@catheadowl/pathscope 0.1.1 → 0.3.0

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.
@@ -1 +1 @@
1
- {"version":3,"file":"exclusion-engine.js","sourceRoot":"","sources":["../src/exclusion-engine.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"exclusion-engine.js","sourceRoot":"","sources":["../src/exclusion-engine.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,109 @@
1
+ import { type LayerHit } from './exclusion-engine.ts';
2
+ import { type ScopeOptions } from './types.ts';
3
+ /** One hit in the explanation chain: a layer adjudication entry plus the path it adjudicated. */
4
+ export interface HitEntry extends LayerHit {
5
+ /**
6
+ * The scan-root-relative POSIX path this hit adjudicated — the queried
7
+ * path itself for rule answers, the EXCLUDED ANCESTOR for structural
8
+ * answers (the pruned directory is where the verdict was made).
9
+ */
10
+ path: string;
11
+ }
12
+ /** The explicit-pierce projection: what would happen if the consumer named this path explicitly. */
13
+ export interface ExplicitProjection {
14
+ /**
15
+ * False only when an enforced stone cut or a strict-channel hit blocks the
16
+ * path (the stone is a structural terminal, strict is immune even to the
17
+ * override whitelist — explicit naming is override-channel semantics and
18
+ * cannot pierce either). Every other layer (presets, cascade, policy, dot)
19
+ * is pierceable: naming a path is the terminal include.
20
+ */
21
+ pierceable: boolean;
22
+ /**
23
+ * The blocking hits (enforced stones / strict rules), in chain order.
24
+ * A stone blocker carries `enforced: true` by definition (only enforced
25
+ * stones block) — the field is load-bearing in `hitChain` (where it
26
+ * separates report-not-cut metadata) and tautological here; renderers may
27
+ * omit it.
28
+ */
29
+ blockers: HitEntry[];
30
+ }
31
+ /** Result of {@link explainScopePath}. */
32
+ export interface ExplanationResult {
33
+ /**
34
+ * The rule-space verdict: true = the exclusion stack excludes this path.
35
+ * For a path on disk under an un-cut budget this equals "absent from a
36
+ * walkScope result"; the two caveats are both by design — the loud budget
37
+ * is a walk-chassis concern the probe never reflects (a budget-cut walk
38
+ * omits files this API rightly reports as included), and for a
39
+ * nonexistent path `excluded: false` means "nothing in the rule space
40
+ * excludes it" (walkScope membership is undefined for paths that do not
41
+ * exist — the consumer's status branch owns existence separately).
42
+ */
43
+ excluded: boolean;
44
+ /**
45
+ * True when the verdict comes from a directory-level adjudication — an
46
+ * excluded ancestor (the whole subtree rides the prune) or the queried
47
+ * directory itself being cut. Rule answers on the queried path are
48
+ * non-structural.
49
+ */
50
+ structural: boolean;
51
+ /**
52
+ * The adjudication record: every layer that matched, in full-stack
53
+ * priority order (stone → strict → override → combined table → dot);
54
+ * within the combined table entries follow the rule stream (presets →
55
+ * cascade → folds → policy rear seat), so the last table entry is the
56
+ * last-match-wins winner. The chain is not only the verdict's cause — an
57
+ * included path can carry hits (the preset hit, then the override that
58
+ * rescued it), and a stone entry with `enforced: false` is report-only
59
+ * metadata (the scanner face's report-not-cut: it did not produce the
60
+ * verdict).
61
+ *
62
+ * For a structural answer the chain is EXACTLY the excluded ancestor's
63
+ * adjudication record: adjudication does not continue below the prune,
64
+ * so the query path's own rule hits are absent by construction (the
65
+ * pruned subtree's `.gitignore` is never folded). What still matters
66
+ * below the prune — enforced stones and strict hits — surfaces in
67
+ * {@link ExplicitProjection.blockers} instead.
68
+ */
69
+ hitChain: HitEntry[];
70
+ explicit: ExplicitProjection;
71
+ }
72
+ /**
73
+ * Point-query one path against the same scope request a walk would resolve:
74
+ * `explainScopePath(root, 'pkg/lib.ts', options)` answers whether that path
75
+ * is in scope and exactly which layer decided it. Nonexistent paths
76
+ * adjudicate hypothetically over the rule space (the stone probes report
77
+ * the IO facts as they are) — a status query asks precisely about on-disk
78
+ * paths that never entered an index. The scan root itself returns the
79
+ * universe-boundary fact (`excluded: false`, empty chain). Read-only: no
80
+ * exclusion source is added, no matching behavior changes, walkScope output
81
+ * is untouched.
82
+ *
83
+ * Input form: `relPath` is scan-root-relative POSIX; a leading `./` is
84
+ * stripped (so `''`, `'.'`, and `'./'` all name the scan root itself); a
85
+ * trailing slash is the OPERATOR selecting directory-order adjudication (a
86
+ * slash-less query always adjudicates file-order, even for an existing
87
+ * directory); an empty segment INSIDE the path (`a//b`) is rejected. The
88
+ * `root` argument takes any form `path.resolve` accepts — relative or
89
+ * absolute, native separators included — exactly like walkScope. Each call
90
+ * is self-contained over a dedicated engine instance — calls are
91
+ * independent and safe to run in parallel. Symlinks are not resolved;
92
+ * `followSymlinks` and `maxFiles` are walk-chassis options, accepted and
93
+ * ignored. A symlinked FINAL segment adjudicates by its own name (never
94
+ * resolved); intermediate reads (stone probes, `.gitignore`) follow the
95
+ * filesystem as any read does. Many-paths workloads: there is no batch
96
+ * face yet (deferred) — each call is self-contained, so run concurrent
97
+ * queries concurrently.
98
+ *
99
+ * The probe covers the WALK face only; the ask-git face (gitUniverse) has
100
+ * no point query — git itself answers those questions. IO rides the node
101
+ * filesystem — an injectable-IO probe face (URI/remote filesystems, the
102
+ * composable engine's ExclusionIO route) is deferred, not provided.
103
+ *
104
+ * @throws PathscopeConfigError when `relPath` is out of domain (absolute
105
+ * path, backslash separator, `..` escape, empty inner segment) or the scan
106
+ * root does not exist — the same fail-loud family as every other malformed
107
+ * input.
108
+ */
109
+ export declare function explainScopePath(root: string, relPath: string, options?: ScopeOptions): Promise<ExplanationResult>;
@@ -0,0 +1,193 @@
1
+ /**
2
+ * explainScopePath — the read-only per-path probe face (06 seam extension,
3
+ * 2026-10-31 frozen contract). One scope request, a third resolution:
4
+ * walkScope enumerates the set, gitUniverse lists it, the probe answers a
5
+ * membership POINT QUERY — `excluded` plus the hit chain that produced it.
6
+ *
7
+ * Consistency mechanism: a DEDICATED engine instance replaying the ancestor
8
+ * chain — every ancestor directory is adjudicated exactly as the walk would
9
+ * (stone probes over the same IO face, gitignore folded only for descended
10
+ * directories), then the final segment adjudicates by file order (or
11
+ * directory order for a trailing-slash query). The equivalence argument is
12
+ * the subtree-anchoring invariant: folded rules are re-anchored under their
13
+ * directory's prefix, so folds from non-ancestor directories cannot match
14
+ * the queried path — the replay state equals the walk's state at the moment
15
+ * it reaches the path. The corpus-wide equivalence fixture gate pins this.
16
+ *
17
+ * Structural answers: an ancestor excluded with no directory-level rescue
18
+ * makes the answer structural — the chain attributes to that ancestor and
19
+ * the pruned subtree's .gitignore never folds (deep rules do not
20
+ * participate, mirroring the walk's prune). The explicit projection still
21
+ * walks the remaining chain in projection mode (stone probes + strict
22
+ * only): those are the two channels explicit naming can never pierce.
23
+ */
24
+ import { existsSync } from 'node:fs';
25
+ import { resolve } from 'node:path';
26
+ import { createExclusionEngine, nodeExclusionIO } from './exclusion-engine.js';
27
+ import { PathscopeConfigError } from './types.js';
28
+ /**
29
+ * Validate the query path: scan-root-relative POSIX form. Absolute paths,
30
+ * backslash separators, `..` escapes, and double slashes are rejected as
31
+ * configuration errors — one canonical input form. Returns the normalized
32
+ * segments plus whether the query named a directory (trailing slash).
33
+ */
34
+ function parseRelPath(relPath) {
35
+ if (typeof relPath !== 'string') {
36
+ throw new PathscopeConfigError('relPath must be a scan-root-relative POSIX path string');
37
+ }
38
+ if (relPath.includes('\\')) {
39
+ throw new PathscopeConfigError(`relPath "${relPath}" contains a backslash — pass POSIX-separator form`);
40
+ }
41
+ if (relPath.startsWith('/')) {
42
+ throw new PathscopeConfigError(`relPath "${relPath}" is absolute — pass a scan-root-RELATIVE path`);
43
+ }
44
+ const isDir = relPath.endsWith('/');
45
+ let core = relPath;
46
+ while (core.startsWith('./'))
47
+ core = core.slice(2);
48
+ if (core === '.' || core === '')
49
+ return { segments: [], isDir: true, isRoot: true };
50
+ const segments = core.replace(/\/+$/, '').split('/');
51
+ for (const seg of segments) {
52
+ if (seg === '') {
53
+ throw new PathscopeConfigError(`relPath "${relPath}" has an empty segment (double slash)`);
54
+ }
55
+ if (seg === '.' || seg === '..') {
56
+ throw new PathscopeConfigError(`relPath "${relPath}" escapes the scan root (".", ".." segments)`);
57
+ }
58
+ }
59
+ return { segments, isDir, isRoot: false };
60
+ }
61
+ /**
62
+ * Point-query one path against the same scope request a walk would resolve:
63
+ * `explainScopePath(root, 'pkg/lib.ts', options)` answers whether that path
64
+ * is in scope and exactly which layer decided it. Nonexistent paths
65
+ * adjudicate hypothetically over the rule space (the stone probes report
66
+ * the IO facts as they are) — a status query asks precisely about on-disk
67
+ * paths that never entered an index. The scan root itself returns the
68
+ * universe-boundary fact (`excluded: false`, empty chain). Read-only: no
69
+ * exclusion source is added, no matching behavior changes, walkScope output
70
+ * is untouched.
71
+ *
72
+ * Input form: `relPath` is scan-root-relative POSIX; a leading `./` is
73
+ * stripped (so `''`, `'.'`, and `'./'` all name the scan root itself); a
74
+ * trailing slash is the OPERATOR selecting directory-order adjudication (a
75
+ * slash-less query always adjudicates file-order, even for an existing
76
+ * directory); an empty segment INSIDE the path (`a//b`) is rejected. The
77
+ * `root` argument takes any form `path.resolve` accepts — relative or
78
+ * absolute, native separators included — exactly like walkScope. Each call
79
+ * is self-contained over a dedicated engine instance — calls are
80
+ * independent and safe to run in parallel. Symlinks are not resolved;
81
+ * `followSymlinks` and `maxFiles` are walk-chassis options, accepted and
82
+ * ignored. A symlinked FINAL segment adjudicates by its own name (never
83
+ * resolved); intermediate reads (stone probes, `.gitignore`) follow the
84
+ * filesystem as any read does. Many-paths workloads: there is no batch
85
+ * face yet (deferred) — each call is self-contained, so run concurrent
86
+ * queries concurrently.
87
+ *
88
+ * The probe covers the WALK face only; the ask-git face (gitUniverse) has
89
+ * no point query — git itself answers those questions. IO rides the node
90
+ * filesystem — an injectable-IO probe face (URI/remote filesystems, the
91
+ * composable engine's ExclusionIO route) is deferred, not provided.
92
+ *
93
+ * @throws PathscopeConfigError when `relPath` is out of domain (absolute
94
+ * path, backslash separator, `..` escape, empty inner segment) or the scan
95
+ * root does not exist — the same fail-loud family as every other malformed
96
+ * input.
97
+ */
98
+ export async function explainScopePath(root, relPath, options = {}) {
99
+ const { segments, isDir, isRoot } = parseRelPath(relPath);
100
+ // Root resolution mirrors walkScope verbatim (resolve → existence → POSIX key).
101
+ const rootNative = resolve(root);
102
+ if (!existsSync(rootNative)) {
103
+ throw new PathscopeConfigError(`scan root does not exist: ${rootNative}`);
104
+ }
105
+ const baseKey = rootNative.replace(/\\/g, '/').replace(/\/+$/, '');
106
+ const engine = await createExclusionEngine(baseKey, options);
107
+ const io = nodeExclusionIO;
108
+ /** Stone probe for one directory key — the same per-name probes the walk glue performs. */
109
+ const probeStones = async (dirKey) => {
110
+ const hits = [];
111
+ for (const name of engine.stoneNames) {
112
+ if (await io.exists(dirKey, name))
113
+ hits.push(name);
114
+ }
115
+ return hits;
116
+ };
117
+ const withPath = (hits, path) => hits.map((h) => ({ ...h, path }));
118
+ if (isRoot) {
119
+ // The scan root is the universe boundary: never excluded, nothing
120
+ // adjudicates it, nothing blocks explicit naming.
121
+ return { excluded: false, structural: false, hitChain: [], explicit: { pierceable: true, blockers: [] } };
122
+ }
123
+ const hitChain = [];
124
+ const blockers = [];
125
+ const keys = [];
126
+ let key = baseKey;
127
+ for (const seg of segments) {
128
+ key = `${key}/${seg}`;
129
+ keys.push(key);
130
+ }
131
+ // ---- verdict replay: ancestors first, then the final segment -------------
132
+ let excluded;
133
+ let structural = false;
134
+ let stoppedDepth = -1;
135
+ for (let i = 0; i < segments.length; i++) {
136
+ const name = segments[i];
137
+ const relHere = segments.slice(0, i + 1).join('/');
138
+ const isLeaf = i === segments.length - 1;
139
+ const adjudicateAsDir = isLeaf ? isDir : true;
140
+ if (adjudicateAsDir) {
141
+ const stoneHit = await probeStones(keys[i]);
142
+ const adj = engine.adjudicateDirectory(name, keys[i], stoneHit);
143
+ hitChain.push(...withPath(adj.hits, relHere));
144
+ if (adj.excluded) {
145
+ // Structural: the prune at this directory carries the whole subtree.
146
+ excluded = true;
147
+ structural = true;
148
+ stoppedDepth = i;
149
+ break;
150
+ }
151
+ // Descending: fold this layer's .gitignore, exactly as the walk glue does.
152
+ engine.foldGitignore(keys[i], await io.readGitignore(keys[i]));
153
+ if (isLeaf)
154
+ excluded = false;
155
+ }
156
+ else {
157
+ const adj = engine.adjudicateFile(relHere);
158
+ hitChain.push(...withPath(adj.hits, relHere));
159
+ excluded = !adj.admitted;
160
+ }
161
+ }
162
+ // ---- explicit projection --------------------------------------------------
163
+ // Blockers from the adjudicated chain: enforced stones and strict hits.
164
+ for (const hit of hitChain) {
165
+ if (hit.source === 'strict' || (hit.source === 'stone' && hit.enforced !== false)) {
166
+ blockers.push(hit);
167
+ }
168
+ }
169
+ // Under a structural stop the rule adjudication must NOT continue (pruned
170
+ // rules never participate), but stone facts and strict are exactly the
171
+ // projection's questions — keep probing the remaining chain.
172
+ if (stoppedDepth >= 0 && stoppedDepth < segments.length - 1) {
173
+ for (let j = stoppedDepth + 1; j < segments.length; j++) {
174
+ const relHere = segments.slice(0, j + 1).join('/');
175
+ const isLeaf = j === segments.length - 1;
176
+ const asDir = isLeaf ? isDir : true;
177
+ if (asDir) {
178
+ blockers.push(...withPath(engine.attributeStones(relHere, await probeStones(keys[j])), relHere));
179
+ blockers.push(...withPath(engine.adjudicateStrict(relHere, true).hits, relHere));
180
+ }
181
+ else {
182
+ blockers.push(...withPath(engine.adjudicateStrict(relHere, false).hits, relHere));
183
+ }
184
+ }
185
+ }
186
+ return {
187
+ excluded: excluded ?? false,
188
+ structural,
189
+ hitChain,
190
+ explicit: { pierceable: blockers.length === 0, blockers },
191
+ };
192
+ }
193
+ //# sourceMappingURL=explain.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"explain.js","sourceRoot":"","sources":["../src/explain.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -6,15 +6,19 @@
6
6
  * cascade on the node-ignore kernel, mounted exclusion presets, override
7
7
  * whitelist, strict immune channel, boundary stones, and a loud budget) or
8
8
  * ask-git mode (gitUniverse — git is the truth, the exclusion stack does not
9
- * participate). Config discovery (locateNearest) locates the nearest config
10
- * residence and never parses it. Consumers that own their own traversal
11
- * (incremental snapshots, watcher feeds, URI/remote filesystems) compose the
12
- * same exclusion stack + cascade as a standalone decision core:
13
- * createExclusionEngine.
9
+ * participate). The read-only probe face (explainScopePath) answers a
10
+ * membership point query over the same scope request — excluded plus the
11
+ * hit chain that decided it. Config discovery (locateNearest) locates the
12
+ * nearest config residence and never parses it. Consumers that own their
13
+ * own traversal (incremental snapshots, watcher feeds, URI/remote
14
+ * filesystems) compose the same exclusion stack + cascade as a standalone
15
+ * decision core: createExclusionEngine.
14
16
  */
