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

Architecture

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...

Patterns

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...

JobCache — Wiki

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...

Architecture

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...

Architecture

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...

Runbooks

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...

JobCache — Wiki

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...

Patterns

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...

Patterns

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...

Studies

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...

Architecture

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...

Studies

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...

Studies

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...

Runbooks

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...

192 of 1986 indexed surfaces shown

Routes and pages

SvelteKit route surfaces, layouts, and static endpoints.

24 of 139
ArtifactLabelGraphPathProduct
Route+layout.server.tsunmappedjobcache/ops/ui/src/routes/+layout.server.tsjobcache
Routesrc/routes layoutjobcache/ops/ui/src/routes/+layout.sveltejobcache
Route+page.server.tsunmappedjobcache/ops/ui/src/routes/+page.server.tsjobcache
Routesrc/routes pageunmappedjobcache/ops/ui/src/routes/+page.sveltejobcache
Routeroutes/anomalies pageunmappedjobcache/ops/ui/src/routes/anomalies/+page.sveltejobcache
Routeroutes/events pageunmappedjobcache/ops/ui/src/routes/events/+page.sveltejobcache
Routeroutes/infra pageunmappedjobcache/ops/ui/src/routes/infra/+page.sveltejobcache
Routeroutes/inspector pageunmappedjobcache/ops/ui/src/routes/inspector/+page.sveltejobcache
Routeroutes/sysadmin pageunmappedjobcache/ops/ui/src/routes/sysadmin/+page.sveltejobcache
Route+layout.server.tsunmappedjobcache/qa/ui/src/routes/+layout.server.tsjobcache
Routesrc/routes layoutunmappedjobcache/qa/ui/src/routes/+layout.sveltejobcache
Route+page.server.tsunmappedjobcache/qa/ui/src/routes/+page.server.tsjobcache
Routesrc/routes pageunmappedjobcache/qa/ui/src/routes/+page.sveltejobcache
Route+page.server.tsunmappedjobcache/qa/ui/src/routes/behaviour/[behaviourId]/+page.server.tsjobcache
Routebehaviour/[behaviourId] pageunmappedjobcache/qa/ui/src/routes/behaviour/[behaviourId]/+page.sveltejobcache
Route+page.server.tsunmappedjobcache/qa/ui/src/routes/behaviour/+page.server.tsjobcache
Routeroutes/behaviour pageunmappedjobcache/qa/ui/src/routes/behaviour/+page.sveltejobcache
Route+page.server.tsunmappedjobcache/qa/ui/src/routes/investigate/+page.server.tsjobcache
Routeroutes/investigate pageunmappedjobcache/qa/ui/src/routes/investigate/+page.sveltejobcache
Route+page.server.tsunmappedjobcache/qa/ui/src/routes/queue/[workflowId]/+page.server.tsjobcache
Routequeue/[workflowId] pageunmappedjobcache/qa/ui/src/routes/queue/[workflowId]/+page.sveltejobcache
Route+page.server.tsunmappedjobcache/qa/ui/src/routes/queue/+page.server.tsjobcache
Routeroutes/queue pageunmappedjobcache/qa/ui/src/routes/queue/+page.sveltejobcache
Route+page.server.tsunmappedjobcache/qa/ui/src/routes/suites/[suiteId]/+page.server.tsjobcache

API routes

Hono route modules and server endpoints that define product contracts.

