wingfoil 0.2.2 → 0.3.0

package/dist/cli/registrar.js

@@ -4,9 +4,13 @@ exports.buildCliCommands = buildCliCommands;
 exports.listRegisteredCliCommands = listRegisteredCliCommands;
 const registry_1 = require("../core/registry");
 const exit_code_1 = require("../core/exit-code");
+const error_details_1 = require("../core/error-details");
+const dry_run_1 = require("../core/dry-run");
+const warning_1 = require("../validation/warning");
 const error_1 = require("./error");
 const exit_1 = require("./exit");
 const output_1 = require("./output");
+const warning_2 = require("./warning");
 /**
  * Derive one `CliCommand` per operation in `modules`, in `enumerateOperations`'s deterministic
  * order (REQ-SYS-07). The verb is derived via `deriveVerb` (spec-006 §5).
@@ -22,14 +26,41 @@ function buildCliCommands(modules, options) {
             description: operation.description,
             positional: operation.positional,
             example: operation.example,
-            flags: operation.flags,
+            // `--dry-run` (task-210, `dl-106` W2, spec-008 §2): every operation that mutates takes it, and
+            // none declares it — it is derived here from `mutates`, so an operation added later inherits it.
+            flags: operation.mutates ? [...(operation.flags ?? []), dry_run_1.DRY_RUN_FLAG] : operation.flags,
             options: operation.options,
             run: async (formatValue, positionals, flags, optionValues) => {
                 if (!(0, output_1.isValidFormat)(formatValue)) {
-                    (0, exit_1.exitWith)(2, `error: invalid --format value "${formatValue}", expected one of: console, json, yaml`);
+                    (0, exit_1.exitWith)(2, `error: ${(0, output_1.invalidFormatReason)(formatValue)}`);
                     return;
                 }
                 const format = formatValue;
+                // The operand count, checked HERE for every derived command, present and future, before
+                // `resolveRoot()`: so before anything is read or written, and before any check the operation
+                // runs, the git-identity pre-flight included (task-129, `bug-171`, `bug-131`). Both are exit `2`
+                // (spec-005 §1), and the global `--format` above is checked first, for every command (`bug-226`).
+                // - An operand beyond the one the command declares (`dl-082-cli-parameter-shape`: at most one
+                //   positional per command), with the declared `surplusHint` appended — the DNA path verbs'
+                //   `the value travels in --value` (task-179, `bug-180`: they no longer refuse it themselves).
+                // - A required operand that is missing: `missing required argument: <name>`, with the command's
+                //   usage as the `hint:` line (task-179, `bug-168`, spec-008 §4).
+                const given = positionals?.length ?? 0;
+                const declared = operation.positional === undefined ? 0 : 1;
+                const commandName = verb ? `${module.name} ${verb}` : module.name;
+                if (given > declared) {
+                    (0, error_1.emitError)((0, registry_1.extraOperandsReason)(commandName, operation.positional?.name, given, operation.positional?.surplusHint), { format });
+                    (0, exit_1.exitWith)(2);
+                    return;
+                }
+                if (given === 0 && operation.positional?.required === true) {
+                    (0, error_1.emitError)((0, registry_1.missingOperandReason)(operation.positional.name), { format, hint: `usage: ${(0, registry_1.commandUsage)(commandName, operation)}` });
+                    (0, exit_1.exitWith)(2);
+                    return;
+                }
+                // The operation's own flags reach `buildParams`; `--dry-run` is the registrar's, not the operation's.
+                const dryRun = operation.mutates && flags?.[dry_run_1.DRY_RUN_FLAG.name] === true;
+                const operationFlags = operation.mutates && flags !== undefined ? withoutDryRun(flags) : flags;
                 let result;
                 try {
                     // `resolveRoot()` / `buildParams()` run INSIDE the try so an ambient failure — e.g. a
@@ -44,12 +75,17 @@ function buildCliCommands(modules, options) {
                         // is the full list a multi-input op (`dnaSet`) reads (task-025-implement-dna-set).
                         positional: positionals?.[0],
                         positionals,
-                        flags,
+                        flags: operationFlags,
                         // Value-bearing `--{name} <value>` options a data-mutating op reads (task-020's `memoryAdd`
                         // reads `type`/`title`/`tags`). Undefined for every op declaring none.
                         options: optionValues,
                     });
-                    result = await operation.fn(params);
+                    // Every warning raised while the operation runs — a loader's unknown-field warning (`bug-202`),
+                    // `agent execute`'s context warnings (task-218) — is rendered here, in the active format, the
+                    // moment it is raised: before the payload or the error that follows it.
+                    const call = () => operation.fn(params);
+                    // A notice (`agent execute`'s launch banner, task-228) is rendered the same way, on stderr.
+                    result = await (0, warning_1.withNoticeSink)((text) => (0, warning_2.emitNotice)(text, { format }), () => (0, warning_1.withWarningSink)((text) => (0, warning_2.emitWarning)(text, { format }), () => (dryRun ? (0, dry_run_1.runAsDryRun)(call) : call())));
                 }
                 catch (error) {
                     // Core owns exit-code selection for a thrown error too (spec-008 Consequences): a UsageError
@@ -64,10 +100,27 @@ function buildCliCommands(modules, options) {
                 // selects for this result (`0` success / `1` logic error) — the CLI does not re-decide the
                 // `0`/`1` mapping (task-012, spec-005 §1). `2` (usage error) is handled above, pre-core.
                 if (result.ok) {
-                    process.stdout.write((0, output_1.renderSuccess)(result.value, format));
+                    // The success-warning channel (task-169, `dl-062`): stderr only, before the payload, so stdout
+                    // is the same bytes with and without warnings under every `--format`.
+                    (0, warning_2.emitWarnings)(result.warnings, { format });
+                    // A command that hands its stdout to a child (`agent execute`, spec-016 §3.4, task-228) reports
+                    // on stderr and writes nothing on stdout (spec-005 §2).
+                    const report = operation.renderToStderr?.(result.value);
+                    if (report !== undefined) {
+                        (0, warning_2.emitStderrDocument)(report.document, report.console, { format });
+                        (0, exit_1.exitWith)((0, exit_code_1.exitCodeForResult)(result));
+                        return;
+                    }
+                    // A command whose spec defines a console rendering (task-220, `agent show`) supplies it;
+                    // every other command keeps `renderSuccess`'s indented JSON (spec-008 §2).
+                    process.stdout.write(format === 'console' && operation.renderConsole !== undefined
+                        ? operation.renderConsole(result.value)
+                        : (0, output_1.renderSuccess)(result.value, format));
                 }
                 else {
-                    (0, error_1.emitError)(result.error.message, { format });
+                    // `details` too (task-130, `dl-055` option 1): the file and the explanation core recorded;
+                    // and the `hint:` line core suggested, if any (task-220, spec-005 §3.1).
+                    (0, error_1.emitError)(result.error.message, { format, hint: result.error.hint, details: (0, error_details_1.errorDetails)(result.error) });
                 }
                 (0, exit_1.exitWith)((0, exit_code_1.exitCodeForResult)(result));
             },
@@ -83,4 +136,12 @@ function buildCliCommands(modules, options) {
 function listRegisteredCliCommands(commands) {
     return commands.map((command) => (command.verb ? `${command.noun} ${command.verb}` : command.noun)).sort();
 }
+/**
+ * `flags` without the registrar's `--dry-run`, or `undefined` when nothing else is left — the shape an
+ * operation that declares no flags of its own was always called with.
+ */
+function withoutDryRun(flags) {
+    const rest = Object.fromEntries(Object.entries(flags).filter(([name]) => name !== dry_run_1.DRY_RUN_FLAG.name));
+    return Object.keys(rest).length > 0 ? rest : undefined;
+}
 //# sourceMappingURL=registrar.js.map

