@rasensio/aidlc 1.66.0 → 1.67.0

package/dist/roadmap/view-html.js

@@ -0,0 +1,317 @@
+/**
+ * The roadmap page as one HTML string (html-roadmap-view).
+ *
+ * Pure: a `RoadmapView` in, bytes out. The only time-dependent text is the generated-at
+ * line, so two pages built from the same items differ in that line alone (AC-10) — ages
+ * are left to the page script for exactly that reason.
+ *
+ * Every item-derived string goes through `escapeHtml`, in text and in double-quoted
+ * attributes alike (AC-12); there is no second escaping scheme anywhere on the page.
+ * That is why DOM ids are positions (`card-i3`) rather than item ids, and why each side
+ * panel is a `<template>` of escaped HTML rather than JSON inside a script, which would
+ * need its own escaper for `</script>`. The Content-Security-Policy allows the one style
+ * block and the one script by hash (AC-13), so a string that escaped escaping would still
+ * not run.
+ *
+ * @module
+ */
+import { createHash } from 'node:crypto';
+import { NODE_H, NODE_W } from './graph.js';
+import { ROADMAP_STATUSES } from './paths.js';
+import { VIEW_SCRIPT, VIEW_STYLE } from './view-assets.js';
+/** Done cards shown before "show all" (AC-18). */
+export const DONE_VISIBLE = 20;
+/** Map labels are cut to this many code points; the full title is in the node's `<title>`. */
+const LABEL_MAX = 34;
+const COLUMN_NAME = {
+    inbox: 'Inbox',
+    backlog: 'Backlog',
+    'in-progress': 'In progress',
+    done: 'Done',
+    hold: 'Hold',
+};
+const STATUS_TEXT = {
+    inbox: 'inbox',
+    backlog: 'backlog',
+    'in-progress': 'in progress',
+    done: 'done',
+    hold: 'hold',
+};
+const ENTITIES = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+    '`': '&#96;',
+};
+/** Escape text for HTML text and double-quoted attribute values alike. */
+export function escapeHtml(text) {
+    return text.replace(/[&<>"'`]/g, (c) => ENTITIES[c]);
+}
+/** A CSP source expression for `text`. */
+export function cspHash(text) {
+    return `'sha256-${createHash('sha256').update(text, 'utf8').digest('base64')}'`;
+}
+/** The policy the page carries: nothing loads, and only this page's own style and script run. */
+export function contentSecurityPolicy() {
+    return `default-src 'none'; style-src ${cspHash(VIEW_STYLE)}; script-src ${cspHash(VIEW_SCRIPT)}; base-uri 'none'; form-action 'none'`;
+}
+/** `**bold**` and `` `code` `` inside one line; every other character is escaped. Emits no links. */
+function inline(md) {
+    return md
+        .split(/(\*\*[^*\n]+\*\*|`[^`\n]+`)/)
+        .map((part) => {
+        if (/^\*\*[^*\n]+\*\*$/.test(part))
+            return `<strong>${escapeHtml(part.slice(2, -2))}</strong>`;
+        if (/^`[^`\n]+`$/.test(part))
+            return `<code>${escapeHtml(part.slice(1, -1))}</code>`;
+        return escapeHtml(part);
+    })
+        .join('');
+}
+/**
+ * The executive summary as HTML: paragraphs and `- ` lists, with bold and code spans.
+ *
+ * Tokenised from the raw markdown and escaped piece by piece, so markup in an item is text
+ * on the page. Deliberately not a markdown library: the summaries are six bullets, and a
+ * library would be the first dependency the page grows.
+ */
+export function renderSummary(markdown) {
+    const blocks = [];
+    let para = [];
+    let list = [];
+    const flushPara = () => {
+        if (para.length > 0)
+            blocks.push(`<p>${inline(para.join(' '))}</p>`);
+        para = [];
+    };
+    const flushList = () => {
+        if (list.length > 0)
+            blocks.push(`<ul>${list.map((li) => `<li>${inline(li)}</li>`).join('')}</ul>`);
+        list = [];
+    };
+    for (const raw of markdown.split('\n')) {
+        const line = raw.trim();
+        const bullet = /^[-*]\s+(.*)$/.exec(line);
+        if (line === '') {
+            flushPara();
+            flushList();
+        }
+        else if (bullet) {
+            flushPara();
+            list.push(bullet[1]);
+        }
+        else if (list.length > 0 && /^\s/.test(raw)) {
+            // A wrapped bullet: an indented line continues the item above it.
+            list[list.length - 1] += ` ${line}`;
+        }
+        else {
+            flushList();
+            para.push(line);
+        }
+    }
+    flushPara();
+    flushList();
+    return blocks.join('');
+}
+function truncate(text) {
+    const points = Array.from(text);
+    return points.length <= LABEL_MAX ? text : `${points.slice(0, LABEL_MAX - 1).join('')}…`;
+}
+function link(href, text) {
+    return href === null ? null : `<a href="${escapeHtml(href)}">${escapeHtml(text)}</a>`;
+}
+function itemLinks(v) {
+    const parts = [
+        link(v.links.item, 'item file'),
+        link(v.links.instance, `instance ${v.instanceName ?? ''}`.trim()),
+        link(v.links.retrospective, 'retrospective'),
+        link(v.links.pulls, 'pull requests'),
+    ].filter((p) => p !== null);
+    return parts.length === 0 ? '' : `<p class="links">${parts.join(' · ')}</p>`;
+}
+function badges(v) {
+    return [
+        v.ready ? '<span class="badge ready">ready</span>' : '',
+        v.blocked ? '<span class="badge blocked">blocked</span>' : '',
+    ].join('');
+}
+function holdLine(v) {
+    if (v.hold === null)
+        return '';
+    return `<p class="hold"><strong>${v.hold.kind}</strong> — ${escapeHtml(v.hold.reason ?? 'no reason recorded')}</p>`;
+}
+function card(v, capped) {
+    const classes = ['card', `s-${v.status}`, v.ready ? 'ready' : '', v.blocked ? 'blocked' : '', capped ? 'capped' : '']
+        .filter((c) => c !== '')
+        .join(' ');
+    const rank = v.rank === null ? '' : `<span class="rank">#${v.rank}</span> `;
+    const age = v.createdAt === null ? '' : `<time class="age" datetime="${v.createdAt}">created ${v.createdAt}</time>`;
+    const marks = badges(v) + age;
+    return [
+        `<li class="${classes}" id="card-${v.ref}" data-ref="${v.ref}" data-search="${escapeHtml(`${v.title} ${v.id ?? v.key}`.toLowerCase())}">`,
+        `<p class="title"><button type="button" class="open" aria-haspopup="dialog">${rank}${escapeHtml(v.title)}</button></p>`,
+        marks === '' ? '' : `<p class="marks">${marks}</p>`,
+        holdLine(v),
+        itemLinks(v),
+        '</li>',
+    ].join('');
+}
+function column(view, byRef, status) {
+    const refs = view.columns[status];
+    const cards = refs.map((ref, n) => card(byRef.get(ref), status === 'done' && n >= DONE_VISIBLE)).join('\n');
+    const more = status === 'done' && refs.length > DONE_VISIBLE
+        ? `<button type="button" class="show-all" aria-expanded="false" data-more="Show all (${refs.length})" data-less="Show the latest ${DONE_VISIBLE}">Show all (${refs.length})</button>`
+        : '';
+    return [
+        `<section class="col s-${status}" aria-labelledby="col-${status}">`,
+        `<h3 id="col-${status}">${COLUMN_NAME[status]} <span class="count">${refs.length}</span></h3>`,
+        `<ol class="cards">${cards === '' ? '' : `\n${cards}\n`}</ol>`,
+        more,
+        '</section>',
+    ].join('\n');
+}
+function labelOf(view, byRef, ref) {
+    const item = byRef.get(ref);
+    if (item !== undefined) {
+        return { title: item.title, statusText: STATUS_TEXT[item.status], cls: `s-${item.status}`, blocked: item.blocked };
+    }
+    const missing = view.missing.find((m) => m.ref === ref);
+    return { title: `missing: ${missing.id}`, statusText: 'no item has this id', cls: 'missing', blocked: false };
+}
+function svgNode(l, ref, x, y, chain, sub) {
+    const sub2 = l.blocked ? `${l.statusText} · blocked` : l.statusText;
+    return (`<g class="node ${l.cls}" id="node-${ref}" data-ref="${ref}" data-x="${x}" data-y="${y}" data-cx="${NODE_W / 2}" data-cy="${NODE_H / 2}" ` +
+        `data-chain="${chain.join(' ')}" data-sub="${sub.join(' ')}" transform="translate(${x} ${y})" tabindex="0" role="button" ` +
+        `aria-label="${escapeHtml(`${l.title} — ${sub2}`)}">` +
+        `<title>${escapeHtml(l.title)}</title><rect width="${NODE_W}" height="${NODE_H}" rx="6"/>` +
+        `<text class="label" x="10" y="20">${escapeHtml(truncate(l.title))}</text><text class="sub" x="10" y="38">${escapeHtml(sub2)}</text></g>`);
+}
+function mapSection(view, byRef) {
+    const { layout } = view;
+    const at = new Map(layout.nodes.map((n) => [n.ref, n]));
+    const edges = layout.edges.map((e) => {
+        const a = at.get(e.from);
+        const b = at.get(e.to);
+        const [x1, y1, x2, y2] = [a.x + NODE_W, a.y + NODE_H / 2, b.x, b.y + NODE_H / 2];
+        const mx = (x1 + x2) / 2;
+        return `<path class="edge${e.dashed ? ' dashed' : ''}" data-from="${e.from}" data-to="${e.to}" d="M${x1} ${y1} C${mx} ${y1} ${mx} ${y2} ${x2} ${y2}"/>`;
+    });
+    const nodes = layout.nodes.map((n) => svgNode(labelOf(view, byRef, n.ref), n.ref, n.x, n.y, n.chain, n.subtree));
+    const toggles = layout.nodes
+        .filter((n) => n.subtree.length > 0)
+        .map((n) => `<g class="toggle" data-toggle="${n.ref}" transform="translate(${n.x + NODE_W} ${n.y + NODE_H / 2})" tabindex="0" role="button" aria-expanded="true" ` +
+        `aria-label="${escapeHtml(`Collapse or expand what sits under ${labelOf(view, byRef, n.ref).title}`)}"><circle r="10"/><text y="5">−</text></g>`);
+    const unlinked = layout.unlinked.map((u) => svgNode(labelOf(view, byRef, u.ref), u.ref, u.x, u.y, [], []));
+    const legend = ROADMAP_STATUSES.map((s) => `<span class="sw s-${s}"></span>${STATUS_TEXT[s]}`).join('') + '<span class="sw missing"></span>missing id';
+    const unlinkedButton = layout.unlinked.length === 0
+        ? ''
+        : ` <button type="button" id="unlinked-toggle" aria-pressed="false" data-count="${layout.unlinked.length}">Show unlinked items (${layout.unlinked.length})</button>`;
+    const empty = layout.nodes.length === 0 ? '<p class="empty">No dependencies yet: no item depends on another.</p>' : '';
+    return [
+        '<section class="map-section" aria-labelledby="map-h">',
+        '<h2 id="map-h">Dependency map</h2>',
+        empty,
+        `<p class="map-controls"><button type="button" id="fit">Fit to screen</button>${unlinkedButton}</p>`,
+        `<p class="legend">Colour is status:${legend}. Dashed links are further dependencies; a blocked item needs something not yet done.</p>`,
+        '<div class="map-wrap">',
+        `<svg id="map" role="group" aria-label="Dependency map: drag to pan, scroll or pinch to zoom" data-linked-w="${layout.linkedSize.width}" data-linked-h="${layout.linkedSize.height}" data-full-w="${layout.fullSize.width}" data-full-h="${layout.fullSize.height}">`,
+        '<g id="viewport">',
+        `<g class="edges">${edges.join('')}</g>`,
+        `<g class="forest">${nodes.join('\n')}</g>`,
+        `<g class="toggles">${toggles.join('')}</g>`,
+        `<g class="unlinked off">${unlinked.join('\n')}</g>`,
+        '</g>',
+        '</svg>',
+        '</div>',
+        '</section>',
+    ]
+        .filter((l) => l !== '')
+        .join('\n');
+}
+function refList(view, byRef, refs) {
+    if (refs.length === 0)
+        return '<p>Nothing.</p>';
+    const items = refs.map((ref) => {
+        const l = labelOf(view, byRef, ref);
+        const target = byRef.has(ref) ? `card-${ref}` : `node-${ref}`;
+        return `<li><a href="#${target}" data-goto="${ref}">${escapeHtml(l.title)}</a> (${escapeHtml(l.statusText)})</li>`;
+    });
+    return `<ul>${items.join('')}</ul>`;
+}
+function detail(view, byRef, v) {
+    const rank = v.rank === null ? '' : ` · rank #${v.rank}`;
+    return [
+        `<template id="detail-${v.ref}">`,
+        `<h2 id="panel-title">${escapeHtml(v.title)}</h2>`,
+        `<p class="meta">${STATUS_TEXT[v.status]}${rank} · <code>${escapeHtml(v.id ?? v.filename)}</code></p>`,
+        badges(v) === '' ? '' : `<p>${badges(v)}</p>`,
+        holdLine(v),
+        '<h3>Executive summary</h3>',
+        v.summary === null ? '<p>No executive summary.</p>' : renderSummary(v.summary),
+        '<h3>Needs</h3>',
+        refList(view, byRef, v.depRefs),
+        '<h3>Needed by</h3>',
+        refList(view, byRef, v.dependentRefs),
+        itemLinks(v),
+        '</template>',
+    ].join('');
+}
+function missingDetail(view, byRef, m) {
+    return [
+        `<template id="detail-${m.ref}">`,
+        `<h2 id="panel-title">missing: ${escapeHtml(m.id)}</h2>`,
+        '<p>No item carries this id, so everything that depends on it is blocked. Check <code>depends_on</code> for a typo.</p>',
+        '<h3>Needed by</h3>',
+        refList(view, byRef, m.dependentRefs),
+        '</template>',
+    ].join('');
+}
+/** "2026-10-06 22:19 UTC" — minutes are enough to tell two pages apart. */
+function humanTime(iso) {
+    return `${iso.slice(0, 10)} ${iso.slice(11, 16)} UTC`;
+}
+/** Render the page. Pure. */
+export function renderView(view) {
+    const byRef = new Map(view.items.map((v) => [v.ref, v]));
+    return [
+        '<!doctype html>',
+        '<html lang="en">',
+        '<head>',
+        '<meta charset="utf-8">',
+        `<meta http-equiv="Content-Security-Policy" content="${contentSecurityPolicy()}">`,
+        '<meta name="viewport" content="width=device-width, initial-scale=1">',
+        '<title>Roadmap</title>',
+        `<style>${VIEW_STYLE}</style>`,
+        '</head>',
+        '<body>',
+        '<header class="top">',
+        '<h1>Roadmap</h1>',
+        `<p class="generated">Generated <time datetime="${view.generatedAt}">${humanTime(view.generatedAt)}</time> by <code>aidlc roadmap view</code></p>`,
+        '<p class="search"><label for="q">Search titles and ids</label> <input id="q" type="search" autocomplete="off"></p>',
+        '<p class="search-status" id="search-status" aria-live="polite"></p>',
+        '</header>',
+        '<main>',
+        '<section aria-labelledby="board-h">',
+        '<h2 id="board-h">Board</h2>',
+        '<div class="board">',
+        ...ROADMAP_STATUSES.map((s) => column(view, byRef, s)),
+        '</div>',
+        '</section>',
+        mapSection(view, byRef),
+        '</main>',
+        '<aside id="panel" class="panel" role="dialog" aria-modal="false" aria-labelledby="panel-title" hidden>',
+        '<button type="button" class="close" id="panel-close" aria-label="Close the panel">×</button>',
+        '<div id="panel-body"></div>',
+        '</aside>',
+        ...view.items.map((v) => detail(view, byRef, v)),
+        ...view.missing.map((m) => missingDetail(view, byRef, m)),
+        '<footer><p>Cost per item is reported by <code>aidlc metrics</code>; this page shows none.</p></footer>',
+        `<script>${VIEW_SCRIPT}</script>`,
+        '</body>',
+        '</html>',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=view-html.js.map

package/dist/roadmap/view-html.js.map

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

package/dist/roadmap/view-model.d.ts

@@ -0,0 +1,93 @@
+/**
+ * What `aidlc roadmap view` shows, before any HTML (html-roadmap-view).
+ *
+ * `readView` is the only function here that touches the disk or git: it lists the primary
+ * checkout's items, asks `pickNextAt` for the ready set, and resolves each instance's
+ * folder, branch and the `origin` remote. `buildView` turns that into columns, marks and
+ * links and is pure, so every board criterion is a test over in-memory items.
+ *
+ * Every link is relative to the directory the page is written to, so the page works from
+ * `file://` wherever it lands, and nothing in it points off the page except GitHub
+ * (AC-11). A link that cannot be made relative — another drive on Windows — is omitted
+ * rather than written as an absolute `file://` URL.
+ *
+ * @module
+ */
+import { type MapLayout } from './graph.js';
+import { type RoadmapItem, type RoadmapStatus } from './paths.js';
+import type { RepoCoords } from './sync/body.js';
+export interface HoldNote {
+    kind: 'parked' | 'declined' | 'on hold';
+    reason: string | null;
+}
+export interface ItemLinks {
+    item: string | null;
+    instance: string | null;
+    retrospective: string | null;
+    pulls: string | null;
+}
+export interface ViewItem {
+    /** `i<n>`: position in the global order, and the suffix of every DOM id for it. */
+    ref: string;
+    key: string;
+    id: string | null;
+    filename: string;
+    status: RoadmapStatus;
+    title: string;
+    /** Backlog rank, or null when unranked, malformed, or not in backlog. */
+    rank: number | null;
+    createdAt: string | null;
+    /** Date of the last history entry. */
+    finishedAt: string | null;
+    depRefs: string[];
+    dependentRefs: string[];
+    blocked: boolean;
+    ready: boolean;
+    hold: HoldNote | null;
+    summary: string | null;
+    instanceName: string | null;
+    links: ItemLinks;
+}
+export interface RoadmapView {
+    items: ViewItem[];
+    columns: Record<RoadmapStatus, string[]>;
+    missing: {
+        ref: string;
+        id: string;
+        dependentRefs: string[];
+    }[];
+    layout: MapLayout;
+    generatedAt: string;
+}
+export interface ViewSources {
+    /** Directory the page is written to; every file link is relative to it. */
+    outDir: string;
+    /** `<primary checkout>/.aidlc/state`. */
+    stateRoot: string;
+    repo: RepoCoords | null;
+    branchOf(instance: string): string | null;
+    /** Backlog file names `roadmap next` would offer. */
+    ready: ReadonlySet<string>;
+}
+export declare function holdNote(reason: unknown): HoldNote;
+/** A relative, percent-encoded href from `fromDir` to `target`, or null when none exists. */
+export declare function relativeHref(fromDir: string, target: string): string | null;
+/** GitHub's pull-request search for one head branch (AC-22). A branch link would 404 once merged. */
+export declare function pullsUrl(repo: RepoCoords, branch: string): string;
+/**
+ * `owner`/`name` from an `origin` URL, or null when it is not a GitHub repository (AC-23).
+ * Accepts the https, scp-like ssh and `ssh://` forms, with or without `.git`.
+ */
+export declare function parseGitHubRemote(url: string): RepoCoords | null;
+/** Build the view. Pure: the same items and sources give the same view. */
+export declare function buildView(items: readonly RoadmapItem[], sources: ViewSources, now: Date): RoadmapView;
+/** `branch` from an instance's `instance.yaml`, or null. */
+export declare function instanceBranch(stateRoot: string, instance: string): string | null;
+/** The `origin` remote as GitHub coordinates, or null — no remote, not GitHub, or no git. */
+export declare function originCoords(cwd: string): RepoCoords | null;
+/**
+ * Read the primary checkout's roadmap — the items `roadmap next` reads, from whichever
+ * worktree this runs in (AC-8) — and build the view for a page written to `outFile`.
+ */
+export declare function readView(cwd: string, outFile: string, now: Date): RoadmapView;
+//# sourceMappingURL=view-model.d.ts.map

package/dist/roadmap/view-model.d.ts.map

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

package/dist/roadmap/view-model.js

@@ -0,0 +1,194 @@
+/**
+ * What `aidlc roadmap view` shows, before any HTML (html-roadmap-view).
+ *
+ * `readView` is the only function here that touches the disk or git: it lists the primary
+ * checkout's items, asks `pickNextAt` for the ready set, and resolves each instance's
+ * folder, branch and the `origin` remote. `buildView` turns that into columns, marks and
+ * links and is pure, so every board criterion is a test over in-memory items.
+ *
+ * Every link is relative to the directory the page is written to, so the page works from
+ * `file://` wherever it lands, and nothing in it points off the page except GitHub
+ * (AC-11). A link that cannot be made relative — another drive on Windows — is omitted
+ * rather than written as an absolute `file://` URL.
+ *
+ * @module
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { execFileSync } from 'node:child_process';
+import { dirname, isAbsolute, join, relative, sep } from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { openRegistry } from '../concurrency/registry.js';
+import { isSafeSegment } from '../core/paths.js';
+import { layoutMap } from './graph.js';
+import { compareCandidates, parsePriority, pickNextAt } from './next.js';
+import { frontmatter, itemBody, listStatusAt, primaryCheckout, roadmapRoot, ROADMAP_STATUSES, } from './paths.js';
+import { summarySection } from './summary.js';
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+/** A `YYYY-MM-DD` date from YAML, which may have parsed it as a string or a Date. */
+function dateOf(raw) {
+    if (raw instanceof Date && !Number.isNaN(raw.getTime()))
+        return raw.toISOString().slice(0, 10);
+    return typeof raw === 'string' && DATE_RE.test(raw) ? raw : null;
+}
+function lastHistoryEntry(data) {
+    const history = data.history;
+    if (!Array.isArray(history) || history.length === 0)
+        return null;
+    const last = history[history.length - 1];
+    return typeof last === 'object' && last !== null ? last : null;
+}
+/** The `parked — ` / `declined — ` prefix the park and triage flows write (AC-19). */
+const HOLD_PREFIX_RE = /^(parked|declined)\b\s*(?:[—–-]\s*)?/;
+export function holdNote(reason) {
+    if (typeof reason !== 'string' || reason.trim() === '')
+        return { kind: 'on hold', reason: null };
+    const match = HOLD_PREFIX_RE.exec(reason);
+    if (!match)
+        return { kind: 'on hold', reason };
+    const rest = reason.slice(match[0].length).trim();
+    return { kind: match[1], reason: rest === '' ? null : rest };
+}
+/** A relative, percent-encoded href from `fromDir` to `target`, or null when none exists. */
+export function relativeHref(fromDir, target) {
+    const rel = relative(fromDir, target);
+    if (rel === '' || isAbsolute(rel))
+        return null;
+    return rel.split(sep).map(encodeURIComponent).join('/');
+}
+/** GitHub's pull-request search for one head branch (AC-22). A branch link would 404 once merged. */
+export function pullsUrl(repo, branch) {
+    return `https://github.com/${repo.owner}/${repo.name}/pulls?q=is%3Apr+head%3A${encodeURIComponent(branch)}`;
+}
+const OWNER_OR_NAME_RE = /^[A-Za-z0-9_.-]+$/;
+/**
+ * `owner`/`name` from an `origin` URL, or null when it is not a GitHub repository (AC-23).
+ * Accepts the https, scp-like ssh and `ssh://` forms, with or without `.git`.
+ */
+export function parseGitHubRemote(url) {
+    const m = /^https:\/\/(?:[^@/]+@)?github\.com\/([^/]+)\/([^/]+?)(?:\.git)?\/?$/.exec(url.trim()) ??
+        /^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?$/.exec(url.trim()) ??
+        /^ssh:\/\/git@github\.com(?::\d+)?\/([^/]+)\/([^/]+?)(?:\.git)?\/?$/.exec(url.trim());
+    if (!m)
+        return null;
+    const [, owner, name] = m;
+    if (!OWNER_OR_NAME_RE.test(owner) || !OWNER_OR_NAME_RE.test(name) || name === '.' || name === '..')
+        return null;
+    return { owner, name };
+}
+/** Build the view. Pure: the same items and sources give the same view. */
+export function buildView(items, sources, now) {
+    const doneIds = new Set(items.filter((i) => i.status === 'done' && i.id !== null).map((i) => i.id));
+    const parsed = items.map((item, n) => {
+        const data = frontmatter(item.raw)?.data ?? {};
+        const deps = Array.isArray(data.depends_on)
+            ? data.depends_on.filter((d) => typeof d === 'string')
+            : [];
+        return { item, ref: `i${n}`, key: item.id ?? item.filename.replace(/\.md$/, ''), data, deps };
+    });
+    const layout = layoutMap(parsed.map((p) => ({ ref: p.ref, key: p.key, deps: p.deps })));
+    const viewItems = parsed.map(({ item, ref, key, data, deps }) => {
+        const priority = parsePriority(data.priority);
+        const last = lastHistoryEntry(data);
+        let instanceName = null;
+        const links = { item: relativeHref(sources.outDir, item.file), instance: null, retrospective: null, pulls: null };
+        // `promoted_to` is tracked YAML; it becomes a path only once it is one safe segment.
+        if (item.promotedTo !== null && isSafeSegment(item.promotedTo)) {
+            instanceName = item.promotedTo;
+            const dir = join(sources.stateRoot, instanceName);
+            if (existsSync(dir)) {
+                const href = relativeHref(sources.outDir, dir);
+                links.instance = href === null ? null : `${href}/`;
+                const retro = join(dir, 'retrospective.md');
+                if (existsSync(retro))
+                    links.retrospective = relativeHref(sources.outDir, retro);
+            }
+            const branch = sources.branchOf(instanceName);
+            if (branch !== null && sources.repo !== null)
+                links.pulls = pullsUrl(sources.repo, branch);
+        }
+        const summary = summarySection(itemBody(item.raw))?.trim() ?? '';
+        return {
+            ref,
+            key,
+            id: item.id,
+            filename: item.filename,
+            status: item.status,
+            title: item.title ?? item.filename,
+            rank: item.status === 'backlog' && typeof priority === 'number' ? priority : null,
+            createdAt: dateOf(data.created_at),
+            finishedAt: last === null ? null : dateOf(last.at),
+            depRefs: layout.links[ref].needs,
+            dependentRefs: layout.links[ref].neededBy,
+            // The rule `pickNext` uses: a dependency counts only once an item carrying its id is done (AC-26).
+            blocked: deps.some((d) => !doneIds.has(d)),
+            ready: item.status === 'backlog' && sources.ready.has(item.filename),
+            hold: item.status === 'hold' ? holdNote(last?.reason) : null,
+            summary: summary === '' ? null : summary,
+            instanceName,
+            links,
+        };
+    });
+    const columns = Object.fromEntries(ROADMAP_STATUSES.map((s) => [s, []]));
+    for (const v of viewItems)
+        columns[v.status].push(v);
+    // Same comparator `roadmap next` sorts with; a malformed rank sorts as unranked (AC-16).
+    columns.backlog.sort((a, b) => compareCandidates({ file: a.filename, id: a.id, title: a.title, priority: a.rank }, { file: b.filename, id: b.id, title: b.title, priority: b.rank }));
+    // Most recently finished first; an item with no dated history sinks to the end (AC-18).
+    columns.done.sort((a, b) => {
+        if (a.finishedAt !== b.finishedAt) {
+            if (a.finishedAt === null)
+                return 1;
+            if (b.finishedAt === null)
+                return -1;
+            return a.finishedAt < b.finishedAt ? 1 : -1;
+        }
+        return a.filename < b.filename ? 1 : a.filename > b.filename ? -1 : 0;
+    });
+    return {
+        items: viewItems,
+        columns: Object.fromEntries(ROADMAP_STATUSES.map((s) => [s, columns[s].map((v) => v.ref)])),
+        missing: layout.missing.map((m) => ({ ...m, dependentRefs: layout.links[m.ref].neededBy })),
+        layout,
+        generatedAt: now.toISOString(),
+    };
+}
+/** `branch` from an instance's `instance.yaml`, or null. */
+export function instanceBranch(stateRoot, instance) {
+    try {
+        const data = parseYaml(readFileSync(join(stateRoot, instance, 'instance.yaml'), 'utf8'));
+        const branch = typeof data === 'object' && data !== null ? data.branch : null;
+        return typeof branch === 'string' && branch.length > 0 ? branch : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** The `origin` remote as GitHub coordinates, or null — no remote, not GitHub, or no git. */
+export function originCoords(cwd) {
+    try {
+        const url = execFileSync('git', ['remote', 'get-url', 'origin'], {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return parseGitHubRemote(url);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read the primary checkout's roadmap — the items `roadmap next` reads, from whichever
+ * worktree this runs in (AC-8) — and build the view for a page written to `outFile`.
+ */
+export function readView(cwd, outFile, now) {
+    const root = roadmapRoot(cwd);
+    const primary = primaryCheckout(cwd);
+    const items = ROADMAP_STATUSES.flatMap((s) => listStatusAt(root, s));
+    const ready = new Set(pickNextAt(root).ready.map((c) => c.file));
+    const stateRoot = join(primary, '.aidlc', 'state');
+    const registry = openRegistry(primary);
+    const branchOf = (instance) => instanceBranch(stateRoot, instance) ?? registry?.lookup(instance)?.branch ?? null;
+    return buildView(items, { outDir: dirname(outFile), stateRoot, repo: originCoords(primary), branchOf, ready }, now);
+}
+//# sourceMappingURL=view-model.js.map