@jakkrichm/create-nexus-devflow 2.0.15 → 2.0.18

package/dist/lib/findings.js

@@ -0,0 +1,110 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+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 readFindings(projectRoot) {
+    let findingsPath = path.join(projectRoot, DEVFLOW_FINDINGS_PATH);
+    try {
+        let stats = await fs.lstat(findingsPath);
+        if (!stats.isFile()) {
+            const altPath = path.join(projectRoot, BLUEPRINT_FINDINGS_PATH);
+            const altStats = await fs.lstat(altPath).catch(() => null);
+            if (altStats?.isFile()) {
+                findingsPath = altPath;
+                stats = altStats;
+            }
+        }
+        if (stats.isSymbolicLink()) {
+            return emptySummary({
+                code: "unsafe_findings_path",
+                message: "Findings file is a symbolic link and was not read."
+            });
+        }
+        if (!stats.isFile()) {
+            return emptySummary({
+                code: "invalid_findings_path",
+                message: "Findings path is not a regular file."
+            });
+        }
+        return parseFindings(await fs.readFile(findingsPath, "utf8"));
+    }
+    catch (error) {
+        if (getErrorCode(error) === "ENOENT") {
+            try {
+                const altPath = path.join(projectRoot, BLUEPRINT_FINDINGS_PATH);
+                const altContent = await fs.readFile(altPath, "utf8");
+                return parseFindings(altContent);
+            }
+            catch {
+                return emptySummary();
+            }
+        }
+        throw error;
+    }
+}
+function parseFindings(markdown) {
+    const items = [];
+    let malformed = false;
+    for (const [index, line] of markdown.split(/\r?\n/).entries()) {
+        const match = line.match(FINDING_PATTERN);
+        if (match) {
+            items.push({
+                id: match[1] || "",
+                severity: (match[2] || "").toUpperCase(),
+                status: (match[3] || "").toLowerCase(),
+                title: (match[4] || "").trim(),
+                line: index + 1
+            });
+        }
+        else if (/^###\s+\S+\s+\[P/i.test(line)) {
+            malformed = true;
+        }
+    }
+    const byStatus = createStatusCounts();
+    for (const finding of items) {
+        byStatus[finding.status] += 1;
+    }
+    return {
+        items,
+        total: items.length,
+        byStatus,
+        blockers: items.filter((finding) => (finding.severity === "P0" || finding.severity === "P1") &&
+            (finding.status === "open" || finding.status === "fixed")),
+        warnings: malformed
+            ? [{
+                    code: "malformed_findings",
+                    message: "One or more finding headings do not match the required ledger format."
+                }]
+            : []
+    };
+}
+function createStatusCounts() {
+    return {
+        unverified: 0,
+        open: 0,
+        fixed: 0,
+        closed: 0,
+        accepted: 0,
+        invalid: 0
+    };
+}
+function emptySummary(warning) {
+    return {
+        items: [],
+        total: 0,
+        byStatus: createStatusCounts(),
+        blockers: [],
+        warnings: warning ? [warning] : []
+    };
+}
+function getErrorCode(error) {
+    return typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        typeof error.code === "string"
+        ? error.code
+        : undefined;
+}
+export { DEVFLOW_FINDINGS_PATH, parseFindings, readFindings };
+//# sourceMappingURL=findings.js.map

package/dist/lib/findings.js.map

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

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

@@ -0,0 +1,13 @@
+interface GitStatusSummary {
+    available: boolean;
+    branch: string | null;
+    clean: boolean | null;
+    changedFiles: number;
+    lastCommit: string | null;
+    upstream: string | null;
+    ahead: number | null;
+    behind: number | null;
+}
+declare function readGitStatus(projectRoot: string): Promise<GitStatusSummary>;
+export { readGitStatus };
+export type { GitStatusSummary };

package/dist/lib/git-status.js