package/dist/cli/registrar.js.map

@@ -1 +1 @@
-{"version":3,"file":"registrar.js","sourceRoot":"","sources":["../../src/cli/registrar.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registrar.js","sourceRoot":"","sources":["../../src/cli/registrar.ts"],"names":[],"mappings":";;AAwFA,4CA2HC;AAQD,8DAEC;AA3MD,+CAA4H;AAE5H,iDAAwE;AACxE,yDAAqD;AACrD,6CAA4D;AAC5D,mDAAwE;AAExE,mCAAoC;AACpC,iCAAkC;AAClC,qCAA6E;AAC7E,uCAAsF;AAwDtF;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,OAA8B,EAAE,OAA6B;IAC5F,OAAO,IAAA,8BAAmB,EAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;QAChE,MAAM,IAAI,GAAG,IAAA,qBAAU,EAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI;YACJ,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,eAAe,EAAE,MAAM,CAAC,WAAW;YACnC,WAAW,EAAE,SAAS,CAAC,WAAW;YAClC,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,+FAA+F;YAC/F,iGAAiG;YACjG,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,sBAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK;YACvF,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,GAAG,EAAE,KAAK,EACR,WAAmB,EACnB,WAA+B,EAC/B,KAAyC,EACzC,YAAmE,EACnE,EAAE;gBACF,IAAI,CAAC,IAAA,sBAAa,EAAC,WAAW,CAAC,EAAE,CAAC;oBAChC,IAAA,eAAQ,EAAC,CAAC,EAAE,UAAU,IAAA,4BAAmB,EAAC,WAAW,CAAC,EAAE,CAAC,CAAC;oBAC1D,OAAO;gBACT,CAAC;gBACD,MAAM,MAAM,GAAG,WAAW,CAAC;gBAE3B,wFAAwF;gBACxF,6FAA6F;gBAC7F,iGAAiG;gBACjG,kGAAkG;gBAClG,8FAA8F;gBAC9F,4FAA4F;gBAC5F,+FAA+F;gBAC/F,gGAAgG;gBAChG,kEAAkE;gBAClE,MAAM,KAAK,GAAG,WAAW,EAAE,MAAM,IAAI,CAAC,CAAC;gBACvC,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;gBAClE,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;oBACrB,IAAA,iBAAS,EAAC,IAAA,8BAAmB,EAAC,WAAW,EAAE,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC9H,IAAA,eAAQ,EAAC,CAAC,CAAC,CAAC;oBACZ,OAAO;gBACT,CAAC;gBACD,IAAI,KAAK,KAAK,CAAC,IAAI,SAAS,CAAC,UAAU,EAAE,QAAQ,KAAK,IAAI,EAAE,CAAC;oBAC3D,IAAA,iBAAS,EAAC,IAAA,+BAAoB,EAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,IAAA,uBAAY,EAAC,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC/H,IAAA,eAAQ,EAAC,CAAC,CAAC,CAAC;oBACZ,OAAO;gBACT,CAAC;gBAED,sGAAsG;gBACtG,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,IAAI,KAAK,EAAE,CAAC,sBAAY,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;gBACxE,MAAM,cAAc,GAAG,SAAS,CAAC,OAAO,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBAE/F,IAAI,MAA2B,CAAC;gBAChC,IAAI,CAAC;oBACH,sFAAsF;oBACtF,sFAAsF;oBACtF,wFAAwF;oBACxF,2FAA2F;oBAC3F,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;wBACjC,UAAU,EAAE,MAAM,CAAC,IAAI;wBACvB,aAAa,EAAE,SAAS,CAAC,IAAI;wBAC7B,IAAI,EAAE,OAAO,CAAC,WAAW,EAAE;wBAC3B,8FAA8F;wBAC9F,mFAAmF;wBACnF,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;wBAC5B,WAAW;wBACX,KAAK,EAAE,cAAc;wBACrB,4FAA4F;wBAC5F,uEAAuE;wBACvE,OAAO,EAAE,YAAY;qBACtB,CAAC,CAAC;oBACH,gGAAgG;oBAChG,8FAA8F;oBAC9F,wEAAwE;oBACxE,MAAM,IAAI,GAAG,GAAiC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;oBACtE,4FAA4F;oBAC5F,MAAM,GAAG,MAAM,IAAA,wBAAc,EAC3B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,oBAAU,EAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EACtC,GAAG,EAAE,CAAC,IAAA,yBAAe,EAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,qBAAW,EAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAA,qBAAW,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAC5G,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,6FAA6F;oBAC7F,2FAA2F;oBAC3F,6FAA6F;oBAC7F,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAA,4BAAgB,EAAC,KAAK,CAAC,CAAC;oBACrD,IAAA,iBAAS,EAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC9B,IAAA,eAAQ,EAAC,QAAQ,CAAC,CAAC;oBACnB,OAAO;gBACT,CAAC;gBAED,yFAAyF;gBACzF,2FAA2F;gBAC3F,yFAAyF;gBACzF,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;oBACd,+FAA+F;oBAC/F,sEAAsE;oBACtE,IAAA,sBAAY,EAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC1C,gGAAgG;oBAChG,wDAAwD;oBACxD,MAAM,MAAM,GAAG,SAAS,CAAC,cAAc,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;oBACxD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;wBACzB,IAAA,4BAAkB,EAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;wBAChE,IAAA,eAAQ,EAAC,IAAA,6BAAiB,EAAC,MAAM,CAAC,CAAC,CAAC;wBACpC,OAAO;oBACT,CAAC;oBACD,yFAAyF;oBACzF,2EAA2E;oBAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,MAAM,KAAK,SAAS,IAAI,SAAS,CAAC,aAAa,KAAK,SAAS;wBAC3D,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;wBACvC,CAAC,CAAC,IAAA,sBAAa,EAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CACxC,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,2FAA2F;oBAC3F,yEAAyE;oBACzE,IAAA,iBAAS,EAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,IAAA,4BAAY,EAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC5G,CAAC;gBACD,IAAA,eAAQ,EAAC,IAAA,6BAAiB,EAAC,MAAM,CAAC,CAAC,CAAC;YACtC,CAAC;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,yBAAyB,CAAC,QAA+B;IACvE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7G,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CAAC,KAAwC;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,sBAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACtG,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACzD,CAAC"}

package/dist/cli/suggest.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The closest-match suggestion for an unknown command (`spec-008-cli-grammar` §1, `spec-005-cli-command-contract`
+ * §3.1; task-179, `bug-104`). WingFoil computes it rather than relaying Commander's own
+ * `(Did you mean …?)`: `spec-008` §1 names Levenshtein distance ≤ 2, Commander's matcher is
+ * Damerau–Levenshtein with distance ≤ 3, and its wording is not the `hint:` line `spec-005` §3.1
+ * declares. Pure and deterministic (REQ-SYS-07): the result depends on the token and the SET of
+ * candidates, never on their order.
+ */
+/** The largest edit distance at which a command is still suggested (`spec-008` §1). */
+export declare const SUGGESTION_MAX_DISTANCE = 2;
+/** Levenshtein distance between `a` and `b`: insertions, deletions and substitutions, each costing 1. */
+export declare function levenshtein(a: string, b: string): number;
+/**
+ * The candidate nearest to `token` within {@link SUGGESTION_MAX_DISTANCE}, or `undefined` when none is
+ * that close. A tie goes to the candidate first in code-unit order; the token itself is never suggested.
+ */
+export declare function closestCommand(token: string, candidates: readonly string[]): string | undefined;
+/** The `hint:` text for a suggested command, in `spec-005` §3.1's words: `did you mean "<name>"?`. */
+export declare function unknownCommandHint(name: string): string;
+//# sourceMappingURL=suggest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.d.ts","sourceRoot":"","sources":["../../src/cli/suggest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uFAAuF;AACvF,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAWxD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAQ/F;AAED,sGAAsG;AACtG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/cli/suggest.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * The closest-match suggestion for an unknown command (`spec-008-cli-grammar` §1, `spec-005-cli-command-contract`
+ * §3.1; task-179, `bug-104`). WingFoil computes it rather than relaying Commander's own
+ * `(Did you mean …?)`: `spec-008` §1 names Levenshtein distance ≤ 2, Commander's matcher is
+ * Damerau–Levenshtein with distance ≤ 3, and its wording is not the `hint:` line `spec-005` §3.1
+ * declares. Pure and deterministic (REQ-SYS-07): the result depends on the token and the SET of
+ * candidates, never on their order.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUGGESTION_MAX_DISTANCE = void 0;
+exports.levenshtein = levenshtein;
+exports.closestCommand = closestCommand;
+exports.unknownCommandHint = unknownCommandHint;
+/** The largest edit distance at which a command is still suggested (`spec-008` §1). */
+exports.SUGGESTION_MAX_DISTANCE = 2;
+/** Levenshtein distance between `a` and `b`: insertions, deletions and substitutions, each costing 1. */
+function levenshtein(a, b) {
+    let previous = Array.from({ length: b.length + 1 }, (_, index) => index);
+    for (let i = 1; i <= a.length; i += 1) {
+        const current = [i];
+        for (let j = 1; j <= b.length; j += 1) {
+            const substitution = previous[j - 1] + (a[i - 1] === b[j - 1] ? 0 : 1);
+            current.push(Math.min(previous[j] + 1, current[j - 1] + 1, substitution));
+        }
+        previous = current;
+    }
+    return previous[b.length];
+}
+/**
+ * The candidate nearest to `token` within {@link SUGGESTION_MAX_DISTANCE}, or `undefined` when none is
+ * that close. A tie goes to the candidate first in code-unit order; the token itself is never suggested.
+ */
+function closestCommand(token, candidates) {
+    let best;
+    for (const name of [...new Set(candidates)].sort()) {
+        if (name === token)
+            continue;
+        const distance = levenshtein(token, name);
+        if (distance <= exports.SUGGESTION_MAX_DISTANCE && (best === undefined || distance < best.distance))
+            best = { name, distance };
+    }
+    return best?.name;
+}
+/** The `hint:` text for a suggested command, in `spec-005` §3.1's words: `did you mean "<name>"?`. */
+function unknownCommandHint(name) {
+    return `did you mean "${name}"?`;
+}
+//# sourceMappingURL=suggest.js.map

