@clay-design-system/kb 0.0.0-stage → 0.14.1

package/dist/contract.d.ts

@@ -0,0 +1,227 @@
+/**
+ * Public query contract for `@clay-design-system/kb`.
+ *
+ * One query layer (Registry D4): the Clay CLI and `kb:mcp` call `createClayKb`, and Marko calls the
+ * same methods. Argument names and types match `scripts/kb/mcp.ts` (`clay_search`, `clay_get`,
+ * `clay_section`, `clay_rules`, `clay_route`). `route` takes the brief inline. There is no
+ * `briefPath` on this package — callers that have a file read it themselves and pass `brief`.
+ *
+ * `text` is the compact Markdown an agent reads. `data` is the same answer as structured fields
+ * (Registry "detail"). `clay_check_copy` stays on the CLI; it reads a page file.
+ *
+ * The published package ships three snapshots (Registry D11, public npm): `snapshot-web.json`,
+ * `snapshot-foundations.json` (tokens, icons, logos), and `snapshot-email.json`. Marko loads web
+ * and foundations together via `createClayKbFromSlices`. These argument shapes still accept
+ * `email`, `ds`, and `includeBackground`. A slice that does not contain those units returns no hits.
+ */
+export declare const CLAY_KB_SCHEMA_VERSION: 1;
+export declare const CLAY_STAGES: readonly ["structure", "mapping", "design", "assets", "copy", "page-file", "ux", "qa", "static", "fidelity"];
+export type ClayStage = (typeof CLAY_STAGES)[number];
+export declare const CLAY_MODES: readonly ["A", "B"];
+export type ClayMode = (typeof CLAY_MODES)[number];
+/** Values `clay_search` accepts for `scope`. Default when omitted: web + ds + shared. */
+export declare const CLAY_SEARCH_SCOPES: readonly ["web", "ds", "shared", "email", "all"];
+export type ClaySearchScope = (typeof CLAY_SEARCH_SCOPES)[number];
+export declare const CLAY_RULE_SCOPES: readonly ["web", "email"];
+export type ClayRuleScope = (typeof CLAY_RULE_SCOPES)[number];
+export interface ClayKbResult<TData> {
+    text: string;
+    data: TData;
+}
+/** In-memory dedupe state. The package never reads or writes a session file. Marko omits this. */
+export interface ClayKbSession {
+    served: Record<string, string>;
+    lines: Record<string, string>;
+    layouts: string[];
+    sections: string[];
+    stages: string[];
+}
+export interface ClayKbOptions {
+    session?: ClayKbSession;
+}
+export interface ClaySearchArgs {
+    query: string;
+    /** How many hits. Default 10. */
+    k?: number;
+    kind?: string[];
+    /** Entity ids, e.g. `section:FeaturesSection`. */
+    entity?: string[];
+    stage?: ClayStage[];
+    mode?: ClayMode;
+    scope?: ClaySearchScope[];
+    includeBackground?: boolean;
+}
+export interface ClaySearchHit {
+    id: string;
+    /** BM25F score, rounded to 3 decimal places. */
+    score: number;
+    kind: string;
+    authority: string;
+    summary: string;
+    /** File-level asset twins folded into this registry hit (one hit per logo), when there are any. */
+    aliases?: string[];
+}
+export interface ClaySearchData {
+    hits: ClaySearchHit[];
+}
+export interface ClayGetArgs {
+    /** An id ending in `*` expands to that prefix (at most 25). */
+    ids: string[];
+}
+export interface ClayKbUnitRelations {
+    supersedes?: string[];
+    conflictsWith?: string[];
+    seeAlso?: string[];
+    precedence?: string[];
+}
+export interface ClayKbUnit {
+    id: string;
+    kind: string;
+    scope: 'web' | 'email' | 'ds' | 'shared';
+    topic: string;
+    authority: 'canonical' | 'derived' | 'guidance' | 'background';
+    stages: ClayStage[];
+    modes?: ClayMode[];
+    entities: string[];
+    summary: string;
+    body: string;
+    when?: string;
+    notWhen?: string;
+    severity?: 'Critical' | 'Major' | 'Minor';
+    enforcement?: ('lint' | 'script' | 'test' | 'qa' | 'review' | 'types')[];
+    relations?: ClayKbUnitRelations;
+    source?: {
+        path: string;
+        anchor?: string;
+        generatedBy?: string;
+    };
+    status: 'active' | 'deprecated';
+    verifiedAt?: string;
+    handbookId?: string;
+    data?: unknown;
+    facts?: unknown;
+}
+export interface ClayGetData {
+    units: ClayKbUnit[];
+    missing: string[];
+    /** Ids already served on `options.session`. Always empty when no session was passed. */
+    repeated: string[];
+}
+export interface ClaySectionArgs {
+    /** e.g. `FeaturesSection`. */
+    name: string;
+    /** e.g. `tab-cards-carousel`. Several layouts may be comma-separated. */
+    layout?: string;
+}
+export interface ClaySectionData {
+    section: string;
+    layout?: string;
+    units: string[];
+}
+export interface ClayRulesArgs {
+    stage?: ClayStage;
+    mode?: ClayMode;
+    /** `email` lists email rules. `web` and omitted both list the non-email rules. */
+    scope?: ClayRuleScope;
+}
+export interface ClayRulesData {
+    units: string[];
+}
+export interface ClayRouteArgs {
+    /** Skill running the stage, e.g. `web-compose`. */
+    skill: string;
+    stage: ClayStage;
+    /** web-compose mode: A = page brief, B = PMM brief. */
+    mode?: ClayMode;
+    /** Brief text (Markdown), inline. This package has no `briefPath`. */
+    brief?: string;
+    /** Token budget. Default 2500. */
+    budget?: number;
+}
+export interface ClayBriefSection {
+    n: number;
+    title: string;
+    text: string;
+    items: number | null;
+}
+export interface ClayBriefRow {
+    section: ClayBriefSection;
+    candidates: {
+        id: string;
+        line: string;
+        fit: 'fits' | 'over' | 'under' | 'unknown';
+    }[];
+}
+export interface ClayRouteData {
+    tokens: number;
+    budget: number;
+    units: {
+        id: string;
+        tier: string;
+        inlined: 'body' | 'summary' | 'id';
+    }[];
+    brief: ClayBriefRow[];
+}
+export type ClayIndexField = 'id' | 'summary' | 'entities' | 'topic' | 'when' | 'body';
+export type ClayIndexAvg = Record<ClayIndexField, number>;
+export interface ClaySerializedSearchIndex {
+    fingerprint: string;
+    n: number;
+    avg: ClayIndexAvg;
+    channels?: Record<'web' | 'email' | 'all', {
+        n: number;
+        avg: ClayIndexAvg;
+    }>;
+    docs: {
+        id: string;
+        len: ClayIndexAvg;
+        email?: 1;
+    }[];
+    /** term → [docIndex, field term-frequencies in ClayIndexField order] */
+    postings: [string, [number, number[]][]][];
+    /** lower-case entity name → entity ids */
+    entityNames: [string, string[]][];
+}
+export interface ClayKbCounts {
+    units: number;
+    hand?: number;
+    derived?: number;
+    byKind?: Record<string, number>;
+    byAuthority?: Record<string, number>;
+    byScope?: Record<string, number>;
+}
+/**
+ * Prebuilt knowledge passed to `createClayKb`. Plain JSON (`packages/kb` export `./snapshot.json`).
+ * `generatedFromSha` is the git sha the snapshot was built from, or null for a local build.
+ */
+export type ClayKbSlice = 'web' | 'foundations' | 'email';
+export interface ClayKbSnapshot {
+    schemaVersion: typeof CLAY_KB_SCHEMA_VERSION;
+    packageVersion: string;
+    generatedFromSha: string | null;
+    /** Which file this snapshot is. Absent on a snapshot merged by `createClayKbFromSlices`. */
+    slice?: ClayKbSlice;
+    fingerprint: string;
+    counts: ClayKbCounts;
+    units: ClayKbUnit[];
+    index: ClaySerializedSearchIndex;
+}
+export interface ClayKb {
+    search(args: ClaySearchArgs): ClayKbResult<ClaySearchData>;
+    get(args: ClayGetArgs): ClayKbResult<ClayGetData>;
+    section(args: ClaySectionArgs): ClayKbResult<ClaySectionData>;
+    rules(args: ClayRulesArgs): ClayKbResult<ClayRulesData>;
+    route(args: ClayRouteArgs): ClayKbResult<ClayRouteData>;
+}
+/**
+ * Query layer over an in-memory snapshot. No filesystem and no `process.cwd`.
+ * Invalid arguments and an unknown section or stage throw `Error`.
+ * Search with no hits, and get with missing ids, return `{ text, data }` and do not throw.
+ */
+/**
+ * One query layer over several snapshots. Marko passes web + foundations. The index is rebuilt
+ * from the stored unit text so scores cover every slice, not one file at a time.
+ */
+export declare function createClayKbFromSlices(snapshots: ClayKbSnapshot[], options?: ClayKbOptions): ClayKb;
+export declare function createClayKb(snapshot: ClayKbSnapshot, options?: ClayKbOptions): ClayKb;
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

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

