@procedures/lib 0.0.0-stage → 0.1.0

package/dist/cli-flags.js

@@ -0,0 +1,33 @@
+/**
+ * The global flags of the `mark` CLI.
+ *
+ * `mark` reads a global flag before the command path. After the path, a flag is global only when
+ * the procedure does not declare a flag of that name: `mark docker compose down -v` gives `-v` to
+ * the procedure. `lib.audit` reports each procedure flag that hides a global flag in this way.
+ *
+ * This module has no side effects: `mark` imports it before it loads the procedures.
+ */
+export const CLI_GLOBAL_FLAGS = [
+    { long: "help", short: "h", takesValue: false, description: "Show the help" },
+    { long: "version", short: "v", takesValue: false, description: "Show the version" },
+    { long: "verbose", short: "V", takesValue: false, description: "Show more output" },
+    { long: "format", short: "f", takesValue: true, description: "The output format: text, json, table or streaming" },
+    { long: "local", takesValue: false, description: "Run the command in this process, not on the CLI server" },
+    { long: "json", takesValue: true, description: "Run a procedure reference that is given as JSON" },
+    { long: "no-input", takesValue: false, description: "Never ask for a missing argument (also when CI is set)" },
+    { long: "interactive", short: "i", takesValue: false, mode: true, description: "Start the REPL" },
+    { long: "server", takesValue: false, mode: true, description: "Start the CLI server" },
+    { long: "port", takesValue: true, serverOption: true, description: "The port of the CLI server (with --server)" },
+    { long: "host", takesValue: true, serverOption: true, description: "The host of the CLI server (with --server)" },
+    {
+        long: "transport",
+        takesValue: true,
+        serverOption: true,
+        description: "The transport of the CLI server: http, websocket or both (with --server)",
+    },
+];
+/** The global flag with this long name or short letter */
+export function findGlobalFlag(name, short) {
+    return CLI_GLOBAL_FLAGS.find((flag) => (short ? flag.short === name : flag.long === name));
+}
+//# sourceMappingURL=cli-flags.js.map

package/dist/cli-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flags.js","sourceRoot":"","sources":["../src/cli-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAiBH,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE;IAC7E,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE;IACnF,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE;IACnF,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,mDAAmD,EAAE;IAClH,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,wDAAwD,EAAE;IAC3G,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,iDAAiD,EAAE;IAClG,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,wDAAwD,EAAE;IAC9G,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,EAAE;IACjG,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE;IACtF,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,4CAA4C,EAAE;IACjH,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,4CAA4C,EAAE;IACjH;QACE,IAAI,EAAE,WAAW;QACjB,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,0EAA0E;KACxF;CACF,CAAC;AAEF,0DAA0D;AAC1D,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAc;IACzD,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;AAC7F,CAAC"}

package/dist/dag/builder.d.ts

@@ -0,0 +1,18 @@
+/**
+ * DAG Builder
+ *
+ * Builds the ecosystem-specific dependency DAG from package scan results. This is the only
+ * domain-specific piece; the generic DAG algorithms (buildLeveledDAG, executeDAG, filterDAGFromRoot,
+ * getAncestors, getDescendants, ...) live in @procedures/dag. This package previously
+ * vendored a verbatim copy of those — see documentation/BUGS-2026-07.md (DAG de-dup).
+ */
+import type { DAGNode, PackageInfo } from "../types.js";
+/**
+ * Build DAG nodes from package info.
+ *
+ * Creates nodes only for packages that are mark1russell7 dependencies and exist in the scanned
+ * packages. `id` mirrors `name` so the nodes satisfy client-dag's DAGNode contract (which keys by
+ * id) while the ecosystem code keeps using the readable `name`.
+ */
+export declare function buildDAGNodes(packages: Record<string, PackageInfo>): Map<string, DAGNode>;
+//# sourceMappingURL=builder.d.ts.map

package/dist/dag/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/dag/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GACpC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAuBtB"}

