@specship/specship-linux-arm64 0.28.0 → 0.29.0

package/lib/dist/design-md/maintain.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Keeping design.md current (DESIGNMD-DOC, REQ-DESIGNMD-003).
+ *
+ * Re-extraction swaps only the marker-fenced generated block; every authored
+ * byte outside it survives. What moved — tokens and inventory values added,
+ * removed or changed — is written as one dated Change log entry, so a reader
+ * (or a model revising the UI) sees exactly what to update. Nothing changed →
+ * no entry, byte-identical file.
+ */
+export declare class DesignMdUpdateError extends Error {
+}
+export interface BlockSpan {
+    start: number;
+    end: number;
+    block: string;
+}
+/** Locate the generated block (markers included), or null. */
+export declare function findGeneratedBlock(content: string): BlockSpan | null;
+/**
+ * The comparable facts of a generated block: `token <name> on <selector>` and
+ * `variable <name>` → value, `<Inventory>: <value>` → "" (presence only).
+ */
+export declare function blockFacts(block: string): Map<string, string>;
+export interface InventoryDiff {
+    added: string[];
+    removed: string[];
+    changed: {
+        key: string;
+        from: string;
+        to: string;
+    }[];
+}
+export declare function diffInventories(oldBlock: string, newBlock: string): InventoryDiff;
+export interface UpdateResult {
+    content: string;
+    changed: boolean;
+    diff: InventoryDiff;
+}
+/**
+ * Replace the generated block of an existing design.md and log what moved.
+ * Throws `DesignMdUpdateError` when the file has no markers — refusing beats
+ * overwriting authored content (REQ-DESIGNMD-003.A3).
+ */
+export declare function updateDesignMd(existing: string, newBlock: string, date: string): UpdateResult;
+//# sourceMappingURL=maintain.d.ts.map

package/lib/dist/design-md/maintain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintain.d.ts","sourceRoot":"","sources":["../../src/design-md/maintain.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,qBAAa,mBAAoB,SAAQ,KAAK;CAAG;AAEjD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAMpE;AAeD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAqB7D;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACtD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CAUjF;AAeD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAqB7F"}

