halfcycle 0.5.2 → 0.5.3

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "halfcycle",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "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

@@ -18103,6 +18103,30 @@ var phaseReviewViewSchema = external_exports.discriminatedUnion("state", [
   phaseReviewOpenSchema,
   phaseReviewClosedSchema
 ]);
+function reviewPartAwaitingAnswer(part) {
+  return part.questions.some((q) => q.agentAnswer === void 0);
+}
+function reviewPartSentBackIn(part, round) {
+  return part.sentBack.some((s) => s.round === round);
+}
+function shownReviewEntryOf(view, shownAt) {
+  const parts = view.parts.map((p) => ({
+    part: p.part,
+    name: p.name,
+    built: p.built,
+    decidable: p.decidable,
+    awaitingAnswer: reviewPartAwaitingAnswer(p),
+    sentBack: reviewPartSentBackIn(p, view.round)
+  }));
+  return {
+    phase: view.phase,
+    number: view.number,
+    round: view.round,
+    reviewVersion: view.reviewVersion,
+    shownAt,
+    parts
+  };
+}
 
 // ../events/dist/client-version.js
 var CLIENT_VERSION_HEADER = "x-halfcycle-client";
@@ -18563,6 +18587,42 @@ var ownerWaitDeclarationSchema = external_exports.object({
 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 on their settings page in the console first; it cannot be done by typing in chat.`;
 
+// ../events/dist/owner-wait-answer.js
+var OWNER_WAIT_SHORT_ID_LENGTH = 8;
+var ownerWaitShortIdSchema = external_exports.string().regex(/^[0-9a-f]{8}$/);
+function ownerWaitShortIdOf(declarationId) {
+  return declarationId.slice(0, OWNER_WAIT_SHORT_ID_LENGTH).toLowerCase();
+}
+var OWNER_WAIT_ANSWER_ACTS = ["approve", "decline"];
+var ownerWaitAnswerActSchema = external_exports.enum(OWNER_WAIT_ANSWER_ACTS);
+function ownerWaitApproveLineOf(declarationId) {
+  return `approve wait ${ownerWaitShortIdOf(declarationId)}`;
+}
+function ownerWaitDeclineLineOf(declarationId) {
+  return `decline wait ${ownerWaitShortIdOf(declarationId)}: <why>`;
+}
+var ownerWaitChatRequestSchema = external_exports.discriminatedUnion("act", [
+  external_exports.object({ act: external_exports.literal("approve"), wait: ownerWaitShortIdSchema }).strict(),
+  external_exports.object({ act: external_exports.literal("decline"), wait: ownerWaitShortIdSchema, note: scopeNoteWireSchema }).strict()
+]);
+function bareOutcome3(outcome) {
+  return external_exports.object({ outcome: external_exports.literal(outcome) }).strict();
+}
+var ownerWaitChatResultSchema = external_exports.discriminatedUnion("outcome", [
+  external_exports.object({
+    outcome: external_exports.literal("recorded"),
+    act: ownerWaitAnswerActSchema,
+    question: external_exports.string().min(1)
+  }).strict(),
+  external_exports.object({ outcome: external_exports.literal("refused"), problems: external_exports.array(systemDescriptionProblemSchema).min(1) }).strict(),
+  bareOutcome3("not-owner"),
+  bareOutcome3("no-owner"),
+  bareOutcome3("not-found"),
+  bareOutcome3("ambiguous"),
+  bareOutcome3("not-offered"),
+  bareOutcome3("unavailable")
+]);
+
 // ../events/dist/pacing.js
 var CLAUDE_PLANS = Object.freeze([
   Object.freeze({ id: "pro", words: "Pro", startingAgents: 2 }),
@@ -18765,6 +18825,8 @@ var autonomyActivityRowSchema = external_exports.object({
   // whether the agent says it can be undone
   how: statementText(STATEMENT_MAX).optional(),
   // how to undo it, when it can be
+  wait: ownerWaitShortIdSchema.optional(),
+  // the short id the owner types to answer a waiting decision
   at: utcIso8601
   // when it happened
 }).strict().superRefine((row, ctx) => {
@@ -18791,6 +18853,9 @@ var autonomyActivityRowSchema = external_exports.object({
       });
     }
   }
+  if (row.kind !== "waiting" && row.wait !== void 0) {
+    ctx.addIssue({ code: "custom", message: "only a waiting decision is answered by typing", path: ["wait"] });
+  }
   if (row.kind === "waiting" && (row.undoable !== void 0 || row.how !== void 0)) {
     ctx.addIssue({ code: "custom", message: "a waiting decision has not been made yet", path: ["undoable"] });
   }
@@ -31287,6 +31352,14 @@ function partShape(act, head, words) {
     return null;
   return { kind: "part", act, reference, part, words };
 }
+function bulkAcceptTargetOf(reference, record2) {
+  const phases = /* @__PURE__ */ new Map();
+  for (const shown2 of [...record2.reviews, ...record2.entries]) {
+    if (!phases.has(shown2.phase))
+      phases.set(shown2.phase, { phase: shown2.phase, number: shown2.number });
+  }
+  return resolvePhaseReference(reference, [...phases.values()]);
+}
 function matchReviewPhraseShape(shape, reviews) {
   const resolved = resolvePhaseReference(shape.reference, reviews);
   const act = shape.kind === "phase" ? "accept" : shape.kind === "reject" ? "reject" : shape.act;
@@ -31377,6 +31450,28 @@ function moveListedReviewForward(engagementId, home, listed, reviewVersion, deci
   }
 }
 
+// dist/hooks/wait-phrase.js
+var APPROVE = /^approve wait ([0-9a-f]{8})$/i;
+var DECLINE = /^decline wait ([0-9a-f]{8})(?:\s*:(.*))?$/is;
+function waitPhraseShape(prompt) {
+  if (typeof prompt !== "string")
+    return null;
+  const line2 = prompt.trim();
+  if (LINE_BREAK.test(line2))
+    return null;
+  const approve = APPROVE.exec(line2);
+  if (approve !== null)
+    return shapeOf("approve", approve[1], null);
+  const decline = DECLINE.exec(line2);
+  if (decline !== null)
+    return shapeOf("decline", decline[1], decline[2] === void 0 ? null : decline[2].trim());
+  return null;
+}
+function shapeOf(act, typed, words) {
+  const wait = typed.toLowerCase();
+  return ownerWaitShortIdSchema.safeParse(wait).success ? { act, wait, words } : null;
+}
+
 // dist/hooks/user-prompt-submit-lines.js
 var TELL_THE_PERSON = "Tell the person.";
 function line(text) {
@@ -31744,6 +31839,69 @@ function codexReviewLine(act) {
 function codexAutonomyLine() {
   return codexLine(`${AUTONOMY_NOTHING_CHANGED}: ${CODEX_TYPING_NEVER_COUNTS}. Turn it on or off with "${AUTONOMY_A1_TITLE}" in the console's settings.`);
 }
+function waitTypedLine(context) {
+  return context.act === "approve" ? ownerWaitApproveLineOf(context.wait) : ownerWaitDeclineLineOf(context.wait);
+}
+function waitRecordedLine(act, question) {
+  return act === "approve" ? line(`Recorded in your session: you approved "${question}". The agent can go ahead with it.`) : line(`Recorded in your session: you declined "${question}", with your words. The agent must not go ahead with it.`);
+}
+function waitNotAttendedLine() {
+  return line(`${NOTHING_RECORDED}: an answer counts only when a person types it into an open session.`);
+}
+function waitNotSignedInLine() {
+  return line(`${NOTHING_RECORDED}: this project is not signed in on this computer. ${HOOK_REMEDY}`);
+}
+function waitNotOwnerLine() {
+  return line(`${NOTHING_RECORDED}: only the project's owner can answer a decision that waits for them.`);
+}
+function waitNoOwnerLine() {
+  return line(`${NOTHING_RECORDED}: this project has no owner, so nobody can answer its decisions.`);
+}
+function waitNotFoundLine(context) {
+  return line(`${NOTHING_RECORDED}: no decision waiting for you has the id ${context.wait}. Type the line the agent gave you with its question, such as ${waitTypedLine(context)}.`);
+}
+function waitAmbiguousLine(context) {
+  return line(`${NOTHING_RECORDED}: more than one decision waiting for you starts with ${context.wait}. Ask the agent to put the question to you again.`);
+}
+function waitNoWordsLine(context) {
+  return line(`${NOTHING_RECORDED}: a decline needs your reason after the colon, as in ${ownerWaitDeclineLineOf(context.wait)}.`);
+}
+function waitRefusedLine() {
+  return line(`${NOTHING_RECORDED}: Halfcycle did not accept the words. Reword them in plain words and type the line again.`);
+}
+function waitSwitchedOffLine() {
+  return line(`${NOTHING_RECORDED}. ${TYPED_APPROVAL_OFF_SENTENCE}`);
+}
+function waitCannotReachLine() {
+  return line(`${NOTHING_RECORDED}: Halfcycle could not be reached just now. Type the line again in a minute.`);
+}
+function codexWaitLine(context) {
+  return codexLine(`${NOTHING_RECORDED}: ${CODEX_TYPING_NEVER_COUNTS}. To answer, type ${waitTypedLine(context)} in a Claude Code session on this project.`);
+}
+function waitLineForAnswer(context, answer) {
+  switch (answer.outcome) {
+    case "recorded":
+      return waitRecordedLine(answer.act, answer.question);
+    case "refused":
+      return waitRefusedLine();
+    case "not-owner":
+      return waitNotOwnerLine();
+    case "no-owner":
+      return waitNoOwnerLine();
+    case "not-found":
+      return waitNotFoundLine(context);
+    case "ambiguous":
+      return waitAmbiguousLine(context);
+    case "not-offered":
+      return waitSwitchedOffLine();
+    case "unavailable":
+      return waitCannotReachLine();
+    default: {
+      const unreachable = answer;
+      return unreachable;
+    }
+  }
+}
 
 // dist/hooks/user-prompt-submit.js
 var CHAT_REQUEST_TIMEOUT_MS = 6e3;
@@ -31768,6 +31926,7 @@ function agentOf(opts) {
 async function decideLine(opts) {
   let act = null;
   let autonomyAct = null;
+  let waitRecognised = false;
   const review = { recognised: false };
   try {
     const prompt = promptOf(opts.input);
@@ -31778,6 +31937,12 @@ async function decideLine(opts) {
     if (autonomyShape !== null) {
       autonomyAct = autonomyShape;
       return `${await decideAutonomy(autonomyShape, opts)}
+`;
+    }
+    const waitShape = waitPhraseShape(prompt);
+    if (waitShape !== null) {
+      waitRecognised = true;
+      return `${await decideWait(waitShape, opts)}
 `;
     }
     const reviewShape = reviewPhraseShape(prompt);
@@ -31795,6 +31960,9 @@ async function decideLine(opts) {
   } catch {
     if (autonomyAct !== null)
       return `${autonomyCannotReachLine()}
+`;
+    if (waitRecognised)
+      return `${waitCannotReachLine()}
 `;
     if (review.recognised)
       return `${reviewCannotReachLine()}
@@ -31840,6 +32008,57 @@ async function decideAutonomy(act, opts) {
   const { guardServiceToken, guardEngagementId } = read.config;
   return postAutonomy(act, guardEngagementId, guardServiceToken, env, opts.fetchFn);
 }
+async function decideWait(shape, opts) {
+  const env = opts.env ?? process.env;
+  const context = { act: shape.act, wait: shape.wait };
+  const typed = whoTyped(opts);
+  if (typed === "cannot-tell")
+    return codexWaitLine(context);
+  if (typed === "not-attended")
+    return waitNotAttendedLine();
+  const read = readConfig(env);
+  if (read.config === null) {
+    return readNeverConfiguredReason(env) === "not-this-account" ? waitNotOwnerLine() : waitNotSignedInLine();
+  }
+  let candidate = { act: "approve", wait: shape.wait };
+  if (shape.act === "decline") {
+    const words = shape.words ?? "";
+    if (words === "")
+      return waitNoWordsLine(context);
+    if (!scopeNoteWireSchema.safeParse(words).success)
+      return reviewWordsTooLongLine();
+    if (looksLikeSecret(words))
+      return reviewWordsLookSecretLine();
+    candidate = { act: "decline", wait: shape.wait, note: words };
+  }
+  const request = ownerWaitChatRequestSchema.parse(candidate);
+  const { guardServiceToken, guardEngagementId } = read.config;
+  const url2 = `${readControlOrigin(env).origin}/engagements/${encodeURIComponent(guardEngagementId)}/owner-waits/chat`;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), CHAT_REQUEST_TIMEOUT_MS);
+  try {
+    const response = await (opts.fetchFn ?? globalThis.fetch)(url2, {
+      method: "POST",
+      headers: { Authorization: `Bearer ${guardServiceToken}`, "Content-Type": "application/json" },
+      body: JSON.stringify(request),
+      signal: controller.signal
+    });
+    if (response.status === 401)
+      return waitNotSignedInLine();
+    if (response.status === 429 || response.status >= 500)
+      return waitCannotReachLine();
+    const parsed = ownerWaitChatResultSchema.safeParse(await response.json());
+    if (!parsed.success)
+      return waitCannotReachLine();
+    if (parsed.data.outcome === "recorded" && response.status !== 200)
+      return waitCannotReachLine();
+    return waitLineForAnswer(context, parsed.data);
+  } catch {
+    return waitCannotReachLine();
+  } finally {
+    clearTimeout(timer);
+  }
+}
 async function postAutonomy(act, engagementId, credential, env, fetchFn = globalThis.fetch) {
   const url2 = `${readControlOrigin(env).origin}/engagements/${encodeURIComponent(engagementId)}/autonomy/chat`;
   const controller = new AbortController();
@@ -31873,8 +32092,12 @@ async function decideReview(shape, opts, progress) {
     const read2 = readConfig(env);
     if (read2.config === null)
       return "";
-    const match2 = matchReviewPhraseShape(shape, readShownRecord(read2.config.guardEngagementId, opts.home).reviews);
-    if (match2.kind === "nothing")
+    const { guardEngagementId: engagementId, guardServiceToken: credential } = read2.config;
+    const record2 = readShownRecord(engagementId, opts.home);
+    const listed = matchReviewPhraseShape(shape, record2.reviews);
+    const fresh = listed.kind === "accept" && listedRecently(listed.entry.shownAt, (opts.now ?? Date.now)());
+    const target = listed.kind === "ambiguous" || fresh ? null : bulkAcceptTargetOf(shape.reference, record2);
+    if (target?.kind === "none")
       return "";
     progress.recognised = true;
     const typed2 = whoTyped(opts);
@@ -31882,7 +32105,11 @@ async function decideReview(shape, opts, progress) {
       return codexReviewLine("accept");
     if (typed2 === "not-attended")
       return reviewNotAttendedLine();
-    return checkAndSendReview(match2, read2.config.guardEngagementId, read2.config.guardServiceToken, env, opts);
+    if (target === null)
+      return checkAndSendReview(listed, engagementId, credential, env, opts);
+    if (target.kind === "ambiguous")
+      return reviewAmbiguousLine(target.entries.map((e) => e.phase));
+    return readThenAccept(shape, target.entry.phase, engagementId, credential, env, opts);
   }
   progress.recognised = true;
   const typed = whoTyped(opts);
@@ -31897,6 +32124,38 @@ async function decideReview(shape, opts, progress) {
   const match = matchReviewPhraseShape(shape, readShownRecord(read.config.guardEngagementId, opts.home).reviews);
   return checkAndSendReview(match, read.config.guardEngagementId, read.config.guardServiceToken, env, opts);
 }
+var REVIEW_READ_TIMEOUT_MS = 3e3;
+async function readThenAccept(shape, phase, engagementId, credential, env, opts) {
+  const fetchFn = opts.fetchFn ?? globalThis.fetch;
+  const url2 = `${readControlOrigin(env).origin}/engagements/${encodeURIComponent(engagementId)}/phases/${encodeURIComponent(phase)}/review`;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), REVIEW_READ_TIMEOUT_MS);
+  let raw;
+  try {
+    const response = await fetchFn(url2, {
+      method: "GET",
+      headers: { Authorization: `Bearer ${credential}` },
+      signal: controller.signal
+    });
+    if (response.status === 401)
+      return reviewNotSignedInLine();
+    if (response.status !== 200)
+      return reviewCannotReachLine();
+    raw = await response.json();
+  } catch {
+    return reviewCannotReachLine();
+  } finally {
+    clearTimeout(timer);
+  }
+  const parsed = phaseReviewViewSchema.safeParse(raw);
+  if (!parsed.success)
+    return reviewCannotReachLine();
+  const view = parsed.data;
+  if (view.state !== "open")
+    return reviewNoReviewLine(phase);
+  const entry = shownReviewEntryOf(view, new Date((opts.now ?? Date.now)()).toISOString());
+  return checkAndSendReview(matchReviewPhraseShape(shape, [entry]), engagementId, credential, env, opts);
+}
 async function checkAndSendReview(match, engagementId, credential, env, opts) {
   if (match.kind === "nothing" || match.kind === "show-first")
     return reviewShowFirstLine();