@kindgi/cli 0.0.0-bootstrap.0 → 0.1.1

package/dist/help.js

@@ -0,0 +1,61 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { ROOT_COMMANDS } from './commands/index.js';
+import { wiredCommands } from './commands/unwired.js';
+import { GLOBAL_OPTION_SPEC } from './parse.js';
+export function rootHelpText() {
+    const lines = [];
+    lines.push('kindgi — command-line interface for Kindgi™ — the sovereign AI OS');
+    lines.push('');
+    lines.push('Usage: kindgi <command> [<subcommand>] [args] [flags]');
+    lines.push('');
+    lines.push('Commands:');
+    for (const c of wiredCommands(ROOT_COMMANDS)) {
+        lines.push(`  ${c.name.padEnd(16, ' ')}  ${c.description}`);
+    }
+    lines.push('');
+    lines.push('Global flags:');
+    lines.push(...flagLines(GLOBAL_OPTION_SPEC));
+    lines.push('');
+    lines.push('Config precedence: --flag > env var > .kindgirc.json (this directory) > ~/.kindgi/config.json.');
+    return `${lines.join('\n')}\n`;
+}
+/** `path`: the command's words from the root, so a group lists only its wired subcommands. */
+export function commandHelpText(command, path = [command.name]) {
+    const lines = [];
+    lines.push(command.description);
+    lines.push('');
+    if (command.kind === 'leaf') {
+        lines.push(`Usage: ${command.usage}`);
+        const flags = flagLines(command.optionSpec ?? {});
+        if (flags.length > 0) {
+            lines.push('');
+            lines.push('Flags:');
+            lines.push(...flags);
+        }
+        lines.push('');
+        lines.push('Global flags (--json, --url, --token, …): kindgi --help');
+    }
+    else {
+        lines.push(`Usage: kindgi ${command.name} <subcommand> [args] [flags]`);
+        lines.push('');
+        lines.push('Subcommands:');
+        for (const sub of wiredCommands(command.subcommands, path)) {
+            lines.push(`  ${sub.name.padEnd(16, ' ')}  ${sub.description}`);
+        }
+    }
+    return `${lines.join('\n')}\n`;
+}
+/** `  --name <value>, -n   What it does.`, one line per flag, by name. */
+function flagLines(spec) {
+    const rows = Object.entries(spec)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([name, option]) => {
+        const value = option.type === 'string' ? (option.optionalValue ? '[=<value>]' : ' <value>') : '';
+        const short = option.short ? `, -${option.short}` : '';
+        return [`--${name}${value}${short}`, option.description ?? ''];
+    });
+    const width = Math.max(0, ...rows.map(([label]) => label.length));
+    return rows.map(([label, description]) => `  ${label.padEnd(width)}  ${description}`.trimEnd());
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @kindgi/cli — the `kindgi` command-line interface.
+ *
+ * Projects add it as a devDependency and run `kindgi` through their
+ * package manager (`pnpm exec kindgi …`). The programmatic surface below
+ * is exposed for tests and for tools that embed CLI behavior without
+ * spawning a subprocess.
+ */
+export { runCli } from './main.js';
+export type { CliOutcome, RunCliInputs } from './main.js';
+export { describeCommands, describeGlobalFlags } from './reference.js';
+export type { CommandReference, FlagReference } from './reference.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACvE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * @kindgi/cli — the `kindgi` command-line interface.
+ *
+ * Projects add it as a devDependency and run `kindgi` through their
+ * package manager (`pnpm exec kindgi …`). The programmatic surface below
+ * is exposed for tests and for tools that embed CLI behavior without
+ * spawning a subprocess.
+ */
+export { runCli } from './main.js';
+export { describeCommands, describeGlobalFlags } from './reference.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/init/augment-scaffolder.d.ts

