@procedures/dag 0.2.3 → 0.4.0

package/dist/index.d.ts

@@ -39,4 +39,7 @@
  */
 export type { DAGNode, DependencyDAG, DAGExecutionOptions, NodeResult, DAGResult, NodeProcessor, } from "./types.js";
 export { buildLeveledDAG, getTopologicalOrder, visualizeDAG, executeDAG, executeDAGSequential, createProcessor, filterDAGFromRoot, getAncestors, getDescendants, createNode, buildNodeMap, } from "./dag/index.js";
+export * from "./module.js";
+export { DagTraverseInputSchema, DagTraverseOutputSchema, type DagTraverseInput, type DagTraverseOutput, type TraverseNodeResult, type ScannedPackage, type ScanOutput, type PackageNode, } from "./procedures/types.js";
+export { dagTraverse, packageNodes, callsGit, keyedLock, repositoryRoot } from "./procedures/traverse.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,YAAY,EACV,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,YAAY,GACb,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,YAAY,EACV,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,SAAS,EACT,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,YAAY,GACb,MAAM,gBAAgB,CAAC;AAIxB,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -39,4 +39,9 @@
  */
 // DAG utilities
 export { buildLeveledDAG, getTopologicalOrder, visualizeDAG, executeDAG, executeDAGSequential, createProcessor, filterDAGFromRoot, getAncestors, getDescendants, createNode, buildNodeMap, } from "./dag/index.js";
