@refrakt-md/plan 0.9.6 → 0.9.8

package/dist/relationships.d.ts

@@ -0,0 +1,36 @@
+/** 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' | 'depends-on' | 'dependency-of' | 'implements' | 'implemented-by' | 'informs' | 'informed-by' | 'related';
+}
+/** Minimal entity shape needed for relationship building */
+export interface RelationshipEntity {
+    type: string;
+    data: Record<string, unknown>;
+}
+/**
+ * Build a bidirectional relationship index from entity references.
+ *
+ * Three sources of relationships are processed:
+ * 1. **Source references** (from source= attribute): produce `implements`/`implemented-by` edges
+ *    (or `informs`/`informed-by` for decisions)
+ * 2. **Scanner dependencies** (from ## Dependencies sections): produce `depends-on`/`dependency-of` edges
+ * 3. **ID references** (text-pattern matches like WORK-042): produce `related` edges
+ *    (or `blocked-by`/`blocks` when the referencing entity has status "blocked")
+ *
+ * Edges from sources 1 and 2 suppress duplicate edges from source 3.
+ */
+export declare function buildRelationships(entities: Map<string, RelationshipEntity>, sourceReferences: Map<string, Array<{
+    id: string;
+    type: string;
+}>>, scannerDependencies: Map<string, string[]>, idReferences: Map<string, Array<{
+    id: string;
+    type: string;
+}>>): Map<string, EntityRelationship[]>;
+//# sourceMappingURL=relationships.d.ts.map

package/dist/relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../src/relationships.ts"],"names":[],"mappings":"AAIA,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,YAAY,GAAG,eAAe,GAAG,YAAY,GAAG,gBAAgB,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAAC;CACzI;AAED,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACzC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,EAClE,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC1C,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,GAC5D,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAuHnC"}

package/dist/relationships.js

