@noodleseed/one 0.156.0 → 0.158.0

package/dist/project-bootstrap-install.d.ts

@@ -0,0 +1,14 @@
+import { type ProjectPackageManager } from './project-toolchain.js';
+/** Inspect dependency metadata only; never read dotenv files or return raw parse errors. */
+export declare function readBootstrapManifest(project: string): {
+    packageManager?: string | undefined;
+    dependencies?: Record<string, string> | undefined;
+    devDependencies?: Record<string, string> | undefined;
+    scripts?: Record<string, string> | undefined;
+} | undefined;
+export declare function bootstrapLockfiles(project: string): string[];
+export declare function bootstrapDependencyFingerprint(project: string): string;
+/** The dependency must be installed in this project, not discovered through a parent/global fallback. */
+export declare function installedBootstrapCli(project: string, version: string): string | undefined;
+export declare function hasCompletedBootstrapLock(project: string, manager: ProjectPackageManager): boolean;
+//# sourceMappingURL=project-bootstrap-install.d.ts.map

package/dist/project-bootstrap-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-bootstrap-install.d.ts","sourceRoot":"","sources":["../src/project-bootstrap-install.ts"],"names":[],"mappings":"AAIA,OAAO,EAAqB,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AASvF,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM;;;;;cAYpD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAa5D;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAWtE;AAED,yGAAyG;AACzG,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAe1F;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAIT"}

package/dist/project-bootstrap-install.js

@@ -0,0 +1,73 @@
+import { createHash } from 'node:crypto';
+import { lstatSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { PROJECT_LOCKFILES } from './project-toolchain.js';
+const manifestSchema = z.object({
+    packageManager: z.string().optional(),
+    dependencies: z.record(z.string(), z.string()).optional(),
+    devDependencies: z.record(z.string(), z.string()).optional(),
+    scripts: z.record(z.string(), z.string()).optional(),
+});
+/** Inspect dependency metadata only; never read dotenv files or return raw parse errors. */
+export function readBootstrapManifest(project) {
+    const file = join(project, 'package.json');
+    try {
+        const stat = lstatSync(file);
+        if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 1024 * 1024)
+            throw new Error();
+        return manifestSchema.parse(JSON.parse(readFileSync(file, 'utf8')));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw new Error('Project package.json is unreadable or invalid; preserve and repair it before setup.');
+    }
+}
+export function bootstrapLockfiles(project) {
+    return Object.keys(PROJECT_LOCKFILES).filter((name) => {
+        try {
+            const stat = lstatSync(join(project, name));
+            if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 8 * 1024 * 1024)
+                throw new Error();
+            return true;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return false;
+            throw new Error('Project lockfile is unreadable or unsafe; preserve and repair it before setup.');
+        }
+    });
+}
+export function bootstrapDependencyFingerprint(project) {
+    const hash = createHash('sha256');
+    readBootstrapManifest(project);
+    for (const name of ['package.json', ...bootstrapLockfiles(project).sort()]) {
+        hash
+            .update(name)
+            .update('\0')
+            .update(readFileSync(join(project, name)))
+            .update('\0');
+    }
+    return hash.digest('hex');
+}
+/** The dependency must be installed in this project, not discovered through a parent/global fallback. */
+export function installedBootstrapCli(project, version) {
+    const root = join(project, 'node_modules/@noodleseed/one');
+    try {
+        const raw = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
+        if (raw.name !== '@noodleseed/one' ||
+            raw.version !== version ||
+            raw.bin?.noodle !== 'dist/bin.js')
+            return undefined;
+        const bin = join(root, 'dist/bin.js');
+        return lstatSync(bin).isFile() ? bin : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function hasCompletedBootstrapLock(project, manager) {
+    return bootstrapLockfiles(project).some((name) => PROJECT_LOCKFILES[name] === manager && lstatSync(join(project, name)).size > 0);
+}
+//# sourceMappingURL=project-bootstrap-install.js.map

package/dist/project-bootstrap-install.js.map

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

package/dist/project-bootstrap-launch.d.ts

@@ -0,0 +1,27 @@
+import { spawn } from 'node:child_process';
+import type { AgentTarget } from '@noodle-borg/agent-kit';
+export type BootstrapLaunchTarget = AgentTarget | 'none';
+type LaunchResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly code: 'missing_executable' | 'command_failed';
+};
+type LaunchChild = Pick<ReturnType<typeof spawn>, 'once'>;
+type LaunchSpawn = (command: string, args: string[], options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    stdio: 'inherit';
+}) => LaunchChild;
+export declare function isRunningCodingAgent(env: NodeJS.ProcessEnv): boolean;
+/** Offered only after a new project passes; cancelling keeps the ready project intact. */
+export declare function chooseBootstrapAgent(agents: readonly AgentTarget[], env: NodeJS.ProcessEnv): Promise<BootstrapLaunchTarget>;
+export declare function assertBootstrapLaunchAllowed(target: BootstrapLaunchTarget, agents: readonly AgentTarget[], interactive: boolean, env: NodeJS.ProcessEnv, install: boolean): void;
+export declare function bootstrapLaunchCommand(target: AgentTarget): {
+    command: string;
+    args: string[];
+};
+/** Explicit interactive handoff. No install, shell, saved-session reuse, model or permission override. */
+export declare function launchBootstrapAgent(target: AgentTarget, project: string, env: NodeJS.ProcessEnv, spawnAgent?: LaunchSpawn): Promise<LaunchResult>;
+export {};
+//# sourceMappingURL=project-bootstrap-launch.d.ts.map

