halfcycle 0.12.0 → 0.13.0-rc.2

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "halfcycle",
-  "version": "0.12.0",
+  "version": "0.13.0-rc.2",
   "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

@@ -16293,13 +16293,39 @@ var leftForOwnerSchema = external_exports.object({
 }).strict().refine((v) => v.tasks.length + v.waiting.length > 0, {
   message: "is sent only when some work was left for the owner"
 });
+var TASKS_FILE_PATH = "docs/tasks.md";
+function isTicket(ref, url2) {
+  const issue2 = /^#([1-9][0-9]{0,9})$/.exec(ref);
+  if (issue2 === null)
+    return ref === TASKS_FILE_PATH && (url2 === void 0 || url2 === null);
+  if (url2 === void 0 || url2 === null)
+    return true;
+  const address = /^(.*)\/issues\/([1-9][0-9]{0,9})$/.exec(url2);
+  return address !== null && address[2] === issue2[1] && GITHUB_REPOSITORY_ADDRESS.test(address[1]) && !looksLikeSecret(url2);
+}
+var TICKET_MESSAGE = `must be #<number> or ${TASKS_FILE_PATH}, with a link only beside #<number>: https://github.com/<owner>/<repo>/issues/<number>`;
+var ticketSchema = external_exports.object({
+  ref: external_exports.string(),
+  url: external_exports.string().optional()
+}).strict().refine((t) => isTicket(t.ref, t.url), { message: TICKET_MESSAGE });
+var TICKET_TITLE_MAX = 240;
+var TICKETS_MAX = 500;
+var ticketEntrySchema = external_exports.object({
+  title: plainText(TICKET_TITLE_MAX),
+  ref: external_exports.string(),
+  url: external_exports.string().nullable()
+}).strict().refine((t) => isTicket(t.ref, t.url), { message: TICKET_MESSAGE });
+var ticketsSchema = external_exports.object({
+  entries: external_exports.array(ticketEntrySchema).min(1).max(TICKETS_MAX)
+}).strict();
 var observedCloseSchema = external_exports.object({
   sequence: external_exports.number().int().min(1),
   closedAt: utcIso8601,
   closedBy: closedBySchema,
   crossed: crossedSchema,
   seatCoverage: seatCoverageSchema.nullable(),
-  leftForOwner: leftForOwnerSchema.optional()
+  leftForOwner: leftForOwnerSchema.optional(),
+  tickets: ticketsSchema.optional()
 }).strict();
 var couldNotRunCheckSchema = external_exports.object({
   check: plainText(),
@@ -16846,7 +16872,8 @@ var buildTaskSchema = external_exports.object({
   ships: buildTaskShipsSchema.optional(),
   // The commit or version the task reported when it shipped, exactly as reported, as
   // one word with no spaces. Absent until it has shipped, or when it reported none.
-  shipped: external_exports.string().min(1).max(BUILD_TASK_SHIPPED_MAX).regex(/^[^\s\x00-\x1f\x7f-\x9f]*$/, { message: "must be one word, with no spaces or control characters" }).optional()
+  shipped: external_exports.string().min(1).max(BUILD_TASK_SHIPPED_MAX).regex(/^[^\s\x00-\x1f\x7f-\x9f]*$/, { message: "must be one word, with no spaces or control characters" }).optional(),
+  ticket: ticketSchema.optional()
 }).strict().superRefine((task, ctx) => {
   if (task.reviews !== void 0 && task.reviews === task.id) {
     ctx.addIssue({
@@ -17506,7 +17533,10 @@ var METHOD_FILE_PATTERNS = [
   "docs/phases",
   "docs/build-records",
   "docs/decisions",
-  "docs/components"
+  "docs/components",
+  TASKS_FILE_PATH,
+  ".gitignore",
+  ".gitattributes"
 ];
 var TEST_FILE_PATTERNS = [
   "**/*.test.*",
@@ -19003,7 +19033,7 @@ function paceHeldStartTextOf(input) {
 }
 var PACE_FIRST_READ = "Reading this computer's usage records for the first time. This can take a minute.";
 var PACE_AGENTS_TOO_MANY = `Run at most ${String(PACE_AGENTS_MAX)} agents at once.`;
-var PACE_ONLY_PERSON_RAISES = 'Only the person can raise the number of agents, by typing "faster" or "run 5 agents" in the chat. Nothing was changed.';
+var PACE_ONLY_PERSON_RAISES = 'The build is registered at the careful start. A higher number of agents waits for you: type "faster" or "run 5 agents" in the chat.';
 function paceStatusLineOf(percent, window) {
   return `Halfcycle \xB7 ${String(Math.round(percent))}% of this ${paceWindowWordsOf(window)} used`;
 }
@@ -19679,6 +19709,8 @@ var ownerWaitAddResultSchema = external_exports.discriminatedUnion("outcome", [
   external_exports.object({ outcome: external_exports.literal("refused"), reason: external_exports.literal("too-many") }).strict()
 ]);
 var ownerWaitUndoableSchema = external_exports.enum(["yes", "no"]);
+var OWNER_WAIT_STEP_MAX = 64;
+var ownerWaitStepSchema = external_exports.string().max(OWNER_WAIT_STEP_MAX).refine((v) => stepIdSchema.safeParse(v).success, { message: "must be the id of a step, as the method names it" });
 var ownerWaitDeclareRequestSchema = external_exports.object({
   engagementId: external_exports.string().min(1),
   item: ownerWaitItemRefSchema,
@@ -19687,7 +19719,8 @@ var ownerWaitDeclareRequestSchema = external_exports.object({
   task: buildTaskIdSchema.optional(),
   by: agentNameSchema.optional(),
   undoable: ownerWaitUndoableSchema.optional(),
-  how: statementText(STATEMENT_MAX).optional()
+  how: statementText(STATEMENT_MAX).optional(),
+  step: ownerWaitStepSchema.optional()
 }).strict().refine((r) => r.undoable === "yes" === (r.how !== void 0), {
   message: "says how to undo it exactly when it can be undone",
   path: ["how"]
@@ -27882,11 +27915,12 @@ async function runPaceVerb(args2, deps = {}) {
         named: named2
       });
       const suggested = suggestFor(null);
-      if (parsed.agents !== null && parsed.agents > (kept ?? suggested.number)) {
-        return { stdout: null, stderr: [...stderr, PACE_ONLY_PERSON_RAISES], code: 2 };
-      }
-      const named = parsed.agents ?? kept;
-      suggestion = { ...named === null ? suggested : suggestFor(named), ...ceiling };
+      const waits = parsed.agents !== null && parsed.agents > (kept ?? suggested.number);
+      if (waits)
+        stderr.push(PACE_ONLY_PERSON_RAISES);
+      const named = waits ? kept : parsed.agents ?? kept;
+      const startAt = waits && named === null ? CAREFUL_START_AGENTS : named;
+      suggestion = { ...startAt === null ? suggested : suggestFor(startAt), ...ceiling };
       number4 = suggestion.number;
       writeBuildNumber(engagementId, { phase: parsed.phase, number: number4, namedByOwner: named !== null }, deps.home);
       moveRelayedToPhase(engagementId, parsed.phase, project, deps.home);
@@ -32087,8 +32121,20 @@ function savedText(object2, cwd, env) {
   return text.ok ? text.value : null;
 }
 function recordRoot(abs, env) {
-  if (isInside(abs, env.projectDir))
-    return env.projectDir;
+  if (isInside(abs, env.projectDir)) {
+    const copies = join16(env.projectDir, ".claude", "worktrees");
+    if (!isInside(abs, copies) || !env.sameRepository(abs))
+      return env.projectDir;
+    let at = abs;
+    while (!isDirectory(at)) {
+      const up = dirname7(at);
+      if (up === at)
+        return env.projectDir;
+      at = up;
+    }
+    const top = env.repoRoot(at);
+    return top !== null && isInside(top, copies) ? top : env.projectDir;
+  }
   if (env.isTemp(abs) || !env.sameRepository(abs))
     return null;
   let dir = abs;
@@ -33014,7 +33060,7 @@ var NUMBERS_WAIT_MS = 50;
 var NUMBERS_LOCK_STALE_MS = 5e3;
 var NUMBERS_LOCK_POLL_MS = 2;
 var COPY_GIT_TIMEOUT_MS = 3e3;
-var ALLOW_NUMBER = new RegExp(`^${ALLOW_REPLY}(?: +([0-9]{1,4}))?$`);
+var ALLOW_NUMBER = new RegExp(`^${ALLOW_REPLY}(?: +([0-9]{1,4}))?\\.?$`);
 var STEP_MAX_LENGTH = 1e3;
 function allowReplyOf(prompt) {
   if (typeof prompt !== "string")
@@ -34993,6 +35039,53 @@ var AS_MANY = new RegExp(`^${VERB}as many agents as (?:possible|you can)${QUALIF
 var VAGUE = new RegExp(`^${VERB}(?:lots of|a lot of|loads of|plenty of|many|some|several|a few|a bunch of) agents${QUALIFIER}$`, "i");
 var KEEP_FREE = /^keep ([0-9]{1,3})% free$/i;
 var USE_UP_TO = /^use up to ([0-9]{1,3})%$/i;
+var INTENT_MAX_WORDS = 12;
+var WORD_OR_DIGITS = `-?[0-9]+(?:\\.[0-9]+)?|${NUMBER_WORDS.join("|")}`;
+var FILLER = /* @__PURE__ */ new Set([
+  "please",
+  "remember",
+  "we",
+  "need",
+  "to",
+  "let's",
+  "lets",
+  "can",
+  "you",
+  "now",
+  "build",
+  "building",
+  "run",
+  "use",
+  "go",
+  "start",
+  "at",
+  "with",
+  "the",
+  "a",
+  "and",
+  "keep"
+]);
+var NEGATED = /\?|\b(?:not|never)\b|don['’]?t/;
+var EXPR_MAX = /^(?:(?:max|maximum|full|top|fastest) (?:pace|speed)|as many agents as possible)$/;
+var EXPR_FASTER = /^(?:faster|more agents|(?:increase|raise|up) (?:pace|speed)|speed up)$/;
+var EXPR_SLOWER = /^(?:slower|slow down|fewer agents|(?:decrease|lower|reduce) (?:pace|speed))$/;
+var EXPR_AGENTS = new RegExp(`^(${WORD_OR_DIGITS}) agents?(?: once| in parallel)?$`);
+function intentShape(line2) {
+  const lowered = line2.toLowerCase().replace(/[.!,\s]+$/, "");
+  if (lowered.split(" ").length > INTENT_MAX_WORDS || NEGATED.test(lowered))
+    return null;
+  const rest = lowered.split(" ").map((w) => w.replace(/^[.!,]+|[.!,]+$/g, "")).filter((w) => w !== "" && !FILLER.has(w)).join(" ");
+  const agents = EXPR_AGENTS.exec(rest);
+  if (agents !== null)
+    return { kind: "agents", count: countOf(agents[1]) };
+  if (EXPR_MAX.test(rest))
+    return { kind: "max" };
+  if (EXPR_FASTER.test(rest))
+    return { kind: "faster" };
+  if (EXPR_SLOWER.test(rest))
+    return { kind: "slower" };
+  return null;
+}
 function countOf(said) {
   const word = NUMBER_WORDS.indexOf(said.toLowerCase());
   return word >= 0 ? word + 1 : Number(said);
@@ -35021,7 +35114,7 @@ function pacePhraseShape(prompt) {
   const use = USE_UP_TO.exec(line2);
   if (use !== null)
     return { kind: "use-up-to", percent: Number(use[1]) };
-  return null;
+  return intentShape(line2);
 }
 
 // dist/hooks/review-phrase.js
@@ -35933,10 +36026,10 @@ async function decidePace(shape, opts) {
     } catch {
     }
   };
-  if (shape.kind === "faster" || shape.kind === "agents" || shape.kind === "max") {
-    if (shape.kind === "faster" && running === null)
+  if (shape.kind === "faster" || shape.kind === "slower" || shape.kind === "agents" || shape.kind === "max") {
+    if ((shape.kind === "faster" || shape.kind === "slower") && running === null)
       return say(paceNoBuildText());
-    const number4 = shape.kind === "faster" ? running.build.number + 1 : shape.kind === "max" ? PACE_AGENTS_MAX : shape.count;
+    const number4 = shape.kind === "faster" ? running.build.number + 1 : shape.kind === "slower" ? Math.max(1, running.build.number - 1) : shape.kind === "max" ? PACE_AGENTS_MAX : shape.count;
     if (!Number.isInteger(number4) || number4 < 1 || number4 > PACE_AGENTS_MAX)
       return say(paceAgentsRangeText());
     const before = running !== null ? running.build.number : project.number ?? CAREFUL_START_AGENTS;

package/dist/banner-facts.d.ts

@@ -80,11 +80,28 @@ export interface FactProbes {
     readonly projectName: (dir: string) => string | undefined;
     readonly commitCount: (dir: string) => number | null;
     readonly installedVersion: (dir: string) => string | undefined;
-    /** Which Halfcycle this run talks to, as an address a person recognises. */
-    readonly websiteHost: (env: NodeJS.ProcessEnv) => string | undefined;
+    /** Which Halfcycle this project talks to, as an address a person recognises. */
+    readonly websiteHost: (env: NodeJS.ProcessEnv, dir: string) => string | undefined;
 }
 /** The real probes. Each one is separately replaceable, which is the point of the seam. */
 export declare const REAL_PROBES: FactProbes;
+/**
+ * WHICH HALFCYCLE THIS PROJECT TALKS TO, as the banner shows it (walk-11-client-fixes AC3).
+ *
+ * Three sources, in order: `HALFCYCLE_SERVICE_URL` when it is set; else the service the
+ * machine-level store of the engagement the project's pin names holds, which is how a
+ * project installed against staging says so with nothing exported; else the published
+ * service. The second is the same source the CLI's console links already read
+ * (`projectPageUrl`), so the banner and those links cannot name two services.
+ *
+ * Each read is its own `try`: a pin that is not JSON, an engagement id that cannot be a
+ * path, or a store that cannot be read falls through to the next source rather than
+ * dropping the row. The published origin shows as the brand's address whichever source
+ * named it; any other origin shows its host, because there the host is the diagnostic.
+ *
+ * @param home the home folder the store is under; the user's own when absent.
+ */
+export declare function serviceHost(env: NodeJS.ProcessEnv, projectDir: string, home?: string): string;
 /**
  * The opening block's content for a run against `projectDir`.
  *

package/dist/banner-facts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"banner-facts.d.ts","sourceRoot":"","sources":["../src/banner-facts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAIjD,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAkB,KAAK,aAAa,EAAmB,MAAM,aAAa,CAAC;AAElF;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,MAAM,EAGpC,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAI3C,CAAC;AAEF;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,sBAA2B,GAAG,MAAM,GAAG,SAAS,CAEvF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,qBAA0B,GAAG,MAAM,GAAG,SAAS,CAEjF;AAED;0CAC0C;AAC1C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACrD,gFAAgF;IAChF,QAAQ,CAAC,YAAY,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACrD,QAAQ,CAAC,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/D,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,KAAK,MAAM,GAAG,SAAS,CAAC;CACtE;AAED,2FAA2F;AAC3F,eAAO,MAAM,WAAW,EAAE,UAsCzB,CAAC;AAQF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,MAAM,GAAE,UAAwB,GAC/B,aAAa,CAyCf"}
+{"version":3,"file":"banner-facts.d.ts","sourceRoot":"","sources":["../src/banner-facts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKjD,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAkB,KAAK,aAAa,EAAmB,MAAM,aAAa,CAAC;AAElF;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,iBAAiB,CAAC;AAExC;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,SAAS,MAAM,EAGpC,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAI3C,CAAC;AAEF;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,sBAA2B,GAAG,MAAM,GAAG,SAAS,CAEvF;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,qBAA0B,GAAG,MAAM,GAAG,SAAS,CAEjF;AAED;0CAC0C;AAC1C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACrD,gFAAgF;IAChF,QAAQ,CAAC,YAAY,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACrD,QAAQ,CAAC,gBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC/D,gFAAgF;IAChF,QAAQ,CAAC,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACnF;AAED,2FAA2F;AAC3F,eAAO,MAAM,WAAW,EAAE,UAgCzB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAU7F;AA2BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,MAAM,CAAC,UAAwB,EACpC,MAAM,GAAE,UAAwB,GAC/B,aAAa,CAyCf"}

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,EAkBL,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;AA6WD;;;;;;;;;;;;;;;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;AAiYD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAgFvE"}