24 of 28
ArtifactLabelGraphPathProduct
APIcorpus.tsapi/src/routers/corpus.tscareervector
APIinternal-corpus.tsapi/src/routers/internal-corpus.tscareervector
APIinternal.tsapi/src/routers/internal.tscareervector
APIllm.tsapi/src/routers/llm.tscareervector
APImisc.tsapi/src/routers/misc.tscareervector
APIp2p.tsapi/src/routers/p2p.tscareervector
APIradar-search.tsapi/src/routers/radar-search.tscareervector
APIradar-state.tsapi/src/routers/radar-state.tscareervector
APIradar.tsapi/src/routers/radar.tscareervector
APItelemetry.tsapi/src/routers/telemetry.tscareervector
APIworkspaces.tsapi/src/routers/workspaces.tscareervector
APIaudit.tsjobcache/ops/api/src/routers/audit.tsjobcache
APIchanges.tsjobcache/ops/api/src/routers/changes.tsjobcache
APIcockpit.tsjobcache/ops/api/src/routers/cockpit.tsjobcache
APIcorpus.tsjobcache/ops/api/src/routers/corpus.tsjobcache
APIcost.tsjobcache/ops/api/src/routers/cost.tsjobcache
APIcratedb.tsjobcache/ops/api/src/routers/cratedb.tsjobcache
APIdevices.tsjobcache/ops/api/src/routers/devices.tsjobcache
APIfreshness.tsjobcache/ops/api/src/routers/freshness.tsjobcache
APIhealth.tsjobcache/ops/api/src/routers/health.tsjobcache
APIingestion-health.tsjobcache/ops/api/src/routers/ingestion-health.tsjobcache
APIproviders.tsjobcache/ops/api/src/routers/providers.tsjobcache
APIrecovery.tsjobcache/ops/api/src/routers/recovery.tsjobcache
APIrouting.tsjobcache/ops/api/src/routers/routing.tsjobcache

MCP tools

Agent-facing tools that wrap API contracts.

24 of 62
ArtifactLabelGraphPathProduct
MCP_helpers.tsunmappedjobcache/mcp/src/tools/_helpers.tsjobcache
MCPget_role_evidence.tsunmappedjobcache/mcp/src/tools/get_role_evidence.tsjobcache
MCPindex.tsunmappedjobcache/mcp/src/tools/index.tsjobcache
MCPreductions.tsunmappedjobcache/mcp/src/tools/reductions.tsjobcache
MCPsearch_roles.tsunmappedjobcache/mcp/src/tools/search_roles.tsjobcache
MCPsessions.tsunmappedjobcache/mcp/src/tools/sessions.tsjobcache
MCPsnapshots.tsunmappedjobcache/mcp/src/tools/snapshots.tsjobcache
MCPviews.tsunmappedjobcache/mcp/src/tools/views.tsjobcache
MCPget_audit_log.tsjobcache/ops/mcp/src/tools/get_audit_log.tsjobcache
MCPget_corpus.tsjobcache/ops/mcp/src/tools/get_corpus.tsjobcache
MCPget_cost_per_ad.tsjobcache/ops/mcp/src/tools/get_cost_per_ad.tsjobcache
MCPget_devices.tsjobcache/ops/mcp/src/tools/get_devices.tsjobcache
MCPget_freshness.tsjobcache/ops/mcp/src/tools/get_freshness.tsjobcache
MCPget_health.tsjobcache/ops/mcp/src/tools/get_health.tsjobcache
MCPget_scraper_quotas.tsjobcache/ops/mcp/src/tools/get_scraper_quotas.tsjobcache
MCPget_source_detail.tsjobcache/ops/mcp/src/tools/get_source_detail.tsjobcache
MCPget_source_matrix.tsjobcache/ops/mcp/src/tools/get_source_matrix.tsjobcache
MCPindex.tsjobcache/ops/mcp/src/tools/index.tsjobcache
MCPpause_source.tsjobcache/ops/mcp/src/tools/pause_source.tsjobcache
MCPpin_source_note.tsjobcache/ops/mcp/src/tools/pin_source_note.tsjobcache
MCPrerun_last_failed_scrape.tsjobcache/ops/mcp/src/tools/rerun_last_failed_scrape.tsjobcache
MCPreset_drift.tsjobcache/ops/mcp/src/tools/reset_drift.tsjobcache
MCPresume_source.tsjobcache/ops/mcp/src/tools/resume_source.tsjobcache
MCPstate_override.tsjobcache/ops/mcp/src/tools/state_override.tsjobcache

Components

Shared and perspective-specific Svelte components.