package/dist/project-bootstrap-launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-bootstrap-launch.d.ts","sourceRoot":"","sources":["../src/project-bootstrap-launch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAI1D,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG,MAAM,CAAC;AACzD,KAAK,YAAY,GACb;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CAAA;CAAE,CAAC;AACnF,KAAK,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AAC1D,KAAK,WAAW,GAAG,CACjB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,KAC/D,WAAW,CAAC;AAEjB,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAEpE;AAED,0FAA0F;AAC1F,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAAC,qBAAqB,CAAC,CA4BhC;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,WAAW,EAAE,OAAO,EACpB,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,OAAO,EAAE,OAAO,GACf,IAAI,CAkBN;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAO/F;AAED,0GAA0G;AAC1G,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,UAAU,GAAE,WAAmB,GAC9B,OAAO,CAAC,YAAY,CAAC,CAavB"}

package/dist/project-bootstrap-launch.js

@@ -0,0 +1,64 @@
+import { spawn } from 'node:child_process';
+import { commandOnPath } from './agent-command-context.js';
+import { confirm, select } from './prompts.js';
+export function isRunningCodingAgent(env) {
+    return Boolean(env.NOODLE_PLUGIN_HOST || env.CODEX_THREAD_ID || env.CLAUDECODE);
+}
+/** Offered only after a new project passes; cancelling keeps the ready project intact. */
+export async function chooseBootstrapAgent(agents, env) {
+    const detected = agents.filter((target) => commandOnPath(target === 'codex' ? 'codex' : 'claude', env));
+    if (!detected.length)
+        return 'none';
+    try {
+        const choices = [
+            ...detected.map((target) => ({
+                value: target,
+                label: target === 'codex' ? 'Codex' : 'Claude Code',
+            })),
+            { value: 'none', label: 'Not now' },
+        ];
+        const choice = await select('Local checks passed. Start a fresh coding-agent session?', choices, { initial: choices.length - 1 });
+        if (choice === 'none')
+            return 'none';
+        return (await confirm('Start the selected installed agent in this project with its normal permissions?', { initial: false }))
+            ? choice
+            : 'none';
+    }
+    catch {
+        return 'none';
+    }
+}
+export function assertBootstrapLaunchAllowed(target, agents, interactive, env, install) {
+    if (target === 'none')
+        return;
+    if (!interactive)
+        throw new Error('Fresh agent launch requires an interactive terminal; omit --launch in JSON/CI.');
+    if (isRunningCodingAgent(env))
+        throw new Error('Do not launch recursively from a running agent; read the new project context or start a fresh session yourself.');
+    if (!agents.includes(target))
+        throw new Error('Fresh agent launch requires its generated context; include the selected --agents target.');
+    if (!install)
+        throw new Error('Fresh agent launch requires completed local verification; remove --no-install.');
+}
+export function bootstrapLaunchCommand(target) {
+    return {
+        command: target === 'codex' ? 'codex' : 'claude',
+        args: [
+            'Read AGENTS.md, the Noodle project skill and its routed references, and the generated project README before doing anything. Local synthetic starter checks have passed; the real customer application and hosted deployment are not verified. Do not read secrets or assume production permissions. Ask me which existing application and end-user workflow to integrate, then reuse the maintained recipes and their acceptance tests.',
+        ],
+    };
+}
+/** Explicit interactive handoff. No install, shell, saved-session reuse, model or permission override. */
+export function launchBootstrapAgent(target, project, env, spawnAgent = spawn) {
+    const command = bootstrapLaunchCommand(target);
+    return new Promise((resolve) => {
+        const child = spawnAgent(command.command, command.args, {
+            cwd: project,
+            env,
+            stdio: 'inherit',
+        });
+        child.once('error', () => resolve({ ok: false, code: 'missing_executable' }));
+        child.once('close', (code) => resolve(code === 0 ? { ok: true } : { ok: false, code: 'command_failed' }));
+    });
+}
+//# sourceMappingURL=project-bootstrap-launch.js.map

