@vibe-hero/server 0.1.0

package/dist/tools/types.js

@@ -0,0 +1,48 @@
+/**
+ * @file Tool-registry contract shared by every MCP tool module (T020).
+ *
+ * Each tool lives in its own module exporting a {@link ToolModule}: a name, a
+ * human description, a Zod `inputSchema` (an *object* schema — `index.ts` passes
+ * its `.shape` to the SDK's `registerTool`), and a `handler`. The handler is the
+ * pure tool logic; `index.ts` wraps it with the setup gate and adapts its plain
+ * JSON result into the SDK's `CallToolResult` shape.
+ *
+ * Keeping the handler return type a plain JSON object (not a `CallToolResult`)
+ * means tool logic stays decoupled from the transport: tests call handlers
+ * directly and assert on the JSON, and later tasks can replace placeholder
+ * handlers without touching transport wiring.
+ *
+ * Source of truth: specs/001-vibe-hero-mvp/contracts/mcp-tools.md.
+ */
+/**
+ * Adapt a typed {@link ToolModule} into a schema-erased {@link AnyToolModule}
+ * for the registry. The returned handler parses raw input through the module's
+ * `inputSchema` (so the typed handler always receives validated, narrowed args)
+ * and delegates. Placeholder handlers that ignore their input pass through
+ * unchanged.
+ *
+ * @param tool - A fully-typed tool module.
+ * @returns The erased registry entry.
+ */
+export const defineTool = (tool) => ({
+    name: tool.name,
+    description: tool.description,
+    inputSchema: tool.inputSchema,
+    handler: async (args) => tool.handler(tool.inputSchema.parse(args)),
+});
+/**
+ * Adapt a plain JSON {@link ToolResult} into the SDK's `CallToolResult`.
+ *
+ * We populate both `content` (a JSON text block, the universally-readable form
+ * for hosts/tests with no output schema) and `structuredContent` (the same
+ * object, machine-readable). This keeps results inspectable without registering
+ * an output schema for every tool yet.
+ *
+ * @param result - The tool's JSON result.
+ * @returns A well-formed `CallToolResult`.
+ */
+export const toCallToolResult = (result) => ({
+    content: [{ type: "text", text: JSON.stringify(result) }],
+    structuredContent: result,
+});
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAmDH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,IAAwB,EACT,EAAE,CAAC,CAAC;IACnB,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,OAAO,EAAE,KAAK,EAAE,IAAa,EAAuB,EAAE,CACpD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAoB,CAAC;CAChE,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAkB,EAAkB,EAAE,CAAC,CAAC;IACvE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IACzD,iBAAiB,EAAE,MAAM;CAC1B,CAAC,CAAC"}

