@stigmer/cli 3.0.8

package/commands/execution/trace.js

@@ -0,0 +1,24 @@
+// `stigmer execution trace <execution-id>` — show task/tool structure + timing.
+// Thin handler: resolve the client and format, delegate to
+// resources/execution-trace.ts. Mirrors Go's execution_trace.go.
+import { ensureAuthenticated } from "../../config/index.js";
+import { addReadFlags, readFormat } from "../shared.js";
+export function registerExecutionTrace(execution) {
+    const trace = execution
+        .command("trace <execution-id>")
+        .description("show execution task structure and timing")
+        .action((executionId, options) => runTrace(executionId, options));
+    addReadFlags(trace);
+}
+async function runTrace(executionId, options) {
+    // Read-class format resolves to exactly table | json | yaml — the trace surface.
+    const format = readFormat(options);
+    const [{ connectBackend }, { traceExecution }] = await Promise.all([
+        import("../../backend.js"),
+        import("../../resources/execution-trace.js"),
+    ]);
+    const client = connectBackend();
+    ensureAuthenticated(client.config);
+    await traceExecution(client.stigmer, executionId, format);
+}
+//# sourceMappingURL=trace.js.map

package/commands/execution/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/commands/execution/trace.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,2DAA2D;AAC3D,iEAAiE;AAGjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,UAAU,sBAAsB,CAAC,SAAkB;IACvD,MAAM,KAAK,GAAG,SAAS;SACpB,OAAO,CAAC,sBAAsB,CAAC;SAC/B,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,CAAC,WAAmB,EAAE,OAAoB,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACzF,YAAY,CAAC,KAAK,CAAC,CAAC;AACtB,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,WAAmB,EAAE,OAAoB;IAC/D,iFAAiF;IACjF,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAgB,CAAC;IAElD,MAAM,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACjE,MAAM,CAAC,kBAAkB,CAAC;QAC1B,MAAM,CAAC,oCAAoC,CAAC;KAC7C,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEnC,MAAM,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC"}

package/commands/get.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerGet(program: Command): void;
+//# sourceMappingURL=get.d.ts.map

package/commands/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../src/commands/get.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAUlD"}

package/commands/get.js

@@ -0,0 +1,81 @@
+// `stigmer get <type> <reference>` — fetch a single resource.
+//
+// Thin handler: route the two non-registry special cases (executions, addressed
+// by `aex_`/`wex_` ID; workflow version history/retrieval) first, then the
+// registry-driven standard path. Heavy modules (backend client, SDK schemas)
+// are dynamically imported inside the action so `--help` stays fast (DD-001).
+import { ensureAuthenticated, resolveOrganization } from "../config/index.js";
+import { UsageError } from "../errors/index.js";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { defaultRegistry, Verb } from "../registry/index.js";
+import { addReadFlags, globalOrg, readFormat } from "./shared.js";
+export function registerGet(program) {
+    const get = program
+        .command("get <type> <reference>")
+        .description("get a resource by type and reference (slug, org/slug, or ID)")
+        .option("--version <hashOrTag>", "fetch a specific version by hash or tag (workflows only)")
+        .option("--version-history", "show the version history timeline (workflows only)")
+        .action((type, reference, options, command) => runGet(type, reference, options, command));
+    addReadFlags(get);
+}
+async function runGet(type, reference, options, command) {
+    const { isExecutionAlias } = await import("../resources/execution.js");
+    if (isExecutionAlias(type)) {
+        await runGetExecution(reference, options, command);
+        return;
+    }
+    const info = defaultRegistry().getByAlias(type);
+    if (info === undefined) {
+        throw new UsageError(`unknown resource type: ${type}`);
+    }
+    if (!info.supportedVerbs.has(Verb.Get)) {
+        throw new UsageError(`${info.displayName} does not support 'get'`);
+    }
+    const [{ connectBackend }, { parseReference }, { fetchResource }, { renderResource }] = await Promise.all([
+        import("../backend.js"),
+        import("../resources/reference.js"),
+        import("../resources/get.js"),
+        import("../resources/render.js"),
+    ]);
+    const client = connectBackend();
+    ensureAuthenticated(client.config);
+    const org = resolveOrganization(client.config, globalOrg(command));
+    // Workflow versioning is the only versioned read surface today (Go ignores the
+    // flags for other kinds, returning the current resource).
+    if (info.kind === ApiResourceKind.workflow && (options.versionHistory === true || (options.version ?? "") !== "")) {
+        const [refOrg, slug] = parseOrgSlug(reference, org);
+        const { renderWorkflowVersionHistory, getWorkflowVersionYaml } = await import("../resources/version.js");
+        if (options.versionHistory === true) {
+            process.stdout.write(await renderWorkflowVersionHistory(client.stigmer, refOrg, slug));
+        }
+        else {
+            process.stdout.write(await getWorkflowVersionYaml(client.stigmer, refOrg, slug, options.version ?? ""));
+        }
+        return;
+    }
+    const parsed = parseReference(reference, org, info.idPrefix);
+    const { schema, message } = await fetchResource(client.stigmer, info.kind, parsed);
+    process.stdout.write(renderResource(schema, message, readFormat(options)));
+}
+async function runGetExecution(reference, options, command) {
+    const [{ connectBackend }, { getExecution }, { renderResource }] = await Promise.all([
+        import("../backend.js"),
+        import("../resources/execution.js"),
+        import("../resources/render.js"),
+    ]);
+    const client = connectBackend();
+    ensureAuthenticated(client.config);
+    // Executions are addressed by ID; org context is irrelevant. `getExecution`
+    // resolves agent-vs-workflow by prefix and throws a usage error otherwise.
+    void globalOrg(command);
+    const { schema, message } = await getExecution(client.stigmer, reference);
+    process.stdout.write(renderResource(schema, message, readFormat(options)));
+}
+// Splits "org/slug" into its parts; a bare token uses the resolved org context.
+function parseOrgSlug(reference, org) {
+    const idx = reference.indexOf("/");
+    if (idx > 0)
+        return [reference.slice(0, idx), reference.slice(idx + 1)];
+    return [org, reference];
+}
+//# sourceMappingURL=get.js.map