@@ -0,0 +1,128 @@
+// ─── Relationship Builder ───
+// Constructs bidirectional relationship graphs from entity references.
+// No Node.js API dependencies — safe for edge runtimes.
+/**
+ * Build a bidirectional relationship index from entity references.
+ *
+ * Three sources of relationships are processed:
+ * 1. **Source references** (from source= attribute): produce `implements`/`implemented-by` edges
+ *    (or `informs`/`informed-by` for decisions)
+ * 2. **Scanner dependencies** (from ## Dependencies sections): produce `depends-on`/`dependency-of` edges
+ * 3. **ID references** (text-pattern matches like WORK-042): produce `related` edges
+ *    (or `blocked-by`/`blocks` when the referencing entity has status "blocked")
+ *
+ * Edges from sources 1 and 2 suppress duplicate edges from source 3.
+ */
+export function buildRelationships(entities, sourceReferences, scannerDependencies, idReferences) {
+    const relationships = new Map();
+    function addRel(id, rel) {
+        if (!relationships.has(id))
+            relationships.set(id, []);
+        relationships.get(id).push(rel);
+    }
+    // Track IDs already linked via source= to avoid duplicate 'related' edges
+    const sourceLinked = new Set();
+    // Process structured source= references → implements / implemented-by (or informs / informed-by for decisions)
+    for (const [fromId, refs] of sourceReferences) {
+        const fromEntity = entities.get(fromId);
+        if (!fromEntity)
+            continue;
+        // Decisions use informs/informed-by; work/bug use implements/implemented-by
+        const isDecision = fromEntity.type === 'decision';
+        const forwardKind = isDecision ? 'informs' : 'implements';
+        const reverseKind = isDecision ? 'informed-by' : 'implemented-by';
+        for (const ref of refs) {
+            const toEntity = entities.get(ref.id);
+            if (!toEntity)
+                continue;
+            sourceLinked.add(`${fromId}→${ref.id}`);
+            // A implements/informs B
+            addRel(fromId, {
+                fromId, fromType: fromEntity.type,
+                toId: ref.id, toType: toEntity.type,
+                kind: forwardKind,
+            });
+            // B is implemented-by/informed-by A
+            addRel(ref.id, {
+                fromId: ref.id, fromType: toEntity.type,
+                toId: fromId, toType: fromEntity.type,
+                kind: reverseKind,
+            });
+        }
+    }
+    // Track IDs already linked via depends-on to avoid duplicate 'related' edges
+    const depLinked = new Set();
+    // Process scanner dependency data → depends-on / dependency-of
+    for (const [fromId, depIds] of scannerDependencies) {
+        const fromEntity = entities.get(fromId);
+        if (!fromEntity)
+            continue;
+        for (const depId of depIds) {
+            const toEntity = entities.get(depId);
+            if (!toEntity)
+                continue;
+            depLinked.add(`${fromId}→${depId}`);
+            // A depends-on B
+            addRel(fromId, {
+                fromId, fromType: fromEntity.type,
+                toId: depId, toType: toEntity.type,
+                kind: 'depends-on',
+            });
+            // B is dependency-of A
+            addRel(depId, {
+                fromId: depId, fromType: toEntity.type,
+                toId: fromId, toType: fromEntity.type,
+                kind: 'dependency-of',
+            });
+        }
+    }
+    // Process text-based ID references → blocks / blocked-by / related
+    for (const [fromId, refs] of idReferences) {
+        const fromEntity = entities.get(fromId);
+        if (!fromEntity)
+            continue;
+        for (const ref of refs) {
+            const toEntity = entities.get(ref.id);
+            if (!toEntity)
+                continue; // Reference to unknown entity — skip
+            // Skip if already linked via source= attribute or dependency
+            if (sourceLinked.has(`${fromId}→${ref.id}`))
+                continue;
+            if (depLinked.has(`${fromId}→${ref.id}`))
+                continue;
+            // Determine relationship kind
+            // If entity A has status "blocked" and references entity B, A is "blocked-by" B
+            const fromStatus = String(fromEntity.data.status ?? '');
+            const isBlockedBy = fromStatus === 'blocked';
+            if (isBlockedBy) {
+                // A is blocked by B
+                addRel(fromId, {
+                    fromId, fromType: fromEntity.type,
+                    toId: ref.id, toType: toEntity.type,
+                    kind: 'blocked-by',
+                });
+                // B blocks A
+                addRel(ref.id, {
+                    fromId: ref.id, fromType: toEntity.type,
+                    toId: fromId, toType: fromEntity.type,
+                    kind: 'blocks',
+                });
+            }
+            else {
+                // General related reference (bidirectional)
+                addRel(fromId, {
+                    fromId, fromType: fromEntity.type,
+                    toId: ref.id, toType: toEntity.type,
+                    kind: 'related',
+                });
+                addRel(ref.id, {
+                    fromId: ref.id, fromType: toEntity.type,
+                    toId: fromId, toType: fromEntity.type,
+                    kind: 'related',
+                });
+            }
+        }
+    }
+    return relationships;
+}
+//# sourceMappingURL=relationships.js.map

package/dist/relationships.js.map

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

package/dist/render.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Edge-safe entity rendering module.
+ *
+ * Renders a single plan entity's Markdoc source to a serialized tree
+ * (RendererNode) that can be identity-transformed by any theme and
+ * rendered to HTML.
+ *
+ * This module has NO Node.js dependencies and runs on Cloudflare Workers.
+ *
+ * Usage:
+ *   import { renderEntity } from '@refrakt-md/plan/render';
+ *   import { identityTransform } from '@refrakt-md/lumina/transform';
+ *   import { renderToHtml } from '@refrakt-md/transform';
+ *
+ *   const tree = renderEntity(source);
+ *   const html = renderToHtml(identityTransform(tree));
+ */
+import type { RendererNode } from '@refrakt-md/transform';
+/**
+ * Render a plan entity's Markdoc source to a serialized tree (RendererNode).
+ *
+ * The returned tree has the same structure as the static plan site produces
+ * before the identity transform — preamble, body sections, meta fields, etc.
+ *
+ * The consumer is responsible for:
+ * 1. Applying the theme's identity transform (e.g. lumina)
+ * 2. Rendering to HTML (e.g. renderToHtml from @refrakt-md/transform)
+ * 3. Any presentation wrapping (tabs, panels, etc.)
+ */
+export declare function renderEntity(source: string): RendererNode;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAuB1D;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAUzD"}

