@torus-engineering/tas-kit 1.11.1 → 1.13.0

package/.tas/tas-example.yaml

@@ -1,126 +1,125 @@
-# .tas/tas-example.yaml - Reference template for tas.yaml at root
-# Copy this file to root (tas.yaml) and fill in project information.
-# This file ONLY contains TAS flow and logic.
-# Tech stack, coding conventions, build commands belong in CLAUDE.md.
-
-project:
-  name: "My Project"
-  code: "PROJ"              # Prefix for file naming: PROJ-Epic-001, PROJ-Feature-001, etc.
-  type: greenfield          # greenfield | brownfield
-  description: "Brief project description"
-
-# Azure DevOps integration
-ado:
-  enabled: true                 # false if project doesn't use ADO
-  organization: "https://dev.azure.com/torus-engineering"
-  project_id: "f80dac23-9fa5-4b8e-a1db-da4d5aea7b31"
-
-team:
-  - name: "Nguyen Van A"
-    role: pe
-    ado_id: "nguyenvana@torus.vn"
-  - name: "Tran Van B"
-    role: se
-    ado_id: "tranvanb@torus.vn"
-  - name: "Le Van C"
-    role: dse
-    ado_id: "levanc@torus.vn"
-
-# Flow configuration
-workflow:
-  # Phase 0: Discovery & Design (Human-led, AI-powered)
-  discovery:
-    enabled: true
-    lead: pe
-    artifacts:
-      - prd
-      - design_spec
-      - sad
-      - adr
-      - epic
-      - feature
-      - story
-    gate: ready_for_development
-
-  # Phase 1: Develop (Orchestrated Agentic)
-  develop:
-    enabled: true
-    lead: se
-    environment: test
-    use_tdd: true
-    auto_review: true
-
-  # Phase 2: Verify (Agentic + PE Review)
-  verify:
-    enabled: true
-    lead: pe
-    environment: staging
-    auto_integration_test: true
-    gate: pe_approved
-
-  # Phase 3: Deploy with Feature Flag (Agentic)
-  deploy:
-    enabled: true
-    lead: dse
-    environment: production
-    feature_flag: true
-    gate: pe_approved_production
-
-  # Phase 4: Operate (Autonomous)
-  operate:
-    enabled: false
-    lead: dse
-    environment: production
-    security_check: true
-    performance_monitor: true
-
-# Brownfield-specific config
-brownfield:
-  existing_docs_path: "docs/"
-  codebase_scan_on_init: true
-
-# Pre-commit security hook (installed via tas-kit install --security-hook=husky|native)
-# See .tas/hooks/README.md for details
-#
-# 3-tier scan:
-#   Tier 1 (always): built-in regex scan for ~45 secret patterns — blocks
-#   Tier 2 (if on PATH): gitleaks / trufflehog — only runs if installed — blocks
-#   Tier 3 (opt-in, LOCAL ONLY): AI deep scan → writes docs/security-report.md;
-#                                does NOT block. Use a personal Claude Code
-#                                subscription (no API charges). Not for CI.
-security:
-  pre_commit_hook: true                    # master switch; false to disable without uninstalling
-  external_scanner: auto                   # auto | gitleaks | trufflehog | none — tier 2
-  tool: claude                             # claude | codex | gemini | none — tier 3 AI (report-only)
-  deep_scan_on_every_commit: false         # true = opt into tier 3 AI review each local commit
-  block_on: [critical, high]               # severities that block commit (tier 1 & 2 only)
-  allow_bypass: true                       # print hint about SKIP_SECURITY_SCAN / --no-verify
-
-# Template overrides (optional)
-templates:
-  sad: ".tas/templates/SAD.md"
-  adr: ".tas/templates/ADR.md"
-  prd: ".tas/templates/PRD.md"
-  epic: ".tas/templates/Epic.md"
-  feature: ".tas/templates/Feature.md"
-  story: ".tas/templates/Story.md"
-  bug: ".tas/templates/Bug.md"
-
-# Model mapping
-models:
-  default: sonnet
-  commands:
-    tas-prd: sonnet
-    tas-design: sonnet
-    tas-sad: opus
-    tas-adr: opus
-    tas-epic: sonnet
-    tas-feature: sonnet
-    tas-story: sonnet
-    tas-dev: sonnet
-    tas-review-code: opus
-    tas-brainstorm: opus
-    tas-bug: sonnet
-    tas-verify: haiku
-    tas-status: haiku
-    tas-security-check: opus
+# .tas/tas-example.yaml - Reference template for tas.yaml at root
+# Copy this file to root (tas.yaml) and fill in project information.
+# This file ONLY contains TAS flow and logic.
+# Tech stack, coding conventions, build commands belong in CLAUDE.md.
+
+project:
+  name: "My Project"
+  code: "PROJ"              # Prefix for file naming: PROJ-Epic-001, PROJ-Feature-001, etc.
+  type: greenfield          # greenfield | brownfield
+  description: "Brief project description"
+
+# Azure DevOps integration
+ado:
+  enabled: true                 # false if project doesn't use ADO
+  organization: "https://dev.azure.com/torus-engineering"
+  project_id: "f80dac23-9fa5-4b8e-a1db-da4d5aea7b31"
+
+team:
+  - name: "Nguyen Van A"
+    role: pe
+    ado_id: "nguyenvana@torus.vn"
+  - name: "Tran Van B"
+    role: se
+    ado_id: "tranvanb@torus.vn"
+  - name: "Le Van C"
+    role: dse
+    ado_id: "levanc@torus.vn"
+
+# Flow configuration
+workflow:
+  # Phase 0: Discovery & Design (Human-led, AI-powered)
+  discovery:
+    enabled: true
+    lead: pe
+    artifacts:
+      - prd
+      - design_spec
+      - sad
+      - adr
+      - epic
+      - feature
+      - story
+    gate: ready_for_development
+
+  # Phase 1: Develop (Orchestrated Agentic)
+  develop:
+    enabled: true
+    lead: se
+    environment: test
+    use_tdd: true
+    auto_review: true
+
+  # Phase 2: Verify (Agentic + PE Review)
+  verify:
+    enabled: true
+    lead: pe
+    environment: staging
+    auto_integration_test: true
+    gate: pe_approved
+
+  # Phase 3: Deploy with Feature Flag (Agentic)
+  deploy:
+    enabled: true
+    lead: dse
+    environment: production
+    feature_flag: true
+    gate: pe_approved_production
+
+  # Phase 4: Operate (Autonomous)
+  operate:
+    enabled: false
+    lead: dse
+    environment: production
+    security_check: true
+    performance_monitor: true
+
+# Brownfield-specific config
+brownfield:
+  existing_docs_path: "docs/"
+  codebase_scan_on_init: true
+
+# Pre-commit security hook (installed via tas-kit install --security-hook=husky|native)
+# See .tas/hooks/README.md for details
+#
+# 3-tier scan:
+#   Tier 1 (always): built-in regex scan for ~45 secret patterns — blocks
+#   Tier 2 (if on PATH): gitleaks / trufflehog — only runs if installed — blocks
+#   Tier 3 (opt-in, LOCAL ONLY): AI deep scan → writes docs/security-report.md;
+#                                does NOT block. Use a personal Claude Code
+#                                subscription (no API charges). Not for CI.
+security:
+  pre_commit_hook: true                    # master switch; false to disable without uninstalling
+  external_scanner: auto                   # auto | gitleaks | trufflehog | none — tier 2
+  tool: claude                             # claude | codex | gemini | none — tier 3 AI (report-only)
+  deep_scan_on_every_commit: false         # true = opt into tier 3 AI review each local commit
+  block_on: [critical, high]               # severities that block commit (tier 1 & 2 only)
+  allow_bypass: true                       # print hint about SKIP_SECURITY_SCAN / --no-verify
+
+# Template overrides (optional)
+templates:
+  sad: ".tas/templates/SAD.md"
+  adr: ".tas/templates/ADR.md"
+  prd: ".tas/templates/PRD.md"
+  epic: ".tas/templates/Epic.md"
+  feature: ".tas/templates/Feature.md"
+  story: ".tas/templates/Story.md"
+  bug: ".tas/templates/Bug.md"
+
+# Model mapping
+models:
+  default: sonnet
+  commands:
+    tas-prd: sonnet
+    tas-design: sonnet
+    tas-sad: opus
+    tas-adr: opus
+    tas-epic: sonnet
+    tas-feature: sonnet
+    tas-story: sonnet
+    tas-dev: sonnet
+    tas-review: opus
+    tas-brainstorm: opus
+    tas-bug: sonnet
+    tas-status: haiku
+    tas-security: opus

