@itaila/archetype 0.3.30

package/dist/evals/action-contracts.js

@@ -0,0 +1,208 @@
+const GENERIC_NAME_WORDS = new Set([
+    'data',
+    'handle',
+    'process',
+    'execute',
+    'perform',
+    'do',
+    'action',
+    'thing',
+    'item',
+    'object',
+    'stuff',
+    'info',
+    'update',
+    'manage',
+    'run',
+]);
+export function auditActionContracts(input) {
+    const issues = [];
+    const actions = input.config.actions ?? {};
+    const entities = input.config.entities ?? {};
+    for (const [name, action] of Object.entries(actions)) {
+        issues.push(...auditSingleAction(name, action));
+    }
+    for (const [name, entity] of Object.entries(entities)) {
+        issues.push(...auditSingleEntity(name, entity));
+    }
+    return {
+        pass: !issues.some((i) => i.severity === 'error'),
+        issues,
+    };
+}
+function auditSingleAction(name, action) {
+    const issues = [];
+    const desc = action.description ?? '';
+    if (isGenericName(name)) {
+        issues.push({
+            severity: 'error',
+            surface: 'action',
+            name,
+            principle: 'generic-name',
+            message: `Action name "${name}" is too generic — the AI has to read the description to guess what it does.`,
+            suggestion: `Rename to something self-documenting (verb + noun: sendEmail, logMeal, scheduleCall). A good action name makes the description redundant for the happy path.`,
+        });
+    }
+    if (!desc.trim()) {
+        issues.push({
+            severity: 'warn',
+            surface: 'action',
+            name,
+            principle: 'missing-description',
+            message: `Action "${name}" has no description.`,
+            suggestion: `If the name is self-documenting the description can be one line about WHEN to use it (not WHAT it does — the name carries that).`,
+        });
+    }
+    // If name is self-documenting but description is long, flag over-documentation
+    if (!isGenericName(name) && desc.length > 180) {
+        const restatesName = looksLikeNameRestatement(name, desc);
+        if (restatesName) {
+            issues.push({
+                severity: 'warn',
+                surface: 'action',
+                name,
+                principle: 'self-documenting-overdocumented',
+                message: `Action "${name}" is self-documenting but the ${desc.length}-char description seems to restate what the name says.`,
+                suggestion: `A self-documenting name deserves a one-line description about when to use it, not a restatement of what it does.`,
+            });
+        }
+    }
+    // Check schema shape for vagueness
+    if (action.schema) {
+        const vague = detectVagueSchema(action.schema);
+        for (const v of vague) {
+            issues.push({
+                severity: v.severity,
+                surface: 'action',
+                name,
+                principle: v.principle,
+                message: v.message,
+                suggestion: v.suggestion,
+            });
+        }
+    }
+    return issues;
+}
+function auditSingleEntity(name, entity) {
+    const issues = [];
+    const desc = entity.description ?? '';
+    if (isGenericName(name)) {
+        issues.push({
+            severity: 'warn',
+            surface: 'entity',
+            name,
+            principle: 'generic-name',
+            message: `Entity name "${name}" is generic — the AI will have trouble routing between this and other entities.`,
+            suggestion: `Rename to match the domain noun (meal, task, shift, etc.).`,
+        });
+    }
+    if (!desc.trim()) {
+        issues.push({
+            severity: 'warn',
+            surface: 'entity',
+            name,
+            principle: 'missing-description',
+            message: `Entity "${name}" has no description — the AI may not know when to use it vs. memory or other entities.`,
+            suggestion: `Describe what this entity represents and when the AI should route changes here (vs. memory, vs. another entity).`,
+        });
+    }
+    // Field-level checks
+    const schema = entity.schema;
+    if (schema && 'shape' in schema) {
+        const shape = schema.shape;
+        for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+            const fieldDescription = fieldSchema?.description ?? fieldSchema?._def?.description;
+            if (!fieldDescription && !isObviouslyTypedField(fieldName, fieldSchema)) {
+                issues.push({
+                    severity: 'warn',
+                    surface: 'entity',
+                    name,
+                    principle: 'missing-field-description',
+                    message: `Entity "${name}" field "${fieldName}" has no describe() annotation.`,
+                    suggestion: `Add .describe('...') explaining the semantics — especially if the field name isn't self-explanatory or if values need examples/routing hints.`,
+                });
+            }
+        }
+    }
+    return issues;
+}
+function isGenericName(name) {
+    const tokens = name
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/[_-]/g, ' ')
+        .toLowerCase()
+        .split(/\s+/)
+        .filter(Boolean);
+    if (tokens.length === 0)
+        return false;
+    if (tokens.every((token) => GENERIC_NAME_WORDS.has(token)))
+        return true;
+    // Single-word generic
+    if (tokens.length === 1 && GENERIC_NAME_WORDS.has(tokens[0]))
+        return true;
+    return false;
+}
+function looksLikeNameRestatement(name, description) {
+    const nameTokens = name
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/[_-]/g, ' ')
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((token) => token.length > 3);
+    if (nameTokens.length === 0)
+        return false;
+    const descLower = description.toLowerCase();
+    const matches = nameTokens.filter((token) => descLower.includes(token));
+    return matches.length === nameTokens.length;
+}
+function detectVagueSchema(schema, path = '') {
+    const issues = [];
+    const typeName = schema?._def?.typeName;
+    const here = path ? ` (at ${path})` : '';
+    if (typeName === 'ZodAny' || typeName === 'ZodUnknown') {
+        issues.push({
+            severity: 'error',
+            principle: 'vague-schema-type',
+            message: `Schema uses z.any() or z.unknown()${here} — the AI has no type guidance for the payload.`,
+            suggestion: `Tighten to the actual shape. If the payload is dynamic, use z.record() or discriminated unions so the AI knows the space.`,
+        });
+    }
+    // Recurse into object fields
+    if (typeName === 'ZodObject' && 'shape' in schema) {
+        const shape = schema.shape;
+        for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+            issues.push(...detectVagueSchema(fieldSchema, path ? `${path}.${fieldName}` : fieldName));
+        }
+    }
+    // Unwrap optional/nullable/default
+    const innerType = schema?._def?.innerType;
+    if (innerType && (typeName === 'ZodOptional' || typeName === 'ZodNullable' || typeName === 'ZodDefault')) {
+        issues.push(...detectVagueSchema(innerType, path));
+    }
+    return issues;
+}
+function isObviouslyTypedField(name, schema) {
+    const n = name.toLowerCase();
+    const typeName = schema?._def?.typeName;
+    // Well-known field names whose semantics are obvious from the type
+    const obvious = new Set([
+        'id',
+        'uuid',
+        'name',
+        'title',
+        'description',
+        'createdat',
+        'updatedat',
+        'email',
+        'url',
+        'count',
+        'index',
+    ]);
+    if (obvious.has(n))
+        return true;
+    // Enums are self-documenting
+    if (typeName === 'ZodEnum' || typeName === 'ZodNativeEnum')
+        return true;
+    return false;
+}
+//# sourceMappingURL=action-contracts.js.map

