aiwcli 0.12.3 → 0.12.7

package/dist/templates/CLAUDE.md

@@ -1,205 +1,205 @@
-# Template Development Guidelines
-
-## Output Directory
-
-Write all method outputs to `_output/{method}/`:
-
-```
-_output/
-├── gsd/.planning/    # GSD planning artifacts
-├── bmad/docs/        # BMAD documentation
-└── {method}/{subdir}/ # Other method outputs
-```
-
-Include `_output/{method}/` in template `.gitignore`.
-
----
-
-## Directory Structure
-
-Each template installs into `.aiwcli/` (method files) and `.{ide}/` (IDE integration). The `_shared/` template provides cross-method infrastructure used by all methods.
-
-```
-packages/cli/src/templates/
-├── _shared/                          # Cross-method infrastructure (installed by all methods)
-│   ├── hooks-ts/                     # Shared TypeScript hook scripts (context, tasks, sessions)
-│   └── lib-ts/                       # Shared TypeScript libraries
-│       ├── base/                     #   Core: atomic-write, constants, inference, utils
-│       ├── context/                  #   Context CRUD, selection, formatting, plans, tasks
-│       ├── handoff/                  #   Session handoff document generation
-│       └── templates/                #   Output formatters, plan context templates
-│
-├── cc-native/                        # CC-Native method template
-│   ├── _cc-native/                   #   Method-specific hooks, lib, agents, workflows, scripts
-│   ├── .claude/                      #   Claude Code: settings.json, commands/, agents/
-│   ├── .windsurf/                    #   Windsurf: workflows/
-│   └── .gitignore
-│
-├── gsd/                              # GSD method template
-│   ├── .aiwcli/_gsd/                 #   Templates, workflows, hooks, config, docs
-│   ├── .claude/                      #   Claude Code: settings.json, commands/, agents/
-│   ├── .windsurf/                    #   Windsurf: workflows/
-│   ├── GSD-README.md
-│   ├── TEMPLATE-SCHEMA.md
-│   └── MIGRATION.md
-│
-├── bmad/                             # BMAD method template
-│   ├── .aiwcli/_bmad/               #   Agents, workflows, teams, testarch, config
-│   ├── .claude/                      #   Claude Code: settings.json, commands/
-│   └── ...
-│
-├── planning-with-files/              # Planning-with-Files method template
-│   ├── .claude/                      #   Claude Code: settings.json, skills/
-│   ├── .windsurf/                    #   Windsurf: workflows/, scripts/
-│   └── ...
-│
-└── CLAUDE.md                         # This file
-```
-
-### Tier Details
-
-| Tier | Location | Purpose |
-|------|----------|---------|
-| Shared | `_shared/` | Cross-method hooks and libraries (context management, task tracking, sessions) |
-| Method | `_{method}/` or `.aiwcli/_{method}/` | Method-specific templates, workflows, hooks, config |
-| IDE | `.{ide}/` | IDE-specific command stubs, settings, workflow definitions |
-| Config | `.{ide}/settings.json` | Hooks, model prefs, method settings (merged on install) |
-
----
-
-## Settings Merge Rules
-
-When multiple templates install, settings.json files merge:
-
-**Hook merging** - Hooks combine by lifecycle event
-**Method namespacing** - Use method name as top-level key: `"gsd": { ... }`
-
-```json
-{
-  "gsd": { "planReview": { "enabled": true } },
-  "bmad": { "agents": { "defaultModel": "claude-3-opus" } }
-}
-```
-
----
-
-## Hooks
-
-**Location:** Hooks live in `.aiwcli/_shared/hooks-ts/` (cross-method, TypeScript) and `.aiwcli/_{method}/hooks/` (method-specific). They are configured in `.{ide}/settings.json`, not placed in IDE directories.
-
-**Configuration:**
-```json
-{
-  "hooks": {
-    "PostToolUse": [{
-      "matcher": "Write",
-      "hooks": [{ "type": "command", "command": "bun run .aiwcli/_cc-native/hooks/cc-native-plan-review.ts", "timeout": 300000 }]
-    }]
-  }
-}
-```
-
-**Requirements:**
-- Prefix method-specific hooks with method name (e.g., `cc-native-plan-review.ts`)
-- Use relative paths from project root
-- Write outputs to `_output/{method}/`
-- Specify timeouts
-- Set `blockOnFail: false` unless critical
-
----
-
-## Workflow Pattern
-
-### Canonical Workflow (`_{method}/workflows/`)
-
-```markdown
-# {Method} Workflow: {Name}
-
-## Purpose
-Brief description.
-
-## Process
-### Step 1: {Name}
-Instructions.
-
-## Output Files
-All in `_output/{method}/{subdir}/`:
-- `FILE.md` - Description
-
-## Success Criteria
-- [ ] Criterion 1
-```
-
-### IDE Stub (`.{ide}/{folder}/{method}/`)
-
-```markdown
----
-description: One-line for command palette
----
-# {Workflow Name}
-Load and execute `_{method}/workflows/{name}.md`.
-```
-
----
-
-## Reference Patterns
-
-| Reference Type | Pattern |
-|----------------|---------|
-| Templates | `_{method}/templates/FILE.md.template` |
-| Workflows (Claude) | `/gsd:workflow-name` (maps to `.claude/commands/gsd/workflow-name.md`) |
-| Workflows (Windsurf) | `workflow-name` from method workflows |
-| Outputs | `_output/{method}/{subdir}/FILE.md` |
-
----
-
-## Naming Conventions
-
-| Element | Convention | Example |
-|---------|------------|---------|
-| Method folder | `_{lowercase}` | `_gsd` |
-| Template file | `UPPERCASE.md.template` | `PROJECT.md.template` |
-| Workflow file | `kebab-case.md` | `new-project.md` |
-| Output file | `UPPERCASE.md` | `PROJECT.md` |
-| Hook file | `{method}-{name}.{ext}` | `gsd-plan-review.ts` |
-| Settings key | `{method}` | `"gsd": {}` |
-| Readme | `{METHOD}-README.md` | `GSD-README.md` |
-
----
-
-## Checklists
-
-**New Template:**
-- [ ] Create `_{method}/` with `templates/` and `workflows/`
-- [ ] Create `.claude/commands/{method}/` stubs (Claude Code)
-- [ ] Create `.windsurf/workflows/{method}/` stubs (Windsurf)
-- [ ] Add `.gitignore` with `_output/{method}/`
-- [ ] Create `{METHOD}-README.md`, `TEMPLATE-SCHEMA.md`, `MIGRATION.md`
-- [ ] Configure method-namespaced settings in `.claude/settings.json`
-
-**New Workflow:**
-- [ ] Create canonical in `_{method}/workflows/{name}.md`
-- [ ] Create stubs in `.claude/commands/{method}/` and `.windsurf/workflows/{method}/`
-- [ ] Update README and TEMPLATE-SCHEMA.md
-
----
-
-## Practices
-
-**Do:**
-- Write outputs to `_output/{method}/`
-- Namespace settings under method key
-- Prefix hooks with method name
-- Keep canonical workflows in `_{method}/workflows/`
-- Use relative paths from project root
-- Document changes in TEMPLATE-SCHEMA.md
-- Place hooks in `.aiwcli/` directories, wire them in `.{ide}/settings.json`
-
-**Avoid:**
-- Outputs in project root
-- Generic settings keys that conflict
-- Hooks without method prefix
-- Full workflows in IDE command files
-- Hardcoded paths without method namespace
-- Putting hook scripts directly in IDE directories (`.claude/hooks/`)
-- Creating `_shared/` directories inside method templates (e.g., `cc-native/_shared/`). All shared code lives in `packages/cli/src/templates/_shared/`. Method templates reference shared code via imports at runtime, not by copying.
+# Template Development Guidelines
+
+## Output Directory
+
+Write all method outputs to `_output/{method}/`:
+
+```
+_output/
+├── gsd/.planning/    # GSD planning artifacts
+├── bmad/docs/        # BMAD documentation
+└── {method}/{subdir}/ # Other method outputs
+```
+
+Include `_output/{method}/` in template `.gitignore`.
+
+---
+
+## Directory Structure
+
+Each template installs into `.aiwcli/` (method files) and `.{ide}/` (IDE integration). The `_shared/` template provides cross-method infrastructure used by all methods.
+
+```
+packages/cli/src/templates/
+├── _shared/                          # Cross-method infrastructure (installed by all methods)
+│   ├── hooks-ts/                     # Shared TypeScript hook scripts (context, tasks, sessions)
+│   └── lib-ts/                       # Shared TypeScript libraries
+│       ├── base/                     #   Core: atomic-write, constants, inference, utils
+│       ├── context/                  #   Context CRUD, selection, formatting, plans, tasks
+│       ├── handoff/                  #   Session handoff document generation
+│       └── templates/                #   Output formatters, plan context templates
+│
+├── cc-native/                        # CC-Native method template
+│   ├── _cc-native/                   #   Method-specific hooks, lib, agents, workflows, scripts
+│   ├── .claude/                      #   Claude Code: settings.json, commands/, agents/
+│   ├── .windsurf/                    #   Windsurf: workflows/
+│   └── .gitignore
+│
+├── gsd/                              # GSD method template
+│   ├── .aiwcli/_gsd/                 #   Templates, workflows, hooks, config, docs
+│   ├── .claude/                      #   Claude Code: settings.json, commands/, agents/
+│   ├── .windsurf/                    #   Windsurf: workflows/
+│   ├── GSD-README.md
+│   ├── TEMPLATE-SCHEMA.md
+│   └── MIGRATION.md
+│
+├── bmad/                             # BMAD method template
+│   ├── .aiwcli/_bmad/               #   Agents, workflows, teams, testarch, config
+│   ├── .claude/                      #   Claude Code: settings.json, commands/
+│   └── ...
+│
+├── planning-with-files/              # Planning-with-Files method template
+│   ├── .claude/                      #   Claude Code: settings.json, skills/
+│   ├── .windsurf/                    #   Windsurf: workflows/, scripts/
+│   └── ...
+│
+└── CLAUDE.md                         # This file
+```
+
+### Tier Details
+
+| Tier | Location | Purpose |
+|------|----------|---------|
+| Shared | `_shared/` | Cross-method hooks and libraries (context management, task tracking, sessions) |
+| Method | `_{method}/` or `.aiwcli/_{method}/` | Method-specific templates, workflows, hooks, config |
+| IDE | `.{ide}/` | IDE-specific command stubs, settings, workflow definitions |
+| Config | `.{ide}/settings.json` | Hooks, model prefs, method settings (merged on install) |
+
+---
+
+## Settings Merge Rules
+
+When multiple templates install, settings.json files merge:
+
+**Hook merging** - Hooks combine by lifecycle event
+**Method namespacing** - Use method name as top-level key: `"gsd": { ... }`
+
+```json
+{
+  "gsd": { "planReview": { "enabled": true } },
+  "bmad": { "agents": { "defaultModel": "claude-3-opus" } }
+}
+```
+
+---
+
+## Hooks
+
+**Location:** Hooks live in `.aiwcli/_shared/hooks-ts/` (cross-method, TypeScript) and `.aiwcli/_{method}/hooks/` (method-specific). They are configured in `.{ide}/settings.json`, not placed in IDE directories.
+
+**Configuration:**
+```json
+{
+  "hooks": {
+    "PostToolUse": [{
+      "matcher": "Write",
+      "hooks": [{ "type": "command", "command": "bun run .aiwcli/_cc-native/hooks/cc-native-plan-review.ts", "timeout": 300000 }]
+    }]
+  }
+}
+```
+
+**Requirements:**
+- Prefix method-specific hooks with method name (e.g., `cc-native-plan-review.ts`)
+- Use relative paths from project root
+- Write outputs to `_output/{method}/`
+- Specify timeouts
+- Set `blockOnFail: false` unless critical
+
+---
+
+## Workflow Pattern
+
+### Canonical Workflow (`_{method}/workflows/`)
+
+```markdown
+# {Method} Workflow: {Name}
+
+## Purpose
+Brief description.
+
+## Process
+### Step 1: {Name}
+Instructions.
+
+## Output Files
+All in `_output/{method}/{subdir}/`:
+- `FILE.md` - Description
+
+## Success Criteria
+- [ ] Criterion 1
+```
+
+### IDE Stub (`.{ide}/{folder}/{method}/`)
+
+```markdown
+---
+description: One-line for command palette
+---
+# {Workflow Name}
+Load and execute `_{method}/workflows/{name}.md`.
+```
+
+---
+
+## Reference Patterns
+
+| Reference Type | Pattern |
+|----------------|---------|
+| Templates | `_{method}/templates/FILE.md.template` |
+| Workflows (Claude) | `/gsd:workflow-name` (maps to `.claude/commands/gsd/workflow-name.md`) |
+| Workflows (Windsurf) | `workflow-name` from method workflows |
+| Outputs | `_output/{method}/{subdir}/FILE.md` |
+
+---
+
+## Naming Conventions
+
+| Element | Convention | Example |
+|---------|------------|---------|
+| Method folder | `_{lowercase}` | `_gsd` |
+| Template file | `UPPERCASE.md.template` | `PROJECT.md.template` |
+| Workflow file | `kebab-case.md` | `new-project.md` |
+| Output file | `UPPERCASE.md` | `PROJECT.md` |
+| Hook file | `{method}-{name}.{ext}` | `gsd-plan-review.ts` |
+| Settings key | `{method}` | `"gsd": {}` |
+| Readme | `{METHOD}-README.md` | `GSD-README.md` |
+
+---
+
+## Checklists
+
+**New Template:**
+- [ ] Create `_{method}/` with `templates/` and `workflows/`
+- [ ] Create `.claude/commands/{method}/` stubs (Claude Code)
+- [ ] Create `.windsurf/workflows/{method}/` stubs (Windsurf)
+- [ ] Add `.gitignore` with `_output/{method}/`
+- [ ] Create `{METHOD}-README.md`, `TEMPLATE-SCHEMA.md`, `MIGRATION.md`
+- [ ] Configure method-namespaced settings in `.claude/settings.json`
+
+**New Workflow:**
+- [ ] Create canonical in `_{method}/workflows/{name}.md`
+- [ ] Create stubs in `.claude/commands/{method}/` and `.windsurf/workflows/{method}/`
+- [ ] Update README and TEMPLATE-SCHEMA.md
+
+---
+
+## Practices
+
+**Do:**
+- Write outputs to `_output/{method}/`
+- Namespace settings under method key
+- Prefix hooks with method name
+- Keep canonical workflows in `_{method}/workflows/`
+- Use relative paths from project root
+- Document changes in TEMPLATE-SCHEMA.md
+- Place hooks in `.aiwcli/` directories, wire them in `.{ide}/settings.json`
+
+**Avoid:**
+- Outputs in project root
+- Generic settings keys that conflict
+- Hooks without method prefix
+- Full workflows in IDE command files
+- Hardcoded paths without method namespace
+- Putting hook scripts directly in IDE directories (`.claude/hooks/`)
+- Creating `_shared/` directories inside method templates (e.g., `cc-native/_shared/`). All shared code lives in `packages/cli/src/templates/_shared/`. Method templates reference shared code via imports at runtime, not by copying.

