@ttsc/graph 0.30.3 → 0.31.0

package/lib/model/publishedArtifacts.js

@@ -6,22 +6,38 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.publishArtifacts = publishArtifacts;
 exports.publishArtifactsResident = publishArtifactsResident;
 exports.artifactsAreStale = artifactsAreStale;
+exports.artifactsAreStaleResident = artifactsAreStaleResident;
 exports.watchedBy = watchedBy;
 exports.fingerprintInputs = fingerprintInputs;
-const node_child_process_1 = require("node:child_process");
 const node_crypto_1 = require("node:crypto");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
 const ttsc_1 = require("ttsc");
+const GraphProcessTrace_1 = require("../internal/GraphProcessTrace");
+/**
+ * Discover configured publishers and synchronously publish their artifact set.
+ * Input identity is captured before the graph-nodes verbs to avoid accepting a
+ * concurrent document edit as already represented by an older answer.
+ *
+ * @evidence contracts/common.md#principled-implementation Capability discovery and each sidecar's project-inputs/graph-nodes verbs remain the authorities for plugin selection and artifact meaning.
+ * @evidence contracts/common.md#clear-and-simple-design The one-shot path composes discovery, input capture and publication through helpers also used by resident requests.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Unavailable sidecars do not produce fabricated artifacts; no evidence-rule-specific parser or private compiler mutation substitutes for the publisher.
+ * @evidence contracts/common.md#meaningful-documentation Native prose documents synchronous ownership and the freshness snapshot's required ordering.
+ * @evidence contracts/performance.md#efficient-algorithms Discovery runs once per publication, distinct input paths are merged and fingerprinted once, and publisher JSON is concatenated in one pass.
+ * @evidence contracts/performance.md#reuse-equivalent-work This one-shot caller has no resident sidecar owner; resident consumers use publishArtifactsResident and session freshness reuse instead of repeatedly spawning this path.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources SpawnSync owns each child through completion; the exchange file is overwritten per process/project, but historical project files have no explicit reclamation yet.
+ * @evidence contracts/portability.md#os-neutral-implementation Native paths and temporary storage use Node path/os APIs; sidecars receive argument arrays and hidden Windows child windows without shell composition.
+ */
 function publishArtifacts(options) {
-    const plugins = (0, ttsc_1.resolveCapabilityPlugins)({
+    const discovery = (0, ttsc_1.resolveCapabilityPluginResolution)({
         capability: "graphNodes",
         cwd: options.cwd,
         tsconfig: options.tsconfig,
     });
+    const plugins = discovery.plugins;
     if (plugins.length === 0)
-        return unpublished(options);
+        return unpublished(options, discovery);
     // The inputs are stated before the set is asked for, never after. A document
     // edited between the two calls has to read as a change next time, and only
     // this order gives that: a fingerprint taken first describes a state at least
@@ -30,7 +46,8 @@ function publishArtifacts(options) {
     // the set, and the edit that landed in the gap would read as already
     // accounted for — the exact staleness this exists to remove.
     const inputs = readInputs(plugins.map((plugin) => runVerb(plugin, "project-inputs", options)), options);
-    return assemble(options, inputs, plugins.map((plugin) => runVerb(plugin, "graph-nodes", options)));
+    const fingerprint = fingerprintInputs(inputs);
+    return assemble(options, inputs, fingerprint, plugins.map((plugin) => runVerb(plugin, "graph-nodes", options)), discovery);
 }
 /**
  * The same answer, asked of sidecars this caller keeps open.
@@ -45,29 +62,59 @@ function publishArtifacts(options) {
  * so the answer is the same one either way and only its cost differs. The
  * fallback matters more here than most: a daemon that quietly answered nothing
  * would be indistinguishable from a project that publishes nothing.
+ *
+ * @evidence contracts/common.md#principled-implementation Both paths ask the same configured sidecar verbs; input identity is captured before publication and invalidation clears the daemon's stale Program first.
+ * @evidence contracts/common.md#clear-and-simple-design The caller supplies daemon and asynchronous resolver ownership while this function owns ordered input and artifact phases and the shared result assembly.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts A failed daemon falls back to the public direct verb, not an invented empty-success result or a reimplementation of its parser.
+ * @evidence contracts/common.md#meaningful-documentation Native prose explains resident reuse, direct-command fallback and the reason to invalidate the Program before input collection.
+ * @evidence contracts/performance.md#efficient-algorithms Independent publishers run concurrently within each of two ordered phases; deduplication avoids repeatedly hashing the same declared file path.
+ * @evidence contracts/performance.md#reuse-equivalent-work Session-owned daemons reuse process and plugin loading only while binary, manifest and project context match; changed inputs rebuild the publication.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources The session owns the resolver and daemons. Failed publication joins every selected verb and releases its proof; successful publication transfers proof release to the session. Cancellation closes and joins an active daemon or supervised direct command. One exchange file per process/project still has no historical-file reclamation.
+ * @evidence contracts/portability.md#os-neutral-implementation The fallback preserves native argument-vector invocation and Node path resolution; daemon ownership uses the same cross-platform process boundary.
  */
-async function publishArtifactsResident(options, daemon) {
-    const plugins = (0, ttsc_1.resolveCapabilityPlugins)({
-        capability: "graphNodes",
-        cwd: options.cwd,
-        tsconfig: options.tsconfig,
-    });
-    if (plugins.length === 0)
-        return unpublished(options);
-    // The first request of a republish drops the daemon's warm Program. The
-    // artifacts depend on which sources exist and what they declare — that is
-    // what activates a claim — and between two republishes the developer has
-    // been editing code as well as documents. Reusing a Program from before
-    // those edits would deactivate a claim whose files now exist, which is a
-    // stale answer of exactly the kind this whole mechanism removes. What the
-    // daemon still saves is the process, the plugin load, and the configuration
-    // evaluation, which is most of the cost.
-    const inputs = readInputs(await Promise.all(plugins.map((plugin) => askVerb(plugin, "project-inputs", options, daemon(plugin), true))), options);
-    return assemble(options, inputs, await Promise.all(plugins.map((plugin) => askVerb(plugin, "graph-nodes", options, daemon(plugin), false))));
+async function publishArtifactsResident(options, daemon, resolver) {
+    options.signal?.throwIfAborted();
+    const discovery = await resolver.resolve({ capability: "graphNodes", cwd: options.cwd, tsconfig: options.tsconfig }, { signal: options.signal });
+    try {
+        options.signal?.throwIfAborted();
+        const plugins = discovery.plugins;
+        if (plugins.length === 0)
+            return unpublished(options, discovery);
+        // The first request of a republish drops the daemon's warm Program. The
+        // artifacts depend on which sources exist and what they declare — that is
+        // what activates a claim — and between two republishes the developer has
+        // been editing code as well as documents. Reusing a Program from before
+        // those edits would deactivate a claim whose files now exist, which is a
+        // stale answer of exactly the kind this whole mechanism removes. What the
+        // daemon still saves is the process, the plugin load, and the configuration
+        // evaluation, which is most of the cost.
+        const inputs = readInputs(await joinedPublications(plugins.map(async (plugin) => askVerb(plugin, "project-inputs", options, await daemon(plugin), true, resolver))), options);
+        const fingerprint = fingerprintInputs(inputs);
+        const outputs = await joinedPublications(plugins.map(async (plugin) => askVerb(plugin, "graph-nodes", options, await daemon(plugin), false, resolver)));
+        options.signal?.throwIfAborted();
+        return assemble(options, inputs, fingerprint, outputs, discovery);
+    }
+    catch (error) {
+        try {
+            await discovery.release();
+        }
+        catch (cleanup) {
+            throw new AggregateError([error, cleanup], "@ttsc/graph: discovery release failed");
+        }
+        throw error;
+    }
+}
+/** Join every publisher before releasing a failed publication's proof. */
+async function joinedPublications(outputs) {
+    const results = await Promise.allSettled(outputs);
+    const failures = results.filter((result) => result.status === "rejected");
+    if (failures.length > 0)
+        throw new AggregateError(failures.map((result) => result.reason), "@ttsc/graph: artifact publication failed");
+    return results.map((result) => result.value);
 }
 /** Run one verb as its own process, returning its stdout or `null`. */
 function runVerb(plugin, verb, options) {
-    const result = (0, node_child_process_1.spawnSync)(plugin.binary, [
+    const result = GraphProcessTrace_1.GraphProcessTrace.spawnSync(plugin.binary, [
         verb,
         "--cwd",
         options.cwd,
@@ -97,13 +144,59 @@ function runVerb(plugin, verb, options) {
     return result.stdout;
 }
 /** Ask one verb through a daemon, or as a process when it cannot answer. */
-async function askVerb(plugin, verb, options, daemon, invalidate) {
-    const served = await daemon?.ask(verb, invalidate);
-    return served ?? runVerb(plugin, verb, options);
+async function askVerb(plugin, verb, options, daemon, invalidate, resolver) {
+    options.signal?.throwIfAborted();
+    let closing;
+    const abort = () => {
+        closing = daemon?.close();
+        void closing?.catch(() => undefined);
+    };
+    options.signal?.addEventListener("abort", abort, { once: true });
+    if (options.signal?.aborted)
+        abort();
+    let served;
+    let failure;
+    try {
+        served = await daemon?.ask(verb, invalidate);
+    }
+    catch (error) {
+        failure = error;
+        throw error;
+    }
+    finally {
+        options.signal?.removeEventListener("abort", abort);
+        try {
+            await closing;
+        }
+        catch (cleanup) {
+            throw new AggregateError([
+                ...(failure === undefined ? [] : [failure]),
+                ...(options.signal?.aborted ? [options.signal.reason] : []),
+                cleanup,
+            ], "@ttsc/graph: cancelled daemon cleanup failed");
+        }
+    }
+    options.signal?.throwIfAborted();
+    if (served !== undefined && served !== null)
+        return served;
+    const result = await resolver.runCommand(plugin.binary, [
+        verb,
+        "--cwd",
+        options.cwd,
+        "--tsconfig",
+        options.tsconfig,
+        `--plugins-json=${plugin.manifest}`,
+        ...projectContextArgs(plugin),
+    ], { maxBuffer: 256 * 1024 * 1024, encoding: "utf8", windowsHide: true }, { signal: options.signal });
+    options.signal?.throwIfAborted();
+    return result.error ||
+        result.status !== 0 ||
+        typeof result.stdout !== "string"
+        ? null
+        : result.stdout;
 }
 /** The artifact answer, from each sidecar's `graph-nodes` output. */
-function assemble(options, inputs, outputs) {
-    const fingerprint = fingerprintInputs(inputs);
+function assemble(options, inputs, fingerprint, outputs, discovery) {
     const published = [];
     for (const output of outputs) {
         if (output === null)
@@ -111,14 +204,15 @@ function assemble(options, inputs, outputs) {
         try {
             const parsed = JSON.parse(output);
             if (Array.isArray(parsed))
-                published.push(...parsed);
+                for (const entryToAppend of parsed)
+                    published.push(entryToAppend);
         }
         catch {
             continue;
         }
     }
     if (published.length === 0)
-        return { file: null, fingerprint, inputs };
+        return { file: null, fingerprint, inputs, discovery };
     // One file per process and project, overwritten, rather than a fresh temp
     // directory per call. A directory per call is a leak nothing here is
     // positioned to clean — the path outlives this function by design, since the
@@ -134,23 +228,57 @@ function assemble(options, inputs, outputs) {
     // impossible.
     const file = node_path_1.default.join(node_os_1.default.tmpdir(), `ttsc-graph-artifacts-${String(process.pid)}-${projectKey(options)}.json`);
     node_fs_1.default.writeFileSync(file, JSON.stringify(published));
-    return { file, fingerprint, inputs };
+    return { file, fingerprint, inputs, discovery };
 }
 /**
  * Whether the inputs an answer was derived from have moved since.
  *
- * Answered by stating paths this process already knows, not by asking the
- * plugin again. The question is asked before every graph request in a resident
- * session, and re-running plugin discovery per request would cost more than the
- * refresh it guards — while a `stat` per document costs less than reading one
- * of them.
+ * Published documents are compared by content identity. The owning resolver
+ * separately qualifies discovery, including successful absence. Unavailable,
+ * incomplete or changed discovery proof requires another lookup.
  *
- * The cost of being wrong in the cheap direction is what makes this worth
- * paying at all: a developer who edited only a spec section, and nothing the
- * compiler reads, otherwise saw the graph keep answering with the headings that
- * section used to have.
+ * @evidence contracts/common.md#principled-implementation The owning discovery query must still qualify this exact lookup, and exchange-file existence plus declared input identity must also hold before any publication or successful absence is reused.
+ * @evidence contracts/common.md#clear-and-simple-design Discovery freshness stays with the resolver and downstream document identity stays with fingerprintInputs; this predicate combines their independent authority.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Equal size and modification time cannot substitute for file-content equivalence, and a partial no-plugin watch list cannot prove discovery stability.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain content-based publication freshness, successful absence and conservative relookup for incomplete discovery proof.
+ * @evidence contracts/performance.md#efficient-algorithms Freshness hashes the distinct declared inputs and traverses watch roots once per inventory entry; its cost grows with watched bytes and entries rather than only stat count.
+ * @evidence contracts/performance.md#reuse-equivalent-work The resolver's original complete discovery proof authorizes sharing populated or empty results; changed or unproved selection requires relookup, and document fingerprints separately qualify overlay reuse.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources This predicate borrows an inventory and returns a boolean; the publication and session own their storage and sidecars.
+ * @evidence contracts/portability.md#os-neutral-implementation Existence and fingerprints use Node filesystem APIs and native absolute paths without assumptions about platform shell commands.
  */
 function artifactsAreStale(published) {
+    // Discovery remains the loader's authority, including successful absence.
+    // A downstream input list cannot replace an unavailable or incomplete proof.
+    if (published.discovery?.status !== "resolved" ||
+        !published.discovery.isCurrent())
+        return true;
+    return artifactInputsAreStale(published);
+}
+/**
+ * Check the exact resident discovery proof before reusing its overlay.
+ * Discovery runs off the request thread; declared artifact bytes remain an
+ * independent freshness premise after that authority has answered.
+ *
+ * @evidence contracts/common.md#principled-implementation The original asynchronous proof must authorize reuse before exchange existence and declared input fingerprints are compared.
+ * @evidence contracts/common.md#clear-and-simple-design Resolver proof and artifact-input validation retain their separate owners in one ordered predicate.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Unavailable or invalid proof requires relookup; no partial inventory substitutes for SDK authority.
+ * @evidence contracts/common.md#meaningful-documentation Native prose distinguishes off-thread discovery from this consumer's independent artifact inputs.
+ * @evidence contracts/performance.md#efficient-algorithms The owner validates discovery once and fingerprintInputs hashes each declared file and directory inventory, scaling with declared entries and bytes.
+ * @evidence contracts/performance.md#reuse-equivalent-work Only this exact publication's current proof plus unchanged artifact inputs authorizes reuse, including resolved absence.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources This predicate borrows the session-owned publication and acquires no lasting proof or process.
+ * @evidence contracts/portability.md#os-neutral-implementation SDK process observation remains with its owner and artifact checks use Node native filesystem APIs.
+ */
+async function artifactsAreStaleResident(published, options = {}) {
+    options.signal?.throwIfAborted();
+    if (published.discovery.status !== "resolved")
+        return true;
+    const current = await published.discovery.isCurrent(options);
+    options.signal?.throwIfAborted();
+    if (!current)
+        return true;
+    return artifactInputsAreStale(published);
+}
+function artifactInputsAreStale(published) {
     // The written set is one of its own inputs, by existence alone. It lives in
     // the system temp directory, which is swept on a schedule this session has no
     // say in, and the server is handed the path on every request — so once it is
@@ -169,18 +297,12 @@ function artifactsAreStale(published) {
  * The answer for a project that publishes nothing, and what to watch so that
  * answer can change.
  *
- * Configuring a plugin means editing the project's tsconfig or installing a
- * package that declares one, so those two files are what could turn this answer
- * into a different one. They are stated rather than the whole discovery being
- * re-run, because re-running it walks the dependency closure — the cost
- * samchon/ttsc#1276 is about — and paying that per request to learn nothing
- * would be worse than the staleness it prevents.
- *
- * Bounded, and deliberately: a tsconfig that inherits its plugins from an
- * extended config is not tracked here, because naming the whole extends chain
- * means asking the loader that is itself the expense.
+ * The direct config and package manifest are useful provenance, but do not
+ * cover inherited configuration or dependency installation. The attached owning
+ * discovery proof supplies that independent authority; direct paths do not
+ * stand in for it.
  */
-function unpublished(options) {
+function unpublished(options, discovery) {
     const inputs = {
         directories: [],
         files: [
@@ -188,7 +310,12 @@ function unpublished(options) {
             node_path_1.default.resolve(options.cwd, "package.json"),
         ],
     };
-    return { file: null, fingerprint: fingerprintInputs(inputs), inputs };
+    return {
+        file: null,
+        fingerprint: fingerprintInputs(inputs),
+        inputs,
+        discovery,
+    };
 }
 /**
  * What each sidecar said its rules read, as one watch list.
@@ -260,14 +387,26 @@ function readInputs(outputs, options) {
  * Two readings have to be right here, and both are cheap to get wrong. A
  * pattern carrying no wildcard is a path, not a tree: watching its parent
  * instead would state every sibling on every request to learn about the one
- * file that was declared. And a pattern that does not say `**` does not descend
- * — treating it as though it did is unbounded in exactly the case that looks
- * harmless, because a bare `*.md` has the project root for its prefix.
+ * file that was declared. A bare filename wildcard stays shallow; globstar or a
+ * wildcard directory component requires descent from the fixed prefix.
+ *
+ * @evidence contracts/common.md#principled-implementation Literal paths remain individual inputs; wildcard paths use their fixed directory prefix and descend when remaining path components can contain matched files.
+ * @evidence contracts/common.md#clear-and-simple-design A single fixed-prefix calculation and descent decision produce the directory descriptor consumed by fingerprinting.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Descent is not inferred solely from globstar, which would miss wildcard directory components followed by a filename.
+ * @evidence contracts/common.md#meaningful-documentation Native prose documents literal paths, bare wildcards and wildcard-directory descent.
+ * @evidence contracts/performance.md#efficient-algorithms Pattern scanning is linear in pattern length and avoids directory traversal at selection time; a bare filename wildcard keeps the walk shallow.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work This pure descriptor calculation has no cross-request producer or validation coordinator; publication owns reuse.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources The returned descriptor transfers to its caller and owns no handle or retained task.
+ * @evidence contracts/portability.md#os-neutral-implementation Both slash forms are recognized at the native-path boundary and relative roots resolve through Node path APIs.
  */
 function watchedBy(pattern, cwd) {
     if (pattern.search(GLOB_MAGIC) < 0)
         return null;
-    return { path: globRoot(pattern, cwd), recursive: pattern.includes("**") };
+    const magic = pattern.search(GLOB_MAGIC);
+    return {
+        path: globRoot(pattern, cwd),
+        recursive: pattern.includes("**") || /[/\\]/u.test(pattern.slice(magic)),
+    };
 }
 /**
  * The project identity flag, for a plugin whose descriptor asks for one.
@@ -310,37 +449,67 @@ function absolute(target, cwd) {
 /**
  * The state of every input, as one comparable string.
  *
- * Files are stated by size and modification time rather than content: this runs
- * before every graph request, and hashing a documentation corpus per request
- * would cost more than the refresh it guards. Directories are walked for the
- * same pair, which is what notices a section added or a document deleted rather
- * than edited.
+ * Files are hashed by content so same-size edits with restored modification
+ * times remain observable. Directory membership is walked conservatively from
+ * declared roots; matching remains the sidecar's responsibility.
+ *
+ * @evidence contracts/common.md#principled-implementation The fingerprint includes input paths and regular-file bytes; sorted records make enumeration order irrelevant while missing paths retain an explicit marker.
+ * @evidence contracts/common.md#clear-and-simple-design File state and conservative directory traversal share one record representation before the final digest.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Metadata equality, hidden-directory skipping and arbitrary depth limits do not stand in for declared input identity.
+ * @evidence contracts/common.md#meaningful-documentation Native prose states content hashing, conservative membership and sidecar ownership of actual matching.
+ * @evidence contracts/performance.md#efficient-algorithms Cost is linear in watched regular-file bytes plus O(N log N) record sorting; broad recursive globs conservatively over-read and may invalidate unrelated edits.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work This computes one validation identity; the session compares it with the publication snapshot and decides reuse.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources Synchronous reads close their descriptors internally, and the record array exists only for this computation; no historical fingerprint state is retained here.
+ * @evidence contracts/portability.md#os-neutral-implementation Native stat, read and directory APIs handle platform paths; NUL-separated fields prevent filename ambiguity without shell serialization.
  */
 function fingerprintInputs(inputs) {
     const parts = [];
+    const states = new Map();
     for (const file of inputs.files)
-        parts.push(stateOf(file));
+        parts.push(stateOf(file, states));
     for (const directory of inputs.directories)
-        parts.push(...walkState(directory.path, directory.recursive));
+        for (const entryToAppend of walkState(directory.path, directory.recursive, states))
+            parts.push(entryToAppend);
     parts.sort();
     return (0, node_crypto_1.createHash)("sha256").update(parts.join("\n")).digest("hex");
 }
 /**
- * A path's size and modification time, or a marker when it is absent.
+ * A regular file's content identity, physical directory identity, or absence.
  *
  * The fields are joined on a character a path cannot contain. Separated by a
  * space, a file literally named `a 1 2` states the same string as a one-byte
  * file named `a`, and an edit to either would then read as no edit at all.
  */
-function stateOf(file) {
+function stateOf(file, states) {
+    const existing = states.get(file);
+    if (existing !== undefined)
+        return existing;
     try {
         const stat = node_fs_1.default.statSync(file);
-        return [file, String(stat.size), String(stat.mtimeMs)].join(SEPARATOR);
+        const identity = stat.isFile()
+            ? (0, node_crypto_1.createHash)("sha256").update(node_fs_1.default.readFileSync(file)).digest("hex")
+            : stat.isDirectory()
+                ? ["directory", node_fs_1.default.realpathSync.native(file)].join(SEPARATOR)
+                : ["other", String(stat.size), String(stat.mtimeMs)].join(SEPARATOR);
+        const state = [file, identity].join(SEPARATOR);
+        states.set(file, state);
+        return state;
     }
-    catch {
-        return [file, "absent"].join(SEPARATOR);
+    catch (error) {
+        if (!missingPath(error))
+            throw error;
+        const state = [file, "absent"].join(SEPARATOR);
+        states.set(file, state);
+        return state;
     }
 }
+/** Missing paths are inputs; unreadable existing inputs are failures. */
+function missingPath(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        (error.code === "ENOENT" || error.code === "ENOTDIR"));
+}
 /**
  * The character that joins fields a path could otherwise forge.
  *
@@ -360,43 +529,60 @@ function globRoot(pattern, cwd) {
     const magic = pattern.search(GLOB_MAGIC);
     const head = magic < 0 ? pattern : pattern.slice(0, magic);
     const slash = Math.max(head.lastIndexOf("/"), head.lastIndexOf("\\"));
-    const root = slash < 0 ? "" : head.slice(0, slash);
+    const root = slash < 0
+        ? ""
+        : head.slice(0, Math.max(slash, node_path_1.default.parse(head).root.length));
     return root === "" ? cwd : absolute(root, cwd);
 }
 /**
  * Every entry below `directory`, stated.
  *
- * Bounded three ways, because this runs before every graph request: it descends
- * only when the pattern that named the directory descends, it never enters
- * `node_modules`, and it stops at a depth no documentation tree reaches. Dotted
- * directories are skipped below the declared root, which is what the glob that
- * named it would have matched anyway.
+ * Descent follows the declared pattern rather than a guessed maximum depth or
+ * excluded directory name. Symlink directories are followed with a physical
+ * ancestor set so their declared contents are watched without creating cycles.
  *
  * A directory that does not exist states itself absent, which is what notices
  * one being created.
  */
-function walkState(directory, recursive, depth = 0) {
-    if (depth > 12)
-        return [];
+function walkState(directory, recursive, inputStates, ancestors = new Set()) {
     let entries;
+    let physical;
     try {
+        physical = node_fs_1.default.realpathSync.native(directory);
+        if (ancestors.has(physical))
+            return [stateOf(directory, inputStates)];
         entries = node_fs_1.default.readdirSync(directory, { withFileTypes: true });
     }
-    catch {
-        return [stateOf(directory)];
+    catch (error) {
+        if (!missingPath(error))
+            throw error;
+        return [stateOf(directory, inputStates)];
     }
+    const nextAncestors = new Set(ancestors);
+    nextAncestors.add(physical);
     const states = [];
     for (const entry of entries) {
         const child = node_path_1.default.join(directory, entry.name);
-        if (entry.isDirectory()) {
-            if (!recursive)
-                continue;
-            if (entry.name === "node_modules" || entry.name.startsWith("."))
+        let directoryEntry = entry.isDirectory();
+        if (entry.isSymbolicLink()) {
+            try {
+                directoryEntry = node_fs_1.default.statSync(child).isDirectory();
+            }
+            catch (error) {
+                if (!missingPath(error))
+                    throw error;
+            }
+        }
+        if (directoryEntry) {
+            if (!recursive) {
+                states.push(stateOf(child, inputStates));
                 continue;
-            states.push(...walkState(child, recursive, depth + 1));
+            }
+            for (const entryToAppend of walkState(child, recursive, inputStates, nextAncestors))
+                states.push(entryToAppend);
             continue;
         }
-        states.push(stateOf(child));
+        states.push(stateOf(child, inputStates));
     }
     return states;
 }

package/lib/model/publishedArtifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"publishedArtifacts.js","sourceRoot":"","sources":["../../src/model/publishedArtifacts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"publishedArtifacts.js","sourceRoot":"","sources":["../../src/model/publishedArtifacts.ts"],"names":[],"mappings":"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"}

package/lib/nativeExecutable.d.ts

@@ -1,3 +1,4 @@
+import type { CapturedProcessOutput } from "./CapturedProcessOutput";
 /**
  * Ensure a resolved native binary can be executed on POSIX installs.
  *
@@ -5,16 +6,17 @@
  * package binaries without executable bits. The ttsc launcher already repairs
  * its native helper before spawning; @ttsc/graph has its own ttscgraph spawn
  * paths, so it must apply the same first-run repair here.
+ *
+ * @evidence contracts/common.md#principled-implementation POSIX executable access is checked before preserving existing permission bits and adding the required execution permissions.
+ * @evidence contracts/common.md#clear-and-simple-design This helper owns the native permission boundary for all graph spawn lanes.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Permission repair addresses supported package installation differences; failures still reach the original spawn path.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain the package-manager condition and why graph must apply its own spawn-boundary repair.
+ * @evidence contracts/performance.md#efficient-algorithms Permission repair uses constant-count access/stat/chmod operations without reading binary contents or scanning directories.
+ * @evidenceExclude contracts/performance.md#reuse-equivalent-work Permission is an effectful spawn precondition, not a completed producer result shared across requests.
+ * @evidenceExclude contracts/performance.md#bound-retention-and-release-resources This precondition retains no handle, task or historical entry after synchronous filesystem calls.
+ * @evidence contracts/portability.md#os-neutral-implementation Windows has no POSIX executable-bit requirement; other hosts use filesystem access and mode APIs rather than path spelling assumptions.
  */
 export declare function ensureExecutable(binary: string): void;
-export interface CapturedProcessOutput {
-    /** Close the descriptors and remove the backing files. */
-    dispose(): void;
-    /** Read one stream's text. */
-    read(stream: "stdout" | "stderr"): string;
-    stderrFd: number;
-    stdoutFd: number;
-}
 /**
  * A pair of temporary files standing in for a child process's pipes.
  *
@@ -27,5 +29,14 @@ export interface CapturedProcessOutput {
  * the same answer everywhere. Reading the result back still materializes a
  * string, so V8's own maximum string length remains the outer bound — a
  * property of the runtime rather than a budget chosen here.
+ *
+ * @evidence contracts/common.md#principled-implementation Passing file descriptors avoids spawnSync's pipe-buffer limit while later UTF-8 reads preserve each output channel.
+ * @evidence contracts/common.md#clear-and-simple-design One factory transfers descriptor and directory ownership through a read/dispose handle; private helpers isolate cleanup.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The capture uses supported spawn descriptors rather than patching child_process or imposing repository-sized output limits.
+ * @evidence contracts/common.md#meaningful-documentation Native paragraphs explain file capture, heap materialization and the runtime string-length boundary; the handle documents caller disposal.
+ * @evidence contracts/portability.md#os-neutral-implementation Native fs descriptors and path.join operate on every host; storage is created beneath the resolved physical system-temp directory.
+ * @evidence contracts/performance.md#efficient-algorithms Capturing writes directly to files; reading costs linear output bytes and materializes one stream string, with no pipe-buffer copy in this heap.
+ * @evidence contracts/performance.md#reuse-equivalent-work Stdout and stderr are distinct effectful streams from one child invocation; reruns require new storage and cannot reuse a prior result.
+ * @evidence contracts/performance.md#bound-retention-and-release-resources The returned owner disposes two descriptors and one directory; acquisition failure unwinds acquired storage and removal is best effort when foreign handles remain open.
  */
 export declare function captureProcessOutput(): CapturedProcessOutput;