@rasensio/aidlc 1.19.0 → 1.21.0

package/dist/roadmap/sync/import.js

@@ -0,0 +1,269 @@
+/**
+ * One-shot import: a GitHub issue seeds a roadmap item.
+ *
+ * Import, not sync. Nothing reconciles afterwards, nothing is written back to the issue,
+ * and running it twice over the same issue is reported rather than duplicated.
+ *
+ * The `title` is **always** double-quoted, with no judgement call about whether this one
+ * needs it. An unquoted YAML plain scalar may not begin with a reserved indicator
+ * character, so the single most natural way to name a code defect — an identifier in
+ * backticks — does not parse; and nothing reports it, because an item that will not parse
+ * and an item that was never written look identical. Five of this project's first 49 items
+ * were lost that way for up to ten days, and GitHub issue titles are precisely the corpus
+ * that produces them.
+ *
+ * Requirements: roadmap-issue-projection/AC-51 … roadmap-issue-projection/AC-60
+ *
+ * @module
+ */
+import { existsSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { join, resolve, sep } from 'node:path';
+import { ITEM_FILENAME_RE, ROADMAP_STATUSES, isoDate, primaryCheckout, statusDir, } from '../paths.js';
+import { firstLine } from './gh.js';
+/** Slug used when a title yields nothing usable. */
+export const FALLBACK_SLUG_PREFIX = 'imported-issue';
+/** Keeps filenames reasonable; `ITEM_FILENAME_RE` imposes no length limit itself. */
+const MAX_SLUG_LENGTH = 48;
+/**
+ * Parse an issue reference into a comparable tuple.
+ *
+ * Normalising is the point: `https://github.com/o/r/issues/12`, the same with a trailing
+ * slash, with a `#issuecomment-…` fragment, with `www.`, and the
+ * `api.github.com/repos/o/r/issues/12` form all denote one issue. Comparing raw strings
+ * would report false duplicates in one direction and miss real ones in the other — and a
+ * naive substring compare makes `issues/1` match `issues/12`.
+ */
+export function parseIssueUrl(raw) {
+    let url;
+    try {
+        url = new URL(raw.trim());
+    }
+    catch {
+        return null;
+    }
+    if (url.protocol !== 'https:' && url.protocol !== 'http:')
+        return null;
+    const host = url.hostname.replace(/^www\./, '').toLowerCase();
+    const segments = url.pathname.split('/').filter((s) => s.length > 0);
+    // api.github.com/repos/<owner>/<repo>/issues/<n>
+    if (host === 'api.github.com') {
+        if (segments.length !== 5)
+            return null;
+        if (segments[0] !== 'repos' || segments[3] !== 'issues')
+            return null;
+        const number = toIssueNumber(segments[4]);
+        if (number === null)
+            return null;
+        return { host: 'github.com', owner: segments[1], repo: segments[2], number };
+    }
+    // <host>/<owner>/<repo>/issues/<n>
+    if (segments.length !== 4)
+        return null;
+    if (segments[2] !== 'issues')
+        return null;
+    const number = toIssueNumber(segments[3]);
+    if (number === null)
+        return null;
+    return { host, owner: segments[0], repo: segments[1], number };
+}
+function toIssueNumber(raw) {
+    if (!/^[1-9][0-9]*$/.test(raw))
+        return null;
+    const n = Number(raw);
+    return Number.isSafeInteger(n) ? n : null;
+}
+/** Canonical string form of a coordinate, for map keys. */
+export function coordKey(coord) {
+    return `${coord.host}/${coord.owner}/${coord.repo}#${coord.number}`;
+}
+/**
+ * Every issue already linked by a roadmap item, keyed by coordinate.
+ *
+ * This reads item **bodies**, which the roadmap skill's frontmatter-only rule otherwise
+ * discourages. That rule governs *browse*, which is a list and must stay cheap enough to
+ * run over the whole roadmap. Import is neither a list nor cheap-by-contract, and there is
+ * nowhere else the local half of a duplicate check could come from — DD-1 means no
+ * `remote:` field exists to consult.
+ */
+export function linkedCoords(cwd) {
+    const root = primaryCheckout(cwd);
+    const found = new Map();
+    for (const status of ROADMAP_STATUSES) {
+        const dir = statusDir(root, status);
+        if (!existsSync(dir))
+            continue;
+        let names;
+        try {
+            names = readdirSync(dir).sort();
+        }
+        catch {
+            continue;
+        }
+        for (const filename of names) {
+            if (!filename.endsWith('.md'))
+                continue;
+            let raw;
+            try {
+                raw = readFileSync(join(dir, filename), 'utf8');
+            }
+            catch {
+                continue;
+            }
+            for (const match of raw.matchAll(/https?:\/\/[^\s)>\]"']+/g)) {
+                const coord = parseIssueUrl(match[0]);
+                if (coord === null)
+                    continue;
+                const key = coordKey(coord);
+                if (!found.has(key))
+                    found.set(key, `${status}/${filename}`);
+            }
+        }
+    }
+    return found;
+}
+/**
+ * A filename-safe slug from an issue title.
+ *
+ * Must satisfy `ITEM_FILENAME_RE`'s `[a-z0-9][a-z0-9-]*`, which a title of punctuation or
+ * of a non-Latin script will not survive — hence the fallback rather than a refusal. An
+ * issue that cannot be imported because of its title would be a strange thing to tell
+ * somebody.
+ */
+export function slugFromTitle(title, number) {
+    const slug = title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, MAX_SLUG_LENGTH)
+        .replace(/-+$/g, '');
+    if (slug.length === 0 || !/^[a-z0-9]/.test(slug)) {
+        return `${FALLBACK_SLUG_PREFIX}-${number}`;
+    }
+    return slug;
+}
+/** Read the issue. The only `gh` call import makes, and it is a read. */
+function readIssue(gh, url) {
+    const result = gh.run(['issue', 'view', url, '--json', 'number,title,url']);
+    if (!result.ok)
+        return { ok: false, error: firstLine(result.error) };
+    try {
+        const parsed = JSON.parse(result.stdout);
+        if (typeof parsed.number !== 'number' || typeof parsed.title !== 'string' || typeof parsed.url !== 'string') {
+            return { ok: false, error: 'gh returned an issue without number, title and url' };
+        }
+        return { ok: true, issue: { number: parsed.number, title: parsed.title, url: parsed.url } };
+    }
+    catch (err) {
+        return { ok: false, error: `gh returned output that is not JSON: ${err.message}` };
+    }
+}
+/** Import one issue into `inbox/`. */
+export function importIssue(gh, cwd, url) {
+    const coord = parseIssueUrl(url);
+    if (coord === null) {
+        return {
+            kind: 'refused',
+            error: `${JSON.stringify(url)} is not a GitHub issue URL. Expected ` +
+                'https://github.com/<owner>/<repo>/issues/<number>.',
+        };
+    }
+    const linked = linkedCoords(cwd);
+    const existing = linked.get(coordKey(coord));
+    if (existing !== undefined) {
+        return { kind: 'duplicate', existing, coord };
+    }
+    const read = readIssue(gh, url);
+    if (!read.ok)
+        return { kind: 'refused', error: read.error };
+    const root = primaryCheckout(cwd);
+    const inbox = statusDir(root, 'inbox');
+    const date = isoDate();
+    const compact = date.replace(/-/g, '');
+    const slug = slugFromTitle(read.issue.title, coord.number);
+    const filename = uniqueFilename(root, compact, slug);
+    if (filename === null) {
+        return {
+            kind: 'refused',
+            error: `could not find a free filename for ${compact}-${slug}.md after 50 attempts`,
+        };
+    }
+    const target = resolve(inbox, filename);
+    // Second boundary. The slug is already constrained, but a containment check immediately
+    // before the write is what stops a slug bug from becoming a path traversal — the
+    // secure-defaults rule about validating at more than one boundary.
+    if (!target.startsWith(inbox + sep)) {
+        return { kind: 'refused', error: `refusing to write outside ${inbox}` };
+    }
+    if (!ITEM_FILENAME_RE.test(filename)) {
+        return { kind: 'refused', error: `derived filename ${filename} is not a valid roadmap item name` };
+    }
+    writeFileSync(target, renderItem(read.issue, coord, compact, slug, date), 'utf8');
+    return { kind: 'written', path: target };
+}
+/**
+ * A filename free in **every** status directory.
+ *
+ * Not just `inbox/`: a filename appearing in two status directories is an error the
+ * roadmap module reports rather than resolves, so creating one would be manufacturing it.
+ * The `-2` suffix follows the rule the roadmap skill already states.
+ */
+function uniqueFilename(root, compact, slug) {
+    for (let attempt = 1; attempt <= 50; attempt++) {
+        const candidate = attempt === 1 ? `${compact}-${slug}.md` : `${compact}-${slug}-${attempt}.md`;
+        const taken = ROADMAP_STATUSES.some((status) => existsSync(join(statusDir(root, status), candidate)));
+        if (!taken)
+            return candidate;
+    }
+    return null;
+}
+/**
+ * The item file.
+ *
+ * The Executive Summary is written with every label reading `Not yet decided.` rather than
+ * inferred from the issue body. The roadmap skill requires the section of every item and
+ * warns that a summary drafted before the detail "is a guess wearing a summary's clothes";
+ * filling six labels from an issue nobody has triaged would be exactly that. Triage is
+ * where they get answered.
+ */
+function renderItem(issue, coord, compact, slug, date) {
+    const id = `item-${compact}-${slug}`;
+    return [
+        '---',
+        `id: ${id}`,
+        // JSON.stringify, unconditionally. See the module docblock.
+        `title: ${JSON.stringify(issue.title)}`,
+        `created_at: ${date}`,
+        'source: import',
+        'promoted_to: null',
+        'depends_on: []',
+        'history:',
+        `  - { status: inbox, at: ${date} }`,
+        '---',
+        '',
+        `# Idea: ${issue.title}`,
+        '',
+        '## Executive Summary',
+        '',
+        '- **What it is** — Not yet decided.',
+        '- **Who benefits** — Not yet decided.',
+        '- **Customer value** — Not yet decided.',
+        '- **Revenue** — Not yet decided.',
+        '- **Cost and risk** — Not yet decided.',
+        '- **Recommendation** — Not yet decided.',
+        '',
+        `Imported from ${issue.url} on ${date}. The summary above is deliberately unfilled:`,
+        'six labelled lines guessed from an untriaged issue would read as answered without',
+        'being decided. Fill them in at triage.',
+        '',
+        '## Source',
+        '',
+        `- **Issue:** ${issue.url}`,
+        `- **Repository:** ${coord.owner}/${coord.repo}`,
+        `- **Number:** #${coord.number}`,
+        '',
+        'This item is a one-shot import. Nothing reconciles it with the issue afterwards, and',
+        'comments on the issue are not copied here.',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=import.js.map

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

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

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

@@ -0,0 +1,57 @@
+/**
+ * The label vocabulary the projection uses.
+ *
+ * Two kinds of label, doing two different jobs:
+ *
+ * - **The discovery label** (`aidlc` by default) is how the whole issue map is found in
+ *   one `gh issue list` call. It is identity: an issue without it is invisible to the
+ *   projection.
+ * - **A status label** (`aidlc:backlog`, `aidlc:done`, …) is how a reader tells planned
+ *   from in-flight without opening anything.
+ *
+ * The status names are *derived* from `ROADMAP_STATUSES` rather than listed here, so the
+ * two vocabularies cannot drift: adding a sixth status becomes a compile-time fact
+ * instead of a label nobody remembered to add.
+ *
+ * `LABEL_COLOR` and `LABEL_DESCRIPTION` exist because `gh label create` exits 1 on a
+ * label that already exists, so creation must pass `--force` — and `gh` chooses a
+ * *random* colour when none is given, so `--force` without an explicit colour would
+ * repaint the label on every single run. Fixed values make the ensure genuinely
+ * idempotent.
+ *
+ * Requirements: roadmap-issue-projection/AC-17, roadmap-issue-projection/AC-43
+ *
+ * @module
+ */
+import { type RoadmapStatus } from '../paths.js';
+/** Default discovery label. Overridable via `roadmap.sync.label`. */
+export declare const DEFAULT_DISCOVERY_LABEL = "aidlc";
+/** GitHub's own label-name limit. */
+export declare const MAX_LABEL_LENGTH = 50;
+/** Prefix marking a label this projection owns. */
+export declare const STATUS_LABEL_PREFIX = "aidlc:";
+/** The label carrying an item's status. */
+export declare function statusLabel(status: RoadmapStatus): string;
+/** Every status label, derived. */
+export declare const ALL_STATUS_LABELS: readonly string[];
+/**
+ * True when a label name is one this projection owns.
+ *
+ * Used to decide what `update-labels` may remove. Anything failing this test is a
+ * human's label and is never touched — which is why the update uses `--add-label` /
+ * `--remove-label` rather than a wholesale `--label` replacement.
+ */
+export declare function isStatusLabel(name: string): boolean;
+/** Fixed colours, so `--force` is idempotent rather than a repaint. */
+export declare const LABEL_COLOR: Readonly<Record<string, string>>;
+/** Fallback colour for a custom discovery label. */
+export declare const FALLBACK_LABEL_COLOR = "5319e7";
+/** Fixed descriptions, for the same reason as the colours. */
+export declare const LABEL_DESCRIPTION: Readonly<Record<string, string>>;
+/** Fallback description for the discovery label, whatever it is named. */
+export declare function discoveryLabelDescription(): string;
+/** Colour for a label name, falling back for a custom discovery label. */
+export declare function colorFor(name: string): string;
+/** Description for a label name, falling back for a custom discovery label. */
+export declare function descriptionFor(name: string): string;
+//# sourceMappingURL=labels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../src/roadmap/sync/labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEnE,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C,qCAAqC;AACrC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C,2CAA2C;AAC3C,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAEzD;AAED,mCAAmC;AACnC,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAsC,CAAC;AAEtF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,uEAAuE;AACvE,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxD,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAM9D,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/roadmap/sync/labels.js

@@ -0,0 +1,80 @@
+/**
+ * The label vocabulary the projection uses.
+ *
+ * Two kinds of label, doing two different jobs:
+ *
+ * - **The discovery label** (`aidlc` by default) is how the whole issue map is found in
+ *   one `gh issue list` call. It is identity: an issue without it is invisible to the
+ *   projection.
+ * - **A status label** (`aidlc:backlog`, `aidlc:done`, …) is how a reader tells planned
+ *   from in-flight without opening anything.
+ *
+ * The status names are *derived* from `ROADMAP_STATUSES` rather than listed here, so the
+ * two vocabularies cannot drift: adding a sixth status becomes a compile-time fact
+ * instead of a label nobody remembered to add.
+ *
+ * `LABEL_COLOR` and `LABEL_DESCRIPTION` exist because `gh label create` exits 1 on a
+ * label that already exists, so creation must pass `--force` — and `gh` chooses a
+ * *random* colour when none is given, so `--force` without an explicit colour would
+ * repaint the label on every single run. Fixed values make the ensure genuinely
+ * idempotent.
+ *
+ * Requirements: roadmap-issue-projection/AC-17, roadmap-issue-projection/AC-43
+ *
+ * @module
+ */
+import { ROADMAP_STATUSES } from '../paths.js';
+/** Default discovery label. Overridable via `roadmap.sync.label`. */
+export const DEFAULT_DISCOVERY_LABEL = 'aidlc';
+/** GitHub's own label-name limit. */
+export const MAX_LABEL_LENGTH = 50;
+/** Prefix marking a label this projection owns. */
+export const STATUS_LABEL_PREFIX = 'aidlc:';
+/** The label carrying an item's status. */
+export function statusLabel(status) {
+    return `${STATUS_LABEL_PREFIX}${status}`;
+}
+/** Every status label, derived. */
+export const ALL_STATUS_LABELS = ROADMAP_STATUSES.map(statusLabel);
+/**
+ * True when a label name is one this projection owns.
+ *
+ * Used to decide what `update-labels` may remove. Anything failing this test is a
+ * human's label and is never touched — which is why the update uses `--add-label` /
+ * `--remove-label` rather than a wholesale `--label` replacement.
+ */
+export function isStatusLabel(name) {
+    return ALL_STATUS_LABELS.includes(name);
+}
+/** Fixed colours, so `--force` is idempotent rather than a repaint. */
+export const LABEL_COLOR = {
+    [DEFAULT_DISCOVERY_LABEL]: '5319e7',
+    [statusLabel('inbox')]: 'bfd4f2',
+    [statusLabel('backlog')]: '1d76db',
+    [statusLabel('in-progress')]: '0e8a16',
+    [statusLabel('done')]: '6f42c1',
+    [statusLabel('hold')]: 'd4c5f9',
+};
+/** Fallback colour for a custom discovery label. */
+export const FALLBACK_LABEL_COLOR = '5319e7';
+/** Fixed descriptions, for the same reason as the colours. */
+export const LABEL_DESCRIPTION = {
+    [statusLabel('inbox')]: 'AIDLC roadmap: captured, not yet triaged',
+    [statusLabel('backlog')]: 'AIDLC roadmap: agreed, not started',
+    [statusLabel('in-progress')]: 'AIDLC roadmap: a lifecycle instance exists',
+    [statusLabel('done')]: 'AIDLC roadmap: shipped',
+    [statusLabel('hold')]: 'AIDLC roadmap: parked or declined',
+};
+/** Fallback description for the discovery label, whatever it is named. */
+export function discoveryLabelDescription() {
+    return 'Projected from this repository’s AIDLC roadmap';
+}
+/** Colour for a label name, falling back for a custom discovery label. */
+export function colorFor(name) {
+    return LABEL_COLOR[name] ?? FALLBACK_LABEL_COLOR;
+}
+/** Description for a label name, falling back for a custom discovery label. */
+export function descriptionFor(name) {
+    return LABEL_DESCRIPTION[name] ?? discoveryLabelDescription();
+}
+//# sourceMappingURL=labels.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labels.js","sourceRoot":"","sources":["../../../src/roadmap/sync/labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AAEnE,qEAAqE;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE/C,qCAAqC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC,mDAAmD;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AAE5C,2CAA2C;AAC3C,MAAM,UAAU,WAAW,CAAC,MAAqB;IAC/C,OAAO,GAAG,mBAAmB,GAAG,MAAM,EAAE,CAAC;AAC3C,CAAC;AAED,mCAAmC;AACnC,MAAM,CAAC,MAAM,iBAAiB,GAAsB,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,WAAW,GAAqC;IAC3D,CAAC,uBAAuB,CAAC,EAAE,QAAQ;IACnC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ;IAChC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ;IAClC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,EAAE,QAAQ;IACtC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ;IAC/B,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ;CAChC,CAAC;AAEF,oDAAoD;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAE7C,8DAA8D;AAC9D,MAAM,CAAC,MAAM,iBAAiB,GAAqC;IACjE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAAE,0CAA0C;IAClE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,oCAAoC;IAC9D,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,EAAE,4CAA4C;IAC1E,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,wBAAwB;IAC/C,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,mCAAmC;CAC3D,CAAC;AAEF,0EAA0E;AAC1E,MAAM,UAAU,yBAAyB;IACvC,OAAO,gDAAgD,CAAC;AAC1D,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC;AACnD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,iBAAiB,CAAC,IAAI,CAAC,IAAI,yBAAyB,EAAE,CAAC;AAChE,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * The durable link between a roadmap item and its GitHub issue.
+ *
+ * The link is the item `id`, stamped on the issue as an HTML-comment marker. It is not
+ * the `remote:` frontmatter field: creating an issue and writing a local link are two
+ * writes to two systems, and every failure of the second leaves an issue with no link,
+ * which the next run turns into a duplicate. With the id living server-side there is no
+ * second write to fail, so the projection is a convergent rendering rather than
+ * stateful sync — and can be thrown away and rebuilt.
+ *
+ * Two properties matter and both are easy to get wrong:
+ *
+ * - **Matching is position-independent.** A created body ends with the marker, but as
+ *   soon as somebody comments or edits, it will not. Matching that depended on position
+ *   would silently stop finding issues the moment the tracker was used.
+ * - **Matching consumes the whole marker, terminator included.** The obvious
+ *   implementation, `body.includes(id)`, resolves `item-20260907-foo` against the issue
+ *   for `item-20260907-foo-2` — and that exact pair is manufactured by the roadmap
+ *   skill's own collision rule, which suffixes a duplicate slug with `-2`. So the id is
+ *   *extracted* and compared with `===`, never searched for as a substring.
+ *
+ * Requirements: roadmap-issue-projection/AC-47, roadmap-issue-projection/AC-48,
+ * roadmap-issue-projection/AC-49
+ *
+ * @module
+ */
+/** Render the marker for an item id. */
+export declare function renderMarker(id: string): string;
+/**
+ * Every item id marked in a body, in order of appearance, de-duplicated.
+ *
+ * Returns an **array** rather than the first id. A single-id return would make the
+ * two-markers case undetectable: the function would pick one and the projection would
+ * confidently retitle or close the wrong issue. The plural return costs nothing and
+ * makes the ambiguity representable, so `planProjection` can refuse instead of guess.
+ */
+export declare function findMarkerIds(body: string): string[];
+//# sourceMappingURL=marker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marker.d.ts","sourceRoot":"","sources":["../../../src/roadmap/sync/marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAWH,wCAAwC;AACxC,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CASpD"}

package/dist/roadmap/sync/marker.js

@@ -0,0 +1,58 @@
+/**
+ * The durable link between a roadmap item and its GitHub issue.
+ *
+ * The link is the item `id`, stamped on the issue as an HTML-comment marker. It is not
+ * the `remote:` frontmatter field: creating an issue and writing a local link are two
+ * writes to two systems, and every failure of the second leaves an issue with no link,
+ * which the next run turns into a duplicate. With the id living server-side there is no
+ * second write to fail, so the projection is a convergent rendering rather than
+ * stateful sync — and can be thrown away and rebuilt.
+ *
+ * Two properties matter and both are easy to get wrong:
+ *
+ * - **Matching is position-independent.** A created body ends with the marker, but as
+ *   soon as somebody comments or edits, it will not. Matching that depended on position
+ *   would silently stop finding issues the moment the tracker was used.
+ * - **Matching consumes the whole marker, terminator included.** The obvious
+ *   implementation, `body.includes(id)`, resolves `item-20260907-foo` against the issue
+ *   for `item-20260907-foo-2` — and that exact pair is manufactured by the roadmap
+ *   skill's own collision rule, which suffixes a duplicate slug with `-2`. So the id is
+ *   *extracted* and compared with `===`, never searched for as a substring.
+ *
+ * Requirements: roadmap-issue-projection/AC-47, roadmap-issue-projection/AC-48,
+ * roadmap-issue-projection/AC-49
+ *
+ * @module
+ */
+/**
+ * Marker scanner.
+ *
+ * The id charset deliberately excludes `-->`'s characters, so the match cannot run past
+ * its own terminator. Global, because an issue carrying two markers is a real state the
+ * caller has to be able to see.
+ */
+const MARKER_RE = /<!--\s*aidlc-item:\s*([A-Za-z0-9][A-Za-z0-9._-]*)\s*-->/g;
+/** Render the marker for an item id. */
+export function renderMarker(id) {
+    return `<!-- aidlc-item: ${id} -->`;
+}
+/**
+ * Every item id marked in a body, in order of appearance, de-duplicated.
+ *
+ * Returns an **array** rather than the first id. A single-id return would make the
+ * two-markers case undetectable: the function would pick one and the projection would
+ * confidently retitle or close the wrong issue. The plural return costs nothing and
+ * makes the ambiguity representable, so `planProjection` can refuse instead of guess.
+ */
+export function findMarkerIds(body) {
+    const ids = [];
+    // `matchAll` on a fresh iterator each call — the regex is module-level and `g`-flagged,
+    // so relying on `lastIndex` across calls would make results depend on call order.
+    for (const match of body.matchAll(MARKER_RE)) {
+        const id = match[1];
+        if (!ids.includes(id))
+            ids.push(id);
+    }
+    return ids;
+}
+//# sourceMappingURL=marker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"marker.js","sourceRoot":"","sources":["../../../src/roadmap/sync/marker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;;;GAMG;AACH,MAAM,SAAS,GAAG,0DAA0D,CAAC;AAE7E,wCAAwC;AACxC,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,oBAAoB,EAAE,MAAM,CAAC;AACtC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,wFAAwF;IACxF,kFAAkF;IAClF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7C,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,40 @@
+/**
+ * The projection planner. Pure — and the purity is the point.
+ *
+ * This module imports no `node:fs`, no `node:child_process`, and not `gh.ts`. A test
+ * pins that over the import graph, which is what makes "planning needs no network" a
+ * property of the code rather than a claim about the test suite: hand the command a
+ * runner that throws on every invocation and planning still succeeds, because the
+ * planner never had one.
+ *
+ * Refusals are **values**, in a fixed order, so a tree with two problems always yields
+ * the same message and the command layer — not this module — decides the exit code.
+ *
+ * Requirements: roadmap-issue-projection/AC-14 … roadmap-issue-projection/AC-32,
+ * roadmap-issue-projection/AC-44
+ *
+ * @module
+ */
+import type { SyncConfig } from './config.js';
+import { type Plan, type ProjectableItem, type RemoteIssue, type UnprojectableRef } from './types.js';
+/** GitHub's own issue-title limit. */
+export declare const MAX_ISSUE_TITLE_LENGTH = 256;
+export interface PlanInput {
+    config: SyncConfig;
+    items: readonly ProjectableItem[];
+    unprojectable: readonly UnprojectableRef[];
+    issues: readonly RemoteIssue[];
+    retireIneligible: boolean;
+    /** Printed in the plan header and the prompt. */
+    repoLabel: string;
+}
+export type PlanResult = {
+    kind: 'ok';
+    plan: Plan;
+    warnings: readonly string[];
+} | {
+    kind: 'refused';
+    error: string;
+};
+export declare function planProjection(input: PlanInput): PlanResult;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/roadmap/sync/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,EAIL,KAAK,IAAI,EAET,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACtB,MAAM,YAAY,CAAC;AAEpB,sCAAsC;AACtC,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAClC,aAAa,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC3C,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,CAgE3D"}