yuurei 0.0.1

package/dist/cli/doctor.js

@@ -0,0 +1,160 @@
+import { access, constants, mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { listRuntimeIds, getRuntime } from '../runtime/registry.js';
+import { findOrphanTempDirs } from '../isolation/tempdir.js';
+/**
+ * `yuurei doctor` — inspection only, never mutates the environment
+ * (design doc §8.1). Authentication is reported only when an installed
+ * runtime has credentials available through its supported default path.
+ */
+export async function runDoctor(options) {
+    const runtimes = [];
+    for (const runtimeId of listRuntimeIds()) {
+        const detection = await getRuntime(runtimeId).detect();
+        runtimes.push({
+            runtimeId,
+            installed: detection.installed,
+            version: detection.version,
+            versionSupported: detection.versionSupported,
+            authUsable: detection.authUsable,
+            ...(detection.authGuidance !== undefined ? { authGuidance: detection.authGuidance } : {}),
+        });
+    }
+    return {
+        runtimes,
+        canWriteOutputDir: await canWriteToTempDir(),
+        orphanTempDirs: await findOrphanTempDirs(options?.tempDir === undefined ? undefined : { root: options.tempDir }),
+    };
+}
+export function printDoctorReport(report, logger, format) {
+    if (format === 'json') {
+        printDoctorReportJson(report, logger);
+        return;
+    }
+    printDoctorReportHuman(report, logger);
+}
+/**
+ * Machine-readable path: one JSON object per line, `level` + `message` plus
+ * the runtime/guidance/orphan data as top-level keys. This is the schema
+ * scripts rely on and must not change (issue #103).
+ */
+function printDoctorReportJson(report, logger) {
+    for (const runtime of report.runtimes) {
+        logger.info(`${runtime.runtimeId}: ${runtime.installed ? 'installed' : 'not found'}`, {
+            version: runtime.version,
+            versionSupported: runtime.versionSupported,
+            authUsable: runtime.authUsable,
+        });
+        if (runtime.installed && runtime.authUsable === false && runtime.authGuidance !== undefined) {
+            logger.warn(`${runtime.runtimeId}: authentication required — next steps`, {
+                authGuidance: runtime.authGuidance,
+            });
+        }
+    }
+    logger.info(`output directory writable: ${report.canWriteOutputDir}`);
+    if (report.orphanTempDirs.length === 0) {
+        logger.info('no orphaned isolation temp directories found');
+    }
+    else {
+        logger.warn(`found ${report.orphanTempDirs.length} orphaned isolation temp director${report.orphanTempDirs.length === 1 ? 'y' : 'ies'}; run "yuurei clean" to remove them`, { paths: report.orphanTempDirs.map((orphan) => orphan.path) });
+    }
+}
+/**
+ * Human-readable path: one compact status block per runtime, warnings marked
+ * with a `WARNING:` prefix so they stand out from successful checks, orphan
+ * paths listed one per line after the count and cleanup command. Never prints
+ * credential values — only the runtime-provided guidance text.
+ */
+function printDoctorReportHuman(report, logger) {
+    for (const runtime of report.runtimes) {
+        printRuntimeBlock(runtime, logger);
+        logger.info('');
+    }
+    if (report.canWriteOutputDir) {
+        logger.info('output directory');
+        logger.info(`${HUMAN_INDENT}writable: yes`);
+    }
+    else {
+        logger.warn('WARNING: output directory is not writable');
+    }
+    if (report.orphanTempDirs.length === 0) {
+        logger.info('no orphaned isolation temp directories found');
+    }
+    else {
+        const noun = report.orphanTempDirs.length === 1 ? 'directory' : 'directories';
+        logger.warn(`WARNING: found ${report.orphanTempDirs.length} orphaned isolation temp ${noun}`);
+        logger.warn(`${HUMAN_INDENT}Run "yuurei clean" to remove them.`);
+        for (const orphan of report.orphanTempDirs) {
+            logger.warn(`${HUMAN_INDENT}${orphan.path}`);
+        }
+    }
+}
+function printRuntimeBlock(runtime, logger) {
+    logger.info(runtime.runtimeId);
+    if (!runtime.installed) {
+        logger.info(`${HUMAN_INDENT}status: not found`);
+        return;
+    }
+    logger.info(`${HUMAN_INDENT}status: installed`);
+    if (runtime.version !== null) {
+        logger.info(`${HUMAN_INDENT}version: ${runtime.version}`);
+    }
+    if (runtime.versionSupported !== null) {
+        if (runtime.versionSupported) {
+            logger.info(`${HUMAN_INDENT}supported: yes`);
+        }
+        else {
+            logger.warn(`${HUMAN_INDENT}WARNING: supported: no — upgrade this runtime to a supported version`);
+        }
+    }
+    if (runtime.authUsable === true) {
+        logger.info(`${HUMAN_INDENT}authentication: ready`);
+    }
+    else if (runtime.authUsable === false) {
+        logger.warn(`${HUMAN_INDENT}WARNING: authentication: required`);
+        if (runtime.authGuidance !== undefined) {
+            for (const line of wrapText(runtime.authGuidance, HUMAN_LINE_WIDTH - HUMAN_SUB_INDENT.length)) {
+                logger.warn(`${HUMAN_SUB_INDENT}${line}`);
+            }
+        }
+    }
+    else {
+        logger.info(`${HUMAN_INDENT}authentication: not checked`);
+    }
+}
+const HUMAN_LINE_WIDTH = 80;
+const HUMAN_INDENT = '  ';
+const HUMAN_SUB_INDENT = '    ';
+/** Wraps a paragraph at word boundaries to `maxWidth` columns. */
+function wrapText(text, maxWidth) {
+    const lines = [];
+    let current = '';
+    for (const word of text.split(/\s+/)) {
+        if (current.length === 0) {
+            current = word;
+        }
+        else if (current.length + 1 + word.length <= maxWidth) {
+            current += ` ${word}`;
+        }
+        else {
+            lines.push(current);
+            current = word;
+        }
+    }
+    if (current.length > 0)
+        lines.push(current);
+    return lines;
+}
+async function canWriteToTempDir() {
+    try {
+        const dir = await mkdtemp(join(tmpdir(), 'yuurei-doctor-'));
+        await access(dir, constants.W_OK);
+        await rm(dir, { recursive: true, force: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/exit-codes.d.ts

@@ -0,0 +1,15 @@
+/** Exit codes from design doc §8.1. */
+export declare const EXIT_CODES: {
+    readonly SUCCESS: 0;
+    readonly CONFIG_ERROR: 2;
+    readonly RUNTIME_UNSUPPORTED: 3;
+    readonly ISOLATION_VERIFICATION_FAILED: 4;
+    readonly RUNTIME_EXECUTION_FAILED: 5;
+    readonly TRACE_OR_ARTIFACT_SAVE_FAILED: 6;
+};
+export type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];
+export declare class YuureiError extends Error {
+    readonly exitCode: ExitCode;
+    constructor(message: string, exitCode: ExitCode);
+}
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/cli/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/cli/exit-codes.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,eAAO,MAAM,UAAU;;;;;;;CAOb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEpE,qBAAa,WAAY,SAAQ,KAAK;aAGlB,QAAQ,EAAE,QAAQ;gBADlC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,QAAQ;CAKrC"}

package/dist/cli/exit-codes.js

@@ -0,0 +1,18 @@
+/** Exit codes from design doc §8.1. */
+export const EXIT_CODES = {
+    SUCCESS: 0,
+    CONFIG_ERROR: 2,
+    RUNTIME_UNSUPPORTED: 3,
+    ISOLATION_VERIFICATION_FAILED: 4,
+    RUNTIME_EXECUTION_FAILED: 5,
+    TRACE_OR_ARTIFACT_SAVE_FAILED: 6,
+};
+export class YuureiError extends Error {
+    exitCode;
+    constructor(message, exitCode) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = 'YuureiError';
+    }
+}
+//# sourceMappingURL=exit-codes.js.map

package/dist/cli/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/cli/exit-codes.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,CAAC;IACV,YAAY,EAAE,CAAC;IACf,mBAAmB,EAAE,CAAC;IACtB,6BAA6B,EAAE,CAAC;IAChC,wBAAwB,EAAE,CAAC;IAC3B,6BAA6B,EAAE,CAAC;CACxB,CAAC;AAIX,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGlB;IAFlB,YACE,OAAe,EACC,QAAkB;QAElC,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,aAAQ,GAAR,QAAQ,CAAU;QAGlC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/cli/init.d.ts

@@ -0,0 +1,32 @@
+import type { Logger } from '../util/logger.js';
+export interface InitOptions {
+    /** Directory to scaffold, relative to `cwd`. Use `''` for the current directory. */
+    directory: string;
+    runtime: string;
+    profile: string;
+    task: string;
+    /** Named run referencing the generated profile and task. Defaults to `task`. */
+    run?: string;
+    /** Emit the structured `InitReport` as the JSON output instead of the human report. */
+    json?: boolean;
+}
+/** Structured report for `yuurei init`, emitted on stdout when `--json` is set. */
+export interface InitReport {
+    targetDir: string;
+    /** False when the target was already a matching scaffold, so nothing was written. */
+    created: boolean;
+    /** Paths written (or verified to already match), relative to `targetDir`. */
+    scaffoldPaths: string[];
+    profile: string;
+    task: string;
+    run: string;
+}
+/**
+ * `yuurei init` — scaffolds a minimal runnable project (issue #105). Never
+ * overwrites an existing file: a preflight compares every planned file
+ * against what is on disk and aborts before writing when any differ. Writes
+ * stage into a sibling temp directory and rename into place, so an
+ * unexpected failure cannot leave a partial scaffold (§2.3 fail-safe).
+ */
+export declare function runInit(cwd: string, options: InitOptions, logger: Logger): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,oFAAoF;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,mFAAmF;AACnF,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,OAAO,EAAE,OAAO,CAAC;IACjB,6EAA6E;IAC7E,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAyGD;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0D9F"}

package/dist/cli/init.js

@@ -0,0 +1,143 @@
+import { mkdir, mkdtemp, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { listRuntimeIds } from '../runtime/registry.js';
+import { isPathWithin, pathExists } from '../util/fs.js';
+import { EXIT_CODES, YuureiError } from './exit-codes.js';
+const NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+function validateName(value, what) {
+    if (!NAME_PATTERN.test(value)) {
+        throw new YuureiError(`invalid ${what} "${value}": use letters, digits, ".", "_" and "-", starting with a letter or digit`, EXIT_CODES.CONFIG_ERROR);
+    }
+}
+const DEFAULT_TASK_PROMPT = 'Reply with "Hello from yuurei." Do not read or write any files or run commands.';
+function scaffoldFiles(options) {
+    const { runtime, profile, task } = options;
+    const run = options.run ?? task;
+    return [
+        {
+            relPath: '.yuurei/yuurei.yaml',
+            content: [
+                'version: 1',
+                '',
+                'profiles:',
+                `  ${profile}:`,
+                `    runtime: ${runtime}`,
+                `    source: ./profiles/${profile}`,
+                '',
+                'runs:',
+                `  ${run}:`,
+                `    profile: ${profile}`,
+                `    task: ./tasks/${task}.md`,
+                '',
+            ].join('\n'),
+        },
+        {
+            relPath: `.yuurei/profiles/${profile}/profile.yaml`,
+            content: [
+                `runtime: ${runtime}`,
+                `description: ${profile} profile scaffolded by yuurei init.`,
+                '',
+            ].join('\n'),
+        },
+        {
+            relPath: `.yuurei/profiles/${profile}/config/.gitkeep`,
+            content: '',
+        },
+        {
+            relPath: `.yuurei/tasks/${task}.md`,
+            content: `${DEFAULT_TASK_PROMPT}\n`,
+        },
+    ];
+}
+function displayPaths(options) {
+    const { profile, task } = options;
+    return [
+        '.yuurei/yuurei.yaml',
+        `.yuurei/profiles/${profile}/profile.yaml`,
+        `.yuurei/profiles/${profile}/config/.gitkeep`,
+        `.yuurei/tasks/${task}.md`,
+    ];
+}
+function buildInitReport(targetDir, options, created) {
+    return {
+        targetDir,
+        created,
+        scaffoldPaths: displayPaths(options),
+        profile: options.profile,
+        task: options.task,
+        run: options.run ?? options.task,
+    };
+}
+function printInitReport(report, options, logger) {
+    if (options.json) {
+        logger.info('init', { ...report });
+        return;
+    }
+    logger.info(report.created
+        ? `scaffolded project at ${report.targetDir}`
+        : `project already scaffolded at ${report.targetDir}`);
+    for (const pathName of report.scaffoldPaths) {
+        logger.info(pathName);
+    }
+    logger.info(`run "${report.run}" resolves to profile "${report.profile}" and task "${report.task}"`);
+    logger.info('next commands:');
+    logger.info('  yuurei profile list');
+    logger.info(`  yuurei inspect ${report.profile}`);
+    logger.info(`  yuurei run ${report.run}`);
+}
+/**
+ * `yuurei init` — scaffolds a minimal runnable project (issue #105). Never
+ * overwrites an existing file: a preflight compares every planned file
+ * against what is on disk and aborts before writing when any differ. Writes
+ * stage into a sibling temp directory and rename into place, so an
+ * unexpected failure cannot leave a partial scaffold (§2.3 fail-safe).
+ */
+export async function runInit(cwd, options, logger) {
+    // resolve() not join(): the operand may be absolute, and join() would then
+    // nest it under cwd (join('/work', '/tmp/proj') === '/work/tmp/proj').
+    const targetDir = resolve(cwd, options.directory);
+    const runtimeIds = listRuntimeIds();
+    if (!runtimeIds.includes(options.runtime)) {
+        throw new YuureiError(`unknown runtime "${options.runtime}": must be one of ${runtimeIds.join(', ')}`, EXIT_CODES.RUNTIME_UNSUPPORTED);
+    }
+    validateName(options.profile, 'profile name');
+    validateName(options.task, 'task name');
+    if (options.run !== undefined)
+        validateName(options.run, 'run name');
+    const planned = scaffoldFiles(options);
+    const yuureiDir = join(targetDir, '.yuurei');
+    for (const file of planned) {
+        const absPath = join(targetDir, file.relPath);
+        if (!(await isPathWithin(targetDir, absPath))) {
+            throw new YuureiError(`refusing to scaffold ${file.relPath}: escapes target directory ${targetDir}`, EXIT_CODES.CONFIG_ERROR);
+        }
+    }
+    await mkdir(targetDir, { recursive: true });
+    if (await pathExists(yuureiDir)) {
+        const conflicts = [];
+        for (const file of planned) {
+            const existing = await readFile(join(targetDir, file.relPath), 'utf8').catch(() => null);
+            if (existing !== file.content)
+                conflicts.push(file.relPath);
+        }
+        if (conflicts.length > 0) {
+            throw new YuureiError(`refusing to overwrite existing files: ${conflicts.join(', ')}`, EXIT_CODES.CONFIG_ERROR);
+        }
+        printInitReport(buildInitReport(targetDir, options, false), options, logger);
+        return;
+    }
+    const stagingDir = await mkdtemp(join(targetDir, '.yuurei-init-'));
+    try {
+        for (const file of planned) {
+            const realPath = join(stagingDir, file.relPath);
+            await mkdir(dirname(realPath), { recursive: true });
+            await writeFile(realPath, file.content, 'utf8');
+        }
+        await rename(join(stagingDir, '.yuurei'), yuureiDir);
+    }
+    finally {
+        await rm(stagingDir, { recursive: true, force: true });
+    }
+    printInitReport(buildInitReport(targetDir, options, true), options, logger);
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAiC1D,MAAM,YAAY,GAAG,8BAA8B,CAAC;AAEpD,SAAS,YAAY,CAAC,KAAa,EAAE,IAAY;IAC/C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,WAAW,CACnB,WAAW,IAAI,KAAK,KAAK,2EAA2E,EACpG,UAAU,CAAC,YAAY,CACxB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,mBAAmB,GACvB,iFAAiF,CAAC;AAEpF,SAAS,aAAa,CAAC,OAAoB;IACzC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC;IAChC,OAAO;QACL;YACE,OAAO,EAAE,qBAAqB;YAC9B,OAAO,EAAE;gBACP,YAAY;gBACZ,EAAE;gBACF,WAAW;gBACX,KAAK,OAAO,GAAG;gBACf,gBAAgB,OAAO,EAAE;gBACzB,0BAA0B,OAAO,EAAE;gBACnC,EAAE;gBACF,OAAO;gBACP,KAAK,GAAG,GAAG;gBACX,gBAAgB,OAAO,EAAE;gBACzB,qBAAqB,IAAI,KAAK;gBAC9B,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC;SACb;QACD;YACE,OAAO,EAAE,oBAAoB,OAAO,eAAe;YACnD,OAAO,EAAE;gBACP,YAAY,OAAO,EAAE;gBACrB,gBAAgB,OAAO,qCAAqC;gBAC5D,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC;SACb;QACD;YACE,OAAO,EAAE,oBAAoB,OAAO,kBAAkB;YACtD,OAAO,EAAE,EAAE;SACZ;QACD;YACE,OAAO,EAAE,iBAAiB,IAAI,KAAK;YACnC,OAAO,EAAE,GAAG,mBAAmB,IAAI;SACpC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,OAAoB;IACxC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAClC,OAAO;QACL,qBAAqB;QACrB,oBAAoB,OAAO,eAAe;QAC1C,oBAAoB,OAAO,kBAAkB;QAC7C,iBAAiB,IAAI,KAAK;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,SAAiB,EAAE,OAAoB,EAAE,OAAgB;IAChF,OAAO;QACL,SAAS;QACT,OAAO;QACP,aAAa,EAAE,YAAY,CAAC,OAAO,CAAC;QACpC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,MAAkB,EAAE,OAAoB,EAAE,MAAc;IAC/E,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IACD,MAAM,CAAC,IAAI,CACT,MAAM,CAAC,OAAO;QACZ,CAAC,CAAC,yBAAyB,MAAM,CAAC,SAAS,EAAE;QAC7C,CAAC,CAAC,iCAAiC,MAAM,CAAC,SAAS,EAAE,CACxD,CAAC;IACF,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,CAAC,IAAI,CACT,QAAQ,MAAM,CAAC,GAAG,0BAA0B,MAAM,CAAC,OAAO,eAAe,MAAM,CAAC,IAAI,GAAG,CACxF,CAAC;IACF,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC9B,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACrC,MAAM,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAClD,MAAM,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,OAAoB,EAAE,MAAc;IAC7E,2EAA2E;IAC3E,uEAAuE;IACvE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,WAAW,CACnB,oBAAoB,OAAO,CAAC,OAAO,qBAAqB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC/E,UAAU,CAAC,mBAAmB,CAC/B,CAAC;IACJ,CAAC;IACD,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAC9C,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACxC,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAErE,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,WAAW,CACnB,wBAAwB,IAAI,CAAC,OAAO,8BAA8B,SAAS,EAAE,EAC7E,UAAU,CAAC,YAAY,CACxB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,IAAI,MAAM,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACzF,IAAI,QAAQ,KAAK,IAAI,CAAC,OAAO;gBAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,WAAW,CACnB,yCAAyC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC/D,UAAU,CAAC,YAAY,CACxB,CAAC;QACJ,CAAC;QACD,eAAe,CAAC,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7E,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAChD,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC;IACvD,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,eAAe,CAAC,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAC9E,CAAC"}

package/dist/cli/inspect.d.ts

@@ -0,0 +1,4 @@
+import type { Logger } from '../util/logger.js';
+/** `yuurei inspect <profile-name>` — resolves a profile's config but never runs anything. */
+export declare function runInspect(cwd: string, profileName: string, logger: Logger): Promise<void>;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/cli/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/cli/inspect.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,6FAA6F;AAC7F,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBhG"}

package/dist/cli/inspect.js

@@ -0,0 +1,24 @@
+import { join } from 'node:path';
+import { findYuureiDir } from '../config/discovery.js';
+import { loadYuureiConfig } from '../config/yuurei-config.js';
+import { loadProfile } from '../profile/loader.js';
+import { YuureiError, EXIT_CODES } from './exit-codes.js';
+/** `yuurei inspect <profile-name>` — resolves a profile's config but never runs anything. */
+export async function runInspect(cwd, profileName, logger) {
+    const yuureiDir = await findYuureiDir(cwd);
+    if (!yuureiDir) {
+        throw new YuureiError('no .yuurei/ directory found', EXIT_CODES.CONFIG_ERROR);
+    }
+    const config = await loadYuureiConfig(yuureiDir);
+    const profileEntry = config.profiles[profileName];
+    if (!profileEntry) {
+        throw new YuureiError(`unknown profile: ${profileName}`, EXIT_CODES.CONFIG_ERROR);
+    }
+    const resolved = await loadProfile({
+        name: profileName,
+        runtime: profileEntry.runtime,
+        sourceDir: join(yuureiDir, profileEntry.source),
+    });
+    logger.info(profileName, { runtime: resolved.runtime, digest: resolved.digest });
+}
+//# sourceMappingURL=inspect.js.map

package/dist/cli/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/cli/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG1D,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,WAAmB,EAAE,MAAc;IAC/E,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CAAC,6BAA6B,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,WAAW,CAAC,oBAAoB,WAAW,EAAE,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC;QACjC,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC;KAChD,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;AACnF,CAAC"}

package/dist/cli/output.d.ts

@@ -0,0 +1,5 @@
+import { type Logger } from '../util/logger.js';
+export declare function loggerForFlags(flags: {
+    json?: boolean;
+}): Logger;
+//# sourceMappingURL=output.d.ts.map

package/dist/cli/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE9D,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAEhE"}

package/dist/cli/output.js

@@ -0,0 +1,5 @@
+import { createLogger } from '../util/logger.js';
+export function loggerForFlags(flags) {
+    return createLogger(flags.json ? 'json' : 'human');
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/cli/output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAe,MAAM,mBAAmB,CAAC;AAE9D,MAAM,UAAU,cAAc,CAAC,KAAyB;IACtD,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACrD,CAAC"}

package/dist/cli/profile-list.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from '../util/logger.js';
+export declare function runProfileList(cwd: string, logger: Logger): Promise<void>;
+//# sourceMappingURL=profile-list.d.ts.map

package/dist/cli/profile-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-list.d.ts","sourceRoot":"","sources":["../../src/cli/profile-list.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/E"}

package/dist/cli/profile-list.js

@@ -0,0 +1,14 @@
+import { findYuureiDir } from '../config/discovery.js';
+import { loadYuureiConfig } from '../config/yuurei-config.js';
+import { YuureiError, EXIT_CODES } from './exit-codes.js';
+export async function runProfileList(cwd, logger) {
+    const yuureiDir = await findYuureiDir(cwd);
+    if (!yuureiDir) {
+        throw new YuureiError('no .yuurei/ directory found', EXIT_CODES.CONFIG_ERROR);
+    }
+    const config = await loadYuureiConfig(yuureiDir);
+    for (const [name, profile] of Object.entries(config.profiles)) {
+        logger.info(name, { runtime: profile.runtime, source: profile.source });
+    }
+}
+//# sourceMappingURL=profile-list.js.map

package/dist/cli/profile-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-list.js","sourceRoot":"","sources":["../../src/cli/profile-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG1D,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,MAAc;IAC9D,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,WAAW,CAAC,6BAA6B,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/cli/run.d.ts

@@ -0,0 +1,22 @@
+import type { Logger } from '../util/logger.js';
+export interface RunOptions {
+    runName: string | undefined;
+    profile: string | undefined;
+    task: string | undefined;
+    keep: boolean | undefined;
+    model: string | undefined;
+    /** Milliseconds before the runtime process is sent SIGTERM. undefined = no timeout. */
+    timeoutMs: number | undefined;
+    /** Isolation strategy (design doc §9.3): 'level0' or 'level1'. Defaults to 'level1'. */
+    isolation: string | undefined;
+    /**
+     * Opt-in, experimental: bridge the real ~/.codex/auth.json into the
+     * isolated CODEX_HOME (ignored for other runtimes). Off by default because
+     * that file can carry a rotating OAuth token pair — see the Codex
+     * adapter's bridgeCodexAuthFile doc comment. The supported v0.3 auth path
+     * is an explicitly-set OPENAI_API_KEY, forwarded unconditionally.
+     */
+    bridgeCodexAuthFile: boolean | undefined;
+}
+export declare function runRun(cwd: string, options: RunOptions, logger: Logger): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/cli/run.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAUhD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,uFAAuF;IACvF,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,wFAAwF;IACxF,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B;;;;;;OAMG;IACH,mBAAmB,EAAE,OAAO,GAAG,SAAS,CAAC;CAC1C;AAID,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4G5F"}

package/dist/cli/run.js

@@ -0,0 +1,95 @@
+import { join } from 'node:path';
+import { findYuureiDir } from '../config/discovery.js';
+import { loadYuureiConfig } from '../config/yuurei-config.js';
+import { loadProfile } from '../profile/loader.js';
+import { runPipeline } from '../run/pipeline.js';
+import { MAX_TIMEOUT_MS } from '../runtime/exec.js';
+import { getRuntime } from '../runtime/registry.js';
+import { isPathWithin } from '../util/fs.js';
+import { YuureiError, EXIT_CODES } from './exit-codes.js';
+import { exitCodeForSignal } from '../run/signals.js';
+import { packageVersion } from '../version.js';
+const ISOLATION_STRATEGIES = ['level0', 'level1'];
+const DEFAULT_ISOLATION_STRATEGY = 'level1';
+function isIsolationStrategy(value) {
+    return ISOLATION_STRATEGIES.includes(value);
+}
+const YUUREI_VERSION = packageVersion;
+export async function runRun(cwd, options, logger) {
+    const yuureiDir = await findYuureiDir(cwd);
+    if (!yuureiDir) {
+        throw new YuureiError('no .yuurei/ directory found', EXIT_CODES.CONFIG_ERROR);
+    }
+    const config = await loadYuureiConfig(yuureiDir);
+    let profileName = options.profile;
+    let taskPath = options.task;
+    if (options.runName) {
+        const runEntry = config.runs[options.runName];
+        if (!runEntry) {
+            throw new YuureiError(`unknown run: ${options.runName}`, EXIT_CODES.CONFIG_ERROR);
+        }
+        profileName = runEntry.profile;
+        taskPath = join(yuureiDir, runEntry.task);
+        if (!(await isPathWithin(yuureiDir, taskPath))) {
+            throw new YuureiError(`task path escapes the .yuurei directory: ${runEntry.task}`, EXIT_CODES.CONFIG_ERROR);
+        }
+    }
+    if (!profileName || !taskPath) {
+        throw new YuureiError('either a run name or both --profile and --task are required', EXIT_CODES.CONFIG_ERROR);
+    }
+    if (options.timeoutMs !== undefined &&
+        !(Number.isFinite(options.timeoutMs) &&
+            options.timeoutMs > 0 &&
+            options.timeoutMs <= MAX_TIMEOUT_MS)) {
+        throw new YuureiError(`--timeout must be a finite number of milliseconds between 1 and ${MAX_TIMEOUT_MS}`, EXIT_CODES.CONFIG_ERROR);
+    }
+    if (options.isolation !== undefined && !isIsolationStrategy(options.isolation)) {
+        throw new YuureiError(`--isolation must be one of: ${ISOLATION_STRATEGIES.join(', ')}`, EXIT_CODES.CONFIG_ERROR);
+    }
+    const isolationStrategy = options.isolation ?? DEFAULT_ISOLATION_STRATEGY;
+    const profileEntry = config.profiles[profileName];
+    if (!profileEntry) {
+        throw new YuureiError(`unknown profile: ${profileName}`, EXIT_CODES.CONFIG_ERROR);
+    }
+    const profile = await loadProfile({
+        name: profileName,
+        runtime: profileEntry.runtime,
+        sourceDir: join(yuureiDir, profileEntry.source),
+    });
+    const result = await runPipeline({
+        runtimeId: profile.runtime,
+        requestedModel: options.model ?? '',
+        profile,
+        taskPath,
+        yuureiVersion: YUUREI_VERSION,
+        yuureiDir,
+        isolationStrategy,
+        keep: options.keep ?? false,
+        timeoutMs: options.timeoutMs ?? null,
+        executionOptions: { bridgeCodexAuthFile: options.bridgeCodexAuthFile ?? false },
+        onWarning: (message) => logger.warn(message),
+    });
+    logger.info(`run ${result.runId} finished`, {
+        exitCode: result.trace.execution.exit_code,
+        signal: result.trace.execution.signal,
+        runDir: result.runDir,
+    });
+    if (result.trace.execution.signal !== null) {
+        process.exitCode = exitCodeForSignal(result.trace.execution.signal);
+    }
+    // Surface auth guidance on failure without exposing runtime stdout/stderr
+    // (§10.2). Only for a numeric non-zero exit code — a signal-terminated run
+    // (exit_code null) is covered by the signal exit-code propagation above.
+    if (typeof result.trace.execution.exit_code === 'number' &&
+        result.trace.execution.exit_code !== 0) {
+        const detection = await getRuntime(profile.runtime).detect();
+        if (detection.installed &&
+            detection.authUsable === false &&
+            detection.authGuidance !== undefined) {
+            logger.warn(`${profile.runtime}: authentication required — next steps`, {
+                authGuidance: detection.authGuidance,
+            });
+        }
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

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

package/dist/cli/trace-show.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from '../util/logger.js';
+export declare function runTraceShow(cwd: string, runId: string, logger: Logger): Promise<void>;
+//# sourceMappingURL=trace-show.d.ts.map

package/dist/cli/trace-show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-show.d.ts","sourceRoot":"","sources":["../../src/cli/trace-show.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB5F"}