@kindgi/cli 0.0.0-bootstrap.0 → 0.1.1

package/dist/commands/test.js

@@ -0,0 +1,181 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * `kindgi test` — run the pack's tests via vitest.
+ *
+ * Shells out to the pack's OWN installed vitest binary
+ * (either `pnpm exec vitest` or `npx --no-install vitest`, picked at
+ * production wire time). The CLI does NOT bundle a vitest version —
+ * that would force upgrades on downstream packs whenever the CLI
+ * upgrades.
+ *
+ * Ergonomic defaults:
+ *   - Refuses to spawn without a `vitest.config.*` at the pack root
+ *     (bare vitest would sweep the whole repo on dev machines).
+ *   - `--watch` threads through as `--watch`. Everything else (except
+ *     the CLI's own `--reporter` short-cut + `--path`) is verbatim
+ *     pass-through after `--`.
+ *   - Ctrl+C forwards to the child process (via `ctx.stopSignal`),
+ *     matching `kindgi dev`.
+ *
+ * Every child-process side-effect flows through `TestRunners` so tests
+ * substitute stubs; production wiring lives at
+ * `packages/cli/src/test/defaults.ts`.
+ */
+import { readFile } from 'node:fs/promises';
+import { isAbsolute, join, resolve } from 'node:path';
+import { KINDGI_CONFIG_FILENAMES } from '@kindgi/handler-runtime';
+import { renderJson } from '../output.js';
+export const testCommand = {
+    kind: 'leaf',
+    name: 'test',
+    description: "Run the pack's tests via vitest. Ergonomic wrapper over `vitest run`.",
+    usage: 'kindgi test [--watch] [--reporter <name>] [--path <dir>] [-- <vitest-args>...]',
+    optionSpec: {
+        watch: {
+            type: 'boolean',
+            description: 'Run vitest in watch mode. By default the tests run once (`vitest run`).',
+        },
+        reporter: {
+            type: 'string',
+            description: "The vitest reporter to use (vitest's `--reporter`), e.g. `verbose` or `json`.",
+        },
+        path: {
+            type: 'string',
+            description: 'The pack root, with a `kindgi.config.ts` (or `.mts`) and a `vitest.config.*`. Default: the current directory.',
+        },
+    },
+    run: async (ctx) => runTestCommand(ctx),
+};
+export async function runTestCommand(ctx) {
+    const runners = ctx.testRunners;
+    if (runners === undefined) {
+        return {
+            kind: 'error',
+            stderr: 'Internal error: kindgi test requires test runners to be wired. ' +
+                'Rebuild the CLI (`pnpm --filter @kindgi/cli build`).\n',
+            exitCode: 1,
+        };
+    }
+    const args = resolveArgs(ctx);
+    // Confirm kindgi.config.ts sits at the pack root — same shape
+    // kindgi dev / build use. Failing loud beats a cryptic vitest
+    // error later.
+    const configOk = await ensurePackConfig(args.packDir);
+    if (!configOk) {
+        return {
+            kind: 'error',
+            stderr: `kindgi test could not find a kindgi.config.ts at ${args.packDir}.\nRun \`kindgi init <pack-name>\` to scaffold a pack, or pass --path=<dir>.\n`,
+            exitCode: 1,
+        };
+    }
+    const hasConfig = await runners.hasVitestConfig({ packDir: args.packDir });
+    if (!hasConfig) {
+        return {
+            kind: 'error',
+            stderr: `kindgi test could not find a vitest config at ${args.packDir}.\nCreate one (e.g. \`vitest.config.ts\`) or \`cd\` into your pack root.\nThe two templates shipped with \`kindgi init\` ship one out of the box.\n`,
+            exitCode: 1,
+        };
+    }
+    const forwarded = buildForwardedArgs(args);
+    const banner = [
+        '',
+        `  Running pack tests: ${args.packDir}`,
+        `    Runner:    vitest (via pack's local install)`,
+        `    Mode:      ${args.watch ? 'watch' : 'one-shot'}`,
+        ...(args.reporter !== undefined ? [`    Reporter:  ${args.reporter}`] : []),
+        ...(args.passthroughArgs.length > 0
+            ? [`    Pass-through args: ${args.passthroughArgs.join(' ')}`]
+            : []),
+        '',
+    ];
+    const result = await runners.runTests({
+        packDir: args.packDir,
+        runner: 'vitest',
+        args: forwarded,
+        env: ctx.env,
+        ...(ctx.stopSignal !== undefined && { signal: ctx.stopSignal }),
+        onLog: (chunk) => {
+            // Forward child output to stderr so JSON stdout stays clean.
+            process.stderr.write(chunk);
+        },
+    });
+    if (!result.spawned) {
+        if (result.reason === 'runner-binary-not-found') {
+            return {
+                kind: 'error',
+                stderr: 'kindgi test could not find the vitest binary. ' +
+                    'Install it in your pack: `pnpm add -D vitest` (or `npm i -D vitest`).\n' +
+                    `The CLI does NOT bundle vitest — it uses the pack's own install.\n`,
+                exitCode: 1,
+            };
+        }
+        return {
+            kind: 'error',
+            stderr: `kindgi test failed to spawn the vitest runner (${result.resolvedBinary ?? 'unknown'}). Check your pack's install (\`pnpm install\`) and re-run.\n`,
+            exitCode: 1,
+        };
+    }
+    const summary = {
+        packDir: args.packDir,
+        runner: 'vitest',
+        resolvedBinary: result.resolvedBinary,
+        watch: args.watch,
+        ...(args.reporter !== undefined && { reporter: args.reporter }),
+        passthroughArgs: args.passthroughArgs,
+        exitCode: result.exitCode,
+    };
+    const rendered = renderJson(summary, ctx.globals.format);
+    const stderr = `${banner.join('\n')}\n`;
+    if (result.exitCode === 0) {
+        return { kind: 'ok', rendered: { stdout: rendered.stdout, stderr } };
+    }
+    return {
+        kind: 'ok',
+        exitCode: result.exitCode,
+        rendered: { stdout: rendered.stdout, stderr },
+    };
+}
+function resolveArgs(ctx) {
+    const pathFlag = ctx.options.path;
+    const rawPath = typeof pathFlag === 'string' && pathFlag !== '' ? pathFlag : ctx.cwd;
+    const packDir = isAbsolute(rawPath) ? rawPath : resolve(ctx.cwd, rawPath);
+    const watch = ctx.options.watch === true;
+    const reporterFlag = ctx.options.reporter;
+    const reporter = typeof reporterFlag === 'string' && reporterFlag !== '' ? reporterFlag : undefined;
+    // node:util.parseArgs surfaces tokens after `--` as regular
+    // positionals when `allowPositionals: true`. `kindgi test` treats
+    // every positional as a pass-through vitest arg — the command has
+    // no positional inputs of its own.
+    const passthroughArgs = ctx.positionals;
+    return { packDir, watch, reporter, passthroughArgs };
+}
+function buildForwardedArgs(args) {
+    const out = [];
+    // vitest defaults to watch=true when invoked without subcommand; the
+    // CLI's contract is one-shot unless `--watch` is set.
+    if (args.watch) {
+        out.push('--watch');
+    }
+    else {
+        out.push('run');
+    }
+    if (args.reporter !== undefined) {
+        out.push('--reporter', args.reporter);
+    }
+    out.push(...args.passthroughArgs);
+    return out;
+}
+async function ensurePackConfig(packDir) {
+    for (const c of KINDGI_CONFIG_FILENAMES) {
+        try {
+            await readFile(join(packDir, c), 'utf8');
+            return true;
+        }
+        catch {
+            // try next
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=test.js.map

package/dist/commands/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,uEAAuE;IACpF,KAAK,EAAE,gFAAgF;IACvF,UAAU,EAAE;QACV,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,yEAAyE;SACvF;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,+EAA+E;SAC7F;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,+GAA+G;SAClH;KACF;IACD,GAAG,EAAE,KAAK,EAAE,GAAG,EAA0B,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC;CAChE,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAmB;IACtD,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC;IAChC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO;YACL,IAAI,EAAE,OAAO;YACb,MAAM,EACJ,iEAAiE;gBACjE,wDAAwD;YAC1D,QAAQ,EAAE,CAAC;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAE9B,8DAA8D;IAC9D,8DAA8D;IAC9D,eAAe;IACf,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,oDAAoD,IAAI,CAAC,OAAO,gFAAgF;YACxJ,QAAQ,EAAE,CAAC;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,iDAAiD,IAAI,CAAC,OAAO,qJAAqJ;YAC1N,QAAQ,EAAE,CAAC;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAa;QACvB,EAAE;QACF,yBAAyB,IAAI,CAAC,OAAO,EAAE;QACvC,kDAAkD;QAClD,kBAAkB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE;QACrD,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC;YACjC,CAAC,CAAC,CAAC,0BAA0B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9D,CAAC,CAAC,EAAE,CAAC;QACP,EAAE;KACH,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC;QACpC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,GAAG,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;QAC/D,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE;YACvB,6DAA6D;YAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,MAAM,CAAC,MAAM,KAAK,yBAAyB,EAAE,CAAC;YAChD,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,MAAM,EACJ,gDAAgD;oBAChD,yEAAyE;oBACzE,oEAAoE;gBACtE,QAAQ,EAAE,CAAC;aACZ,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,kDAAkD,MAAM,CAAC,cAAc,IAAI,SAAS,+DAA+D;YAC3J,QAAQ,EAAE,CAAC;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,QAAiB;QACzB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC/D,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;IACF,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACxC,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IACvE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE;KAC9C,CAAC;AACJ,CAAC;AAaD,SAAS,WAAW,CAAC,GAAmB;IACtC,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;IAClC,MAAM,OAAO,GAAG,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACrF,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAE1E,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC;IACzC,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC1C,MAAM,QAAQ,GACZ,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;IAErF,4DAA4D;IAC5D,kEAAkE;IAClE,kEAAkE;IAClE,mCAAmC;IACnC,MAAM,eAAe,GAAG,GAAG,CAAC,WAAW,CAAC;IAExC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAsB;IAChD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,qEAAqE;IACrE,sDAAsD;IACtD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxC,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;IAClC,OAAO,GAAG,CAAC;AACb,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,OAAe;IAC7C,KAAK,MAAM,CAAC,IAAI,uBAAuB,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,WAAW;QACb,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/commands/tokens.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from './types.js';
+export declare const tokensCommand: Command;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/commands/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/commands/tokens.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,YAAY,CAAC;AA6BvD,eAAO,MAAM,aAAa,EAAE,OAK3B,CAAC"}

package/dist/commands/tokens.js

@@ -0,0 +1,33 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { requiredPositional, runSdk, throwUnwired } from './helpers.js';
+const create = {
+    kind: 'leaf',
+    name: 'create',
+    description: 'Create a new API token.',
+    usage: 'kindgi tokens create --spec=<json-or-@file>',
+    optionSpec: {
+        spec: {
+            type: 'string',
+            description: 'The token as inline JSON or `@<file>`, every field optional: `role` (`admin` or `member`, default `member`), `capabilities`, `label`, `expiresAt`, `projectId`.',
+        },
+    },
+    run: (ctx) => runSdk(ctx, 'tokens create', async () => throwUnwired('tokens.create')),
+};
+const revoke = {
+    kind: 'leaf',
+    name: 'revoke',
+    description: 'Revoke an API token.',
+    usage: 'kindgi tokens revoke <token-id>',
+    run: (ctx) => runSdk(ctx, 'tokens revoke', async () => {
+        requiredPositional(ctx, 0, 'token-id');
+        throwUnwired('tokens.revoke');
+    }),
+};
+export const tokensCommand = {
+    kind: 'group',
+    name: 'tokens',
+    description: 'Manage API tokens.',
+    subcommands: [create, revoke],
+};
+//# sourceMappingURL=tokens.js.map

package/dist/commands/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/commands/tokens.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGxE,MAAM,MAAM,GAAgB;IAC1B,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,yBAAyB;IACtC,KAAK,EAAE,6CAA6C;IACpD,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,iKAAiK;SACpK;KACF;IACD,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;CACtF,CAAC;AAEF,MAAM,MAAM,GAAgB;IAC1B,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,sBAAsB;IACnC,KAAK,EAAE,iCAAiC;IACxC,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CACX,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,IAAI,EAAE;QACtC,kBAAkB,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC;QACvC,YAAY,CAAC,eAAe,CAAC,CAAC;IAChC,CAAC,CAAC;CACL,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,oBAAoB;IACjC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;CAC9B,CAAC"}

package/dist/commands/tools.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from './types.js';
+export declare const toolsCommand: Command;
+//# sourceMappingURL=tools.d.ts.map

package/dist/commands/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/commands/tools.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,YAAY,CAAC;AA2KvD,eAAO,MAAM,YAAY,EAAE,OAK1B,CAAC"}

package/dist/commands/tools.js

@@ -0,0 +1,162 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { requiredPositional, runSdk, stringFlag, throwUnwired, truncateCell, } from './helpers.js';
+/** `tools list --table`. */
+const TOOLS_TABLE = {
+    rows: (page) => page.items,
+    columns: [
+        { header: 'ID', get: (tool) => String(tool.id) },
+        { header: 'VERSION', get: (tool) => tool.version ?? '' },
+        { header: 'DESCRIPTION', get: (tool) => truncateCell(tool.description, 60) },
+    ],
+};
+const list = {
+    kind: 'leaf',
+    name: 'list',
+    description: 'List registered tools.',
+    usage: 'kindgi tools list [--name=<prefix>] [--limit=<n>] [--cursor=<c>]',
+    optionSpec: {
+        name: { type: 'string', description: 'Only the tools whose id starts with this prefix.' },
+        limit: {
+            type: 'string',
+            description: 'The most tools to return (default 25, at most 100).',
+        },
+        cursor: {
+            type: 'string',
+            description: "Resume after this cursor, from the previous page's `nextCursor`.",
+        },
+    },
+    run: (ctx) => runSdk(ctx, 'tools list', async () => {
+        const name = stringFlag(ctx, 'name');
+        const cursor = stringFlag(ctx, 'cursor');
+        const limitStr = stringFlag(ctx, 'limit');
+        const limit = limitStr !== undefined ? Number.parseInt(limitStr, 10) : undefined;
+        if (limit !== undefined && Number.isNaN(limit)) {
+            throw new Error(`--limit must be an integer, got "${limitStr}"`);
+        }
+        return await ctx.client().tools.list({
+            ...(name !== undefined && { name }),
+            ...(cursor !== undefined && { cursor: cursor }),
+            ...(limit !== undefined && { limit }),
+        });
+    }, TOOLS_TABLE),
+};
+const get = {
+    kind: 'leaf',
+    name: 'get',
+    description: 'Fetch the latest active version of a tool.',
+    usage: 'kindgi tools get <tool-id>',
+    run: (ctx) => runSdk(ctx, 'tools get', async () => {
+        const toolId = requiredPositional(ctx, 0, 'tool-id');
+        return await ctx.client().tools.get(toolId);
+    }),
+};
+const publish = {
+    kind: 'leaf',
+    name: 'publish',
+    description: 'Publish a tool manifest at a specific version.',
+    usage: 'kindgi tools publish --manifest=<json-or-@file>',
+    optionSpec: {
+        manifest: {
+            type: 'string',
+            description: 'The tool manifest as JSON, or `@<file>` to read it from a file. Required.',
+        },
+    },
+    run: (ctx) => runSdk(ctx, 'tools publish', async () => throwUnwired('tools.publish')),
+};
+const unregister = {
+    kind: 'leaf',
+    name: 'unregister',
+    description: 'Unregister a specific tool version.',
+    usage: 'kindgi tools unregister <tool-id> --version=<semver>',
+    optionSpec: {
+        version: {
+            type: 'string',
+            description: 'The version to unregister (semver); `kindgi tools reinstate` brings it back. Required.',
+        },
+    },
+    run: (ctx) => runSdk(ctx, 'tools unregister', async () => {
+        const toolId = requiredPositional(ctx, 0, 'tool-id');
+        const version = stringFlag(ctx, 'version');
+        if (version === undefined)
+            throw new Error('--version=<semver> is required');
+        return await ctx.client().tools.unregisterVersion(toolId, version);
+    }),
+};
+const versions = {
+    kind: 'leaf',
+    name: 'versions',
+    description: 'List published versions of a tool (active + optionally tombstoned).',
+    usage: 'kindgi tools versions <tool-id> [--include-tombstoned] [--limit=<n>] [--cursor=<c>]',
+    optionSpec: {
+        'include-tombstoned': {
+            type: 'boolean',
+            description: 'Include unregistered versions too, each with its `unregisteredAt`.',
+        },
+        limit: {
+            type: 'string',
+            description: 'The most versions to return (default 25, at most 100).',
+        },
+        cursor: {
+            type: 'string',
+            description: "Resume after this cursor, from the previous page's `nextCursor`.",
+        },
+    },
+    run: (ctx) => runSdk(ctx, 'tools versions', async () => {
+        const toolId = requiredPositional(ctx, 0, 'tool-id');
+        const cursor = stringFlag(ctx, 'cursor');
+        const limitStr = stringFlag(ctx, 'limit');
+        const limit = limitStr !== undefined ? Number.parseInt(limitStr, 10) : undefined;
+        if (limit !== undefined && Number.isNaN(limit)) {
+            throw new Error(`--limit must be an integer, got "${limitStr}"`);
+        }
+        const includeTombstoned = ctx.options['include-tombstoned'] === true;
+        return await ctx.client().tools.listVersions(toolId, {
+            ...(cursor !== undefined && { cursor: cursor }),
+            ...(limit !== undefined && { limit }),
+            ...(includeTombstoned && { includeTombstoned: true }),
+        });
+    }),
+};
+const getVersion = {
+    kind: 'leaf',
+    name: 'get-version',
+    description: 'Fetch a specific tool version by exact semver.',
+    usage: 'kindgi tools get-version <tool-id> --version=<semver>',
+    optionSpec: {
+        version: { type: 'string', description: 'The exact version to fetch (semver). Required.' },
+    },
+    run: (ctx) => runSdk(ctx, 'tools get-version', async () => {
+        const toolId = requiredPositional(ctx, 0, 'tool-id');
+        const version = stringFlag(ctx, 'version');
+        if (version === undefined)
+            throw new Error('--version=<semver> is required');
+        return await ctx.client().tools.getVersion(toolId, version);
+    }),
+};
+const reinstate = {
+    kind: 'leaf',
+    name: 'reinstate',
+    description: 'Un-tombstone a specific tool version.',
+    usage: 'kindgi tools reinstate <tool-id> --version=<semver>',
+    optionSpec: {
+        version: {
+            type: 'string',
+            description: 'The unregistered version to bring back (semver). Required.',
+        },
+    },
+    run: (ctx) => runSdk(ctx, 'tools reinstate', async () => {
+        const toolId = requiredPositional(ctx, 0, 'tool-id');
+        const version = stringFlag(ctx, 'version');
+        if (version === undefined)
+            throw new Error('--version=<semver> is required');
+        return await ctx.client().tools.reinstateVersion(toolId, version);
+    }),
+};
+export const toolsCommand = {
+    kind: 'group',
+    name: 'tools',
+    description: 'Manage tool registrations.',
+    subcommands: [list, get, publish, unregister, versions, getVersion, reinstate],
+};
+//# sourceMappingURL=tools.js.map

package/dist/commands/tools.js.map

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

package/dist/commands/types.d.ts

@@ -0,0 +1,54 @@
+import type { CommandContext } from '../context.js';
+import type { Rendered } from '../output.js';
+/**
+ * A leaf command handler. Returns either a rendered success payload or
+ * a rendered error. The dispatcher writes stdout/stderr and picks an
+ * exit code accordingly.
+ */
+export type CommandResult = {
+    readonly kind: 'ok';
+    readonly rendered: Rendered;
+    readonly exitCode?: number;
+} | {
+    readonly kind: 'error';
+    readonly stderr: string;
+    readonly exitCode: number;
+};
+export interface LeafCommand {
+    readonly kind: 'leaf';
+    readonly name: string;
+    readonly description: string;
+    readonly usage: string;
+    /** Option spec merged with the global spec by the parser. */
+    readonly optionSpec?: Readonly<Record<string, ParseArgsOption>>;
+    readonly run: (ctx: CommandContext) => Promise<CommandResult>;
+}
+export interface GroupCommand {
+    readonly kind: 'group';
+    readonly name: string;
+    readonly description: string;
+    readonly subcommands: readonly Command[];
+}
+export type Command = LeafCommand | GroupCommand;
+export type ParseArgsOption = {
+    type: 'string';
+    multiple?: boolean;
+    short?: string;
+    default?: string;
+    /** What the flag does, in one sentence: `--help` and the docs show it. */
+    description?: string;
+    /**
+     * The value may be left out (`--push`, or `--push` before another
+     * flag): the option is then `''`. Given, it's the next token or
+     * `--push=<value>`.
+     */
+    optionalValue?: boolean;
+} | {
+    type: 'boolean';
+    multiple?: boolean;
+    short?: string;
+    default?: boolean;
+    /** What the flag does, in one sentence: `--help` and the docs show it. */
+    description?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAChE,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,SAAS,OAAO,EAAE,CAAC;CAC1C;AAED,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,YAAY,CAAC;AAEjD,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/dist/commands/types.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/commands/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC"}

package/dist/commands/unwired.d.ts

@@ -0,0 +1,22 @@
+import type { Command } from './types.js';
+/**
+ * Commands whose API this release doesn't wire yet: they call
+ * `throwUnwired` and fail with "not yet wired". They stay callable, so a
+ * script gets an honest error rather than "unknown command", but `--help`
+ * and the generated reference leave them out until they work.
+ *
+ * A path is the command words (`'agents list'`); a group's path hides the
+ * whole group. Wiring a command means removing it here (a test counts the
+ * `throwUnwired` call sites against this list).
+ */
+export declare const UNWIRED_COMMANDS: ReadonlySet<string>;
+/**
+ * Why a listed command isn't available, when the reason isn't simply "not
+ * wired yet": what the CLI prints instead of the generic message.
+ */
+export declare const UNWIRED_REASONS: ReadonlyMap<string, string>;
+/** Whether the command at `path` (its words, from the root) is wired. */
+export declare function isWired(path: readonly string[]): boolean;
+/** The commands under `parent` (its words) that are wired, in order. */
+export declare function wiredCommands(commands: readonly Command[], parent?: readonly string[]): readonly Command[];
+//# sourceMappingURL=unwired.d.ts.map

package/dist/commands/unwired.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unwired.d.ts","sourceRoot":"","sources":["../../src/commands/unwired.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAgB/C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAKtD,CAAC;AAEH,yEAAyE;AACzE,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAKxD;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,MAAM,GAAE,SAAS,MAAM,EAAO,GAC7B,SAAS,OAAO,EAAE,CAEpB"}

package/dist/commands/unwired.js

@@ -0,0 +1,52 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * Commands whose API this release doesn't wire yet: they call
+ * `throwUnwired` and fail with "not yet wired". They stay callable, so a
+ * script gets an honest error rather than "unknown command", but `--help`
+ * and the generated reference leave them out until they work.
+ *
+ * A path is the command words (`'agents list'`); a group's path hides the
+ * whole group. Wiring a command means removing it here (a test counts the
+ * `throwUnwired` call sites against this list).
+ */
+export const UNWIRED_COMMANDS = new Set([
+    'artifacts',
+    'capabilities',
+    'conversations',
+    'flows',
+    'memory',
+    'observations',
+    'proposals',
+    'provenance',
+    'tokens',
+    'agents list',
+    'agents get',
+    'agents unregister',
+    'agents versions',
+    'tools publish',
+    'runs resume',
+]);
+/**
+ * Why a listed command isn't available, when the reason isn't simply "not
+ * wired yet": what the CLI prints instead of the generic message.
+ */
+export const UNWIRED_REASONS = new Map([
+    [
+        'runs resume',
+        'resuming a run at a waitpoint is not available in this release: every waitpoint belongs to an approval or to the runtime. A run waiting for an approval continues when a reviewer decides it: `kindgi approvals complete <approval-id> --decision=approve`.',
+    ],
+]);
+/** Whether the command at `path` (its words, from the root) is wired. */
+export function isWired(path) {
+    for (let i = 1; i <= path.length; i += 1) {
+        if (UNWIRED_COMMANDS.has(path.slice(0, i).join(' ')))
+            return false;
+    }
+    return true;
+}
+/** The commands under `parent` (its words) that are wired, in order. */
+export function wiredCommands(commands, parent = []) {
+    return commands.filter((command) => isWired([...parent, command.name]));
+}
+//# sourceMappingURL=unwired.js.map

package/dist/commands/unwired.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unwired.js","sourceRoot":"","sources":["../../src/commands/unwired.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAIjC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IAC3D,WAAW;IACX,cAAc;IACd,eAAe;IACf,OAAO;IACP,QAAQ;IACR,cAAc;IACd,WAAW;IACX,YAAY;IACZ,QAAQ;IACR,aAAa;IACb,YAAY;IACZ,mBAAmB;IACnB,iBAAiB;IACjB,eAAe;IACf,aAAa;CACd,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgC,IAAI,GAAG,CAAC;IAClE;QACE,aAAa;QACb,6PAA6P;KAC9P;CACF,CAAC,CAAC;AAEH,yEAAyE;AACzE,MAAM,UAAU,OAAO,CAAC,IAAuB;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAC3B,QAA4B,EAC5B,SAA4B,EAAE;IAE9B,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/commands/version.d.ts

@@ -0,0 +1,8 @@
+import type { LeafCommand } from './types.js';
+/**
+ * Print CLI + SDK versions, plus (if the API is reachable) the server's
+ * OpenAPI info block. Never requires an auth token — `/v1/openapi.json`
+ * is public.
+ */
+export declare const versionCommand: LeafCommand;
+//# sourceMappingURL=version.d.ts.map

package/dist/commands/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAiB,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,WAiC5B,CAAC"}

package/dist/commands/version.js

@@ -0,0 +1,41 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { renderJson } from '../output.js';
+import { CLI_VERSION, SDK_VERSION } from '../version-info.js';
+/**
+ * Print CLI + SDK versions, plus (if the API is reachable) the server's
+ * OpenAPI info block. Never requires an auth token — `/v1/openapi.json`
+ * is public.
+ */
+export const versionCommand = {
+    kind: 'leaf',
+    name: 'version',
+    description: 'Print CLI + SDK versions (and API version if reachable).',
+    usage: 'kindgi version',
+    run: async (ctx) => {
+        const info = {
+            cli: CLI_VERSION,
+            sdk: SDK_VERSION,
+        };
+        if (ctx.config.apiUrl !== undefined) {
+            info.apiUrl = ctx.config.apiUrl;
+            try {
+                const url = `${ctx.config.apiUrl.replace(/\/+$/, '')}/v1/openapi.json`;
+                const res = await ctx.fetch(url, { method: 'GET' });
+                if (res.ok) {
+                    const body = (await res.json());
+                    if (body.info !== undefined)
+                        info.api = body.info;
+                }
+                else {
+                    info.apiUnreachable = `HTTP ${res.status}`;
+                }
+            }
+            catch (err) {
+                info.apiUnreachable = err.message;
+            }
+        }
+        return { kind: 'ok', rendered: renderJson(info, ctx.globals.format) };
+    },
+};
+//# sourceMappingURL=version.js.map

package/dist/commands/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,0DAA0D;IACvE,KAAK,EAAE,gBAAgB;IACvB,GAAG,EAAE,KAAK,EAAE,GAAG,EAA0B,EAAE;QACzC,MAAM,IAAI,GAMN;YACF,GAAG,EAAE,WAAW;YAChB,GAAG,EAAE,WAAW;SACjB,CAAC;QACF,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,kBAAkB,CAAC;gBACvE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;gBACpD,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;oBACX,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAoD,CAAC;oBACnF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;wBAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC;gBACpD,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,cAAc,GAAG,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;gBAC7C,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,cAAc,GAAI,GAAa,CAAC,OAAO,CAAC;YAC/C,CAAC;QACH,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;IACxE,CAAC;CACF,CAAC"}