halfcycle 0.12.0-rc.6 → 0.12.0

package/.claude-plugin/plugin.json

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

@@ -17367,7 +17367,8 @@ var timeSummarySchema = external_exports.object({
     totals: timeTotalsSchema,
     usage: timeUsageTotalsSchema
   }).strict(),
-  share: timeSummaryShareSchema.optional()
+  share: timeSummaryShareSchema.optional(),
+  workMinutes: timeCountSchema.nullable().optional()
 }).strict().superRefine((v, ctx) => {
   if (v.closed !== (v.closedAt !== null)) {
     ctx.addIssue({ code: "custom", path: ["closedAt"], message: "must be set exactly when the phase is closed" });
@@ -17482,6 +17483,7 @@ var METHOD_FILE_PATTERNS = [
   "CLAUDE.md",
   "AGENTS.md",
   ".claude/context",
+  "docs/context",
   ".claude/commands",
   ".claude/hooks",
   ".claude/settings.json",
@@ -17541,7 +17543,7 @@ var PROJECT_RECORD_PATTERNS = [
   { pattern: "docs/build-records/task-plan.json", name: () => "the build's plan (task-plan.json)", shrinkAsked: false },
   { pattern: "docs/build-records", name: (file2) => `a closed phase's Build Record (${file2})` },
   {
-    pattern: ".claude/context/tasks/*",
+    pattern: "docs/context/tasks/*",
     name: (file2) => `a task's notes for this phase (${file2})`,
     shrinkAsked: false,
     deleteAsked: false
@@ -20780,6 +20782,7 @@ function pathsDifferingFromHead(repoRoot, timeoutMs = PROVE_GIT_TIMEOUT_MS) {
     return result;
   return parseStatusPathsZ(result.value);
 }
+var GENERATED_CACHE = /(^|\/)(__pycache__|\.pytest_cache|\.mypy_cache|\.ruff_cache|node_modules)\/|\.py[co]$/;
 function parseStatusPathsZ(output) {
   if (output === "")
     return { ok: true, value: [] };
@@ -20790,7 +20793,10 @@ function parseStatusPathsZ(output) {
     if (record2.length < 4 || record2.charAt(2) !== " " || /[RC]/.test(record2.slice(0, 2))) {
       return { ok: false, message: "git gave an unreadable list of changed files" };
     }
-    paths.add(record2.slice(3));
+    const path = record2.slice(3);
+    if (record2.startsWith("??") && GENERATED_CACHE.test(path))
+      continue;
+    paths.add(path);
   }
   return { ok: true, value: [...paths] };
 }

package/bin/pre-tool-use-filter.sh

@@ -369,6 +369,7 @@ halfcycle_pt_records() {
   halfcycle_pt_holds 'build-tasks.json' $'b?(\x01)u?(\x01)i?(\x01)l?(\x01)d?(\x01)-?(\x01)t?(\x01)a?(\x01)s?(\x01)k?(\x01)s?(\x01).?(\x01)j?(\x01)s?(\x01)o?(\x01)n' && return 1
   halfcycle_pt_holds 'task-plan.json' $'t?(\x01)a?(\x01)s?(\x01)k?(\x01)-?(\x01)p?(\x01)l?(\x01)a?(\x01)n?(\x01).?(\x01)j?(\x01)s?(\x01)o?(\x01)n' && return 1
   halfcycle_pt_holds 'build-records' $'b?(\x01)u?(\x01)i?(\x01)l?(\x01)d?(\x01)-?(\x01)r?(\x01)e?(\x01)c?(\x01)o?(\x01)r?(\x01)d?(\x01)s' && return 1
+  halfcycle_pt_holds 'context' $'c?(\x01)o?(\x01)n?(\x01)t?(\x01)e?(\x01)x?(\x01)t' && return 1
   halfcycle_pt_holds '.claude' $'.?(\x01)c?(\x01)l?(\x01)a?(\x01)u?(\x01)d?(\x01)e' && return 1
   return 0
 }

package/dist/check-tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-tasks.d.ts","sourceRoot":"","sources":["../src/check-tasks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"check-tasks.d.ts","sourceRoot":"","sources":["../src/check-tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2FG;AAIH,OAAO,EAWL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAWL,KAAK,mBAAmB,EAExB,KAAK,aAAa,EAElB,KAAK,QAAQ,EACb,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAI1E,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAA2E,CAAC;AAE1G;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAChF;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AAElB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,CAuB3E;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,iIAAiH,CAAC;AAEhJ;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAGrE;AAED,qHAAqH;AACrH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAOzG,qGAAqG;AACrG,KAAK,SAAS,CAAC,CAAC,IACZ;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,MAAM,EAAE,SAAS;YAAE,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC;AAExG;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CA0BjH;AAwCD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,iBAAiB,GAC7B,iBAAiB,GAAG,SAAS,CA6B/B;AAQD;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzG;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,iBAAiB,CAkBrF;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAA6B,GACjC,QAAQ,CAAC,kBAAkB,CAAC,CAU9B;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,kBAAkB,CASvF;AAED,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,aAAa,CAuDnH;AAiBD,sEAAsE;AACtE,eAAO,MAAM,qBAAqB,uEAAuE,CAAC;AAE1G,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,kFAAkF;AAClF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,cAAc,CAAC;IAC/D,QAAQ,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,iIAAiI;AACjI,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAElF,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA8BhG;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,OAAO,EACrB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,aAAa,CAAC,CAKxB"}

package/dist/cli.js

@@ -4028,7 +4028,8 @@ var timeSummarySchema = z11.object({
     totals: timeTotalsSchema,
     usage: timeUsageTotalsSchema
   }).strict(),
-  share: timeSummaryShareSchema.optional()
+  share: timeSummaryShareSchema.optional(),
+  workMinutes: timeCountSchema.nullable().optional()
 }).strict().superRefine((v, ctx) => {
   if (v.closed !== (v.closedAt !== null)) {
     ctx.addIssue({ code: "custom", path: ["closedAt"], message: "must be set exactly when the phase is closed" });
@@ -6675,7 +6676,7 @@ function aboutShareOf(percent) {
 }
 var PLAN_USAGE_CAVEAT = "These figures are estimates. Many things affect usage, and some of them are outside Halfcycle's control.";
 var SMALL_PROJECT_WORK_START = "A small project like this is usually about ";
-var SMALL_PROJECT_WORK_NOTE = "When your plan is written, this phase gets its own figure, counted from the time each task in it is given.";
+var SMALL_PROJECT_WORK_NOTE = "Once your build plan is written, its own figure replaces this one: the time it sets for each task, added up.";
 function sizeAnswerPrintedLinesOf(usage5) {
   const out = [];
   for (const line of usage5) {
@@ -7719,11 +7720,11 @@ function expectedActualLineOf(expected, actual) {
   const took = `The phase took ${timeDurationLabelOf(actual.seconds)} and ${tokenCountWordsOf(actual.tokens)} tokens.`;
   if (expected.minutes === null)
     return `Expected about ${tokenCountWordsOf(expected.tokens)} tokens. ${took}`;
-  return `Expected ${timeDurationLabelOf(expected.minutes * 60)} and about ${tokenCountWordsOf(expected.tokens)} tokens. ${took}`;
+  return `The plan expected about ${timeDurationLabelOf(expected.minutes * 60)} of agent work and about ${tokenCountWordsOf(expected.tokens)} tokens. ${took}`;
 }
 function expectedActualTimeLineOf(expectedMinutes, elapsedSeconds) {
   const took = `The phase took ${timeDurationLabelOf(elapsedSeconds)}.`;
-  return expectedMinutes === null ? took : `Expected ${timeDurationLabelOf(expectedMinutes * 60)}. ${took}`;
+  return expectedMinutes === null ? took : `The plan expected about ${timeDurationLabelOf(expectedMinutes * 60)} of agent work. ${took}`;
 }
 function joinedOf(names) {
   if (names.length <= 1)
@@ -13164,9 +13165,13 @@ function repositoryNameFromRemote(remote) {
   const name = segment.replace(/\.git$/i, "").trim();
   return name.length > 0 ? name : void 0;
 }
+function isLocalRemote(remote) {
+  const r = remote.trim();
+  return /^(\/|\.{1,2}[\\/]|~|file:|[A-Za-z]:[\\/]|\\\\)/.test(r);
+}
 function deriveProjectName(targetRepoRoot) {
   const remote = readRemote(targetRepoRoot);
-  const fromRemote = remote ? repositoryNameFromRemote(remote) : void 0;
+  const fromRemote = remote && !isLocalRemote(remote) ? repositoryNameFromRemote(remote) : void 0;
   const candidate = fromRemote ?? basename(resolve2(targetRepoRoot));
   const name = candidate.trim();
   if (EMPTY_SEGMENTS.has(name))
@@ -17807,7 +17812,7 @@ function assertNever3(value) {
   throw new Error(`unexpected answer: ${JSON.stringify(value)}`);
 }
 function readTimeTotalsUrl(credential, phase) {
-  return `${credential.serviceUrl}/engagements/${encodeURIComponent(credential.engagementId)}/phases/${encodeURIComponent(phase)}/time?with=share`;
+  return `${credential.serviceUrl}/engagements/${encodeURIComponent(credential.engagementId)}/phases/${encodeURIComponent(phase)}/time?with=share&work=true`;
 }
 async function readCloseTimeSummary(credential, phase) {
   let res;
@@ -18002,15 +18007,19 @@ function readPhaseModels(engagementId, phase, openedAt, home) {
 function usageTokensOf(usage5) {
   return usage5.inputTokens + usage5.outputTokens + usage5.cacheWriteTokens + usage5.cacheReadTokens;
 }
+function planWorkMinutesOf(summary) {
+  return summary.workMinutes ?? null;
+}
 function tierFigureLines(work, expected, summary, models, details = false) {
   const lines = [];
   const figures = work === null ? null : tierFiguresOf(work);
   if (figures !== null)
     lines.push(tierCountsLineOf(figures));
-  if (expected === null)
+  const planMinutes = summary === null ? null : planWorkMinutesOf(summary);
+  if (expected === null && planMinutes === null)
     lines.push(NO_EXPECTED_LINE);
   else if (summary !== null) {
-    lines.push(details ? expectedActualLineOf(expected, { seconds: summary.elapsedSeconds, tokens: usageTokensOf(summary.usage) }) : expectedActualTimeLineOf(expected.minutes, summary.elapsedSeconds));
+    lines.push(details && expected !== null ? expectedActualLineOf({ tokens: expected.tokens, minutes: planMinutes }, { seconds: summary.elapsedSeconds, tokens: usageTokensOf(summary.usage) }) : expectedActualTimeLineOf(planMinutes, summary.elapsedSeconds));
   }
   if (figures !== null && models !== null) {
     for (const task of figures.hadCheaperAttempt) {
@@ -18743,8 +18752,18 @@ function readPlanSpecFiles(repoRoot, plan) {
   return { kind: "ok", specFiles: { folder: SPEC_FOLDER, entries } };
 }
 function readCriteriaRecordFile(repoRoot, rel = CRITERIA_RECORD_FILE) {
-  return readJsonFile(repoRoot, rel, (raw) => workCriteriaRecordSchema.safeParse(raw));
+  return readJsonFile(repoRoot, rel, (raw) => {
+    const parsed = workCriteriaRecordSchema.safeParse(raw);
+    if (parsed.success)
+      return parsed;
+    const first = parsed.error.issues[0];
+    if (first !== void 0 && (first.path[0] === "record" || first.path[0] === "subject")) {
+      return { success: false, error: { issues: [{ path: [], message: CRITERIA_RECORD_START }] } };
+    }
+    return parsed;
+  });
 }
+var CRITERIA_RECORD_START = 'does not start the way a criteria record does. Begin it with "record": "criteria" and "subject": {"kind": "phase", "phase": "<the phase>"}, then "check" (the check task), "by" (who holds it) and "rows"';
 function readCriteriaRecord(repoRoot, plan) {
   const read = readCriteriaRecordFile(repoRoot);
   if (read.kind === "missing")
@@ -20292,7 +20311,7 @@ function openingBannerContent(projectDir, env = process.env, probes = REAL_PROBE
     facts,
     tag: TAGLINE,
     tagNarrow: TAGLINE_NARROW,
-    url: BRAND_URL,
+    url: probes.websiteHost(env) ?? BRAND_URL,
     // `''` when even this package's own manifest could not be read. The one-line cut
     // drops the whole `vX.Y.Z` clause in that case rather than printing a bare `v`.
     version: version ?? ""