package/lib/dist/design-md/maintain.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Keeping design.md current (DESIGNMD-DOC, REQ-DESIGNMD-003).
+ *
+ * Re-extraction swaps only the marker-fenced generated block; every authored
+ * byte outside it survives. What moved — tokens and inventory values added,
+ * removed or changed — is written as one dated Change log entry, so a reader
+ * (or a model revising the UI) sees exactly what to update. Nothing changed →
+ * no entry, byte-identical file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DesignMdUpdateError = void 0;
+exports.findGeneratedBlock = findGeneratedBlock;
+exports.blockFacts = blockFacts;
+exports.diffInventories = diffInventories;
+exports.updateDesignMd = updateDesignMd;
+const render_1 = require("./render");
+class DesignMdUpdateError extends Error {
+}
+exports.DesignMdUpdateError = DesignMdUpdateError;
+/** Locate the generated block (markers included), or null. */
+function findGeneratedBlock(content) {
+    const start = content.indexOf(render_1.GENERATED_START);
+    const endMarker = content.indexOf(render_1.GENERATED_END, start + 1);
+    if (start === -1 || endMarker === -1)
+        return null;
+    const end = endMarker + render_1.GENERATED_END.length;
+    return { start, end, block: content.slice(start, end) };
+}
+function cells(row) {
+    return row
+        .trim()
+        .replace(/^\|/, '')
+        .replace(/\|$/, '')
+        .split(/(?<!\\)\|/)
+        .map((c) => c.trim().replace(/\\\|/g, '|'));
+}
+function unquote(c) {
+    return c.replace(/^`|`$/g, '');
+}
+/**
+ * The comparable facts of a generated block: `token <name> on <selector>` and
+ * `variable <name>` → value, `<Inventory>: <value>` → "" (presence only).
+ */
+function blockFacts(block) {
+    const facts = new Map();
+    let section = '';
+    let sub = '';
+    for (const line of block.split('\n')) {
+        if (line.startsWith('### ')) {
+            section = line.slice(4).trim();
+            sub = '';
+            continue;
+        }
+        if (line.startsWith('#### ')) {
+            sub = line.slice(5).trim();
+            continue;
+        }
+        if (!line.startsWith('| `'))
+            continue;
+        const c = cells(line);
+        if (section.startsWith('Design tokens'))
+            facts.set(`token ${unquote(c[0])} on ${c[2].replace(/`/g, '')}`, unquote(c[1]));
+        else if (section === 'Design variables')
+            facts.set(`variable ${unquote(c[0])}`, unquote(c[1]));
+        else if (section === 'Value inventories' && sub)
+            facts.set(`${sub}: ${unquote(c[0])}`, '');
+    }
+    return facts;
+}
+function diffInventories(oldBlock, newBlock) {
+    const before = blockFacts(oldBlock);
+    const after = blockFacts(newBlock);
+    const diff = { added: [], removed: [], changed: [] };
+    for (const [key, value] of after) {
+        if (!before.has(key))
+            diff.added.push(key);
+        else if (before.get(key) !== value)
+            diff.changed.push({ key, from: before.get(key), to: value });
+    }
+    for (const key of before.keys())
+        if (!after.has(key))
+            diff.removed.push(key);
+    return diff;
+}
+function changeLogEntry(diff, date) {
+    const n = diff.added.length + diff.removed.length + diff.changed.length;
+    const lines = [
+        n === 0
+            ? `- ${date}: source re-extracted; no token or inventory value changed (rules or outline may have).`
+            : `- ${date}: source re-extracted; ${n} value change${n === 1 ? '' : 's'}.`,
+    ];
+    for (const c of diff.changed)
+        lines.push(`  - changed ${c.key}: \`${c.from}\` → \`${c.to}\``);
+    for (const a of diff.added)
+        lines.push(`  - added ${a}`);
+    for (const r of diff.removed)
+        lines.push(`  - removed ${r}`);
+    return lines.join('\n');
+}
+/**
+ * Replace the generated block of an existing design.md and log what moved.
+ * Throws `DesignMdUpdateError` when the file has no markers — refusing beats
+ * overwriting authored content (REQ-DESIGNMD-003.A3).
+ */
+function updateDesignMd(existing, newBlock, date) {
+    const span = findGeneratedBlock(existing);
+    if (!span) {
+        throw new DesignMdUpdateError(`no generated block found (expected ${render_1.GENERATED_START} … ${render_1.GENERATED_END}); refusing to overwrite authored content`);
+    }
+    const empty = { added: [], removed: [], changed: [] };
+    if (span.block === newBlock)
+        return { content: existing, changed: false, diff: empty };
+    const diff = diffInventories(span.block, newBlock);
+    let content = existing.slice(0, span.start) + newBlock + existing.slice(span.end);
+    const entry = changeLogEntry(diff, date);
+    const heading = /^## Change log[ \t]*$/m.exec(content);
+    if (heading) {
+        const at = heading.index + heading[0].length;
+        content = `${content.slice(0, at)}\n\n${entry}${content.slice(at).replace(/^\n+/, '\n')}`;
+    }
+    else {
+        content = `${content.replace(/\n*$/, '')}\n\n## Change log\n\n${entry}\n`;
+    }
+    return { content, changed: true, diff };
+}
+//# sourceMappingURL=maintain.js.map

package/lib/dist/design-md/maintain.js.map

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

package/lib/dist/design-md/render.d.ts

