@rasensio/aidlc 1.21.0 → 1.22.0

package/dist/roadmap/sync/sanitize.js

@@ -0,0 +1,140 @@
+/**
+ * Make one item's prose safe to publish, and make its references clickable.
+ *
+ * The body used to carry no item prose at all, and the reason was three real hazards. Two
+ * of them are properties of GitHub's renderer and one is a property of this feature's own
+ * marker scanner:
+ *
+ * - **Marker injection.** The item↔issue link is an HTML comment. An item that quotes one
+ *   would stamp a second marker onto a different issue, and `indexByMarker` then refuses
+ *   the whole run as ambiguous — or, before that guard existed, retitled the wrong issue.
+ * - **Notification side effects.** `@name` and `#123` notify people and cross-link issues
+ *   the instant they are published. A sync is not a reason for somebody's inbox to move.
+ * - **Field limits.** GitHub caps a body at 65,536 characters, so the prose needs a budget
+ *   (that half lives in `body.ts`).
+ *
+ * The rejected alternative was to publish nothing and make the reader follow a link, which
+ * is what shipped in v1.21.0 and what this instance exists to undo: a body carrying no
+ * item-specific words is a redirect, and thirty of them on a board are thirty copies of one
+ * paragraph.
+ *
+ * **Everything here is code-aware, and that is the whole design.** Measured over this
+ * project's 76 items on 2026-09-07, 40 of the 41 hazard spans are inside a fence or an
+ * inline code span — `@clack/prompts`, `actions/checkout@v4`, colour hexes like `#0891b2`
+ * — and exactly one is in prose. A rule that ignored code would corrupt forty spans in
+ * order to defuse one. See `markdown.ts`.
+ *
+ * Requirements: richer-issue-bodies/AC-9, richer-issue-bodies/AC-10,
+ * richer-issue-bodies/AC-11, richer-issue-bodies/AC-12, richer-issue-bodies/AC-29
+ *
+ * @module
+ */
+import { codeMask, inlineCodeSpans, mapProse } from './markdown.js';
+/** An item id, as the roadmap skill mints them. */
+const ITEM_ID_RE = /item-\d{8}-[a-z0-9](?:[a-z0-9-]*[a-z0-9])?/g;
+/**
+ * An HTML comment, terminated or not.
+ *
+ * The unterminated alternative matters: GitHub's renderer swallows everything after a bare
+ * `<!--` to the end of the document, so leaving one in would blank the rest of the body.
+ * Dropping it is both safer and closer to what a reader would have seen anyway.
+ */
+const HTML_COMMENT_RE = /<!--[\s\S]*?-->|<!--[\s\S]*$/g;
+/** A mention GitHub would linkify. Requires a letter or digit after the `@`. */
+const MENTION_RE = /@[A-Za-z0-9][-A-Za-z0-9]*/g;
+/** An issue or pull-request cross-reference GitHub would link and notify. */
+const ISSUE_REF_RE = /#[0-9]+/g;
+/**
+ * Sanitize and enrich an item body for publication.
+ *
+ * Four rules, and the **order is load-bearing**, because two of them insert text a later
+ * rule must not re-examine:
+ *
+ * 1. Item references become links. This runs first because it is the only rule that
+ *    deliberately rewrites a code span, and because the link it emits contains no `@`, `#`
+ *    or `<!--` for rules 2–4 to find.
+ * 2. Prose HTML comments are removed — the marker-injection defence, and lossless, since a
+ *    comment renders as nothing.
+ * 3. Prose mentions are wrapped in backticks.
+ * 4. Prose issue references are wrapped in backticks.
+ *
+ * Rules 2–4 run through `mapProse`, so code is untouched by construction rather than by a
+ * filter that could be got wrong.
+ */
+export function sanitizeItemBody(body, ctx) {
+    const linked = linkItemReferences(body, ctx);
+    return mapProse(linked, defuseProse);
+}
+/**
+ * Apply rules 2–4 to one prose run.
+ *
+ * Comments go first: a marker *is* a comment, so removing comments is what closes the
+ * injection hazard, and doing it before the backtick rules means a `@name` inside a
+ * comment is deleted rather than wrapped.
+ */
+function defuseProse(prose) {
+    return prose
+        .replace(HTML_COMMENT_RE, '')
+        .replace(MENTION_RE, (m) => `\`${m}\``)
+        .replace(ISSUE_REF_RE, (m) => `\`${m}\``);
+}
+/**
+ * Turn item references into links, in code spans and in prose alike.
+ *
+ * All 32 references in the real corpus are inline code spans whose **entire** content is
+ * the id (`` `item-20260902-review-gate-vs-tasks-review` ``) — measured, and the reason
+ * the first draft of this rule was retired by Amendment 1: a prose-only rule would never
+ * have fired once.
+ *
+ * The rewrite is deliberately narrow. Only a span whose whole content is a known id is
+ * touched, and the replacement re-wraps the same content in the same number of backticks
+ * inside a link, so a multi-backtick span stays valid. An id with no entry in `itemPaths`
+ * is left byte-identical, because an unresolvable link is worse than no link.
+ */
+function linkItemReferences(body, ctx) {
+    const { itemPaths, fileUrl } = ctx;
+    if (fileUrl === null || itemPaths.size === 0)
+        return body;
+    const edits = [];
+    // Code spans whose entire content is a known id.
+    const spans = inlineCodeSpans(body);
+    for (const span of spans) {
+        const relPath = itemPaths.get(span.content);
+        if (relPath === undefined)
+            continue;
+        const ticks = '`'.repeat(span.ticks);
+        edits.push({
+            start: span.start,
+            end: span.end,
+            text: `[${ticks}${span.content}${ticks}](${fileUrl(relPath)})`,
+        });
+    }
+    // Bare ids in prose. The mask — not `spans` — decides what counts as prose here:
+    // `inlineCodeSpans` deliberately omits spans inside fenced blocks, so testing against it
+    // alone would rewrite an id sitting in a code sample and corrupt the block.
+    const mask = codeMask(body);
+    ITEM_ID_RE.lastIndex = 0;
+    let match;
+    while ((match = ITEM_ID_RE.exec(body)) !== null) {
+        if (mask[match.index] === 1)
+            continue;
+        const relPath = itemPaths.get(match[0]);
+        if (relPath === undefined)
+            continue;
+        edits.push({
+            start: match.index,
+            end: match.index + match[0].length,
+            text: `[\`${match[0]}\`](${fileUrl(relPath)})`,
+        });
+    }
+    if (edits.length === 0)
+        return body;
+    // Right to left, so earlier offsets stay valid as later text is spliced in.
+    edits.sort((a, b) => b.start - a.start);
+    let out = body;
+    for (const edit of edits) {
+        out = out.slice(0, edit.start) + edit.text + out.slice(edit.end);
+    }
+    return out;
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/roadmap/sync/sanitize.js.map

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

package/dist/roadmap/sync/types.d.ts

@@ -26,8 +26,8 @@ import type { RoadmapStatus } from '../paths.js';
  * criteria unachievable — "the second plan contains only X or Y" cannot be checked
  * against a list nobody wrote down.
  */
-export type Outcome = 'create' | 'update-title' | 'update-labels' | 'close' | 'unchanged' | 'skip' | 'state-divergent' | 'ineligible-with-issue' | 'orphan-missing' | 'label-without-marker';
-/** The four outcomes that write. Everything else is a report. */
+export type Outcome = 'create' | 'update-title' | 'update-labels' | 'update-body' | 'close' | 'unchanged' | 'skip' | 'state-divergent' | 'ineligible-with-issue' | 'orphan-missing' | 'label-without-marker';
+/** The five outcomes that write. Everything else is a report. */
 export declare const WRITE_OUTCOMES: readonly Outcome[];
 /**
  * Outcomes that suppress every write for their item (design DE-18).
@@ -42,6 +42,22 @@ export declare const TERMINAL_REPORTS: readonly Outcome[];
 export declare const WRITE_ORDER: readonly Outcome[];
 /** True when this outcome performs a `gh` write. */
 export declare function isWrite(outcome: Outcome): boolean;
+/**
+ * The frontmatter facts a reader with no checkout cannot otherwise see.
+ *
+ * Every field is nullable and `null` means *not recorded*. It is never coerced to an
+ * empty string or a guess: an item with no `author` is a normal item, and rendering
+ * `not recorded` tells a reader something true, where a blank tells them nothing and an
+ * invented value tells them something false.
+ */
+export interface ItemFacts {
+    createdAt: string | null;
+    author: string | null;
+    source: string | null;
+    promotedTo: string | null;
+    /** Item ids, in file order. Empty when the key is absent or holds no usable ids. */
+    dependsOn: readonly string[];
+}
 /** An item that can be projected: parseable, with an id. */
 export interface ProjectableItem {
     id: string;
@@ -51,6 +67,9 @@ export interface ProjectableItem {
     filename: string;
     /** Repo-relative path, for the issue body. */
     relPath: string;
+    /** Everything below the frontmatter, verbatim. Projected after sanitization. */
+    body: string;
+    facts: ItemFacts;
 }
 /**
  * Why an item cannot be projected.
@@ -93,6 +112,15 @@ export interface PlanLine {
     detail: string | null;
     addLabels: readonly string[];
     removeLabels: readonly string[];
+    /**
+     * The exact bytes to send, on `create` and `update-body`; null on every other outcome.
+     *
+     * Decided in the pure planner rather than in `execute.ts` (design DD-6). The merge that
+     * produces it has four branches and has to preserve a human's additions, which is
+     * exactly the kind of logic that should not live in the one module capable of
+     * irreversible writes — and here it is testable with no `gh` at all.
+     */
+    newBody: string | null;
 }
 export interface Plan {
     /**

package/dist/roadmap/sync/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/roadmap/sync/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GACf,QAAQ,GACR,cAAc,GACd,eAAe,GACf,OAAO,GACP,WAAW,GACX,MAAM,GACN,iBAAiB,GACjB,uBAAuB,GACvB,gBAAgB,GAChB,sBAAsB,CAAC;AAE3B,iEAAiE;AACjE,eAAO,MAAM,cAAc,EAAE,SAAS,OAAO,EAK5C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,OAAO,EAAiD,CAAC;AAEjG,uFAAuF;AACvF,eAAO,MAAM,WAAW,EAAE,SAAS,OAAO,EAAyD,CAAC;AAEpG,oDAAoD;AACpD,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEjD;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,YAAY,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,kBAAkB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0BAA0B;AAC1B,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,IAAI;IACnB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,qDAAqD;IACrD,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACnD,UAAU,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/roadmap/sync/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GACf,QAAQ,GACR,cAAc,GACd,eAAe,GACf,aAAa,GACb,OAAO,GACP,WAAW,GACX,MAAM,GACN,iBAAiB,GACjB,uBAAuB,GACvB,gBAAgB,GAChB,sBAAsB,CAAC;AAE3B,iEAAiE;AACjE,eAAO,MAAM,cAAc,EAAE,SAAS,OAAO,EAM5C,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,OAAO,EAAiD,CAAC;AAEjG,uFAAuF;AACvF,eAAO,MAAM,WAAW,EAAE,SAAS,OAAO,EAMzC,CAAC;AAEF,oDAAoD;AACpD,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAEjD;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oFAAoF;IACpF,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,YAAY,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,kBAAkB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0BAA0B;AAC1B,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,IAAI;IACnB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,qDAAqD;IACrD,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACnD,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/roadmap/sync/types.js

@@ -18,11 +18,12 @@
  *
  * @module
  */
-/** The four outcomes that write. Everything else is a report. */
+/** The five outcomes that write. Everything else is a report. */
 export const WRITE_OUTCOMES = [
     'create',
     'update-title',
     'update-labels',
+    'update-body',
     'close',
 ];
 /**
@@ -35,7 +36,13 @@ export const WRITE_OUTCOMES = [
  */
 export const TERMINAL_REPORTS = ['state-divergent', 'ineligible-with-issue'];
 /** Execution order within one item: edit while the issue is still open, then close. */
-export const WRITE_ORDER = ['create', 'update-title', 'update-labels', 'close'];
+export const WRITE_ORDER = [
+    'create',
+    'update-title',
+    'update-labels',
+    'update-body',
+    'close',
+];
 /** True when this outcome performs a `gh` write. */
 export function isWrite(outcome) {
     return WRITE_OUTCOMES.includes(outcome);

package/dist/roadmap/sync/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/roadmap/sync/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAuBH,iEAAiE;AACjE,MAAM,CAAC,MAAM,cAAc,GAAuB;IAChD,QAAQ;IACR,cAAc;IACd,eAAe;IACf,OAAO;CACR,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAuB,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;AAEjG,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GAAuB,CAAC,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;AAEpG,oDAAoD;AACpD,MAAM,UAAU,OAAO,CAAC,OAAgB;IACtC,OAAO,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/roadmap/sync/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAwBH,iEAAiE;AACjE,MAAM,CAAC,MAAM,cAAc,GAAuB;IAChD,QAAQ;IACR,cAAc;IACd,eAAe;IACf,aAAa;IACb,OAAO;CACR,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAuB,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;AAEjG,uFAAuF;AACvF,MAAM,CAAC,MAAM,WAAW,GAAuB;IAC7C,QAAQ;IACR,cAAc;IACd,eAAe;IACf,aAAa;IACb,OAAO;CACR,CAAC;AAEF,oDAAoD;AACpD,MAAM,UAAU,OAAO,CAAC,OAAgB;IACtC,OAAO,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rasensio/aidlc",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "AI Development Lifecycle Framework — structured lifecycle guidance for AI coding agents across platforms",
   "type": "module",
   "main": "dist/cli.js",
@@ -24,7 +24,7 @@
     "commander": "15.0.0",
     "picomatch": "4.0.5",
     "yaml": "2.9.0",
-    "@rasensio/aidlc-content": "1.21.0"
+    "@rasensio/aidlc-content": "1.22.0"
   },
   "devDependencies": {
     "@types/node": "22.15.32",