@procedures/lib 0.2.3 → 0.4.0

package/src/types.ts

@@ -265,130 +265,7 @@ export interface LibAuditOutput {
   };
 }
 
-// =============================================================================
-// dag.traverse Types
-// =============================================================================
-
-/**
- * Schema for $proc references with $when control.
- */
-const ProcRefSchema: z.ZodObject<{
-  $proc: z.ZodArray<z.ZodString>;
-  input: z.ZodOptional<z.ZodUnknown>;
-  $when: z.ZodOptional<z.ZodString>;
-  $name: z.ZodOptional<z.ZodString>;
-}> = z.object({
-  $proc: z.array(z.string()),
-  input: z.unknown().optional(),
-  $when: z.string().optional(),
-  $name: z.string().optional(),
-});
-
-export 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>;
-}> = z.object({
-  /**
-   * 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" }
-   * ```
-   */
-  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"),
-  /** Workspace root (defaults to 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 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
-   */
-  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)"),
-  /** Preview without executing (default: false) */
-  dryRun: z.boolean().default(false).describe("Preview without executing (default: false)"),
-});
-
-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;
-}
-
-// =============================================================================
-// core.catch Types
-// =============================================================================
-
-export const CoreCatchInputSchema: z.ZodObject<{
-  try: z.ZodUnknown;
-  handler: z.ZodOptional<z.ZodUnknown>;
-  cwd: z.ZodOptional<z.ZodString>;
-}> = z.object({
-  /**
-   * Procedure ref to try executing.
-   * Should use $when: "catch" so it's not auto-executed during hydration.
-   *
-   * Example:
-   * ```json
-   * { "$proc": ["git", "commit"], "input": { "message": "auto" }, "$when": "catch" }
-   * ```
-   */
-  try: z.unknown().describe("Procedure ref to try executing. Should use $when: \"catch\" so it's not auto-executed during hydration. Example: ```json { \"$proc\": [\"git\", \"commit\"], \"input\": { \"message\": \"auto\" }, \"$when\": \"catch\" } ```"),
-  /**
-   * Handler procedure ref called on error.
-   * Receives StepResultInfo (success, error, proc) merged with its input.
-   * Should return ContinueDecision { continue: boolean }.
-   */
-  handler: z.unknown().optional().describe("Handler procedure ref called on error. Receives StepResultInfo (success, error, proc) merged with its input. Should return ContinueDecision { continue: boolean }."),
-  /** Working directory for procedure execution */
-  cwd: z.string().optional().describe("Working directory for procedure execution"),
-});
-
-export type CoreCatchInput = z.infer<typeof CoreCatchInputSchema>;
-
-export interface CoreCatchOutput {
-  /** Whether the try succeeded */
-  success: boolean;
-  /** Result from try (if success) or handler decision */
-  result?: unknown | undefined;
-  /** Error message if failed */
-  error?: string | undefined;
-  /** Whether execution should continue (from handler) */
-  continue: boolean;
-}
+// The types of dag.traverse are in @procedures/dag. core.catch is removed: use client.tryCatch.
 
 // =============================================================================
 // Output schemas (roadmap 2.1)
@@ -499,28 +376,84 @@ export const LibAuditOutputSchema: z.ZodType<LibAuditOutput> = z.looseObject({
     .describe("The counts"),
 });
 
