wingfoil 0.2.1 → 0.3.0

package/dist/agent/execute.js

@@ -0,0 +1,581 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ATTRIBUTION_LINE_PREFIX = exports.MCP_UNREACHABLE_MESSAGE = exports.MCP_PREFLIGHT_TIMEOUT_MS = exports.FRESH_MODE = exports.DEFAULT_ROLE_WARNING = exports.DEFAULT_ROLE = void 0;
+exports.handoffLine = handoffLine;
+exports.attributionLine = attributionLine;
+exports.renderBootstrap = renderBootstrap;
+exports.runningBuildMcpServer = runningBuildMcpServer;
+exports.renderMcpTemplate = renderMcpTemplate;
+exports.withRunFiles = withRunFiles;
+exports.agentCommandFound = agentCommandFound;
+exports.selectAgent = selectAgent;
+exports.mcpPreflight = mcpPreflight;
+exports.agentExecutePipeline = agentExecutePipeline;
+exports.launchPlan = launchPlan;
+/**
+ * `wingfoil agent execute`, the pre-launch half (`spec-016-agent-execution` §3, task-218): everything
+ * the command does before it spawns the agent — the stepless (`adhoc`) form, `--element` with an
+ * optional `--role` and `--agent`, and the step forms `--next`, `--workflow <ref>`, `--step <key>`
+ * (task-235, `./step.ts`). The launch (§3.3 steps 13–18) is `./launch.ts` (task-228).
+ *
+ * The pipeline ({@link agentExecutePipeline}) is §3.3's, in its order, and the first failure stops it:
+ *
+ * 2. With a step form, `workflow next`'s deduction at `HEAD` first (task-235): its commit is the `HEAD`
+ *    every later read takes, and a `spec-003` error in the registry refuses here. Then `dna.yaml` and
+ *    `memory.yaml` at that `HEAD` (the stepless form resolves `HEAD` itself and reads no workflow file);
+ *    the adapter tree listed, every entry that is not an adapter printed as a warning (`bug-290`).
+ * 3. Resolution (§3.2 steps 1–5): the step ({@link selectFrontierStep}), its workflow and phase; the
+ *    element (`--element`, else the step's, {@link stepTargetElement}) at `HEAD`; the role (`--role`, else
+ *    the step's, {@link resolveStepRole}, else — stepless — the `developer` default with a warning,
+ *    approver ruling R18); never `approver` (`REQ-SEC-03`); the agent ({@link selectAgent}); its adapter
+ *    (`loadAdapter`, at `HEAD`).
+ * 4. The adapter's `command` on `PATH` or at its repository path ({@link agentCommandFound}).
+ * 5. The git identity (`requireGitIdentity`), since the record is committed.
+ * 6. The run log declared and unmodified (`runLogPreflight`, task-206).
+ * 7. The execution context assembled and validated at `state_ref` (`assembleExecutionContext`, task-176).
+ * 8. Its warnings printed (`dl-050` option 4): `ExecutionContext.warnings` (the role's §5.1 directive
+ *    warnings, in their order), then the documents the builder could not read (`W_MEMORY_UNREADABLE`,
+ *    task-171's handover) — through the warning sink, so the CLI renders each one at once, before the
+ *    pre-flight. The builder's `notes` (`spec-012` §3: the DNA note, P5.3.3 sc. 3's "no relevant
+ *    Memory") are not warnings and are not printed: they reach the agent with the Prompt (task-195).
+ * 9. The run id (§4.3, `nextRunId`).
+ * 10. The bootstrap (§2.4) and the temporary files (§2.3), in the OS temporary directory
+ *    ({@link withRunFiles}), removed on every exit path.
+ * 11. The MCP pre-flight against the running build ({@link mcpPreflight}, §2.5).
+ * 12. The terminal check, last, so every earlier refusal is reachable without a terminal.
+ *
+ * Then the caller's `launch` runs, with the temporary files still in place and the function that hands
+ * the signals over from their cleanup to the launch (`withRunFiles`' `release`).
+ *
+ * Each distinct warning is printed once, and a label naming the resolved commit reads `HEAD:`
+ * (`withDistinctWarnings`; task-218's review F5).
+ *
+ * **Baseline.** Every gating read is at the one `HEAD` commit resolved at step 2 (`dl-080` (B), the
+ * `command-baseline` directive), which is also `state_ref`. Nothing is written to the repository: the
+ * only files written are the temporary ones, outside it.
+ *
+ * **Determinism.** The bootstrap and the run id are pure functions of committed state and the request
+ * (`REQ-SYS-07`); the temporary-file paths and the Node executable are host values that never reach the
+ * context (`spec-016` Consequences).
+ */
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/client/stdio.js");
+const storage_1 = require("../storage");
+const validation_1 = require("../validation");
+const warning_1 = require("../validation/warning");
+const query_1 = require("../memory/query");
+const roles_1 = require("../dna/roles");
+const approval_authority_1 = require("../core/approval-authority");
+const context_1 = require("../core/context");
+const git_identity_1 = require("../core/git-identity");
+const loaders_1 = require("../core/loaders");
+const revision_1 = require("../core/revision");
+const types_1 = require("../core/types");
+const discovery_1 = require("./discovery");
+const run_log_1 = require("./run-log");
+const step_1 = require("./step");
+/** The role of a run with no step and no `--role` (`X_cli-cmds.md:223`, approver ruling R18). */
+exports.DEFAULT_ROLE = 'developer';
+/** The warning that says the role was defaulted (§3.2 step 3). */
+exports.DEFAULT_ROLE_WARNING = `no --role given and no workflow step to take one from: running as the default role '${exports.DEFAULT_ROLE}'`;
+/** The mode that runs: `fresh`, the only one in v0.3 (§3.2 step 6). */
+exports.FRESH_MODE = 'fresh';
+/** How long the MCP pre-flight may take, start-up included, before it counts as unreachable. */
+exports.MCP_PREFLIGHT_TIMEOUT_MS = 30000;
+/** P5.4.3 sc. 3, verbatim (§3.7 `MCP_UNREACHABLE`). */
+exports.MCP_UNREACHABLE_MESSAGE = 'context pre-load failed: MCP server unreachable';
+/** §2.4's two handoff literals. */
+const HANDOFF_SECTION = 'Record your handoff in the element\'s "## Execution Notes" section.';
+const HANDOFF_FALLBACK = "Record your handoff in the element's body and in your commit messages.";
+/**
+ * §2.4's `{handoff_line}`: the section line when the element type's template has a `## Execution
+ * Notes` heading line, the fallback otherwise.
+ */
+function handoffLine(templateHasExecutionNotes) {
+    return templateHasExecutionNotes ? HANDOFF_SECTION : HANDOFF_FALLBACK;
+}
+/** The fixed opening of §2.4's attribution line (task-228, `git-conventions` §7). */
+exports.ATTRIBUTION_LINE_PREFIX = 'End every commit you write, except an approve or reject commit, with the trailer paragraph';
+/** §2.4's attribution line for `agent`: the rule of `git-conventions` §7, with the entry that signs. */
+function attributionLine(agent) {
+    return `${exports.ATTRIBUTION_LINE_PREFIX} "Co-Authored-By: ${agent.name} <${agent.email}>" and "AI-Model: <the model identifier you run as>"; to a commit wingfoil writes, add them with git commit --amend --no-edit --trailer, never as a paragraph of their own (git-conventions §7, §8).`;
+}
+/**
+ * The session Resource the bootstrap names (§2.4, task-236): `wingfoil://session/<role>/<type>:<id>/<sha>`, the
+ * concrete form of the MCP server's `wingfoil://session/{role}/{element}/{state}` template (`spec-004` §2.1). A
+ * Resource, not the `{role}-session` Prompt that serves the same text: an agent CLI may give its model a tool to
+ * read Resources and none to get Prompts (Claude Code 2.1.296, the `claude-code` built-in's by-hand pass).
+ */
+function sessionContextUri(role, element, stateRef) {
+    return `wingfoil://session/${role}/${element}/${stateRef}`;
+}
+/**
+ * The bootstrap prompt (§2.4): the only text WingFoil puts into the agent's initial prompt. Pure, with
+ * no clock and no host data, LF-terminated. Its last line hands the agent the attribution rule and the
+ * entry that signs (task-228). A change to any literal here is a revision of `spec-016`.
+ */
+function renderBootstrap(input) {
+    const contextInstruction = `Read the MCP resource "${sessionContextUri(input.role, input.element, input.stateRef)}".`;
+    return [
+        `WingFoil run ${input.runId}: act as role "${input.role}" on element ${input.element}.`,
+        `Your context is assembled at commit ${input.stateRef} and served by the "wingfoil" MCP server`,
+        `registered for this session. Load it before any other action: ${contextInstruction}`,
+        input.handoff,
+        attributionLine(input.agent),
+        '',
+    ].join('\n');
+}
+/**
+ * The server `agent execute` registers and pre-flights (§2.5): the build that is running it — the Node
+ * executable, and `[<that build's cli.js>, "mcp"]`, `cli.js` sitting one directory above this module in
+ * the compiled layout (`dist/agent/` → `dist/cli.js`).
+ */
+function runningBuildMcpServer() {
+    return { command: process.execPath, args: [(0, node_path_1.join)(__dirname, '..', 'cli.js'), 'mcp'] };
+}
+/** `mcp.template`'s placeholder tokens: the narrow class, so JSON braces are left alone (§2.3). */
+const TEMPLATE_TOKEN_RE = /\{([a-z][a-z0-9_]*)\}/g;
+/**
+ * Render `mcp.template` (§2.3): `{mcp_command}` becomes the executable as JSON string content (the
+ * template quotes it; a quote or a backslash in the path stays valid), `{mcp_args}` the argv as a JSON
+ * array. The manifest validator admits no other placeholder there, so any other token is left as is.
+ */
+function renderMcpTemplate(template, server) {
+    return template.replace(TEMPLATE_TOKEN_RE, (token, name) => {
+        if (name === 'mcp_command')
+            return JSON.stringify(server.command).slice(1, -1);
+        if (name === 'mcp_args')
+            return JSON.stringify(server.args);
+        return token;
+    });
+}
+/** Each file's basename inside the run's temporary directory. */
+const RUN_FILE_BASENAMES = {
+    bootstrap_file: 'bootstrap.txt',
+    mcp_config_file: 'mcp-config.json',
+};
+/** The signals that end `agent execute` before the spawn, and so must not leave the temporary files behind. */
+const CLEANUP_SIGNALS = process.platform === 'win32' ? ['SIGINT', 'SIGTERM'] : ['SIGINT', 'SIGTERM', 'SIGHUP'];
+/**
+ * Write `files` into a fresh directory of the operating system's temporary directory (never the
+ * repository, §2.3), owner-only, run `work` with their absolute paths, and remove the directory when
+ * `work` settles — resolved, rejected or thrown alike.
+ *
+ * A `SIGINT`, `SIGTERM` or `SIGHUP` that arrives meanwhile (a pre-flight interrupted from the keyboard,
+ * task-218's review) removes the directory too, then ends the process by that same signal. `work`
+ * receives `release`, which removes that handling: the launch calls it when it takes the signals over
+ * (§3.3 step 15).
+ */
+async function withRunFiles(files, work) {
+    // The listeners go in before the directory exists (review fix 1), so no signal can leave it behind.
+    let dir;
+    const listeners = CLEANUP_SIGNALS.map((signal) => [
+        signal,
+        () => {
+            // The directory goes before the listeners: a second signal meanwhile runs this again, harmlessly.
+            if (dir !== undefined)
+                (0, node_fs_1.rmSync)(dir, { recursive: true, force: true });
+            release();
+            process.kill(process.pid, signal);
+        },
+    ]);
+    let held = true;
+    function release() {
+        if (!held)
+            return;
+        held = false;
+        for (const [signal, listener] of listeners)
+            process.removeListener(signal, listener);
+    }
+    for (const [signal, listener] of listeners)
+        process.on(signal, listener);
+    try {
+        dir = (0, node_fs_1.mkdtempSync)((0, node_path_1.join)((0, node_os_1.tmpdir)(), 'wingfoil-run-'));
+        const paths = {};
+        for (const name of Object.keys(RUN_FILE_BASENAMES).sort()) {
+            const text = files[name];
+            if (text === undefined)
+                continue;
+            const path = (0, node_path_1.join)(dir, RUN_FILE_BASENAMES[name]);
+            (0, node_fs_1.writeFileSync)(path, text, { encoding: 'utf-8', mode: 0o600 });
+            paths[name] = path;
+        }
+        return await work(paths, release);
+    }
+    finally {
+        // Removed before the last listeners come out, so no signal in between can leave it behind.
+        if (dir !== undefined)
+            (0, node_fs_1.rmSync)(dir, { recursive: true, force: true });
+        release();
+    }
+}
+/** Whether `path` is a regular file this process may execute. */
+function isExecutableFile(path) {
+    try {
+        if (!(0, node_fs_1.statSync)(path).isFile())
+            return false;
+        (0, node_fs_1.accessSync)(path, node_fs_1.constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * §3.3 step 4: whether the adapter's `command` can be started — a name holding no path separator is
+ * looked up on `searchPath` (`PATH`), in order; anything else is a path, resolved against the project
+ * root when relative. Either way it must be an executable regular file. Nothing is run, and no shell is
+ * involved (`dl-090` Q3 (a)).
+ */
+function agentCommandFound(root, command, searchPath) {
+    if ((0, node_path_1.isAbsolute)(command) || command.includes('/') || command.includes('\\'))
+        return isExecutableFile((0, node_path_1.resolve)(root, command));
+    const extensions = process.platform === 'win32' ? ['', ...(process.env.PATHEXT ?? '.EXE;.CMD;.BAT').split(';')] : [''];
+    return (searchPath ?? '')
+        .split(node_path_1.delimiter)
+        .filter((dir) => dir !== '')
+        .some((dir) => extensions.some((extension) => isExecutableFile((0, node_path_1.join)(dir, `${command}${extension}`))));
+}
+/**
+ * §3.2 step 4 (the role already checked): with `agentName`, that `team.agents` entry, which must
+ * execute `role` and declare an `adapter`; without it, the first entry in declared order that does both.
+ */
+function selectAgent(dna, role, agentName) {
+    const agents = dna.team.agents ?? [];
+    const refuse = (message) => (0, types_1.coreErr)({ code: 'VALIDATION', message });
+    if (agentName === undefined) {
+        const found = agents.find((agent) => agent.adapter !== undefined && agent.executes_as.includes(role));
+        return found === undefined ? refuse(`no agent in dna.yaml with an adapter executes as role '${role}'`) : (0, types_1.coreOk)(found);
+    }
+    const named = agents.find((agent) => agent.name === agentName);
+    if (named === undefined)
+        return refuse(`unknown agent '${agentName}'`);
+    if (!named.executes_as.includes(role))
+        return refuse(`agent '${agentName}' does not execute as role '${role}'`);
+    if (named.adapter === undefined)
+        return refuse(`agent '${agentName}' declares no adapter`);
+    return (0, types_1.coreOk)(named);
+}
+/** `text` on one line, every spelling of `root` removed (`<root>/x` → `x`), so no absolute path leaks. */
+function withoutRoot(text, root) {
+    return text.replace(/\s*\n\s*/g, '; ').trim().split(`${root}/`).join('').split(root).join('.');
+}
+/**
+ * §3.3 step 11: start the server, complete MCP `initialize`, get the `{role}-session` Prompt with
+ * `element` and `state`, read the session Resource the bootstrap names (§2.4, task-236), and close. The
+ * project's own registration (`.mcp.json`) is not read (§2.5). Any failure — the server does not start,
+ * exits, refuses the Prompt or the Resource, returns no text, or exceeds `timeoutMs` — is `IO` with
+ * P5.4.3 sc. 3's message verbatim, its cause as a `dl-055` detail line with the project root removed.
+ *
+ * Both carriers are checked, the Prompt first: the agent reads the Resource, and the Prompt serves the same
+ * text to a client that gets Prompts; one deadline covers the whole exchange.
+ */
+async function mcpPreflight(input) {
+    const env = Object.fromEntries(Object.entries(process.env).filter((entry) => entry[1] !== undefined));
+    const transport = new stdio_js_1.StdioClientTransport({ command: input.server.command, args: [...input.server.args], cwd: input.root, env, stderr: 'pipe' });
+    let serverStderr = '';
+    transport.stderr?.on('data', (chunk) => {
+        serverStderr += chunk.toString();
+    });
+    const client = new index_js_1.Client({ name: 'wingfoil-agent-execute', version: '1' }, { capabilities: {} });
+    // One deadline for the whole exchange, start-up included (task-218's review: a limit per request let
+    // the pre-flight take about twice it against REQ-PERF-01's 30 s).
+    let timer;
+    const deadline = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => reject(new Error(`no answer within ${input.timeoutMs} ms`)), input.timeoutMs);
+    });
+    const exchange = async () => {
+        await client.connect(transport, { timeout: input.timeoutMs });
+        const prompt = await client.getPrompt({ name: `${input.role}-session`, arguments: { element: input.element, state: input.stateRef } }, { timeout: input.timeoutMs });
+        const content = prompt.messages[0]?.content;
+        if (content === undefined || content.type !== 'text' || content.text === '') {
+            throw new Error(`the ${input.role}-session prompt returned no context text`);
+        }
+        // task-236: the Resource the bootstrap names — what the agent will actually read.
+        const uri = sessionContextUri(input.role, input.element, input.stateRef);
+        const resource = await client.readResource({ uri }, { timeout: input.timeoutMs });
+        const entry = resource.contents[0];
+        if (entry === undefined || !('text' in entry) || entry.text === '') {
+            throw new Error(`the session resource ${uri} returned no context text`);
+        }
+    };
+    try {
+        await Promise.race([exchange(), deadline]);
+        return (0, types_1.coreOk)(undefined);
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : String(error);
+        const said = serverStderr.trim().split('\n').filter((line) => line.trim() !== '').pop();
+        const cause = withoutRoot(said === undefined ? reason : `${reason} (server: ${said})`, input.root);
+        return (0, types_1.coreErr)({ code: 'IO', message: exports.MCP_UNREACHABLE_MESSAGE, details: { cause, issues: [{ detail: cause }] } });
+    }
+    finally {
+        clearTimeout(timer);
+        await client.close().catch(() => undefined);
+    }
+}
+/** The process's own terminals: stdin and stdout both. */
+function processHasTerminal() {
+    return process.stdin.isTTY === true && process.stdout.isTTY === true;
+}
+/** `VALIDATION` from a loader's `ValidationError`, its issues as `dl-055` details. */
+function validationRefusal(error) {
+    return (0, types_1.coreErr)({ code: 'VALIDATION', message: error.message, details: { issues: error.issues } });
+}
+/** The committed pillar files the pipeline reads, or the refusal of an absent or invalid one. */
+function loadCommittedConfig(root, sha) {
+    try {
+        const dna = (0, loaders_1.loadDnaYamlAtRev)(root, sha);
+        if (dna === null)
+            return (0, types_1.coreErr)({ code: 'NOT_FOUND', message: `${loaders_1.DNA_YAML_PATH} is not committed at HEAD, which agent execute reads: commit it first` });
+        const memoryYaml = (0, loaders_1.loadMemoryYamlAtRev)(root, sha);
+        if (memoryYaml === null)
+            return (0, types_1.coreErr)({ code: 'NOT_FOUND', message: `${loaders_1.MEMORY_YAML_PATH} is not committed at HEAD, which agent execute reads: commit it first` });
+        return (0, types_1.coreOk)({ dna, memoryYaml });
+    }
+    catch (error) {
+        if (error instanceof validation_1.ValidationError)
+            return validationRefusal(error);
+        throw error;
+    }
+}
+/**
+ * §3.2 step 2: the element must exist at `HEAD` → else `NOT_FOUND` `element not found: <type>:<id>`, the
+ * documents the scan could not read as `details.unreadable` (task-171) so the refusal does not read as
+ * a bare absence. An archived element is found here and refused by the context builder.
+ */
+function requireElement(root, sha, memoryYaml, element) {
+    const unreadable = [];
+    const found = (0, query_1.findMemoryDocumentByTypeAndIdAtRev)(root, sha, memoryYaml, element.type, element.id, {
+        includeArchived: true,
+        onDiagnostic: (diagnostic) => unreadable.push(diagnostic),
+    });
+    if (found !== undefined)
+        return (0, types_1.coreOk)(found.path);
+    return (0, types_1.coreErr)({
+        code: 'NOT_FOUND',
+        message: `element not found: ${element.type}:${element.id}`,
+        ...(unreadable.length > 0 ? { details: unreadableDetails(unreadable.map(validation_1.formatDiagnostic)) } : {}),
+    });
+}
+/**
+ * `details` naming the documents a scan could not read: `unreadable` (task-171's key) and the same
+ * lines as `dl-055` detail lines, so the CLI and the MCP surface show them (`errorDetails`).
+ */
+function unreadableDetails(lines) {
+    return { unreadable: lines, issues: lines.map((detail) => ({ detail })) };
+}
+/** Root-relative path of the element type's template file, or `undefined` when the type declares none. */
+function templatePathOf(memoryYaml, type) {
+    const file = memoryYaml.types[type]?.template?.file;
+    return file === undefined ? undefined : `.wingfoil/${file}`;
+}
+/** Whether the element type's template, at `sha`, has a `## Execution Notes` heading line (§2.4). */
+function templateHasExecutionNotes(root, sha, templatePath) {
+    if (templatePath === undefined)
+        return false;
+    const text = (0, storage_1.readPathAtRev)(root, sha, templatePath);
+    return text !== null && (0, run_log_1.executionNotesSection)(text) !== null;
+}
+/**
+ * Run `agent execute`'s pipeline up to the spawn (§3.3 steps 2–12, see the module doc), then
+ * `launch` with the prepared launch, while its temporary files exist. Warnings go through the warning
+ * sink as they arise. Returns the first refusal, or what `launch` returns.
+ *
+ * @param root - The project root, already known to be initialized.
+ */
+async function agentExecutePipeline(root, request, host, launch) {
+    // Each distinct warning is printed once — the pipeline and the context builder both load dna.yaml
+    // (task-218's review F5) — and a label naming the resolved commit reads `HEAD:`, the baseline every
+    // read of the run is at (spec-008 §11).
+    let sha;
+    return (0, warning_1.withDistinctWarnings)(() => runPipeline(root, request, host, launch, (resolved) => (sha = resolved)), (text) => (sha === undefined ? text : text.split(`${sha}:`).join('HEAD:')));
+}
+/** {@link agentExecutePipeline}'s body; `onHead` learns the commit step 2 resolved. */
+async function runPipeline(root, request, host, launch, onHead) {
+    // Step 2 — one HEAD, every gating read at it. A step form reads the deduction first, so the HEAD it was
+    // deduced at is the one every later read takes (task-235); a registry error refuses here.
+    const deduced = request.step === undefined ? undefined : (0, step_1.readNextAtHead)(root, request.step.workflow);
+    if (deduced !== undefined && !deduced.ok && deduced.error.code === 'VALIDATION')
+        return deduced;
+    let sha;
+    try {
+        // The deduction of a repository with no commit has no commit either: resolving HEAD then refuses it.
+        sha = deduced?.ok === true && deduced.value.baseline.commit !== '' ? deduced.value.baseline.commit : (0, revision_1.resolveRevision)(root, 'HEAD');
+    }
+    catch (error) {
+        if (error instanceof revision_1.RevisionError)
+            return (0, types_1.coreErr)(error.toCoreError());
+        throw error;
+    }
+    onHead(sha);
+    const config = loadCommittedConfig(root, sha);
+    if (!config.ok)
+        return config;
+    const { dna, memoryYaml } = config.value;
+    for (const diagnostic of (0, discovery_1.adapterTreeDiagnosticsAtRev)(root, sha))
+        (0, warning_1.reportWarning)((0, validation_1.formatDiagnostic)(diagnostic));
+    // A name in both built-in/ and custom/ is refused where the tree is listed (§2.1), before resolution.
+    // Every adapter read takes the one resolved commit, spelled `HEAD` in messages (task-235's review F3).
+    const duplicate = (0, discovery_1.duplicateAdapterRefusal)(root, sha, 'HEAD');
+    if (duplicate !== undefined)
+        return duplicate;
+    // Step 3 — resolution (§3.2 steps 1–5).
+    // §3.2 step 1 — the step (a step form only), which names the run's workflow and phase.
+    let step;
+    if (deduced !== undefined) {
+        if (!deduced.ok)
+            return deduced;
+        const selected = (0, step_1.selectFrontierStep)(deduced.value, request.step.key);
+        if (!selected.ok)
+            return selected;
+        step = selected.value;
+    }
+    // §3.2 step 2 — the element: `--element`, else the step's; it must exist at HEAD.
+    let target;
+    if (step === undefined) {
+        target = request.element; // the stepless form always names its element (the caller's usage check)
+    }
+    else {
+        const stepElement = (0, step_1.stepTargetElement)(step, deduced.ok ? deduced.value.instance : null, request.element);
+        if (!stepElement.ok)
+            return stepElement;
+        target = stepElement.value;
+    }
+    const elementRef = `${target.type}:${target.id}`;
+    const element = requireElement(root, sha, memoryYaml, target);
+    if (!element.ok)
+        return element;
+    // §3.2 step 3 — the role: `--role`, else the step's, else (stepless) the developer default, with a warning.
+    let role;
+    if (step === undefined) {
+        if (request.role === undefined)
+            (0, warning_1.reportWarning)(exports.DEFAULT_ROLE_WARNING);
+        role = request.role ?? exports.DEFAULT_ROLE;
+    }
+    else {
+        const stepRole = (0, step_1.resolveStepRole)(dna, step, request.role);
+        if (!stepRole.ok)
+            return stepRole;
+        role = stepRole.value;
+    }
+    if (!(0, roles_1.isRoleDefined)(dna, role))
+        return (0, types_1.coreErr)({ code: 'VALIDATION', message: `unknown role '${role}' (not defined in dna.yaml)` });
+    if (role === approval_authority_1.APPROVER_ROLE)
+        return (0, types_1.coreErr)({ code: 'VALIDATION', message: `role '${approval_authority_1.APPROVER_ROLE}' is never executed by an agent` });
+    const agent = selectAgent(dna, role, request.agent);
+    if (!agent.ok)
+        return agent;
+    const adapter = (0, discovery_1.loadAdapter)(root, agent.value.adapter, sha, 'HEAD');
+    if (!adapter.ok)
+        return adapter;
+    const manifest = adapter.value.manifest;
+    // Step 4 — the agent CLI can be started.
+    if (!agentCommandFound(root, manifest.command, host.searchPath ?? process.env.PATH)) {
+        return (0, types_1.coreErr)({ code: 'IO', message: `agent command '${manifest.command}' not found (adapter '${adapter.value.name}')` });
+    }
+    // Step 5 — the identity the record commit (step 17) needs.
+    const identity = (0, git_identity_1.requireGitIdentity)(root);
+    if (!identity.ok)
+        return identity;
+    // Step 6 — the run log, declared and unmodified (`paths` is passthrough; `runs` is spec-016 §4.1's).
+    const runs = dna.paths?.['runs'];
+    const logPath = (0, run_log_1.runLogPreflight)(root, runs, target.id);
+    if (!logPath.ok)
+        return logPath;
+    // Step 7 — the context, assembled and validated at state_ref.
+    const assembled = (0, context_1.assembleExecutionContext)(root, { role, element: target, stateRef: sha });
+    // The element was found at this same commit (step 3), so the builder's NOT_FOUND with
+    // `details.unreadable` cannot arise here; its refusals pass through as they are.
+    if (!assembled.ok)
+        return assembled;
+    // Step 8 — its warnings, before the pre-flight (dl-050 option 4); the notes reach the agent with the Prompt.
+    for (const warning of [...assembled.value.context.warnings, ...(assembled.warnings ?? [])]) {
+        (0, warning_1.reportWarning)(warning);
+    }
+    // Step 9 — the run id.
+    // `n` counts per (element, phase), whatever the workflow (§4.3).
+    const phase = step?.phase ?? run_log_1.ADHOC_PHASE;
+    const runId = (0, run_log_1.nextRunId)(root, { logPath: logPath.value, element: elementRef, phase, stateRef: sha });
+    if (!runId.ok)
+        return runId;
+    // Step 10 — the bootstrap and the temporary files.
+    const templatePath = templatePathOf(memoryYaml, target.type);
+    const bootstrap = renderBootstrap({
+        role,
+        element: elementRef,
+        runId: runId.value,
+        stateRef: sha,
+        handoff: handoffLine(templateHasExecutionNotes(root, sha, templatePath)),
+        // A team.agents entry that declares an adapter declares an email (dna.yaml schema, dl-158 Rule 2 (ii)).
+        agent: { name: agent.value.name, email: agent.value.email ?? '' },
+    });
+    const mcpServer = host.mcpServer ?? runningBuildMcpServer();
+    const files = {
+        ...(manifest.prompt.via === 'file' ? { bootstrap_file: bootstrap } : {}),
+        ...(manifest.mcp.via === 'config-file' ? { mcp_config_file: renderMcpTemplate(manifest.mcp.template, mcpServer) } : {}),
+    };
+    // Under `config-arg` the rendered template is not a file but one whole argv element (§2.3 `{mcp_config}`).
+    const mcpConfig = manifest.mcp.via === 'config-arg' ? renderMcpTemplate(manifest.mcp.template, mcpServer) : undefined;
+    return withRunFiles(files, async (paths, releaseSignals) => {
+        // Step 11 — the MCP pre-flight.
+        const preflight = await mcpPreflight({
+            root,
+            server: mcpServer,
+            role,
+            element: elementRef,
+            stateRef: sha,
+            timeoutMs: host.mcpTimeoutMs ?? exports.MCP_PREFLIGHT_TIMEOUT_MS,
+        });
+        if (!preflight.ok)
+            return preflight;
+        // Step 12 — the terminal check, last.
+        const isTerminal = host.isTerminal ?? processHasTerminal;
+        if (manifest.launch.interactive.terminal === 'required' && !isTerminal()) {
+            return (0, types_1.coreErr)({ code: 'VALIDATION', message: 'interactive launch needs a terminal on stdin and stdout' });
+        }
+        return launch({
+            runId: runId.value,
+            element: elementRef,
+            workflow: step?.workflow ?? run_log_1.NO_WORKFLOW,
+            phase,
+            role,
+            // Every v0.3 run is fresh, whatever the step's allowedModes; the phase's separation of executors is not checked (§3.2 step 6, P4.12 in v1.0).
+            mode: exports.FRESH_MODE,
+            agent: agent.value,
+            adapter: adapter.value,
+            stateRef: sha,
+            logPath: logPath.value,
+            elementPath: element.value,
+            templatePath,
+            bootstrap,
+            mcpServer,
+            files: paths,
+            mcpConfig,
+        }, releaseSignals);
+    });
+}
+/** The plan of `prepared` (a pure function of it, host paths excluded). */
+function launchPlan(prepared) {
+    return {
+        dryRun: true,
+        subject: (0, run_log_1.recordSubject)(prepared.runId),
+        paths: [prepared.logPath],
+        run: {
+            id: prepared.runId,
+            element: prepared.element,
+            workflow: prepared.workflow,
+            phase: prepared.phase,
+            role: prepared.role,
+            mode: prepared.mode,
+            agent: prepared.agent.name,
+            adapter: `${prepared.adapter.kind}/${prepared.adapter.name}`,
+            state_ref: prepared.stateRef,
+        },
+        bootstrap: prepared.bootstrap,
+    };
+}
+//# sourceMappingURL=execute.js.map

