@anthropologies/claudestory 0.1.35 → 0.1.36

package/dist/index.js

@@ -1395,6 +1395,7 @@ function validateProject(state) {
       }
     }
   }
+  detectSupersedesCycles(state, findings);
   const phaseIDCounts = /* @__PURE__ */ new Map();
   for (const p of state.roadmap.phases) {
     phaseIDCounts.set(p.id, (phaseIDCounts.get(p.id) ?? 0) + 1);
@@ -1599,6 +1600,33 @@ function dfsBlocked(id, state, visited, inStack, findings) {
   inStack.delete(id);
   visited.add(id);
 }
+function detectSupersedesCycles(state, findings) {
+  const visited = /* @__PURE__ */ new Set();
+  const inStack = /* @__PURE__ */ new Set();
+  for (const l of state.lessons) {
+    if (l.supersedes == null || visited.has(l.id)) continue;
+    dfsSupersedesChain(l.id, state, visited, inStack, findings);
+  }
+}
+function dfsSupersedesChain(id, state, visited, inStack, findings) {
+  if (inStack.has(id)) {
+    findings.push({
+      level: "error",
+      code: "supersedes_cycle",
+      message: `Cycle detected in supersedes chain involving ${id}.`,
+      entity: id
+    });
+    return;
+  }
+  if (visited.has(id)) return;
+  inStack.add(id);
+  const lesson = state.lessonByID(id);
+  if (lesson?.supersedes && lesson.supersedes !== id) {
+    dfsSupersedesChain(lesson.supersedes, state, visited, inStack, findings);
+  }
+  inStack.delete(id);
+  visited.add(id);
+}
 
 // src/core/recommend.ts
 var SEVERITY_RANK = {
@@ -1616,10 +1644,12 @@ var CATEGORY_PRIORITY = {
   high_impact_unblock: 4,
   near_complete_umbrella: 5,
   phase_momentum: 6,
-  quick_win: 7,
-  open_issue: 8
+  debt_trend: 7,
+  quick_win: 8,
+  handover_context: 9,
+  open_issue: 10
 };
-function recommend(state, count) {
+function recommend(state, count, options) {
   const effectiveCount = Math.max(1, Math.min(10, count));
   const dedup = /* @__PURE__ */ new Map();
   const phaseIndex = buildPhaseIndex(state);
@@ -1631,7 +1661,8 @@ function recommend(state, count) {
     () => generateNearCompleteUmbrellas(state, phaseIndex),
     () => generatePhaseMomentum(state),
     () => generateQuickWins(state, phaseIndex),
-    () => generateOpenIssues(state)
+    () => generateOpenIssues(state),
+    () => generateDebtTrend(state, options)
   ];
   for (const gen of generators) {
     for (const rec of gen()) {
@@ -1641,6 +1672,7 @@ function recommend(state, count) {
       }
     }
   }
+  applyHandoverBoost(state, dedup, options);
   const curPhase = currentPhase(state);
   const curPhaseIdx = curPhase ? phaseIndex.get(curPhase.id) ?? 0 : 0;
   for (const [id, rec] of dedup) {
@@ -1830,6 +1862,82 @@ function sortByPhaseAndOrder(tickets, phaseIndex) {
     return a.order - b.order;
   });
 }
+var TICKET_ID_RE = /\bT-\d{3}[a-z]?\b/g;
+var ACTIONABLE_HEADING_RE = /^#+\s.*(next|open|remaining|todo|blocked)/im;
+var HANDOVER_BOOST = 50;
+var HANDOVER_BASE_SCORE = 350;
+function applyHandoverBoost(state, dedup, options) {
+  if (!options?.latestHandoverContent) return;
+  const content = options.latestHandoverContent;
+  let actionableIds = extractTicketIdsFromActionableSections(content);
+  if (actionableIds.size === 0) {
+    const allIds = new Set(content.match(TICKET_ID_RE) ?? []);
+    for (const id of allIds) {
+      const ticket = state.ticketByID(id);
+      if (ticket && ticket.status !== "complete" && ticket.status !== "inprogress") {
+        actionableIds.add(id);
+      }
+    }
+  }
+  for (const id of actionableIds) {
+    const ticket = state.ticketByID(id);
+    if (!ticket || ticket.status === "complete") continue;
+    const existing = dedup.get(id);
+    if (existing) {
+      dedup.set(id, {
+        ...existing,
+        score: existing.score + HANDOVER_BOOST,
+        reason: existing.reason + " (handover context)"
+      });
+    } else {
+      dedup.set(id, {
+        id,
+        kind: "ticket",
+        title: ticket.title,
+        category: "handover_context",
+        reason: "Referenced in latest handover",
+        score: HANDOVER_BASE_SCORE
+      });
+    }
+  }
+}
+function extractTicketIdsFromActionableSections(content) {
+  const ids = /* @__PURE__ */ new Set();
+  const lines = content.split("\n");
+  let inActionable = false;
+  for (const line of lines) {
+    if (/^#+\s/.test(line)) {
+      inActionable = ACTIONABLE_HEADING_RE.test(line);
+    }
+    if (inActionable) {
+      const matches = line.match(TICKET_ID_RE);
+      if (matches) for (const m of matches) ids.add(m);
+    }
+  }
+  return ids;
+}
+var DEBT_TREND_SCORE = 450;
+var DEBT_GROWTH_THRESHOLD = 0.25;
+var DEBT_ABSOLUTE_MINIMUM = 2;
+function generateDebtTrend(state, options) {
+  if (options?.previousOpenIssueCount == null) return [];
+  const currentOpen = state.issues.filter((i) => i.status !== "resolved").length;
+  const previous = options.previousOpenIssueCount;
+  if (previous <= 0) return [];
+  const growth = (currentOpen - previous) / previous;
+  const absolute = currentOpen - previous;
+  if (growth > DEBT_GROWTH_THRESHOLD && absolute >= DEBT_ABSOLUTE_MINIMUM) {
+    return [{
+      id: "DEBT_TREND",
+      kind: "action",
+      title: "Issue debt growing",
+      category: "debt_trend",
+      reason: `Open issues grew from ${previous} to ${currentOpen} (+${Math.round(growth * 100)}%). Consider triaging or resolving issues before adding features.`,
+      score: DEBT_TREND_SCORE
+    }];
+  }
+  return [];
+}
 
 // src/core/id-allocation.ts
 var TICKET_NUMERIC_REGEX = /^T-(\d+)[a-z]?$/;
@@ -2341,7 +2449,7 @@ function fencedBlock(content, lang) {
 ${content}
 ${fence}`;
 }
-function formatStatus(state, format) {
+function formatStatus(state, format, activeSessions = []) {
   const phases = phasesWithStatus(state);
   const data = {
     project: state.config.project,
@@ -2361,7 +2469,8 @@ function formatStatus(state, format) {
       name: p.phase.name,
       status: p.status,
       leafCount: p.leafCount
-    }))
+    })),
+    ...activeSessions.length > 0 ? { activeSessions } : {}
   };
   if (format === "json") {
     return JSON.stringify(successEnvelope(data), null, 2);
@@ -2383,6 +2492,15 @@ function formatStatus(state, format) {
     const summary = p.phase.summary ?? truncate(p.phase.description, 80);
     lines.push(`${indicator} **${escapeMarkdownInline(p.phase.name)}** (${p.leafCount} tickets) \u2014 ${escapeMarkdownInline(summary)}`);
   }
+  if (activeSessions.length > 0) {
+    lines.push("");
+    lines.push("## Active Sessions");
+    lines.push("");
+    for (const s of activeSessions) {
+      const ticket = s.ticketId ? `${s.ticketId}: ${escapeMarkdownInline(s.ticketTitle ?? "")}` : "no ticket";
+      lines.push(`- ${s.sessionId.slice(0, 8)}: ${s.state} -- ${ticket} (${s.mode} mode)`);
+    }
+  }
   if (state.isEmptyScaffold) {
     lines.push("");
     lines.push(EMPTY_SCAFFOLD_HEADING);