halfcycle 0.4.16 → 0.4.17

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "halfcycle",
-  "version": "0.4.16",
+  "version": "0.4.17",
   "description": "Halfcycle Method bundle — resolution-stub slash commands, remote method-delivery registration, and governance-hook wiring for a Halfcycle engagement repo. It ships NO worker role files: a project's roles are authored from that project's own recorded decisions at orchestration kickoff (FX-2, W3-F-27).",
   "commands": [
     {

package/bin/bin.bundle.mjs

@@ -15715,12 +15715,25 @@ var seatCoverageSchema = external_exports.object({
   message: "conformant cannot exceed enrolled",
   path: ["conformant"]
 });
+var LEFT_FOR_OWNER_TEXT_MAX = 300;
+var LEFT_FOR_OWNER_ENTRIES_MAX = 500;
+var leftForOwnerDecisionSchema = external_exports.object({
+  item: plainText(LEFT_FOR_OWNER_TEXT_MAX),
+  question: plainText(LEFT_FOR_OWNER_TEXT_MAX)
+}).strict();
+var leftForOwnerSchema = external_exports.object({
+  tasks: external_exports.array(plainText(LEFT_FOR_OWNER_TEXT_MAX)).max(LEFT_FOR_OWNER_ENTRIES_MAX),
+  waiting: external_exports.array(leftForOwnerDecisionSchema).max(LEFT_FOR_OWNER_ENTRIES_MAX)
+}).strict().refine((v) => v.tasks.length + v.waiting.length > 0, {
+  message: "is sent only when some work was left for the owner"
+});
 var observedCloseSchema = external_exports.object({
   sequence: external_exports.number().int().min(1),
   closedAt: utcIso8601,
   closedBy: closedBySchema,
   crossed: crossedSchema,
-  seatCoverage: seatCoverageSchema.nullable()
+  seatCoverage: seatCoverageSchema.nullable(),
+  leftForOwner: leftForOwnerSchema.optional()
 }).strict();
 var couldNotRunCheckSchema = external_exports.object({
   check: plainText(),
@@ -18411,7 +18424,7 @@ var ownerWaitDeclarationSchema = external_exports.object({
   path: ["fixedItem"]
 });
 var ownerWaitDeclarationsSchema = external_exports.object({ declarations: external_exports.array(ownerWaitDeclarationSchema) }).strict();
-var OWNER_WAIT_TOO_MANY = `This project already has ${String(OWNER_WAIT_ADDITIONS_MAX)} things added to what waits for the owner. Ask the owner to take one off in the console first.`;
+var OWNER_WAIT_TOO_MANY = `This project already has ${String(OWNER_WAIT_ADDITIONS_MAX)} things added to what waits for the owner. Ask the owner to take one off on their settings page in the console first; it cannot be done by typing in chat.`;
 
 // ../events/dist/pacing.js
 var CLAUDE_PLANS = Object.freeze([
@@ -23344,7 +23357,7 @@ function distinctBullets(explanations) {
   return bullets([...new Set(explanations)]);
 }
 function foundLine(count) {
-  return count === 1 ? "Halfcycle found 1 small thing to fix in this turn's work. The agent gets the details with your next message and will fix it; there is nothing for you to do." : `Halfcycle found ${count} small things to fix in this turn's work. The agent gets the details with your next message and will fix them; there is nothing for you to do.`;
+  return count === 1 ? `Halfcycle found 1 small thing to fix in this turn's work. The agent gets the details with your next message and will fix it; there is nothing for you to do. Say "fix it" to have it fixed.` : `Halfcycle found ${count} small things to fix in this turn's work. The agent gets the details with your next message and will fix them; there is nothing for you to do. Say "fix them" to have them fixed.`;
 }
 function fixedLine(count, all) {
   if (all)
@@ -23354,7 +23367,7 @@ function fixedLine(count, all) {
 function stillOpenMessage(explanations) {
   const n = explanations.length;
   const head = n === 1 ? "Halfcycle: 1 thing it found is still not fixed after the agent's last turn." : `Halfcycle: ${n} things it found are still not fixed after the agent's last turn.`;
-  const tail = n === 1 ? "Ask the agent to fix it, or tell it to leave it as it is if that is what you want." : "Ask the agent to fix them, or tell it to leave them as they are if that is what you want.";
+  const tail = n === 1 ? 'Ask the agent to fix it, or tell it to leave it as it is if that is what you want. Say "fix it" to have it fixed.' : 'Ask the agent to fix them, or tell it to leave them as they are if that is what you want. Say "fix them" to have them fixed.';
   return `${head}
 ${bullets(explanations)}
 ${tail}`;

package/dist/build-record/render-v2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-v2.d.ts","sourceRoot":"","sources":["../../src/build-record/render-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAmBL,KAAK,WAAW,EAQjB,MAAM,mBAAmB,CAAC;AA8J3B;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAepD;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOvD;AA2MD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAO/D;AAwVD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAgFvE"}
+{"version":3,"file":"render-v2.d.ts","sourceRoot":"","sources":["../../src/build-record/render-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,EAmBL,KAAK,WAAW,EAQjB,MAAM,mBAAmB,CAAC;AA8J3B;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAepD;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASpD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOvD;AA2PD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAO/D;AA2WD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAgFvE"}

package/dist/cli.js

@@ -1446,12 +1446,25 @@ var seatCoverageSchema = z6.object({
   message: "conformant cannot exceed enrolled",
   path: ["conformant"]
 });
+var LEFT_FOR_OWNER_TEXT_MAX = 300;
+var LEFT_FOR_OWNER_ENTRIES_MAX = 500;
+var leftForOwnerDecisionSchema = z6.object({
+  item: plainText(LEFT_FOR_OWNER_TEXT_MAX),
+  question: plainText(LEFT_FOR_OWNER_TEXT_MAX)
+}).strict();
+var leftForOwnerSchema = z6.object({
+  tasks: z6.array(plainText(LEFT_FOR_OWNER_TEXT_MAX)).max(LEFT_FOR_OWNER_ENTRIES_MAX),
+  waiting: z6.array(leftForOwnerDecisionSchema).max(LEFT_FOR_OWNER_ENTRIES_MAX)
+}).strict().refine((v) => v.tasks.length + v.waiting.length > 0, {
+  message: "is sent only when some work was left for the owner"
+});
 var observedCloseSchema = z6.object({
   sequence: z6.number().int().min(1),
   closedAt: utcIso8601,
   closedBy: closedBySchema,
   crossed: crossedSchema,
-  seatCoverage: seatCoverageSchema.nullable()
+  seatCoverage: seatCoverageSchema.nullable(),
+  leftForOwner: leftForOwnerSchema.optional()
 }).strict();
 var couldNotRunCheckSchema = z6.object({
   check: plainText(),
@@ -4979,11 +4992,15 @@ function ownerWaitItemPhraseOf(item) {
   const bare = cut.endsWith(".") ? cut.slice(0, -1) : cut;
   return bare.charAt(0).toLowerCase() + bare.slice(1);
 }
-var OWNER_WAIT_TOO_MANY = `This project already has ${String(OWNER_WAIT_ADDITIONS_MAX)} things added to what waits for the owner. Ask the owner to take one off in the console first.`;
+var OWNER_WAIT_TOO_MANY = `This project already has ${String(OWNER_WAIT_ADDITIONS_MAX)} things added to what waits for the owner. Ask the owner to take one off on their settings page in the console first; it cannot be done by typing in chat.`;
+function ownerWaitClosedItemOf(item) {
+  if (!("fixed" in item))
+    return `"${item.addedWords}" (added by an agent)`;
+  const phrase = ownerWaitItemPhraseOf(item.fixed);
+  return phrase.charAt(0).toUpperCase() + phrase.slice(1);
+}
 function ownerWaitClosedLineOf(item, question2) {
-  const phrase = "fixed" in item ? ownerWaitItemPhraseOf(item.fixed) : "";
-  const which = "fixed" in item ? phrase.charAt(0).toUpperCase() + phrase.slice(1) : `"${item.addedWords}" (added by an agent)`;
-  return `Waited for you: ${which} \u2014 the agent asked: "${question2}"`;
+  return `Waited for you: ${ownerWaitClosedItemOf(item)} \u2014 the agent asked: "${question2}"`;
 }
 var OWNER_WAIT_DECLARATIONS_READ_FAILED = "Halfcycle could not read the decisions that waited for you.";
 
@@ -5092,7 +5109,7 @@ function claudePlanFromAnswer(answer) {
   return CLAUDE_PLANS[Number(trimmed) - 1]?.id ?? null;
 }
 function claudePlanRememberedText(plan, settingsUrl) {
-  return `Using the plan you gave before: ${claudePlanOf(plan).words}. You can change it at ${settingsUrl}.`;
+  return `Using the plan you gave before: ${claudePlanOf(plan).words}. You can change it on your settings page, not by typing in chat: ${settingsUrl}`;
 }
 function paceP1Of(n, minutes) {
   const first = `Halfcycle suggests running ${paceAgentsOf(n)} at once.`;
@@ -5107,7 +5124,7 @@ function paceP3Of(window) {
 }
 function paceP4Of(n, settingsUrl) {
   const first = `Halfcycle does not know which Claude plan you use, so it starts with ${String(n)}.`;
-  return settingsUrl === null ? first : `${first} You can say which at ${settingsUrl}.`;
+  return settingsUrl === null ? first : `${first} You can say which on your settings page, not by typing in chat: ${settingsUrl}`;
 }
 var PACE_P5 = "This build may use all of your allowance. It will not slow down to leave room for you.";
 function paceP6Of(k) {
@@ -5115,7 +5132,7 @@ function paceP6Of(k) {
 }
 function paceP7Of(settingsUrl) {
   const first = "Say a different number to change it.";
-  return settingsUrl === null ? first : `${first} To let builds use all of your allowance, change it at ${settingsUrl}.`;
+  return settingsUrl === null ? first : `${first} To let builds use all of your allowance, change it on your settings page, not by typing in chat: ${settingsUrl}`;
 }
 function paceStartLinesOf(s) {
   const lines = [paceP1Of(s.number, s.minutes)];
@@ -5330,8 +5347,9 @@ var savedSchema = z33.object({
 function autonomyA13(accepted, carried) {
   return `Your autonomy setting accepted the ${String(accepted)} built parts and carried ${String(carried)} unbuilt parts forward. The phase is closed.`;
 }
-function autonomyA14(count, parts) {
-  return `The phase waits for you: ${String(count)} tests the agents said pass were not run by Halfcycle, so ${namesOf(parts)} wait for you too. Only you can accept or reject those tests and decide those parts. See the console's review.`;
+function autonomyA14(count, parts, acceptLine) {
+  const typed = acceptLine === null ? 'say "review what was built" and type the lines it gives.' : `say "review what was built", then type ${acceptLine}.`;
+  return `The phase waits for you: ${String(count)} tests the agents said pass were not run by Halfcycle, so ${namesOf(parts)} wait for you too. Only you can accept or reject those tests, in the console's review; that cannot be done by typing in chat. Then decide those parts there, or in your own Claude Code session: ` + typed;
 }
 function autonomyA15(count) {
   return `The phase waits for you: ${String(count)} parts were built without an approved scope, and only you can decide them.`;
@@ -10457,6 +10475,27 @@ function renderCouldNotRun(entries, p) {
 function headlineText(observed, attested, checks) {
   const met = attested.decision === "done-when-met";
   const problemsReported = attested.walk !== null && attested.walk.verdict === "defects";
+  const left = observed.leftForOwner;
+  if (left !== void 0 && observed.crossed.kind === "none") {
+    const saw = `Halfcycle saw work that waits for you: ${leftForYouSummary(left)}, each listed in this record.`;
+    if (!met) {
+      return [LEFT_FOR_YOU_TITLE, `${saw} The person closing the phase chose to override rather than state its finish conditions were met.`];
+    }
+    return problemsReported ? [LEFT_FOR_YOU_TITLE, `${saw} The person closing the phase reported problems found in its acceptance walk.`] : [LEFT_FOR_YOU_TITLE, `${saw} The person closing the phase stated its finish conditions were met, but this work is still yours to do.`];
+  }
+  const [title, sentence] = headlineOverCrossed(observed, met, problemsReported, checks);
+  return left === void 0 ? [title, sentence] : [title, `${sentence} Halfcycle also saw work that waits for you: ${leftForYouSummary(left)}, each listed in this record.`];
+}
+var LEFT_FOR_YOU_TITLE = "Closed with work left for you.";
+function leftForYouSummary(left) {
+  const parts = [];
+  if (left.tasks.length > 0)
+    parts.push(`${counted(left.tasks.length, "task", "tasks")} held for you`);
+  if (left.waiting.length > 0)
+    parts.push(`${counted(left.waiting.length, "decision", "decisions")} waiting for your answer`);
+  return parts.join(" and ");
+}
+function headlineOverCrossed(observed, met, problemsReported, checks) {
   switch (observed.crossed.kind) {
     case "none":
       if (!met) {
@@ -10524,6 +10563,18 @@ function outstanding(crossed, p) {
       ];
   }
 }
+function leftForYouLines(left, p) {
+  if (left === void 0)
+    return [];
+  const lines = [`- Work left for you when the phase closed, which only you can do: ${leftForYouSummary(left)}.`];
+  for (const title of left.tasks)
+    lines.push(`  - Task held for you: ${p.text(title)}`);
+  for (const decision of left.waiting) {
+    lines.push(`  - Decision waiting for your answer, as the agent asked it: ${p.text(decision.question)}`);
+    lines.push(`    - On the list of what always waits for you as: ${p.text(decision.item)}`);
+  }
+  return lines;
+}
 function shownBy(steps) {
   const named = steps.filter((s) => s.name !== void 0).length;
   if (named === 0)
@@ -10596,6 +10647,7 @@ function renderClose(heading, observed, attested, checks, p, closingRound = fals
       `- Closed at: ${closedAtText(observed.closedAt, p)}`,
       `- Signed in as: ${signedInAs(observed.closedBy, p)}`,
       ...outstanding(observed.crossed, p),
+      ...leftForYouLines(observed.leftForOwner, p),
       machines(observed.seatCoverage, checks)
     ].join("\n"),
     STATED_LABEL,
@@ -12926,7 +12978,8 @@ function uncheckedClaimLine(test) {
 }
 function answerClaimsInSystemViewLine(engagementId, phase) {
   const address = systemViewUrl(engagementId, phase);
-  return address === void 0 ? "Accept or reject each one in the System view." : `Accept or reject each one in the System view: ${address}`;
+  const only = "Accept or reject each one in the System view; this cannot be done by typing in chat";
+  return address === void 0 ? `${only}.` : `${only}: ${address}`;
 }
 function checksSectionLines(work, engagementId) {
   const unchecked = work.tasks.flatMap((task) => task.tests.filter((t) => t.state === "unchecked"));
@@ -13339,14 +13392,25 @@ function reviewOpenedLine(phase) {
   return `[halfcycle] The review of phase "${phase}" is open. The project's owner reviews each part: accept it, ask a question or send it back. Each part that was not built is carried to the next phase or dropped, with a reason. The phase closes when every part is decided.`;
 }
 var COULD_NOT_COUNT_LINE = "[halfcycle] Halfcycle could not count what this phase changed, so the owner judges each part on what the agents reported alone.";
-function typedReviewHintLine(offered) {
-  return offered ? '[halfcycle] The owner reviews each part in their own Claude Code session: they say "review what was built" to see the list, then type one decision per line.' : `[halfcycle] ${TYPED_REVIEW_OFF_SENTENCE}`;
+function typedAcceptLine(phase) {
+  return phase.includes(":") ? null : `accept ${phase}`;
+}
+function typedReviewHintLine(offered, phase) {
+  if (!offered)
+    return `[halfcycle] ${TYPED_REVIEW_OFF_SENTENCE}`;
+  const accept = typedAcceptLine(phase);
+  const lines = accept === null ? "then type one decision per line, as the whole message." : `then type ${accept} as the whole message to accept every built part, or one line per part, such as ${accept}/<part>; the list gives each part's lines.`;
+  return `[halfcycle] The owner reviews each part in their own Claude Code session: they say "review what was built" to see the list, ${lines}`;
 }
 function systemViewReviewLine(offered, engagementId, phase) {
   const address = systemViewUrl(engagementId, phase);
   if (address === void 0)
     return void 0;
-  return offered ? `[halfcycle] Or the owner reviews it in the System view: ${address}` : `[halfcycle] The owner reviews it in the System view: ${address}`;
+  if (!offered)
+    return `[halfcycle] The owner reviews it in the System view: ${address}`;
+  const accept = typedAcceptLine(phase);
+  const instead = accept === null ? "typing in their own Claude Code session" : `typing ${accept} in their own Claude Code session`;
+  return `[halfcycle] Or, instead of ${instead}, the owner reviews it in the System view: ${address}`;
 }
 function tasksOpenLine(phase, open, more) {
   const total = open.length + more;
@@ -13399,7 +13463,7 @@ function closeStepReport(phase, attempt, engagementId) {
           stdout.push(reviewOpenedLine(phase));
           if (!answer.counted)
             stdout.push(COULD_NOT_COUNT_LINE);
-          stdout.push(typedReviewHintLine(answer.typedReviewOffered));
+          stdout.push(typedReviewHintLine(answer.typedReviewOffered, phase));
           {
             const viewLine = systemViewReviewLine(answer.typedReviewOffered, engagementId, phase);
             if (viewLine !== void 0)
@@ -13436,7 +13500,7 @@ function closeStepReport(phase, attempt, engagementId) {
           exitCode = 0;
           break;
         case "autonomy-waits":
-          stdout.push(answer.reason === "unchecked-claims" ? autonomyA14(answer.count, answer.parts.map((p) => p.name)) : autonomyA15(answer.count));
+          stdout.push(answer.reason === "unchecked-claims" ? autonomyA14(answer.count, answer.parts.map((p) => p.name), typedAcceptLine(phase)) : autonomyA15(answer.count));
           exitCode = 0;
           break;
         default: