@aperant/framework 0.6.2

package/dist/cli/design/template.d.mts

@@ -0,0 +1,99 @@
+/**
+ * Resolve the library directory. Explicit flag wins; absolute paths are used
+ * as-is, relative paths resolve against cwd. When no flag is passed, fall
+ * back to the shipped templates/design-library path.
+ *
+ * @param {string | true | undefined | null} flag
+ * @returns {string}
+ */
+export function resolveLibraryDir(flag: string | true | undefined | null): string;
+/**
+ * List every slug under the library directory, sorted alphabetically.
+ * Each entry carries the slug, meta.name, meta.description, provenance.origin,
+ * provenance.source. Directories missing DESIGN.md are skipped. Warnings are
+ * accumulated (not thrown) so `list` never fails wholesale on one bad entry.
+ *
+ * @param {{ libraryDir?: string }} [opts]
+ * @returns {{ entries: LibraryEntrySummary[], warnings: string[] }}
+ */
+export function listLibraryEntries(opts?: {
+    libraryDir?: string;
+}): {
+    entries: LibraryEntrySummary[];
+    warnings: string[];
+};
+/**
+ * Load a single library entry by slug. Returns the raw DESIGN.md text, the
+ * parsed frontmatter object, and the parsed provenance object.
+ *
+ * Throws (caller translates to CLI exit) when the slug is missing or the
+ * DESIGN.md can't be read.
+ *
+ * @param {{ libraryDir?: string, slug: string }} opts
+ * @returns {{ slug: string, path: string, design_md: string, frontmatter: Record<string, unknown> | null, provenance: Record<string, unknown> }}
+ */
+export function loadLibraryEntry(opts: {
+    libraryDir?: string;
+    slug: string;
+}): {
+    slug: string;
+    path: string;
+    design_md: string;
+    frontmatter: Record<string, unknown> | null;
+    provenance: Record<string, unknown>;
+};
+/**
+ * Copy a library entry's DESIGN.md into a target project directory as
+ * `<projectDir>/DESIGN.md`. Refuses to overwrite unless `force` is set —
+ * mirrors the `author-skill` safety rule.
+ *
+ * Throws (caller translates to CLI exit) on refusal or missing slug.
+ *
+ * @param {{ libraryDir?: string, slug: string, projectDir: string, force?: boolean }} opts
+ * @returns {{ slug: string, from: string, to: string, overwritten: boolean }}
+ */
+export function addLibraryEntry(opts: {
+    libraryDir?: string;
+    slug: string;
+    projectDir: string;
+    force?: boolean;
+}): {
+    slug: string;
+    from: string;
+    to: string;
+    overwritten: boolean;
+};
+/**
+ * Validate a candidate DESIGN.md and, when it passes, copy it into the
+ * library under `<libraryDir>/<slug>/DESIGN.md` with a fresh provenance.yaml
+ * whose `origin` is `community`. Does NOT open a PR — the author commits
+ * + pushes themselves.
+ *
+ * Throws (caller translates to CLI exit) when:
+ *   - the candidate file doesn't exist
+ *   - the candidate fails `validateDesignMarkdown`
+ *   - the target slug directory already exists (no --force here; community
+ *     submissions go into a fresh directory, always)
+ *
+ * @param {{ libraryDir?: string, slug?: string, candidatePath: string, force?: boolean }} opts
+ * @returns {{ slug: string, copied_to: string, provenance_path: string, warnings: string[] }}
+ */
+export function submitLibraryEntry(opts: {
+    libraryDir?: string;
+    slug?: string;
+    candidatePath: string;
+    force?: boolean;
+}): {
+    slug: string;
+    copied_to: string;
+    provenance_path: string;
+    warnings: string[];
+};
+export type LibraryEntrySummary = {
+    slug: string;
+    name: string;
+    description: string;
+    origin: string;
+    source: string;
+};
+//# sourceMappingURL=template.d.mts.map

