@refrakt-md/ai 0.21.0 → 0.23.0

package/dist/modes/write.d.ts

@@ -1,5 +1,14 @@
 export interface WritePromptOptions {
     multiFile?: boolean;
 }
+/**
+ * Few-shot exemplars drawn from the standardised fixture corpus (SPEC-102 /
+ * WORK-413). Only fixtures whose frontmatter explicitly tags a `canonical` /
+ * `rich` role are included — an explicit role is the author's opt-in that a
+ * fixture is a good example to learn from. Each block carries the fixture's
+ * `notes` (authoring guidance) when present. Replaces the old hardcoded example
+ * snippet; grows automatically as the corpus is annotated.
+ */
+export declare function exemplarSection(): string;
 export declare function writePrompt(options?: WritePromptOptions): string;
 //# sourceMappingURL=write.d.ts.map

package/dist/modes/write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/modes/write.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAYD,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CA+ChE"}
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/modes/write.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,kBAAkB;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAeD;;;;;;;GAOG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAqBxC;AAED,wBAAgB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,MAAM,CA2ChE"}

package/dist/modes/write.js

@@ -1,3 +1,4 @@
+import { RUNE_EXAMPLES, RUNE_FIXTURE_META } from '@refrakt-md/runes';
 const FRONTMATTER_INSTRUCTION = `
 
 ## File format
@@ -7,9 +8,40 @@ Every page should begin with YAML frontmatter:
 title: Page Title
 description: A brief description
 ---`;
+/** Fixture roles that opt a rune into the few-shot exemplar set. */
+const EXEMPLAR_ROLES = new Set(['canonical', 'rich']);
+/**
+ * Few-shot exemplars drawn from the standardised fixture corpus (SPEC-102 /
+ * WORK-413). Only fixtures whose frontmatter explicitly tags a `canonical` /
+ * `rich` role are included — an explicit role is the author's opt-in that a
+ * fixture is a good example to learn from. Each block carries the fixture's
+ * `notes` (authoring guidance) when present. Replaces the old hardcoded example
+ * snippet; grows automatically as the corpus is annotated.
+ */
+export function exemplarSection() {
+    const exemplars = Object.entries(RUNE_FIXTURE_META)
+        .filter(([name, meta]) => meta.role && EXEMPLAR_ROLES.has(meta.role) && RUNE_EXAMPLES[name])
+        .sort(([a], [b]) => a.localeCompare(b));
+    if (exemplars.length === 0)
+        return '';
+    const blocks = exemplars.map(([name, meta]) => {
+        const notes = meta.notes ? `\n${meta.notes}\n` : '';
+        return `### ${name}${notes}\n\`\`\`md\n${RUNE_EXAMPLES[name]}\n\`\`\``;
+    });
+    return `
+
+## Example patterns
+
+These are canonical, validated examples of well-formed runes. Study their
+structure and match this quality — emulate the shape, don't copy the literal
+content.
+
+${blocks.join('\n\n')}`;
+}
 export function writePrompt(options) {
+    const exemplars = exemplarSection();
     if (!options?.multiFile) {
-        return FRONTMATTER_INSTRUCTION;
+        return FRONTMATTER_INSTRUCTION + exemplars;
     }
     return FRONTMATTER_INSTRUCTION + `
 
@@ -27,7 +59,8 @@ Rules:
 - Use directory nesting for logical sections (e.g. \`docs/\`, \`blog/\`).
 - Do NOT use \`../\` in file paths.
 
-Example structure:
+The marker structure looks like this (compose the page bodies from the rune
+patterns shown below):
 
 --- FILE: _layout.md ---
 ---
@@ -41,17 +74,10 @@ title: Home
 description: Welcome to the site
 ---
 
-{% hero %}
-# Welcome
-...
-{% /hero %}
-
 --- FILE: docs/getting-started.md ---
 ---
 title: Getting Started
 description: Learn the basics
----
-
-Content here...`;
+---` + exemplars;
 }
 //# sourceMappingURL=write.js.map

package/dist/modes/write.js.map

@@ -1 +1 @@
-{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/modes/write.ts"],"names":[],"mappings":"AAIA,MAAM,uBAAuB,GAAG;;;;;;;;IAQ5B,CAAC;AAEL,MAAM,UAAU,WAAW,CAAC,OAA4B;IACvD,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QACzB,OAAO,uBAAuB,CAAC;IAChC,CAAC;IAED,OAAO,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAyClB,CAAC;AACjB,CAAC"}
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/modes/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAMrE,MAAM,uBAAuB,GAAG;;;;;;;;IAQ5B,CAAC;AAEL,oEAAoE;AACpE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe;IAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC;SACjD,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;SAC3F,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,OAAO,IAAI,GAAG,KAAK,eAAe,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,OAAO;;;;;;;;EAQN,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAA4B;IACvD,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IAEpC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QACzB,OAAO,uBAAuB,GAAG,SAAS,CAAC;IAC5C,CAAC;IAED,OAAO,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmC9B,GAAG,SAAS,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@refrakt-md/ai",
   "description": "AI content generation for refrakt.md",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -29,6 +29,6 @@
     "build": "tsc"
   },
   "devDependencies": {
-    "@refrakt-md/runes": "0.21.0"
+    "@refrakt-md/runes": "0.23.0"
   }
 }