/** * Story annotations seeded by `./seed-primitive-story`. Each `prefix` is the * start of a commit SHA in the tracked repo (kody-hq/kody by default). They * only match commits in that repo, so a fork pointed at another repo should * replace this list (or leave it empty) and write its own with `./commentary`. * * Seeding never overwrites an existing commentary, and already-stored * commentaries are what the chart shows, so editing this list does not change * the live chart on its own. */ export const primitiveStories: Array<{ prefix: string; label: string; narrative: string }> = [ { prefix: 'b449da5', label: 'Search + execute', narrative: 'The factory loop lands as two primitives: search to find a capability, execute to run it. Almost every later Kody surface is an expansion of this pair.', }, { prefix: 'a81baf9', label: 'Capabilities get domains', narrative: 'Capabilities are regrouped by domain (email, jobs, packages, …) so search can rank a neighborhood instead of a flat tool list.', }, { prefix: '53953b7', label: 'UI save combined', narrative: 'Separate generated-UI save paths collapse into one upsert capability. A small net change that removes a primitive fork in the API.', }, { prefix: 'af4b327', label: 'Cursor MCP leaves core', narrative: 'Built-in Cursor MCP capabilities are deleted from kody itself. Agents pick them up through a connected MCP server instead of a first-party bundle.', }, { prefix: '64f1ab0', label: 'GitHub MCP leaves core', narrative: 'Same extraction for GitHub: the mock server and built-in GitHub capabilities leave the repo so GitHub work goes through the integration/package lane.', }, { prefix: 'd3f6f61', label: 'Style primitives combined', narrative: 'Shared client style primitives are extracted and auth UI styling is consolidated. Lines drop because duplicated presentation code is folded together.', }, { prefix: '87a495a', label: 'Agent-turn primitives', narrative: 'Generic agent-turn primitives are added so hosted chat can run a turn without baking a vendor agent into the core.', }, { prefix: '8d2a07d', label: 'Repo-backed source', narrative: 'Package source becomes a git-backed primitive. Saved packages can live as real repos instead of only inlined file blobs.', }, { prefix: 'bfe1457', label: 'page-to-markdown removed', narrative: 'The page-to-markdown capability is deleted after it proved the wrong primitive for fetching the web. Later work uses focused fetch helpers instead.', }, { prefix: 'fd2bc77', label: 'Package-first split', narrative: 'Architecture foundations move durable work into packages. A large deletion as monolith helpers are carved out of the core worker.', }, { prefix: 'f008b29', label: 'Package realtime', narrative: 'A websocket primitive for package apps. Hosted UIs can push live events without each package inventing its own channel.', }, { prefix: '2cd81f7', label: 'Agent turns removed', narrative: 'Built-in agent-turn primitives come back out. The earlier add was useful for learning the shape; the remove keeps vendor agent loops out of core.', }, { prefix: 'ed933a5', label: 'Community packages', narrative: 'Public listings, forks, ratings, and moderation become first-class. Packages stop being only a private account primitive.', }, { prefix: '8d7b77b', label: 'Generated UI runtime gone', narrative: 'open_generated_ui and its runtime are removed. Hosted package apps replace the generated-UI primitive as the thing you open in a browser.', }, { prefix: '8a68e67', label: 'OpenAPI bindings', narrative: 'Spec summarize, client scaffold, and curated provider bindings land. Third-party HTTP APIs become a reusable integration primitive.', }, { prefix: 'f8803a0', label: 'OAuth as tables', narrative: 'OAuth apps and connections become first-class storage instead of ad-hoc secrets. Integrations get a real primitive instead of a convention.', }, { prefix: 'd93cc2e', label: 'Package codemods', narrative: 'A formal migration system for user package source. When a primitive changes shape, existing packages can be rewritten on publish.', }, { prefix: 'b2da6f7', label: 'Remote connectors removed', narrative: 'Remote connectors leave the repo. Home devices talk outbound MCP instead of Kody hosting inbound connector primitives.', }, { prefix: '8b9e6f7', label: 'Package services removed', narrative: 'The package-services primitive is deleted. Durable work stays on jobs, storage, and app fetch — one less overlapping runtime to explain.', }, // Late-2026 labels. The chart staggers label rows by creation order // (commentary index % 3), so this order is chosen to keep neighbouring // labels on different rows at ~1024px wide. Keep it when editing. { prefix: 'e3e042a', label: 'Remix package apps', narrative: 'Package apps become hosted Remix mini-apps: a Remix router renders on kody.run and hydrates from a platform-built browser module. Existing raw-fetch apps keep working.', }, { prefix: 'c3f2676', label: 'OpenAPI purged', narrative: 'The pre-launch purge hard-cuts the durable OpenAPI bindings, retires ambient execute scratch storage, and stops refreshing raw OAuth tokens. About ten thousand lines leave as research moves into packages.', }, { prefix: '15fe049', label: 'Shares become teams', narrative: 'Teams phase 8 converts package shares and scope grants into the org access model, turns platform accounts into ordinary orgs, and deletes the old share and platform lanes.', }, { prefix: '7d4d04e', label: 'Credentials website UI', narrative: 'The whole credentials website lands in one PR: list, detail, creation links, package tabs, and approval pages on top of the new credentials backend.', }, { prefix: 'edc1189', label: 'Test surgery', narrative: 'Deliberate test-debt surgery removes about 70k lines of redundant tests while keeping every use case covered. The steepest single drop on the chart.', }, { prefix: 'a2df3e1', label: 'CLI joins the repo', narrative: 'The Kody CLI is imported into the monorepo as packages/cli and becomes a client of the versioned HTTP API, with login minting a revocable device token. The biggest single rise on the chart.', }, { prefix: '2894f12', label: 'TanStack Start web app', narrative: 'The web app moves to TanStack Start, Router, Query, and Redact. The PR adds about 193k lines and removes about 157k as the old browser router and renderer are retired.', }, ]