@jakkrichm/create-nexus-devflow 2.0.27 → 2.2.0

package/dist/lib/drift-reconciler.d.ts

@@ -0,0 +1,38 @@
+export interface GitDriftReport {
+    hasDrift: boolean;
+    undocumentedFiles: string[];
+    phantomFiles: string[];
+    matchedFiles: string[];
+    gitModifiedFiles: string[];
+    specFiles: string[];
+    stageDrift: {
+        isDrifted: boolean;
+        activeBranch: string | null;
+        stageRunningId: string | null;
+    };
+}
+export interface ReconcileResult {
+    reconciled: boolean;
+    addedFiles: string[];
+    healedStage: boolean;
+    message: string;
+}
+/**
+ * Normalizes file path to forward slashes relative to workspace root.
+ */
+export declare function normalizeRelativePath(projectRoot: string, filePath: string): string;
+/**
+ * Parses the "Files to Modify/Create" section from a living spec markdown.
+ */
+export declare function parseSpecFilesList(specContent: string): string[];
+/**
+ * Detects git drift between modified repository files and spec declaration.
+ */
+export declare function detectGitDrift(projectRoot: string, explicitBranch?: string): Promise<GitDriftReport>;
+/**
+ * Automatically reconciles and synchronizes living spec and stage file.
+ */
+export declare function reconcileState(projectRoot: string, options?: {
+    autoAddUndocumented?: boolean;
+    healStage?: boolean;
+}): Promise<ReconcileResult>;

package/dist/lib/drift-reconciler.js