package/dist/evals/action-contracts.js.map

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

package/dist/evals/brain-bloat.d.ts

@@ -0,0 +1,39 @@
+import type { LoadedBrainArtifact } from '../types.js';
+export interface BrainBloatAuditInput {
+    markdown?: string;
+    brain?: LoadedBrainArtifact;
+    sourcePath?: string;
+    options?: Partial<BrainBloatAuditOptions>;
+}
+export interface BrainBloatAuditOptions {
+    maxTotalChars: number;
+    maxParagraphChars: number;
+    sectionCharBudgets: Record<string, number>;
+    defaultSectionChars: number;
+}
+export interface BrainBloatAuditIssue {
+    severity: 'error' | 'warn';
+    kind: 'total-brain-size' | 'section-size' | 'long-paragraph' | 'repeated-line' | 'implementation-leakage';
+    message: string;
+    section?: string;
+    actual?: number;
+    limit?: number;
+}
+export interface BrainBloatSectionMetric {
+    name: string;
+    chars: number;
+    lines: number;
+    paragraphs: number;
+}
+export interface BrainBloatAuditResult {
+    pass: boolean;
+    issues: BrainBloatAuditIssue[];
+    metrics: {
+        totalChars: number;
+        totalLines: number;
+        sectionCount: number;
+        sections: BrainBloatSectionMetric[];
+    };
+}
+export declare function auditBrainBloat(input: BrainBloatAuditInput): BrainBloatAuditResult;
+//# sourceMappingURL=brain-bloat.d.ts.map

