@jakkrichm/create-nexus-devflow 2.12.1 → 2.12.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jakkrichm/create-nexus-devflow",
-  "version": "2.12.1",
+  "version": "2.12.2",
   "description": "Installer and workflow manager for Nexus-DevFlow agentic workflow layer.",
   "license": "MIT",
   "author": "Jakkrich",

package/template/.agents/skills/onboard/SKILL.md

@@ -96,7 +96,8 @@ Read only enough to identify the setup:
   `tailwind.config.*`, database config, test config)
 - source layout, route layout, and app/package directories
 - existing `.gitignore`
-- whether `.agents/` and `.claude/` are both needed
+- `devflow/.state/manifest.json` or `.nexus/nexus-devflow.json`, when present, and its selected adapter list
+- which selected tools need `.agents/`, `.claude/`, or both
 - whether Blueprint workflow paths are already tracked by git
 - existing verification commands and `.github/workflows/`
 - project name, from `package.json`, the folder name, existing docs, or the user
@@ -278,14 +279,26 @@ Recommend option 1 by default. If the user chooses option 2:
   `git rm --cached -r .agents .claude devflow CLAUDE.md`, and
   only run it if the user explicitly approves. Never delete the local files.
 
-Then report which adapter folders are needed:
-
-- Codex, Antigravity, and GitHub Copilot: keep `AGENTS.md`, `.agents/`, and `devflow/`; `CLAUDE.md` and
+Then report which selected tools and adapter folders are needed:
+
+- When a valid `devflow/.state/manifest.json` or `.nexus/nexus-devflow.json` exists, its `adapters` list is
+  the authoritative installer selection. The presence of `.agents/` means its
+  files are compatible with Codex, Antigravity, GitHub Copilot, and OpenCode;
+  it does not mean all four tools were selected.
+- Do not ask the user to select adapters again when that valid manifest exists.
+  Keep and report the exact selection. If a required adapter tree is missing,
+  report the mismatch and point to `/doctor` instead of guessing or deleting
+  another tree.
+- Without a valid manifest, explain that folder detection cannot distinguish
+  Codex, Antigravity, GitHub Copilot, and OpenCode, then ask which tools the user actually
+  uses instead of assuming all of them are selected.
+- Codex and Antigravity: keep `AGENTS.md`, `.agents/`, and `devflow/`; `CLAUDE.md` and
   `.claude/` can be deleted.
 - Claude Code only: keep `AGENTS.md`, `CLAUDE.md`, `.claude/`, and `devflow/`;
   `.agents/` can be deleted.
+- GitHub Copilot only: keep `AGENTS.md`, `.agents/`, and `devflow/`.
 - OpenCode: shares either `.agents/` or `.claude/` compatible skill tree without duplicate folders.
-- Mixed tools: keep both `.agents/` and `.claude/` adapters.
+- Mixed tools: keep only the compatible adapter trees required by the selected tools.
 
 Do not delete adapters unless the user explicitly asks.
 

package/template/.claude/skills/onboard/SKILL.md

@@ -96,7 +96,8 @@ Read only enough to identify the setup:
   `tailwind.config.*`, database config, test config)
 - source layout, route layout, and app/package directories
 - existing `.gitignore`
-- whether `.agents/` and `.claude/` are both needed
+- `devflow/.state/manifest.json` or `.nexus/nexus-devflow.json`, when present, and its selected adapter list
+- which selected tools need `.agents/`, `.claude/`, or both
 - whether Blueprint workflow paths are already tracked by git
 - existing verification commands and `.github/workflows/`
 - project name, from `package.json`, the folder name, existing docs, or the user
@@ -278,14 +279,26 @@ Recommend option 1 by default. If the user chooses option 2:
   `git rm --cached -r .agents .claude devflow CLAUDE.md`, and
   only run it if the user explicitly approves. Never delete the local files.
 
