Codebook
Implementation map
Codebook is the implementation POV. Implementation hub nodes come first; routes, API modules, MCP tools, workers, components, libraries, and source files are the artifacts that prove where those implementations live.
Implementation docs
API ID Conventions
API ID Conventions Workspace Job IDs A job ID is an opaque string key for the workspace local job projection. APIs, MCP tools, and browser code accept and return it as jobId / job id strings. It identifies an entry in...
API ID Conventions
API ID Conventions Workspace Job IDs A job ID is an opaque string key for the workspace local job projection. APIs, MCP tools, and browser code accept and return it as jobId / job id strings. It identifies an entry in...
API Reference
API Reference This is the provider suspended jobcache/interface Core compatibility API. It is not the session private App API and must not acquire new App state. The target public/session route table lives in jobcache...
API Specification
API Specification Two surfaces: 1. REST endpoints — for the SvelteKit app and external clients (curl, Postman, agents calling REST) 2. MCP tools — for AI agents using Model Context Protocol Both wrap the same underlyi...
CareerVector MCP Connectors
CareerVector MCP Connectors CareerVector exposes a remote MCP endpoint for chatbot and agent hosts that support HTTP MCP connectors. Endpoint Use this server URL: Transport: Remote MCP over Streamable HTTP. JSON RPC r...
CareerVector Quality Service
CareerVector Quality Service quality.careervector.corbet.ch is the product facing quality service concept for CareerVector. It coordinates test buckets, quality evidence, budget policy, and synthetic workspace cleanup...
Control Token + MCP Tool Surface
Control Token + MCP Tool Surface JobCache's Core API separates public legacy reads, general control operations, and participant lifecycle authority. The new App MCP has no bearer at all: it calls only the App API, and...
CRDT-pattern gotchas
CRDT pattern gotchas A short field guide for anyone writing or reviewing Yjs ops in CareerVector. Each entry pairs a tempting looking pattern with a counter example that bit us, and the canonical fix that survived rev...
CSS pattern gotchas
CSS pattern gotchas Hard won lessons about DaisyUI v5 + Tailwind v4 base resets, sub pixel rendering, and CSS framework drift from v1. Written for future agents (and future Julian) so the same class of bug doesn't re...
jobcache-mcp hosting — Render vs. Cloudflare
jobcache mcp hosting — Render vs. Cloudflare Status: draft recommendation, 2026 05 17. Co locating MCP with its backing API is the stated direction. This study weighs it against the status quo. 1. Render Hobby free pl...
MCP Coverage Gap and Tool Build Queue
MCP Coverage Gap and Tool Build Queue North star (PRINCIPLES.md 7): every action a human can take in the dashboard must have an MCP tool equivalent. The product's main surface is the collaborative job market matrix; M...
Reference API Sketch
Reference API Sketch This is code shaped design input, not production code. Engine Boundary Draft Facade Selectors Transition Report Design Notes This facade should be substrate neutral. Svelte, MCP, Typst, and tailor...
SK vs Hono: `careervector-api` head-to-head
SK vs Hono: careervector api head to head Status: decided; Date: 2026 05 16 Decision: Keep Hono. The latency wins are real and consistent. The bundle bloat is a fixable artifact of how the migration was executed, not...
Testing Architecture
Testing Architecture The foundation for every test in CareerVector. Read this once; write tests against the layers it defines. Mission Per wiki/content/architecture/PRINCIPLES.md §4: tests are the spec, not regression...
Routes and pages
SvelteKit route surfaces, layouts, and static endpoints.
API routes
Hono route modules and server endpoints that define product contracts.
MCP tools
Agent-facing tools that wrap API contracts.
Components
Shared and perspective-specific Svelte components.
Workers and config
Cloudflare workers, wrangler files, package manifests, and build config.
Migrations
D1 and JobCache schema changes referenced from architecture and runbooks.
Tests and evidence
Unit, integration, browser, and CI helper files that prove behaviour.
| Artifact | Label | Graph | Path | Product |
|---|---|---|---|---|
| Test | chain-availability.test.ts | api/src/lib/server/chain-availability.test.ts | careervector | |
| Test | process-commands.test.ts | api/src/lib/server/process-commands.test.ts | careervector | |
| Test | scope-boundary.test.ts | unmapped | api/src/routers/__tests__/scope-boundary.test.ts | careervector |
| Test | corpus.test.ts | unmapped | api/src/routers/corpus.test.ts | careervector |
| Test | internal-corpus.test.ts | unmapped | api/src/routers/internal-corpus.test.ts | careervector |
| Test | internal.test.ts | unmapped | api/src/routers/internal.test.ts | careervector |
| Test | process-requests-routing.test.ts | unmapped | api/src/routers/process-requests-routing.test.ts | careervector |
| Test | radar-search.test.ts | api/src/routers/radar-search.test.ts | careervector | |
| Test | radar.test.ts | unmapped | api/src/routers/radar.test.ts | careervector |
| Test | workspaces.jobs-hydration.test.ts | api/src/routers/workspaces.jobs-hydration.test.ts | careervector | |
| Test | bounded-text.test.ts | unmapped | jobcache/api/src/bounded-text.test.ts | jobcache |
| Test | core-client.test.ts | unmapped | jobcache/api/src/core-client.test.ts | jobcache |
| Test | d1-store.test.ts | unmapped | jobcache/api/src/d1-store.test.ts | jobcache |
| Test | router.test.ts | unmapped | jobcache/api/src/router.test.ts | jobcache |
| Test | schemas.test.ts | unmapped | jobcache/api/src/schemas.test.ts | jobcache |
| Test | worker.test.ts | unmapped | jobcache/api/src/worker.test.ts | jobcache |
| Test | catalog-conformance.test.ts | jobcache/ingest/src/adapters/catalog-conformance.test.ts | jobcache | |
| Test | greenhouse-proton.test.ts | unmapped | jobcache/ingest/src/adapters/greenhouse-proton.test.ts | jobcache |
| Test | device-cycle.test.ts | jobcache/ingest/src/device-cycle.test.ts | jobcache | |
| Test | device-runtime.test.ts | jobcache/ingest/src/device-runtime.test.ts | jobcache | |
| Test | dockerfile-entry.test.ts | unmapped | jobcache/ingest/src/dockerfile-entry.test.ts | jobcache |
| Test | ingest-app.test.ts | jobcache/ingest/src/jobs/ingest-app.test.ts | jobcache | |
| Test | method-chain.test.ts | jobcache/ingest/src/method-chain.test.ts | jobcache | |
| Test | method-order-golden.test.ts | jobcache/ingest/src/method-order-golden.test.ts | jobcache |
Libraries
Shared implementation modules that pages, APIs, and MCP tools depend on.
| Artifact | Label | Graph | Path | Product |
|---|---|---|---|---|
| Library | instance-store-d1.ts | unmapped | api/src/instance-store-d1.ts | careervector |
| Library | profile-stack.ts | api/src/lib/profile-stack.ts | careervector | |
| Library | chain-availability.ts | api/src/lib/server/chain-availability.ts | careervector | |
| Library | process-commands.ts | api/src/lib/server/process-commands.ts | careervector | |
| Library | tsconfig.json | unmapped | api/tsconfig.json | careervector |
| Library | blueprint-design-language.ts | unmapped | architecture/blueprint-design-language.ts | careervector |
| Library | blueprint-graph.ts | architecture/blueprint-graph.ts | careervector | |
| Library | blueprint-routing.ts | unmapped | architecture/blueprint-routing.ts | careervector |
| Library | blueprint-supergraph.ts | unmapped | architecture/blueprint-supergraph.ts | careervector |
| Library | blueprint.ts | unmapped | architecture/blueprint.ts | careervector |
| Library | operating-obligations.ts | unmapped | architecture/operating-obligations.ts | careervector |
| Library | CLAUDE.md | CLAUDE.md | careervector | |
| Library | README.md | unmapped | jobcache/api/README.md | jobcache |
| Library | bounded-text.ts | unmapped | jobcache/api/src/bounded-text.ts | jobcache |
| Library | core-client.ts | unmapped | jobcache/api/src/core-client.ts | jobcache |
| Library | d1-store.ts | unmapped | jobcache/api/src/d1-store.ts | jobcache |
| Library | index.ts | unmapped | jobcache/api/src/index.ts | jobcache |
| Library | router.ts | unmapped | jobcache/api/src/router.ts | jobcache |
| Library | schemas.ts | unmapped | jobcache/api/src/schemas.ts | jobcache |
| Library | service.ts | unmapped | jobcache/api/src/service.ts | jobcache |
| Library | store.ts | unmapped | jobcache/api/src/store.ts | jobcache |
| Library | tsconfig.json | unmapped | jobcache/api/tsconfig.json | jobcache |
| Library | vitest.config.ts | unmapped | jobcache/api/vitest.config.ts | jobcache |
| Library | README.md | jobcache/experiments/README.md | jobcache |