package/dist/project-bootstrap-launch.js.map

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

package/dist/project-bootstrap-process.d.ts

@@ -0,0 +1,19 @@
+export type BootstrapProcessCode = 'command_failed' | 'command_timeout' | 'missing_executable' | 'cancelled';
+export type BootstrapProcessResult = {
+    readonly ok: true;
+    readonly stdout: string;
+} | {
+    readonly ok: false;
+    readonly code: BootstrapProcessCode;
+    readonly stdout: '';
+};
+export interface BootstrapProcessOptions {
+    readonly cwd: string;
+    readonly env: NodeJS.ProcessEnv;
+    readonly timeoutMs?: number;
+    readonly maxOutputBytes?: number;
+}
+export type BootstrapExecutor = (command: string, args: readonly string[], options: BootstrapProcessOptions) => Promise<BootstrapProcessResult>;
+/** No shell, bounded output/time, and no failed stdout/stderr reflected into recovery data. */
+export declare const runBootstrapProcess: BootstrapExecutor;
+//# sourceMappingURL=project-bootstrap-process.d.ts.map

package/dist/project-bootstrap-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-bootstrap-process.d.ts","sourceRoot":"","sources":["../src/project-bootstrap-process.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAC5B,gBAAgB,GAChB,iBAAiB,GACjB,oBAAoB,GACpB,WAAW,CAAC;AAChB,MAAM,MAAM,sBAAsB,GAC9B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAA;CAAE,CAAC;AACrF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AACD,MAAM,MAAM,iBAAiB,GAAG,CAC9B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,uBAAuB,KAC7B,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErC,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,EAAE,iBAuD9B,CAAC"}

package/dist/project-bootstrap-process.js