15
17
  export { walkScope } from './engine.ts';
16
18
  export { createExclusionEngine, nodeExclusionIO } from './exclusion-engine.ts';
17
- export type { ExclusionEngine, ExclusionIO } from './exclusion-engine.ts';
19
+ export type { DirectoryAdjudication, ExclusionEngine, ExclusionIO, FileAdjudication, HitSource, LayerHit } from './exclusion-engine.ts';
20
+ export { explainScopePath } from './explain.ts';
21
+ export type { ExplicitProjection, ExplanationResult, HitEntry } from './explain.ts';
18
22
  export { clearUniverseCache, gitUniverse } from './universe.ts';
19
23
  export { locateNearest } from './discover.ts';
20
24
  export { PRESETS, DEFAULT_MOUNTED_PRESETS } from './presets.ts';
package/dist/index.js CHANGED
@@ -6,14 +6,17 @@
6
6
  * cascade on the node-ignore kernel, mounted exclusion presets, override
7
7
  * whitelist, strict immune channel, boundary stones, and a loud budget) or
8
8
  * ask-git mode (gitUniverse — git is the truth, the exclusion stack does not
9
- * participate). Config discovery (locateNearest) locates the nearest config
10
- * residence and never parses it. Consumers that own their own traversal
11
- * (incremental snapshots, watcher feeds, URI/remote filesystems) compose the
12
- * same exclusion stack + cascade as a standalone decision core:
13
- * createExclusionEngine.
9
+ * participate). The read-only probe face (explainScopePath) answers a
10
+ * membership point query over the same scope request — excluded plus the
11
+ * hit chain that decided it. Config discovery (locateNearest) locates the
12
+ * nearest config residence and never parses it. Consumers that own their
13
+ * own traversal (incremental snapshots, watcher feeds, URI/remote
14
+ * filesystems) compose the same exclusion stack + cascade as a standalone
15
+ * decision core: createExclusionEngine.
14
16
  */
