chkit 0.1.2-beta.7 → 0.2.0-beta.12

package/dist/commands/snapshot/output.js

@@ -0,0 +1,86 @@
+import { isAbsolute, relative } from 'node:path';
+import process from 'node:process';
+import { emitJson } from '../../runtime/json-output.js';
+const DOCS_URL = 'https://chkit.obsessiondb.com/cli/snapshot/';
+const UNREADABLE_LABELS = {
+    empty: 'empty file',
+    invalid_json: 'invalid JSON',
+    invalid_shape: 'not a chkit snapshot',
+};
+export function emitSnapshotRebuildOutput(payload, jsonMode) {
+    if (jsonMode) {
+        emitJson('snapshot', payload);
+        return;
+    }
+    console.log(formatSnapshotRebuildText(payload).join('\n'));
+}
+function formatSnapshotRebuildText(payload) {
+    const { previous } = payload;
+    const displayPath = formatShellPath(payload.snapshotFile);
+    const lines = [
+        formatHeader(payload),
+        `Definitions:        ${payload.definitionCount}`,
+        `Previous snapshot:  ${formatPreviousSummary(previous)}`,
+    ];
+    if (previous.status === 'parsed') {
+        lines.push(...previous.added.map((key) => `  + ${key}`), ...previous.removed.map((key) => `  - ${key}`), ...previous.changed.map((key) => `  ~ ${key}`));
+    }
+    if (previous.status === 'conflicted') {
+        // Only one of MERGE_HEAD and REBASE_HEAD exists at a time, so each gets its
+        // own line. The labels are shell comments: a line still runs when pasted.
+        lines.push('', payload.mode === 'plan'
+            ? 'After the rebuild, compare snapshot.json with both sides of the conflict before you commit it:'
+            : 'Compare snapshot.json with both sides of the conflict before you commit it:', `  git diff HEAD -- ${displayPath}`, `  git diff MERGE_HEAD -- ${displayPath}    # during a merge`, `  git diff REBASE_HEAD -- ${displayPath}   # during a rebase`, 'Every entry that differs from one side must come from a migration file of the other side.');
+    }
+    if (previous.status === 'unreadable') {
+        // `git checkout -- <path>` restores from the index, which still holds a
+        // staged damaged file and refuses an unmerged one. HEAD is the committed
+        // version, but during a merge or rebase it is only one side of the conflict.
+        lines.push('', 'If no merge or rebase is in progress and the damaged file is committed, its committed version', 'is a safer baseline than a rebuild. Restore it with:', `  git checkout HEAD -- ${displayPath}`);
+    }
+    if (needsCaution(previous)) {
+        lines.push('', ...formatCaution(payload.mode));
+    }
+    return lines;
+}
+function formatHeader(payload) {
+    if (payload.mode === 'plan')
+        return `Dry run: ${payload.snapshotFile} was not written.`;
+    if (payload.written && payload.previous.status === 'missing')
+        return `Created snapshot: ${payload.snapshotFile}`;
+    if (payload.written)
+        return `Rebuilt snapshot: ${payload.snapshotFile}`;
+    return `Snapshot is up to date: ${payload.snapshotFile}`;
+}
+function formatPreviousSummary(previous) {
+    if (previous.status === 'missing')
+        return 'none';
+    if (previous.status === 'parsed') {
+        return `${previous.added.length} added, ${previous.removed.length} removed, ${previous.changed.length} changed`;
+    }
+    if (previous.status === 'conflicted')
+        return 'unresolved merge conflict markers (not compared)';
+    return `${UNREADABLE_LABELS[previous.reason]} (not compared)`;
+}
+/** The snapshot path for a copy-pasteable command: relative when it is inside cwd, quoted when needed. */
+function formatShellPath(file) {
+    const fromCwd = relative(process.cwd(), file);
+    const path = fromCwd && !fromCwd.startsWith('..') && !isAbsolute(fromCwd) ? fromCwd : file;
+    return /^[\w./-]+$/.test(path) ? path : `'${path.replaceAll("'", `'\\''`)}'`;
+}
+function needsCaution(previous) {
+    if (previous.status !== 'parsed')
+        return true;
+    return previous.added.length + previous.removed.length + previous.changed.length > 0;
+}
+function formatCaution(mode) {
+    const verb = mode === 'plan' ? 'would record' : 'records';
+    return [
+        `Caution: the rebuilt snapshot ${verb} every schema definition as already migrated, so`,
+        '`chkit generate` will not write a migration for any change it absorbed. Rebuild only when',
+        'every schema change already has a migration file. For merged branches, `chkit generate --dryrun`',
+        'should have reported 0 operations on each branch. After upgrading chkit, run `chkit generate` first.',
+        `When not to rebuild: ${DOCS_URL}#when-not-to-rebuild`,
+    ];
+}
+//# sourceMappingURL=output.js.map

