npm - @jakkrichm/create-nexus-devflow - Versions diffs - 2.0.27 → 2.2.0 - Mend

@jakkrichm/create-nexus-devflow 2.0.27 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (104) hide show

package/README.md +29 -7
package/dist/bin/create-nexus-devflow.d.ts +5 -1
package/dist/bin/create-nexus-devflow.js +247 -4
package/dist/bin/create-nexus-devflow.js.map +1 -1
package/dist/lib/branch-context.d.ts +39 -0
package/dist/lib/branch-context.js +196 -0
package/dist/lib/branch-context.js.map +1 -0
package/dist/lib/code-graph.d.ts +30 -0
package/dist/lib/code-graph.js +209 -0
package/dist/lib/code-graph.js.map +1 -0
package/dist/lib/context-slicer.d.ts +31 -0
package/dist/lib/context-slicer.js +234 -0
package/dist/lib/context-slicer.js.map +1 -0
package/dist/lib/current-work.js +4 -2
package/dist/lib/current-work.js.map +1 -1
package/dist/lib/dashboard-page.d.ts +1 -1
package/dist/lib/dashboard-page.js +140 -56
package/dist/lib/dashboard-page.js.map +1 -1
package/dist/lib/dashboard-snapshot.d.ts +13 -0
package/dist/lib/dashboard-snapshot.js +24 -6
package/dist/lib/dashboard-snapshot.js.map +1 -1
package/dist/lib/dashboard.js +38 -0
package/dist/lib/dashboard.js.map +1 -1
package/dist/lib/drift-reconciler.d.ts +38 -0
package/dist/lib/drift-reconciler.js +155 -0
package/dist/lib/drift-reconciler.js.map +1 -0
package/dist/lib/gatekeeper.d.ts +1 -0
package/dist/lib/gatekeeper.js +30 -1
package/dist/lib/gatekeeper.js.map +1 -1
package/dist/lib/git-hooks.js +41 -16
package/dist/lib/git-hooks.js.map +1 -1
package/dist/lib/ide-extension.d.ts +38 -0
package/dist/lib/ide-extension.js +61 -0
package/dist/lib/ide-extension.js.map +1 -0
package/dist/lib/mcp.d.ts +36 -0
package/dist/lib/mcp.js +653 -0
package/dist/lib/mcp.js.map +1 -0
package/dist/lib/project-metadata.d.ts +1 -1
package/dist/lib/project-metadata.js +3 -2
package/dist/lib/project-metadata.js.map +1 -1
package/dist/lib/status.d.ts +1 -1
package/dist/lib/status.js +4 -4
package/dist/lib/status.js.map +1 -1
package/dist/lib/swarm-orchestrator.d.ts +31 -0
package/dist/lib/swarm-orchestrator.js +134 -0
package/dist/lib/swarm-orchestrator.js.map +1 -0
package/dist/lib/update.js +7 -3
package/dist/lib/update.js.map +1 -1
package/dist/lib/webview-studio.d.ts +8 -0
package/dist/lib/webview-studio.js +463 -0
package/dist/lib/webview-studio.js.map +1 -0
package/dist/lib/workflow-state.js +24 -8
package/dist/lib/workflow-state.js.map +1 -1
package/package.json +1 -1
package/template/.agents/skills/adopt/SKILL.md +58 -5
package/template/.agents/skills/doctor/SKILL.md +23 -16
package/template/.agents/skills/implement/SKILL.md +2 -2
package/template/.agents/skills/onboard/SKILL.md +18 -17
package/template/.agents/skills/rollback/SKILL.md +1 -1
package/template/.claude/skills/00-explore/SKILL.md +2 -2
package/template/.claude/skills/10-define/SKILL.md +2 -2
package/template/.claude/skills/20-spec/SKILL.md +1 -2
package/template/.claude/skills/30-plan/SKILL.md +1 -2
package/template/.claude/skills/40-execute/SKILL.md +2 -2
package/template/.claude/skills/50-verify/SKILL.md +2 -2
package/template/.claude/skills/60-report/SKILL.md +2 -2
package/template/.claude/skills/70-deliver/SKILL.md +2 -2
package/template/.claude/skills/adopt/SKILL.md +191 -75
package/template/.claude/skills/audit/SKILL.md +267 -133
package/template/.claude/skills/autopilot/SKILL.md +226 -167
package/template/.claude/skills/brainstorm/SKILL.md +62 -0
package/template/.claude/skills/brief/SKILL.md +93 -92
package/template/.claude/skills/check/SKILL.md +96 -76
package/template/.claude/skills/ci/SKILL.md +140 -61
package/template/.claude/skills/complete/SKILL.md +156 -101
package/template/.claude/skills/convert-any-to-md/SKILL.md +2 -2
package/template/.claude/skills/convert-any-to-md/references/setup.md +29 -0
package/template/.claude/skills/convert-any-to-md/scripts/convert_any_to_md.py +487 -0
package/template/.claude/skills/convert-any-to-md/scripts/requirements.txt +3 -0
package/template/.claude/skills/debug/SKILL.md +124 -49
package/template/.claude/skills/devflow/SKILL.md +9 -3
package/template/.claude/skills/discovery/SKILL.md +150 -129
package/template/.claude/skills/doctor/SKILL.md +195 -72
package/template/.claude/skills/feature/SKILL.md +195 -151
package/template/.claude/skills/fix/SKILL.md +41 -90
package/template/.claude/skills/idea/SKILL.md +2 -2
package/template/.claude/skills/implement/SKILL.md +189 -46
package/template/.claude/skills/onboard/SKILL.md +216 -85
package/template/.claude/skills/overview/SKILL.md +44 -29
package/template/.claude/skills/prototype/SKILL.md +82 -27
package/template/.claude/skills/release/SKILL.md +119 -130
package/template/.claude/skills/report-html/SKILL.md +2 -2
package/template/.claude/skills/rollback/SKILL.md +123 -77
package/template/.claude/skills/status/SKILL.md +109 -0
package/template/.claude/skills/test/SKILL.md +2 -2
package/template/.claude/skills/tests/SKILL.md +126 -0
package/template/.claude/skills/try/SKILL.md +77 -65
package/template/AGENTS.md +2 -1
package/template/devflow/build-plan.md +50 -20
package/template/devflow/history/features/README.md +5 -0
package/template/devflow/history/fixes/README.md +5 -0
package/template/devflow/history/rollbacks/README.md +5 -0
package/template/devflow/project-plan.md +70 -18
package/template/devflow/reference/studio.html +504 -0

