openplanr 0.9.0 → 1.0.0

package/README.md

@@ -4,9 +4,9 @@
 [![license](https://img.shields.io/npm/l/openplanr.svg)](https://github.com/TechArc-io/OpenPlanr/blob/main/LICENSE)
 [![node](https://img.shields.io/node/v/openplanr.svg)](https://nodejs.org)
 
-**Agile planning CLI for AI-assisted development.** Generate epics, features, user stories, tasks, and AI agent rules — all from your terminal.
+**AI-powered planning CLI for developers.** Capture ideas, plan sprints, generate tasks, estimate effort, and sync with GitHub — all from your terminal.
 
-Planr brings structured agile planning to AI coding workflows. Create planning artifacts with a simple CLI, then generate rule files that teach Cursor, Claude Code, or Codex how to follow your plan.
+Planr replaces heavyweight project management tools with a fast, file-based workflow. Artifacts live in your repo as markdown, version-controlled alongside your code. AI generates structured plans and teaches your coding agent (Cursor, Claude Code, Codex) how to follow them.
 
 ---
 
@@ -14,9 +14,14 @@ Planr brings structured agile planning to AI coding workflows. Create planning a
 
 AI coding assistants are powerful but lack structured planning. Without a clear plan, they generate code that drifts from requirements. Planr solves this by:
 
-1. **Structuring your planning** — epics, features, stories, and tasks in markdown
-2. **Generating AI rules** — rule files that give your AI assistant context about the plan
-3. **Keeping everything in your repo** — artifacts live alongside your code, version-controlled
+1. **Capturing ideas instantly** — `planr backlog add` captures work items without breaking your flow
+2. **Structuring your planning** — epics, features, stories, and tasks in markdown
+3. **Sprint planning** — time-boxed iterations with velocity tracking and AI task selection
+4. **Reusable patterns** — task templates for common workflows (REST endpoints, React components, etc.)
+5. **AI-powered estimation** — story points, effort hours, and complexity analysis
+6. **Generating AI rules** — rule files that give your AI assistant context about the plan
+7. **GitHub integration** — push artifacts to issues, bi-directional sync, export reports
+8. **Keeping everything in your repo** — artifacts live alongside your code, version-controlled
 
 ## Quick Start
 
@@ -28,14 +33,21 @@ npm install -g openplanr
 cd my-project
 planr init
 
-# Create your first epic
-planr epic create
+# Capture an idea
+planr backlog add "add user profiles" --priority high --tag feature
 
-# Break it down
+# Or jump straight into planning
+planr epic create
 planr feature create --epic EPIC-001
 planr story create --feature FEAT-001
-planr task create --story US-001
-# or: planr task create --feature FEAT-001  # one task list from every story + full planning context (AI)
+planr task create --feature FEAT-001
+
+# Generate tasks from a template
+planr template use rest-endpoint --title "User Profile API"
+
+# Start a sprint
+planr sprint create --name "Sprint 1" --duration 2w
+planr sprint add TASK-001 QT-001
 
 # Generate AI rules for your editor
 planr rules generate
@@ -43,20 +55,27 @@ planr rules generate
 
 ## How It Works
 
-```
+```text
+Backlog → Agile Hierarchy → Sprint → Implementation
+
+planr backlog add "..."              # Capture ideas as they come
+planr backlog prioritize             # AI sorts by impact/effort
+planr backlog promote BL-001 --quick # Move to task when ready
+
 planr init
-  └── planr epic create                    # Define the big picture
-       └── planr feature create --epic EPIC-001    # Break into features
-            └── planr story create --feature FEAT-001  # User stories + Gherkin
-                 ├── planr task create --story US-001       # Tasks from one story (+ parent feature/epic, Gherkin, ADRs, codebase context)
-                 └── planr task create --feature FEAT-001  # Tasks from all stories in the feature (+ same context, wider scope; larger AI budget)
+  └── planr epic create                         # Define the big picture
+       └── planr feature create --epic EPIC-001
+            └── planr story create --feature FEAT-001
+                 └── planr task create --feature FEAT-001
 
-planr rules generate   # Generate .cursor/rules, CLAUDE.md, AGENTS.md
-```
+planr sprint create --name "Sprint 1" --duration 2w
+planr sprint add TASK-001 QT-001     # Assign tasks (or --auto for AI)
+planr sprint status                  # Track progress
 
-Each command creates markdown artifacts in `docs/agile/` and interactively prompts for the details. The hierarchy is enforced — features require an epic, stories require a feature, tasks require a story or feature. For AI-powered `task create`, context always includes parent feature and epic, Gherkin where present, all ADRs, and codebase-derived context; `--feature` aggregates every story under that feature and uses a higher output token limit than `--story`.
+planr rules generate                 # Generate .cursor/rules, CLAUDE.md, AGENTS.md
+```
 
-Or use `planr plan` to run the full flow in a single command:
+Or use `planr plan` to run the full agile flow in a single command:
 
 ```bash
 planr plan                          # start from scratch
@@ -65,11 +84,11 @@ planr plan --epic EPIC-001          # cascade from an existing epic
 
 ## Supported AI Targets
 
-| Target | Generated File(s) | Used By |
-|--------|--------------------|---------|
-| Cursor | `.cursor/rules/*.mdc` | Cursor IDE |
-| Claude | `CLAUDE.md` | Claude Code CLI |
-| Codex | `AGENTS.md` | OpenAI Codex CLI |
+| Target | Generated File(s)     | Used By          |
+| ------ | --------------------- | ---------------- |
+| Cursor | `.cursor/rules/*.mdc` | Cursor IDE       |
+| Claude | `CLAUDE.md`           | Claude Code CLI  |
+| Codex  | `AGENTS.md`           | OpenAI Codex CLI |
 
 ```bash
 planr rules generate                  # all targets
@@ -79,37 +98,81 @@ planr rules generate --dry-run        # preview
 
 ## Commands
 
-| Command | Description |
-|---------|-------------|
-| `planr init` | Initialize project with config and directory structure |
-| `planr epic create` | Create a new epic (supports `--file <path>` for PRDs) |
-| `planr epic list` | List all epics |
-| `planr feature create --epic <ID>` | Create features from an epic |
-| `planr feature list` | List all features |
-| `planr story create --feature <ID>` | Create user stories from a feature |
-| `planr story create --epic <ID>` | Batch-generate stories for all features under an epic |
-| `planr story list` | List all user stories |
-| `planr task create --story <ID>` | AI task list from one story (plus parent feature/epic, Gherkin, ADRs, codebase context) |
-| `planr task create --feature <ID>` | AI task list from **all** stories under the feature, with the same artifact context and a larger model output budget |
-| `planr task list` | List all task lists |
-| `planr task implement <ID>` | View tasks and start implementing |
-| `planr plan` | Full automated flow: Epic → Features → Stories → Tasks |
-| `planr refine <ID>` | AI-powered review and apply improvements |
-| `planr sync` | Validate and fix cross-references across artifacts |
-| `planr checklist show` | View the agile development checklist |
-| `planr checklist toggle` | Interactively toggle checklist items |
-| `planr checklist reset` | Reset checklist to initial state |
-| `planr rules generate` | Generate AI agent rule files |
-| `planr status` | Show planning progress with tree view and metrics |
-| `planr config show` | Display current configuration |
-| `planr config set-provider` | Set AI provider (anthropic, openai, ollama) |
-| `planr config set-key` | Store API key securely |
-| `planr config set-model` | Set AI model |
-| `planr config set-agent` | Set default coding agent |
-| `planr github push [ID]` | Push artifacts to GitHub Issues (single, `--epic`, or `--all`) |
-| `planr github sync` | Bi-directional status sync with GitHub Issues |
-| `planr github status` | Show sync status of linked artifacts |
-| `planr export` | Export planning report (markdown, JSON, or HTML) |
+### Backlog & Sprint
+
+| Command                                               | Description                                 |
+| ----------------------------------------------------- | ------------------------------------------- |
+| `planr backlog add "desc" --priority high --tag bug`  | Capture a backlog item                      |
+| `planr backlog list --tag bug --priority high`        | List/filter backlog items                   |
+| `planr backlog prioritize`                            | AI sorts open items by impact and effort    |
+| `planr backlog promote BL-001 --quick`                | Promote to quick task or story              |
+| `planr backlog close BL-001`                          | Close/archive an item                       |
+| `planr sprint create --name "Sprint 1" --duration 2w` | Create a time-boxed sprint                  |
+| `planr sprint add TASK-001 QT-001`                    | Assign tasks to active sprint               |
+| `planr sprint add --auto`                             | AI selects tasks by priority and velocity   |
+| `planr sprint status`                                 | Progress dashboard with completion %        |
+| `planr sprint close`                                  | Archive sprint, carry over incomplete tasks |
+| `planr sprint list`                                   | List all sprints                            |
+| `planr sprint history`                                | Velocity chart across past sprints          |
+
+### Agile Hierarchy
+
+| Command                             | Description                                           |
+| ----------------------------------- | ----------------------------------------------------- |
+| `planr epic create`                 | Create a new epic (supports `--file <path>` for PRDs) |
+| `planr epic list`                   | List all epics                                        |
+| `planr feature create --epic <ID>`  | Create features from an epic                          |
+| `planr feature list`                | List all features                                     |
+| `planr story create --feature <ID>` | Create user stories from a feature                    |
+| `planr story create --epic <ID>`    | Batch-generate stories for all features under an epic |
+| `planr story list`                  | List all user stories                                 |
+| `planr task create --story <ID>`    | AI task list from one story                           |
+| `planr task create --feature <ID>`  | AI task list from all stories under a feature         |
+| `planr task list`                   | List all task lists                                   |
+### Quick Tasks & Templates
+
+| Command                                               | Description                        |
+| ----------------------------------------------------- | ---------------------------------- |
+| `planr quick create "description"`                    | AI-generated standalone task list  |
+| `planr quick create --file spec.md`                   | Task list from a PRD or spec file  |
+| `planr quick promote <ID> --story US-001`             | Move into agile hierarchy          |
+| `planr template list`                                 | List built-in and custom templates |
+| `planr template use rest-endpoint --title "User API"` | Generate tasks from a template     |
+| `planr template save TASK-001 --name my-pattern`      | Save existing tasks as template    |
+| `planr template show rest-endpoint`                   | Preview template contents          |
+
+### Planning Tools
+
+| Command                | Description                                               |
+| ---------------------- | --------------------------------------------------------- |
+| `planr plan`           | Full automated flow: Epic -> Features -> Stories -> Tasks |
+| `planr estimate <ID>`  | AI effort estimation (story points, hours, complexity)    |
+| `planr refine <ID>`    | AI-powered review and improvements                        |
+| `planr search <query>` | Full-text search across all artifacts                     |
+| `planr sync`           | Validate and fix cross-references                         |
+| `planr status`         | Planning progress with tree view and metrics              |
+
+### GitHub & Export
+
+| Command                      | Description                                      |
+| ---------------------------- | ------------------------------------------------ |
+| `planr github push [ID]`     | Push artifacts to GitHub Issues                  |
+| `planr github sync`          | Bi-directional status sync with GitHub           |
+| `planr github status`        | Show sync status of linked artifacts             |
+| `planr export --format html` | Export planning report (markdown, JSON, or HTML) |
+
+### Setup & config commands
+
+| Command                             | Description                                            |
+| ----------------------------------- | ------------------------------------------------------ |
+| `planr init`                        | Initialize project with config and directory structure |
+| `planr config show`                 | Display current configuration                          |
+| `planr config set-provider`         | Set AI provider (anthropic, openai, ollama)            |
+| `planr config set-key`              | Store API key securely                                 |
+| `planr config set-model`            | Set AI model                                           |
+| `planr config set-agent`            | Set default coding agent                               |
+| `planr rules generate`              | Generate AI agent rule files                           |
+| `planr checklist show/toggle/reset` | Agile development checklist                            |
 
 See [docs/CLI.md](docs/CLI.md) for the full command reference with all options and flags.
 
@@ -117,7 +180,7 @@ See [docs/CLI.md](docs/CLI.md) for the full command reference with all options a
 
 After running `planr init` and creating artifacts:
 
-```
+```text
 my-project/
 ├── planr.config.json
 ├── docs/agile/
@@ -125,6 +188,10 @@ my-project/
 │   ├── features/       # FEAT-001-*.md
 │   ├── stories/        # US-001-*.md + US-001-gherkin.feature
 │   ├── tasks/          # TASK-001-*.md
+│   ├── quick/          # QT-001-*.md
+│   ├── backlog/        # BL-001-*.md
+│   ├── sprints/        # SPRINT-001-*.md
+│   ├── templates/      # Custom task templates
 │   ├── adrs/           # Architecture Decision Records
 │   ├── checklists/     # Agile development checklist
 │   └── diagrams/       # UML, C4, sequence diagrams
@@ -151,11 +218,28 @@ my-project/
     "epic": "EPIC",
     "feature": "FEAT",
     "story": "US",
-    "task": "TASK"
+    "task": "TASK",
+    "quick": "QT",
+    "backlog": "BL",
+    "sprint": "SPRINT"
   }
 }
 ```
 
+## Built-in Task Templates
+
+| Template             | Description                                             |
+| -------------------- | ------------------------------------------------------- |
+| `rest-endpoint`      | CRUD endpoint with validation, auth, tests, docs        |
+| `react-component`    | Component, stories, tests, types                        |
+| `database-migration` | Schema change, migration, rollback, seed data           |
+| `api-integration`    | External API client, retry logic, error handling, tests |
+| `auth-flow`          | Authentication flow with login, signup, password reset  |
+
+```bash
+planr template use rest-endpoint --title "User Profile API"
+```
+
 ## Development
 
 ```bash

package/dist/agents/index.d.ts

@@ -1,7 +1,3 @@
-export { createAgent } from './agent-factory.js';
-export { executeFollowUp, executeImplementation } from './implementation-bridge.js';
-export { createProgressSpinner, describeActivity } from './progress.js';
-export { composeImplementationPrompt } from './prompt-composer.js';
 export { findSubtasks, getNextPending, parseTaskMarkdown } from './task-parser.js';
-export type { AgentOptions, AgentResult, CodingAgent } from './types.js';
+export { which } from './utils.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACnF,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/agents/index.js

@@ -1,6 +1,3 @@
-export { createAgent } from './agent-factory.js';
-export { executeFollowUp, executeImplementation } from './implementation-bridge.js';
-export { createProgressSpinner, describeActivity } from './progress.js';
-export { composeImplementationPrompt } from './prompt-composer.js';
 export { findSubtasks, getNextPending, parseTaskMarkdown } from './task-parser.js';
+export { which } from './utils.js';
 //# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC"}

package/dist/agents/task-parser.d.ts

@@ -16,7 +16,10 @@ export interface ParsedSubtask {
 }
 /**
  * Parse a task list markdown file into structured subtasks.
- * Expected format: `- [x] 1.0 Task title` or `  - [ ] 1.1 Subtask title`
+ * Expected format:
+ *   `- [x] **1.0** Task title`  (bold group IDs)
+ *   `- [x] 1.0 Task title`     (plain group IDs)
+ *   `  - [ ] 1.1 Subtask title` (indented subtasks)
  */
 export declare function parseTaskMarkdown(content: string): ParsedSubtask[];
 /**

package/dist/agents/task-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-parser.d.ts","sourceRoot":"","sources":["../../src/agents/task-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CA+BlE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAgBnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,aAAa,GAAG,IAAI,CAE3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAStF"}
+{"version":3,"file":"task-parser.d.ts","sourceRoot":"","sources":["../../src/agents/task-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CA+BlE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAgBnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,aAAa,GAAG,IAAI,CAE3E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAStF"}

package/dist/agents/task-parser.js

@@ -9,15 +9,18 @@
  */
 /**
  * Parse a task list markdown file into structured subtasks.
- * Expected format: `- [x] 1.0 Task title` or `  - [ ] 1.1 Subtask title`
+ * Expected format:
+ *   `- [x] **1.0** Task title`  (bold group IDs)
+ *   `- [x] 1.0 Task title`     (plain group IDs)
+ *   `  - [ ] 1.1 Subtask title` (indented subtasks)
  */
 export function parseTaskMarkdown(content) {
     const tasks = [];
     const lines = content.split('\n');
     let currentGroupId = null;
     for (const line of lines) {
-        // Match: - [x] 1.0 Task title  OR  - [ ] 1.1 Subtask title
-        const match = line.match(/^(\s*)- \[(x| )\]\s+(\d+\.\d+)\s+(.+)$/);
+        // Match: - [x] **1.0** Task title  OR  - [x] 1.0 Task title  OR  - [ ] 1.1 Subtask title
+        const match = line.match(/^(\s*)- \[(x| )\]\s+\*{0,2}(\d+\.\d+)\*{0,2}\s+(.+)$/);
         if (!match)
             continue;
         const indent = match[1].length;

package/dist/agents/task-parser.js.map

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

package/dist/agents/utils.d.ts

@@ -6,8 +6,4 @@
  * Returns the path to the command or null.
  */
 export declare function which(command: string): Promise<string | null>;
-export declare const MAX_RETRIES = 2;
-export declare const RETRY_DELAY_MS = 3000;
-export declare function isRetryableError(stderr: string): boolean;
-export declare function sleep(ms: number): Promise<void>;
 //# sourceMappingURL=utils.d.ts.map

package/dist/agents/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/agents/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;;GAGG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQnE;AAMD,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,cAAc,OAAO,CAAC;AAcnC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/agents/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;;GAGG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASnE"}

package/dist/agents/utils.js

@@ -3,6 +3,7 @@
  */
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
+import { logger } from '../utils/logger.js';
 const execFileAsync = promisify(execFile);
 /**
  * Check if a command exists on the system PATH.
@@ -14,31 +15,9 @@ export async function which(command) {
         const { stdout } = await execFileAsync(cmd, [command]);
         return stdout.trim() || null;
     }
-    catch {
+    catch (err) {
+        logger.debug('Command lookup failed', err);
         return null;
     }
 }
-// ---------------------------------------------------------------------------
-// Retry helpers (shared across agent adapters)
-// ---------------------------------------------------------------------------
-export const MAX_RETRIES = 2;
-export const RETRY_DELAY_MS = 3000;
-/** Patterns in stderr that indicate a transient/retryable API error */
-const RETRYABLE_PATTERNS = [
-    'tool use concurrency',
-    'overloaded',
-    '429',
-    '500',
-    '503',
-    'rate limit',
-    'econnreset',
-    'socket hang up',
-];
-export function isRetryableError(stderr) {
-    const lower = stderr.toLowerCase();
-    return RETRYABLE_PATTERNS.some((p) => lower.includes(p));
-}
-export function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
 //# sourceMappingURL=utils.js.map

package/dist/agents/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/agents/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAe;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,+CAA+C;AAC/C,8EAA8E;AAE9E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC,uEAAuE;AACvE,MAAM,kBAAkB,GAAG;IACzB,sBAAsB;IACtB,YAAY;IACZ,KAAK;IACL,KAAK;IACL,KAAK;IACL,YAAY;IACZ,YAAY;IACZ,gBAAgB;CACjB,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/agents/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,OAAe;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/ai/codebase/context-builder.d.ts

@@ -1,16 +1,35 @@
 /**
  * Orchestrates codebase awareness into a single context string.
  *
- * Combines tech stack detection, folder tree, and related file snippets
- * into a formatted block for inclusion in AI prompts. Respects a token
- * budget (~8K tokens ≈ 32K chars) to avoid prompt overflow.
+ * Combines tech stack detection, folder tree, architecture files,
+ * and keyword-matched file snippets into a formatted block for
+ * inclusion in AI prompts. Respects a token budget to avoid overflow.
+ *
+ * Architecture files are always included — they define the patterns
+ * the AI must follow when generating implementation tasks.
  */
+import { type PatternRule } from './pattern-rules.js';
 import { type TechStack } from './stack-detector.js';
 export interface CodebaseContext {
     techStack: TechStack | null;
     folderTree: string;
+    /** Compact listing of all source files in key directories. */
+    sourceInventory: string;
+    /** Core pattern files that define how the project is structured. */
+    architectureFiles: Map<string, string>;
+    /** Keyword-matched files relevant to the specific task. */
     relatedFiles: Map<string, string>;
+    /** User-defined rules from `.planr/rules.md`. */
+    projectRules: string | null;
+    /** Auto-detected architectural patterns. */
+    patternRules: PatternRule[];
 }
+/**
+ * Discover architecture files that exist in the project.
+ * Tries each candidate path per pattern — first match wins.
+ * Returns a map of relative paths → labeled, truncated content.
+ */
+export declare function findArchitectureFiles(projectDir: string): Promise<Map<string, string>>;
 /**
  * Build a complete codebase context for AI prompt enrichment.
  *

package/dist/ai/codebase/context-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../src/ai/codebase/context-builder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKvF,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAM,EAAO,GACtB,OAAO,CAAC,eAAe,CAAC,CAU1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAwClE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BzD"}
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../src/ai/codebase/context-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAKvF,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,2DAA2D;IAC3D,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,iDAAiD;IACjD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,4CAA4C;IAC5C,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AA2DD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAe5F;AA6ED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAM,EAAO,GACtB,OAAO,CAAC,eAAe,CAAC,CA6B1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA0ElE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BzD"}