{
  "id": "page:docs-genty-features-backlog-updated-genty-stack-roadmap",
  "_kind": "Page",
  "_file": "wiki/docs/genty-features-backlog-updated/genty-stack-roadmap.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/genty-features-backlog-updated/genty-stack-roadmap.md",
    "sourceKind": "repo-docs",
    "title": "Genty Stack Roadmap",
    "displayName": "Genty Stack Roadmap",
    "slug": "docs/genty-features-backlog-updated/genty-stack-roadmap",
    "articlePath": "wiki/docs/genty-features-backlog-updated/genty-stack-roadmap.md",
    "article": "\n# Genty Stack Roadmap\n\n> The genty stack is a superset of Pi's capabilities plus trust enforcement.\n> Baseline: [pi.dev](https://pi.dev/) as of 2026-06-04\n> **Status: All 18 gaps (11 Pi parity + 7 trust) CLOSED as of 2026-06-05**\n\n---\n\n## Stack Layer Reference\n\n| Layer | Abstract Role | Our Implementation |\n|-------|--------------|-------------------|\n| L4 agent-core | Core runtime primitives | `@a5c-ai/genty-core` |\n| L5 agent-runtime | Session/daemon/resource management | `@a5c-ai/genty-runtime` |\n| L6 agent-platform | Orchestration, harness, governance | `@a5c-ai/genty-platform` |\n| SDK | Public API surface | `@a5c-ai/babysitter-sdk` |\n| Adapters | Harness integration | `@a5c-ai/adapters` family |\n\n---\n\n## 1. Modes of Operation\n\n### 1.1 Interactive Mode — IMPLEMENTED\n\nFull TUI via `@a5c-ai/genty-tui` (Ink). Harness orchestration via genty-platform. Real-time event rendering, breakpoint approval, parallel task visualization.\n\n### 1.2 Print / JSON Mode — IMPLEMENTED ✅\n\n`genty -p \"query\"` one-shot mode. JSON event stream via `--json`. CLI at `packages/genty/cli/src/cli/commands/print.ts`.\n\n### 1.3 RPC Mode — IMPLEMENTED ✅\n\nJSON-RPC over stdin/stdout. `genty rpc` command. Server at `packages/genty/runtime/src/rpc/server.ts`, CLI entry at `packages/genty/cli/src/cli/commands/rpc.ts`. Supports `session.create`, `session.send`, `model.switch`, `model.list`, `tool.list`, `extension.list`, `health`.\n\n### 1.4 SDK Mode — IMPLEMENTED\n\n`@a5c-ai/babysitter-sdk` provides `defineTask`, run management, sessions, hooks. Programmatic embedding works.\n\n---\n\n## 2. Context Engineering\n\n### 2.1 AGENTS.md — IMPLEMENTED ✅\n\nHierarchical loading from `~/.genty/agent/AGENTS.md`, parent directories, and CWD. Also loads `GENTY.md`. Wired into orchestration session via `GentySessionContext`.\n\n**Where:** `packages/genty/platform/src/context/instructions.ts`\n\n### 2.2 SYSTEM.md — IMPLEMENTED ✅\n\nPer-project `SYSTEM.md` with frontmatter `mode: replace|append`. Wired into orchestration and worker sessions.\n\n**Where:** Same file, `parseSystemMd()` function.\n\n### 2.3 Compaction — IMPLEMENTED\n\n4-layer compression subsystem (29%–94% reduction). Auto-summarizes at context limit. Customizable per-layer.\n\n### 2.4 Skills — IMPLEMENTED\n\nSkills with `SKILL.md`, progressive disclosure, on-demand loading. Unified plugin system with marketplace.\n\n### 2.5 Prompt Templates — IMPLEMENTED\n\nCommands as markdown files. `/name` expansion. Frontmatter metadata.\n\n### 2.6 Dynamic Context — IMPLEMENTED ✅\n\nProvider-based pipeline with `collectInjections`/`applyInjections`. Extension-registered providers auto-wired. Supports message injection and system prompt append. Wired into orchestration loop.\n\n**Where:** `packages/genty/platform/src/context/dynamic.ts`\n\n---\n\n## 3. Extensibility\n\n### 3.1 Extension API — IMPLEMENTED ✅\n\nFull TypeScript Extension API:\n- `GentyExtension` interface with `activate(ctx)`/`deactivate()`\n- `ExtensionContext`: registerTool, registerCommand, registerKeyBinding, onEvent, registerStatusBarItem, injectContext, getConfig, log\n- `ExtensionRegistry` with namespace isolation (`ext:<name>:` prefix), permission policy enforcement, key binding conflict detection\n- 10 permission types, event system with error isolation\n- 14 unit tests\n\n**Where:** `packages/genty/core/src/extensions/`\n\n### 3.2 Plugins — IMPLEMENTED\n\nFull plugin system: skills, MCP servers, hooks, commands. Marketplace CLI. Per-harness bundles.\n\n### 3.3 Hooks — IMPLEMENTED\n\nLifecycle hooks with 13 per-harness adapters.\n\n### 3.4 MCP — IMPLEMENTED\n\nMCP server mode + client for plugin tool servers.\n\n### 3.5 Installable Extension Packages — IMPLEMENTED ✅\n\n- `installFromNpm(packageName, version?)` — npm install to `~/.genty/extensions/`\n- `installFromGit(url, ref?)` — git clone + npm install\n- `installFromLocal(path)` — symlink/reference\n- `listInstalled()` — enumerate installed extensions\n- Filesystem discovery scans `~/.genty/extensions/` on startup, auto-activates into registry\n\n**Where:** `packages/genty/platform/src/extensions/installer.ts` + `discovery.ts`\n\n---\n\n## 4. Session Management\n\n### 4.1 Tree-Structured History — IMPLEMENTED ✅\n\nTree data structure with parent pointers, branch IDs, forking from any node, navigation, bookmarks, serialize/deserialize.\n\n**Where:** `packages/genty/runtime/src/session/tree.ts`\n\n### 4.2 Session Export / Share — IMPLEMENTED ✅\n\nHTML export (dark theme, styled per-role) and markdown export. CLI command `genty session-export <tree-path> [html|markdown] [output-path]`.\n\n**Where:** `packages/genty/runtime/src/session/export.ts` + `packages/genty/cli/src/cli/commands/session/export.ts`\n\n### 4.3 Session Resume — IMPLEMENTED\n\nEvent-sourced journal with deterministic replay. Works across sessions and harnesses.\n\n---\n\n## 5. Model & Provider Support\n\n### 5.1 Multi-Provider — IMPLEMENTED\n\n15+ harnesses with provider routing via transport-adapter proxy.\n\n### 5.2 Mid-Session Model Switch — IMPLEMENTED ✅\n\n`ModelSwitchState` with `switchModel`, `cycleFavorite`, `addFavorite`, `removeFavorite`. Wired into `GentySessionContext` — model switch state used for session creation.\n\n**Where:** `packages/genty/platform/src/interaction/model-switch.ts`\n\n---\n\n## 6. Agent Interaction\n\n### 6.1 Steering — IMPLEMENTED ✅\n\n`SteeringQueue` with typed messages (`steer`/`followup`), drain between orchestration turns, prepended to prompt. Listener subscriptions.\n\n**Where:** `packages/genty/platform/src/interaction/steering.ts`\n\n### 6.2 Approval Modes — IMPLEMENTED\n\nInteractive (breakpoints) and yolo (auto-approve). Profile-driven density.\n\n---\n\n## 7. Trust Enforcement — IMPLEMENTED ✅ (beyond Pi)\n\nThis is where the genty stack goes beyond Pi. Every action in the system produces cryptographically signed evidence.\n\n### 7.1 Design Principles — IMPLEMENTED\n\nAll 4 principles are enforced through the signing primitives.\n\n### 7.2 Tool Call Signing — IMPLEMENTED ✅\n\n`signToolResult`/`verifyToolResult` with Ed25519 signatures. Covers tool name, input params, output, timestamp, upstream signatures.\n\n**Where:** `packages/genty/core/src/trust/tool-signing.ts`\n\n### 7.3 Model Response Signing — IMPLEMENTED ✅\n\n`signModelResponse`/`verifyModelResponse`. Covers model ID, provider, input messages hash, output content, thinking content, token usage.\n\n**Where:** `packages/genty/core/src/trust/model-signing.ts`\n\n### 7.4 Agent Request Signing — IMPLEMENTED ✅\n\n`signAgentRequest`/`verifyAgentRequest`. Covers agent ID, session ID, turn number, request type, content, delegation chain.\n\n**Where:** `packages/genty/core/src/trust/agent-signing.ts`\n\n### 7.5 Permission as Signed Evidence — IMPLEMENTED ✅\n\n`signPermissionEvidence`/`verifyPermissionEvidence`/`isPermissionValid`. Scoped with expiry, conditions, approver identity.\n\n**Where:** `packages/genty/core/src/trust/tool-signing.ts`\n\n### 7.6 Prompt Signing — IMPLEMENTED ✅\n\n`signPrompt`/`verifyPrompt`. Supports initial/followup/steering types. Author ID, instruction hashes, content hashing.\n\n**Where:** `packages/genty/core/src/trust/agent-signing.ts`\n\n### 7.7 Trust Chain Verification — IMPLEMENTED ✅\n\n`verifyTrustChain` validates end-to-end signature chain with delegation link verification.\n\n**Where:** `packages/genty/core/src/trust/chain.ts`\n\n### 7.8 Key Persistence — IMPLEMENTED ✅\n\nEd25519 key pairs stored at `~/.genty/keys/`. Load-or-create semantics per agent ID.\n\n**Where:** `packages/genty/platform/src/trust/key-store.ts`\n\n### 7.9 Harness Integration — IMPLEMENTED ✅\n\nAll trust primitives wired into the production harness via `GentySessionContext`:\n- `gentySessionContext.ts` — central factory\n- `harness-signing.ts` — trust context bridge for prompt/tool/model signing\n- `internalPhase.ts` — orchestration loop integration\n- `workerSessionEnhancer.ts` — worker session integration\n\n---\n\n## Priority Order — Completion Status\n\nAll 11 items IMPLEMENTED as of 2026-06-05:\n\n1. ~~**Trust Enforcement**~~ ✅ — 7 gaps, 30 tests\n2. ~~**Extension API**~~ ✅ — 14 tests\n3. ~~**Print/JSON mode**~~ ✅\n4. ~~**RPC mode**~~ ✅\n5. ~~**AGENTS.md / SYSTEM.md**~~ ✅\n6. ~~**Tree-structured history**~~ ✅\n7. ~~**Steering**~~ ✅\n8. ~~**Mid-session model switch**~~ ✅\n9. ~~**Session export/share**~~ ✅\n10. ~~**Dynamic context extensions**~~ ✅\n11. ~~**Installable extension packages**~~ ✅\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-genty-features-backlog-updated",
      "to": "page:docs-genty-features-backlog-updated-genty-stack-roadmap",
      "kind": "contains_page"
    }
  ]
}