@kindgi/cli 0.0.0-bootstrap.0 → 0.1.1

package/dist/init/pnpm-workspace-patcher.d.ts

@@ -0,0 +1,55 @@
+export declare const PNPM_WORKSPACE_FILE = "pnpm-workspace.yaml";
+/** The dependency with an install script that Kindgi brings (it bundles the pack). */
+export declare const ESBUILD = "esbuild";
+/** Kindgi's decision for esbuild's install script: off, since esbuild works without it. */
+export declare const ESBUILD_DECISION = false;
+export type BuildDecisionEdit = {
+    readonly kind: 'edited';
+    readonly text: string;
+    /** `added`: a new entry (or block); `placeholder`: pnpm's placeholder replaced. */
+    readonly change: 'added' | 'placeholder';
+}
+/** `allowBuilds.<name>` already holds a decision (`true` or `false`): kept. */
+ | {
+    readonly kind: 'decided';
+    readonly value: boolean;
+} | {
+    readonly kind: 'refused';
+    readonly reason: string;
+};
+/**
+ * Record `value` as the decision for `name`'s install script in a
+ * `pnpm-workspace.yaml`'s text, unless it already has one. Pure: the
+ * edited text, or why it was left as it is.
+ */
+export declare function decideBuildInText(text: string, name: string, value: boolean): BuildDecisionEdit;
+export type PnpmWorkspacePatchResult = {
+    readonly kind: 'created';
+} | {
+    readonly kind: 'patched';
+    readonly change: 'added' | 'placeholder';
+}
+/** The app already decided (`true` or `false`): kept. */
+ | {
+    readonly kind: 'already-decided';
+    readonly value: boolean;
+}
+/** Not edited: the caller tells the user what to add by hand. */
+ | {
+    readonly kind: 'refused';
+    readonly reason: string;
+} | {
+    readonly kind: 'error';
+    readonly message: string;
+};
+/**
+ * Make sure `pnpm install` has a decision for esbuild's install script
+ * (Kindgi's: off): edit the `pnpm-workspace.yaml` at `path`, or create it.
+ */
+export declare function patchPnpmWorkspace(path: string): Promise<PnpmWorkspacePatchResult>;
+/**
+ * The `pnpm-workspace.yaml` pnpm reads for an app at `dir`: the nearest
+ * one at or above it (the workspace root), else the app's own (to create).
+ */
+export declare function pnpmWorkspaceFileFor(dir: string, exists?: (path: string) => Promise<boolean>): Promise<string>;
+//# sourceMappingURL=pnpm-workspace-patcher.d.ts.map

package/dist/init/pnpm-workspace-patcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-workspace-patcher.d.ts","sourceRoot":"","sources":["../../src/init/pnpm-workspace-patcher.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,sFAAsF;AACtF,eAAO,MAAM,OAAO,YAAY,CAAC;AAEjC,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,QAAQ,CAAC;AAatC,MAAM,MAAM,iBAAiB,GACzB;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CAAC;CAC1C;AACH,+EAA+E;GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAwB/F;AAED,MAAM,MAAM,wBAAwB,GAChC;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CAAA;CAAE;AACxE,yDAAyD;GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE;AAC/D,iEAAiE;GAC/D;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAqBxF;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAc,GACtD,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/init/pnpm-workspace-patcher.js

