felenova-backlog 0.1.0

package/dist/_core/markdown/items.js

@@ -0,0 +1,256 @@
+import YAML from 'yaml';
+import { Item } from '../schema.js';
+import { deepEqual } from '../util/deep-equal.js';
+export class ItemParseError extends Error {
+    path;
+    problems;
+    constructor(path, problems) {
+        super(`${path}: ${problems.length} problem(s)\n  - ${problems.join('\n  - ')}`);
+        this.path = path;
+        this.problems = problems;
+        this.name = 'ItemParseError';
+    }
+}
+/** §4.1 field order — also the canonical output order. */
+export const FRONTMATTER_FIELDS = [
+    'id',
+    'title',
+    'status',
+    'domain',
+    'priority',
+    'origin',
+    'created',
+    'updated',
+    'prerequisites',
+    'blocks',
+    'criteria_status',
+    'revisit_when',
+    'track',
+    'shipped_commit',
+    'production_date',
+];
+export const REQUIRED_SECTIONS = [
+    'What',
+    'Why',
+    'Acceptance criteria',
+    'Critique / risks',
+    'Out of scope',
+    'Dependencies & sequencing',
+];
+/**
+ * Narrow alias table for headings real liblib-meet items use for a required section.
+ * Parsing only — canonical export always writes the canonical heading, and the verbatim
+ * path re-emits the raw body, so an aliased file stays byte-exact until it is edited.
+ */
+const SECTION_ALIASES = [
+    ['Critique / shape', 'Critique / risks'],
+];
+function splitFrontmatter(text, path) {
+    if (!text.startsWith('---\n'))
+        throw new ItemParseError(path, ['no frontmatter (file must start with ---)']);
+    const end = text.indexOf('\n---\n', 4);
+    if (end < 0)
+        throw new ItemParseError(path, ['unterminated frontmatter']);
+    return { frontmatterRaw: text.slice(4, end), bodyRaw: text.slice(end + 5) };
+}
+function finishSection(c) {
+    const matches = (name) => c.heading === name || c.heading.startsWith(`${name} (`);
+    const canonical = REQUIRED_SECTIONS.find(matches) ??
+        SECTION_ALIASES.find(([alias]) => matches(alias))?.[1] ??
+        null;
+    return { heading: c.heading, canonical, text: c.lines.join('\n').trim() };
+}
+/** Split a body on `## ` headings. A required heading matches `## Name` or `## Name (…`. */
+function splitSections(body) {
+    const lines = body.split('\n');
+    const sections = [];
+    const preamble = [];
+    let current = null;
+    for (const line of lines) {
+        const m = /^## (.+?)\s*$/.exec(line);
+        if (m?.[1] !== undefined) {
+            if (current)
+                sections.push(finishSection(current));
+            current = { heading: m[1], lines: [] };
+        }
+        else if (current)
+            current.lines.push(line);
+        else
+            preamble.push(line);
+    }
+    if (current)
+        sections.push(finishSection(current));
+    return { sections, preamble: preamble.join('\n') };
+}
+const CHECKBOX = /^\s*-\s*\[([ xX])\]\s*(.+?)\s*$/;
+/**
+ * Parse an `## Acceptance criteria` section into its checkboxes and the prose around them.
+ *
+ * Real items wrap a criterion over indented continuation lines and hang sub-bullets or a
+ * numbered precedence list under it (liblib-meet RP-004, RP-032): an indented line that is not
+ * itself a checkbox continues the criterion above it and is folded in with a single space.
+ * Every other non-checkbox line is section prose (liblib-meet AI-001's `*Pending — …*` note,
+ * RP-032's `### ` group headings) and is kept in `notes` so canonical export loses nothing.
+ */
+export function parseCriteriaSection(sectionText) {
+    const criteria = [];
+    const notes = [];
+    let open = false; // the previous line was a criterion or one of its continuation lines
+    for (const line of sectionText.split('\n')) {
+        const m = CHECKBOX.exec(line);
+        if (m?.[2] !== undefined) {
+            criteria.push({ index: criteria.length + 1, text: m[2], done: m[1] !== ' ' });
+            open = true;
+            continue;
+        }
+        const last = criteria[criteria.length - 1];
+        if (open && last && /^\s+\S/.test(line)) {
+            last.text = `${last.text} ${line.trim()}`;
+            continue;
+        }
+        open = false;
+        notes.push(line);
+    }
+    return { criteria, notes: notes.join('\n').trim() };
+}
+export function parseCriteria(sectionText) {
+    return parseCriteriaSection(sectionText).criteria;
+}
+export function parseItem(text, path) {
+    const { frontmatterRaw, bodyRaw } = splitFrontmatter(text, path);
+    const problems = [];
+    let fm = {};
+    try {
+        const parsed = YAML.parse(frontmatterRaw, { schema: 'core' });
+        if (parsed && typeof parsed === 'object')
+            fm = parsed;
+        else
+            problems.push('frontmatter is not a mapping');
+    }
+    catch (e) {
+        problems.push(`frontmatter YAML: ${e.message}`);
+    }
+    for (const f of FRONTMATTER_FIELDS)
+        if (!(f in fm))
+            problems.push(`missing frontmatter field: ${f}`);
+    const filenameId = path.replace(/^.*\//, '').replace(/\.md$/, '');
+    if (fm.id !== undefined && String(fm.id) !== filenameId)
+        problems.push(`id ${String(fm.id)} does not match filename ${filenameId}`);
+    const { sections, preamble } = splitSections(bodyRaw);
+    const found = {};
+    const extra = [];
+    for (const s of sections) {
+        if (s.canonical && !found[s.canonical])
+            found[s.canonical] = s;
+        else
+            extra.push({ heading: s.heading, text: s.text });
+    }
+    for (const name of REQUIRED_SECTIONS)
+        if (!found[name])
+            problems.push(`missing section: ## ${name}`);
+    const order = REQUIRED_SECTIONS.map((n) => sections.findIndex((s) => s === found[n])).filter((i) => i >= 0);
+    if (order.some((v, i) => i > 0 && v < (order[i - 1] ?? -1)))
+        problems.push('required sections are out of order');
+    if (problems.length)
+        throw new ItemParseError(path, problems);
+    const str = (v) => (v == null ? '' : String(v));
+    const nul = (v) => (v == null ? null : String(v));
+    const section = (name) => found[name]?.text ?? '';
+    const ac = parseCriteriaSection(section('Acceptance criteria'));
+    const candidate = {
+        id: str(fm.id),
+        title: str(fm.title),
+        status: fm.status,
+        domain: str(fm.domain),
+        priority: fm.priority,
+        origin: str(fm.origin),
+        created: str(fm.created),
+        updated: str(fm.updated),
+        prerequisites: Array.isArray(fm.prerequisites) ? fm.prerequisites.map(String) : [],
+        blocks: Array.isArray(fm.blocks) ? fm.blocks.map(String) : [],
+        criteria_status: fm.criteria_status,
+        criteria_version: typeof fm.criteria_version === 'number' ? fm.criteria_version : 1,
+        revisit_when: str(fm.revisit_when),
+        track: nul(fm.track),
+        shipped_commit: nul(fm.shipped_commit),
+        production_date: nul(fm.production_date),
+        // liblib-meet predates the field: a rejected item keeps its rationale in the body (RP-003).
+        rejected_reason: nul(fm.rejected_reason) ?? (fm.status === 'rejected' ? 'see item body' : null),
+        what: section('What'),
+        why: section('Why'),
+        criteria: ac.criteria,
+        criteria_notes: ac.notes,
+        critique: section('Critique / risks'),
+        out_of_scope: section('Out of scope'),
+        dependencies_note: section('Dependencies & sequencing'),
+        extra_sections: extra,
+        preamble: preamble.trim(),
+    };
+    const result = Item.safeParse(candidate);
+    if (!result.success) {
+        throw new ItemParseError(path, result.error.issues.map((i) => `${i.path.join('.') || '(item)'}: ${i.message}`));
+    }
+    return { item: result.data, source: { path, frontmatterRaw, bodyRaw } };
+}
+// ---- serialisation -------------------------------------------------------------
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+const RESERVED_WORDS = new Set(['null', 'true', 'false', '~', 'yes', 'no', 'on', 'off']);
+/** Needs double quotes: empty, YAML-reserved words, a `: ` or newline inside, or an indicator/digit first char. */
+const NEEDS_QUOTES = /^["'#\-[\]{}&*!|>%@`?,+.]|^\d|: | #|^\s|\s$|\n/;
+function yamlScalar(v) {
+    if (v === null)
+        return 'null';
+    if (v === '')
+        return '""';
+    if (ISO_DATE.test(v))
+        return v;
+    // YAML 1.1 reserved words are case-insensitive: `True`, `NULL` and `Off` are booleans/null too.
+    if (RESERVED_WORDS.has(v.toLowerCase()))
+        return JSON.stringify(v);
+    return NEEDS_QUOTES.test(v) ? JSON.stringify(v) : v;
+}
+function yamlList(xs) {
+    return `[${xs.join(', ')}]`;
+}
+export function serializeItemCanonical(item) {
+    const fm = [];
+    for (const f of FRONTMATTER_FIELDS) {
+        const v = item[f];
+        fm.push(`${f}: ${Array.isArray(v) ? yamlList(v) : yamlScalar(v)}`);
+    }
+    if (item.criteria_version > 1)
+        fm.push(`criteria_version: ${item.criteria_version}`);
+    if (item.rejected_reason !== null)
+        fm.push(`rejected_reason: ${yamlScalar(item.rejected_reason)}`);
+    const boxes = item.criteria.map((c) => `- [${c.done ? 'x' : ' '}] ${c.text}`).join('\n');
+    const crit = item.criteria_notes ? `${item.criteria_notes}\n\n${boxes}`.trimEnd() : boxes;
+    const sections = [
+        ['What', item.what],
+        ['Why', item.why],
+        ['Acceptance criteria', crit],
+        ['Critique / risks', item.critique],
+        ['Out of scope', item.out_of_scope],
+        ['Dependencies & sequencing', item.dependencies_note],
+        ...item.extra_sections.map((s) => [s.heading, s.text]),
+    ];
+    const body = sections.map(([h, t]) => `## ${h}\n\n${t}`.trimEnd()).join('\n\n');
+    const head = item.preamble ? `${item.preamble}\n\n` : '';
+    return `---\n${fm.join('\n')}\n---\n\n${head}${body}\n`;
+}
+export function itemMatchesSource(item, source) {
+    try {
+        const again = parseItem(`---\n${source.frontmatterRaw}\n---\n${source.bodyRaw}`, source.path).item;
+        // Structural, not JSON-text: an item that has been through `jsonb` comes back with
+        // Postgres's key order, and a byte-identical item must still count as pristine.
+        return deepEqual(again, item);
+    }
+    catch {
+        return false;
+    }
+}
+export function serializeItem(item, source) {
+    if (source && itemMatchesSource(item, source))
+        return `---\n${source.frontmatterRaw}\n---\n${source.bodyRaw}`;
+    return serializeItemCanonical(item);
+}
+//# sourceMappingURL=items.js.map

package/dist/_core/markdown/items.js.map

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

package/dist/_core/markdown/matrix.d.ts

@@ -0,0 +1,20 @@
+import { type MatrixRow } from '../schema.js';
+export interface MatrixDoc {
+    path: string;
+    slug: string | null;
+    rows: MatrixRow[];
+    warnings: string[];
+    raw: string;
+}
+export declare function parseMatrixRowId(id: string): {
+    item: string;
+    ac: number;
+    m: number;
+} | null;
+export declare function parseMatrix(text: string, path: string): MatrixDoc;
+/** Ported from liblib-meet scripts/backlog/matrix.ts buildMatrixMd, grouped by item id in first-seen order. */
+export declare function buildMatrixMarkdown(slug: string, type: string, rows: MatrixRow[], generatedOn: string): string;
+export declare function serializeMatrix(doc: MatrixDoc, rows?: MatrixRow[], opts?: {
+    type?: string;
+    generatedOn?: string;
+}): string;

package/dist/_core/markdown/matrix.js

@@ -0,0 +1,147 @@
+import { MATRIX_STATUSES } from '../schema.js';
+import { deepEqual } from '../util/deep-equal.js';
+const ROW_ID = /^([A-Z][A-Z0-9]*-\d{3,})-AC(\d+)\.M(\d+)$/;
+const LEGACY_ID = /^[A-Z]\d+$/;
+/** `A1`/`A10` belong to section `A`, `B1` to section `B` — the checklist's own grouping. */
+const LEGACY_LETTER = /^([A-Z])\d+$/;
+const STATUS_SET = new Set(MATRIX_STATUSES);
+export function parseMatrixRowId(id) {
+    const m = ROW_ID.exec(id);
+    return m ? { item: m[1], ac: Number(m[2]), m: Number(m[3]) } : null;
+}
+function splitCells(line) {
+    // Strip exactly ONE leading pipe (plus one optional space) and exactly ONE trailing pipe.
+    // A greedy trailing strip would eat the delimiter of an empty last cell, so a row ending
+    // `… | ☐ | |` would lose its Notes cell and shift the status scan.
+    // Unescape "\|" produced by the canonical writer.
+    const trimmed = line.replace(/\s+$/, '');
+    const body = trimmed.endsWith('|') ? trimmed.slice(0, -1) : trimmed;
+    const inner = body.replace(/^\| ?/, '');
+    return inner.split(/ \| /).map((c) => c.replace(/\\\|/g, '|').trim());
+}
+export function parseMatrix(text, path) {
+    const slugMatch = /^# QA Matrix — `([^`]+)`/m.exec(text);
+    const rows = [];
+    const warnings = [];
+    for (const line of text.split('\n')) {
+        if (!line.startsWith('| '))
+            continue;
+        const cells = splitCells(line);
+        const id = cells[0] ?? '';
+        const parsedId = parseMatrixRowId(id);
+        const isLegacy = LEGACY_ID.test(id);
+        if (!parsedId && !isLegacy)
+            continue; // header, separator, summary tables
+        if (cells.length < 6) {
+            warnings.push(`${path}: row ${id}: only ${cells.length} cells — skipped`);
+            continue;
+        }
+        let statusIdx = -1;
+        for (let i = cells.length - 1; i >= 4; i--) {
+            if (STATUS_SET.has(cells[i]) || cells[i] === 'N/A') {
+                statusIdx = i;
+                break;
+            }
+        }
+        // A generated row has exactly 7 columns. More cells means an unescaped pipe inside one of
+        // them; parsing still works by position (status found by symbol), but say so out loud.
+        if (parsedId && cells.length > 7 && statusIdx !== 5)
+            warnings.push(`${path}: row ${id}: ${cells.length} cells (expected 7) — pipe inside a cell? parsed by position`);
+        const link = (linkedText) => parsedId && !/^§/.test(linkedText)
+            ? { item: parsedId.item, ac: parsedId.ac }
+            : { legacy: linkedText || id };
+        if (statusIdx < 0) {
+            // Nothing in the row looks like a status. Say exactly that and guess no column.
+            warnings.push(`${path}: row ${id}: no status symbol in any cell; treated as unparsed (status null)`);
+            const linkedText = cells.slice(4, cells.length - 1).join(' | ');
+            rows.push({
+                id,
+                what_to_verify: cells[1] ?? '',
+                how_to_verify: cells[2] ?? '',
+                test_type: cells[3] ?? '',
+                linked_criterion: link(linkedText),
+                linked_text: linkedText,
+                environment: null,
+                status: null,
+                status_raw: '',
+                notes: cells[cells.length - 1] ?? '',
+                evidence: [],
+            });
+            continue;
+        }
+        const statusRaw = cells[statusIdx];
+        const status = STATUS_SET.has(statusRaw) ? statusRaw : null;
+        if (status === null)
+            warnings.push(`${path}: row ${id}: unrecognised status "${statusRaw}" kept as raw`);
+        const linkedText = cells.slice(4, statusIdx).join(' | ');
+        // linked_text keeps the cell verbatim; linked_criterion is the structured bridge (§5.6).
+        rows.push({
+            id,
+            what_to_verify: cells[1] ?? '',
+            how_to_verify: cells[2] ?? '',
+            test_type: cells[3] ?? '',
+            linked_criterion: link(linkedText),
+            linked_text: linkedText,
+            environment: null,
+            status,
+            status_raw: statusRaw,
+            notes: cells.slice(statusIdx + 1).join(' | '),
+            evidence: [],
+        });
+    }
+    return { path, slug: slugMatch ? slugMatch[1] : null, rows, warnings, raw: text };
+}
+const esc = (s) => s.replace(/\|/g, '\\|');
+/** Ported from liblib-meet scripts/backlog/matrix.ts buildMatrixMd, grouped by item id in first-seen order. */
+export function buildMatrixMarkdown(slug, type, rows, generatedOn) {
+    const byItem = new Map();
+    for (const r of rows) {
+        const key = 'item' in r.linked_criterion
+            ? r.linked_criterion.item
+            : (LEGACY_LETTER.exec(r.id)?.[1] ?? 'legacy');
+        byItem.set(key, [...(byItem.get(key) ?? []), r]);
+    }
+    // Legacy sections keep their own letter; item sections take the next free one.
+    const taken = new Set([...byItem.keys()].filter((k) => /^[A-Z]$/.test(k)));
+    let next = 0;
+    const sections = [...byItem.entries()].map(([key, rs]) => {
+        const legacySection = /^[A-Z]$/.test(key);
+        let letter = key;
+        if (!legacySection) {
+            do {
+                letter = String.fromCharCode(65 + next++);
+            } while (taken.has(letter));
+            taken.add(letter);
+        }
+        const header = legacySection ? `## ${letter}. Legacy rows` : `## ${letter}. ${key}`;
+        const table = [
+            '| ID | What to verify | How to verify | Test type | Linked criterion | Status | Notes |',
+            '|---|---|---|---|---|---|---|',
+            ...rs.map((r) => {
+                const linked = r.linked_text ||
+                    ('item' in r.linked_criterion
+                        ? `${r.linked_criterion.item} AC${r.linked_criterion.ac}`
+                        : r.linked_criterion.legacy);
+                return `| ${r.id} | ${esc(r.what_to_verify)} | ${esc(r.how_to_verify)} | ${esc(r.test_type)} | ${esc(linked)} | ${r.status ?? r.status_raw} | ${esc(r.notes)} |`;
+            }),
+        ].join('\n');
+        return `${header}\n\n${table}\n`;
+    });
+    return `# QA Matrix — \`${slug}\`
+
+**Track type:** ${type}
+**Generated:** ${generatedOn} by \`backlog matrix\`
+
+**Status legend (per \`docs/backlog/_schema.md\` §10.5):** ☐ not started · 🟡 in progress · ✅ implemented · 🔬 verified in staging · 🚀 verified in production · ⏭️ skipped (reason in Notes).
+
+---
+
+${sections.join('\n---\n\n')}`;
+}
+export function serializeMatrix(doc, rows, opts = {}) {
+    // Structural compare: rows round-tripped through `jsonb` keep their values but not key order.
+    if (!rows || deepEqual(rows, doc.rows))
+        return doc.raw;
+    return buildMatrixMarkdown(doc.slug ?? 'matrix', opts.type ?? 'feature', rows, opts.generatedOn ?? '1970-01-01');
+}
+//# sourceMappingURL=matrix.js.map

package/dist/_core/markdown/matrix.js.map

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

package/dist/_core/markdown/track.d.ts

@@ -0,0 +1,71 @@
+import type { Criterion } from '../schema.js';
+/**
+ * The three files a promoted conductor track carries, rendered from the register's own
+ * `TrackDetail` payload (DECISION-028). Pure: no `node:*`, no clock — `created` is an
+ * argument — so the CLI, the service and the tests all render the same bytes.
+ *
+ * The shape is `conductor/tracks/verification_20260912/` and nothing else: conductor is not
+ * modified by the plugin (§7.3), so the renderer follows the convention rather than proposing
+ * one. `metadata.json` is v3 exactly (§7).
+ */
+/** What promotion copies into `spec.md` — mirrors `apps/service` `TrackSpecEntry`. */
+export interface TrackSpecEntry {
+    id: string;
+    title: string;
+    criteria: Criterion[];
+    /** The item's `## Out of scope` body. Copied **verbatim**; never re-wrapped or re-bulleted. */
+    out_of_scope: string;
+    criteria_version: number;
+}
+/** The subset of `TrackDetail` the renderer reads. Extra fields are ignored, not rejected. */
+export interface TrackRenderPayload {
+    project?: string;
+    track: {
+        slug: string;
+        type: string;
+        backlog_ids?: string[];
+        qa_enforcement?: string;
+    };
+    spec: TrackSpecEntry[];
+}
+export interface TrackSpecOptions {
+    /** The track's human name. Only the base name reaches the title line. */
+    name?: string | undefined;
+}
+export interface TrackPlanOptions {
+    created?: string | undefined;
+    /** `--plan <path>`; otherwise the conventional `docs/superpowers/plans/<created>-<base>.md`. */
+    planPath?: string | undefined;
+}
+export interface TrackMetadataOptions {
+    name?: string | undefined;
+    /** The highest priority across the promoted items — the CLI resolves it, not the renderer. */
+    priority?: string | undefined;
+    /** `YYYY-MM-DD`. Required: the renderer never reads a clock. */
+    created: string;
+    /** Every promoted ref, in argument order. Defaults to the track's own list, then the spec. */
+    backlogIds?: string[] | undefined;
+    qaEnforcement?: string | undefined;
+}
+export type TrackRenderOptions = TrackSpecOptions & TrackPlanOptions & TrackMetadataOptions;
+export interface TrackFiles {
+    'spec.md': string;
+    'plan.md': string;
+    'metadata.json': string;
+}
+/** The three names, in the order `promote` writes (and prints) them. */
+export declare const TRACK_FILENAMES: readonly ["spec.md", "plan.md", "metadata.json"];
+/** `verification_20260912` → `verification`. The date is the promotion stamp, not the name. */
+export declare function trackBaseName(slug: string): string;
+/**
+ * `spec.md`. The criteria are rendered **unticked** whatever the item says: this file is the
+ * contract as promoted, and the tick state lives in the register (and in the QA matrix), not
+ * in a copy on disk that nothing reconciles.
+ */
+export declare function renderTrackSpec(payload: TrackRenderPayload, opts?: TrackSpecOptions): string;
+/** `plan.md` — one line, pointing at the plan. Conductor owns the file; we only seed it. */
+export declare function renderTrackPlan(payload: TrackRenderPayload, opts?: TrackPlanOptions): string;
+/** `metadata.json` — v3 (§7), two-space indent, trailing newline. */
+export declare function renderTrackMetadata(payload: TrackRenderPayload, opts: TrackMetadataOptions): string;
+/** All three, keyed by filename — what `promote` writes into the track directory. */
+export declare function renderTrackFiles(payload: TrackRenderPayload, opts: TrackRenderOptions): TrackFiles;

package/dist/_core/markdown/track.js

@@ -0,0 +1,79 @@
+/** The three names, in the order `promote` writes (and prints) them. */
+export const TRACK_FILENAMES = ['spec.md', 'plan.md', 'metadata.json'];
+const EMPTY_SECTION = '_none recorded_';
+/** `verification_20260912` → `verification`. The date is the promotion stamp, not the name. */
+export function trackBaseName(slug) {
+    return slug.replace(/_\d{8}$/, '');
+}
+/** The name as the title line wants it: the track's own word, not the full metadata sentence. */
+function titleName(payload, opts) {
+    const base = trackBaseName(payload.track.slug);
+    if (base !== '')
+        return base;
+    return (opts.name ?? payload.track.slug).trim();
+}
+function backlogIds(payload, opts) {
+    const given = opts.backlogIds ?? payload.track.backlog_ids;
+    if (given && given.length > 0)
+        return [...given];
+    return payload.spec.map((entry) => entry.id);
+}
+/**
+ * `spec.md`. The criteria are rendered **unticked** whatever the item says: this file is the
+ * contract as promoted, and the tick state lives in the register (and in the QA matrix), not
+ * in a copy on disk that nothing reconciles.
+ */
+export function renderTrackSpec(payload, opts = {}) {
+    const blocks = [`# ${titleName(payload, opts)} — spec`, '## Acceptance criteria'];
+    for (const entry of payload.spec) {
+        blocks.push(`### ${entry.id}`);
+        blocks.push(entry.criteria.length === 0
+            ? EMPTY_SECTION
+            : entry.criteria.map((c) => `- [ ] ${c.text}`).join('\n'));
+    }
+    blocks.push('## Non-goals');
+    for (const entry of payload.spec) {
+        blocks.push(`### ${entry.id}`);
+        // Verbatim: no trim, no re-wrap, no bullet normalisation. An empty section is the one
+        // substitution, because a blank block would read as a rendering bug.
+        blocks.push(entry.out_of_scope === '' ? EMPTY_SECTION : entry.out_of_scope);
+    }
+    const text = blocks.join('\n\n');
+    return text.endsWith('\n') ? text : `${text}\n`;
+}
+/** `plan.md` — one line, pointing at the plan. Conductor owns the file; we only seed it. */
+export function renderTrackPlan(payload, opts = {}) {
+    const given = opts.planPath?.trim();
+    if (given)
+        return `${given}`.startsWith('See ') ? `${given}\n` : `See ${given}\n`;
+    const base = trackBaseName(payload.track.slug);
+    if (opts.created)
+        return `See docs/superpowers/plans/${opts.created}-${base}.md\n`;
+    return `No plan recorded for ${payload.track.slug} yet — add one under docs/superpowers/plans/.\n`;
+}
+/** `metadata.json` — v3 (§7), two-space indent, trailing newline. */
+export function renderTrackMetadata(payload, opts) {
+    const doc = {
+        version: 3,
+        track_id: payload.track.slug,
+        name: (opts.name ?? trackBaseName(payload.track.slug)).trim(),
+        type: payload.track.type,
+        priority: opts.priority ?? 'P1',
+        created: opts.created,
+        status: 'in_progress',
+        backlog_ids: backlogIds(payload, opts),
+        follow_up_backlog: [],
+        qa_enforcement: opts.qaEnforcement ?? payload.track.qa_enforcement ?? 'permissive',
+        loop_state: { current_step: 'PLAN', step_status: 'IN_PROGRESS' },
+    };
+    return `${JSON.stringify(doc, null, 2)}\n`;
+}
+/** All three, keyed by filename — what `promote` writes into the track directory. */
+export function renderTrackFiles(payload, opts) {
+    return {
+        'spec.md': renderTrackSpec(payload, opts),
+        'plan.md': renderTrackPlan(payload, opts),
+        'metadata.json': renderTrackMetadata(payload, opts),
+    };
+}
+//# sourceMappingURL=track.js.map

package/dist/_core/markdown/track.js.map

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

package/dist/_core/matrix-status.d.ts

@@ -0,0 +1,9 @@
+import type { MatrixRow, MatrixStatus } from './schema.js';
+/** §5.6: one-way, one step at a time; ⏭️ from any state with a reason. */
+export declare const MATRIX_FORWARD: readonly MatrixStatus[];
+export declare function canTransitionMatrix(from: MatrixStatus | null, to: MatrixStatus): boolean;
+export declare function transitionMatrixRow(row: MatrixRow, to: MatrixStatus, opts?: {
+    reason?: string;
+}): MatrixRow;
+/** Which §3.1 action a target status needs — Engineers implement, QA verifies, Product+ skips. */
+export declare function matrixActionFor(to: MatrixStatus): 'matrix_mark_implemented' | 'matrix_verify' | 'matrix_skip';