halfcycle 0.5.3 → 0.6.0

package/dist/index.d.ts

@@ -20,4 +20,5 @@ export { runBootstrapScan, scanLayers, mergeWithRecords, HALFCYCLE_STATE_FORMAT
 export type { HalfcycleStateFile, ScannedLayerEntry, ScannedLayerValue } from './scan.js';
 export * from './setup/index.js';
 export * from './build-record/index.js';
+export { readyRowsFromFiles } from './ready.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACrG,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAyBhE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnG,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAI1F,cAAc,kBAAkB,CAAC;AAKjC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACrG,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAyBhE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnG,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAI1F,cAAc,kBAAkB,CAAC;AAKjC,cAAc,yBAAyB,CAAC;AAKxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -298,9 +298,13 @@ var HOOK_REMEDY = `Run ${SIGN_IN_COMMAND} in the project folder to sign in.`;
 
 // ../core/dist/task-plan.js
 import { z as z2 } from "zod";
+var TASK_PLAN_FILE = "docs/build-records/task-plan.json";
+var TASK_LIST_FILE = "docs/build-records/build-tasks.json";
 var TASK_PLAN_TASKS_MAX = 500;
 var TASK_PLAN_ID_MAX = 64;
 var TASK_PLAN_BUILDS_NONE = "none";
+var TASK_PLAN_CRITERIA_NONE = "none";
+var TASK_PLAN_SPECS_NONE = "none";
 var TASK_PLAN_KINDS = ["build", "review", "spec", "walk", "check"];
 var CONTROL_CHARACTER = /[\u0000-\u001f\u007f-\u009f]/;
 var planText = z2.string().refine((text) => !CONTROL_CHARACTER.test(text), { message: "holds a control character" });
@@ -317,7 +321,9 @@ var taskPlanTaskSchema = z2.object({
   }).strict().optional(),
   wholeProject: z2.literal(true).optional(),
   ships: z2.enum(["deploy", "release"]).optional(),
-  builds: z2.union([z2.literal(TASK_PLAN_BUILDS_NONE), z2.array(planText)]).optional()
+  builds: z2.union([z2.literal(TASK_PLAN_BUILDS_NONE), z2.array(planText)]).optional(),
+  criteria: z2.union([z2.literal(TASK_PLAN_CRITERIA_NONE), z2.array(planText)]).optional(),
+  whyOutsidePlan: planText.optional()
 }).strict().superRefine((task, ctx) => {
   if (task.reviews !== void 0 && task.kind !== "review") {
     ctx.addIssue({
@@ -343,6 +349,7 @@ var taskPlanTaskSchema = z2.object({
 });
 var taskPlanSchema = z2.object({
   phase: z2.string().min(1).refine((text) => !CONTROL_CHARACTER.test(text), { message: "holds a control character" }),
+  specs: z2.union([z2.literal(TASK_PLAN_SPECS_NONE), z2.array(planText)]).optional(),
   tasks: z2.array(taskPlanTaskSchema).max(TASK_PLAN_TASKS_MAX)
 }).strict();
 var taskListRowSchema = z2.object({
@@ -451,6 +458,37 @@ var AGENT_PROFILES = {
 };
 var ALL_HOOK_COMMANDS = new Set(AGENT_IDS.flatMap((id) => [...AGENT_PROFILES[id].commands]));
 
+// ../core/dist/worker-report.js
+var WORKER_REPORT_STATUSES = Object.freeze([
+  "done",
+  "needs-human-verification",
+  "blocked-on-human",
+  "failed"
+]);
+var WORKER_REPORT_RULE_FIELDS = Object.freeze({
+  W1: "Worker report",
+  W2: "Status",
+  W3: "Head",
+  W4: "Head",
+  W5: "Verification",
+  W6: "Verification",
+  W7: "Verification",
+  W8: "Unverified"
+});
+var WORKER_REPORT_LINES = Object.freeze({
+  noBlock: () => 'There is no "## Worker report" block in this report.',
+  statusMissing: (statuses) => `The report has no Status line. Use one of: ${statuses.join(", ")}.`,
+  statusUnknown: (found, statuses) => `The report's Status is "${found}". Use one of: ${statuses.join(", ")}.`,
+  headMissing: () => "The report has no Head line. Give the full commit id the report is about.",
+  headMalformed: (found) => `The report's Head is "${found}", which is not a full commit id.`,
+  headDiffers: (found, head) => `The report is about commit ${found}, but the work's head is ${head}. Ask for a report on the current head.`,
+  noVerification: () => "The report does not say what was run. List each check under Verification with its exit code.",
+  noExitCode: (entry) => `"${entry}" under Verification does not give an exit code.`,
+  nonZeroOnDone: (entry) => `"${entry}" exited with a code other than 0, so the work is not done.`,
+  noUnverified: () => 'The report has no Unverified line. Say what was not checked, or "nothing".',
+  clear: () => "The report is complete and names the commit it is about."
+});
+
 // ../events/dist/result.js
 import { z as z3 } from "zod";
 var firedGuardSchema = z3.object({
@@ -5350,12 +5388,12 @@ function findNotShared(targetRepo, manifest, collidedPaths) {
   if (ignored === null)
     return null;
   const sorted = [...ignored].sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
-  const named = sorted.find((entry) => entry.path === SETTINGS_REL) ?? sorted[0];
+  const named2 = sorted.find((entry) => entry.path === SETTINGS_REL) ?? sorted[0];
   return {
-    path: named.path,
-    pattern: named.pattern,
-    source: named.source,
-    line: named.line,
+    path: named2.path,
+    pattern: named2.pattern,
+    source: named2.source,
+    line: named2.line,
     others: sorted.length - 1
   };
 }
@@ -8106,10 +8144,10 @@ function leftForYouLines(left, p) {
   return lines;
 }
 function shownBy(steps) {
-  const named = steps.filter((s) => s.name !== void 0).length;
-  if (named === 0)
+  const named2 = steps.filter((s) => s.name !== void 0).length;
+  if (named2 === 0)
     return "Each is shown by the method's own label for it:";
-  if (named === steps.length)
+  if (named2 === steps.length)
     return "Each is shown by the method's own name for it:";
   return "Each is shown by the method's own name for it, or by its label where the record holds no name:";
 }
@@ -8652,6 +8690,64 @@ async function obtainBuildRecord(credential, repoRoot, phase, io = NODE_RECORD_P
 function refetchCommand(phase) {
   return `${HALFCYCLE_COMMAND} build-record ${quoteForShell(phase)}`;
 }
+
+// dist/check-tasks.js
+var CHECK_TASKS_USAGE = `${HALFCYCLE_COMMAND} check-tasks <phase> [--with-task-list] [--repo <root>]`;
+var MISSING_PLAN_LINE = `there is no ${TASK_PLAN_FILE} in this project yet. Run the task-graph step to write it, then run this again.`;
+var SPEC_FOLDER = LAYER_ARTEFACT_PATHS.l4[0];
+
+// dist/ready.js
+var READY_USAGE = `${HALFCYCLE_COMMAND} ready <phase> [--cap <n>] [--repo <root>]`;
+var STATES_TEXT = buildTaskStateSchema.options.join(", ");
+var READY_LINES = {
+  start: (id, title) => `Ready to start: ${named(id, title)}`,
+  pastCap: (id, title) => `Ready, but past the number allowed now: ${named(id, title)}`,
+  person: (id, title) => `Waiting on a person: ${named(id, title)}`,
+  noCap: () => "No number was given, so every task that can start is listed.",
+  nothing: () => "Nothing can start now.",
+  noTaskList: () => `There is no task list at ${TASK_LIST_FILE}, so which tasks are done is not known. Write the task list for this phase, then run this again.`,
+  otherPhase: (phase) => `The task list in ${TASK_LIST_FILE} is not for "${phase}", so which tasks are done is not known. Write the task list for this phase, then run this again.`,
+  noState: (id) => `"${id}" in ${TASK_LIST_FILE} does not give its state as one of: ${STATES_TEXT}.`
+};
+function named(id, title) {
+  return title === void 0 ? id : `${id}, ${title}`;
+}
+var PROGRESS = {
+  pending: "pending",
+  completed: "completed",
+  "in-flight": "other",
+  failed: "other",
+  blocked: "other"
+};
+function readyRowsFromFiles(plan, taskList) {
+  const listed = /* @__PURE__ */ new Map();
+  for (const entry of taskList.tasks) {
+    if (!listed.has(entry.id))
+      listed.set(entry.id, entry);
+  }
+  const rows = [];
+  const lines = [];
+  plan.tasks.forEach((task, place) => {
+    const entry = listed.get(task.id);
+    const state = buildTaskStateSchema.safeParse(entry?.state);
+    if (entry === void 0 || !state.success) {
+      lines.push(READY_LINES.noState(task.id));
+      return;
+    }
+    const title = typeof entry.title === "string" && entry.title !== "" ? entry.title : void 0;
+    const minutes = typeof entry.budgetMinutes === "number" ? entry.budgetMinutes : void 0;
+    rows.push({
+      id: task.id,
+      dependsOn: task.dependsOn,
+      progress: PROGRESS[state.data],
+      person: task.heldBy === "person" || entry.agent === HUMAN_AGENT,
+      ...minutes === void 0 ? {} : { minutes },
+      tieRank: place,
+      title
+    });
+  });
+  return lines.length > 0 ? { ok: false, lines } : { ok: true, rows };
+}
 export {
   BUILD_RECORD_DIR,
   CreateEngagementRefused,
@@ -8687,6 +8783,7 @@ export {
   readBundlePin,
   readRemote,
   readRootCommit,
+  readyRowsFromFiles,
   refetchCommand,
   renderAnchor,
   renderBuildRecordV2Markdown,