@@ -0,0 +1,155 @@
+import fs from "node:fs/promises";
+import fsSync from "node:fs";
+import path from "node:path";
+import { resolveActiveContextPaths } from "./branch-context.js";
+import { readGitStatus } from "./git-status.js";
+const IGNORED_DRIFT_PATTERNS = [
+    /devflow\/context\/current-feature\.md$/i,
+    /devflow\/context\/current-stage\.md$/i,
+    /devflow\/history\//i,
+    /devflow\/runs\//i,
+    /devflow\/discoveries\//i,
+    /\.gitignore$/i,
+    /\.nexus\//i,
+    /\.agents\//i,
+    /\.claude\//i,
+    /node_modules\//i,
+    /dist\//i,
+    /package-lock\.json$/i
+];
+/**
+ * Normalizes file path to forward slashes relative to workspace root.
+ */
+export function normalizeRelativePath(projectRoot, filePath) {
+    const relative = path.isAbsolute(filePath)
+        ? path.relative(projectRoot, filePath)
+        : filePath;
+    return relative.replace(/\\/g, "/").replace(/^\.\//, "");
+}
+/**
+ * Parses the "Files to Modify/Create" section from a living spec markdown.
+ */
+export function parseSpecFilesList(specContent) {
+    const files = [];
+    const lines = specContent.split("\n");
+    let inFilesSection = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (/Files\s+to\s+Modify\/Create/i.test(trimmed)) {
+            inFilesSection = true;
+            continue;
+        }
+        if (inFilesSection) {
+            // Exit if next major section, horizontal rule, or next main bold bullet in Plan (e.g. - **Test Decision**:)
+            if (/^##+\s+/.test(trimmed) || /^-\s+\*\*[^*]+\*\*:/i.test(trimmed) || trimmed.startsWith("---")) {
+                inFilesSection = false;
+                continue;
+            }
+            if (trimmed.startsWith("-") || trimmed.startsWith("*")) {
+                // Extract backtick path `path/to/file.ext` or direct path
+                const match = trimmed.match(/`([^`]+)`/) || trimmed.match(/^[*-]\s+(?:\[[ x]\]\s+)?([a-zA-Z0-9_./\\-]+\.[a-zA-Z0-9]+)/);
+                if (match && match[1]) {
+                    const clean = match[1].trim().replace(/\\/g, "/");
+                    // Ensure it looks like a valid file path with extension
+                    if (/\.[a-zA-Z0-9_-]+$/.test(clean) && !clean.startsWith("http")) {
+                        files.push(clean);
+                    }
+                }
+            }
+        }
+    }
+    return Array.from(new Set(files));
+}
+/**
+ * Detects git drift between modified repository files and spec declaration.
+ */
+export async function detectGitDrift(projectRoot, explicitBranch) {
+    const contextPaths = await resolveActiveContextPaths(projectRoot, explicitBranch);
+    const gitStatus = await readGitStatus(projectRoot);
+    let specFiles = [];
+    let stageRunningId = null;
+    if (fsSync.existsSync(contextPaths.featureSpecPath)) {
+        const specContent = await fs.readFile(contextPaths.featureSpecPath, "utf8");
+        specFiles = parseSpecFilesList(specContent);
+    }
+    if (fsSync.existsSync(contextPaths.stagePath)) {
+        const stageContent = await fs.readFile(contextPaths.stagePath, "utf8");
+        const match = stageContent.match(/Active Running ID:\s*`?([a-zA-Z0-9_-]+)`?/i);
+        if (match)
+            stageRunningId = match[1];
+    }
+    // Collect git changed files
+    const rawGitFiles = [];
+    if (gitStatus.available) {
+        if (gitStatus.changedFiles && Array.isArray(gitStatus.changedFiles)) {
+            rawGitFiles.push(...gitStatus.changedFiles);
+        }
+    }
+    // Filter out ignored/transient files
+    const gitModifiedFiles = rawGitFiles
+        .map((f) => normalizeRelativePath(projectRoot, f))
+        .filter((f) => !IGNORED_DRIFT_PATTERNS.some((p) => p.test(f)));
+    const normalizedSpecFiles = specFiles.map((f) => normalizeRelativePath(projectRoot, f));
+    const undocumentedFiles = gitModifiedFiles.filter((gf) => !normalizedSpecFiles.some((sf) => sf === gf || gf.endsWith(sf) || sf.endsWith(gf)));
+    const phantomFiles = normalizedSpecFiles.filter((sf) => !gitModifiedFiles.some((gf) => gf === sf || gf.endsWith(sf) || sf.endsWith(gf)));
+    const matchedFiles = gitModifiedFiles.filter((gf) => normalizedSpecFiles.some((sf) => sf === gf || gf.endsWith(sf) || sf.endsWith(gf)));
+    const isStageDrifted = Boolean(gitStatus.branch &&
+        stageRunningId &&
+        stageRunningId !== "None" &&
+        !gitStatus.branch.includes(stageRunningId) &&
+        !stageRunningId.includes(gitStatus.branch));
+    const hasDrift = undocumentedFiles.length > 0 || isStageDrifted;
+    return {
+        hasDrift,
+        undocumentedFiles,
+        phantomFiles,
+        matchedFiles,
+        gitModifiedFiles,
+        specFiles: normalizedSpecFiles,
+        stageDrift: {
+            isDrifted: isStageDrifted,
+            activeBranch: gitStatus.branch || null,
+            stageRunningId
+        }
+    };
+}
+/**
+ * Automatically reconciles and synchronizes living spec and stage file.
+ */
+export async function reconcileState(projectRoot, options = { autoAddUndocumented: true, healStage: true }) {
+    const drift = await detectGitDrift(projectRoot);
+    const contextPaths = await resolveActiveContextPaths(projectRoot);
+    const addedFiles = [];
+    let healedStage = false;
+    // 1. Reconcile Undocumented Files into current-feature.md
+    if (options.autoAddUndocumented && drift.undocumentedFiles.length > 0 && fsSync.existsSync(contextPaths.featureSpecPath)) {
+        const specContent = await fs.readFile(contextPaths.featureSpecPath, "utf8");
+        const lines = specContent.split("\n");
+        const targetIdx = lines.findIndex((l) => /Files\s+to\s+Modify\/Create/i.test(l));
+        if (targetIdx !== -1) {
+            const newEntries = drift.undocumentedFiles.map((f) => `  - \`${f}\` (Auto-reconciled from Git changes)`);
+            lines.splice(targetIdx + 1, 0, ...newEntries);
+            await fs.writeFile(contextPaths.featureSpecPath, lines.join("\n"), "utf8");
+            addedFiles.push(...drift.undocumentedFiles);
+        }
+    }
+    // 2. Heal current-stage.md if drifted
+    if (options.healStage && drift.stageDrift.isDrifted && drift.stageDrift.activeBranch && fsSync.existsSync(contextPaths.stagePath)) {
+        const stageContent = await fs.readFile(contextPaths.stagePath, "utf8");
+        const cleanBranch = drift.stageDrift.activeBranch.replace(/^(feature|fix|chore)\//, "");
+        const updatedStage = stageContent.replace(/Active Running ID:\s*`?[^`\n]+`?/i, `Active Running ID: \`${cleanBranch}\``);
+        await fs.writeFile(contextPaths.stagePath, updatedStage, "utf8");
+        healedStage = true;
+    }
+    const reconciled = addedFiles.length > 0 || healedStage;
+    const message = reconciled
+        ? `Reconciliation complete: Added ${addedFiles.length} undocumented file(s) to spec, stage healed: ${healedStage}`
+        : "No drift detected or nothing to reconcile.";
+    return {
+        reconciled,
+        addedFiles,
+        healedStage,
+        message
+    };
+}
+//# sourceMappingURL=drift-reconciler.js.map