package/dist/cli/design/template.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.mts","sourceRoot":"","sources":["../../../src/cli/design/template.mjs"],"names":[],"mappings":"AAyFA;;;;;;;GAOG;AACH,wCAHW,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAC9B,MAAM,CAOlB;AA0BD;;;;;;;;GAQG;AACH,0CAHW;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACrB;IAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAiElE;AAED;;;;;;;;;GASG;AACH,uCAHW;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAsB/I;AAED;;;;;;;;;GASG;AACH,sCAHW;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAkC5E;AAED;;;;;;;;;;;;;;GAcG;AACH,yCAHW;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5E;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA6E5F;kCA5Ua;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE"}

package/dist/cli/design/template.mjs

@@ -0,0 +1,324 @@
+/**
+ * design/template.mjs — library IO primitives for C42 `design-template` CLI.
+ *
+ * Pure(-ish) exports. All I/O wrapped so callers can catch structured errors.
+ * No process.exit here — the CLI layer (commands/design-template.mjs) owns
+ * exit-code decisions.
+ *
+ * Exports:
+ *   - resolveLibraryDir(flag?)        → abs path; default to shipped templates/design-library
+ *   - listLibraryEntries({libraryDir}) → sorted { slug, name, description, origin, source }[]
+ *   - loadLibraryEntry({libraryDir, slug}) → full design_md text + parsed frontmatter + provenance
+ *   - addLibraryEntry({libraryDir, slug, projectDir, force}) → copy into project-root DESIGN.md
+ *   - submitLibraryEntry({candidatePath, libraryDir, slug}) → validate + copy into library
+ */
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync, } from 'node:fs';
+import { basename, dirname, resolve as resolvePath } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { extractDesignFrontmatter, validateDesignMarkdown } from './validate.mjs';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// src/cli/design/template.mjs → ../../../templates/design-library
+// (three `..`: design/ → cli/ → src/ → framework-root/templates/design-library)
+const DEFAULT_LIBRARY_DIR = resolvePath(__dirname, '..', '..', '..', 'templates', 'design-library');
+/** @typedef {{ slug: string, name: string, description: string, origin: string, source: string }} LibraryEntrySummary */
+/**
+ * Slugs must be simple directory-name tokens (alphanumerics, hyphen, or
+ * underscore). Rejecting `/`, `..`, `\\`, and leading dots prevents path
+ * traversal into arbitrary filesystem locations via `show`/`add`/`submit --as`
+ * — slugs are user-supplied but are composed directly into paths under
+ * `<libraryDir>/<slug>/DESIGN.md`. Without this guard, a slug like
+ * `../../../etc/hosts` would escape the library root on read, and a
+ * `submit --as ../../../tmp/evil` could write outside the library tree.
+ *
+ * Kept as simple and conservative as possible: the real typeui-sh corpus uses
+ * `^[a-z][a-z0-9-]*$`, the three first-party seeds match the same pattern,
+ * and community submissions should too.
+ *
+ * @param {string} slug
+ * @param {string} context  — used only in the error message (e.g. "show slug")
+ * @returns {void}
+ */
+function assertSafeSlug(slug, context) {
+    if (typeof slug !== 'string' || slug.length === 0) {
+        const err = new Error(`${context}: slug must be a non-empty string`);
+        // @ts-expect-error — attach code for CLI layer
+        err.code = 'EINVALID_SLUG';
+        throw err;
+    }
+    // Max length is a belt-and-braces limit; 128 is far longer than any real slug.
+    if (slug.length > 128) {
+        const err = new Error(`${context}: slug is longer than 128 characters — pick something shorter.`);
+        // @ts-expect-error — attach code for CLI layer
+        err.code = 'EINVALID_SLUG';
+        throw err;
+    }
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(slug)) {
+        const err = new Error(`${context}: slug "${slug}" contains unsupported characters. Allowed: letters, digits, hyphen, underscore, dot; must start with a letter or digit. Path separators and parent-directory references are not allowed.`);
+        // @ts-expect-error — attach code for CLI layer
+        err.code = 'EINVALID_SLUG';
+        throw err;
+    }
+    if (slug === '.' || slug === '..' || slug.includes('..')) {
+        const err = new Error(`${context}: slug "${slug}" is not a valid directory name (path traversal components rejected).`);
+        // @ts-expect-error — attach code for CLI layer
+        err.code = 'EINVALID_SLUG';
+        throw err;
+    }
+}
+/**
+ * Resolve the library directory. Explicit flag wins; absolute paths are used
+ * as-is, relative paths resolve against cwd. When no flag is passed, fall
+ * back to the shipped templates/design-library path.
+ *
+ * @param {string | true | undefined | null} flag
+ * @returns {string}
+ */
+export function resolveLibraryDir(flag) {
+    if (typeof flag === 'string' && flag.length > 0) {
+        return resolvePath(flag);
+    }
+    return DEFAULT_LIBRARY_DIR;
+}
+/**
+ * Read the provenance.yaml sidecar for a given slug. Returns an empty object
+ * when missing/unparseable — callers treat `origin: null, source: null` as
+ * "unattributed".
+ *
+ * @param {string} libraryDir
+ * @param {string} slug
+ * @returns {Record<string, unknown>}
+ */
+function readProvenance(libraryDir, slug) {
+    const p = resolvePath(libraryDir, slug, 'provenance.yaml');
+    if (!existsSync(p))
+        return {};
+    try {
+        const txt = readFileSync(p, 'utf8');
+        const parsed = parseYaml(txt);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return /** @type {Record<string, unknown>} */ (parsed);
+        }
+    }
+    catch {
+        return {};
+    }
+    return {};
+}
+/**
+ * List every slug under the library directory, sorted alphabetically.
+ * Each entry carries the slug, meta.name, meta.description, provenance.origin,
+ * provenance.source. Directories missing DESIGN.md are skipped. Warnings are
+ * accumulated (not thrown) so `list` never fails wholesale on one bad entry.
+ *
+ * @param {{ libraryDir?: string }} [opts]
+ * @returns {{ entries: LibraryEntrySummary[], warnings: string[] }}
+ */
+export function listLibraryEntries(opts = {}) {
+    const libraryDir = resolveLibraryDir(opts.libraryDir);
+    const warnings = [];
+    const entries = [];
+    if (!existsSync(libraryDir)) {
+        return {
+            entries,
+            warnings: [`library directory not found at ${libraryDir}`],
+        };
+    }
+    let names;
+    try {
+        names = readdirSync(libraryDir);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { entries, warnings: [`failed to read library directory ${libraryDir}: ${msg}`] };
+    }
+    for (const name of names) {
+        const slugDir = resolvePath(libraryDir, name);
+        let st;
+        try {
+            st = statSync(slugDir);
+        }
+        catch {
+            continue;
+        }
+        if (!st.isDirectory())
+            continue;
+        const designPath = resolvePath(slugDir, 'DESIGN.md');
+        if (!existsSync(designPath)) {
+            warnings.push(`slug "${name}": no DESIGN.md, skipping`);
+            continue;
+        }
+        let text;
+        try {
+            text = readFileSync(designPath, 'utf8');
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            warnings.push(`slug "${name}": failed to read DESIGN.md: ${msg}`);
+            continue;
+        }
+        const fm = extractDesignFrontmatter(text);
+        const meta = /** @type {Record<string, unknown>} */ ((fm && fm.meta) || {});
+        const provenance = readProvenance(libraryDir, name);
+        const metaName = typeof meta.name === 'string' && meta.name.length > 0 ? meta.name : name;
+        const description = typeof meta.description === 'string' && meta.description.length > 0 ? meta.description : '';
+        const origin = typeof provenance.origin === 'string' && provenance.origin.length > 0
+            ? /** @type {string} */ (provenance.origin)
+            : 'unknown';
+        const source = typeof provenance.source === 'string' && provenance.source.length > 0
+            ? /** @type {string} */ (provenance.source)
+            : '';
+        entries.push({ slug: name, name: metaName, description, origin, source });
+    }
+    entries.sort((a, b) => (a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0));
+    return { entries, warnings };
+}
+/**
+ * Load a single library entry by slug. Returns the raw DESIGN.md text, the
+ * parsed frontmatter object, and the parsed provenance object.
+ *
+ * Throws (caller translates to CLI exit) when the slug is missing or the
+ * DESIGN.md can't be read.
+ *
+ * @param {{ libraryDir?: string, slug: string }} opts
+ * @returns {{ slug: string, path: string, design_md: string, frontmatter: Record<string, unknown> | null, provenance: Record<string, unknown> }}
+ */
+export function loadLibraryEntry(opts) {
+    if (!opts || typeof opts.slug !== 'string' || opts.slug.length === 0) {
+        throw new Error('loadLibraryEntry: slug is required');
+    }
+    assertSafeSlug(opts.slug, 'loadLibraryEntry');
+    const libraryDir = resolveLibraryDir(opts.libraryDir);
+    const slugDir = resolvePath(libraryDir, opts.slug);
+    const designPath = resolvePath(slugDir, 'DESIGN.md');
+    if (!existsSync(designPath)) {
+        const err = new Error(`Library entry "${opts.slug}" not found (expected at ${designPath}). Run \`apt-tools design-template list\` to see available slugs.`);
+        // @ts-expect-error — attach code for CLI layer
+        err.code = 'ENOENT_SLUG';
+        throw err;
+    }
+    const text = readFileSync(designPath, 'utf8');
+    const frontmatter = extractDesignFrontmatter(text);
+    const provenance = readProvenance(libraryDir, opts.slug);
+    return { slug: opts.slug, path: designPath, design_md: text, frontmatter, provenance };
+}
+/**
+ * Copy a library entry's DESIGN.md into a target project directory as
+ * `<projectDir>/DESIGN.md`. Refuses to overwrite unless `force` is set —
+ * mirrors the `author-skill` safety rule.
+ *
+ * Throws (caller translates to CLI exit) on refusal or missing slug.
+ *
+ * @param {{ libraryDir?: string, slug: string, projectDir: string, force?: boolean }} opts
+ * @returns {{ slug: string, from: string, to: string, overwritten: boolean }}
+ */
+export function addLibraryEntry(opts) {
+    if (!opts || typeof opts.slug !== 'string' || opts.slug.length === 0) {
+        throw new Error('addLibraryEntry: slug is required');
+    }
+    if (!opts.projectDir || typeof opts.projectDir !== 'string') {
+        throw new Error('addLibraryEntry: projectDir is required');
+    }
+    assertSafeSlug(opts.slug, 'addLibraryEntry');
+    const libraryDir = resolveLibraryDir(opts.libraryDir);
+    const from = resolvePath(libraryDir, opts.slug, 'DESIGN.md');
+    if (!existsSync(from)) {
+        const err = new Error(`Library entry "${opts.slug}" not found (expected at ${from}). Run \`apt-tools design-template list\` to see available slugs.`);
+        // @ts-expect-error — attach code for CLI layer
+        err.code = 'ENOENT_SLUG';
+        throw err;
+    }
+    const projectDir = resolvePath(opts.projectDir);
+    mkdirSync(projectDir, { recursive: true });
+    const to = resolvePath(projectDir, 'DESIGN.md');
+    const overwritten = existsSync(to);
+    if (overwritten && !opts.force) {
+        const err = new Error(`Refusing to overwrite existing DESIGN.md at ${to}. Re-run with --force to overwrite, or edit the file directly.`);
+        // @ts-expect-error — attach code for CLI layer
+        err.code = 'EEXIST_DEST';
+        throw err;
+    }
+    copyFileSync(from, to);
+    return { slug: opts.slug, from, to, overwritten };
+}
+/**
+ * Validate a candidate DESIGN.md and, when it passes, copy it into the
+ * library under `<libraryDir>/<slug>/DESIGN.md` with a fresh provenance.yaml
+ * whose `origin` is `community`. Does NOT open a PR — the author commits
+ * + pushes themselves.
+ *
+ * Throws (caller translates to CLI exit) when:
+ *   - the candidate file doesn't exist
+ *   - the candidate fails `validateDesignMarkdown`
+ *   - the target slug directory already exists (no --force here; community
+ *     submissions go into a fresh directory, always)
+ *
+ * @param {{ libraryDir?: string, slug?: string, candidatePath: string, force?: boolean }} opts
+ * @returns {{ slug: string, copied_to: string, provenance_path: string, warnings: string[] }}
+ */
+export function submitLibraryEntry(opts) {
+    if (!opts || typeof opts.candidatePath !== 'string' || opts.candidatePath.length === 0) {
+        throw new Error('submitLibraryEntry: candidatePath is required');
+    }
+    const candidatePath = resolvePath(opts.candidatePath);
+    if (!existsSync(candidatePath)) {
+        const err = new Error(`Candidate DESIGN.md not found at ${candidatePath}.`);
+        // @ts-expect-error — attach code for CLI layer
+        err.code = 'ENOENT_CANDIDATE';
+        throw err;
+    }
+    const text = readFileSync(candidatePath, 'utf8');
+    const validation = validateDesignMarkdown(text);
+    if (!validation.ok) {
+        const err = new Error(`Candidate DESIGN.md failed validation:\n  - ${validation.errors.join('\n  - ')}`);
+        // @ts-expect-error — attach code for CLI layer
+        err.code = 'EINVALID_CANDIDATE';
+        // @ts-expect-error — attach details
+        err.validation = validation;
+        throw err;
+    }
+    // Resolve slug: explicit --as wins; else derive from the candidate's
+    // parent directory name (e.g. `foo/DESIGN.md` → slug=foo).
+    let slug = opts.slug;
+    if (!slug || slug.length === 0) {
+        slug = basename(dirname(candidatePath));
+    }
+    if (!slug || slug.length === 0 || slug === '.' || slug === '/') {
+        throw new Error('submitLibraryEntry: could not infer slug from candidate path; pass --as <slug>');
+    }
+    // Reject slugs that would escape the library directory or otherwise
+    // target a non-directory-name path. See assertSafeSlug() for the allowed
+    // character class.
+    assertSafeSlug(slug, 'submitLibraryEntry');
+    const libraryDir = resolveLibraryDir(opts.libraryDir);
+    const targetDir = resolvePath(libraryDir, slug);
+    const targetDesign = resolvePath(targetDir, 'DESIGN.md');
+    const targetProvenance = resolvePath(targetDir, 'provenance.yaml');
+    if (existsSync(targetDir) && !opts.force) {
+        const err = new Error(`Library already contains slug "${slug}" at ${targetDir}. Pick a different --as <slug> or use --force to replace (not recommended — community submissions should land in fresh slugs).`);
+        // @ts-expect-error — attach code for CLI layer
+        err.code = 'EEXIST_SLUG';
+        throw err;
+    }
+    mkdirSync(targetDir, { recursive: true });
+    copyFileSync(candidatePath, targetDesign);
+    const provenance = {
+        origin: 'community',
+        source: 'user-submitted',
+        source_path: candidatePath,
+        source_license: 'unspecified',
+        source_author: 'unspecified',
+        submitted_at: new Date().toISOString().slice(0, 10),
+        extractor_version: null,
+        warnings: /** @type {string[]} */ (validation.warnings || []),
+    };
+    writeFileSync(targetProvenance, stringifyYaml(provenance, { lineWidth: 0 }), 'utf8');
+    return {
+        slug,
+        copied_to: targetDesign,
+        provenance_path: targetProvenance,
+        warnings: validation.warnings || [],
+    };
+}
+//# sourceMappingURL=template.mjs.map