package/dist/cli/suggest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest.js","sourceRoot":"","sources":["../../src/cli/suggest.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAMH,kCAWC;AAMD,wCAQC;AAGD,gDAEC;AAlCD,uFAAuF;AAC1E,QAAA,uBAAuB,GAAG,CAAC,CAAC;AAEzC,yGAAyG;AACzG,SAAgB,WAAW,CAAC,CAAS,EAAE,CAAS;IAC9C,IAAI,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;IACzE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;QACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAE,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;QAC9E,CAAC;QACD,QAAQ,GAAG,OAAO,CAAC;IACrB,CAAC;IACD,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAE,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc,CAAC,KAAa,EAAE,UAA6B;IACzE,IAAI,IAAoD,CAAC;IACzD,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACnD,IAAI,IAAI,KAAK,KAAK;YAAE,SAAS;QAC7B,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,QAAQ,IAAI,+BAAuB,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAAE,IAAI,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACzH,CAAC;IACD,OAAO,IAAI,EAAE,IAAI,CAAC;AACpB,CAAC;AAED,sGAAsG;AACtG,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,OAAO,iBAAiB,IAAI,IAAI,CAAC;AACnC,CAAC"}

package/dist/cli/warning.d.ts

@@ -0,0 +1,26 @@
+import type { OutputFormat } from './output';
+/** Write one warning to stderr in the active `--format`'s shape (see the module doc). Writes only. */
+export declare function emitWarning(text: string, opts: {
+    format: OutputFormat;
+}): void;
+/** Write each of `warnings` to stderr, in order, through {@link emitWarning}. Writes nothing for none. */
+export declare function emitWarnings(warnings: readonly string[] | undefined, opts: {
+    format: OutputFormat;
+}): void;
+/**
+ * Write one notice (task-228, `reportNotice`: `agent execute`'s launch banner, `spec-016` §3.3 step 13) to
+ * stderr in the active `--format`'s shape: the bare line for `console`, `{"notice": "<text>"}` for
+ * `json`, one self-delimiting YAML document for `yaml` — the shapes {@link emitWarning} uses.
+ */
+export declare function emitNotice(text: string, opts: {
+    format: OutputFormat;
+}): void;
+/**
+ * Write one stderr message: `document` as one JSON line (`json`) or one `---`/`...` YAML document
+ * (`yaml`), `consoleLine` as is (`console`). The success report of a command that writes nothing on
+ * stdout (`CoreOperation.renderToStderr`, `spec-016` §3.4) goes through here too.
+ */
+export declare function emitStderrDocument(document: Readonly<Record<string, unknown>>, consoleLine: string, opts: {
+    format: OutputFormat;
+}): void;
+//# sourceMappingURL=warning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"warning.d.ts","sourceRoot":"","sources":["../../src/cli/warning.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG,IAAI,CAQ9E;AAED,0GAA0G;AAC1G,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG,IAAI,CAE1G;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG,IAAI,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,GAAG,IAAI,CAIzI"}