package/commands/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/commands/get.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,gFAAgF;AAChF,2EAA2E;AAC3E,6EAA6E;AAC7E,8EAA8E;AAG9E,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,eAAe,EAAE,MAAM,qFAAqF,CAAC;AACtH,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOlE,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,wBAAwB,CAAC;SACjC,WAAW,CAAC,8DAA8D,CAAC;SAC3E,MAAM,CAAC,uBAAuB,EAAE,0DAA0D,CAAC;SAC3F,MAAM,CAAC,mBAAmB,EAAE,oDAAoD,CAAC;SACjF,MAAM,CAAC,CAAC,IAAY,EAAE,SAAiB,EAAE,OAAiB,EAAE,OAAgB,EAAE,EAAE,CAC/E,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAC1C,CAAC;IACJ,YAAY,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAY,EAAE,SAAiB,EAAE,OAAiB,EAAE,OAAgB;IACxF,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACvE,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,UAAU,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,CAAC,WAAW,yBAAyB,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACxG,MAAM,CAAC,eAAe,CAAC;QACvB,MAAM,CAAC,2BAA2B,CAAC;QACnC,MAAM,CAAC,qBAAqB,CAAC;QAC7B,MAAM,CAAC,wBAAwB,CAAC;KACjC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,mBAAmB,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAEnE,+EAA+E;IAC/E,0DAA0D;IAC1D,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,cAAc,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;QAClH,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACpD,MAAM,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;QACzG,IAAI,OAAO,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,4BAA4B,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;QACzF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,sBAAsB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1G,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7D,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,SAAiB,EAAE,OAAiB,EAAE,OAAgB;IACnF,MAAM,CAAC,EAAE,cAAc,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACnF,MAAM,CAAC,eAAe,CAAC;QACvB,MAAM,CAAC,2BAA2B,CAAC;QACnC,MAAM,CAAC,wBAAwB,CAAC;KACjC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnC,4EAA4E;IAC5E,2EAA2E;IAC3E,KAAK,SAAS,CAAC,OAAO,CAAC,CAAC;IAExB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,gFAAgF;AAChF,SAAS,YAAY,CAAC,SAAiB,EAAE,GAAW;IAClD,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAC1B,CAAC"}

package/commands/internal-daemon.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerInternalDaemon(program: Command): void;
+//# sourceMappingURL=internal-daemon.d.ts.map

package/commands/internal-daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-daemon.d.ts","sourceRoot":"","sources":["../../src/commands/internal-daemon.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAS7D"}

