@jakkrichm/create-nexus-devflow 2.0.12 → 2.0.14

package/lib/update.js

@@ -1,379 +0,0 @@
-const crypto = require("node:crypto");
-const fs = require("node:fs/promises");
-const path = require("node:path");
-
-const CONTROL_DIR = ".nexus";
-const MANIFEST_PATH = `${CONTROL_DIR}/nexus-devflow.json`;
-const MANIFEST_SCHEMA_VERSION = 1;
-const MANAGED_ROOTS = {
-  common: ["AGENTS.md", "CLAUDE.md", "devflow", "LICENSE"],
-  codex: [".agents/skills"],
-  antigravity: [".agents/skills", ".agent/workflows"],
-  claude: [".claude/skills"]
-};
-
-function adapterListFromMode(adapter) {
-  if (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}`);
-}
-
-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",
-        "wiki",
-        "check-for-updates",
-        "help"
-      ]
-    },
-    managedFiles
-  };
-}
-
-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;
-  }
-}
-
-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;
-  }
-}
-
-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
-  };
-}
-
-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++;
-    } catch (error) {
-      if (error.code !== "ENOENT") {
-        throw error;
-      }
-    }
-  }
-
-  await writeInstallManifest(prepared.targetDir, prepared.nextManifest);
-
-  return {
-    appliedCount,
-    removedCount
-  };
-}
-
-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");
-}
-
-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);
-}
-
-function targetPath(targetDir, relativePath) {
-  return path.resolve(targetDir, ...relativePath.split("/"));
-}
-
-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;
-    }
-  }
-}
-
-async function hashFile(filePath) {
-  const content = await fs.readFile(filePath);
-  return crypto.createHash("sha256").update(content).digest("hex");
-}
-
-module.exports = {
-  CONTROL_DIR,
-  MANIFEST_PATH,
-  adapterListFromMode,
-  applyPreparedUpdate,
-  createManifest,
-  prepareUpdate,
-  readManifest,
-  writeInstallManifest
-};

package/template/.agents/skills/9arm-skills/README.md

@@ -1,51 +0,0 @@
----
-name: 9arm-skills
-description: Credited engineering discipline pack adapted from thananon/9arm-skills for Antigravity IDE and Nexus-DevFlow workflows.
-source_pack: 9arm-skills
-credit: thananon/9arm-skills
-upstream: https://github.com/thananon/9arm-skills
-adapted_for: Antigravity IDE / Nexus-DevFlow
----
-
-# 9arm-Skills Discipline Pack
-
-This pack adapts the engineering discipline ideas from `9arm-skills` into the Nexus-DevFlow `.agent` bundle.
-
-`9arm-skills` is used as a credited thinking layer, not as a replacement for Nexus-DevFlow. Users should keep invoking the normal workflows (`Debug`, `PR-Review`, `Insight`, `Agent`, `Help`). The workflow applies the relevant 9arm discipline internally and still writes the usual Nexus reports and artifacts.
-
-## Credit
-
-- Source pack: `9arm-skills`
-- Credit: `thananon/9arm-skills`
-- Upstream: https://github.com/thananon/9arm-skills
-- Adapted for: Antigravity IDE / Nexus-DevFlow
-
-## Workflow Mapping
-
-| Nexus-DevFlow Workflow | Applied 9arm Skill | Purpose |
-|---|---|---|
-| `Debug` | `debug-mantra` | Reproduce before fixing, trace the real fail path, falsify hypotheses, and preserve breadcrumbs. |
-| `Insight` | `post-mortem` | Turn validated bug fixes and incidents into durable team knowledge. |
-| `PR-Review` | `scrutinize` | Review intent, smaller alternatives, actual paths, and findings before approving changes. |
-| `Agent code-reviewer` | `scrutinize` | Apply outsider review discipline to specialist code reviews. |
-| `PR`, `/60-Report`, `/70-Release`, `Help` | `management-talk` | Translate engineering details into stakeholder-readable status, impact, owner, and next step. |
-
-## Output Rule
-
-Keep Nexus-DevFlow output formats intact:
-
-- Debug output still goes to `devflow/debug/rca-{slug}.md`.
-- PR review output still uses the PR review report contract.
-- Specialist reports still go to `devflow/reports/`.
-- Lessons still go to `devflow/lessons.md` or task logs.
-
-When a report uses this pack, include a short source discipline note:
-
-```md
-## Source Discipline
-- Source pack: 9arm-skills
-- Applied skill: {skill-name}
-- Credit: thananon/9arm-skills
-- Adapted for: Antigravity IDE / Nexus-DevFlow
-```
-

package/template/.agents/skills/9arm-skills/debug-mantra/SKILL.md

@@ -1,86 +0,0 @@
----
-name: 9arm-skills/debug-mantra
-description: Use during debugging and RCA. Requires reproduction, real fail-path tracing, hypothesis falsification, and breadcrumb cross-reference before proposing a fix.
-source_pack: 9arm-skills
-credit: thananon/9arm-skills
-upstream: https://github.com/thananon/9arm-skills
-adapted_for: Antigravity IDE / Nexus-DevFlow
----
-
-# Debug Mantra
-
-## Purpose
-
-Stop the Antigravity IDE agent from guessing during debug work. The agent must prove the bug path before recommending or applying a fix.
-
-This skill is a credited adaptation of `9arm-skills/debug-mantra` for Nexus-DevFlow.
-
-## Mantra
-
-```text
-Reproduce -> Trace fail path -> Falsify hypothesis -> Cross-reference breadcrumbs
-```
-
-## Required Discipline
-
-### 1. Reproduce First
-
-Do not propose a fix until there is a credible reproduction story.
-
-Capture:
-
-- exact symptom
-- expected behavior
-- observed behavior
-- reproduction steps
-- reproduction rate
-- environment or data conditions
-
-If the issue is intermittent, document the conditions and instrumentation needed to catch it instead of pretending it is solved.
-
-### 2. Trace The Real Fail Path
-
-Follow the actual runtime path end-to-end:
-
-- user action or incoming request
-- entrypoint
-- service/module boundaries
-- data reads and writes
-- external calls
-- final failure point
-
-Evidence should cite file paths, line numbers when available, commands, logs, or observed runtime output.
-
-### 3. Falsify Hypotheses
-
-List 2-4 plausible hypotheses and try to disprove them. A hypothesis that was ruled out is useful evidence and should be recorded.
-
-Use this table in RCA notes when helpful:
-
-| Hypothesis | Test / Evidence | Result | Ruled In/Out |
-|---|---|---|---|
-| {Hypothesis} | {Evidence} | {Result} | {Status} |
-
-### 4. Cross-Reference Breadcrumbs
-
-Keep a breadcrumb ledger so the investigation can be audited later:
-
-| Breadcrumb | Source | What It Proves | Follow-up |
-|---|---|---|---|
-| {Observation} | {File / command / log} | {Claim supported} | {Next step} |
-
-## Nexus-DevFlow Output
-
-When used by `Debug`, preserve the existing RCA output contract:
-
-- inspect `.agent/resources/schemas/rca.template.md`
-- write `devflow/debug/rca-{slug}.md`
-- include the normal RCA sections
-- add a short `Source Discipline` note crediting `9arm-skills/debug-mantra`
-
-Do not replace the RCA template with a custom 9arm-only format.
-
-## Hard Stop
-
-If there is no reproduction, no trace, and no falsified hypothesis, the correct output is an investigation plan, not a fix.
-

package/template/.agents/skills/9arm-skills/management-talk/SKILL.md

@@ -1,79 +0,0 @@
----
-name: 9arm-skills/management-talk
-description: Use to translate engineering detail into stakeholder-readable updates, PR summaries, changelog notes, standups, Slack/JIRA comments, or leadership talking points.
-source_pack: 9arm-skills
-credit: thananon/9arm-skills
-upstream: https://github.com/thananon/9arm-skills
-adapted_for: Antigravity IDE / Nexus-DevFlow
----
-
-# Management Talk
-
-## Purpose
-
-Translate engineering-to-engineering detail into decision-ready communication for PMs, leads, release managers, support, and executives.
-
-This skill is a credited adaptation of `9arm-skills/management-talk` for Nexus-DevFlow.
-
-## What To Preserve
-
-Keep:
-
-- current status
-- user or business impact
-- risk
-- owner
-- next step
-- timeline or blocking condition
-- validation status
-
-Remove or compress unless needed:
-
-- internal function names
-- long file paths
-- commit SHAs
-- implementation details that do not affect decisions
-- speculative blame
-
-## Output Shapes
-
-### Status Update
-
-```md
-## Source Discipline
-- Source pack: 9arm-skills
-- Applied skill: management-talk
-- Credit: thananon/9arm-skills
-- Adapted for: Antigravity IDE / Nexus-DevFlow
-
-## Current Status
-## Impact
-## Owner
-## Next Step
-## Risk / Blocker
-```
-
-### PR / Release Summary
-
-```md
-## What Changed
-## Why It Matters
-## Validation
-## Risk
-## Rollback / Follow-up
-```
-
-### Incident / Bug Summary
-
-```md
-## What Happened
-## Who Was Affected
-## Current State
-## Fix / Mitigation
-## Prevention
-```
-
-## Nexus-DevFlow Output
-
-Use this skill inside `PR`, `/60-Report`, `/70-Release`, and `Help` when the user needs a human-readable summary. Keep existing Nexus output formats and destinations intact.
-

package/template/.agents/skills/9arm-skills/post-mortem/SKILL.md

@@ -1,71 +0,0 @@
----
-name: 9arm-skills/post-mortem
-description: Use after a bug, outage, or regression has been fixed and validated. Converts the fix into durable engineering knowledge.
-source_pack: 9arm-skills
-credit: thananon/9arm-skills
-upstream: https://github.com/thananon/9arm-skills
-adapted_for: Antigravity IDE / Nexus-DevFlow
----
-
-# Post-Mortem
-
-## Purpose
-
-Convert a resolved issue into team memory. A fix is not complete until the team can explain what broke, why it broke, how it was fixed, how it was validated, and why it slipped through.
-
-This skill is a credited adaptation of `9arm-skills/post-mortem` for Nexus-DevFlow.
-
-## When To Use
-
-Use after:
-
-- `Debug` found a root cause
-- `/40-Implement` applied a fix
-- `/50-Verify` or manual validation proved the fix
-- a production incident, regression, or high-risk bug deserves durable learning
-
-Do not write a confident post-mortem before the fix and validation evidence exist.
-
-## Required Inputs
-
-- reliable reproduction or incident timeline
-- root cause
-- fix summary
-- validation evidence
-- affected user or system impact
-- prevention measure or follow-up
-
-If inputs are missing, list the gaps and request the missing evidence.
-
-## Report Sections
-
-Use these sections inside `devflow/lessons.md`, task logs, or a task-linked report when appropriate:
-
-```md
-## Source Discipline
-- Source pack: 9arm-skills
-- Applied skill: post-mortem
-- Credit: thananon/9arm-skills
-- Adapted for: Antigravity IDE / Nexus-DevFlow
-
-## What Broke
-## Impact
-## Reliable Repro / Timeline
-## Root Cause
-## Fix
-## Validation Evidence
-## Why It Slipped Through
-## Prevention / Follow-up
-```
-
-## Nexus-DevFlow Output
-
-Prefer existing destinations:
-
-- task-specific insight: record the final lesson in the active markdown artifacts for that running ID, or in `devflow/lessons.md`
-- project-wide lesson: `devflow/lessons.md` using `.agent/resources/schemas/lessons.template.md`
-- release-facing summary: `/70-Release`
-- stakeholder summary: `management-talk`
-
-Keep the output concise and actionable. Avoid blame.
-