@agentshouse/mdmodel 0.1.0-alpha.8 → 0.1.0-c68e2039f1ca8

package/fixtures/division.json

@@ -0,0 +1,409 @@
+{
+  "schema": "task:\n  type: object\n  properties:\n    name: { type: string }\n    status: { enum: [open, done] }\n  required: [status]\n  sections:\n    Description: { kind: text, required: true }\n    Acceptance: { kind: list, items: { type: string, reference: person } }\nperson: {}\n",
+  "cases": [
+    {
+      "name": "a Document whose whole input fits the budget is one Span carrying its projection",
+      "file": "tasks/one.md",
+      "source": "---\ntype: task\nname: Ship the release\nstatus: open\n---\n\nPreamble prose.\n\n## Description\n\nBody of the description.\n\n## Acceptance\n\n- people/ana.md\n",
+      "documentTargets": [],
+      "definition": "task",
+      "budget": 4096,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "Ship the release\n\n\nPreamble prose.\n\n## Description\n\nBody of the description.\n\n",
+            "source": "Ship the release\nstatus: open\n---\n\nPreamble prose.\n\n## Description\n\nBody of the description.\n\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "an input over the budget descends to whole heading nodes and packs adjacent siblings",
+      "file": "tasks/one.md",
+      "source": "---\ntype: task\nname: Ship the release\nstatus: open\n---\n\nPreamble prose.\n\n## Description\n\nBody of the description.\n\n## Notes\n\nNotes prose.\n\n## Acceptance\n\n- people/ana.md\n",
+      "documentTargets": [],
+      "definition": "task",
+      "budget": 45,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "Ship the release\n\n\nPreamble prose.\n\n",
+            "source": "Ship the release\nstatus: open\n---\n\nPreamble prose.\n\n"
+          },
+          {
+            "text": "## Description\n\nBody of the description.\n\n",
+            "source": "## Description\n\nBody of the description.\n\n"
+          },
+          {
+            "text": "## Notes\n\nNotes prose.\n\n",
+            "source": "## Notes\n\nNotes prose.\n\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "a heading node over the budget divides into adjacent blocks carrying its own heading",
+      "file": "tasks/one.md",
+      "source": "---\ntype: task\nname: Task\nstatus: open\n---\n\n## Overview\n\nFirst paragraph of the overview.\n\nSecond paragraph of the overview.\n\n## Notes\n\nShort note.\n",
+      "documentTargets": [],
+      "definition": "task",
+      "budget": 50,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "Task\n\n\n",
+            "source": "Task\nstatus: open\n---\n\n"
+          },
+          {
+            "text": "## Overview\n\nFirst paragraph of the overview.\n\n",
+            "source": "## Overview\n\nFirst paragraph of the overview.\n\n"
+          },
+          {
+            "text": "## Overview\n\nSecond paragraph of the overview.\n\n",
+            "source": "Second paragraph of the overview.\n\n"
+          },
+          {
+            "text": "## Notes\n\nShort note.\n",
+            "source": "## Notes\n\nShort note.\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "a node continuation and the next whole sibling stay in their own Spans",
+      "file": "tasks/one.md",
+      "source": "---\ntype: task\nname: Task\nstatus: open\n---\n\n## Overview\n\nFirst paragraph of the overview.\n\nSecond paragraph of the overview.\n\n## Notes\n\nShort note.\n",
+      "documentTargets": [],
+      "definition": "task",
+      "budget": 75,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "Task\n\n\n",
+            "source": "Task\nstatus: open\n---\n\n"
+          },
+          {
+            "text": "## Overview\n\nFirst paragraph of the overview.\n\n",
+            "source": "## Overview\n\nFirst paragraph of the overview.\n\n"
+          },
+          {
+            "text": "## Overview\n\nSecond paragraph of the overview.\n\n",
+            "source": "Second paragraph of the overview.\n\n"
+          },
+          {
+            "text": "## Notes\n\nShort note.\n",
+            "source": "## Notes\n\nShort note.\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "a continuation Span carries its own node heading and never an ancestor heading",
+      "file": "tasks/one.md",
+      "source": "---\ntype: task\nname: Task\nstatus: open\n---\n\n## Overview\n\nIntro line.\n\n### Detail\n\nDetail paragraph one.\n\nDetail paragraph two.\n",
+      "documentTargets": [],
+      "definition": "task",
+      "budget": 40,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "Task\n\n\n",
+            "source": "Task\nstatus: open\n---\n\n"
+          },
+          {
+            "text": "## Overview\n\nIntro line.\n\n",
+            "source": "## Overview\n\nIntro line.\n\n"
+          },
+          {
+            "text": "### Detail\n\nDetail paragraph one.\n\n",
+            "source": "### Detail\n\nDetail paragraph one.\n\n"
+          },
+          {
+            "text": "### Detail\n\nDetail paragraph two.\n",
+            "source": "Detail paragraph two.\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "a block over the budget divides into sentences that repeat their predecessor",
+      "file": "tasks/one.md",
+      "source": "---\ntype: task\nname: Task\nstatus: open\n---\n\n## Overview\n\nOne. Two. Three. Four.\n",
+      "documentTargets": [],
+      "definition": "task",
+      "budget": 30,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "Task\n\n\n",
+            "source": "Task\nstatus: open\n---\n\n"
+          },
+          {
+            "text": "## Overview\n\nOne. Two. Three. ",
+            "source": "## Overview\n\nOne. Two. Three. "
+          },
+          {
+            "text": "## Overview\n\nThree. Four.\n",
+            "source": "Three. Four.\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "a single sentence over the budget divides at a bound cut inside it",
+      "file": "tasks/one.md",
+      "source": "---\ntype: task\nname: Task\nstatus: open\n---\n\n## Overview\n\naaaa bbbb cccc dddd eeee\n",
+      "documentTargets": [],
+      "definition": "task",
+      "budget": 20,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "Task\n\n\n",
+            "source": "Task\nstatus: open\n---\n\n"
+          },
+          {
+            "text": "## Overview\n\naaaa",
+            "source": "## Overview\n\naaaa"
+          },
+          {
+            "text": "## Overview\n\n bbbb",
+            "source": " bbbb"
+          },
+          {
+            "text": "## Overview\n\n cccc",
+            "source": " cccc"
+          },
+          {
+            "text": "## Overview\n\n dddd",
+            "source": " dddd"
+          },
+          {
+            "text": "## Overview\n\n eeee\n",
+            "source": " eeee\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "an untyped input with no definition descends the same ladder",
+      "file": "notes/one.md",
+      "source": "# Title\n\nIntro paragraph about the whole thing.\n\n## Alpha\n\nAlpha one. Alpha two.\n\n### Deep\n\nDeep prose here.\n\n## Beta\n\nBeta prose.\n",
+      "documentTargets": [],
+      "definition": null,
+      "budget": 60,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "# Title\n\nIntro paragraph about the whole thing.\n\n",
+            "source": "# Title\n\nIntro paragraph about the whole thing.\n\n"
+          },
+          {
+            "text": "## Alpha\n\nAlpha one. Alpha two.\n\n",
+            "source": "## Alpha\n\nAlpha one. Alpha two.\n\n"
+          },
+          {
+            "text": "### Deep\n\nDeep prose here.\n\n",
+            "source": "### Deep\n\nDeep prose here.\n\n"
+          },
+          {
+            "text": "## Beta\n\nBeta prose.\n",
+            "source": "## Beta\n\nBeta prose.\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "a Document that declares the built-in any type divides its body after the fence",
+      "file": "notes/two.md",
+      "source": "---\ntype: any\ntitle: Note\n---\n\n## Notes\n\nRead it.\n",
+      "documentTargets": [],
+      "definition": null,
+      "budget": 4096,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "\n## Notes\n\nRead it.\n",
+            "source": "\n## Notes\n\nRead it.\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "an internal link embeds its label and addresses the destination the author wrote",
+      "file": "tasks/one.md",
+      "source": "---\ntype: task\nname: Task\nstatus: open\n---\n\n## Overview\n\nRead [the plan](../plans/q3.md) before starting.\n\n## Notes\n\nShort note.\n",
+      "documentTargets": [
+        "plans/q3.md"
+      ],
+      "definition": "task",
+      "budget": 50,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "Task\n\n\n",
+            "source": "Task\nstatus: open\n---\n\n"
+          },
+          {
+            "text": "## Overview\n\nRead the plan before starting.\n\n",
+            "source": "## Overview\n\nRead [the plan](../plans/q3.md) before starting.\n\n"
+          },
+          {
+            "text": "## Notes\n\nShort note.\n",
+            "source": "## Notes\n\nShort note.\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "a declared structured section stays outside the text and inside the extent",
+      "file": "tasks/one.md",
+      "source": "---\ntype: task\nname: Task\nstatus: open\n---\n\nPreamble prose.\n\n## Acceptance\n\n- people/ana.md\n\n## Notes\n\nShort note.\n",
+      "documentTargets": [],
+      "definition": "task",
+      "budget": 4096,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "Task\n\n\nPreamble prose.\n\n## Notes\n\nShort note.\n",
+            "source": "Task\nstatus: open\n---\n\nPreamble prose.\n\n## Acceptance\n\n- people/ana.md\n\n## Notes\n\nShort note.\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "a Document that declares a type the caller supplies no definition for is refused",
+      "file": "tasks/one.md",
+      "source": "---\ntype: task\nname: Ship the release\nstatus: open\n---\n\nPreamble prose.\n\n## Description\n\nBody of the description.\n\n## Acceptance\n\n- people/ana.md\n",
+      "documentTargets": [],
+      "definition": null,
+      "budget": 4096,
+      "expected": {
+        "ok": false,
+        "refusal": {
+          "file": "tasks/one.md",
+          "rule": "unknown-type",
+          "location": "type"
+        }
+      }
+    },
+    {
+      "name": "a budget that cannot hold one whole character is refused before any division",
+      "file": "notes/one.md",
+      "source": "## Notes\n\nShort note.\n",
+      "documentTargets": [],
+      "definition": null,
+      "budget": 1,
+      "expected": {
+        "ok": false,
+        "refusal": {
+          "file": "notes/one.md",
+          "rule": "division-budget"
+        }
+      }
+    },
+    {
+      "name": "a free-text value the author quoted embeds bare and addresses the quotes it was written with",
+      "file": "tasks/one.md",
+      "source": "---\ntype: task\nname: \"Ship: the release\"\nstatus: open\n---\n\nBody prose.\n",
+      "documentTargets": [],
+      "definition": "task",
+      "budget": 4096,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "Ship: the release\n\n\nBody prose.\n",
+            "source": "\"Ship: the release\"\nstatus: open\n---\n\nBody prose.\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "sentence division reads every terminator and closer and drops a carry the budget cannot hold",
+      "file": "notes/three.md",
+      "source": "## Ask\n\nReady? Go! He said \"no.\" Then (silence.) Done.\n",
+      "documentTargets": [],
+      "definition": null,
+      "budget": 30,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "## Ask\n\nReady? Go! ",
+            "source": "## Ask\n\nReady? Go! "
+          },
+          {
+            "text": "## Ask\n\nGo! He said \"no.\" ",
+            "source": "Go! He said \"no.\" "
+          },
+          {
+            "text": "## Ask\n\nThen (silence.) Done.\n",
+            "source": "Then (silence.) Done.\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "a heading with no body of its own leads the first child node instead of standing alone",
+      "file": "notes/four.md",
+      "source": "## Part\n\n### Alpha\n\nAlpha prose that is long enough to matter.\n\n### Beta\n\nBeta prose.\n",
+      "documentTargets": [],
+      "definition": null,
+      "budget": 70,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "## Part\n\n### Alpha\n\nAlpha prose that is long enough to matter.\n\n",
+            "source": "## Part\n\n### Alpha\n\nAlpha prose that is long enough to matter.\n\n"
+          },
+          {
+            "text": "### Beta\n\nBeta prose.\n",
+            "source": "### Beta\n\nBeta prose.\n"
+          }
+        ]
+      }
+    },
+    {
+      "name": "a heading the budget cannot hold beside any text is not repeated",
+      "file": "notes/five.md",
+      "source": "## An overview of the release\n\nFirst paragraph here.\n\nSecond paragraph here.\n",
+      "documentTargets": [],
+      "definition": null,
+      "budget": 25,
+      "expected": {
+        "ok": true,
+        "spans": [
+          {
+            "text": "## An overview of the",
+            "source": "## An overview of the"
+          },
+          {
+            "text": " release\n\nFirst paragraph",
+            "source": " release\n\nFirst paragraph"
+          },
+          {
+            "text": " here.\n\n",
+            "source": " here.\n\n"
+          },
+          {
+            "text": "Second paragraph here.\n",
+            "source": "Second paragraph here.\n"
+          }
+        ]
+      }
+    }
+  ]
+}

