@mrciphersmith/keryx 0.3.32 → 0.3.33

package/README.md

@@ -646,7 +646,10 @@ Grouped by what you are trying to do, not by internal module layout.
   at, each with its outcome criterion or `not measured — no instrument stated`,
   and splits the count three ways: no outcome criterion stated, criterion
   stated but never observed, observed (split by verdict). A criterion goes in
-  the `## Outcome criteria` slot `flow init` leaves in `description.md`. An
+  the `## Outcome criteria` slot `flow init` leaves in `description.md`; who
+  wrote it is recorded as `outcomeAuthor` (`flow init --outcome-author
+  agent|human`, `flow outcome author <id> agent|human --reason "<why>"`), shown
+  by `product open`, and gates nothing. An
   observation is a line starting `outcome-observed: <verdict> — <note>` in the
   flow's `journal.md`, with the verdict one of `helped`, `no-effect`, `harmed`,
   `inconclusive`; a requirements package uses an `## Outcome observations`

package/dist/cli.js

@@ -13447,7 +13447,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@mrciphersmith/keryx",
-    version: "0.3.32",
+    version: "0.3.33",
     description: "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
     private: false,
     publishConfig: {
@@ -48615,6 +48615,22 @@ var init_review_gate = __esm(() => {
   REPLY_EVIDENCE_PATTERN = /(https?:\/\/\S+|#(issue|discussion)comment[-_]?\d+|\breplied\b|\breply\b|\banswered\b)/i;
 });
 
+// src/flow/outcome-author.ts
+function readOutcomeAuthor(value) {
+  return value === "agent" || value === "human" ? value : "unknown";
+}
+function parseOutcomeAuthor(raw, flag = "--outcome-author") {
+  if (raw === "agent" || raw === "human")
+    return raw;
+  const shown = typeof raw === "string" ? `"${raw}"` : "nothing";
+  throw new Error(`${flag} must be one of: ${OUTCOME_AUTHORS.join(", ")} (got ${shown}).`);
+}
+var OUTCOME_AUTHORS, OUTCOME_AUTHOR_READINGS, DEFAULT_OUTCOME_AUTHOR = "agent";
+var init_outcome_author = __esm(() => {
+  OUTCOME_AUTHORS = ["agent", "human"];
+  OUTCOME_AUTHOR_READINGS = [...OUTCOME_AUTHORS, "unknown"];
+});
+
 // src/flow/identity.ts
 function resolveSignerIdentity(input) {
   const stated = input.stated?.trim();
@@ -49052,6 +49068,11 @@ function flowStateSchema() {
         $ref: "#/definitions/identity",
         description: "The human accountable for this flow, or absent if one was never set. Never inferred: only ever written by an explicit `--owner` on `flow init` or `flow owner set`, so `basis` is always `stated`."
       },
+      outcomeAuthor: {
+        type: "string",
+        enum: ["agent", "human"],
+        description: "Who wrote the outcome criterion. Written by `flow init --outcome-author` (default `agent`; `human` only when the flag says so, never inferred) and changed only by `flow outcome author`, which journals the change. Absent on flows created before the field existed, and read as `unknown` (neither agent nor human). Gates nothing."
+      },
       signatures: {
         type: "array",
         description: "Append-only signing record for `flow ac confirm` and a passing `flow complete`. Absent means never signed under this field's existence.",
@@ -50830,6 +50851,7 @@ function createFlowService(deps) {
       if (input.owner !== undefined && !input.owner.trim()) {
         throw new Error(BLANK_OWNER_MESSAGE);
       }
+      const outcomeAuthor = input.outcomeAuthor === undefined ? DEFAULT_OUTCOME_AUTHOR : parseOutcomeAuthor(input.outcomeAuthor);
       const trackerReady = deps.tracker ? await deps.tracker.detect() : false;
       const tracker = trackerReady ? deps.tracker : null;
       const issueRef = input.issue && deps.tracker ? deps.tracker.parseRef(input.issue) : null;
@@ -50881,6 +50903,7 @@ function createFlowService(deps) {
           pr: { url: null },
           ...input.baseBranch === undefined ? {} : { baseBranch: input.baseBranch },
           ...input.owner?.trim() ? { owner: ownerIdentity(input.owner.trim(), "`--owner` flag on `flow init`") } : {},
+          outcomeAuthor,
           tasks: DEFAULT_TASKS.map((task) => ({ ...task, status: "todo" })),
           history: [{ at: createdAt, event: "created" }]
         };
@@ -50938,6 +50961,25 @@ function createFlowService(deps) {
         return save(cwd, dir, flow, previous === null ? "owner-set" : "owner-changed", detail);
       });
     },
+    async outcomeAuthorSet({ cwd, id, author, reason }) {
+      const next = parseOutcomeAuthor(author, "outcome author");
+      if (!reason?.trim()) {
+        throw new Error('flow outcome author requires --reason "<why>"');
+      }
+      validateSingleLineReason(reason);
+      let previous = "unknown";
+      let changed = false;
+      const flow = await mutate(cwd, id, async ({ dir, flow: current }) => {
+        previous = readOutcomeAuthor(current.outcomeAuthor);
+        if (previous === next) {
+          return current;
+        }
+        changed = true;
+        current.outcomeAuthor = next;
+        return save(cwd, dir, current, "outcome-author-set", `${previous} -> ${next} (${reason.trim()})`);
+      });
+      return { flow, previous, changed };
+    },
     async freeze({ cwd, id }) {
       return mutate(cwd, id, async ({ dir, flow }) => {
         assertTransition(flow.status, "ready");
@@ -51785,6 +51827,8 @@ var init_service9 = __esm(() => {
   init_validator();
   init_machine();
   init_review_gate();
+  init_outcome_author();
+  init_outcome_author();
   init_flow_move();
   init_ac_reseal();
   init_schema3();
@@ -96328,7 +96372,8 @@ function flowItemFromState(flow, dir) {
     createdAt: flow.createdAt,
     updatedAt: flow.updatedAt,
     source: flow.source.ref ?? flow.source.type,
-    tasks: flow.tasks.map((task) => ({ id: task.id, title: task.title, status: task.status }))
+    tasks: flow.tasks.map((task) => ({ id: task.id, title: task.title, status: task.status })),
+    outcomeAuthor: readOutcomeAuthor(flow.outcomeAuthor)
   };
 }
 function localSacGuard() {
@@ -96548,6 +96593,7 @@ function formatFlowDetailLines(item) {
   return [
     `${item.id}  ${item.title}`,
     `Status   ${item.status}`,
+    `Outcome author  ${item.outcomeAuthor ?? "unknown"}`,
     ...item.interrupted ? [`         ${item.interrupted}`] : [],
     ...item.uncommitted ? [`         note: ${item.uncommitted}`] : [],
     `Dir      ${item.dir}`,
@@ -96937,7 +96983,8 @@ function extractFlowIntent(source, repoPath) {
     status: closed ? "closed" : "open",
     flowStatus: status,
     closedAt: closed ? closedAtOf(flow) : null,
-    outcome: { criterion, ...observationFrom(source.journal) }
+    outcome: { criterion, ...observationFrom(source.journal) },
+    outcomeAuthor: readOutcomeAuthor(flow.outcomeAuthor)
   };
 }
 function extractDocpackIntent(source, repoPath) {
@@ -97209,6 +97256,8 @@ function indexProblem(value) {
       return "index.json holds an intent with an unusable note";
     if (outcome.observed === true && outcome.verdict === null)
       return "index.json holds an observed intent without a verdict";
+    if (intent.outcomeAuthor !== undefined && !OUTCOME_AUTHOR_READINGS.includes(intent.outcomeAuthor))
+      return "index.json holds an intent with an unknown outcome author";
   }
   return null;
 }
@@ -97244,6 +97293,7 @@ async function checkStaleness(cwd, index) {
 }
 var COUNT_KEYS;
 var init_store7 = __esm(() => {
+  init_service9();
   init_fs();
   init_corpus();
   init_types8();
@@ -97258,7 +97308,8 @@ function buildOpenReport(index) {
     path: intent.path,
     closedAt: intent.closedAt,
     outcome: hasInstrument(intent.outcome.criterion) ? intent.outcome.criterion : intent.outcome.criterion ?? NO_INSTRUMENT,
-    hasCriterion: hasInstrument(intent.outcome.criterion)
+    hasCriterion: hasInstrument(intent.outcome.criterion),
+    outcomeAuthor: readOutcomeAuthor(intent.outcomeAuthor)
   })).sort((a, b) => (b.closedAt ?? "").localeCompare(a.closedAt ?? "") || Number.parseInt(b.id, 10) - Number.parseInt(a.id, 10) || (a.path < b.path ? -1 : 1));
   const { counts } = index;
   return {
@@ -97293,6 +97344,7 @@ function openEntryLines(entry) {
   return [
     `${label}  ${entry.title}`,
     `${pad}outcome: ${entry.outcome}`,
+    `${pad}outcome author: ${entry.outcomeAuthor}`,
     `${pad}closed ${entry.closedAt === null ? "at an unrecorded time" : entry.closedAt.slice(0, 10)}`
   ];
 }
@@ -97330,6 +97382,7 @@ function renderIndexSummary(index, file) {
 }
 var REBUILD = "Run `keryx product index`.";
 var init_open = __esm(() => {
+  init_service9();
   init_extract3();
   init_store7();
 });
@@ -122434,6 +122487,8 @@ async function flowCommand(args) {
         return await runCheckAcCommand(args.slice(1));
       case "owner":
         return await runOwner(args.slice(1));
+      case "outcome":
+        return await runOutcome(args.slice(1));
       case "implemented":
         return await runImplemented(args.slice(1));
       case "complete":
@@ -122474,7 +122529,8 @@ async function runInit(args) {
     slug: optionValue(args, "--slug"),
     baseBranch: optionValue(args, "--base"),
     owner: optionValue(args, "--owner"),
-    requireConfirmation: args.includes("--require-confirmation")
+    requireConfirmation: args.includes("--require-confirmation"),
+    outcomeAuthor: outcomeAuthorFlag(args)
   });
   banner("flow init", `Created flow ${result.flow.id}`);
   console.log(`  ${style.green(symbols.ok)} ${style.bold(result.flow.title)}`);
@@ -122484,6 +122540,7 @@ async function runInit(args) {
     console.log(`  base:   ${result.flow.baseBranch}`);
   }
   console.log(`  owner:  ${result.flow.owner?.value ?? style.dim("not set")}`);
+  console.log(`  outcome author: ${readOutcomeAuthor(result.flow.outcomeAuthor)}`);
   if (result.flow.gates?.confirmation) {
     console.log(`  confirmation: required ${style.dim("(a terminal-minted token: `keryx flow confirm <id>`)")}`);
   }
@@ -122502,6 +122559,13 @@ async function runInit(args) {
     `Freeze and start: ${style.cyan(`keryx flow freeze ${result.flow.id}`)} then ${style.cyan(`flow start ${result.flow.id}`)}.`
   ]);
 }
+function outcomeAuthorFlag(args) {
+  const given = args.filter((arg) => arg === "--outcome-author" || arg.startsWith("--outcome-author=")).length;
+  if (given > 1) {
+    throw new Error("--outcome-author was given more than once; pass it once, as agent or human.");
+  }
+  return given === 1 ? optionValue(args, "--outcome-author") ?? "" : undefined;
+}
 async function runPlan(args) {
   const id = requireId(args);
   const cwd = process.cwd();
@@ -122598,6 +122662,7 @@ async function runStatus(args) {
   const acLabel = flow.acChecksum ? style.green("frozen") : style.yellow("not frozen");
   console.log(`  AC:      ${acLabel}, ${Object.keys(flow.acConfirmed).length} confirmed`);
   console.log(`  PR:      ${flow.pr.url ? style.cyan(flow.pr.url) : style.dim("none")}`);
+  console.log(`  outcome author: ${readOutcomeAuthor(flow.outcomeAuthor)}`);
   console.log(`  owner:   ${flow.owner?.value ? `${flow.owner.value} ${style.dim(`[${flow.owner.basis}]`)}` : style.dim("not set")}`);
   const latestSignature = flow.signatures?.at(-1);
   console.log(`  signed:  ${latestSignature ? `${latestSignature.identity.value ?? "unknown"} ${style.dim(`[${latestSignature.identity.basis}]`)} ${style.dim(`(${latestSignature.kind}, ${latestSignature.at})`)}${latestSignature.confirmation ? ` ${style.dim(`+ terminal token ${latestSignature.confirmation.tokenRef}`)}` : ""}` : style.dim("no signatures yet")}`);
@@ -122841,6 +122906,34 @@ async function runOwner(args) {
   }
   throw new Error('Usage: keryx flow owner set <id> --owner "<name>" --reason "<why>"');
 }
+async function runOutcome(args) {
+  if (args[0] !== "author") {
+    throw new Error(OUTCOME_AUTHOR_USAGE);
+  }
+  const rest = args.slice(1);
+  const positionals = [];
+  for (let i = 0;i < rest.length; i += 1) {
+    const arg = rest[i] ?? "";
+    if (arg === "--reason") {
+      i += 1;
+    } else if (!arg.startsWith("--")) {
+      positionals.push(arg);
+    }
+  }
+  const id = positionals[0];
+  const author = positionals[1];
+  if (!id || author === undefined || positionals.length > 2) {
+    throw new Error(OUTCOME_AUTHOR_USAGE);
+  }
+  const result = await getService2().outcomeAuthorSet({
+    cwd: process.cwd(),
+    id,
+    author,
+    reason: optionValue(rest, "--reason") ?? ""
+  });
+  const after = readOutcomeAuthor(result.flow.outcomeAuthor);
+  console.log(result.changed ? `  ${style.green(symbols.ok)} Outcome author ${result.previous} ${style.cyan(symbols.arrow)} ${style.bold(after)}` : `  ${style.dim(symbols.bullet)} Outcome author already ${style.bold(after)}; nothing written`);
+}
 async function runAc(args) {
   const sub = args[0];
   if (sub === "confirm") {
@@ -123188,6 +123281,7 @@ function printHelp5() {
     'keryx flow task attempt <id> <taskId> --outcome started|failed|blocked [--detail "<what happened>"]',
     'keryx flow task depends <id> <taskId> --on T1,T2|none --reason "<why>"   (repair an unsatisfiable dependsOn)',
     'keryx flow owner set <id> --owner "<name>" --reason "<why>"   (the human accountable; never inferred)',
+    'keryx flow outcome author <id> agent|human --reason "<why>"   (who wrote the outcome criterion; journaled, gates nothing)',
     'keryx flow ac confirm <id> <ACn> [--note "<evidence>"] [--signed-by "<name>"]',
     'keryx flow ac update <id> --reason "<why>"   (re-freeze the file as already edited; VOIDS prior confirmations)',
     'keryx flow ac update <id> --criterion ACn --text "<criterion>" --reason "<why>"   (rewrite/append that one criterion, then re-freeze; VOIDS prior confirmations)',
@@ -123207,9 +123301,10 @@ function printHelp5() {
     "keryx flow schema [--out <path>]"
   ]);
   note("`--signed-by` names the signer explicitly (stated). Falls back to KERYX_ACTOR (also " + "stated), then to `git config user.email` in this checkout (derived \u2014 the person who " + "RAN the command, not necessarily who signed), then to `unknown`. None of these is proof a human signed: a flag, an environment variable, and a local git identity can all be set " + "by an agent. `--owner` is never inferred at all \u2014 see docs/decisions/keryx-harness/.");
+  note("`flow init --outcome-author agent|human` records who wrote the outcome criterion: `agent` (the default when the flag " + "is absent) or `human`, and `human` only when the flag says so \u2014 never inferred from a git " + "identity, an owner or the environment. A flow without the field reads `unknown`. The flag labels a sample and gates nothing.");
   note("`flow confirm` mints a short-lived, single-use token only for a flow created with `--require-confirmation` (or `completion.require_confirmation: true`). " + CONFIRMATION_CAVEAT + " See docs/decisions/keryx-harness/TM-03-terminal-confirmation-token.md.");
 }
-var VALID_TASK_KINDS, WARN = "!", AC_CONFIRM_FLAGS, AC_UPDATE_FLAGS, AC_RESEAL_FLAGS, VALID_DISPOSITIONS, service5 = null, CHALLENGE_ALPHABET = "abcdefghjkmnpqrstuvwxyz23456789";
+var VALID_TASK_KINDS, WARN = "!", AC_CONFIRM_FLAGS, AC_UPDATE_FLAGS, AC_RESEAL_FLAGS, VALID_DISPOSITIONS, service5 = null, OUTCOME_AUTHOR_USAGE = 'Usage: keryx flow outcome author <id> agent|human --reason "<why>"', CHALLENGE_ALPHABET = "abcdefghjkmnpqrstuvwxyz23456789";
 var init_flow = __esm(() => {
   init_args();
   init_fs();
@@ -159494,7 +159589,7 @@ var init_command_registry = __esm(() => {
     {
       module: "tasks",
       command: "flow status",
-      summary: "One flow's full status: lifecycle state, AC freeze/confirmation count, PR, owner, latest signature, task list, and recent history.",
+      summary: "One flow's full status: lifecycle state, outcome author (agent, human or unknown), AC freeze/confirmation count, PR, owner, latest signature, task list, and recent history.",
       intent: ["\u0441\u0442\u0430\u0442\u0443\u0441 \u0444\u043B\u043E\u0443", "flow status", "flow details", "show one flow"],
       args: [{ name: "<id>", type: "string", required: true, desc: "flow id" }],
       json: false,
@@ -159503,7 +159598,7 @@ var init_command_registry = __esm(() => {
     {
       module: "tasks",
       command: "flow init",
-      summary: "Create a new flow (managed work item): allocates an id, scaffolds its directory, and collects initial " + "context from the source issue if one is given. `--owner` is NEVER inferred \u2014 only an explicit value " + "on this command populates it.",
+      summary: "Create a new flow (managed work item): allocates an id, scaffolds its directory, and collects initial " + "context from the source issue if one is given. `--owner` is NEVER inferred \u2014 only an explicit value " + "on this command populates it. `--outcome-author` records who wrote the outcome criterion (default " + "`agent`; `human` only when the flag says so).",
       intent: ["\u0441\u043E\u0437\u0434\u0430\u0439 \u0444\u043B\u043E\u0443", "flow init", "start a new flow", "new managed work item", "\u0437\u0430\u0432\u0435\u0434\u0438 \u0444\u043B\u043E\u0443"],
       args: [
         { name: "title", type: "string", required: false, desc: "work title; required unless --issue is given" },
@@ -159516,6 +159611,12 @@ var init_command_registry = __esm(() => {
           type: "bool",
           required: false,
           desc: "opt this flow into the confirmation gate: `flow complete` then needs a token minted by `flow confirm` (flow 299)"
+        },
+        {
+          name: "outcome-author",
+          type: "string",
+          required: false,
+          desc: "who wrote the outcome criterion: agent (the default when omitted) or human; never inferred, any other value is refused before the flow is created; gates nothing"
         }
       ],
       json: false,
@@ -159539,6 +159640,20 @@ var init_command_registry = __esm(() => {
       read: false,
       sideEffects: ["writes flow.json's owner field (basis: stated) and appends a history entry"]
     },
+    {
+      module: "tasks",
+      command: "flow outcome author",
+      summary: "Change who wrote a flow's outcome criterion (agent or human). Requires a reason; appends one journal line " + "naming the old value (or `unknown`), the new value and the reason, and writes nothing when the value is unchanged. Gates nothing.",
+      intent: ["\u043A\u0442\u043E \u043D\u0430\u043F\u0438\u0441\u0430\u043B \u043A\u0440\u0438\u0442\u0435\u0440\u0438\u0439 \u0438\u0441\u0445\u043E\u0434\u0430", "flow outcome author", "set outcome author", "mark outcome criterion as human", "\u0430\u0432\u0442\u043E\u0440 \u043A\u0440\u0438\u0442\u0435\u0440\u0438\u044F \u0438\u0441\u0445\u043E\u0434\u0430"],
+      args: [
+        { name: "<id>", type: "string", required: true, desc: "flow id" },
+        { name: "<agent|human>", type: "string", required: true, desc: "who wrote the outcome criterion" },
+        { name: "reason", type: "string", required: true, desc: "why the author is being set or changed; one line" }
+      ],
+      json: false,
+      read: false,
+      sideEffects: ["writes flow.json's outcomeAuthor field and appends one journal.md line and a history entry"]
+    },
     {
       module: "tasks",
       command: "flow ac confirm",

package/dist/core.js

@@ -21629,6 +21629,9 @@ __export(exports_service2, {
   AC_CHECK_TOKEN_BUDGET: () => AC_CHECK_TOKEN_BUDGET,
   AC_KINDS: () => AC_KINDS,
   CONFIRMATION_CAVEAT: () => CONFIRMATION_CAVEAT,
+  DEFAULT_OUTCOME_AUTHOR: () => DEFAULT_OUTCOME_AUTHOR,
+  OUTCOME_AUTHORS: () => OUTCOME_AUTHORS,
+  OUTCOME_AUTHOR_READINGS: () => OUTCOME_AUTHOR_READINGS,
   OUTCOME_HINT: () => OUTCOME_HINT,
   REVIEW_GATE_CONFIG_PATH: () => REVIEW_GATE_CONFIG_PATH,
   acCheckCacheKey: () => acCheckCacheKey,
@@ -21655,11 +21658,13 @@ __export(exports_service2, {
   isFrozen: () => isFrozen,
   notCheckableVerdict: () => notCheckableVerdict,
   parseAcceptanceCriteria: () => parseAcceptanceCriteria,
+  parseOutcomeAuthor: () => parseOutcomeAuthor,
   proseOutsideFences: () => proseOutsideFences,
   readAcCheckCache: () => readAcCheckCache,
   readAcCheckEnabled: () => readAcCheckEnabled,
   readAcKindRecords: () => readAcKindRecords,
   readFlow: () => readFlow,
+  readOutcomeAuthor: () => readOutcomeAuthor,
   renderAcCheckAdvisoryNotice: () => renderAcCheckAdvisoryNotice,
   renderAcCheckReport: () => renderAcCheckReport,
   renderAcKindDistribution: () => renderAcKindDistribution,
@@ -23122,6 +23127,19 @@ async function reviewGate(input) {
   return { name: "review", status: verdict.status, detail: verdict.detail };
 }
 
+// src/flow/outcome-author.ts
+var OUTCOME_AUTHORS = ["agent", "human"];
+var OUTCOME_AUTHOR_READINGS = [...OUTCOME_AUTHORS, "unknown"];
+var DEFAULT_OUTCOME_AUTHOR = "agent";
+function readOutcomeAuthor(value) {
+  return value === "agent" || value === "human" ? value : "unknown";
+}
+function parseOutcomeAuthor(raw, flag = "--outcome-author") {
+  if (raw === "agent" || raw === "human")
+    return raw;
+  const shown = typeof raw === "string" ? `"${raw}"` : "nothing";
+  throw new Error(`${flag} must be one of: ${OUTCOME_AUTHORS.join(", ")} (got ${shown}).`);
+}
 // src/flow/identity.ts
 function resolveSignerIdentity(input) {
   const stated = input.stated?.trim();
@@ -23408,6 +23426,11 @@ function flowStateSchema() {
         $ref: "#/definitions/identity",
         description: "The human accountable for this flow, or absent if one was never set. Never inferred: only ever written by an explicit `--owner` on `flow init` or `flow owner set`, so `basis` is always `stated`."
       },
+      outcomeAuthor: {
+        type: "string",
+        enum: ["agent", "human"],
+        description: "Who wrote the outcome criterion. Written by `flow init --outcome-author` (default `agent`; `human` only when the flag says so, never inferred) and changed only by `flow outcome author`, which journals the change. Absent on flows created before the field existed, and read as `unknown` (neither agent nor human). Gates nothing."
+      },
       signatures: {
         type: "array",
         description: "Append-only signing record for `flow ac confirm` and a passing `flow complete`. Absent means never signed under this field's existence.",
@@ -24890,6 +24913,7 @@ function createFlowService(deps) {
       if (input.owner !== undefined && !input.owner.trim()) {
         throw new Error(BLANK_OWNER_MESSAGE);
       }
+      const outcomeAuthor = input.outcomeAuthor === undefined ? DEFAULT_OUTCOME_AUTHOR : parseOutcomeAuthor(input.outcomeAuthor);
       const trackerReady = deps.tracker ? await deps.tracker.detect() : false;
       const tracker = trackerReady ? deps.tracker : null;
       const issueRef = input.issue && deps.tracker ? deps.tracker.parseRef(input.issue) : null;
@@ -24941,6 +24965,7 @@ function createFlowService(deps) {
           pr: { url: null },
           ...input.baseBranch === undefined ? {} : { baseBranch: input.baseBranch },
           ...input.owner?.trim() ? { owner: ownerIdentity(input.owner.trim(), "`--owner` flag on `flow init`") } : {},
+          outcomeAuthor,
           tasks: DEFAULT_TASKS.map((task) => ({ ...task, status: "todo" })),
           history: [{ at: createdAt, event: "created" }]
         };
@@ -24998,6 +25023,25 @@ function createFlowService(deps) {
         return save(cwd, dir, flow, previous === null ? "owner-set" : "owner-changed", detail);
       });
     },
+    async outcomeAuthorSet({ cwd, id, author, reason }) {
+      const next = parseOutcomeAuthor(author, "outcome author");
+      if (!reason?.trim()) {
+        throw new Error('flow outcome author requires --reason "<why>"');
+      }
+      validateSingleLineReason(reason);
+      let previous = "unknown";
+      let changed = false;
+      const flow = await mutate(cwd, id, async ({ dir, flow: current }) => {
+        previous = readOutcomeAuthor(current.outcomeAuthor);
+        if (previous === next) {
+          return current;
+        }
+        changed = true;
+        current.outcomeAuthor = next;
+        return save(cwd, dir, current, "outcome-author-set", `${previous} -> ${next} (${reason.trim()})`);
+      });
+      return { flow, previous, changed };
+    },
     async freeze({ cwd, id }) {
       return mutate(cwd, id, async ({ dir, flow }) => {
         assertTransition(flow.status, "ready");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrciphersmith/keryx",
-  "version": "0.3.32",
+  "version": "0.3.33",
   "description": "Version-controlled project context for AI coding agents: code graph, architecture wiki, project memory, relevant tests, quality signals, and task flows.",
   "private": false,
   "publishConfig": {