@vibe-hero/server 0.1.0

package/dist/schemas/content.d.ts

@@ -0,0 +1,828 @@
+/**
+ * @file Content Catalog schemas (read-only at runtime).
+ *
+ * Defines topics, items, answer keys, rubrics, trigger signals, and the catalog
+ * manifest. Cross-field validation (item type vs. choices/answerKey/rubric) is
+ * enforced with `.superRefine` so catalog load rejects violations with a
+ * path-qualified diagnostic (FR-004).
+ *
+ * Source of truth: specs/001-vibe-hero-mvp/data-model.md (§ Content Catalog).
+ */
+import { z } from "zod";
+/** A selectable answer option for a multiple-choice item. */
+export declare const ChoiceSchema: z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    id: string;
+}, {
+    text: string;
+    id: string;
+}>;
+/** A multiple-choice option. */
+export type Choice = z.infer<typeof ChoiceSchema>;
+/**
+ * Deterministic grading key. Discriminated on `kind`:
+ * - `choice`  — the id of the single correct choice (multiple_choice).
+ * - `keyword` — any of the accepted keyword answers, with optional
+ *   normalization applied before comparison (short_answer).
+ */
+export declare const AnswerKeySchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"choice">;
+    correctChoiceId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "choice";
+    correctChoiceId: string;
+}, {
+    kind: "choice";
+    correctChoiceId: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"keyword">;
+    anyOf: z.ZodArray<z.ZodString, "many">;
+    normalize: z.ZodOptional<z.ZodEnum<["lower", "trim", "both"]>>;
+}, "strip", z.ZodTypeAny, {
+    kind: "keyword";
+    anyOf: string[];
+    normalize?: "trim" | "lower" | "both" | undefined;
+}, {
+    kind: "keyword";
+    anyOf: string[];
+    normalize?: "trim" | "lower" | "both" | undefined;
+}>]>;
+/** A deterministic answer key. */
+export type AnswerKey = z.infer<typeof AnswerKeySchema>;
+/** A single rubric criterion the host agent judges for free-form items. */
+export declare const RubricCriterionSchema: z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    id: string;
+}, {
+    text: string;
+    id: string;
+}>;
+/** A rubric criterion. */
+export type RubricCriterion = z.infer<typeof RubricCriterionSchema>;
+/**
+ * Free-form grading rubric. The criteria + reference answer are handed to the
+ * host agent for judging (returned by `start_quiz`); the MCP computes the score
+ * from the per-criterion verdict. `passThreshold` is the fraction of criteria
+ * that must be met to count as "correct" (default 0.6).
+ */
+export declare const RubricSchema: z.ZodObject<{
+    criteria: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        id: string;
+    }, {
+        text: string;
+        id: string;
+    }>, "many">;
+    referenceAnswer: z.ZodString;
+    passThreshold: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    criteria: {
+        text: string;
+        id: string;
+    }[];
+    referenceAnswer: string;
+    passThreshold: number;
+}, {
+    criteria: {
+        text: string;
+        id: string;
+    }[];
+    referenceAnswer: string;
+    passThreshold?: number | undefined;
+}>;
+/** A free-form grading rubric. */
+export type Rubric = z.infer<typeof RubricSchema>;
+/**
+ * A catalog question with all type-dependent invariants enforced.
+ * Difficulty is a fixed authored field (no self-update).
+ */
+export declare const ContentItemSchema: z.ZodEffects<z.ZodObject<{
+    id: z.ZodString;
+    tier: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>]>;
+    bloom: z.ZodEnum<["remember", "understand", "apply", "analyze", "evaluate", "create"]>;
+    /**
+     * Fixed authored Elo item-rating. Never self-updates — only the learner's
+     * ability moves against it.
+     */
+    difficulty: z.ZodNumber;
+    type: z.ZodEnum<["multiple_choice", "short_answer", "free_form"]>;
+    prompt: z.ZodString;
+    choices: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        id: string;
+    }, {
+        text: string;
+        id: string;
+    }>, "many">>;
+    answerKey: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"choice">;
+        correctChoiceId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "choice";
+        correctChoiceId: string;
+    }, {
+        kind: "choice";
+        correctChoiceId: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"keyword">;
+        anyOf: z.ZodArray<z.ZodString, "many">;
+        normalize: z.ZodOptional<z.ZodEnum<["lower", "trim", "both"]>>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "keyword";
+        anyOf: string[];
+        normalize?: "trim" | "lower" | "both" | undefined;
+    }, {
+        kind: "keyword";
+        anyOf: string[];
+        normalize?: "trim" | "lower" | "both" | undefined;
+    }>]>>;
+    rubric: z.ZodOptional<z.ZodObject<{
+        criteria: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            id: string;
+        }, {
+            text: string;
+            id: string;
+        }>, "many">;
+        referenceAnswer: z.ZodString;
+        passThreshold: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        criteria: {
+            text: string;
+            id: string;
+        }[];
+        referenceAnswer: string;
+        passThreshold: number;
+    }, {
+        criteria: {
+            text: string;
+            id: string;
+        }[];
+        referenceAnswer: string;
+        passThreshold?: number | undefined;
+    }>>;
+    /** Teaching text shown after answering / on detected weakness. */
+    guidance: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "multiple_choice" | "short_answer" | "free_form";
+    tier: 400 | 300 | 200 | 100 | 500;
+    difficulty: number;
+    id: string;
+    bloom: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create";
+    prompt: string;
+    guidance: string;
+    choices?: {
+        text: string;
+        id: string;
+    }[] | undefined;
+    answerKey?: {
+        kind: "choice";
+        correctChoiceId: string;
+    } | {
+        kind: "keyword";
+        anyOf: string[];
+        normalize?: "trim" | "lower" | "both" | undefined;
+    } | undefined;
+    rubric?: {
+        criteria: {
+            text: string;
+            id: string;
+        }[];
+        referenceAnswer: string;
+        passThreshold: number;
+    } | undefined;
+}, {
+    type: "multiple_choice" | "short_answer" | "free_form";
+    tier: 400 | 300 | 200 | 100 | 500;
+    difficulty: number;
+    id: string;
+    bloom: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create";
+    prompt: string;
+    guidance: string;
+    choices?: {
+        text: string;
+        id: string;
+    }[] | undefined;
+    answerKey?: {
+        kind: "choice";
+        correctChoiceId: string;
+    } | {
+        kind: "keyword";
+        anyOf: string[];
+        normalize?: "trim" | "lower" | "both" | undefined;
+    } | undefined;
+    rubric?: {
+        criteria: {
+            text: string;
+            id: string;
+        }[];
+        referenceAnswer: string;
+        passThreshold?: number | undefined;
+    } | undefined;
+}>, {
+    type: "multiple_choice" | "short_answer" | "free_form";
+    tier: 400 | 300 | 200 | 100 | 500;
+    difficulty: number;
+    id: string;
+    bloom: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create";
+    prompt: string;
+    guidance: string;
+    choices?: {
+        text: string;
+        id: string;
+    }[] | undefined;
+    answerKey?: {
+        kind: "choice";
+        correctChoiceId: string;
+    } | {
+        kind: "keyword";
+        anyOf: string[];
+        normalize?: "trim" | "lower" | "both" | undefined;
+    } | undefined;
+    rubric?: {
+        criteria: {
+            text: string;
+            id: string;
+        }[];
+        referenceAnswer: string;
+        passThreshold: number;
+    } | undefined;
+}, {
+    type: "multiple_choice" | "short_answer" | "free_form";
+    tier: 400 | 300 | 200 | 100 | 500;
+    difficulty: number;
+    id: string;
+    bloom: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create";
+    prompt: string;
+    guidance: string;
+    choices?: {
+        text: string;
+        id: string;
+    }[] | undefined;
+    answerKey?: {
+        kind: "choice";
+        correctChoiceId: string;
+    } | {
+        kind: "keyword";
+        anyOf: string[];
+        normalize?: "trim" | "lower" | "both" | undefined;
+    } | undefined;
+    rubric?: {
+        criteria: {
+            text: string;
+            id: string;
+        }[];
+        referenceAnswer: string;
+        passThreshold?: number | undefined;
+    } | undefined;
+}>;
+/** A catalog question. */
+export type ContentItem = z.infer<typeof ContentItemSchema>;
+/**
+ * How observed host activity maps to a topic for offer candidacy (FR-003a).
+ * At least one of the `match` selectors must be present. Trigger-only: it
+ * selects which topic to offer and never contributes to scoring.
+ */
+export declare const TriggerSignalSchema: z.ZodObject<{
+    tool: z.ZodEnum<["claude-code", "codex", "kiro-cli", "kiro-ide"]>;
+    match: z.ZodEffects<z.ZodObject<{
+        toolName: z.ZodOptional<z.ZodString>;
+        toolNamePattern: z.ZodOptional<z.ZodString>;
+        mcpToolPattern: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        toolName?: string | undefined;
+        toolNamePattern?: string | undefined;
+        mcpToolPattern?: string | undefined;
+    }, {
+        toolName?: string | undefined;
+        toolNamePattern?: string | undefined;
+        mcpToolPattern?: string | undefined;
+    }>, {
+        toolName?: string | undefined;
+        toolNamePattern?: string | undefined;
+        mcpToolPattern?: string | undefined;
+    }, {
+        toolName?: string | undefined;
+        toolNamePattern?: string | undefined;
+        mcpToolPattern?: string | undefined;
+    }>;
+    weight: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+    match: {
+        toolName?: string | undefined;
+        toolNamePattern?: string | undefined;
+        mcpToolPattern?: string | undefined;
+    };
+    weight: number;
+}, {
+    tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+    match: {
+        toolName?: string | undefined;
+        toolNamePattern?: string | undefined;
+        mcpToolPattern?: string | undefined;
+    };
+    weight?: number | undefined;
+}>;
+/** A topic trigger signal. */
+export type TriggerSignal = z.infer<typeof TriggerSignalSchema>;
+/**
+ * A topic file resolves to exactly one `(id, class)` pair and carries every
+ * tier's items plus its trigger signals (which may be empty).
+ */
+export declare const TopicSchema: z.ZodObject<{
+    id: z.ZodString;
+    class: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"general">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "general";
+    }, {
+        kind: "general";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"tool">;
+        tool: z.ZodEnum<["claude-code", "codex", "kiro-cli", "kiro-ide"]>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "tool";
+        tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+    }, {
+        kind: "tool";
+        tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+    }>]>;
+    title: z.ZodString;
+    summary: z.ZodString;
+    triggerSignals: z.ZodArray<z.ZodObject<{
+        tool: z.ZodEnum<["claude-code", "codex", "kiro-cli", "kiro-ide"]>;
+        match: z.ZodEffects<z.ZodObject<{
+            toolName: z.ZodOptional<z.ZodString>;
+            toolNamePattern: z.ZodOptional<z.ZodString>;
+            mcpToolPattern: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            toolName?: string | undefined;
+            toolNamePattern?: string | undefined;
+            mcpToolPattern?: string | undefined;
+        }, {
+            toolName?: string | undefined;
+            toolNamePattern?: string | undefined;
+            mcpToolPattern?: string | undefined;
+        }>, {
+            toolName?: string | undefined;
+            toolNamePattern?: string | undefined;
+            mcpToolPattern?: string | undefined;
+        }, {
+            toolName?: string | undefined;
+            toolNamePattern?: string | undefined;
+            mcpToolPattern?: string | undefined;
+        }>;
+        weight: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+        match: {
+            toolName?: string | undefined;
+            toolNamePattern?: string | undefined;
+            mcpToolPattern?: string | undefined;
+        };
+        weight: number;
+    }, {
+        tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+        match: {
+            toolName?: string | undefined;
+            toolNamePattern?: string | undefined;
+            mcpToolPattern?: string | undefined;
+        };
+        weight?: number | undefined;
+    }>, "many">;
+    items: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        id: z.ZodString;
+        tier: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>]>;
+        bloom: z.ZodEnum<["remember", "understand", "apply", "analyze", "evaluate", "create"]>;
+        /**
+         * Fixed authored Elo item-rating. Never self-updates — only the learner's
+         * ability moves against it.
+         */
+        difficulty: z.ZodNumber;
+        type: z.ZodEnum<["multiple_choice", "short_answer", "free_form"]>;
+        prompt: z.ZodString;
+        choices: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            id: string;
+        }, {
+            text: string;
+            id: string;
+        }>, "many">>;
+        answerKey: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"choice">;
+            correctChoiceId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "choice";
+            correctChoiceId: string;
+        }, {
+            kind: "choice";
+            correctChoiceId: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"keyword">;
+            anyOf: z.ZodArray<z.ZodString, "many">;
+            normalize: z.ZodOptional<z.ZodEnum<["lower", "trim", "both"]>>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "keyword";
+            anyOf: string[];
+            normalize?: "trim" | "lower" | "both" | undefined;
+        }, {
+            kind: "keyword";
+            anyOf: string[];
+            normalize?: "trim" | "lower" | "both" | undefined;
+        }>]>>;
+        rubric: z.ZodOptional<z.ZodObject<{
+            criteria: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                text: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                text: string;
+                id: string;
+            }, {
+                text: string;
+                id: string;
+            }>, "many">;
+            referenceAnswer: z.ZodString;
+            passThreshold: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            criteria: {
+                text: string;
+                id: string;
+            }[];
+            referenceAnswer: string;
+            passThreshold: number;
+        }, {
+            criteria: {
+                text: string;
+                id: string;
+            }[];
+            referenceAnswer: string;
+            passThreshold?: number | undefined;
+        }>>;
+        /** Teaching text shown after answering / on detected weakness. */
+        guidance: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "multiple_choice" | "short_answer" | "free_form";
+        tier: 400 | 300 | 200 | 100 | 500;
+        difficulty: number;
+        id: string;
+        bloom: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create";
+        prompt: string;
+        guidance: string;
+        choices?: {
+            text: string;
+            id: string;
+        }[] | undefined;
+        answerKey?: {
+            kind: "choice";
+            correctChoiceId: string;
+        } | {
+            kind: "keyword";
+            anyOf: string[];
+            normalize?: "trim" | "lower" | "both" | undefined;
+        } | undefined;
+        rubric?: {
+            criteria: {
+                text: string;
+                id: string;
+            }[];
+            referenceAnswer: string;
+            passThreshold: number;
+        } | undefined;
+    }, {
+        type: "multiple_choice" | "short_answer" | "free_form";
+        tier: 400 | 300 | 200 | 100 | 500;
+        difficulty: number;
+        id: string;
+        bloom: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create";
+        prompt: string;
+        guidance: string;
+        choices?: {
+            text: string;
+            id: string;
+        }[] | undefined;
+        answerKey?: {
+            kind: "choice";
+            correctChoiceId: string;
+        } | {
+            kind: "keyword";
+            anyOf: string[];
+            normalize?: "trim" | "lower" | "both" | undefined;
+        } | undefined;
+        rubric?: {
+            criteria: {
+                text: string;
+                id: string;
+            }[];
+            referenceAnswer: string;
+            passThreshold?: number | undefined;
+        } | undefined;
+    }>, {
+        type: "multiple_choice" | "short_answer" | "free_form";
+        tier: 400 | 300 | 200 | 100 | 500;
+        difficulty: number;
+        id: string;
+        bloom: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create";
+        prompt: string;
+        guidance: string;
+        choices?: {
+            text: string;
+            id: string;
+        }[] | undefined;
+        answerKey?: {
+            kind: "choice";
+            correctChoiceId: string;
+        } | {
+            kind: "keyword";
+            anyOf: string[];
+            normalize?: "trim" | "lower" | "both" | undefined;
+        } | undefined;
+        rubric?: {
+            criteria: {
+                text: string;
+                id: string;
+            }[];
+            referenceAnswer: string;
+            passThreshold: number;
+        } | undefined;
+    }, {
+        type: "multiple_choice" | "short_answer" | "free_form";
+        tier: 400 | 300 | 200 | 100 | 500;
+        difficulty: number;
+        id: string;
+        bloom: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create";
+        prompt: string;
+        guidance: string;
+        choices?: {
+            text: string;
+            id: string;
+        }[] | undefined;
+        answerKey?: {
+            kind: "choice";
+            correctChoiceId: string;
+        } | {
+            kind: "keyword";
+            anyOf: string[];
+            normalize?: "trim" | "lower" | "both" | undefined;
+        } | undefined;
+        rubric?: {
+            criteria: {
+                text: string;
+                id: string;
+            }[];
+            referenceAnswer: string;
+            passThreshold?: number | undefined;
+        } | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    id: string;
+    items: {
+        type: "multiple_choice" | "short_answer" | "free_form";
+        tier: 400 | 300 | 200 | 100 | 500;
+        difficulty: number;
+        id: string;
+        bloom: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create";
+        prompt: string;
+        guidance: string;
+        choices?: {
+            text: string;
+            id: string;
+        }[] | undefined;
+        answerKey?: {
+            kind: "choice";
+            correctChoiceId: string;
+        } | {
+            kind: "keyword";
+            anyOf: string[];
+            normalize?: "trim" | "lower" | "both" | undefined;
+        } | undefined;
+        rubric?: {
+            criteria: {
+                text: string;
+                id: string;
+            }[];
+            referenceAnswer: string;
+            passThreshold: number;
+        } | undefined;
+    }[];
+    class: {
+        kind: "general";
+    } | {
+        kind: "tool";
+        tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+    };
+    summary: string;
+    triggerSignals: {
+        tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+        match: {
+            toolName?: string | undefined;
+            toolNamePattern?: string | undefined;
+            mcpToolPattern?: string | undefined;
+        };
+        weight: number;
+    }[];
+}, {
+    title: string;
+    id: string;
+    items: {
+        type: "multiple_choice" | "short_answer" | "free_form";
+        tier: 400 | 300 | 200 | 100 | 500;
+        difficulty: number;
+        id: string;
+        bloom: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create";
+        prompt: string;
+        guidance: string;
+        choices?: {
+            text: string;
+            id: string;
+        }[] | undefined;
+        answerKey?: {
+            kind: "choice";
+            correctChoiceId: string;
+        } | {
+            kind: "keyword";
+            anyOf: string[];
+            normalize?: "trim" | "lower" | "both" | undefined;
+        } | undefined;
+        rubric?: {
+            criteria: {
+                text: string;
+                id: string;
+            }[];
+            referenceAnswer: string;
+            passThreshold?: number | undefined;
+        } | undefined;
+    }[];
+    class: {
+        kind: "general";
+    } | {
+        kind: "tool";
+        tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+    };
+    summary: string;
+    triggerSignals: {
+        tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+        match: {
+            toolName?: string | undefined;
+            toolNamePattern?: string | undefined;
+            mcpToolPattern?: string | undefined;
+        };
+        weight?: number | undefined;
+    }[];
+}>;
+/** A catalog topic (one topic × class). */
+export type Topic = z.infer<typeof TopicSchema>;
+/** A manifest entry indexing one topic for fast listing. */
+export declare const CatalogManifestTopicSchema: z.ZodObject<{
+    id: z.ZodString;
+    class: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"general">;
+    }, "strip", z.ZodTypeAny, {
+        kind: "general";
+    }, {
+        kind: "general";
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"tool">;
+        tool: z.ZodEnum<["claude-code", "codex", "kiro-cli", "kiro-ide"]>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "tool";
+        tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+    }, {
+        kind: "tool";
+        tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+    }>]>;
+    file: z.ZodString;
+    itemCount: z.ZodNumber;
+    tiers: z.ZodArray<z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    class: {
+        kind: "general";
+    } | {
+        kind: "tool";
+        tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+    };
+    file: string;
+    itemCount: number;
+    tiers: (400 | 300 | 200 | 100 | 500)[];
+}, {
+    id: string;
+    class: {
+        kind: "general";
+    } | {
+        kind: "tool";
+        tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+    };
+    file: string;
+    itemCount: number;
+    tiers: (400 | 300 | 200 | 100 | 500)[];
+}>;
+/** A topic index entry in the catalog manifest. */
+export type CatalogManifestTopic = z.infer<typeof CatalogManifestTopicSchema>;
+/**
+ * The catalog manifest: a versioned index of all topics. `etag` is set by the
+ * fetch layer for cache validation.
+ */
+export declare const CatalogManifestSchema: z.ZodObject<{
+    version: z.ZodString;
+    publishedAt: z.ZodString;
+    topics: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        class: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"general">;
+        }, "strip", z.ZodTypeAny, {
+            kind: "general";
+        }, {
+            kind: "general";
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"tool">;
+            tool: z.ZodEnum<["claude-code", "codex", "kiro-cli", "kiro-ide"]>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "tool";
+            tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+        }, {
+            kind: "tool";
+            tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+        }>]>;
+        file: z.ZodString;
+        itemCount: z.ZodNumber;
+        tiers: z.ZodArray<z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        class: {
+            kind: "general";
+        } | {
+            kind: "tool";
+            tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+        };
+        file: string;
+        itemCount: number;
+        tiers: (400 | 300 | 200 | 100 | 500)[];
+    }, {
+        id: string;
+        class: {
+            kind: "general";
+        } | {
+            kind: "tool";
+            tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+        };
+        file: string;
+        itemCount: number;
+        tiers: (400 | 300 | 200 | 100 | 500)[];
+    }>, "many">;
+    etag: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    version: string;
+    publishedAt: string;
+    topics: {
+        id: string;
+        class: {
+            kind: "general";
+        } | {
+            kind: "tool";
+            tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+        };
+        file: string;
+        itemCount: number;
+        tiers: (400 | 300 | 200 | 100 | 500)[];
+    }[];
+    etag?: string | undefined;
+}, {
+    version: string;
+    publishedAt: string;
+    topics: {
+        id: string;
+        class: {
+            kind: "general";
+        } | {
+            kind: "tool";
+            tool: "claude-code" | "codex" | "kiro-cli" | "kiro-ide";
+        };
+        file: string;
+        itemCount: number;
+        tiers: (400 | 300 | 200 | 100 | 500)[];
+    }[];
+    etag?: string | undefined;
+}>;
+/** The catalog manifest. */
+export type CatalogManifest = z.infer<typeof CatalogManifestSchema>;
+//# sourceMappingURL=content.d.ts.map