@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.
- package/CHANGELOG.md +97 -90
- 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.
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
presets
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
the
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
`
|
|
82
|
-
|
|
83
|
-
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
-
|
|
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.
|
|
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/
|
|
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",
|