package/dist/templates/_shared/.claude/commands/handoff-resume.md

@@ -1,64 +1,12 @@
-# Resume Handoff
-
-Restore session context from a handoff document programmatically, then create actionable ISC tasks so work continues without re-discovering what was already learned.
-
-## Arguments
-
-- `$ARGUMENTS` - Optional path to a handoff folder or index.md. If omitted, auto-discovers the most recent handoff from the active context.
-
-## Instructions
-
-### Step 1: Gather Context via Script
-
-Run the resume script to collect and format all handoff sections:
-
-**If `$ARGUMENTS` is provided:**
-```bash
-bun .aiwcli/_shared/scripts/resume_handoff.ts "$ARGUMENTS"
-```
-
-**If `$ARGUMENTS` is empty:**
-The script auto-discovers the active context ID programmatically — no manual lookup needed:
-```bash
-bun .aiwcli/_shared/scripts/resume_handoff.ts
-```
-
-Present the script's output to the conversation. The output is already structured in priority order (dead ends first, then pending items, decisions, git delta, completed work, context notes).
-
-If the script exits with an error, show the error message and stop.
-
-### Step 2: Create ISC Tasks
-
-Convert each actionable item from the script output into a task via `TaskCreate`:
-- Each pending issue from the **Pending Items** section
-- Each remaining plan item from the **Plan — Remaining Items** section
-
-Each task follows ISC format — ~8 words, states a desired end-state (not an action), and is binary testable in 2 seconds.
-
-**Example:**
-
-| Source | ISC Task |
-|--------|----------|
-| Pending: "Fix race condition in SessionStore" | "SessionStore handles concurrent access without race conditions" |
-| Plan remaining: "Add retry logic to API client" | "API client retries failed requests with exponential backoff" |
-| Next step: "Write tests for auth flow" | "Auth flow has passing integration test coverage" |
-
-### Step 3: Confirm Ready
-
-After creating tasks, run `TaskList` and confirm ready to continue.
-
-## Constraints
-
-- Dead ends are presented verbatim from the script output — never summarize or omit entries
-- ISC tasks use ~8-word end-state format, not action descriptions
-- Skip missing files gracefully (the script handles this)
-- If the script warns about staleness (>7 days), surface the warning prominently
-
-## Success Criteria
-
-- [ ] Script ran successfully and output the structured briefing
-- [ ] Dead ends visible in conversation (not summarized)
-- [ ] Pending items converted to ISC tasks via TaskCreate
-- [ ] Plan completion percentage visible (if plan exists)
-- [ ] Git delta visible
-- [ ] Tasks confirmed via TaskList
+---
+name: handoff-resume
+description: Resume handoff
+---
+
+# Resume Handoff
+
+Restore context from a handoff document and create ISC tasks. See `.aiwcli/_shared/handoff-system/workflows/handoff-resume.md` for complete process documentation.
+
+**Quick trigger:** `/handoff-resume` or `/handoff-resume path/to/handoff`
+
+The workflow uses the resume script to load handoff sections and convert pending items to tasks.