@torus-engineering/tas-kit 1.5.0

package/.tas/templates/Security-Report.md

@@ -0,0 +1,27 @@
+# Security Report
+
+> **Last Scan:** {Date}
+> **Scope:** {Full scan | File/Module specific}
+> **Scanned by:** {DSE name}
+
+## Summary
+| Severity | Open | Fixed | Accepted Risk | Total |
+|----------|------|-------|---------------|-------|
+| Critical | 0 | 0 | 0 | 0 |
+| High | 0 | 0 | 0 | 0 |
+| Medium | 0 | 0 | 0 | 0 |
+| Low | 0 | 0 | 0 | 0 |
+
+## Findings
+
+### SEC-001: {Title}
+- **Severity:** Critical | High | Medium | Low
+- **Status:** Open | In Progress | Fixed | Accepted Risk
+- **Location:** {file:line}
+- **Description:** {Mô tả vấn đề}
+- **Recommended Fix:** {Cách fix cụ thể}
+- **Fixed Date:** {Date, nếu đã fix}
+
+## Scan History
+| Date | Scope | New Findings | Fixed | Remaining |
+|------|-------|-------------|-------|-----------|

package/.tas/templates/Story.md

@@ -0,0 +1,88 @@
+---
+ado_id:
+ado_type: User Story
+ado_title: "{Title}"
+ado_state: New
+ado_assigned_to:
+ado_created:
+last_ado_sync:
+parent_ado_id:
+---
+# Story-{NNN}: {Title}
+
+> **Status:** New | Committed | In Progress | Deploy Test | Verify Test | Deploy Stag | Verify Stag | Deploy Prod | Verify Prod | Done
+> **Feature:** Feature-{NNN}
+> **Assigned to:** {SE name}
+> **Estimate:** {S/M/L}
+> **Created:** {Date}
+
+## User Story
+As a {role}, I want {goal}, so that {benefit}.
+
+---
+## Context from PRD (nếu có)
+*(Chỉ thêm section này khi Story có business requirements đặc biệt cần lưu ý)*
+
+---
+## Context from SAD/ADR (nếu có)
+*(Chỉ thêm section này khi Story có architecture decisions, patterns, hoặc constraints cần tuân thủ)*
+
+- **Relevant Components:** {components liên quan}
+- **Patterns to follow:** {patterns từ SAD/ADR}
+- **Constraints:** {nếu có}
+
+---
+## Prerequisites from Feature (nếu có)
+*(Chỉ thêm section này khi Story có dependency từ Stories khác hoặc prerequisites)*
+
+---
+## Implementation Context
+
+## Acceptance Criteria
+### AC-1: {title}
+- **Given** {precondition}
+- **When** {action}
+- **Then** {expected result}
+
+### AC-2: {title}
+- **Given** {precondition}
+- **When** {action}
+- **Then** {expected result}
+
+## Technical Notes
+- **Files to modify:** {list}
+- **Patterns:** {reference to SAD/ADR}
+- **Database changes:** {if any}
+
+## Unit Test Cases
+SE implement trong code. PE thiết kế happy path + edge cases + negative cases khi tạo Story.
+
+### Happy Path
+| ID | Description | Input | Expected Output |
+|----|-------------|-------|-----------------|
+| UT-1 | {description} | {input} | {expected} |
+
+### Edge Cases
+| ID | Description | Input | Expected Output |
+|----|-------------|-------|-----------------|
+| UT-E1 | {description} | {input} | {expected} |
+
+### Negative Cases
+| ID | Description | Input | Expected Output |
+|----|-------------|-------|-----------------|
+| UT-N1 | {description} | {input} | {expected} |
+
+### Dependencies to Mock
+- {external API, database state, third-party service...}
+
+## Definition of Done
+- [ ] Code implemented
+- [ ] Unit tests pass
+- [ ] Code review passed
+- [ ] Acceptance criteria verified
+- [ ] No regression
+- [ ] Documentation updated (if needed)
+
+## Changelog
+| Date | Changes | Author |
+|------|---------|--------|

package/.tas/tools/tas-ado-readme.md

