openplanr 0.8.0 → 1.0.0

package/dist/templates/rules/cursor/2101-implement-task-list.mdc.hbs

@@ -1,28 +1,80 @@
 ---
-description: "Implement Task List — manage task-by-task implementation for {{projectName}}"
+description: "Implement Task List — context-aware task implementation guide for {{projectName}}"
 globs: ""
 alwaysApply: false
 ---
 
 # Implement Task List
 
-You are an implementation assistant. Guide one-task-at-a-time implementation.
+You are an implementation assistant for **{{projectName}}**. Before writing any code, you MUST gather full planning context by reading the artifact hierarchy.
 
-## Rules
+## Context-Gathering Protocol
 
-1. Only work on ONE subtask at a time
-2. Wait for user approval before moving to the next subtask
-3. After completing a subtask, update the task list by checking the box
-4. Reference acceptance criteria from the linked user story's Gherkin file
+Before implementing ANY subtask, follow this exact sequence:
 
-## Process
+### Step 1: Read the Task List
+- Open the task file from `{{agilePath}}/tasks/` (e.g., `TASK-001-*.md`)
+- Parse the frontmatter to find `storyId` or `featureId`
+- Identify the target subtask (first unchecked `- [ ]` item)
+- Read ALL subtasks to understand the full scope and dependencies
 
-1. Read the task list from `{{agilePath}}/tasks/`
-2. Find the first unchecked subtask
-3. Implement it
-4. Mark it complete in the task file
-5. Ask the user to review before proceeding
+### Step 2: Read the Parent Chain (MANDATORY)
+Follow the artifact hierarchy upward — each level adds critical context:
 
-## Task Locations
+1. **User Story** → `{{agilePath}}/stories/US-XXX-*.md`
+   - Read the full story (role, goal, benefit, acceptance criteria)
+   - Find and read the matching Gherkin file: `{{agilePath}}/stories/US-XXX-gherkin.feature`
+   - Extract the parent `featureId` from frontmatter
+
+2. **Feature** → `{{agilePath}}/features/FEAT-XXX-*.md`
+   - Read the full feature (overview, functional requirements, technical considerations)
+   - Extract the parent `epicId` from frontmatter
+
+3. **Epic** → `{{agilePath}}/epics/EPIC-XXX-*.md`
+   - Read the epic summary (business value, problem statement, success criteria)
+   - This provides the WHY behind the work
+
+### Step 3: Read Architecture Context
+- Read ALL ADRs in `{{agilePath}}/adrs/` — these are binding technical decisions
+- Check `{{agilePath}}/checklists/AGILE-DEVELOPMENT-GUIDE.md` for current progress
+
+### Step 4: Scan the Codebase
+Before writing code, understand what exists:
+
+1. **Identify the tech stack** — Read `package.json`, `tsconfig.json`, or equivalent
+2. **Scan the source tree** — List directories under `src/` (or project root)
+3. **Read architecture files** — Look for these high-priority files:
+   - Type definitions: `src/models/types.ts`, `src/types/index.ts`, or `src/types.ts`
+   - Core services: `src/services/` — understand CRUD patterns
+   - Entry point: `src/index.ts`, `src/main.ts`, or `src/app.ts` — understand registration patterns
+   - Config: `src/config.ts` or `src/services/config-service.ts`
+4. **Find related files** — Search for files matching keywords from the task description
+5. **Check project rules** — Read `.planr/rules.md` if it exists (MANDATORY rules)
+
+## Implementation Rules
+
+1. **ONE subtask at a time** — implement only the target subtask
+2. **Wait for user approval** before moving to the next subtask
+3. **Follow existing patterns** — match the code style, naming conventions, and architecture from Step 4
+4. **Map to acceptance criteria** — every implementation must satisfy the Gherkin scenarios from Step 2
+5. **Update the task file** — check the box `- [x]` for completed subtasks
+6. **Don't modify unrelated code** — stay focused on the target subtask
+
+## Artifact Locations
 - Task lists: `{{agilePath}}/tasks/`
 - User stories: `{{agilePath}}/stories/`