package/dist/commands/snapshot/output.js.map

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

package/dist/commands/snapshot/rebuild.d.ts

@@ -0,0 +1,19 @@
+import { type ParsedFlags, type ResolvedChxConfig } from '@chkit/core';
+import type { PluginRuntime } from '../../plugins.js';
+export interface SnapshotRebuildInput {
+    dryrun: boolean;
+    jsonMode: boolean;
+}
+export interface SnapshotRebuildDeps {
+    config: ResolvedChxConfig;
+    configPath: string;
+    flags: ParsedFlags;
+    pluginRuntime: PluginRuntime;
+}
+/**
+ * Rewrite snapshot.json from the schema definitions. Definitions are loaded,
+ * passed through the plugin hooks, validated and written exactly as
+ * `chkit generate` does; no migration is planned or written.
+ */
+export declare function runSnapshotRebuild(input: SnapshotRebuildInput, deps: SnapshotRebuildDeps): Promise<number>;
+//# sourceMappingURL=rebuild.d.ts.map

package/dist/commands/snapshot/rebuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild.d.ts","sourceRoot":"","sources":["../../../src/commands/snapshot/rebuild.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAEvB,MAAM,aAAa,CAAA;AAEpB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAarD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,iBAAiB,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,WAAW,CAAA;IAClB,aAAa,EAAE,aAAa,CAAA;CAC7B;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwDhH"}

package/dist/commands/snapshot/rebuild.js