24 of 142
ArtifactLabelGraphPathProduct
ComponentAuditLog.sveltejobcache/ops/ui/src/lib/cockpit/AuditLog.sveltejobcache
ComponentCrossCuts.sveltejobcache/ops/ui/src/lib/cockpit/CrossCuts.sveltejobcache
ComponentDeviceFleet.sveltejobcache/ops/ui/src/lib/cockpit/DeviceFleet.sveltejobcache
ComponentHeaderPanels.sveltejobcache/ops/ui/src/lib/cockpit/HeaderPanels.sveltejobcache
ComponentIngestionHealth.sveltejobcache/ops/ui/src/lib/cockpit/IngestionHealth.sveltejobcache
ComponentIngestionTape.sveltejobcache/ops/ui/src/lib/cockpit/IngestionTape.sveltejobcache
ComponentRoutingFeedback.svelteunmappedjobcache/ops/ui/src/lib/cockpit/RoutingFeedback.sveltejobcache
ComponentSourceDetail.sveltejobcache/ops/ui/src/lib/cockpit/SourceDetail.sveltejobcache
ComponentSourceMatrix.sveltejobcache/ops/ui/src/lib/cockpit/SourceMatrix.sveltejobcache
ComponentJobCacheOpsHeartbeat.svelteunmappedjobcache/ops/ui/src/lib/components/JobCacheOpsHeartbeat.sveltejobcache
ComponentSessionActionButtons.svelteunmappedjobcache/ui/src/lib/SessionActionButtons.sveltejobcache
ComponentKnowledgeHubControl.sveltelib/admin-ui/src/components/KnowledgeHubControl.svelteshared
ComponentPrivateFooter.sveltelib/admin-ui/src/components/PrivateFooter.svelteshared
ComponentPublicFooter.sveltelib/admin-ui/src/components/PublicFooter.svelteshared
ComponentScrapingPill.sveltelib/jobcache-participant/src/ScrapingPill.svelteshared
ComponentOpsAdminShell.svelteunmappedlib/ops-platform/src/ui/OpsAdminShell.svelteshared
ComponentOpsHeartbeatFrame.svelteunmappedlib/ops-platform/src/ui/OpsHeartbeatFrame.svelteshared
ComponentAppShell.svelteunmappedlib/public-ui/src/components/AppShell.svelteshared
ComponentCopyCurrentLinkButton.svelteunmappedlib/public-ui/src/components/CopyCurrentLinkButton.svelteshared
ComponentCreateLanding.svelteunmappedlib/public-ui/src/components/CreateLanding.svelteshared
ComponentLinkDerivativeActions.svelteunmappedlib/public-ui/src/components/LinkDerivativeActions.svelteshared
ComponentLinkIdentityActions.sveltelib/public-ui/src/components/LinkIdentityActions.svelteshared
ComponentLinkIntelligence.svelteunmappedlib/public-ui/src/components/LinkIntelligence.svelteshared

Workers and config

Cloudflare workers, wrangler files, package manifests, and build config.

24 of 106
ArtifactLabelGraphPathProduct
Workerapi/src workerapi/src/worker.tscareervector
Workerjobcache/api/src workerunmappedjobcache/api/src/worker.tsjobcache
Workerjobcache/interface/src/api/commands workerjobcache/interface/src/api/commands/worker.tsjobcache
Workerjobcache/mcp/src workerunmappedjobcache/mcp/src/worker.tsjobcache
Workerjobcache/ops/api/src workerjobcache/ops/api/src/worker.tsjobcache
Workerjobcache/ops/mcp/src workerjobcache/ops/mcp/src/worker.tsjobcache
Worker+server.tsunmappedjobcache/ops/ui/src/routes/api/cockpit/snapshot/+server.tsjobcache
Worker+server.tsunmappedjobcache/ops/ui/src/routes/api/hub/status/+server.tsjobcache
Workerjobcache/qa/api/src workerjobcache/qa/api/src/worker.tsjobcache
Workerjobcache/qa/mcp/src workerjobcache/qa/mcp/src/worker.tsjobcache
Worker+server.tsunmappedjobcache/qa/ui/src/routes/api/hub/status/+server.tsjobcache
Worker+server.tsunmappedjobcache/qa/ui/src/routes/queue/evidence/+server.tsjobcache
Worker+server.tsunmappedjobcache/qa/ui/src/routes/queue/reorder/+server.tsjobcache
Worker+server.tsjobcache/qa/ui/src/routes/trigger/pending/+server.tsjobcache
Workerjobcache/status/api/src workerjobcache/status/api/src/worker.tsjobcache
Workerjobcache/status/mcp/src workerjobcache/status/mcp/src/worker.tsjobcache
Worker+server.tsunmappedjobcache/ui/src/routes/api/[...path]/+server.tsjobcache
Workerqa/api/src workerqa/api/src/worker.tsqa
Workerqa/mcp/src workerqa/mcp/src/worker.tsqa
Worker+server.tsunmappedqa/ui/src/routes/api/hub/checkpoint/+server.tsqa
Worker+server.tsunmappedqa/ui/src/routes/api/hub/falkor/sync/+server.tsqa
Worker+server.tsunmappedqa/ui/src/routes/api/hub/falkor/verify/+server.tsqa
Worker+server.tsunmappedqa/ui/src/routes/api/hub/graphdb/sync/+server.tsqa
Worker+server.tsunmappedqa/ui/src/routes/api/hub/graphdb/verify/+server.tsqa