package/dist/dag/builder.js

@@ -0,0 +1,35 @@
+/**
+ * DAG Builder
+ *
+ * Builds the ecosystem-specific dependency DAG from package scan results. This is the only
+ * domain-specific piece; the generic DAG algorithms (buildLeveledDAG, executeDAG, filterDAGFromRoot,
+ * getAncestors, getDescendants, ...) live in @procedures/dag. This package previously
+ * vendored a verbatim copy of those — see documentation/BUGS-2026-07.md (DAG de-dup).
+ */
+/**
+ * Build DAG nodes from package info.
+ *
+ * Creates nodes only for packages that are mark1russell7 dependencies and exist in the scanned
+ * packages. `id` mirrors `name` so the nodes satisfy client-dag's DAGNode contract (which keys by
+ * id) while the ecosystem code keeps using the readable `name`.
+ */
+export function buildDAGNodes(packages) {
+    const nodes = new Map();
+    for (const [name, info] of Object.entries(packages)) {
+        // Only include packages that have mark1russell7 dependencies or are dependencies of others.
+        const deps = info.mark1russell7Deps.filter((dep) => packages[dep] !== undefined);
+        const gitRef = info.gitRemote ?? `github:mark1russell7/${info.name}#${info.currentBranch ?? "main"}`;
+        const requiredBranch = info.currentBranch ?? "main";
+        const node = {
+            id: name,
+            name,
+            repoPath: info.repoPath,
+            gitRef,
+            requiredBranch,
+            dependencies: deps,
+        };
+        nodes.set(name, node);
+    }
+    return nodes;
+}
+//# sourceMappingURL=builder.js.map

package/dist/dag/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/dag/builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAqC;IAErC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAC;IAEzC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,4FAA4F;QAC5F,MAAM,IAAI,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;QAEjF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,IAAI,wBAAwB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,aAAa,IAAI,MAAM,EAAE,CAAC;QACrG,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,IAAI,MAAM,CAAC;QAEpD,MAAM,IAAI,GAAY;YACpB,EAAE,EAAE,IAAI;YACR,IAAI;YACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM;YACN,cAAc;YACd,YAAY,EAAE,IAAI;SACnB,CAAC;QAEF,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/dag/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * DAG utilities.
+ *
+ * The generic DAG algorithms are re-exported from @procedures/dag; only buildDAGNodes
+ * (which builds the ecosystem package graph) is domain-specific and stays local. This package
+ * previously vendored a verbatim copy of the generic algorithms — deduplicated here. The nodes
+ * carry an `id` (mirroring `name`) so they satisfy client-dag's generic `DAGNode` contract.
+ * See documentation/BUGS-2026-07.md (DAG de-dup / H27).
+ */
+export { buildLeveledDAG, getTopologicalOrder, visualizeDAG, executeDAG, executeDAGSequential, createProcessor, filterDAGFromRoot, getAncestors, getDescendants, } from "@procedures/dag";
+export { buildDAGNodes } from "./builder.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/dag/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dag/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/dag/index.js

@@ -0,0 +1,12 @@
+/**
+ * DAG utilities.
+ *
+ * The generic DAG algorithms are re-exported from @procedures/dag; only buildDAGNodes
+ * (which builds the ecosystem package graph) is domain-specific and stays local. This package
+ * previously vendored a verbatim copy of the generic algorithms — deduplicated here. The nodes
+ * carry an `id` (mirroring `name`) so they satisfy client-dag's generic `DAGNode` contract.
+ * See documentation/BUGS-2026-07.md (DAG de-dup / H27).
+ */
+export { buildLeveledDAG, getTopologicalOrder, visualizeDAG, executeDAG, executeDAGSequential, createProcessor, filterDAGFromRoot, getAncestors, getDescendants, } from "@procedures/dag";
+export { buildDAGNodes } from "./builder.js";
+//# sourceMappingURL=index.js.map