package/commands/internal-daemon.js

@@ -0,0 +1,22 @@
+// `stigmer internal-daemon` (hidden) — the long-lived supervised daemon process
+// that `up` re-execs. It is not meant to be invoked directly; it runs the local
+// stack until it receives SIGTERM/SIGINT, then exits with the daemon's code.
+export function registerInternalDaemon(program) {
+    program
+        .command("internal-daemon", { hidden: true })
+        .description("internal: run the supervised local-stack daemon (do not invoke directly)")
+        .action(async () => {
+        const { runInternalDaemon } = await import("../local/daemon/process.js");
+        const code = await runInternalDaemon({ waitForShutdown: waitForShutdownSignal });
+        process.exit(code);
+    });
+}
+// Resolve when the first SIGTERM/SIGINT arrives — the daemon's shutdown trigger.
+function waitForShutdownSignal() {
+    return new Promise((resolve) => {
+        const onSignal = () => resolve();
+        process.once("SIGTERM", onSignal);
+        process.once("SIGINT", onSignal);
+    });
+}
+//# sourceMappingURL=internal-daemon.js.map

package/commands/internal-daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-daemon.js","sourceRoot":"","sources":["../../src/commands/internal-daemon.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,gFAAgF;AAChF,6EAA6E;AAI7E,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,iBAAiB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAC5C,WAAW,CAAC,0EAA0E,CAAC;SACvF,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,MAAM,iBAAiB,CAAC,EAAE,eAAe,EAAE,qBAAqB,EAAE,CAAC,CAAC;QACjF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;AACP,CAAC;AAED,iFAAiF;AACjF,SAAS,qBAAqB;IAC5B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,QAAQ,GAAG,GAAS,EAAE,CAAC,OAAO,EAAE,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/commands/list.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerList(program: Command): void;
+//# sourceMappingURL=list.d.ts.map

package/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CASnD"}

package/commands/list.js