@@ -0,0 +1,94 @@
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { writeSnapshot } from '@chkit/codegen';
+import { canonicalizeDefinitions, ChxValidationError, validateDefinitions, } from '@chkit/core';
+import { resolveDirs } from '../../runtime/config.js';
+import { emitJson } from '../../runtime/json-output.js';
+import { readSnapshot } from '../../runtime/migration-store.js';
+import { loadSchemaDefinitionsWithHooks } from '../../runtime/schema-loader.js';
+import { carryRetainedDefinitions } from '../generate/cutover.js';
+import { diffSnapshotDefinitions, parseSnapshotDocument, } from '../../runtime/snapshot-document.js';
+import { emitSnapshotRebuildOutput } from './output.js';
+/**
+ * Rewrite snapshot.json from the schema definitions. Definitions are loaded,
+ * passed through the plugin hooks, validated and written exactly as
+ * `chkit generate` does; no migration is planned or written.
+ */
+export async function runSnapshotRebuild(input, deps) {
+    const { metaDir } = resolveDirs(deps.config);
+    const snapshotFile = join(metaDir, 'snapshot.json');
+    const loaded = await loadSchemaDefinitionsWithHooks({
+        command: 'snapshot',
+        config: deps.config,
+        configPath: deps.configPath,
+        flags: deps.flags,
+        jsonMode: input.jsonMode,
+    }, { pluginRuntime: deps.pluginRuntime });
+    // A hook that edits definitions in place (instead of returning them) leaves
+    // them non-canonical. The snapshot always stores canonical definitions, so
+    // canonicalize once and validate, compare, count and write that same list.
+    // A table that a keep-mode cutover retained is declared in the snapshot only,
+    // so the rebuild keeps it, as `generate` does.
+    const definitions = carryRetainedDefinitions({
+        previousDefinitions: await readRetainedSource(metaDir),
+        definitions: canonicalizeDefinitions(loaded),
+        dropRetained: [],
+    });
+    // Same validation and error contract as `chkit generate` (planDiff validates the new definitions).
+    const issues = validateDefinitions(definitions);
+    if (issues.length > 0) {
+        if (input.jsonMode) {
+            emitJson('snapshot', { error: 'validation_failed', issues });
+            return 1;
+        }
+        const details = issues.map((issue) => `- [${issue.code}] ${issue.message}`).join('\n');
+        throw new Error(`${new ChxValidationError(issues).message}\n${details}`);
+    }
+    const previous = await describePreviousSnapshot(snapshotFile, definitions);
+    const upToDate = previous.status === 'parsed' &&
+        previous.added.length + previous.removed.length + previous.changed.length === 0;
+    // An unchanged snapshot is left alone, so a rebuild never churns `generatedAt`.
+    const written = !input.dryrun && !upToDate;
+    if (written)
+        await writeSnapshot({ metaDir, definitions });
+    emitSnapshotRebuildOutput({
+        subcommand: 'rebuild',
+        mode: input.dryrun ? 'plan' : 'write',
+        snapshotFile,
+        written,
+        definitionCount: definitions.length,
+        previous,
+    }, input.jsonMode);
+    return 0;
+}
+/** The definitions of the current snapshot, or none when it is missing or unreadable. */
+async function readRetainedSource(metaDir) {
+    try {
+        return (await readSnapshot(metaDir))?.definitions ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+async function describePreviousSnapshot(snapshotFile, next) {
+    if (!existsSync(snapshotFile))
+        return { status: 'missing' };
+    const raw = await readFile(snapshotFile, 'utf8');
+    let parsed;
+    try {
+        parsed = parseSnapshotDocument(raw);
+    }
+    catch {
+        // Valid JSON whose entries cannot be read as chkit definitions. The rebuild
+        // replaces it anyway; it just cannot be compared.
+        return { status: 'unreadable', reason: 'invalid_shape' };
+    }
+    if (parsed.status === 'ok') {
+        return { status: 'parsed', ...diffSnapshotDefinitions(parsed.snapshot.definitions, next) };
+    }
+    if (parsed.reason === 'conflict_markers')
+        return { status: 'conflicted' };
+    return { status: 'unreadable', reason: parsed.reason };
+}
+//# sourceMappingURL=rebuild.js.map

package/dist/commands/snapshot/rebuild.js.map

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

package/dist/internal-plugins/core/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/internal-plugins/core/plugin.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,UAAU,sCAWrB,CAAA"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/internal-plugins/core/plugin.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,UAAU,sCAYrB,CAAA"}

package/dist/internal-plugins/core/plugin.js

@@ -4,6 +4,7 @@ import { generateCommand } from '../../commands/generate/command.js';
 import { migrateCommand } from '../../commands/migrate/command.js';
 import { pluginCommand } from '../../commands/plugin.js';
 import { queryCommand } from '../../commands/query.js';
+import { snapshotCommand } from '../../commands/snapshot/command.js';
 import { statusCommand } from '../../commands/status.js';
 import { definePlugin } from '../../plugins.js';
 export const corePlugin = definePlugin({
@@ -14,6 +15,7 @@ export const corePlugin = definePlugin({
         statusCommand,
         driftCommand,
         checkCommand,
+        snapshotCommand,
         queryCommand,
         pluginCommand,
     ],

package/dist/internal-plugins/core/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/internal-plugins/core/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;IACrC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE;IACzC,QAAQ,EAAE;QACR,eAAe;QACf,cAAc;QACd,aAAa;QACb,YAAY;QACZ,YAAY;QACZ,YAAY;QACZ,aAAa;KACd;CACF,CAAC,CAAA"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/internal-plugins/core/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;IACrC,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE;IACzC,QAAQ,EAAE;QACR,eAAe;QACf,cAAc;QACd,aAAa;QACb,YAAY;QACZ,YAAY;QACZ,eAAe;QACf,YAAY;QACZ,aAAa;KACd;CACF,CAAC,CAAA"}

package/dist/registry/build.d.ts

@@ -0,0 +1,17 @@
+import { type RegistryCatalog, type RegistryItem } from './model.js';
+export declare function buildRegistry(input: {
+    manifestPath: string;
+    outputDir: string;
+}): Promise<{
+    items: RegistryItem[];
+    files: string[];
+}>;
+export declare function buildRegistryCatalog(input: {
+    catalog: RegistryCatalog;
+    sourceRoot: string;
+    outputDir: string;
+}): Promise<{
+    items: RegistryItem[];
+    files: string[];
+}>;
+//# sourceMappingURL=build.d.ts.map

package/dist/registry/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/registry/build.ts"],"names":[],"mappings":"AAKA,OAAO,EAAiH,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAEnL,wBAAsB,aAAa,CAAC,KAAK,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAI3I;AAED,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAsC1K"}

package/dist/registry/build.js

@@ -0,0 +1,94 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import * as ts from 'typescript';
+import { assertProjectPath, readOptional } from './files.js';
+import { CATALOG_SCHEMA_URL, hashContent, ITEM_SCHEMA_URL, MAX_ARTIFACT_BYTES, parseRegistryCatalog, parseRegistryItem } from './model.js';
+export async function buildRegistry(input) {
+    const manifestPath = resolve(input.manifestPath);
+    const catalog = parseRegistryCatalog(JSON.parse(await readFile(manifestPath, 'utf8')));
+    return buildRegistryCatalog({ catalog, sourceRoot: dirname(manifestPath), outputDir: input.outputDir });
+}
+export async function buildRegistryCatalog(input) {
+    const sourceRoot = resolve(input.sourceRoot);
+    const outputDir = resolve(input.outputDir);
+    const catalog = parseRegistryCatalog(input.catalog);
+    const items = [];
+    const outputs = [];
+    for (const source of catalog.items) {
+        const files = [];
+        for (const file of source.files) {
+            const path = resolve(sourceRoot, file.path);
+            await assertProjectPath(sourceRoot, path);
+            const content = await readFile(path, 'utf8');
+            if (/\.[cm]?tsx?$/.test(file.path))
+                validateSyntax(file.path, content);
+            files.push({ ...file, content });
+        }
+        const item = parseRegistryItem({
+            ...source,
+            $schema: ITEM_SCHEMA_URL,
+            files,
+            meta: { chkit: { ...source.meta.chkit, fileHashes: Object.fromEntries(files.map((file) => [file.target, hashContent(file.content ?? '')])) } },
+        });
+        validateEntryExports(item);
+        const content = serialize(item);
+        const versionPath = resolve(outputDir, item.name, `${item.meta.chkit.version}.json`);
+        await assertProjectPath(outputDir, versionPath);
+        const existing = await readOptional(versionPath);
+        if (existing !== undefined && existing !== content)
+            throw new Error(`Immutable registry version already exists with different content: ${versionPath}. Bump the template version.`);
+        items.push(item);
+        outputs.push({ path: versionPath, content }, { path: resolve(outputDir, `${item.name}.json`), content });
+    }
+    const index = { ...catalog, $schema: CATALOG_SCHEMA_URL, items: items.map((item) => ({ ...item, files: item.files.map(({ content: _content, ...file }) => file) })) };
+    outputs.push({ path: resolve(outputDir, 'registry.json'), content: serialize(index) });
+    for (const output of outputs)
+        await assertProjectPath(outputDir, output.path);
+    for (const output of outputs) {
+        await mkdir(dirname(output.path), { recursive: true });
+        await writeFile(output.path, output.content);
+    }
+    return { items, files: outputs.map((file) => file.path) };
+}
+function validateEntryExports(item) {
+    const entryPath = `${item.meta.chkit.root}/${item.meta.chkit.entry}`;
+    const entry = item.files.find((file) => file.target === entryPath);
+    if (!entry?.content)
+        throw new Error(`Missing entry source: ${entryPath}`);
+    const source = ts.createSourceFile(entryPath, entry.content, ts.ScriptTarget.Latest, true);
+    const names = new Set();
+    for (const statement of source.statements) {
+        if (ts.isExportDeclaration(statement) && !statement.isTypeOnly && statement.exportClause && ts.isNamedExports(statement.exportClause)) {
+            for (const element of statement.exportClause.elements)
+                if (!element.isTypeOnly)
+                    names.add(element.name.text);
+        }
+        if (ts.canHaveModifiers(statement) && ts.getModifiers(statement)?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword)) {
+            if (ts.isVariableStatement(statement)) {
+                for (const declaration of statement.declarationList.declarations)
+                    if (ts.isIdentifier(declaration.name))
+                        names.add(declaration.name.text);
+            }
+        }
+    }
+    for (const name of item.meta.chkit.exports) {
+        if (!names.has(name))
+            throw new Error(`Entry ${entryPath} must explicitly export ${name}`);
+    }
+}
+function validateSyntax(path, content) {
+    const diagnostics = ts.transpileModule(content, {
+        fileName: path, reportDiagnostics: true,
+        compilerOptions: { target: ts.ScriptTarget.ESNext, module: ts.ModuleKind.ESNext },
+    }).diagnostics ?? [];
+    const error = diagnostics.find((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error);
+    if (error)
+        throw new Error(`Invalid template source ${path}: ${ts.flattenDiagnosticMessageText(error.messageText, '\n')}`);
+}
+function serialize(value) {
+    const text = `${JSON.stringify(value, null, 2)}\n`;
+    if (Buffer.byteLength(text) > MAX_ARTIFACT_BYTES)
+        throw new Error('Registry artifact exceeds the 8 MiB limit');
+    return text;
+}
+//# sourceMappingURL=build.js.map

package/dist/registry/build.js.map

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

package/dist/registry/dependencies.d.ts

@@ -0,0 +1,19 @@
+import { type PackageManager } from '../runtime/deps.js';
+import { type RegistryItem } from './model.js';
+export declare function planDependencies(input: {
+    cwd: string;
+    item: RegistryItem;
+    cliVersion: string;
+    packageManager?: PackageManager;
+    withTests?: boolean;
+}): Promise<{
+    path: string;
+    content: string;
+    original?: string;
+    dependencies: string[];
+    packageManager: PackageManager;
+    installed: boolean;
+}>;
+export declare function installDependencies(cwd: string, packageManager: PackageManager): Promise<void>;
+export declare function parsePackageManager(value: string): PackageManager;
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/registry/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/registry/dependencies.ts"],"names":[],"mappings":"AAKA,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAE9E,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAYjE,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC;IACpK,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,cAAc,EAAE,cAAc,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAC7H,CAAC,CA0CD;AAmBD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpG;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAGjE"}

package/dist/registry/dependencies.js

@@ -0,0 +1,105 @@
+import { spawn } from 'node:child_process';
+import { basename, dirname, resolve } from 'node:path';
+import { satisfies, subset, validRange } from 'semver';
+import { z } from 'zod';
+import { detectPackageManager } from '../runtime/deps.js';
+import { readOptional } from './files.js';
+import { requireDependency } from './model.js';
+const manifestSchema = z.object({
+    name: z.string().optional(),
+    version: z.string().optional(),
+    packageManager: z.string().optional(),
+    dependencies: z.record(z.string(), z.string()).optional(),
+    devDependencies: z.record(z.string(), z.string()).optional(),
+    peerDependencies: z.record(z.string(), z.string()).optional(),
+    optionalDependencies: z.record(z.string(), z.string()).optional(),
+}).passthrough();
+export async function planDependencies(input) {
+    const path = resolve(input.cwd, 'package.json');
+    const original = await readOptional(path);
+    const manifest = original === undefined
+        ? { name: basename(input.cwd).toLowerCase().replace(/[^a-z0-9._-]/g, '-') || 'chkit-project', private: true, type: 'module' }
+        : manifestSchema.parse(JSON.parse(original));
+    const parsed = manifestSchema.parse(manifest);
+    const packageManager = input.packageManager ?? await choosePackageManager(input.cwd, parsed.packageManager);
+    const meta = input.item.meta.chkit;
+    const versionOptions = { includePrerelease: true };
+    if (!satisfies(input.cliVersion, meta.chkit, versionOptions))
+        throw new Error(`Template requires chkit ${meta.chkit}; running ${input.cliVersion}. Use a compatible CLI version.`);
+    const desired = [...input.item.dependencies, ...(input.withTests ? input.item.devDependencies ?? [] : [])];
+    const hasExplicitCli = desired.some((spec) => requireDependency(spec).name === 'chkit');
+    if (!hasExplicitCli)
+        desired.push(`chkit@${input.cliVersion}`);
+    const devDependencies = { ...parsed.devDependencies };
+    const dependencies = [];
+    let installed = true;
+    for (const spec of desired) {
+        const { name, range } = requireDependency(spec);
+        const compatibility = name === '@chkit/plugin-ingest' ? meta.ingest : name === 'chkit' || name === '@chkit/core' ? meta.chkit : undefined;
+        if (compatibility && !subset(range, compatibility, versionOptions))
+            throw new Error(`Dependency ${spec} is outside the template compatibility range ${compatibility}`);
+        const existing = parsed.dependencies?.[name] ?? parsed.devDependencies?.[name];
+        const required = name === 'chkit' && !hasExplicitCli ? meta.chkit : range;
+        const localVersion = await installedVersion(input.cwd, name);
+        if (!localVersion || !satisfies(localVersion, existing ?? required, versionOptions) || !satisfies(localVersion, required, versionOptions))
+            installed = false;
+        for (const indirect of [parsed.peerDependencies?.[name], parsed.optionalDependencies?.[name]]) {
+            if (indirect !== undefined && (!validRange(indirect) || !subset(indirect, required, versionOptions))) {
+                throw new Error(`Dependency conflict: ${name} is ${indirect}, but the template requires ${required}. Choose compatible versions before installing.`);
+            }
+        }
+        if (existing !== undefined) {
+            if (!validRange(existing) || !subset(existing, required, versionOptions)) {
+                throw new Error(`Dependency conflict: ${name} is ${existing}, but the template requires ${required}. Choose compatible versions before installing.`);
+            }
+            continue;
+        }
+        devDependencies[name] = range;
+        dependencies.push(spec);
+    }
+    const changed = dependencies.length > 0 || original === undefined;
+    const content = changed ? `${JSON.stringify({ ...parsed, devDependencies }, null, 2)}\n` : original;
+    return { path, content: content ?? '', original, dependencies, packageManager, installed };
+}
+async function installedVersion(cwd, name) {
+    // Inspect the current filesystem rather than module-resolution caches, which
+    // may retain a miss across package installation in the same Bun process.
+    // Reading through node_modules links also supports pnpm's strict layout.
+    let path = resolve(cwd);
+    while (true) {
+        const text = await readOptional(resolve(path, 'node_modules', name, 'package.json'));
+        if (text !== undefined) {
+            const manifest = manifestSchema.parse(JSON.parse(text));
+            if (manifest.name === name)
+                return manifest.version;
+        }
+        const parent = dirname(path);
+        if (parent === path)
+            return undefined;
+        path = parent;
+    }
+}
+export async function installDependencies(cwd, packageManager) {
+    await new Promise((resolvePromise, reject) => {
+        // stdout remains available for the CLI's JSON response; package-manager logs go to stderr.
+        const child = spawn(packageManager, ['install'], { cwd, stdio: ['ignore', 2, 2] });
+        child.on('error', reject);
+        child.on('close', (code) => code === 0 ? resolvePromise() : reject(new Error(`${packageManager} install failed (${code}). Files are installed; run ${packageManager} install in ${cwd} to complete setup.`)));
+    });
+}
+export function parsePackageManager(value) {
+    if (value === 'bun' || value === 'npm' || value === 'pnpm' || value === 'yarn')
+        return value;
+    throw new Error(`Unsupported package manager: ${value}. Use bun, npm, pnpm, or yarn.`);
+}
+async function choosePackageManager(cwd, declared) {
+    if (declared)
+        return parsePackageManager(declared.split('@')[0] ?? '');
+    const lockfiles = [['bun.lock', 'bun'], ['bun.lockb', 'bun'], ['package-lock.json', 'npm'], ['pnpm-lock.yaml', 'pnpm'], ['yarn.lock', 'yarn']];
+    const present = await Promise.all(lockfiles.map(async ([file, pm]) => (await readOptional(resolve(cwd, file))) === undefined ? undefined : pm));
+    const managers = [...new Set(present.filter((pm) => pm !== undefined))];
+    if (managers.length > 1)
+        throw new Error('Multiple package-manager lockfiles found. Choose --package-manager explicitly.');
+    return managers[0] ?? detectPackageManager();
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/registry/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../../src/registry/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,oBAAoB,EAAuB,MAAM,oBAAoB,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,iBAAiB,EAAqB,MAAM,YAAY,CAAA;AAEjE,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzD,eAAe,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC5D,gBAAgB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7D,oBAAoB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAClE,CAAC,CAAC,WAAW,EAAE,CAAA;AAEhB,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAoH;IAGzJ,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,cAAc,CAAC,CAAA;IAC/C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAA;IACzC,MAAM,QAAQ,GAAG,QAAQ,KAAK,SAAS;QACrC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,IAAI,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC7H,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC9C,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC7C,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,IAAI,MAAM,oBAAoB,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,CAAC,CAAA;IAC3G,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAA;IAClC,MAAM,cAAc,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAA;IAClD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,KAAK,aAAa,KAAK,CAAC,UAAU,iCAAiC,CAAC,CAAA;IAClL,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC1G,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAA;IACvF,IAAI,CAAC,cAAc;QAAE,OAAO,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,UAAU,EAAE,CAAC,CAAA;IAC9D,MAAM,eAAe,GAAG,EAAE,GAAG,MAAM,CAAC,eAAe,EAAE,CAAA;IACrD,MAAM,YAAY,GAAa,EAAE,CAAA;IACjC,IAAI,SAAS,GAAG,IAAI,CAAA;IACpB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAC/C,MAAM,aAAa,GAAG,IAAI,KAAK,sBAAsB,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;QACzI,IAAI,aAAa,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,cAAc,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,gDAAgD,aAAa,EAAE,CAAC,CAAA;QACtK,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC,IAAI,CAAC,CAAA;QAC9E,MAAM,QAAQ,GAAG,IAAI,KAAK,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;QACzE,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QAC5D,IAAI,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,QAAQ,IAAI,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,QAAQ,EAAE,cAAc,CAAC;YAAE,SAAS,GAAG,KAAK,CAAA;QAC5J,KAAK,MAAM,QAAQ,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,oBAAoB,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC9F,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;gBACrG,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,OAAO,QAAQ,+BAA+B,QAAQ,iDAAiD,CAAC,CAAA;YACtJ,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,cAAc,CAAC,EAAE,CAAC;gBACzE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,OAAO,QAAQ,+BAA+B,QAAQ,iDAAiD,CAAC,CAAA;YACtJ,CAAC;YACD,SAAQ;QACV,CAAC;QACD,eAAe,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;QAC7B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,KAAK,SAAS,CAAA;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,eAAe,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAA;IACnG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,CAAA;AAC5F,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,IAAY;IACvD,6EAA6E;IAC7E,yEAAyE;IACzE,yEAAyE;IACzE,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACvB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC,CAAA;QACpF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;YACvD,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI;gBAAE,OAAO,QAAQ,CAAC,OAAO,CAAA;QACrD,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,SAAS,CAAA;QACrC,IAAI,GAAG,MAAM,CAAA;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW,EAAE,cAA8B;IACnF,MAAM,IAAI,OAAO,CAAO,CAAC,cAAc,EAAE,MAAM,EAAE,EAAE;QACjD,2FAA2F;QAC3F,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;QAClF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QACzB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,cAAc,oBAAoB,IAAI,+BAA+B,cAAc,eAAe,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAA;IAC/M,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAA;IAC5F,MAAM,IAAI,KAAK,CAAC,gCAAgC,KAAK,gCAAgC,CAAC,CAAA;AACxF,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,GAAW,EAAE,QAA4B;IAC3E,IAAI,QAAQ;QAAE,OAAO,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IACtE,MAAM,SAAS,GAAoC,CAAC,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/K,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC/I,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,EAAwB,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,CAAA;IAC7F,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAA;IAC1H,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,oBAAoB,EAAE,CAAA;AAC9C,CAAC"}

package/dist/registry/files.d.ts

@@ -0,0 +1,4 @@
+/** Reject symlinks even within the project: installation should never write through one. */
+export declare function assertProjectPath(root: string, path: string): Promise<void>;
+export declare function readOptional(path: string): Promise<string | undefined>;
+//# sourceMappingURL=files.d.ts.map

package/dist/registry/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/registry/files.ts"],"names":[],"mappings":"AAGA,4FAA4F;AAC5F,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBjF;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAK5E"}

package/dist/registry/files.js

@@ -0,0 +1,33 @@
+import { lstat, readFile } from 'node:fs/promises';
+import { isAbsolute, relative, resolve, sep } from 'node:path';
+/** Reject symlinks even within the project: installation should never write through one. */
+export async function assertProjectPath(root, path) {
+    const absoluteRoot = resolve(root);
+    const absolutePath = resolve(path);
+    const suffix = relative(absoluteRoot, absolutePath);
+    if (!suffix || suffix === '..' || suffix.startsWith(`..${sep}`) || isAbsolute(suffix)) {
+        throw new Error(`Path must stay inside the project: ${path}`);
+    }
+    let current = absoluteRoot;
+    for (const part of suffix.split(sep)) {
+        current = resolve(current, part);
+        const stat = await lstat(current).catch((error) => {
+            if (isMissing(error))
+                return undefined;
+            throw error;
+        });
+        if (stat?.isSymbolicLink())
+            throw new Error(`Refusing a symlink in registry path: ${current}`);
+    }
+}
+export async function readOptional(path) {
+    return readFile(path, 'utf8').catch((error) => {
+        if (isMissing(error))
+            return undefined;
+        throw error;
+    });
+}
+function isMissing(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+//# sourceMappingURL=files.js.map

package/dist/registry/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/registry/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AAE9D,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAAY;IAChE,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;IACnD,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACtF,MAAM,IAAI,KAAK,CAAC,sCAAsC,IAAI,EAAE,CAAC,CAAA;IAC/D,CAAC;IACD,IAAI,OAAO,GAAG,YAAY,CAAA;IAC1B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QAChC,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACzD,IAAI,SAAS,CAAC,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAA;YACtC,MAAM,KAAK,CAAA;QACb,CAAC,CAAC,CAAA;QACF,IAAI,IAAI,EAAE,cAAc,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,OAAO,EAAE,CAAC,CAAA;IAChG,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QACrD,IAAI,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAA;QACtC,MAAM,KAAK,CAAA;IACb,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAA;AAC7E,CAAC"}

package/dist/registry/install.d.ts

@@ -0,0 +1,55 @@
+import type { PackageManager } from '../runtime/deps.js';
+import { type RegistryItem } from './model.js';
+export interface PlannedFile {
+    path: string;
+    content: string;
+    original?: string;
+}
+export interface InstallPlan {
+    cwd: string;
+    template: {
+        name: string;
+        version: string;
+        origin: string;
+    };
+    files: PlannedFile[];
+    dependencies: string[];
+    packageManager: PackageManager;
+    noInstall: boolean;
+    withTests: boolean;
+    alreadyInstalled: boolean;
+    installRequired: boolean;
+}
+export declare function planInstallation(input: {
+    cwd: string;
+    item: RegistryItem;
+    origin: string;
+    cliVersion: string;
+    path?: string;
+    configPath?: string;
+    packageManager?: PackageManager;
+    noInstall?: boolean;
+    withTests?: boolean;
+}): Promise<InstallPlan>;
+export declare function applyInstallation(plan: InstallPlan, deps?: {
+    install?: (cwd: string, packageManager: PackageManager) => Promise<void>;
+}): Promise<void>;
+export declare function describePlan(plan: InstallPlan): {
+    template: {
+        name: string;
+        version: string;
+        origin: string;
+    };
+    files: {
+        path: string;
+        action: string;
+        content: string;
+    }[];
+    dependencies: string[];
+    packageManager: PackageManager;
+    noInstall: boolean;
+    withTests: boolean;
+    alreadyInstalled: boolean;
+    installRequired: boolean;
+};
+//# sourceMappingURL=install.d.ts.map