package/dist/dag/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dag/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/git/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Git utilities
+ */
+export { parseGitRef, isGitRef, isMark1Russell7Ref, extractMark1Russell7Deps, getPackageNameFromRef, } from "./ref-parser.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/git/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/git/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/git/index.js

@@ -0,0 +1,5 @@
+/**
+ * Git utilities
+ */
+export { parseGitRef, isGitRef, isMark1Russell7Ref, extractMark1Russell7Deps, getPackageNameFromRef, } from "./ref-parser.js";
+//# sourceMappingURL=index.js.map

package/dist/git/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/git/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC"}

package/dist/git/ref-parser.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Git reference parser
+ *
+ * Parses git references from package.json dependencies like:
+ * - github:mark1russell7/logger#main
+ * - github:mark1russell7/client#v1.0.0
+ */
+import type { GitRef } from "../types.js";
+/**
+ * Parse a git reference string into its components
+ *
+ * @example
+ * parseGitRef("github:mark1russell7/logger#main")
+ * // { raw: "...", host: "github", owner: "mark1russell7", repo: "logger", ref: "main" }
+ */
+export declare function parseGitRef(refString: string): GitRef | null;
+/**
+ * Check if a dependency string is a git reference
+ */
+export declare function isGitRef(dep: string): boolean;
+/**
+ * Check if a dependency is a mark1russell7 git reference
+ */
+export declare function isMark1Russell7Ref(dep: string): boolean;
+/**
+ * Extract mark1russell7 git refs from package.json dependencies
+ */
+export declare function extractMark1Russell7Deps(dependencies: Record<string, string>): GitRef[];
+/**
+ * Get the package name from a git ref
+ * Uses the repo name, optionally scoped with @mark1russell7/
+ */
+export declare function getPackageNameFromRef(ref: GitRef): string;
+//# sourceMappingURL=ref-parser.d.ts.map

package/dist/git/ref-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-parser.d.ts","sourceRoot":"","sources":["../../src/git/ref-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoB5D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,MAAM,EAAE,CAaV;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKzD"}

package/dist/git/ref-parser.js

