@damphuquy/agent-init 1.3.0 → 1.4.0

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAyD3C,CAAC;AAEF,wBAAgB,cAAc,IAAI,MAAM,CASvC;AAED,wBAAgB,cAAc,CAAC,cAAc,GAAE,MAAyB,GAAG,WAAW,CAgBrF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EA6D3C,CAAC;AAEF,wBAAgB,cAAc,IAAI,MAAM,CASvC;AAED,wBAAgB,cAAc,CAAC,cAAc,GAAE,MAAyB,GAAG,WAAW,CAgBrF"}

package/dist/config.js

@@ -22,6 +22,7 @@ export const FILE_GROUPS = [
         title: 'Operational Workspace Control & Seeds (_seeds/)',
         files: [
             { path: 'process/README.md', desc: 'Operational Workspace Control Center' },
+            { path: 'process/.editorconfig', desc: 'Consistent editor and format rules for process artifacts' },
             { path: 'process/_seeds/_GUIDE.md', desc: 'Seed archetypes usage & lifecycle guide' },
             { path: 'process/_seeds/task-template.md.seed', desc: 'Task master contract & RIPER-5 execution plan' },
             { path: 'process/_seeds/context-group.md.seed', desc: 'Research phase artifact blueprint' },
@@ -30,6 +31,8 @@ export const FILE_GROUPS = [
             { path: 'process/_seeds/state-template.md.seed', desc: 'Execute loop persistent memory' },
             { path: 'process/_seeds/review-template.md.seed', desc: 'Review phase artifact & Gate 3' },
             { path: 'process/_seeds/handoff-template.md.seed', desc: 'Final projection (intentionally short)' },
+            { path: 'process/_seeds/cancellation-template.md.seed', desc: 'Knowledge-preserving task cancellation record' },
+            { path: 'process/_seeds/results-template.tsv.seed', desc: 'Benchmark & quantitative metrics evaluation registry' },
             { path: 'process/_seeds/program-template.md.seed', desc: 'Multi-phase umbrella epic blueprint' },
         ],
     },
@@ -38,6 +41,7 @@ export const FILE_GROUPS = [
         files: [
             { path: 'process/context/all-context.md', desc: 'Root context & knowledge routing registry' },
             { path: 'process/context/planning/all-planning.md', desc: 'INVEST criteria & vertical slicing standards' },
+            { path: 'process/context/tests/all-tests.md', desc: 'Test pyramid, isolation policies, and harness strategy' },
         ],
     },
     {

package/dist/config.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damphuquy/agent-init",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Scaffolding CLI to bootstrap RIPER-5 Coding Agents & Operational Workspace",
   "type": "module",
   "main": "./dist/index.js",

package/templates/process/.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.tsv]
+indent_style = tab
+
+[*.md]
+trim_trailing_whitespace = false

package/templates/process/README.md

@@ -13,6 +13,7 @@
 ```text
 process/
 ├── README.md                         # Operational guide (this file)
+├── .editorconfig                     # Unified format settings for markdown, tsv, json
 ├── _seeds/                           # Read-only archetype blueprints
 │   ├── _GUIDE.md                     # Full catalog, artifact chain, and instantiation commands
 │   ├── task-template.md.seed         # Master contract & RIPER state record
@@ -22,10 +23,13 @@ process/
 │   ├── state-template.md.seed        # Execute loop persistent memory
 │   ├── review-template.md.seed       # Review phase artifact (Gate 3)
 │   ├── handoff-template.md.seed      # Final projection (short)
+│   ├── cancellation-template.md.seed # Knowledge-preserving cancellation record
+│   ├── results-template.tsv.seed     # Benchmark & quantitative metrics tracker
 │   └── program-template.md.seed      # Multi-phase program blueprint
 ├── context/                          # Durable knowledge base & context routers
 │   ├── all-context.md                # Root context router
-│   └── planning/all-planning.md      # Planning calibration & vertical slicing rules
+│   ├── planning/all-planning.md      # Planning calibration & vertical slicing rules
+│   └── tests/all-tests.md            # Testing pyramid, harness policy & mock conventions
 ├── development-protocols/            # System rules & execution harness
 │   ├── all-development-protocols.md
 │   ├── orchestration.md              # Subagent delegation rules
@@ -39,7 +43,9 @@ process/
 │   │       ├── plan.md               # Plan phase output
 │   │       ├── state.md              # Execute loop memory
 │   │       ├── review.md             # Review phase output
-│   │       └── handoff.md            # Final projection
+│   │       ├── handoff.md            # Final projection
+│   │       ├── results.tsv           # (Optional) Benchmark & metric iteration tracking
+│   │       └── cancelled.md          # (If aborted) Cancellation findings & rollback status
 │   ├── completed/                    # Archived task workspaces
 │   └── backlog/                      # Backlog notes: {note_slug}_NOTE_{dd-mm-yy}.md
 └── general-plans/                    # Cross-cutting & standalone tasks
@@ -101,6 +107,8 @@ handoff.md       ← (Complete) Short final projection
 | Execute | source code + tests + `state.md` |
 | Review | `review.md` |
 | Handoff | `handoff.md` |
+| Cancellation | `cancelled.md` (knowledge preservation upon abort) |
+| Benchmark / Metrics | `results.tsv` (performance and eval metrics) |
 | Gate 1 | `decision.md` approval |
 | Gate 2 | `plan.md` approval |
 | Gate 3 | `review.md` approval |

package/templates/process/_seeds/_GUIDE.md

@@ -69,6 +69,16 @@
     blast radius registries, and phase gate rules.
   </seed>
 
+  <seed type="cancellation" path="cancellation-template.md.seed">
+    Task cancellation record. Preserves investigation findings, decision rationale,
+    reusable prototypes/tests, and rollback verification when an in-flight task is cancelled.
+  </seed>
+
+  <seed type="results" path="results-template.tsv.seed">
+    Benchmark and quantitative metrics evaluation registry.
+    Use for tracking latency, throughput, memory, or eval scores across iterations and vertical slices.
+  </seed>
+
 </catalog>
 
 ---
@@ -107,15 +117,28 @@ handoff.md      ← Final projection (short)
 
 ## 3. Recommended Task Workspace Layout
 
+### Standard Single-Project Layout
 ```text
 process/features/active/CHG-017-your-feature/
-├── task.md          ← instantiated from task-template.md.seed
-├── research.md      ← instantiated from context-group.md.seed
-├── decision.md      ← instantiated from decision-template.md.seed
-├── plan.md          ← instantiated from plan-template.md.seed
-├── state.md         ← instantiated from state-template.md.seed
-├── review.md        ← instantiated from review-template.md.seed
-└── handoff.md       ← instantiated from handoff-template.md.seed
+├── task.md          ← instantiated from task-template.md.seed (Master Spec & AC)
+├── research.md      ← instantiated from context-group.md.seed (Research Output)
+├── decision.md      ← instantiated from decision-template.md.seed (Gate 1 Options)
+├── plan.md          ← instantiated from plan-template.md.seed (Gate 2 Execution Contract)
+├── state.md         ← instantiated from state-template.md.seed (Execute Memory)
+├── review.md        ← instantiated from review-template.md.seed (Gate 3 Audit)
+├── handoff.md       ← instantiated from handoff-template.md.seed (Final Projection)
+├── results.tsv      ← (Optional) instantiated from results-template.tsv.seed (Metrics/Benchmarks)
+└── cancelled.md     ← (If cancelled) instantiated from cancellation-template.md.seed
+```
+
+### Monorepo / Multi-Domain Layout (Optional)
+When working in monorepos with independent domains (e.g. `mobile-app`, `billing-service`), partition features by domain:
+```text
+process/features/{domain-slug}/
+├── active/
+│   └── CHG-XXX-your-feature/
+├── backlog/
+└── completed/
 ```
 
 Not all artifacts are required at start. Create them progressively as the task advances through RIPER phases.
@@ -128,7 +151,7 @@ Not all artifacts are required at start. Create them progressively as the task a
 # Create a new task workspace
 mkdir -p process/features/active/CHG-XXX-your-feature
 
-# Instantiate seeds into the workspace
+# Instantiate primary seeds into the workspace
 cp process/_seeds/task-template.md.seed     process/features/active/CHG-XXX-your-feature/task.md
 cp process/_seeds/context-group.md.seed    process/features/active/CHG-XXX-your-feature/research.md
 cp process/_seeds/decision-template.md.seed process/features/active/CHG-XXX-your-feature/decision.md
@@ -136,6 +159,12 @@ cp process/_seeds/plan-template.md.seed    process/features/active/CHG-XXX-your-
 cp process/_seeds/state-template.md.seed   process/features/active/CHG-XXX-your-feature/state.md
 cp process/_seeds/review-template.md.seed  process/features/active/CHG-XXX-your-feature/review.md
 cp process/_seeds/handoff-template.md.seed process/features/active/CHG-XXX-your-feature/handoff.md
+
+# (Optional) Tracking performance or evaluation metrics:
+cp process/_seeds/results-template.tsv.seed process/features/active/CHG-XXX-your-feature/results.tsv
+
+# (When cancelling an in-flight task):
+cp process/_seeds/cancellation-template.md.seed process/features/active/CHG-XXX-your-feature/cancelled.md
 ```
 
 </seeds_guide>

package/templates/process/_seeds/cancellation-template.md.seed

@@ -0,0 +1,79 @@
+# Cancellation Record: [TASK-ID] [Task Title]
+
+<cancellation_record task_id="[TASK-ID]" version="1.0" framework="RIPER-5">
+
+<!--
+  TASK CANCELLATION GUIDELINES:
+  - Purpose: Preserve investigation knowledge, technical discoveries, and decision rationale when a task is aborted.
+  - Never delete a task workspace outright if research or partial planning has occurred.
+  - Instantiate this file as `cancelled.md` inside the task workspace.
+  - Complete the reversal checklist, then move the task directory to `completed/` (or `cancelled/`).
+-->
+
+<status>
+  <phase_at_cancellation>[RESEARCH | INNOVATE | PLAN | EXECUTE | REVIEW]</phase_at_cancellation>
+  <cancelled_date>[YYYY-MM-DD or DD-MM-YY]</cancelled_date>
+  <cancelled_by>[@engineer_or_product_lead]</cancelled_by>
+  <reversal_status>[CLEAN | ROLLBACK_APPLIED | DIRTY_NEEDS_MANUAL_CLEANUP]</reversal_status>
+</status>
+
+---
+
+## 1. Rationale for Cancellation
+
+<cancellation_rationale>
+  <primary_reason>
+    <!-- [e.g. Pivot in product strategy / Architectural blocker / Excessive blast radius / Superseded by CHG-YYY] -->
+    [Concise summary of why this task was terminated prematurely.]
+  </primary_reason>
+
+  <decision_context>
+    [Detailed context, trade-offs evaluated, and key stakeholder guidance that led to cancellation.]
+  </decision_context>
+</cancellation_rationale>
+
+---
+
+## 2. Technical Findings & Preserved Knowledge
+
+<preserved_knowledge>
+  <codebase_discoveries>
+    <!-- What did we learn about the system, data models, or hidden dependencies during this task? -->
+    - [Discovery 1 — Component behavior, undocumented API limits, or legacy constraints]
+    - [Discovery 2 — Existing tests or subsystem boundaries uncovered]
+  </codebase_discoveries>
+
+  <invalidated_hypotheses>
+    <!-- What assumptions proved false during investigation? -->
+    - [Hypothesis that turned out incorrect or infeasible]
+  </invalidated_hypotheses>
+
+  <reusable_assets>
+    <!-- Are there test cases, draft schemas, benchmarks, or prototypes that future tasks can reuse? -->
+    - [Reusable asset 1: test cases or data models in draft branch / commit]
+  </reusable_assets>
+</preserved_knowledge>
+
+---
+
+## 3. Working Tree Reversal & Cleanup Checklist
+
+<cleanup_checklist>
+  - [ ] Uncommitted changes rolled back or stashed cleanly (`git status` clean)
+  - [ ] Temporary debug logs, scratch scripts, or test dumps deleted
+  - [ ] No phantom migrations or schema artifacts left in local database
+  - [ ] Task folder archived to `completed/` (or `cancelled/`)
+</cleanup_checklist>
+
+---
+
+## 4. Superseding Task or Follow-Up
+
+<follow_up>
+  <superseded_by>[Link to new task folder or CHG-YYY, or NONE]</superseded_by>
+  <recommended_next_action>
+    [Specific recommendations if this problem is revisited in the future.]
+  </recommended_next_action>
+</follow_up>
+
+</cancellation_record>

package/templates/process/_seeds/results-template.tsv.seed

@@ -0,0 +1,5 @@
+# Benchmark & Metric Evaluation Registry (RIPER-5 Framework)
+# Instantiate as results.tsv in task workspace when tracking performance, latency, memory, or eval metrics.
+iteration	timestamp	slice_id	metric_name	baseline	observed	unit	diff_pct	status	notes
+0	2026-01-01T00:00:00Z	baseline	p99_latency_ms	100.0	100.0	ms	0.0%	BASELINE	Initial baseline measurement
+1	2026-01-01T01:00:00Z	slice-01	p99_latency_ms	100.0	75.0	ms	-25.0%	PASS	Optimization slice 1 applied

package/templates/process/context/all-context.md

@@ -29,6 +29,12 @@
     <scope>Scaffolding seeds for tasks, research, decisions, plans, state, reviews, handoffs, and programs. Full artifact chain and instantiation commands.</scope>
   </group>
 
+  <group id="tests">
+    <title>Testing Standards & Harness Strategy</title>
+    <path>[`tests/all-tests.md`](tests/all-tests.md)</path>
+    <scope>Test pyramid, unit/integration isolation policies, mock conventions, and test fixtures</scope>
+  </group>
+
   <group id="protocols">
     <title>Development Protocols Index</title>
     <path>[`../development-protocols/all-development-protocols.md`](../development-protocols/all-development-protocols.md)</path>

package/templates/process/context/tests/all-tests.md

@@ -0,0 +1,56 @@
+# Testing Standards & Harness Strategy Context
+
+<testing_context version="1.0">
+
+<overview>
+  Guidelines for test pyramid calibration, isolation policies, mock conventions, and automated verification harness across the system.
+</overview>
+
+## 1. Test Pyramid & Classification
+<test_pyramid>
+  <layer name="Unit Tests" path="tests/unit/">
+    - Scope: Pure business logic, domain models, utility functions, edge case branching.
+    - Execution speed: Fast (< 50ms per test), zero network/disk/external I/O.
+    - Mock policy: Mock all I/O boundaries, external clients, and port interfaces.
+  </layer>
+
+  <layer name="Integration Tests" path="tests/integration/">
+    - Scope: Database persistence, external API client adapters, framework wiring.
+    - Isolation: Ephemeral test containers (e.g. Testcontainers) or dedicated isolated test database per suite.
+    - Teardown: Must guarantee zero state leakage across test runs.
+  </layer>
+
+  <layer name="End-to-End Tests" path="tests/e2e/">
+    - Scope: Critical user journeys, full HTTP/gRPC API lifecycle, regression smoke tests.
+    - Verification: Validates end-to-end contract integrity across subsystems.
+  </layer>
+</test_pyramid>
+
+## 2. Test Harness Policies
+<test_policies>
+  <policy name="Determinism">
+    Zero flaky tests. Tests must not depend on real wall-clock time (use frozen clocks or fake timers) or randomized execution order.
+  </policy>
+
+  <policy name="Clean State">
+    Every test must seed its own data or fixtures. Tests must never assume pre-existing database rows.
+  </policy>
+
+  <policy name="Assertion Precision">
+    Avoid vague assertions (e.g. `expect(res).toBeTruthy()`). Always assert exact expected structures, status codes, and error types.
+  </policy>
+
+  <policy name="Fast Feedback">
+    Unit tests must execute in under 30 seconds for the entire suite. Slow integration suites must be cleanly partitioned.
+  </policy>
+</test_policies>
+
+## 3. Verification Commands Mapping
+<verification_commands>
+  <!-- Keep aligned with AGENTS.md <validation_commands> -->
+  <command type="unit">Run fast unit test suite</command>
+  <command type="integration">Run integration/e2e tests</command>
+  <command type="coverage">Run test coverage check</command>
+</verification_commands>
+
+</testing_context>