@yemi33/minions 0.1.898 → 0.1.900

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.1.900 (2026-04-12)
+
+### Other
+- chore(dashboard): remove dashboard.html monolith, fragments are canonical (closes #932) (#942)
+
+## 0.1.899 (2026-04-12)
+
+### Fixes
+- add backward-scan in syncPrdItemStatus to re-open done work items on PRD reset (closes #929) (#940)
+
 ## 0.1.898 (2026-04-12)
 
 ### Fixes

package/dashboard-build.js

@@ -14,7 +14,7 @@ function buildDashboardHtml() {
   const layoutPath = path.join(dashDir, 'layout.html');
 
   if (!fs.existsSync(layoutPath)) {
-    return safeRead(path.join(MINIONS_DIR, 'dashboard.html')) || '';
+    throw new Error(`Dashboard layout not found: ${layoutPath}. The dashboard/ directory must exist.`);
   }
 
   const layout = safeRead(layoutPath);

package/dashboard.js

@@ -62,14 +62,13 @@ function resolvePlanPath(file) {
   return active;
 }
 
-// Assemble dashboard HTML from fragments (or fall back to monolith)
+// Assemble dashboard HTML from fragments (canonical source: dashboard/)
 function buildDashboardHtml() {
   const dashDir = path.join(MINIONS_DIR, 'dashboard');
   const layoutPath = path.join(dashDir, 'layout.html');
 
-  // Fall back to monolith if fragments don't exist
   if (!fs.existsSync(layoutPath)) {
-    return safeRead(path.join(MINIONS_DIR, 'dashboard.html')) || '';
+    throw new Error(`Dashboard layout not found: ${layoutPath}. The dashboard/ directory must exist.`);
   }
 
   const layout = safeRead(layoutPath);

package/docs/command-center.md

@@ -148,7 +148,7 @@ Frontend
 | `engine/shared.js` | `parseStreamJsonOutput()` extracts `sessionId` from result |
 | `engine/cc-session.json` | Persisted session state (sessionId, turnCount, timestamps) |
 | `dashboard.js` | CC endpoint, `buildCCStatePreamble()`, `ccDocCall()`, `parseCCActions()` |
-| `dashboard.html` | Frontend: localStorage persistence, session indicator, New Session button |
+| `dashboard/js/` | Frontend: localStorage persistence, session indicator, New Session button |
 
 ## Command Bar
 

package/docs/distribution.md

@@ -31,7 +31,7 @@ These files are removed during sync to personal:
 
 Controlled by the `files` field in `package.json`:
 - `bin/minions.js` — CLI entry point
-- `engine.js`, `dashboard.js`, `dashboard.html`, `minions.js` — core scripts
+- `engine.js`, `dashboard.js`, `dashboard/` (fragments), `minions.js` — core scripts
 - `engine/spawn-agent.js`, `engine/ado-mcp-wrapper.js` — engine helpers
 - `agents/*/charter.md` — agent role definitions
 - `playbooks/*.md` — task templates

package/engine/lifecycle.js

@@ -8,7 +8,7 @@ const path = require('path');
 const os = require('os');
 const shared = require('./shared');
 const { safeRead, safeJson, safeWrite, mutateJsonFileLocked, mutateWorkItems, execSilent, execAsync, projectPrPath, getPrLinks, addPrLink,
-  log, ts, dateStamp, WI_STATUS, DONE_STATUSES, PLAN_TERMINAL_STATUSES, WORK_TYPE, PLAN_STATUS, PR_STATUS, DISPATCH_RESULT,
+  log, ts, dateStamp, WI_STATUS, DONE_STATUSES, PLAN_TERMINAL_STATUSES, WORK_TYPE, PLAN_STATUS, PRD_ITEM_STATUS, PR_STATUS, DISPATCH_RESULT,
   ENGINE_DEFAULTS, DEFAULT_AGENT_METRICS, FAILURE_CLASS } = shared;
 const { trackEngineUsage } = require('./llm');
 const queries = require('./queries');
@@ -637,6 +637,52 @@ function syncPrdItemStatus(itemId, status, sourcePlan) {
   } catch (err) { log('warn', `PRD status sync: ${err.message}`); }
 }
 
+// ─── PRD Backward-Scan Reconciliation (#929) ────────────────────────────────
+// Proactive counterpart to syncPrdItemStatus. Scans all active PRDs and promotes
+// "missing" items to "updated" when a done work item already exists for that ID.
+// This catches cases where a PRD regeneration incorrectly sets items to "missing"
+// and no subsequent work item state change triggers the reactive sync.
+
+function reconcilePrdStatuses(config) {
+  if (!fs.existsSync(PRD_DIR)) return;
+  let prdFiles;
+  try { prdFiles = fs.readdirSync(PRD_DIR).filter(f => f.endsWith('.json')); } catch { return; }
+  if (prdFiles.length === 0) return;
+
+  const allWorkItems = queries.getWorkItems(config);
+  if (allWorkItems.length === 0) return;
+
+  // Index done work items by ID for O(1) lookup
+  const doneWiById = new Map();
+  for (const wi of allWorkItems) {
+    if (wi.id && DONE_STATUSES.has(wi.status)) doneWiById.set(wi.id, wi);
+  }
+  if (doneWiById.size === 0) return;
+
+  for (const file of prdFiles) {
+    try {
+      const fpath = path.join(PRD_DIR, file);
+      const plan = safeJson(fpath);
+      if (!plan?.missing_features) continue;
+      // Skip completed/archived PRDs — no reconciliation needed
+      if (plan.status === PLAN_STATUS.COMPLETED) continue;
+
+      let modified = false;
+      for (const feature of plan.missing_features) {
+        if (feature.status === PRD_ITEM_STATUS.MISSING && doneWiById.has(feature.id)) {
+          feature.status = PRD_ITEM_STATUS.UPDATED;
+          modified = true;
+          log('info', `PRD backward-scan: promoted ${feature.id} from missing→updated in ${file} (done work item exists)`);
+        }
+      }
+
+      if (modified) {
+        safeWrite(fpath, plan);
+      }
+    } catch (err) { log('warn', `PRD backward-scan for ${file}: ${err.message}`); }
+  }
+}
+
 // ─── PR Sync from Output ─────────────────────────────────────────────────────
 
 function syncPrsFromOutput(output, agentId, meta, config) {
@@ -1876,6 +1922,7 @@ module.exports = {
   cleanupPlanWorktrees,
   updateWorkItemStatus,
   syncPrdItemStatus,
+  reconcilePrdStatuses,
   syncPrsFromOutput,
   updatePrAfterReview,
   updatePrAfterFix,

package/engine.js

@@ -135,7 +135,7 @@ const { renderPlaybook, validatePlaybookVars, PLAYBOOK_REQUIRED_VARS,
 
 // ─── Lifecycle (extracted to engine/lifecycle.js) ────────────────────────────
 
-const { runPostCompletionHooks, updateWorkItemStatus, syncPrdItemStatus, handlePostMerge, checkPlanCompletion,
+const { runPostCompletionHooks, updateWorkItemStatus, syncPrdItemStatus, reconcilePrdStatuses, handlePostMerge, checkPlanCompletion,
   syncPrsFromOutput, updatePrAfterReview, updatePrAfterFix, checkForLearnings, extractSkillsFromOutput,
   updateAgentHistory, updateMetrics, createReviewFeedbackForAuthor, parseAgentOutput, syncPrdFromPrs,
   isItemCompleted, classifyFailure, processPendingRebases } = require('./engine/lifecycle');
@@ -2692,6 +2692,7 @@ async function discoverWork(config) {
 
   // Side-effect passes: materialize plans and design docs into work-items.json
   // These write to project work queues — picked up by discoverFromWorkItems below.
+  reconcilePrdStatuses(config); // Backward-scan: correct "missing" PRD items that have done work items (#929)
   materializePlansAsWorkItems(config);
 
   for (const project of projects) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yemi33/minions",
-  "version": "0.1.898",
+  "version": "0.1.900",
   "description": "Multi-agent AI dev team that runs from ~/.minions/ — five autonomous agents share a single engine, dashboard, and knowledge base",
   "bin": {
     "minions": "bin/minions.js"

package/prompts/cc-system.md

@@ -2,7 +2,7 @@ You are the Command Center AI for "Minions" — a multi-agent software engineeri
 You have full CLI power (read, write, edit, shell, builds) plus minions-specific actions to delegate work to agents.
 
 ## Guardrails
-READ ONLY — never write/edit: `engine.js`, `engine/*.js`, `dashboard.js`, `dashboard.html`, `minions.js`, `bin/*.js`, `engine/control.json`, `engine/dispatch.json`, `config.json`.
+READ ONLY — never write/edit: `engine.js`, `engine/*.js`, `dashboard.js`, `dashboard/**`, `minions.js`, `bin/*.js`, `engine/control.json`, `engine/dispatch.json`, `config.json`.
 CAN modify: notes, plans, knowledge, work items, pull-requests.json, routing.md, charters, skills, playbooks, project repos.
 
 ## Filesystem