15
17
  export { walkScope } from './engine.js';
16
18
  export { createExclusionEngine, nodeExclusionIO } from './exclusion-engine.js';
19
+ export { explainScopePath } from './explain.js';
17
20
  export { clearUniverseCache, gitUniverse } from './universe.js';
18
21
  export { locateNearest } from './discover.js';
19
22
  export { PRESETS, DEFAULT_MOUNTED_PRESETS } from './presets.js';
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}
package/dist/presets.d.ts CHANGED
@@ -11,15 +11,23 @@
11
11
  import type { PresetName } from './types.ts';
12
12
  /** Type guard used by option validation — unknown preset names fail loudly. */
13
13
  export declare function isPresetName(value: unknown): value is PresetName;
14
- /** Preset content: directory names (matched as dir-only `name/` patterns at any depth) and file names. */
14
+ /**
15
+ * Preset content: directory names (matched as dir-only `name/` patterns at any
16
+ * depth) and file names. A `dirs` entry MAY carry a leading slash (`/target`)
17
+ * — it then compiles to a scan-root-anchored pattern (`/target/`, plain
18
+ * gitignore anchoring) that matches only a same-named directory at the scan
19
+ * root itself, never nested ones; the named-negation exit key (`!target/`)
20
+ * un-excludes it like any other entry.
21
+ */
15
22
  export type Preset = {
16
23
  dirs: string[];
17
24
  files?: string[];
18
25
  };