package/dist/tools/us2/standing.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @file Shared standing/ranking helpers for the US-2 read tools (T025–T027).
+ *
+ * `get_status`, `get_guidance`, and (indirectly) `list_topics` all need the same
+ * derivation: given the loaded catalog topics + the learner profile, compute the
+ * per-(topic × class) standing — its {@link AbilityKey}, displayed tier, status,
+ * and current ability — and rank topics by weakness so the weakest/stale one can
+ * be suggested or auto-selected. Centralizing it here keeps the three tools DRY
+ * and guarantees they agree on what "weak", "not_started", and "due_for_review"
+ * mean.
+ *
+ * Pure + telemetry-free (SC-011): every value is derived from the catalog
+ * (bundled or fetched) plus the profile's `abilities`/`graduations` — NO
+ * observation/offer state is consulted, so the whole pull path works with zero
+ * telemetry.
+ *
+ * Source of truth: specs/001-vibe-hero-mvp/contracts/mcp-tools.md
+ * (`get_status` / `get_guidance`), spec.md US-2 / FR-021 / SC-011.
+ */
+import { type AbilityKey, type ToolId } from "../../schemas/common.js";
+import type { Topic } from "../../schemas/content.js";
+import type { Profile } from "../../schemas/profile.js";
+import type { StatusTopic } from "../../schemas/tools.js";
+/**
+ * A topic's computed standing, plus the source {@link Topic} so callers can read
+ * its items/summary (e.g. for guidance text) without re-joining.
+ */
+export interface TopicStanding {
+    /** The serialized `(class, topicId)` key this standing is keyed by. */
+    readonly key: AbilityKey;
+    /** The source catalog topic. */
+    readonly topic: Topic;
+    /** The per-topic status row, contract-shaped for `get_status`. */
+    readonly row: StatusTopic;
+}
+/**
+ * Whether `topic` is in scope for `tool`. A `general` topic is always in scope
+ * (it applies to every tool); a tool-scoped topic is in scope only when its tool
+ * matches. With no `tool` filter, every topic is in scope.
+ */
+export declare const topicInScope: (topic: Topic, tool?: ToolId) => boolean;
+/**
+ * Derive the standing for one topic from the profile (telemetry-free).
+ *
+ * - `tier`/`status` come from `graduations[key]`: a learner with no graduation
+ *   entry has never graduated, so tier is `0` and status is `not_started`.
+ *   Otherwise the displayed tier is `currentTier` and the status mirrors the
+ *   graduation's `current` / `due_for_review`.
+ * - `ability` comes from `abilities[key].value`, defaulting to the cold-start
+ *   {@link ASSESSMENT_CONFIG.startingAbility} when the learner has no estimate
+ *   yet (so a never-touched topic reports a sensible baseline, not `0`).
+ */
+export declare const standingFor: (topic: Topic, profile: Profile) => TopicStanding;
+/**
+ * Compute every in-scope topic's standing, in catalog order.
+ *
+ * @param topics - The loaded catalog topics (bundled or fetched).
+ * @param profile - The learner profile (only `abilities`/`graduations` are read).
+ * @param tool - Optional tool filter; see {@link topicInScope}.
+ */
+export declare const computeStandings: (topics: readonly Topic[], profile: Profile, tool?: ToolId) => TopicStanding[];
+/**
+ * Detect knowledge lapse (FR-009 / OD-003) across a set of standings, given the
+ * caller-injected `now` (the engine math is PURE; status.ts reads the clock and
+ * passes it in — E5). For each currently-graduated topic that has gone stale and
+ * whose decayed effective ability has fallen near/under its lower band
+ * ({@link isDueForReview}), the topic is surfaced for review:
+ *
+ *  - its status row is overlaid to `due_for_review` (so `get_status` reports the
+ *    stale topic correctly even before the profile is rewritten), and
+ *  - its key is collected as `newlyLapsed` so the caller can enqueue a
+ *    `ReviewEntry{reason:"lapsed"}` and persist the `due_for_review` status.
+ *
+ * Topics already flagged `due_for_review` are skipped (idempotent — they are
+ * already surfaced). Ungraduated / `not_started` topics never lapse.
+ *
+ * Pure (clock injected). Returns NEW standing objects for the overlaid rows; the
+ * input array is not mutated.
+ *
+ * @param standings - In-scope standings (from {@link computeStandings}).
+ * @param profile - The learner profile (reads `abilities`/`graduations`).
+ * @param now - Reference ISO datetime, injected by the caller (E5).
+ * @returns The (possibly overlaid) standings plus the keys newly found lapsed.
+ */
+export declare const detectLapses: (standings: readonly TopicStanding[], profile: Profile, now: string) => {
+    standings: TopicStanding[];
+    newlyLapsed: AbilityKey[];
+};
+/**
+ * Weakness ordering for suggestions / weakest-pick (lower ⇒ weaker ⇒ surfaced
+ * first):
+ *   1. `not_started` topics rank ahead of any started topic (they are the most
+ *      valuable next step and need no telemetry to identify).
+ *   2. within each group, lower `ability` ranks first (the weakest area).
+ *   3. ties break on `key` for a stable, deterministic total order.
+ *
+ * @returns A negative/zero/positive comparator result for `Array#sort`.
+ */
+export declare const byWeakness: (a: TopicStanding, b: TopicStanding) => number;
+/**
+ * Rank in-scope standings weakest-first (stable, deterministic).
+ * A copy is returned; the input is never mutated.
+ */
+export declare const rankByWeakness: (standings: readonly TopicStanding[]) => TopicStanding[];
+/**
+ * A short, human reason for why a topic is suggested as a next step.
+ * `not_started` topics are framed as "not started yet"; everything else as a
+ * relative-weakness nudge.
+ */
+export declare const suggestionReason: (standing: TopicStanding) => string;
+//# sourceMappingURL=standing.d.ts.map

package/dist/tools/us2/standing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standing.d.ts","sourceRoot":"","sources":["../../../src/tools/us2/standing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,MAAM,EACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;CAC3B;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,EAAE,OAAO,MAAM,KAAG,OAG1D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,EAAE,SAAS,OAAO,KAAG,aAiB5D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,SAAS,KAAK,EAAE,EACxB,SAAS,OAAO,EAChB,OAAO,MAAM,KACZ,aAAa,EAGgC,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,YAAY,GACvB,WAAW,SAAS,aAAa,EAAE,EACnC,SAAS,OAAO,EAChB,KAAK,MAAM,KACV;IAAE,SAAS,EAAE,aAAa,EAAE,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAA;CAezD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,GAAI,GAAG,aAAa,EAAE,GAAG,aAAa,KAAG,MAM/D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,WAAW,SAAS,aAAa,EAAE,KAClC,aAAa,EAAqC,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,aAAa,KAAG,MAKmB,CAAC"}

