@jakkrichm/create-nexus-devflow 2.0.13 → 2.0.14

package/template/devflow/context/project-overview.md

@@ -1,19 +1,37 @@
 # Project Overview
 
-> **DevFlow Context Source of Truth.**
-> Single AI-facing source of truth for project architecture, stack, and shipped capabilities.
-> Run `/onboard` (for fresh projects) or `/adopt` (for existing codebases) to populate this file automatically.
+Primary source of truth for the project context, architecture, tech stack, and active DevFlow stage status.
 
-## 1. Project Summary
+## Application Summary
 
-- **Name**: [Project Name]
-- **Description**: [One-line summary of project purpose]
-- **Primary Stack**: [Framework / Language / Runtime]
+- **Project Name**: Nexus-DevFlow
+- **Goal**: Agent-ready DevFlow 2.0 workflow layer framework with .agents and .claude adapter tooling, living context synchronization, and automated AI Blueprint upstream monitoring.
+- **Target Audience**: AI coding assistants (Google Antigravity, OpenAI Codex, Claude Code, Cursor) and software development teams building resilient agentic delivery workflows.
 
-## 2. Architecture & Modules
+## Tech Stack
 
-- `src/` - Core application source code
+- **Core & Runtime**: Node.js (>=18.17 / Node 22), TypeScript 5.7, Node Next ESM (`"type": "module"`)
+- **Execution & Tooling**: `tsx` (TypeScript execute/test runner), `tsc` (Typecheck & compilation)
+- **Installer Package**: `@jakkrichm/create-nexus-devflow` (with `dist/` compilation pipeline)
+- **Documentation**: VitePress / Astro website under `website/` (GitHub Pages)
+- **Upstream Integration**: Automated GitHub Actions monitor (`.github/workflows/check-upstream.yml`) tracking `aiblueprinthq/ai-blueprint`
+- **Verification Gate**: `npm run check` (TypeScript typechecking, static contract validation, TF-IDF skill routing evaluations, installer unit tests, packed smoke tests)
 
-## 3. Shipped Capabilities
+## Architecture & Key Modules
 
-- None recorded yet. Run `/onboard` or `/adopt` to initialize.
+- **`packages/create-nexus-devflow/`**: Distribution CLI package with TypeScript compilation (`dist/bin/create-nexus-devflow.js`), atomic update engine (`lib/update.ts`), and prepack template bundler (`scripts/prepare-template.ts`).
+- **`.agents/skills/` & `.claude/skills/`**: 72 synchronized AI agent skills covering Mainline stages (00-70) and companion tools (`devflow`, `try`, `doctor`, `overview`, `sync-upstream`, `ci`, `rollback`).
+- **`scripts/`**: Maintainer infrastructure (`check-devflow.ts`, `validate-framework.ts`, `smoke-package.ts`, `upstream-monitor.ts`, `evals/routing.ts`).
+- **`devflow/`**: Workspace state, discoveries, runs, context, reference contracts, and master release history ledger.
+
+## Shipped Capabilities (Recent Milestones)
+
+- **`RUN-014` (2026-08-20)**: Upgraded DevFlow to full TypeScript architecture (`tsconfig.json`, `tsx`, `tsc`, `dist/`), migrated AI Blueprint Upstream Monitor workflow to DevFlow, and established multi-lane verification matrix.
+- **`RUN-013` (2026-08-20)**: Added `/overview` skill for living context scanning and synchronization.
+- **`RUN-008` (2026-08-18)**: Lean & Clean DevFlow optimization, consolidated skill taxonomy, and safe rollback mechanisms.
+
+## DevFlow Workspace Status
+
+- **Active Discovery ID**: None (Idle)
+- **Active Running ID**: None (Idle)
+- **Last Completed Run**: `RUN-014-typescript-migration-and-upstream-monitor-for-devflow`

package/template/devflow/history/HISTORY.md