package/.tas/templates/ADR.md

@@ -1,47 +1,47 @@
-# ADR-{NNN}: {Title}
-
-> **Status:** Proposed | Accepted | Deprecated | Superseded
-> **Date:** [Date]
-> **Author:** [SE name]
-> **Supersedes:** [ADR-NNN if any]
-> **Related:** [ADR-NNN if any]
-
-## Context
-[Describe context leading to this decision. What problem needs solving?]
-
-## Decision
-[Describe the chosen architectural decision.]
-
-## Rationale
-[Why choose this approach? Technical and business reasons.]
-
-## Alternatives Considered
-
-### Alternative 1: [Name]
-- **Pros:** [advantages]
-- **Cons:** [disadvantages]
-- **Why not chosen:** [explanation]
-
-### Alternative 2: [Name]
-- **Pros:** [advantages]
-- **Cons:** [disadvantages]
-- **Why not chosen:** [explanation]
-
-## Consequences
-
-### Positive
-- [consequence 1]
-- [consequence 2]
-
-### Negative
-- [consequence 1]
-- [consequence 2]
-
-### SAD Updates
-*(List changes needed to update docs/sad.md - only add when ADR affects overall architecture)*
-- [ ] [change 1]
-- [ ] [change 2]
-
-## Changelog
-| Date | Changes | Author |
-|------|---------|--------|
+# ADR-{NNN}: {Title}
+
+> **Status:** Proposed | Accepted | Deprecated | Superseded
+> **Date:** [Date]
+> **Author:** [SE name]
+> **Supersedes:** [ADR-NNN if any]
+> **Related:** [ADR-NNN if any]
+
+## Context
+[Describe context leading to this decision. What problem needs solving?]
+
+## Decision
+[Describe the chosen architectural decision.]
+
+## Rationale
+[Why choose this approach? Technical and business reasons.]
+
+## Alternatives Considered
+
+### Alternative 1: [Name]
+- **Pros:** [advantages]
+- **Cons:** [disadvantages]
+- **Why not chosen:** [explanation]
+
+### Alternative 2: [Name]
+- **Pros:** [advantages]
+- **Cons:** [disadvantages]
+- **Why not chosen:** [explanation]
+
+## Consequences
+
+### Positive
+- [consequence 1]
+- [consequence 2]
+
+### Negative
+- [consequence 1]
+- [consequence 2]
+
+### SAD Updates
+*(List changes needed to update docs/sad.md - only add when ADR affects overall architecture)*
+- [ ] [change 1]
+- [ ] [change 2]
+
+## Changelog
+| Date | Changes | Author |
+|------|---------|--------|