@@ -0,0 +1,70 @@
+/**
+ * Git reference parser
+ *
+ * Parses git references from package.json dependencies like:
+ * - github:mark1russell7/logger#main
+ * - github:mark1russell7/client#v1.0.0
+ */
+/**
+ * Parse a git reference string into its components
+ *
+ * @example
+ * parseGitRef("github:mark1russell7/logger#main")
+ * // { raw: "...", host: "github", owner: "mark1russell7", repo: "logger", ref: "main" }
+ */
+export function parseGitRef(refString) {
+    // Pattern: host:owner/repo#ref
+    // Examples:
+    //   github:mark1russell7/logger#main
+    //   gitlab:user/project#develop
+    const match = refString.match(/^(\w+):([^/]+)\/([^#]+)#(.+)$/);
+    if (!match) {
+        return null;
+    }
+    const [, host, owner, repo, ref] = match;
+    return {
+        raw: refString,
+        host: host,
+        owner: owner,
+        repo: repo,
+        ref: ref,
+    };
+}
+/**
+ * Check if a dependency string is a git reference
+ */
+export function isGitRef(dep) {
+    return /^\w+:[^/]+\/[^#]+#.+$/.test(dep);
+}
+/**
+ * Check if a dependency is a mark1russell7 git reference
+ */
+export function isMark1Russell7Ref(dep) {
+    return dep.includes("mark1russell7/");
+}
+/**
+ * Extract mark1russell7 git refs from package.json dependencies
+ */
+export function extractMark1Russell7Deps(dependencies) {
+    const refs = [];
+    for (const [, version] of Object.entries(dependencies)) {
+        if (isMark1Russell7Ref(version)) {
+            const ref = parseGitRef(version);
+            if (ref) {
+                refs.push(ref);
+            }
+        }
+    }
+    return refs;
+}
+/**
+ * Get the package name from a git ref
+ * Uses the repo name, optionally scoped with @mark1russell7/
+ */
+export function getPackageNameFromRef(ref) {
+    // For mark1russell7 repos, the package name is usually @mark1russell7/{repo}
+    // But some packages like "client" are unscoped
+    // We'll need to check the actual package.json to be sure
+    return ref.repo;
+}
+//# sourceMappingURL=ref-parser.js.map

package/dist/git/ref-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-parser.js","sourceRoot":"","sources":["../../src/git/ref-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,+BAA+B;IAC/B,YAAY;IACZ,qCAAqC;IACrC,gCAAgC;IAChC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAE/D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;IAEzC,OAAO;QACL,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,IAAK;QACX,KAAK,EAAE,KAAM;QACb,IAAI,EAAE,IAAK;QACX,GAAG,EAAE,GAAI;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,YAAoC;IAEpC,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,KAAK,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACvD,IAAI,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;YACjC,IAAI,GAAG,EAAE,CAAC;gBACR,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,6EAA6E;IAC7E,+CAA+C;IAC/C,yDAAyD;IACzD,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @procedures/lib
+ *
+ * Library management procedures for the workspace - scan, new, audit, rename.
+ */
+import "./register.js";
+export * from "./types.js";
+export { libScan, libRename, libNew, libAudit, } from "./procedures/lib/index.js";
+export { ecosystemProcedures, EcosystemProceduresInputSchema, } from "./procedures/ecosystem/index.js";
+export type { EcosystemProceduresInput, EcosystemProceduresOutput, ProcedureInfo, PackageProcedures, } from "./procedures/ecosystem/index.js";
+export { buildDAGNodes, filterDAGFromRoot, getAncestors, getDescendants, buildLeveledDAG, getTopologicalOrder, visualizeDAG, executeDAG, executeDAGSequential, createProcessor, } from "./dag/index.js";
+export { parseGitRef, isGitRef, isMark1Russell7Ref, extractMark1Russell7Deps, getPackageNameFromRef, } from "./git/index.js";
+export { CLI_GLOBAL_FLAGS, findGlobalFlag, type CliGlobalFlag } from "./cli-flags.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,eAAe,CAAC;AAGvB,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,OAAO,EACP,SAAS,EACT,MAAM,EACN,QAAQ,GACT,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,wBAAwB,EACxB,yBAAyB,EACzB,aAAa,EACb,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @procedures/lib
+ *
+ * Library management procedures for the workspace - scan, new, audit, rename.
+ */
+// Importing the package registers its procedures, as in the other client packages (BUGS-2026-07 H18)
+import "./register.js";
+// Re-export types
+export * from "./types.js";
+// Re-export procedures
+export { libScan, libRename, libNew, libAudit, } from "./procedures/lib/index.js";
+// Re-export ecosystem procedures
+export { ecosystemProcedures, EcosystemProceduresInputSchema, } from "./procedures/ecosystem/index.js";
+// Re-export DAG utilities (ecosystem-specific)
+export { buildDAGNodes, filterDAGFromRoot, getAncestors, getDescendants, buildLeveledDAG, getTopologicalOrder, visualizeDAG, executeDAG, executeDAGSequential, createProcessor, } from "./dag/index.js";
+// Re-export git utilities
+export { parseGitRef, isGitRef, isMark1Russell7Ref, extractMark1Russell7Deps, getPackageNameFromRef, } from "./git/index.js";
+// The global flags of the mark CLI (also at "@procedures/lib/cli-flags", with no side effects)
+export { CLI_GLOBAL_FLAGS, findGlobalFlag } from "./cli-flags.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qGAAqG;AACrG,OAAO,eAAe,CAAC;AAEvB,kBAAkB;AAClB,cAAc,YAAY,CAAC;AAE3B,uBAAuB;AACvB,OAAO,EACL,OAAO,EACP,SAAS,EACT,MAAM,EACN,QAAQ,GACT,MAAM,2BAA2B,CAAC;AAEnC,iCAAiC;AACjC,OAAO,EACL,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,iCAAiC,CAAC;AAQzC,+CAA+C;AAC/C,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,0BAA0B;AAC1B,OAAO,EACL,WAAW,EACX,QAAQ,EACR,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,+FAA+F;AAC/F,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAsB,MAAM,gBAAgB,CAAC"}

package/dist/module.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * Procedure Registration for lib operations
+ *
+ * This is the canonical home for lib.* procedures.
+ * client-cli no longer registers these to avoid duplicates.
+ */
+import { type ProcedureModule } 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.)
+ */
+export declare const libModule: ProcedureModule;
+export default libModule;
+//# 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;;;;;;;GAOG;AAEH,OAAO,EAA4D,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAmLpH;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,eAYG,CAAC;eAEb,SAAS"}

package/dist/module.js

@@ -0,0 +1,156 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * Procedure Registration for lib operations
+ *
+ * This is the canonical home for lib.* procedures.
+ * client-cli no longer registers these to avoid duplicates.
+ */
+import { createProcedure, zodAdapter, RUNS_REFS_TAG, defineModule } from "@procedures/client";
+import gitModule from "@procedures/git/module";
+import fsModule from "@procedures/fs/module";
+import { libScan, libRename, libNew, libAudit, } from "./procedures/lib/index.js";
+import { ecosystemProcedures, EcosystemProceduresInputSchema, EcosystemProceduresOutputSchema, } from "./procedures/ecosystem/index.js";
+import { dagTraverse } from "./procedures/dag/index.js";
+import { coreCatch } from "./procedures/core/index.js";
+import { LibScanInputSchema, LibRenameInputSchema, LibNewInputSchema, LibAuditInputSchema, DagTraverseInputSchema, CoreCatchInputSchema, LibScanOutputSchema, LibRenameOutputSchema, LibNewOutputSchema, LibAuditOutputSchema, DagTraverseOutputSchema, CoreCatchOutputSchema, } from "./types.js";
+// =============================================================================
+// lib.* Procedures
+// =============================================================================
+const libScanProcedure = createProcedure()
+    .path(["lib", "scan"])
+    .input(zodAdapter(LibScanInputSchema))
+    .output(zodAdapter(LibScanOutputSchema))
+    .meta({
+    description: "Scan for packages in the git directory",
+    calls: ["fs.readdir", "fs.read.json", "git.status", "git.remote"],
+    args: [],
+    shorts: {},
+    output: "json",
+})
+    .handler(async (input, ctx) => {
+    return libScan(input, ctx);
+})
+    .build();
+const libRenameProcedure = createProcedure()
+    .path(["lib", "rename"])
+    .input(zodAdapter(LibRenameInputSchema))
+    .output(zodAdapter(LibRenameOutputSchema))
+    .meta({
+    description: "Rename a package across the ecosystem",
+    calls: ["fs.glob", "fs.read.json", "fs.write", "fs.exists"],
+    args: ["oldName", "newName"],
+    shorts: { dryRun: "n" },
+    output: "json",
+})
+    .handler(async (input, ctx) => {
+    return libRename(input, ctx);
+})
+    .build();
+const libNewProcedure = createProcedure()
+    .path(["lib", "new"])
+    .input(zodAdapter(LibNewInputSchema))
+    .output(zodAdapter(LibNewOutputSchema))
+    .meta({
+    description: "Create a new package in the ecosystem",
+    calls: ["shell.run", "fs.exists", "fs.mkdir", "fs.write", "fs.read.json"],
+    args: ["name"],
+    shorts: { dryRun: "n" },
+    output: "json",
+})
+    .handler(async (input, ctx) => {
+    return libNew(input, ctx);
+})
+    .build();
+const libAuditProcedure = createProcedure()
+    .path(["lib", "audit"])
+    .input(zodAdapter(LibAuditInputSchema))
+    .output(zodAdapter(LibAuditOutputSchema))
+    .meta({
+    description: "Audit ecosystem packages for issues",
+    calls: ["fs.readdir", "fs.read.json", "git.status", "git.remote", "fs.exists", "fs.mkdir", "fs.write"],
+    args: [],
+    shorts: { fix: "f" },
+    output: "json",
+})
+    .handler(async (input, ctx) => {
+    return libAudit(input, ctx);
+})
+    .build();
+// =============================================================================
+// ecosystem.* Procedures
+// =============================================================================
+const ecosystemProceduresProcedure = createProcedure()
+    .path(["ecosystem", "procedures"])
+    .input(zodAdapter(EcosystemProceduresInputSchema))
+    .output(zodAdapter(EcosystemProceduresOutputSchema))
+    .meta({
+    description: "List all procedures across the ecosystem",
+    args: [],
+    shorts: { namespace: "n" },
+    output: "json",
+})
+    .handler(async (input, ctx) => {
+    return ecosystemProcedures(input, ctx);
+})
+    .build();
+// =============================================================================
+// 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],
+    args: [],
+    shorts: { root: "r", concurrency: "j", continueOnError: "c", dryRun: "d" },
+    output: "streaming",
+})
+    .handler(async (input, ctx) => {
+    return dagTraverse(input, ctx);
+})
+    .build();
+// =============================================================================
+// core.* Procedures
+// =============================================================================
+const coreCatchProcedure = createProcedure()
+    .path(["core", "catch"])
+    .input(zodAdapter(CoreCatchInputSchema))
+    .output(zodAdapter(CoreCatchOutputSchema))
+    .meta({
+    description: "Execute a procedure with error handling",
+    // It runs the procedure refs of its input: a server with an expose rule limits what they call
+    tags: [RUNS_REFS_TAG],
+    args: [],
+    shorts: {},
+    output: "json",
+})
+    .handler(async (input, ctx) => {
+    return coreCatch(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.)
+ */
+export const libModule = defineModule("@procedures/lib", [
+    // lib.* procedures (canonical home)
+    libScanProcedure,
+    libRenameProcedure,
+    libNewProcedure,
+    libAuditProcedure,
+    // ecosystem.* procedures
+    ecosystemProceduresProcedure,
+    // dag.* procedures (canonical home)
+    dagTraverseProcedure,
+    // core.* procedures
+    coreCatchProcedure,
+], [fsModule, gitModule]);
+export default libModule;
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

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

package/dist/procedures/core/catch.d.ts

@@ -0,0 +1,33 @@
+/**
+ * core.catch procedure
+ *
+ * Wraps a procedure execution with error handling.
+ * The `try` procedure ref should use `$when: "catch"` so it's not
+ * executed during hydration but instead by this procedure.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   $proc: ["core", "catch"],
+ *   input: {
+ *     try: {
+ *       $proc: ["git", "commit"],
+ *       input: { message: "auto" },
+ *       $when: "catch"  // Defer execution to catch procedure
+ *     },
+ *     handler: {
+ *       $proc: ["core", "identity"],
+ *       input: { value: { continue: true } },
+ *       $when: "catch"
+ *     }
+ *   }
+ * }
+ * ```
+ */
+import type { ProcedureContext } from "@procedures/client";
+import type { CoreCatchInput, CoreCatchOutput } from "../../types.js";
+/**
+ * Execute a procedure with error handling
+ */
+export declare function coreCatch(input: CoreCatchInput, ctx: ProcedureContext): Promise<CoreCatchOutput>;
+//# sourceMappingURL=catch.d.ts.map

package/dist/procedures/core/catch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catch.d.ts","sourceRoot":"","sources":["../../../src/procedures/core/catch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,oBAAoB,CAAC;AAS1E,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtE;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,CAAC,CAiG1B"}