Skip to content

feat: add offline Claude web skills for uploaded repositories - #14

Merged
HarshPopat23 merged 3 commits into
mainfrom
feat/claude-web-skills
Oct 23, 2026
Merged

HarshPopat23 merged 3 commits into
mainfrom
feat/claude-web-skills

Conversation

@HarshPopat23

@HarshPopat23 HarshPopat23 commented Oct 23, 2026 •

Copy link
Copy Markdown
Owner

SHContext currently requires a local CLI/Claude Code setup. This adds a separate experimental Claude web distribution: users install individual skill ZIPs, upload source, let the active host author bounded drafts, then download validated context. Updates import both new source and the previous context/cache; the existing CLI, five Code skills, plugin metadata and optional OpenAI adapter are unchanged.

  • Four independent web skills (build/update/verify/query), compiled runtime plus locked production dependencies/licenses, checksums and CI artifacts. Consumers need existing Python 3.9+ and Node 22.14+ (22.x) or 24.x; preflight checks versions/imports without npm, Git, network or model API keys.
  • Bounded ZIP validation/extraction, explicit repository prefix/subfolder selection, private workspaces, no uploaded source execution. Reject traversal, links/special entries, duplicate/alias paths, Git metadata, corruption and expansion limits.
  • Reuse the existing prepare → host-authored drafts → submit → staged finalize pipeline. Validate imported ownership/cache, detect stale/source-changing sessions and publish ZIP exports atomically without overwriting existing files.
  • Document Headlamp prompts, cross-chat updates, limitations and a separate real-account acceptance procedure. Provenance is explicitly host-declared.

Verification

Unlazy acceptance checks were defined before editing. Archive safety controls and isolated no-key distribution flows pass, including selective regeneration, zero-draft reuse, invalid drafts, stale/corrupt output and missing runtimes. A fresh Codex agent followed only packaged instructions on pinned Headlamp router source, authored build/update drafts, verified/query-inspected source, and independently confirmed unchanged reuse/export. Metadata-only routing matched all 20 positive/negative requests. These are local tests, not Claude web execution.

Final head 355177f passes all 9 CI jobs in run 39907300917:

  • Linux Node 22/24: 504 passed, 0 failed, 0 skipped per job.
  • Windows Node 22/24: 499 passed, 0 failed, 5 documented platform skips per job.
  • Offline web distribution on Node 22.14.0 and 24: 11 tests passed per job. The producer is tested from a checkout without scaffold-created empty directories.
  • Existing Claude Code plugin installation, pinned quality/repository evaluation and alpha packaging pass.

Archive controls exercise raw hostile Windows ZIP headers instead of platform-normalized safe filenames, plus a simulated Windows normalization control. Unlazy's final ledger has 7 met, 0 failed, 1 blocked (the actual account test below).

Blocking acceptance check

Actual Claude web upload/execution/download/fresh-chat update is blocked by Claude's hCaptcha after a secure Google sign-in selection. No CAPTCHA was attempted automatically. This PR does not claim web certification. Source ZIP attachment support and actual sandbox runtime versions must be observed in an authenticated account. See docs/claude-web-acceptance.md; no separate API-key test substitutes for it.

Download the shcontext-web-skills CI artifact, extract the outer artifact wrapper, and upload its individual skill ZIPs. The artifact contains the four independently uploadable distributions. Nothing is published to npm or merged by this PR.

@HarshPopat23
HarshPopat23 marked this pull request as ready for review October 23, 2026 05:56
@HarshPopat23
HarshPopat23 merged commit 799eddc into main Oct 23, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant