@vibe-hero/server 0.1.0

package/dist/schemas/common.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @file Shared primitive schemas, enums, and codec helpers for vibe-hero.
+ *
+ * Zod is the single source of truth: every entity exports both its schema and
+ * the inferred type. This module is imported by `content.ts`, `profile.ts`, and
+ * `tools.ts`; it must not import from any of them (no cycles).
+ *
+ * Source of truth: specs/001-vibe-hero-mvp/data-model.md (§ Identifiers & enums).
+ */
+import { z } from "zod";
+/**
+ * The set of host coding tools vibe-hero can teach. Extensible; v1 populates
+ * `claude-code` content only, but all four ids are valid configuration values.
+ */
+export declare const ToolIdSchema: z.ZodEnum<["claude-code", "codex", "kiro-cli", "kiro-ide"]>;
+/** A host coding tool identifier. */
+export type ToolId = z.infer<typeof ToolIdSchema>;
+/**
+ * Classifies content as either tool-agnostic (`general`) or specific to one
+ * {@link ToolId}. Modelled as a discriminated union on `kind` so downstream
+ * code can switch exhaustively and the tool-specific branch carries its tool.
+ *
+ * Rationale: a tagged union (rather than `"general" | { tool }`) keeps the
+ * serialized shape uniform (always an object with a `kind`), which makes the
+ * {@link abilityKey} codec and JSON persistence straightforward and total.
+ */
+export declare const ContentClassSchema: 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";
+}>]>;
+/** Whether content is general or scoped to a specific tool. */
+export type ContentClass = z.infer<typeof ContentClassSchema>;
+/** The course-numbering ladder. Higher tiers gate behind lower ones. */
+export declare const TierSchema: z.ZodUnion<[z.ZodLiteral<100>, z.ZodLiteral<200>, z.ZodLiteral<300>, z.ZodLiteral<400>, z.ZodLiteral<500>]>;
+/** A mastery tier on the 100–500 ladder. */
+export type Tier = z.infer<typeof TierSchema>;
+/** Bloom's taxonomy depth tag for an item. */
+export declare const BloomLevelSchema: z.ZodEnum<["remember", "understand", "apply", "analyze", "evaluate", "create"]>;
+/** A Bloom's-taxonomy cognitive level. */
+export type BloomLevel = z.infer<typeof BloomLevelSchema>;
+/** The supported question formats. */
+export declare const QuestionTypeSchema: z.ZodEnum<["multiple_choice", "short_answer", "free_form"]>;
+/** A question format. */
+export type QuestionType = z.infer<typeof QuestionTypeSchema>;
+/**
+ * The derived binary projection of a score persisted in history.
+ * `Grade = score >= passThreshold ? "correct" : "incorrect"`.
+ */
+export declare const GradeSchema: z.ZodEnum<["correct", "incorrect"]>;
+/** A binary correctness verdict. */
+export type Grade = z.infer<typeof GradeSchema>;
+/**
+ * Serialized `(class, topicId)` ability key, e.g. `claude-code|subagents` or
+ * `general|planning`. Validated as a non-empty `class|topic` string; use
+ * {@link abilityKey} / {@link parseAbilityKey} to build and read it safely.
+ */
+export declare const AbilityKeySchema: z.ZodString;
+/** A serialized ability key string. */
+export type AbilityKey = z.infer<typeof AbilityKeySchema>;
+/**
+ * Serialize a `(class, topicId)` pair into an {@link AbilityKey} string.
+ *
+ * The class prefix is `general` for general content or `tool:<toolId>` for
+ * tool-specific content; the topic id follows after a single `|` separator.
+ *
+ * @example
+ * abilityKey({ kind: "general" }, "planning"); // "general|planning"
+ * abilityKey({ kind: "tool", tool: "claude-code" }, "subagents"); // "tool:claude-code|subagents"
+ */
+export declare const abilityKey: (cls: ContentClass, topicId: string) => AbilityKey;
+/** Result of decoding an {@link AbilityKey}. */
+export interface ParsedAbilityKey {
+    readonly class: ContentClass;
+    readonly topicId: string;
+}
+/**
+ * Parse an {@link AbilityKey} string back into its `(class, topicId)` pair.
+ * Inverse of {@link abilityKey}.
+ *
+ * @throws {Error} if the string is not a well-formed `class|topic` key.
+ */
+export declare const parseAbilityKey: (key: string) => ParsedAbilityKey;
+//# sourceMappingURL=common.d.ts.map

package/dist/schemas/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,YAAY,6DAKvB,CAAC;AACH,qCAAqC;AACrC,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;IAG7B,CAAC;AACH,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,wEAAwE;AACxE,eAAO,MAAM,UAAU,6GAMrB,CAAC;AACH,4CAA4C;AAC5C,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB,iFAO3B,CAAC;AACH,0CAA0C;AAC1C,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,6DAI7B,CAAC;AACH,yBAAyB;AACzB,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;GAGG;AACH,eAAO,MAAM,WAAW,qCAAmC,CAAC;AAC5D,oCAAoC;AACpC,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,aAK1B,CAAC;AACJ,uCAAuC;AACvC,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM1D;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,YAAY,EAAE,SAAS,MAAM,KAAG,UAC/B,CAAC;AAElC,gDAAgD;AAChD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,gBAgB7C,CAAC"}