@@ -0,0 +1,60 @@
+import { spawn } from 'node:child_process';
+/** No shell, bounded output/time, and no failed stdout/stderr reflected into recovery data. */
+export const runBootstrapProcess = (command, args, options) => new Promise((resolve) => {
+    const child = spawn(command, [...args], {
+        cwd: options.cwd,
+        env: options.env,
+        detached: true,
+        stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    let done = false;
+    let stopped;
+    let output = '';
+    let bytes = 0;
+    let force;
+    const kill = (signal) => {
+        if (child.pid !== undefined) {
+            // Signal only the process group we created, including ordinary child processes.
+            try {
+                process.kill(-child.pid, signal);
+            }
+            catch { }
+        }
+    };
+    const stop = (code) => {
+        if (stopped || done)
+            return;
+        stopped = code;
+        kill('SIGTERM');
+        force = setTimeout(() => kill('SIGKILL'), 1_000);
+    };
+    const timer = setTimeout(() => stop('command_timeout'), options.timeoutMs ?? 180_000);
+    const interrupt = () => stop('cancelled');
+    process.once('SIGINT', interrupt);
+    process.once('SIGTERM', interrupt);
+    const finish = (result) => {
+        if (done)
+            return;
+        done = true;
+        clearTimeout(timer);
+        if (force)
+            clearTimeout(force);
+        process.removeListener('SIGINT', interrupt);
+        process.removeListener('SIGTERM', interrupt);
+        resolve(result);
+    };
+    const capture = (chunk, stdout) => {
+        bytes += chunk.byteLength;
+        if (bytes > (options.maxOutputBytes ?? 1024 * 1024))
+            stop('command_failed');
+        else if (stdout && !stopped)
+            output += chunk.toString('utf8');
+    };
+    child.stdout?.on('data', (chunk) => capture(chunk, true));
+    child.stderr?.on('data', (chunk) => capture(chunk, false));
+    child.once('error', () => finish({ ok: false, code: 'missing_executable', stdout: '' }));
+    child.once('close', (code) => finish(code === 0 && !stopped
+        ? { ok: true, stdout: output }
+        : { ok: false, code: stopped ?? 'command_failed', stdout: '' }));
+});
+//# sourceMappingURL=project-bootstrap-process.js.map

package/dist/project-bootstrap-process.js.map

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

package/dist/project-bootstrap-report.d.ts

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import type { NextCommand } from './commands/output.js';
+/** Shared, bounded progress projection: no customer values, child logs, or arbitrary commands. */
+export declare const bootstrapStatusSchema: z.ZodObject<{
+    ready: z.ZodBoolean;
+    packageManager: z.ZodEnum<{
+        npm: "npm";
+        pnpm: "pnpm";
+        yarn: "yarn";
+    }>;
+    completed: z.ZodReadonly<z.ZodArray<z.ZodEnum<{
+        context: "context";
+        behavior: "behavior";
+        validate: "validate";
+        install: "install";
+        scaffold: "scaffold";
+        types: "types";
+        launch: "launch";
+    }>>>;
+    failed: z.ZodOptional<z.ZodObject<{
+        stage: z.ZodEnum<{
+            context: "context";
+            behavior: "behavior";
+            validate: "validate";
+            install: "install";
+            scaffold: "scaffold";
+            types: "types";
+            launch: "launch";
+        }>;
+        code: z.ZodEnum<{
+            command_failed: "command_failed";
+            cancelled: "cancelled";
+            missing_executable: "missing_executable";
+            command_timeout: "command_timeout";
+            context_invalid: "context_invalid";
+            verification_failed: "verification_failed";
+            dependency_mismatch: "dependency_mismatch";
+            configuration_conflict: "configuration_conflict";
+            package_manager_unsupported: "package_manager_unsupported";
+        }>;
+    }, z.core.$strict>>;
+    restartRequired: z.ZodBoolean;
+    proof: z.ZodEnum<{
+        unverified: "unverified";
+        "local-synthetic": "local-synthetic";
+    }>;
+}, z.core.$strip>;
+export type BootstrapStatus = z.infer<typeof bootstrapStatusSchema>;
+export interface BootstrapReport extends BootstrapStatus {
+    readonly resumeCommand: string;
+    readonly nextSteps: readonly NextCommand[];
+}
+/** A zero exit code alone is not the CLI's machine-readable success contract. */
+export declare function bootstrapJsonSucceeded(stdout: string): boolean;
+//# sourceMappingURL=project-bootstrap-report.d.ts.map

package/dist/project-bootstrap-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-bootstrap-report.d.ts","sourceRoot":"","sources":["../src/project-bootstrap-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,kGAAkG;AAClG,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoB/B,CAAC;AACJ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;CAC5C;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAO9D"}

package/dist/project-bootstrap-report.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { BOOTSTRAP_STAGES, bootstrapFailureSchema } from './project-bootstrap-state.js';
+/** Shared, bounded progress projection: no customer values, child logs, or arbitrary commands. */
+export const bootstrapStatusSchema = z
+    .object({
+    ready: z.boolean(),
+    packageManager: z.enum(['npm', 'pnpm', 'yarn']),
+    completed: z.array(z.enum(BOOTSTRAP_STAGES)).max(BOOTSTRAP_STAGES.length).readonly(),
+    failed: bootstrapFailureSchema.optional(),
+    restartRequired: z.boolean(),
+    proof: z.enum(['local-synthetic', 'unverified']),
+})
+    .refine((status) => new Set(status.completed).size === status.completed.length &&
+    (!status.failed || !status.completed.includes(status.failed.stage)) &&
+    (status.ready
+        ? status.proof === 'local-synthetic' &&
+            ['scaffold', 'install', 'validate', 'behavior', 'types'].every((stage) => status.completed.some((value) => value === stage)) &&
+            !status.failed
+        : status.proof === 'unverified'));
+/** A zero exit code alone is not the CLI's machine-readable success contract. */
+export function bootstrapJsonSucceeded(stdout) {
+    try {
+        const value = JSON.parse(stdout);
+        return typeof value === 'object' && value !== null && 'ok' in value && value.ok === true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=project-bootstrap-report.js.map

package/dist/project-bootstrap-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-bootstrap-report.js","sourceRoot":"","sources":["../src/project-bootstrap-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAExF,kGAAkG;AAClG,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE;IAClB,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IACpF,MAAM,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IACzC,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE;IAC5B,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;CACjD,CAAC;KACD,MAAM,CACL,CAAC,MAAM,EAAE,EAAE,CACT,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,SAAS,CAAC,MAAM;IAC1D,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC,MAAM,CAAC,KAAK;QACX,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,iBAAiB;YAClC,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CACvE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,CAClD;YACD,CAAC,MAAM,CAAC,MAAM;QAChB,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,YAAY,CAAC,CACrC,CAAC;AAOJ,iFAAiF;AACjF,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACnD,IAAI,CAAC;QACH,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC;IAC3F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/project-bootstrap-state.d.ts

@@ -0,0 +1,87 @@
+import { z } from 'zod';
+export declare const BOOTSTRAP_STAGES: readonly ["scaffold", "install", "context", "validate", "behavior", "types", "launch"];
+export type BootstrapStage = (typeof BOOTSTRAP_STAGES)[number];
+export declare const bootstrapFailureSchema: z.ZodObject<{
+    stage: z.ZodEnum<{
+        context: "context";
+        behavior: "behavior";
+        validate: "validate";
+        install: "install";
+        scaffold: "scaffold";
+        types: "types";
+        launch: "launch";
+    }>;
+    code: z.ZodEnum<{
+        command_failed: "command_failed";
+        cancelled: "cancelled";
+        missing_executable: "missing_executable";
+        command_timeout: "command_timeout";
+        context_invalid: "context_invalid";
+        verification_failed: "verification_failed";
+        dependency_mismatch: "dependency_mismatch";
+        configuration_conflict: "configuration_conflict";
+        package_manager_unsupported: "package_manager_unsupported";
+    }>;
+}, z.core.$strict>;
+declare const stateSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    cliVersion: z.ZodString;
+    packageManager: z.ZodEnum<{
+        npm: "npm";
+        pnpm: "pnpm";
+        yarn: "yarn";
+    }>;
+    managerVersion: z.ZodOptional<z.ZodString>;
+    launchedAgent: z.ZodOptional<z.ZodEnum<{
+        codex: "codex";
+        "claude-code": "claude-code";
+    }>>;
+    completed: z.ZodArray<z.ZodEnum<{
+        context: "context";
+        behavior: "behavior";
+        validate: "validate";
+        install: "install";
+        scaffold: "scaffold";
+        types: "types";
+        launch: "launch";
+    }>>;
+    inProgress: z.ZodOptional<z.ZodEnum<{
+        context: "context";
+        behavior: "behavior";
+        validate: "validate";
+        install: "install";
+        scaffold: "scaffold";
+        types: "types";
+        launch: "launch";
+    }>>;
+    failed: z.ZodOptional<z.ZodObject<{
+        stage: z.ZodEnum<{
+            context: "context";
+            behavior: "behavior";
+            validate: "validate";
+            install: "install";
+            scaffold: "scaffold";
+            types: "types";
+            launch: "launch";
+        }>;
+        code: z.ZodEnum<{
+            command_failed: "command_failed";
+            cancelled: "cancelled";
+            missing_executable: "missing_executable";
+            command_timeout: "command_timeout";
+            context_invalid: "context_invalid";
+            verification_failed: "verification_failed";
+            dependency_mismatch: "dependency_mismatch";
+            configuration_conflict: "configuration_conflict";
+            package_manager_unsupported: "package_manager_unsupported";
+        }>;
+    }, z.core.$strict>>;
+    dependencyFingerprint: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type BootstrapState = Readonly<Omit<z.infer<typeof stateSchema>, 'completed'>> & {
+    readonly completed: readonly BootstrapStage[];
+};
+export declare function readBootstrapState(project: string): BootstrapState | undefined;
+export declare function writeBootstrapState(project: string, state: BootstrapState): void;
+export {};
+//# sourceMappingURL=project-bootstrap-state.d.ts.map

package/dist/project-bootstrap-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-bootstrap-state.d.ts","sourceRoot":"","sources":["../src/project-bootstrap-state.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB,wFAQnB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;kBAajC,CAAC;AAKH,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAqBd,CAAC;AACJ,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG;IACtF,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;CAC/C,CAAC;AAgBF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CA4B9E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAgBhF"}

package/dist/project-bootstrap-state.js

@@ -0,0 +1,125 @@
+import { randomBytes } from 'node:crypto';
+import { closeSync, constants, fstatSync, lstatSync, mkdirSync, openSync, readSync, renameSync, rmSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+export const BOOTSTRAP_STAGES = [
+    'scaffold',
+    'install',
+    'context',
+    'validate',
+    'behavior',
+    'types',
+    'launch',
+];
+const stageSchema = z.enum(BOOTSTRAP_STAGES);
+export const bootstrapFailureSchema = z.strictObject({
+    stage: stageSchema,
+    code: z.enum([
+        'command_failed',
+        'command_timeout',
+        'missing_executable',
+        'context_invalid',
+        'verification_failed',
+        'dependency_mismatch',
+        'configuration_conflict',
+        'package_manager_unsupported',
+        'cancelled',
+    ]),
+});
+const versionSchema = z
+    .string()
+    .max(128)
+    .regex(/^\d+\.\d+\.\d+(?:[-+][\w.+-]+)?$/);
+const stateSchema = z
+    .object({
+    schemaVersion: z.literal(1),
+    cliVersion: versionSchema,
+    packageManager: z.enum(['npm', 'pnpm', 'yarn']),
+    managerVersion: versionSchema.optional(),
+    launchedAgent: z.enum(['codex', 'claude-code']).optional(),
+    completed: z.array(stageSchema).max(BOOTSTRAP_STAGES.length),
+    inProgress: stageSchema.optional(),
+    failed: bootstrapFailureSchema.optional(),
+    dependencyFingerprint: z
+        .string()
+        .regex(/^[a-f0-9]{64}$/)
+        .optional(),
+})
+    .strict()
+    .refine((state) => new Set(state.completed).size === state.completed.length &&
+    (!state.inProgress || !state.completed.includes(state.inProgress)) &&
+    (!state.failed || !state.completed.includes(state.failed.stage)));
+const MAX_STATE_BYTES = 16 * 1024;
+const stateError = () => new Error('Bootstrap state is unreadable or not owned by this setup format.');
+function stateDirectory(project) {
+    const path = join(project, '.noodle');
+    try {
+        const stat = lstatSync(path);
+        if (!stat.isDirectory() || stat.isSymbolicLink())
+            throw stateError();
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw stateError();
+    }
+    return path;
+}
+export function readBootstrapState(project) {
+    let descriptor;
+    try {
+        const path = join(stateDirectory(project), 'setup.json');
+        try {
+            descriptor = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return undefined;
+            throw stateError();
+        }
+        const stat = fstatSync(descriptor);
+        if (!stat.isFile() || stat.size > MAX_STATE_BYTES)
+            throw stateError();
+        const buffer = Buffer.alloc(MAX_STATE_BYTES + 1);
+        let length = 0;
+        while (length < buffer.length) {
+            const count = readSync(descriptor, buffer, length, buffer.length - length, length);
+            if (count === 0)
+                break;
+            length += count;
+        }
+        if (length > MAX_STATE_BYTES)
+            throw stateError();
+        const parsed = stateSchema.safeParse(JSON.parse(buffer.subarray(0, length).toString('utf8')));
+        if (!parsed.success)
+            throw stateError();
+        return parsed.data;
+    }
+    catch {
+        throw stateError();
+    }
+    finally {
+        if (descriptor !== undefined)
+            closeSync(descriptor);
+    }
+}
+export function writeBootstrapState(project, state) {
+    const parsed = stateSchema.safeParse(state);
+    if (!parsed.success)
+        throw stateError();
+    // A malformed/unowned existing record is never treated as permission to replace it.
+    readBootstrapState(project);
+    const directory = stateDirectory(project);
+    mkdirSync(directory, { recursive: true, mode: 0o700 });
+    const temporary = join(directory, `.setup-${randomBytes(12).toString('hex')}.tmp`);
+    try {
+        writeFileSync(temporary, `${JSON.stringify(parsed.data)}\n`, { mode: 0o600, flag: 'wx' });
+        renameSync(temporary, join(directory, 'setup.json'));
+    }
+    catch {
+        throw stateError();
+    }
+    finally {
+        rmSync(temporary, { force: true });
+    }
+}
+//# sourceMappingURL=project-bootstrap-state.js.map

package/dist/project-bootstrap-state.js.map

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