@davidorex/pi-context-cli 0.28.0

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+All notable changes to this package are documented here. Format follows [Keep a Changelog](https://keepachangelog.com/). This package has not yet been published to npm; the accumulated surface below sits under `[Unreleased]` and becomes its first published version's section at first publish.
+
+## [Unreleased]
+
+## [0.28.0] - 2026-06-03
+
+### Added
+- Runtime-reflecting CLI over pi-context's op-registry: the command surface is derived from the registered operations rather than hand-maintained (`b0a831e`)
+
+### Fixed
+- String-enum union flags derive as strings rather than JSON (DEFECT-1) (`37f3f31`)

package/README.md

@@ -0,0 +1,60 @@
+# @davidorex/pi-context-cli
+
+A command-line interface over the [`@davidorex/pi-context`](https://github.com/davidorex/pi-project-workflows/tree/main/packages/pi-context) substrate operations.
+
+The command set is **auto-tracking**: every operation in pi-context's op-registry whose `surface` is `"use"` surfaces as a CLI command by reflection. There is no hardcoded command list — adding an op to pi-context makes a new CLI command appear with zero changes to this package. Operations that depend on a pi runtime handle (e.g. `list-tools`) carry `surface: "process"` and are not surfaced here.
+
+## Install
+
+```bash
+npm i -g @davidorex/pi-context-cli
+```
+
+This provides a `pi-context` binary.
+
+## Usage
+
+```bash
+pi-context --help                 # list every surfaced op + global flags
+pi-context <op> --help            # per-op help: declared flags with TYPE tags
+pi-context <op> [flags]           # run an op
+```
+
+Each op's flags derive from its parameter schema:
+
+- scalar fields take `--field value` (`string` / `number`); `boolean` fields are presence flags (`--flag`, or `--flag true|false`)
+- object / array / typeless fields take a JSON argument: `--field '<inline json>'` or `--field @path/to.json`
+
+Example:
+
+```bash
+pi-context read-block --block tasks
+pi-context append-block-item --block issues --arrayKey issues --item @new-issue.json --autoId
+pi-context read-block-page --block framework-gaps --offset 0 --limit 50
+```
+
+## Global flags
+
+- `--cwd <dir>` — substrate root (default: current working directory; relative paths resolve against it)
+- `--json` — emit a `{ ok, op, output }` envelope on success (`{ ok: false, op, error }` on failure) instead of raw output
+- `--yes`, `--force` — pre-authorize an auth-gated op in a non-interactive context
+- `--writer <json>` — override the auto-resolved writer identity
+- `--help`, `-h` — top-level help, or per-op help after an op name
+
+## Writer identity
+
+Ops that declare a `writer` parameter (e.g. `promote-item`, `write-schema-migration`) get it injected automatically when not passed via `--writer`. The identity is resolved by cascade: `git config user.email`, then `$USER`, then the literal `"operator"`. Pass `--writer '{"kind":"human","user":"you@example.com"}'` to override.
+
+## Auth-gated ops
+
+Ops marked `authGated` (writes that mutate config / schemas / migrations) require authorization, mirroring the in-pi dispatch gate:
+
+- `--yes` / `--force` proceeds immediately
+- on an interactive terminal you are prompted (`Authorize <op>? [y/N]`)
+- in a non-interactive context without `--yes` the op refuses
+
+## Exit codes
+
+- `0` — success
+- `1` — op/runtime error, or declined authorization
+- `2` — usage error (unknown op, unknown flag, missing required field)

package/dist/cli.d.ts

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import { type OpDefinition } from "@davidorex/pi-context/ops";
+/**
+ * The surfaced command set: every op the CLI exposes. Derived by reflection —
+ * NOT a hardcoded list. A `surface: "process"` op (currently only list-tools)
+ * is excluded here by the partition, never by name.
+ */
+export declare const useOps: OpDefinition[];
+/** Field-type tag rendered in help and used to pick a coercion strategy. */
+export type FieldType = "string" | "number" | "boolean" | "json";
+interface FieldSchema {
+    type?: string;
+    description?: string;
+    anyOf?: Array<{
+        type?: string;
+        const?: unknown;
+        enum?: unknown[];
+    }>;
+}
+/**
+ * Extract the literal string values of a string-enum field, or null for any
+ * non-enum shape. A typebox `Type.Union([Type.Literal("eq"), …])` serializes at
+ * runtime to `{ anyOf: [{ type: "string", const: "eq" }, …] }` with no
+ * top-level `type` — so the union members must be read off `anyOf`.
+ *
+ * Returns the string values only when `anyOf` is a non-empty array and EVERY
+ * element contributes string members (a `const` string, or — for forward
+ * safety against an element-level `enum` shape — string members of an `enum`
+ * array). Any element that fails to contribute makes the whole shape non-enum
+ * (returns null), so mixed unions and non-string literals are left untouched
+ * and continue to flow through the JSON path.
+ */
+export declare function stringEnumValues(field: FieldSchema): string[] | null;
+/**
+ * Map a typebox field schema to a CLI field type. Scalars carry an explicit
+ * `type`; Type.Unknown() has no `type`; Type.Record/Type.Object report
+ * `type:"object"`; arrays `type:"array"` — all of which are JSON-arg fields.
+ */
+export declare function fieldType(field: FieldSchema): FieldType;
+/** Look up a surfaced op by name. Returns undefined for unknown/non-use ops. */
+export declare function resolveOp(name: string): OpDefinition | undefined;
+/** True when `name` is a real op but not surfaced via the CLI (surface!=="use"). */
+export declare function isProcessOnlyOp(name: string): boolean;
+/**
+ * Resolve the operator identity for schema-driven writer injection. Cascade
+ * (replicated from pi-agent-dispatch getVerifiedOperatorIdentity, which is not
+ * importable without dragging the dispatch tree):
+ *   (1) `git config user.email`, trimmed, if non-empty
+ *   (2) process.env.USER, if non-empty
+ *   (3) null
+ * Dependencies are injectable for unit testing.
+ */
+export declare function resolveIdentity(deps?: {
+    gitEmail?: () => string | null;
+    envUser?: string | undefined;
+}): string | null;
+export interface ParsedArgs {
+    cwd: string;
+    json: boolean;
+    yes: boolean;
+    help: boolean;
+    explicitWriter?: unknown;
+    params: Record<string, unknown>;
+}
+export declare class UsageError extends Error {
+}
+/**
+ * Parse the argv tail (everything after the op name) against the op's schema.
+ * Throws UsageError on unknown flags, missing required fields, or malformed
+ * values. Does NOT inject the writer or evaluate the auth gate — callers do
+ * that after parsing so those concerns stay independently testable.
+ */
+export declare function parseOpArgs(op: OpDefinition, argv: string[], cwdBase?: string): ParsedArgs;
+/**
+ * Schema-driven writer injection: when the op declares a `writer` field and the
+ * caller did not pass `--writer`, fill params.writer from the resolved operator
+ * identity (falling back to "operator"). Mutates and returns `params`.
+ */
+export declare function injectWriter(op: OpDefinition, params: Record<string, unknown>, identity: string | null): Record<string, unknown>;
+export type AuthDecision = {
+    allow: true;
+} | {
+    allow: false;
+    reason: string;
+    needsPrompt: boolean;
+};
+/**
+ * Pure auth-gate decision (no I/O). Mirrors the pi-agent-dispatch gate:
+ *  - not gated → allow
+ *  - --yes/--force → allow
+ *  - interactive TTY → defer to a prompt (needsPrompt)
+ *  - non-interactive without --yes → refuse
+ */
+export declare function authDecision(op: OpDefinition, opts: {
+    yes: boolean;
+    interactive: boolean;
+}): AuthDecision;
+/** Per-op help text: description + one line per declared field. */
+export declare function deriveHelp(op: OpDefinition): string;
+/** Top-level help: one line per surfaced op + global flag notes. */
+export declare function deriveTopHelp(): string;
+export declare function main(argv: string[]): Promise<number>;
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA+BA,OAAO,EAAE,KAAK,YAAY,EAAO,MAAM,2BAA2B,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,MAAM,EAAE,YAAY,EAA2C,CAAC;AAE7E,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAEjE,UAAU,WAAW;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;CACpE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,GAAG,IAAI,CAmBpE;AAYD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,CAgBvD;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEhE;AAED,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE;IACtC,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,GAAG,MAAM,GAAG,IAAI,CAmBhB;AAED,MAAM,WAAW,UAAU;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,SAAgB,GAAG,UAAU,CAwGjG;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,GACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC;AAEpG;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GAAG,YAAY,CASzG;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAoBnD;AAED,oEAAoE;AACpE,wBAAgB,aAAa,IAAI,MAAM,CAgBtC;AAcD,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAsE1D"}

package/dist/cli.js

@@ -0,0 +1,427 @@
+#!/usr/bin/env node
+/**
+ * pi-context — auto-tracking command-line interface over the pi-context
+ * op-registry.
+ *
+ * The command set is derived by REFLECTION over the imported `ops` array
+ * (`@davidorex/pi-context/ops`): every OpDefinition whose `surface === "use"`
+ * becomes a CLI command. Adding an op to pi-context surfaces a new CLI command
+ * with zero edits here — there is intentionally NO hardcoded op-name list. The
+ * one op that depends on a pi-runtime handle (list-tools) carries
+ * `surface: "process"` at source and is therefore filtered out by the same
+ * partition, not by name.
+ *
+ * Per-op flags are derived from each op's typebox `parameters` schema: scalar
+ * fields (string/number/boolean) take `--field value` (boolean is a presence
+ * flag); object/array/typeless fields take a JSON argument (`--field '<json>'`
+ * or `--field @file.json`). Required fields (op.parameters.required) are
+ * enforced before invocation, except `writer`, which is schema-driven
+ * auto-injected from the resolved operator identity when not passed explicitly.
+ *
+ * authGated ops mirror the pi-agent-dispatch auth-gate: `--yes`/`--force`
+ * proceeds; interactive TTY prompts; non-interactive without `--yes` refuses.
+ *
+ * The pure pieces (resolveOp / parseOpArgs / deriveHelp / deriveTopHelp /
+ * resolveIdentity / authDecision / useOps) are exported for unit testing.
+ */
+import { execSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { createInterface } from "node:readline";
+import { fileURLToPath } from "node:url";
+import { ops } from "@davidorex/pi-context/ops";
+/**
+ * The surfaced command set: every op the CLI exposes. Derived by reflection —
+ * NOT a hardcoded list. A `surface: "process"` op (currently only list-tools)
+ * is excluded here by the partition, never by name.
+ */
+export const useOps = ops.filter((o) => o.surface === "use");
+/**
+ * Extract the literal string values of a string-enum field, or null for any
+ * non-enum shape. A typebox `Type.Union([Type.Literal("eq"), …])` serializes at
+ * runtime to `{ anyOf: [{ type: "string", const: "eq" }, …] }` with no
+ * top-level `type` — so the union members must be read off `anyOf`.
+ *
+ * Returns the string values only when `anyOf` is a non-empty array and EVERY
+ * element contributes string members (a `const` string, or — for forward
+ * safety against an element-level `enum` shape — string members of an `enum`
+ * array). Any element that fails to contribute makes the whole shape non-enum
+ * (returns null), so mixed unions and non-string literals are left untouched
+ * and continue to flow through the JSON path.
+ */
+export function stringEnumValues(field) {
+    const anyOf = field.anyOf;
+    if (!Array.isArray(anyOf) || anyOf.length === 0)
+        return null;
+    const values = [];
+    for (const el of anyOf) {
+        if (el.type === "string" && typeof el.const === "string") {
+            values.push(el.const);
+            continue;
+        }
+        if (Array.isArray(el.enum)) {
+            const strings = el.enum.filter((e) => typeof e === "string");
+            if (strings.length === el.enum.length && strings.length > 0) {
+                values.push(...strings);
+                continue;
+            }
+        }
+        return null;
+    }
+    return values.length > 0 ? values : null;
+}
+/** The typebox Type.Object value carried at runtime on op.parameters. */
+function objectSchema(op) {
+    return op.parameters ?? {};
+}
+/**
+ * Map a typebox field schema to a CLI field type. Scalars carry an explicit
+ * `type`; Type.Unknown() has no `type`; Type.Record/Type.Object report
+ * `type:"object"`; arrays `type:"array"` — all of which are JSON-arg fields.
+ */
+export function fieldType(field) {
+    // String-enum unions (Type.Union of string literals) coerce as verbatim
+    // strings — identical to a plain string field — not as JSON.
+    if (stringEnumValues(field) !== null)
+        return "string";
+    switch (field.type) {
+        case "string":
+            return "string";
+        case "number":
+        case "integer":
+            return "number";
+        case "boolean":
+            return "boolean";
+        default:
+            // object | array | undefined (Type.Unknown) → JSON argument
+            return "json";
+    }
+}
+/** Look up a surfaced op by name. Returns undefined for unknown/non-use ops. */
+export function resolveOp(name) {
+    return useOps.find((o) => o.name === name);
+}
+/** True when `name` is a real op but not surfaced via the CLI (surface!=="use"). */
+export function isProcessOnlyOp(name) {
+    return ops.some((o) => o.name === name) && !useOps.some((o) => o.name === name);
+}
+/**
+ * Resolve the operator identity for schema-driven writer injection. Cascade
+ * (replicated from pi-agent-dispatch getVerifiedOperatorIdentity, which is not
+ * importable without dragging the dispatch tree):
+ *   (1) `git config user.email`, trimmed, if non-empty
+ *   (2) process.env.USER, if non-empty
+ *   (3) null
+ * Dependencies are injectable for unit testing.
+ */
+export function resolveIdentity(deps) {
+    const gitEmail = deps?.gitEmail ??
+        (() => {
+            try {
+                return execSync("git config user.email", {
+                    encoding: "utf8",
+                    stdio: ["ignore", "pipe", "ignore"],
+                }).trim();
+            }
+            catch {
+                return null;
+            }
+        });
+    const envUser = deps && "envUser" in deps ? deps.envUser : process.env.USER;
+    const email = gitEmail();
+    if (email && email.length > 0)
+        return email;
+    if (envUser && envUser.length > 0)
+        return envUser;
+    return null;
+}
+export class UsageError extends Error {
+}
+/**
+ * Parse the argv tail (everything after the op name) against the op's schema.
+ * Throws UsageError on unknown flags, missing required fields, or malformed
+ * values. Does NOT inject the writer or evaluate the auth gate — callers do
+ * that after parsing so those concerns stay independently testable.
+ */
+export function parseOpArgs(op, argv, cwdBase = process.cwd()) {
+    const schema = objectSchema(op);
+    const props = schema.properties ?? {};
+    const out = {
+        cwd: cwdBase,
+        json: false,
+        yes: false,
+        help: false,
+        params: {},
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const tok = argv[i];
+        if (tok === "--help" || tok === "-h") {
+            out.help = true;
+            continue;
+        }
+        if (tok === "--json") {
+            out.json = true;
+            continue;
+        }
+        if (tok === "--yes" || tok === "--force") {
+            out.yes = true;
+            continue;
+        }
+        if (tok === "--cwd") {
+            const v = argv[++i];
+            if (v === undefined)
+                throw new UsageError("--cwd requires a directory argument");
+            out.cwd = path.isAbsolute(v) ? v : path.resolve(cwdBase, v);
+            continue;
+        }
+        if (tok === "--writer") {
+            const v = argv[++i];
+            if (v === undefined)
+                throw new UsageError("--writer requires a JSON argument");
+            try {
+                out.explicitWriter = v.startsWith("@") ? JSON.parse(readFileSync(v.slice(1), "utf8")) : JSON.parse(v);
+            }
+            catch (err) {
+                throw new UsageError(`--writer: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            continue;
+        }
+        if (!tok.startsWith("--")) {
+            throw new UsageError(`unexpected argument: ${tok}`);
+        }
+        const field = tok.slice(2);
+        const fschema = props[field];
+        if (fschema === undefined) {
+            throw new UsageError(`unknown flag: ${tok}`);
+        }
+        const kind = fieldType(fschema);
+        if (kind === "boolean") {
+            // Presence flag; accept an optional explicit true|false next token.
+            const next = argv[i + 1];
+            if (next === "true" || next === "false") {
+                out.params[field] = next === "true";
+                i++;
+            }
+            else {
+                out.params[field] = true;
+            }
+            continue;
+        }
+        const value = argv[++i];
+        if (value === undefined)
+            throw new UsageError(`--${field} requires a value`);
+        if (kind === "number") {
+            const n = Number(value);
+            if (Number.isNaN(n))
+                throw new UsageError(`--${field} expects a number, got '${value}'`);
+            out.params[field] = n;
+        }
+        else if (kind === "string") {
+            const vals = stringEnumValues(fschema);
+            if (vals !== null && !vals.includes(value)) {
+                throw new UsageError(`--${field} expects one of: ${vals.join(", ")}; got '${value}'`);
+            }
+            out.params[field] = value;
+        }
+        else {
+            // json: inline JSON or @file
+            try {
+                out.params[field] = value.startsWith("@")
+                    ? JSON.parse(readFileSync(value.slice(1), "utf8"))
+                    : JSON.parse(value);
+            }
+            catch (err) {
+                throw new UsageError(`--${field}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
+    if (out.explicitWriter !== undefined) {
+        out.params.writer = out.explicitWriter;
+    }
+    // Required-field check — `writer` is exempt (schema-driven auto-injected
+    // after parse when the op declares it and none was passed).
+    if (!out.help) {
+        const required = (schema.required ?? []).filter((r) => r !== "writer");
+        const missing = required.filter((r) => !(r in out.params));
+        if (missing.length > 0) {
+            throw new UsageError(`missing required: ${missing.map((m) => `--${m}`).join(", ")}`);
+        }
+    }
+    return out;
+}
+/**
+ * Schema-driven writer injection: when the op declares a `writer` field and the
+ * caller did not pass `--writer`, fill params.writer from the resolved operator
+ * identity (falling back to "operator"). Mutates and returns `params`.
+ */
+export function injectWriter(op, params, identity) {
+    const props = objectSchema(op).properties ?? {};
+    if (props.writer !== undefined && params.writer === undefined) {
+        params.writer = { kind: "human", user: identity ?? "operator" };
+    }
+    return params;
+}
+/**
+ * Pure auth-gate decision (no I/O). Mirrors the pi-agent-dispatch gate:
+ *  - not gated → allow
+ *  - --yes/--force → allow
+ *  - interactive TTY → defer to a prompt (needsPrompt)
+ *  - non-interactive without --yes → refuse
+ */
+export function authDecision(op, opts) {
+    if (op.authGated !== true)
+        return { allow: true };
+    if (opts.yes)
+        return { allow: true };
+    if (opts.interactive)
+        return { allow: false, needsPrompt: true, reason: "interactive confirmation required" };
+    return {
+        allow: false,
+        needsPrompt: false,
+        reason: `${op.name} requires authorization; re-run with --yes in a non-interactive context`,
+    };
+}
+/** Per-op help text: description + one line per declared field. */
+export function deriveHelp(op) {
+    const schema = objectSchema(op);
+    const props = schema.properties ?? {};
+    const required = new Set(schema.required ?? []);
+    const lines = [`${op.name} — ${op.description}`, ""];
+    const entries = Object.entries(props);
+    if (entries.length === 0) {
+        lines.push("  (no parameters)");
+    }
+    else {
+        lines.push("Flags:");
+        for (const [field, fschema] of entries) {
+            const vals = stringEnumValues(fschema);
+            const t = vals ? vals.join("|") : fieldType(fschema);
+            const req = required.has(field) ? "required" : "optional";
+            const desc = fschema.description ? ` — ${fschema.description}` : "";
+            lines.push(`  --${field} <${t}>  (${req})${desc}`);
+        }
+    }
+    lines.push("", "Global flags: --cwd <dir>  --json  --yes  --writer <json>  --help");
+    return lines.join("\n");
+}
+/** Top-level help: one line per surfaced op + global flag notes. */
+export function deriveTopHelp() {
+    const lines = ["pi-context <op> [flags]", "", "Commands:"];
+    const width = Math.max(...useOps.map((o) => o.name.length));
+    for (const op of useOps) {
+        lines.push(`  ${op.name.padEnd(width)}  —  ${op.description.split("\n")[0]}`);
+    }
+    lines.push("", "Global flags:", "  --cwd <dir>      substrate root (default: cwd)", "  --json           emit { ok, op, output } envelope", "  --yes, --force   pre-authorize gated ops in non-interactive contexts", "  --writer <json>  override the auto-resolved writer identity", "  --help, -h       this help, or per-op help after an op name");
+    return lines.join("\n");
+}
+/** Prompt the operator on an interactive TTY. Resolves true on y/yes. */
+function promptConfirm(opName) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(`Authorize ${opName}? [y/N] `, (answer) => {
+            rl.close();
+            const a = answer.trim().toLowerCase();
+            resolve(a === "y" || a === "yes");
+        });
+    });
+}
+export async function main(argv) {
+    const first = argv[0];
+    if (first === undefined || first === "--help" || first === "-h") {
+        process.stdout.write(`${deriveTopHelp()}\n`);
+        return 0;
+    }
+    const op = resolveOp(first);
+    if (op === undefined) {
+        if (isProcessOnlyOp(first)) {
+            process.stderr.write(`${first} is not available via the CLI (process-only op)\n`);
+        }
+        else {
+            process.stderr.write(`unknown command: ${first}\n\n${deriveTopHelp()}\n`);
+        }
+        return 2;
+    }
+    let parsed;
+    try {
+        parsed = parseOpArgs(op, argv.slice(1));
+    }
+    catch (err) {
+        if (err instanceof UsageError) {
+            process.stderr.write(`error: ${err.message}\n\n${deriveHelp(op)}\n`);
+            return 2;
+        }
+        throw err;
+    }
+    if (parsed.help) {
+        process.stdout.write(`${deriveHelp(op)}\n`);
+        return 0;
+    }
+    injectWriter(op, parsed.params, resolveIdentity());
+    const decision = authDecision(op, {
+        yes: parsed.yes,
+        interactive: Boolean(process.stdin.isTTY && process.stdout.isTTY),
+    });
+    if (decision.allow === false) {
+        if (decision.needsPrompt) {
+            const ok = await promptConfirm(op.name);
+            if (!ok) {
+                process.stderr.write(`declined: ${op.name} not authorized\n`);
+                return 1;
+            }
+        }
+        else {
+            process.stderr.write(`${decision.reason}\n`);
+            return 1;
+        }
+    }
+    try {
+        const text = await op.run(parsed.cwd, parsed.params);
+        if (parsed.json) {
+            process.stdout.write(`${JSON.stringify({ ok: true, op: op.name, output: text })}\n`);
+        }
+        else {
+            process.stdout.write(`${text}\n`);
+        }
+        return 0;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (parsed.json) {
+            process.stdout.write(`${JSON.stringify({ ok: false, op: op.name, error: message })}\n`);
+        }
+        else {
+            process.stderr.write(`error: ${message}\n`);
+        }
+        return 1;
+    }
+}
+/**
+ * True when this module is the process entrypoint (invoked as `pi-context …`),
+ * false when it is merely imported (e.g. by the unit tests). Guards the
+ * auto-run so importing the module to test its pure helpers does not execute
+ * main() against the test runner's argv.
+ */
+function isEntrypoint() {
+    const invoked = process.argv[1];
+    if (invoked === undefined)
+        return false;
+    try {
+        return fileURLToPath(import.meta.url) === path.resolve(invoked);
+    }
+    catch {
+        return false;
+    }
+}
+// Module entrypoint: run main() and map its resolved exit code. A thrown
+// (non-UsageError) error maps to exit 1.
+if (isEntrypoint()) {
+    main(process.argv.slice(2))
+        .then((code) => {
+        process.exitCode = code;
+    })
+        .catch((err) => {
+        process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+	"name": "@davidorex/pi-context-cli",
+	"version": "0.28.0",
+	"publishConfig": {
+		"access": "public"
+	},
+	"description": "Auto-tracking command-line interface over the pi-context op-registry — every substrate op surfaces as a CLI command by reflection, no hardcoded command list",
+	"license": "MIT",
+	"author": "David Ryan",
+	"type": "module",
+	"keywords": [
+		"pi-context",
+		"cli"
+	],
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/davidorex/pi-project-workflows.git",
+		"directory": "packages/pi-context-cli"
+	},
+	"homepage": "https://github.com/davidorex/pi-project-workflows/tree/main/packages/pi-context-cli",
+	"main": "./dist/cli.js",
+	"bin": {
+		"pi-context": "./dist/cli.js"
+	},
+	"files": [
+		"dist/",
+		"*.md"
+	],
+	"scripts": {
+		"clean": "rm -rf dist",
+		"build": "rm -rf dist && tsc -p tsconfig.build.json",
+		"prepublishOnly": "npm run clean && npm run build",
+		"test": "tsx --test src/*.test.ts"
+	},
+	"dependencies": {
+		"@davidorex/pi-context": "^0.28.0",
+		"typebox": "^1.1.24"
+	},
+	"engines": {
+		"node": ">=22.19.0"
+	}
+}