@procedures/cli-run 0.0.0-stage → 0.2.0

package/dist/module.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * Procedure Registration for CLI operations
+ *
+ * Provides cli.run procedure for calling mark CLI commands via client-shell.
+ */
+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.)
+ */
+export declare const cliModule: ProcedureModule;
+export default cliModule;
+/**
+ * This function registers the procedures of @procedures/cli-run, and of the modules that it requires, 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 registerCliProcedures(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;;;;;;GAMG;AAGH,OAAO,EAA6C,KAAK,eAAe,EAAuC,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAgClK;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,eAEL,CAAC;eAEL,SAAS;AAExB;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,GAAE,iBAAsC,GAAG,IAAI,CAE5F"}

package/dist/module.js

@@ -0,0 +1,51 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * Procedure Registration for CLI operations
+ *
+ * Provides cli.run procedure for calling mark CLI commands via client-shell.
+ */
+import { createProcedure, zodAdapter, defineModule, PROCEDURE_REGISTRY, registerModules } from "@procedures/client";
+import shellModule from "@procedures/shell/module";
+import { cliRun } from "./procedures/cli/index.js";
+import { CliRunInputSchema, CliRunOutputSchema } from "./types.js";
+// =============================================================================
+// cli.run Procedure
+// =============================================================================
+const cliRunProcedure = createProcedure()
+    .path(["cli", "run"])
+    .input(zodAdapter(CliRunInputSchema))
+    .output(zodAdapter(CliRunOutputSchema))
+    .meta({
+    description: "Run a mark CLI command",
+    args: ["path"],
+    shorts: { cwd: "C", timeout: "t" },
+    output: "json",
+    // The caller chooses the mark command, and a mark command can start any procedure.
+    // It also finds the mark CLI in the files of the workspace.
+    effects: { reads: ["fs", "process"], writes: ["process"] },
+})
+    .handler(async (input, ctx) => {
+    return cliRun(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 cliModule = defineModule("@procedures/cli-run", [
+    cliRunProcedure,
+], [shellModule]);
+export default cliModule;
+/**
+ * This function registers the procedures of @procedures/cli-run, and of the modules that it requires, 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 registerCliProcedures(registry = PROCEDURE_REGISTRY) {
+    registerModules(registry, [cliModule]);
+}
+//# 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;;;;;;GAMG;AAGH,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAwB,kBAAkB,EAAE,eAAe,EAA0B,MAAM,oBAAoB,CAAC;AAClK,OAAO,WAAW,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAuC,MAAM,YAAY,CAAC;AAGxG,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF,MAAM,eAAe,GAAG,eAAe,EAAE;KACtC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;KACpB,KAAK,CAAC,UAAU,CAAc,iBAAiB,CAAC,CAAC;KACjD,MAAM,CAAC,UAAU,CAAe,kBAAkB,CAAC,CAAC;KACpD,IAAI,CAAC;IACJ,WAAW,EAAE,wBAAwB;IACrC,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE;IAClC,MAAM,EAAE,MAAM;IACd,mFAAmF;IACnF,4DAA4D;IAC5D,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE;CAC3D,CAAC;KACD,OAAO,CAAC,KAAK,EAAE,KAAkB,EAAE,GAAqB,EAAyB,EAAE;IAClF,OAAO,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC,CAAC;KACD,KAAK,EAAE,CAAC;AAEX,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAoB,YAAY,CAAC,qBAAqB,EAAE;IAC1E,eAAe;CAChB,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;AAEpB,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/cli/index.d.ts

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

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

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

package/dist/procedures/cli/index.js

@@ -0,0 +1,5 @@
+/**
+ * CLI Procedures
+ */
+export { cliRun } from "./run.js";
+//# sourceMappingURL=index.js.map

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

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

package/dist/procedures/cli/run.d.ts

@@ -0,0 +1,41 @@
+/**
+ * cli.run procedure
+ *
+ * Wraps the mark CLI as a procedure using client-shell.
+ * This allows calling any mark CLI command programmatically. The mark CLI itself uses a running
+ * CLI server when that server is safe to use (same folder, same build, its token).
+ */
+import type { ProcedureContext } from "@procedures/client";
+import type { CliRunInput, CliRunOutput } from "../../types.js";
+/**
+ * The argv of `mark` for an input: the command path, then each named argument as
+ * `--key=<text>`, then `--` and the positional arguments.
+ *
+ * A string value goes as it is. Another value goes as JSON, which `mark` converts by the type of
+ * the field: `--flag=false` for a boolean, `--files=["a","b"]` for an array, `--env={"A":"1"}`
+ * for a record. Before, the procedure sent `--key value`, so a value that starts with "-" became
+ * a flag, and it dropped a `false` boolean, so a default of `true` could not be turned off.
+ * The `--` keeps a positional argument that starts with "-" from becoming a flag.
+ */
+export declare function buildMarkArgs(input: Pick<CliRunInput, "path" | "positional" | "args">): string[];
+/**
+ * Run a mark CLI command
+ *
+ *
+ * @example
+ * // Equivalent to: mark lib new my-package
+ * await client.call(["cli", "run"], {
+ *   path: ["lib", "new"],
+ *   positional: ["my-package"],
+ * });
+ *
+ * @example
+ * // Equivalent to: mark procedure new fs.read --description "Read a file"
+ * await client.call(["cli", "run"], {
+ *   path: ["procedure", "new"],
+ *   positional: ["fs.read"],
+ *   args: { description: "Read a file" },
+ * });
+ */
+export declare function cliRun(input: CliRunInput, ctx: ProcedureContext): Promise<CliRunOutput>;
+//# sourceMappingURL=run.d.ts.map

package/dist/procedures/cli/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/procedures/cli/run.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAwBhE;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,CAAC,GAAG,MAAM,EAAE,CAUhG;AA8CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,MAAM,CAC1B,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,YAAY,CAAC,CAiBvB"}

package/dist/procedures/cli/run.js

@@ -0,0 +1,115 @@
+/**
+ * cli.run procedure
+ *
+ * Wraps the mark CLI as a procedure using client-shell.
+ * This allows calling any mark CLI command programmatically. The mark CLI itself uses a running
+ * CLI server when that server is safe to use (same folder, same build, its token).
+ */
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Find the mark CLI of the workspace that contains this package (packages/mark/dist/cli.js)
+ */
+function resolveMarkCli() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (;;) {
+        if (existsSync(join(dir, "pnpm-workspace.yaml"))) {
+            const cli = join(dir, "packages", "mark", "dist", "cli.js");
+            if (existsSync(cli)) {
+                return cli;
+            }
+            break;
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    throw new Error("Could not find the mark CLI (packages/mark/dist/cli.js in the workspace). Run pnpm build.");
+}
+/**
+ * The argv of `mark` for an input: the command path, then each named argument as
+ * `--key=<text>`, then `--` and the positional arguments.
+ *
+ * A string value goes as it is. Another value goes as JSON, which `mark` converts by the type of
+ * the field: `--flag=false` for a boolean, `--files=["a","b"]` for an array, `--env={"A":"1"}`
+ * for a record. Before, the procedure sent `--key value`, so a value that starts with "-" became
+ * a flag, and it dropped a `false` boolean, so a default of `true` could not be turned off.
+ * The `--` keeps a positional argument that starts with "-" from becoming a flag.
+ */
+export function buildMarkArgs(input) {
+    const args = [...input.path];
+    for (const [key, value] of Object.entries(input.args ?? {})) {
+        if (value === undefined || value === null)
+            continue;
+        args.push(`--${key}=${typeof value === "string" ? value : JSON.stringify(value)}`);
+    }
+    if (input.positional && input.positional.length > 0) {
+        args.push("--", ...input.positional.map(String));
+    }
+    return args;
+}
+/**
+ * Execute via shell (spawn node process)
+ */
+async function shellExecution(input, ctx, startTime) {
+    const args = buildMarkArgs(input);
+    // Build shell input
+    const shellInput = {
+        command: process.execPath,
+        args: [resolveMarkCli(), ...args],
+    };
+    if (input.cwd !== undefined)
+        shellInput.cwd = input.cwd;
+    if (input.timeout !== undefined)
+        shellInput.timeout = input.timeout;
+    // Call shell.run
+    const result = await ctx.client.call(["shell", "run"], shellInput);
+    return {
+        exitCode: result.exitCode,
+        stdout: result.stdout,
+        stderr: result.stderr,
+        success: result.exitCode === 0,
+        duration: Date.now() - startTime,
+    };
+}
+/**
+ * Run a mark CLI command
+ *
+ *
+ * @example
+ * // Equivalent to: mark lib new my-package
+ * await client.call(["cli", "run"], {
+ *   path: ["lib", "new"],
+ *   positional: ["my-package"],
+ * });
+ *
+ * @example
+ * // Equivalent to: mark procedure new fs.read --description "Read a file"
+ * await client.call(["cli", "run"], {
+ *   path: ["procedure", "new"],
+ *   positional: ["fs.read"],
+ *   args: { description: "Read a file" },
+ * });
+ */
+export async function cliRun(input, ctx) {
+    const startTime = Date.now();
+    try {
+        // Always through the mark CLI. Before, a second path sent the input straight to a running
+        // CLI server, without mark's argument mapping, so the two paths gave different results
+        // (a "dry run" wrote files), and it had its own copy of the lockfile logic (deep dive CLI-12).
+        return await shellExecution(input, ctx, startTime);
+    }
+    catch (error) {
+        return {
+            exitCode: 1,
+            stdout: "",
+            stderr: error instanceof Error ? error.message : String(error),
+            success: false,
+            duration: Date.now() - startTime,
+        };
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/procedures/cli/run.js.map

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

package/dist/register.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Importing this file registers the procedures of @procedures/cli-run, and of the modules that it
+ * requires, in the global registry: `import "@procedures/cli-run/register"`. The package root and the
+ * `./module` entry register nothing (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+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;;;;GAIG;AAIH,cAAc,aAAa,CAAC"}

package/dist/register.js

@@ -0,0 +1,9 @@
+/**
+ * Importing this file registers the procedures of @procedures/cli-run, and of the modules that it
+ * requires, in the global registry: `import "@procedures/cli-run/register"`. The package root and the
+ * `./module` entry register nothing (ARCHITECTURE-PROPOSALS-2026-10, P9).
+ */
+import { registerCliProcedures } from "./module.js";
+export * from "./module.js";
+registerCliProcedures();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,cAAc,aAAa,CAAC;AAE5B,qBAAqB,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Type definitions for client-cli procedures
+ *
+ * client-cli wraps the mark CLI as procedures using client-shell.
+ */
+import { z } from "zod";
+export declare const CliRunInputSchema: z.ZodObject<{
+    path: z.ZodArray<z.ZodString>;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    positional: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    cwd: z.ZodOptional<z.ZodString>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}>;
+export type CliRunInput = z.infer<typeof CliRunInputSchema>;
+export interface CliRunOutput {
+    /** Exit code of the command */
+    exitCode: number;
+    /** Standard output */
+    stdout: string;
+    /** Standard error */
+    stderr: string;
+    /** Whether command succeeded (exit code 0) */
+    success: boolean;
+    /** Duration in milliseconds */
+    duration: number;
+}
+/** The output schema of cli.run (roadmap 2.1). Loose: a field that it does not name stays. */
+export declare const CliRunOutputSchema: z.ZodType<CliRunOutput>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,SAAS,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7G,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACnD,GAAG,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;CACrC,CAWC,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAMrD,CAAC"}

package/dist/types.js

@@ -0,0 +1,30 @@
+/**
+ * Type definitions for client-cli procedures
+ *
+ * client-cli wraps the mark CLI as procedures using client-shell.
+ */
+import { z } from "zod";
+// =============================================================================
+// cli.run Types
+// =============================================================================
+export const CliRunInputSchema = z.object({
+    /** Procedure path to call, e.g. ["lib", "new"] for "mark lib new" */
+    path: z.array(z.string()).describe("Procedure path to call, e.g. [\"lib\", \"new\"] for \"mark lib new\""),
+    /** Named arguments as key-value pairs, e.g. { name: "foo" } -> "--name foo" */
+    args: z.record(z.string(), z.union([z.string(), z.number(), z.boolean()])).optional().describe("Named arguments as key-value pairs, e.g. { name: \"foo\" } -> \"--name foo\""),
+    /** Positional arguments after the path */
+    positional: z.array(z.string()).optional().describe("Positional arguments after the path"),
+    /** Working directory */
+    cwd: z.string().optional().describe("Working directory"),
+    /** Timeout in milliseconds */
+    timeout: z.number().optional().describe("Timeout in milliseconds"),
+});
+/** The output schema of cli.run (roadmap 2.1). Loose: a field that it does not name stays. */
+export const CliRunOutputSchema = z.looseObject({
+    exitCode: z.number().describe("The exit code of mark"),
+    stdout: z.string().describe("The standard output of mark"),
+    stderr: z.string().describe("The standard error of mark"),
+    success: z.boolean().describe("True when the exit code is 0"),
+    duration: z.number().describe("The time of the command, in milliseconds"),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,iBAAiB,GAMzB,CAAC,CAAC,MAAM,CAAC;IACZ,qEAAqE;IACrE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,sEAAsE,CAAC;IAC1G,+EAA+E;IAC/E,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;IAC9K,0CAA0C;IAC1C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IAC1F,wBAAwB;IACxB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IACxD,8BAA8B;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACnE,CAAC,CAAC;AAiBH,8FAA8F;AAC9F,MAAM,CAAC,MAAM,kBAAkB,GAA4B,CAAC,CAAC,WAAW,CAAC;IACvE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;IACtD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC1D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACzD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC7D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CAC1E,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,83 @@
 {
+  "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/cli-run",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Run any mark CLI command as a procedure (cli.run) with a safe argv mapping: no shell, typed flags and captured output.",
+  "keywords": [
+    "cli",
+    "mark",
+    "procedures",
+    "automation",
+    "argv"
+  ],
+  "homepage": "https://mark1russell7.github.io/client/",
+  "bugs": {
+    "url": "https://github.com/mark1russell7/client/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark1russell7/client.git",
+    "directory": "packages/client-cli"
+  },
+  "license": "MIT",
+  "author": "Mark Russell (https://github.com/mark1russell7)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./module": {
+      "types": "./dist/module.d.ts",
+      "import": "./dist/module.js"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "import": "./dist/register.js"
+    },
+    "./register.js": {
+      "import": "./dist/register.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "./dist/register.js"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@procedures/client": "0.2.0",
+    "@procedures/shell": "0.2.0",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "@types/node": "^22.0.0",
+    "@mark1russell7/cue": "^1.0.0",
+    "vitest": "^5.0.3"
+  },
+  "client": {
+    "procedures": "./dist/register.js"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
 }

package/src/index.ts

@@ -0,0 +1,30 @@
+/**
+ * @procedures/cli-run
+ *
+ * Wraps the mark CLI as procedures using client-shell.
+ *
+ * @example
+ * ```typescript
+ * import { Client } from "@procedures/client";
+ *
+ * // Equivalent to: mark lib new my-package
+ * const result = await client.call(["cli", "run"], {
+ *   path: ["lib", "new"],
+ *   positional: ["my-package"],
+ * });
+ *
+ * if (result.success) {
+ *   console.log(result.stdout);
+ * }
+ * ```
+ */
+
+// Types
+export type { CliRunInput, CliRunOutput } from "./types.js";
+export { CliRunInputSchema } from "./types.js";
+
+// Procedures
+export { cliRun } from "./procedures/cli/index.js";
+
+// Registration
+export { registerCliProcedures } from "./module.js";

package/src/module.ts

@@ -0,0 +1,59 @@
+/**
+ * Module (no side effects): the procedures of this package as data, for `createRegistry()`.
+ *
+ * Procedure Registration for CLI operations
+ *
+ * Provides cli.run procedure for calling mark CLI commands via client-shell.
+ */
+
+
+import { createProcedure, zodAdapter, defineModule, type ProcedureModule, PROCEDURE_REGISTRY, registerModules, type ProcedureRegistry } from "@procedures/client";
+import shellModule from "@procedures/shell/module";
+import { cliRun } from "./procedures/cli/index.js";
+import { CliRunInputSchema, CliRunOutputSchema, type CliRunInput, type CliRunOutput } from "./types.js";
+import type { ProcedureContext } from "@procedures/client";
+
+// =============================================================================
+// cli.run Procedure
+// =============================================================================
+
+const cliRunProcedure = createProcedure()
+  .path(["cli", "run"])
+  .input(zodAdapter<CliRunInput>(CliRunInputSchema))
+  .output(zodAdapter<CliRunOutput>(CliRunOutputSchema))
+  .meta({
+    description: "Run a mark CLI command",
+    args: ["path"],
+    shorts: { cwd: "C", timeout: "t" },
+    output: "json",
+    // The caller chooses the mark command, and a mark command can start any procedure.
+    // It also finds the mark CLI in the files of the workspace.
+    effects: { reads: ["fs", "process"], writes: ["process"] },
+  })
+  .handler(async (input: CliRunInput, ctx: ProcedureContext): Promise<CliRunOutput> => {
+    return cliRun(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 cliModule: ProcedureModule = defineModule("@procedures/cli-run", [
+    cliRunProcedure,
+  ], [shellModule]);
+
+export default cliModule;
+
+/**
+ * This function registers the procedures of @procedures/cli-run, and of the modules that it requires, 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 registerCliProcedures(registry: ProcedureRegistry = PROCEDURE_REGISTRY): void {
+  registerModules(registry, [cliModule]);
+}

package/src/procedures/cli/index.ts

@@ -0,0 +1,5 @@
+/**
+ * CLI Procedures
+ */
+
+export { cliRun } from "./run.js";