@@ -0,0 +1,117 @@
+// `stigmer list <type>` — list resources of a type, or `list types` to show the
+// registry of available types. Thin handler: resolve/route, delegate, render.
+import { stringify as toYaml } from "yaml";
+import { ensureAuthenticated, resolveOrganization } from "../config/index.js";
+import { UsageError } from "../errors/index.js";
+import { renderTable } from "../output/index.js";
+import { ALL_VERBS, defaultRegistry, Verb } from "../registry/index.js";
+import { addReadFlags, globalOrg, readFormat } from "./shared.js";
+const DEFAULT_LIMIT = 50;
+export function registerList(program) {
+    const list = program
+        .command("list <type>")
+        .description("list resources of a type (or 'list types' for available types)")
+        .option("--limit <n>", "maximum number of results", String(DEFAULT_LIMIT))
+        .option("--verb <verb>", "filter to types supporting this verb (only for 'list types')")
+        .option("--type <kind>", "execution type filter: agent or workflow (only for 'list executions')")
+        .action((type, options, command) => runList(type, options, command));
+    addReadFlags(list);
+}
+async function runList(type, options, command) {
+    if (isTypesAlias(type)) {
+        process.stdout.write(renderTypes(options.verb, readFormat(options)));
+        return;
+    }
+    const { isExecutionAlias } = await import("../resources/execution.js");
+    const { isSessionAlias } = await import("../resources/session.js");
+    if (isExecutionAlias(type)) {
+        await runListExecutions(options);
+        return;
+    }
+    if (isSessionAlias(type)) {
+        await runListSessions(options);
+        return;
+    }
+    const info = defaultRegistry().getByAlias(type);
+    if (info === undefined) {
+        throw new UsageError(`unknown resource type: ${type}`);
+    }
+    if (!info.supportedVerbs.has(Verb.List)) {
+        throw new UsageError(`${info.displayName} does not support 'list'`);
+    }
+    const [{ connectBackend }, { listResources }] = await Promise.all([
+        import("../backend.js"),
+        import("../resources/list.js"),
+    ]);
+    const client = connectBackend();
+    ensureAuthenticated(client.config);
+    const org = resolveOrganization(client.config, globalOrg(command));
+    const rendered = await listResources(client.stigmer, info.kind, org, parseLimit(options.limit), readFormat(options));
+    process.stdout.write(rendered);
+}
+// Executions bypass the registry: they're listed by their own controllers and
+// optionally filtered to agent (default) or workflow by `--type`.
+async function runListExecutions(options) {
+    const [{ connectBackend }, execution] = await Promise.all([
+        import("../backend.js"),
+        import("../resources/execution.js"),
+    ]);
+    const client = connectBackend();
+    ensureAuthenticated(client.config);
+    const limit = parseLimit(options.limit);
+    const format = readFormat(options);
+    const filter = (options.type ?? "").trim().toLowerCase();
+    if (filter === "workflow" || filter === "wf") {
+        const result = await execution.listWorkflowExecutions(client.stigmer, limit);
+        process.stdout.write(execution.renderExecutionList(result, format, "workflow"));
+        return;
+    }
+    if (filter !== "" && filter !== "agent") {
+        throw new UsageError(`unknown execution type filter: ${options.type}\n\nValid values: agent, workflow`);
+    }
+    const result = await execution.listAgentExecutions(client.stigmer, limit);
+    process.stdout.write(execution.renderExecutionList(result, format, "agent"));
+}
+async function runListSessions(options) {
+    const [{ connectBackend }, session] = await Promise.all([
+        import("../backend.js"),
+        import("../resources/session.js"),
+    ]);
+    const client = connectBackend();
+    ensureAuthenticated(client.config);
+    const result = await session.listSessions(client.stigmer, parseLimit(options.limit));
+    process.stdout.write(session.renderSessionList(result, readFormat(options)));
+}
+function isTypesAlias(type) {
+    const normalized = type.trim().toLowerCase();
+    return normalized === "type" || normalized === "types";
+}
+function parseLimit(raw) {
+    if (raw === undefined || raw === "")
+        return DEFAULT_LIMIT;
+    if (!/^\d+$/.test(raw))
+        throw new UsageError(`invalid --limit value "${raw}"`);
+    return Number.parseInt(raw, 10);
+}
+// `list types` reads from the local registry — no backend call.
+function renderTypes(verbFilter, format) {
+    const registry = defaultRegistry();
+    const verb = verbFilter !== undefined && verbFilter !== "" ? verbFilter.toLowerCase() : undefined;
+    if (verb !== undefined && !ALL_VERBS.includes(verb)) {
+        throw new UsageError(`unknown verb: ${verbFilter}`);
+    }
+    const types = (verb !== undefined ? registry.typesForVerb(verb) : registry.all()).map((info) => ({
+        name: info.name,
+        display_name: info.displayName,
+        id_prefix: info.idPrefix,
+        aliases: [...info.aliases],
+        verbs: ALL_VERBS.filter((v) => info.supportedVerbs.has(v)),
+    }));
+    if (format === "json")
+        return `${JSON.stringify(types, null, 2)}\n`;
+    if (format === "yaml")
+        return toYaml(types);
+    const rows = types.map((t) => [t.name, t.id_prefix, t.verbs.join(", ")]);
+    return `\n${renderTable(["TYPE", "ID PREFIX", "VERBS"], rows)}`;
+}
+//# sourceMappingURL=list.js.map

package/commands/list.js.map

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

package/commands/logs.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerLogs(program: Command): void;
+//# sourceMappingURL=logs.d.ts.map

package/commands/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/commands/logs.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CASnD"}

package/commands/logs.js

