dw-kit 1.2.1 → 1.3.0

package/.dw/core/templates/v2/spec.md

@@ -0,0 +1,68 @@
+---
+task_id: {task-name}
+created: {YYYY-MM-DD}
+status: Draft | Approved | In Progress | Done
+owner: {name}
+depth: quick | standard | thorough
+related_adr: {ADR-XXXX | none}
+target_ship: {YYYY-MM-DD | none}
+---
+
+# Spec: {Task Title}
+
+## Intent
+
+{1-2 paragraphs — what and why. No background padding.}
+
+## Why Now
+
+{Forcing function. Deadline, incident, dependency, opportunity.}
+
+## Scope
+
+### In Scope
+
+**ST-1: {Subtask name}**
+- {Concrete action}
+- Acceptance: {verifiable criterion}
+- Effort: {hours or days}
+
+**ST-2: ...**
+
+### Out of Scope (Won't Contain)
+
+- {Explicit exclusions — prevents scope creep}
+
+## Timeline (if ship target)
+
+| Phase | Duration | Target Date |
+|-------|----------|-------------|
+| ... | ... | ... |
+
+## Risks & Mitigations
+
+| Risk | Severity | Mitigation |
+|------|----------|-----------|
+| ... | H/M/L | ... |
+
+## Success Criteria
+
+Measurable outcomes (not vibes):
+
+- [ ] {Numeric threshold, e.g., "latency <100ms p95"}
+- [ ] {Binary gate, e.g., "passes smoke test"}
+
+## Dependencies
+
+- {Upstream blockers}
+- {External systems}
+
+## Known Unknowns (admitted gaps)
+
+- {Question 1 — to resolve during execution}
+
+## Acceptance (Task Complete When)
+
+- [ ] {High-level criteria, e.g., "shipped to prod"}
+- [ ] {Documentation updated}
+- [ ] {Migration note added if breaking}

package/.dw/core/templates/v2/tracking.md

@@ -0,0 +1,62 @@
+---
+task_id: {task-name}
+started: {YYYY-MM-DD}
+last_updated: {YYYY-MM-DD}
+status: Not Started | In Progress | Blocked | Done
+current_phase: {phase name}
+blockers: {none | description}
+---
+
+# Tracking: {Task Title}
+
+## Status Snapshot
+
+**Phase:** {current}
+**Next milestone:** {date or deliverable}
+
+## Subtask Progress
+
+| # | Subtask | Status | Date | Notes |
+|---|---------|--------|------|-------|
+| ST-1 | ... | ⬜ Pending | — | |
+
+Status legend: ⬜ Pending · 🟡 In Progress · ✅ Done · 🔴 Blocked · ⏸ Paused
+
+## Changelog
+
+### {YYYY-MM-DD} — {Session/commit title}
+
+**Actions taken:**
+- ...
+
+**Decisions made:**
+- ...
+
+**Pain points logged:**
+- ...
+
+## Handoff Notes
+
+**For next session (or next agent):**
+
+- **Read first:** {files}
+- **Current state:** {phase, subtask}
+- **Don't do:** {anti-patterns}
+- **Watch out:** {risks, gotchas}
+
+## Friction Journal
+
+Every time current system causes friction while working, append here:
+
+| Date | Friction | Component | Proposed fix |
+|------|----------|-----------|-------------|
+| ... | ... | ... | ... |
+
+## Agent Debate Log (optional, for thorough depth)
+
+### {Date} — {Context}
+
+**Red-bot findings:** ...
+**Blue-bot suggestions:** ...
+**Incorporated:** ...
+**Deferred:** ...

package/.dw/core/v14-evaluation-protocol.md

