@sublang/slc 0.1.0

package/dist/compiled-executor.js

@@ -0,0 +1,433 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+/**
+ * Compiled phase execution: load a `playbook` artifact and drive it host-side
+ * (PHEXEC-23, PHEXEC-24, PHEXEC-25; DR-005).
+ *
+ * {@link loadPlaybookRuntime} imports a compiled `playbook` module and returns
+ * its `createPlaybookRuntime` factory. {@link createCompiledExecutor} adapts it
+ * to the DR-003 {@link PhaseExecutor} boundary: per run it builds the
+ * Cligent-backed Playbook ports, constructs the runtime, drives one
+ * non-interactive turn (`init` -> `handleBossInput` -> `dispose`), and maps a
+ * structured result when present or the bounded legacy host-observable outcome
+ * otherwise. The pin-selected contract profile chooses the exact legacy,
+ * traced-session, or composed-session init shape without a retry heuristic
+ * (DR-010, DR-011). The host-only `drainDiagnostics` stays host-side;
+ * human status and non-trace operational telemetry become diagnostics. Like
+ * interpreted execution, a compiled phase writes through its agents
+ * (`callPlayer`) and relies on the DR-003 generic checks, which defend the
+ * protected inputs (not the full write scope); `slc` adds no host-side
+ * write-scope enforcement.
+ *
+ * The turn is seeded per the PHEXEC-29 contract ({@link seedPhaseTurn}), and a
+ * transformation-performing direct Captain call additionally carries the host
+ * workspace contract ({@link composeWorkspaceContract}; PHEXEC-34) so the
+ * host-agnostic artifact's Captain learns the request's absolute paths; the
+ * result is derived in {@link drivePhase} from the structured runtime boundary
+ * or, for a void-result legacy runtime, the host-observable output delta.
+ * See specs/dev/phase-execution.md.
+ */
+import { createHash, randomUUID } from 'node:crypto';
+import { readFile, stat } from 'node:fs/promises';
+import { basename, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { composeWorkspaceContract, mapPhaseResult, seedPhaseTurn, } from './phase-runner.js';
+import { isPlaybookRunResult, } from './playbook-contract.js';
+import { createPlaybookPorts } from './playbook-ports.js';
+/**
+ * Imports a compiled `playbook` module and returns its runtime factory
+ * (PHEXEC-23).
+ *
+ * @throws when the module has no callable `createPlaybookRuntime` default export.
+ */
+export async function loadPlaybookRuntime(artifactPath) {
+    const module = await import(pathToFileURL(resolve(artifactPath)).href);
+    const create = module.default;
+    if (typeof create !== 'function') {
+        throw new Error(`compiled artifact "${artifactPath}" has no createPlaybookRuntime default export`);
+    }
+    return create;
+}
+/**
+ * Adapts a compiled `playbook` artifact to the {@link PhaseExecutor} boundary
+ * (PHEXEC-24, PHEXEC-25): build the Cligent-backed Playbook ports, load and
+ * construct the runtime, drive one non-interactive root-session turn, and map
+ * the outcome, appending drained status and non-trace operational telemetry.
+ */
+export function createCompiledExecutor(opts) {
+    const load = opts.loadFactory ?? loadPlaybookRuntime;
+    return {
+        async run(request, signal) {
+            let lastFsmState;
+            const input = phaseInput(request, opts.runRoot);
+            const adapter = createPlaybookPorts({
+                player: opts.player,
+                judge: opts.judge,
+                models: opts.models,
+                defaultModel: opts.defaultModel,
+                cwd: opts.cwd,
+                // The host owns the workspace: a transformation-performing Captain's
+                // transported prompt carries the request's absolute paths and
+                // write-scope rules (PHEXEC-34).
+                captainWorkspace: composeWorkspaceContract(input),
+            });
+            // Hand the runtime only Playbook's ports — never the host-only
+            // drainDiagnostics, nor a file capability (DR-005, PHEXEC-23).
+            const ports = {
+                callPlayer: adapter.callPlayer,
+                callCaptain: adapter.callCaptain,
+                callJudge: adapter.callJudge,
+                callPlaybook: adapter.callPlaybook,
+                emitStatus: adapter.emitStatus,
+                emitTelemetry: async (event) => {
+                    const state = fsmTransitionTarget(event);
+                    if (state !== undefined)
+                        lastFsmState = state;
+                    await adapter.emitTelemetry(event);
+                },
+            };
+            const runtimeContract = opts.runtimeContract ?? 'legacy';
+            const identity = phaseSessionIdentity({
+                sessionId: (opts.createSessionId ?? randomUUID)(),
+                playbookId: opts.playbookId ?? playbookIdFromArtifact(opts.artifactPath),
+            });
+            const driven = await drivePhase(load, opts.artifactPath, ports, input, signal, identity, runtimeContract);
+            const result = mapVoidContractFailedState(driven, lastFsmState, runtimeContract !== 'composed-v2');
+            const mapped = mapPhaseResult(result);
+            return {
+                status: mapped.status,
+                diagnostics: [...mapped.diagnostics, ...adapter.drainDiagnostics()],
+            };
+        },
+    };
+}
+/** Returns the destination carried by Playbook's standard FSM telemetry. */
+function fsmTransitionTarget(event) {
+    if (event.topic !== 'playbook.fsm.state' ||
+        typeof event.payload !== 'object' ||
+        event.payload === null ||
+        !('to' in event.payload) ||
+        typeof event.payload.to !== 'string') {
+        return undefined;
+    }
+    return event.payload.to;
+}
+/** DR-005 maps a quiescent `failed` FSM state to an executor error. */
+function mapVoidContractFailedState(result, lastFsmState, voidContract) {
+    if (!voidContract || result.status === 'error' || lastFsmState !== 'failed') {
+        return result;
+    }
+    return {
+        status: 'error',
+        diagnostics: ['compiled runtime reached the failed quiescent state'],
+    };
+}
+/**
+ * Loads, constructs, and drives one non-interactive turn. Structured results
+ * are authoritative; a void legacy result retains DR-010's output-delta and
+ * host-observed failed-state mapping.
+ */
+async function drivePhase(load, artifactPath, ports, input, signal, identity, runtimeContract) {
+    let runtime;
+    try {
+        const factory = await load(artifactPath);
+        runtime = factory({});
+    }
+    catch (error) {
+        return {
+            status: 'error',
+            diagnostics: [`compiled artifact failed to load: ${messageOf(error)}`],
+        };
+    }
+    // Snapshot the output before the turn so a pre-existing stale artifact is not
+    // mistaken for fresh output the turn produced.
+    const outputPath = input.kind === 'compile' ? input.target : input.linked;
+    const before = await outputState(outputPath);
+    const initValue = runtimeInitValue(runtimeContract, identity, ports);
+    let runResult;
+    try {
+        await callRuntimeInit(runtime, initValue);
+        runResult = await callRuntimeTurn(runtime, seedPhaseTurn(input), signal);
+    }
+    catch (error) {
+        const disposal = await disposeRuntime(runtime);
+        return {
+            status: 'error',
+            diagnostics: [
+                signal.aborted
+                    ? 'compiled run aborted'
+                    : `compiled run failed: ${messageOf(error)}`,
+                ...(disposal === undefined
+                    ? []
+                    : [`compiled runtime disposal also failed: ${messageOf(disposal)}`]),
+            ],
+        };
+    }
+    const disposal = await disposeRuntime(runtime);
+    if (disposal !== undefined) {
+        return {
+            status: 'error',
+            diagnostics: [`compiled runtime disposal failed: ${messageOf(disposal)}`],
+        };
+    }
+    if (signal.aborted) {
+        return {
+            status: 'error',
+            diagnostics: ['compiled run aborted'],
+        };
+    }
+    const after = await outputState(outputPath);
+    const produced = outputWasProduced(before, after);
+    return mapRuntimeOutcome(runResult, produced, runtimeContract);
+}
+async function disposeRuntime(runtime) {
+    try {
+        await runtime.dispose();
+        return undefined;
+    }
+    catch (error) {
+        return error;
+    }
+}
+function rootSession(identity, ports) {
+    return {
+        sessionId: identity.sessionId,
+        playbookId: identity.playbookId,
+        rootSessionId: identity.sessionId,
+        depth: 0,
+        ports: composedPorts(ports),
+    };
+}
+function legacyPorts(ports) {
+    return {
+        callPlayer: ports.callPlayer,
+        callJudge: ports.callJudge,
+        emitStatus: ports.emitStatus,
+        emitTelemetry: ports.emitTelemetry,
+    };
+}
+function sessionV1Ports(ports) {
+    return {
+        callPlayer: (playerId, prompt, signal, options) => ports.callPlayer(playerId, prompt, signal, requirePlayerCallOptions(options)),
+        callJudge: ports.callJudge,
+        emitStatus: ports.emitStatus,
+        emitTelemetry: ports.emitTelemetry,
+    };
+}
+function composedPorts(ports) {
+    return {
+        callPlayer: (playerId, prompt, signal, options) => preserveControlPlaneRejection('callPlayer', signal, () => ports.callPlayer(playerId, prompt, signal, requirePlayerCallOptions(options))),
+        callCaptain: (prompt, signal, options) => preserveControlPlaneRejection('callCaptain', signal, () => ports.callCaptain(prompt, signal, options)),
+        callJudge: (prompt, signal) => preserveControlPlaneRejection('callJudge', signal, () => ports.callJudge(prompt, signal)),
+        callPlaybook: (request, signal) => preserveControlPlaneRejection('callPlaybook', signal, () => ports.callPlaybook(request, signal)),
+        emitStatus: (message, data) => preserveControlPlaneRejection('emitStatus', undefined, () => ports.emitStatus(message, data)),
+        emitTelemetry: (event) => preserveControlPlaneRejection('emitTelemetry', undefined, () => ports.emitTelemetry(event)),
+    };
+}
+/**
+ * Keeps nullish host-port rejections visible to immutable composed runtimes.
+ * Playbook 2.0.0 latches control-plane failures with nullish coalescing, so a
+ * rejection without a value could otherwise be mistaken for an authored FSM
+ * failure. Preserve a causally identical abort reason, but give every other
+ * nullish rejection a stable Error identity before it crosses the boundary.
+ */
+async function preserveControlPlaneRejection(port, signal, call) {
+    try {
+        return await call();
+    }
+    catch (error) {
+        if (error !== undefined && error !== null) {
+            throw error;
+        }
+        if (signal?.aborted === true && error === signal.reason) {
+            throw error;
+        }
+        throw new Error(`compiled composed-v2 ${port} port rejected without an error`, { cause: error });
+    }
+}
+function requirePlayerCallOptions(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new TypeError('session runtime callPlayer requires explicit PlayerCallOptions');
+    }
+    const descriptor = Object.getOwnPropertyDescriptor(value, 'resume');
+    if (descriptor === undefined ||
+        !Object.prototype.hasOwnProperty.call(descriptor, 'value') ||
+        (descriptor.value !== false && typeof descriptor.value !== 'string')) {
+        throw new TypeError('session runtime callPlayer options.resume must be false or a string');
+    }
+    return { resume: descriptor.value };
+}
+function runtimeInitValue(contract, identity, ports) {
+    switch (contract) {
+        case 'legacy':
+            return legacyPorts(ports);
+        case 'session-v1':
+            return {
+                sessionId: identity.sessionId,
+                playbookId: identity.playbookId,
+                ports: sessionV1Ports(ports),
+            };
+        case 'composed-v2':
+            return rootSession(identity, ports);
+    }
+}
+async function callRuntimeInit(runtime, value) {
+    const init = runtime.init;
+    await init.call(runtime, value);
+}
+async function callRuntimeTurn(runtime, text, signal) {
+    const handle = runtime.handleBossInput;
+    return handle.call(runtime, { text, signal });
+}
+function mapRuntimeOutcome(result, produced, contract) {
+    if (contract !== 'composed-v2') {
+        return result === undefined
+            ? legacyOutputResult(produced)
+            : {
+                status: 'error',
+                diagnostics: [
+                    `compiled ${contract} runtime returned an unexpected structured result`,
+                ],
+            };
+    }
+    if (result === undefined) {
+        return {
+            status: 'error',
+            diagnostics: ['compiled composed-v2 runtime returned no run result'],
+        };
+    }
+    if (!isPlaybookRunResult(result)) {
+        return {
+            status: 'error',
+            diagnostics: ['compiled runtime returned an invalid run result'],
+        };
+    }
+    return structuredOutputResult(result, produced);
+}
+function phaseSessionIdentity(identity) {
+    if (identity.sessionId.trim().length === 0) {
+        throw new Error('compiled runtime session id must be non-empty');
+    }
+    if (identity.playbookId.trim().length === 0) {
+        throw new Error('compiled runtime playbook id must be non-empty');
+    }
+    return identity;
+}
+function legacyOutputResult(produced) {
+    return produced
+        ? { status: 'ok', diagnostics: [] }
+        : {
+            status: 'blocked',
+            diagnostics: [
+                'compiled phase produced no output (parked for Boss input)',
+            ],
+        };
+}
+function structuredOutputResult(result, produced) {
+    switch (result.outcome) {
+        case 'quiescent':
+        case 'terminal':
+            return produced
+                ? { status: 'ok', diagnostics: [] }
+                : {
+                    status: 'blocked',
+                    diagnostics: [
+                        `compiled runtime ${result.outcome} without producing output`,
+                    ],
+                };
+        case 'no-action':
+            return {
+                status: 'blocked',
+                diagnostics: ['compiled runtime accepted no phase action'],
+            };
+        case 'failed':
+        case 'aborted':
+            return {
+                status: 'error',
+                diagnostics: [
+                    `compiled runtime ${result.outcome}${result.error ? `: ${result.error.message}` : ''}`,
+                ],
+            };
+        case 'suspended':
+            return {
+                status: 'error',
+                diagnostics: [
+                    `compiled runtime suspended for unsupported nested playbook call ${result.pendingCall.callId}`,
+                ],
+            };
+    }
+}
+function playbookIdFromArtifact(artifactPath) {
+    const name = basename(artifactPath);
+    return name.endsWith('.playbook.ts')
+        ? name.slice(0, -'.playbook.ts'.length)
+        : name.replace(/\.[^.]+$/, '');
+}
+/**
+ * A point-in-time output view. Content and file identity supplement timestamps,
+ * so an atomic replacement or preserved mtime still counts as produced output.
+ */
+async function outputState(path) {
+    try {
+        const info = await stat(path);
+        const identity = {
+            dev: info.dev,
+            ino: info.ino,
+            mode: info.mode,
+            size: info.size,
+            mtimeMs: info.mtimeMs,
+            ctimeMs: info.ctimeMs,
+        };
+        if (!info.isFile())
+            return { kind: 'other', ...identity };
+        const digest = createHash('sha256')
+            .update(await readFile(path))
+            .digest('hex');
+        return { kind: 'file', digest, ...identity };
+    }
+    catch {
+        return { kind: 'missing' };
+    }
+}
+function outputWasProduced(before, after) {
+    if (after.kind !== 'file')
+        return false;
+    if (before.kind !== 'file')
+        return true;
+    return (before.digest !== after.digest ||
+        before.dev !== after.dev ||
+        before.ino !== after.ino ||
+        before.mode !== after.mode ||
+        before.size !== after.size ||
+        before.mtimeMs !== after.mtimeMs ||
+        before.ctimeMs !== after.ctimeMs);
+}
+/**
+ * Maps an {@link ExecuteRequest} to the {@link PhaseInput} the seed carries,
+ * resolving its workspace paths against the run root to absolute host paths the
+ * runtime's agents can act on (DR-005).
+ */
+function phaseInput(request, runRoot) {
+    const abs = (path) => resolve(runRoot, path);
+    if (request.kind === 'compile') {
+        return {
+            kind: 'compile',
+            source: abs(request.source),
+            target: abs(request.target),
+        };
+    }
+    return {
+        kind: 'link',
+        objects: request.objects.map(abs),
+        linkTarget: abs(request.linkTarget),
+        options: optionsRecord(request.options),
+        linked: abs(request.linked),
+    };
+}
+function optionsRecord(options) {
+    return Object.fromEntries(options.map((option) => [option.name, option.value]));
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=compiled-executor.js.map

package/dist/compiled-executor.js.map

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

package/dist/config-file.d.ts

@@ -0,0 +1,52 @@
+/** Config-file basename discovered in the working directory (DR-006). */
+export declare const CONFIG_FILE = "slc.config.yaml";
+/** Config-file path under the user config home (DR-006). */
+export declare const HOME_CONFIG: string;
+/** Partial cligent-invocation selection loaded from a config file (DR-006). */
+export interface FileConfig {
+    agent?: string;
+    model?: string;
+    effort?: string;
+    pipelinePath?: string[];
+}
+/**
+ * A loaded config file: the parsed {@link FileConfig} plus the resolved file
+ * path, or `path: undefined` on a discovery miss (no file loaded).
+ */
+export interface LoadedFileConfig {
+    path?: string;
+    config: FileConfig;
+}
+/** Injectable IO for {@link loadConfigFile}; all fields default to the process. */
+export interface LoadConfigFileOptions {
+    cwd?: string;
+    /** Explicit `--config <path>`: disables discovery and errors when absent (CLI-20, CLI-21). */
+    configPath?: string;
+    /** User config home; defaults to `${XDG_CONFIG_HOME:-~/.config}`. Injectable for tests. */
+    configHome?: string;
+    /** Environment for resolving `XDG_CONFIG_HOME`; defaults to `process.env`. */
+    env?: Record<string, string | undefined>;
+    /** Called with the created path when a discovery miss seeds the user config (DR-015, CLI-30). */
+    onSeed?: (path: string) => void;
+}
+/** Machine-readable reason a config file was rejected (CLI-21). */
+export type ConfigFileErrorCode = 'config-not-found' | 'config-parse' | 'config-invalid';
+/** Raised when an explicit `--config` file is missing, malformed, or invalid (CLI-21). */
+export declare class ConfigFileError extends Error {
+    readonly code: ConfigFileErrorCode;
+    constructor(code: ConfigFileErrorCode, message: string);
+}
+/**
+ * Loads the slc config file (DR-006, CLI-20, CLI-21).
+ *
+ * Resolves the file via an explicit `--config` path or cwd/home discovery,
+ * parses and validates it, and returns the partial selection plus the resolved
+ * path. A discovery miss returns `{ config: {} }` so the caller falls through to
+ * the environment and built-in defaults.
+ *
+ * @throws {ConfigFileError} when an explicit `--config` path is absent
+ *   (`config-not-found`), the file is unreadable or malformed YAML
+ *   (`config-parse`), or it violates the flat schema (`config-invalid`).
+ */
+export declare function loadConfigFile(options?: LoadConfigFileOptions): Promise<LoadedFileConfig>;
+//# sourceMappingURL=config-file.d.ts.map

package/dist/config-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file.d.ts","sourceRoot":"","sources":["../src/config-file.ts"],"names":[],"mappings":"AA2BA,yEAAyE;AACzE,eAAO,MAAM,WAAW,oBAAoB,CAAC;AAC7C,4DAA4D;AAC5D,eAAO,MAAM,WAAW,QAA6B,CAAC;AAOtD,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2FAA2F;IAC3F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,iGAAiG;IACjG,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,mEAAmE;AACnE,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,cAAc,GACd,gBAAgB,CAAC;AAErB,0FAA0F;AAC1F,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;gBAEvB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM;CAKvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAQ3B"}

package/dist/config-file.js

@@ -0,0 +1,159 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: 2026 SubLang International <https://sublang.ai>
+/**
+ * Config-file loader for the `slc` bin (DR-006, CLI-20, CLI-21).
+ *
+ * Discovers and parses the optional YAML config file that supplies the
+ * cligent-invocation defaults — `agent`, `model`, `effort`, and `pipelinePath` — which the
+ * environment then overrides (DR-006). Discovery reads `slc.config.yaml` in the
+ * working directory, then `${XDG_CONFIG_HOME:-~/.config}/slc/config.yaml`; an
+ * explicit `--config` path disables discovery and is an error when absent, while
+ * a discovery miss returns an empty result that falls through to the environment
+ * and defaults. The loader validates a flat schema and rejects unknown keys and
+ * mistyped values; the supported-agent check stays with `resolveAgentSelection`
+ * so the agent set keeps a single source of truth. Relative `pipelinePath`
+ * entries are returned verbatim and resolved against the cwd downstream
+ * (CLI-6). See specs/dev/cli.md.
+ */
+import { copyFileSync, existsSync, mkdirSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parse } from 'yaml';
+/** Config-file basename discovered in the working directory (DR-006). */
+export const CONFIG_FILE = 'slc.config.yaml';
+/** Config-file path under the user config home (DR-006). */
+export const HOME_CONFIG = join('slc', 'config.yaml');
+/** Bundled starter template seeded into the user config home on a discovery miss (DR-015). */
+const TEMPLATE_PATH = fileURLToPath(new URL('./slc.config.template.yaml', import.meta.url));
+/** Raised when an explicit `--config` file is missing, malformed, or invalid (CLI-21). */
+export class ConfigFileError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'ConfigFileError';
+        this.code = code;
+    }
+}
+/**
+ * Loads the slc config file (DR-006, CLI-20, CLI-21).
+ *
+ * Resolves the file via an explicit `--config` path or cwd/home discovery,
+ * parses and validates it, and returns the partial selection plus the resolved
+ * path. A discovery miss returns `{ config: {} }` so the caller falls through to
+ * the environment and built-in defaults.
+ *
+ * @throws {ConfigFileError} when an explicit `--config` path is absent
+ *   (`config-not-found`), the file is unreadable or malformed YAML
+ *   (`config-parse`), or it violates the flat schema (`config-invalid`).
+ */
+export async function loadConfigFile(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const path = resolveConfigPath(options, cwd);
+    if (path === undefined) {
+        return { config: {} };
+    }
+    const config = await readConfigFile(path);
+    return { path, config };
+}
+function resolveConfigPath(options, cwd) {
+    if (options.configPath !== undefined) {
+        const explicit = isAbsolute(options.configPath)
+            ? options.configPath
+            : resolve(cwd, options.configPath);
+        if (!existsSync(explicit)) {
+            throw new ConfigFileError('config-not-found', `--config file not found: ${options.configPath}`);
+        }
+        return explicit;
+    }
+    const cwdConfig = resolve(cwd, CONFIG_FILE);
+    if (existsSync(cwdConfig)) {
+        return cwdConfig;
+    }
+    const homeConfig = join(configHome(options), HOME_CONFIG);
+    if (existsSync(homeConfig)) {
+        return homeConfig;
+    }
+    // First run: neither discovered file exists, so seed the user config from
+    // the bundled starter and load it (DR-015, CLI-30).
+    mkdirSync(dirname(homeConfig), { recursive: true });
+    copyFileSync(TEMPLATE_PATH, homeConfig);
+    options.onSeed?.(homeConfig);
+    return homeConfig;
+}
+function configHome(options) {
+    if (options.configHome !== undefined) {
+        return options.configHome;
+    }
+    const env = options.env ?? process.env;
+    const xdg = (env.XDG_CONFIG_HOME ?? '').trim();
+    return xdg !== '' ? xdg : join(homedir(), '.config');
+}
+async function readConfigFile(path) {
+    let source;
+    try {
+        source = await readFile(path, 'utf8');
+    }
+    catch (error) {
+        throw new ConfigFileError('config-parse', `Failed to read config file ${path}: ${messageOf(error)}`);
+    }
+    let raw;
+    try {
+        raw = parse(source);
+    }
+    catch (error) {
+        throw new ConfigFileError('config-parse', `Failed to parse config file ${path}: ${messageOf(error)}`);
+    }
+    return normalizeFileConfig(raw, path);
+}
+const ALLOWED_KEYS = new Set(['agent', 'model', 'effort', 'pipelinePath']);
+function normalizeFileConfig(value, path) {
+    if (value === null || value === undefined) {
+        return {};
+    }
+    if (typeof value !== 'object' || Array.isArray(value)) {
+        throw new ConfigFileError('config-invalid', `Config file ${path} must contain a mapping of keys to values`);
+    }
+    const input = value;
+    for (const key of Object.keys(input)) {
+        if (!ALLOWED_KEYS.has(key)) {
+            throw new ConfigFileError('config-invalid', `Unknown config key "${key}" in ${path}; allowed keys: agent, model, effort, pipelinePath`);
+        }
+    }
+    const config = {};
+    if (input.agent !== undefined) {
+        config.agent = requireString(input.agent, 'agent', path);
+    }
+    if (input.model !== undefined) {
+        config.model = requireString(input.model, 'model', path);
+    }
+    if (input.effort !== undefined) {
+        config.effort = requireString(input.effort, 'effort', path);
+    }
+    if (input.pipelinePath !== undefined) {
+        config.pipelinePath = requireStringArray(input.pipelinePath, 'pipelinePath', path);
+    }
+    return config;
+}
+function requireString(value, key, path) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new ConfigFileError('config-invalid', `Config key "${key}" in ${path} must be a non-empty string`);
+    }
+    return value;
+}
+function requireStringArray(value, key, path) {
+    if (!Array.isArray(value)) {
+        throw new ConfigFileError('config-invalid', `Config key "${key}" in ${path} must be a sequence of strings`);
+    }
+    return value.map((entry, index) => {
+        if (typeof entry !== 'string' || entry.trim() === '') {
+            throw new ConfigFileError('config-invalid', `Config key "${key}[${index}]" in ${path} must be a non-empty string`);
+        }
+        return entry;
+    });
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=config-file.js.map