-Then report which adapter folders are needed:
-
-- Codex, Antigravity, and GitHub Copilot: keep `AGENTS.md`, `.agents/`, and `devflow/`; `CLAUDE.md` and
+Then report which selected tools and adapter folders are needed:
+
+- When a valid `devflow/.state/manifest.json` or `.nexus/nexus-devflow.json` exists, its `adapters` list is
+  the authoritative installer selection. The presence of `.agents/` means its
+  files are compatible with Codex, Antigravity, GitHub Copilot, and OpenCode;
+  it does not mean all four tools were selected.
+- Do not ask the user to select adapters again when that valid manifest exists.
+  Keep and report the exact selection. If a required adapter tree is missing,
+  report the mismatch and point to `/doctor` instead of guessing or deleting
+  another tree.
+- Without a valid manifest, explain that folder detection cannot distinguish
+  Codex, Antigravity, GitHub Copilot, and OpenCode, then ask which tools the user actually
+  uses instead of assuming all of them are selected.
+- Codex and Antigravity: keep `AGENTS.md`, `.agents/`, and `devflow/`; `CLAUDE.md` and
   `.claude/` can be deleted.
 - Claude Code only: keep `AGENTS.md`, `CLAUDE.md`, `.claude/`, and `devflow/`;
   `.agents/` can be deleted.
+- GitHub Copilot only: keep `AGENTS.md`, `.agents/`, and `devflow/`.
 - OpenCode: shares either `.agents/` or `.claude/` compatible skill tree without duplicate folders.
-- Mixed tools: keep both `.agents/` and `.claude/` adapters.
+- Mixed tools: keep only the compatible adapter trees required by the selected tools.
 
 Do not delete adapters unless the user explicitly asks.
 

package/template/devflow/analysis/REQ-20260904-001-sync-upstream-ai-blueprint/codebase-impact.md

@@ -0,0 +1,47 @@
+# Codebase Impact & Blast Radius Analysis
+
+> **Request ID**: `REQ-20260904-001-sync-upstream-ai-blueprint`  
+> **Target Run ID**: `072-sync-upstream-ai-blueprint-v153`  
+> **Analysis Date**: 2026-09-04  
+> **Status**: Completed
+
+---
+
+## 💥 Blast Radius Overview
+
+| Category | Assessment | Details |
+| :--- | :--- | :--- |
+| **Overall Complexity** | `Low-Medium` 🟢 | แก้ไข Skill Markdown contracts, เพิ่ม 1 E2E Scenario, ปรับปรุง Static Validator |
+| **API / Contract Breaking Risk** | `None` 🟢 | รักษา Backward Compatibility 100% (ทั้งแบบมีและไม่มี manifest) |
+| **Affected Areas** | Core Skills, E2E Test Suite, Static Framework Validator | `.agents/`, `.claude/`, `scripts/` |
+| **Regression Risk** | `Low` 🟢 | มี Static Check และ E2E Scenario ครอบคลุม |
+
+---
+
+## 📂 Affected Files & Modules
+
+### 1. Core Skills (`.agents/` & `.claude/`)
+- `.agents/skills/onboard/SKILL.md` (Update Step 1 & Step 6 for manifest-aware adapter reporting)
+- `.claude/skills/onboard/SKILL.md` (Synchronize Step 1 & Step 6 identical contract)
+
+### 2. Validation & Verification Guardrails
+- `agent-bundle.manifest.json` (Add contract phrases for onboard: authoritative installer selection, etc.)
+- `scripts/validate-framework.ts` (Ensure verification covers updated onboard contracts)
+
+### 3. Test Suites & E2E Scenarios
+- `scripts/e2e/scenarios/adapter-selection.ts` (New E2E Scenario 10 ported from upstream)
+- `packages/create-nexus-devflow/test/update.test.ts` (Verify adapter detection & selection tests)
+
+### 4. Documentation & Release Tracking
+- `devflow/build-plan.md` (Record Run 072)
+- `CHANGELOG.md` (Document v1.5.3 sync updates)
+
+---
+
+## 🧪 Verification Strategy
+
+1. **Static Validation**: `npm run check:static` (ต้องผ่าน 100% ไม่เกิน context budget)
+2. **Type Checking**: `npm run typecheck`
+3. **Unit / Package Tests**: `npm test`
+4. **End-to-End Test Suite**: `npm run check`
+5. **Upstream Drift Radar**: `npx tsx scripts/check-upstream-drift.ts` (ยืนยัน 100% Skills & Contract Parity)