package/dist/cli/warning.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitWarning = emitWarning;
+exports.emitWarnings = emitWarnings;
+exports.emitNotice = emitNotice;
+exports.emitStderrDocument = emitStderrDocument;
+/**
+ * The one CLI renderer for warnings (task-169, `dl-062` Q1 option 3; the shape is `spec-016` §3.4's,
+ * pinned for every command in `spec-008` §6).
+ *
+ * A warning is **stderr only**, under every `--format`, so the payload on stdout is the same with and
+ * without it (`spec-005` §2: stdout carries only the payload). Its shape follows the format, as an
+ * error's does (`./error.ts`):
+ *
+ * - `console`: `warning: <text>`, beside the `error: ` prefix. A continuation line of a multi-line
+ *   warning is indented, so no line of it can begin with the greppable `warning: ` or `error: `.
+ * - `json`: one `{"warning": "<text>"}` document per line.
+ * - `yaml`: one `warning: <text>` YAML document per warning, opened by `---` and closed by `...`, so
+ *   every warning is a self-delimiting document: several warnings, or warnings followed by an error
+ *   (`./error.ts`, whose bytes are unchanged), read as separate documents of one stream and never
+ *   merge into a single mapping (task-169 review).
+ *
+ * Every warning on the CLI goes through here: the success-warning channel the registrar renders
+ * (`CoreResult.warnings`), and any warning a command prints while it runs (`spec-016` §3.4's
+ * `ExecutionContext.warnings`, task-218).
+ */
+const js_yaml_1 = require("js-yaml");
+/** Write one warning to stderr in the active `--format`'s shape (see the module doc). Writes only. */
+function emitWarning(text, opts) {
+    if (opts.format === 'json') {
+        process.stderr.write(JSON.stringify({ warning: text }) + '\n');
+    }
+    else if (opts.format === 'yaml') {
+        process.stderr.write('---\n' + (0, js_yaml_1.dump)({ warning: text }) + '...\n');
+    }
+    else {
+        process.stderr.write(`warning: ${text.replace(/\n/g, '\n  ')}\n`);
+    }
+}
+/** Write each of `warnings` to stderr, in order, through {@link emitWarning}. Writes nothing for none. */
+function emitWarnings(warnings, opts) {
+    for (const warning of warnings ?? [])
+        emitWarning(warning, opts);
+}
+/**
+ * Write one notice (task-228, `reportNotice`: `agent execute`'s launch banner, `spec-016` §3.3 step 13) to
+ * stderr in the active `--format`'s shape: the bare line for `console`, `{"notice": "<text>"}` for
+ * `json`, one self-delimiting YAML document for `yaml` — the shapes {@link emitWarning} uses.
+ */
+function emitNotice(text, opts) {
+    emitStderrDocument({ notice: text }, text, opts);
+}
+/**
+ * Write one stderr message: `document` as one JSON line (`json`) or one `---`/`...` YAML document
+ * (`yaml`), `consoleLine` as is (`console`). The success report of a command that writes nothing on
+ * stdout (`CoreOperation.renderToStderr`, `spec-016` §3.4) goes through here too.
+ */
+function emitStderrDocument(document, consoleLine, opts) {
+    if (opts.format === 'json')
+        process.stderr.write(JSON.stringify(document) + '\n');
+    else if (opts.format === 'yaml')
+        process.stderr.write('---\n' + (0, js_yaml_1.dump)(document) + '...\n');
+    else
+        process.stderr.write(`${consoleLine}\n`);
+}
+//# sourceMappingURL=warning.js.map