-export const DagTraverseOutputSchema: z.ZodType<DagTraverseOutput> = z.looseObject({
-  success: z.boolean().describe("True when every visit succeeded"),
-  results: z
+// =============================================================================
+// lib.graph Types (roadmap R44)
+// =============================================================================
+
+/** The fields of package.json that give the edges of the graph. */
+export type DependencyKind = "dependencies" | "devDependencies" | "peerDependencies" | "optionalDependencies";
+
+export interface LibGraphInput {
+  /** The workspace root (default: the pnpm workspace that contains client-lib) */
+  rootPath?: string | undefined;
+}
+
+export interface LibGraphNode {
+  /** The name in package.json */
+  name: string;
+  /** The folder in packages/ */
+  folder: string;
+  version?: string | undefined;
+  private?: boolean | undefined;
+}
+
+export interface LibGraphEdge {
+  /** The package that depends */
+  from: string;
+  /** The package that it depends on */
+  to: string;
+  kind: DependencyKind;
+  /** The specifier, for example workspace:* */
+  spec: string;
+}
+
+export interface LibGraphOutput {
+  /** The workspace root */
+  root: string;
+  nodes: LibGraphNode[];
+  edges: LibGraphEdge[];
+  /** True when the graph has no cycle */
+  acyclic: boolean;
+  /** Each cycle: the packages of a strongly connected component, in name order */
+  cycles: string[][];
+  /** Without a cycle: the packages in levels. Level 0 depends on no workspace package. */
+  levels?: string[][] | undefined;
+  /** The folders that the procedure could not read */
+  warnings: Array<{ path: string; issue: string }>;
+}
+
+export const LibGraphInputSchema: z.ZodType<LibGraphInput> = z.object({
+  rootPath: z.string().optional().describe("The workspace root (default: the pnpm workspace that contains client-lib)"),
+});
+
+const DEPENDENCY_KINDS = ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"] as const;
+
+export const LibGraphOutputSchema: z.ZodType<LibGraphOutput> = z.looseObject({
+  root: z.string().describe("The workspace root"),
+  nodes: 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"),
+        name: z.string().describe("The name in package.json"),
+        folder: z.string().describe("The folder in packages/"),
+        version: z.string().optional().describe("The version in package.json"),
+        private: z.boolean().optional().describe("True for a private package"),
       })
     )
-    .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"),
-});
-
-export const CoreCatchOutputSchema: z.ZodType<CoreCatchOutput> = z.looseObject({
-  success: z.boolean().describe("True when the try operand succeeded"),
-  result: z.unknown().optional().describe("The result of try, or the decision of the handler"),
-  error: z.string().optional().describe("The error of try, when it failed"),
-  continue: z.boolean().describe("True when the caller can continue"),
+    .describe("The workspace packages, in name order"),
+  edges: z
+    .array(
+      z.looseObject({
+        from: z.string().describe("The package that depends"),
+        to: z.string().describe("The package that it depends on"),
+        kind: z.enum(DEPENDENCY_KINDS).describe("The field of package.json"),
+        spec: z.string().describe("The specifier, for example workspace:*"),
+      })
+    )
+    .describe("The workspace: dependencies between the packages"),
+  acyclic: z.boolean().describe("True when the graph has no cycle"),
+  cycles: z.array(z.array(z.string())).describe("Each cycle: the packages of a strongly connected component, in name order"),
+  levels: z.array(z.array(z.string())).optional().describe("Without a cycle: the packages in levels. Level 0 depends on no workspace package."),
+  warnings: z
+    .array(z.looseObject({ path: z.string().describe("The folder"), issue: z.string().describe("The problem") }))
+    .describe("The folders that the procedure could not read"),
 });

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

@@ -1,33 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}

package/dist/procedures/core/catch.js

