@catheadowl/pathscope 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/CHANGELOG.md +97 -90
  2. package/package.json +4 -3
package/CHANGELOG.md CHANGED
@@ -1,90 +1,97 @@
1
- ---
2
- description: pathscope changelog — user-visible changes per release, newest first
3
- ---
4
-
5
- # Changelog
6
-
7
- All notable changes to this project are documented here. The format follows
8
- [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
9
-
10
- ## 0.1.0 — 2026-10-24
11
-
12
- First public cut.
13
-
14
- ### Added
15
-
16
- - **walk mode** — `walkScope(root, options)`: whole-tree pruning, gitignore
17
- cascade (inherited + nested, one ordered rule stream, last-match-wins),
18
- five mounted exclusion presets (vcs / deps / build / caches / agentDocs —
19
- un-excludable via named `!`), policy layer, override whitelist (terminal
20
- include), strict immune channel (outbound artifact boundaries, written
21
- reason mandatory), boundary stones (always-on `.git` core stone, opt-in
22
- config homes and `.gitignore` proxy), dot-entry walk option, symlinks
23
- unresolved by default, and a loud file budget (default 2000 — never a
24
- silent cut). `respectGitignore: false` skips the gitignore sources only —
25
- presets, the policy layer, the override whitelist, and boundary stones
26
- are unaffected.
27
- - **named-subtree core-stone exemption** — `boundaryStones.exempt`:
28
- gitignore-style patterns anchored at the scan root (e.g.
29
- `'embedded-toolkit/'`) naming subtrees whose own `.git` no longer
30
- truncates them — the submodule-registration isomorphism. A matched
31
- directory descends as a native subtree (nested `.gitignore` files fold by
32
- the ordinary nesting rules), while a deeper embedded `.git` inside it is
33
- still a stone and un-named siblings keep the cut. The exemption reaches
34
- only the core stone (config homes and the `.gitignore` proxy are never
35
- exemptible) and is registration, not rescue. On the composable engine
36
- face, `excludeDirectory`'s `stoneHit` parameter additionally accepts
37
- per-stone hit names (`boolean | readonly string[]`); the boolean form
38
- still truncates unconditionally.
39
- - **proxy-stone exemption** — `boundaryStones.exempt` reaches the
40
- `.gitignore` proxy stone under the same rules: naming a subtree revokes
41
- its proxy registration — the named subtree returns to the git-native
42
- default where a nested `.gitignore` is rules, not territory. Config homes
43
- stay never-exemptible; a co-hit of the exemptible kinds in one directory
44
- is neutralized by the single naming; deeper proxy stones inside the named
45
- subtree are still stones. A degenerate `.gitignore` config-home
46
- declaration under a mounted proxy stone is rejected as a configuration
47
- error.
48
- - **alignment faces** — `alignment?: 'git' | 'scanner'` (default `'git'`):
49
- two named faces over one decision core. The git face is the standing
50
- semantics (core-stone truncation). The scanner face (rg/fd family parity)
51
- suspends core-stone enforcement — report-not-cut: the `.git` stone stays
52
- in the probe contract and the per-stone `stoneHit` report keeps naming it
53
- ("this subtree is a nested repository" metadata) while the truncation
54
- never executes, at any depth. Config-home stones keep their verdict under
55
- every face; mounting `gitignoreProxy` under the scanner face is rejected
56
- as a configuration error. On the composable face the scanner semantics
57
- ride the array `stoneHit` form of `excludeDirectory`; the boolean form
58
- keeps its unconditional cut.
59
- - **git universe** — `gitUniverse(root, options)`: ask git instead of
60
- walking. Variants `all` (tracked + untracked-but-not-ignored), `tree`
61
- (index contents), `staged` (A/C/M/R vs HEAD). Gitlink submodules
62
- (mode 160000) and symlinks (mode 120000) never enter the universe;
63
- repository root memoized per root (`clearUniverseCache` resets); opt-in
64
- `filter` post-filter (a tracked `node_modules` belongs in the universe).
65
- - **config discovery** — `locateNearest(names, {cwd, stopAt})`:
66
- nearest-wins residence lookup (nested config = governance boundary;
67
- `stopAt` inclusive). Locates only — parsing stays consumer-side.
68
- - **composable decision core** — `createExclusionEngine(rootKey, options?,
69
- io?)`: the exclusion stack + gitignore cascade behind walkScope as a
70
- standalone engine for consumers that own their own traversal (incremental
71
- snapshots, watcher feeds, URI/remote filesystems). Construction runs the
72
- inherited phase through an injectable async `ExclusionIO`
73
- (`nodeExclusionIO` is the node default); adjudication is pure and
74
- synchronous — `excludeDirectory(name, dirPath, stoneHit?)` → (descend) →
75
- `foldGitignore(dirPath, text)` → `admitFile(relPath)` mirrors walkScope's
76
- per-directory sequence, no budget (the loud budget stays with walkScope).
77
- - **conformance corpus** — self-contained fixtures of two provenance kinds
78
- (git-oracle-adjudicated and registered extensions), language-neutral for
79
- cross-language ports.
80
- - `PathscopeConfigError` (malformed options fail loudly) and
81
- `PathscopeGitError` (git missing / not a repository / git failed — the
82
- message names the command).
83
- - **dual-format package** — a CommonJS require condition
84
- (`dist/cjs/index.js`, an esbuild bundle that inlines the ESM-only find-up
85
- so the CJS artifact runs on the same Node range as the ESM face) alongside
86
- the ESM default (`esbuild` is a devDependency, build-time only).
87
-
88
- ### Changed
89
-
90
- - Nothing yet — this is the first release.
1
+ ---
2
+ description: pathscope changelog — user-visible changes per release, newest first
3
+ ---
4
+
5
+ # Changelog
6
+
7
+ All notable changes to this project are documented here. The format follows
8
+ [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
9
+
10
+ ## 0.1.1 — 2026-10-31
11
+
12
+ Maintenance release — no library changes. CI publishing switched to npm
13
+ trusted publishing (OIDC); provenance attestations stay off while the
14
+ source repository is private (`publishConfig.provenance: false`, to be
15
+ dropped when the repository goes public).
16
+
17
+ ## 0.1.0 — 2026-10-24
18
+
19
+ First public cut.
20
+
21
+ ### Added
22
+
23
+ - **walk mode** — `walkScope(root, options)`: whole-tree pruning, gitignore
24
+ cascade (inherited + nested, one ordered rule stream, last-match-wins),
25
+ five mounted exclusion presets (vcs / deps / build / caches / agentDocs —
26
+ un-excludable via named `!`), policy layer, override whitelist (terminal
27
+ include), strict immune channel (outbound artifact boundaries, written
28
+ reason mandatory), boundary stones (always-on `.git` core stone, opt-in
29
+ config homes and `.gitignore` proxy), dot-entry walk option, symlinks
30
+ unresolved by default, and a loud file budget (default 2000 — never a
31
+ silent cut). `respectGitignore: false` skips the gitignore sources only —
32
+ presets, the policy layer, the override whitelist, and boundary stones
33
+ are unaffected.
34
+ - **named-subtree core-stone exemption** — `boundaryStones.exempt`:
35
+ gitignore-style patterns anchored at the scan root (e.g.
36
+ `'embedded-toolkit/'`) naming subtrees whose own `.git` no longer
37
+ truncates them — the submodule-registration isomorphism. A matched
38
+ directory descends as a native subtree (nested `.gitignore` files fold by
39
+ the ordinary nesting rules), while a deeper embedded `.git` inside it is
40
+ still a stone and un-named siblings keep the cut. The exemption reaches
41
+ only the core stone (config homes and the `.gitignore` proxy are never
42
+ exemptible) and is registration, not rescue. On the composable engine
43
+ face, `excludeDirectory`'s `stoneHit` parameter additionally accepts
44
+ per-stone hit names (`boolean | readonly string[]`); the boolean form
45
+ still truncates unconditionally.
46
+ - **proxy-stone exemption** — `boundaryStones.exempt` reaches the
47
+ `.gitignore` proxy stone under the same rules: naming a subtree revokes
48
+ its proxy registration — the named subtree returns to the git-native
49
+ default where a nested `.gitignore` is rules, not territory. Config homes
50
+ stay never-exemptible; a co-hit of the exemptible kinds in one directory
51
+ is neutralized by the single naming; deeper proxy stones inside the named
52
+ subtree are still stones. A degenerate `.gitignore` config-home
53
+ declaration under a mounted proxy stone is rejected as a configuration
54
+ error.
55
+ - **alignment faces** — `alignment?: 'git' | 'scanner'` (default `'git'`):
56
+ two named faces over one decision core. The git face is the standing
57
+ semantics (core-stone truncation). The scanner face (rg/fd family parity)
58
+ suspends core-stone enforcement — report-not-cut: the `.git` stone stays
59
+ in the probe contract and the per-stone `stoneHit` report keeps naming it
60
+ ("this subtree is a nested repository" metadata) while the truncation
61
+ never executes, at any depth. Config-home stones keep their verdict under
62
+ every face; mounting `gitignoreProxy` under the scanner face is rejected
63
+ as a configuration error. On the composable face the scanner semantics
64
+ ride the array `stoneHit` form of `excludeDirectory`; the boolean form
65
+ keeps its unconditional cut.
66
+ - **git universe** — `gitUniverse(root, options)`: ask git instead of
67
+ walking. Variants `all` (tracked + untracked-but-not-ignored), `tree`
68
+ (index contents), `staged` (A/C/M/R vs HEAD). Gitlink submodules
69
+ (mode 160000) and symlinks (mode 120000) never enter the universe;
70
+ repository root memoized per root (`clearUniverseCache` resets); opt-in
71
+ `filter` post-filter (a tracked `node_modules` belongs in the universe).
72
+ - **config discovery** — `locateNearest(names, {cwd, stopAt})`:
73
+ nearest-wins residence lookup (nested config = governance boundary;
74
+ `stopAt` inclusive). Locates only — parsing stays consumer-side.
75
+ - **composable decision core** — `createExclusionEngine(rootKey, options?,
76
+ io?)`: the exclusion stack + gitignore cascade behind walkScope as a
77
+ standalone engine for consumers that own their own traversal (incremental
78
+ snapshots, watcher feeds, URI/remote filesystems). Construction runs the
79
+ inherited phase through an injectable async `ExclusionIO`
80
+ (`nodeExclusionIO` is the node default); adjudication is pure and
81
+ synchronous — `excludeDirectory(name, dirPath, stoneHit?)` → (descend) →
82
+ `foldGitignore(dirPath, text)` → `admitFile(relPath)` mirrors walkScope's
83
+ per-directory sequence, no budget (the loud budget stays with walkScope).
84
+ - **conformance corpus** — self-contained fixtures of two provenance kinds
85
+ (git-oracle-adjudicated and registered extensions), language-neutral for
86
+ cross-language ports.
87
+ - `PathscopeConfigError` (malformed options fail loudly) and
88
+ `PathscopeGitError` (git missing / not a repository / git failed — the
89
+ message names the command).
90
+ - **dual-format package** — a CommonJS require condition
91
+ (`dist/cjs/index.js`, an esbuild bundle that inlines the ESM-only find-up
92
+ so the CJS artifact runs on the same Node range as the ESM face) alongside
93
+ the ESM default (`esbuild` is a devDependency, build-time only).
94
+
95
+ ### Changed
96
+
97
+ - Nothing yet — this is the first release.
package/package.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "@catheadowl/pathscope",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Cross-repo shared engine resolving the in-scope file set: walk, gitignore cascade, mounted exclusion presets, loud budget, git universe, boundary stones — under a git-native alignment skeleton with conformance fixtures adjudicated by a git oracle.",
5
5
  "license": "MIT",
6
6
  "repository": {
7
7
  "type": "git",
8
- "url": "git+https://github.com/catheadowl/pathscope.git"
8
+ "url": "git+https://github.com/CatheadOwl/pathscope.git"
9
9
  },
10
10
  "type": "module",
11
11
  "engines": {
@@ -19,7 +19,8 @@
19
19
  "CHANGELOG.md"
20
20
  ],
21
21
  "publishConfig": {
22
- "access": "public"
22
+ "access": "public",
23
+ "provenance": false
23
24
  },
24
25
  "scripts": {
25
26
  "build": "tsc -p tsconfig.build.json && node scripts/build-cjs.mjs",