package/dist/cli/warning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warning.js","sourceRoot":"","sources":["../../src/cli/warning.ts"],"names":[],"mappings":";;AAyBA,kCAQC;AAGD,oCAEC;AAOD,gCAEC;AAOD,gDAIC;AA1DD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qCAA2C;AAI3C,sGAAsG;AACtG,SAAgB,WAAW,CAAC,IAAY,EAAE,IAA8B;IACtE,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IACjE,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAA,cAAQ,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC;IACxE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,0GAA0G;AAC1G,SAAgB,YAAY,CAAC,QAAuC,EAAE,IAA8B;IAClG,KAAK,MAAM,OAAO,IAAI,QAAQ,IAAI,EAAE;QAAE,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,IAAY,EAAE,IAA8B;IACrE,kBAAkB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC;AAED;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,QAA2C,EAAE,WAAmB,EAAE,IAA8B;IACjI,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;SAC7E,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAA,cAAQ,EAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,CAAC;;QACzF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,IAAI,CAAC,CAAC;AAChD,CAAC"}

package/dist/cli.js

@@ -20,6 +20,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  * (spec-005-cli-command-contract §1, spec-008-cli-grammar §1) even outside a git repository; only an
  * actual `<noun> <verb>` invocation needs a resolvable git root.
  */
+const exit_1 = require("./cli/exit");
 const program_1 = require("./cli/program");
 const core_1 = require("./core");
 const git_root_1 = require("./storage/git-root");