package/dist/agent/execute.js.map

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

package/dist/agent/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * `agent` module — launching an agent's own CLI through a declared adapter (`adr-012`,
+ * `spec-016-agent-execution` §1). It owns adapter manifest loading and validation (task-177: the strict
+ * schema §2.2, the placeholder rules §2.3, discovery and loading at a revision §2.1, §3.2 step 5, and
+ * the report of what under `.wingfoil/agents/` is not an adapter, `bug-290`), the run log (task-206),
+ * `agent execute`'s pipeline up to the spawn (task-218, `./execute.ts`) and the launch (task-228,
+ * `./launch.ts`). Its operations are registered under the `agent` `CoreModule` (`src/core/index.ts`).
+ */
+export declare const MODULE_NAME: "agent";
+export { ADAPTER_MANIFEST_FORMAT, AdapterManifest } from './schema';
+export { E_ADAPTER_MANIFEST, parseAdapterManifest } from './manifest';
+export type { AdapterKind, AdapterSource } from './manifest';
+export { ADAPTER_PLACEHOLDERS, E_ADAPTER_PLACEHOLDER, placeholderIssues, requiredPlaceholderIssues } from './placeholders';
+export type { AdapterPlaceholder } from './placeholders';
+export { adapterTreeDiagnosticsAtRev, ADAPTERS_DIR_PATH, duplicateAdapterRefusal, E_ADAPTER_DUPLICATE, listAdaptersAtRev, loadAdapter, W_ADAPTER_IGNORED } from './discovery';
+export type { AdapterEntry, LoadedAdapter } from './discovery';
+export { ADHOC_PHASE, deriveNotesField, executionNotesSection, formatRunId, isRunId, isRunLogPath, nextRunId, NO_WORKFLOW, NOT_REPORTED, notesField, parseRunLog, readRunLogAt, readRunLogsAt, recordRun, recordSubject, requireWritableRunLog, resolveRunLogPath, runIdElementId, RUN_RECORD_KEYS, RUN_TOKEN_KEYS, runLogDirPrefix, runLogPreflight, serializeRunRecord, } from './run-log';
+export type { DeriveNotesFieldInput, NextRunIdInput, NotesFieldInput, RecordedRun, ReportedCount, RunRecord, RunTokens, } from './run-log';
+export { assignedSessionId, launchAgent, launchBanner, LOOKUP_TIMEOUT_MS, readJsonPath, renderLaunchArgv, runSummaryLine, SESSION_ID_NAMESPACE, uuidV5, } from './launch';
+export type { LaunchHost, LaunchInput, LaunchValues, RecordedLaunch, SpawnAgent } from './launch';
+export { agentCommandFound, attributionLine, ATTRIBUTION_LINE_PREFIX, agentExecutePipeline, DEFAULT_ROLE, DEFAULT_ROLE_WARNING, FRESH_MODE, handoffLine, launchPlan, MCP_PREFLIGHT_TIMEOUT_MS, MCP_UNREACHABLE_MESSAGE, mcpPreflight, renderBootstrap, renderMcpTemplate, runningBuildMcpServer, selectAgent, withRunFiles, } from './execute';
+export type { AgentExecuteHost, AgentExecuteRequest, AgentLaunchPlan, BootstrapInput, McpPreflightInput, McpServerCommand, PreparedLaunch, RunFileName, } from './execute';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAG,OAAgB,CAAC;AAE5C,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3H,YAAY,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC9K,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACX,OAAO,EACP,YAAY,EACZ,SAAS,EACT,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,SAAS,EACT,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,eAAe,EACf,kBAAkB,GACnB,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,WAAW,EACX,aAAa,EACb,SAAS,EACT,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,MAAM,GACP,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,UAAU,EACV,wBAAwB,EACxB,uBAAuB,EACvB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,YAAY,GACb,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,WAAW,GACZ,MAAM,WAAW,CAAC"}