package/template/devflow/build-plan.md

@@ -212,3 +212,12 @@
   - *Dependencies*: Feature 25, REQ-20260903-001
   - *Scope*: เพิ่มการตรวจจับและกู้คืน Unborn Git repository ใน `/onboard` ด้วย Scaffold Initial Commit (`chore: scaffold application`), รองรับการ Finalize DevFlow Baseline บน Dedicated Setup Branch ด้วย `git merge --ff-only` ใน `/overview`, เพิ่มชุดทดสอบ E2E Scenario `scripts/e2e/scenarios/unborn-onboarding.ts`, อัปเดต `devflow/context/ai-interaction.md` และอัปเดต Framework Static Contracts ผ่าน 100%
 
+---
+
+## 🔄 Phase 27: Upstream AI Blueprint v1.5.3 Synchronization
+
+- [x] **27. Sync Upstream v1.5.3 (Manifest-Aware Adapter Selection in Onboard & E2E Scenario Parity) (`REQ-20260904-001`, `072-sync-upstream-ai-blueprint-v153`)** `[Size: S]`
+  - *Dependencies*: Feature 26, REQ-20260904-001
+  - *Scope*: ปรับปรุง `/onboard` (ทั้ง `.agents/` และ `.claude/`) ให้อ่านและยึดถือรายการ `adapters` จาก Manifest (`.nexus/nexus-devflow.json` / `devflow/.state/manifest.json`) เป็นความจริงหลัก (Authoritative Selection) โดยไม่ถามซ้ำและไม่อนุมานผิดพลาด, เพิ่มชุดทดสอบ E2E Scenario ตัวที่ 10 `scripts/e2e/scenarios/adapter-selection.ts`, อัปเดต `agent-bundle.manifest.json` และ `scripts/validate-framework.ts` ให้ครอบคลุม Verification Contracts ใหม่ 100%
+
+

package/template/devflow/inbox/REQ-20260904-001-sync-upstream-ai-blueprint/clarifications.md

@@ -0,0 +1,28 @@
+# Socratic Gap Detection & Clarification Checklist
+
+> **Request ID**: `REQ-20260904-001-sync-upstream-ai-blueprint`  
+> **Source**: Upstream AI Blueprint Synchronization Analysis
+
+---
+
+## 🔍 Socratic Review & Technical Clarifications
+
+### 1. ตำแหน่งไฟล์ Manifest ใน Nexus-DevFlow
+- **ประเด็น**: ใน Upstream `ai-blueprint` ใช้ไฟล์ `blueprint/.state/manifest.json` เป็นหลัก ขณะที่ Nexus-DevFlow มีทั้ง `.nexus/nexus-devflow.json` (จากตัวติดตั้ง package) และ `devflow/.state/manifest.json`
+- **แนวทาง**: ในคำสั่ง `/onboard` ควรอ้างอิงทั้ง `devflow/.state/manifest.json` และ `.nexus/nexus-devflow.json` โดยให้ความสำคัญกับไฟล์ที่มีอยู่จริง เพื่อความยืดหยุ่นสูงสุด
+
+### 2. รายชื่อเครื่องมือที่รองรับใน DevFlow vs Upstream
+- **ประเด็น**: Upstream รองรับ 4 ตัวหลัก (`codex`, `claude`, `copilot`, `opencode`) ขณะที่ Nexus-DevFlow มี First-Class Support เพิ่มเติมสำหรับ **Google Antigravity** (`antigravity` ซึ่งแชร์โครงสร้าง `.agents/`)
+- **แนวทาง**: ข้อความใน Step 6 ของ Onboard ต้องระบุชื่อเครื่องมือให้ครอบคลุม: "Codex, Antigravity, GitHub Copilot, และ OpenCode"
+
+### 3. สถานะ Version Tagging & Roadmap
+- **ประเด็น**: Upstream ออก release 1.5.3 สำหรับการแก้นี้ สำหรับ Nexus-DevFlow จะจัดเป็น Run `072` มุ่งสู่ Minor/Patch release ถัดไป (v2.12.2)
+- **แนวทาง**: กำหนดหมายเลข Run `072-sync-upstream-ai-blueprint-v153` และบันทึกลงใน Build Plan
+
+---
+
+## ✅ Readiness Checklist for Implementation
+- [x] ตรวจสอบ Diff ละเอียดจาก Upstream ครบถ้วน 100%
+- [x] วิเคราะห์จุดแตกต่างระหว่างสถาปัตยกรรม DevFlow และ AI Blueprint
+- [x] กำหนดขอบเขต E2E Scenario และ Static Contract เรียบร้อย
+- [ ] รอเจ้านายอนุมัติเพื่อเริ่มกระบวนการ `/feature` หรือ `/implement`