package/dist/lib/webview-studio.js ADDED Viewed

@@ -0,0 +1,463 @@
+import { readDashboardSnapshot } from "./dashboard-snapshot.js";
+import { evaluateGate } from "./gatekeeper.js";
+import { detectGitDrift } from "./drift-reconciler.js";
+import { readIdeas } from "./ideas.js";
+/**
+ * Escapes HTML characters safely.
+ */
+function escapeHtml(str) {
+    if (!str)
+        return "";
+    return String(str)
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#039;");
+}
+/**
+ * Renders a self-contained, interactive Webview Studio HTML page.
+ */
+export async function renderStudioHtml(projectRoot, options = {}) {
+    const snapshot = await readDashboardSnapshot(projectRoot);
+    const gateReport = await evaluateGate(projectRoot, { strict: false });
+    const driftReport = await detectGitDrift(projectRoot);
+    const ideas = await readIdeas(projectRoot);
+    const status = snapshot.status;
+    const currentWork = status.currentWork;
+    const projectName = status.project.name || "Nexus-DevFlow Project";
+    const branch = status.git.branch || "main";
+    const nextActionCmd = typeof status.nextAction === "string" ? status.nextAction : status.nextAction?.command || "/feature";
+    const track = snapshot.workflow.track || (currentWork.state === "active" ? "fast" : "idle");
+    const isGatePassed = gateReport.passed;
+    const gatePillClass = isGatePassed ? "badge-pass" : "badge-blocked";
+    const gatePillText = isGatePassed ? "✔ Gate Passed" : "✖ Gate Blocked";
+    const ideasHtml = ideas.pending.length > 0
+        ? ideas.pending.map((idea) => `
+        <div class="card-item idea-item">
+          <div class="item-header">
+            <span class="badge-id">${escapeHtml(idea.id)}</span>
+            <span class="item-title">${escapeHtml(idea.title || idea.rawInput.slice(0, 40))}</span>
+          </div>
+          <div class="item-tags">
+            <span class="tag tag-feasibility">${escapeHtml(idea.feasibility || "Feasible")}</span>
+            <span class="tag tag-value">${escapeHtml(idea.value || "Value: High")}</span>
+          </div>
+        </div>
+      `).join("")
+        : `<div class="empty-state">No pending ideas in inbox. Use <code>nexus-devflow idea add</code></div>`;
+    const historyHtml = snapshot.history.items.length > 0
+        ? snapshot.history.items.slice(0, 8).map((item) => {
+            const runId = item.buildPlanItem || item.file.replace(/\.md$/, "");
+            return `
+          <div class="card-item history-item">
+            <div class="item-header">
+              <span class="badge-id badge-history">${escapeHtml(runId)}</span>
+              <span class="item-title">${escapeHtml(item.title)}</span>
+            </div>
+            <div class="item-meta">
+              <span class="tag tag-cat">${escapeHtml(item.type)}</span>
+            </div>
+          </div>
+        `;
+        }).join("")
+        : `<div class="empty-state">No archived history records yet.</div>`;
+    const completedCount = currentWork.completed;
+    const totalTasks = currentWork.total;
+    const progressPercent = totalTasks > 0 ? Math.round((completedCount / totalTasks) * 100) : 0;
+    return `<!DOCTYPE html>
+<html lang="th" data-theme="${options.theme || "auto"}">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Nexus-DevFlow Studio: ${escapeHtml(projectName)}</title>
+  <style>
+    :root {
+      --bg: var(--vscode-editor-background, #090d16);
+      --bg-panel: var(--vscode-sideBar-background, rgba(17, 24, 39, 0.75));
+      --bg-card: rgba(30, 41, 59, 0.6);
+      --border: var(--vscode-panel-border, rgba(255, 255, 255, 0.08));
+      --border-accent: rgba(56, 189, 248, 0.3);
+      --fg: var(--vscode-editor-foreground, #f8fafc);
+      --fg-muted: var(--vscode-descriptionForeground, #94a3b8);
+      --accent: #38bdf8;
+      --accent-gradient: linear-gradient(135deg, #38bdf8 0%, #818cf8 100%);
+      --green: #4ade80;
+      --yellow: #facc15;
+      --red: #f87171;
+      --font-mono: var(--vscode-editor-font-family, 'Fira Code', Consolas, monospace);
+      --font-sans: var(--vscode-font-family, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif);
+    }
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      font-family: var(--font-sans);
+      background-color: var(--bg);
+      color: var(--fg);
+      padding: 16px;
+      line-height: 1.5;
+      font-size: 13px;
+      overflow-x: hidden;
+    }
+    .studio-container {
+      max-width: 1200px;
+      margin: 0 auto;
+      display: flex;
+      flex-direction: column;
+      gap: 16px;
+    }
+    /* Top Studio Header */
+    .studio-header {
+      background: var(--bg-panel);
+      backdrop-filter: blur(12px);
+      border: 1px solid var(--border);
+      border-radius: 12px;
+      padding: 16px 20px;
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      flex-wrap: wrap;
+      gap: 12px;
+    }
+    .header-left {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+    }
+    .project-badge {
+      font-weight: 700;
+      font-size: 16px;
+      background: var(--accent-gradient);
+      -webkit-background-clip: text;
+      -webkit-text-fill-color: transparent;
+      letter-spacing: -0.5px;
+    }
+    .branch-pill {
+      font-family: var(--font-mono);
+      font-size: 12px;
+      background: rgba(56, 189, 248, 0.12);
+      color: var(--accent);
+      padding: 3px 10px;
+      border-radius: 20px;
+      border: 1px solid var(--border-accent);
+    }
+    .header-right {
+      display: flex;
+      align-items: center;
+      gap: 10px;
+    }
+    .badge-pass {
+      background: rgba(74, 222, 128, 0.15);
+      color: var(--green);
+      border: 1px solid rgba(74, 222, 128, 0.3);
+      padding: 4px 12px;
+      border-radius: 20px;
+      font-weight: 600;
+    }
+    .badge-blocked {
+      background: rgba(248, 113, 113, 0.15);
+      color: var(--red);
+      border: 1px solid rgba(248, 113, 113, 0.3);
+      padding: 4px 12px;
+      border-radius: 20px;
+      font-weight: 600;
+    }
+    /* Quick Action Dispatcher */
+    .action-bar {
+      background: var(--bg-panel);
+      border: 1px solid var(--border);
+      border-radius: 10px;
+      padding: 12px 16px;
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      overflow-x: auto;
+    }
+    .action-label {
+      font-weight: 600;
+      color: var(--fg-muted);
+      font-size: 11px;
+      text-transform: uppercase;
+      margin-right: 4px;
+      white-space: nowrap;
+    }
+    .btn-action {
+      background: var(--bg-card);
+      border: 1px solid var(--border);
+      color: var(--fg);
+      padding: 5px 12px;
+      border-radius: 6px;
+      cursor: pointer;
+      font-family: var(--font-mono);
+      font-size: 12px;
+      transition: all 0.2s ease;
+      white-space: nowrap;
+    }
+    .btn-action:hover {
+      background: rgba(56, 189, 248, 0.15);
+      border-color: var(--accent);
+      color: var(--accent);
+    }
+    .btn-action.btn-primary {
+      background: var(--accent-gradient);
+      color: #040812;
+      font-weight: 700;
+      border: none;
+    }
+    /* 3-Pillars Kanban Grid */
+    .kanban-grid {
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));
+      gap: 16px;
+    }
+    .kanban-col {
+      background: var(--bg-panel);
+      border: 1px solid var(--border);
+      border-radius: 12px;
+      padding: 16px;
+      display: flex;
+      flex-direction: column;
+      gap: 12px;
+    }
+    .col-header {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      border-bottom: 1px solid var(--border);
+      padding-bottom: 10px;
+    }
+    .col-title {
+      font-size: 13px;
+      font-weight: 700;
+      display: flex;
+      align-items: center;
+      gap: 6px;
+    }
+    .col-count {
+      font-size: 11px;
+      background: var(--bg-card);
+      padding: 2px 8px;
+      border-radius: 10px;
+      color: var(--fg-muted);
+    }
+    .col-content {
+      display: flex;
+      flex-direction: column;
+      gap: 10px;
+      max-height: 480px;
+      overflow-y: auto;
+    }
+    /* Card Items */
+    .card-item {
+      background: var(--bg-card);
+      border: 1px solid var(--border);
+      border-radius: 8px;
+      padding: 12px;
+      display: flex;
+      flex-direction: column;
+      gap: 6px;
+      transition: transform 0.15s ease, border-color 0.15s ease;
+    }
+    .card-item:hover {
+      border-color: var(--border-accent);
+      transform: translateY(-1px);
+    }
+    .card-item.active-item {
+      border-color: var(--accent);
+      box-shadow: 0 0 12px rgba(56, 189, 248, 0.15);
+    }
+    .item-header {
+      display: flex;
+      align-items: flex-start;
+      gap: 8px;
+    }
+    .badge-id {
+      font-family: var(--font-mono);
+      font-size: 10px;
+      font-weight: 700;
+      background: rgba(56, 189, 248, 0.2);
+      color: var(--accent);
+      padding: 2px 6px;
+      border-radius: 4px;
+      white-space: nowrap;
+    }
+    .badge-history {
+      background: rgba(129, 140, 248, 0.2);
+      color: #818cf8;
+    }
+    .item-title {
+      font-weight: 600;
+      font-size: 12px;
+      flex: 1;
+    }
+    /* Progress bar */
+    .progress-bar-container {
+      background: rgba(0, 0, 0, 0.3);
+      height: 6px;
+      border-radius: 3px;
+      overflow: hidden;
+      margin-top: 4px;
+    }
+    .progress-bar-fill {
+      background: var(--accent-gradient);
+      height: 100%;
+      transition: width 0.3s ease;
+    }
+    .item-tags, .item-meta {
+      display: flex;
+      align-items: center;
+      gap: 6px;
+      font-size: 11px;
+      color: var(--fg-muted);
+    }
+    .tag {
+      font-size: 10px;
+      padding: 1px 6px;
+      border-radius: 4px;
+      background: rgba(255, 255, 255, 0.05);
+    }
+    .tag-feasibility { color: var(--green); }
+    .tag-value { color: var(--accent); }
+    .tag-cat { color: var(--yellow); }
+    .empty-state {
+      text-align: center;
+      padding: 24px;
+      color: var(--fg-muted);
+      font-size: 12px;
+    }
+    /* Pulse Notification */
+    .pulse-panel {
+      background: var(--bg-panel);
+      border: 1px solid var(--border);
+      border-radius: 10px;
+      padding: 12px 16px;
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      font-size: 12px;
+    }
+  </style>
+</head>
+<body>
+  <div class="studio-container">
+    <!-- Top Header -->
+    <header class="studio-header">
+      <div class="header-left">
+        <span class="project-badge">⚡ ${escapeHtml(projectName)}</span>
+        <span class="branch-pill">🌿 ${escapeHtml(branch)}</span>
+        <span class="badge-track">Track: ${escapeHtml(track)}</span>
+      </div>
+      <div class="header-right">
+        <span class="${gatePillClass}">${gatePillText}</span>
+        <button class="btn-action btn-primary" onclick="dispatchCommand('${escapeHtml(nextActionCmd)}')">
+          Next: ${escapeHtml(nextActionCmd)}
+        </button>
+      </div>
+    </header>
+    <!-- Quick Action Bar -->
+    <div class="action-bar">
+      <span class="action-label">Quick Actions:</span>
+      <button class="btn-action" onclick="dispatchCommand('/feature')">/feature</button>
+      <button class="btn-action" onclick="dispatchCommand('/implement')">/implement</button>
+      <button class="btn-action" onclick="dispatchCommand('/check')">/check</button>
+      <button class="btn-action" onclick="dispatchCommand('/complete')">/complete</button>
+      <button class="btn-action" onclick="dispatchCommand('nexus-devflow slice --stage implement')">slice</button>
+      <button class="btn-action" onclick="dispatchCommand('nexus-devflow drift')">drift</button>
+      <button class="btn-action" onclick="dispatchCommand('nexus-devflow reconcile --fix')">reconcile</button>
+      <button class="btn-action" onclick="dispatchCommand('nexus-devflow doctor')">doctor</button>
+    </div>
+    <!-- 3-Pillars Kanban View -->
+    <main class="kanban-grid">
+      <!-- 🔮 1. Future (Ideas Inbox) -->
+      <section class="kanban-col">
+        <div class="col-header">
+          <span class="col-title">🔮 Future (Ideas Inbox)</span>
+          <span class="col-count">${ideas.pending.length}</span>
+        </div>
+        <div class="col-content">
+          ${ideasHtml}
+        </div>
+      </section>
+      <!-- ⚡ 2. Present (Active Living Context) -->
+      <section class="kanban-col">
+        <div class="col-header">
+          <span class="col-title">⚡ Present (Active Living Spec)</span>
+          <span class="col-count">${completedCount}/${totalTasks} Tasks</span>
+        </div>
+        <div class="col-content">
+          ${currentWork.state === "active" ? `
+            <div class="card-item active-item">
+              <div class="item-header">
+                <span class="badge-id">${escapeHtml(currentWork.runId || "ACTIVE")}</span>
+                <span class="item-title">${escapeHtml(currentWork.title || "Active Spec")}</span>
+              </div>
+              <div class="progress-bar-container">
+                <div class="progress-bar-fill" style="width: ${progressPercent}%;"></div>
+              </div>
+              <div class="item-meta">
+                <span>Progress: ${progressPercent}%</span>
+                <span>Remaining: ${currentWork.remaining} task(s)</span>
+              </div>
+            </div>
+          ` : `
+            <div class="empty-state">
+              Idle workspace.<br>Run <code>/feature</code> or <code>/fix</code> to start a run.
+            </div>
+          `}
+        </div>
+      </section>
+      <!-- 📦 3. Past (Release History Archive) -->
+      <section class="kanban-col">
+        <div class="col-header">
+          <span class="col-title">📦 Past (History Archives)</span>
+          <span class="col-count">${snapshot.history.total} Releases</span>
+        </div>
+        <div class="col-content">
+          ${historyHtml}
+        </div>
+      </section>
+    </main>
+    <!-- Bottom Pulse -->
+    <footer class="pulse-panel">
+      <div>Findings Blockers: <strong>${gateReport.findingsBlockers}</strong> | Total Findings: <strong>${status.findings.total}</strong></div>
+      <div>Git Drift: <strong>${driftReport.hasDrift ? "⚠ Drift Detected" : "✔ In Sync"}</strong></div>
+    </footer>
+  </div>
+  <script>
+    function dispatchCommand(cmd) {
+      if (window.acquireVsCodeApi) {
+        const vscode = window.acquireVsCodeApi();
+        vscode.postMessage({ command: 'exec', text: cmd });
+      } else if (navigator.clipboard) {
+        navigator.clipboard.writeText(cmd);
+        alert('Copied command to clipboard: ' + cmd);
+      }
+    }
+  </script>
+</body>
+</html>`;
+}
+//# sourceMappingURL=webview-studio.js.map

