@kindgi/cli 0.0.0-bootstrap.0 → 0.1.1

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuBrB,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC;CAC1E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,eAAe,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAM,GAC9D,YAAY,CA0Dd;AAED,KAAK,eAAe,GAChB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,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,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/dist/parse.js

@@ -0,0 +1,100 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { parseArgs } from 'node:util';
+/**
+ * Global flags recognised on every command. Kept small on purpose —
+ * per-command flags are declared in each command's handler and merged
+ * on parse.
+ */
+export const GLOBAL_OPTION_SPEC = {
+    url: {
+        type: 'string',
+        description: "The Kindgi API's URL. Overrides `KINDGI_API_URL` and the config files.",
+    },
+    token: {
+        type: 'string',
+        description: 'The API token. Overrides `KINDGI_API_TOKEN` and the config files.',
+    },
+    verbose: {
+        type: 'boolean',
+        short: 'v',
+        description: 'Show more detail when a command fails.',
+    },
+    help: { type: 'boolean', short: 'h', description: 'Show help.' },
+    version: { type: 'boolean', description: "Print the CLI's version." },
+    json: { type: 'boolean', description: 'Output pretty-printed JSON (the default).' },
+    table: { type: 'boolean', description: 'Output a table, for commands that list.' },
+    raw: { type: 'boolean', description: 'Output compact, one-line JSON.' },
+    quiet: {
+        type: 'boolean',
+        description: 'Print nothing: the exit code alone reports the result.',
+    },
+};
+/**
+ * Parse a token vector against a merged option spec (globals + the
+ * command's own options). `parseArgs` is used with `allowPositionals:
+ * true` and `strict: true`; unknown flags fail loudly.
+ */
+export function parseCommand(tokens, extraOptionSpec = {}) {
+    const merged = { ...GLOBAL_OPTION_SPEC, ...extraOptionSpec };
+    // `parseArgs` has no optional values: a bare `--name` of such an option
+    // (last, or before another flag) becomes `--name=`.
+    const optional = new Set(Object.entries(merged)
+        .filter(([, spec]) => spec.type === 'string' && spec.optionalValue === true)
+        .map(([name]) => `--${name}`));
+    const args = tokens.map((token, i) => {
+        const next = tokens[i + 1];
+        return optional.has(token) && (next === undefined || next.startsWith('-'))
+            ? `${token}=`
+            : token;
+    });
+    // `parseArgs` takes only its own keys: drop the description and the
+    // optional-value marker.
+    const options = Object.fromEntries(Object.entries(merged).map(([name, spec]) => {
+        if (spec.type !== 'string') {
+            const { description: _description, ...rest } = spec;
+            return [name, rest];
+        }
+        const { optionalValue: _optional, description: _description, ...rest } = spec;
+        return [name, rest];
+    }));
+    const parsed = parseArgs({
+        args,
+        options,
+        allowPositionals: true,
+        strict: true,
+    });
+    const values = parsed.values;
+    const positionals = parsed.positionals ?? [];
+    const format = pickFormat(values.json === true, values.table === true, values.raw === true, values.quiet === true);
+    const globals = {
+        verbose: values.verbose === true,
+        help: values.help === true,
+        version: values.version === true,
+        format,
+        formatRequested: [values.json, values.table, values.raw, values.quiet].includes(true),
+        ...(typeof values.url === 'string' ? { url: values.url } : {}),
+        ...(typeof values.token === 'string' ? { token: values.token } : {}),
+    };
+    // Strip global keys from options so command handlers see only their own.
+    const own = {};
+    for (const [key, value] of Object.entries(values)) {
+        if (key in GLOBAL_OPTION_SPEC)
+            continue;
+        own[key] = value;
+    }
+    return { globals, positionals, options: own };
+}
+function pickFormat(json, table, raw, quiet) {
+    if (quiet)
+        return 'quiet';
+    if (raw)
+        return 'raw';
+    if (table)
+        return 'table';
+    // Default pretty JSON (also selected explicitly by --json).
+    if (json)
+        return 'json';
+    return 'json';
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

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

package/dist/providers/preset-loader.d.ts

@@ -0,0 +1,47 @@
+import type { RegisterProviderInput } from '@kindgi/client';
+export interface ProviderPreset {
+    /** Matches the JSON filename stem; `--preset=<name>`. */
+    readonly name: string;
+    /** One line for `kindgi providers presets`. */
+    readonly description: string;
+    readonly adapterId: string;
+    /** The secret holding the credential; absent when the adapter finds its own. */
+    readonly secret?: string;
+    /** Adapter settings the caller supplies, each as `--<key>=<value>`. */
+    readonly adapterConfig?: readonly PresetSetting[];
+    /** When the models' prices were last checked against the vendor's. */
+    readonly pricesCheckedAt: string;
+    readonly metadata: PresetMetadata;
+}
+export interface PresetSetting {
+    readonly key: string;
+    readonly description: string;
+}
+type PresetMetadata = RegisterProviderInput['metadata'];
+export declare function defaultProviderPresetsRoot(): string;
+export interface PresetIO {
+    readonly readdir: (path: string) => Promise<readonly string[]>;
+    readonly readFile: (path: string) => Promise<string>;
+}
+/** Every preset, by name. A malformed file fails the load, naming the file. */
+export declare function loadProviderPresets(dir?: string, io?: PresetIO): Promise<Readonly<Record<string, ProviderPreset>>>;
+export interface PresetChoices {
+    /** A subset of the preset's model names; all of them when absent. */
+    readonly models?: readonly string[];
+    /** Overrides the preset's secret name. */
+    readonly secret?: string;
+    /** The secret's environment (`local` in `kindgi dev`). */
+    readonly envName: string;
+    /** The values of the preset's `adapterConfig` settings, by key. */
+    readonly settings: Readonly<Record<string, string | undefined>>;
+}
+/** The registration body for a preset, or why the choices don't fit it. */
+export declare function presetRegistration(preset: ProviderPreset, choices: PresetChoices): {
+    readonly kind: 'ok';
+    readonly input: RegisterProviderInput;
+} | {
+    readonly kind: 'err';
+    readonly message: string;
+};
+export {};
+//# sourceMappingURL=preset-loader.d.ts.map

package/dist/providers/preset-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-loader.d.ts","sourceRoot":"","sources":["../../src/providers/preset-loader.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAClD,sEAAsE;IACtE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,KAAK,cAAc,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAIxD,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAC/D,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACtD;AAOD,+EAA+E;AAC/E,wBAAsB,mBAAmB,CACvC,GAAG,GAAE,MAAqC,EAC1C,EAAE,GAAE,QAAqB,GACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAmBnD;AAuCD,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;CACjE;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,aAAa,GAEpB;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAA;CAAE,GAC9D;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CA+BJ"}

package/dist/providers/preset-loader.js

@@ -0,0 +1,107 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * Provider presets — `kindgi providers register --preset=<name>`.
+ *
+ * A preset is a vendor's registration body with the models, context
+ * windows and prices filled in (`src/providers/presets/<name>.json`,
+ * copied to `dist/providers/presets/` at build): its adapter, the secret
+ * its credential lives in (if any), the adapter settings it needs from
+ * the caller (e.g. Gemini's `--project`), and `metadata`. Prices change
+ * with the vendors' — `pricesCheckedAt` says when they were last read.
+ */
+import { readFile as nodeReadFile, readdir as nodeReaddir } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+export function defaultProviderPresetsRoot() {
+    return join(__dirname, 'presets');
+}
+const DEFAULT_IO = {
+    readdir: async (path) => nodeReaddir(path),
+    readFile: async (path) => nodeReadFile(path, 'utf8'),
+};
+/** Every preset, by name. A malformed file fails the load, naming the file. */
+export async function loadProviderPresets(dir = defaultProviderPresetsRoot(), io = DEFAULT_IO) {
+    const files = (await io.readdir(dir)).filter((n) => n.endsWith('.json')).sort();
+    const presets = {};
+    for (const file of files) {
+        const problem = (message) => new Error(`provider preset ${file}: ${message}`);
+        let parsed;
+        try {
+            parsed = JSON.parse(await io.readFile(join(dir, file)));
+        }
+        catch (err) {
+            throw problem(`invalid JSON — ${err.message}`);
+        }
+        const preset = checkPreset(parsed);
+        if (typeof preset === 'string')
+            throw problem(preset);
+        if (preset.name !== file.replace(/\.json$/, '')) {
+            throw problem(`name "${preset.name}" does not match the file name`);
+        }
+        presets[preset.name] = preset;
+    }
+    return presets;
+}
+function checkPreset(input) {
+    if (input === null || typeof input !== 'object' || Array.isArray(input)) {
+        return 'must be a JSON object';
+    }
+    const p = input;
+    for (const key of ['name', 'description', 'adapterId', 'pricesCheckedAt']) {
+        if (typeof p[key] !== 'string' || p[key] === '')
+            return `"${key}" must be a non-empty string`;
+    }
+    if (p.secret !== undefined && (typeof p.secret !== 'string' || p.secret === '')) {
+        return '"secret" must be a non-empty string';
+    }
+    if (p.adapterConfig !== undefined &&
+        (!Array.isArray(p.adapterConfig) ||
+            !p.adapterConfig.every((s) => s !== null &&
+                typeof s === 'object' &&
+                typeof s.key === 'string' &&
+                typeof s.description === 'string'))) {
+        return '"adapterConfig" must be a list of { key, description }';
+    }
+    const metadata = p.metadata;
+    if (metadata === undefined ||
+        typeof metadata.id !== 'string' ||
+        !Array.isArray(metadata.models) ||
+        metadata.models.length === 0 ||
+        !metadata.models.every((m) => typeof m.name === 'string')) {
+        return '"metadata" must have an id and at least one named model';
+    }
+    return input;
+}
+/** The registration body for a preset, or why the choices don't fit it. */
+export function presetRegistration(preset, choices) {
+    const all = preset.metadata.models;
+    const unknown = (choices.models ?? []).filter((name) => !all.some((m) => m.name === name));
+    if (unknown.length > 0) {
+        return {
+            kind: 'err',
+            message: `preset "${preset.name}" has no model ${unknown.join(', ')} — it has ${all.map((m) => m.name).join(', ')}`,
+        };
+    }
+    const models = choices.models === undefined ? all : all.filter((m) => choices.models?.includes(m.name));
+    const missing = (preset.adapterConfig ?? []).filter((s) => choices.settings[s.key] === undefined);
+    if (missing.length > 0) {
+        return {
+            kind: 'err',
+            message: `preset "${preset.name}" needs ${missing.map((s) => `--${s.key}=<…> (${s.description})`).join(', ')}`,
+        };
+    }
+    const secret = choices.secret ?? preset.secret;
+    const adapterConfig = Object.fromEntries((preset.adapterConfig ?? []).map((s) => [s.key, choices.settings[s.key]]));
+    return {
+        kind: 'ok',
+        input: {
+            metadata: { ...preset.metadata, models },
+            adapter_id: preset.adapterId,
+            ...(secret !== undefined && { secret_ref: { envName: choices.envName, name: secret } }),
+            ...(Object.keys(adapterConfig).length > 0 && { adapter_config: adapterConfig }),
+        },
+    };
+}
+//# sourceMappingURL=preset-loader.js.map

package/dist/providers/preset-loader.js.map

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

package/dist/providers/presets/anthropic.json

@@ -0,0 +1,47 @@
+{
+  "name": "anthropic",
+  "description": "Claude on the Anthropic API (key: ANTHROPIC_API_KEY).",
+  "adapterId": "@kindgi/adapter-model-anthropic",
+  "secret": "ANTHROPIC_API_KEY",
+  "pricesCheckedAt": "2026-10-01",
+  "metadata": {
+    "id": "anthropic",
+    "region": "unspecified",
+    "description": "Claude on the Anthropic API",
+    "models": [
+      {
+        "name": "claude-opus-5-5",
+        "contextWindow": 1000000,
+        "maxOutputTokens": 16000,
+        "features": ["tool-use", "parallel-tool-use", "structured-output", "long-context"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.004,
+          "completionUsdPer1kTokens": 0.02
+        },
+        "description": "Most capable Opus \u2014 long-running agentic and knowledge work."
+      },
+      {
+        "name": "claude-sonnet-5-5",
+        "contextWindow": 1000000,
+        "maxOutputTokens": 16000,
+        "features": ["tool-use", "parallel-tool-use", "structured-output", "long-context"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.002,
+          "completionUsdPer1kTokens": 0.01
+        },
+        "description": "Balanced performance and cost."
+      },
+      {
+        "name": "claude-haiku-4-5",
+        "contextWindow": 200000,
+        "maxOutputTokens": 8192,
+        "features": ["tool-use", "parallel-tool-use"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.001,
+          "completionUsdPer1kTokens": 0.005
+        },
+        "description": "Fastest and cheapest \u2014 routing, classification, simple calls."
+      }
+    ]
+  }
+}

package/dist/providers/presets/gemini.json

@@ -0,0 +1,40 @@
+{
+  "name": "gemini",
+  "description": "Gemini on Vertex AI (Google Application Default Credentials; --project=<gcp-project>).",
+  "adapterId": "@kindgi/adapter-model-gemini",
+  "adapterConfig": [
+    {
+      "key": "project",
+      "description": "The Google Cloud project Vertex AI bills and authorises against."
+    }
+  ],
+  "pricesCheckedAt": "2026-10-01",
+  "metadata": {
+    "id": "gemini",
+    "region": "global",
+    "description": "Gemini on Vertex AI",
+    "models": [
+      {
+        "name": "gemini-2.5-pro",
+        "contextWindow": 1048576,
+        "maxOutputTokens": 8192,
+        "features": ["tool-use"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.00125,
+          "completionUsdPer1kTokens": 0.01,
+          "longContext": {
+            "thresholdTokens": 200000,
+            "promptUsdPer1kTokens": 0.0025,
+            "completionUsdPer1kTokens": 0.015
+          }
+        }
+      },
+      {
+        "name": "gemini-2.5-flash",
+        "contextWindow": 1048576,
+        "features": ["tool-use"],
+        "cost": { "promptUsdPer1kTokens": 0.0003, "completionUsdPer1kTokens": 0.0025 }
+      }
+    ]
+  }
+}

package/dist/reference.d.ts

@@ -0,0 +1,28 @@
+/** One flag: `--name` (and `-short`), taking a string or a boolean. */
+export interface FlagReference {
+    readonly name: string;
+    readonly type: 'string' | 'boolean';
+    readonly short?: string;
+    /** The flag may be repeated. */
+    readonly multiple?: boolean;
+    readonly default?: string | boolean;
+    /** What the flag does, in one sentence. */
+    readonly description?: string;
+}
+/** One command; a group of commands has subcommands and no usage. */
+export interface CommandReference {
+    readonly name: string;
+    /** The words after `kindgi`, e.g. `['secrets', 'set']`. */
+    readonly path: readonly string[];
+    readonly description: string;
+    /** The usage line (leaf commands only). */
+    readonly usage?: string;
+    /** The command's own flags, by name (leaf commands only). */
+    readonly flags: readonly FlagReference[];
+    readonly subcommands: readonly CommandReference[];
+}
+/** Every top-level command, in the order `kindgi --help` lists them. */
+export declare function describeCommands(): readonly CommandReference[];
+/** The flags every command takes (`--url`, `--token`, `--json`, …), by name. */
+export declare function describeGlobalFlags(): readonly FlagReference[];
+//# sourceMappingURL=reference.d.ts.map

package/dist/reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAeA,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACnD;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,IAAI,SAAS,gBAAgB,EAAE,CAE9D;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,IAAI,SAAS,aAAa,EAAE,CAE9D"}

package/dist/reference.js

@@ -0,0 +1,52 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * The CLI described as data: every command with its usage, its flags and
+ * its subcommands, and the global flags. No handlers. The CLI reference
+ * on docs.kindgi.com is generated from it, so it can't drift from the
+ * commands.
+ */
+import { ROOT_COMMANDS } from './commands/index.js';
+import { wiredCommands } from './commands/unwired.js';
+import { GLOBAL_OPTION_SPEC } from './parse.js';
+/** Every top-level command, in the order `kindgi --help` lists them. */
+export function describeCommands() {
+    return wiredCommands(ROOT_COMMANDS).map((command) => describe(command, []));
+}
+/** The flags every command takes (`--url`, `--token`, `--json`, …), by name. */
+export function describeGlobalFlags() {
+    return flags(GLOBAL_OPTION_SPEC);
+}
+function describe(command, parent) {
+    const path = [...parent, command.name];
+    if (command.kind === 'group') {
+        return {
+            name: command.name,
+            path,
+            description: command.description,
+            flags: [],
+            subcommands: wiredCommands(command.subcommands, path).map((sub) => describe(sub, path)),
+        };
+    }
+    return {
+        name: command.name,
+        path,
+        description: command.description,
+        usage: command.usage,
+        flags: flags(command.optionSpec ?? {}),
+        subcommands: [],
+    };
+}
+function flags(spec) {
+    return Object.entries(spec)
+        .map(([name, option]) => ({
+        name,
+        type: option.type,
+        ...(option.short !== undefined && { short: option.short }),
+        ...(option.multiple !== undefined && { multiple: option.multiple }),
+        ...(option.default !== undefined && { default: option.default }),
+        ...(option.description !== undefined && { description: option.description }),
+    }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=reference.js.map

package/dist/reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference.js","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AA2BhD,wEAAwE;AACxE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,aAAa,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,mBAAmB;IACjC,OAAO,KAAK,CAAC,kBAAkB,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,QAAQ,CAAC,OAAgB,EAAE,MAAyB;IAC3D,MAAM,IAAI,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI;YACJ,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,KAAK,EAAE,EAAE;YACT,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;SACxF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI;QACJ,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;QACtC,WAAW,EAAE,EAAE;KAChB,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,IAA+C;IAC5D,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACxB,IAAI;QACJ,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1D,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QACnE,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QAChE,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;KAC7E,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/sdk-package.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Root directory of the `@kindgi/sdk` package the CLI depends on,
+ * resolved by package name from the CLI's own location. Correct whether
+ * the SDK is a workspace sibling, lives in a separate checkout linked into
+ * the workspace, or is installed under `node_modules` — no repo-layout
+ * assumption. `undefined` when it can't be resolved (broken install).
+ */
+export declare function resolveSdkPackageRoot(): string | undefined;
+//# sourceMappingURL=sdk-package.d.ts.map

package/dist/sdk-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-package.d.ts","sourceRoot":"","sources":["../src/sdk-package.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAM1D"}

package/dist/sdk-package.js

@@ -0,0 +1,20 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { createRequire } from 'node:module';
+import { dirname } from 'node:path';
+/**
+ * Root directory of the `@kindgi/sdk` package the CLI depends on,
+ * resolved by package name from the CLI's own location. Correct whether
+ * the SDK is a workspace sibling, lives in a separate checkout linked into
+ * the workspace, or is installed under `node_modules` — no repo-layout
+ * assumption. `undefined` when it can't be resolved (broken install).
+ */
+export function resolveSdkPackageRoot() {
+    try {
+        return dirname(createRequire(import.meta.url).resolve('@kindgi/sdk/package.json'));
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=sdk-package.js.map

package/dist/sdk-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-package.js","sourceRoot":"","sources":["../src/sdk-package.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}