wingfoil 0.2.2 → 0.3.0

package/dist/agent/index.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attributionLine = exports.agentCommandFound = exports.uuidV5 = exports.SESSION_ID_NAMESPACE = exports.runSummaryLine = exports.renderLaunchArgv = exports.readJsonPath = exports.LOOKUP_TIMEOUT_MS = exports.launchBanner = exports.launchAgent = exports.assignedSessionId = exports.serializeRunRecord = exports.runLogPreflight = exports.runLogDirPrefix = exports.RUN_TOKEN_KEYS = exports.RUN_RECORD_KEYS = exports.runIdElementId = exports.resolveRunLogPath = exports.requireWritableRunLog = exports.recordSubject = exports.recordRun = exports.readRunLogsAt = exports.readRunLogAt = exports.parseRunLog = exports.notesField = exports.NOT_REPORTED = exports.NO_WORKFLOW = exports.nextRunId = exports.isRunLogPath = exports.isRunId = exports.formatRunId = exports.executionNotesSection = exports.deriveNotesField = exports.ADHOC_PHASE = exports.W_ADAPTER_IGNORED = exports.loadAdapter = exports.listAdaptersAtRev = exports.E_ADAPTER_DUPLICATE = exports.duplicateAdapterRefusal = exports.ADAPTERS_DIR_PATH = exports.adapterTreeDiagnosticsAtRev = exports.requiredPlaceholderIssues = exports.placeholderIssues = exports.E_ADAPTER_PLACEHOLDER = exports.ADAPTER_PLACEHOLDERS = exports.parseAdapterManifest = exports.E_ADAPTER_MANIFEST = exports.AdapterManifest = exports.ADAPTER_MANIFEST_FORMAT = exports.MODULE_NAME = void 0;
+exports.withRunFiles = exports.selectAgent = exports.runningBuildMcpServer = exports.renderMcpTemplate = exports.renderBootstrap = exports.mcpPreflight = exports.MCP_UNREACHABLE_MESSAGE = exports.MCP_PREFLIGHT_TIMEOUT_MS = exports.launchPlan = exports.handoffLine = exports.FRESH_MODE = exports.DEFAULT_ROLE_WARNING = exports.DEFAULT_ROLE = exports.agentExecutePipeline = exports.ATTRIBUTION_LINE_PREFIX = void 0;
+/**
+ * `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`).
+ */
+exports.MODULE_NAME = 'agent';
+var schema_1 = require("./schema");
+Object.defineProperty(exports, "ADAPTER_MANIFEST_FORMAT", { enumerable: true, get: function () { return schema_1.ADAPTER_MANIFEST_FORMAT; } });
+Object.defineProperty(exports, "AdapterManifest", { enumerable: true, get: function () { return schema_1.AdapterManifest; } });
+var manifest_1 = require("./manifest");
+Object.defineProperty(exports, "E_ADAPTER_MANIFEST", { enumerable: true, get: function () { return manifest_1.E_ADAPTER_MANIFEST; } });
+Object.defineProperty(exports, "parseAdapterManifest", { enumerable: true, get: function () { return manifest_1.parseAdapterManifest; } });
+var placeholders_1 = require("./placeholders");
+Object.defineProperty(exports, "ADAPTER_PLACEHOLDERS", { enumerable: true, get: function () { return placeholders_1.ADAPTER_PLACEHOLDERS; } });
+Object.defineProperty(exports, "E_ADAPTER_PLACEHOLDER", { enumerable: true, get: function () { return placeholders_1.E_ADAPTER_PLACEHOLDER; } });
+Object.defineProperty(exports, "placeholderIssues", { enumerable: true, get: function () { return placeholders_1.placeholderIssues; } });
+Object.defineProperty(exports, "requiredPlaceholderIssues", { enumerable: true, get: function () { return placeholders_1.requiredPlaceholderIssues; } });
+var discovery_1 = require("./discovery");
+Object.defineProperty(exports, "adapterTreeDiagnosticsAtRev", { enumerable: true, get: function () { return discovery_1.adapterTreeDiagnosticsAtRev; } });
+Object.defineProperty(exports, "ADAPTERS_DIR_PATH", { enumerable: true, get: function () { return discovery_1.ADAPTERS_DIR_PATH; } });
+Object.defineProperty(exports, "duplicateAdapterRefusal", { enumerable: true, get: function () { return discovery_1.duplicateAdapterRefusal; } });
+Object.defineProperty(exports, "E_ADAPTER_DUPLICATE", { enumerable: true, get: function () { return discovery_1.E_ADAPTER_DUPLICATE; } });
+Object.defineProperty(exports, "listAdaptersAtRev", { enumerable: true, get: function () { return discovery_1.listAdaptersAtRev; } });
+Object.defineProperty(exports, "loadAdapter", { enumerable: true, get: function () { return discovery_1.loadAdapter; } });
+Object.defineProperty(exports, "W_ADAPTER_IGNORED", { enumerable: true, get: function () { return discovery_1.W_ADAPTER_IGNORED; } });
+var run_log_1 = require("./run-log");
+Object.defineProperty(exports, "ADHOC_PHASE", { enumerable: true, get: function () { return run_log_1.ADHOC_PHASE; } });
+Object.defineProperty(exports, "deriveNotesField", { enumerable: true, get: function () { return run_log_1.deriveNotesField; } });
+Object.defineProperty(exports, "executionNotesSection", { enumerable: true, get: function () { return run_log_1.executionNotesSection; } });
+Object.defineProperty(exports, "formatRunId", { enumerable: true, get: function () { return run_log_1.formatRunId; } });
+Object.defineProperty(exports, "isRunId", { enumerable: true, get: function () { return run_log_1.isRunId; } });
+Object.defineProperty(exports, "isRunLogPath", { enumerable: true, get: function () { return run_log_1.isRunLogPath; } });
+Object.defineProperty(exports, "nextRunId", { enumerable: true, get: function () { return run_log_1.nextRunId; } });
+Object.defineProperty(exports, "NO_WORKFLOW", { enumerable: true, get: function () { return run_log_1.NO_WORKFLOW; } });
+Object.defineProperty(exports, "NOT_REPORTED", { enumerable: true, get: function () { return run_log_1.NOT_REPORTED; } });
+Object.defineProperty(exports, "notesField", { enumerable: true, get: function () { return run_log_1.notesField; } });
+Object.defineProperty(exports, "parseRunLog", { enumerable: true, get: function () { return run_log_1.parseRunLog; } });
+Object.defineProperty(exports, "readRunLogAt", { enumerable: true, get: function () { return run_log_1.readRunLogAt; } });
+Object.defineProperty(exports, "readRunLogsAt", { enumerable: true, get: function () { return run_log_1.readRunLogsAt; } });
+Object.defineProperty(exports, "recordRun", { enumerable: true, get: function () { return run_log_1.recordRun; } });
+Object.defineProperty(exports, "recordSubject", { enumerable: true, get: function () { return run_log_1.recordSubject; } });
+Object.defineProperty(exports, "requireWritableRunLog", { enumerable: true, get: function () { return run_log_1.requireWritableRunLog; } });
+Object.defineProperty(exports, "resolveRunLogPath", { enumerable: true, get: function () { return run_log_1.resolveRunLogPath; } });
+Object.defineProperty(exports, "runIdElementId", { enumerable: true, get: function () { return run_log_1.runIdElementId; } });
+Object.defineProperty(exports, "RUN_RECORD_KEYS", { enumerable: true, get: function () { return run_log_1.RUN_RECORD_KEYS; } });
+Object.defineProperty(exports, "RUN_TOKEN_KEYS", { enumerable: true, get: function () { return run_log_1.RUN_TOKEN_KEYS; } });
+Object.defineProperty(exports, "runLogDirPrefix", { enumerable: true, get: function () { return run_log_1.runLogDirPrefix; } });
+Object.defineProperty(exports, "runLogPreflight", { enumerable: true, get: function () { return run_log_1.runLogPreflight; } });
+Object.defineProperty(exports, "serializeRunRecord", { enumerable: true, get: function () { return run_log_1.serializeRunRecord; } });
+var launch_1 = require("./launch");
+Object.defineProperty(exports, "assignedSessionId", { enumerable: true, get: function () { return launch_1.assignedSessionId; } });
+Object.defineProperty(exports, "launchAgent", { enumerable: true, get: function () { return launch_1.launchAgent; } });
+Object.defineProperty(exports, "launchBanner", { enumerable: true, get: function () { return launch_1.launchBanner; } });
+Object.defineProperty(exports, "LOOKUP_TIMEOUT_MS", { enumerable: true, get: function () { return launch_1.LOOKUP_TIMEOUT_MS; } });
+Object.defineProperty(exports, "readJsonPath", { enumerable: true, get: function () { return launch_1.readJsonPath; } });
+Object.defineProperty(exports, "renderLaunchArgv", { enumerable: true, get: function () { return launch_1.renderLaunchArgv; } });
+Object.defineProperty(exports, "runSummaryLine", { enumerable: true, get: function () { return launch_1.runSummaryLine; } });
+Object.defineProperty(exports, "SESSION_ID_NAMESPACE", { enumerable: true, get: function () { return launch_1.SESSION_ID_NAMESPACE; } });
+Object.defineProperty(exports, "uuidV5", { enumerable: true, get: function () { return launch_1.uuidV5; } });
+var execute_1 = require("./execute");
+Object.defineProperty(exports, "agentCommandFound", { enumerable: true, get: function () { return execute_1.agentCommandFound; } });
+Object.defineProperty(exports, "attributionLine", { enumerable: true, get: function () { return execute_1.attributionLine; } });
+Object.defineProperty(exports, "ATTRIBUTION_LINE_PREFIX", { enumerable: true, get: function () { return execute_1.ATTRIBUTION_LINE_PREFIX; } });
+Object.defineProperty(exports, "agentExecutePipeline", { enumerable: true, get: function () { return execute_1.agentExecutePipeline; } });
+Object.defineProperty(exports, "DEFAULT_ROLE", { enumerable: true, get: function () { return execute_1.DEFAULT_ROLE; } });
+Object.defineProperty(exports, "DEFAULT_ROLE_WARNING", { enumerable: true, get: function () { return execute_1.DEFAULT_ROLE_WARNING; } });
+Object.defineProperty(exports, "FRESH_MODE", { enumerable: true, get: function () { return execute_1.FRESH_MODE; } });
+Object.defineProperty(exports, "handoffLine", { enumerable: true, get: function () { return execute_1.handoffLine; } });
+Object.defineProperty(exports, "launchPlan", { enumerable: true, get: function () { return execute_1.launchPlan; } });
+Object.defineProperty(exports, "MCP_PREFLIGHT_TIMEOUT_MS", { enumerable: true, get: function () { return execute_1.MCP_PREFLIGHT_TIMEOUT_MS; } });
+Object.defineProperty(exports, "MCP_UNREACHABLE_MESSAGE", { enumerable: true, get: function () { return execute_1.MCP_UNREACHABLE_MESSAGE; } });
+Object.defineProperty(exports, "mcpPreflight", { enumerable: true, get: function () { return execute_1.mcpPreflight; } });
+Object.defineProperty(exports, "renderBootstrap", { enumerable: true, get: function () { return execute_1.renderBootstrap; } });
+Object.defineProperty(exports, "renderMcpTemplate", { enumerable: true, get: function () { return execute_1.renderMcpTemplate; } });
+Object.defineProperty(exports, "runningBuildMcpServer", { enumerable: true, get: function () { return execute_1.runningBuildMcpServer; } });
+Object.defineProperty(exports, "selectAgent", { enumerable: true, get: function () { return execute_1.selectAgent; } });
+Object.defineProperty(exports, "withRunFiles", { enumerable: true, get: function () { return execute_1.withRunFiles; } });
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":";;;;AAAA;;;;;;;GAOG;AACU,QAAA,WAAW,GAAG,OAAgB,CAAC;AAE5C,mCAAoE;AAA3D,iHAAA,uBAAuB,OAAA;AAAE,yGAAA,eAAe,OAAA;AACjD,uCAAsE;AAA7D,8GAAA,kBAAkB,OAAA;AAAE,gHAAA,oBAAoB,OAAA;AAEjD,+CAA2H;AAAlH,oHAAA,oBAAoB,OAAA;AAAE,qHAAA,qBAAqB,OAAA;AAAE,iHAAA,iBAAiB,OAAA;AAAE,yHAAA,yBAAyB,OAAA;AAElG,yCAA8K;AAArK,wHAAA,2BAA2B,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,oHAAA,uBAAuB,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,wGAAA,WAAW,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAExJ,qCAwBmB;AAvBjB,sGAAA,WAAW,OAAA;AACX,2GAAA,gBAAgB,OAAA;AAChB,gHAAA,qBAAqB,OAAA;AACrB,sGAAA,WAAW,OAAA;AACX,kGAAA,OAAO,OAAA;AACP,uGAAA,YAAY,OAAA;AACZ,oGAAA,SAAS,OAAA;AACT,sGAAA,WAAW,OAAA;AACX,uGAAA,YAAY,OAAA;AACZ,qGAAA,UAAU,OAAA;AACV,sGAAA,WAAW,OAAA;AACX,uGAAA,YAAY,OAAA;AACZ,wGAAA,aAAa,OAAA;AACb,oGAAA,SAAS,OAAA;AACT,wGAAA,aAAa,OAAA;AACb,gHAAA,qBAAqB,OAAA;AACrB,4GAAA,iBAAiB,OAAA;AACjB,yGAAA,cAAc,OAAA;AACd,0GAAA,eAAe,OAAA;AACf,yGAAA,cAAc,OAAA;AACd,0GAAA,eAAe,OAAA;AACf,0GAAA,eAAe,OAAA;AACf,6GAAA,kBAAkB,OAAA;AAWpB,mCAUkB;AAThB,2GAAA,iBAAiB,OAAA;AACjB,qGAAA,WAAW,OAAA;AACX,sGAAA,YAAY,OAAA;AACZ,2GAAA,iBAAiB,OAAA;AACjB,sGAAA,YAAY,OAAA;AACZ,0GAAA,gBAAgB,OAAA;AAChB,wGAAA,cAAc,OAAA;AACd,8GAAA,oBAAoB,OAAA;AACpB,gGAAA,MAAM,OAAA;AAGR,qCAkBmB;AAjBjB,4GAAA,iBAAiB,OAAA;AACjB,0GAAA,eAAe,OAAA;AACf,kHAAA,uBAAuB,OAAA;AACvB,+GAAA,oBAAoB,OAAA;AACpB,uGAAA,YAAY,OAAA;AACZ,+GAAA,oBAAoB,OAAA;AACpB,qGAAA,UAAU,OAAA;AACV,sGAAA,WAAW,OAAA;AACX,qGAAA,UAAU,OAAA;AACV,mHAAA,wBAAwB,OAAA;AACxB,kHAAA,uBAAuB,OAAA;AACvB,uGAAA,YAAY,OAAA;AACZ,0GAAA,eAAe,OAAA;AACf,4GAAA,iBAAiB,OAAA;AACjB,gHAAA,qBAAqB,OAAA;AACrB,sGAAA,WAAW,OAAA;AACX,uGAAA,YAAY,OAAA"}