@@ -0,0 +1,59 @@
+// `stigmer logs` — view daemon component logs, with `kubectl logs`-style
+// defaults: follow all components live, showing a tail snapshot first.
+//
+//   stigmer logs                       # follow all components
+//   stigmer logs --no-follow --tail 100
+//   stigmer logs --component runner    # just the runner
+import { homedir } from "node:os";
+export function registerLogs(program) {
+    program
+        .command("logs")
+        .description("view logs from the local Stigmer stack")
+        .option("-f, --no-follow", "do not stream new log lines (show the tail and exit)")
+        .option("-n, --tail <lines>", "number of recent lines to show before streaming", "50")
+        .option("-c, --component <name>", "show a single component (stigmer-server, runner, or temporal)")
+        .option("--no-all", "with --component unset, restrict to the default component")
+        .action((options) => runLogs(options));
+}
+async function runLogs(options) {
+    const { allComponents, componentByName, followAll, printTail } = await import("../local/logs/view.js");
+    const { logDir } = await import("../local/paths.js");
+    const { CliExitError } = await import("../errors/cli-exit-error.js");
+    const { ExitCode } = await import("../errors/exit-codes.js");
+    const dir = logDir(homedir());
+    const tail = Number.parseInt(options.tail ?? "50", 10);
+    const tailLines = Number.isNaN(tail) ? 50 : tail;
+    const follow = options.follow !== false;
+    // A single component is selected explicitly; otherwise show all unless the
+    // user opted out of the all-view (then fall back to the server's logs).
+    const useAll = options.component === undefined && options.all !== false;
+    const components = useAll
+        ? allComponents(dir)
+        : [
+            componentByName(dir, options.component ?? "stigmer-server") ??
+                (() => {
+                    throw new CliExitError(`unknown component: ${options.component}`, ExitCode.Usage, [
+                        "Valid components: stigmer-server, runner, temporal",
+                    ]);
+                })(),
+        ];
+    printTail(components, tailLines, process.stdout);
+    if (!follow)
+        return;
+    await streamUntilInterrupt(() => followAll(components, process.stdout));
+}
+// Follow until SIGINT, then stop cleanly. Resolves on Ctrl-C so the process can
+// exit 0 rather than dumping a stack trace.
+function streamUntilInterrupt(start) {
+    return new Promise((resolve) => {
+        const handle = start();
+        const onSignal = () => {
+            handle.stop();
+            process.removeListener("SIGINT", onSignal);
+            process.stderr.write("\n");
+            resolve();
+        };
+        process.on("SIGINT", onSignal);
+    });
+}
+//# sourceMappingURL=logs.js.map

package/commands/logs.js.map

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

package/commands/mcp-server.d.ts

@@ -0,0 +1,22 @@
+import type { Command } from "commander";
+import type { Config } from "../config/config.js";
+/** Flags the command bridges into the server's environment. */
+export interface McpServerFlags {
+    transport?: string;
+    port?: string;
+    serverAddress?: string;
+    apiKey?: string;
+    logFormat?: string;
+    logLevel?: string;
+}
+export declare function registerMcpServer(program: Command): void;
+/**
+ * Bridge CLI config into the server's environment, but only where unset, so a
+ * pre-existing environment variable (or a flag bridged before this) wins. Local
+ * backends connect to the local server without auth; cloud backends contribute
+ * the stored endpoint and token.
+ */
+export declare function applyConfigEnv(config: Config, env: NodeJS.ProcessEnv): void;
+/** Bridge explicitly-set flags into the server's environment (highest precedence). */
+export declare function applyFlagsEnv(flags: McpServerFlags, env: NodeJS.ProcessEnv): void;
+//# sourceMappingURL=mcp-server.d.ts.map

package/commands/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/commands/mcp-server.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAqBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAYxD;AAsBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAU3E;AAED,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAOjF"}

package/commands/mcp-server.js