package/dist/evals/brain-bloat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-bloat.d.ts","sourceRoot":"","sources":["../../src/evals/brain-bloat.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,mBAAmB,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAA;CAC1C;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,CAAA;IACrB,iBAAiB,EAAE,MAAM,CAAA;IACzB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAA;IAC1B,IAAI,EACA,kBAAkB,GAClB,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,wBAAwB,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,oBAAoB,EAAE,CAAA;IAC9B,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAA;QAClB,UAAU,EAAE,MAAM,CAAA;QAClB,YAAY,EAAE,MAAM,CAAA;QACpB,QAAQ,EAAE,uBAAuB,EAAE,CAAA;KACpC,CAAA;CACF;AAmDD,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAwFlF"}

package/dist/evals/brain-bloat.js

@@ -0,0 +1,167 @@
+import { parseBrainMarkdown } from '../brain.js';
+const DEFAULT_OPTIONS = {
+    maxTotalChars: 4000,
+    maxParagraphChars: 420,
+    defaultSectionChars: 900,
+    sectionCharBudgets: {
+        // Voice formatting enumerates markdown/rendering capabilities — it's
+        // mechanical, not prescriptive, so a slightly longer section is OK here.
+        'voice-formatting': 320,
+        methodology: 1400,
+        'action-protocol': 1200,
+        'greeting-guidelines': 250,
+        'retrospective-guidelines': 350,
+        directives: 500,
+        discovery: 450,
+    },
+};
+const CONCISE_SECTIONS = new Set([
+    'voice-formatting',
+    'action-protocol',
+    'greeting-guidelines',
+    'retrospective-guidelines',
+    'directives',
+    'discovery',
+]);
+/**
+ * Patterns that indicate actual implementation mechanics leaking into the brain.
+ * Tuned to avoid false positives on domain vocabulary — e.g., a nutrition brain
+ * talking about a "food record" is scene-setting, not implementation leakage.
+ * The patterns below look for infrastructure phrasing, not just nouns.
+ */
+const IMPLEMENTATION_LEAKAGE_PATTERNS = [
+    /\bcrud\b/i,
+    /\buse the (\w+\s+)?entity\b/i,
+    /\buse the id shown\b/i,
+    /\bthe id (shown|from)\b/i,
+    /\bcontext block\b/i,
+    /\bupdate (the |your )?record\b/i,
+    /\buse the record\b/i,
+    /\brecord (cleanup|update|id|entry)\b/i,
+    /\brecord shows\b/i,
+    /\brecipe:\s*null\b/i,
+    /\bzod\b/i,
+    /\bjson (schema|format|response)\b/i,
+    /\breturn.*\bjson\b/i,
+    /\bschema\b.*\b(compliance|validation)\b/i,
+];
+export function auditBrainBloat(input) {
+    const options = { ...DEFAULT_OPTIONS, ...input.options, sectionCharBudgets: { ...DEFAULT_OPTIONS.sectionCharBudgets, ...(input.options?.sectionCharBudgets ?? {}) } };
+    const brain = input.brain ?? parseBrainMarkdown(input.markdown ?? '', input.sourcePath);
+    const sections = Object.entries(brain.sections).map(([name, content]) => ({
+        name,
+        content,
+        chars: content.length,
+        lines: content.split('\n').length,
+        paragraphs: countParagraphs(content),
+    }));
+    const issues = [];
+    const totalChars = sections.reduce((sum, section) => sum + section.chars, 0);
+    const totalLines = sections.reduce((sum, section) => sum + section.lines, 0);
+    if (totalChars > options.maxTotalChars) {
+        issues.push({
+            severity: 'error',
+            kind: 'total-brain-size',
+            message: `Brain carries ${totalChars} chars across sections (limit ${options.maxTotalChars}).`,
+            actual: totalChars,
+            limit: options.maxTotalChars,
+        });
+    }
+    for (const section of sections) {
+        const sectionLimit = options.sectionCharBudgets[section.name] ?? options.defaultSectionChars;
+        if (section.chars > sectionLimit) {
+            issues.push({
+                severity: 'error',
+                kind: 'section-size',
+                section: section.name,
+                message: `Section "${section.name}" carries ${section.chars} chars (limit ${sectionLimit}).`,
+                actual: section.chars,
+                limit: sectionLimit,
+            });
+        }
+        for (const paragraph of collectParagraphs(section.content)) {
+            if (paragraph.length > options.maxParagraphChars) {
+                issues.push({
+                    severity: CONCISE_SECTIONS.has(section.name) ? 'error' : 'warn',
+                    kind: 'long-paragraph',
+                    section: section.name,
+                    message: `Section "${section.name}" contains a long paragraph of ${paragraph.length} chars.`,
+                    actual: paragraph.length,
+                    limit: options.maxParagraphChars,
+                });
+            }
+        }
+        for (const rawLine of section.content.split('\n')) {
+            const trimmed = rawLine.trim();
+            if (!trimmed)
+                continue;
+            if (!IMPLEMENTATION_LEAKAGE_PATTERNS.some(pattern => pattern.test(trimmed)))
+                continue;
+            issues.push({
+                severity: CONCISE_SECTIONS.has(section.name) ? 'error' : 'warn',
+                kind: 'implementation-leakage',
+                section: section.name,
+                message: `Section "${section.name}" leaks implementation mechanics instead of staying brain-level: "${trimmed}"`,
+            });
+        }
+    }
+    const repeatedLines = findRepeatedLines(sections.map(section => ({ name: section.name, content: section.content })));
+    for (const repeated of repeatedLines) {
+        issues.push({
+            severity: 'warn',
+            kind: 'repeated-line',
+            message: `Repeated line appears across sections: "${repeated.line}"`,
+        });
+    }
+    return {
+        pass: issues.every(issue => issue.severity !== 'error'),
+        issues,
+        metrics: {
+            totalChars,
+            totalLines,
+            sectionCount: sections.length,
+            sections: sections.map(section => ({
+                name: section.name,
+                chars: section.chars,
+                lines: section.lines,
+                paragraphs: section.paragraphs,
+            })),
+        },
+    };
+}
+function collectParagraphs(content) {
+    return content
+        .split(/\n\s*\n/g)
+        .map(paragraph => paragraph.replace(/\s+/g, ' ').trim())
+        .filter(Boolean);
+}
+function countParagraphs(content) {
+    return collectParagraphs(content).length;
+}
+function normalizeRepeatedLineCandidate(line) {
+    return line
+        .replace(/^[-*]\s+/, '')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .toLowerCase();
+}
+function findRepeatedLines(sections) {
+    const seen = new Map();
+    const canonical = new Map();
+    for (const section of sections) {
+        for (const rawLine of section.content.split('\n')) {
+            const normalized = normalizeRepeatedLineCandidate(rawLine);
+            if (!normalized || normalized.length < 45)
+                continue;
+            if (!canonical.has(normalized))
+                canonical.set(normalized, rawLine.trim());
+            const owners = seen.get(normalized) ?? new Set();
+            owners.add(section.name);
+            seen.set(normalized, owners);
+        }
+    }
+    return Array.from(seen.entries())
+        .filter(([, owners]) => owners.size > 1)
+        .map(([normalized]) => ({ line: canonical.get(normalized) ?? normalized }));
+}
+//# sourceMappingURL=brain-bloat.js.map

