@refrakt-md/plan 0.9.0

package/dist/commands/bundle-behaviors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-behaviors.js","sourceRoot":"","sources":["../../src/commands/bundle-behaviors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACpC,gFAAgF;IAChF,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,QAAQ,EAAE,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;QAC1B,WAAW,EAAE,CAAC,UAAU,CAAC;QACzB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,KAAK;QACZ,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,CAAC,QAAQ,CAAC;KAClB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnC,CAAC"}

package/dist/commands/create.d.ts

@@ -0,0 +1,21 @@
+import { type PlanItemType } from './templates.js';
+export declare const EXIT_SUCCESS = 0;
+export declare const EXIT_ALREADY_EXISTS = 1;
+export declare const EXIT_INVALID_ARGS = 2;
+export interface CreateOptions {
+    dir: string;
+    type: PlanItemType;
+    id: string;
+    title: string;
+    attrs?: Record<string, string>;
+}
+export interface CreateResult {
+    file: string;
+    type: PlanItemType;
+    id: string;
+}
+/**
+ * Scaffold a new plan item from a template.
+ */
+export declare function runCreate(options: CreateOptions): CreateResult;
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhF,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAWnC,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAuC9D"}

package/dist/commands/create.js

@@ -0,0 +1,50 @@
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { renderTemplate, VALID_TYPES } from './templates.js';
+export const EXIT_SUCCESS = 0;
+export const EXIT_ALREADY_EXISTS = 1;
+export const EXIT_INVALID_ARGS = 2;
+/** Directory name for each type */
+const TYPE_DIRS = {
+    work: 'work',
+    bug: 'work', // bugs live alongside work items
+    decision: 'decision',
+    spec: 'spec',
+    milestone: 'milestone',
+};
+/**
+ * Scaffold a new plan item from a template.
+ */
+export function runCreate(options) {
+    const { dir, type, id, title, attrs } = options;
+    if (!VALID_TYPES.includes(type)) {
+        const err = new Error(`Invalid type "${type}". Valid types: ${VALID_TYPES.join(', ')}`);
+        err.exitCode = EXIT_INVALID_ARGS;
+        throw err;
+    }
+    if (!id) {
+        const err = new Error('--id is required');
+        err.exitCode = EXIT_INVALID_ARGS;
+        throw err;
+    }
+    if (!title) {
+        const err = new Error('--title is required');
+        err.exitCode = EXIT_INVALID_ARGS;
+        throw err;
+    }
+    const subDir = join(dir, TYPE_DIRS[type]);
+    mkdirSync(subDir, { recursive: true });
+    // Generate a filename from the title
+    const slug = title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, '');
+    const fileName = `${slug}.md`;
+    const filePath = join(subDir, fileName);
+    if (existsSync(filePath)) {
+        const err = new Error(`File already exists: ${filePath}`);
+        err.exitCode = EXIT_ALREADY_EXISTS;
+        throw err;
+    }
+    const content = renderTemplate(type, { id, title, attrs });
+    writeFileSync(filePath, content);
+    return { file: filePath, type, id };
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,WAAW,EAAqB,MAAM,gBAAgB,CAAC;AAEhF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAC9B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC,mCAAmC;AACnC,MAAM,SAAS,GAAiC;IAC/C,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,MAAM,EAAE,iCAAiC;IAC9C,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;CACtB,CAAC;AAgBF;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAsB;IAC/C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAEhD,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,iBAAiB,IAAI,mBAAmB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAQ,CAAC;QAC/F,GAAG,CAAC,QAAQ,GAAG,iBAAiB,CAAC;QACjC,MAAM,GAAG,CAAC;IACX,CAAC;IAED,IAAI,CAAC,EAAE,EAAE,CAAC;QACT,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,kBAAkB,CAAQ,CAAC;QACjD,GAAG,CAAC,QAAQ,GAAG,iBAAiB,CAAC;QACjC,MAAM,GAAG,CAAC;IACX,CAAC;IAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,qBAAqB,CAAQ,CAAC;QACpD,GAAG,CAAC,QAAQ,GAAG,iBAAiB,CAAC;QACjC,MAAM,GAAG,CAAC;IACX,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1C,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,qCAAqC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACrF,MAAM,QAAQ,GAAG,GAAG,IAAI,KAAK,CAAC;IAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAExC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,wBAAwB,QAAQ,EAAE,CAAQ,CAAC;QACjE,GAAG,CAAC,QAAQ,GAAG,mBAAmB,CAAC;QACnC,MAAM,GAAG,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAEjC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AACrC,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,17 @@
+export declare const EXIT_SUCCESS = 0;
+export declare const EXIT_ALREADY_EXISTS = 1;
+export interface InitOptions {
+    dir: string;
+    /** Path to the project root (for CLAUDE.md). Defaults to '.' */
+    projectRoot?: string;
+}
+export interface InitResult {
+    dir: string;
+    created: string[];
+    claudeMdUpdated: boolean;
+}
+/**
+ * Initialize a plan directory structure with example files.
+ */
+export declare function runInit(options: InitOptions): InitResult;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,MAAM,WAAW,WAAW;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;CACzB;AAkBD;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CA0FxD"}

