@refrakt-md/plan 0.9.0

package/dist/index.js

@@ -0,0 +1,144 @@
+import { tabsBehavior } from '@refrakt-md/behaviors';
+import { spec } from './tags/spec.js';
+import { work } from './tags/work.js';
+import { bug } from './tags/bug.js';
+import { decision } from './tags/decision.js';
+import { milestone } from './tags/milestone.js';
+import { backlog } from './tags/backlog.js';
+import { decisionLog } from './tags/decision-log.js';
+import { planProgress } from './tags/plan-progress.js';
+import { planActivity } from './tags/plan-activity.js';
+import { config } from './config.js';
+import { planPipelineHooks } from './pipeline.js';
+export const plan = {
+    name: 'plan',
+    displayName: 'Plan',
+    version: '0.9.0',
+    runes: {
+        'spec': {
+            transform: spec,
+            description: 'Specification document with status tracking, versioning, and entity registry integration',
+            reinterprets: { heading: 'spec title', blockquote: 'scope summary', paragraph: 'specification content' },
+            fixture: `{% spec id="SPEC-001" status="accepted" version="1.0" %}
+# Authentication System
+
+> Token-based authentication for the API layer.
+
+Users authenticate via JWT tokens issued by the auth endpoint.
+Tokens expire after 24 hours and can be refreshed.
+{% /spec %}`,
+        },
+        'work': {
+            transform: work,
+            aliases: ['task'],
+            description: 'Work item with acceptance criteria, references, and implementation tracking',
+            reinterprets: { heading: 'work item title or section heading', paragraph: 'description', list: 'acceptance criteria or references' },
+            fixture: `{% work id="RF-142" status="ready" priority="high" complexity="moderate" milestone="v0.5.0" %}
+# Implement dark mode support
+
+The theme needs dual light/dark token definitions.
+
+## Acceptance Criteria
+- [ ] Accepts light and dark content sections
+- [ ] Theme CSS swaps tokens in dark mode
+- [ ] Falls back to page tokens when dark values absent
+
+## Approach
+Use CSS custom properties with media query swapping.
+{% /work %}`,
+        },
+        'bug': {
+            transform: bug,
+            description: 'Bug report with structured reproduction steps and severity tracking',
+            reinterprets: { heading: 'bug title or section heading', list: 'reproduction steps or environment details', paragraph: 'expected/actual behaviour' },
+            fixture: `{% bug id="RF-201" status="confirmed" severity="major" %}
+# Showcase bleed breaks with overflow:hidden parent
+
+## Steps to Reproduce
+1. Create a section with overflow: hidden
+2. Add a showcase with bleed="top" inside
+3. Observe the rendered output
+
+## Expected
+Showcase extends above the section boundary.
+
+## Actual
+Showcase is clipped at the section edge.
+{% /bug %}`,
+        },
+        'decision': {
+            transform: decision,
+            aliases: ['adr'],
+            description: 'Architecture decision record capturing context, options, decision, rationale, and consequences',
+            reinterprets: { heading: 'decision title or section heading', paragraph: 'context, rationale, or consequences', list: 'options considered' },
+            fixture: `{% decision id="ADR-007" status="accepted" date="2026-03-11" %}
+# Use CSS custom properties for token injection
+
+## Context
+Tint runes need to override colour tokens within a section scope.
+
+## Options Considered
+1. **CSS custom properties** — inline styles setting tokens
+2. **Generated CSS classes** — build step creates per-tint classes
+3. **JavaScript runtime** — behaviour script reads data attributes
+
+## Decision
+CSS custom properties via inline styles on the container element.
+
+## Rationale
+Custom properties cascade naturally without JavaScript.
+
+## Consequences
+- Themes must include bridge CSS
+- Inline styles cannot use media queries
+{% /decision %}`,
+        },
+        'milestone': {
+            transform: milestone,
+            description: 'Named release target with scope, goals, and status tracking',
+            reinterprets: { heading: 'milestone title', list: 'goals' },
+            fixture: `{% milestone name="v0.5.0" target="2026-03-29" status="active" %}
+# v0.5.0 — Layout & Tint
+
+- Complete alignment system migration
+- Ship tint rune with dark mode support
+- Publish layout spec as documentation
+{% /milestone %}`,
+        },
+        'backlog': {
+            transform: backlog,
+            description: 'Aggregation view of work items and bugs with filtering, sorting, and grouping',
+            reinterprets: {},
+            fixture: `{% backlog filter="status:ready" sort="priority" group="status" /%}`,
+        },
+        'decision-log': {
+            transform: decisionLog,
+            description: 'Chronological view of architecture decision records',
+            reinterprets: {},
+            fixture: `{% decision-log sort="date" /%}`,
+        },
+        'plan-progress': {
+            transform: planProgress,
+            description: 'Progress summary showing status counts per entity type',
+            reinterprets: {},
+            fixture: `{% plan-progress /%}`,
+        },
+        'plan-activity': {
+            transform: planActivity,
+            description: 'Recent activity feed sorted by file modification time',
+            reinterprets: {},
+            fixture: `{% plan-activity limit="10" /%}`,
+        },
+    },
+    theme: {
+        runes: config,
+    },
+    behaviors: {
+        'milestone-backlog': tabsBehavior,
+    },
+    pipeline: planPipelineHooks,
+};
+export default plan;
+export { scanPlanFiles, parseFile } from './scanner.js';
+export { planPipelineHooks } from './pipeline.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/pipeline.d.ts

@@ -0,0 +1,23 @@
+import type { PackagePipelineHooks, EntityRegistration } from '@refrakt-md/types';
+/** A directed reference from one entity to another */
+export interface EntityRelationship {
+    /** The entity that contains the reference */
+    fromId: string;
+    fromType: string;
+    /** The entity being referenced */
+    toId: string;
+    toType: string;
+    /** Relationship kind */
+    kind: 'blocks' | 'blocked-by' | 'related';
+}
+export interface PlanAggregatedData {
+    workEntities: EntityRegistration[];
+    bugEntities: EntityRegistration[];
+    decisionEntities: EntityRegistration[];
+    specEntities: EntityRegistration[];
+    milestoneEntities: EntityRegistration[];
+    /** Bidirectional relationship index: entityId → relationships */
+    relationships: Map<string, EntityRelationship[]>;
+}
+export declare const planPipelineHooks: PackagePipelineHooks;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAgOlF,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IAClC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,IAAI,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,kBAAkB;IAClC,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,gBAAgB,EAAE,kBAAkB,EAAE,CAAC;IACvC,YAAY,EAAE,kBAAkB,EAAE,CAAC;IACnC,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;IACxC,iEAAiE;IACjE,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;CACjD;AASD,eAAO,MAAM,iBAAiB,EAAE,oBA0L/B,CAAC"}