package/dist/schemas/common.js

@@ -0,0 +1,106 @@
+/**
+ * @file Shared primitive schemas, enums, and codec helpers for vibe-hero.
+ *
+ * Zod is the single source of truth: every entity exports both its schema and
+ * the inferred type. This module is imported by `content.ts`, `profile.ts`, and
+ * `tools.ts`; it must not import from any of them (no cycles).
+ *
+ * Source of truth: specs/001-vibe-hero-mvp/data-model.md (§ Identifiers & enums).
+ */
+import { z } from "zod";
+/**
+ * The set of host coding tools vibe-hero can teach. Extensible; v1 populates
+ * `claude-code` content only, but all four ids are valid configuration values.
+ */
+export const ToolIdSchema = z.enum([
+    "claude-code",
+    "codex",
+    "kiro-cli",
+    "kiro-ide",
+]);
+/**
+ * Classifies content as either tool-agnostic (`general`) or specific to one
+ * {@link ToolId}. Modelled as a discriminated union on `kind` so downstream
+ * code can switch exhaustively and the tool-specific branch carries its tool.
+ *
+ * Rationale: a tagged union (rather than `"general" | { tool }`) keeps the
+ * serialized shape uniform (always an object with a `kind`), which makes the
+ * {@link abilityKey} codec and JSON persistence straightforward and total.
+ */
+export const ContentClassSchema = z.discriminatedUnion("kind", [
+    z.object({ kind: z.literal("general") }),
+    z.object({ kind: z.literal("tool"), tool: ToolIdSchema }),
+]);
+/** The course-numbering ladder. Higher tiers gate behind lower ones. */
+export const TierSchema = z.union([
+    z.literal(100),
+    z.literal(200),
+    z.literal(300),
+    z.literal(400),
+    z.literal(500),
+]);
+/** Bloom's taxonomy depth tag for an item. */
+export const BloomLevelSchema = z.enum([
+    "remember",
+    "understand",
+    "apply",
+    "analyze",
+    "evaluate",
+    "create",
+]);
+/** The supported question formats. */
+export const QuestionTypeSchema = z.enum([
+    "multiple_choice",
+    "short_answer",
+    "free_form",
+]);
+/**
+ * The derived binary projection of a score persisted in history.
+ * `Grade = score >= passThreshold ? "correct" : "incorrect"`.
+ */
+export const GradeSchema = z.enum(["correct", "incorrect"]);
+/**
+ * Serialized `(class, topicId)` ability key, e.g. `claude-code|subagents` or
+ * `general|planning`. Validated as a non-empty `class|topic` string; use
+ * {@link abilityKey} / {@link parseAbilityKey} to build and read it safely.
+ */
+export const AbilityKeySchema = z
+    .string()
+    .regex(/^(general|tool:(claude-code|codex|kiro-cli|kiro-ide))\|.+$/, "AbilityKey must serialize as 'class|topic' (e.g. 'general|planning' or 'tool:claude-code|subagents')");
+/** Serialized class prefix used inside an {@link AbilityKey}. */
+const classToken = (cls) => cls.kind === "general" ? "general" : `${cls.kind}:${cls.tool}`;
+/**
+ * Serialize a `(class, topicId)` pair into an {@link AbilityKey} string.
+ *
+ * The class prefix is `general` for general content or `tool:<toolId>` for
+ * tool-specific content; the topic id follows after a single `|` separator.
+ *
+ * @example
+ * abilityKey({ kind: "general" }, "planning"); // "general|planning"
+ * abilityKey({ kind: "tool", tool: "claude-code" }, "subagents"); // "tool:claude-code|subagents"
+ */
+export const abilityKey = (cls, topicId) => `${classToken(cls)}|${topicId}`;
+/**
+ * Parse an {@link AbilityKey} string back into its `(class, topicId)` pair.
+ * Inverse of {@link abilityKey}.
+ *
+ * @throws {Error} if the string is not a well-formed `class|topic` key.
+ */
+export const parseAbilityKey = (key) => {
+    const sep = key.indexOf("|");
+    if (sep <= 0 || sep === key.length - 1) {
+        throw new Error(`Malformed AbilityKey: ${JSON.stringify(key)}`);
+    }
+    const classPart = key.slice(0, sep);
+    const topicId = key.slice(sep + 1);
+    if (classPart === "general") {
+        return { class: { kind: "general" }, topicId };
+    }
+    const toolMatch = /^tool:(.+)$/.exec(classPart);
+    if (toolMatch && toolMatch[1] !== undefined) {
+        const tool = ToolIdSchema.parse(toolMatch[1]);
+        return { class: { kind: "tool", tool }, topicId };
+    }
+    throw new Error(`Malformed AbilityKey class segment: ${JSON.stringify(key)}`);
+};
+//# sourceMappingURL=common.js.map

package/dist/schemas/common.js.map

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