@@ -0,0 +1,98 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+async function readGitStatus(projectRoot) {
+    if (!(await isGitRepository(projectRoot))) {
+        return unavailableSummary();
+    }
+    const porcelain = await runGit(projectRoot, [
+        "status",
+        "--porcelain=v1",
+        "--untracked-files=all"
+    ]);
+    const changedFiles = porcelain
+        .split(/\r?\n/)
+        .filter((line) => line.length > 0)
+        .length;
+    const branch = await readBranch(projectRoot);
+    const lastCommit = await runOptionalGit(projectRoot, [
+        "log",
+        "-1",
+        "--format=%s"
+    ]);
+    const upstream = await runOptionalGit(projectRoot, [
+        "rev-parse",
+        "--abbrev-ref",
+        "--symbolic-full-name",
+        "@{upstream}"
+    ]);
+    const divergence = upstream
+        ? await readDivergence(projectRoot)
+        : { ahead: null, behind: null };
+    return {
+        available: true,
+        branch,
+        clean: changedFiles === 0,
+        changedFiles,
+        lastCommit,
+        upstream,
+        ahead: divergence.ahead,
+        behind: divergence.behind
+    };
+}
+async function isGitRepository(projectRoot) {
+    return (await runOptionalGit(projectRoot, [
+        "rev-parse",
+        "--is-inside-work-tree"
+    ])) === "true";
+}
+async function readBranch(projectRoot) {
+    const branch = await runOptionalGit(projectRoot, [
+        "symbolic-ref",
+        "--quiet",
+        "--short",
+        "HEAD"
+    ]);
+    return branch || "(detached HEAD)";
+}
+async function readDivergence(projectRoot) {
+    const counts = await runOptionalGit(projectRoot, [
+        "rev-list",
+        "--left-right",
+        "--count",
+        "HEAD...@{upstream}"
+    ]);
+    const match = counts?.match(/^(\d+)\s+(\d+)$/);
+    return match
+        ? { ahead: Number(match[1]), behind: Number(match[2]) }
+        : { ahead: null, behind: null };
+}
+async function runOptionalGit(projectRoot, args) {
+    try {
+        return await runGit(projectRoot, args);
+    }
+    catch {
+        return null;
+    }
+}
+async function runGit(projectRoot, args) {
+    const result = await execFileAsync("git", ["-C", projectRoot, ...args], {
+        encoding: "utf8",
+        maxBuffer: 1024 * 1024
+    });
+    return result.stdout.trim();
+}
+function unavailableSummary() {
+    return {
+        available: false,
+        branch: null,
+        clean: null,
+        changedFiles: 0,
+        lastCommit: null,
+        upstream: null,
+        ahead: null,
+        behind: null
+    };
+}
+export { readGitStatus };
+//# sourceMappingURL=git-status.js.map

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

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

package/dist/lib/project-metadata.d.ts

@@ -0,0 +1,22 @@
+declare const PROJECT_STATE_SCHEMA_VERSION: 1;
+type ProjectAdapter = "codex" | "claude" | "antigravity";
+interface ProjectWarning {
+    code: "invalid_manifest";
+    message: string;
+}
+interface ProjectMetadata {
+    schemaVersion: typeof PROJECT_STATE_SCHEMA_VERSION;
+    project: {
+        name: string;
+        root: string;
+    };
+    devflow: {
+        version: string | null;
+        adapters: ProjectAdapter[];
+    };
+    warnings: ProjectWarning[];
+}
+declare function readProjectMetadata(startPath?: string): Promise<ProjectMetadata>;
+declare function detectAdapters(projectRoot: string): Promise<ProjectAdapter[]>;
+export { PROJECT_STATE_SCHEMA_VERSION, detectAdapters, readProjectMetadata };
+export type { ProjectAdapter, ProjectMetadata, ProjectWarning };

package/dist/lib/project-metadata.js