@@ -0,0 +1,118 @@
+# v1.4 Evaluation Protocol
+
+> How to decide what to cut in v1.4, based on telemetry evidence from v1.3 in production.
+> Anchored to [ADR-0001](../decisions/0001-v2-pragmatic-lean.md) Cut Criteria Matrix.
+
+---
+
+## Purpose
+
+Prove dw-kit can **cut itself** when data says so — validates the "not a framework cage" principle and grows organizational memory via ADRs.
+
+## Timeline
+
+| Phase | Dates | Activity |
+|-------|-------|----------|
+| Prep | Week 0 | v1.3.0 published + installed on all teams |
+| Collect | Week 1–4 | Normal use; telemetry accumulates locally per dev |
+| Aggregate | End of Week 4 | Each dev exports `.dw/metrics/events.jsonl`, TechLead merges |
+| Analyze | Week 5 (day 1–2) | Run `dw metrics cut-analysis` on merged data |
+| Survey | Week 5 (day 2–3) | Team survey on flagged items (qualitative check) |
+| Decide | Week 5 (day 4) | ADR per confirmed cut |
+| Execute | Week 5 (day 5) | Remove files + settings + write MIGRATION-v1.4.md |
+| Ship | Week 6 | v1.4.0 release |
+
+## Evaluation Steps
+
+### 1. Collect (end of week 4)
+
+Each dev runs:
+```bash
+cp .dw/metrics/events.jsonl ~/dw-metrics-<dev-name>.jsonl
+```
+
+TechLead merges into a single evaluation workspace:
+```bash
+mkdir -p ~/dw-v14-eval/.dw/metrics
+cat ~/dw-metrics-*.jsonl > ~/dw-v14-eval/.dw/metrics/events.jsonl
+```
+
+### 2. Analyze
+
+```bash
+cd ~/dw-v14-eval
+dw metrics cut-analysis --since 2026-05-12
+```
+
+Output flags skills/hooks qualifying per [ADR-0001 Cut Criteria](../decisions/0001-v2-pragmatic-lean.md):
+
+- **Skill**: `uses/week/dev < 5` AND `devs ≥ 5` AND `coverage_days ≥ 21`
+- **Hook**: `avg_latency > 500ms` OR `fires/session > 10`
+
+**Caveat**: session-hash proxy undercounts real headcount. If flagged count is borderline → lean keep.
+
+### 3. Survey (qualitative gate)
+
+For each flagged item, ask the team:
+
+1. Did you use `/dw:{name}` in the last 4 weeks?
+2. If removed, would you miss it? (1=no / 5=yes)
+3. Any use case that telemetry wouldn't capture?
+
+**Cut only if**: telemetry flags AND <30% of devs answer ≥4 on question 2.
+
+### 4. Decide (per cut)
+
+For each confirmed cut:
+
+```bash
+/dw:decision "Remove {hook-or-skill-name}"
+```
+
+ADR must include:
+- Evidence: uses/week/dev, fires/session, latency (paste from `cut-analysis`)
+- Survey result
+- Rollback plan (git revert SHA + how to reinstate)
+- Supersedes line if any prior ADR protected this item
+
+### 5. Execute
+
+For each cut:
+- Delete `.claude/hooks/{name}.sh` or `.claude/skills/dw-{name}/`
+- Remove entry from `.claude/settings.json` hooks block
+- Remove from `package.json#files` if listed
+- Add row to `MIGRATION-v1.4.md` with "What changed / Why / Rollback"
+
+### 6. Ship
+
+- Version bump: `1.3.x → 1.4.0`
+- Split commits: one per cut + one for MIGRATION doc
+- `npm publish`
+- Announce to teams with link to MIGRATION-v1.4.md and relevant ADRs
+
+## Protected Items (never cut in v1.4)
+
+**Critical-path skills** (workflow load-bearing):
+`dw:flow`, `dw:task-init`, `dw:commit`, `dw:handoff`, `dw:execute`, `dw:plan`, `dw:research`, `dw:thinking`, `dw:review`, `dw:debug`, `dw:decision`
+
+**Per-project skills** (low cadence is expected):
+`dw:onboard`, `dw:retroactive`, `dw:config-init`, `dw:upgrade`, `dw:rollback`
+
+If any flagged by matrix → override is "keep" with a 1-line note in the analysis report.
+
+## Failure Modes
+
+| Failure | Mitigation |
+|---------|------------|
+| <21 days coverage | Postpone v1.4, extend collection window |
+| <5 unique sessions | Insufficient data; wait or onboard more devs to v1.3 |
+| Data merge error | Each jsonl is self-contained; re-merge from backups |
+| Team disagrees with data | Qualitative survey overrides; document in ADR |
+| Post-cut regret | Execute rollback plan from ADR; issue v1.4.1 patch |
+
+## Success Signals
+
+- ≥2 ADRs written (shows data-driven cuts happened, not just "feels right")
+- Auto-loaded rules bytes ↓ ≥30% from v1.3 baseline ([baseline.md](../tasks/dw-kit-v2-lean-optimization/baseline.md))
+- Team NPS for dw-kit ≥ v1.3 level (cuts didn't hurt workflow)
+- Zero rollback in first 2 weeks post-v1.4

package/CLAUDE.md

@@ -1,39 +1,42 @@
-# dw-kit (repo)
-
-Workflow toolkit codebase. dw rules live in `.claude/rules/` — auto-loaded by Claude Code.
-
-Config: `.dw/config/dw.config.yml`
-
----
-
-## Tech Stack
-
-- Runtime: Node.js ≥18, ESM (`.mjs`)
-- CLI: `commander` · UI: `enquirer`, `chalk` · Config: `js-yaml`, `ajv`
-- Tests: `node src/smoke-test.mjs`
-
-## Repo Structure
-
-```
-bin/          CLI entrypoint
-src/
-  commands/   CLI subcommands (init, upgrade, validate, ...)
-  lib/        Shared utilities (config, copy, ui, ...)
-.claude/
-  hooks/      Bash hooks — python3-free, node only (Windows compat)
-  rules/      dw-core.md + dw-skills.md (auto-loaded by Claude Code)
-  skills/     Slash command definitions
-  templates/  Agent report template
-.dw/
-  core/       WORKFLOW.md, THINKING.md, QUALITY.md, ROLES.md
-  config/     dw.config.yml for this repo
-  tasks/      Active task docs
-```
-
-## Dev Notes
-
-- All source ESM (`import`/`export`) — no CommonJS
-- `TOOLKIT_ROOT` resolved from `import.meta.url` in each command
-- Hooks use `node` for JSON parsing (not python3 — Windows compat)
-- Skills `dw-kit-evolve` and `dw-kit-audit` are maintainer-only — excluded from npm package
-- Published package files declared explicitly in `package.json#files`
+# dw-kit (repo)
+
+Workflow toolkit codebase. Rules live in `.claude/rules/` (auto-loaded).
+
+**v2.0 direction:** Context-First SDLC Governance Layer (5 pillars — see `.dw/core/PILLARS.md`)
+**Current:** v1.4.0-dev · v1.3.0 ready to ship · ADR-0001 active
+
+---
+
+## Tech Stack
+
+- Runtime: Node.js ≥18, ESM (`.mjs`)
+- CLI: `commander` · UI: `enquirer`, `chalk` · Config: `js-yaml`, `ajv`
+- Tests: `node src/smoke-test.mjs`
+
+## Repo Structure
+
+```
+bin/          CLI entrypoint
+src/
+  commands/   CLI subcommands (init, upgrade, dashboard, metrics, ...)
+  lib/        Shared utilities (config, telemetry, active-index, ...)
+.claude/
+  hooks/      Bash hooks (Guards pillar)
+  rules/      dw.md (consolidated) + code-style + commit-standards
+  skills/     Slash commands with dw:* namespace
+.dw/
+  core/       WORKFLOW · THINKING · QUALITY · ROLES · PILLARS · templates/
+  decisions/  ADRs (Records pillar)
+  tasks/      Active + archive/ (Bridges pillar — via tracking.md)
+  metrics/    Local telemetry (events.jsonl)
+  config/     dw.config.yml
+```
+
+## Dev Notes
+
+- All source ESM — no CommonJS
+- `TOOLKIT_ROOT` resolved from `import.meta.url` in each command
+- Hooks python3-free (node only — Windows compat)
+- `dw-kit-evolve` + `dw-kit-audit` are maintainer-only — excluded from npm package
+- Published package files declared explicitly in `package.json#files`
+- Telemetry local-only, `DW_NO_TELEMETRY=1` to disable

package/MIGRATION-v1.3.md

@@ -0,0 +1,201 @@
+# Migration Guide — dw-kit v1.2.x → v1.3
+
+**Target version:** 1.3.0
+**Ship date:** 2026-05-12 (target)
+**Status:** In Progress
+
+This guide documents all user-visible changes in v1.3. v1.3 is **fully backward compatible** with v1.2.x — existing projects continue to work. New features are opt-in.
+
+---
+
+## At a Glance
+
+| Area | Change | Impact |
+|------|--------|--------|
+| Task docs | New 2-file format (`spec.md` + `tracking.md`) available; 3-file legacy still works | Opt-in |
+| Decisions layer | New `.dw/decisions/` directory for ADRs | New feature |
+| ACTIVE index | `.dw/tasks/ACTIVE.md` auto-generated | New feature |
+| Telemetry | Local-only metrics in `.dw/metrics/events.jsonl` | Opt-out via `DW_NO_TELEMETRY=1` |
+| Solo preset | `dw init --preset solo` available | New option |
+| Skill naming | `/dw-*` may be renamed to `/dw:*` (pending harness verification) | **Potentially breaking** |
+| Archive | 8 Done tasks moved to `.dw/tasks/archive/` in dw-kit repo itself | No user impact |
+
+---
+
+## New Features (Opt-In)
+
+### 1. Task Docs v2 Format
+
+**Before (v1.x):** 3 files per task
+```
+.dw/tasks/{name}/
+├── {name}-context.md
+├── {name}-plan.md
+└── {name}-progress.md
+```
+
+**Now (v1.3):** Simpler 2-file default
+```
+.dw/tasks/{name}/
+├── spec.md       # Intent + plan merged
+└── tracking.md   # Progress + handoff
+```
+
+Templates at `.dw/core/templates/v2/spec.md` and `.dw/core/templates/v2/tracking.md`.
+
+**Migration:** Existing 3-file tasks continue to work. For new tasks, copy from new templates.
+
+### 2. Decisions Layer (ADRs)
+
+New `.dw/decisions/` directory for Architecture Decision Records.
+
+- Template: `.dw/decisions/_template.md`
+- Format: YAML frontmatter + TL;DR + Context + Options + Decision + Consequences
+- Example: `.dw/decisions/0001-v2-pragmatic-lean.md` (dw-kit's own v2 direction)
+
+**Why:** Capture *why* decisions were made, not just *what*. Complements code and git history.
+
+### 3. ACTIVE.md Auto-Index
+
+`.dw/tasks/ACTIVE.md` auto-generated with 1 line per active task. Format:
+```
+- `{task-name}` · {status} · {last-updated} · {blockers}
+```
+
+Excludes `.dw/tasks/archive/`. TechLead can `cat .dw/tasks/ACTIVE.md` to see team state at a glance.
+
+**New CLI:** `dw active` to regenerate.
+
+### 4. Local Telemetry
+
+**Privacy-first design:**
+- **Local-only by default.** Zero network calls.
+- Schema: append-only JSONL at `.dw/metrics/events.jsonl`
+- Events logged: skill invocations, hook fires, task lifecycle
+- Inspect: `dw metrics show`
+- Opt-out: `DW_NO_TELEMETRY=1` environment variable
+
+**What's collected:** timestamps, event type, skill/hook name, session hash, depth, latency. **Not collected:** file contents, prompts, personal data.
+
+**Internal team policy (for 2 internal teams only):** Mandatory for v1.4 cut decisions. Can still set `DW_NO_TELEMETRY=1` on specific machine.
+
+### 5. Solo Preset
+
+**New:** `dw init --preset solo` — optimized for solo developers / vibe coders.
+
+**Enabled by default:** `privacy-block`, `pre-commit-gate` hooks only (safety-critical).
+**Disabled:** Task docs, session-init, scout-block, post-write, progress-ping, telemetry.
+
+Target: working setup in <30 seconds, zero friction.
+
+---
+
+## Potentially Breaking (Pending Verification)
+
+### Skill Naming: `/dw-{name}` → `/dw:{name}`
+
+**Status:** Pending Claude Code harness verification.
+
+**Rationale:** Colon creates clear namespace separator, matches industry conventions (`git:log`, `npm:run`).
+
+**Change:** SKILL.md frontmatter `name:` field. Directory names unchanged (`:` illegal on Windows filesystems).
+
+**Before:** `name: dw-thinking` → invoke `/dw-thinking`
+**After:** `name: dw:thinking` → invoke `/dw:thinking`
+
+**Mapping table (if applied):**
+
+| v1.x | v1.3+ |
+|------|-------|
+| `/dw-flow` | `/dw:flow` |
+| `/dw-task-init` | `/dw:task-init` |
+| `/dw-research` | `/dw:research` |
+| `/dw-plan` | `/dw:plan` |
+| `/dw-execute` | `/dw:execute` |
+| `/dw-commit` | `/dw:commit` |
+| `/dw-handoff` | `/dw:handoff` |
+| `/dw-debug` | `/dw:debug` |
+| `/dw-review` | `/dw:review` |
+| `/dw-thinking` | `/dw:thinking` |
+| `/dw-prompt` | `/dw:prompt` |
+| `/dw-docs-update` | `/dw:docs-update` |
+| `/dw-requirements` | `/dw:requirements` |
+| `/dw-test-plan` | `/dw:test-plan` |
+| `/dw-arch-review` | `/dw:arch-review` |
+| `/dw-dashboard` | `/dw:dashboard` |
+| `/dw-sprint-review` | `/dw:sprint-review` |
+| `/dw-estimate` | `/dw:estimate` |
+| `/dw-log-work` | `/dw:log-work` |
+| `/dw-onboard` | `/dw:onboard` |
+| `/dw-retroactive` | `/dw:retroactive` |
+| `/dw-config-init` | `/dw:config-init` |
+| `/dw-config-validate` | `/dw:config-validate` |
+| `/dw-upgrade` | `/dw:upgrade` |
+| `/dw-rollback` | `/dw:rollback` |
+| `/dw-archive` | `/dw:archive` |
+| `/dw-kit-report` | `/dw:kit-report` |
+| `/dw-kit-evolve` | `/dw:kit-evolve` |
+| `/dw-kit-audit` | `/dw:kit-audit` |
+
+See `ADR-0002` for full rationale.
+
+---
+
+## Deprecations (No Removal in v1.3)
+
+These are marked for removal in v1.4+ based on telemetry evidence:
+
+| Feature | Replacement | Removal Target |
+|---------|-------------|----------------|
+| `scout-block.sh` hook | Permission allowlist in settings.json | v1.4 |
+| `post-write.sh` hook | None (low-value reminder) | v1.4 |
+| `progress-ping.sh` hook | `tracking.md` manual + Stop hook | v1.4 |
+| `session-init.sh` hook inject context | `.dw/tasks/ACTIVE.md` auto-loaded | v1.4 |
+| Split rules files (5 files) | Consolidated 1-2 files | v1.4 |
+| 3-file task docs mandatory | 2-file default (legacy still works) | v2.0 |
+| Prescriptive `/dw-research`, `/dw-plan`, `/dw-execute` | Context injector pattern | v2.0 |
+
+**Escape hatch:** Set `legacy_features: true` in `.dw/config/dw.config.yml` to keep v1.x behavior through v2.0.
+
+---
+
+## Upgrade Steps
+
+### Automated
+```bash
+npx dw-kit upgrade
+```
+
+This will:
+1. Merge new templates into `.dw/core/templates/v2/`
+2. Create `.dw/decisions/` if missing
+3. Generate initial `.dw/tasks/ACTIVE.md`
+4. Add telemetry module (local-only)
+5. NOT touch existing task docs or skills
+
+### Manual Checks After Upgrade
+
+- [ ] Verify `.dw/tasks/ACTIVE.md` generated correctly
+- [ ] Read new `ADR-0001` to understand v2.0 direction
+- [ ] Optional: set `DW_NO_TELEMETRY=1` if you want to opt out
+- [ ] Optional: try `dw init --preset solo` for new projects
+
+### Rollback
+```bash
+npm install -g dw-kit@1.2.1
+```
+Your existing `.dw/` data remains compatible with v1.2.1.
+
+---
+
+## Known Issues
+
+- Skill naming (`/dw:*`) pending Claude Code harness verification. If harness rejects `:` in skill `name:` field, rename will be reverted in v1.3.1.
+
+---
+
+## Feedback
+
+- Internal teams: Slack channel `#dw-kit`
+- Open source: https://github.com/dv-workflow/dv-workflow/issues
+- Use `/dw-kit-report` (or `/dw:kit-report` after rename) to file structured feedback.

package/README.md

@@ -2,7 +2,7 @@
 
 > An AI development workflow toolkit for teams using agentic IDEs (Claude Code, Cursor) — from idea to review-ready commits.
 
-**v1.2** · `npm install -g dw-kit` · [Docs](docs/README.md) · [Get started](docs/get-started.md) · [Cheatsheet](docs/cheatsheet.md) · [Changelog](CHANGELOG.md#v120--2026-04-09)
+**v1.3** · `npm install -g dw-kit` · [Docs](docs/README.md) · [Get started](docs/get-started.md) · [Cheatsheet](docs/cheatsheet.md) · [Migration v1.3](MIGRATION-v1.3.md) · [Changelog](CHANGELOG.md)
 
 ---
 
@@ -61,7 +61,7 @@ dw init
 Then in **Claude Code CLI**, run the full workflow:
 
 ```
-/dw-flow your-task-or-anythings
+/dw:flow your-task-or-anythings
 ```
 
 ---
@@ -69,18 +69,21 @@ Then in **Claude Code CLI**, run the full workflow:
 Discover other skills:
 
 ```
-/dw-prompt
-/dw-thinking
+/dw:prompt
+/dw:thinking
+/dw:decision
 ...
-
 ```
 
+> **v1.3 note**: Slash commands switched from `/dw-*` to `/dw:*` (namespace convention). See [MIGRATION-v1.3.md](MIGRATION-v1.3.md).
+
 ---
 
 ## CLI commands
 
 ```bash
 dw init                 # setup wizard / presets
+dw init --solo          # zero-config solo dev setup (v1.3)
 dw validate             # validate .dw/config/dw.config.yml
 dw doctor               # installation health check
 dw upgrade              # update toolkit files (override-aware)
@@ -88,6 +91,9 @@ dw upgrade --check      # check for updates only
 dw upgrade --dry-run    # preview changes
 dw prompt               # build a well-structured task prompt (autocomplete + wizard)
 dw prompt --text "..."  # non-interactive: structure a description directly
+dw active               # regenerate .dw/tasks/ACTIVE.md index (v1.3)
+dw metrics              # inspect local telemetry (v1.3, opt-out via DW_NO_TELEMETRY=1)
+dw dashboard            # active tasks + ADRs + telemetry summary (v1.3)
 dw claude-vn-fix        # patch Claude CLI to fix Vietnamese IME (backup/restore)
 ```
 
@@ -117,11 +123,34 @@ workflow:
 ## What gets added to your repo?
 
 ```
-.dw/        # methodology, config, adapters, task docs
+.dw/
+  core/       methodology + PILLARS.md
+  config/     dw.config.yml (+ optional .local.yml)
+  decisions/  ADRs (v1.3) — architectural decision records
+  tasks/      task docs + ACTIVE.md index (v1.3)
+  metrics/    local telemetry (v1.3, opt-out)
 .claude/    # Claude Code: skills, hooks, agents, rules
 CLAUDE.md   # project context for the agent
 ```
 
 ---
 
+## 5-pillar architecture (v1.3+)
+
+dw-kit is a **context-first governance layer** on top of your AI agent — not a prescriptive workflow engine. Five pillars, verb-based:
+
+| Pillar | Purpose | Examples |
+|--------|---------|----------|
+| **Guards** | Safety before action | `safety-guard`, `privacy-block`, `pre-commit-gate` |
+| **Surfaces** | Make state visible | `ACTIVE.md`, `dw dashboard`, `project-map.md` |
+| **Records** | Preserve memory | ADRs in `.dw/decisions/`, task docs |
+| **Bridges** | Continuity across sessions/roles | `session-init`, auto-handoff in `tracking.md` |
+| **Tunes** | Adapt to team shape | presets (`solo`, `team`, `enterprise`), config flags |
+
+Full spec: [`.dw/core/PILLARS.md`](.dw/core/PILLARS.md)
+
+**Design principle — obsolescence test**: Every feature must answer "will this be *more* valuable when AI is smarter?" If no → cut or defer.
+
+---
+
 Maintainer: [huygdv](mailto:huygdv19@gmail.com)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dw-kit",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "AI development workflow toolkit — structured, quality-assured, team-ready. From requirements to dashboard.",
   "type": "module",
   "bin": {
@@ -24,6 +24,7 @@
     ".claude/skills/dw-config-validate/",
     ".claude/skills/dw-dashboard/",
     ".claude/skills/dw-debug/",
+    ".claude/skills/dw-decision/",
     ".claude/skills/dw-docs-update/",
     ".claude/skills/dw-estimate/",
     ".claude/skills/dw-execute/",
@@ -46,7 +47,8 @@
     ".claude/skills/dw-upgrade/",
     ".claude/templates/",
     ".claude/settings.json",
-    "CLAUDE.md"
+    "CLAUDE.md",
+    "MIGRATION-v1.3.md"
   ],
   "engines": {
     "node": ">=18"

package/src/cli.mjs

@@ -28,7 +28,8 @@ export function run(argv) {
   program
     .command('init')
     .description('Setup dw-kit in current project (interactive wizard)')
-    .option('-p, --preset <name>', 'Use preset: solo-quick | small-team | enterprise')
+    .option('-p, --preset <name>', 'Use preset: solo | solo-quick | small-team | team | enterprise')
+    .option('--solo', 'Shortcut for --preset solo (zero-config setup)')
     .option('-a, --adapter <platform>', 'Target platform: claude-cli | cursor | generic', 'claude-cli')
     .option('-s, --silent', 'Non-interactive mode (reads DW_NAME, DW_DEPTH, DW_ROLES, DW_LANG env vars)')
     .action(async (opts) => {
@@ -73,6 +74,33 @@ export function run(argv) {
       await promptCommand(opts);
     });
 
+  program
+    .command('metrics [sub]')
+    .description('Inspect local telemetry (show | cut-analysis | clear). Default: show')
+    .option('--since <date>', 'Filter events since ISO date (YYYY-MM-DD)')
+    .option('--skill <name>', 'Filter by skill name')
+    .action(async (sub, opts) => {
+      const { metricsCommand } = await import('./commands/metrics.mjs');
+      await metricsCommand({ sub, ...opts });
+    });
+
+  program
+    .command('active')
+    .description('Regenerate .dw/tasks/ACTIVE.md index')
+    .action(async () => {
+      const { writeActiveIndex } = await import('./lib/active-index.mjs');
+      const target = writeActiveIndex();
+      console.log(chalk.green('✓') + ` Wrote ${target}`);
+    });
+
+  program
+    .command('dashboard')
+    .description('Show team dashboard — active tasks, ADRs, telemetry summary, health')
+    .action(async (opts) => {
+      const { dashboardCommand } = await import('./commands/dashboard.mjs');
+      await dashboardCommand(opts);
+    });
+
   program
     .command('claude-vn-fix')
     .description('Patch Claude CLI to fix Vietnamese IME (local, with backup/restore)')