@@ -8,6 +8,10 @@ This master ledger tracks all released delivery runs, milestones, and rollbacks
 
 | Release Date | Running ID | Title | Git Tag / Commit | Release Status | Report Link |
 | :--- | :--- | :--- | :--- | :--- | :--- |
+| 2026-08-20 | `RUN-016` | ระบบบันทึกไอเดียพร้อม AI วิเคราะห์ความเป็นไปได้ (`/idea`) และเชื่อมต่อกับ Status Backlog | `HEAD` | `Released` | [`spec.md`](../runs/RUN-016-idea-capture-inbox-and-status-integration/spec.md) |
+| 2026-08-20 | `RUN-015` | Dual-Track Architecture (Fast-Track 4 Steps & Deep-Track 8 Steps) + Living Spec (`spec.md`) + Standalone HTML Report Policy | `HEAD` | `Released` | [`spec.md`](../runs/RUN-015-fast-track-and-living-blueprint/spec.md) |
+| 2026-08-20 | `RUN-014` | ยกระดับสถาปัตยกรรม DevFlow สู่ TypeScript และย้ายระบบ Check AI Blueprint Upstream Monitor | `HEAD` | `Released` | [`60-report.md`](../runs/RUN-014-typescript-migration-and-upstream-monitor-for-devflow/60-report.md) |
+| 2026-08-20 | `RUN-013` | เพิ่ม Skill `/overview` และระบบ Living Context Sync สำหรับ Nexus-DevFlow | `e30375b` | `Released` | [`60-report.md`](../runs/RUN-013-add-overview-and-context-sync-skill/60-report.md) |
 | 2026-08-18 | `RUN-008` | ปรับปรุงโครงสร้าง Nexus-DevFlow ให้ Lean & Clean ยุบรวม Skills บริหารจัดการ History และ Safe Rollback | `be713ea` | `Released` | [`60-report.md`](../runs/RUN-008-lean-and-clean-devflow-optimization/60-report.md) |
 | 2026-08-18 | `RUN-007` | ยกระดับระบบ Nexus-DevFlow ด้วยวินัยและกลไกสำคัญจาก Blueprint | `e79528b` | `Released` | [`60-report.md`](../runs/RUN-007-integrate-blueprint-skills-enhancements/60-report.md) |
 | 2026-08-18 | `RUN-006` | Standardize Command Naming and Provider Invocation | `HEAD` | `Released` | [`60-report.md`](../runs/RUN-006-standardize-command-naming-and-provider-invocation/60-report.md) |

package/template/devflow/ideas.md

