@educa-corp/sdd-framework 0.6.0 → 0.7.0

package/commands/generate-spec-manifest.tmpl

@@ -1,164 +0,0 @@
-# /generate-spec-manifest — Sinh Spec Manifest cho External Agent
-
-Quét tất cả file spec và ghi một `spec-manifest.yaml` ở project root.
-File này dành cho **external agent** (vd agent của tester) — nó không commit vào git.
-
-## Gate
-
-{{include:steps/gate.md}}
-
-*Lưu ý: Với lệnh này, không có target file — nó quét cả dự án. Bỏ qua `$ARGUMENTS` trừ khi truyền domain filter.*
-
-## Context
-
-{{include:steps/context-loader.md}}
-
----
-
-## Process
-
-### Step 1 — Xác định scan root
-
-Đọc `project-context.yaml` để xác định mode và path:
-
-**Umbrella mode** (`setup.mode: umbrella`):
-```
-spec_root      = {setup.spec_source}              ← spec submodule của PO
-prd_glob       = {spec_root}/specs/*/*/*.md           ← file .md ở gốc feature folder = PRD ({TICKET-ID}-{prd-slug}.md)
-pdd_glob       = {spec_root}/specs/product-definition/**/*.md
-services       = {services}                        ← map domain → paths
-```
-
-**Single-service mode** (không có `setup.mode`):
-```
-spec_root      = .
-prd_glob       = {paths.specs_dir}/*/*/*.md           ← file .md ở gốc feature folder = PRD ({TICKET-ID}-{prd-slug}.md)
-pdd_glob       = {paths.product_definitions_dir}/**/*.md
-services       = { default: { specs_dir: {paths.specs_dir}, tech_docs_dir: {paths.tech_docs_dir} } }
-```
-
-Nếu truyền domain filter trong `$ARGUMENTS` → chỉ quét PRD khớp domain đó.
-
----
-
-### Step 2 — Quét file PRD
-
-Với mỗi file `.md` khớp `prd_glob`:
-
-1. Đọc bảng metadata của file:
-   - `TICKET-ID` từ `| **PRD ID** |`
-   - `domain` từ `| **Domain** |`
-   - `status` từ `| **Status** |`
-   - `version` từ `| **Version** |`
-2. Cũng đọc frontmatter `@trace.domain` nếu có (dùng cái này thay vì domain bảng metadata nếu cả hai tồn tại)
-3. Ghi: `{ ticket_id, domain, status, version, prd_path }` — path tương đối với manifest root
-
-Skip file không xác định được `TICKET-ID`.
-
----
-
-### Step 3 — Khớp file PDD
-
-Với mỗi TICKET-ID tìm thấy ở Step 2:
-
-Tìm `pdd_glob` một file có tên chứa TICKET-ID (vd `FT-001-*.md`).
-- Tìm thấy → ghi `pdd_path` (tương đối với manifest root)
-- Không thấy → ghi `pdd: null`
-
----
-
-### Step 4 — Khớp file BDD và Tech-Doc theo từng service
-
-Với mỗi TICKET-ID, với mỗi service trong map `services`:
-
-**BDD:**
-- Glob `{service.specs_dir}/**/{TICKET-ID}*.feature`
-- Cũng kiểm tra file chứa `@trace.prd: {TICKET-ID}` trong frontmatter nếu glob không trả gì
-- Tìm thấy → ghi path dưới `bdd.{service_key}`
-- Không thấy → bỏ key (đừng ghi `null` cho service chưa có BDD)
-
-**Tech-docs:**
-- Glob `{service.tech_docs_dir}/**/{TICKET-ID}*.md`
-- Cũng kiểm tra file chứa `@trace.prd: {TICKET-ID}` nếu glob không trả gì
-- Tìm thấy → ghi path dưới `tech_docs.{service_key}`
-- Không thấy → bỏ key
-
-Mọi path tương đối với manifest root (umbrella root hoặc project root).
-
----
-
-### Step 5 — Ghi spec-manifest.yaml
-
-Ghi vào `{manifest_root}/spec-manifest.yaml` (ghi đè nếu tồn tại).
-
-Format:
-
-```yaml
-# Auto-generated by /generate-spec-manifest — DO NOT edit manually
-# To regenerate: /generate-spec-manifest
-# This file is excluded from git — see .gitignore
-
-version: "1.0"
-generated_at: "{YYYY-MM-DD}"
-project_mode: "{umbrella | single}"
-
-features:
-  {TICKET-ID}:
-    domain: {domain}
-    status: {status}
-    prd_version: "{version}"
-    prd: "{prd_path}"
-    pdd: "{pdd_path}"               # omit if null
-    tech_docs:
-      {service_key}: "{path}"       # only include services where file was found
-    bdd:
-      {service_key}: "{path}"       # only include services where file was found
-```
-
-Sort features theo TICKET-ID alphabet.
-Bỏ hẳn block `tech_docs` nếu không tìm thấy tech-doc cho service nào.
-Bỏ hẳn block `bdd` nếu không tìm thấy BDD cho service nào.
-
----
-
-### Step 6 — Đảm bảo .gitignore
-
-Kiểm tra `{manifest_root}/.gitignore`:
-- Nếu `spec-manifest.yaml` đã được liệt kê → không làm gì
-- Nếu chưa → append vào `.gitignore`:
-
-```
-# Auto-generated — do not commit
-spec-manifest.yaml
-```
-
-In: `✅ spec-manifest.yaml added to .gitignore`
-
----
-
-## Output
-
-{{include:steps/report-footer.md}}
-
-```
-/generate-spec-manifest Hoàn tất
----
-Status  : ✅ Complete
-Output  : spec-manifest.yaml  ({N} features)
-Mode    : {umbrella | single}
-.gitignore : ✅ spec-manifest.yaml excluded
-
-Summary:
-  {N} PRD scanned  ({A} approved, {D} draft)
-  {N} PDD matched
-  {N} BDD file matched  (across {S} services)
-  {N} Tech-doc file matched  (across {S} services)
-
-  ⚠️  {N} PRD không có BDD khớp:
-    - {TICKET-ID} ({domain}) — chạy /generate-bdd trước
-  ⚠️  {N} PRD không có tech-docs khớp:
-    - {TICKET-ID} ({domain}) — chạy /generate-tech-docs trước
-
-Next   : Chia sẻ path spec-manifest.yaml với tester agent
-         Sinh lại bất cứ lúc nào: /generate-spec-manifest
-```