@jakkrichm/create-nexus-devflow 2.0.27 → 2.2.0

package/dist/lib/branch-context.js

@@ -0,0 +1,196 @@
+import fs from "node:fs/promises";
+import fsSync from "node:fs";
+import path from "node:path";
+import { readGitStatus } from "./git-status.js";
+/**
+ * Sanitizes a Git branch name into a cross-platform safe directory name.
+ * e.g. "feature/044-auth#login" -> "feature-044-auth-login"
+ */
+export function sanitizeBranchName(branch) {
+    return branch
+        .trim()
+        .replace(/[^a-zA-Z0-9._-]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .toLowerCase();
+}
+/**
+ * Resolves active context paths for the current repository and git branch.
+ * Checks for branch-isolated context in:
+ *   1. devflow/context/<sanitized>/ (Primary user-visible multi-dev location)
+ *   2. .nexus/branches/<sanitized>/ (Internal branch cache)
+ *   3. devflow/context/ (Default fallback)
+ */
+export async function resolveActiveContextPaths(projectRoot, explicitBranch) {
+    const defaultFeaturePath = path.join(projectRoot, "devflow", "context", "current-feature.md");
+    const defaultStagePath = path.join(projectRoot, "devflow", "context", "current-stage.md");
+    const defaultFindingsPath = path.join(projectRoot, "devflow", "context", "findings.md");
+    let branchName = explicitBranch || null;
+    if (!branchName) {
+        const git = await readGitStatus(projectRoot);
+        if (git.available && git.branch) {
+            branchName = git.branch;
+        }
+    }
+    if (!branchName || branchName === "main" || branchName === "master" || branchName === "HEAD") {
+        return {
+            isBranchScoped: false,
+            branchName,
+            sanitizedBranch: null,
+            branchDir: null,
+            featureSpecPath: defaultFeaturePath,
+            stagePath: defaultStagePath,
+            findingsPath: defaultFindingsPath
+        };
+    }
+    const sanitized = sanitizeBranchName(branchName);
+    // Candidate 1: devflow/context/<sanitized>/
+    const devflowBranchDir = path.join(projectRoot, "devflow", "context", sanitized);
+    const devflowBranchFeature = path.join(devflowBranchDir, "current-feature.md");
+    const devflowBranchStage = path.join(devflowBranchDir, "current-stage.md");
+    if (fsSync.existsSync(devflowBranchFeature)) {
+        return {
+            isBranchScoped: true,
+            branchName,
+            sanitizedBranch: sanitized,
+            branchDir: devflowBranchDir,
+            featureSpecPath: devflowBranchFeature,
+            stagePath: fsSync.existsSync(devflowBranchStage) ? devflowBranchStage : defaultStagePath,
+            findingsPath: defaultFindingsPath
+        };
+    }
+    // Candidate 2: .nexus/branches/<sanitized>/
+    const nexusBranchDir = path.join(projectRoot, ".nexus", "branches", sanitized);
+    const nexusBranchFeature = path.join(nexusBranchDir, "current-feature.md");
+    const nexusBranchStage = path.join(nexusBranchDir, "current-stage.md");
+    if (fsSync.existsSync(nexusBranchFeature)) {
+        return {
+            isBranchScoped: true,
+            branchName,
+            sanitizedBranch: sanitized,
+            branchDir: nexusBranchDir,
+            featureSpecPath: nexusBranchFeature,
+            stagePath: fsSync.existsSync(nexusBranchStage) ? nexusBranchStage : defaultStagePath,
+            findingsPath: defaultFindingsPath
+        };
+    }
+    return {
+        isBranchScoped: false,
+        branchName,
+        sanitizedBranch: sanitized,
+        branchDir: null,
+        featureSpecPath: defaultFeaturePath,
+        stagePath: defaultStagePath,
+        findingsPath: defaultFindingsPath
+    };
+}
+/**
+ * Initializes a branch-scoped context directory under devflow/context/<sanitized>/ (or .nexus/branches/)
+ */
+export async function initBranchContext(projectRoot, branchName, initialSpec, useDevflowContextDir = true) {
+    const sanitized = sanitizeBranchName(branchName);
+    const branchDir = useDevflowContextDir
+        ? path.join(projectRoot, "devflow", "context", sanitized)
+        : path.join(projectRoot, ".nexus", "branches", sanitized);
+    await fs.mkdir(branchDir, { recursive: true });
+    const featurePath = path.join(branchDir, "current-feature.md");
+    const stagePath = path.join(branchDir, "current-stage.md");
+    if (initialSpec) {
+        await fs.writeFile(featurePath, initialSpec, "utf8");
+    }
+    else if (!fsSync.existsSync(featurePath)) {
+        const defaultFeature = path.join(projectRoot, "devflow", "context", "current-feature.md");
+        try {
+            const baseline = await fs.readFile(defaultFeature, "utf8");
+            await fs.writeFile(featurePath, baseline, "utf8");
+        }
+        catch {
+            await fs.writeFile(featurePath, "# Current Feature\n\n_Nothing in progress. Run /feature, /fix, or /rollback to start._\n", "utf8");
+        }
+    }
+    if (!fsSync.existsSync(stagePath)) {
+        const defaultStage = path.join(projectRoot, "devflow", "context", "current-stage.md");
+        try {
+            const baseline = await fs.readFile(defaultStage, "utf8");
+            await fs.writeFile(stagePath, baseline, "utf8");
+        }
+        catch {
+            await fs.writeFile(stagePath, `# Current Stage\n\n- Track: \`fast\`\n- Branch: \`${branchName}\`\n`, "utf8");
+        }
+    }
+    return {
+        isBranchScoped: true,
+        branchName,
+        sanitizedBranch: sanitized,
+        branchDir,
+        featureSpecPath: featurePath,
+        stagePath,
+        findingsPath: path.join(projectRoot, "devflow", "context", "findings.md")
+    };
+}
+/**
+ * Cleans up branch-scoped context directories after completion.
+ */
+export async function cleanupBranchContext(projectRoot, branchName) {
+    const sanitized = sanitizeBranchName(branchName);
+    const devflowBranchDir = path.join(projectRoot, "devflow", "context", sanitized);
+    const nexusBranchDir = path.join(projectRoot, ".nexus", "branches", sanitized);
+    let cleaned = false;
+    try {
+        if (fsSync.existsSync(devflowBranchDir)) {
+            await fs.rm(devflowBranchDir, { recursive: true, force: true });
+            cleaned = true;
+        }
+        if (fsSync.existsSync(nexusBranchDir)) {
+            await fs.rm(nexusBranchDir, { recursive: true, force: true });
+            cleaned = true;
+        }
+        return cleaned;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Lists all active branch isolated contexts.
+ */
+export async function listBranchContexts(projectRoot) {
+    const results = [];
+    const reservedDevflowDirs = new Set(["current-run", "findings.md", "current-feature.md", "current-stage.md", "coding-standards.md", "project-overview.md", "ai-interaction.md"]);
+    // Scan devflow/context/
+    const contextRoot = path.join(projectRoot, "devflow", "context");
+    if (fsSync.existsSync(contextRoot)) {
+        const entries = await fs.readdir(contextRoot, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory() && !reservedDevflowDirs.has(entry.name)) {
+                const dirPath = path.join(contextRoot, entry.name);
+                const specPath = path.join(dirPath, "current-feature.md");
+                results.push({
+                    branch: entry.name,
+                    path: dirPath,
+                    hasSpec: fsSync.existsSync(specPath),
+                    type: "devflow"
+                });
+            }
+        }
+    }
+    // Scan .nexus/branches/
+    const nexusBranchesRoot = path.join(projectRoot, ".nexus", "branches");
+    if (fsSync.existsSync(nexusBranchesRoot)) {
+        const entries = await fs.readdir(nexusBranchesRoot, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const dirPath = path.join(nexusBranchesRoot, entry.name);
+                const specPath = path.join(dirPath, "current-feature.md");
+                results.push({
+                    branch: entry.name,
+                    path: dirPath,
+                    hasSpec: fsSync.existsSync(specPath),
+                    type: "nexus"
+                });
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=branch-context.js.map

package/dist/lib/branch-context.js.map

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

package/dist/lib/code-graph.d.ts

@@ -0,0 +1,30 @@
+export interface CodeGraphNode {
+    filePath: string;
+    imports: string[];
+    importedBy: string[];
+    exports: string[];
+}
+export interface CodeGraph {
+    nodes: Record<string, CodeGraphNode>;
+    totalFiles: number;
+    totalEdges: number;
+}
+export interface BlastRadiusReport {
+    targetFile: string;
+    exists: boolean;
+    directDependents: string[];
+    transitiveDependents: string[];
+    totalAffected: number;
+    impactScore: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+    affectedFiles: string[];
+}
+/**
+ * Builds an In-Memory Codebase Semantic Dependency Graph.
+ */
+export declare function buildCodeGraph(projectRoot: string, options?: {
+    maxFiles?: number;
+}): Promise<CodeGraph>;
+/**
+ * Calculates the Blast Radius (direct and transitive dependents) of a modified target file.
+ */
+export declare function calculateBlastRadius(graph: CodeGraph, targetFile: string): BlastRadiusReport;

package/dist/lib/code-graph.js

@@ -0,0 +1,209 @@
+import fs from "node:fs/promises";
+import fsSync from "node:fs";
+import path from "node:path";
+const SUPPORTED_EXTENSIONS = new Set([".ts", ".js", ".mjs", ".cjs", ".jsx", ".tsx"]);
+const IGNORED_DIRS = new Set([
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    ".nexus",
+    ".agents",
+    ".claude",
+    "coverage"
+]);
+/**
+ * Normalizes file path to forward slashes relative to workspace root.
+ */
+function normalizeRelative(projectRoot, filePath) {
+    const rel = path.isAbsolute(filePath) ? path.relative(projectRoot, filePath) : filePath;
+    return rel.replace(/\\/g, "/").replace(/^\.\//, "");
+}
+/**
+ * Resolves an import specifier relative to the importing file.
+ */
+function resolveImportPath(projectRoot, importingFile, specifier) {
+    if (!specifier.startsWith(".")) {
+        return null; // External package
+    }
+    const baseDir = path.dirname(path.join(projectRoot, importingFile));
+    let resolved = path.join(baseDir, specifier);
+    // Try direct match or common extensions
+    if (fsSync.existsSync(resolved) && fsSync.statSync(resolved).isFile()) {
+        return normalizeRelative(projectRoot, resolved);
+    }
+    const candidates = [
+        resolved,
+        resolved + ".ts",
+        resolved + ".js",
+        resolved + ".tsx",
+        resolved + ".jsx",
+        resolved.replace(/\.js$/, ".ts"),
+        resolved.replace(/\.jsx$/, ".tsx"),
+        path.join(resolved, "index.ts"),
+        path.join(resolved, "index.js")
+    ];
+    for (const c of candidates) {
+        if (fsSync.existsSync(c) && fsSync.statSync(c).isFile()) {
+            return normalizeRelative(projectRoot, c);
+        }
+    }
+    return normalizeRelative(projectRoot, resolved.replace(/\\/g, "/"));
+}
+/**
+ * Parses exports and imports from code contents using regex AST heuristic.
+ */
+function parseModuleSymbols(content) {
+    const imports = [];
+    const exports = [];
+    // Import matches: import ... from "..." or require("...")
+    const importRegex = /(?:import\s+(?:[\w*\s{},$]+from\s+)?['"]([^'"]+)['"])|(?:require\s*\(\s*['"]([^'"]+)['"]\s*\))/g;
+    let match;
+    while ((match = importRegex.exec(content)) !== null) {
+        const spec = match[1] || match[2];
+        if (spec)
+            imports.push(spec);
+    }
+    // Export matches: export { ... } or export const/function/class/interface/type/default
+    const exportRegex = /export\s+(?:default\s+|const\s+|let\s+|var\s+|function\s+|class\s+|interface\s+|type\s+)?([a-zA-Z0-9_$]+)/g;
+    while ((match = exportRegex.exec(content)) !== null) {
+        const sym = match[1];
+        if (sym && !["default", "const", "let", "var", "function", "class", "interface", "type"].includes(sym)) {
+            exports.push(sym);
+        }
+    }
+    return {
+        imports: Array.from(new Set(imports)),
+        exports: Array.from(new Set(exports))
+    };
+}
+/**
+ * Recursively scans directory to collect supported code files.
+ */
+async function collectFiles(dir, projectRoot, fileList = []) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.name.startsWith(".") && entry.name !== ".gitignore")
+            continue;
+        if (IGNORED_DIRS.has(entry.name))
+            continue;
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await collectFiles(fullPath, projectRoot, fileList);
+        }
+        else if (entry.isFile()) {
+            const ext = path.extname(entry.name).toLowerCase();
+            if (SUPPORTED_EXTENSIONS.has(ext)) {
+                fileList.push(normalizeRelative(projectRoot, fullPath));
+            }
+        }
+    }
+    return fileList;
+}
+/**
+ * Builds an In-Memory Codebase Semantic Dependency Graph.
+ */
+export async function buildCodeGraph(projectRoot, options = {}) {
+    const files = await collectFiles(projectRoot, projectRoot);
+    const targetFiles = options.maxFiles ? files.slice(0, options.maxFiles) : files;
+    const nodes = {};
+    // 1. Initialize all nodes
+    for (const file of targetFiles) {
+        nodes[file] = {
+            filePath: file,
+            imports: [],
+            importedBy: [],
+            exports: []
+        };
+    }
+    // 2. Parse symbols and build edges
+    let totalEdges = 0;
+    for (const file of targetFiles) {
+        try {
+            const fullPath = path.join(projectRoot, file);
+            const content = await fs.readFile(fullPath, "utf8");
+            const { imports, exports } = parseModuleSymbols(content);
+            nodes[file].exports = exports;
+            for (const imp of imports) {
+                const resolved = resolveImportPath(projectRoot, file, imp);
+                if (resolved && nodes[resolved]) {
+                    if (!nodes[file].imports.includes(resolved)) {
+                        nodes[file].imports.push(resolved);
+                        totalEdges++;
+                    }
+                    if (!nodes[resolved].importedBy.includes(file)) {
+                        nodes[resolved].importedBy.push(file);
+                    }
+                }
+            }
+        }
+        catch {
+            // Graceful ignore on unreadable files
+        }
+    }
+    return {
+        nodes,
+        totalFiles: Object.keys(nodes).length,
+        totalEdges
+    };
+}
+/**
+ * Calculates the Blast Radius (direct and transitive dependents) of a modified target file.
+ */
+export function calculateBlastRadius(graph, targetFile) {
+    const normalizedTarget = targetFile.replace(/\\/g, "/").replace(/^\.\//, "");
+    const directDependents = [];
+    const transitiveDependents = [];
+    const visited = new Set();
+    // Find exact node or match suffix
+    let targetNodeKey = Object.keys(graph.nodes).find((k) => k === normalizedTarget || k.endsWith(normalizedTarget) || normalizedTarget.endsWith(k));
+    if (!targetNodeKey || !graph.nodes[targetNodeKey]) {
+        return {
+            targetFile: normalizedTarget,
+            exists: false,
+            directDependents: [],
+            transitiveDependents: [],
+            totalAffected: 0,
+            impactScore: "LOW",
+            affectedFiles: []
+        };
+    }
+    const direct = graph.nodes[targetNodeKey].importedBy;
+    directDependents.push(...direct);
+    visited.add(targetNodeKey);
+    const queue = [...direct];
+    for (const d of direct)
+        visited.add(d);
+    while (queue.length > 0) {
+        const current = queue.shift();
+        const node = graph.nodes[current];
+        if (node && node.importedBy) {
+            for (const parent of node.importedBy) {
+                if (!visited.has(parent)) {
+                    visited.add(parent);
+                    transitiveDependents.push(parent);
+                    queue.push(parent);
+                }
+            }
+        }
+    }
+    const totalAffected = directDependents.length + transitiveDependents.length;
+    let impactScore = "LOW";
+    if (totalAffected >= 10)
+        impactScore = "CRITICAL";
+    else if (totalAffected >= 5)
+        impactScore = "HIGH";
+    else if (totalAffected >= 2)
+        impactScore = "MEDIUM";
+    const affectedFiles = Array.from(new Set([...directDependents, ...transitiveDependents]));
+    return {
+        targetFile: targetNodeKey,
+        exists: true,
+        directDependents,
+        transitiveDependents,
+        totalAffected,
+        impactScore,
+        affectedFiles
+    };
+}
+//# sourceMappingURL=code-graph.js.map

package/dist/lib/code-graph.js.map

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

package/dist/lib/context-slicer.d.ts

@@ -0,0 +1,31 @@
+export type SliceStage = "implement" | "check" | "explore" | "feature" | "status";
+export interface SliceOptions {
+    maxTokens?: number;
+    taskIndex?: number;
+    customBranch?: string;
+}
+export interface ContextSliceSection {
+    name: string;
+    tokens: number;
+    content: string;
+}
+export interface ContextSliceResult {
+    stage: SliceStage;
+    estimatedTokens: number;
+    rawTokens: number;
+    reductionPercentage: number;
+    content: string;
+    sections: ContextSliceSection[];
+}
+/**
+ * Estimates token count for text using standard character/word heuristic for mixed markdown/code.
+ */
+export declare function estimateTokenCount(text: string): number;
+/**
+ * Parses markdown into discrete sections by headings (## or ###) and filters by allowed patterns.
+ */
+export declare function pruneMarkdownSections(markdown: string, allowedHeadingPatterns: RegExp[], maxTokens?: number): string;
+/**
+ * Creates a stage-aware context slice for AI agents, omitting irrelevant sections.
+ */
+export declare function sliceContextForStage(projectRoot: string, stage: SliceStage, options?: SliceOptions): Promise<ContextSliceResult>;