package/.tas/templates/Bug.md

@@ -1,67 +1,67 @@
----
-ado_id:
-ado_type: Bug
-ado_title: "{Title}"
-ado_state: New
-ado_assigned_to:
-ado_created:
-last_ado_sync:
-parent_ado_id:
----
-# Bug-{NNN}: {Title}
-
-> **Status:** New | Committed | In Progress | Deploy Test | Verify Test | Deploy Stag | Verify Stag | Deploy Prod | Verify Prod | Done
-> **Feature:** Feature-{NNN}
-> **Severity:** Critical | High | Medium | Low
-> **Found in:** Test | Staging | Production
-> **Found by:** {PE/SE name}
-> **Assigned to:** {SE name}
-> **Created:** {Date}
-
-## Description
-{Brief bug description}
-
-## Steps to Reproduce
-1. {Step 1}
-2. {Step 2}
-3. {Step 3}
-
-## Expected Behavior
-{Expected result}
-
-## Actual Behavior
-{Actual result}
-
-## Evidence
-{Screenshots, logs, error messages}
-
-## Root Cause Analysis
-*SE fills when analyzing*
-- **Root Cause:** {Root cause description}
-- **Affected Files:** {List of related files}
-- **Impact Scope:** {Affected functionality}
-
-## Regression Test Cases
-*SE designs before fixing*
-
-| ID | Description | Input | Expected | Status |
-|----|-------------|-------|----------|--------|
-| RT-1 | Reproduce bug case | {input} | {expected} | - |
-| RT-2 | Related regression | {input} | {expected} | - |
-
-## Fix Notes
-*SE fills after fixing*
-- **Fix Description:** {Fix description}
-- **Files Changed:** {List of changed files}
-- **Commit:** {commit hash}
-
-## Verify Notes
-*PE fills when verifying*
-
-| Date | Environment | Result | Verified by | Notes |
-|------|-------------|--------|-------------|-------|
-| {Date} | {env} | Pass/Fail | {PE name} | {notes} |
-
-## Changelog
-| Date | Changes | Author |
-|------|---------|--------|
+---
+ado_id:
+ado_type: Bug
+ado_title: "{Title}"
+ado_state: New
+ado_assigned_to:
+ado_created:
+last_ado_sync:
+parent_ado_id:
+---
+# Bug-{NNN}: {Title}
+
+> **Status:** New | Committed | In Progress | Deploy Test | Verify Test | Deploy Stag | Verify Stag | Deploy Prod | Verify Prod | Done
+> **Feature:** Feature-{NNN}
+> **Severity:** Critical | High | Medium | Low
+> **Found in:** Test | Staging | Production
+> **Found by:** {PE/SE name}
+> **Assigned to:** {SE name}
+> **Created:** {Date}
+
+## Description
+{Brief bug description}
+
+## Steps to Reproduce
+1. {Step 1}
+2. {Step 2}
+3. {Step 3}
+
+## Expected Behavior
+{Expected result}
+
+## Actual Behavior
+{Actual result}
+
+## Evidence
+{Screenshots, logs, error messages}
+
+## Root Cause Analysis
+*SE fills when analyzing*
+- **Root Cause:** {Root cause description}
+- **Affected Files:** {List of related files}
+- **Impact Scope:** {Affected functionality}
+
+## Regression Test Cases
+*SE designs before fixing*
+
+| ID | Description | Input | Expected | Status |
+|----|-------------|-------|----------|--------|
+| RT-1 | Reproduce bug case | {input} | {expected} | - |
+| RT-2 | Related regression | {input} | {expected} | - |
+
+## Fix Notes
+*SE fills after fixing*
+- **Fix Description:** {Fix description}
+- **Files Changed:** {List of changed files}
+- **Commit:** {commit hash}
+
+## Verify Notes
+*PE fills when verifying*
+
+| Date | Environment | Result | Verified by | Notes |
+|------|-------------|--------|-------------|-------|
+| {Date} | {env} | Pass/Fail | {PE name} | {notes} |
+
+## Changelog
+| Date | Changes | Author |
+|------|---------|--------|

