halfcycle 0.5.2 → 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({
@@ -3160,16 +3198,43 @@ var ownerWaitDeclarationSchema = z23.object({
 var ownerWaitDeclarationsSchema = z23.object({ declarations: z23.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/autonomy.js
+// ../events/dist/owner-wait-answer.js
 import { z as z24 } from "zod";
+var ownerWaitShortIdSchema = z24.string().regex(/^[0-9a-f]{8}$/);
+var OWNER_WAIT_ANSWER_ACTS = ["approve", "decline"];
+var ownerWaitAnswerActSchema = z24.enum(OWNER_WAIT_ANSWER_ACTS);
+var ownerWaitChatRequestSchema = z24.discriminatedUnion("act", [
+  z24.object({ act: z24.literal("approve"), wait: ownerWaitShortIdSchema }).strict(),
+  z24.object({ act: z24.literal("decline"), wait: ownerWaitShortIdSchema, note: scopeNoteWireSchema }).strict()
+]);
+function bareOutcome(outcome) {
+  return z24.object({ outcome: z24.literal(outcome) }).strict();
+}
+var ownerWaitChatResultSchema = z24.discriminatedUnion("outcome", [
+  z24.object({
+    outcome: z24.literal("recorded"),
+    act: ownerWaitAnswerActSchema,
+    question: z24.string().min(1)
+  }).strict(),
+  z24.object({ outcome: z24.literal("refused"), problems: z24.array(systemDescriptionProblemSchema).min(1) }).strict(),
+  bareOutcome("not-owner"),
+  bareOutcome("no-owner"),
+  bareOutcome("not-found"),
+  bareOutcome("ambiguous"),
+  bareOutcome("not-offered"),
+  bareOutcome("unavailable")
+]);
+
+// ../events/dist/autonomy.js
+import { z as z25 } from "zod";
 var AUTONOMY_CHANGED_IN = ["console", "chat"];
-var autonomyChangedInSchema = z24.enum(AUTONOMY_CHANGED_IN);
-var autonomySettingsSchema = z24.object({
-  on: z24.boolean(),
+var autonomyChangedInSchema = z25.enum(AUTONOMY_CHANGED_IN);
+var autonomySettingsSchema = z25.object({
+  on: z25.boolean(),
   // whether builds run on their own
-  mayPublish: z24.boolean(),
+  mayPublish: z25.boolean(),
   // whether builds may publish or release without waiting
-  maySpend: z24.boolean(),
+  maySpend: z25.boolean(),
   // whether builds may spend money or sign up without waiting
   changedAt: utcIso8601.nullable(),
   // when the setting last changed; null if never
@@ -3179,37 +3244,37 @@ var autonomySettingsSchema = z24.object({
   message: "says when and where it changed, or neither",
   path: ["changedIn"]
 });
-var autonomyChangeRequestSchema = z24.object({
-  on: z24.boolean(),
+var autonomyChangeRequestSchema = z25.object({
+  on: z25.boolean(),
   // the switch
-  mayPublish: z24.boolean(),
+  mayPublish: z25.boolean(),
   // the publish box
-  maySpend: z24.boolean()
+  maySpend: z25.boolean()
   // the spend box
 }).strict();
 var AUTONOMY_CHAT_ACTS = ["on", "off"];
-var autonomyChatActSchema = z24.enum(AUTONOMY_CHAT_ACTS);
-var autonomyChatRequestSchema = z24.object({
+var autonomyChatActSchema = z25.enum(AUTONOMY_CHAT_ACTS);
+var autonomyChatRequestSchema = z25.object({
   act: autonomyChatActSchema
   // what the owner typed
 }).strict();
-var autonomyChatResultSchema = z24.discriminatedUnion("outcome", [
-  z24.object({
-    outcome: z24.literal("recorded"),
-    on: z24.boolean()
+var autonomyChatResultSchema = z25.discriminatedUnion("outcome", [
+  z25.object({
+    outcome: z25.literal("recorded"),
+    on: z25.boolean()
     // whether builds now run on their own
   }).strict(),
-  z24.object({ outcome: z24.literal("not-owner") }).strict(),
-  z24.object({ outcome: z24.literal("no-owner") }).strict(),
-  z24.object({ outcome: z24.literal("not-offered") }).strict(),
-  z24.object({ outcome: z24.literal("unavailable") }).strict()
+  z25.object({ outcome: z25.literal("not-owner") }).strict(),
+  z25.object({ outcome: z25.literal("no-owner") }).strict(),
+  z25.object({ outcome: z25.literal("not-offered") }).strict(),
+  z25.object({ outcome: z25.literal("unavailable") }).strict()
 ]);
-var autonomyStateSchema = z24.object({
-  on: z24.boolean(),
+var autonomyStateSchema = z25.object({
+  on: z25.boolean(),
   // whether builds run on their own
-  mayPublish: z24.boolean(),
+  mayPublish: z25.boolean(),
   // whether builds may publish or release without waiting
-  maySpend: z24.boolean()
+  maySpend: z25.boolean()
   // whether builds may spend money or sign up without waiting
 }).strict();
 var autonomyStateFileSchema = autonomyStateSchema.extend({
@@ -3218,8 +3283,8 @@ var autonomyStateFileSchema = autonomyStateSchema.extend({
 }).strict();
 var AUTONOMY_STATE_FILE_MAX_AGE_MS = 24 * 60 * 60 * 1e3;
 var AUTONOMY_ACTIVITY_KINDS = ["went-ahead", "waiting", "approved", "closed", "waiting-on-owner"];
-var autonomyActivityKindSchema = z24.enum(AUTONOMY_ACTIVITY_KINDS);
-var autonomyActivityRowSchema = z24.object({
+var autonomyActivityKindSchema = z25.enum(AUTONOMY_ACTIVITY_KINDS);
+var autonomyActivityRowSchema = z25.object({
   kind: autonomyActivityKindSchema,
   // what happened
   phase: scopePhaseSchema,
@@ -3232,6 +3297,8 @@ var autonomyActivityRowSchema = z24.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) => {
@@ -3258,6 +3325,9 @@ var autonomyActivityRowSchema = z24.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"] });
   }
@@ -3265,11 +3335,11 @@ var autonomyActivityRowSchema = z24.object({
     ctx.addIssue({ code: "custom", message: "says how to undo it exactly when it can be undone", path: ["how"] });
   }
 });
-var autonomyActivitySchema = z24.object({
-  rows: z24.array(autonomyActivityRowSchema)
+var autonomyActivitySchema = z25.object({
+  rows: z25.array(autonomyActivityRowSchema)
   // newest first
 }).strict();
-var savedIdSchema = z24.string().min(1).max(64).regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "must be lower-case letters, digits and single hyphens");
+var savedIdSchema = z25.string().min(1).max(64).regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "must be lower-case letters, digits and single hyphens");
 var SAVED_REF_PREFIX = "refs/halfcycle/saved/";
 function savedRefOf(id) {
   return `${SAVED_REF_PREFIX}${id}`;
@@ -3290,33 +3360,33 @@ function isGitFolderSegment(segment) {
   return t === ".git" || /^git~\d+$/.test(t);
 }
 var SAVED_PATH_KEPT_IN = ["commit", "copy"];
-var savedPathSchema = z24.object({
-  path: z24.string().max(4096).refine(isProjectRelativePath, { message: "must be a path inside the project" }),
+var savedPathSchema = z25.object({
+  path: z25.string().max(4096).refine(isProjectRelativePath, { message: "must be a path inside the project" }),
   // the file, relative to the project
-  keptIn: z24.enum(SAVED_PATH_KEPT_IN)
+  keptIn: z25.enum(SAVED_PATH_KEPT_IN)
   // in the save's commit, or copied beside this file
 }).strict();
-var savedCommitSchema = z24.string().regex(/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/, "must be a full commit hash");
-var savedBranchSchema = z24.object({
-  name: z24.string().min(1).max(255).refine((n) => !hasControlCharacter(n) && !n.startsWith("-") && !n.includes("..") && n !== "HEAD", {
+var savedCommitSchema = z25.string().regex(/^(?:[0-9a-f]{40}|[0-9a-f]{64})$/, "must be a full commit hash");
+var savedBranchSchema = z25.object({
+  name: z25.string().min(1).max(255).refine((n) => !hasControlCharacter(n) && !n.startsWith("-") && !n.includes("..") && n !== "HEAD", {
     message: "must be a branch name"
   }),
   // the branch's name
   commit: savedCommitSchema
   // the commit it pointed at
 }).strict();
-var savedSchema = z24.object({
+var savedSchema = z25.object({
   id: savedIdSchema,
   // what restore is typed with
   savedAt: utcIso8601,
   // when the copy was made
-  ref: z24.string().min(1),
+  ref: z25.string().min(1),
   // where the saved commit is kept
-  what: z24.string().min(1).max(2e3),
+  what: z25.string().min(1).max(2e3),
   // what the action would have changed, in words
-  paths: z24.array(savedPathSchema),
+  paths: z25.array(savedPathSchema),
   // every saved file
-  branches: z24.array(savedBranchSchema)
+  branches: z25.array(savedBranchSchema)
   // every saved line of work
 }).strict().refine((s) => s.ref === savedRefOf(s.id), { message: "must be the ref of this save", path: ["ref"] });
 function autonomyC8(agent, question, chose) {
@@ -5318,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
   };
 }
@@ -8074,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:";
 }
@@ -8620,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,
@@ -8655,6 +8783,7 @@ export {
   readBundlePin,
   readRemote,
   readRootCommit,
+  readyRowsFromFiles,
   refetchCommand,
   renderAnchor,
   renderBuildRecordV2Markdown,