Migrations

D1 and JobCache schema changes referenced from architecture and runbooks.

24 of 88
ArtifactLabelGraphPathProduct
Migration0001_jobcache_app.sqlunmappedjobcache/api/migrations/0001_jobcache_app.sqljobcache
Migration0002_session_derivatives.sqlunmappedjobcache/api/migrations/0002_session_derivatives.sqljobcache
Migrationadd-ad-language-identity.sqljobcache/migrations/add-ad-language-identity.sqljobcache
Migrationadd-collector-code-version.sqljobcache/migrations/add-collector-code-version.sqljobcache
Migrationadd-collector-version-index.sqljobcache/migrations/add-collector-version-index.sqljobcache
Migrationadd-device-control-plane.sqljobcache/migrations/add-device-control-plane.sqljobcache
Migrationadd-freshness-refetch-index.sqljobcache/migrations/add-freshness-refetch-index.sqljobcache
Migrationadd-jobcache-evidence-index.sqljobcache/migrations/add-jobcache-evidence-index.sqljobcache
Migrationadd-operator-actions.sqljobcache/migrations/add-operator-actions.sqljobcache
Migrationadd-rawstore-encryption-columns.sqljobcache/migrations/add-rawstore-encryption-columns.sqljobcache
Migrationadd-rawstore-wrapped-dk.sqljobcache/migrations/add-rawstore-wrapped-dk.sqljobcache
Migrationadd-render-task-class.sqljobcache/migrations/add-render-task-class.sqljobcache
Migrationadd-reparse-task-class.sqljobcache/migrations/add-reparse-task-class.sqljobcache
Migrationadd-scrape-events.sqljobcache/migrations/add-scrape-events.sqljobcache
Migrationadd-addressed-routing-feedback.sqlunmappedjobcache/migrations/cratedb/add-addressed-routing-feedback.sqljobcache
Migrationadd-archive-pointer.sqlunmappedjobcache/migrations/cratedb/add-archive-pointer.sqljobcache
Migrationadd-corpus-participant-lifecycle.sqlunmappedjobcache/migrations/cratedb/add-corpus-participant-lifecycle.sqljobcache
Migrationadd-deposit-attempt-state.sqlunmappedjobcache/migrations/cratedb/add-deposit-attempt-state.sqljobcache
Migrationadd-leased-at.sqlunmappedjobcache/migrations/cratedb/add-leased-at.sqljobcache
Migrationadd-orchestrator-discovery.sqlunmappedjobcache/migrations/cratedb/add-orchestrator-discovery.sqljobcache
Migrationadd-routing-feedback.sqlunmappedjobcache/migrations/cratedb/add-routing-feedback.sqljobcache
Migrationadd-routing-receipt.sqlunmappedjobcache/migrations/cratedb/add-routing-receipt.sqljobcache
Migrationapply.tsunmappedjobcache/migrations/cratedb/apply.tsjobcache
MigrationCRATEDB-CUTOVER.mdunmappedjobcache/migrations/cratedb/CRATEDB-CUTOVER.mdjobcache

Tests and evidence

Unit, integration, browser, and CI helper files that prove behaviour.