package/dist/evals/brain-bloat.js.map

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

package/dist/evals/brain-prescriptions.d.ts

@@ -0,0 +1,30 @@
+import type { LoadedBrainArtifact } from '../types.js';
+export interface BrainPrescriptionsAuditInput {
+    markdown?: string;
+    brain?: LoadedBrainArtifact;
+    sourcePath?: string;
+}
+export interface BrainPrescription {
+    severity: 'error' | 'warn';
+    shape: 'trigger-response' | 'exception-rule' | 'negative-contrast' | 'field-value-prescription' | 'enum-semantic-definition' | 'announce-actions';
+    section: string;
+    brainText: string;
+    /** Why it's a problem. */
+    issue: string;
+    /** Concrete next step — either move to a specific layer or delete. */
+    suggestion: string;
+}
+export interface BrainPrescriptionsAuditResult {
+    pass: boolean;
+    prescriptions: BrainPrescription[];
+    /** What this audit catches and what it cannot — always returned so callers
+     *  know to pair with auditPrompt for full coverage. */
+    scope: AuditScope;
+}
+export interface AuditScope {
+    catches: string[];
+    misses: string[];
+    recommendation: string;
+}
+export declare function auditBrainPrescriptions(input: BrainPrescriptionsAuditInput): BrainPrescriptionsAuditResult;
+//# sourceMappingURL=brain-prescriptions.d.ts.map