@@ -0,0 +1,84 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { findProjectRoot } from "./project-root.js";
+import { readManifest } from "./update.js";
+const PROJECT_STATE_SCHEMA_VERSION = 1;
+const ADAPTER_PATHS = {
+    codex: path.join(".agents", "skills"),
+    claude: path.join(".claude", "skills"),
+    antigravity: path.join(".agents", "skills")
+};
+async function readProjectMetadata(startPath = process.cwd()) {
+    const projectRoot = await findProjectRoot(startPath);
+    if (!projectRoot) {
+        throw new Error(`No Nexus-DevFlow project found from: ${path.resolve(startPath)}`);
+    }
+    const warnings = [];
+    let manifest = null;
+    try {
+        manifest = await readManifest(projectRoot);
+    }
+    catch (error) {
+        warnings.push({
+            code: "invalid_manifest",
+            message: error instanceof Error ? error.message : String(error)
+        });
+    }
+    let projectVersion = manifest?.version || null;
+    if (!projectVersion) {
+        try {
+            const packageJsonPath = path.join(projectRoot, "package.json");
+            const packageContent = await fs.readFile(packageJsonPath, "utf8");
+            const pkg = JSON.parse(packageContent);
+            if (pkg.version) {
+                projectVersion = pkg.version;
+            }
+        }
+        catch {
+            // Ignore fallback failure
+        }
+    }
+    return {
+        schemaVersion: PROJECT_STATE_SCHEMA_VERSION,
+        project: {
+            name: path.basename(projectRoot),
+            root: projectRoot
+        },
+        devflow: {
+            version: projectVersion,
+            adapters: await detectAdapters(projectRoot)
+        },
+        warnings
+    };
+}
+async function detectAdapters(projectRoot) {
+    const adapters = [];
+    for (const adapter of ["codex", "claude"]) {
+        if (await isDirectory(path.join(projectRoot, ADAPTER_PATHS[adapter]))) {
+            adapters.push(adapter);
+        }
+    }
+    return adapters;
+}
+async function isDirectory(targetPath) {
+    try {
+        return (await fs.lstat(targetPath)).isDirectory();
+    }
+    catch (error) {
+        const code = getErrorCode(error);
+        if (code === "ENOENT" || code === "ENOTDIR") {
+            return false;
+        }
+        throw error;
+    }
+}
+function getErrorCode(error) {
+    return typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        typeof error.code === "string"
+        ? error.code
+        : undefined;
+}
+export { PROJECT_STATE_SCHEMA_VERSION, detectAdapters, readProjectMetadata };
+//# sourceMappingURL=project-metadata.js.map

package/dist/lib/project-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-metadata.js","sourceRoot":"","sources":["../../lib/project-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,4BAA4B,GAAG,CAAU,CAAC;AAqBhD,MAAM,aAAa,GAAmC;IACpD,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;IACrC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;IACtC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;CAC5C,CAAC;AAEF,KAAK,UAAU,mBAAmB,CAChC,YAAoB,OAAO,CAAC,GAAG,EAAE;IAEjC,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IAErD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,IAAI,QAAQ,GAAG,IAAI,CAAC;IAEpB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,cAAc,GAAG,QAAQ,EAAE,OAAO,IAAI,IAAI,CAAC;IAC/C,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;YAC/D,MAAM,cAAc,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;YAClE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAyB,CAAC;YAC/D,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAChB,cAAc,GAAG,GAAG,CAAC,OAAO,CAAC;YAC/B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC;IAED,OAAO;QACL,aAAa,EAAE,4BAA4B;QAC3C,OAAO,EAAE;YACP,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;YAChC,IAAI,EAAE,WAAW;SAClB;QACD,OAAO,EAAE;YACP,OAAO,EAAE,cAAc;YACvB,QAAQ,EAAE,MAAM,cAAc,CAAC,WAAW,CAAC;SAC5C;QACD,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,WAAmB;IAC/C,MAAM,QAAQ,GAAqB,EAAE,CAAC;IAEtC,KAAK,MAAM,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAU,EAAE,CAAC;QACnD,IAAI,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,UAAkB;IAC3C,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAEjC,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ;QAC9B,KAAK,KAAK,IAAI;QACd,MAAM,IAAI,KAAK;QACf,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,CAAC,CAAC,KAAK,CAAC,IAAI;QACZ,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,OAAO,EACL,4BAA4B,EAC5B,cAAc,EACd,mBAAmB,EACpB,CAAC"}

package/dist/lib/project-root.d.ts

@@ -0,0 +1,3 @@
+declare function findProjectRoot(startPath?: string): Promise<string | null>;
+declare function isDevFlowProjectRoot(directory: string): Promise<boolean>;
+export { findProjectRoot, isDevFlowProjectRoot };

package/dist/lib/project-root.js