@@ -0,0 +1,86 @@
+import type { CommandResult } from '../commands/types.js';
+import { type PackageManager } from '../package-manager.js';
+import { type KindgiDependencySpecs } from './dependency-specs.js';
+export interface RunInitAugmentInputs {
+    readonly targetDir: string;
+    /**
+     * Optional root containing shipped skill folders (each with a
+     * `SKILL.md`). If undefined, no skills are copied. Production
+     * wiring passes `defaultSdkSkillsRoot()`; tests inject a fixture
+     * dir.
+     */
+    readonly skillsRoot?: string;
+    /** Override the derived pack id (e.g. when name normalization can't produce a valid PACK_ID). */
+    readonly packIdOverride?: string;
+    /**
+     * Overwrite existing `kindgi.config.ts` + shipped skill files under
+     * `.claude/skills/kindgi-<name>/SKILL.md`. Non-force default:
+     * refuse when `kindgi.config.ts` exists; merge (skip) any
+     * pre-existing skill files.
+     */
+    readonly force: boolean;
+    /** `--link-local`: link the Kindgi checkout even when the target is inside its workspace. */
+    readonly linkLocal?: boolean;
+    /**
+     * `--template`: `sample` adds the sample pack's primitives (tools, a
+     * guardrail, an agent, a flow) under `kindgi/`, read from
+     * `templatesRoot`. Default `minimal`: the config and empty folders.
+     */
+    readonly template?: 'minimal' | 'sample';
+    readonly templatesRoot?: string;
+    /** Test seams. */
+    readonly ioOverrides?: AugmentIOOverrides;
+    readonly packageManager?: PackageManager;
+    readonly dependencySpecs?: KindgiDependencySpecs;
+}
+export interface AugmentIOOverrides {
+    readonly readFile?: (path: string) => Promise<string>;
+    readonly writeFile?: (path: string, contents: string) => Promise<void>;
+    readonly mkdir?: (path: string) => Promise<void>;
+    readonly fileExists?: (path: string) => Promise<boolean>;
+    readonly listDir?: (path: string) => Promise<readonly string[]>;
+}
+/**
+ * Derive a `PACK_ID_REGEX`-valid id from a `package.json` name. Rules:
+ *   - `my-app` -> `my-app`
+ *   - `@acme/legal` -> `acme.legal`
+ *   - `@ACME/Legal` -> `acme.legal`  (lowercased)
+ *   - `my_app` -> error (underscores not allowed; explicit override required)
+ *   - `x` (single char, valid) -> `x`
+ */
+export declare function derivePackId(name: string): {
+    readonly kind: 'ok';
+    readonly id: string;
+} | {
+    readonly kind: 'err';
+    readonly message: string;
+};
+/**
+ * Render the augment-mode `kindgi.config.ts` file. Compact — no
+ * `environments` block (user fills that in when ready to deploy;
+ * `kindgi dev` doesn't need it).
+ */
+export declare function renderAugmentConfig(inputs: {
+    readonly packId: string;
+    readonly packVersion: string;
+    readonly packName: string;
+}): string;
+export declare function runInitAugment(inputs: RunInitAugmentInputs): Promise<CommandResult>;
+/**
+ * What to run next — in the project's own package manager, with its own
+ * `kindgi`. With the sample's `packId`, how to try its agent too.
+ */
+export declare function augmentNextSteps(pm: PackageManager, samplePackId?: string): readonly string[];
+/** Zod, at the fresh templates' range (their `package.json.tmpl`). */
+export declare const ZOD_DEPENDENCY: {
+    readonly name: "zod";
+    readonly spec: "^4.0.0";
+    readonly section: "dependencies";
+};
+/**
+ * The app's own Zod is kept; one whose range excludes zod 4 is reported,
+ * since Kindgi's schemas, examples and skills are zod 4. A spec that isn't
+ * a semver range (`catalog:`, `workspace:*`, a tag) is taken on trust.
+ */
+export declare function zodWarnings(pkg: Readonly<Record<string, unknown>>): readonly string[];
+//# sourceMappingURL=augment-scaffolder.d.ts.map

package/dist/init/augment-scaffolder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"augment-scaffolder.d.ts","sourceRoot":"","sources":["../../src/init/augment-scaffolder.ts"],"names":[],"mappings":"AAkDA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,EACL,KAAK,cAAc,EAIpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,KAAK,qBAAqB,EAAgC,MAAM,uBAAuB,CAAC;AAqBjG,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,iGAAiG;IACjG,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,6FAA6F;IAC7F,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,kBAAkB;IAClB,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,qBAAqB,CAAC;CAClD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;CACjE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,GAEV;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAkBrD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GAAG,MAAM,CA6BT;AAyCD,wBAAsB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAuHzF;AAwCD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAmB7F;AAKD,sEAAsE;AACtE,eAAO,MAAM,cAAc;;;;CAAoE,CAAC;AAShG;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,MAAM,EAAE,CAcrF"}