24 of 577
ArtifactLabelGraphPathProduct
Testchain-availability.test.tsapi/src/lib/server/chain-availability.test.tscareervector
Testprocess-commands.test.tsapi/src/lib/server/process-commands.test.tscareervector
Testscope-boundary.test.tsunmappedapi/src/routers/__tests__/scope-boundary.test.tscareervector
Testcorpus.test.tsunmappedapi/src/routers/corpus.test.tscareervector
Testinternal-corpus.test.tsunmappedapi/src/routers/internal-corpus.test.tscareervector
Testinternal.test.tsunmappedapi/src/routers/internal.test.tscareervector
Testprocess-requests-routing.test.tsunmappedapi/src/routers/process-requests-routing.test.tscareervector
Testradar-search.test.tsapi/src/routers/radar-search.test.tscareervector
Testradar.test.tsunmappedapi/src/routers/radar.test.tscareervector
Testworkspaces.jobs-hydration.test.tsapi/src/routers/workspaces.jobs-hydration.test.tscareervector
Testbounded-text.test.tsunmappedjobcache/api/src/bounded-text.test.tsjobcache
Testcore-client.test.tsunmappedjobcache/api/src/core-client.test.tsjobcache
Testd1-store.test.tsunmappedjobcache/api/src/d1-store.test.tsjobcache
Testrouter.test.tsunmappedjobcache/api/src/router.test.tsjobcache
Testschemas.test.tsunmappedjobcache/api/src/schemas.test.tsjobcache
Testworker.test.tsunmappedjobcache/api/src/worker.test.tsjobcache
Testcatalog-conformance.test.tsjobcache/ingest/src/adapters/catalog-conformance.test.tsjobcache
Testgreenhouse-proton.test.tsunmappedjobcache/ingest/src/adapters/greenhouse-proton.test.tsjobcache
Testdevice-cycle.test.tsjobcache/ingest/src/device-cycle.test.tsjobcache
Testdevice-runtime.test.tsjobcache/ingest/src/device-runtime.test.tsjobcache
Testdockerfile-entry.test.tsunmappedjobcache/ingest/src/dockerfile-entry.test.tsjobcache
Testingest-app.test.tsjobcache/ingest/src/jobs/ingest-app.test.tsjobcache
Testmethod-chain.test.tsjobcache/ingest/src/method-chain.test.tsjobcache
Testmethod-order-golden.test.tsjobcache/ingest/src/method-order-golden.test.tsjobcache

Libraries

Shared implementation modules that pages, APIs, and MCP tools depend on.

24 of 844
ArtifactLabelGraphPathProduct
Libraryinstance-store-d1.tsunmappedapi/src/instance-store-d1.tscareervector
Libraryprofile-stack.tsapi/src/lib/profile-stack.tscareervector
Librarychain-availability.tsapi/src/lib/server/chain-availability.tscareervector
Libraryprocess-commands.tsapi/src/lib/server/process-commands.tscareervector
Librarytsconfig.jsonunmappedapi/tsconfig.jsoncareervector
Libraryblueprint-design-language.tsunmappedarchitecture/blueprint-design-language.tscareervector
Libraryblueprint-graph.tsarchitecture/blueprint-graph.tscareervector
Libraryblueprint-routing.tsunmappedarchitecture/blueprint-routing.tscareervector
Libraryblueprint-supergraph.tsunmappedarchitecture/blueprint-supergraph.tscareervector
Libraryblueprint.tsunmappedarchitecture/blueprint.tscareervector
Libraryoperating-obligations.tsunmappedarchitecture/operating-obligations.tscareervector
LibraryCLAUDE.mdCLAUDE.mdcareervector
LibraryREADME.mdunmappedjobcache/api/README.mdjobcache
Librarybounded-text.tsunmappedjobcache/api/src/bounded-text.tsjobcache
Librarycore-client.tsunmappedjobcache/api/src/core-client.tsjobcache
Libraryd1-store.tsunmappedjobcache/api/src/d1-store.tsjobcache
Libraryindex.tsunmappedjobcache/api/src/index.tsjobcache
Libraryrouter.tsunmappedjobcache/api/src/router.tsjobcache
Libraryschemas.tsunmappedjobcache/api/src/schemas.tsjobcache
Libraryservice.tsunmappedjobcache/api/src/service.tsjobcache
Librarystore.tsunmappedjobcache/api/src/store.tsjobcache
Librarytsconfig.jsonunmappedjobcache/api/tsconfig.jsonjobcache
Libraryvitest.config.tsunmappedjobcache/api/vitest.config.tsjobcache
LibraryREADME.mdjobcache/experiments/README.mdjobcache