+// The procedure dag.traverse. The root registers nothing: import "@procedures/dag/register", or
+// give the module to createRegistry() with the module of @procedures/lib.
+export * from "./module.js";
+export { DagTraverseInputSchema, DagTraverseOutputSchema, } from "./procedures/types.js";
+export { dagTraverse, packageNodes, callsGit, keyedLock, repositoryRoot } from "./procedures/traverse.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAYH,gBAAgB;AAChB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,YAAY,GACb,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAYH,gBAAgB;AAChB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,gGAAgG;AAChG,0EAA0E;AAC1E,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GAOxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/module.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * The package has one procedure, `dag.traverse`. It came from `@procedures/lib`, and its name
+ * stays the same. The graph algorithms of the package root do not need this module.
+ */
+import { type ProcedureModule, type ProcedureRegistry } from "@procedures/client";
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
+ *
+ * `dag.traverse` uses `lib.scan`. This module cannot list the module of `@procedures/lib` as a
+ * dependency, because that package depends on this one. A host registers both modules
+ * (`bundle-dev`, `bundle-mcp` and `mark` do).
+ */
+export declare const dagModule: ProcedureModule;
+export default dagModule;
+/**
+ * This function registers the procedures of @procedures/dag in a registry. The default is the
+ * global registry. Importing this file registers nothing: the `./register` entry starts this
+ * function (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+export declare function registerDagProcedures(registry?: ProcedureRegistry): void;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAQL,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAuC5B;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,EAAE,eAAyE,CAAC;eAEnF,SAAS;AAExB;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,GAAE,iBAAsC,GAAG,IAAI,CAE5F"}

package/dist/module.js

@@ -0,0 +1,55 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * The package has one procedure, `dag.traverse`. It came from `@procedures/lib`, and its name
+ * stays the same. The graph algorithms of the package root do not need this module.
+ */
+import { createProcedure, zodAdapter, RUNS_REFS_TAG, defineModule, PROCEDURE_REGISTRY, registerModules, } from "@procedures/client";
+import { dagTraverse } from "./procedures/traverse.js";
+import { DagTraverseInputSchema, DagTraverseOutputSchema, } from "./procedures/types.js";
+// =============================================================================
+// dag.* Procedures
+// =============================================================================
+const dagTraverseProcedure = createProcedure()
+    .path(["dag", "traverse"])
+    .input(zodAdapter(DagTraverseInputSchema))
+    .output(zodAdapter(DagTraverseOutputSchema))
+    .meta({
+    description: "Traverse ecosystem packages in dependency order, executing visit procedure for each",
+    // It runs the procedure refs of its input: a server with an expose rule limits what they call
+    tags: [RUNS_REFS_TAG],
+    // It gets the packages from lib.scan (@procedures/lib). This package cannot import that one,
+    // because @procedures/lib depends on this package.
+    calls: ["lib.scan"],
+    // Its own effect is the scan of the workspace. The admission examines each visit call.
+    effects: { reads: ["fs"], writes: [] },
+    args: [],
+    shorts: { root: "r", concurrency: "j", continueOnError: "c", dryRun: "d" },
+    output: "streaming",
+})
+    .handler(async (input, ctx) => {
+    return dagTraverse(input, ctx);
+})
+    .build();
+// =============================================================================
+// Registration
+// =============================================================================
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
+ *
+ * `dag.traverse` uses `lib.scan`. This module cannot list the module of `@procedures/lib` as a
+ * dependency, because that package depends on this one. A host registers both modules
+ * (`bundle-dev`, `bundle-mcp` and `mark` do).
+ */
+export const dagModule = defineModule("@procedures/dag", [dagTraverseProcedure]);
+export default dagModule;
+/**
+ * This function registers the procedures of @procedures/dag in a registry. The default is the
+ * global registry. Importing this file registers nothing: the `./register` entry starts this
+ * function (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+export function registerDagProcedures(registry = PROCEDURE_REGISTRY) {
+    registerModules(registry, [dagModule]);
+}
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,eAAe,EACf,UAAU,EACV,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,eAAe,GAIhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GAGxB,MAAM,uBAAuB,CAAC;AAE/B,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,MAAM,oBAAoB,GAAG,eAAe,EAAE;KAC3C,IAAI,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;KACzB,KAAK,CAAC,UAAU,CAAmB,sBAAsB,CAAC,CAAC;KAC3D,MAAM,CAAC,UAAU,CAAoB,uBAAuB,CAAC,CAAC;KAC9D,IAAI,CAAC;IACJ,WAAW,EAAE,qFAAqF;IAClG,8FAA8F;IAC9F,IAAI,EAAE,CAAC,aAAa,CAAC;IACrB,6FAA6F;IAC7F,mDAAmD;IACnD,KAAK,EAAE,CAAC,UAAU,CAAC;IACnB,uFAAuF;IACvF,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IACtC,IAAI,EAAE,EAAE;IACR,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;IAC1E,MAAM,EAAE,WAAW;CACpB,CAAC;KACD,OAAO,CAAC,KAAK,EAAE,KAAuB,EAAE,GAAqB,EAA8B,EAAE;IAC5F,OAAO,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACjC,CAAC,CAAC;KACD,KAAK,EAAE,CAAC;AAEX,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,SAAS,GAAoB,YAAY,CAAC,iBAAiB,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAElG,eAAe,SAAS,CAAC;AAEzB;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAQ,GAAsB,kBAAkB;IACpF,eAAe,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/procedures/traverse.d.ts

@@ -0,0 +1,63 @@
+/**
+ * dag.traverse procedure
+ *
+ * General-purpose DAG traversal that executes a visit procedure
+ * for each node in dependency order.
+ *
+ * This enables declarative composition of traversals:
+ * ```typescript
+ * // Execute git add on all packages (using $when: "$parent")
+ * await client.exec({
+ *   $proc: ["dag", "traverse"],
+ *   input: {
+ *     visit: {
+ *       $proc: ["git", "add"],
+ *       input: { all: true },
+ *       $when: "$parent"  // Defer to dag.traverse
+ *     }
+ *   }
+ * });
+ *
+ * // Simple form with just procedure path
+ * await client.exec({
+ *   $proc: ["dag", "traverse"],
+ *   input: {
+ *     visit: ["git", "add"]
+ *   }
+ * });
+ * ```
+ *
+ * The `$when` field controls when nested $proc refs are executed:
+ * - "$immediate" (default): Execute during hydration
+ * - "$parent": Defer to parent procedure (dag.traverse executes per-node)
+ * - "$never": Never auto-execute, pass as pure data
+ *
+ * The procedure gets the packages of the workspace from `lib.scan` of `@procedures/lib`, through
+ * `ctx.client`. It does not import that package, because `@procedures/lib` depends on this one.
+ * Thus a registry with `dag.traverse` also needs the module of `@procedures/lib`.
+ */
+import type { ProcedureContext } from "@procedures/client";
+import type { DagTraverseInput, DagTraverseOutput, PackageNode, ScanOutput } from "./types.js";
+/**
+ * This function gives the nodes of the packages of a `lib.scan` output. A dependency on a
+ * package that the scan did not find is not an edge.
+ */
+export declare function packageNodes(packages: ScanOutput["packages"]): Map<string, PackageNode>;
+/** The folder of the git repository that holds `path` (it has `.git`), or `path` itself. */
+export declare function repositoryRoot(path: string): string;
+/** True when the value names a `git` procedure: a path, or a `$proc` ref at any depth. */
+export declare function callsGit(value: unknown): boolean;
+/**
+ * Run the tasks of one key one at a time, in the order of the calls. Tasks of other keys run
+ * in parallel.
+ */
+export declare function keyedLock(): <T>(key: string, task: () => Promise<T>) => Promise<T>;
+/**
+ * Execute a DAG traversal with a custom visit procedure
+ *
+ * The visits of nodes in one git repository run one at a time when the visit calls git (or
+ * with `serialize: "repository"`). All the packages of a workspace share one repository, and
+ * concurrent `git add` calls failed on `index.lock` (deep dive DATA-17).
+ */
+export declare function dagTraverse(input: DagTraverseInput, ctx: ProcedureContext): Promise<DagTraverseOutput>;
+//# sourceMappingURL=traverse.d.ts.map