package/dist/tools/us2/standing.js

@@ -0,0 +1,143 @@
+/**
+ * @file Shared standing/ranking helpers for the US-2 read tools (T025–T027).
+ *
+ * `get_status`, `get_guidance`, and (indirectly) `list_topics` all need the same
+ * derivation: given the loaded catalog topics + the learner profile, compute the
+ * per-(topic × class) standing — its {@link AbilityKey}, displayed tier, status,
+ * and current ability — and rank topics by weakness so the weakest/stale one can
+ * be suggested or auto-selected. Centralizing it here keeps the three tools DRY
+ * and guarantees they agree on what "weak", "not_started", and "due_for_review"
+ * mean.
+ *
+ * Pure + telemetry-free (SC-011): every value is derived from the catalog
+ * (bundled or fetched) plus the profile's `abilities`/`graduations` — NO
+ * observation/offer state is consulted, so the whole pull path works with zero
+ * telemetry.
+ *
+ * Source of truth: specs/001-vibe-hero-mvp/contracts/mcp-tools.md
+ * (`get_status` / `get_guidance`), spec.md US-2 / FR-021 / SC-011.
+ */
+import { ASSESSMENT_CONFIG } from "../../config.js";
+import { isDueForReview } from "../../engine/lapse.js";
+import { abilityKey, } from "../../schemas/common.js";
+/**
+ * Whether `topic` is in scope for `tool`. A `general` topic is always in scope
+ * (it applies to every tool); a tool-scoped topic is in scope only when its tool
+ * matches. With no `tool` filter, every topic is in scope.
+ */
+export const topicInScope = (topic, tool) => {
+    if (tool === undefined)
+        return true;
+    return topic.class.kind === "general" || topic.class.tool === tool;
+};
+/**
+ * Derive the standing for one topic from the profile (telemetry-free).
+ *
+ * - `tier`/`status` come from `graduations[key]`: a learner with no graduation
+ *   entry has never graduated, so tier is `0` and status is `not_started`.
+ *   Otherwise the displayed tier is `currentTier` and the status mirrors the
+ *   graduation's `current` / `due_for_review`.
+ * - `ability` comes from `abilities[key].value`, defaulting to the cold-start
+ *   {@link ASSESSMENT_CONFIG.startingAbility} when the learner has no estimate
+ *   yet (so a never-touched topic reports a sensible baseline, not `0`).
+ */
+export const standingFor = (topic, profile) => {
+    const key = abilityKey(topic.class, topic.id);
+    const graduation = profile.graduations[key];
+    const ability = profile.abilities[key]?.value ?? ASSESSMENT_CONFIG.startingAbility;
+    const row = graduation === undefined
+        ? { key, title: topic.title, tier: 0, status: "not_started", ability }
+        : {
+            key,
+            title: topic.title,
+            tier: graduation.currentTier,
+            status: graduation.status,
+            ability,
+        };
+    return { key, topic, row };
+};
+/**
+ * Compute every in-scope topic's standing, in catalog order.
+ *
+ * @param topics - The loaded catalog topics (bundled or fetched).
+ * @param profile - The learner profile (only `abilities`/`graduations` are read).
+ * @param tool - Optional tool filter; see {@link topicInScope}.
+ */
+export const computeStandings = (topics, profile, tool) => topics
+    .filter((topic) => topicInScope(topic, tool))
+    .map((topic) => standingFor(topic, profile));
+/**
+ * Detect knowledge lapse (FR-009 / OD-003) across a set of standings, given the
+ * caller-injected `now` (the engine math is PURE; status.ts reads the clock and
+ * passes it in — E5). For each currently-graduated topic that has gone stale and
+ * whose decayed effective ability has fallen near/under its lower band
+ * ({@link isDueForReview}), the topic is surfaced for review:
+ *
+ *  - its status row is overlaid to `due_for_review` (so `get_status` reports the
+ *    stale topic correctly even before the profile is rewritten), and
+ *  - its key is collected as `newlyLapsed` so the caller can enqueue a
+ *    `ReviewEntry{reason:"lapsed"}` and persist the `due_for_review` status.
+ *
+ * Topics already flagged `due_for_review` are skipped (idempotent — they are
+ * already surfaced). Ungraduated / `not_started` topics never lapse.
+ *
+ * Pure (clock injected). Returns NEW standing objects for the overlaid rows; the
+ * input array is not mutated.
+ *
+ * @param standings - In-scope standings (from {@link computeStandings}).
+ * @param profile - The learner profile (reads `abilities`/`graduations`).
+ * @param now - Reference ISO datetime, injected by the caller (E5).
+ * @returns The (possibly overlaid) standings plus the keys newly found lapsed.
+ */
+export const detectLapses = (standings, profile, now) => {
+    const newlyLapsed = [];
+    const overlaid = standings.map((standing) => {
+        const graduation = profile.graduations[standing.key];
+        const ability = profile.abilities[standing.key];
+        if (graduation === undefined || ability === undefined)
+            return standing;
+        if (!isDueForReview(graduation, ability, now))
+            return standing;
+        newlyLapsed.push(standing.key);
+        return {
+            ...standing,
+            row: { ...standing.row, status: "due_for_review" },
+        };
+    });
+    return { standings: overlaid, newlyLapsed };
+};
+/**
+ * Weakness ordering for suggestions / weakest-pick (lower ⇒ weaker ⇒ surfaced
+ * first):
+ *   1. `not_started` topics rank ahead of any started topic (they are the most
+ *      valuable next step and need no telemetry to identify).
+ *   2. within each group, lower `ability` ranks first (the weakest area).
+ *   3. ties break on `key` for a stable, deterministic total order.
+ *
+ * @returns A negative/zero/positive comparator result for `Array#sort`.
+ */
+export const byWeakness = (a, b) => {
+    const aNotStarted = a.row.status === "not_started" ? 0 : 1;
+    const bNotStarted = b.row.status === "not_started" ? 0 : 1;
+    if (aNotStarted !== bNotStarted)
+        return aNotStarted - bNotStarted;
+    if (a.row.ability !== b.row.ability)
+        return a.row.ability - b.row.ability;
+    return a.key < b.key ? -1 : a.key > b.key ? 1 : 0;
+};
+/**
+ * Rank in-scope standings weakest-first (stable, deterministic).
+ * A copy is returned; the input is never mutated.
+ */
+export const rankByWeakness = (standings) => [...standings].sort(byWeakness);
+/**
+ * A short, human reason for why a topic is suggested as a next step.
+ * `not_started` topics are framed as "not started yet"; everything else as a
+ * relative-weakness nudge.
+ */
+export const suggestionReason = (standing) => standing.row.status === "not_started"
+    ? "Not started yet — a good place to begin."
+    : standing.row.status === "due_for_review"
+        ? "Due for review — knowledge may be going stale."
+        : `Weakest area so far (ability ≈ ${Math.round(standing.row.ability)}).`;
+//# sourceMappingURL=standing.js.map