@@ -1,118 +0,0 @@
-/**
- * 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 { isAnyProcedureRef, normalizeRef, hydrateInput, scopeOf, } from "@procedures/client";
-/**
- * Execute a procedure with error handling
- */
-export async function coreCatch(input, ctx) {
-    const { try: tryRef, handler: handlerRef, cwd } = input;
-    // The names of the chain around this procedure: a `$ref` in an operand can read them
-    const scope = scopeOf(input);
-    // Validate try is a procedure ref
-    if (!isAnyProcedureRef(tryRef)) {
-        throw new Error("catch: 'try' must be a procedure reference with $when: \"catch\"");
-    }
-    // Create executor that uses client.call
-    const executor = async (path, inp) => {
-        // Inject cwd if provided
-        const inputWithCwd = cwd && typeof inp === "object" && inp !== null
-            ? { ...inp, cwd }
-            : inp;
-        return ctx.client.call(path, inputWithCwd);
-    };
-    // Normalize the try ref
-    const normalizedTry = normalizeRef(tryRef);
-    // Build input for try, merging with cwd
-    const tryInput = {
-        ...(typeof normalizedTry.input === "object" ? normalizedTry.input : {}),
-        ...(cwd ? { cwd } : {}),
-    };
-    try {
-        // Hydrate the try input (execute any nested $immediate refs). The hydration is inside the
-        // `try`: a nested ref that throws is an error of the `try` step (deep dive DATA-22).
-        const hydratedTryInput = await hydrateInput(tryInput, executor, {
-            contextStack: ["catch"],
-            onRef: ctx.onRef,
-            scope,
-        });
-        // Execute the try procedure
-        const result = await ctx.client.call(normalizedTry.path, hydratedTryInput);
-        return {
-            success: true,
-            result,
-            continue: true,
-        };
-    }
-    catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        // If no handler, return error result with continue: false
-        if (!handlerRef || !isAnyProcedureRef(handlerRef)) {
-            return {
-                success: false,
-                error: errorMessage,
-                continue: false,
-            };
-        }
-        // Build StepResultInfo for handler
-        const resultInfo = {
-            success: false,
-            error: errorMessage,
-            proc: normalizedTry.path,
-        };
-        // Execute handler with result info merged into its input
-        const normalizedHandler = normalizeRef(handlerRef);
-        const handlerInput = {
-            ...(typeof normalizedHandler.input === "object" ? normalizedHandler.input : {}),
-            ...resultInfo,
-            ...(cwd ? { cwd } : {}),
-        };
-        try {
-            // Hydrate handler input (a failure here is a failure of the handler)
-            const hydratedHandlerInput = await hydrateInput(handlerInput, executor, {
-                contextStack: ["catch"],
-                onRef: ctx.onRef,
-                scope,
-            });
-            const decision = await ctx.client.call(normalizedHandler.path, hydratedHandlerInput);
-            return {
-                success: false,
-                error: errorMessage,
-                result: decision,
-                continue: decision.continue ?? false,
-            };
-        }
-        catch (handlerError) {
-            // Handler itself failed
-            return {
-                success: false,
-                error: `Handler failed: ${handlerError instanceof Error ? handlerError.message : String(handlerError)}`,
-                continue: false,
-            };
-        }
-    }
-}
-//# sourceMappingURL=catch.js.map

package/dist/procedures/core/catch.js.map

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

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

@@ -1,9 +0,0 @@
-/**
- * Core control-flow procedures that require ProcedureContext
- *
- * These procedures need access to the client for executing procedure refs
- * with proper error handling and control flow.
- */
-export { coreCatch } from "./catch.js";
-export type { CoreCatchInput, CoreCatchOutput } from "../../types.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/procedures/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/procedures/core/index.js

@@ -1,8 +0,0 @@
-/**
- * Core control-flow procedures that require ProcedureContext
- *
- * These procedures need access to the client for executing procedure refs
- * with proper error handling and control flow.
- */
-export { coreCatch } from "./catch.js";
-//# sourceMappingURL=index.js.map

package/dist/procedures/core/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/procedures/core/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

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

@@ -1,5 +0,0 @@
-/**
- * DAG Procedures
- */
-export { dagTraverse } from "./traverse.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/procedures/dag/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/procedures/dag/index.js

@@ -1,5 +0,0 @@
-/**
- * DAG Procedures
- */
-export { dagTraverse } from "./traverse.js";
-//# sourceMappingURL=index.js.map

package/dist/procedures/dag/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/procedures/dag/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

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

@@ -1,54 +0,0 @@
-/**
- * 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
- */
-import type { ProcedureContext } from "@procedures/client";
-import type { DagTraverseInput, DagTraverseOutput } from "../../types.js";
-/** 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/dag/traverse.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"traverse.d.ts","sourceRoot":"","sources":["../../../src/procedures/dag/traverse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,oBAAoB,CAAC;AAE1E,OAAO,KAAK,EAEV,gBAAgB,EAChB,iBAAiB,EAElB,MAAM,gBAAgB,CAAC;AAUxB,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,CAyK5B"}