@papi-ai/server 0.7.3-alpha.1 → 0.7.4-alpha.1

package/dist/index.js

@@ -1427,8 +1427,8 @@ var init_dist2 = __esm({
       bug: 1,
       task: 1,
       research: 2,
-      idea: 3,
-      feedback: 3
+      spike: 2,
+      idea: 3
     };
     VALID_EFFORT_SIZES = /* @__PURE__ */ new Set(["XS", "S", "M", "L", "XL"]);
     SECTION_HEADERS = [
@@ -4467,6 +4467,7 @@ function rowToTask(row) {
   if (row.maturity != null) task.maturity = row.maturity;
   if (row.stage_id != null) task.stageId = row.stage_id;
   if (row.doc_ref != null) task.docRef = row.doc_ref;
+  if (row.source != null) task.source = row.source;
   return task;
 }
 function rowToBuildReport(row) {
@@ -6710,7 +6711,7 @@ ${newParts.join("\n")}` : newParts.join("\n");
         project_id, display_id, title, status, priority, complexity,
         module, epic, phase, owner, reviewed, cycle, created_cycle,
         why, depends_on, notes, closure_reason, state_history,
-        build_handoff, build_report, task_type, maturity, stage_id, doc_ref
+        build_handoff, build_report, task_type, maturity, stage_id, doc_ref, source
       ) VALUES (
         ${this.projectId}, ${displayId}, ${task.title}, ${task.status}, ${task.priority},
         ${normaliseComplexity(task.complexity)}, ${task.module}, ${task.epic ?? null}, ${task.phase}, ${task.owner},
@@ -6723,7 +6724,8 @@ ${newParts.join("\n")}` : newParts.join("\n");
         ${task.taskType ?? null},
         ${task.maturity ?? null},
         ${task.stageId ?? null},
-        ${task.docRef ?? null}
+        ${task.docRef ?? null},
+        ${task.source ?? null}
       )
       RETURNING *
     `;
@@ -6754,6 +6756,7 @@ ${newParts.join("\n")}` : newParts.join("\n");
         if (updates.maturity !== void 0) columnMap["maturity"] = updates.maturity;
         if (updates.stageId !== void 0) columnMap["stage_id"] = updates.stageId;
         if (updates.docRef !== void 0) columnMap["doc_ref"] = updates.docRef;
+        if (updates.source !== void 0) columnMap["source"] = updates.source;
         const keys = Object.keys(columnMap);
         if (keys.length === 0) return;
         await this.sql`
@@ -10000,10 +10003,12 @@ This is Cycle 0 \u2014 the first planning cycle for a brand-new project.
 
 2. **North Star** \u2014 Propose a one-sentence North Star statement, a success metric, and a key metric.
 
-3. **Initial Board** \u2014 Generate 3-5 tasks:
-   - Task 1: Project setup / scaffolding (if needed)
-   - Task 2: Core data model or foundational structure
-   - Tasks 3-5: First user-facing features, broken into small steps
+3. **Initial Board** \u2014 Generate 3-5 tasks based on the project's actual tech stack and goals:
+   - Infer the project type from the brief/description (CLI, web app, mobile app, API, library, game, data pipeline, etc.)
+   - Task 1: Project-appropriate setup (toolchain, dependencies, config \u2014 NOT "scaffolding" if the project already has code)
+   - Task 2: Core functionality that proves the concept works (data model, main loop, core algorithm \u2014 whatever the project needs first)
+   - Tasks 3-5: First deliverables that demonstrate value, broken into small steps appropriate for the project type
+   - Do NOT assume web-app patterns (routes, pages, components) unless the brief explicitly describes a web application
    - All tasks: status Backlog, priority P1-P2, reviewed true, phase "Phase 1"
 
 4. **First Active Decision** \u2014 If the description implies a clear architectural choice, create AD-1 with Confidence: MEDIUM. If no clear choice, skip this.
@@ -10163,11 +10168,25 @@ var PLAN_FRAGMENT_RESEARCH = `
 var PLAN_FRAGMENT_BUG = `
    **Bug task detection:** When a task's task type is "bug" or the title starts with "Bug:" or "Fix:", apply these rules:
    - **Auto-P1:** If the task's current priority is P2 or lower, upgrade it to "P1 High" via a boardCorrections entry in Part 2. Note the upgrade in Part 1 analysis.
-   - Add a BLAST RADIUS note to the BUILD HANDOFF SCOPE section: "Bug fix \u2014 minimal blast radius. Change only what is necessary to fix the reported behaviour. Do not refactor surrounding code or expand scope."
-   - Add to ACCEPTANCE CRITERIA: "[ ] Fix is targeted \u2014 no unrelated code changed"`;
+   - Replace the standard SCOPE (DO THIS) section with bug-specific sections:
+     - **REPRODUCE:** Exact steps to reproduce the bug before touching any code. If the task notes describe the symptoms, include them. If not, the first build step is "confirm the bug reproduces."
+     - **ROOT CAUSE:** One-sentence hypothesis for the root cause (what is wrong, not what the user sees). The builder must confirm or correct this before implementing a fix.
+     - **MINIMAL FIX:** The smallest code change that resolves the root cause. "Bug fix \u2014 minimal blast radius. Change only what is necessary. Do not refactor surrounding code or expand scope."
+     - **REGRESSION TEST:** How to verify the bug is fixed and won't silently recur. Describe the test (manual or automated) \u2014 the builder must confirm this passes.
+   - Add to ACCEPTANCE CRITERIA: "[ ] Fix is targeted \u2014 no unrelated code changed" and "[ ] Regression test confirms the bug no longer reproduces"`;
 var PLAN_FRAGMENT_IDEA = `
    **Idea task detection:** When a task's task type is "idea", add a scope clarification note to the BUILD HANDOFF:
    - Add to SCOPE (DO THIS): "This task originated as an idea. Confirm the exact deliverable before implementing \u2014 check task notes and any referenced docs for intent. If scope is unclear, flag it in the build report surprises."`;
+var PLAN_FRAGMENT_SPIKE = `
+   **Spike task detection:** When a task's task type is "spike" or the title starts with "Spike:", apply these rules:
+   - Spikes are time-boxed investigations, not implementation tasks. The deliverable is a FINDING, not code.
+   - Replace the standard BUILD HANDOFF sections with spike-specific sections:
+     - **TIME-BOX:** Maximum effort for this spike (e.g. "Stop after S effort / ~2 hours"). If the question isn't answered by then, the spike is done \u2014 report what you found.
+     - **GOAL:** The specific question this spike answers (one sentence, phrased as a question).
+     - **OUTPUT:** What the spike produces: a written finding (doc in docs/research/ or notes in the build report), optionally a proof-of-concept if code is needed.
+     - **DONE CONDITION:** "Question answered OR time-box hit, whichever comes first."
+   - Keep SCOPE BOUNDARY, SECURITY CONSIDERATIONS, and PRE-BUILD VERIFICATION as normal.
+   - Spikes should be estimated conservatively: XS or S. If a spike needs M+ effort, it's not a spike \u2014 reclassify as a research task.`;
 var PLAN_FRAGMENT_UI = `
    **UI/visual task detection:** When a task's title or notes contain keywords suggesting frontend visual work (e.g. "visual", "design", "UI", "styling", "refresh", "frontend", "landing page", "hero", "carousel", "theme", "layout", "cockpit", "dashboard", "page"), apply these handoff additions:
    - Add to SCOPE: "Read \`.impeccable.md\` for brand palette, design principles, and audience context before writing any code. Use the \`frontend-design\` skill for implementation."
@@ -10276,6 +10295,7 @@ Standard planning cycle with full board review.
   if (flags.hasResearchTasks) parts.push(PLAN_FRAGMENT_RESEARCH);
   if (flags.hasBugTasks) parts.push(PLAN_FRAGMENT_BUG);
   if (flags.hasIdeaTasks) parts.push(PLAN_FRAGMENT_IDEA);
+  if (flags.hasSpikeTasks) parts.push(PLAN_FRAGMENT_SPIKE);
   if (flags.hasUITasks) parts.push(PLAN_FRAGMENT_UI);
   parts.push(`
 11. **New Tasks (max 3 per cycle)** \u2014 Actively mine the Recent Build Reports for task candidates. For each report, check:
@@ -10594,6 +10614,15 @@ You MUST cover these 5 sections. Each is mandatory.
 ${compressionJob}
 Note: Hierarchy assessment and structural drift detection are handled within section 5 (AD & Hierarchy Housekeeping). They do not need their own sections.
 
+## DETECT STRATEGIC DECISIONS
+
+Watch for direction changes, architecture shifts, deprioritisation with reasoning, new principles, or competitive positioning decisions in the project data.
+
+When detected:
+1. Flag it in the review: "Strategic direction change detected \u2014 [description]."
+2. Propose an AD update or new AD in the structured output (Part 2 \`activeDecisions\` array).
+3. Recommend running \`strategy_change\` if the shift requires immediate action before the next plan.
+
 ## OUTPUT FORMAT
 
 Your output has TWO parts:
@@ -11453,21 +11482,24 @@ function detectBoardFlags(tasks) {
   let hasBugTasks = false;
   let hasResearchTasks = false;
   let hasIdeaTasks = false;
+  let hasSpikeTasks = false;
   let hasUITasks = false;
   const uiKeywords = /\b(visual|design|UI|styling|refresh|frontend|landing page|hero|carousel|theme|layout|cockpit|dashboard|page)\b/i;
   for (const t of tasks) {
     if (t.taskType === "bug" || /^(Bug:|Fix:)/i.test(t.title)) hasBugTasks = true;
     if (t.taskType === "research" || /^Research:/i.test(t.title)) hasResearchTasks = true;
     if (t.taskType === "idea") hasIdeaTasks = true;
+    if (t.taskType === "spike" || /^Spike:/i.test(t.title)) hasSpikeTasks = true;
     if (uiKeywords.test(t.title) || uiKeywords.test(t.notes ?? "")) hasUITasks = true;
   }
-  return { hasBugTasks, hasResearchTasks, hasIdeaTasks, hasUITasks };
+  return { hasBugTasks, hasResearchTasks, hasIdeaTasks, hasSpikeTasks, hasUITasks };
 }
 function detectBoardFlagsFromText(boardText) {
   return {
     hasBugTasks: /\b(bug|Bug:|Fix:)\b/i.test(boardText),
     hasResearchTasks: /\b(research|Research:)\b/i.test(boardText),
     hasIdeaTasks: /\bidea\b/i.test(boardText),
+    hasSpikeTasks: /\b(spike|Spike:)\b/i.test(boardText),
     hasUITasks: /\b(visual|design|UI|styling|refresh|frontend|landing page|hero|carousel|theme|layout|cockpit|dashboard|page)\b/i.test(boardText)
   };
 }
@@ -11944,13 +11976,24 @@ ${cleanContent}`;
   console.error(`[plan-perf] transactionalWriteBack: total=${writeBackMs}ms`);
   const verifyWarnings = [];
   try {
-    const cycles = await adapter2.readCycles();
+    const [cycles, boardTasks] = await Promise.all([
+      adapter2.readCycles(),
+      adapter2.queryBoard({ status: ["In Cycle", "Backlog", "In Progress", "In Review"] })
+    ]);
     const newCycle = cycles.find((s) => s.number === newCycleNumber);
     if (!newCycle) {
-      verifyWarnings.push(`Post-write verification: cycle ${newCycleNumber} entity not found after commit`);
+      verifyWarnings.push(`Post-write verification FAILED: cycle ${newCycleNumber} entity not found after commit \u2014 data may not have persisted`);
+    } else {
+      const expectedHandoffs = data.cycleHandoffs?.length ?? 0;
+      const actualCycleTasks = boardTasks.filter((t) => t.cycle === newCycleNumber).length;
+      if (expectedHandoffs > 0 && actualCycleTasks === 0) {
+        verifyWarnings.push(`Post-write verification FAILED: cycle ${newCycleNumber} exists but has 0 tasks assigned (expected ${expectedHandoffs}) \u2014 task cycle assignment may have failed`);
+      } else if (expectedHandoffs > 0 && actualCycleTasks < expectedHandoffs) {
+        verifyWarnings.push(`Post-write verification WARNING: cycle ${newCycleNumber} has ${actualCycleTasks} tasks but expected ${expectedHandoffs} \u2014 some task assignments may have failed`);
+      }
     }
   } catch {
-    verifyWarnings.push("Post-write verification: could not read cycles table");
+    verifyWarnings.push("Post-write verification: could not read cycles/tasks tables");
   }
   const allWarnings = [...result.warnings, ...verifyWarnings];
   const handoffCount = data.cycleHandoffs?.length ?? 0;
@@ -12037,7 +12080,8 @@ ${cleanContent}`;
         cycle: newCycleNumber,
         createdCycle: newCycleNumber,
         why: task.why || "",
-        notes: task.notes || ""
+        notes: task.notes || "",
+        source: "llm"
       });
       newTaskIdMap.set(`new-${i + 1}`, created.id);
       if (adapter2.updateCycleLearningActionRef && task.notes) {
@@ -14434,6 +14478,18 @@ ${result.userMessage}
 // src/services/board.ts
 var ACTIVE_STATUSES = ["Backlog", "In Cycle", "Ready", "In Progress", "In Review", "Blocked"];
 var PRIORITY_ORDER = ["P0 Critical", "P1 High", "P2 Medium", "P3 Low"];
+var STATUS_TIER = {
+  "In Progress": 0,
+  "In Review": 1,
+  "Backlog": 2,
+  "In Cycle": 2,
+  "Ready": 2,
+  "Blocked": 3,
+  "Deferred": 4,
+  "Done": 5,
+  "Cancelled": 6,
+  "Archived": 7
+};
 async function viewBoard(adapter2, phaseFilter, options) {
   const queryOptions = {};
   const phase = options?.phase ?? phaseFilter;
@@ -14448,9 +14504,16 @@ async function viewBoard(adapter2, phaseFilter, options) {
     Object.keys(queryOptions).length > 0 ? queryOptions : void 0
   );
   allTasks.sort((a, b2) => {
+    const aTier = STATUS_TIER[a.status] ?? 4;
+    const bTier = STATUS_TIER[b2.status] ?? 4;
+    if (aTier !== bTier) return aTier - bTier;
     const ai = PRIORITY_ORDER.indexOf(a.priority);
     const bi = PRIORITY_ORDER.indexOf(b2.priority);
-    return (ai === -1 ? 999 : ai) - (bi === -1 ? 999 : bi);
+    const priorityDiff = (ai === -1 ? 999 : ai) - (bi === -1 ? 999 : bi);
+    if (priorityDiff !== 0) return priorityDiff;
+    const aDate = a.createdAt ?? "";
+    const bDate = b2.createdAt ?? "";
+    return bDate.localeCompare(aDate);
   });
   const total = allTasks.length;
   const offset = options?.offset ?? 0;
@@ -14654,7 +14717,7 @@ function formatBoard(result) {
   if (result.tasks.length === 0) {
     return "No tasks found.";
   }
-  const headers = ["Priority", "Task", "Summary", "Status", "Cycle", "Phase", "Module", "Epic", "Effort", "Created"];
+  const headers = ["Priority", "Task", "Summary", "Status", "Cycle", "Phase", "Module", "Epic", "Effort", "Created", "Source"];
   const rows = result.tasks.map((t) => [
     t.priority,
     t.id,
@@ -14665,7 +14728,8 @@ function formatBoard(result) {
     t.module ?? "-",
     t.epic ?? "-",
     t.complexity ?? "-",
-    t.createdAt ?? "-"
+    t.createdAt ?? "-",
+    t.source ?? "-"
   ]);
   const widths = headers.map(
     (h, i) => Math.max(h.length, ...rows.map((r) => r[i].length))
@@ -15943,7 +16007,8 @@ async function applySetup(adapter2, config2, input, briefText, adSeedText, conve
             phase: task.phase || "Phase 1",
             owner: "TBD",
             reviewed: false,
-            notes: task.notes
+            notes: task.notes,
+            source: "llm"
           });
           createdTasks++;
         }
@@ -17522,19 +17587,23 @@ ${lines.join("\n")}
   const VALID_COMPLEXITIES2 = /* @__PURE__ */ new Set(["XS", "Small", "Medium", "Large", "XL"]);
   const priority = input.priority && VALID_PRIORITIES2.has(input.priority) ? input.priority : "P2 Medium";
   const complexity = input.complexity && VALID_COMPLEXITIES2.has(input.complexity) ? input.complexity : "Small";
-  const PREFIX_MAP = {
-    bug: "bug",
-    research: "research",
-    feedback: "feedback"
-  };
+  const VALID_TYPES = /* @__PURE__ */ new Set(["task", "bug", "research", "idea", "spike"]);
   let taskTitle = input.text;
   let taskType = "idea";
-  const prefixMatch = input.text.match(/^\[([a-zA-Z]+)\]\s*/);
-  if (prefixMatch) {
-    const key = prefixMatch[1].toLowerCase();
-    if (key in PREFIX_MAP) {
-      taskType = PREFIX_MAP[key];
-      taskTitle = input.text.slice(prefixMatch[0].length);
+  if (input.type && VALID_TYPES.has(input.type)) {
+    taskType = input.type;
+  } else {
+    const PREFIX_MAP = {
+      bug: "bug",
+      research: "research"
+    };
+    const prefixMatch = input.text.match(/^\[([a-zA-Z]+)\]\s*/);
+    if (prefixMatch) {
+      const key = prefixMatch[1].toLowerCase();
+      if (key in PREFIX_MAP) {
+        taskType = PREFIX_MAP[key];
+        taskTitle = input.text.slice(prefixMatch[0].length);
+      }
     }
   }
   const task = await adapter2.createTask({
@@ -17553,7 +17622,8 @@ ${lines.join("\n")}
     notes: input.notes || "",
     taskType,
     maturity: "raw",
-    docRef: input.docRef
+    docRef: input.docRef,
+    source: "llm"
   });
   if (input.notes && adapter2.updateCycleLearningActionRef) {
     const learningRefs = input.notes.match(/learning:([a-f0-9-]+)/gi);
@@ -17661,6 +17731,11 @@ var ideaTool = {
         type: "boolean",
         description: "Force creation even if a high-overlap duplicate or already-done task is detected. Default: false."
       },
+      type: {
+        type: "string",
+        enum: ["task", "bug", "research", "spike"],
+        description: 'Task type. Defaults to "task". Use "bug" for defects, "research" for investigation tasks, "spike" for time-boxed experiments. The planner uses this to generate type-specific BUILD HANDOFFs.'
+      },
       doc_ref: {
         type: "string",
         description: 'Path to a reference document (e.g. "docs/research/foo.md"). Stored as a structured field \u2014 replaces the fragile "Reference:" line in notes.'
@@ -17691,7 +17766,8 @@ async function handleIdea(adapter2, config2, args) {
     notes: rawNotes,
     discovery: args.discovery === true,
     force: args.force === true,
-    docRef: args.doc_ref?.trim()
+    docRef: args.doc_ref?.trim(),
+    type: args.type
   };
   const useGit = isGitAvailable() && isGitRepo(config2.projectRoot);
   const currentBranch = useGit ? getCurrentBranch(config2.projectRoot) : null;
@@ -17778,7 +17854,8 @@ async function captureBug(adapter2, input) {
     createdCycle: health.totalCycles,
     notes: input.notes || "",
     taskType: "bug",
-    maturity: "investigated"
+    maturity: "investigated",
+    source: "llm"
   });
 }
 
@@ -17949,7 +18026,8 @@ async function recordAdHoc(adapter2, input) {
       reviewed: true,
       createdCycle: cycle,
       notes: input.notes ? `[ad-hoc] ${input.notes}` : "[ad-hoc]",
-      taskType: "task"
+      taskType: "task",
+      source: "owner"
     });
   }
   const report = {
@@ -18463,11 +18541,88 @@ When done, call \`board_reconcile\` again with:
 - \`mode\`: "retriage-apply"
 - \`llm_response\`: your complete output (both parts)
 `;
+async function checkCycleIntegrity(adapter2) {
+  const report = {
+    multiActiveCycles: [],
+    ghostCycles: [],
+    orphanedAssignments: [],
+    autoFixed: []
+  };
+  try {
+    const cycles = await adapter2.readCycles();
+    const allTasks = await adapter2.queryBoard({ status: ["Backlog", "In Cycle", "Ready", "In Progress", "In Review", "Done", "Blocked", "Cancelled", "Deferred"] });
+    const activeCycles = cycles.filter((c) => c.status === "active");
+    if (activeCycles.length > 1) {
+      for (const cycle of activeCycles) {
+        const taskCount = allTasks.filter((t) => t.cycle === cycle.number).length;
+        report.multiActiveCycles.push({ cycleNumber: cycle.number, id: cycle.id, taskCount });
+      }
+    }
+    const validCycleNumbers = new Set(cycles.map((c) => c.number));
+    for (const cycle of cycles) {
+      if (cycle.status === "completed") continue;
+      const taskCount = allTasks.filter((t) => t.cycle === cycle.number).length;
+      if (taskCount === 0 && cycle.status === "active") {
+        report.ghostCycles.push({ cycleNumber: cycle.number, id: cycle.id });
+      }
+    }
+    for (const task of allTasks) {
+      if (task.cycle && !validCycleNumbers.has(task.cycle)) {
+        report.orphanedAssignments.push({
+          taskId: task.id,
+          title: task.title,
+          assignedCycle: task.cycle
+        });
+      }
+    }
+  } catch {
+  }
+  return report;
+}
+function formatCycleIntegrityReport(report) {
+  const lines = [];
+  const hasIssues = report.multiActiveCycles.length > 1 || report.ghostCycles.length > 0 || report.orphanedAssignments.length > 0;
+  if (!hasIssues) return "";
+  lines.push("### Cycle Integrity Check");
+  lines.push("");
+  if (report.multiActiveCycles.length > 1) {
+    lines.push(`**Multi-active-cycle detected** (${report.multiActiveCycles.length} active cycles \u2014 needs manual fix):`);
+    const sorted = [...report.multiActiveCycles].sort((a, b2) => b2.taskCount - a.taskCount || b2.cycleNumber - a.cycleNumber);
+    for (const c of sorted) {
+      const tag = c === sorted[0] ? " \u2190 likely current" : " \u2190 candidate for completion";
+      lines.push(`- Cycle ${c.cycleNumber} (${c.taskCount} tasks)${tag}`);
+    }
+    lines.push("Fix: run `UPDATE cycles SET status = 'completed' WHERE number = <N>` for the stale cycle(s).");
+    lines.push("");
+  }
+  if (report.ghostCycles.length > 0) {
+    lines.push("**Ghost cycles** (active but no tasks \u2014 needs manual review):");
+    for (const g of report.ghostCycles) {
+      lines.push(`- Cycle ${g.cycleNumber} (id: ${g.id}) \u2014 active with 0 tasks`);
+    }
+    lines.push("");
+  }
+  if (report.orphanedAssignments.length > 0) {
+    lines.push("**Orphaned cycle assignments** (tasks pointing to non-existent cycles):");
+    for (const o of report.orphanedAssignments) {
+      lines.push(`- **${o.taskId}**: "${o.title}" \u2192 cycle ${o.assignedCycle} (does not exist)`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n") + "\n";
+}
 async function handleBoardReconcile(adapter2, config2, args) {
   const mode = args.mode ?? "prepare";
   if (mode === "prepare") {
     const context = await prepareReconcile(adapter2);
+    const cycleReport = await checkCycleIntegrity(adapter2);
+    const cycleSection = formatCycleIntegrityReport(cycleReport);
     if (context === "No backlog tasks to reconcile.") {
+      if (cycleSection) {
+        return textResponse(`No backlog tasks to reconcile.
+
+${cycleSection}`);
+      }
       return textResponse(context);
     }
     let mismatchSection = "";
@@ -18498,7 +18653,7 @@ async function handleBoardReconcile(adapter2, config2, args) {
       `${RECONCILE_PROMPT}
 ---
 
-### Backlog Context
+${cycleSection}### Backlog Context
 
 ${mismatchSection}${context}
 ---
@@ -19868,9 +20023,10 @@ async function getHierarchyPosition(adapter2) {
       adapter2.queryBoard()
     ]);
     if (horizons.length === 0) return void 0;
-    const activeHorizon = horizons.find((h) => h.status === "active") || horizons[0];
-    const activeStages = stages.filter((s) => s.horizonId === activeHorizon.id);
-    const activeStage = activeStages.find((s) => s.status === "active") || activeStages[0];
+    const isActive = (s) => s.status.toLowerCase() === "active";
+    const activeHorizon = horizons.find(isActive) || horizons[0];
+    const horizonStages = stages.filter((s) => s.horizonId === activeHorizon.id).sort((a, b2) => (a.sortOrder ?? 0) - (b2.sortOrder ?? 0));
+    const activeStage = horizonStages.find(isActive) || horizonStages[0];
     if (!activeStage) return void 0;
     const stagePhases = phases.filter((p) => p.stageId === activeStage.id);
     const activePhases = stagePhases.filter((p) => p.status === "In Progress");

package/dist/prompts.js

@@ -133,10 +133,12 @@ This is Cycle 0 \u2014 the first planning cycle for a brand-new project.
 
 2. **North Star** \u2014 Propose a one-sentence North Star statement, a success metric, and a key metric.
 
-3. **Initial Board** \u2014 Generate 3-5 tasks:
-   - Task 1: Project setup / scaffolding (if needed)
-   - Task 2: Core data model or foundational structure
-   - Tasks 3-5: First user-facing features, broken into small steps
+3. **Initial Board** \u2014 Generate 3-5 tasks based on the project's actual tech stack and goals:
+   - Infer the project type from the brief/description (CLI, web app, mobile app, API, library, game, data pipeline, etc.)
+   - Task 1: Project-appropriate setup (toolchain, dependencies, config \u2014 NOT "scaffolding" if the project already has code)
+   - Task 2: Core functionality that proves the concept works (data model, main loop, core algorithm \u2014 whatever the project needs first)
+   - Tasks 3-5: First deliverables that demonstrate value, broken into small steps appropriate for the project type
+   - Do NOT assume web-app patterns (routes, pages, components) unless the brief explicitly describes a web application
    - All tasks: status Backlog, priority P1-P2, reviewed true, phase "Phase 1"
 
 4. **First Active Decision** \u2014 If the description implies a clear architectural choice, create AD-1 with Confidence: MEDIUM. If no clear choice, skip this.
@@ -296,11 +298,25 @@ var PLAN_FRAGMENT_RESEARCH = `
 var PLAN_FRAGMENT_BUG = `
    **Bug task detection:** When a task's task type is "bug" or the title starts with "Bug:" or "Fix:", apply these rules:
    - **Auto-P1:** If the task's current priority is P2 or lower, upgrade it to "P1 High" via a boardCorrections entry in Part 2. Note the upgrade in Part 1 analysis.
-   - Add a BLAST RADIUS note to the BUILD HANDOFF SCOPE section: "Bug fix \u2014 minimal blast radius. Change only what is necessary to fix the reported behaviour. Do not refactor surrounding code or expand scope."
-   - Add to ACCEPTANCE CRITERIA: "[ ] Fix is targeted \u2014 no unrelated code changed"`;
+   - Replace the standard SCOPE (DO THIS) section with bug-specific sections:
+     - **REPRODUCE:** Exact steps to reproduce the bug before touching any code. If the task notes describe the symptoms, include them. If not, the first build step is "confirm the bug reproduces."
+     - **ROOT CAUSE:** One-sentence hypothesis for the root cause (what is wrong, not what the user sees). The builder must confirm or correct this before implementing a fix.
+     - **MINIMAL FIX:** The smallest code change that resolves the root cause. "Bug fix \u2014 minimal blast radius. Change only what is necessary. Do not refactor surrounding code or expand scope."
+     - **REGRESSION TEST:** How to verify the bug is fixed and won't silently recur. Describe the test (manual or automated) \u2014 the builder must confirm this passes.
+   - Add to ACCEPTANCE CRITERIA: "[ ] Fix is targeted \u2014 no unrelated code changed" and "[ ] Regression test confirms the bug no longer reproduces"`;
 var PLAN_FRAGMENT_IDEA = `
    **Idea task detection:** When a task's task type is "idea", add a scope clarification note to the BUILD HANDOFF:
    - Add to SCOPE (DO THIS): "This task originated as an idea. Confirm the exact deliverable before implementing \u2014 check task notes and any referenced docs for intent. If scope is unclear, flag it in the build report surprises."`;
+var PLAN_FRAGMENT_SPIKE = `
+   **Spike task detection:** When a task's task type is "spike" or the title starts with "Spike:", apply these rules:
+   - Spikes are time-boxed investigations, not implementation tasks. The deliverable is a FINDING, not code.
+   - Replace the standard BUILD HANDOFF sections with spike-specific sections:
+     - **TIME-BOX:** Maximum effort for this spike (e.g. "Stop after S effort / ~2 hours"). If the question isn't answered by then, the spike is done \u2014 report what you found.
+     - **GOAL:** The specific question this spike answers (one sentence, phrased as a question).
+     - **OUTPUT:** What the spike produces: a written finding (doc in docs/research/ or notes in the build report), optionally a proof-of-concept if code is needed.
+     - **DONE CONDITION:** "Question answered OR time-box hit, whichever comes first."
+   - Keep SCOPE BOUNDARY, SECURITY CONSIDERATIONS, and PRE-BUILD VERIFICATION as normal.
+   - Spikes should be estimated conservatively: XS or S. If a spike needs M+ effort, it's not a spike \u2014 reclassify as a research task.`;
 var PLAN_FRAGMENT_UI = `
    **UI/visual task detection:** When a task's title or notes contain keywords suggesting frontend visual work (e.g. "visual", "design", "UI", "styling", "refresh", "frontend", "landing page", "hero", "carousel", "theme", "layout", "cockpit", "dashboard", "page"), apply these handoff additions:
    - Add to SCOPE: "Read \`.impeccable.md\` for brand palette, design principles, and audience context before writing any code. Use the \`frontend-design\` skill for implementation."
@@ -409,6 +425,7 @@ Standard planning cycle with full board review.
   if (flags.hasResearchTasks) parts.push(PLAN_FRAGMENT_RESEARCH);
   if (flags.hasBugTasks) parts.push(PLAN_FRAGMENT_BUG);
   if (flags.hasIdeaTasks) parts.push(PLAN_FRAGMENT_IDEA);
+  if (flags.hasSpikeTasks) parts.push(PLAN_FRAGMENT_SPIKE);
   if (flags.hasUITasks) parts.push(PLAN_FRAGMENT_UI);
   parts.push(`
 11. **New Tasks (max 3 per cycle)** \u2014 Actively mine the Recent Build Reports for task candidates. For each report, check:
@@ -727,6 +744,15 @@ You MUST cover these 5 sections. Each is mandatory.
 ${compressionJob}
 Note: Hierarchy assessment and structural drift detection are handled within section 5 (AD & Hierarchy Housekeeping). They do not need their own sections.
 
+## DETECT STRATEGIC DECISIONS
+
+Watch for direction changes, architecture shifts, deprioritisation with reasoning, new principles, or competitive positioning decisions in the project data.
+
+When detected:
+1. Flag it in the review: "Strategic direction change detected \u2014 [description]."
+2. Propose an AD update or new AD in the structured output (Part 2 \`activeDecisions\` array).
+3. Recommend running \`strategy_change\` if the shift requires immediate action before the next plan.
+
 ## OUTPUT FORMAT
 
 Your output has TWO parts:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@papi-ai/server",
-  "version": "0.7.3-alpha.1",
+  "version": "0.7.4-alpha.1",
   "description": "PAPI MCP server — AI-powered sprint planning, build execution, and strategy review for software projects",
   "license": "Elastic-2.0",
   "type": "module",