package/dist/procedures/traverse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.d.ts","sourceRoot":"","sources":["../../src/procedures/traverse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,oBAAoB,CAAC;AAE1E,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,UAAU,EAEX,MAAM,YAAY,CAAC;AAQpB;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAWvF;AAED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED,0FAA0F;AAC1F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAShD;AAED;;;GAGG;AACH,wBAAgB,SAAS,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAkBlF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAgL5B"}

package/dist/procedures/traverse.js

@@ -0,0 +1,275 @@
+/**
+ * dag.traverse procedure
+ *
+ * General-purpose DAG traversal that executes a visit procedure
+ * for each node in dependency order.
+ *
+ * This enables declarative composition of traversals:
+ * ```typescript
+ * // Execute git add on all packages (using $when: "$parent")
+ * await client.exec({
+ *   $proc: ["dag", "traverse"],
+ *   input: {
+ *     visit: {
+ *       $proc: ["git", "add"],
+ *       input: { all: true },
+ *       $when: "$parent"  // Defer to dag.traverse
+ *     }
+ *   }
+ * });
+ *
+ * // Simple form with just procedure path
+ * await client.exec({
+ *   $proc: ["dag", "traverse"],
+ *   input: {
+ *     visit: ["git", "add"]
+ *   }
+ * });
+ * ```
+ *
+ * The `$when` field controls when nested $proc refs are executed:
+ * - "$immediate" (default): Execute during hydration
+ * - "$parent": Defer to parent procedure (dag.traverse executes per-node)
+ * - "$never": Never auto-execute, pass as pure data
+ *
+ * The procedure gets the packages of the workspace from `lib.scan` of `@procedures/lib`, through
+ * `ctx.client`. It does not import that package, because `@procedures/lib` depends on this one.
+ * Thus a registry with `dag.traverse` also needs the module of `@procedures/lib`.
+ */
+import { existsSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { isAnyProcedureRef, hydrateInput, scopeOf } from "@procedures/client";
+import { buildLeveledDAG, executeDAG, createProcessor, filterDAGFromRoot, } from "../dag/index.js";
+/**
+ * This function gives the nodes of the packages of a `lib.scan` output. A dependency on a
+ * package that the scan did not find is not an edge.
+ */
+export function packageNodes(packages) {
+    const nodes = new Map();
+    for (const [name, info] of Object.entries(packages)) {
+        nodes.set(name, {
+            id: name,
+            name,
+            repoPath: info.repoPath,
+            dependencies: info.mark1russell7Deps.filter((dep) => packages[dep] !== undefined),
+        });
+    }
+    return nodes;
+}
+/** The folder of the git repository that holds `path` (it has `.git`), or `path` itself. */
+export function repositoryRoot(path) {
+    let current = resolve(path);
+    for (;;) {
+        if (existsSync(join(current, ".git")))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return resolve(path);
+        current = parent;
+    }
+}
+/** True when the value names a `git` procedure: a path, or a `$proc` ref at any depth. */
+export function callsGit(value) {
+    if (Array.isArray(value)) {
+        if (value[0] === "git" && value.every((part) => typeof part === "string"))
+            return true;
+        return value.some(callsGit);
+    }
+    if (typeof value === "object" && value !== null) {
+        return Object.values(value).some(callsGit);
+    }
+    return false;
+}
+/**
+ * Run the tasks of one key one at a time, in the order of the calls. Tasks of other keys run
+ * in parallel.
+ */
+export function keyedLock() {
+    const tails = new Map();
+    return async (key, task) => {
+        const previous = tails.get(key) ?? Promise.resolve();
+        let release;
+        const done = new Promise((resolveDone) => {
+            release = resolveDone;
+        });
+        const tail = previous.then(() => done);
+        tails.set(key, tail);
+        await previous;
+        try {
+            return await task();
+        }
+        finally {
+            release();
+            if (tails.get(key) === tail)
+                tails.delete(key);
+        }
+    };
+}
+/**
+ * Execute a DAG traversal with a custom visit procedure
+ *
+ * The visits of nodes in one git repository run one at a time when the visit calls git (or
+ * with `serialize: "repository"`). All the packages of a workspace share one repository, and
+ * concurrent `git add` calls failed on `index.lock` (deep dive DATA-17).
+ */
+export async function dagTraverse(input, ctx) {
+    const startTime = Date.now();
+    const results = [];
+    // Scan for all packages (lib.scan of @procedures/lib)
+    const scanResult = await ctx.client.call(["lib", "scan"], input.rootPath !== undefined ? { rootPath: input.rootPath } : {});
+    let allNodes = packageNodes(scanResult.packages);
+    // Filter to specific packages if requested
+    if (input.filter && input.filter.length > 0) {
+        const filtered = new Map();
+        for (const name of input.filter) {
+            const node = allNodes.get(name);
+            if (node) {
+                filtered.set(name, node);
+            }
+        }
+        allNodes = filtered;
+    }
+    // Filter to root and its dependencies if requested
+    if (input.root) {
+        const rootNode = allNodes.get(input.root);
+        if (!rootNode) {
+            return {
+                success: false,
+                results: [],
+                totalDuration: Date.now() - startTime,
+                visited: 0,
+                failed: 0,
+            };
+        }
+        allNodes = filterDAGFromRoot(allNodes, input.root);
+    }
+    // Build DAG for dependency-ordered execution
+    const dag = buildLeveledDAG(allNodes);
+    // Determine how to execute the visit procedure
+    // visit can be:
+    // - Array: procedure path like ["git", "add"]
+    // - $proc ref: { $proc: [...], input: {...}, $when: "$parent" }
+    const visitIsRef = isAnyProcedureRef(input.visit);
+    let visitPath;
+    let baseInput = {};
+    if (Array.isArray(input.visit)) {
+        visitPath = input.visit;
+    }
+    else if (visitIsRef && typeof input.visit === "object" && "$proc" in input.visit) {
+        visitPath = input.visit.$proc;
+        baseInput = input.visit.input ?? {};
+    }
+    else {
+        throw new Error("visit must be a procedure path or $proc reference with $when");
+    }
+    const serialize = input.serialize ?? "auto";
+    const oneAtATime = serialize === "repository" || (serialize === "auto" && callsGit(input.visit));
+    const lock = keyedLock();
+    // Create processor that executes visit procedure per node
+    const processor = createProcessor(async (node) => {
+        if (oneAtATime) {
+            await lock(repositoryRoot(node.repoPath), () => visit(node));
+        }
+        else {
+            await visit(node);
+        }
+    });
+    async function visit(node) {
+        if (input.dryRun) {
+            results.push({
+                name: node.name,
+                path: node.repoPath,
+                success: true,
+                duration: 0,
+                output: { dryRun: true, wouldExecute: visitPath },
+            });
+            return;
+        }
+        const nodeStartTime = Date.now();
+        try {
+            // Merge base input with node context
+            const visitInput = {
+                ...(typeof baseInput === "object" ? baseInput : {}),
+                cwd: node.repoPath,
+                node: {
+                    name: node.name,
+                    path: node.repoPath,
+                    dependencies: node.dependencies,
+                },
+            };
+            // Create executor for hydration that injects cwd into every call
+            const executor = async (path, inp) => {
+                // Inject cwd into the input so nested procedures run in correct directory
+                const inputWithCwd = typeof inp === "object" && inp !== null
+                    ? { ...inp, cwd: node.repoPath }
+                    : inp;
+                return ctx.client.call(path, inputWithCwd);
+            };
+            // Hydrate the input (execute any nested procedure refs like chain steps)
+            // Push "dag.traverse" onto context stack so refs with $when: "dag.traverse" execute
+            const hydratedInput = await hydrateInput(visitInput, executor, {
+                contextStack: ["dag.traverse"],
+                onRef: ctx.onRef,
+                // The names of the chain around this procedure: a `$ref` in the visit can read them
+                scope: scopeOf(input),
+            });
+            // Execute visit procedure with hydrated input
+            const output = await ctx.client.call(visitPath, hydratedInput);
+            results.push({
+                name: node.name,
+                path: node.repoPath,
+                success: true,
+                duration: Date.now() - nodeStartTime,
+                output,
+            });
+        }
+        catch (error) {
+            const result = {
+                name: node.name,
+                path: node.repoPath,
+                success: false,
+                duration: Date.now() - nodeStartTime,
+                error: error instanceof Error ? error.message : String(error),
+            };
+            results.push(result);
+            throw error; // Re-throw for DAG executor to handle
+        }
+    }
+    // Execute DAG traversal
+    const dagResult = await executeDAG(dag, processor, {
+        concurrency: input.concurrency ?? 4,
+        failFast: !input.continueOnError,
+    });
+    // If dry run, we already populated results in the processor
+    if (!input.dryRun) {
+        // Ensure all nodes have results (some may have been skipped due to errors)
+        for (const [name, nodeResult] of dagResult.results) {
+            const existing = results.find((r) => r.name === name);
+            // No test reaches this branch: each visit adds its result before it ends or throws, and
+            // executeDAG gives no result for a node of a level that it skipped. The branch came with
+            // the procedure from client-lib (2026-10). It stays until a decision about it.
+            /* v8 ignore if -- @preserve */
+            if (!existing) {
+                const node = allNodes.get(name);
+                const result = {
+                    name,
+                    path: node?.repoPath ?? "unknown",
+                    success: nodeResult.success,
+                    duration: nodeResult.duration,
+                };
+                if (nodeResult.error?.message) {
+                    result.error = nodeResult.error.message;
+                }
+                results.push(result);
+            }
+        }
+    }
+    return {
+        success: dagResult.success,
+        results,
+        totalDuration: Date.now() - startTime,
+        visited: results.filter((r) => r.success).length,
+        failed: results.filter((r) => !r.success).length,
+    };
+}
+//# sourceMappingURL=traverse.js.map

package/dist/procedures/traverse.js.map

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

package/dist/procedures/types.d.ts

@@ -0,0 +1,73 @@
+/**
+ * The types and schemas of the `dag.traverse` procedure.
+ *
+ * The procedure came from `@procedures/lib` (roadmap, items for a decision). Its name stays
+ * `dag.traverse`.
+ */
+import { z } from "zod";
+import type { DAGNode } from "../types.js";
+/**
+ * Schema for $proc references with $when control.
+ */
+declare const ProcRefSchema: z.ZodObject<{
+    $proc: z.ZodArray<z.ZodString>;
+    input: z.ZodOptional<z.ZodUnknown>;
+    $when: z.ZodOptional<z.ZodString>;
+    $name: z.ZodOptional<z.ZodString>;
+}>;
+export declare const DagTraverseInputSchema: z.ZodObject<{
+    visit: z.ZodUnion<readonly [z.ZodArray<z.ZodString>, typeof ProcRefSchema]>;
+    filter: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    root: z.ZodOptional<z.ZodString>;
+    rootPath: z.ZodOptional<z.ZodString>;
+    concurrency: z.ZodDefault<z.ZodNumber>;
+    serialize: z.ZodDefault<z.ZodEnum<{
+        auto: "auto";
+        repository: "repository";
+        none: "none";
+    }>>;
+    continueOnError: z.ZodDefault<z.ZodBoolean>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+}>;
+export type DagTraverseInput = z.infer<typeof DagTraverseInputSchema>;
+export interface TraverseNodeResult {
+    name: string;
+    path: string;
+    success: boolean;
+    duration: number;
+    error?: string | undefined;
+    output?: unknown | undefined;
+}
+export interface DagTraverseOutput {
+    success: boolean;
+    results: TraverseNodeResult[];
+    totalDuration: number;
+    visited: number;
+    failed: number;
+}
+export declare const DagTraverseOutputSchema: z.ZodType<DagTraverseOutput>;
+/**
+ * A package of the output of `lib.scan`: the fields that `dag.traverse` reads. The type is local,
+ * because `@procedures/lib` depends on this package, and this package must not depend on it.
+ */
+export interface ScannedPackage {
+    /** The package name */
+    name: string;
+    /** The folder of the package */
+    repoPath: string;
+    /** The ecosystem packages that the package depends on */
+    mark1russell7Deps: string[];
+}
+/** The output of `lib.scan`: the fields that `dag.traverse` reads. */
+export interface ScanOutput {
+    packages: Record<string, ScannedPackage>;
+}
+/** A node of the traversal: a workspace package. `id` is the package name. */
+export interface PackageNode extends DAGNode {
+    /** The package name. It is the same as `id`. */
+    name: string;
+    /** The folder of the package */
+    repoPath: string;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/procedures/types.d.ts.map

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

package/dist/procedures/types.js

@@ -0,0 +1,68 @@
+/**
+ * The types and schemas of the `dag.traverse` procedure.
+ *
+ * The procedure came from `@procedures/lib` (roadmap, items for a decision). Its name stays
+ * `dag.traverse`.
+ */
+import { z } from "zod";
+/**
+ * Schema for $proc references with $when control.
+ */
+const ProcRefSchema = z.object({
+    $proc: z.array(z.string()),
+    input: z.unknown().optional(),
+    $when: z.string().optional(),
+    $name: z.string().optional(),
+});
+export const DagTraverseInputSchema = z.object({
+    /**
+     * The procedure to start for each node.
+     * - A list: a procedure path, for example ["git", "add"]
+     * - A `$proc` ref with `$when: "$never"` or `"$parent"`: deferred. The traversal starts it for each node.
+     *
+     * Example:
+     * ```json
+     * { "$proc": ["git", "add"], "input": { "all": true }, "$when": "$parent" }
+     * ```
+     */
+    visit: z.union([
+        z.array(z.string()),
+        ProcRefSchema,
+    ]).describe("Procedure to execute for each node. - Array: procedure path, e.g., [\"git\", \"add\"] - $proc with $when: \"$never\" or \"$parent\": deferred, executed per-node Example: ```json { \"$proc\": [\"git\", \"add\"], \"input\": { \"all\": true }, \"$when\": \"$parent\" } ```"),
+    /** Filter to specific package names */
+    filter: z.array(z.string()).optional().describe("Filter to specific package names"),
+    /** Start from specific root package */
+    root: z.string().optional().describe("Start from specific root package"),
+    /** The workspace root that `lib.scan` reads (default: the pnpm workspace that contains client-lib) */
+    rootPath: z.string().optional().describe("Workspace root (defaults to the pnpm workspace that contains client-lib)"),
+    /** Max parallel operations (default: 4) */
+    concurrency: z.number().default(4).describe("Max parallel operations (default: 4)"),
+    /**
+     * When the visits of nodes in one git repository start one at a time (default: "auto").
+     * - "auto": when the visit uses a `git` procedure (git locks the index of the repository)
+     * - "repository": always
+     * - "none": not at any time
+     */
+    serialize: z.enum(["auto", "repository", "none"]).default("auto").describe("When the visits of nodes in one git repository run one at a time (default: \"auto\"). - \"auto\": when the visit calls a `git` procedure (git locks the index of the repository) - \"repository\": always - \"none\": never"),
+    /** Continue on error (default: false) */
+    continueOnError: z.boolean().default(false).describe("Continue on error (default: false)"),
+    /** Give the plan only, and start no visit (default: false) */
+    dryRun: z.boolean().default(false).describe("Preview without executing (default: false)"),
+});
+export const DagTraverseOutputSchema = z.looseObject({
+    success: z.boolean().describe("True when every visit succeeded"),
+    results: z
+        .array(z.looseObject({
+        name: z.string().describe("The package name of the node"),
+        path: z.string().describe("The folder of the node"),
+        success: z.boolean().describe("True when the visit succeeded"),
+        duration: z.number().describe("The time of the visit, in milliseconds"),
+        error: z.string().optional().describe("The error of a failed visit"),
+        output: z.unknown().optional().describe("The result of the visit"),
+    }))
+        .describe("The result of each visited node"),
+    totalDuration: z.number().describe("The time of the traversal, in milliseconds"),
+    visited: z.number().describe("The number of visited nodes"),
+    failed: z.number().describe("The number of failed visits"),
+});
+//# sourceMappingURL=types.js.map

package/dist/procedures/types.js.map

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

package/dist/register.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Importing this file registers the procedures of @procedures/dag in the global registry:
+ * `import "@procedures/dag/register"`. The package root and the `./module` entry register nothing
+ * (ARCHITECTURE-PROPOSALS-2026-10, P9). `dag.traverse` calls `lib.scan`: also import
+ * `@procedures/lib/register`.
+ */
+export * from "./module.js";
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,cAAc,aAAa,CAAC"}