@@ -34,12 +35,20 @@ const git_root_1 = require("./storage/git-root");
 })
     .then((program) => program.parseAsync(process.argv))
     .catch((error) => {
+    // Not an error: an exit already chosen through `exitWith` is waiting for queued output to drain
+    // (task-249, `bug-222`), and the process ends with that code once it has. Matched by name, as the
+    // compiled test harness does, so a second copy of `./cli/exit` cannot make it read as a failure —
+    // and only when `exitWith` has really chosen a code (`process.exitCode` is set), so an unrelated
+    // error that happens to carry the name is still reported below rather than swallowed.
+    if (error instanceof Error && error.name === 'DeferredExit' && process.exitCode !== undefined)
+        return;
     // Last-resort handler for anything that escapes the per-command spec-005 exit path. Emit only the
     // message as a single `error:` line — never `error.stack`, which would leak a stack trace and
     // absolute internal paths from a published CLI (bug-002-cli-error-stack-dump). The normal
     // no-git-root path is already handled cleanly inside the registrar; this guards the unexpected.
+    // It ends through `exitWith` like every other outcome (spec-005 §1), so output a command queued
+    // before the escape still drains (task-249 review).
     const message = error instanceof Error ? error.message : String(error);
-    process.stderr.write(`error: ${message}\n`);
-    process.exit(1);
+    (0, exit_1.exitWith)(1, `error: ${message}`);
 });
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AACA;;;;;;;;;;;;;;;;;;GAkBG;AACH,2CAA6C;AAC7C,iCAAsC;AACtC,iDAAwD;AAExD,IAAA,sBAAY,EAAC,mBAAY,EAAE;IACzB,WAAW,EAAE,GAAG,EAAE,CAAC,IAAA,6BAAkB,EAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACpD,0FAA0F;IAC1F,iGAAiG;IACjG,gGAAgG;IAChG,qGAAqG;IACrG,0CAA0C;IAC1C,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;CACjJ,CAAC;KACC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,kGAAkG;IAClG,8FAA8F;IAC9F,0FAA0F;IAC1F,gGAAgG;IAChG,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AACA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qCAAsC;AACtC,2CAA6C;AAC7C,iCAAsC;AACtC,iDAAwD;AAExD,IAAA,sBAAY,EAAC,mBAAY,EAAE;IACzB,WAAW,EAAE,GAAG,EAAE,CAAC,IAAA,6BAAkB,EAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IACpD,0FAA0F;IAC1F,iGAAiG;IACjG,gGAAgG;IAChG,qGAAqG;IACrG,0CAA0C;IAC1C,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;CACjJ,CAAC;KACC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KACnD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,gGAAgG;IAChG,kGAAkG;IAClG,kGAAkG;IAClG,iGAAiG;IACjG,sFAAsF;IACtF,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO;IACtG,kGAAkG;IAClG,8FAA8F;IAC9F,0FAA0F;IAC1F,gGAAgG;IAChG,gGAAgG;IAChG,oDAAoD;IACpD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,IAAA,eAAQ,EAAC,CAAC,EAAE,UAAU,OAAO,EAAE,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC"}

package/dist/core/agent-execute.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `wingfoil agent execute` `CoreOperation.fn` (task-218, task-228, task-235, `spec-016` §3; P5.3.1, P5.3.2,
+ * P5.4.2–P5.4.4): the stepless form, `--element <type>:<id>` with an optional `--role` and `--agent`, and the
+ * step forms `--next`, `--workflow <ref>`, `--step <key>` (§3.1; either option implies `--next`), which take
+ * the workflow, phase, element and role from a frontier step (`src/agent/step.ts`). It parses the request
+ * (§3.3 step 1), runs `src/agent/execute.ts`'s pipeline up to the spawn (steps 2–12), and then:
+ * - under `--dry-run` (`spec-008` §2) returns the launch it would make — the record commit's subject and
+ *   run-log path, the run's fields known before the spawn, and the §2.4 bootstrap — having written
+ *   nothing;
+ * - otherwise launches the agent (`src/agent/launch.ts`, steps 13–18) and returns the recorded run,
+ *   which the CLI prints on stderr only ({@link renderAgentExecuteStderr}, §3.4).
+ *
+ * v0.4's `--resume` and `--ref` are not registered, so Commander refuses them as unknown options (exit `2`).
+ */
+import { type AgentExecuteHost, type AgentLaunchPlan } from '../agent/execute';
+import { type RecordedLaunch } from '../agent/launch';
+import type { CoreFn, StderrReport } from './registry';
+/** `agent execute` params: the value options (`spec-008` §1) ride `options`, the `--next` flag `next`. */
+export interface AgentExecuteParams {
+    readonly root: string;
+    /** `--next` (task-235): take the step from the active instance, or from the one `--workflow` selects. */
+    readonly next?: boolean;
+    readonly options?: Readonly<Record<string, string | readonly string[] | undefined>>;
+    /**
+     * The host facts the pipeline reads (the MCP server to pre-flight, the terminal test, `PATH`), for an
+     * in-process caller only: no surface builds it from user input, so the CLI always runs with the
+     * process's own (`src/cli.ts`'s `buildParams` sets no such key).
+     */
+    readonly host?: AgentExecuteHost;
+}
+/** §3.1: none of `--next`, `--workflow`, `--step`, `--element` → exit `2` with this reason. */
+export declare const AGENT_EXECUTE_MISSING_TARGET = "missing required argument: --next or --element";
+/**
+ * Parse, check the project is initialized, run the pipeline, then plan (dry run) or launch. A usage
+ * error (none of `--next`, `--workflow`, `--step`, `--element`; a malformed element-ref, `spec-008` §7) is
+ * thrown as `UsageError` before the project is read.
+ */
+export declare const agentExecuteFn: CoreFn<unknown, AgentLaunchPlan | RecordedLaunch>;
+/**
+ * §3.4: a recorded run is reported on stderr — the summary line (`console`), `{ "run": <record> }`
+ * (`json`/`yaml`) — and stdout is left to the agent. The dry-run plan is an ordinary stdout payload.
+ */
+export declare function renderAgentExecuteStderr(value: AgentLaunchPlan | RecordedLaunch): StderrReport | undefined;
+//# sourceMappingURL=agent-execute.d.ts.map

package/dist/core/agent-execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-execute.d.ts","sourceRoot":"","sources":["../../src/core/agent-execute.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAoC,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACjH,OAAO,EAA+B,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAInF,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAIvD,0GAA0G;AAC1G,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yGAAyG;IACzG,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;IACpF;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;CAClC;AAED,+FAA+F;AAC/F,eAAO,MAAM,4BAA4B,mDAAmD,CAAC;AAO7F;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA2B5E,CAAC;AAEF;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,SAAS,CAG1G"}