package/fixtures/projection.json

@@ -1,8 +1,5 @@
 {
-  "definitions": {
-    "task": "---\ntype: definition\nfields:\n  title: { kind: string, required: true }\n  status: { kind: enum, values: [open, done], required: true }\n  owner: { kind: reference, to: person }\nsections:\n  Description: { kind: text, required: true }\n  Acceptance: { kind: list }\n---\n",
-    "unreadable-task": "---\ntype: definition\nsections:\n  Description: { kind: prose }\n---\n"
-  },
+  "schema": "$defs:\n  line: { type: string }\ntask:\n  type: object\n  properties:\n    name: { type: string }\n    aliases: { type: array, items: { type: string } }\n    title: { type: string, pattern: '\\S' }\n    status: { enum: [open, done] }\n    owner: { type: string, reference: person }\n    reviewers: { type: array, items: { type: string, reference: person } }\n    due: { type: string, format: date }\n    estimate: { type: number }\n    labels: { type: array, items: { type: string, pattern: '^[a-z]+$' } }\n    contact:\n      type: object\n      properties:\n        note: { type: string }\n        email: { type: string, format: email }\n    notes: { type: object, additionalProperties: { type: string } }\n    backup: { $ref: '#/$defs/line', format: email }\n    memo: { type: [string, 'null'] }\n    steps:\n      type: array\n      items:\n        type: object\n        properties:\n          title: { type: string }\n          done: { type: boolean }\n  required: [name, title, status]\n  sections:\n    Description: { kind: text, required: true }\n    Acceptance: { kind: list, items: { type: string, reference: person } }\n    Checklist: { kind: list, items: { type: string } }\nperson: {}\n",
   "cases": [
     {
       "name": "any body keeps labels and leaves every unsupplied destination authored",
@@ -59,9 +56,53 @@
       }
     },
     {
-      "name": "typed Document takes its declared free-text sections alone",
+      "name": "a typed Document projects its free-text field values as bare values and no other kind",
+      "file": "tasks/four.md",
+      "source": "---\ntype: task\nname: Ship the release\naliases: [\"Launch day\", Cutover]\ntitle: Ship it\nstatus: open\nowner: ../people/ana.md\ndue: 2026-09-30\nestimate: 3\nlabels: [core, urgent]\n---\n",
+      "documentTargets": [],
+      "definition": "task",
+      "move": null,
+      "expected": {
+        "ok": true,
+        "text": "Ship the release\n\nLaunch day\n\nCutover\n\n"
+      }
+    },
+    {
+      "name": "a typed Document projects its prose at any depth in document order and leaves every filtered value out",
+      "file": "tasks/twelve.md",
+      "source": "---\ntype: task\nname: Ship the release\ntitle: Ship it\nstatus: open\nowner: ../people/ana.md\nreviewers: [../people/bo.md]\ndue: 2026-09-30\ncontact:\n  note: Call before noon\n  email: ana@example.com\nsteps:\n  - title: Tag the build\n    done: true\n  - title: Announce it\n    done: false\n---\n\n## Description\n\nCut the release.\n\n## Acceptance\n\n- [Ana](../people/ana.md)\n\n## Checklist\n\n- Notes written\n",
+      "documentTargets": [],
+      "definition": "task",
+      "move": null,
+      "filtered": {
+        "field": "status",
+        "value": "done"
+      },
+      "expected": {
+        "ok": true,
+        "text": "Ship the release\n\nCall before noon\n\nTag the build\n\nAnnounce it\n\n\n## Description\n\nCut the release.\n\n## Checklist\n\n- Notes written\n"
+      }
+    },
+    {
+      "name": "a typed Document projects the prose of an open map and a nullable string and leaves a formatted $ref out",
+      "file": "tasks/launch.md",
+      "source": "---\ntype: task\nname: Plan the launch\ntitle: Plan\nstatus: open\nnotes:\n  monday: Book the room\n  friday: Send the invite\nbackup: ana@example.com\nmemo: Bring slides\n---\n\n## Description\n\nLaunch.\n",
+      "documentTargets": [],
+      "definition": "task",
+      "move": null,
+      "filtered": {
+        "field": "backup",
+        "value": "bo@example.com"
+      },
+      "expected": {
+        "ok": true,
+        "text": "Plan the launch\n\nBook the room\n\nSend the invite\n\nBring slides\n\n\n## Description\n\nLaunch.\n"
+      }
+    },
+    {
+      "name": "a typed Document projects its preamble and every section its type does not declare as structure",
       "file": "tasks/one.md",
-      "source": "---\ntype: task\ntitle: Ship it\nstatus: open\nowner: ../people/ana.md\n---\n\nPreamble prose that mentions [the plan](../plans/q3.md).\n\n## Description\n\nFollow [the plan][plan] and [the plan][plan] again, then [read it][].\n\n[plan]: ../plans/q3.md \"Plan\"\n[read it]: ../plans/q3.md\n\n## Acceptance\n\n- [the plan](../plans/q3.md) is linked\n\n## Notes\n\nUndeclared prose about [the plan](../plans/q3.md).\n",
+      "source": "---\ntype: task\nname: Shipping the release\ntitle: Ship it\nstatus: open\nowner: ../people/ana.md\n---\n\nPreamble prose that mentions [the plan](../plans/q3.md).\n\n## Description\n\nFollow [the plan][plan] and [the plan][plan] again, then [read it][].\n\n[plan]: ../plans/q3.md \"Plan\"\n[read it]: ../plans/q3.md\n\n## Acceptance\n\n- [the plan](../plans/q3.md) is linked\n\n## Checklist\n\n- [the plan](../plans/q3.md) is read\n\n## Notes\n\nUndeclared prose about [the plan](../plans/q3.md).\n",
       "documentTargets": [
         "plans/q3.md",
         "plans/2026-q3.md"
@@ -71,13 +112,21 @@
         "href": "../plans/q3.md",
         "to": "../plans/2026-q3.md"
       },
+      "relabel": {
+        "from": "[the plan][plan] and",
+        "to": "[the roadmap][plan] and",
+        "expected": {
+          "ok": true,
+          "text": "Shipping the release\n\n\nPreamble prose that mentions the plan.\n\n## Description\n\nFollow the roadmap and the plan again, then read it.\n\n\n## Checklist\n\n- the plan is read\n\n## Notes\n\nUndeclared prose about the plan.\n"
+        }
+      },
       "expected": {
         "ok": true,
-        "text": "## Description\n\nFollow the plan and the plan again, then read it.\n\n\n"
+        "text": "Shipping the release\n\n\nPreamble prose that mentions the plan.\n\n## Description\n\nFollow the plan and the plan again, then read it.\n\n\n## Checklist\n\n- the plan is read\n\n## Notes\n\nUndeclared prose about the plan.\n"
       }
     },
     {
-      "name": "a link definition outside the projected sections still resolves its use",
+      "name": "a link definition in another section resolves its use and leaves the projection",
       "file": "tasks/two.md",
       "source": "---\ntype: task\ntitle: Ship it\nstatus: open\n---\n\n## Description\n\nFollow [the plan][plan].\n\n## Notes\n\n[plan]: ../plans/q3.md\n",
       "documentTargets": [
@@ -91,7 +140,7 @@
       },
       "expected": {
         "ok": true,
-        "text": "## Description\n\nFollow the plan.\n\n"
+        "text": "\n## Description\n\nFollow the plan.\n\n## Notes\n\n"
       }
     },
     {
@@ -109,13 +158,13 @@
       },
       "expected": {
         "ok": true,
-        "text": "## Description\n\nFirst plan.\n\n## Description\n\nSecond note.\n"
+        "text": "\n## Description\n\nFirst plan.\n\n## Description\n\nSecond note.\n"
       }
     },
     {
       "name": "a declared type the caller does not supply is refused",
       "file": "tasks/one.md",
-      "source": "---\ntype: task\ntitle: Ship it\nstatus: open\nowner: ../people/ana.md\n---\n\nPreamble prose that mentions [the plan](../plans/q3.md).\n\n## Description\n\nFollow [the plan][plan] and [the plan][plan] again, then [read it][].\n\n[plan]: ../plans/q3.md \"Plan\"\n[read it]: ../plans/q3.md\n\n## Acceptance\n\n- [the plan](../plans/q3.md) is linked\n\n## Notes\n\nUndeclared prose about [the plan](../plans/q3.md).\n",
+      "source": "---\ntype: task\nname: Shipping the release\ntitle: Ship it\nstatus: open\nowner: ../people/ana.md\n---\n\nPreamble prose that mentions [the plan](../plans/q3.md).\n\n## Description\n\nFollow [the plan][plan] and [the plan][plan] again, then [read it][].\n\n[plan]: ../plans/q3.md \"Plan\"\n[read it]: ../plans/q3.md\n\n## Acceptance\n\n- [the plan](../plans/q3.md) is linked\n\n## Checklist\n\n- [the plan](../plans/q3.md) is read\n\n## Notes\n\nUndeclared prose about [the plan](../plans/q3.md).\n",
       "documentTargets": [
         "plans/q3.md",
         "plans/2026-q3.md"
@@ -127,35 +176,32 @@
         "refusal": {
           "file": "tasks/one.md",
           "rule": "unknown-type",
-          "version": "<package-version>",
           "location": "type"
         }
       }
     },
     {
-      "name": "a definition the model cannot read is refused at that definition",
-      "file": "tasks/one.md",
-      "source": "---\ntype: task\ntitle: Ship it\nstatus: open\nowner: ../people/ana.md\n---\n\nPreamble prose that mentions [the plan](../plans/q3.md).\n\n## Description\n\nFollow [the plan][plan] and [the plan][plan] again, then [read it][].\n\n[plan]: ../plans/q3.md \"Plan\"\n[read it]: ../plans/q3.md\n\n## Acceptance\n\n- [the plan](../plans/q3.md) is linked\n\n## Notes\n\nUndeclared prose about [the plan](../plans/q3.md).\n",
+      "name": "an image at a supplied Markdown document target is projected like its link",
+      "file": "notes/four.md",
+      "source": "Read [the plan](../plans/q3.md) and ![the chart](../plans/q3.md).\nAlso [the plan][plan] and ![the chart][plan].\n\n[plan]: ../plans/q3.md\n",
       "documentTargets": [
         "plans/q3.md",
         "plans/2026-q3.md"
       ],
-      "definition": "unreadable-task",
-      "move": null,
+      "definition": null,
+      "move": {
+        "href": "../plans/q3.md",
+        "to": "../plans/2026-q3.md"
+      },
       "expected": {
-        "ok": false,
-        "refusal": {
-          "file": "types/task.md",
-          "rule": "definition-section-kind",
-          "version": "<package-version>",
-          "location": "Description"
-        }
+        "ok": true,
+        "text": "Read the plan and the chart.\nAlso the plan and the chart.\n\n"
       }
     },
     {
-      "name": "an image at a supplied Markdown document target is projected like its link",
-      "file": "notes/four.md",
-      "source": "Read [the plan](../plans/q3.md) and ![the chart](../plans/q3.md).\nAlso [the plan][plan] and ![the chart][plan].\n\n[plan]: ../plans/q3.md\n",
+      "name": "a shortcut reference link projects its label and its definition leaves the projection",
+      "file": "notes/five.md",
+      "source": "Read [Plan] and [the draft], then [plan](not a link).\nAlso [[Plan]], [ plan ], \\[Plan] and [Release  plan].\n\n[plan]: ../plans/q3.md\n[release plan]: ../plans/q3.md\n",
       "documentTargets": [
         "plans/q3.md",
         "plans/2026-q3.md"
@@ -165,9 +211,44 @@
         "href": "../plans/q3.md",
         "to": "../plans/2026-q3.md"
       },
+      "links": [
+        {
+          "href": "../plans/q3.md",
+          "target": "plans/q3.md"
+        }
+      ],
       "expected": {
         "ok": true,
-        "text": "Read the plan and the chart.\nAlso the plan and the chart.\n\n"
+        "text": "Read Plan and [the draft], then plan(not a link).\nAlso [Plan],  plan , \\[Plan] and Release  plan.\n\n"
+      }
+    },
+    {
+      "name": "an image whose description holds a link projects both labels",
+      "file": "notes/six.md",
+      "source": "Read ![outer [Plan](../plans/q3.md)](../plans/q4.md).\n",
+      "documentTargets": [
+        "plans/q3.md",
+        "plans/2026-q3.md",
+        "plans/q4.md"
+      ],
+      "definition": null,
+      "move": {
+        "href": "../plans/q3.md",
+        "to": "../plans/2026-q3.md"
+      },
+      "links": [
+        {
+          "href": "../plans/q3.md",
+          "target": "plans/q3.md"
+        },
+        {
+          "href": "../plans/q4.md",
+          "target": "plans/q4.md"
+        }
+      ],
+      "expected": {
+        "ok": true,
+        "text": "Read outer Plan.\n"
       }
     }
   ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentshouse/mdmodel",
-  "version": "0.1.0-alpha.8",
+  "version": "0.1.0-c68e2039f1ca8",
   "description": "MD Type language, parser, validator, structured change application, Markdown syntax profile, and conformance fixtures",
   "license": "MIT",
   "type": "module",
@@ -21,19 +21,10 @@
   "files": [
     "dist",
     "fixtures",
+    "API.md",
     "LICENSE",
-    "README.md",
-    "markdown-syntax-profile.md"
+    "README.md"
   ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/agentshouse/mdmodel.git",
-    "directory": "packages/mdmodel"
-  },
-  "homepage": "https://github.com/agentshouse/mdmodel#readme",
-  "bugs": {
-    "url": "https://github.com/agentshouse/mdmodel/issues"
-  },
   "dependencies": {
     "@cfworker/json-schema": "4.1.1"
   }