package/dist/agent/launch.d.ts

@@ -0,0 +1,133 @@
+/**
+ * `wingfoil agent execute`, the launch half (`spec-016-agent-execution` §3.3 steps 13–18, task-228):
+ * what follows the pre-launch pipeline (`./execute.ts`) once every check has passed.
+ *
+ * 13. The banner, `run <run-id>: launching <agent> (<adapter>) as <role> on <type>:<id>`, as a notice
+ *     on stderr (`reportNotice`): the CLI renders it in the active `--format`.
+ * 14. The spawn: the adapter's `command` with `launch.interactive.args` (+ `session.assign_args` under
+ *     `session.id: assign`), every placeholder filling whole argv elements ({@link renderLaunchArgv}),
+ *     no shell, the agent inheriting stdin, stdout and stderr, its working directory the project root,
+ *     the environment passed through unchanged (`adr-012` point 1). This is REQ-PERF-01's "agent ready".
+ * 15. The wait. From the spawn until the record is committed `SIGINT` and `SIGQUIT` are ignored (the
+ *     terminal delivers them to the agent itself, in the same foreground process group) and `SIGTERM`
+ *     and `SIGHUP` are forwarded to the agent while it runs, so a run ended by a signal is still recorded
+ *     as `signal:<NAME>`.
+ * 16. The post-run lookups (§2.6): `version_args`, `session.lookup_args`, `usage.lookup_args`, each run as
+ *     `command` + argv with a time limit ({@link LOOKUP_TIMEOUT_MS}); one argv declared twice runs once.
+ *     A lookup that fails, times out or prints no JSON, and a value of the wrong type, yield
+ *     `not-reported` and a `warning:` line; the lookup never fails the run.
+ * 17. The record (§4.2), appended and committed by `recordRun` (task-206): `agent: record <run-id>`.
+ * 18. The outcome: success only when the agent exited `0` and the record was committed.
+ *
+ * **Determinism.** The argv, the session id and every record field but `duration_ms` are pure functions
+ * of committed state and the run's inputs; the temporary-file paths and the Node executable are host
+ * values that never reach the context (`spec-016` Consequences). `duration_ms` is wall-clock by design:
+ * a record of what happened, never part of a context (`dl-114` Q2).
+ */
+import { type ChildProcess, type SpawnOptions } from 'node:child_process';
+import { type CoreResult } from '../core/types';
+import type { AdapterManifest } from './schema';
+import { type RunRecord } from './run-log';
+/** How long one post-run lookup may run (§2.6, §3.3 step 16). */
+export declare const LOOKUP_TIMEOUT_MS = 10000;
+/**
+ * The namespace of the assigned session ids (§2.6): the version 5 UUID of the name
+ * `wingfoil:spec-016:session` in RFC 4122's URL namespace, fixed here so no clock or random source is
+ * involved.
+ */
+export declare const SESSION_ID_NAMESPACE = "a432dcd6-576d-5991-9503-2b23aa4139db";
+/** RFC 4122 §4.3 name-based UUID, version 5 (SHA-1) of `name` in `namespace`. */
+export declare function uuidV5(namespace: string, name: string): string;
+/**
+ * The session id WingFoil assigns (§2.6 `assign`): the v5 UUID of `<absolute repository root>\n<run id>`
+ * in {@link SESSION_ID_NAMESPACE}. Unique per clone and run, derived, never random. Per clone by design
+ * (it hashes the root): the run id is the identifier across clones (`dl-135` Q3 (a)).
+ */
+export declare function assignedSessionId(root: string, runId: string): string;
+/** The values the launch placeholders take (§2.3). */
+export interface LaunchValues {
+    readonly bootstrap: string;
+    /** Absolute paths of the temporary files the launch declared. */
+    readonly files: Partial<Record<'bootstrap_file' | 'mcp_config_file', string>>;
+    readonly mcpServer: {
+        readonly command: string;
+        readonly args: readonly string[];
+    };
+    /** The rendered `mcp.template`, passed as one whole argv element; read only under `mcp.via: config-arg`. */
+    readonly mcpConfig?: string | undefined;
+    /** The assigned session id; read only under `session.id: assign`. */
+    readonly sessionId: string;
+}
+/**
+ * The launch argv (§3.3 step 14): `launch.interactive.args` rendered, then `session.assign_args`
+ * rendered when the session id is assigned. The `command` is not part of it.
+ */
+export declare function renderLaunchArgv(manifest: AdapterManifest, values: LaunchValues): string[];
+/**
+ * The value at the dotted `path` of a JSON value (§2.2 `session.field`, `usage.fields`): each segment a
+ * key of a plain object; `undefined` when a segment is absent or the value on the way is not an object.
+ */
+export declare function readJsonPath(document: unknown, path: string): unknown;
+/** What starts the agent: `child_process.spawn`'s shape, overridable by an in-process caller (tests). */
+export type SpawnAgent = (command: string, args: readonly string[], options: SpawnOptions) => ChildProcess;
+/** The host facts the launch reads, each overridable by an in-process caller (tests). */
+export interface LaunchHost {
+    /** What starts the agent; `child_process.spawn` by default. */
+    readonly spawn?: SpawnAgent;
+    /** {@link LOOKUP_TIMEOUT_MS} by default. */
+    readonly lookupTimeoutMs?: number;
+}
+/** What the launch needs from the pre-launch pipeline (`PreparedLaunch`, `./execute.ts`). */
+export interface LaunchInput {
+    readonly runId: string;
+    /** `<type>:<id>`. */
+    readonly element: string;
+    readonly workflow: string;
+    readonly phase: string;
+    readonly role: string;
+    readonly mode: string;
+    readonly agent: {
+        readonly name: string;
+    };
+    readonly adapter: {
+        readonly name: string;
+        readonly kind: string;
+        readonly manifest: AdapterManifest;
+    };
+    readonly stateRef: string;
+    readonly logPath: string;
+    /** Root-relative path of the element's document at `state_ref`. */
+    readonly elementPath: string;
+    /** Root-relative path of the element type's template file, when the type declares one. */
+    readonly templatePath: string | undefined;
+    readonly bootstrap: string;
+    readonly mcpServer: {
+        readonly command: string;
+        readonly args: readonly string[];
+    };
+    readonly files: Partial<Record<'bootstrap_file' | 'mcp_config_file', string>>;
+    /** The rendered `mcp.template` under `mcp.via: config-arg` (§2.3 `{mcp_config}`); `undefined` otherwise. */
+    readonly mcpConfig?: string | undefined;
+}
+/** A launched run, recorded: what `agent execute` reports (§3.4's `{ "run": <record> }`). */
+export interface RecordedLaunch {
+    readonly run: RunRecord;
+    /** The `agent: record <run-id>` commit. */
+    readonly sha: string;
+}
+/** §3.4's post-run summary line, without a prefix. */
+export declare function runSummaryLine(record: RunRecord, sha: string): string;
+/** The step-13 banner (§3.3), without a prefix. */
+export declare function launchBanner(input: LaunchInput): string;
+/**
+ * §3.3 steps 13–18 for a launch every pre-launch check has passed. `releaseSignals` is called right
+ * before the spawn, after the launch has installed its own listeners: it hands the process's signals
+ * over from the pre-launch cleanup (`withRunFiles`) to the launch (§3.3 step 15) with no gap between.
+ *
+ * @returns The recorded run (the agent exited `0` and the record was committed); otherwise `IO`
+ *   `agent command '<command>' could not be started …` (no run, no record), `IO` `agent exited
+ *   <exit_status>; run <run-id> recorded` with `details: {run_id, exit_status}` and the summary as a
+ *   detail line, or `recordRun`'s refusal, the record in its `details` (the run is never lost).
+ */
+export declare function launchAgent(root: string, input: LaunchInput, host: LaunchHost, releaseSignals: () => void): Promise<CoreResult<RecordedLaunch>>;
+//# sourceMappingURL=launch.d.ts.map

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

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