package/dist/cli/design/template.mjs.map

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

package/dist/cli/design/validate.d.mts

@@ -0,0 +1,26 @@
+/**
+ * @typedef {{ ok: boolean, errors: string[], warnings: string[] }} ValidationResult
+ */
+/**
+ * Validate a DESIGN.md text against the canonical frontmatter schema.
+ *
+ * @param {string} text — full DESIGN.md contents, including frontmatter
+ * @returns {ValidationResult}
+ */
+export function validateDesignMarkdown(text: string): ValidationResult;
+/**
+ * Extract the frontmatter object from a DESIGN.md string.
+ *
+ * Callers that want the parsed tokens (not just ok/errors) can invoke this.
+ * Returns `null` if the file has no parseable frontmatter.
+ *
+ * @param {string} text
+ * @returns {Record<string, unknown> | null}
+ */
+export function extractDesignFrontmatter(text: string): Record<string, unknown> | null;
+export type ValidationResult = {
+    ok: boolean;
+    errors: string[];
+    warnings: string[];
+};
+//# sourceMappingURL=validate.d.mts.map

package/dist/cli/design/validate.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.mts","sourceRoot":"","sources":["../../../src/cli/design/validate.mjs"],"names":[],"mappings":"AAiBA;;GAEG;AAEH;;;;;GAKG;AACH,6CAHW,MAAM,GACJ,gBAAgB,CAyD5B;AAED;;;;;;;;GAQG;AACH,+CAHW,MAAM,GACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAe1C;+BAxFY;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE"}