package/dist/lib/webview-studio.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"webview-studio.js","sourceRoot":"","sources":["../../lib/webview-studio.ts"],"names":[],"mappings":"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"}

package/dist/lib/workflow-state.js CHANGED Viewed

@@ -31,19 +31,22 @@ function parseWorkflowState(markdown, currentWork) {
     const lastCompletedRun = nullableField(markdown, "Last Completed Run");
     const lastUpdated = nullableField(markdown, "Last Updated");
     const deepStage = normalizeDeepStage(rawStage);
+    const fastStageFromMarkdown = normalizeFastStage(rawStage);
     let track = "idle";
     let currentStage = null;
-    if (explicitTrack === "deep") {
+    const isIdle = explicitTrack === "idle" ||
+        (rawStage === null && currentWork.state === "idle" && !activeRunId && !activeDiscoveryId);
+    if (isIdle) {
+        track = "idle";
+        currentStage = null;
+    }
+    else if (explicitTrack === "deep") {
         track = "deep";
         currentStage = deepStage || (activeDiscoveryId ? "00-explore" : "10-define");
     }
     else if (explicitTrack === "fast") {
         track = "fast";
-        currentStage = fastStage(currentWork);
-    }
-    else if (explicitTrack === "idle") {
-        track = "idle";
-        currentStage = null;
+        currentStage = fastStageFromMarkdown || fastStage(currentWork);
     }
     else if (activeRunId && deepStage) {
         track = "deep";
@@ -55,7 +58,7 @@ function parseWorkflowState(markdown, currentWork) {
     }
     else if (currentWork.state === "active") {
         track = currentWork.type === "stage" ? "deep" : "fast";
-        currentStage = track === "deep" ? deepStage || "40-execute" : fastStage(currentWork);
+        currentStage = track === "deep" ? deepStage || "40-execute" : fastStageFromMarkdown || fastStage(currentWork);
     }
     return {
         track,
@@ -83,8 +86,21 @@ function normalizeDeepStage(value) {
     const direct = value.match(/\b(00-explore|10-define|20-spec|30-plan|40-execute|50-verify|60-report|70-deliver)\b/i)?.[1];
     return (handoff || direct || "").toLowerCase() || null;
 }
+function normalizeFastStage(value) {
+    if (!value)
+        return null;
+    const match = value.match(/\b(feature|fix|feature-fix|implement|check|complete)\b/i)?.[1];
+    if (!match)
+        return null;
+    const normalized = match.toLowerCase();
+    if (normalized === "feature" || normalized === "fix")
+        return "feature-fix";
+    return normalized;
+}
 function fastStage(work) {
-    if (work.total === 0)
+    if (work.state === "idle")
+        return "feature-fix";
+    if (work.completed === 0 && work.total > 0)
         return "implement";
     return work.remaining > 0 ? "implement" : "check";
 }

package/dist/lib/workflow-state.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"workflow-state.js","sourceRoot":"","sources":["../../lib/workflow-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAyB7B,MAAM,WAAW,GAAG,CAAC,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AAC/E,MAAM,WAAW,GAAG;IAClB,YAAY;IACZ,WAAW;IACX,SAAS;IACT,SAAS;IACT,YAAY;IACZ,WAAW;IACX,WAAW;IACX,YAAY;CACJ,CAAC;AAEX,KAAK,UAAU,iBAAiB,CAC9B,WAAmB,EACnB,WAA8B;IAE9B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;IACnF,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,YAAY,CAAC,KAAK,CAAC,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;IACpD,CAAC;IAED,OAAO,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,kBAAkB,CACzB,QAAgB,EAChB,WAA8B;IAE9B,MAAM,aAAa,GAAG,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACtE,MAAM,iBAAiB,GAAG,aAAa,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,aAAa,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,aAAa,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAAG,aAAa,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,aAAa,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;~~IAE~~/C,IAAI,KAAK,GAAkB,MAAM,CAAC;IAClC,IAAI,YAAY,GAAkB,IAAI,CAAC;IAEvC,~~IAAI~~,aAAa,KAAK,MAAM,~~EAAE,~~CAAC~~;QAC7B~~,KAAK,~~GAAG~~,~~MAAM~~,CAAC~~;QACf~~,~~YAAY~~,~~GAAG~~,~~SAAS~~,IAAI,CAAC,~~iBAAiB~~,CAAC,CAAC,CAAC,~~YAAY~~,~~CAAC~~,~~CAAC~~,CAAC,~~WAAW~~,CAAC,CAAC;~~IAC/E~~,CAAC;SAAM,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;QACpC,KAAK,GAAG,MAAM,CAAC;QACf,YAAY,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;~~IACxC~~,CAAC;SAAM,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;QACpC,KAAK,GAAG,MAAM,CAAC;QACf,YAAY,GAAG,IAAI,CAAC;~~IACtB~~,CAAC;SAAM,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;QACpC,KAAK,GAAG,MAAM,CAAC;QACf,YAAY,GAAG,SAAS,CAAC;IAC3B,CAAC;SAAM,IAAI,iBAAiB,EAAE,CAAC;QAC7B,KAAK,GAAG,MAAM,CAAC;QACf,YAAY,GAAG,YAAY,CAAC;IAC9B,CAAC;SAAM,IAAI,WAAW,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC1C,KAAK,GAAG,WAAW,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QACvD,YAAY,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,IAAI,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;~~IACvF~~,CAAC;IAED,OAAO;QACL,KAAK;QACL,YAAY;QACZ,iBAAiB;QACjB,WAAW;QACX,gBAAgB;QAChB,WAAW;QACX,IAAI,EAAE,aAAa,CAAC,WAAW,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;QACxE,IAAI,EAAE,aAAa,CAAC,WAAW,EAAE,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;KACzE,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,KAAa;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAC1B,IAAI,MAAM,CAAC,oBAAoB,OAAO,yCAAyC,EAAE,IAAI,CAAC,CACvF,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACvC,OAAO,KAAK,KAAK,EAAE,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM;QACrF,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAoB;IAC9C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,+GAA+G,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClJ,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,uFAAuF,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzH,OAAO,CAAC,OAAO,IAAI,MAAM,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC;AACzD,CAAC;AAED,SAAS,SAAS,CAAC,IAAuB;IACxC,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC;~~IACzC~~,OAAO,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;AACpD,CAAC;~~AAED~~,SAAS,aAAa,CACpB,MAAyB,EACzB,WAA0B;IAE1B,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QACnC,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK;QACxD,OAAO,EAAE,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE;QAClE,KAAK,EAAE,WAAW,GAAG,CAAC;YACpB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,KAAK,GAAG,WAAW;gBACrB,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,KAAK,KAAK,WAAW;oBACvB,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,SAAS;KACd,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QACrG,CAAC,CAAC,KAAK,CAAC,IAAI;QACZ,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,CAAC"}
1	+ {"version":3,"file":"workflow-state.js","sourceRoot":"","sources":["../../lib/workflow-state.ts"],"names":[],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@jakkrichm/create-nexus-devflow",
-  "version": "2.0.27",
+  "version": "2.2.0",
   "description": "Installer package for Nexus-DevFlow agentic workflow layer.",
   "license": "MIT",
   "author": "Jakkrich",

package/template/.agents/skills/adopt/SKILL.md CHANGED Viewed

@@ -1,6 +1,6 @@
 ---
 name: adopt
-description: "[devflow][B] Bring the blueprint into an existing (brownfield) codebase. Surveys the real repo, interviews for intent, generates the owned plans and coding standards, documents existing verification and CI, and points to the optional standalone CI setup. Use when the user runs /adopt, is overlaying the blueprint onto an app that already has meaningful code, or asks to adopt or bootstrap the workflow into an existing project. For freshly scaffolded or early projects, use onboard instead."
+description: "[devflow][B] Bring the blueprint into an existing (brownfield) codebase. Surveys the real repo, interviews for intent, generates the owned plans and coding standards, documents existing verification and CI, asks whether DevFlow workflow files should be committed or kept local-only, and points to the optional standalone CI setup. Use when the user runs /adopt, is overlaying the blueprint onto an app that already has meaningful code, or asks to adopt or bootstrap the workflow into an existing project. For freshly scaffolded or early projects, use onboard instead."
 ---
 # adopt - bootstrap the blueprint from an existing codebase
@@ -42,9 +42,9 @@ Protect the project README:
 - If the root `README.md` already looks like a real project README, leave it
   alone.
-- If the root `README.md` is the copied Blueprint workflow doc (for example it
+- If the root `README.md` is the copied DevFlow workflow doc (for example it
   starts with `# AI Coding Blueprint`), report it as obsolete overlay content
-  and ask before replacing or removing it. Do not move it into `blueprint/`.
+  and ask before replacing or removing it. Do not move it into `devflow/`.
 - Do not create or overwrite a root project README for a brownfield app unless
   the user explicitly asks. The existing project face belongs to the app, not the
   workflow.
@@ -124,7 +124,54 @@ Run /ci or $ci when you want automatic GitHub checks.
 Explain that CI is not required to finish adoption. The `/ci` skill owns
 project-specific Verify and GitHub workflow setup.
-## Step 5 - review gate, then hand off
+## Step 5 - ask about DevFlow visibility
+Ask how the DevFlow workflow files should be handled in git, unless the user
+already gave a preference:
+```text
+DevFlow visibility?
+1. Commit DevFlow workflow files
+   Portable. Best for teams and working across machines.
+2. Keep DevFlow workflow files local
+   Adds .agents/, .claude/, devflow/, and CLAUDE.md to .gitignore.
+   Keeps AGENTS.md public as the lightweight project agent guide.
+```
+Recommend option 1 by default. If the user chooses option 2:
+- Add this block to `.gitignore`, preserving existing entries:
+  ```gitignore
+  # DevFlow local workflow files
+  .agents/
+  .claude/
+  devflow/
+  CLAUDE.md
+  ```
+- Keep `AGENTS.md` tracked. It remains the lightweight public project guide for
+  commands and conventions.
+- Make `AGENTS.md` public-safe: keep project description, commands, testing gate,
+  and coding conventions, but remove or avoid DevFlow workflow explanations,
+  hidden adapter paths, workflow-document pointers, and core skill lists that
+  would expose the local-only workflow.
+- Explain that local-only mode hides the workflow contents from the repo, but the
+  `.gitignore` names still reveal the ignored paths.
+- Explain that DevFlow state, specs, findings, and history will not travel
+  with the repo; another machine needs DevFlow reinstalled or restored
+  locally.
+- Because adoption runs right after the DevFlow files were added to an
+  existing repository, they are more likely to already be staged or committed
+  than in a fresh install. If any of `.agents/`, `.claude/`, `devflow/`, or
+  `CLAUDE.md` are already tracked, say `.gitignore` will not hide tracked files.
+  Ask before running
+  `git rm --cached -r .agents .claude devflow CLAUDE.md`, and
+  only run it if the user explicitly approves. Never delete the local files.
+## Step 6 - review gate, then hand off
 Stop and show the user what you generated, calling out:
@@ -132,7 +179,9 @@ Stop and show the user what you generated, calling out:
   judgment most worth their eyes,
 - every `> TODO (confirm)` you left,
 - anything the survey and the interview disagreed on,
-- verification command and GitHub checks status.
+- verification command and GitHub checks status,
+- DevFlow visibility choice, and a tracked-file warning if local-only mode was
+  chosen after files were already tracked.
 These files are the ones the user *owns*. Have them review and adjust, then tell
 them to run `/overview` to distill the plans into `project-overview.md` and start
@@ -150,6 +199,10 @@ the normal loop.
   before touching them. Never run a scaffolder.
 - **Be honest about testing.** If there's no runner, say testing is opt-in and not
   yet set up; don't describe a gate the project hasn't adopted.
+- Keep `AGENTS.md` public in local-only mode unless the user explicitly asks for
+  a more advanced setup.
+- Do not untrack DevFlow files with `git rm --cached` without a separate
+  explicit approval.
 ## Formatting