@aitne/shared 0.1.0

package/dist/skill-curation/schemas.d.ts

@@ -0,0 +1,461 @@
+import { z } from "zod";
+/** Bumped when the typed-payload shape changes in a non-additive way. */
+export declare const SKILL_CURATION_SCHEMA_VERSION = 1;
+/** Allowed section kinds (discriminator on `payload.kind`). */
+export declare const SECTION_KINDS: readonly ["knowledge_layout", "routing_table", "frontmatter_schema", "search_recipes", "convention_notes", "cross_references"];
+export type SectionKind = (typeof SECTION_KINDS)[number];
+export declare const KnowledgeLayoutSection: z.ZodObject<{
+    heading: z.ZodString;
+    contains: z.ZodString;
+    example_entry: z.ZodOptional<z.ZodString>;
+    writers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export declare const KnowledgeLayoutFile: z.ZodObject<{
+    path: z.ZodString;
+    purpose: z.ZodString;
+    sections: z.ZodArray<z.ZodObject<{
+        heading: z.ZodString;
+        contains: z.ZodString;
+        example_entry: z.ZodOptional<z.ZodString>;
+        writers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const KnowledgeLayoutPayload: z.ZodObject<{
+    kind: z.ZodLiteral<"knowledge_layout">;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        purpose: z.ZodString;
+        sections: z.ZodArray<z.ZodObject<{
+            heading: z.ZodString;
+            contains: z.ZodString;
+            example_entry: z.ZodOptional<z.ZodString>;
+            writers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const RoutingTableRule: z.ZodObject<{
+    trigger_pattern: z.ZodString;
+    destination_path: z.ZodString;
+    destination_section: z.ZodString;
+    destination_mode: z.ZodEnum<{
+        append: "append";
+        replace: "replace";
+        append_to_file: "append_to_file";
+        patch_section: "patch_section";
+    }>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const RoutingTablePayload: z.ZodObject<{
+    kind: z.ZodLiteral<"routing_table">;
+    rules: z.ZodArray<z.ZodObject<{
+        trigger_pattern: z.ZodString;
+        destination_path: z.ZodString;
+        destination_section: z.ZodString;
+        destination_mode: z.ZodEnum<{
+            append: "append";
+            replace: "replace";
+            append_to_file: "append_to_file";
+            patch_section: "patch_section";
+        }>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const FrontmatterRequiredField: z.ZodObject<{
+    key: z.ZodString;
+    type: z.ZodEnum<{
+        string: "string";
+        array: "array";
+        enum: "enum";
+        "iso-date": "iso-date";
+    }>;
+    example: z.ZodString;
+}, z.core.$strip>;
+export declare const FrontmatterConventionalField: z.ZodObject<{
+    key: z.ZodString;
+    purpose: z.ZodString;
+}, z.core.$strip>;
+export declare const FrontmatterFileType: z.ZodObject<{
+    glob: z.ZodString;
+    required: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        type: z.ZodEnum<{
+            string: "string";
+            array: "array";
+            enum: "enum";
+            "iso-date": "iso-date";
+        }>;
+        example: z.ZodString;
+    }, z.core.$strip>>;
+    conventional: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        purpose: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const FrontmatterSchemaPayload: z.ZodObject<{
+    kind: z.ZodLiteral<"frontmatter_schema">;
+    file_types: z.ZodArray<z.ZodObject<{
+        glob: z.ZodString;
+        required: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            type: z.ZodEnum<{
+                string: "string";
+                array: "array";
+                enum: "enum";
+                "iso-date": "iso-date";
+            }>;
+            example: z.ZodString;
+        }, z.core.$strip>>;
+        conventional: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            purpose: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const SearchRecipe: z.ZodObject<{
+    question_shape: z.ZodString;
+    lookup_path: z.ZodString;
+    lookup_section: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SearchRecipesPayload: z.ZodObject<{
+    kind: z.ZodLiteral<"search_recipes">;
+    recipes: z.ZodArray<z.ZodObject<{
+        question_shape: z.ZodString;
+        lookup_path: z.ZodString;
+        lookup_section: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const ConventionNote: z.ZodObject<{
+    topic: z.ZodString;
+    rule: z.ZodString;
+    example: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ConventionNotesPayload: z.ZodObject<{
+    kind: z.ZodLiteral<"convention_notes">;
+    notes: z.ZodArray<z.ZodObject<{
+        topic: z.ZodString;
+        rule: z.ZodString;
+        example: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const CrossReference: z.ZodObject<{
+    from_path: z.ZodString;
+    to_path: z.ZodString;
+    relation: z.ZodString;
+}, z.core.$strip>;
+export declare const CrossReferencesPayload: z.ZodObject<{
+    kind: z.ZodLiteral<"cross_references">;
+    refs: z.ZodArray<z.ZodObject<{
+        from_path: z.ZodString;
+        to_path: z.ZodString;
+        relation: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const CurationPayload: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"knowledge_layout">;
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        purpose: z.ZodString;
+        sections: z.ZodArray<z.ZodObject<{
+            heading: z.ZodString;
+            contains: z.ZodString;
+            example_entry: z.ZodOptional<z.ZodString>;
+            writers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"routing_table">;
+    rules: z.ZodArray<z.ZodObject<{
+        trigger_pattern: z.ZodString;
+        destination_path: z.ZodString;
+        destination_section: z.ZodString;
+        destination_mode: z.ZodEnum<{
+            append: "append";
+            replace: "replace";
+            append_to_file: "append_to_file";
+            patch_section: "patch_section";
+        }>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"frontmatter_schema">;
+    file_types: z.ZodArray<z.ZodObject<{
+        glob: z.ZodString;
+        required: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            type: z.ZodEnum<{
+                string: "string";
+                array: "array";
+                enum: "enum";
+                "iso-date": "iso-date";
+            }>;
+            example: z.ZodString;
+        }, z.core.$strip>>;
+        conventional: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            purpose: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"search_recipes">;
+    recipes: z.ZodArray<z.ZodObject<{
+        question_shape: z.ZodString;
+        lookup_path: z.ZodString;
+        lookup_section: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"convention_notes">;
+    notes: z.ZodArray<z.ZodObject<{
+        topic: z.ZodString;
+        rule: z.ZodString;
+        example: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"cross_references">;
+    refs: z.ZodArray<z.ZodObject<{
+        from_path: z.ZodString;
+        to_path: z.ZodString;
+        relation: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>], "kind">;
+export type CurationPayloadValue = z.infer<typeof CurationPayload>;
+export type KnowledgeLayoutValue = z.infer<typeof KnowledgeLayoutPayload>;
+export type RoutingTableValue = z.infer<typeof RoutingTablePayload>;
+export type FrontmatterSchemaValue = z.infer<typeof FrontmatterSchemaPayload>;
+export type SearchRecipesValue = z.infer<typeof SearchRecipesPayload>;
+export type ConventionNotesValue = z.infer<typeof ConventionNotesPayload>;
+export type CrossReferencesValue = z.infer<typeof CrossReferencesPayload>;
+export declare const BYTE_BUDGET: Record<SectionKind, number>;
+export declare const CurationDeclarationSection: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        knowledge_layout: "knowledge_layout";
+        routing_table: "routing_table";
+        frontmatter_schema: "frontmatter_schema";
+        search_recipes: "search_recipes";
+        convention_notes: "convention_notes";
+        cross_references: "cross_references";
+    }>;
+    anchor: z.ZodString;
+    human_label: z.ZodString;
+    description: z.ZodString;
+    scope_paths: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const CurationDeclaration: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    sections: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            knowledge_layout: "knowledge_layout";
+            routing_table: "routing_table";
+            frontmatter_schema: "frontmatter_schema";
+            search_recipes: "search_recipes";
+            convention_notes: "convention_notes";
+            cross_references: "cross_references";
+        }>;
+        anchor: z.ZodString;
+        human_label: z.ZodString;
+        description: z.ZodString;
+        scope_paths: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type CurationDeclarationValue = z.infer<typeof CurationDeclaration>;
+export type CurationDeclarationSectionValue = z.infer<typeof CurationDeclarationSection>;
+export declare const SkillCurationConfig: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    cadence: z.ZodDefault<z.ZodEnum<{
+        daily: "daily";
+        weekly: "weekly";
+        monthly: "monthly";
+    }>>;
+    backend: z.ZodDefault<z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        gemini: "gemini";
+    }>>;
+    model: z.ZodDefault<z.ZodString>;
+    excluded_skills: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type SkillCurationConfigValue = z.infer<typeof SkillCurationConfig>;
+export declare const DEFAULT_SKILL_CURATION_CONFIG: SkillCurationConfigValue;
+export declare const OverlayEnvelope: z.ZodObject<{
+    schema_version: z.ZodNumber;
+    skill_slug: z.ZodString;
+    section_id: z.ZodString;
+    kind: z.ZodEnum<{
+        knowledge_layout: "knowledge_layout";
+        routing_table: "routing_table";
+        frontmatter_schema: "frontmatter_schema";
+        search_recipes: "search_recipes";
+        convention_notes: "convention_notes";
+        cross_references: "cross_references";
+    }>;
+    payload: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"knowledge_layout">;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            purpose: z.ZodString;
+            sections: z.ZodArray<z.ZodObject<{
+                heading: z.ZodString;
+                contains: z.ZodString;
+                example_entry: z.ZodOptional<z.ZodString>;
+                writers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"routing_table">;
+        rules: z.ZodArray<z.ZodObject<{
+            trigger_pattern: z.ZodString;
+            destination_path: z.ZodString;
+            destination_section: z.ZodString;
+            destination_mode: z.ZodEnum<{
+                append: "append";
+                replace: "replace";
+                append_to_file: "append_to_file";
+                patch_section: "patch_section";
+            }>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"frontmatter_schema">;
+        file_types: z.ZodArray<z.ZodObject<{
+            glob: z.ZodString;
+            required: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                type: z.ZodEnum<{
+                    string: "string";
+                    array: "array";
+                    enum: "enum";
+                    "iso-date": "iso-date";
+                }>;
+                example: z.ZodString;
+            }, z.core.$strip>>;
+            conventional: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                purpose: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"search_recipes">;
+        recipes: z.ZodArray<z.ZodObject<{
+            question_shape: z.ZodString;
+            lookup_path: z.ZodString;
+            lookup_section: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"convention_notes">;
+        notes: z.ZodArray<z.ZodObject<{
+            topic: z.ZodString;
+            rule: z.ZodString;
+            example: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"cross_references">;
+        refs: z.ZodArray<z.ZodObject<{
+            from_path: z.ZodString;
+            to_path: z.ZodString;
+            relation: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "kind">;
+    applied_proposal_id: z.ZodNullable<z.ZodNumber>;
+    applied_at: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+export type OverlayEnvelopeValue = z.infer<typeof OverlayEnvelope>;
+export declare const SubmitProposalRequest: z.ZodObject<{
+    runId: z.ZodString;
+    skill_slug: z.ZodString;
+    section_id: z.ZodString;
+    payload: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"knowledge_layout">;
+        files: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            purpose: z.ZodString;
+            sections: z.ZodArray<z.ZodObject<{
+                heading: z.ZodString;
+                contains: z.ZodString;
+                example_entry: z.ZodOptional<z.ZodString>;
+                writers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"routing_table">;
+        rules: z.ZodArray<z.ZodObject<{
+            trigger_pattern: z.ZodString;
+            destination_path: z.ZodString;
+            destination_section: z.ZodString;
+            destination_mode: z.ZodEnum<{
+                append: "append";
+                replace: "replace";
+                append_to_file: "append_to_file";
+                patch_section: "patch_section";
+            }>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"frontmatter_schema">;
+        file_types: z.ZodArray<z.ZodObject<{
+            glob: z.ZodString;
+            required: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                type: z.ZodEnum<{
+                    string: "string";
+                    array: "array";
+                    enum: "enum";
+                    "iso-date": "iso-date";
+                }>;
+                example: z.ZodString;
+            }, z.core.$strip>>;
+            conventional: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                purpose: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"search_recipes">;
+        recipes: z.ZodArray<z.ZodObject<{
+            question_shape: z.ZodString;
+            lookup_path: z.ZodString;
+            lookup_section: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"convention_notes">;
+        notes: z.ZodArray<z.ZodObject<{
+            topic: z.ZodString;
+            rule: z.ZodString;
+            example: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"cross_references">;
+        refs: z.ZodArray<z.ZodObject<{
+            from_path: z.ZodString;
+            to_path: z.ZodString;
+            relation: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>], "kind">;
+    rationale: z.ZodString;
+    signal_ids: z.ZodArray<z.ZodNumber>;
+}, z.core.$strip>;
+export type SubmitProposalRequestValue = z.infer<typeof SubmitProposalRequest>;
+/** Manual on-demand run — `POST /api/skill-curation/runs/manual`. The
+ *  dashboard fires this when the owner clicks "Run optimization now".
+ *  Bypasses the per-skill weight threshold and the per-section cooldown
+ *  for skill SELECTION (see signals.ts), but proposals still require
+ *  signal citations via the `signal_citations_valid` smoke check.
+ *
+ *  Body is intentionally empty in v1 — server reads cadence/backend/model
+ *  from `runtime_state.skill_curation.config`. Reserved for future use
+ *  (e.g. owner-narrowed manual run targeting a specific skill). */
+export declare const ManualRunRequest: z.ZodObject<{
+    target_skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type ManualRunRequestValue = z.infer<typeof ManualRunRequest>;
+export declare const DiscardOrphanRequest: z.ZodObject<{
+    slug: z.ZodString;
+    section_id: z.ZodString;
+}, z.core.$strip>;
+export type DiscardOrphanRequestValue = z.infer<typeof DiscardOrphanRequest>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/skill-curation/schemas.d.ts.map

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

package/dist/skill-curation/schemas.js

@@ -0,0 +1,211 @@
+// Skill-curation typed payloads (P22 §1.4 — normative).
+//
+// These are the ONLY shapes the curation API accepts. The optimizer agent
+// has no Edit/Write tools — its sole mutation surface is `POST /api/skill-
+// curation/proposals` with one of the six `kind` payloads below. Bounds on
+// every string and array exist to cap blast radius.
+import { z } from "zod";
+import { DECISION_LANGUAGE_MESSAGE, EMBEDDED_MARKER_MESSAGE, noDecisionLanguage, noEmbeddedMarkers, } from "./decision-language.js";
+/** Bumped when the typed-payload shape changes in a non-additive way. */
+export const SKILL_CURATION_SCHEMA_VERSION = 1;
+/** Allowed section kinds (discriminator on `payload.kind`). */
+export const SECTION_KINDS = [
+    "knowledge_layout",
+    "routing_table",
+    "frontmatter_schema",
+    "search_recipes",
+    "convention_notes",
+    "cross_references",
+];
+// Path-shape characters that the optimizer is allowed to submit. `*` is in
+// the set because `knowledge_layout.files[].path` legitimately holds glob
+// entries (`projects/*.md`, `user/*.md`) per design §1.2's seed rows; the
+// smoke test's `paths_resolve` check already understands globs via
+// `snapshotMatchesPath`. The renderer wraps the value in backticks unchanged.
+const PathRegex = /^[a-z0-9_./*-]+$/i;
+const noMarkersField = (max) => z.string().max(max).refine(noEmbeddedMarkers, { message: EMBEDDED_MARKER_MESSAGE });
+const descriptiveField = (min, max) => z.string().min(min).max(max)
+    .refine(noEmbeddedMarkers, { message: EMBEDDED_MARKER_MESSAGE })
+    .refine(noDecisionLanguage, { message: DECISION_LANGUAGE_MESSAGE });
+// ── knowledge_layout ─────────────────────────────────────────────────────
+export const KnowledgeLayoutSection = z.object({
+    heading: z.string().min(1).max(80).refine(noEmbeddedMarkers, { message: EMBEDDED_MARKER_MESSAGE }),
+    contains: descriptiveField(5, 200),
+    example_entry: noMarkersField(200).optional(),
+    writers: z.array(z.string().min(1).max(40)).max(10).optional(),
+});
+export const KnowledgeLayoutFile = z.object({
+    path: z.string().regex(PathRegex).max(120),
+    purpose: descriptiveField(5, 200),
+    sections: z.array(KnowledgeLayoutSection).max(20),
+});
+export const KnowledgeLayoutPayload = z.object({
+    kind: z.literal("knowledge_layout"),
+    files: z.array(KnowledgeLayoutFile).min(1).max(50),
+});
+// ── routing_table ────────────────────────────────────────────────────────
+export const RoutingTableRule = z.object({
+    trigger_pattern: z.string().min(5).max(200)
+        .refine(noEmbeddedMarkers, { message: EMBEDDED_MARKER_MESSAGE }),
+    destination_path: z.string().regex(PathRegex).max(120),
+    destination_section: z.string().min(1).max(80),
+    destination_mode: z.enum(["append", "replace", "append_to_file", "patch_section"]),
+    note: z.string().max(150)
+        .refine(noEmbeddedMarkers, { message: EMBEDDED_MARKER_MESSAGE })
+        .refine(noDecisionLanguage, { message: DECISION_LANGUAGE_MESSAGE })
+        .optional(),
+});
+export const RoutingTablePayload = z.object({
+    kind: z.literal("routing_table"),
+    rules: z.array(RoutingTableRule).min(1).max(50),
+});
+// ── frontmatter_schema ───────────────────────────────────────────────────
+export const FrontmatterRequiredField = z.object({
+    key: z.string().min(1).max(40),
+    type: z.enum(["string", "iso-date", "enum", "array"]),
+    example: z.string().min(1).max(120),
+});
+export const FrontmatterConventionalField = z.object({
+    key: z.string().min(1).max(40),
+    purpose: z.string().min(3).max(120)
+        .refine(noEmbeddedMarkers, { message: EMBEDDED_MARKER_MESSAGE })
+        .refine(noDecisionLanguage, { message: DECISION_LANGUAGE_MESSAGE }),
+});
+export const FrontmatterFileType = z.object({
+    glob: z.string().min(1).max(80),
+    required: z.array(FrontmatterRequiredField).max(10),
+    conventional: z.array(FrontmatterConventionalField).max(20),
+});
+export const FrontmatterSchemaPayload = z.object({
+    kind: z.literal("frontmatter_schema"),
+    file_types: z.array(FrontmatterFileType).min(1).max(20),
+});
+// ── search_recipes ───────────────────────────────────────────────────────
+export const SearchRecipe = z.object({
+    question_shape: descriptiveField(5, 200),
+    lookup_path: z.string().regex(PathRegex).max(120),
+    lookup_section: z.string().min(1).max(80).optional(),
+    note: z.string().max(200)
+        .refine(noEmbeddedMarkers, { message: EMBEDDED_MARKER_MESSAGE })
+        .refine(noDecisionLanguage, { message: DECISION_LANGUAGE_MESSAGE })
+        .optional(),
+});
+export const SearchRecipesPayload = z.object({
+    kind: z.literal("search_recipes"),
+    recipes: z.array(SearchRecipe).min(1).max(50),
+});
+// ── convention_notes ─────────────────────────────────────────────────────
+export const ConventionNote = z.object({
+    topic: z.string().min(3).max(80).refine(noEmbeddedMarkers, { message: EMBEDDED_MARKER_MESSAGE }),
+    // Tightened from 300 → 180: conventions are short statements of fact, not
+    // how-to instructions.
+    rule: descriptiveField(5, 180),
+    example: noMarkersField(200).optional(),
+});
+export const ConventionNotesPayload = z.object({
+    kind: z.literal("convention_notes"),
+    notes: z.array(ConventionNote).min(1).max(20),
+});
+// ── cross_references ─────────────────────────────────────────────────────
+export const CrossReference = z.object({
+    from_path: z.string().regex(PathRegex).max(120),
+    to_path: z.string().regex(PathRegex).max(120),
+    relation: z.string().min(3).max(120)
+        .refine(noEmbeddedMarkers, { message: EMBEDDED_MARKER_MESSAGE })
+        .refine(noDecisionLanguage, { message: DECISION_LANGUAGE_MESSAGE }),
+});
+export const CrossReferencesPayload = z.object({
+    kind: z.literal("cross_references"),
+    refs: z.array(CrossReference).min(1).max(50),
+});
+// ── Discriminated union over all kinds ───────────────────────────────────
+export const CurationPayload = z.discriminatedUnion("kind", [
+    KnowledgeLayoutPayload,
+    RoutingTablePayload,
+    FrontmatterSchemaPayload,
+    SearchRecipesPayload,
+    ConventionNotesPayload,
+    CrossReferencesPayload,
+]);
+// ── Per-kind byte budgets (P22 §1.4.5) ───────────────────────────────────
+export const BYTE_BUDGET = {
+    knowledge_layout: 3 * 1024,
+    routing_table: 2 * 1024,
+    frontmatter_schema: 2 * 1024,
+    search_recipes: 2 * 1024,
+    convention_notes: 1.5 * 1024,
+    cross_references: 1 * 1024,
+};
+// ── Curation declaration sidecar (curation.json) ─────────────────────────
+export const CurationDeclarationSection = z.object({
+    id: z.string().min(1).max(80).regex(/^[a-z0-9-]+$/),
+    kind: z.enum(SECTION_KINDS),
+    anchor: z.string().min(1).max(200),
+    human_label: z.string().min(1).max(80),
+    description: z.string().min(1).max(200),
+    scope_paths: z.array(z.string().min(1).max(120)).min(1).max(20),
+});
+export const CurationDeclaration = z.object({
+    version: z.literal(1),
+    sections: z.array(CurationDeclarationSection).min(1).max(4),
+});
+// ── Settings (`runtime_state.skill_curation.config`) ─────────────────────
+// P22 §6.2 — operator-facing config. Auto-apply is the implicit behaviour
+// (every passing proposal applies); the only opt-out is `enabled = false`,
+// which both stops new runs AND tells SkillsCompiler to render seed-only.
+export const SkillCurationConfig = z.object({
+    enabled: z.boolean().default(false),
+    cadence: z.enum(["daily", "weekly", "monthly"]).default("weekly"),
+    backend: z.enum(["claude", "codex", "gemini"]).default("claude"),
+    model: z.string().min(1).max(120).default("claude-sonnet-4-6"),
+    excluded_skills: z.array(z.string().min(1).max(80)).default([]),
+});
+export const DEFAULT_SKILL_CURATION_CONFIG = {
+    enabled: false,
+    cadence: "weekly",
+    backend: "claude",
+    model: "claude-sonnet-4-6",
+    excluded_skills: [],
+};
+// ── Overlay envelope written to disk ─────────────────────────────────────
+export const OverlayEnvelope = z.object({
+    schema_version: z.number().int().positive(),
+    skill_slug: z.string().min(1).max(80),
+    section_id: z.string().min(1).max(80),
+    kind: z.enum(SECTION_KINDS),
+    payload: CurationPayload,
+    applied_proposal_id: z.number().int().nullable(),
+    applied_at: z.number().int().nullable(),
+});
+// ── Proposal submission body (POST /api/skill-curation/proposals) ───────
+export const SubmitProposalRequest = z.object({
+    runId: z.string().min(1).max(120),
+    skill_slug: z.string().min(1).max(80),
+    section_id: z.string().min(1).max(80),
+    payload: CurationPayload,
+    rationale: z.string().min(1).max(500),
+    signal_ids: z.array(z.number().int().positive()).min(1).max(50),
+});
+// ── §6.4 manual run trigger ──────────────────────────────────────────────
+/** Manual on-demand run — `POST /api/skill-curation/runs/manual`. The
+ *  dashboard fires this when the owner clicks "Run optimization now".
+ *  Bypasses the per-skill weight threshold and the per-section cooldown
+ *  for skill SELECTION (see signals.ts), but proposals still require
+ *  signal citations via the `signal_citations_valid` smoke check.
+ *
+ *  Body is intentionally empty in v1 — server reads cadence/backend/model
+ *  from `runtime_state.skill_curation.config`. Reserved for future use
+ *  (e.g. owner-narrowed manual run targeting a specific skill). */
+export const ManualRunRequest = z.object({
+    /** Optional override — restrict the run to these skills only. When
+     *  omitted, every skill with ≥1 unconsumed signal becomes a target.
+     *  Slugs the operator excluded via /settings/self-learning are still
+     *  filtered out regardless of this list. */
+    target_skills: z.array(z.string().min(1).max(80)).max(20).optional(),
+});
+// ── §5.4 orphan-overlay discard ────────────────────────────────────────
+export const DiscardOrphanRequest = z.object({
+    slug: z.string().min(1).max(80),
+    section_id: z.string().min(1).max(80),
+});
+//# sourceMappingURL=schemas.js.map