package/dist/evals/brain-prescriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-prescriptions.d.ts","sourceRoot":"","sources":["../../src/evals/brain-prescriptions.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,mBAAmB,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAA;IAC1B,KAAK,EACD,kBAAkB,GAClB,gBAAgB,GAChB,mBAAmB,GACnB,0BAA0B,GAC1B,0BAA0B,GAC1B,kBAAkB,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,OAAO,CAAA;IACb,aAAa,EAAE,iBAAiB,EAAE,CAAA;IAClC;2DACuD;IACvD,KAAK,EAAE,UAAU,CAAA;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;CACvB;AAoHD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,4BAA4B,GAAG,6BAA6B,CA0B1G"}

package/dist/evals/brain-prescriptions.js

@@ -0,0 +1,148 @@
+/**
+ * Brain prescriptions detector — catches trigger-response rules, exception
+ * rules, field-value prescription, and enum semantics that belong in schemas,
+ * even when they don't name a specific entity.
+ *
+ * The cross-layer duplicate detector is entity-gated: it triggers only when
+ * a brain line names a specific entity and looks prescriptive. That misses
+ * the common shape where the brain prescribes behavior without naming the
+ * entity — "if you are changing weight, preserve its duration" — which is
+ * exactly the boxing pattern a scenario-first audit must catch.
+ *
+ * This audit catches those shapes structurally. It is necessarily partial —
+ * pattern matching will never catch semantic issues. For full coverage, pair
+ * with auditPrompt (LLM reviewer). Each finding has a `suggestion` that
+ * points to where the rule should live (field describe, enum describe, or
+ * deletion if the standard is already implicit in the persona).
+ */
+import { parseBrainMarkdown } from '../brain.js';
+const PRESCRIPTIONS_SCOPE = {
+    catches: [
+        'explicit trigger-response shapes: "if you are X, Y", "when you X, Y", "after X, Y"',
+        'exception rules: "do X unless Y"',
+        'negative contrast: "X rather than Y"',
+        'field-value prescription: "set X 0", "include Y", numeric field assignments in brain',
+        'enum semantics baked into brain: "X-category are only for Y", "X is for Y"',
+        'announce-action anti-patterns: "speak to", "narrate", explicit talk-about-action verbs',
+    ],
+    misses: [
+        'semantic contradictions between sections (needs auditPrompt)',
+        'underspecified / vague instructions (needs auditPrompt)',
+        'trigger-response wrapped in indirect phrasing the patterns miss (needs auditPrompt)',
+        'subtle boxing that uses domain vocabulary creatively (needs auditPrompt)',
+    ],
+    recommendation: 'Pair this with auditPrompt (LLM reviewer) for coverage of semantic issues this pattern-based audit cannot catch.',
+};
+const PATTERNS = [
+    // Trigger-response shapes
+    {
+        shape: 'trigger-response',
+        regex: /\bif you (are |'re )?\w+ing\b/i,
+        issue: '"if you are [verb]ing" is a classic trigger-response shape — it prescribes behavior for a specific situation the expert can judge.',
+        severity: 'warn',
+        suggest: 'Describe the standard or move the situational cue into field describe()s the AI can read at decision time.',
+    },
+    {
+        shape: 'trigger-response',
+        // Must be a sentence-level trigger (start of sentence or after punctuation),
+        // so subordinate clauses like "use formatting when it helps" don't match.
+        regex: /(^|[.!?;]\s+)\bwhen (you|the user|the athlete|the client|they) \w+.*,\s/i,
+        issue: '"when [actor] [verb], [do X]" prescribes what to do in a specific scenario. The expert should decide.',
+        severity: 'warn',
+        suggest: 'Describe the standard. If the rule is real routing logic, move it to the entity/schema layer.',
+    },
+    {
+        shape: 'trigger-response',
+        regex: /\bafter (the |you |your )?\w+ing\b/i,
+        issue: '"after [verb]ing" prescribes sequencing — classic announce-actions or step-ordering boxing.',
+        severity: 'warn',
+        suggest: 'Trust the expert to decide what comes next. If the constraint is real, describe it as a standard.',
+    },
+    // Exception rules
+    {
+        shape: 'exception-rule',
+        regex: /\b(preserve|use|do|keep|hold)\b[^\.]{0,80}\bunless\b/i,
+        issue: '"X unless Y" is an exception rule — prescribing default behavior plus an escape hatch. The expert knows when exceptions apply.',
+        severity: 'warn',
+        suggest: 'Describe the field\'s semantics (what it represents) so the AI can reason about it naturally.',
+    },
+    // Negative contrast
+    {
+        shape: 'negative-contrast',
+        regex: /\brather than\b|\bnot.{0,30}\binstead\b/i,
+        issue: '"X rather than Y" prescribes a specific choice over another — the expert should decide.',
+        severity: 'warn',
+        suggest: 'Describe why the standard matters or delete if the keystone/identity already implies it.',
+    },
+    // Field-value prescription
+    {
+        shape: 'field-value-prescription',
+        regex: /\bset \w+ (?:to )?\d+\b/i,
+        issue: 'Brain is prescribing a specific field value numerically. That\'s a mechanical rule, not persona guidance.',
+        severity: 'error',
+        suggest: 'Move the value into the relevant field describe() or the enum value that owns the semantics.',
+    },
+    {
+        shape: 'field-value-prescription',
+        regex: /\binclude \w+(Seconds|Ms|Lbs|Kg|Reps|Sets)\b/i,
+        issue: 'Brain is prescribing which schema field to include. That\'s routing logic that belongs in the schema.',
+        severity: 'warn',
+        suggest: 'Move the inclusion rule to the field describe() or to the enum value\'s semantics.',
+    },
+    // Enum semantic definition
+    {
+        shape: 'enum-semantic-definition',
+        regex: /\b\w+[- ]?category (are|is) (only )?(for|used)\b/i,
+        issue: 'Brain is defining what a category/enum value means. That semantic belongs in the enum\'s describe() annotation.',
+        severity: 'warn',
+        suggest: 'Move this definition into the enum field\'s describe(): `z.enum([\'X\', ...]).describe(\'X is for ..., ...\')`',
+    },
+    {
+        shape: 'enum-semantic-definition',
+        regex: /\b(are only for|only for standalone|exclusively (for|used))\b/i,
+        issue: 'Brain is narrowing the scope of a category — defining its semantic boundary. Belongs in the enum\'s describe().',
+        severity: 'warn',
+        suggest: 'Move the scope definition to the enum field\'s describe() so the schema carries the meaning.',
+    },
+    // Announce-actions
+    {
+        shape: 'announce-actions',
+        regex: /\b(speak to|narrate|describe (the|your) action|mention (your )?action)\b/i,
+        issue: 'Brain is directing the AI on how to talk about its own actions — a common boxing anti-pattern.',
+        severity: 'warn',
+        suggest: 'Delete. The keystone + identity handle this naturally when the AI is briefed, not micromanaged.',
+    },
+];
+export function auditBrainPrescriptions(input) {
+    const brain = input.brain ?? parseBrainMarkdown(input.markdown ?? '', input.sourcePath);
+    const prescriptions = [];
+    for (const [sectionName, sectionContent] of Object.entries(brain.sections)) {
+        for (const line of extractMeaningfulLines(sectionContent)) {
+            for (const pattern of PATTERNS) {
+                if (!pattern.regex.test(line))
+                    continue;
+                prescriptions.push({
+                    severity: pattern.severity,
+                    shape: pattern.shape,
+                    section: sectionName,
+                    brainText: line,
+                    issue: pattern.issue,
+                    suggestion: pattern.suggest,
+                });
+                // Continue — a single line can match multiple patterns and each is a distinct signal
+            }
+        }
+    }
+    return {
+        pass: !prescriptions.some((p) => p.severity === 'error'),
+        prescriptions,
+        scope: PRESCRIPTIONS_SCOPE,
+    };
+}
+function extractMeaningfulLines(content) {
+    return content
+        .split('\n')
+        .map((raw) => raw.replace(/^[-*]\s+/, '').trim())
+        .filter((line) => line.length >= 15 && !line.startsWith('#'));
+}
+//# sourceMappingURL=brain-prescriptions.js.map

package/dist/evals/brain-prescriptions.js.map

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