package/dist/core/agent-execute.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentExecuteFn = exports.AGENT_EXECUTE_MISSING_TARGET = void 0;
+exports.renderAgentExecuteStderr = renderAgentExecuteStderr;
+/**
+ * `wingfoil agent execute` `CoreOperation.fn` (task-218, task-228, task-235, `spec-016` §3; P5.3.1, P5.3.2,
+ * P5.4.2–P5.4.4): the stepless form, `--element <type>:<id>` with an optional `--role` and `--agent`, and the
+ * step forms `--next`, `--workflow <ref>`, `--step <key>` (§3.1; either option implies `--next`), which take
+ * the workflow, phase, element and role from a frontier step (`src/agent/step.ts`). It parses the request
+ * (§3.3 step 1), runs `src/agent/execute.ts`'s pipeline up to the spawn (steps 2–12), and then:
+ * - under `--dry-run` (`spec-008` §2) returns the launch it would make — the record commit's subject and
+ *   run-log path, the run's fields known before the spawn, and the §2.4 bootstrap — having written
+ *   nothing;
+ * - otherwise launches the agent (`src/agent/launch.ts`, steps 13–18) and returns the recorded run,
+ *   which the CLI prints on stderr only ({@link renderAgentExecuteStderr}, §3.4).
+ *
+ * v0.4's `--resume` and `--ref` are not registered, so Commander refuses them as unknown options (exit `2`).
+ */
+const execute_1 = require("../agent/execute");
+const launch_1 = require("../agent/launch");
+const storage_1 = require("../storage");
+const element_ref_1 = require("./element-ref");
+const init_1 = require("./init");
+const types_1 = require("./types");
+const usage_error_1 = require("./usage-error");
+/** §3.1: none of `--next`, `--workflow`, `--step`, `--element` → exit `2` with this reason. */
+exports.AGENT_EXECUTE_MISSING_TARGET = 'missing required argument: --next or --element';
+/** A single option value: the last occurrence, as Commander gives a non-repeatable option. */
+function single(value) {
+    return typeof value === 'string' ? value : value?.[value.length - 1];
+}
+/**
+ * Parse, check the project is initialized, run the pipeline, then plan (dry run) or launch. A usage
+ * error (none of `--next`, `--workflow`, `--step`, `--element`; a malformed element-ref, `spec-008` §7) is
+ * thrown as `UsageError` before the project is read.
+ */
+const agentExecuteFn = async (params) => {
+    const { root, options, host, next } = params;
+    const elementOption = single(options?.element);
+    const workflow = single(options?.workflow);
+    const key = single(options?.step);
+    // `--workflow` and `--step` imply `--next` (§3.1); giving `--next` as well changes nothing.
+    const stepForm = next === true || workflow !== undefined || key !== undefined;
+    if (elementOption === undefined && !stepForm)
+        throw new usage_error_1.UsageError(exports.AGENT_EXECUTE_MISSING_TARGET);
+    const element = elementOption === undefined ? undefined : (0, element_ref_1.parseElementRef)(elementOption);
+    if (element !== undefined && !element.ok)
+        throw new usage_error_1.UsageError(element.error.message);
+    const initialized = (0, init_1.requireInitializedProject)(root);
+    if (!initialized.ok)
+        return initialized;
+    const dryRun = (0, storage_1.isDryRunActive)();
+    const launchHost = host ?? {};
+    return (0, execute_1.agentExecutePipeline)(root, {
+        ...(element === undefined ? {} : { element: element.value }),
+        ...(stepForm ? { step: { ...(workflow === undefined ? {} : { workflow }), ...(key === undefined ? {} : { key }) } } : {}),
+        role: single(options?.role),
+        agent: single(options?.agent),
+    }, launchHost, async (prepared, releaseSignals) => (dryRun ? (0, types_1.coreOk)((0, execute_1.launchPlan)(prepared)) : (0, launch_1.launchAgent)(root, prepared, launchHost, releaseSignals)));
+};
+exports.agentExecuteFn = agentExecuteFn;
+/**
+ * §3.4: a recorded run is reported on stderr — the summary line (`console`), `{ "run": <record> }`
+ * (`json`/`yaml`) — and stdout is left to the agent. The dry-run plan is an ordinary stdout payload.
+ */
+function renderAgentExecuteStderr(value) {
+    if ('dryRun' in value)
+        return undefined;
+    return { document: { run: value.run }, console: (0, launch_1.runSummaryLine)(value.run, value.sha) };
+}
+//# sourceMappingURL=agent-execute.js.map

package/dist/core/agent-execute.js.map

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

package/dist/core/agent-list.d.ts

