runcastle 1.0.26 → 1.0.27

package/bin/runcastle.js

@@ -272,6 +272,7 @@ var init_schemas = __esm(() => {
     featureId: z2.string(),
     seq: z2.number(),
     status: TicketStatus,
+    lap: z2.number(),
     commits: z2.array(z2.string()),
     error: z2.string().optional(),
     attemptBranch: z2.string().optional(),
@@ -349,6 +350,7 @@ var init_schemas = __esm(() => {
     title: z2.string(),
     oneLiner: z2.string(),
     mapped: z2.boolean(),
+    lap: z2.number(),
     phase: Phase,
     branch: z2.string(),
     baseBranch: z2.string().optional(),
@@ -485,7 +487,7 @@ function nextGate(feature) {
     return MAPPED_G1;
   return gate;
 }
-var PIPELINE, ORDER, REVIEW_LOOP_BACK, MAPPED_G1;
+var PIPELINE, ORDER, REVIEW_LOOP_BACK, RETHINK_LOOP_BACK, MAPPED_G1;
 var init_pipeline = __esm(() => {
   PIPELINE = [
     { phase: "ideation" },
@@ -532,6 +534,7 @@ var init_pipeline = __esm(() => {
   ];
   ORDER = PIPELINE.map((p) => p.phase);
   REVIEW_LOOP_BACK = { from: "review", to: "implementation" };
+  RETHINK_LOOP_BACK = { from: "review", to: "ideation" };
   MAPPED_G1 = {
     id: "G1",
     description: "Every waypoint resolved or dropped before converging",
@@ -584,6 +587,7 @@ var init_db_schema = __esm(() => {
     title: text("title").notNull(),
     oneLiner: text("one_liner").notNull(),
     mapped: integer("mapped", { mode: "boolean" }).notNull().default(false),
+    lap: integer("lap").notNull().default(1),
     phase: text("phase").notNull().$type(),
     branch: text("branch").notNull(),
     baseBranch: text("base_branch"),
@@ -594,6 +598,7 @@ var init_db_schema = __esm(() => {
     id: text("id").primaryKey(),
     featureId: text("feature_id"),
     projectId: text("project_id"),
+    lap: integer("lap").notNull().default(1),
     kind: text("kind").notNull().$type(),
     ccSessionId: text("cc_session_id"),
     transcriptPath: text("transcript_path"),
@@ -610,6 +615,7 @@ var init_db_schema = __esm(() => {
     acceptanceCriteria: text("acceptance_criteria", { mode: "json" }).notNull().$type(),
     seams: text("seams", { mode: "json" }).notNull().$type(),
     blockedBy: text("blocked_by", { mode: "json" }).notNull().$type(),
+    lap: integer("lap").notNull().default(1),
     status: text("status").notNull().$type(),
     commits: text("commits", { mode: "json" }).notNull().$type(),
     error: text("error"),
@@ -645,6 +651,7 @@ var init_db_schema = __esm(() => {
     featureId: text("feature_id"),
     runId: text("run_id"),
     ticketId: text("ticket_id"),
+    lap: integer("lap").notNull().default(1),
     ts: integer("ts").notNull(),
     type: text("type").notNull(),
     message: text("message").notNull(),
@@ -1383,6 +1390,10 @@ function projectIdForFeature(ctx, featureId) {
     throw new NotFoundError(`feature ${featureId} not found`);
   return row.projectId;
 }
+function lapForFeature(ctx, featureId) {
+  const row = ctx.db.select({ lap: features.lap }).from(features).where(eq(features.id, featureId)).get();
+  return row?.lap ?? 1;
+}
 function emit(ctx, featureId, e) {
   return insertEvent(ctx, projectIdForFeature(ctx, featureId), featureId, e);
 }
@@ -1400,6 +1411,7 @@ function insertEvent(ctx, projectId, featureId, e) {
   const row = ctx.db.insert(events).values({
     projectId,
     featureId,
+    lap: featureId ? lapForFeature(ctx, featureId) : 1,
     runId: e.runId ?? null,
     ticketId: e.ticketId ?? null,
     ts: Date.now(),
@@ -1440,6 +1452,7 @@ function rowToFeature(row) {
     title: row.title,
     oneLiner: row.oneLiner,
     mapped: row.mapped,
+    lap: row.lap,
     phase: row.phase,
     branch: row.branch,
     baseBranch: row.baseBranch ?? undefined,
@@ -1741,6 +1754,7 @@ function createSessionRow(ctx, input) {
     id: newId("sess"),
     featureId: input.featureId ?? null,
     projectId: input.projectId ?? null,
+    lap: input.featureId ? getFeatureRow(ctx, input.featureId).lap : 1,
     kind: input.kind,
     ccSessionId: null,
     transcriptPath: null,
@@ -1772,6 +1786,9 @@ function markSessionLive(ctx, id, input = {}) {
   }
   return getSessionRow(ctx, id);
 }
+function lapKickoff(lap) {
+  return `Proceed with your task: invoke the /runcastle:revisit skill for LAP ${lap} REVIEW ITERATION. ` + `Call get_feature_context, then read this feature's test-notes.md (the "## Lap ${lap - 1}" ` + 'section \u2014 what the last drive surfaced) and the "## Later laps" section of its spec.md. ' + "EITHER MAY NOT EXIST YET; that is normal, not an error \u2014 say so and carry on from what I " + "tell you. Interview me about what the test drive taught: what was wrong, what was missing, " + "what I want next. Write what we settle on into decisions.md and amend spec.md for this lap " + '(pruning anything you promote out of "## Later laps"), then call emit_tickets for this ' + `lap's work. Finish in THIS session: complete_phase through ideation \u2192 spec \u2192 tickets, then ` + "tell me to review the cards and click Burn.";
+}
 function kickoffLineFor(kind, override) {
   return override ?? KICKOFF_LINES[kind];
 }
@@ -4905,6 +4922,7 @@ function rowToTicket(row) {
     acceptanceCriteria: row.acceptanceCriteria,
     seams: row.seams,
     blockedBy: row.blockedBy,
+    lap: row.lap,
     status: row.status,
     commits: row.commits,
     error: row.error ?? undefined,
@@ -4927,6 +4945,7 @@ function listByFeature2(ctx, featureId) {
 function storeTickets(ctx, featureId, inputs) {
   if (inputs.length === 0)
     return [];
+  const { lap } = getFeatureRow(ctx, featureId);
   const existing = ctx.db.select({ seq: tickets.seq }).from(tickets).where(eq7(tickets.featureId, featureId)).all();
   const startSeq = existing.reduce((max, r) => Math.max(max, r.seq), 0) + 1;
   const resolved = resolveBlocking(inputs, startSeq);
@@ -4940,6 +4959,7 @@ function storeTickets(ctx, featureId, inputs) {
     acceptanceCriteria: t.acceptanceCriteria,
     seams: t.seams,
     blockedBy: resolved[i].blockedBy,
+    lap,
     status: "pending",
     commits: [],
     error: null,
@@ -5047,6 +5067,7 @@ var init_tickets = __esm(() => {
   init_schema();
   init_errors();
   init_events();
+  init_repo();
   MUTABLE_STATUSES = new Set(["pending", "failed"]);
 });
 
@@ -5070,7 +5091,7 @@ function checkGate(ctx, check, feature) {
     case "spec-file-exists":
       return fileGate(ctx, feature, "spec.md", "write the spec (spec.md) before breaking into tickets");
     case "tickets-approved": {
-      const count = listByFeature2(ctx, feature.id).filter((t) => t.status !== "cancelled").length;
+      const count = listByFeature2(ctx, feature.id).filter((t) => t.lap === feature.lap && t.status !== "cancelled").length;
       return count >= 1 ? { satisfied: true } : { satisfied: false, reason: "no tickets to burn" };
     }
     case "all-tickets-terminal": {
@@ -5605,6 +5626,7 @@ async function createFeature(ctx, input) {
     title: input.title,
     oneLiner: input.oneLiner,
     mapped: false,
+    lap: 1,
     phase: "ideation",
     branch,
     baseBranch,
@@ -5689,7 +5711,8 @@ async function burn(ctx, featureId, opts = {}) {
   const feature = getFeatureRow(ctx, featureId);
   const running = hasActiveRun(ctx, featureId);
   let tickets2 = listByFeature2(ctx, featureId);
-  const pending = tickets2.filter((t) => t.status !== "done" && t.status !== "failed" && t.status !== "cancelled");
+  const lapTickets = tickets2.filter((t) => t.lap === feature.lap);
+  const pending = lapTickets.filter((t) => t.status !== "done" && t.status !== "failed" && t.status !== "cancelled");
   const restarting = feature.phase === "implementation" && !running;
   const iterating = feature.phase === "review" && !running && pending.length >= 1;
   if (feature.phase !== "tickets" && !restarting && !iterating) {
@@ -5702,8 +5725,8 @@ async function burn(ctx, featureId, opts = {}) {
       why = `feature must be in the tickets phase to burn (currently ${feature.phase})`;
     throw new GateError(why);
   }
-  if (tickets2.filter((t) => t.status !== "cancelled").length < 1) {
-    throw new GateError(tickets2.length > 0 ? "no burnable tickets \u2014 every ticket is cancelled" : "no tickets to burn");
+  if (lapTickets.filter((t) => t.status !== "cancelled").length < 1) {
+    throw new GateError(lapTickets.length > 0 ? "no burnable tickets \u2014 every ticket is cancelled" : "no tickets to burn");
   }
   if (restarting) {
     sweepOrphanedBurning(ctx, featureId, "orphaned \u2014 the previous run died while it was burning");
@@ -5727,6 +5750,22 @@ async function burn(ctx, featureId, opts = {}) {
   });
   return { runId };
 }
+function rethink(ctx, featureId) {
+  const feature = getFeatureRow(ctx, featureId);
+  if (feature.phase !== RETHINK_LOOP_BACK.from) {
+    throw new GateError(`feature must be in the review phase to rethink (currently ${feature.phase})`);
+  }
+  if (hasActiveRun(ctx, featureId)) {
+    throw new GateError("a run is burning this feature \u2014 cancel or wait for it before rethinking");
+  }
+  const live = activeSessionsForFeature(ctx, featureId);
+  if (live.length > 0) {
+    throw new GateError(`a ${live[0].kind} session is already live for ${feature.slug} \u2014 only one terminal per feature; end or resume it first`);
+  }
+  const lap = feature.lap + 1;
+  ctx.db.update(features).set({ lap }).where(eq9(features.id, featureId)).run();
+  return setPhase(ctx, featureId, RETHINK_LOOP_BACK.to, "lap.started", `rethink \u2014 lap ${lap}`);
+}
 async function retryTicket(ctx, ticketId, opts = {}) {
   const ticket = getTicket(ctx, ticketId);
   const feature = getFeatureRow(ctx, ticket.featureId);
@@ -5908,6 +5947,7 @@ var init_features = __esm(() => {
   init_git();
   init_knowledge();
   init_repo();
+  init_sessions();
   init_end_session();
   init_tickets();
   init_waypoints();
@@ -5953,6 +5993,7 @@ function toolGetFeatureContext(ctx, session) {
   const context = {
     feature,
     phase: feature.phase,
+    lap: feature.lap,
     docs,
     tickets: listByFeature2(ctx, feature.id)
   };
@@ -7461,6 +7502,7 @@ var gateId, featureRouter;
 var init_feature = __esm(() => {
   init_src();
   init_launcher();
+  init_sessions();
   init_events();
   init_features();
   init_gates();
@@ -7484,6 +7526,14 @@ var init_feature = __esm(() => {
     })).mutation(({ ctx, input }) => launchSession(ctx, input)),
     workWaypoint: publicProcedure.input(z7.object({ featureId: z7.string(), waypointId: z7.string(), endLive: z7.boolean().optional() })).mutation(({ ctx, input }) => workWaypoint(ctx, input)),
     converge: publicProcedure.input(z7.object({ featureId: z7.string(), overrideReason: z7.string().min(1).optional() })).mutation(({ ctx, input }) => converge(ctx, { featureId: input.featureId, overrideReason: input.overrideReason })),
+    rethink: publicProcedure.input(z7.object({ featureId: z7.string() })).mutation(({ ctx, input }) => {
+      const feature = rethink(ctx, input.featureId);
+      return launchSession(ctx, {
+        featureId: input.featureId,
+        kind: "revisit",
+        kickoffLine: lapKickoff(feature.lap)
+      });
+    }),
     resendKickoff: publicProcedure.input(z7.object({ sessionId: z7.string() })).mutation(({ ctx, input }) => resendKickoff(ctx, input.sessionId)),
     endSession: publicProcedure.input(z7.object({ sessionId: z7.string() })).mutation(({ ctx, input }) => endSession(ctx, input.sessionId)),
     advance: publicProcedure.input(z7.object({ featureId: z7.string() })).mutation(({ ctx, input }) => advance(ctx, input.featureId)),

package/drizzle/0014_ordinary_mystique.sql

@@ -0,0 +1,4 @@
+ALTER TABLE `events` ADD `lap` integer DEFAULT 1 NOT NULL;--> statement-breakpoint
+ALTER TABLE `features` ADD `lap` integer DEFAULT 1 NOT NULL;--> statement-breakpoint
+ALTER TABLE `sessions` ADD `lap` integer DEFAULT 1 NOT NULL;--> statement-breakpoint
+ALTER TABLE `tickets` ADD `lap` integer DEFAULT 1 NOT NULL;