@@ -0,0 +1,248 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * `pnpm-workspace.yaml` patcher for augment mode in a pnpm app. pnpm 11+
+ * fails `pnpm install` (`ERR_PNPM_IGNORED_BUILDS`) when a dependency has
+ * an install script the workspace hasn't allowed or denied — and
+ * `@kindgi/cli` depends on esbuild, which has one. esbuild doesn't need
+ * it: its native binary comes from its `@esbuild/<platform>` package, and
+ * the script only checks it. So `kindgi init` records the decision that
+ * runs nothing, `allowBuilds.esbuild: false`, as the fresh templates' own
+ * `pnpm-workspace.yaml` does.
+ *
+ * The file pnpm reads is the workspace root's: the nearest
+ * `pnpm-workspace.yaml` at or above the app (a monorepo's root), else a new
+ * one in the app. An existing file is edited as text, so the app's own
+ * keys, comments and layout survive; every edit is checked by parsing the
+ * result, which must equal the original document with exactly that one
+ * change (the `pyproject.toml` patcher's rule). An edit that can't be made
+ * that way is refused and the caller tells the user what to add by hand.
+ *
+ *   - no `allowBuilds` key → an `allowBuilds:` block appended at the end;
+ *   - `allowBuilds` without `esbuild` → `esbuild: false` added to it;
+ *   - pnpm's placeholder (`esbuild: set this to true or false`, written
+ *     by a failed install) → replaced with `false`;
+ *   - `esbuild: true` or `false` → the app has decided: nothing to do.
+ */
+import { readFile, stat, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { isDeepStrictEqual } from 'node:util';
+import { isMap, isScalar, parseDocument } from 'yaml';
+export const PNPM_WORKSPACE_FILE = 'pnpm-workspace.yaml';
+/** The dependency with an install script that Kindgi brings (it bundles the pack). */
+export const ESBUILD = 'esbuild';
+/** Kindgi's decision for esbuild's install script: off, since esbuild works without it. */
+export const ESBUILD_DECISION = false;
+/** What pnpm writes for a build it was not told about. */
+const PNPM_PLACEHOLDER = 'set this to true or false';
+/** The block added to a file without `allowBuilds` (or written as a new file). */
+const ALLOW_BUILDS_BLOCK = `# Install scripts pnpm runs (true) or skips (false); pnpm 11 stops an
+# install until each one has a decision. esbuild works without its script
+# (its binary comes from its @esbuild/<platform> package), so it stays off.
+allowBuilds:
+  ${ESBUILD}: ${ESBUILD_DECISION}
+`;
+/**
+ * Record `value` as the decision for `name`'s install script in a
+ * `pnpm-workspace.yaml`'s text, unless it already has one. Pure: the
+ * edited text, or why it was left as it is.
+ */
+export function decideBuildInText(text, name, value) {
+    const doc = parseDocument(text);
+    const parseError = doc.errors[0];
+    if (parseError !== undefined)
+        return refused(`it does not parse: ${parseError.message}`);
+    const root = doc.contents;
+    if (isNull(root))
+        return verified(text, appendBlock(text, name, value), name, value, 'added');
+    if (!isMap(root) || root.flow === true)
+        return refused('it is not a YAML mapping');
+    const allowBuilds = findPair(root, 'allowBuilds');
+    if (allowBuilds === undefined) {
+        return verified(text, appendBlock(text, name, value), name, value, 'added');
+    }
+    const builds = allowBuilds.value;
+    if (isNull(builds))
+        return addUnderEmptyKey(text, allowBuilds, name, value);
+    if (!isMap(builds))
+        return refused('allowBuilds is not a mapping');
+    const entry = findPair(builds, name);
+    if (entry !== undefined)
+        return editEntry(text, entry, name, value);
+    const edited = builds.flow === true
+        ? addToFlowMap(text, builds, name, value)
+        : addEntry(text, builds, name, value);
+    if (edited === undefined)
+        return refused('allowBuilds is laid out in a way init does not edit');
+    return verified(text, edited, name, value, 'added');
+}
+/**
+ * Make sure `pnpm install` has a decision for esbuild's install script
+ * (Kindgi's: off): edit the `pnpm-workspace.yaml` at `path`, or create it.
+ */
+export async function patchPnpmWorkspace(path) {
+    let text;
+    try {
+        text = await readFile(path, 'utf8');
+    }
+    catch (err) {
+        if (err.code !== 'ENOENT') {
+            return { kind: 'error', message: `Failed to read ${path}: ${err.message}` };
+        }
+    }
+    const edit = text === undefined ? undefined : decideBuildInText(text, ESBUILD, ESBUILD_DECISION);
+    if (edit !== undefined && edit.kind !== 'edited') {
+        return edit.kind === 'decided'
+            ? { kind: 'already-decided', value: edit.value }
+            : { kind: 'refused', reason: edit.reason };
+    }
+    try {
+        await writeFile(path, edit === undefined ? ALLOW_BUILDS_BLOCK : edit.text, 'utf8');
+    }
+    catch (err) {
+        return { kind: 'error', message: `Failed to write ${path}: ${err.message}` };
+    }
+    return edit === undefined ? { kind: 'created' } : { kind: 'patched', change: edit.change };
+}
+/**
+ * The `pnpm-workspace.yaml` pnpm reads for an app at `dir`: the nearest
+ * one at or above it (the workspace root), else the app's own (to create).
+ */
+export async function pnpmWorkspaceFileFor(dir, exists = fileExists) {
+    for (let current = dir;; current = dirname(current)) {
+        const candidate = join(current, PNPM_WORKSPACE_FILE);
+        if (await exists(candidate))
+            return candidate;
+        if (dirname(current) === current)
+            return join(dir, PNPM_WORKSPACE_FILE);
+    }
+}
+// ---------------------------------------------------------------------
+// Edits
+// ---------------------------------------------------------------------
+function editEntry(text, entry, name, decision) {
+    const value = entry.value;
+    if (isScalar(value) && typeof value.value === 'boolean') {
+        return { kind: 'decided', value: value.value };
+    }
+    const range = value?.range;
+    if (isScalar(value) &&
+        typeof value.value === 'string' &&
+        value.value.trim().toLowerCase() === PNPM_PLACEHOLDER &&
+        range !== undefined &&
+        range !== null) {
+        const edited = `${text.slice(0, range[0])}${decision}${text.slice(range[1])}`;
+        return verified(text, edited, name, decision, 'placeholder');
+    }
+    return refused(`allowBuilds.${name} is neither true nor false`);
+}
+/** `allowBuilds:` with nothing under it: `name: <value>` on the next line. */
+function addUnderEmptyKey(text, pair, name, value) {
+    const range = pair.value?.range;
+    // An explicit `null` / `~`, not an empty value.
+    if (range !== undefined && range !== null && range[0] !== range[1]) {
+        return refused('allowBuilds is null');
+    }
+    const keyStart = pair.key.range?.[0] ?? 0;
+    const indent = `${lineIndent(text, keyStart) ?? ''}  `;
+    const edited = insert(text, lineEnd(text, keyStart), `\n${indent}${name}: ${value}`);
+    return verified(text, edited, name, value, 'added');
+}
+/** `name: <value>` as the last entry of a block `allowBuilds`, at its entries' indent. */
+function addEntry(text, map, name, value) {
+    const firstKey = map.items[0]?.key;
+    const lastItem = map.items[map.items.length - 1];
+    const indent = lineIndent(text, firstKey?.range?.[0] ?? -1);
+    let end = (lastItem?.value ?? lastItem?.key)?.range?.[1];
+    if (indent === undefined || end === undefined)
+        return undefined;
+    // A nested value's range can run to the start of the next line.
+    while (end > 0 && /\s/.test(text[end - 1]))
+        end -= 1;
+    return insert(text, lineEnd(text, end), `\n${indent}${name}: ${value}`);
+}
+/** `name: <value>` as the last entry of a flow `allowBuilds` (`{ … }`). */
+function addToFlowMap(text, map, name, value) {
+    const range = map.range;
+    if (range === undefined || range === null || text[range[1] - 1] !== '}')
+        return undefined;
+    let last = range[1] - 2;
+    while (last > range[0] && /\s/.test(text[last]))
+        last -= 1;
+    if (last === range[0])
+        return `${text.slice(0, range[0])}{ ${name}: ${value} }${text.slice(range[1])}`;
+    const entry = `${name}: ${value}`;
+    return insert(text, last + 1, text[last] === ',' ? ` ${entry}` : `, ${entry}`);
+}
+function appendBlock(text, name, value) {
+    const block = name === ESBUILD && value === ESBUILD_DECISION
+        ? ALLOW_BUILDS_BLOCK
+        : `allowBuilds:\n  ${name}: ${value}\n`;
+    if (text.trim() === '')
+        return `${text}${block}`;
+    return `${text.endsWith('\n') ? text : `${text}\n`}\n${block}`;
+}
+// ---------------------------------------------------------------------
+// Verification
+// ---------------------------------------------------------------------
+/**
+ * `after`, if it parses to exactly `before`'s document with
+ * `allowBuilds.<name>` set to `value`; refused otherwise.
+ */
+function verified(before, after, name, value, change) {
+    const wanted = toPlain(before);
+    const got = toPlain(after);
+    if (wanted === undefined || got === undefined)
+        return refused('the edit would not parse');
+    const doc = isRecord(wanted) ? { ...wanted } : {};
+    doc.allowBuilds = { ...(isRecord(doc.allowBuilds) ? doc.allowBuilds : {}), [name]: value };
+    return isDeepStrictEqual(got, doc)
+        ? { kind: 'edited', text: after, change }
+        : refused('the edit would change more than intended');
+}
+/** The document as plain JSON values; `undefined` when it doesn't parse. */
+function toPlain(text) {
+    const doc = parseDocument(text);
+    if (doc.errors.length > 0)
+        return undefined;
+    return JSON.parse(JSON.stringify(doc.toJS() ?? {}));
+}
+// ---------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------
+/** No document, or a `null` value. */
+function isNull(node) {
+    return node === null || node === undefined || (isScalar(node) && node.value === null);
+}
+function findPair(map, key) {
+    return map.items.find((p) => isScalar(p.key) && p.key.value === key);
+}
+/** The whitespace before `offset` on its line; `undefined` when other text precedes it. */
+function lineIndent(text, offset) {
+    if (offset < 0)
+        return undefined;
+    const indent = text.slice(text.lastIndexOf('\n', offset - 1) + 1, offset);
+    return /^[ \t]*$/.test(indent) ? indent : undefined;
+}
+function lineEnd(text, from) {
+    const nl = text.indexOf('\n', from);
+    return nl === -1 ? text.length : nl;
+}
+function insert(text, at, what) {
+    return `${text.slice(0, at)}${what}${text.slice(at)}`;
+}
+function refused(reason) {
+    return { kind: 'refused', reason };
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+async function fileExists(path) {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=pnpm-workspace-patcher.js.map

package/dist/init/pnpm-workspace-patcher.js.map

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

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

@@ -0,0 +1,56 @@
+type Doc = Record<string, unknown>;
+/** How the app declares its dependencies — whether `kindgi init` can add one. */
+export type DependencyStyle = 
+/** `[project].dependencies` (PEP 621): editable. */
+'pep621'
+/** `dependencies` is in `[project].dynamic` (setuptools reading a file). */
+ | 'dynamic'
+/** No `[project]` table — Poetry 1's `[tool.poetry]`, `setup.py`, …. */
+ | 'none';
+export interface PyprojectInfo {
+    readonly name: string | undefined;
+    readonly version: string | undefined;
+    /** It already has a `[tool.kindgi]` table — it is a pack. */
+    readonly isPack: boolean;
+    readonly dependencyStyle: DependencyStyle;
+    /** `kindgi` is already one of `[project].dependencies`. */
+    readonly hasKindgiDependency: boolean;
+    /** `[tool.poetry]` is present. */
+    readonly usesPoetry: boolean;
+    /** `[tool.uv]` is present, or the build backend is `uv_build`. */
+    readonly usesUv: boolean;
+    /** `[tool.uv] required-version`, when set. */
+    readonly uvRequiredVersion: string | undefined;
+}
+type Edit = {
+    readonly kind: 'ok';
+    readonly text: string;
+} | {
+    readonly kind: 'err';
+    readonly message: string;
+};
+export declare function readPyproject(text: string): {
+    readonly kind: 'ok';
+    readonly info: PyprojectInfo;
+} | {
+    readonly kind: 'err';
+    readonly message: string;
+};
+/** The normalized distribution name of a requirement (`Kindgi[x]>=1` → `kindgi`). */
+export declare function requirementName(requirement: string): string;
+/** PEP 503 normalization: lowercase, runs of `-`, `_`, `.` become `-`. */
+export declare function normalizeName(name: string): string;
+/** Add `requirement` to `[project].dependencies` (creating the key if absent). */
+export declare function addProjectDependency(text: string, requirement: string): Edit;
+/** Add `name = <inlineTable>` under `[tool.uv.sources]` (creating the table at the end if absent). */
+export declare function addUvSource(text: string, name: string, inlineTable: string): Edit;
+/**
+ * Set `key = <tomlValue>` in the table `dotted` (e.g. `tool.uv`): right
+ * under its header, or in a new table at the end of the file. The key must
+ * not be set yet (the verification refuses otherwise).
+ */
+export declare function addTableKey(text: string, dotted: string, key: string, tomlValue: string): Edit;
+/** Append `block` (whole tables) at the end of the file; it must add exactly `expected`. */
+export declare function appendTables(text: string, block: string, expected: Doc): Edit;
+export {};
+//# sourceMappingURL=pyproject-patcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pyproject-patcher.d.ts","sourceRoot":"","sources":["../../src/init/pyproject-patcher.ts"],"names":[],"mappings":"AAmBA,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEnC,iFAAiF;AACjF,MAAM,MAAM,eAAe;AACzB,oDAAoD;AAClD,QAAQ;AACV,4EAA4E;GAC1E,SAAS;AACX,wEAAwE;GACtE,MAAM,CAAC;AAEX,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,2DAA2D;IAC3D,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC,kCAAkC;IAClC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;CAChD;AAED,KAAK,IAAI,GACL;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,GAEV;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA6BrD;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAuB5E;AAED,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAEjF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAmB9F;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG,IAAI,CAG7E"}