package/template/devflow/inbox/REQ-20260904-001-sync-upstream-ai-blueprint/parsed.md

@@ -0,0 +1,59 @@
+# Requirement Specification: ซิงก์ส่วนขยาย Upstream AI Blueprint (v1.5.3 / Latest Commits)
+
+> **Request ID**: `REQ-20260904-001-sync-upstream-ai-blueprint`  
+> **Source**: Upstream Repository `aiblueprinthq/ai-blueprint` (Commits `b4eb32e` .. `2b5f334`)  
+> **Ingested Date**: 2026-09-04  
+> **Target Run ID**: `072` (Feature)  
+> **Language**: Thai (`th`) Default
+
+---
+
+## 📌 Executive Summary
+
+สกัดและวิเคราะห์การเปลี่ยนแปลงล่าสุดจากต้นน้ำ (Upstream `ai-blueprint`) หลังการซิงก์รอบ v1.5.2 (Run `071`) โดยพบการอัปเดตสำคัญระดับสถาปัตยกรรมและกระบวนการ Onboarding ใน commit `b4eb32e` (fix: honor selected adapters) พร้อมทั้งการปรับปรุงเอกสารและ Diagram ใน commit `ed9c19c`, `a231195`, `2b5f334` 
+
+หัวใจหลักของการอัปเดตครั้งนี้คือการทำให้ขั้นตอน `/onboard` มีความฉลาดในการอ่านและยึดถือรายการ Adapter จากไฟล์ Manifest (`.nexus/nexus-devflow.json` หรือ `devflow/.state/manifest.json`) เป็นความจริงหลัก (Authoritative Source of Truth) เพื่อแก้ปัญหาที่ Onboard เคยเดาเอาเองว่าการมีโฟลเดอร์ `.agents/` แปลว่าผู้ใช้เลือกเครื่องมือทุกตัว (Codex, Antigravity, GitHub Copilot, OpenCode) และถามผู้ใช้ซ้ำซ้อน
+
+---
+
+## 👥 Target Personas & User Stories
+
+1. **ผู้ใช้ใหม่ที่ติดตั้ง DevFlow ด้วย Interactive Installer**:
+   - *As a developer* ติดตั้ง DevFlow ด้วยคำสั่ง `npx @jakkrichm/create-nexus-devflow` และเลือกเฉพาะ Claude Code และ Antigravity/Codex
+   - *I want* เมื่อรันคำสั่ง `/onboard` ให้ระบบจำการเลือกของฉันจาก Manifest โดยตรง
+   - *So that* AI จะไม่ถามซ้ำ และไม่ทึกทักไปเองว่าเราเลือก GitHub Copilot หรือ OpenCode เพิ่มขึ้นมา
+
+2. **ผู้ใช้เดิมที่รัน Onboard โดยไม่มี Manifest (Legacy / Manual Copy)**:
+   - *As a developer* ที่คัดลอกไฟล์มาเองหรือไม่มี Manifest
+   - *I want* AI อธิบายชัดเจนว่าโครงสร้าง `.agents/` ใช้ร่วมกันได้หลายเครื่องมือ แล้วถามยืนยันว่าใช้เครื่องมือใดบ้าง
+   - *So that* รายงาน Onboarding ถูกต้องตรงกับสิ่งที่ใช้งานจริง
+
+3. **Core Framework Maintainer**:
+   - *As a maintainer* ของ Nexus-DevFlow
+   - *I want* ระบบ E2E Test มี Scenario ตัวที่ 10 (`adapter-selection.ts`) และ Static Contract Validator ป้องกัน Regression
+   - *So that* ฟีเจอร์ Onboard Manifest Preservation ทำงานถูกต้อง 100% ตามมาตรฐาน Upstream
+
+---
+
+## ⚙️ Functional Requirements (FR)
+
+- **FR-1: Manifest-Aware Adapter Inspection ใน `/onboard` (Step 1)**
+  - เพิ่มการอ่านไฟล์ `devflow/.state/manifest.json` หรือ `.nexus/nexus-devflow.json` ในขั้นตอน Preflight/Inspection เพื่อดึง `adapters` list
+- **FR-2: Authoritative Selection & No Repeated Prompts ใน `/onboard` (Step 6)**
+  - เมื่อพบ Manifest ที่ถูกต้อง ให้ยึด `adapters` ใน Manifest เป็นหลัก ห้ามถามผู้ใช้ซ้ำ
+  - อธิบายว่าการมีอยู่ของ `.agents/` ไม่ได้หมายความว่าเลือกเครื่องมือทุกตัว
+  - หากไม่มี Manifest ให้ถามอย่างชัดเจนโดยไม่เดา
+- **FR-3: Dual-Adapter Contract Synchronicity**
+  - ปรับปรุงเนื้อหาใน `.agents/skills/onboard/SKILL.md` และ `.claude/skills/onboard/SKILL.md` ให้ตรงกัน 100%
+- **FR-4: Automated E2E Scenario Integration**
+  - เพิ่มชุดทดสอบ E2E Scenario `scripts/e2e/scenarios/adapter-selection.ts` ตรวจสอบพฤติกรรม Onboard กับ Manifest
+- **FR-5: Static Verification Guardrails**
+  - อัปเดต `agent-bundle.manifest.json` และ `scripts/validate-framework.ts` ให้ตรวจจับ Contract ใหม่ของ Onboard
+
+---
+
+## 🛡️ Non-Functional Requirements (NFR)
+
+- **Context Budget**: Skill Description และ Instruction ต้องไม่เกินขีดจำกัด Context Budget (< 400 ตัวอักษรต่อคำอธิบาย, ไม่ทำให้ไฟล์เกิน 20KB)
+- **Zero Breaking Change**: รักษาความเข้ากันได้กับโปรเจกต์เดิมที่มีหรือไม่มี Manifest
+- **Cross-Tool Parity**: รองรับ Codex, Antigravity, Claude Code, GitHub Copilot และ OpenCode