package/dist/contract.js

@@ -0,0 +1,134 @@
+import { get, route, rules, search, section } from './core/query.js';
+import { buildIndex, hydrateIndex, serializeIndex } from './core/search.js';
+/**
+ * Public query contract for `@clay-design-system/kb`.
+ *
+ * One query layer (Registry D4): the Clay CLI and `kb:mcp` call `createClayKb`, and Marko calls the
+ * same methods. Argument names and types match `scripts/kb/mcp.ts` (`clay_search`, `clay_get`,
+ * `clay_section`, `clay_rules`, `clay_route`). `route` takes the brief inline. There is no
+ * `briefPath` on this package — callers that have a file read it themselves and pass `brief`.
+ *
+ * `text` is the compact Markdown an agent reads. `data` is the same answer as structured fields
+ * (Registry "detail"). `clay_check_copy` stays on the CLI; it reads a page file.
+ *
+ * The published package ships three snapshots (Registry D11, public npm): `snapshot-web.json`,
+ * `snapshot-foundations.json` (tokens, icons, logos), and `snapshot-email.json`. Marko loads web
+ * and foundations together via `createClayKbFromSlices`. These argument shapes still accept
+ * `email`, `ds`, and `includeBackground`. A slice that does not contain those units returns no hits.
+ */
+export const CLAY_KB_SCHEMA_VERSION = 1;
+export const CLAY_STAGES = [
+    'structure',
+    'mapping',
+    'design',
+    'assets',
+    'copy',
+    'page-file',
+    'ux',
+    'qa',
+    'static',
+    'fidelity',
+];
+export const CLAY_MODES = ['A', 'B'];
+/** Values `clay_search` accepts for `scope`. Default when omitted: web + ds + shared. */
+export const CLAY_SEARCH_SCOPES = ['web', 'ds', 'shared', 'email', 'all'];
+export const CLAY_RULE_SCOPES = ['web', 'email'];
+function required(tool, key, value) {
+    if (value === undefined || value === null || value === '') {
+        throw new Error(`${tool}: missing required argument "${key}"`);
+    }
+}
+/**
+ * Query layer over an in-memory snapshot. No filesystem and no `process.cwd`.
+ * Invalid arguments and an unknown section or stage throw `Error`.
+ * Search with no hits, and get with missing ids, return `{ text, data }` and do not throw.
+ */
+/**
+ * One query layer over several snapshots. Marko passes web + foundations. The index is rebuilt
+ * from the stored unit text so scores cover every slice, not one file at a time.
+ */
+export function createClayKbFromSlices(snapshots, options) {
+    if (snapshots.length === 0)
+        throw new Error('createClayKbFromSlices: pass at least one snapshot');
+    const units = snapshots.flatMap((snapshot) => snapshot.units);
+    const fingerprint = snapshots.map((snapshot) => snapshot.fingerprint).join('+');
+    const built = buildIndex({ fingerprint, units: units });
+    const index = JSON.parse(serializeIndex(built));
+    delete index.$comment;
+    delete index.fields;
+    return createClayKb({
+        schemaVersion: CLAY_KB_SCHEMA_VERSION,
+        packageVersion: snapshots[0].packageVersion,
+        generatedFromSha: snapshots[0].generatedFromSha,
+        fingerprint,
+        counts: {
+            units: units.length,
+            byScope: snapshots.reduce((acc, snapshot) => {
+                for (const [scope, count] of Object.entries(snapshot.counts.byScope ?? {})) {
+                    acc[scope] = (acc[scope] ?? 0) + count;
+                }
+                return acc;
+            }, {}),
+        },
+        units,
+        index,
+    }, options);
+}
+export function createClayKb(snapshot, options) {
+    if (snapshot.schemaVersion !== CLAY_KB_SCHEMA_VERSION) {
+        throw new Error(`createClayKb: snapshot schemaVersion must be ${CLAY_KB_SCHEMA_VERSION}, got ${String(snapshot.schemaVersion)}`);
+    }
+    if (!Array.isArray(snapshot.units) ||
+        snapshot.index == null ||
+        typeof snapshot.fingerprint !== 'string') {
+        throw new Error('createClayKb: snapshot needs units, index, and fingerprint');
+    }
+    const units = snapshot.units;
+    const ctx = {
+        kb: { fingerprint: snapshot.fingerprint, units },
+        index: hydrateIndex(snapshot.index),
+        byId: new Map(units.map((unit) => [unit.id, unit])),
+    };
+    const session = options?.session;
+    return {
+        search(args) {
+            required('clay_search', 'query', args.query);
+            return search(ctx, args.query, {
+                k: args.k,
+                kind: args.kind,
+                entity: args.entity,
+                stage: args.stage,
+                mode: args.mode,
+                scope: args.scope,
+                includeBackground: args.includeBackground,
+            });
+        },
+        get(args) {
+            if (!Array.isArray(args.ids) || args.ids.length === 0)
+                required('clay_get', 'ids', undefined);
+            return get(ctx, args.ids, { session });
+        },
+        section(args) {
+            required('clay_section', 'name', args.name);
+            return section(ctx, args.name, args.layout, { session });
+        },
+        rules(args = {}) {
+            return rules(ctx, { stage: args.stage, mode: args.mode, scope: args.scope });
+        },
+        route(args) {
+            required('clay_route', 'skill', args.skill);
+            required('clay_route', 'stage', args.stage);
+            const result = route(ctx, {
+                skill: args.skill,
+                stage: args.stage,
+                mode: args.mode,
+                brief: args.brief,
+                budget: args.budget,
+                session,
+            });
+            const { text: _routeText, ...data } = result.data;
+            return { text: result.text, data };
+        },
+    };
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

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

package/dist/core/memory.d.ts

@@ -0,0 +1,20 @@
+/**
+ * In-memory dedupe for one build. The Clay CLI loads and saves this object;
+ * the core only mutates the object it is given.
+ */
+export interface MemorySession {
+    served: Record<string, string>;
+    lines: Record<string, string>;
+    layouts: string[];
+    sections: string[];
+    stages: string[];
+}
+/** Record a unit as served in full (first place wins). */
+export declare function markServed(s: MemorySession | undefined, id: string, where: string): void;
+/** Record a unit's one-line summary as served. */
+export declare function markLine(s: MemorySession | undefined, id: string, where: string): void;
+/** Already seen at least as a line (or a body). */
+export declare const seenLine: (s: MemorySession | undefined, id: string) => boolean;
+export declare const seenBody: (s: MemorySession | undefined, id: string) => boolean;
+export declare function noteSection(s: MemorySession | undefined, name: string, layout?: string): void;
+//# sourceMappingURL=memory.d.ts.map

package/dist/core/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/core/memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAExF;AAED,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEtF;AAED,mDAAmD;AACnD,eAAO,MAAM,QAAQ,GAAI,GAAG,aAAa,GAAG,SAAS,EAAE,IAAI,MAAM,YACvB,CAAA;AAC1C,eAAO,MAAM,QAAQ,GAAI,GAAG,aAAa,GAAG,SAAS,EAAE,IAAI,MAAM,YAA0B,CAAA;AAE3F,wBAAgB,WAAW,CAAC,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAK7F"}

package/dist/core/memory.js

@@ -0,0 +1,23 @@
+/** Record a unit as served in full (first place wins). */
+export function markServed(s, id, where) {
+    if (s && !s.served[id])
+        s.served[id] = where;
+}
+/** Record a unit's one-line summary as served. */
+export function markLine(s, id, where) {
+    if (s && !s.lines[id])
+        s.lines[id] = where;
+}
+/** Already seen at least as a line (or a body). */
+export const seenLine = (s, id) => !!s && (!!s.lines[id] || !!s.served[id]);
+export const seenBody = (s, id) => !!s && !!s.served[id];
+export function noteSection(s, name, layout) {
+    if (!s || !name)
+        return;
+    if (!s.sections.includes(name))
+        s.sections.push(name);
+    const key = layout ? `${name}.${layout}` : '';
+    if (key && !s.layouts.includes(key))
+        s.layouts.push(key);
+}
+//# sourceMappingURL=memory.js.map

package/dist/core/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/core/memory.ts"],"names":[],"mappings":"AAYA,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,CAA4B,EAAE,EAAU,EAAE,KAAa;IAChF,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,KAAK,CAAA;AAC9C,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,QAAQ,CAAC,CAA4B,EAAE,EAAU,EAAE,KAAa;IAC9E,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,KAAK,CAAA;AAC5C,CAAC;AAED,mDAAmD;AACnD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAA4B,EAAE,EAAU,EAAE,EAAE,CACnE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;AAC1C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAA4B,EAAE,EAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AAE3F,MAAM,UAAU,WAAW,CAAC,CAA4B,EAAE,IAAY,EAAE,MAAe;IACrF,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI;QAAE,OAAM;IACvB,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC7C,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC1D,CAAC"}

package/dist/core/model.d.ts

@@ -0,0 +1,47 @@
+/**
+ * In-memory knowledge the query core reads. No filesystem.
+ * Field set is the subset search, route, and the answer formatters use.
+ * `STAGES` matches `kb/schema.ts` and `CLAY_STAGES` in `../contract.ts`.
+ */
+export declare const STAGES: readonly ["structure", "mapping", "design", "assets", "copy", "page-file", "ux", "qa", "static", "fidelity"];
+export type Stage = (typeof STAGES)[number];
+export declare function estimateTokens(text: string): number;
+export interface Unit {
+    id: string;
+    kind: string;
+    scope: string;
+    topic: string;
+    authority: string;
+    stages: string[];
+    modes?: ('A' | 'B')[];
+    entities: string[];
+    summary: string;
+    body: string;
+    when?: string;
+    notWhen?: string;
+    severity?: string;
+    enforcement?: string[];
+    relations?: {
+        supersedes?: string[];
+        conflictsWith?: string[];
+        seeAlso?: string[];
+        precedence?: string[];
+    };
+    source: {
+        path: string;
+        anchor?: string;
+        generatedBy?: string;
+    };
+    status: string;
+    verifiedAt?: string;
+    handbookId?: string;
+    data?: unknown;
+    facts?: unknown;
+    file?: string;
+}
+export type KbUnit = Unit;
+export interface Kb {
+    fingerprint: string;
+    units: KbUnit[];
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/core/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/core/model.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,MAAM,8GAWT,CAAA;AAEV,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,KAAK,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAAA;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,SAAS,CAAC,EAAE;QACV,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;QACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;QACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;QAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KACtB,CAAA;IACD,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/D,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,MAAM,GAAG,IAAI,CAAA;AAEzB,MAAM,WAAW,EAAE;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB"}

package/dist/core/model.js

@@ -0,0 +1,21 @@
+/**
+ * In-memory knowledge the query core reads. No filesystem.
+ * Field set is the subset search, route, and the answer formatters use.
+ * `STAGES` matches `kb/schema.ts` and `CLAY_STAGES` in `../contract.ts`.
+ */
+export const STAGES = [
+    'structure',
+    'mapping',
+    'design',
+    'assets',
+    'copy',
+    'page-file',
+    'ux',
+    'qa',
+    'static',
+    'fidelity',
+];
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+//# sourceMappingURL=model.js.map

package/dist/core/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/core/model.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,WAAW;IACX,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,WAAW;IACX,IAAI;IACJ,IAAI;IACJ,QAAQ;IACR,UAAU;CACF,CAAA;AAIV,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AACnC,CAAC"}

package/dist/core/prose.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Prose utilities for the general `kb:lint` claim checks (K3 retry 2): split a unit into sentences,
+ * reduce a sentence to its significant tokens, and weigh tokens by rarity (IDF) over the corpus.
+ *
+ * Normalisation is deliberately simple and symmetric (both sides of every comparison go through it):
+ *   - unit-id citations (`policy.x.y`) are removed (a citation is a link, not content);
+ *   - Markdown punctuation is dropped; `gray` → `grey`; "back to back" / "next to each other" /
+ *     "adjacent" / "consecutive" / "in a row" → `adjacent`;
+ *   - numbers keep their unit (`64 px` → `64px`) and ranges become one token (`4–6` → `4to6`);
+ *   - identifiers are split on `-` / `_` / camelCase is kept whole (`tabs-background` → tabs, background;
+ *     `FeaturesSection` → featuressection);
+ *   - English stop words and normative words (never/always/must/only/…) are not significant: the
+ *     normative words mark a *rule* sentence but never count as shared content;
+ *   - a light stemmer folds plurals and -ing/-ed.
+ */
+import { stem } from './rank.js';
+export declare const UNIT_ID_RE: RegExp;
+/** A sentence carries a rule when it says what to always / never / only do. */
+export declare const NORMATIVE_RE: RegExp;
+/**
+ * A sentence gives an instruction without a normative word: it opens with a base verb, optionally after a leading
+ * "When/Whenever/If …," clause ("Whenever a MediaSlot is a placeholder, give it a placeholderLabel …"). K4: candidate
+ * restatements are normative OR imperative sentences.
+ */
+export declare const IMPERATIVE_RE: RegExp;
+/** The light stemmer (folds plurals, -ing/-ed) lives with the search analyzer so lint and search stem alike. */
+export { stem };
+/** Text with citations, Markdown and phrasing variants normalised (still human-readable). */
+export declare function normaliseText(s: string): string;
+/** Significant, stemmed tokens of a sentence (a set). */
+export declare function sigTokens(s: string): Set<string>;
+export declare const isNumericToken: (t: string) => boolean;
+/** Sentences of a Markdown body: one per table row / list item / line, lines split on `. ` + capital and (unless `keepSemicolons`) on `; `. Code fences are skipped. */
+export declare function sentences(text: string, opts?: {
+    keepSemicolons?: boolean;
+}): string[];
+/** Inverse document frequency over a corpus of token sets: rare tokens weigh more. */
+export declare function idfOf(docs: Iterable<Set<string>>): (t: string) => number;
+export declare function intersect(a: Set<string>, b: Set<string>): string[];
+//# sourceMappingURL=prose.d.ts.map

package/dist/core/prose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prose.d.ts","sourceRoot":"","sources":["../../src/core/prose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,eAAO,MAAM,UAAU,QAC+J,CAAA;AAEtL,+EAA+E;AAC/E,eAAO,MAAM,YAAY,QACkJ,CAAA;AAE3K;;;;GAIG;AACH,eAAO,MAAM,aAAa,QACmO,CAAA;AAgB7P,gHAAgH;AAChH,OAAO,EAAE,IAAI,EAAE,CAAA;AAEf,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAU/C;AAED,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAYhD;AAED,eAAO,MAAM,cAAc,GAAI,GAAG,MAAM,YAAkB,CAAA;AAE1D,wKAAwK;AACxK,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,EAAE,CAqBzF;AAED,sFAAsF;AACtF,wBAAgB,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAQxE;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAKlE"}