@jakkrichm/create-nexus-devflow 2.0.25 → 2.1.0

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/findings.d.ts

@@ -21,6 +21,30 @@ interface FindingsSummary {
 }
 declare const DEVFLOW_FINDINGS_PATH: string;
 declare function readFindings(projectRoot: string): Promise<FindingsSummary>;
+declare function resolveFinding(projectRoot: string, findingId: string, newStatus?: FindingStatus): Promise<{
+    success: boolean;
+    message: string;
+    previousStatus?: FindingStatus;
+    finding?: Finding;
+}>;
+declare function formatFindingsHuman(summary: FindingsSummary, options?: {
+    blockersOnly?: boolean;
+    color?: boolean;
+}): string;
 declare function parseFindings(markdown: string): FindingsSummary;
-export { DEVFLOW_FINDINGS_PATH, parseFindings, readFindings };
-export type { Finding, FindingSeverity, FindingsSummary, FindingStatus, FindingsWarning, FindingsWarningCode };
+interface AddFindingOptions {
+    id?: string;
+    severity?: FindingSeverity;
+    status?: FindingStatus;
+    location?: string;
+    impact?: string;
+    remediation?: string;
+}
+declare function addFinding(projectRoot: string, title: string, options?: AddFindingOptions): Promise<{
+    success: boolean;
+    message: string;
+    finding?: Finding;
+    filePath: string;
+}>;
+export { DEVFLOW_FINDINGS_PATH, addFinding, formatFindingsHuman, parseFindings, readFindings, resolveFinding };
+export type { AddFindingOptions, Finding, FindingSeverity, FindingsSummary, FindingStatus, FindingsWarning, FindingsWarningCode };

package/dist/lib/findings.js

@@ -1,8 +1,30 @@
 import fs from "node:fs/promises";
 import path from "node:path";
+import { createStyle } from "./ui.js";
 const DEVFLOW_FINDINGS_PATH = path.join("devflow", "context", "findings.md");
 const BLUEPRINT_FINDINGS_PATH = path.join("blueprint", "context", "findings.md");
 const FINDING_PATTERN = /^###\s+(\S+)\s+\[(P[0-3])\]\s+(unverified|open|fixed|closed|accepted|invalid)\s+-\s+(.+?)\s*$/i;