@@ -0,0 +1,104 @@
+// `stigmer mcp-server` — start the Stigmer MCP server.
+//
+// The server is the TypeScript `@stigmer/mcp-server` package, and the CLI runs it
+// IN-PROCESS via its `run(cfg, signal)` embed API — the module exists precisely
+// so a host like the CLI embeds it rather than shelling out (the Go CLI shelled
+// out only because Go cannot import TypeScript). This avoids a child process, an
+// npx/tsx resolution dance, and a second Node startup.
+//
+// MCP clients (Cursor, Claude Desktop, Windsurf) spawn `stigmer mcp-server` and
+// speak the protocol over stdio, so stdout must carry ONLY MCP frames: the CLI's
+// logger writes to stderr (see logger.ts) and the server logs to stderr too. The
+// CLI owns the shutdown signal and aborts the server's AbortController on
+// SIGINT/SIGTERM.
+//
+// Configuration precedence (matches the Go CLI): flags > env > ~/.stigmer config
+// > server defaults. We realize that precedence by bridging config into the
+// environment only where unset, then letting explicit flags override, and finally
+// letting the server read its Config from the environment.
+const HELP_AFTER = `
+Environment variables:
+  STIGMER_SERVER_ADDRESS         gRPC address (default: CLI config, else localhost:7234)
+  STIGMER_API_KEY                API key (auto-resolved from CLI config for cloud)
+  STIGMER_MCP_TRANSPORT          stdio | http | both (default: stdio)
+  STIGMER_MCP_HTTP_PORT          HTTP listen port (default: 8080)
+  STIGMER_MCP_LOG_FORMAT         text | json (default: text)
+  STIGMER_MCP_LOG_LEVEL          debug | info | warn | error (default: info)
+
+Examples:
+  # STDIO mode (default — what MCP clients spawn)
+  $ stigmer mcp-server
+
+  # HTTP mode on a custom port
+  $ stigmer mcp-server --transport http --port 9090
+
+  # Cursor mcp.json:
+  # { "command": "stigmer", "args": ["mcp-server"] }`;
+export function registerMcpServer(program) {
+    program
+        .command("mcp-server")
+        .description("start the MCP server that exposes Stigmer resources to AI coding assistants")
+        .option("--transport <mode>", "transport mode: stdio, http, or both (env: STIGMER_MCP_TRANSPORT)")
+        .option("--port <port>", "HTTP listen port (env: STIGMER_MCP_HTTP_PORT)")
+        .option("--server-address <addr>", "gRPC address of stigmer-server (env: STIGMER_SERVER_ADDRESS)")
+        .option("--api-key <key>", "API key for stigmer-server (env: STIGMER_API_KEY)")
+        .option("--log-format <fmt>", "log encoding: text or json (env: STIGMER_MCP_LOG_FORMAT)")
+        .option("--log-level <level>", "minimum log level: debug, info, warn, or error (env: STIGMER_MCP_LOG_LEVEL)")
+        .addHelpText("after", HELP_AFTER)
+        .action((flags) => runMcpServer(flags));
+}
+async function runMcpServer(flags) {
+    const { load } = await import("../config/config.js");
+    applyConfigEnv(load(), process.env);
+    applyFlagsEnv(flags, process.env);
+    // Imported lazily so `stigmer --help`/`version` never pull in the MCP stack.
+    const { run, defaultConfig } = await import("@stigmer/mcp-server");
+    const controller = new AbortController();
+    const onSignal = () => controller.abort();
+    process.once("SIGINT", onSignal);
+    process.once("SIGTERM", onSignal);
+    try {
+        await run(defaultConfig(), controller.signal);
+    }
+    finally {
+        process.removeListener("SIGINT", onSignal);
+        process.removeListener("SIGTERM", onSignal);
+    }
+}
+/**
+ * Bridge CLI config into the server's environment, but only where unset, so a
+ * pre-existing environment variable (or a flag bridged before this) wins. Local
+ * backends connect to the local server without auth; cloud backends contribute
+ * the stored endpoint and token.
+ */
+export function applyConfigEnv(config, env) {
+    if (config.backend.type === "local") {
+        setIfEmpty(env, "STIGMER_SERVER_ADDRESS", "localhost:7234");
+        return;
+    }
+    const cloud = config.backend.cloud;
+    if (cloud !== undefined) {
+        setIfEmpty(env, "STIGMER_SERVER_ADDRESS", cloud.endpoint);
+        setIfEmpty(env, "STIGMER_API_KEY", cloud.token);
+    }
+}
+/** Bridge explicitly-set flags into the server's environment (highest precedence). */
+export function applyFlagsEnv(flags, env) {
+    setIfPresent(env, "STIGMER_MCP_TRANSPORT", flags.transport);
+    setIfPresent(env, "STIGMER_MCP_HTTP_PORT", flags.port);
+    setIfPresent(env, "STIGMER_SERVER_ADDRESS", flags.serverAddress);
+    setIfPresent(env, "STIGMER_API_KEY", flags.apiKey);
+    setIfPresent(env, "STIGMER_MCP_LOG_FORMAT", flags.logFormat);
+    setIfPresent(env, "STIGMER_MCP_LOG_LEVEL", flags.logLevel);
+}
+function setIfEmpty(env, key, value) {
+    if (value !== undefined && value !== "" && (env[key] === undefined || env[key] === "")) {
+        env[key] = value;
+    }
+}
+function setIfPresent(env, key, value) {
+    if (value !== undefined && value !== "") {
+        env[key] = value;
+    }
+}
+//# sourceMappingURL=mcp-server.js.map

package/commands/mcp-server.js.map

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

package/commands/push.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerPush(program: Command): void;
+//# sourceMappingURL=push.d.ts.map

package/commands/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/commands/push.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiBnD"}