@@ -0,0 +1,95 @@
+/**
+ * `wingfoil agent list [--past] [--waiting] [--element <type>:<id>] [--phase <name>]` (task-240,
+ * `spec-016` §5; P5.3.4): the recorded agent runs, and the workflow steps waiting for an agent.
+ *
+ * **Two sources, one baseline** (`dl-135` point 1; `spec-016` §5.1, approver ruling R15; `spec-006` §6
+ * item 6):
+ * - **past** = the run log (task-206's `src/agent/run-log.ts`, read strictly, §4.5) at `HEAD`;
+ * - **waiting** = every frontier step of every open instance whose role an agent executes (`Step.agentRole`,
+ *   `spec-017` §6.3), in `spec-017` §1.3's frontier order — the steps `workflow status` reports
+ *   (`StatusResult.open[].frontier`), built by the same `readNextInputs` + `buildStep` (task-225).
+ *
+ * When the waiting section is selected, the deduction snapshot is read first and its commit is the one the
+ * run logs are read at too, so both sections answer from the one `HEAD` the payload's `baseline` names.
+ * The working tree only explains: a run log that differs from `HEAD` is a `W_UNCOMMITTED_INPUTS` diagnostic
+ * (`spec-017` §1.2), one per dirty path — the deduction's own when it runs, this module's (through the same
+ * builder) when `--past` alone runs none.
+ *
+ * v0.3 limit (§5): with no active registry, a step an agent is running on right now is still listed as
+ * waiting; `--active` is v0.4 and refused as an unknown option.
+ */
+import { type RunRecord } from '../agent/run-log';
+import { type Diagnostic } from '../validation';
+import { type Baseline } from '../workflow/deduce';
+import type { PhaseMode } from '../workflow/schema';
+import type { CoreFn } from './registry';
+import { type CoreResult } from './types';
+/** The warning of a project whose `dna.yaml` declares no run log (§5: not an error for `list`). */
+export declare const NO_RUN_LOG_WARNING = "dna.yaml declares no run log (paths.runs)";
+/** `agent list` params: the two section flags, and the two filters as value options (`spec-008` §12). */
+export interface AgentListParams {
+    readonly root: string;
+    readonly past?: boolean;
+    readonly waiting?: boolean;
+    readonly options?: Readonly<Record<string, string | readonly string[] | undefined>>;
+}
+/** One step waiting for an agent (`spec-016` §5's `waiting[]` item). */
+export interface WaitingStep {
+    /** The open instance the step belongs to. */
+    readonly instance: string;
+    /** The step key (`spec-017` §4.9). */
+    readonly key: string;
+    readonly workflow: string;
+    readonly phase: string;
+    /** `<type>:<id>`: the step's scope element, else its instance's bound element; `null` when it has neither. */
+    readonly element: string | null;
+    readonly role: string;
+    readonly allowedModes: readonly PhaseMode[];
+    /** The `team.agents[]` names, in DNA order, that execute the role and declare an adapter. */
+    readonly agents: readonly string[];
+}
+/**
+ * `agent list`'s payload (`spec-016` §5): `baseline` and `diagnostics` always, and only the selected source
+ * keys, in that order.
+ */
+export interface AgentListResult {
+    readonly baseline: Baseline;
+    readonly past?: readonly RunRecord[];
+    readonly waiting?: readonly WaitingStep[];
+    readonly diagnostics: readonly Diagnostic[];
+}
+/** A diagnostic as the console's `warning:` line: `<code> (<file>): <message>` (`spec-008` §6's form). */
+export declare function diagnosticWarning(diagnostic: Diagnostic): string;
+/** What the request selects, parsed before the project is read. */
+interface Selection {
+    readonly past: boolean;
+    readonly waiting: boolean;
+    readonly element?: string;
+    readonly phase?: string;
+}
+/**
+ * `agent list` at `HEAD` (`spec-016` §5, §5.1).
+ *
+ * @returns the payload and its success warnings (each diagnostic, and the missing-run-log warning); a §4.5
+ *   violation of a committed run log is `VALIDATION` (exit `1`); `dna.yaml` not committed when the past
+ *   section is selected is `NOT_FOUND`, as `agent show`.
+ * @throws `DiagnosticsError` / `ValidationError` from the deduction (mapped by {@link agentListFn}).
+ */
+export declare function agentListAtHead(root: string, selection: Selection): CoreResult<AgentListResult>;
+/**
+ * `agent list` `CoreOperation.fn` (`mutates: false`; `spec-006` §3, `spec-016` §8).
+ *
+ * 1. The selection: `--past`, `--waiting`; neither or both select both sections. A malformed `--element`
+ *    (`spec-008` §7) is a usage error (exit `2`), refused before the project is read.
+ * 2. {@link agentListAtHead}; a `spec-003` error in the registry at `HEAD` is `VALIDATION` with every
+ *    diagnostic in `details`, an invalid committed file `VALIDATION` with its issues, as `workflow status`.
+ */
+export declare const agentListFn: CoreFn<unknown, AgentListResult>;
+/**
+ * `agent list`'s `--format console` (`spec-016` §5): one section per selected source, past first — a
+ * heading with the count, then one line per item, or `no past runs` / `no waiting steps` for an empty one.
+ * Diagnostics are not here: they print on stderr as `warning:` lines (the success warnings).
+ */
+export declare function renderAgentListConsole(value: unknown): string;
+export {};
+//# sourceMappingURL=agent-list.d.ts.map

package/dist/core/agent-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-list.d.ts","sourceRoot":"","sources":["../../src/core/agent-list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEjE,OAAO,EAAqC,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAmD,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACpG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAIpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAK3D,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,8CAA8C,CAAC;AAE9E,yGAAyG;AACzG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;CACrF;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,8GAA8G;IAC9G,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5C,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAOD,0GAA0G;AAC1G,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAEhE;AAaD,mEAAmE;AACnE,UAAU,SAAS;IACjB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAsBD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,UAAU,CAAC,eAAe,CAAC,CAkD/F;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,eAAe,CA2BxD,CAAC;AAeF;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAY7D"}