+- Gherkin acceptance criteria: `{{agilePath}}/stories/*-gherkin.feature`
+- Features: `{{agilePath}}/features/`
+- Epics: `{{agilePath}}/epics/`
+- Quick tasks: `{{agilePath}}/quick/`
+- Backlog items: `{{agilePath}}/backlog/`
+- ADRs: `{{agilePath}}/adrs/`
+- Sprints: `{{agilePath}}/sprints/`
+
+## Frontmatter Cross-References
+Artifacts link to their parents via frontmatter fields:
+- Tasks → `storyId: "US-XXX"` or `featureId: "FEAT-XXX"`
+- Stories → `featureId: "FEAT-XXX"`
+- Features → `epicId: "EPIC-XXX"`
+
+Always follow these links to build the full context chain.

package/dist/templates/sprints/sprint.md.hbs

@@ -0,0 +1,42 @@
+---
+id: "{{id}}"
+name: "{{name}}"
+startDate: "{{startDate}}"
+endDate: "{{endDate}}"
+duration: "{{duration}}"
+status: "{{status}}"
+created: "{{date}}"
+updated: "{{date}}"
+taskIds: [{{#each taskIds}}"{{this}}"{{#unless @last}}, {{/unless}}{{/each}}]
+---
+
+# {{id}}: {{name}}
+
+## Sprint Details
+- **Duration:** {{duration}}
+- **Start:** {{startDate}}
+- **End:** {{endDate}}
+- **Status:** {{uppercase status}}
+
+{{#if goals}}
+## Goals
+{{#each goals}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+## Tasks
+{{#if taskIds}}
+{{#each taskIds}}
+- [ ] {{this}}
+{{/each}}
+{{else}}
+_No tasks assigned yet. Run `planr sprint add <taskId>` to assign tasks._
+{{/if}}
+
+## Retrospective
+_Complete this section when closing the sprint with `planr sprint close`._
+
+---
+_View progress: `planr sprint status`_
+_Close sprint: `planr sprint close`_

package/dist/templates/task-templates/api-integration.json

@@ -0,0 +1,45 @@
+{
+  "name": "api-integration",
+  "description": "External API client with retry logic, error handling, and tests",
+  "variables": ["serviceName", "baseUrl"],
+  "tasks": [
+    {
+      "id": "1.0",
+      "title": "API client setup",
+      "subtasks": [
+        { "id": "1.1", "title": "Create {{serviceName}} API client module" },
+        { "id": "1.2", "title": "Configure base URL, headers, and authentication" },
+        { "id": "1.3", "title": "Add environment variables for {{serviceName}} credentials" }
+      ]
+    },
+    {
+      "id": "2.0",
+      "title": "Implement API methods",
+      "subtasks": [
+        { "id": "2.1", "title": "Implement core API methods for {{serviceName}}" },
+        { "id": "2.2", "title": "Add request/response type definitions" },
+        { "id": "2.3", "title": "Add response parsing and data transformation" }
+      ]
+    },
+    {
+      "id": "3.0",
+      "title": "Reliability and error handling",
+      "subtasks": [
+        { "id": "3.1", "title": "Add retry logic with exponential backoff" },
+        { "id": "3.2", "title": "Add timeout configuration" },
+        { "id": "3.3", "title": "Add error classification (retryable vs fatal)" },
+        { "id": "3.4", "title": "Add rate limiting / throttling support" }
+      ]
+    },
+    {
+      "id": "4.0",
+      "title": "Testing",
+      "subtasks": [
+        { "id": "4.1", "title": "Unit tests with mocked HTTP responses" },
+        { "id": "4.2", "title": "Test retry logic and error scenarios" },
+        { "id": "4.3", "title": "Test timeout and rate limit handling" },
+        { "id": "4.4", "title": "Integration test with {{serviceName}} sandbox (if available)" }
+      ]
+    }
+  ]
+}

package/dist/templates/task-templates/auth-flow.json

@@ -0,0 +1,48 @@
+{
+  "name": "auth-flow",
+  "description": "Authentication flow with login, signup, and password reset",
+  "variables": ["authProvider"],
+  "tasks": [
+    {
+      "id": "1.0",
+      "title": "Authentication infrastructure",
+      "subtasks": [
+        { "id": "1.1", "title": "Set up {{authProvider}} authentication provider" },
+        { "id": "1.2", "title": "Configure session/token management (JWT or session)" },
+        { "id": "1.3", "title": "Add auth middleware for protected routes" }
+      ]
+    },
+    {
+      "id": "2.0",
+      "title": "Implement auth endpoints",
+      "subtasks": [
+        { "id": "2.1", "title": "POST /auth/signup — user registration" },
+        { "id": "2.2", "title": "POST /auth/login — user login" },
+        { "id": "2.3", "title": "POST /auth/logout — session termination" },
+        { "id": "2.4", "title": "POST /auth/forgot-password — password reset request" },
+        { "id": "2.5", "title": "POST /auth/reset-password — password reset confirmation" }
+      ]
+    },
+    {
+      "id": "3.0",
+      "title": "Security hardening",
+      "subtasks": [
+        { "id": "3.1", "title": "Add input validation and sanitization" },
+        { "id": "3.2", "title": "Implement rate limiting on auth endpoints" },
+        { "id": "3.3", "title": "Add password strength requirements" },
+        { "id": "3.4", "title": "Secure token storage and rotation" }
+      ]
+    },
+    {
+      "id": "4.0",
+      "title": "Testing",
+      "subtasks": [
+        { "id": "4.1", "title": "Test signup flow (valid input, duplicate email, weak password)" },
+        { "id": "4.2", "title": "Test login flow (valid credentials, invalid, locked account)" },
+        { "id": "4.3", "title": "Test password reset flow end-to-end" },
+        { "id": "4.4", "title": "Test auth middleware (valid token, expired, missing)" },
+        { "id": "4.5", "title": "Test rate limiting on auth endpoints" }
+      ]
+    }
+  ]
+}

package/dist/templates/task-templates/database-migration.json

@@ -0,0 +1,44 @@
+{
+  "name": "database-migration",
+  "description": "Schema change with migration, rollback, and seed data",
+  "variables": ["tableName", "changeDescription"],
+  "tasks": [
+    {
+      "id": "1.0",
+      "title": "Plan schema change",
+      "subtasks": [
+        { "id": "1.1", "title": "Document {{changeDescription}} for {{tableName}} table" },
+        { "id": "1.2", "title": "Review impact on existing queries and indexes" },
+        { "id": "1.3", "title": "Check for foreign key constraints and cascading effects" }
+      ]
+    },
+    {
+      "id": "2.0",
+      "title": "Create migration",
+      "subtasks": [
+        { "id": "2.1", "title": "Write up migration for {{tableName}}" },
+        { "id": "2.2", "title": "Write down migration (rollback)" },
+        { "id": "2.3", "title": "Test migration on local database" }
+      ]
+    },
+    {
+      "id": "3.0",
+      "title": "Update application code",
+      "subtasks": [
+        { "id": "3.1", "title": "Update ORM models/types for {{tableName}}" },
+        { "id": "3.2", "title": "Update queries and repository layer" },
+        { "id": "3.3", "title": "Update API serialization if schema changed" }
+      ]
+    },
+    {
+      "id": "4.0",
+      "title": "Testing and validation",
+      "subtasks": [
+        { "id": "4.1", "title": "Update seed data for {{tableName}}" },
+        { "id": "4.2", "title": "Run existing tests and fix breakages" },
+        { "id": "4.3", "title": "Test rollback migration works correctly" },
+        { "id": "4.4", "title": "Verify data integrity after migration" }
+      ]
+    }
+  ]
+}

package/dist/templates/task-templates/react-component.json

@@ -0,0 +1,45 @@
+{
+  "name": "react-component",
+  "description": "React component with stories, tests, and types",
+  "variables": ["componentName"],
+  "tasks": [
+    {
+      "id": "1.0",
+      "title": "Component setup",
+      "subtasks": [
+        { "id": "1.1", "title": "Create {{componentName}} component file with props interface" },
+        { "id": "1.2", "title": "Add component styles (CSS modules or styled-components)" },
+        { "id": "1.3", "title": "Export from component index barrel" }
+      ]
+    },
+    {
+      "id": "2.0",
+      "title": "Implement component logic",
+      "subtasks": [
+        { "id": "2.1", "title": "Implement {{componentName}} render logic and state" },
+        { "id": "2.2", "title": "Add event handlers and callbacks" },
+        { "id": "2.3", "title": "Handle loading, error, and empty states" },
+        { "id": "2.4", "title": "Add accessibility attributes (aria-labels, roles, keyboard nav)" }
+      ]
+    },
+    {
+      "id": "3.0",
+      "title": "Storybook stories",
+      "subtasks": [
+        { "id": "3.1", "title": "Create default story for {{componentName}}" },
+        { "id": "3.2", "title": "Add variant stories (sizes, states, themes)" },
+        { "id": "3.3", "title": "Add interactive story with controls" }
+      ]
+    },
+    {
+      "id": "4.0",
+      "title": "Tests",
+      "subtasks": [
+        { "id": "4.1", "title": "Unit tests for {{componentName}} rendering" },
+        { "id": "4.2", "title": "Test user interactions and event handlers" },
+        { "id": "4.3", "title": "Test edge cases and error states" },
+        { "id": "4.4", "title": "Snapshot or visual regression test" }
+      ]
+    }
+  ]
+}

package/dist/templates/task-templates/rest-endpoint.json

@@ -0,0 +1,53 @@
+{
+  "name": "rest-endpoint",
+  "description": "CRUD REST endpoint with validation, auth, tests, and docs",
+  "variables": ["entityName", "basePath"],
+  "tasks": [
+    {
+      "id": "1.0",
+      "title": "Define data model and types",
+      "subtasks": [
+        { "id": "1.1", "title": "Create {{entityName}} interface/type definition" },
+        { "id": "1.2", "title": "Add Zod validation schema for {{entityName}}" },
+        { "id": "1.3", "title": "Define request/response DTOs" }
+      ]
+    },
+    {
+      "id": "2.0",
+      "title": "Implement API routes",
+      "subtasks": [
+        { "id": "2.1", "title": "Create GET {{basePath}} — list all {{entityName}}s" },
+        { "id": "2.2", "title": "Create GET {{basePath}}/:id — get single {{entityName}}" },
+        { "id": "2.3", "title": "Create POST {{basePath}} — create {{entityName}}" },
+        { "id": "2.4", "title": "Create PUT {{basePath}}/:id — update {{entityName}}" },
+        { "id": "2.5", "title": "Create DELETE {{basePath}}/:id — delete {{entityName}}" }
+      ]
+    },
+    {
+      "id": "3.0",
+      "title": "Add middleware and validation",
+      "subtasks": [
+        { "id": "3.1", "title": "Add request body validation middleware" },
+        { "id": "3.2", "title": "Add authentication/authorization checks" },
+        { "id": "3.3", "title": "Add error handling and proper HTTP status codes" }
+      ]
+    },
+    {
+      "id": "4.0",
+      "title": "Write tests",
+      "subtasks": [
+        { "id": "4.1", "title": "Unit tests for {{entityName}} validation logic" },
+        { "id": "4.2", "title": "Integration tests for all CRUD endpoints" },
+        { "id": "4.3", "title": "Test error cases (404, 400, 401, 403)" }
+      ]
+    },
+    {
+      "id": "5.0",
+      "title": "Documentation",
+      "subtasks": [
+        { "id": "5.1", "title": "Add API documentation for {{basePath}} endpoints" },
+        { "id": "5.2", "title": "Update README with new endpoint details" }
+      ]
+    }
+  ]
+}

package/dist/templates/tasks/task-list.md.hbs

@@ -44,4 +44,4 @@ status: "pending"
 {{/if}}
 
 ## Notes
-_Mark tasks complete by checking the boxes above, or run `planr task implement {{id}}`._
+_Mark tasks complete by checking the boxes above. Use your coding agent (Claude Code, Cursor, Codex) with the generated rules for context-aware implementation._

package/dist/utils/constants.d.ts

@@ -7,6 +7,8 @@ export declare const ARTIFACT_DIRS: {
     readonly stories: "stories";
     readonly tasks: "tasks";
     readonly quick: "quick";
+    readonly backlog: "backlog";
+    readonly sprints: "sprints";
     readonly adrs: "adrs";
     readonly checklists: "checklists";
 };
@@ -16,6 +18,8 @@ export declare const ID_PREFIXES: {
     readonly story: "US";
     readonly task: "TASK";
     readonly quick: "QT";
+    readonly backlog: "BL";
+    readonly sprint: "SPRINT";
     readonly adr: "ADR";
 };
 export declare function getTemplatesDir(): string;

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAEnD,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAC9C,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAExD,eAAO,MAAM,aAAa;;;;;;;;CAQhB,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;CAOd,CAAC;AAEX,wBAAgB,eAAe,IAAI,MAAM,CAExC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAEnD,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAC9C,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAExD,eAAO,MAAM,aAAa;;;;;;;;;;CAUhB,CAAC;AAEX,eAAO,MAAM,WAAW;;;;;;;;;CASd,CAAC;AAEX,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/utils/constants.js

@@ -11,6 +11,8 @@ export const ARTIFACT_DIRS = {
     stories: 'stories',
     tasks: 'tasks',
     quick: 'quick',
+    backlog: 'backlog',
+    sprints: 'sprints',
     adrs: 'adrs',
     checklists: 'checklists',
 };
@@ -20,6 +22,8 @@ export const ID_PREFIXES = {
     story: 'US',
     task: 'TASK',
     quick: 'QT',
+    backlog: 'BL',
+    sprint: 'SPRINT',
     adr: 'ADR',
 };
 export function getTemplatesDir() {

package/dist/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAEnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAC9C,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAExD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,YAAY;CAChB,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,IAAI;IACX,GAAG,EAAE,KAAK;CACF,CAAC;AAEX,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAEnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAC9C,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAExD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,YAAY;CAChB,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;CACF,CAAC;AAEX,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;AACpD,CAAC"}

package/dist/utils/logger.d.ts

@@ -16,6 +16,36 @@ export declare const logger: {
     error(msg: string): void;
     heading(msg: string): void;
     dim(msg: string): void;
-    debug(msg: string): void;
+    debug(msg: string, ...args: unknown[]): void;
+};
+export declare const display: {
+    /** Print a single formatted line. */
+    line(text: string): void;
+    /** Print an empty line for spacing. */
+    blank(): void;
+    /** Print a dim horizontal separator. */
+    separator(width?: number, char?: string): void;
+    /** Print a bold section heading. */
+    heading(text: string): void;
+    /** Print a key-value pair with aligned label. */
+    keyValue(label: string, value: string, indent?: number): void;
+    /** Print a bulleted list item. */
+    bullet(text: string, indent?: number): void;
+    /** Print a numbered list item. */
+    numbered(index: number, text: string, indent?: number): void;
+    /** Print a table header row with dim column names. */
+    tableHeader(columns: {
+        label: string;
+        width: number;
+    }[], indent?: number): void;
+    /** Print a table row with padded columns. */
+    tableRow(values: string[], widths: number[], indent?: number): void;
+    /** Print a table separator matching column widths. */
+    tableSeparator(totalWidth: number, indent?: number, char?: string): void;
+    /** Print a progress bar. */
+    progressBar(percent: number, width?: number, opts?: {
+        label?: string;
+        indent?: number;
+    }): void;
 };
 //# sourceMappingURL=logger.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAM9C,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAG1D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA2BtD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,eAAO,MAAM,MAAM;cACP,MAAM;iBAGH,MAAM;cAGT,MAAM;eAGL,MAAM;iBAGJ,MAAM;aAGV,MAAM;eAGJ,MAAM;CAKlB,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAe9C,MAAM,WAAW,OAAO;IACtB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAG1D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CA2BtD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjD;AAED,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,eAAO,MAAM,MAAM;cACP,MAAM;iBAGH,MAAM;cAGT,MAAM;eAGL,MAAM;iBAGJ,MAAM;aAGV,MAAM;eAGJ,MAAM,WAAW,OAAO,EAAE;CAStC,CAAC;AAQF,eAAO,MAAM,OAAO;IAClB,qCAAqC;eAC1B,MAAM;IAGjB,uCAAuC;;IAIvC,wCAAwC;;IAIxC,oCAAoC;kBACtB,MAAM;IAGpB,iDAAiD;oBACjC,MAAM,SAAS,MAAM;IAIrC,kCAAkC;iBACrB,MAAM;IAInB,kCAAkC;oBAClB,MAAM,QAAQ,MAAM;IAIpC,sDAAsD;yBACjC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE;IAKvD,6CAA6C;qBAC5B,MAAM,EAAE,UAAU,MAAM,EAAE;IAK3C,sDAAsD;+BAC3B,MAAM;IAIjC,4BAA4B;yBACP,MAAM,yBAAoB;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAgBnF,CAAC"}

package/dist/utils/logger.js

@@ -1,4 +1,12 @@
 import chalk from 'chalk';
+// ---------------------------------------------------------------------------
+// Internal output primitives — the only place console.* is allowed.
+// All public APIs (logger.*, display.*) delegate here.
+// ---------------------------------------------------------------------------
+// biome-ignore lint/suspicious/noConsole: logger is the intentional console abstraction
+const out = (...args) => console.log(...args);
+// biome-ignore lint/suspicious/noConsole: logger is the intentional console abstraction
+const outErr = (...args) => console.error(...args);
 let verboseEnabled = false;
 const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
 /** Format token usage for display. Returns empty string if no usage data. */
@@ -28,7 +36,7 @@ export function createSpinner(message) {
         succeed(msg) {
             clearInterval(interval);
             process.stdout.write(`\r${' '.repeat(currentMsg.length + 4)}\r`);
-            console.log(chalk.green('✓'), msg);
+            out(chalk.green('✓'), msg);
         },
     };
 }
@@ -40,27 +48,102 @@ export function isVerbose() {
 }
 export const logger = {
     info(msg) {
-        console.log(chalk.blue('ℹ'), msg);
+        out(chalk.blue('ℹ'), msg);
     },
     success(msg) {
-        console.log(chalk.green('✓'), msg);
+        out(chalk.green('✓'), msg);
     },
     warn(msg) {
-        console.log(chalk.yellow('⚠'), msg);
+        out(chalk.yellow('⚠'), msg);
     },
     error(msg) {
-        console.error(chalk.red('✗'), msg);
+        outErr(chalk.red('✗'), msg);
     },
     heading(msg) {
-        console.log(chalk.bold.cyan(`\n${msg}`));
+        out(chalk.bold.cyan(`\n${msg}`));
     },
     dim(msg) {
-        console.log(chalk.dim(msg));
+        out(chalk.dim(msg));
     },
-    debug(msg) {
+    debug(msg, ...args) {
         if (verboseEnabled) {
-            console.log(chalk.gray(`[DEBUG] ${msg}`));
+            const extra = args.length > 0
+                ? ` ${args.map((a) => (a instanceof Error ? (a.stack ?? a.message) : String(a))).join(' ')}`
+                : '';
+            out(chalk.gray(`[DEBUG] ${msg}${extra}`));
         }
     },
 };
+// ---------------------------------------------------------------------------
+// display — intentional user-facing output
+//
+// Use `display.*` for formatted output the user sees (tables, lists, previews).
+// Use `logger.*` for operational messages (info, warn, error, debug).
+// ---------------------------------------------------------------------------
+export const display = {
+    /** Print a single formatted line. */
+    line(text) {
+        out(text);
+    },
+    /** Print an empty line for spacing. */
+    blank() {
+        out('');
+    },
+    /** Print a dim horizontal separator. */
+    separator(width = 50, char = '━') {
+        out(chalk.dim(char.repeat(width)));
+    },
+    /** Print a bold section heading. */
+    heading(text) {
+        out(chalk.bold(text));
+    },
+    /** Print a key-value pair with aligned label. */
+    keyValue(label, value, indent = 2) {
+        const pad = ' '.repeat(indent);
+        out(`${pad}${chalk.dim(`${label}:`)}  ${value}`);
+    },
+    /** Print a bulleted list item. */
+    bullet(text, indent = 4) {
+        const pad = ' '.repeat(indent);
+        out(`${pad}• ${text}`);
+    },
+    /** Print a numbered list item. */
+    numbered(index, text, indent = 4) {
+        const pad = ' '.repeat(indent);
+        out(`${pad}${chalk.dim(`${index}.`)} ${text}`);
+    },
+    /** Print a table header row with dim column names. */
+    tableHeader(columns, indent = 2) {
+        const pad = ' '.repeat(indent);
+        const header = columns.map((c) => chalk.dim(c.label.padEnd(c.width))).join(' ');
+        out(`${pad}${header}`);
+    },
+    /** Print a table row with padded columns. */
+    tableRow(values, widths, indent = 2) {
+        const pad = ' '.repeat(indent);
+        const row = values.map((v, i) => v.padEnd(widths[i] ?? 0)).join(' ');
+        out(`${pad}${row}`);
+    },
+    /** Print a table separator matching column widths. */
+    tableSeparator(totalWidth, indent = 2, char = '─') {
+        const pad = ' '.repeat(indent);
+        out(`${pad}${char.repeat(totalWidth)}`);
+    },
+    /** Print a progress bar. */
+    progressBar(percent, width = 20, opts = {}) {
+        const { label = '', indent = 2 } = opts;
+        const pad = ' '.repeat(indent);
+        const clamped = Math.max(0, Math.min(100, percent));
+        const safeWidth = Math.max(1, width);
+        const filled = Math.round((clamped / 100) * safeWidth);
+        const empty = safeWidth - filled;
+        const bar = `${chalk.green('█'.repeat(filled))}${chalk.dim('░'.repeat(empty))}`;
+        const pctStr = clamped >= 75
+            ? chalk.green(`${clamped}%`)
+            : clamped >= 25
+                ? chalk.yellow(`${clamped}%`)
+                : chalk.red(`${clamped}%`);
+        out(`${pad}${bar} ${pctStr}${label ? `  ${label}` : ''}`);
+    },
+};
 //# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/markdown.d.ts

@@ -1,7 +1,8 @@
+import type { ArtifactFrontmatter } from '../models/types.js';
 export interface ParsedMarkdown {
-    data: Record<string, unknown>;
+    data: ArtifactFrontmatter;
     content: string;
 }
 export declare function parseMarkdown(raw: string): ParsedMarkdown;
-export declare function toMarkdownWithFrontmatter(data: Record<string, unknown>, content: string): string;
+export declare function toMarkdownWithFrontmatter(data: ArtifactFrontmatter, content: string): string;
 //# sourceMappingURL=markdown.d.ts.map