package/dist/commands/init.js

@@ -0,0 +1,109 @@
+import { existsSync, mkdirSync, writeFileSync, readFileSync, appendFileSync } from 'fs';
+import { join } from 'path';
+import { runCreate } from './create.js';
+import { STATUS_PAGES, renderStatusPage, renderTypeIndexPage } from './templates.js';
+export const EXIT_SUCCESS = 0;
+export const EXIT_ALREADY_EXISTS = 1;
+const WORKFLOW_SECTION = `
+## Plan
+
+Project planning content lives in \`plan/\` as Markdoc files using the \`@refrakt-md/plan\` runes package.
+
+### Workflow
+
+1. Find next work item: \`refrakt plan next\`
+2. Start working: \`refrakt plan update <id> --status in-progress\`
+3. Check off criteria: \`refrakt plan update <id> --check "criterion text"\`
+4. Mark complete with resolution: \`refrakt plan update <id> --status done --resolve "summary of what was done"\`
+5. Check project status: \`refrakt plan status\`
+
+When marking a work item done, always provide a \`--resolve\` summary unless the change is trivial. This captures implementation context (files changed, decisions made, branch/PR) for future reference.
+`;
+/**
+ * Initialize a plan directory structure with example files.
+ */
+export function runInit(options) {
+    const { dir, projectRoot = '.' } = options;
+    const created = [];
+    // Create directories
+    const dirs = ['work', 'spec', 'decision', 'milestone'];
+    for (const sub of dirs) {
+        const path = join(dir, sub);
+        if (!existsSync(path)) {
+            mkdirSync(path, { recursive: true });
+            created.push(path + '/');
+        }
+    }
+    // Create example files — use runCreate which generates slug-based filenames
+    const examples = [
+        { type: 'spec', id: 'SPEC-001', title: 'Example Spec', subDir: 'spec', slug: 'example-spec.md' },
+        { type: 'work', id: 'WORK-001', title: 'Example Work Item', subDir: 'work', slug: 'example-work-item.md', attrs: { priority: 'medium', complexity: 'simple', tags: '' } },
+        { type: 'decision', id: 'ADR-001', title: 'Example Decision', subDir: 'decision', slug: 'example-decision.md' },
+        { type: 'milestone', id: 'v0.1.0', title: 'First Release', subDir: 'milestone', slug: 'first-release.md' },
+    ];
+    for (const ex of examples) {
+        const filePath = join(dir, ex.subDir, ex.slug);
+        if (!existsSync(filePath)) {
+            runCreate({ dir, type: ex.type, id: ex.id, title: ex.title, attrs: ex.attrs });
+            created.push(filePath);
+        }
+    }
+    // Create status filter pages for each type
+    for (const def of STATUS_PAGES) {
+        const slug = `${def.status}.md`;
+        const filePath = join(dir, def.typeDir, slug);
+        if (!existsSync(filePath)) {
+            writeFileSync(filePath, renderStatusPage(def));
+            created.push(filePath);
+        }
+    }
+    // Create type-level index pages with links to status filter pages
+    const typeDirs = [...new Set(STATUS_PAGES.map(p => p.typeDir))];
+    for (const typeDir of typeDirs) {
+        const filePath = join(dir, typeDir, 'index.md');
+        if (!existsSync(filePath)) {
+            writeFileSync(filePath, renderTypeIndexPage(typeDir));
+            created.push(filePath);
+        }
+    }
+    // Create index.md
+    const indexFile = join(dir, 'index.md');
+    if (!existsSync(indexFile)) {
+        writeFileSync(indexFile, `# Project Plan
+
+This directory contains project planning content.
+
+## Structure
+
+- [Specifications](spec/) — What to build
+- [Work Items](work/) — How to build it
+- [Decisions](decision/) — Why it's built this way
+- [Milestones](milestone/) — Named release targets
+
+## Quick Start
+
+\`\`\`bash
+refrakt plan next          # Find next work item
+refrakt plan status        # Project overview
+refrakt plan create work --id WORK-002 --title "My task"
+\`\`\`
+`);
+        created.push(indexFile);
+    }
+    // Update CLAUDE.md
+    let claudeMdUpdated = false;
+    const claudeMdPath = join(projectRoot, 'CLAUDE.md');
+    if (existsSync(claudeMdPath)) {
+        const content = readFileSync(claudeMdPath, 'utf-8');
+        if (!content.includes('refrakt plan next')) {
+            appendFileSync(claudeMdPath, WORKFLOW_SECTION);
+            claudeMdUpdated = true;
+        }
+    }
+    else {
+        writeFileSync(claudeMdPath, `# CLAUDE.md\n${WORKFLOW_SECTION}`);
+        claudeMdUpdated = true;
+    }
+    return { dir, created, claudeMdUpdated };
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/next.d.ts

@@ -0,0 +1,34 @@
+export declare const EXIT_FOUND = 0;
+export declare const EXIT_NO_MATCHES = 1;
+export declare const EXIT_INVALID_ARGS = 2;
+export interface NextOptions {
+    dir: string;
+    milestone?: string;
+    tag?: string;
+    assignee?: string;
+    type?: 'work' | 'bug' | 'all';
+    count?: number;
+    formatJson?: boolean;
+}
+export interface NextResult {
+    items: NextItem[];
+}
+export interface NextItem {
+    id: string;
+    title: string | undefined;
+    type: string;
+    priority: string;
+    complexity: string;
+    file: string;
+    criteria: {
+        text: string;
+        checked: boolean;
+    }[];
+    refs: string[];
+    attributes: Record<string, string>;
+}
+/**
+ * Find the next actionable work items, respecting dependencies and filters.
+ */
+export declare function runNext(options: NextOptions): NextResult;
+//# sourceMappingURL=next.d.ts.map

package/dist/commands/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/commands/next.ts"],"names":[],"mappings":"AA+BA,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,MAAM,WAAW,WAAW;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,QAAQ,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC/C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CA2ExD"}

package/dist/commands/next.js

@@ -0,0 +1,100 @@
+import { scanPlanFiles } from '../scanner.js';
+// --- Priority and complexity sort orders ---
+const PRIORITY_ORDER = {
+    critical: 0,
+    high: 1,
+    medium: 2,
+    low: 3,
+};
+const COMPLEXITY_ORDER = {
+    trivial: 0,
+    simple: 1,
+    moderate: 2,
+    complex: 3,
+    unknown: 4,
+};
+/** Statuses that indicate an entity's work is complete */
+const DONE_STATUSES = new Set(['done', 'fixed']);
+/** Statuses that indicate an item is actionable */
+const READY_STATUSES = {
+    work: ['ready'],
+    bug: ['confirmed'],
+};
+// --- Exit codes ---
+export const EXIT_FOUND = 0;
+export const EXIT_NO_MATCHES = 1;
+export const EXIT_INVALID_ARGS = 2;
+/**
+ * Find the next actionable work items, respecting dependencies and filters.
+ */
+export function runNext(options) {
+    const { dir, milestone, tag, assignee, type = 'all', count = 1 } = options;
+    const entities = scanPlanFiles(dir);
+    // Build status lookup: ID → status
+    const statusMap = new Map();
+    for (const e of entities) {
+        const id = e.attributes.id ?? e.attributes.name;
+        if (id)
+            statusMap.set(id, e.attributes.status ?? '');
+    }
+    // Filter to actionable types
+    const typeFilter = type === 'all' ? ['work', 'bug'] : [type];
+    let candidates = entities.filter(e => {
+        if (!typeFilter.includes(e.type))
+            return false;
+        const readyStatuses = READY_STATUSES[e.type];
+        if (!readyStatuses)
+            return false;
+        const status = e.attributes.status ?? '';
+        return readyStatuses.includes(status);
+    });
+    // Exclude items with unfinished dependencies
+    candidates = candidates.filter(e => {
+        for (const refId of e.refs) {
+            const refStatus = statusMap.get(refId);
+            // If the referenced entity exists and isn't done, exclude this item
+            if (refStatus !== undefined && !DONE_STATUSES.has(refStatus)) {
+                return false;
+            }
+        }
+        return true;
+    });
+    // Apply filters
+    if (milestone) {
+        candidates = candidates.filter(e => e.attributes.milestone === milestone);
+    }
+    if (tag) {
+        candidates = candidates.filter(e => {
+            const tags = (e.attributes.tags ?? '').split(',').map(t => t.trim());
+            return tags.includes(tag);
+        });
+    }
+    if (assignee) {
+        candidates = candidates.filter(e => e.attributes.assignee === assignee);
+    }
+    // Sort: priority (critical first), then complexity (simpler first)
+    candidates.sort((a, b) => {
+        const pa = PRIORITY_ORDER[a.attributes.priority ?? 'medium'] ?? 2;
+        const pb = PRIORITY_ORDER[b.attributes.priority ?? 'medium'] ?? 2;
+        if (pa !== pb)
+            return pa - pb;
+        const ca = COMPLEXITY_ORDER[a.attributes.complexity ?? 'unknown'] ?? 4;
+        const cb = COMPLEXITY_ORDER[b.attributes.complexity ?? 'unknown'] ?? 4;
+        return ca - cb;
+    });
+    const selected = candidates.slice(0, count);
+    return {
+        items: selected.map(e => ({
+            id: e.attributes.id ?? e.attributes.name ?? '',
+            title: e.title,
+            type: e.type,
+            priority: e.attributes.priority ?? 'medium',
+            complexity: e.attributes.complexity ?? 'unknown',
+            file: e.file,
+            criteria: e.criteria,
+            refs: e.refs,
+            attributes: e.attributes,
+        })),
+    };
+}
+//# sourceMappingURL=next.js.map

package/dist/commands/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sourceRoot":"","sources":["../../src/commands/next.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9C,8CAA8C;AAE9C,MAAM,cAAc,GAA2B;IAC9C,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,CAAC;CACN,CAAC;AAEF,MAAM,gBAAgB,GAA2B;IAChD,OAAO,EAAE,CAAC;IACV,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;CACV,CAAC;AAEF,0DAA0D;AAC1D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjD,mDAAmD;AACnD,MAAM,cAAc,GAA6B;IAChD,IAAI,EAAE,CAAC,OAAO,CAAC;IACf,GAAG,EAAE,CAAC,WAAW,CAAC;CAClB,CAAC;AAEF,qBAAqB;AAErB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC;AAC5B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AA4BnC;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,OAAoB;IAC3C,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,GAAG,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAE3E,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAEpC,mCAAmC;IACnC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC1B,MAAM,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAChD,IAAI,EAAE;YAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,6BAA6B;IAC7B,MAAM,UAAU,GAAG,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE7D,IAAI,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QACpC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QAC/C,MAAM,aAAa,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,aAAa;YAAE,OAAO,KAAK,CAAC;QACjC,MAAM,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC;QACzC,OAAO,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,6CAA6C;IAC7C,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAClC,KAAK,MAAM,KAAK,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACvC,oEAAoE;YACpE,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9D,OAAO,KAAK,CAAC;YACd,CAAC;QACF,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,gBAAgB;IAChB,IAAI,SAAS,EAAE,CAAC;QACf,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,GAAG,EAAE,CAAC;QACT,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YAClC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACrE,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,EAAE,CAAC;QACd,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IACzE,CAAC;IAED,mEAAmE;IACnE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClE,MAAM,EAAE,GAAG,cAAc,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClE,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAE9B,MAAM,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;QACvE,OAAO,EAAE,GAAG,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAE5C,OAAO;QACN,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzB,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE;YAC9C,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,IAAI,QAAQ;YAC3C,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,UAAU,IAAI,SAAS;YAChD,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,UAAU,EAAE,CAAC,CAAC,UAAU;SACxB,CAAC,CAAC;KACH,CAAC;AACH,CAAC"}

package/dist/commands/plan-behaviors.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plan-behaviors.d.ts.map

package/dist/commands/plan-behaviors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-behaviors.d.ts","sourceRoot":"","sources":["../../src/commands/plan-behaviors.ts"],"names":[],"mappings":""}

package/dist/commands/plan-behaviors.js

@@ -0,0 +1,7 @@
+import { initRuneBehaviors, initLayoutBehaviors, registerBehaviors, tabsBehavior } from '@refrakt-md/behaviors';
+// Register plan-specific behaviors
+registerBehaviors({ 'milestone-backlog': tabsBehavior });
+// Initialize all rune + layout behaviors on DOM ready
+initRuneBehaviors(document);
+initLayoutBehaviors(document);
+//# sourceMappingURL=plan-behaviors.js.map

package/dist/commands/plan-behaviors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-behaviors.js","sourceRoot":"","sources":["../../src/commands/plan-behaviors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEhH,mCAAmC;AACnC,iBAAiB,CAAC,EAAE,mBAAmB,EAAE,YAAY,EAAE,CAAC,CAAC;AAEzD,sDAAsD;AACtD,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AAC5B,mBAAmB,CAAC,QAAQ,CAAC,CAAC"}

package/dist/commands/render-pipeline.d.ts

@@ -0,0 +1,70 @@
+import 'reflect-metadata';
+import type { RendererNode } from '@refrakt-md/types';
+export interface ProcessedPage {
+    url: string;
+    title: string;
+    type: string;
+    entityId: string;
+    status: string;
+    renderable: RendererNode;
+    filePath: string;
+    headings: Array<{
+        level: number;
+        text: string;
+        id: string;
+    }>;
+}
+export interface NavGroup {
+    title: string;
+    type: string;
+    items: NavItem[];
+    statusGroups: NavStatusGroup[];
+}
+export interface NavStatusGroup {
+    status: string;
+    label: string;
+    items: NavItem[];
+    collapsed: boolean;
+}
+export interface NavItem {
+    url: string;
+    label: string;
+    id: string;
+    status: string;
+    priority?: string;
+    tags?: string;
+    assignee?: string;
+    milestone?: string;
+    severity?: string;
+    hasUnresolvedBlockers?: boolean;
+}
+export interface PipelineResult {
+    pages: ProcessedPage[];
+    dashboard: ProcessedPage;
+    nav: NavGroup[];
+    navRegion: RendererNode[];
+    themeCss: string;
+    highlightCss: string;
+}
+export interface PipelineOptions {
+    dir: string;
+    specsDir?: string;
+    theme: string;
+    baseUrl: string;
+}
+export declare function runPipeline(options: PipelineOptions): Promise<PipelineResult>;
+/**
+ * Render a processed page to a full HTML document using the HTML adapter.
+ */
+export declare function renderPage(page: ProcessedPage, navRegion: RendererNode[], allPageUrls: Array<{
+    url: string;
+    title: string;
+    draft: boolean;
+}>, opts?: {
+    hotReload?: boolean;
+    stylesheets?: string[];
+    scripts?: string[];
+    activeUrl?: string;
+}): string;
+export declare function getThemeCss(theme: string): string;
+//# sourceMappingURL=render-pipeline.d.ts.map

package/dist/commands/render-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-pipeline.d.ts","sourceRoot":"","sources":["../../src/commands/render-pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAQ1B,OAAO,KAAK,EAAE,YAAY,EAAuF,MAAM,mBAAmB,CAAC;AAoB3I,MAAM,WAAW,aAAa;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,YAAY,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,QAAQ;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,YAAY,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,OAAO;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,SAAS,EAAE,aAAa,CAAC;IACzB,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAChB;AAu/BD,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA+MnF;AAED;;GAEG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,YAAY,EAAE,EACzB,WAAW,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,EAClE,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5F,MAAM,CA8BR;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD"}