@kindgi/cli 0.0.0-bootstrap.0 → 0.1.1

package/dist/init/dependency-specs.js

@@ -0,0 +1,153 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * The version specs `kindgi init` writes for `@kindgi/sdk` (dependency)
+ * and `@kindgi/cli` (devDependency) — one answer for both init modes.
+ * The CLI is project-local: a project runs the `kindgi` it pins, never a
+ * global one.
+ *
+ * Three cases, decided by where the running CLI lives:
+ *
+ *   - **published** — the CLI sits under `node_modules`. `@kindgi/cli`
+ *     pins the running CLI's version; `@kindgi/sdk` uses the spec the
+ *     published CLI itself depends on (pnpm rewrites `workspace:*` at
+ *     publish time).
+ *   - **workspace** — a source checkout, and the target is inside the
+ *     same pnpm workspace (`packs/foo`): `workspace:*` for both.
+ *   - **local-checkout** — a source checkout, target elsewhere (an
+ *     existing app, a pilot repo) or `--link-local`: symlink both
+ *     packages from the checkout (`link:`, or `file:` for npm).
+ *
+ * Never `latest` — an unpinned spec resolves to whatever the registry
+ * serves that day, and before publishing it resolves to nothing.
+ */
+import { realpath as fsRealpath, stat } from 'node:fs/promises';
+import { dirname, join, relative, sep } from 'node:path';
+import { resolveCliPackage } from '../cli-package.js';
+import { localLinkProtocol } from '../package-manager.js';
+import { resolveSdkPackageRoot } from '../sdk-package.js';
+export async function resolveKindgiDependencySpecs(input) {
+    const realpath = input.realpath ?? fsRealpath;
+    const exists = input.exists ?? pathExists;
+    const cli = input.cli ?? resolveCliPackage();
+    if (cli === undefined) {
+        return {
+            kind: 'error',
+            message: 'Cannot locate the @kindgi/cli package.json — broken install.',
+        };
+    }
+    const cliRoot = await realpath(cli.root);
+    if (cliRoot.split(sep).includes('node_modules'))
+        return publishedSpecs(cli);
+    const sdkRootRaw = input.sdkRoot ?? resolveSdkPackageRoot();
+    if (sdkRootRaw === undefined) {
+        return {
+            kind: 'error',
+            message: 'Cannot resolve @kindgi/sdk from the CLI checkout — run the checkout install first.',
+        };
+    }
+    const sdkRoot = await realpath(sdkRootRaw);
+    if (input.forceLocal !== true) {
+        const workspace = await findPnpmWorkspaceRoot(cliRoot, exists);
+        const target = await realpath(input.targetDir);
+        if (workspace !== undefined && isInside(target, workspace)) {
+            return { kind: 'ok', specs: { source: 'workspace', sdk: 'workspace:*', cli: 'workspace:*' } };
+        }
+    }
+    const protocol = localLinkProtocol(input.packageManager);
+    return {
+        kind: 'ok',
+        specs: { source: 'local-checkout', sdk: `${protocol}${sdkRoot}`, cli: `${protocol}${cliRoot}` },
+    };
+}
+function publishedSpecs(cli) {
+    const sdk = cli.sdkDependency;
+    if (sdk === undefined || sdk.startsWith('workspace:')) {
+        return {
+            kind: 'error',
+            message: `This @kindgi/cli (${cli.version}) lists @kindgi/sdk as "${sdk ?? '(missing)'}", not a published version — publisher misconfiguration.`,
+        };
+    }
+    return { kind: 'ok', specs: { source: 'published', sdk, cli: cli.version } };
+}
+async function findPnpmWorkspaceRoot(from, exists) {
+    let dir = from;
+    for (;;) {
+        if (await exists(join(dir, 'pnpm-workspace.yaml')))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+function isInside(path, root) {
+    const rel = relative(root, path);
+    return rel !== '' && !rel.startsWith('..') && !rel.startsWith(sep);
+}
+async function pathExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The `kindgi` requirement a published CLI writes: the Python SDK within the
+ * CLI's minor (`0.x`) or major (from `1.0`). The Python SDK's minors follow
+ * the npm packages'; its patches needn't, so a CLI patch release with no
+ * Python release still resolves.
+ */
+export function kindgiRequirement(cliVersion) {
+    const match = /^(\d+)\.(\d+)\.\d+/.exec(cliVersion);
+    if (match === null)
+        return undefined;
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    return major === 0
+        ? `kindgi>=0.${minor},<0.${minor + 1}`
+        : `kindgi>=${major}.${minor},<${major + 1}`;
+}
+/** The requirement to write for `source`: the published range, or the bare name a uv source pins. */
+export function kindgiRequirementFor(source) {
+    return source.kind === 'published' ? source.requirement : 'kindgi';
+}
+export async function resolveKindgiPythonSource(input = {}) {
+    const realpath = input.realpath ?? fsRealpath;
+    const exists = input.exists ?? pathExists;
+    const cli = input.cli ?? resolveCliPackage();
+    if (cli === undefined) {
+        return {
+            kind: 'error',
+            message: 'Cannot locate the @kindgi/cli package.json — broken install.',
+        };
+    }
+    if ((await realpath(cli.root)).split(sep).includes('node_modules')) {
+        const requirement = kindgiRequirement(cli.version);
+        if (requirement === undefined) {
+            return {
+                kind: 'error',
+                message: `This @kindgi/cli's version (${cli.version}) isn't major.minor.patch — broken install.`,
+            };
+        }
+        return { kind: 'published', requirement };
+    }
+    const sdkRootRaw = input.sdkRoot ?? resolveSdkPackageRoot();
+    if (sdkRootRaw === undefined) {
+        return {
+            kind: 'error',
+            message: 'Cannot resolve @kindgi/sdk from the CLI checkout — run the checkout install first.',
+        };
+    }
+    const python = join(await realpath(sdkRootRaw), '..', '..', 'sdks', 'python');
+    if (!(await exists(join(python, 'pyproject.toml')))) {
+        return {
+            kind: 'error',
+            message: `No Python SDK at ${python} — the Kindgi checkout is incomplete.`,
+        };
+    }
+    return { kind: 'local-checkout', path: python };
+}
+//# sourceMappingURL=dependency-specs.js.map

package/dist/init/dependency-specs.js.map

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

package/dist/init/gitignore-patcher.d.ts

@@ -0,0 +1,23 @@
+export interface PatchResult {
+    /** `absent` — the file doesn't exist and was not created (formatter ignores). */
+    readonly kind: 'patched' | 'already-present' | 'absent' | 'error';
+    readonly appended: readonly string[];
+    readonly message?: string;
+}
+/**
+ * Read the file (or treat as empty if missing), append any of our
+ * patterns that aren't already an exact-match line, write back.
+ * Returns which lines were appended (empty when already complete).
+ */
+export declare function patchGitignore(gitignorePath: string): Promise<PatchResult>;
+/**
+ * Add the Kindgi-managed skills to an existing `.prettierignore`. A
+ * project without one is left alone — Kindgi doesn't introduce a
+ * formatter config the app never had.
+ */
+export declare function patchPrettierignore(path: string): Promise<PatchResult>;
+/** Append whichever of `patterns` are missing (exact-line match) under the Kindgi marker. */
+export declare function patchIgnoreFile(gitignorePath: string, patterns: readonly string[], options: {
+    readonly createIfMissing: boolean;
+}): Promise<PatchResult>;
+//# sourceMappingURL=gitignore-patcher.d.ts.map

package/dist/init/gitignore-patcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore-patcher.d.ts","sourceRoot":"","sources":["../../src/init/gitignore-patcher.ts"],"names":[],"mappings":"AA0CA,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,iBAAiB,GAAG,QAAQ,GAAG,OAAO,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAE1E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAEtE;AAED,6FAA6F;AAC7F,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE;IAAE,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAAE,GAC7C,OAAO,CAAC,WAAW,CAAC,CAwCtB"}

package/dist/init/gitignore-patcher.js

@@ -0,0 +1,103 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * `.gitignore` patcher for augment mode. Appends Kindgi's local-state
+ * ignore patterns if absent (the fresh templates' `.gitignore` carries
+ * the same three):
+ *
+ *   - `.env.local` — where `kindgi secrets set` writes plaintext
+ *     secret values in dev mode
+ *   - `.kindgi/` — build artifacts, the dev index, dev-server state
+ *   - `.kindgirc.json` — the dev server's API URL + bearer token,
+ *     written by `kindgi dev` for second-terminal commands
+ *
+ * Idempotency: line-scan for exact matches only. Broader user
+ * patterns (`.env*`, `*.local`) that already cover our lines get
+ * appended-alongside — Git handles duplicate patterns fine, and this
+ * keeps our detection dumb + predictable.
+ *
+ * Marker comment groups the additions so they're visible in a diff:
+ *
+ *   # Kindgi
+ *   .env.local
+ *   .kindgi/
+ *   .kindgirc.json
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+const KINDGI_MARKER = '# Kindgi';
+const KINDGI_PATTERNS = ['.env.local', '.kindgi/', '.kindgirc.json'];
+/**
+ * Kindgi-managed files a host formatter must leave alone: `kindgi skills
+ * sync` owns their bytes, and a reformatted skill reads as a local edit
+ * that blocks every later update. Everything else Kindgi writes
+ * (`kindgi.config.*`, `kindgi/**`) is the author's code and is formatted
+ * like the rest of the app; `.kindgi/` is already out via `.gitignore`,
+ * which Prettier 3 honours.
+ */
+const FORMATTER_IGNORE_PATTERNS = ['.claude/skills/kindgi-*/'];
+/**
+ * Read the file (or treat as empty if missing), append any of our
+ * patterns that aren't already an exact-match line, write back.
+ * Returns which lines were appended (empty when already complete).
+ */
+export function patchGitignore(gitignorePath) {
+    return patchIgnoreFile(gitignorePath, KINDGI_PATTERNS, { createIfMissing: true });
+}
+/**
+ * Add the Kindgi-managed skills to an existing `.prettierignore`. A
+ * project without one is left alone — Kindgi doesn't introduce a
+ * formatter config the app never had.
+ */
+export function patchPrettierignore(path) {
+    return patchIgnoreFile(path, FORMATTER_IGNORE_PATTERNS, { createIfMissing: false });
+}
+/** Append whichever of `patterns` are missing (exact-line match) under the Kindgi marker. */
+export async function patchIgnoreFile(gitignorePath, patterns, options) {
+    const read = await readIgnoreFile(gitignorePath);
+    if (read.kind === 'error')
+        return { kind: 'error', appended: [], message: read.message };
+    if (read.kind === 'absent' && !options.createIfMissing)
+        return { kind: 'absent', appended: [] };
+    const raw = read.kind === 'ok' ? read.raw : '';
+    const existed = read.kind === 'ok';
+    const existingLines = new Set(raw
+        .split('\n')
+        .map((l) => l.trim())
+        .filter((l) => l !== ''));
+    const toAppend = [];
+    for (const pattern of patterns) {
+        if (!existingLines.has(pattern))
+            toAppend.push(pattern);
+    }
+    if (toAppend.length === 0) {
+        return { kind: 'already-present', appended: [] };
+    }
+    // Preserve prior content verbatim; append our block with a marker.
+    // Ensure the prior content ends with a newline so our block starts
+    // on its own line.
+    const prefix = existed ? (raw.endsWith('\n') || raw === '' ? raw : `${raw}\n`) : '';
+    const separator = prefix === '' || prefix.endsWith('\n\n') ? '' : '\n';
+    const block = `${separator}${KINDGI_MARKER}\n${toAppend.join('\n')}\n`;
+    try {
+        await writeFile(gitignorePath, `${prefix}${block}`, 'utf8');
+    }
+    catch (err) {
+        return {
+            kind: 'error',
+            appended: [],
+            message: `Failed to write ${gitignorePath}: ${err.message}`,
+        };
+    }
+    return { kind: 'patched', appended: toAppend };
+}
+async function readIgnoreFile(path) {
+    try {
+        return { kind: 'ok', raw: await readFile(path, 'utf8') };
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return { kind: 'absent' };
+        return { kind: 'error', message: `Failed to read ${path}: ${err.message}` };
+    }
+}
+//# sourceMappingURL=gitignore-patcher.js.map

package/dist/init/gitignore-patcher.js.map

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

package/dist/init/mode-detect.d.ts

@@ -0,0 +1,34 @@
+export type InitMode = 'fresh' | 'augment';
+export interface DetectInputs {
+    readonly cwd: string;
+    readonly positionals: readonly string[];
+    /** `--path=<dir>` — target directory. Absolute or cwd-relative. */
+    readonly pathFlag?: string;
+    /**
+     * `--new-repo` — force fresh mode even when a `package.json` sits
+     * at the target dir. Rare but real: someone in a monorepo wants to
+     * scaffold a standalone pack in a nested subdir.
+     */
+    readonly newRepoFlag: boolean;
+    /** `--template=<name>` — `python` picks the Python app when both project files exist. */
+    readonly templateFlag?: string;
+    /** Test injection point. */
+    readonly fileExists?: (path: string) => Promise<boolean>;
+}
+export type DetectResult = {
+    readonly kind: 'ok';
+    readonly mode: 'fresh';
+    readonly targetDir: string;
+    readonly packName: string;
+} | {
+    readonly kind: 'ok';
+    readonly mode: 'augment';
+    readonly targetDir: string;
+    /** The app's language — the pack's. */
+    readonly language: 'node' | 'python';
+} | {
+    readonly kind: 'err';
+    readonly message: string;
+};
+export declare function detectInitMode(inputs: DetectInputs): Promise<DetectResult>;
+//# sourceMappingURL=mode-detect.d.ts.map

package/dist/init/mode-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-detect.d.ts","sourceRoot":"","sources":["../../src/init/mode-detect.ts"],"names":[],"mappings":"AAqCA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,yFAAyF;IACzF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,4BAA4B;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAED,MAAM,MAAM,YAAY,GACpB;IACE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;CACtC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAYN,wBAAsB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CA+DhF"}

package/dist/init/mode-detect.js

@@ -0,0 +1,115 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * `kindgi init` mode-detection — routes between two flows:
+ *
+ *   - **fresh** — creates a new pack in a subdirectory, scaffolds the
+ *     full template (`package.json`, `tsconfig.json`,
+ *     `pnpm-workspace.yaml`, `agents/`, `tools/`, etc.). The
+ *     historical `kindgi init <pack-name>` shape.
+ *   - **augment** — adds Kindgi files alongside an existing project: a
+ *     Node.js app (`kindgi.config.ts`, `kindgi/**`, `.claude/skills/`, the
+ *     existing `package.json` patched — "add Kindgi to my Next.js app")
+ *     or a Python app (`[tool.kindgi]` appended to its `pyproject.toml`,
+ *     `kindgi/**`, the Python-pack skills).
+ *
+ * Detection rules (in evaluation order):
+ *
+ *   1. `--new-repo` explicit: fresh mode (positional pack-name still
+ *      required). Escape hatch for "I'm in a repo but want a nested
+ *      standalone pack anyway."
+ *   2. Positional pack-name present: fresh mode. Intent signal wins.
+ *   3. No positional AND `package.json` at target dir: augment mode, a
+ *      TypeScript pack — unless `--template=python` and a
+ *      `pyproject.toml` is there too (an app with both).
+ *   4. No positional AND a `pyproject.toml` (no `package.json`): augment
+ *      mode, a Python pack.
+ *   5. Neither: error — caller either wants fresh (needs pack-name) or
+ *      augment (needs a package.json or pyproject.toml in scope).
+ *
+ * The result carries the resolved `targetDir` so callers don't
+ * re-resolve `--path` themselves; consistent path handling in one
+ * place.
+ */
+import { isAbsolute, resolve } from 'node:path';
+const defaultFileExists = async (path) => {
+    const { stat } = await import('node:fs/promises');
+    try {
+        const s = await stat(path);
+        return s.isFile();
+    }
+    catch {
+        return false;
+    }
+};
+export async function detectInitMode(inputs) {
+    const fileExists = inputs.fileExists ?? defaultFileExists;
+    const packName = inputs.positionals[0] ?? '';
+    // Resolve targetDir:
+    //   - fresh mode: --path defaults to `<cwd>/<packName>` (or `<cwd>/<lastDot>` for dot-namespaced ids)
+    //   - augment mode: --path defaults to `<cwd>`
+    // For DETECTION we only care about the dir we'll look for `package.json` in.
+    // In fresh mode with a positional pack-name we look at the PARENT (cwd) not the target subdir.
+    // In augment mode we look at the resolved `--path` or cwd.
+    // Case 1: --new-repo forces fresh. Positional required.
+    if (inputs.newRepoFlag) {
+        if (packName === '') {
+            return {
+                kind: 'err',
+                message: '--new-repo requires a pack-name.\n' +
+                    'Usage: kindgi init <pack-name> --new-repo [--path=<dir>]\n',
+            };
+        }
+        return {
+            kind: 'ok',
+            mode: 'fresh',
+            targetDir: resolveFreshTargetDir(inputs.cwd, inputs.pathFlag, packName),
+            packName,
+        };
+    }
+    // Case 2: positional pack-name present. Fresh mode (intent signal).
+    if (packName !== '') {
+        return {
+            kind: 'ok',
+            mode: 'fresh',
+            targetDir: resolveFreshTargetDir(inputs.cwd, inputs.pathFlag, packName),
+            packName,
+        };
+    }
+    // No positional — detect based on package.json presence.
+    const augmentTargetDir = inputs.pathFlag !== undefined && inputs.pathFlag !== ''
+        ? isAbsolute(inputs.pathFlag)
+            ? inputs.pathFlag
+            : resolve(inputs.cwd, inputs.pathFlag)
+        : inputs.cwd;
+    const hasPackageJson = await fileExists(`${augmentTargetDir}/package.json`);
+    const hasPyproject = await fileExists(`${augmentTargetDir}/pyproject.toml`);
+    // Cases 3 and 4: no positional + a project file → augment, in its language.
+    if (hasPyproject && (!hasPackageJson || inputs.templateFlag === 'python')) {
+        return { kind: 'ok', mode: 'augment', targetDir: augmentTargetDir, language: 'python' };
+    }
+    if (hasPackageJson) {
+        return { kind: 'ok', mode: 'augment', targetDir: augmentTargetDir, language: 'node' };
+    }
+    // Case 5: no positional + neither → error.
+    return {
+        kind: 'err',
+        message: `No pack-name provided and no package.json or pyproject.toml at ${augmentTargetDir}.\n  - To scaffold a new pack:      kindgi init <pack-name> [--template=python]\n  - To add Kindgi to existing:   run inside a directory with package.json (Node) or pyproject.toml (Python)\n`,
+    };
+}
+/**
+ * Fresh-mode target dir resolution — matches the historical behavior
+ * of `resolveArgs` in `init.ts`. If `--path` is set, use it verbatim
+ * (absolute or cwd-relative). Otherwise default to `<cwd>/<dirName>`
+ * where dirName strips the namespace prefix of dot-namespaced ids
+ * (`acme.legal-basics` → `legal-basics`).
+ */
+function resolveFreshTargetDir(cwd, pathFlag, packName) {
+    if (pathFlag !== undefined && pathFlag !== '') {
+        return isAbsolute(pathFlag) ? pathFlag : resolve(cwd, pathFlag);
+    }
+    const dotIdx = packName.lastIndexOf('.');
+    const dirName = dotIdx === -1 ? packName : packName.slice(dotIdx + 1);
+    return resolve(cwd, dirName);
+}
+//# sourceMappingURL=mode-detect.js.map

package/dist/init/mode-detect.js.map

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

package/dist/init/package-json-patcher.d.ts

@@ -0,0 +1,36 @@
+import type { KindgiDependencySpecs } from './dependency-specs.js';
+export declare const KINDGI_SDK_PKG = "@kindgi/sdk";
+export declare const KINDGI_CLI_PKG = "@kindgi/cli";
+/** A package `patchPackageJson` adds when no dependency section declares it. */
+export interface WantedDependency {
+    readonly name: string;
+    readonly spec: string;
+    readonly section: 'dependencies' | 'devDependencies';
+}
+export type PatchResult = {
+    readonly kind: 'patched';
+    readonly added: readonly string[];
+} | {
+    readonly kind: 'already-present';
+} | {
+    readonly kind: 'error';
+    readonly message: string;
+};
+/**
+ * Read `package.json`, add whichever of `@kindgi/sdk` / `@kindgi/cli`
+ * (and `extra`) is missing, write it back preserving format. Never
+ * touches the file when all are already declared.
+ */
+export declare function patchPackageJson(pkgJsonPath: string, specs: Pick<KindgiDependencySpecs, 'sdk' | 'cli'>, extra?: readonly WantedDependency[]): Promise<PatchResult>;
+/**
+ * Detect the indent width used in a JSON file. Reads until the first
+ * indented line (a line starting with whitespace), counts the run.
+ * Falls back to 2 spaces if nothing looks indented (single-line JSON).
+ */
+export declare function detectIndent(raw: string): number;
+/**
+ * True iff the dep appears in `dependencies`, `devDependencies`,
+ * `peerDependencies`, or `optionalDependencies` sections.
+ */
+export declare function isDepPresent(pkg: Record<string, unknown>, name: string): boolean;
+//# sourceMappingURL=package-json-patcher.d.ts.map

package/dist/init/package-json-patcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-json-patcher.d.ts","sourceRoot":"","sources":["../../src/init/package-json-patcher.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAC5C,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAE5C,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,iBAAiB,CAAC;CACtD;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACpC;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,KAAK,GAAG,KAAK,CAAC,EACjD,KAAK,GAAE,SAAS,gBAAgB,EAAO,GACtC,OAAO,CAAC,WAAW,CAAC,CA8CtB;AAMD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAehD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAYhF"}

package/dist/init/package-json-patcher.js

@@ -0,0 +1,128 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * `package.json` patcher for augment mode. Makes Kindgi a project
+ * dependency — `@kindgi/sdk` in `dependencies`, `@kindgi/cli` in
+ * `devDependencies`, so the project runs its own pinned `kindgi` —
+ * while preserving the rest of the file:
+ *
+ *   - Indent (2-space or 4-space, auto-detected from the first
+ *     indented key)
+ *   - Trailing-newline convention (preserved verbatim)
+ *   - Field order (unrelated fields never reordered)
+ *
+ * Idempotency: a package already declared in ANY dependency section
+ * is left exactly where it is (the user's placement and spec win).
+ *
+ * Specs come from `resolveKindgiDependencySpecs` (`dependency-specs.ts`)
+ * — the same answer fresh mode uses. Never `latest`.
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+export const KINDGI_SDK_PKG = '@kindgi/sdk';
+export const KINDGI_CLI_PKG = '@kindgi/cli';
+/**
+ * Read `package.json`, add whichever of `@kindgi/sdk` / `@kindgi/cli`
+ * (and `extra`) is missing, write it back preserving format. Never
+ * touches the file when all are already declared.
+ */
+export async function patchPackageJson(pkgJsonPath, specs, extra = []) {
+    let raw;
+    try {
+        raw = await readFile(pkgJsonPath, 'utf8');
+    }
+    catch (err) {
+        return { kind: 'error', message: `Failed to read ${pkgJsonPath}: ${err.message}` };
+    }
+    let parsed;
+    try {
+        const p = JSON.parse(raw);
+        if (p === null || typeof p !== 'object' || Array.isArray(p)) {
+            return { kind: 'error', message: `${pkgJsonPath} is not a JSON object.` };
+        }
+        parsed = p;
+    }
+    catch (err) {
+        return {
+            kind: 'error',
+            message: `${pkgJsonPath} is not valid JSON: ${err.message}`,
+        };
+    }
+    const wanted = [
+        { name: KINDGI_SDK_PKG, spec: specs.sdk, section: 'dependencies' },
+        { name: KINDGI_CLI_PKG, spec: specs.cli, section: 'devDependencies' },
+        ...extra,
+    ];
+    const missing = wanted.filter((w) => !isDepPresent(parsed, w.name));
+    if (missing.length === 0)
+        return { kind: 'already-present' };
+    const next = { ...parsed };
+    for (const w of missing) {
+        const bucket = isRecord(next[w.section])
+            ? { ...next[w.section] }
+            : {};
+        bucket[w.name] = w.spec;
+        next[w.section] = sortByKey(bucket);
+    }
+    const emitted = JSON.stringify(next, null, detectIndent(raw)) + (raw.endsWith('\n') ? '\n' : '');
+    try {
+        await writeFile(pkgJsonPath, emitted, 'utf8');
+    }
+    catch (err) {
+        return { kind: 'error', message: `Failed to write ${pkgJsonPath}: ${err.message}` };
+    }
+    return { kind: 'patched', added: missing.map((w) => w.name) };
+}
+// ---------------------------------------------------------------------
+// Helpers — exported for tests
+// ---------------------------------------------------------------------
+/**
+ * Detect the indent width used in a JSON file. Reads until the first
+ * indented line (a line starting with whitespace), counts the run.
+ * Falls back to 2 spaces if nothing looks indented (single-line JSON).
+ */
+export function detectIndent(raw) {
+    const lines = raw.split('\n');
+    for (const line of lines) {
+        const match = line.match(/^(\s+)/);
+        if (match !== null) {
+            const ws = match[1] ?? '';
+            // Tabs → treat as 4 spaces of JSON.stringify indent (JS's
+            // JSON.stringify only accepts number-or-string, so we return a
+            // number; tab-indented files get re-emitted with 4-space
+            // indent. Acceptable rare-case regression.
+            if (ws.includes('\t'))
+                return 4;
+            return ws.length;
+        }
+    }
+    return 2;
+}
+/**
+ * True iff the dep appears in `dependencies`, `devDependencies`,
+ * `peerDependencies`, or `optionalDependencies` sections.
+ */
+export function isDepPresent(pkg, name) {
+    const sections = [
+        'dependencies',
+        'devDependencies',
+        'peerDependencies',
+        'optionalDependencies',
+    ];
+    for (const s of sections) {
+        const bucket = pkg[s];
+        if (isRecord(bucket) && Object.prototype.hasOwnProperty.call(bucket, name))
+            return true;
+    }
+    return false;
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function sortByKey(obj) {
+    const out = {};
+    for (const key of Object.keys(obj).sort()) {
+        out[key] = obj[key];
+    }
+    return out;
+}
+//# sourceMappingURL=package-json-patcher.js.map

package/dist/init/package-json-patcher.js.map

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