package/template/devflow/inbox/REQ-20260904-001-sync-upstream-ai-blueprint/raw/upstream-diff.txt

@@ -0,0 +1,23 @@
+# Upstream AI Blueprint Synchronization Request (v1.5.2 -> v1.5.3 / HEAD)
+
+## Raw Upstream Commits
+- 2b5f334 docs: refresh workflow diagram asset
+- a231195 docs: simplify workflow diagram
+- ed9c19c docs: position AI Blueprint as a workflow framework
+- b4eb32e fix: honor selected adapters
+- 5b46859 fix: handle repositories without an initial commit (synced in 071)
+
+## Core Upstream Changes Diff Stat
+ .agents/skills/onboard/SKILL.md                    |  23 ++++----
+ .claude/skills/onboard/SKILL.md                    |  23 ++++----
+ CHANGELOG.md                                       |  12 +++++
+ README.md                                          |  20 +++----
+ assets/ai-blueprint-workflow-v2.png                | Bin 0 -> 107098 bytes
+ assets/ai-blueprint-workflow.png                   | Bin 216758 -> 0 bytes
+ packages/create-ai-blueprint/README.md             |   5 +-
+ packages/create-ai-blueprint/bin/create-ai-blueprint.ts |   4 +-
+ packages/create-ai-blueprint/package.json          |   2 +-
+ packages/create-ai-blueprint/test/update.test.ts   |   6 +--
+ scripts/e2e/scenarios/adapter-selection.ts         |  59 +++++++++++++++++++++
+ scripts/validate-blueprint.ts                      |   9 +++-
+ 12 files changed, 126 insertions(+), 37 deletions(-)