Skip to content

docs(npm-exemptions): mirror hypatia#405 vscode-* + tree-sitter-* carve-outs (standards#253) #320

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
hyperpolymath merged 1 commit into from
May 30, 2026
+18 −4
Merged

docs(npm-exemptions): mirror hypatia#405 vscode-* + tree-sitter-* carve-outs (standards#253) #320

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion .claude/CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -171,11 +171,16 @@ In-flight migration tracked under `hyperpolymath/standards#253` (172 manifests a

| Path / Pattern | Class | Rationale | Unblock condition |
|---|---|---|---|
| `**/vscode/**` | VSCode extension host-required | VSCode extension toolchain runs under Node; lockfile is contractually required by the host. | When AffineScript ships the VSCode-extension API binding. |
| `**/vscode/**` | VSCode extension host-required (segment) | VSCode extension toolchain runs under Node; lockfile is contractually required by the host. | When AffineScript ships the VSCode-extension API binding. |
| `vscode-` substring (`vscode-extension/`, `editors/vscode-007/`, `vscode-a2ml`, `vscode-k9`, …) | VSCode-* extension repos / subdirs | Same VSCode host-required toolchain rationale; different path-segment shape than `/vscode/`. | When AffineScript ships the VSCode-extension API binding. |
| `tree-sitter-` substring (`tree-sitter-a2ml`, `tree-sitter-k9`, `editors/tree-sitter-ephapax`, `tree-sitter-affinescript/`, …) | tree-sitter grammar npm-publish target | Class C consumer artifact — tree-sitter grammars ship via npm with `node-gyp` native binding because every consumer (Atom/Neovim/VSCode TextMate) links the native addon. | Never — npm-publishable consumer artifact with native binding. |
| `affinescript-deno-test/**`, `affinescript-cli/**` | bootstrap shim | Bootstrap the AffineScript toolchain itself. | When AffineScript self-hosts these. |
| `rescript/**`, `servers/**`, `repos-monorepo/**`, `linguist/**` | upstream fork | Not estate-authored — vendored upstream code. | Never — upstream fork. |
| `hyperpolymath-archive/**` | archived | Archived repos cannot accept PRs. | Never — archived. |
| `**/deps/**`, `**/node_modules/**` | vendored package-manager dep | Vendored deps. | Never — vendored upstream. |
| `**/.lake/**` | Lean4 vendored package | Lean4's package manager directory, parallel to `/deps/`. | Never — vendored. |
| `**/office-addin/**` | Office.js add-in host-required | Office host loads `.js` from a Node-packaged manifest, parallel to VSCode extension carve-out. | When AffineScript ships an Office.js binding. |
| `**/bindings/javascript/**`, `**/bindings/typescript/**` | consumer-facing estate export | Proven JS/TS bindings published to npm consumers, parallel to `/bindings/deno/` under `:typescript_detected`. | Never — consumer-facing bindings. |
| `**/example/**`, `**/examples/**`, `**/test-fixtures/**`, `**/fixtures/**` | example/test fixture | Demonstrates an npm consumer (e.g., showing how a library is used from a Node project) without making the repo itself an npm consumer. | Never — fixture, not own toolchain. |

### JavaScript Exemptions (Approved)
Expand Down
15 changes: 12 additions & 3 deletions rhodium-standard-repositories/.github/workflows/language-policy.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -114,20 +114,29 @@ jobs:

# Block new package-lock.json (npm banned 2026-05-25, replacement: Deno).
# Carve-outs (parallel to hypatia cicd_rules/nodejs_detected
# path_allow_prefixes — 6 classes):
# **/vscode/ VSCode extension host-required toolchain
# path_allow_prefixes — 8 classes):
# **/vscode/ VSCode extension host-required toolchain (segment)
# vscode- VSCode-* extension repos / subdirs (substring)
# tree-sitter- tree-sitter grammar npm-publish targets (Class C)
# affinescript-deno-test/ + affinescript-cli/ bootstrap shims
# rescript/ + servers/ + repos-monorepo/ + linguist/ upstream forks
# hyperpolymath-archive/ archived repos
# **/deps/ + **/node_modules/ vendored package-manager deps
# **/deps/ + **/node_modules/ + **/.lake/ + **/office-addin/
# + **/bindings/{javascript,typescript}/ vendored / host-required /
# consumer-facing exports
# **/example/ + **/examples/ + **/test-fixtures/ + **/fixtures/
NEW_NPM_LOCK=$(git diff --name-only --diff-filter=A HEAD~1 2>/dev/null \
| grep -E '(^|/)package-lock\.json$' \
| grep -vE '/vscode/' \
| grep -vE 'vscode-' \
| grep -vE 'tree-sitter-' \
| grep -vE '^(affinescript-deno-test|affinescript-cli)/' \
| grep -vE '^(rescript|servers|repos-monorepo|linguist|hyperpolymath-archive)/' \
| grep -vE '/deps/' \
| grep -vE '/node_modules/' \
| grep -vE '/\.lake/' \
| grep -vE '/office-addin/' \
| grep -vE '/bindings/(javascript|typescript)/' \
| grep -vE '/(example|examples|test-fixtures|fixtures)/' \
|| true)
if [ -n "$NEW_NPM_LOCK" ]; then
Expand Down