@crossworks/content-core 0.232.57 → 0.232.58

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossworks/content-core",
-  "version": "0.232.57",
+  "version": "0.232.58",
   "description": "Browser-safe content logic — markdown, blocks, pages, tables, formulas — shared by the server and any client. Zero server deps by design: nothing here may reach @mantle/db, node-only APIs, or the network (the jackdaw-repo-split P0 boundary).",
   "exports": {
     "./markdown": "./src/markdown-to-doc.ts",

package/src/recall-compile.test.ts

@@ -5,6 +5,7 @@ import {
   RECALL_BODY_CHAR_BUDGET,
   assignRecallSlugs,
   parseRecallDoc,
+  recallOptionsMarkdown,
   recallSlug,
 } from './recall-compile';
 
@@ -152,3 +153,33 @@ describe('audit regressions', () => {
     ]);
   });
 });
+
+describe('recallOptionsMarkdown', () => {
+  const OPTIONS = [
+    { label: 'Fleet access', targetPageId: 'aaa-fleet', useWhen: 'use when logging into a box' },
+    { label: 'Architecture', targetPageId: 'bbb-arch', useWhen: 'use when asking why' },
+  ];
+
+  it('round-trips through markdownToDoc + parseRecallDoc unchanged', () => {
+    const md = `Body text.\n\n${recallOptionsMarkdown(OPTIONS)}`;
+    const parsed = parseRecallDoc(markdownToDoc(md));
+    expect(parsed.issues).toEqual([]);
+    expect(parsed.options).toEqual(OPTIONS);
+    expect(parsed.bodyMarkdown).toBe('Body text.');
+  });
+
+  it('emits nothing for an empty list (a node with no options has no section)', () => {
+    expect(recallOptionsMarkdown([])).toBe('');
+  });
+
+  it('normalizes whitespace and strips brackets that would break the link syntax', () => {
+    const md = `Body.\n\n${recallOptionsMarkdown([
+      { label: '  Fleet\n[access]  ', targetPageId: ' aaa ', useWhen: 'use  when\nlogging in' },
+    ])}`;
+    const parsed = parseRecallDoc(markdownToDoc(md));
+    expect(parsed.issues).toEqual([]);
+    expect(parsed.options).toEqual([
+      { label: 'Fleet access', targetPageId: 'aaa', useWhen: 'use when logging in' },
+    ]);
+  });
+});

package/src/recall-compile.ts

@@ -275,6 +275,25 @@ export function parseRecallDoc(
   return { bodyMarkdown, useWhen, options, issues };
 }
 
+/**
+ * The ONE writer for a node's `## Options` section. Every author path — the
+ * owner UI's routing editor and the agent-side authoring tools — must emit
+ * options through this, so human-authored and agent-authored options are
+ * byte-identical and always round-trip through `parseRecallDoc`. Compose a
+ * full body as `bodyMarkdown + '\n\n' + recallOptionsMarkdown(options)`.
+ */
+export function recallOptionsMarkdown(
+  options: { label: string; targetPageId: string; useWhen: string }[],
+): string {
+  if (options.length === 0) return '';
+  const line = (v: string) => v.replace(/\s+/g, ' ').trim();
+  const items = options.map((o) => {
+    const label = line(o.label).replace(/[[\]]/g, '') || 'Untitled';
+    return `- [${label}](page:${o.targetPageId.trim()}) — ${line(o.useWhen)}`;
+  });
+  return `## Options\n\n${items.join('\n')}\n`;
+}
+
 /** Kebab-case a title into a stable slug ('Fleet, access & MCP' → 'fleet-access-mcp'). */
 export function recallSlug(title: string): string {
   const slug = title