@jakkrichm/create-nexus-devflow 2.0.12 → 2.0.14

package/dist/bin/create-nexus-devflow.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/create-nexus-devflow.js

@@ -0,0 +1,233 @@
+#!/usr/bin/env node
+import fsSync from "node:fs";
+import path from "node:path";
+import readline from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+import { applyPreparedUpdate, prepareUpdate } from "../lib/update.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(__dirname, "..", "..");
+const templateRoot = path.join(packageRoot, "template");
+const adapterChoices = new Set(["codex", "antigravity", "claude", "both", "all"]);
+async function main() {
+    const options = parseArgs(process.argv.slice(2));
+    if (options.help) {
+        printHelp();
+        return;
+    }
+    if (options.version) {
+        console.log(readPackageVersion());
+        return;
+    }
+    if (!fsSync.existsSync(templateRoot)) {
+        throw new Error("Installer template is missing. Run `npm run prepare-template` before local testing.");
+    }
+    const targetDir = path.resolve(process.cwd(), options.target || ".");
+    const version = readPackageVersion();
+    if (options.command === "update") {
+        const prepared = await prepareUpdate({
+            targetDir,
+            templateRoot,
+            version,
+            adapter: options.adapter
+        });
+        printUpdatePlan(prepared);
+        if (options.dryRun) {
+            return;
+        }
+        const replaceConflicts = options.force || (await confirmUpdateConflicts(prepared, options));
+        const result = await applyPreparedUpdate(prepared, { replaceConflicts });
+        printUpdateSuccess(prepared, result);
+        return;
+    }
+    const prepared = await prepareUpdate({
+        targetDir,
+        templateRoot,
+        version,
+        adapter: options.adapter
+    });
+    printInstallPlan(prepared);
+    if (options.dryRun) {
+        return;
+    }
+    if (prepared.conflictList.length > 0 && !options.force) {
+        const proceed = await confirmInstallConflicts(prepared, options);
+        if (!proceed) {
+            console.log("Install cancelled.");
+            return;
+        }
+    }
+    const result = await applyPreparedUpdate(prepared, {
+        replaceConflicts: options.force || prepared.conflictList.length > 0
+    });
+    printInstallSuccess(targetDir, result);
+}
+function parseArgs(args) {
+    let command = "install";
+    let target = null;
+    let adapter = "both";
+    let force = false;
+    let dryRun = false;
+    let help = false;
+    let version = false;
+    let yes = false;
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--help" || arg === "-h") {
+            help = true;
+            continue;
+        }
+        if (arg === "--version" || arg === "-v") {
+            version = true;
+            continue;
+        }
+        if (arg === "--force" || arg === "-f") {
+            force = true;
+            continue;
+        }
+        if (arg === "--dry-run") {
+            dryRun = true;
+            continue;
+        }
+        if (arg === "-y" || arg === "--yes") {
+            yes = true;
+            continue;
+        }
+        if (arg === "--adapter") {
+            const value = args[++i];
+            if (!value || !adapterChoices.has(value.toLowerCase())) {
+                throw new Error(`Invalid --adapter value "${value}". Expected one of: codex, antigravity, claude, both, all`);
+            }
+            adapter = value.toLowerCase();
+            continue;
+        }
+        if (arg.startsWith("--adapter=")) {
+            const value = arg.slice("--adapter=".length);
+            if (!adapterChoices.has(value.toLowerCase())) {
+                throw new Error(`Invalid --adapter value "${value}". Expected one of: codex, antigravity, claude, both, all`);
+            }
+            adapter = value.toLowerCase();
+            continue;
+        }
+        if (arg.startsWith("-")) {
+            throw new Error(`Unknown option "${arg}". Use --help to see available options.`);
+        }
+        positional.push(arg);
+    }
+    if (positional.length > 0) {
+        if (positional[0] === "update") {
+            command = "update";
+            target = positional[1] || ".";
+        }
+        else {
+            target = positional[0];
+        }
+    }
+    return {
+        command,
+        target,
+        adapter,
+        force,
+        dryRun,
+        help,
+        version,
+        yes
+    };
+}
+function readPackageVersion() {
+    const pkgPath = path.join(packageRoot, "package.json");
+    const content = fsSync.readFileSync(pkgPath, "utf8");
+    return JSON.parse(content).version;
+}
+function printHelp() {
+    console.log(`
+Nexus-DevFlow Installer v${readPackageVersion()}
+
+Usage:
+  npx @jakkrichm/create-nexus-devflow [target-dir] [options]
+  npx @jakkrichm/create-nexus-devflow update [target-dir] [options]
+
+Options:
+  --adapter <name>   Tool adapters to install: codex, antigravity, claude, both (default: both)
+  --force, -f        Overwrite conflicting files without prompting
+  --dry-run          Preview changes without modifying disk
+  -y, --yes          Automatically confirm interactive prompts
+  --version, -v      Show version number
+  --help, -h         Show help screen
+`);
+}
+function printInstallPlan(prepared) {
+    console.log(`\nNexus-DevFlow v${readPackageVersion()}`);
+    console.log(`Target Directory: ${prepared.targetDir}`);
+    console.log(`Active Adapters : ${prepared.activeAdapters.join(", ")}\n`);
+    console.log(`Files to create : ${prepared.createList.length}`);
+    console.log(`Files to update : ${prepared.updateList.length}`);
+    console.log(`Conflicts found : ${prepared.conflictList.length}`);
+    if (prepared.conflictList.length > 0) {
+        console.log("\nConflicting files:");
+        for (const conflict of prepared.conflictList) {
+            console.log(`  - ${conflict.relativePath} (${conflict.detail})`);
+        }
+    }
+}
+function printUpdatePlan(prepared) {
+    console.log(`\nNexus-DevFlow Update Plan (v${readPackageVersion()})`);
+    console.log(`Target Directory: ${prepared.targetDir}`);
+    console.log(`Active Adapters : ${prepared.activeAdapters.join(", ")}\n`);
+    console.log(`Files to create : ${prepared.createList.length}`);
+    console.log(`Files to update : ${prepared.updateList.length}`);
+    console.log(`Orphaned files  : ${prepared.orphanedFiles.length}`);
+    console.log(`Conflicts found : ${prepared.conflictList.length}`);
+}
+async function confirmInstallConflicts(prepared, options) {
+    if (options.yes)
+        return true;
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    const answer = await rl.question(`\nOverwrite ${prepared.conflictList.length} conflicting file(s)? [y/N] `);
+    rl.close();
+    return answer.trim().toLowerCase() === "y";
+}
+async function confirmUpdateConflicts(prepared, options) {
+    if (options.yes)
+        return true;
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    const answer = await rl.question(`\nOverwrite ${prepared.conflictList.length} customized file(s) with update? [y/N] `);
+    rl.close();
+    return answer.trim().toLowerCase() === "y";
+}
+function printNextSteps() {
+    console.log("\nNext steps in your AI IDE (Antigravity, Claude Code, Codex, etc.):");
+    console.log("  1. Project Setup & Baseline:");
+    console.log("     - Existing project : Run `/adopt` (or `$adopt`) to scan codebase and bootstrap context.");
+    console.log("     - Fresh project    : Run `/onboard` (or `$onboard`) to configure project baseline.");
+    console.log("  2. System Health & CI:");
+    console.log("     - Health check     : Run `/doctor` (or `$doctor`) to verify adapters and setup.");
+    console.log("     - CI configuration : Run `/ci` (or `$ci`) to setup GitHub Actions workflow.");
+    console.log("  3. Delivery Flow:");
+    console.log("     - Interactive guide: Run `/devflow` (or `$devflow`) for state & routing assistance.");
+    console.log("     - Start new work   : Run `/00-discover` (or `$00-discover`) to begin delivery lifecycle.");
+}
+function printInstallSuccess(targetDir, result) {
+    console.log("\nNexus-DevFlow overlay successfully installed!");
+    console.log(`Applied ${result.appliedCount} file(s).`);
+    printNextSteps();
+}
+function printUpdateSuccess(prepared, result) {
+    console.log("\nNexus-DevFlow update successfully applied!");
+    console.log(`Applied ${result.appliedCount} file(s), removed ${result.removedCount} orphaned file(s).`);
+    printNextSteps();
+}
+if (process.argv[1] &&
+    fsSync.realpathSync(process.argv[1]) === fsSync.realpathSync(fileURLToPath(import.meta.url))) {
+    main().catch((err) => {
+        console.error(`\nError: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=create-nexus-devflow.js.map

package/dist/bin/create-nexus-devflow.js.map

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

package/dist/lib/starter-templates.d.ts

@@ -0,0 +1,6 @@
+export interface StarterTemplate {
+    name: string;
+    description: string;
+    files: Record<string, string>;
+}
+export declare const starterTemplates: Record<string, StarterTemplate>;

package/dist/lib/starter-templates.js

@@ -0,0 +1,8 @@
+export const starterTemplates = {
+    default: {
+        name: "default",
+        description: "Default Nexus-DevFlow workspace configuration",
+        files: {}
+    }
+};
+//# sourceMappingURL=starter-templates.js.map

package/dist/lib/starter-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"starter-templates.js","sourceRoot":"","sources":["../../lib/starter-templates.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,gBAAgB,GAAoC;IAC/D,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,+CAA+C;QAC5D,KAAK,EAAE,EAAE;KACV;CACF,CAAC"}

package/dist/lib/update.d.ts

@@ -0,0 +1,68 @@
+export declare const CONTROL_DIR = ".nexus";
+export declare const MANIFEST_PATH = ".nexus/nexus-devflow.json";
+export declare const MANIFEST_SCHEMA_VERSION = 1;
+export declare const MANAGED_ROOTS: Record<string, string[]>;
+export interface Manifest {
+    schemaVersion: number;
+    name: string;
+    package: string;
+    version: string;
+    repository: string;
+    artifactLanguage: string;
+    adapters: string[];
+    workspace: {
+        contextDir: string;
+        historyDir: string;
+        referenceDir: string;
+        runsDir: string;
+        discoveriesDir: string;
+    };
+    lifecycle: {
+        mainlineStages: string[];
+        companionCommands: string[];
+    };
+    managedFiles: Record<string, string>;
+}
+export interface TemplateFile {
+    source: string;
+    hash: string;
+}
+export interface Conflict {
+    relativePath: string;
+    reason: "symlink" | "not_file" | "customized";
+    detail: string;
+}
+export interface PreparedUpdate {
+    targetDir: string;
+    templateRoot: string;
+    previousManifest: Manifest | null;
+    nextManifest: Manifest;
+    activeAdapters: string[];
+    templateFiles: Map<string, TemplateFile>;
+    createList: string[];
+    updateList: string[];
+    conflictList: Conflict[];
+    orphanedFiles: string[];
+}
+export declare function adapterListFromMode(adapter?: string): string[];
+export declare function createManifest(version: string, adapters: Iterable<string>, templateFiles: Map<string, TemplateFile>): Manifest;
+export declare function collectManagedTemplateFiles(templateRoot: string, adapters: string[]): Promise<Map<string, TemplateFile>>;
+export declare function readManifest(targetDir: string): Promise<Manifest | null>;
+export declare function prepareUpdate({ targetDir, templateRoot, version, adapter }: {
+    targetDir: string;
+    templateRoot: string;
+    version: string;
+    adapter?: string;
+}): Promise<PreparedUpdate>;
+export declare function applyPreparedUpdate(prepared: PreparedUpdate, { replaceConflicts }?: {
+    replaceConflicts?: boolean;
+}): Promise<{
+    appliedCount: number;
+    removedCount: number;
+}>;
+export declare function cleanEmptyParentDirectories(targetDir: string, filePath: string): Promise<void>;
+export declare function writeInstallManifest(targetDir: string, manifest: Manifest): Promise<void>;
+export declare function copyFileAtomic(targetDir: string, relativePath: string, sourcePath: string): Promise<void>;
+export declare function targetPath(targetDir: string, relativePath: string): string;
+export declare function assertNoSymlinkParents(targetDir: string, relativePath: string): Promise<void>;
+export declare function hashFile(filePath: string): Promise<string>;

package/dist/lib/update.js

@@ -0,0 +1,325 @@
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+export const CONTROL_DIR = ".nexus";
+export const MANIFEST_PATH = `${CONTROL_DIR}/nexus-devflow.json`;
+export const MANIFEST_SCHEMA_VERSION = 1;
+export const MANAGED_ROOTS = {
+    common: ["AGENTS.md", "CLAUDE.md", "devflow", "LICENSE"],
+    codex: [".agents/skills"],
+    antigravity: [".agents/skills", ".agent/workflows"],
+    claude: [".claude/skills"]
+};
+export function adapterListFromMode(adapter) {
+    if (!adapter || adapter === "both" || adapter === "all") {
+        return ["codex", "claude"];
+    }
+    if (adapter === "antigravity") {
+        return ["codex"];
+    }
+    if (adapter === "codex" || adapter === "claude") {
+        return [adapter];
+    }
+    throw new Error(`Unknown adapter mode: ${adapter}`);
+}
+export function createManifest(version, adapters, templateFiles) {
+    const managedFiles = {};
+    for (const [relativePath, file] of [...templateFiles.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+        managedFiles[relativePath] = file.hash;
+    }
+    return {
+        schemaVersion: MANIFEST_SCHEMA_VERSION,
+        name: "nexus-devflow",
+        package: "@jakkrichm/create-nexus-devflow",
+        version,
+        repository: "https://github.com/Jakkrich/nexus-devflow",
+        artifactLanguage: "th",
+        adapters: [...adapters].sort(),
+        workspace: {
+            contextDir: "devflow/context",
+            historyDir: "devflow/history",
+            referenceDir: "devflow/reference",
+            runsDir: "devflow/runs",
+            discoveriesDir: "devflow/discoveries"
+        },
+        lifecycle: {
+            mainlineStages: [
+                "00-discover",
+                "10-define",
+                "20-spec",
+                "30-plan",
+                "40-implement",
+                "50-verify",
+                "60-report",
+                "70-release"
+            ],
+            companionCommands: [
+                "goal",
+                "brainstorm",
+                "research",
+                "debug",
+                "prd",
+                "issue-triage",
+                "security-review",
+                "check-for-updates",
+                "help"
+            ]
+        },
+        managedFiles
+    };
+}
+export async function collectManagedTemplateFiles(templateRoot, adapters) {
+    const files = new Map();
+    const roots = [
+        ...MANAGED_ROOTS.common,
+        ...adapters.flatMap((adapter) => MANAGED_ROOTS[adapter] || [])
+    ];
+    for (const relativeRoot of roots) {
+        const sourceRoot = path.join(templateRoot, ...relativeRoot.split("/"));
+        await collectSourceFiles(sourceRoot, relativeRoot, files);
+    }
+    return files;
+}
+async function collectSourceFiles(sourcePath, relativePath, files) {
+    try {
+        const stats = await fs.lstat(sourcePath);
+        if (stats.isSymbolicLink()) {
+            throw new Error(`Managed template path cannot be a symbolic link: ${relativePath}`);
+        }
+        if (stats.isDirectory()) {
+            const children = (await fs.readdir(sourcePath)).sort();
+            for (const child of children) {
+                await collectSourceFiles(path.join(sourcePath, child), `${relativePath}/${child}`, files);
+            }
+            return;
+        }
+        if (!stats.isFile()) {
+            throw new Error(`Managed template path is not a regular file: ${relativePath}`);
+        }
+        files.set(relativePath, {
+            source: sourcePath,
+            hash: await hashFile(sourcePath)
+        });
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return;
+        }
+        throw err;
+    }
+}
+export async function readManifest(targetDir) {
+    const manifestFile = targetPath(targetDir, MANIFEST_PATH);
+    await assertNoSymlinkParents(targetDir, MANIFEST_PATH);
+    try {
+        const content = await fs.readFile(manifestFile, "utf8");
+        const data = JSON.parse(content);
+        if (!data || data.schemaVersion !== MANIFEST_SCHEMA_VERSION) {
+            throw new Error("Unsupported manifest schema version.");
+        }
+        return data;
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function prepareUpdate({ targetDir, templateRoot, version, adapter }) {
+    const requestedAdapters = new Set(adapterListFromMode(adapter));
+    const previousManifest = await readManifest(targetDir);
+    const activeAdapters = new Set([
+        ...requestedAdapters,
+        ...(previousManifest?.adapters || [])
+    ]);
+    const templateFiles = await collectManagedTemplateFiles(templateRoot, [...activeAdapters]);
+    const nextManifest = createManifest(version, activeAdapters, templateFiles);
+    const createList = [];
+    const updateList = [];
+    const conflictList = [];
+    for (const [relativePath, templateFile] of templateFiles) {
+        await assertNoSymlinkParents(targetDir, relativePath);
+        const targetFile = targetPath(targetDir, relativePath);
+        let targetStats = null;
+        try {
+            targetStats = await fs.lstat(targetFile);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+        }
+        if (!targetStats) {
+            createList.push(relativePath);
+            continue;
+        }
+        if (targetStats.isSymbolicLink()) {
+            conflictList.push({
+                relativePath,
+                reason: "symlink",
+                detail: "Target path is a symbolic link."
+            });
+            continue;
+        }
+        if (!targetStats.isFile()) {
+            conflictList.push({
+                relativePath,
+                reason: "not_file",
+                detail: "Target path exists but is not a regular file."
+            });
+            continue;
+        }
+        const currentHash = await hashFile(targetFile);
+        if (currentHash === templateFile.hash) {
+            continue;
+        }
+        const recordedHash = previousManifest?.managedFiles?.[relativePath];
+        if (recordedHash && recordedHash === currentHash) {
+            updateList.push(relativePath);
+            continue;
+        }
+        conflictList.push({
+            relativePath,
+            reason: "customized",
+            detail: recordedHash
+                ? "File was modified locally since last install."
+                : "File exists in project and differs from template."
+        });
+    }
+    const orphanedFiles = [];
+    if (previousManifest) {
+        for (const [relativePath, recordedHash] of Object.entries(previousManifest.managedFiles)) {
+            if (templateFiles.has(relativePath)) {
+                continue;
+            }
+            await assertNoSymlinkParents(targetDir, relativePath);
+            const targetFile = targetPath(targetDir, relativePath);
+            let targetStats = null;
+            try {
+                targetStats = await fs.lstat(targetFile);
+            }
+            catch (error) {
+                if (error.code !== "ENOENT") {
+                    throw error;
+                }
+            }
+            if (!targetStats || !targetStats.isFile()) {
+                continue;
+            }
+            const currentHash = await hashFile(targetFile);
+            if (currentHash === recordedHash) {
+                orphanedFiles.push(relativePath);
+            }
+        }
+    }
+    return {
+        targetDir,
+        templateRoot,
+        previousManifest,
+        nextManifest,
+        activeAdapters: [...activeAdapters].sort(),
+        templateFiles,
+        createList,
+        updateList,
+        conflictList,
+        orphanedFiles
+    };
+}
+export async function applyPreparedUpdate(prepared, { replaceConflicts = false } = {}) {
+    if (prepared.conflictList.length > 0 && !replaceConflicts) {
+        throw new Error(`Cannot apply update with ${prepared.conflictList.length} conflict(s). Pass force/replace option or resolve conflicts.`);
+    }
+    const writeTargets = [
+        ...prepared.createList,
+        ...prepared.updateList,
+        ...(replaceConflicts ? prepared.conflictList.map((item) => item.relativePath) : [])
+    ];
+    let appliedCount = 0;
+    for (const relativePath of writeTargets) {
+        const templateFile = prepared.templateFiles.get(relativePath);
+        if (!templateFile) {
+            continue;
+        }
+        await copyFileAtomic(prepared.targetDir, relativePath, templateFile.source);
+        appliedCount++;
+    }
+    let removedCount = 0;
+    for (const relativePath of prepared.orphanedFiles) {
+        const fileToRemove = targetPath(prepared.targetDir, relativePath);
+        try {
+            await fs.unlink(fileToRemove);
+            removedCount++;
+            await cleanEmptyParentDirectories(prepared.targetDir, fileToRemove);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT") {
+                throw error;
+            }
+        }
+    }
+    await writeInstallManifest(prepared.targetDir, prepared.nextManifest);
+    return {
+        appliedCount,
+        removedCount
+    };
+}
+export async function cleanEmptyParentDirectories(targetDir, filePath) {
+    let parentDir = path.dirname(filePath);
+    const resolvedTarget = path.resolve(targetDir);
+    while (parentDir !== resolvedTarget && parentDir.startsWith(resolvedTarget)) {
+        try {
+            const entries = await fs.readdir(parentDir);
+            if (entries.length === 0) {
+                await fs.rmdir(parentDir);
+                parentDir = path.dirname(parentDir);
+            }
+            else {
+                break;
+            }
+        }
+        catch {
+            break;
+        }
+    }
+}
+export async function writeInstallManifest(targetDir, manifest) {
+    const manifestFile = targetPath(targetDir, MANIFEST_PATH);
+    await fs.mkdir(path.dirname(manifestFile), { recursive: true });
+    await fs.writeFile(manifestFile, `${JSON.stringify(manifest, null, 2)}\n`, "utf8");
+}
+export async function copyFileAtomic(targetDir, relativePath, sourcePath) {
+    await assertNoSymlinkParents(targetDir, relativePath);
+    const destinationPath = targetPath(targetDir, relativePath);
+    await fs.mkdir(path.dirname(destinationPath), { recursive: true });
+    const tempPath = `${destinationPath}.tmp-${process.pid}-${Date.now()}`;
+    await fs.copyFile(sourcePath, tempPath);
+    await fs.rename(tempPath, destinationPath);
+}
+export function targetPath(targetDir, relativePath) {
+    return path.resolve(targetDir, ...relativePath.split("/"));
+}
+export async function assertNoSymlinkParents(targetDir, relativePath) {
+    const parts = relativePath.split("/");
+    let current = path.resolve(targetDir);
+    for (let i = 0; i < parts.length - 1; i++) {
+        current = path.join(current, parts[i]);
+        try {
+            const stats = await fs.lstat(current);
+            if (stats.isSymbolicLink()) {
+                throw new Error(`Target sub-path "${parts.slice(0, i + 1).join("/")}" is a symbolic link.`);
+            }
+        }
+        catch (error) {
+            if (error.code === "ENOENT") {
+                break;
+            }
+            throw error;
+        }
+    }
+}
+export async function hashFile(filePath) {
+    const content = await fs.readFile(filePath);
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+//# sourceMappingURL=update.js.map