@@ -0,0 +1,76 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+const DEVFLOW_MANIFEST_PATH = path.join("devflow", ".state", "manifest.json");
+const BLUEPRINT_MANIFEST_PATH = path.join("blueprint", ".state", "manifest.json");
+async function findProjectRoot(startPath = process.cwd()) {
+    const resolvedStart = await fs.realpath(startPath);
+    const stats = await fs.stat(resolvedStart);
+    let currentDir = stats.isDirectory()
+        ? resolvedStart
+        : path.dirname(resolvedStart);
+    while (true) {
+        if (await isDevFlowProjectRoot(currentDir)) {
+            return currentDir;
+        }
+        const parentDir = path.dirname(currentDir);
+        if (parentDir === currentDir) {
+            return null;
+        }
+        currentDir = parentDir;
+    }
+}
+async function isDevFlowProjectRoot(directory) {
+    const devflowDir = path.join(directory, "devflow");
+    const blueprintDir = path.join(directory, "blueprint");
+    const hasDevFlowDir = await isDirectory(devflowDir);
+    const hasBlueprintDir = await isDirectory(blueprintDir);
+    if (!hasDevFlowDir && !hasBlueprintDir) {
+        return false;
+    }
+    return ((await hasInstallManifest(directory)) ||
+        (await isFile(path.join(directory, "AGENTS.md"))));
+}
+async function hasInstallManifest(directory) {
+    const devflowStateDir = path.join(directory, "devflow", ".state");
+    const blueprintStateDir = path.join(directory, "blueprint", ".state");
+    if ((await isDirectory(devflowStateDir)) &&
+        (await isFile(path.join(directory, DEVFLOW_MANIFEST_PATH)))) {
+        return true;
+    }
+    return ((await isDirectory(blueprintStateDir)) &&
+        (await isFile(path.join(directory, BLUEPRINT_MANIFEST_PATH))));
+}
+async function isDirectory(targetPath) {
+    try {
+        return (await fs.lstat(targetPath)).isDirectory();
+    }
+    catch (error) {
+        const code = getErrorCode(error);
+        if (code === "ENOENT" || code === "ENOTDIR") {
+            return false;
+        }
+        throw error;
+    }
+}
+async function isFile(targetPath) {
+    try {
+        return (await fs.lstat(targetPath)).isFile();
+    }
+    catch (error) {
+        const code = getErrorCode(error);
+        if (code === "ENOENT" || code === "ENOTDIR") {
+            return false;
+        }
+        throw error;
+    }
+}
+function getErrorCode(error) {
+    return typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        typeof error.code === "string"
+        ? error.code
+        : undefined;
+}
+export { findProjectRoot, isDevFlowProjectRoot };
+//# sourceMappingURL=project-root.js.map

package/dist/lib/project-root.js.map

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

package/dist/lib/status.d.ts

@@ -0,0 +1,62 @@
+import type { CurrentWorkSummary, CurrentWorkType } from "./current-work.js";
+import type { Finding, FindingStatus } from "./findings.js";
+import type { GitStatusSummary } from "./git-status.js";
+import type { ProjectAdapter } from "./project-metadata.js";
+type CompletionState = "blocked" | "needs_verification" | "ready";
+interface StatusWarning {
+    code: string;
+    message: string;
+}
+interface StatusCurrentWork {
+    state: CurrentWorkSummary["state"];
+    type: CurrentWorkType | null;
+    title: string | null;
+    status: string | null;
+    runId: string | null;
+    completed: number;
+    remaining: number;
+    total: number;
+    nextStep: {
+        title: string;
+    } | null;
+}
+interface StatusFindings {
+    total: number;
+    byStatus: Record<FindingStatus, number>;
+    active: Array<Pick<Finding, "id" | "severity" | "status" | "title">>;
+    blockers: Array<Pick<Finding, "id" | "severity" | "status" | "title">>;
+}
+interface StatusNextAction {
+    command: string | null;
+    reason: string;
+}
+interface StatusCompletion {
+    state: CompletionState;
+    blockers: string[];
+}
+interface HumanStatusOptions {
+    color?: boolean;
+}
+interface ProjectStatus {
+    schemaVersion: 1;
+    health: "ok" | "warning";
+    project: {
+        name: string;
+        root: string;
+    };
+    devflow: {
+        version: string | null;
+        adapters: ProjectAdapter[];
+    };
+    currentWork: StatusCurrentWork;
+    findings: StatusFindings;
+    git: GitStatusSummary;
+    completion: StatusCompletion;
+    nextAction: StatusNextAction;
+    warnings: StatusWarning[];
+}
+declare function readProjectStatus(startPath?: string): Promise<ProjectStatus>;
+declare function formatHumanStatus(status: ProjectStatus, options?: HumanStatusOptions): string;
+declare function shouldUseColor(isTTY?: boolean | undefined, environment?: NodeJS.ProcessEnv): boolean;
+export { formatHumanStatus, readProjectStatus, shouldUseColor };
+export type { CompletionState, HumanStatusOptions, ProjectStatus, StatusCompletion, StatusCurrentWork, StatusFindings, StatusNextAction, StatusWarning };