package/dist/cli/design/validate.mjs

@@ -0,0 +1,94 @@
+/**
+ * design/validate.mjs — C2 DESIGN.md validator (pure fn).
+ *
+ * Grep-extracts the leading YAML frontmatter block of DESIGN.md, parses it
+ * with `yaml`, and validates the result against `DesignFrontmatterSchema`.
+ * Mirrors `skill-author/validate.mjs` so call sites share a surface.
+ *
+ * We do NOT inspect the prose body. The 9-section Stitch-style narrative is
+ * informational for humans and for generation prompts — it carries no
+ * machine-consumed facts that aren't already in the frontmatter.
+ */
+import { parse as parseYaml } from 'yaml';
+import { validateDesignFrontmatter } from './frontmatter-schema.mjs';
+const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n/;
+/**
+ * @typedef {{ ok: boolean, errors: string[], warnings: string[] }} ValidationResult
+ */
+/**
+ * Validate a DESIGN.md text against the canonical frontmatter schema.
+ *
+ * @param {string} text — full DESIGN.md contents, including frontmatter
+ * @returns {ValidationResult}
+ */
+export function validateDesignMarkdown(text) {
+    const errors = [];
+    const warnings = [];
+    if (typeof text !== 'string' || text.length === 0) {
+        return { ok: false, errors: ['DESIGN.md is empty or not a string'], warnings };
+    }
+    const fmMatch = text.match(FRONTMATTER_RE);
+    if (!fmMatch) {
+        errors.push('missing YAML frontmatter block (must start with `---\\n...\\n---\\n`)');
+        return { ok: false, errors, warnings };
+    }
+    let parsed;
+    try {
+        parsed = parseYaml(fmMatch[1]);
+    }
+    catch (err) {
+        errors.push(`frontmatter YAML parse error: ${(err && err.message) || String(err)}`);
+        return { ok: false, errors, warnings };
+    }
+    if (parsed === null ||
+        parsed === undefined ||
+        typeof parsed !== 'object' ||
+        Array.isArray(parsed)) {
+        errors.push('frontmatter must be a YAML object');
+        return { ok: false, errors, warnings };
+    }
+    const res = validateDesignFrontmatter(parsed);
+    if (!res.success) {
+        for (const issue of res.error.issues) {
+            const pathStr = issue.path && issue.path.length > 0 ? issue.path.join('.') : '(root)';
+            errors.push(`frontmatter.${pathStr}: ${issue.message}`);
+        }
+        return { ok: false, errors, warnings };
+    }
+    // Soft checks (warnings only). Match numbered Stitch sections too ("## 2. Color Palette")
+    // so scaffolds with prose ordering still pass.
+    if (!/##\s+(?:\d+\.\s+)?Color(?:\s+Palette|s)\b/.test(text)) {
+        warnings.push('body: no "## Color Palette" section found — Stitch 9-section convention recommends one');
+    }
+    if (!/##\s+(?:\d+\.\s+)?Typography\b/.test(text)) {
+        warnings.push('body: no "## Typography" section found — Stitch 9-section convention recommends one');
+    }
+    return { ok: true, errors, warnings };
+}
+/**
+ * Extract the frontmatter object from a DESIGN.md string.
+ *
+ * Callers that want the parsed tokens (not just ok/errors) can invoke this.
+ * Returns `null` if the file has no parseable frontmatter.
+ *
+ * @param {string} text
+ * @returns {Record<string, unknown> | null}
+ */
+export function extractDesignFrontmatter(text) {
+    if (typeof text !== 'string' || text.length === 0)
+        return null;
+    const m = text.match(FRONTMATTER_RE);
+    if (!m)
+        return null;
+    try {
+        const parsed = parseYaml(m[1]);
+        if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
+            return /** @type {Record<string, unknown>} */ (parsed);
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+//# sourceMappingURL=validate.mjs.map

package/dist/cli/design/validate.mjs.map

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

package/dist/cli/design/weighted-map.d.mts

@@ -0,0 +1,37 @@
+/**
+ * design/weighted-map.mjs — tiny shared helpers for the taste-infer extractors.
+ *
+ * Both `extract-url.mjs` and `extract-repo.mjs` accumulate observed design
+ * tokens (colours / fonts / spacing / etc.) into Map<string, number>
+ * counters and then convert those maps to weighted arrays sorted desc by
+ * weight, tiebreak alphabetical. The helpers live here so the two
+ * extractors share one implementation — per MI-3 in the C43 review.
+ *
+ * Do NOT add LLM-client-adjacent code to this file. Per invariant I-1, any
+ * module reachable from the extractor transitive import graph stays free
+ * of LLM SDKs — the I-1 AST invariant test only walks the extractors
+ * directly, so keeping this file small and dependency-free is the
+ * simplest way to preserve the invariant long term.
+ */
+/**
+ * Map-based counter. Non-string / empty keys are ignored. Keeps insertion
+ * order for deterministic output after `toWeighted`.
+ *
+ * @param {Map<string, number>} map
+ * @param {string} key
+ * @param {number} [by]
+ */
+export function bumpCount(map: Map<string, number>, key: string, by?: number): void;
+/**
+ * Convert a count map into `{ value, weight }[]`, sorted desc by weight
+ * with alphabetical tiebreak so output is deterministic even when two
+ * values share a weight.
+ *
+ * @param {Map<string, number>} map
+ * @returns {{ value: string, weight: number }[]}
+ */
+export function toWeighted(map: Map<string, number>): {
+    value: string;
+    weight: number;
+}[];
+//# sourceMappingURL=weighted-map.d.mts.map

package/dist/cli/design/weighted-map.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weighted-map.d.mts","sourceRoot":"","sources":["../../../src/cli/design/weighted-map.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;GAOG;AACH,+BAJW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,OACnB,MAAM,OACN,MAAM,QAMhB;AAED;;;;;;;GAOG;AACH,gCAHW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,CAM/C"}

package/dist/cli/design/weighted-map.mjs

@@ -0,0 +1,43 @@
+/**
+ * design/weighted-map.mjs — tiny shared helpers for the taste-infer extractors.
+ *
+ * Both `extract-url.mjs` and `extract-repo.mjs` accumulate observed design
+ * tokens (colours / fonts / spacing / etc.) into Map<string, number>
+ * counters and then convert those maps to weighted arrays sorted desc by
+ * weight, tiebreak alphabetical. The helpers live here so the two
+ * extractors share one implementation — per MI-3 in the C43 review.
+ *
+ * Do NOT add LLM-client-adjacent code to this file. Per invariant I-1, any
+ * module reachable from the extractor transitive import graph stays free
+ * of LLM SDKs — the I-1 AST invariant test only walks the extractors
+ * directly, so keeping this file small and dependency-free is the
+ * simplest way to preserve the invariant long term.
+ */
+/**
+ * Map-based counter. Non-string / empty keys are ignored. Keeps insertion
+ * order for deterministic output after `toWeighted`.
+ *
+ * @param {Map<string, number>} map
+ * @param {string} key
+ * @param {number} [by]
+ */
+export function bumpCount(map, key, by = 1) {
+    if (!key || typeof key !== 'string')
+        return;
+    const prev = map.get(key) ?? 0;
+    map.set(key, prev + by);
+}
+/**
+ * Convert a count map into `{ value, weight }[]`, sorted desc by weight
+ * with alphabetical tiebreak so output is deterministic even when two
+ * values share a weight.
+ *
+ * @param {Map<string, number>} map
+ * @returns {{ value: string, weight: number }[]}
+ */
+export function toWeighted(map) {
+    return [...map.entries()]
+        .map(([value, weight]) => ({ value, weight }))
+        .sort((a, b) => b.weight - a.weight || a.value.localeCompare(b.value));
+}
+//# sourceMappingURL=weighted-map.mjs.map