@@ -0,0 +1,28 @@
+/**
+ * design.md rendering (DESIGNMD-DOC, REQ-DESIGNMD-001/002).
+ *
+ * Every design.md has the same headings in the same order, so a low-end
+ * model always finds a value in the same place. The generated reference is
+ * fenced by markers and is a pure function of the extraction: same sources,
+ * same bytes (REQ-DESIGNMD-001.A4). Everything outside the markers is
+ * authored — by the design-md skill or a person — and survives re-extraction.
+ */
+import { DesignExtraction } from './extract';
+export declare const GENERATED_START = "<!-- design-md:generated:start -->";
+export declare const GENERATED_END = "<!-- design-md:generated:end -->";
+/** Top-level sections, in order (REQ-DESIGNMD-002.A1). */
+export declare const REQUIRED_SECTIONS: readonly ["Source", "Fidelity rules", "Screens & layout", "Components & states", "Interactions & motion", "Responsive behaviour", "Assets", "Generated reference", "Change log"];
+/** Authored sections that must carry real content before `check` passes. */
+export declare const AUTHORED_SECTIONS: readonly ["Screens & layout", "Components & states", "Interactions & motion", "Responsive behaviour", "Assets"];
+/** The marker-fenced reference block. Deterministic for a given extraction. */
+export declare function renderGeneratedBlock(x: DesignExtraction): string;
+export interface RenderOptions {
+    title: string;
+    /** Where the design came from — a claude.ai/design or figma.com link, or a bundle path. */
+    origin?: string;
+    /** YYYY-MM-DD for the first Change log entry. */
+    date: string;
+}
+/** A complete new design.md: fixed headings, authored stubs, the generated block. */
+export declare function renderDesignMd(x: DesignExtraction, opts: RenderOptions): string;
+//# sourceMappingURL=render.d.ts.map

package/lib/dist/design-md/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/design-md/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,gBAAgB,EAAmC,MAAM,WAAW,CAAC;AAE9E,eAAO,MAAM,eAAe,uCAAuC,CAAC;AACpE,eAAO,MAAM,aAAa,qCAAqC,CAAC;AAEhE,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,kLAUpB,CAAC;AAEX,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,iHAMpB,CAAC;AAqBX,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAyEhE;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,2FAA2F;IAC3F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAkD/E"}

package/lib/dist/design-md/render.js