package/dist/render.js

@@ -0,0 +1,57 @@
+/**
+ * Edge-safe entity rendering module.
+ *
+ * Renders a single plan entity's Markdoc source to a serialized tree
+ * (RendererNode) that can be identity-transformed by any theme and
+ * rendered to HTML.
+ *
+ * This module has NO Node.js dependencies and runs on Cloudflare Workers.
+ *
+ * Usage:
+ *   import { renderEntity } from '@refrakt-md/plan/render';
+ *   import { identityTransform } from '@refrakt-md/lumina/transform';
+ *   import { renderToHtml } from '@refrakt-md/transform';
+ *
+ *   const tree = renderEntity(source);
+ *   const html = renderToHtml(identityTransform(tree));
+ */
+import Markdoc from '@markdoc/markdoc';
+import { serializeTree } from '@refrakt-md/runes';
+import { tags as coreTagOverrides, nodes as coreNodes } from '@refrakt-md/runes';
+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';
+// ── Tag Schemas ─────────────────────────────────────────────
+const planTags = {
+    spec,
+    work,
+    task: work,
+    bug,
+    decision,
+    adr: decision,
+    milestone,
+};
+// ── Main API ────────────────────────────────────────────────
+/**
+ * Render a plan entity's Markdoc source to a serialized tree (RendererNode).
+ *
+ * The returned tree has the same structure as the static plan site produces
+ * before the identity transform — preamble, body sections, meta fields, etc.
+ *
+ * The consumer is responsible for:
+ * 1. Applying the theme's identity transform (e.g. lumina)
+ * 2. Rendering to HTML (e.g. renderToHtml from @refrakt-md/transform)
+ * 3. Any presentation wrapping (tabs, panels, etc.)
+ */
+export function renderEntity(source) {
+    const tags = { ...coreTagOverrides, ...planTags };
+    const ast = Markdoc.parse(source);
+    const renderable = Markdoc.transform(ast, {
+        tags,
+        nodes: coreNodes,
+    });
+    return serializeTree(renderable);
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,OAAO,MAAM,kBAAkB,CAAC;AAGvC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,IAAI,IAAI,gBAAgB,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,+DAA+D;AAE/D,MAAM,QAAQ,GAAwB;IACrC,IAAI;IACJ,IAAI;IACJ,IAAI,EAAE,IAAI;IACV,GAAG;IACH,QAAQ;IACR,GAAG,EAAE,QAAQ;IACb,SAAS;CACT,CAAC;AAEF,+DAA+D;AAE/D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IAC1C,MAAM,IAAI,GAAG,EAAE,GAAG,gBAAgB,EAAE,GAAG,QAAQ,EAAE,CAAC;IAElD,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE;QACzC,IAAI;QACJ,KAAK,EAAE,SAAS;KAChB,CAAC,CAAC;IAEH,OAAO,aAAa,CAAC,UAAgC,CAAiB,CAAC;AACxE,CAAC"}

package/dist/scanner-core.d.ts

@@ -0,0 +1,10 @@
+import type { PlanEntity, FileSource } from './types.js';
+/** Parse plan content from a string and return PlanEntity if it contains a plan rune, or null */
+export declare function parseFileContent(source: string, relPath: string): PlanEntity | null;
+/**
+ * Scan plan entities from pre-fetched file contents.
+ * Use this when files come from an external source (e.g. GitHub API)
+ * rather than the local filesystem.
+ */
+export declare function scanPlanSources(sources: FileSource[]): PlanEntity[];
+//# sourceMappingURL=scanner-core.d.ts.map

package/dist/scanner-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner-core.d.ts","sourceRoot":"","sources":["../src/scanner-core.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAkD,UAAU,EAAE,MAAM,YAAY,CAAC;AAuMzG,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA0BnF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAUnE"}

package/dist/scanner-core.js

@@ -0,0 +1,230 @@
+import Markdoc from '@markdoc/markdoc';
+import { escapeFenceTags } from '@refrakt-md/runes';
+const PLAN_RUNE_TYPES = new Set(['spec', 'work', 'bug', 'decision', 'milestone']);
+const REF_TAG_NAMES = new Set(['ref', 'xref']);
+/** Known sections per rune type: canonical name → lowercase aliases */
+const KNOWN_SECTIONS = {
+    work: {
+        'Acceptance Criteria': ['criteria', 'ac', 'done when'],
+        'Dependencies': ['deps', 'depends on', 'blocked by', 'requires'],
+        'Approach': ['technical notes', 'implementation notes', 'how'],
+        'References': ['refs', 'related', 'context'],
+        'Edge Cases': ['exceptions', 'corner cases'],
+        'Verification': ['test cases', 'tests'],
+    },
+    bug: {
+        'Steps to Reproduce': ['reproduction', 'steps', 'repro'],
+        'Expected': ['expected behaviour'],
+        'Actual': ['actual behaviour'],
+        'Environment': ['env'],
+    },
+    decision: {
+        'Context': ['background'],
+        'Options Considered': ['options', 'alternatives'],
+        'Decision': [],
+        'Rationale': ['reasoning'],
+        'Consequences': ['impact', 'trade-offs'],
+    },
+};
+/** Match a heading text to a canonical known section name for a given rune type */
+function matchKnownSection(runeType, headingText) {
+    const sections = KNOWN_SECTIONS[runeType];
+    if (!sections)
+        return undefined;
+    const normalized = headingText.toLowerCase().trim();
+    for (const [canonical, aliases] of Object.entries(sections)) {
+        if (canonical.toLowerCase() === normalized)
+            return canonical;
+        if (aliases.some(a => a === normalized))
+            return canonical;
+    }
+    return undefined;
+}
+/** Walk the AST and collect all nodes matching a predicate */
+function walkNodes(node, predicate) {
+    const results = [];
+    if (predicate(node))
+        results.push(node);
+    if (node.children) {
+        for (const child of node.children) {
+            results.push(...walkNodes(child, predicate));
+        }
+    }
+    return results;
+}
+/** Extract the title from the first H1 heading's text content */
+function extractTitle(ast) {
+    const headings = walkNodes(ast, n => n.type === 'heading' && n.attributes.level === 1);
+    if (headings.length === 0)
+        return undefined;
+    const texts = [];
+    walkNodes(headings[0], n => {
+        if (n.type === 'text' && n.attributes.content) {
+            texts.push(n.attributes.content);
+        }
+        return false;
+    });
+    return texts.join('').trim() || undefined;
+}
+/** Extract acceptance criteria checkboxes from the raw source lines within a plan rune */
+function extractCriteria(source, runeStartLine, runeEndLine) {
+    const lines = source.split('\n');
+    const criteria = [];
+    for (let i = runeStartLine; i < runeEndLine && i < lines.length; i++) {
+        const match = lines[i].match(/^[\s]*-\s+\[([ xX])\]\s+(.+)/);
+        if (match) {
+            criteria.push({
+                text: match[2].trim(),
+                checked: match[1] !== ' ',
+            });
+        }
+    }
+    return criteria;
+}
+/** Extract the Resolution section from the raw source within the rune's line range */
+function extractResolution(source, runeStartLine, runeEndLine) {
+    const lines = source.split('\n');
+    // Find the first ## Resolution heading within the rune range
+    let resolutionStart = -1;
+    for (let i = runeStartLine; i < runeEndLine && i < lines.length; i++) {
+        if (/^##\s+Resolution\s*$/.test(lines[i])) {
+            resolutionStart = i;
+            break;
+        }
+    }
+    if (resolutionStart === -1)
+        return undefined;
+    // Collect all lines from after the heading to the end of the rune (or next ## heading)
+    const contentLines = [];
+    for (let i = resolutionStart + 1; i < runeEndLine && i < lines.length; i++) {
+        // Stop at the next H2 heading (but not H3+)
+        if (/^##\s+[^#]/.test(lines[i]))
+            break;
+        contentLines.push(lines[i]);
+    }
+    const content = contentLines.join('\n').trim();
+    // Parse metadata lines
+    let date;
+    let branch;
+    let pr;
+    const bodyLines = [];
+    for (const line of contentLines) {
+        const dateMatch = line.match(/^Completed:\s*(.+)$/);
+        if (dateMatch) {
+            date = dateMatch[1].trim();
+            continue;
+        }
+        const branchMatch = line.match(/^Branch:\s*(.+)$/);
+        if (branchMatch) {
+            branch = branchMatch[1].trim().replace(/^`|`$/g, '');
+            continue;
+        }
+        const prMatch = line.match(/^PR:\s*(.+)$/);
+        if (prMatch) {
+            pr = prMatch[1].trim();
+            continue;
+        }
+        bodyLines.push(line);
+    }
+    const body = bodyLines.join('\n').trim();
+    return { date, branch, pr, body };
+}
+/** Extract all referenced entity IDs from ref/xref tag nodes in the AST */
+function extractRefs(ast) {
+    const refNodes = walkNodes(ast, n => n.type === 'tag' && REF_TAG_NAMES.has(n.tag));
+    const ids = [];
+    for (const node of refNodes) {
+        const primary = node.attributes.primary;
+        if (primary)
+            ids.push(primary);
+    }
+    // Deduplicate while preserving order
+    return [...new Set(ids)];
+}
+/** Extract heading text from an AST heading node */
+function extractHeadingText(node) {
+    const texts = [];
+    walkNodes(node, n => {
+        if (n.type === 'text' && n.attributes.content) {
+            texts.push(n.attributes.content);
+        }
+        return false;
+    });
+    return texts.join('').trim();
+}
+/**
+ * Extract section-scoped refs and known section presence from the AST.
+ * Walks the plan tag's children, tracking which H2 section each ref falls in.
+ */
+function extractScopedRefs(planTag, runeType) {
+    const scopedRefs = [];
+    const knownSectionsPresent = [];
+    let currentSection;
+    for (const child of planTag.children ?? []) {
+        if (child.type === 'heading' && child.attributes?.level === 2) {
+            const headingText = extractHeadingText(child);
+            const canonical = matchKnownSection(runeType, headingText);
+            currentSection = canonical;
+            if (canonical && !knownSectionsPresent.includes(canonical)) {
+                knownSectionsPresent.push(canonical);
+            }
+        }
+        // Find refs in this node (including deeply nested ones)
+        const refNodes = walkNodes(child, n => n.type === 'tag' && REF_TAG_NAMES.has(n.tag));
+        for (const refNode of refNodes) {
+            const id = refNode.attributes.primary;
+            if (id) {
+                scopedRefs.push({ id, section: currentSection });
+            }
+        }
+    }
+    // Deduplicate scopedRefs by id+section
+    const seen = new Set();
+    const deduped = [];
+    for (const ref of scopedRefs) {
+        const key = `${ref.id}:${ref.section ?? ''}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            deduped.push(ref);
+        }
+    }
+    return { scopedRefs: deduped, knownSectionsPresent };
+}
+/** Parse plan content from a string and return PlanEntity if it contains a plan rune, or null */
+export function parseFileContent(source, relPath) {
+    const ast = Markdoc.parse(escapeFenceTags(source));
+    // Find the first plan rune tag at the top level
+    const planTag = ast.children.find((n) => n.type === 'tag' && PLAN_RUNE_TYPES.has(n.tag));
+    if (!planTag)
+        return null;
+    const runeType = planTag.tag;
+    const attributes = {};
+    for (const [key, value] of Object.entries(planTag.attributes)) {
+        attributes[key] = String(value);
+    }
+    const title = extractTitle(planTag);
+    const startLine = planTag.lines?.[0] ?? 0;
+    const endLine = planTag.lines?.[planTag.lines.length - 1] ?? source.split('\n').length;
+    const criteria = extractCriteria(source, startLine, endLine);
+    const refs = extractRefs(planTag);
+    const { scopedRefs, knownSectionsPresent } = extractScopedRefs(planTag, runeType);
+    const resolution = extractResolution(source, startLine, endLine);
+    return { file: relPath, type: runeType, attributes, title, criteria, refs, scopedRefs, knownSectionsPresent, resolution };
+}
+/**
+ * Scan plan entities from pre-fetched file contents.
+ * Use this when files come from an external source (e.g. GitHub API)
+ * rather than the local filesystem.
+ */
+export function scanPlanSources(sources) {
+    const entities = [];
+    for (const source of sources) {
+        const entity = parseFileContent(source.content, source.path);
+        if (entity) {
+            entity.mtime = source.mtime;
+            entities.push(entity);
+        }
+    }
+    return entities;
+}
+//# sourceMappingURL=scanner-core.js.map

package/dist/scanner-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner-core.js","sourceRoot":"","sources":["../src/scanner-core.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AAC1F,MAAM,aAAa,GAAG,IAAI,GAAG,CAAS,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvD,uEAAuE;AACvE,MAAM,cAAc,GAA6C;IAChE,IAAI,EAAE;QACL,qBAAqB,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,WAAW,CAAC;QACtD,cAAc,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,CAAC;QAChE,UAAU,EAAE,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,KAAK,CAAC;QAC9D,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;QAC5C,YAAY,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC;QAC5C,cAAc,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC;KACvC;IACD,GAAG,EAAE;QACJ,oBAAoB,EAAE,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC;QACxD,UAAU,EAAE,CAAC,oBAAoB,CAAC;QAClC,QAAQ,EAAE,CAAC,kBAAkB,CAAC;QAC9B,aAAa,EAAE,CAAC,KAAK,CAAC;KACtB;IACD,QAAQ,EAAE;QACT,SAAS,EAAE,CAAC,YAAY,CAAC;QACzB,oBAAoB,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC;QACjD,UAAU,EAAE,EAAE;QACd,WAAW,EAAE,CAAC,WAAW,CAAC;QAC1B,cAAc,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC;KACxC;CACD,CAAC;AAEF,mFAAmF;AACnF,SAAS,iBAAiB,CAAC,QAAgB,EAAE,WAAmB;IAC/D,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IACpD,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7D,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,UAAU;YAAE,OAAO,SAAS,CAAC;QAC7D,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC;YAAE,OAAO,SAAS,CAAC;IAC3D,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,8DAA8D;AAC9D,SAAS,SAAS,CAAC,IAAU,EAAE,SAA+B;IAC7D,MAAM,OAAO,GAAW,EAAE,CAAC;IAC3B,IAAI,SAAS,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;QAC9C,CAAC;IACF,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,iEAAiE;AACjE,SAAS,YAAY,CAAC,GAAS;IAC9B,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC;IACvF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QAC1B,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAiB,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;AAC3C,CAAC;AAED,0FAA0F;AAC1F,SAAS,eAAe,CAAC,MAAc,EAAE,aAAqB,EAAE,WAAmB;IAClF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAgB,EAAE,CAAC;IACjC,KAAK,IAAI,CAAC,GAAG,aAAa,EAAE,CAAC,GAAG,WAAW,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtE,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC7D,IAAI,KAAK,EAAE,CAAC;YACX,QAAQ,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;gBACrB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;aACzB,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,sFAAsF;AACtF,SAAS,iBAAiB,CAAC,MAAc,EAAE,aAAqB,EAAE,WAAmB;IACpF,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,6DAA6D;IAC7D,IAAI,eAAe,GAAG,CAAC,CAAC,CAAC;IACzB,KAAK,IAAI,CAAC,GAAG,aAAa,EAAE,CAAC,GAAG,WAAW,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtE,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,eAAe,GAAG,CAAC,CAAC;YACpB,MAAM;QACP,CAAC;IACF,CAAC;IACD,IAAI,eAAe,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAE7C,uFAAuF;IACvF,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,IAAI,CAAC,GAAG,eAAe,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5E,4CAA4C;QAC5C,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,MAAM;QACvC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAE/C,uBAAuB;IACvB,IAAI,IAAwB,CAAC;IAC7B,IAAI,MAA0B,CAAC;IAC/B,IAAI,EAAsB,CAAC;IAC3B,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACpD,IAAI,SAAS,EAAE,CAAC;YAAC,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QAExD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACnD,IAAI,WAAW,EAAE,CAAC;YAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QAEpF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC3C,IAAI,OAAO,EAAE,CAAC;YAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAAC,SAAS;QAAC,CAAC;QAElD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACnC,CAAC;AAED,2EAA2E;AAC3E,SAAS,WAAW,CAAC,GAAS;IAC7B,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,GAAa,CAAC,CAAC,CAAC;IAC7F,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,OAA6B,CAAC;QAC9D,IAAI,OAAO;YAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,qCAAqC;IACrC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1B,CAAC;AAED,oDAAoD;AACpD,SAAS,kBAAkB,CAAC,IAAU;IACrC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE;QACnB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAiB,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,OAAa,EAAE,QAAgB;IACzD,MAAM,UAAU,GAAgB,EAAE,CAAC;IACnC,MAAM,oBAAoB,GAAa,EAAE,CAAC;IAC1C,IAAI,cAAkC,CAAC;IAEvC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;YAC/D,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;YAC3D,cAAc,GAAG,SAAS,CAAC;YAC3B,IAAI,SAAS,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC5D,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtC,CAAC;QACF,CAAC;QAED,wDAAwD;QACxD,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,GAAa,CAAC,CAAC,CAAC;QAC/F,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAChC,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,OAA6B,CAAC;YAC5D,IAAI,EAAE,EAAE,CAAC;gBACR,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;YAClD,CAAC;QACF,CAAC;IACF,CAAC;IAED,uCAAuC;IACvC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC7C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACF,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;AACtD,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,OAAe;IAC/D,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAEnD,gDAAgD;IAChD,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAChC,CAAC,CAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,GAAa,CAAC,CACrE,CAAC;IACF,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAmB,CAAC;IAC7C,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/D,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IACvF,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAE7D,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,UAAU,EAAE,oBAAoB,EAAE,GAAG,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClF,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAEjE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,oBAAoB,EAAE,UAAU,EAAE,CAAC;AAC3H,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAqB;IACpD,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,MAAM,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACF,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/scanner.d.ts

@@ -1,6 +1,5 @@
-import type { PlanEntity, ScanOptions, FileSource } from './types.js';
-/** Parse plan content from a string and return PlanEntity if it contains a plan rune, or null */
-export declare function parseFileContent(source: string, relPath: string): PlanEntity | null;
+import type { PlanEntity, ScanOptions } from './types.js';
+export { parseFileContent, scanPlanSources } from './scanner-core.js';
 /** Parse a single file from disk and return PlanEntity if it contains a plan rune, or null */
 export declare function parseFile(filePath: string, relPath: string): PlanEntity | null;
 /**
@@ -8,10 +7,4 @@ export declare function parseFile(filePath: string, relPath: string): PlanEntity
  * Returns typed PlanEntity objects for each discovered entity.
  */
 export declare function scanPlanFiles(dir: string, options?: ScanOptions): PlanEntity[];
-/**
- * Scan plan entities from pre-fetched file contents.
- * Use this when files come from an external source (e.g. GitHub API)
- * rather than the local filesystem.
- */
-export declare function scanPlanSources(sources: FileSource[]): PlanEntity[];
 //# sourceMappingURL=scanner.d.ts.map

package/dist/scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAA6E,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAuNjJ,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA0BnF;AAED,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAG9E;AAmCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,UAAU,EAAE,CAyClF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAUnE"}
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../src/scanner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAa,WAAW,EAAE,MAAM,YAAY,CAAC;AAIrE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAmBtE,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAG9E;AAmCD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,UAAU,EAAE,CA0ClF"}