@refrakt-md/plan 0.9.5 → 0.9.7

package/dist/tags/work.js

@@ -2,7 +2,7 @@ import Markdoc from '@markdoc/markdoc';
 const { Tag } = Markdoc;
 import { createContentModelSchema, createComponentRenderable, asNodes, RenderableNodeCursor } from '@refrakt-md/runes';
 import { buildSections } from '../util.js';
-const statusValues = ['draft', 'ready', 'in-progress', 'review', 'done', 'blocked'];
+const statusValues = ['draft', 'ready', 'in-progress', 'review', 'done', 'blocked', 'pending'];
 const priorityValues = ['critical', 'high', 'medium', 'low'];
 const complexityValues = ['trivial', 'simple', 'moderate', 'complex', 'unknown'];
 export const work = createContentModelSchema({
@@ -13,6 +13,7 @@ export const work = createContentModelSchema({
         complexity: { type: String, required: false, matches: complexityValues.slice(), description: 'Complexity signal: trivial, simple, moderate, complex, or unknown.' },
         assignee: { type: String, required: false, description: 'Person or agent working on this.' },
         milestone: { type: String, required: false, description: 'Milestone this belongs to.' },
+        source: { type: String, required: false, description: 'Comma-separated IDs of specs or decisions this item implements.' },
         tags: { type: String, required: false, description: 'Comma-separated labels.' },
         created: { type: String, required: false, description: 'Creation date (ISO 8601). Defaults to file creation date from git.' },
         modified: { type: String, required: false, description: 'Last modified date (ISO 8601). Defaults to file modification date from git.' },
@@ -28,6 +29,26 @@ export const work = createContentModelSchema({
             type: 'sequence',
             fields: [{ name: 'body', match: 'any', optional: true, greedy: true }],
         },
+        knownSections: {
+            'Acceptance Criteria': {
+                alias: ['Criteria', 'AC', 'Done When'],
+            },
+            'Dependencies': {
+                alias: ['Deps', 'Depends On', 'Blocked By', 'Requires'],
+            },
+            'Approach': {
+                alias: ['Technical Notes', 'Implementation Notes', 'How'],
+            },
+            'References': {
+                alias: ['Refs', 'Related', 'Context'],
+            },
+            'Edge Cases': {
+                alias: ['Exceptions', 'Corner Cases'],
+            },
+            'Verification': {
+                alias: ['Test Cases', 'Tests'],
+            },
+        },
     }),
     transform(resolved, attrs, config) {
         const titleNodes = new RenderableNodeCursor(Markdoc.transform(asNodes(resolved.title), config));
@@ -38,17 +59,15 @@ export const work = createContentModelSchema({
         const complexityMeta = new Tag('meta', { content: attrs.complexity ?? 'unknown' });
         const assigneeMeta = new Tag('meta', { content: attrs.assignee ?? '' });
         const milestoneMeta = new Tag('meta', { content: attrs.milestone ?? '' });
+        const sourceMeta = new Tag('meta', { content: attrs.source ?? '' });
         const tagsMeta = new Tag('meta', { content: attrs.tags ?? '' });
         const fileVars = config.variables?.file;
         const createdMeta = new Tag('meta', { content: attrs.created || fileVars?.created || '' });
         const modifiedMeta = new Tag('meta', { content: attrs.modified || fileVars?.modified || '' });
         const title = titleNodes.wrap('header');
-        const contentChildren = [];
-        if (descNodes.count() > 0) {
-            contentChildren.push(descNodes.wrap('div').next());
-        }
+        const blurb = descNodes.count() > 0 ? descNodes.wrap('div').next() : undefined;
         const sections = resolved.sections;
-        contentChildren.push(...buildSections(sections, config));
+        const contentChildren = buildSections(sections, config);
         const bodyDiv = new Tag('div', {}, contentChildren);
         return createComponentRenderable({ rune: 'work',
             tag: 'article',
@@ -59,15 +78,17 @@ export const work = createContentModelSchema({
                 complexity: complexityMeta,
                 assignee: assigneeMeta,
                 milestone: milestoneMeta,
+                source: sourceMeta,
                 tags: tagsMeta,
                 created: createdMeta,
                 modified: modifiedMeta,
             },
             refs: {
                 title: title.tag('header'),
+                blurb,
                 body: bodyDiv,
             },
-            children: [idMeta, statusMeta, priorityMeta, complexityMeta, assigneeMeta, milestoneMeta, tagsMeta, createdMeta, modifiedMeta, title.next(), bodyDiv],
+            children: [idMeta, statusMeta, priorityMeta, complexityMeta, assigneeMeta, milestoneMeta, sourceMeta, tagsMeta, createdMeta, modifiedMeta, title.next(), ...(blurb ? [blurb] : []), bodyDiv],
         });
     },
 });

package/dist/tags/work.js.map

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

package/dist/types.d.ts

@@ -13,6 +13,13 @@ export interface Resolution {
     /** Full resolution section content (excluding parsed metadata lines) */
     body: string;
 }
+/** A ref tag scoped to the section it appears in */
+export interface ScopedRef {
+    /** The referenced entity ID */
+    id: string;
+    /** The canonical section name this ref appears in, or undefined if not in a known section */
+    section?: string;
+}
 export interface PlanEntity {
     /** File path relative to the scan directory */
     file: string;
@@ -26,11 +33,24 @@ export interface PlanEntity {
     criteria: Criterion[];
     /** Referenced entity IDs extracted from {% ref %} / {% xref %} tags */
     refs: string[];
+    /** Section-scoped refs (refs tagged with the section they appear in) */
+    scopedRefs: ScopedRef[];
+    /** Canonical names of known sections present in this entity */
+    knownSectionsPresent: string[];
     /** Parsed resolution section, if present */
     resolution?: Resolution;
     /** File modification time (ms since epoch) */
     mtime?: number;
 }
+/** A file provided as content rather than read from disk — for use with scanPlanSources() */
+export interface FileSource {
+    /** Relative path (e.g. "work/WORK-042.md") */
+    path: string;
+    /** Full file content */
+    content: string;
+    /** Optional modification time in ms since epoch (e.g. from a git commit timestamp) */
+    mtime?: number;
+}
 export interface ScanCacheEntry {
     /** File modification time (ms since epoch) */
     mtime: number;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,CAAC;AAE9E,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IAC1B,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IAC1B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,YAAY,CAAC;IACnB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,gDAAgD;IAChD,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,uEAAuE;IACvE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4CAA4C;IAC5C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC9B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,MAAM,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACzB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC3B,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,WAAW,CAAC;AAE9E,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IAC1B,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;CACb;AAED,oDAAoD;AACpD,MAAM,WAAW,SAAS;IACzB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IAC1B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,IAAI,EAAE,YAAY,CAAC;IACnB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,gDAAgD;IAChD,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,uEAAuE;IACvE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,wEAAwE;IACxE,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,+DAA+D;IAC/D,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,6FAA6F;AAC7F,MAAM,WAAW,UAAU;IAC1B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC9B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,MAAM,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACzB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC3B,sDAAsD;IACtD,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB"}

package/dist/util.d.ts

@@ -3,6 +3,8 @@ export declare function slugify(text: string): string;
 /**
  * Build section wrapper elements from resolved sections.
  * Each section becomes a `<section>` with `data-name` set to the slugified heading text.
+ * Known sections (matched via `$canonicalName`) get `data-known-section` on the heading
+ * so the layout TOC and mobile section nav can filter to just these sections.
  */
 export declare function buildSections(sections: any[], config: any): any[];
 //# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAKA,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,EAAE,CAmBjE"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAKA,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,EAAE,CA2BjE"}

package/dist/util.js

@@ -11,6 +11,8 @@ export function slugify(text) {
 /**
  * Build section wrapper elements from resolved sections.
  * Each section becomes a `<section>` with `data-name` set to the slugified heading text.
+ * Known sections (matched via `$canonicalName`) get `data-known-section` on the heading
+ * so the layout TOC and mobile section nav can filter to just these sections.
  */
 export function buildSections(sections, config) {
     if (!sections || sections.length === 0)
@@ -18,11 +20,19 @@ export function buildSections(sections, config) {
     return sections.map((section) => {
         const headingText = section.$heading;
         const slug = slugify(headingText);
+        const canonicalName = section.$canonicalName;
         const headingNode = section.$headingNode;
         const bodyContent = Markdoc.transform(asNodes(section.body), config);
         const children = [];
         if (headingNode) {
             const renderedHeading = Markdoc.transform([headingNode], config);
+            // Mark known-section headings with data-known-section attribute
+            if (canonicalName && renderedHeading.length > 0) {
+                const heading = renderedHeading[0];
+                if (heading instanceof Tag) {
+                    heading.attributes['data-known-section'] = canonicalName;
+                }
+            }
             children.push(...renderedHeading);
         }
         children.push(...bodyContent);

package/dist/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AAEvC,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,2DAA2D;AAC3D,MAAM,UAAU,OAAO,CAAC,IAAY;IACnC,OAAO,IAAI;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAe,EAAE,MAAW;IACzD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAY,EAAE,EAAE;QACpC,MAAM,WAAW,GAAG,OAAO,CAAC,QAAkB,CAAC;QAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QAElC,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAyB,CAAC;QAE7F,MAAM,QAAQ,GAAU,EAAE,CAAC;QAC3B,IAAI,WAAW,EAAE,CAAC;YACjB,MAAM,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,EAAE,MAAM,CAAyB,CAAC;YACzF,QAAQ,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;QAE9B,OAAO,IAAI,GAAG,CAAC,SAAS,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AAEvC,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,2DAA2D;AAC3D,MAAM,UAAU,OAAO,CAAC,IAAY;IACnC,OAAO,IAAI;SACT,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAe,EAAE,MAAW;IACzD,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAElD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAY,EAAE,EAAE;QACpC,MAAM,WAAW,GAAG,OAAO,CAAC,QAAkB,CAAC;QAC/C,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QAClC,MAAM,aAAa,GAAG,OAAO,CAAC,cAAoC,CAAC;QAEnE,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;QACzC,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,CAAyB,CAAC;QAE7F,MAAM,QAAQ,GAAU,EAAE,CAAC;QAC3B,IAAI,WAAW,EAAE,CAAC;YACjB,MAAM,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,EAAE,MAAM,CAAyB,CAAC;YACzF,gEAAgE;YAChE,IAAI,aAAa,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjD,MAAM,OAAO,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;gBACnC,IAAI,OAAO,YAAY,GAAG,EAAE,CAAC;oBAC5B,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,GAAG,aAAa,CAAC;gBAC1D,CAAC;YACF,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;QACnC,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;QAE9B,OAAO,IAAI,GAAG,CAAC,SAAS,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@refrakt-md/plan",
   "description": "Planning runes for refrakt.md — specs, work items, bugs, decisions, and milestones",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -26,6 +26,22 @@
     "./scanner": {
       "types": "./dist/scanner.d.ts",
       "default": "./dist/scanner.js"
+    },
+    "./diff": {
+      "types": "./dist/diff.d.ts",
+      "default": "./dist/diff.js"
+    },
+    "./filter": {
+      "types": "./dist/filter.d.ts",
+      "default": "./dist/filter.js"
+    },
+    "./relationships": {
+      "types": "./dist/relationships.d.ts",
+      "default": "./dist/relationships.js"
+    },
+    "./cards": {
+      "types": "./dist/cards.d.ts",
+      "default": "./dist/cards.js"
     }
   },
   "files": [
@@ -37,16 +53,17 @@
   },
   "dependencies": {
     "@markdoc/markdoc": "0.4.0",
-    "@refrakt-md/behaviors": "0.9.5",
-    "@refrakt-md/content": "0.9.5",
-    "@refrakt-md/highlight": "0.9.5",
-    "@refrakt-md/html": "0.9.5",
-    "@refrakt-md/runes": "0.9.5",
-    "@refrakt-md/transform": "0.9.5",
-    "@refrakt-md/types": "0.9.5",
+    "@refrakt-md/behaviors": "0.9.7",
+    "@refrakt-md/content": "0.9.7",
+    "@refrakt-md/highlight": "0.9.7",
+    "@refrakt-md/html": "0.9.7",
+    "@refrakt-md/runes": "0.9.7",
+    "@refrakt-md/transform": "0.9.7",
+    "@refrakt-md/types": "0.9.7",
     "reflect-metadata": "^0.2.0"
   },
   "devDependencies": {
-    "esbuild": "^0.27.4"
+    "esbuild": "^0.27.4",
+    "pagefind": "^1.3.0"
   }
 }