archondev 2.19.29 → 2.19.31

package/README.md

@@ -121,6 +121,10 @@ pnpm exec tsx scripts/init-governance-db.ts
 - Content-only requests (stories, outlines, lessons, visuals) use lightweight planning to avoid blocking.
 - BYOK shows per‑model usage and cost by today/week/month/year in `archon preferences` → “View usage details.”  
 - You can paste multi‑line requests into interactive prompts; Archon captures them as a single response.
+- Proposal approvals like `approve plan` now bind to the pending proposal context in chat mode.
+- Governance boundary/path checks in execute now steer with actionable guidance and set atoms to `BLOCKED` rather than hard failing.
+- Analysis-first requests now return recommendations first and require explicit `create atom` before task creation.
+- Chat execution now requires explicit execute intent (for example, `execute atom`) instead of generic `continue`.
 
 **Tip:** Use `archon plan --edit` to adjust title and acceptance criteria before planning.
 **Web Checks:** If Archon detects a web project, it prompts to run A11y/SEO/GEO checks and stores your preference in `.archon/config.yaml`.

package/dist/index.js

@@ -203,7 +203,7 @@ async function saveAtomEnvironmentState(atomId, cwd, state) {
 import chalk5 from "chalk";
 import readline from "readline";
 import { existsSync as existsSync6, readFileSync as readFileSync3, readdirSync as readdirSync3, appendFileSync } from "fs";
-import { join as join6 } from "path";
+import { join as join6, relative } from "path";
 
 // src/core/context/manager.ts
 import { existsSync as existsSync2 } from "fs";
@@ -2616,6 +2616,8 @@ function detectWebProject(cwd) {
 // src/cli/start.ts
 var PAID_TIER_DEFAULT_CHAT_MODEL = "gemini-3.1-pro-preview";
 var pendingProposalRequest = null;
+var pendingProposalMode = "atom";
+var pendingAnalysisToAtomRequest = null;
 function uiText(rich, plain) {
   return isTerminalSafeMode() ? plain : rich;
 }
@@ -3676,11 +3678,21 @@ async function runAgentMode(cwd, state) {
 async function handleAgentConversationInput(cwd, input) {
   const normalized = input.trim().toLowerCase();
   if (!normalized) return false;
+  if (pendingAnalysisToAtomRequest && isCreateAtomDirective(normalized)) {
+    const request = pendingAnalysisToAtomRequest;
+    pendingAnalysisToAtomRequest = null;
+    console.log(chalk5.dim("\n> Great. Creating a governed task from the approved analysis plan.\n"));
+    const { plan: plan3 } = await import("./plan-RHDFDSZE.js");
+    await plan3(request, { conversational: true });
+    await showLatestPlannedAtom(cwd);
+    console.log(chalk5.dim('\nReply "execute atom" when you want implementation to start, or tell me what to change.'));
+    return true;
+  }
   if (pendingProposalRequest && isPlanApprovalDirective(normalized)) {
     await applyApprovedProposal(cwd);
     return true;
   }
-  if (isContinuationDirective(normalized)) {
+  if (isExecutionDirective(normalized)) {
     await continueWithCurrentTask(cwd);
     return true;
   }
@@ -3689,6 +3701,10 @@ async function handleAgentConversationInput(cwd, input) {
     return true;
   }
   if (wantsProposalBeforeExecution(input)) {
+    if (shouldDoAnalysisBeforeAtom(input)) {
+      await provideAnalysisFirstPlan(cwd, input);
+      return true;
+    }
     await showProposalForApproval(input);
     return true;
   }
@@ -3706,7 +3722,7 @@ async function handleAgentConversationInput(cwd, input) {
     return true;
   }
   await showLatestPlannedAtom(cwd);
-  console.log(chalk5.dim('\nReply "continue" when you approve this plan, or tell me what to change.'));
+  console.log(chalk5.dim('\nReply "execute atom" when you want implementation to start, or tell me what to change.'));
   return true;
 }
 function isReadOnlyExploreRequest(input) {
@@ -3733,6 +3749,7 @@ function wantsProposalBeforeExecution(input) {
 }
 async function showProposalForApproval(input) {
   pendingProposalRequest = input.trim();
+  pendingProposalMode = shouldDoAnalysisBeforeAtom(input) ? "analysis" : "atom";
   console.log(chalk5.dim("\n> Understood. I will not create atoms yet.\n"));
   console.log(chalk5.bold("Proposed plan (for your approval):"));
   console.log(chalk5.dim("  1. Review project files and locate the capsule markdown/source for day 1."));
@@ -3766,18 +3783,32 @@ Showing latest planned atom (${latest.externalId})...
   const { show: show2 } = await import("./show-7A3FACN6.js");
   await show2(latest.externalId);
 }
-function isContinuationDirective(input) {
+function isPlanApprovalDirective(input) {
   const normalized = input.trim().toLowerCase();
-  return normalized === "continue" || normalized === "continue." || normalized === "go on" || normalized === "go ahead" || normalized === "next" || normalized === "proceed" || normalized === "do it";
+  return normalized === "approve" || normalized === "approve plan" || normalized === "approved" || normalized === "yes" || normalized === "yes, proceed" || normalized === "proceed";
 }
-function isPlanApprovalDirective(input) {
+function isExecutionDirective(input) {
   const normalized = input.trim().toLowerCase();
-  return normalized === "approve" || normalized === "approve plan" || normalized === "approved" || normalized === "yes" || normalized === "yes, proceed" || normalized === "proceed" || normalized === "continue" || normalized === "continue.";
+  return normalized === "execute" || normalized === "execute atom" || normalized === "run atom" || normalized === "run it now" || normalized === "implement now" || normalized === "start execution" || normalized === "go ahead and execute";
+}
+function isCreateAtomDirective(input) {
+  const normalized = input.trim().toLowerCase();
+  return normalized === "create atom" || normalized === "save this" || normalized === "make atom" || normalized === "save as atom" || normalized === "turn this into a task" || normalized === "create task";
+}
+function shouldDoAnalysisBeforeAtom(input) {
+  const normalized = input.toLowerCase();
+  const hasAnalysisIntent = /\b(review|analy[sz]e|inspect|read)\b/.test(normalized) && /\b(files?|folder|project|markdown|lesson|capsule)\b/.test(normalized);
+  const asksForPlan = /\b(let me know|what your plan is|plan is|how to implement|before creating|before you implement)\b/.test(normalized);
+  return hasAnalysisIntent && asksForPlan;
 }
 async function applyApprovedProposal(cwd) {
   const approvedRequest = pendingProposalRequest;
   if (!approvedRequest) return;
   pendingProposalRequest = null;
+  if (pendingProposalMode === "analysis") {
+    await provideAnalysisFirstPlan(cwd, approvedRequest);
+    return;
+  }
   console.log(chalk5.dim("\n> Great. I will create the task from your approved request.\n"));
   const { plan: plan2 } = await import("./plan-RHDFDSZE.js");
   await plan2(approvedRequest, { conversational: true });
@@ -3786,7 +3817,140 @@ async function applyApprovedProposal(cwd) {
     return;
   }
   await showLatestPlannedAtom(cwd);
-  console.log(chalk5.dim('\nReply "continue" when you approve this plan, or tell me what to change.'));
+  console.log(chalk5.dim('\nReply "execute atom" when you want implementation to start, or tell me what to change.'));
+}
+async function provideAnalysisFirstPlan(cwd, request) {
+  console.log(chalk5.dim("\n> I analyzed your request and generated a recommendation + sample draft first.\n"));
+  const markdownFiles = collectMarkdownFiles(cwd);
+  const dayOneCandidates = markdownFiles.filter((file) => isDayOnePath(file));
+  const capsuleCandidates = markdownFiles.filter((file) => /capsule/i.test(file));
+  const primaryCandidates = dayOneCandidates.length > 0 ? dayOneCandidates : capsuleCandidates;
+  const reviewedFiles = primaryCandidates.slice(0, 8);
+  const stats = computeContentStats(cwd, reviewedFiles);
+  const recommendSplit = stats.totalWords > 900 || stats.totalHeadings >= 6;
+  const capsuleCount = recommendSplit ? 2 : 1;
+  console.log(chalk5.bold("Analysis summary (no atoms created):"));
+  if (reviewedFiles.length === 0) {
+    console.log(chalk5.dim("  - I did not find obvious day-1 capsule markdown files automatically."));
+    console.log(chalk5.dim("  - Share the target file path and I will evaluate it directly."));
+  } else {
+    console.log(chalk5.dim("  Files reviewed:"));
+    for (const file of reviewedFiles) {
+      console.log(chalk5.dim(`    - ${file}`));
+    }
+    console.log(chalk5.dim(`  Content signals: ~${stats.totalWords} words, ${stats.totalHeadings} section headings.`));
+  }
+  console.log();
+  console.log(chalk5.bold("Recommendation:"));
+  if (reviewedFiles.length === 0) {
+    console.log(chalk5.dim("  I need the exact day-1 capsule file path to make a reliable one-vs-many capsule recommendation."));
+  } else if (recommendSplit) {
+    console.log(chalk5.dim(`  Split day 1 into ${capsuleCount} capsules for clarity and lower cognitive load.`));
+  } else {
+    console.log(chalk5.dim("  Keep day 1 as one capsule to preserve continuity and reduce context switching."));
+  }
+  console.log();
+  console.log(chalk5.bold("Implementation plan (proposed):"));
+  console.log(chalk5.dim("  1. Confirm target source file(s) for day 1 content."));
+  console.log(chalk5.dim(`  2. Define capsule boundaries and titles (${capsuleCount} capsule${capsuleCount > 1 ? "s" : ""}).`));
+  console.log(chalk5.dim("  3. Draft capsule markdown(s) with consistent template and learning objective per capsule."));
+  console.log(chalk5.dim("  4. Add index/manifest links and quick validation checks for user flow."));
+  const sampleDraft = buildSampleCapsuleDraft(cwd, reviewedFiles, capsuleCount);
+  if (sampleDraft) {
+    console.log();
+    console.log(chalk5.bold("Sample output for day 1 (draft):"));
+    console.log(sampleDraft);
+  }
+  pendingAnalysisToAtomRequest = request;
+  console.log();
+  console.log(chalk5.dim('Reply "save this" (or "create atom") if you want me to implement this in governed mode.'));
+}
+function collectMarkdownFiles(cwd) {
+  const results = [];
+  const queue = ["."];
+  const skipDirs = /* @__PURE__ */ new Set([".git", "node_modules", ".archon", "dist", "build", ".next", ".turbo"]);
+  while (queue.length > 0 && results.length < 200) {
+    const current = queue.shift();
+    if (!current) break;
+    const abs = join6(cwd, current);
+    let entries;
+    try {
+      entries = readdirSync3(abs, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const rel = current === "." ? entry.name : join6(current, entry.name);
+      if (entry.isDirectory()) {
+        if (!skipDirs.has(entry.name)) {
+          queue.push(rel);
+        }
+        continue;
+      }
+      if (entry.isFile() && entry.name.toLowerCase().endsWith(".md")) {
+        results.push(relative(cwd, join6(cwd, rel)).replace(/\\/g, "/"));
+      }
+    }
+  }
+  return results;
+}
+function computeContentStats(cwd, files) {
+  let totalWords = 0;
+  let totalHeadings = 0;
+  for (const relPath of files) {
+    try {
+      const content = readFileSync3(join6(cwd, relPath), "utf-8");
+      totalWords += content.split(/\s+/).filter(Boolean).length;
+      totalHeadings += content.split("\n").filter((line) => line.trim().startsWith("#")).length;
+    } catch {
+    }
+  }
+  return { totalWords, totalHeadings };
+}
+function isDayOnePath(path2) {
+  const normalized = path2.toLowerCase();
+  return /\b(day[-_ ]?0*1|lesson[-_ ]?0*1|email[-_ ]?day[-_ ]?0*1)\b/.test(normalized) && !/\b(day[-_ ]?(?:1[0-9]|[2-9])|lesson[-_ ]?(?:1[0-9]|[2-9]))\b/.test(normalized);
+}
+function buildSampleCapsuleDraft(cwd, files, capsuleCount) {
+  if (files.length === 0) return null;
+  const primary = files[0];
+  if (!primary) return null;
+  let content = "";
+  try {
+    content = readFileSync3(join6(cwd, primary), "utf-8");
+  } catch {
+    return null;
+  }
+  const lines = content.split("\n").map((line) => line.trim());
+  const heading = lines.find((line) => line.startsWith("#"))?.replace(/^#+\s*/, "") || "Day 1 Lesson";
+  const paragraphs = content.split("\n\n").map((p) => p.replace(/\s+/g, " ").trim()).filter((p) => p.length > 40 && !p.startsWith("#") && !p.startsWith("- ") && !p.startsWith("* "));
+  const objective = paragraphs[0] ?? "Introduce the day-1 core idea with a clear, practical framing.";
+  const concept = paragraphs[1] ?? "Explain the key concept in plain language with one relatable example.";
+  const practice = paragraphs[2] ?? "Give one guided prompt so the learner can apply the idea immediately.";
+  if (capsuleCount <= 1) {
+    return [
+      chalk5.dim("  ---"),
+      chalk5.dim(`  title: "${heading} - Core Capsule"`),
+      chalk5.dim('  type: "lesson_capsule"'),
+      chalk5.dim("  day: 1"),
+      chalk5.dim("  ---"),
+      chalk5.dim("  ## Objective"),
+      chalk5.dim(`  ${objective}`),
+      chalk5.dim("  ## Core Concept"),
+      chalk5.dim(`  ${concept}`),
+      chalk5.dim("  ## Practice"),
+      chalk5.dim(`  ${practice}`)
+    ].join("\n");
+  }
+  return [
+    chalk5.dim("  Capsule 1: Foundation"),
+    chalk5.dim(`  - Objective: ${objective}`),
+    chalk5.dim(`  - Core Concept: ${concept}`),
+    chalk5.dim(""),
+    chalk5.dim("  Capsule 2: Application"),
+    chalk5.dim(`  - Guided Practice: ${practice}`),
+    chalk5.dim("  - Reflection Prompt: What changed in your understanding after this exercise?")
+  ].join("\n");
 }
 async function continueWithCurrentTask(cwd) {
   const { listLocalAtoms: listLocalAtoms2 } = await import("./plan-RHDFDSZE.js");
@@ -3922,6 +4086,10 @@ function containsActionIntent(input) {
 async function handlePostExploreAction(cwd, request, options = {}) {
   const sourceInput = options.originalInput?.trim() || request;
   if (wantsProposalBeforeExecution(sourceInput)) {
+    if (shouldDoAnalysisBeforeAtom(sourceInput)) {
+      await provideAnalysisFirstPlan(cwd, sourceInput);
+      return;
+    }
     await showProposalForApproval(sourceInput);
     return;
   }
@@ -3944,7 +4112,7 @@ async function handlePostExploreAction(cwd, request, options = {}) {
       return;
     }
     await showLatestPlannedAtom(cwd);
-    console.log(chalk5.dim('\nReply "continue" when you approve this plan, or tell me what to change.'));
+    console.log(chalk5.dim('\nReply "execute atom" when you want implementation to start, or tell me what to change.'));
   }
 }
 async function planTask() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archondev",
-  "version": "2.19.29",
+  "version": "2.19.31",
   "description": "Local-first AI-powered development governance system",
   "main": "dist/index.js",
   "bin": {