package/dist/tools/us2/standing.js.map

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@vibe-hero/server",
+  "version": "0.1.0",
+  "description": "MCP server engine for the vibe-hero adaptive-learning plugin — not used standalone; install the vibe-hero Claude Code plugin, which launches this and ships the skills + hook.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude-code",
+    "codex",
+    "learning",
+    "quiz",
+    "adaptive-learning",
+    "agentic-coding",
+    "education"
+  ],
+  "author": "Sjors Robroek",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/srobroek/vibe-hero.git",
+    "directory": "packages/server"
+  },
+  "homepage": "https://github.com/srobroek/vibe-hero#readme",
+  "bugs": {
+    "url": "https://github.com/srobroek/vibe-hero/issues"
+  },
+  "private": false,
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "vibe-hero": "dist/cli/index.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "js-yaml": "^4.1.0",
+    "proper-lockfile": "^4.1.2",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
+    "@types/proper-lockfile": "^4.1.4",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && pnpm run copy-assets",
+    "copy-assets": "node -e \"const{cpSync,existsSync,mkdirSync}=require('node:fs');const path=require('node:path');function cp(s,d){if(existsSync(s)){mkdirSync(d,{recursive:true});cpSync(s,d,{recursive:true,filter:p=>!p.endsWith('.ts')});}}cp('src/catalog/bundled','dist/catalog/bundled');const root=path.resolve('../..');['claude-code','general'].forEach(cls=>{const s=path.join(root,'content',cls);const d=path.join('dist','catalog','bundled',cls);if(existsSync(s)){mkdirSync(d,{recursive:true});cpSync(s,d,{recursive:true});}});\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit"
+  }
+}