19
26
  /**
20
27
  * The five preset groups. `dirs` entries compile to dir-only gitignore
21
- * patterns (`name/` — a plain file with the same name stays in scope);
22
- * `files` entries compile to bare names.
28
+ * patterns (`name/` — a plain file with the same name stays in scope; a
29
+ * leading-slash entry anchors to the scan root); `files` entries compile to
30
+ * bare names.
23
31
  */
24
32
  export declare const PRESETS: Record<PresetName, Preset>;
25
33
  /** The default mount set. */
package/dist/presets.js CHANGED
@@ -5,8 +5,9 @@ export function isPresetName(value) {
5
5
  }
6
6
  /**
7
7
  * The five preset groups. `dirs` entries compile to dir-only gitignore
8
- * patterns (`name/` — a plain file with the same name stays in scope);
9
- * `files` entries compile to bare names.
8
+ * patterns (`name/` — a plain file with the same name stays in scope; a
9
+ * leading-slash entry anchors to the scan root); `files` entries compile to
10
+ * bare names.
10
11
  */
11
12
  export const PRESETS = {
12
13
  vcs: {
@@ -24,16 +25,23 @@ export const PRESETS = {
24
25
  // Build outputs and coverage. These are collision-grade names (a project's
25
26
  // source can legitimately live in `lib/`) — that is exactly why they ride
26
27
  // the un-excludable preset channel (`!lib/` names its way out) instead of
27
- // a separate immune layer.
28
- dirs: ['dist', 'build', 'lib', 'out', 'coverage'],
28
+ // a separate immune layer. `/target` is the ROOT-ANCHORED cargo/maven
29
+ // build tree: anchored exactly because `target` is collision-grade — the
30
+ // Rust toolchain's own adjudication (cargo#3158: a bare `target` hits
31
+ // same-named directories at any depth; `cargo new` generates `/target`),
32
+ // so the entry binds only when the scan root itself is the project.
33
+ dirs: ['dist', 'build', 'lib', 'out', 'coverage', '/target'],
29
34
  },
30
35
  caches: {
31
- // Python & front-end cache/generated trees. Vendor lineage of the entries:
36
+ // Cache/generated trees (Python, front-end, build tools). Vendor lineage
37
+ // of the entries:
32
38
  // - repomix `defaultIgnore.ts` (MIT): __pycache__, .mypy_cache,
33
- // .pytest_cache, .tox, .venv, .cache, .next, .nuxt, .turbo, .vite,
34
- // .parcel-cache, .svelte-kit
39
+ // .pytest_cache, .tox, .venv, venv, .gradle, .cache, .next, .nuxt,
40
+ // .turbo, .vite, .parcel-cache, .svelte-kit
35
41
  // - watchfiles `DefaultFilter` (Python-side alignment): __pycache__,
36
42
  // .mypy_cache, .pytest_cache, .ruff_cache, .tox, .nox, .venv
43
+ // (non-dot `venv` and `.gradle` are repomix-only — watchfiles carries
44
+ // neither; github's Python/Gradle templates carry both)
37
45
  // This group is NOT in the default mount set.
38
46
  dirs: [
39
47
  '__pycache__',
@@ -42,6 +50,8 @@ export const PRESETS = {
42
50
  '.ruff_cache',
43
51
  '.tox',
44
52
  '.venv',
53
+ 'venv',
54
+ '.gradle',
45
55
  '.cache',
46
56
  '.next',
47
57
  '.nuxt',
@@ -1 +1 @@
1
- {"version":3,"file":"presets.js","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAYA,MAAM,YAAY,GAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAE5F,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,YAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1F,CAAC;AAKD;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAA+B;IACjD,GAAG,EAAE;QACH,yEAAyE;QACzE,0EAA0E;QAC1E,uCAAuC;QACvC,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC;KAC9B;IACD,IAAI,EAAE;QACJ,yEAAyE;QACzE,6DAA6D;QAC7D,IAAI,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,CAAC;KAC1C;IACD,KAAK,EAAE;QACL,2EAA2E;QAC3E,0EAA0E;QAC1E,0EAA0E;QAC1E,2BAA2B;QAC3B,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC;KAClD;IACD,MAAM,EAAE;QACN,2EAA2E;QAC3E,kEAAkE;QAClE,uEAAuE;QACvE,iCAAiC;QACjC,uEAAuE;QACvE,iEAAiE;QACjE,8CAA8C;QAC9C,IAAI,EAAE;YACJ,aAAa;YACb,aAAa;YACb,eAAe;YACf,aAAa;YACb,MAAM;YACN,OAAO;YACP,QAAQ;YACR,OAAO;YACP,OAAO;YACP,QAAQ;YACR,OAAO;YACP,eAAe;YACf,aAAa;YACb,MAAM;YACN,cAAc;SACf;KACF;IACD,SAAS,EAAE;QACT,+DAA+D;QAC/D,mEAAmE;QACnE,IAAI,EAAE,EAAE;QACR,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;KAClC;CACF,CAAC;AAEF,6BAA6B;AAC7B,MAAM,CAAC,MAAM,uBAAuB,GAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvF,8EAA8E;AAC9E,MAAM,UAAU,qBAAqB,CAAC,KAA4B;IAChE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QAC9D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
1
+ {"version":3,"file":"presets.js","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAYA,MAAM,YAAY,GAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAE5F,+EAA+E;AAC/E,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,YAAkC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1F,CAAC;AAYD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAA+B;IACjD,GAAG,EAAE;QACH,yEAAyE;QACzE,0EAA0E;QAC1E,uCAAuC;QACvC,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC;KAC9B;IACD,IAAI,EAAE;QACJ,yEAAyE;QACzE,6DAA6D;QAC7D,IAAI,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,CAAC;KAC1C;IACD,KAAK,EAAE;QACL,2EAA2E;QAC3E,0EAA0E;QAC1E,0EAA0E;QAC1E,sEAAsE;QACtE,yEAAyE;QACzE,sEAAsE;QACtE,yEAAyE;QACzE,oEAAoE;QACpE,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC;KAC7D;IACD,MAAM,EAAE;QACN,yEAAyE;QACzE,kBAAkB;QAClB,kEAAkE;QAClE,uEAAuE;QACvE,gDAAgD;QAChD,uEAAuE;QACvE,iEAAiE;QACjE,0EAA0E;QAC1E,4DAA4D;QAC5D,8CAA8C;QAC9C,IAAI,EAAE;YACJ,aAAa;YACb,aAAa;YACb,eAAe;YACf,aAAa;YACb,MAAM;YACN,OAAO;YACP,MAAM;YACN,SAAS;YACT,QAAQ;YACR,OAAO;YACP,OAAO;YACP,QAAQ;YACR,OAAO;YACP,eAAe;YACf,aAAa;YACb,MAAM;YACN,cAAc;SACf;KACF;IACD,SAAS,EAAE;QACT,+DAA+D;QAC/D,mEAAmE;QACnE,IAAI,EAAE,EAAE;QACR,KAAK,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;KAClC;CACF,CAAC;AAEF,6BAA6B;AAC7B,MAAM,CAAC,MAAM,uBAAuB,GAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvF,8EAA8E;AAC9E,MAAM,UAAU,qBAAqB,CAAC,KAA4B;IAChE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE;YAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QAC9D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
package/dist/types.d.ts CHANGED
@@ -148,12 +148,53 @@ export type ScanDiagnostic = {
148
148
  /** The budget limit that was hit. */
149
149
  limit: number;
150
150
  };
151
+ /**
152
+ * One boundary-stone hit discovered during a walk — the walk face's share of
153
+ * the report-not-cut principle: which subtrees carry an existence signal
154
+ * (an embedded repository, a declared config home) and where. Pure metadata:
155
+ * the report never changes the file set.
156
+ *
157
+ * - `stoneName` — the stone that hit (the core `.git` — a `.git` directory
158
+ * or one of git's own pointer-file forms, such as a worktree/submodule
159
+ * `gitdir` file; a declared config home; the `.gitignore` proxy when
160
+ * mounted);
161
+ * - `path` — the scan-root-relative POSIX directory directly containing the
162
+ * stone (the nested repository's own directory, not the stone file);
163
+ * - `enforced` — whether the hit executed its cut under the active alignment
164
+ * face and exemption: `true` on the default git face (the entry names where
165
+ * the truncation happened), `false` for scanner-face core-stone hits
166
+ * (report-not-cut) and exemption-neutralized hits (registration, not
167
+ * rescue), and `true` always for config-home hits (your own declarations
168
+ * keep their verdict under every face).
169
+ *
170
+ * The scan root's own stones are not reported — the root is the universe
171
+ * boundary and never adjudicates against itself; only directories the walk
172
+ * visits as descent candidates appear here. Completeness is therefore the
173
+ * walk's: rule-pruned subtrees (preset, `exclude`, dot category) and
174
+ * everything below a budget cut (check `diagnostics`) leave no hits — a
175
+ * silent absence is not negative evidence. `.gitmodules` registration is
176
+ * invisible to the walk: a registered submodule's `.git` file hits exactly
177
+ * like an embedded repository's; `boundaryStones.exempt` is the walk-mode
178
+ * registration for both.
179
+ */
180
+ export interface WalkStoneHit {
181
+ stoneName: string;
182
+ path: string;
183
+ enforced: boolean;
184
+ }
151
185
  /** Result of a {@link walkScope} run. */
152
186
  export interface WalkResult {
153
187
  /** Included files as POSIX relative paths (forward slashes), sorted. */
154
188
  files: string[];
155
189
  /** Diagnostics; empty when the scan completed without a cut. */
156
190
  diagnostics: ScanDiagnostic[];
191
+ /**
192
+ * Boundary-stone hits discovered during the walk, sorted by path then
193
+ * stone name — see {@link WalkStoneHit}. Empty when no directory on the
194
+ * walked tree carried a stone. Report-only: identical options without
195
+ * this field produce the identical `files`.
196
+ */
197
+ stoneHits: WalkStoneHit[];
157
198
  }
158
199
  /** Thrown for malformed engine configuration (a strict rule without a reason, an unknown preset, ...). */
159
200
  export declare class PathscopeConfigError extends Error {
@@ -206,8 +247,8 @@ export interface UniverseResult {
206
247
  /** Repository root as git reports it (`rev-parse --show-toplevel`). */
207
248
  repoRoot: string;
208
249
  /**
209
- * Diagnostics; always empty in 0.1.0 (the universe has no budget — git is
210
- * the authority, not a traversal that could be cut). The field exists for
250
+ * Diagnostics; always empty (the universe has no budget — git is the
251
+ * authority, not a traversal that could be cut). The field exists for
211
252
  * shape parity with {@link WalkResult}.
212
253
  */
213
254
  diagnostics: ScanDiagnostic[];
package/dist/types.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA8JH,0GAA0G;AAC1G,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAwMH,0GAA0G;AAC1G,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}