package/.tas/templates/Design-Spec.md

@@ -1,36 +1,36 @@
-# Design Specification
-
-> **Status:** Draft | Approved
-> **Last Updated:** [Date]
-> **Author:** [PE name]
-> **PRD Reference:** docs/prd.md
-
----
-
-## 1. Overview
-{Design overview}
-
-## 2. User Flows
-<!-- Use Mermaid flowchart, :::mermaid wrapper, no () -->
-
-## 3. Screen Descriptions
-
-### Screen 1: {Name}
-- **Purpose:** {purpose}
-- **Key Elements:** {key elements}
-- **Actions Available:** {user actions available}
-
-## 4. Navigation Structure
-<!-- Use Mermaid flowchart -->
-
-## 5. Interaction Patterns
-{Describe patterns: form submission, search, pagination...}
-
-## 6. Responsive Behavior
-{Describe breakpoints and behavior changes}
-
----
-
-## Changelog
-| Date | Changes | Author |
-|------|---------|--------|
+# Design Specification
+
+> **Status:** Draft | Approved
+> **Last Updated:** [Date]
+> **Author:** [PE name]
+> **PRD Reference:** docs/prd.md
+
+---
+
+## 1. Overview
+{Design overview}
+
+## 2. User Flows
+<!-- Use Mermaid flowchart, :::mermaid wrapper, no () -->
+
+## 3. Screen Descriptions
+
+### Screen 1: {Name}
+- **Purpose:** {purpose}
+- **Key Elements:** {key elements}
+- **Actions Available:** {user actions available}
+
+## 4. Navigation Structure
+<!-- Use Mermaid flowchart -->
+
+## 5. Interaction Patterns
+{Describe patterns: form submission, search, pagination...}
+
+## 6. Responsive Behavior
+{Describe breakpoints and behavior changes}
+
+---
+
+## Changelog
+| Date | Changes | Author |
+|------|---------|--------|