@@ -0,0 +1,178 @@
+"use strict";
+/**
+ * design.md rendering (DESIGNMD-DOC, REQ-DESIGNMD-001/002).
+ *
+ * Every design.md has the same headings in the same order, so a low-end
+ * model always finds a value in the same place. The generated reference is
+ * fenced by markers and is a pure function of the extraction: same sources,
+ * same bytes (REQ-DESIGNMD-001.A4). Everything outside the markers is
+ * authored — by the design-md skill or a person — and survives re-extraction.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTHORED_SECTIONS = exports.REQUIRED_SECTIONS = exports.GENERATED_END = exports.GENERATED_START = void 0;
+exports.renderGeneratedBlock = renderGeneratedBlock;
+exports.renderDesignMd = renderDesignMd;
+const extract_1 = require("./extract");
+exports.GENERATED_START = '<!-- design-md:generated:start -->';
+exports.GENERATED_END = '<!-- design-md:generated:end -->';
+/** Top-level sections, in order (REQ-DESIGNMD-002.A1). */
+exports.REQUIRED_SECTIONS = [
+    'Source',
+    'Fidelity rules',
+    'Screens & layout',
+    'Components & states',
+    'Interactions & motion',
+    'Responsive behaviour',
+    'Assets',
+    'Generated reference',
+    'Change log',
+];
+/** Authored sections that must carry real content before `check` passes. */
+exports.AUTHORED_SECTIONS = [
+    'Screens & layout',
+    'Components & states',
+    'Interactions & motion',
+    'Responsive behaviour',
+    'Assets',
+];
+const USED_BY_LIMIT = 6;
+function cell(text) {
+    return text.replace(/\|/g, '\\|').replace(/\n/g, ' ');
+}
+function usedBy(e) {
+    const shown = e.usedBy.slice(0, USED_BY_LIMIT).map((s) => `\`${cell(s)}\``).join(', ');
+    return e.usedBy.length > USED_BY_LIMIT ? `${shown} +${e.usedBy.length - USED_BY_LIMIT} more` : shown;
+}
+function inventoryTable(entries) {
+    return ['| Value | Uses | Used by |', '|---|---|---|', ...entries.map((e) => `| \`${cell(e.value)}\` | ${e.count} | ${usedBy(e)} |`)];
+}
+function ruleText(rule) {
+    return `${rule.selector} { ${rule.declarations.map((d) => `${d.property}: ${d.value};`).join(' ')} }`;
+}
+/** The marker-fenced reference block. Deterministic for a given extraction. */
+function renderGeneratedBlock(x) {
+    const out = [exports.GENERATED_START];
+    out.push(`Sources: ${x.sources.map((s) => `\`${s.path}\` sha256:${s.sha256}`).join(' · ')}`);
+    out.push('');
+    out.push('_Extracted by `specship design extract`. Do not edit by hand — re-run with `--update`. Every value below is verbatim from the source._');
+    for (const m of x.missingLinks)
+        out.push('', `Missing linked stylesheet: \`${m}\` — its values are NOT in this reference.`);
+    out.push('', '### Design tokens (custom properties)', '');
+    if (x.customProperties.length === 0)
+        out.push('None declared.');
+    else {
+        out.push('| Token | Value | Declared on |', '|---|---|---|');
+        for (const p of x.customProperties) {
+            const value = p.value === '' ? '_empty (declared as `' + p.name + ': ;`)_' : `\`${cell(p.value)}\``;
+            out.push(`| \`${cell(p.name)}\` | ${value} | \`${cell(p.selector)}\`${p.media ? ` (${cell(p.media)})` : ''} |`);
+        }
+    }
+    if (x.variables.length > 0) {
+        out.push('', '### Design variables', '', '| Variable | Value |', '|---|---|');
+        for (const v of x.variables)
+            out.push(`| \`${cell(v.name)}\` | \`${cell(v.value)}\` |`);
+    }
+    out.push('', '### Value inventories');
+    for (const kind of extract_1.INVENTORY_KINDS) {
+        const entries = x.inventories[kind];
+        if (entries.length === 0)
+            continue;
+        out.push('', `#### ${kind}`, '', ...inventoryTable(entries));
+    }
+    if (x.fontLinks.length > 0 || x.fontFaces.length > 0) {
+        out.push('', '### Font loading', '');
+        for (const link of x.fontLinks)
+            out.push(`- \`${link}\``);
+        for (const face of x.fontFaces)
+            out.push(`- \`@font-face { ${face.map((d) => `${d.property}: ${d.value};`).join(' ')} }\``);
+    }
+    if (x.keyframes.length > 0) {
+        out.push('', '### Keyframes', '', '```css');
+        for (const k of x.keyframes)
+            out.push(`${k.media ? `/* ${k.media} */ ` : ''}@keyframes ${k.name} { ${k.body} }`);
+        out.push('```');
+    }
+    if (x.utilityClasses.length > 0) {
+        out.push('', '### Utility classes', '', ...inventoryTable(x.utilityClasses));
+    }
+    if (x.assets.length > 0) {
+        out.push('', '### Asset references', '', ...inventoryTable(x.assets));
+    }
+    if (x.outline.length > 0) {
+        out.push('', '### Element outline', '', '_One element per line, nested by indentation, with its inline style in braces; quoted lines are text in document order; an `svg … = <svg …>` line carries that icon\'s exact markup — paste it as is._', '', '```text', ...x.outline);
+        if (x.outlineTruncated)
+            out.push(`… truncated at ${x.outline.length} elements — the source file has the rest`);
+        out.push('```');
+    }
+    // Inline styles already sit on their element in the outline.
+    const sheetRules = x.rules.filter((r) => !r.selector.startsWith('inline '));
+    if (sheetRules.length > 0) {
+        out.push('', '### Style rules (verbatim)', '');
+        const groups = new Map();
+        for (const r of sheetRules) {
+            const key = r.media ?? '';
+            groups.set(key, [...(groups.get(key) ?? []), r]);
+        }
+        for (const [media, rules] of groups) {
+            if (media)
+                out.push(`#### ${media}`, '');
+            out.push('```css', ...rules.map(ruleText), '```', '');
+        }
+        out.pop();
+    }
+    out.push(exports.GENERATED_END);
+    return out.join('\n');
+}
+/** A complete new design.md: fixed headings, authored stubs, the generated block. */
+function renderDesignMd(x, opts) {
+    const stub = (hint) => `<!-- design-md: ${hint} -->`;
+    return [
+        `# ${opts.title} — design reference`,
+        '',
+        '## Source',
+        '',
+        ...(opts.origin ? [`- Design: ${opts.origin}`] : []),
+        ...x.sources.map((s) => `- \`${s.path}\` (${s.kind})`),
+        '',
+        '## Fidelity rules',
+        '',
+        '- The Generated reference is authoritative. Build the structure exactly as the Element outline nests it, with its classes, inline styles, text and SVG. The authored sections explain it; where they disagree with the outline, the outline wins.',
+        '- Keep the stylesheet rules in the order Style rules lists them. A later rule overrides an earlier one, so reordering `.border-white` and `.border-t-transparent` changes what renders.',
+        '- Use every value in this file verbatim: colors, sizes, spacing, radii, shadows, font stacks, weights, durations and easings. Never round, approximate or substitute a "close" value.',
+        '- Reuse an existing project token only when its value is exactly equal to the value here; otherwise add the value as written.',
+        '- Build every state listed under Components & states — default, hover, focus-visible, active, disabled, loading, empty and error where listed.',
+        '- When this file and the source disagree, the source wins: run `specship design extract --update` and re-read.',
+        '- Do not invent anything this file does not state. A missing value is a question for the designer, not a guess.',
+        '- Add no CSS the design does not have: no resets, normalizers, or "fixes". An element this file leaves unstyled keeps the browser default, because the design was rendered with that default.',
+        '',
+        '## Screens & layout',
+        '',
+        stub('For each screen or frame: its size, the layout model (grid/flex, columns, gaps, max-width, alignment), and the regions top to bottom with their exact dimensions and the tokens they use. Cite the selectors from the Generated reference.'),
+        '',
+        '## Components & states',
+        '',
+        stub('For each component: its selector(s), anatomy (child parts in order), exact sizes and paddings, and one bullet per state (default, hover, focus-visible, active, disabled, loading, empty, error) naming the exact values that change.'),
+        '',
+        '## Interactions & motion',
+        '',
+        stub('Every transition and animation: trigger, the properties that animate, duration, easing, delay, and keyframes by name. Write "None in this design." when there are none.'),
+        '',
+        '## Responsive behaviour',
+        '',
+        stub('Each breakpoint from the Generated reference and exactly what changes at it (columns, visibility, sizes, font sizes). Write "Single fixed layout." when there are none.'),
+        '',
+        '## Assets',
+        '',
+        stub('Each image, icon and font: file or link, rendered size, and where it is used. Write "None." when there are none.'),
+        '',
+        '## Generated reference',
+        '',
+        renderGeneratedBlock(x),
+        '',
+        '## Change log',
+        '',
+        `- ${opts.date}: created from ${x.sources.map((s) => `\`${s.path}\``).join(', ')}.`,
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=render.js.map

package/lib/dist/design-md/render.js.map

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

package/lib/dist/design-md/upkeep.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Keeping design.md in step with the UI code (DESIGNMD-DOC, REQ-DESIGNMD-007).
+ *
+ * design.md is only worth trusting if it describes the UI that actually
+ * ships. So a change that touches UI code governed by a design-backed spec
+ * must, in the same change, record what moved in that spec's design.md: a new
+ * Change log entry (and the authored sections it describes), or a
+ * re-extraction when the design source itself changed. And the file must still
+ * pass `specship design check`. `specship postcheck` runs this, which is what
+ * makes `/specship:spec implement` refuse to finish without it.
+ */
+/** File types whose changes change what a user sees. */
+export declare const UI_FILE: RegExp;
+export interface DesignBinding {
+    /** Project-relative path of the spec file declaring `design:`. */
+    specFile: string;
+    /** Project-relative path of its design.md. */
+    designFile: string;
+    /** UI files the spec's `implementations:` blocks name. */
+    uiFiles: string[];
+}
+export interface UpkeepFinding {
+    designFile: string;
+    message: string;
+}
+/** `design:` from a spec file's frontmatter, or null. */
+export declare function designFrontmatter(source: string): string | null;
+/** Every design-backed spec under specs/ with the UI files it governs. */
+export declare function designBindings(projectRoot: string): DesignBinding[];
+export interface UpkeepOptions {
+    projectRoot: string;
+    /** Files changed since the run base (project-relative). */
+    changed: string[];
+    /** The design.md content at the base ref, or null when it did not exist. */
+    baseContent: (relPath: string) => string | null;
+    /** The spec file of the requirement being implemented, when known. */
+    specFile?: string | null;
+}
+/**
+ * A design.md is "touched" by a change when the change edits a UI file its spec
+ * governs, edits one of its recorded design sources, or edits any UI file while
+ * implementing that design-backed spec itself.
+ */
+export declare function checkDesignUpkeep(opts: UpkeepOptions): {
+    findings: UpkeepFinding[];
+    checked: string[];
+};
+//# sourceMappingURL=upkeep.d.ts.map

package/lib/dist/design-md/upkeep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upkeep.d.ts","sourceRoot":"","sources":["../../src/design-md/upkeep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,wDAAwD;AACxD,eAAO,MAAM,OAAO,QAAiE,CAAC;AAEtF,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK/D;AAsBD,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CA0BnE;AAQD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4EAA4E;IAC5E,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAChD,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG;IAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAsCvG"}

package/lib/dist/design-md/upkeep.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * Keeping design.md in step with the UI code (DESIGNMD-DOC, REQ-DESIGNMD-007).
+ *
+ * design.md is only worth trusting if it describes the UI that actually
+ * ships. So a change that touches UI code governed by a design-backed spec
+ * must, in the same change, record what moved in that spec's design.md: a new
+ * Change log entry (and the authored sections it describes), or a
+ * re-extraction when the design source itself changed. And the file must still
+ * pass `specship design check`. `specship postcheck` runs this, which is what
+ * makes `/specship:spec implement` refuse to finish without it.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UI_FILE = void 0;
+exports.designFrontmatter = designFrontmatter;
+exports.designBindings = designBindings;
+exports.checkDesignUpkeep = checkDesignUpkeep;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const check_1 = require("./check");
+/** File types whose changes change what a user sees. */
+exports.UI_FILE = /\.(tsx|jsx|vue|svelte|astro|html?|css|scss|sass|less|styl)$/i;
+function rel(projectRoot, abs) {
+    return path.relative(projectRoot, abs).split(path.sep).join('/');
+}
+/** `design:` from a spec file's frontmatter, or null. */
+function designFrontmatter(source) {
+    const fm = /^---\r?\n([\s\S]*?)\r?\n---/.exec(source);
+    if (!fm)
+        return null;
+    const m = /^design:\s*(.+?)\s*$/m.exec(fm[1]);
+    return m ? m[1].replace(/^["']|["']$/g, '') : null;
+}
+/** Every file path named in the spec's `implementations:` blocks. */
+function implementationFiles(source) {
+    const out = new Set();
+    let inBlock = false;
+    for (const line of source.split(/\r?\n/)) {
+        if (/^implementations:\s*$/.test(line)) {
+            inBlock = true;
+            continue;
+        }
+        if (!inBlock)
+            continue;
+        const m = /^\s+-\s+(.+?)\s*$/.exec(line);
+        if (m) {
+            const bullet = m[1];
+            const idx = bullet.lastIndexOf(':');
+            out.add((idx > 0 && !/^[A-Za-z]:[\\/]/.test(bullet) ? bullet.slice(0, idx) : bullet).replace(/\\/g, '/'));
+        }
+        else if (line.trim() !== '')
+            inBlock = false;
+    }
+    return [...out];
+}
+/** Every design-backed spec under specs/ with the UI files it governs. */
+function designBindings(projectRoot) {
+    const out = [];
+    const walk = (dir) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const p = path.join(dir, e.name);
+            if (e.isDirectory())
+                walk(p);
+            else if (e.name.endsWith('.md') && e.name !== 'design.md') {
+                const source = fs.readFileSync(p, 'utf8');
+                const design = designFrontmatter(source);
+                if (!design)
+                    continue;
+                out.push({
+                    specFile: rel(projectRoot, p),
+                    designFile: design.replace(/\\/g, '/'),
+                    uiFiles: implementationFiles(source).filter((f) => exports.UI_FILE.test(f)),
+                });
+            }
+        }
+    };
+    walk(path.join(projectRoot, 'specs'));
+    return out;
+}
+function changeLog(content) {
+    if (content === null)
+        return '';
+    const start = content.search(/^## Change log[ \t]*$/m);
+    return start === -1 ? '' : content.slice(start);
+}
+/**
+ * A design.md is "touched" by a change when the change edits a UI file its spec
+ * governs, edits one of its recorded design sources, or edits any UI file while
+ * implementing that design-backed spec itself.
+ */
+function checkDesignUpkeep(opts) {
+    const changed = opts.changed.map((f) => f.replace(/\\/g, '/'));
+    const changedUi = changed.filter((f) => exports.UI_FILE.test(f) && !f.startsWith('specs/'));
+    const ownSpec = opts.specFile ? rel(opts.projectRoot, path.resolve(opts.projectRoot, opts.specFile)) : null;
+    const findings = [];
+    const checked = [];
+    for (const b of designBindings(opts.projectRoot)) {
+        const governed = new Set(b.uiFiles);
+        const hits = changedUi.filter((f) => governed.has(f) || (b.specFile === ownSpec));
+        if (hits.length === 0)
+            continue;
+        checked.push(b.designFile);
+        const abs = path.resolve(opts.projectRoot, b.designFile);
+        let now;
+        try {
+            now = fs.readFileSync(abs, 'utf8');
+        }
+        catch {
+            findings.push({ designFile: b.designFile, message: `${b.specFile} names design: ${b.designFile}, which does not exist` });
+            continue;
+        }
+        const shown = hits.slice(0, 5).join(', ') + (hits.length > 5 ? ` +${hits.length - 5} more` : '');
+        if (changeLog(now) === changeLog(opts.baseContent(b.designFile))) {
+            findings.push({
+                designFile: b.designFile,
+                message: `UI changed (${shown}) but ${b.designFile} has no new Change log entry — record what changed ` +
+                    '(update the authored sections it affects and add a dated Change log line naming the requirement; ' +
+                    'if the design source itself changed, run `specship design extract <sources> --update ' + b.designFile + '`)',
+            });
+        }
+        for (const f of (0, check_1.checkDesignMd)(now, { projectRoot: opts.projectRoot })) {
+            if (f.severity !== 'error')
+                continue;
+            findings.push({ designFile: b.designFile, message: `${b.designFile}${f.line ? `:${f.line}` : ''} ${f.code}: ${f.message}` });
+        }
+    }
+    return { findings, checked };
+}
+//# sourceMappingURL=upkeep.js.map

package/lib/dist/design-md/upkeep.js.map

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