@@ -0,0 +1,169 @@
+# TAS Kit Skill Specification: ado-integration
+
+**Skill name**: ado-integration  
+**Version**: 0.2 (concept & spec date: March 17, 2026)  
+**Purpose**:  
+Cho phép AI agent trong môi trường coding (Claude Code, Cursor, VS Code + terminal) thực hiện **CRUD** và đồng bộ hai chiều giữa các file Markdown (.md) trong repository và work items trên Azure DevOps (Epic, Feature, User Story, Bug), bao gồm tự động quản lý hierarchy (parent-child relations).
+
+Mục tiêu chính:  
+- Biến AI thành "thành viên đội ngũ" có khả năng tự quản lý backlog mà không cần rời khỏi editor  
+- Đảm bảo file .md là single source of truth (local ↔ ADO sync)  
+- Ghi dấu thời gian đồng bộ để agent biết dữ liệu mới/cũ
+
+## 1. Yêu cầu môi trường & Dependencies
+
+**Bắt buộc**:
+- Azure CLI đã cài + extension `azure-devops`
+  ```bash
+  az extension add --name azure-devops --upgrade
+  ```
+- Python 3.8+
+- Package: `pyyaml` (`pip install pyyaml`)
+
+**Cấu hình** (file `tas.yaml` ở root repo):
+```yaml
+ado:
+  organization: https://dev.azure.com/your-org-name
+  project: Your-Project-Name
+  # pat: PAT với scope Work Items (Full) + optional Read & manage wiki
+  # Nếu không có pat trong file → dùng biến môi trường AZURE_DEVOPS_PAT
+```
+
+## 2. File chính cần tạo
+
+- `tools/tas-ado.py`          → script Python thực thi tất cả lệnh
+- `skills/ado-integration.md` → tài liệu hướng dẫn sử dụng (giống file bạn đang đọc)
+
+## 3. Các lệnh CLI được hỗ trợ
+
+Tất cả lệnh đều chạy dạng:
+
+```bash
+python tools/tas-ado.py <command> [arguments]
+```
+
+### Create commands (tạo mới + tự rename file + optional parent)
+
+```bash
+create-epic   <temp-id> [--parent-id <id>]
+create-feature <temp-id> [--parent-id <id>]
+create-story   <temp-id> [--parent-id <id>]
+create-bug     <temp-id> [--parent-id <id>]
+```
+
+Ví dụ:
+```bash
+python tools/tas-ado.py create-story 789 --parent-id 456
+# → đọc epic-789-*.md → tạo User Story → rename thành story-1234-*.md → add parent relation đến 456
+```
+
+### Pull / Get commands
+
+```bash
+get  <ado-id>
+pull <ado-id>          # alias
+```
+
+Ví dụ:
+```bash
+python tools/tas-ado.py get 5345
+# → tạo/tạo lại file epic-5345-slug-title.md với frontmatter + nội dung
+```
+
+### Update commands
+
+```bash
+update-epic   <ado-id> [--assign <name/email>] [--status <state>]
+update-feature <ado-id> [--assign <...>] [--status <...>]
+update-story   <ado-id> [--assign <...>] [--status <...>]
+update-bug     <ado-id> [--assign <...>] [--status <...>]
+
+update-status <ado-id> --status <state> [--assign <name/email>]
+```
+
+### Delete commands
+
+```bash
+delete-epic   <ado-id>
+delete-feature <ado-id>
+delete-story   <ado-id>
+delete-bug     <ado-id>
+```
+
+## 4. Quy ước file .md
+
+- Pattern tên file: `{type}-{ado_id hoặc temp_id}-{slug-title}.md`
+  - type: epic / feature / story / bug
+  - slug-title: lowercase, thay space bằng -, loại ký tự đặc biệt
+
+- Frontmatter YAML (luôn ở đầu file):
+
+```yaml
+---
+ado_id: 5345
+ado_type: Epic           # Epic / Feature / User Story / Bug
+ado_title: Landing Page Redesign
+ado_state: Active
+ado_assigned_to: Nguyen Van A <email@domain.com>
+ado_created: 2026-03-10
+last_ado_sync: 2026-03-17 15:42:08
+# optional: parent_ado_id: 100   (nếu muốn hỗ trợ detect parent tự động sau này)
+---
+# Tiêu đề (phải trùng ado_title)
+
+Nội dung mô tả, acceptance criteria, steps to reproduce, v.v.
+```
+
+**Quan trọng**:  
+- Mỗi lần **create / pull / update / update-status** thành công → **cập nhật** (hoặc thêm) trường `last_ado_sync` với thời gian hiện tại (format: YYYY-MM-DD HH:MM:SS)
+
+## 5. Yêu cầu logic chi tiết
+
+### Khi create:
+1. Tìm file theo pattern `{type}-{temp_id}-*.md`
+2. Extract title (dòng # đầu tiên), description (phần còn lại)
+3. Tạo work item bằng `az boards work-item create`
+4. Lấy ID mới → rename file thành `{type}-{new_id}-*.md`
+5. Nếu có `--parent-id` → chạy `az boards work-item relation add --id <new_id> --relation-type parent --target-id <parent_id>`
+6. Tự động detect parent_id từ frontmatter `parent_ado_id` hoặc tên file
+7. Cập nhật `last_ado_sync` trong frontmatter
+
+### Khi pull/get:
+1. Lấy work item bằng `az boards work-item show --id <id> --expand fields`
+2. Convert description (HTML → Markdown cơ bản)
+3. Tạo file `{type}-{id}-{slug}.md`
+4. Ghi frontmatter + nội dung
+5. Cập nhật `last_ado_sync`
+
+### Khi update:
+1. Tìm file theo pattern `*-<id>-*.md`
+2. Đọc title & description từ file
+3. Cập nhật bằng `az boards work-item update`
+4. Cập nhật `last_ado_sync`
+
+### Khi update-status:
+1. Tìm file theo pattern
+2. Chỉ update state &/hoặc assigned-to
+3. Cập nhật `last_ado_sync` nếu tìm thấy file
+
+### Khi delete:
+- Chỉ xóa trên ADO, không động đến file local
+
+## 6. Gợi ý mở rộng (không bắt buộc cho v0.2)
+
+- Hỗ trợ thêm fields: priority, effort, labels, acceptance criteria
+- Tự động git add/commit/push sau sync
+- Convert HTML → Markdown tốt hơn (table, code block, list)
+
+## 7. Cách sử dụng trong agent prompt
+
+Ví dụ prompt mẫu cho AI agent:
+
+```
+/ado-create-feature 042 --parent-id 100
+/ado-create-story 789 --parent-id <feature-id vừa tạo>
+/ado-get 1234          # lấy bug mới về để fix
+/ado-update-bug 1234 --status Resolved
+```
+
+Skill này được thiết kế để tích hợp mượt mà vào các framework agentic như TAS Kit, Superpowers, BMAD.