package/.tas/templates/Epic.md

@@ -1,46 +1,46 @@
----
-ado_id:
-ado_type: Epic
-ado_title: "{Title}"
-ado_state: New
-ado_assigned_to:
-ado_created:
-last_ado_sync:
----
-# Epic-{NNN}: {Title}
-
-> **Status:** New | Pending | In Design | In Progress | In Monitoring | In Closing | Done | Removed
-> **Owner:** {PE name}
-> **Created:** {Date}
-> **PRD Reference:** {link to PRD section}
-
-## Business Value
-{Business value description}
-
-## Scope
-### In Scope
-- Item 1
-- Item 2
-
-### Out of Scope
-- Item 1
-
-## Acceptance Criteria (High-level)
-- [ ] Criteria 1
-- [ ] Criteria 2
-
-## Features
-| ID | Feature | Priority | Estimate |
-|----|---------|----------|----------|
-| Feature-001 | {name} | Must | M |
-| Feature-002 | {name} | Should | L |
-
-## Dependencies
-- {dependency 1}
-
-## Risks
-- {risk 1}
-
-## Changelog
-| Date | Changes | Author |
-|------|---------|--------|
+---
+ado_id:
+ado_type: Epic
+ado_title: "{Title}"
+ado_state: New
+ado_assigned_to:
+ado_created:
+last_ado_sync:
+---
+# Epic-{NNN}: {Title}
+
+> **Status:** New | Pending | In Design | In Progress | In Monitoring | In Closing | Done | Removed
+> **Owner:** {PE name}
+> **Created:** {Date}
+> **PRD Reference:** {link to PRD section}
+
+## Business Value
+{Business value description}
+
+## Scope
+### In Scope
+- Item 1
+- Item 2
+
+### Out of Scope
+- Item 1
+
+## Acceptance Criteria (High-level)
+- [ ] Criteria 1
+- [ ] Criteria 2
+
+## Features
+| ID | Feature | Priority | Estimate |
+|----|---------|----------|----------|
+| Feature-001 | {name} | Must | M |
+| Feature-002 | {name} | Should | L |
+
+## Dependencies
+- {dependency 1}
+
+## Risks
+- {risk 1}
+
+## Changelog
+| Date | Changes | Author |
+|------|---------|--------|

package/.tas/templates/Feature.md

@@ -43,7 +43,7 @@ PE designs when creating Feature. SE implements in code.
 | IT-2 | AC-2 | {Integration flow description} | {Expected result} | - |
 
 ## E2E / Acceptance Test Cases
-PE designs when creating Feature. PE verifies on Staging in Phase 2 using /tas-verify.
+PE designs when creating Feature. PE verifies on Staging in Phase 2 using /tas-functest + /tas-e2e.
 
 | ID | AC Ref | User Scenario | Steps | Expected Result | Status | Verified Date |
 |----|--------|---------------|-------|-----------------|--------|---------------|