+async function getFindingsFilePath(projectRoot) {
+    const devflowPath = path.join(projectRoot, DEVFLOW_FINDINGS_PATH);
+    const blueprintPath = path.join(projectRoot, BLUEPRINT_FINDINGS_PATH);
+    try {
+        const stats = await fs.lstat(devflowPath);
+        if (stats.isFile())
+            return devflowPath;
+    }
+    catch {
+        // try fallback
+    }
+    try {
+        const stats = await fs.lstat(blueprintPath);
+        if (stats.isFile())
+            return blueprintPath;
+    }
+    catch {
+        // not found
+    }
+    return null;
+}
 async function readFindings(projectRoot) {
     let findingsPath = path.join(projectRoot, DEVFLOW_FINDINGS_PATH);
     try {
@@ -43,6 +65,84 @@ async function readFindings(projectRoot) {
         throw error;
     }
 }
+async function resolveFinding(projectRoot, findingId, newStatus = "closed") {
+    const filePath = await getFindingsFilePath(projectRoot);
+    if (!filePath) {
+        return {
+            success: false,
+            message: `Findings file not found in ${projectRoot}`
+        };
+    }
+    const content = await fs.readFile(filePath, "utf8");
+    const lines = content.split(/\r?\n/);
+    let targetIndex = -1;
+    let previousStatus;
+    let updatedFinding;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const match = line.match(FINDING_PATTERN);
+        if (match && match[1]?.toLowerCase() === findingId.toLowerCase()) {
+            targetIndex = i;
+            const id = match[1];
+            const severity = (match[2] || "").toUpperCase();
+            previousStatus = (match[3] || "").toLowerCase();
+            const title = (match[4] || "").trim();
+            lines[i] = `### ${id} [${severity}] ${newStatus} - ${title}`;
+            updatedFinding = {
+                id,
+                severity,
+                status: newStatus,
+                title,
+                line: i + 1
+            };
+            break;
+        }
+    }
+    if (targetIndex === -1 || !updatedFinding) {
+        return {
+            success: false,
+            message: `Finding with ID '${findingId}' not found in ${filePath}`
+        };
+    }
+    await fs.writeFile(filePath, lines.join("\n"), "utf8");
+    return {
+        success: true,
+        message: `Finding ${updatedFinding.id} status updated from '${previousStatus}' to '${newStatus}'`,
+        previousStatus,
+        finding: updatedFinding
+    };
+}
+function formatFindingsHuman(summary, options = {}) {
+    const style = createStyle(options.color);
+    const lines = [];
+    const items = options.blockersOnly ? summary.blockers : summary.items;
+    const headerTitle = options.blockersOnly
+        ? `Findings Blockers (${summary.blockers.length} active P0/P1)`
+        : `Findings Ledger (${summary.total} total, ${summary.blockers.length} blockers)`;
+    lines.push(style.bold(headerTitle));
+    lines.push("");
+    if (items.length === 0) {
+        lines.push(style.dim(options.blockersOnly
+            ? "  No active P0/P1 blockers! Ready for delivery."
+            : "  No findings recorded in devflow/context/findings.md"));
+    }
+    else {
+        for (const finding of items) {
+            const isBlocker = (finding.severity === "P0" || finding.severity === "P1") &&
+                (finding.status === "open" || finding.status === "fixed");
+            const sevFormatted = isBlocker
+                ? style.bold(style.red(`[${finding.severity}]`))
+                : style.yellow(`[${finding.severity}]`);
+            const statusFormatted = finding.status === "closed" || finding.status === "accepted"
+                ? style.green(finding.status)
+                : finding.status === "fixed"
+                    ? style.cyan(finding.status)
+                    : style.yellow(finding.status);
+            lines.push(`  ${style.bold(style.cyan(finding.id))} ${sevFormatted} ${statusFormatted} - ${finding.title}`);
+        }
+    }
+    return lines.join("\n").trimEnd();
+}
 function parseFindings(markdown) {
     const items = [];
     let malformed = false;
@@ -106,5 +206,69 @@ function getErrorCode(error) {
         ? error.code
         : undefined;
 }
-export { DEVFLOW_FINDINGS_PATH, parseFindings, readFindings };
+async function addFinding(projectRoot, title, options = {}) {
+    let filePath = await getFindingsFilePath(projectRoot);
+    let content = "";
+    if (!filePath) {
+        filePath = path.join(projectRoot, DEVFLOW_FINDINGS_PATH);
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        content = `# Findings Ledger\n\n> Durable record of audit findings, security issues, and code quality items.\n> Active P0 and P1 findings in \`open\` or \`fixed\` status block delivery and releases.\n\n`;
+    }
+    else {
+        content = await fs.readFile(filePath, "utf8");
+    }
+    const existing = parseFindings(content);
+    const severity = options.severity || "P2";
+    const status = options.status || "open";
+    let id = options.id?.trim();
+    if (!id) {
+        let maxNum = 0;
+        for (const item of existing.items) {
+            const numMatch = item.id.match(/\d+$/);
+            if (numMatch) {
+                const n = parseInt(numMatch[0], 10);
+                if (!isNaN(n) && n > maxNum) {
+                    maxNum = n;
+                }
+            }
+        }
+        const nextSeq = String(maxNum + 1).padStart(3, "0");
+        id = `FIND-${nextSeq}`;
+    }
+    const cleanTitle = title.trim();
+    const entryLines = [];
+    entryLines.push(`### ${id} [${severity}] ${status} - ${cleanTitle}`);
+    if (options.location) {
+        entryLines.push(`- **Location**: \`${options.location}\``);
+    }
+    if (options.impact) {
+        entryLines.push(`- **Impact**: ${options.impact}`);
+    }
+    if (options.remediation) {
+        entryLines.push(`- **Remediation**: ${options.remediation}`);
+    }
+    const newEntry = entryLines.join("\n") + "\n";
+    let updatedContent = content.trimEnd();
+    if (updatedContent.length > 0) {
+        updatedContent += "\n\n" + newEntry;
+    }
+    else {
+        updatedContent = newEntry;
+    }
+    await fs.writeFile(filePath, updatedContent, "utf8");
+    const finding = {
+        id,
+        severity,
+        status,
+        title: cleanTitle,
+        line: updatedContent.split(/\r?\n/).length
+    };
+    return {
+        success: true,
+        message: `Added finding ${id} [${severity}] ${status} to ${filePath}`,
+        finding,
+        filePath
+    };
+}
+export { DEVFLOW_FINDINGS_PATH, addFinding, formatFindingsHuman, parseFindings, readFindings, resolveFinding };
 //# sourceMappingURL=findings.js.map

package/dist/lib/findings.js.map

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

package/dist/lib/gatekeeper.d.ts

@@ -0,0 +1,20 @@
+export interface GateOptions {
+    strict?: boolean;
+    allowUnverified?: boolean;
+    color?: boolean;
+}
+export interface GateReport {
+    passed: boolean;
+    exitCode: 0 | 1;
+    strict: boolean;
+    completionState: string;
+    violations: string[];
+    warnings: string[];
+    findingsBlockers: number;
+    remainingTasks: number;
+    summary: string;
+}
+export declare function evaluateGate(projectRoot: string, options?: GateOptions): Promise<GateReport>;
+export declare function formatGateReport(report: GateReport, options?: {
+    color?: boolean;
+}): string;

package/dist/lib/gatekeeper.js

@@ -0,0 +1,106 @@
+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 || [];
+    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) {
+        violations.push(`Living spec '${status.currentWork.runId || "active"}' has ${remaining} uncompleted task(s)`);
+    }
+    // Check 3: Strict mode verification check
+    if (options.strict && status.currentWork.state === "active") {
+        if (status.completion.state === "needs_verification" || status.completion.state === "blocked") {
+            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 = "";
+    if (passed) {
+        summary =
+            status.currentWork.state === "idle"
+                ? "Quality Gate Passed: Workspace is clean with 0 blockers."
+                : "Quality Gate Passed: Active run satisfies all gatekeeper criteria.";
+    }
+    else {
+        summary = `Quality Gate Failed: ${violations.length} blocker(s) detected.`;
+    }
+    return {
+        passed,
+        exitCode,
+        strict: options.strict === true,
+        completionState: status.completion.state,
+        violations,
+        warnings,
+        findingsBlockers: blockers.length,
+        remainingTasks: remaining,
+        summary
+    };
+}
+export function formatGateReport(report, options = {}) {
+    const style = createStyle(options.color);
+    const lines = [];
+    const modeBadge = report.strict ? style.yellow("[Strict Mode]") : style.dim("[Standard Mode]");
+    const header = report.passed
+        ? style.bold(style.green(`✔ DevFlow Quality Gate PASSED ${modeBadge}`))
+        : style.bold(style.red(`✖ DevFlow Quality Gate BLOCKED ${modeBadge}`));
+    lines.push(header);
+    lines.push(`  ${style.dim(report.summary)}`);
+    lines.push("");
+    if (report.violations.length > 0) {
+        lines.push(style.bold(style.red("Violations:")));
+        for (const v of report.violations) {
+            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")}`);
+        }
+        if (report.remainingTasks > 0) {
+            lines.push(`  - Complete tasks: ${style.bold("/implement")}`);
+        }
+        if (report.completionState === "needs_verification" || report.strict) {
+            lines.push(`  - Verify living spec: ${style.bold("/check")}`);
+        }
+    }
+    else {
+        lines.push(style.green("  All quality gates passed. Safe to merge and commit."));
+    }
+    return lines.join("\n").trimEnd();
+}
+//# sourceMappingURL=gatekeeper.js.map

package/dist/lib/gatekeeper.js.map

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

package/dist/lib/git-hooks.d.ts

@@ -0,0 +1,16 @@
+export type GitHookType = "pre-commit" | "pre-push";
+export interface HookInstallResult {
+    success: boolean;
+    hookType: GitHookType;
+    path: string;
+    message: string;
+}
+export interface HookUninstallResult {
+    success: boolean;
+    removed: string[];
+    message: string;
+}
+export declare function installGitHook(projectRoot: string, hookType?: GitHookType, options?: {
+    strict?: boolean;
+}): Promise<HookInstallResult>;
+export declare function uninstallGitHooks(projectRoot: string): Promise<HookUninstallResult>;