@@ -0,0 +1,15 @@
+# 💡 DevFlow Idea Inbox & Backlog
+
+บันทึกไอเดียที่รอดำเนินการ พร้อมบทวิเคราะห์ความเป็นไปได้เบื้องต้นจาก AI (บันทึกด้วยคำสั่ง `/idea "<text>"`)
+
+---
+
+## 📌 Pending Ideas
+
+*(ยังไม่มีไอเดียค้างอยู่ — เพิ่มไอเดียใหม่ได้ด้วยคำสั่ง `/idea "<ข้อความไอเดีย>" หรือ `$idea "<text>"`)*
+
+---
+
+## 📦 Archived / Shipped Ideas
+
+*(ไอเดียที่ถูกหยิบไปทำด้วย `/spec IDEA-xxx` หรือ `/00-discover IDEA-xxx` จะถูกย้ายมาบันทึกที่นี่)*

package/bin/create-nexus-devflow.js

@@ -1,287 +0,0 @@
-#!/usr/bin/env node
-
-const fs = require("node:fs/promises");
-const fsSync = require("node:fs");
-const path = require("node:path");
-const readline = require("node:readline/promises");
-const {
-  MANIFEST_PATH,
-  applyPreparedUpdate,
-  prepareUpdate,
-  writeInstallManifest
-} = require("../lib/update");
-
-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, options);
-
-  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, options);
-}
-
-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, options) {
-  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, options) {
-  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();
-}
-
-main().catch((err) => {
-  console.error(`\nError: ${err.message}`);
-  process.exit(1);
-});

package/lib/starter-templates.js

@@ -1,111 +0,0 @@
-const starterTemplates = {
-  projectOverview: `# Project Overview
-
-> **DevFlow Context Source of Truth.**
-> Single AI-facing source of truth for project architecture, stack, and shipped capabilities.
-> Run \`/onboard\` (for fresh projects) or \`/adopt\` (for existing codebases) to populate this file automatically.
-
-## 1. Project Summary
-
-- **Name**: [Project Name]
-- **Description**: [One-line summary of project purpose]
-- **Primary Stack**: [Framework / Language / Runtime]
-
-## 2. Architecture & Modules
-
-- \`src/\` - Core application source code
-
-## 3. Shipped Capabilities
-
-- None recorded yet. Run \`/onboard\` or \`/adopt\` to initialize.
-`,
-
-  codingStandards: `# Coding Standards
-
-> Project conventions and rules to follow during development.
-> Run \`/onboard\` (or \`/adopt\` for existing codebases) to tune these standards to your specific stack.
-
-## Architecture and Conventions
-
-- Write clean, modular, and maintainable code with clear single responsibilities.
-- Prefer TypeScript and explicit interfaces where available.
-- Keep dependencies lean and justified.
-
-## Code Organization & Style
-
-- Structure source code following framework-native conventions.
-- Keep functions focused and avoid deeply nested logic.
-- Use consistent naming conventions (camelCase for functions/variables, PascalCase for components/types).
-
-## Error Handling & Security
-
-- Handle errors explicitly and provide meaningful error messages.
-- Never hardcode credentials, secrets, or API keys in source code.
-- Sanitize and validate all user inputs.
-
-## Testing & Quality
-
-- Follow the TDD workflow for behavior-changing code units.
-- Run tests and linting before completing features or fixes.
-`,
-
-  currentStage: `# Current DevFlow Run Status
-
-- **Active Discovery ID**: None
-- **Active Running ID**: None
-- **Current Stage**: Idle
-- **Last Completed Run**: None
-- **Last Updated**: -
-`,
-
-  findings: `# Findings Ledger
-
-> Review findings raised by \`/security-review\` or QA audits.
-> Resolved findings are tracked with durable IDs.
-
-- **Total Open P0/P1**: 0
-- **Total Tracked**: 0
-
-_No findings recorded._
-`,
-
-  aiInteraction: `# AI Interaction Guidelines for DevFlow
-
-> **DevFlow is an agentic workflow layer**, overlaying on top of scaffolded or existing codebases.
-
-## Communication & Interaction
-
-- Be concise and direct in communication.
-- Explain technical trade-offs and non-obvious design decisions briefly.
-- Always confirm before performing major refactors or destructive operations.
-- Maintain markdown-first evidence for all stage activities.
-
-## Artifact Language
-
-- Default language for user-facing artifacts and summaries is Thai (\`th\`), while code, paths, and identifiers remain in English.
-- Use exact schema headings when validators check for specific contract sections.
-
-## Output Formatting
-
-- Use GitHub-style markdown for clean scanning.
-- Use lists for steps, options, and findings.
-- Use tables for comparative matrices or stage summaries.
-- Use backticks for paths, filenames, identifiers, and CLI commands.
-
-## DevFlow Timeline Lifecycle
-
-\`\`\`text
-/00-Discover -> /10-Define -> /20-Spec -> /30-Plan -> /40-Implement -> /50-Verify -> /60-Report -> /70-Release
-\`\`\`
-
-- Run \`/00-Discover\` to explore requests under a Discovery ID.
-- Run \`/10-Define\` to set delivery boundaries and allocate Running IDs.
-- Run \`/20-Spec\` and \`/30-Plan\` to establish formal delivery specifications and execution plans.
-- Run \`/40-Implement\` for step-by-step code implementation with evidence.
-- Run \`/50-Verify\`, \`/60-Report\`, and \`/70-Release\` for quality verification, reporting, and release packaging.
-`
-};
-
-module.exports = {
-  starterTemplates
-};