package/dist/lib/drift-reconciler.js.map

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

package/dist/lib/gatekeeper.d.ts

@@ -9,6 +9,7 @@ export interface GateReport {
     strict: boolean;
     completionState: string;
     violations: string[];
+    warnings: string[];
     findingsBlockers: number;
     remainingTasks: number;
     summary: string;

package/dist/lib/gatekeeper.js

@@ -1,13 +1,24 @@
 import { readProjectStatus } from "./status.js";
+import { detectGitDrift } from "./drift-reconciler.js";
 import { createStyle } from "./ui.js";
 export async function evaluateGate(projectRoot, options = {}) {
     const status = await readProjectStatus(projectRoot);
     const violations = [];
+    const warnings = [];
     // Check 1: Active Findings Blockers (P0 / P1 in open or fixed status)
-    const blockers = status.findings.blockers;
+    const blockers = status.findings.blockers || [];
     for (const blocker of blockers) {
         violations.push(`Finding ${blocker.id} [${blocker.severity}] (${blocker.status}): ${blocker.title}`);
     }
+    // Check 1.1: Non-blocker findings warnings (P2 / P3 in open status)
+    const nonBlockers = (status.findings.active || []).filter((item) => (item.severity === "P2" || item.severity === "P3") && (item.status === "open" || item.status === "unverified"));
+    for (const item of nonBlockers) {
+        warnings.push(`Advisory Finding ${item.id} [${item.severity}] (${item.status}): ${item.title}`);
+    }
+    // Check 1.2: Status / findings warnings
+    for (const w of status.warnings || []) {
+        warnings.push(`Warning (${w.code}): ${w.message}`);
+    }
     // Check 2: Uncompleted tasks in Living Spec
     const remaining = status.currentWork.remaining;
     if (status.currentWork.state === "active" && remaining > 0) {
@@ -19,6 +30,14 @@ export async function evaluateGate(projectRoot, options = {}) {
             violations.push(`Living spec '${status.currentWork.runId || "active"}' is unverified (run /check before delivery)`);
         }
     }
+    // Check 4: Git drift advisory check
+    try {
+        const drift = await detectGitDrift(projectRoot);
+        if (drift.hasDrift && drift.undocumentedFiles.length > 0) {
+            warnings.push(`Warning (git_drift): ${drift.undocumentedFiles.length} file(s) modified in git without being listed in living spec.`);
+        }
+    }
+    catch { }
     const passed = violations.length === 0;
     const exitCode = passed ? 0 : 1;
     let summary = "";
@@ -37,6 +56,7 @@ export async function evaluateGate(projectRoot, options = {}) {
         strict: options.strict === true,
         completionState: status.completion.state,
         violations,
+        warnings,
         findingsBlockers: blockers.length,
         remainingTasks: remaining,
         summary
@@ -58,6 +78,15 @@ export function formatGateReport(report, options = {}) {
             lines.push(`  - ${style.red("✖")} ${v}`);
         }
         lines.push("");
+    }
+    if (report.warnings.length > 0) {
+        lines.push(style.bold(style.yellow("Warnings / Advisories:")));
+        for (const w of report.warnings) {
+            lines.push(`  - ${style.yellow("⚠")} ${style.dim(w)}`);
+        }
+        lines.push("");
+    }
+    if (report.violations.length > 0) {
         lines.push(style.yellow("Suggested Actions:"));
         if (report.findingsBlockers > 0) {
             lines.push(`  - Resolve blockers: ${style.bold("nexus-devflow findings --blockers")}`);

package/dist/lib/gatekeeper.js.map

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

package/dist/lib/git-hooks.js

@@ -6,38 +6,57 @@ function createHookScript(strict = true) {
     return `#!/bin/sh
 ${HOOK_MARKER}
 echo "[Nexus-DevFlow] Verifying Quality Gatekeeper before proceeding..."
-npx nexus-devflow check-gate${strictFlag}
+
+if command -v npx >/dev/null 2>&1; then
+  npx nexus-devflow check-gate${strictFlag}
+else
+  echo "[Nexus-DevFlow] Warning: 'npx' not found in PATH, skipping local gatekeeper check."
+  exit 0
+fi
+
 EXIT_CODE=$?
 if [ $EXIT_CODE -ne 0 ]; then
   echo ""
   echo "[Nexus-DevFlow] Action aborted: Quality Gatekeeper failed."
-  echo "[Nexus-DevFlow] Fix blockers or resolve findings before proceeding."
+  echo "[Nexus-DevFlow] Fix blockers, complete tasks, or resolve findings before proceeding."
   exit 1
 fi
 `;
 }
-export async function installGitHook(projectRoot, hookType = "pre-commit", options = {}) {
-    const gitDir = path.join(projectRoot, ".git");
+async function resolveGitHooksDir(projectRoot) {
+    const gitPath = path.join(projectRoot, ".git");
     try {
-        const gitStats = await fs.lstat(gitDir);
-        if (!gitStats.isDirectory()) {
-            return {
-                success: false,
-                hookType,
-                path: "",
-                message: "Target directory is not a Git repository (.git directory not found)."
-            };
+        const stats = await fs.lstat(gitPath);
+        if (stats.isDirectory()) {
+            return path.join(gitPath, "hooks");
+        }
+        if (stats.isFile()) {
+            const content = await fs.readFile(gitPath, "utf8");
+            const match = content.match(/^gitdir:\s*(.+)$/m);
+            if (match) {
+                const rawGitDir = match[1].trim();
+                const gitDir = path.isAbsolute(rawGitDir)
+                    ? rawGitDir
+                    : path.resolve(projectRoot, rawGitDir);
+                return path.join(gitDir, "hooks");
+            }
         }
     }
     catch {
+        return null;
+    }
+    return null;
+}
+export async function installGitHook(projectRoot, hookType = "pre-commit", options = {}) {
+    const hooksDir = await resolveGitHooksDir(projectRoot);
+    if (!hooksDir) {
         return {
             success: false,
             hookType,
             path: "",
-            message: "Target directory is not a Git repository (.git directory not found)."
+            message: "Target directory is not a Git repository (.git directory or worktree not found)."
         };
     }
-    const hooksDir = path.join(gitDir, "hooks");
     await fs.mkdir(hooksDir, { recursive: true });
     const hookPath = path.join(hooksDir, hookType);
     const scriptContent = createHookScript(options.strict !== false);
@@ -50,8 +69,14 @@ export async function installGitHook(projectRoot, hookType = "pre-commit", optio
     };
 }
 export async function uninstallGitHooks(projectRoot) {
-    const gitDir = path.join(projectRoot, ".git");
-    const hooksDir = path.join(gitDir, "hooks");
+    const hooksDir = await resolveGitHooksDir(projectRoot);
+    if (!hooksDir) {
+        return {
+            success: true,
+            removed: [],
+            message: "Target directory is not a Git repository (.git directory or worktree not found)."
+        };
+    }
     const removed = [];
     const types = ["pre-commit", "pre-push"];
     for (const t of types) {

package/dist/lib/git-hooks.js.map

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

package/dist/lib/ide-extension.d.ts

@@ -0,0 +1,38 @@
+export interface IdeExtensionManifest {
+    name: string;
+    displayName: string;
+    description: string;
+    version: string;
+    publisher: string;
+    engines: {
+        vscode: string;
+    };
+    categories: string[];
+    activationEvents: string[];
+    main: string;
+    contributes: {
+        viewsContainers: {
+            activitybar: Array<{
+                id: string;
+                title: string;
+                icon: string;
+            }>;
+        };
+        views: {
+            [containerId: string]: Array<{
+                type: string;
+                id: string;
+                name: string;
+            }>;
+        };
+        commands: Array<{
+            command: string;
+            title: string;
+            category: string;
+        }>;
+    };
+}
+/**
+ * Generates the official VS Code / Antigravity IDE Extension package.json manifest.
+ */
+export declare function generateIdeExtensionManifest(): IdeExtensionManifest;

package/dist/lib/ide-extension.js

@@ -0,0 +1,61 @@
+/**
+ * Generates the official VS Code / Antigravity IDE Extension package.json manifest.
+ */
+export function generateIdeExtensionManifest() {
+    return {
+        name: "nexus-devflow-studio",
+        displayName: "Nexus-DevFlow Studio",
+        description: "Interactive 3-Pillars Kanban Dashboard, Dynamic Spec Manager & Quality Gatekeeper for Nexus-DevFlow",
+        version: "2.0.27",
+        publisher: "jakkrichm",
+        engines: {
+            vscode: "^1.80.0"
+        },
+        categories: ["Programming Languages", "Other", "Linters"],
+        activationEvents: ["onView:nexusDevFlowStudioView", "onCommand:nexusDevFlow.openStudio"],
+        main: "./out/extension.js",
+        contributes: {
+            viewsContainers: {
+                activitybar: [
+                    {
+                        id: "nexus-devflow-container",
+                        title: "Nexus-DevFlow",
+                        icon: "resources/devflow-icon.svg"
+                    }
+                ]
+            },
+            views: {
+                "nexus-devflow-container": [
+                    {
+                        type: "webview",
+                        id: "nexusDevFlowStudioView",
+                        name: "DevFlow Studio"
+                    }
+                ]
+            },
+            commands: [
+                {
+                    command: "nexusDevFlow.openStudio",
+                    title: "Open DevFlow Studio Webview",
+                    category: "Nexus-DevFlow"
+                },
+                {
+                    command: "nexusDevFlow.checkGate",
+                    title: "Run Quality Gatekeeper Check",
+                    category: "Nexus-DevFlow"
+                },
+                {
+                    command: "nexusDevFlow.detectDrift",
+                    title: "Detect Git Diff Drift",
+                    category: "Nexus-DevFlow"
+                },
+                {
+                    command: "nexusDevFlow.reconcileState",
+                    title: "Auto-Heal & Reconcile State",
+                    category: "Nexus-DevFlow"
+                }
+            ]
+        }
+    };
+}
+//# sourceMappingURL=ide-extension.js.map

package/dist/lib/ide-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ide-extension.js","sourceRoot":"","sources":["../../lib/ide-extension.ts"],"names":[],"mappings":"AAmCA;;GAEG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE,qGAAqG;QAClH,OAAO,EAAE,QAAQ;QACjB,SAAS,EAAE,WAAW;QACtB,OAAO,EAAE;YACP,MAAM,EAAE,SAAS;SAClB;QACD,UAAU,EAAE,CAAC,uBAAuB,EAAE,OAAO,EAAE,SAAS,CAAC;QACzD,gBAAgB,EAAE,CAAC,+BAA+B,EAAE,mCAAmC,CAAC;QACxF,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE;YACX,eAAe,EAAE;gBACf,WAAW,EAAE;oBACX;wBACE,EAAE,EAAE,yBAAyB;wBAC7B,KAAK,EAAE,eAAe;wBACtB,IAAI,EAAE,4BAA4B;qBACnC;iBACF;aACF;YACD,KAAK,EAAE;gBACL,yBAAyB,EAAE;oBACzB;wBACE,IAAI,EAAE,SAAS;wBACf,EAAE,EAAE,wBAAwB;wBAC5B,IAAI,EAAE,gBAAgB;qBACvB;iBACF;aACF;YACD,QAAQ,EAAE;gBACR;oBACE,OAAO,EAAE,yBAAyB;oBAClC,KAAK,EAAE,6BAA6B;oBACpC,QAAQ,EAAE,eAAe;iBAC1B;gBACD;oBACE,OAAO,EAAE,wBAAwB;oBACjC,KAAK,EAAE,8BAA8B;oBACrC,QAAQ,EAAE,eAAe;iBAC1B;gBACD;oBACE,OAAO,EAAE,0BAA0B;oBACnC,KAAK,EAAE,uBAAuB;oBAC9B,QAAQ,EAAE,eAAe;iBAC1B;gBACD;oBACE,OAAO,EAAE,6BAA6B;oBACtC,KAAK,EAAE,6BAA6B;oBACpC,QAAQ,EAAE,eAAe;iBAC1B;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/mcp.d.ts

@@ -0,0 +1,36 @@
+import type { Readable, Writable } from "node:stream";
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id?: string | number | null;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id: string | number | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export declare const DEVFLOW_MCP_TOOLS: McpToolDefinition[];
+export declare function handleToolCall(projectRoot: string, name: string, args?: Record<string, unknown>): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+}>;
+export declare function processMcpMessage(projectRoot: string, rawMessage: string): Promise<JsonRpcResponse | null>;
+export declare function startMcpServer(projectRoot: string, inStream?: Readable, outStream?: Writable): void;