package/dist/agent/launch.js

@@ -0,0 +1,380 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_ID_NAMESPACE = exports.LOOKUP_TIMEOUT_MS = void 0;
+exports.uuidV5 = uuidV5;
+exports.assignedSessionId = assignedSessionId;
+exports.renderLaunchArgv = renderLaunchArgv;
+exports.readJsonPath = readJsonPath;
+exports.runSummaryLine = runSummaryLine;
+exports.launchBanner = launchBanner;
+exports.launchAgent = launchAgent;
+/**
+ * `wingfoil agent execute`, the launch half (`spec-016-agent-execution` §3.3 steps 13–18, task-228):
+ * what follows the pre-launch pipeline (`./execute.ts`) once every check has passed.
+ *
+ * 13. The banner, `run <run-id>: launching <agent> (<adapter>) as <role> on <type>:<id>`, as a notice
+ *     on stderr (`reportNotice`): the CLI renders it in the active `--format`.
+ * 14. The spawn: the adapter's `command` with `launch.interactive.args` (+ `session.assign_args` under
+ *     `session.id: assign`), every placeholder filling whole argv elements ({@link renderLaunchArgv}),
+ *     no shell, the agent inheriting stdin, stdout and stderr, its working directory the project root,
+ *     the environment passed through unchanged (`adr-012` point 1). This is REQ-PERF-01's "agent ready".
+ * 15. The wait. From the spawn until the record is committed `SIGINT` and `SIGQUIT` are ignored (the
+ *     terminal delivers them to the agent itself, in the same foreground process group) and `SIGTERM`
+ *     and `SIGHUP` are forwarded to the agent while it runs, so a run ended by a signal is still recorded
+ *     as `signal:<NAME>`.
+ * 16. The post-run lookups (§2.6): `version_args`, `session.lookup_args`, `usage.lookup_args`, each run as
+ *     `command` + argv with a time limit ({@link LOOKUP_TIMEOUT_MS}); one argv declared twice runs once.
+ *     A lookup that fails, times out or prints no JSON, and a value of the wrong type, yield
+ *     `not-reported` and a `warning:` line; the lookup never fails the run.
+ * 17. The record (§4.2), appended and committed by `recordRun` (task-206): `agent: record <run-id>`.
+ * 18. The outcome: success only when the agent exited `0` and the record was committed.
+ *
+ * **Determinism.** The argv, the session id and every record field but `duration_ms` are pure functions
+ * of committed state and the run's inputs; the temporary-file paths and the Node executable are host
+ * values that never reach the context (`spec-016` Consequences). `duration_ms` is wall-clock by design:
+ * a record of what happened, never part of a context (`dl-114` Q2).
+ */
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
+const node_path_1 = require("node:path");
+const node_perf_hooks_1 = require("node:perf_hooks");
+const storage_1 = require("../storage");
+const warning_1 = require("../validation/warning");
+const types_1 = require("../core/types");
+const run_log_1 = require("./run-log");
+/**
+ * How much one post-run lookup may print before it is stopped (§2.6): `execFile`'s `maxBuffer`, which
+ * bounds stdout and stderr each, so a lookup with valid stdout and over 1 MiB on stderr loses its values.
+ */
+const LOOKUP_MAX_BYTES = 1024 * 1024;
+/** How long one post-run lookup may run (§2.6, §3.3 step 16). */
+exports.LOOKUP_TIMEOUT_MS = 10000;
+/**
+ * The namespace of the assigned session ids (§2.6): the version 5 UUID of the name
+ * `wingfoil:spec-016:session` in RFC 4122's URL namespace, fixed here so no clock or random source is
+ * involved.
+ */
+exports.SESSION_ID_NAMESPACE = 'a432dcd6-576d-5991-9503-2b23aa4139db';
+/** RFC 4122 §4.3 name-based UUID, version 5 (SHA-1) of `name` in `namespace`. */
+function uuidV5(namespace, name) {
+    const hash = (0, node_crypto_1.createHash)('sha1')
+        .update(Buffer.concat([Buffer.from(namespace.replace(/-/g, ''), 'hex'), Buffer.from(name, 'utf-8')]))
+        .digest();
+    const bytes = Buffer.from(hash.subarray(0, 16));
+    bytes[6] = (bytes[6] & 0x0f) | 0x50;
+    bytes[8] = (bytes[8] & 0x3f) | 0x80;
+    const hex = bytes.toString('hex');
+    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+/**
+ * The session id WingFoil assigns (§2.6 `assign`): the v5 UUID of `<absolute repository root>\n<run id>`
+ * in {@link SESSION_ID_NAMESPACE}. Unique per clone and run, derived, never random. Per clone by design
+ * (it hashes the root): the run id is the identifier across clones (`dl-135` Q3 (a)).
+ */
+function assignedSessionId(root, runId) {
+    return uuidV5(exports.SESSION_ID_NAMESPACE, `${root}\n${runId}`);
+}
+/** One argv template rendered: each `{name}` element replaced by its value, `{mcp_args}` by several. */
+function renderArgv(template, values) {
+    const single = {
+        '{bootstrap}': values.bootstrap,
+        '{bootstrap_file}': values.files.bootstrap_file,
+        '{mcp_config_file}': values.files.mcp_config_file,
+        '{mcp_config}': values.mcpConfig,
+        '{mcp_command}': values.mcpServer.command,
+        '{session_id}': values.sessionId,
+    };
+    return template.flatMap((element) => {
+        if (element === '{mcp_args}')
+            return [...values.mcpServer.args];
+        // The manifest validator admits a placeholder only as a whole element, and only where it has a
+        // value (§2.3), so every token here is one of these.
+        return [single[element] ?? element];
+    });
+}
+/**
+ * The launch argv (§3.3 step 14): `launch.interactive.args` rendered, then `session.assign_args`
+ * rendered when the session id is assigned. The `command` is not part of it.
+ */
+function renderLaunchArgv(manifest, values) {
+    const assign = manifest.session.id === 'assign' ? (manifest.session.assign_args ?? []) : [];
+    return [...renderArgv(manifest.launch.interactive.args, values), ...renderArgv(assign, values)];
+}
+/**
+ * The value at the dotted `path` of a JSON value (§2.2 `session.field`, `usage.fields`): each segment a
+ * key of a plain object; `undefined` when a segment is absent or the value on the way is not an object.
+ */
+function readJsonPath(document, path) {
+    let value = document;
+    for (const key of path.split('.')) {
+        if (typeof value !== 'object' || value === null || Array.isArray(value))
+            return undefined;
+        if (!Object.prototype.hasOwnProperty.call(value, key))
+            return undefined;
+        value = value[key];
+    }
+    return value;
+}
+/** The agent's `command`, as spawned: a name stays a name (the OS searches `PATH`), a path is resolved against the root. */
+function commandToSpawn(root, command) {
+    return (0, node_path_1.isAbsolute)(command) || command.includes('/') || command.includes('\\') ? (0, node_path_1.resolve)(root, command) : command;
+}
+/** The signals `agent execute` takes over while the agent runs (§3.3 step 15). */
+const IGNORED_SIGNALS = process.platform === 'win32' ? ['SIGINT'] : ['SIGINT', 'SIGQUIT'];
+const FORWARDED_SIGNALS = process.platform === 'win32' ? ['SIGTERM'] : ['SIGTERM', 'SIGHUP'];
+/**
+ * Install §3.3 step 15's signal handling **before the spawn** (review fix 1: a signal between the
+ * pre-launch cleanup's release and the spawn must neither kill `agent execute` nor orphan the agent):
+ * `SIGINT`/`SIGQUIT` ignored, `SIGTERM`/`SIGHUP` forwarded to the agent while it runs. One that arrives
+ * before the agent exists is remembered and sent as soon as it is attached; once the agent has exited
+ * they are ignored, until the record is committed.
+ */
+function takeOverSignals() {
+    let child;
+    let pending;
+    const forward = (signal) => {
+        if (child === undefined)
+            pending = signal;
+        else if (child.exitCode === null && child.signalCode === null)
+            child.kill(signal);
+    };
+    const installed = [
+        ...IGNORED_SIGNALS.map((signal) => [signal, () => undefined]),
+        ...FORWARDED_SIGNALS.map((signal) => [signal, () => forward(signal)]),
+    ];
+    for (const [signal, listener] of installed)
+        process.on(signal, listener);
+    return {
+        attach(spawned) {
+            child = spawned;
+            if (pending !== undefined)
+                forward(pending);
+        },
+        restore() {
+            for (const [signal, listener] of installed)
+                process.removeListener(signal, listener);
+        },
+    };
+}
+/** Spawn the agent and wait for it: its exit status and the wall-clock duration, or why it could not start. */
+function runAgent(spawnAgent, command, args, root, onSpawn) {
+    return new Promise((settle) => {
+        let child;
+        const start = node_perf_hooks_1.performance.now();
+        try {
+            child = spawnAgent(command, args, { cwd: root, stdio: 'inherit', env: process.env });
+        }
+        catch (error) {
+            settle({ ok: false, reason: error instanceof Error ? error.message : String(error) });
+            return;
+        }
+        onSpawn(child);
+        let spawned = false;
+        child.once('spawn', () => {
+            spawned = true;
+        });
+        child.once('error', (error) => {
+            if (!spawned)
+                settle({ ok: false, reason: error.message });
+        });
+        child.once('exit', (code, signal) => {
+            const durationMs = Math.max(0, Math.round(node_perf_hooks_1.performance.now() - start));
+            settle({ ok: true, exitStatus: signal !== null ? `signal:${signal}` : (code ?? 0), durationMs });
+        });
+    });
+}
+/** Run `command` + `args` with the time limit, no shell, in the root; stdout captured. */
+function runLookup(command, args, root, timeoutMs) {
+    return new Promise((settle) => {
+        (0, node_child_process_1.execFile)(command, [...args], { cwd: root, env: process.env, timeout: timeoutMs, killSignal: 'SIGKILL', maxBuffer: LOOKUP_MAX_BYTES, encoding: 'utf-8' }, (error, stdout) => {
+            if (error === null)
+                return settle({ ok: true, stdout });
+            const failed = error;
+            if (failed.killed === true)
+                return settle({ ok: false, reason: `timed out after ${timeoutMs} ms` });
+            if (failed.code === 'ERR_CHILD_PROCESS_STDIO_MAXBUFFER')
+                return settle({ ok: false, reason: `printed more than ${LOOKUP_MAX_BYTES / 1024 / 1024} MiB on stdout or stderr` });
+            if (typeof failed.code === 'number')
+                return settle({ ok: false, reason: `exited ${failed.code}` });
+            if (failed.signal)
+                return settle({ ok: false, reason: `ended by ${failed.signal}` });
+            return settle({ ok: false, reason: failed.code !== undefined ? `could not start: ${failed.code}` : failed.message });
+        });
+    });
+}
+/** The first JSON value a lookup printed, or why there is none. */
+function parseLookup(outcome) {
+    if (!outcome.ok)
+        return outcome;
+    try {
+        return { ok: true, document: JSON.parse(outcome.stdout) };
+    }
+    catch {
+        return { ok: false, reason: 'printed no JSON' };
+    }
+}
+/**
+ * Every count unreported. A function, not a module constant: `./run-log` can still be loading when this
+ * module is first evaluated (`src/core` ↔ `src/agent` import cycle), so `NOT_REPORTED` is read at call time.
+ */
+const noTokens = () => ({ input: run_log_1.NOT_REPORTED, output: run_log_1.NOT_REPORTED, cache_read: run_log_1.NOT_REPORTED, cache_write: run_log_1.NOT_REPORTED });
+/**
+ * §3.3 step 16: `agent_version`, the session id, the model and the tokens, from the adapter's
+ * declarations (§2.2, §2.6). Every lookup runs after the agent exited; an argv declared for both the
+ * session and the usage runs once. A failure is `not-reported` and one warning; never a refusal.
+ */
+async function postRunFacts(input) {
+    const { manifest, adapterName } = input;
+    const command = commandToSpawn(input.root, manifest.command);
+    const warn = (text) => (0, warning_1.reportWarning)(`adapter '${adapterName}': ${text}`);
+    const runs = new Map();
+    const lookup = (argv) => {
+        const rendered = renderArgv(argv, input.values);
+        const key = JSON.stringify(rendered);
+        if (!runs.has(key))
+            runs.set(key, runLookup(command, rendered, input.root, input.timeoutMs));
+        return runs.get(key);
+    };
+    let agentVersion = run_log_1.NOT_REPORTED;
+    if (manifest.version_args !== undefined) {
+        const outcome = await lookup(manifest.version_args);
+        const first = outcome.ok ? outcome.stdout.split('\n').map((line) => line.trim()).find((line) => line !== '') : undefined;
+        if (first !== undefined)
+            agentVersion = first;
+        else
+            warn(`version_args ${outcome.ok ? 'printed nothing' : `failed (${outcome.reason})`}: agent_version recorded as not-reported`);
+    }
+    let session = input.assigned ?? run_log_1.NOT_REPORTED;
+    if (manifest.session.id === 'lookup' && manifest.session.lookup_args !== undefined && manifest.session.field !== undefined) {
+        const parsed = parseLookup(await lookup(manifest.session.lookup_args));
+        if (!parsed.ok)
+            warn(`the session lookup failed (${parsed.reason}): session recorded as not-reported`);
+        else {
+            const value = readJsonPath(parsed.document, manifest.session.field);
+            if (typeof value === 'string' && value !== '')
+                session = value;
+            else
+                warn("the session lookup's session id is not a non-empty string: recorded as not-reported");
+        }
+    }
+    let model = run_log_1.NOT_REPORTED;
+    let tokens = noTokens();
+    if (manifest.usage.from === 'lookup' && manifest.usage.lookup_args !== undefined) {
+        const parsed = parseLookup(await lookup(manifest.usage.lookup_args));
+        if (!parsed.ok)
+            warn(`the usage lookup failed (${parsed.reason}): model and tokens recorded as not-reported`);
+        else {
+            const fields = manifest.usage.fields ?? {};
+            if (fields.model !== undefined) {
+                const value = readJsonPath(parsed.document, fields.model);
+                if (typeof value === 'string' && value !== '')
+                    model = value;
+                else if (value !== undefined)
+                    warn("the usage lookup's model is not a non-empty string: recorded as not-reported");
+            }
+            const count = (key) => {
+                const path = fields[key];
+                if (path === undefined)
+                    return run_log_1.NOT_REPORTED;
+                const value = readJsonPath(parsed.document, path);
+                if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0)
+                    return value;
+                if (value !== undefined)
+                    warn(`the usage lookup's ${key} is not a non-negative integer: recorded as not-reported`);
+                return run_log_1.NOT_REPORTED;
+            };
+            tokens = { input: count('input'), output: count('output'), cache_read: count('cache_read'), cache_write: count('cache_write') };
+        }
+    }
+    return { agent_version: agentVersion, model, session, tokens };
+}
+/** §3.4's post-run summary line, without a prefix. */
+function runSummaryLine(record, sha) {
+    return `run ${record.id}: agent exited ${String(record.exit_status)} after ${(record.duration_ms / 1000).toFixed(1)} s (recorded in ${sha.slice(0, 7)})`;
+}
+/** The step-13 banner (§3.3), without a prefix. */
+function launchBanner(input) {
+    return `run ${input.runId}: launching ${input.agent.name} (${input.adapter.kind}/${input.adapter.name}) as ${input.role} on ${input.element}`;
+}
+/**
+ * §3.3 steps 13–18 for a launch every pre-launch check has passed. `releaseSignals` is called right
+ * before the spawn, after the launch has installed its own listeners: it hands the process's signals
+ * over from the pre-launch cleanup (`withRunFiles`) to the launch (§3.3 step 15) with no gap between.
+ *
+ * @returns The recorded run (the agent exited `0` and the record was committed); otherwise `IO`
+ *   `agent command '<command>' could not be started …` (no run, no record), `IO` `agent exited
+ *   <exit_status>; run <run-id> recorded` with `details: {run_id, exit_status}` and the summary as a
+ *   detail line, or `recordRun`'s refusal, the record in its `details` (the run is never lost).
+ */
+async function launchAgent(root, input, host, releaseSignals) {
+    const { manifest } = input.adapter;
+    const assigned = manifest.session.id === 'assign' ? assignedSessionId(root, input.runId) : undefined;
+    const values = {
+        bootstrap: input.bootstrap,
+        files: input.files,
+        mcpServer: input.mcpServer,
+        mcpConfig: input.mcpConfig,
+        sessionId: assigned ?? '',
+    };
+    const argv = renderLaunchArgv(manifest, values);
+    // Step 13 — the banner; step 14 — the spawn; step 15 — the wait, with the signals taken over.
+    (0, warning_1.reportNotice)(launchBanner(input));
+    // The launch's listeners go in before the pre-launch cleanup's come out: no signal finds neither.
+    const signals = takeOverSignals();
+    releaseSignals();
+    try {
+        const ran = await runAgent(host.spawn ?? node_child_process_1.spawn, commandToSpawn(root, manifest.command), argv, root, (child) => signals.attach(child));
+        if (!ran.ok) {
+            return (0, types_1.coreErr)({ code: 'IO', message: `agent command '${manifest.command}' could not be started (adapter '${input.adapter.name}'): ${ran.reason}` });
+        }
+        // Step 16 — the post-run lookups.
+        const facts = await postRunFacts({
+            root,
+            adapterName: input.adapter.name,
+            manifest,
+            assigned,
+            values,
+            timeoutMs: host.lookupTimeoutMs ?? exports.LOOKUP_TIMEOUT_MS,
+        });
+        const elementId = input.element.slice(input.element.indexOf(':') + 1);
+        const record = {
+            id: input.runId,
+            element: input.element,
+            workflow: input.workflow,
+            phase: input.phase,
+            role: input.role,
+            mode: input.mode,
+            agent: input.agent.name,
+            adapter: `${input.adapter.kind}/${input.adapter.name}`,
+            agent_version: facts.agent_version,
+            model: facts.model,
+            session: facts.session,
+            tokens: facts.tokens,
+            wingfoil: (0, storage_1.readBuildStamp)(),
+            state_ref: input.stateRef,
+            duration_ms: ran.durationMs,
+            exit_status: ran.exitStatus,
+            result: 'n/a',
+            notes: input.templatePath === undefined
+                ? 'none'
+                : (0, run_log_1.deriveNotesField)(root, { elementId, elementPath: input.elementPath, templatePath: input.templatePath, stateRef: input.stateRef }),
+        };
+        // Step 17 — append and commit.
+        const recorded = (0, run_log_1.recordRun)(root, input.logPath, record);
+        if (!recorded.ok)
+            return recorded;
+        // Step 18 — the outcome.
+        if (record.exit_status !== 0) {
+            return (0, types_1.coreErr)({
+                code: 'IO',
+                message: `agent exited ${String(record.exit_status)}; run ${record.id} recorded`,
+                details: { run_id: record.id, exit_status: record.exit_status, issues: [{ detail: runSummaryLine(record, recorded.value.sha) }] },
+            });
+        }
+        return (0, types_1.coreOk)({ run: record, sha: recorded.value.sha });
+    }
+    finally {
+        signals.restore();
+    }
+}
+//# sourceMappingURL=launch.js.map