{
  "id": "page:docs-harness-features-backlog-glossary-references",
  "_kind": "Page",
  "_file": "wiki/docs/harness-features-backlog/glossary-references.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "sourcePath": "docs/harness-features-backlog/glossary-references.md",
    "sourceKind": "repo-docs",
    "title": "Glossary & References",
    "displayName": "Glossary & References",
    "slug": "docs/harness-features-backlog/glossary-references",
    "articlePath": "wiki/docs/harness-features-backlog/glossary-references.md",
    "article": "\n# Glossary & References\n\nTerms, abbreviations, file paths, and cross-codebase references used throughout this gap analysis.\n\n## Glossary\n\n| Term | Definition |\n|------|-----------|\n| **CC** | Claude Code -- Anthropic's AI coding agent CLI |\n| **Harness** | The Babysitter orchestration platform that delegates work to AI CLI tools |\n| **Adapter** | A harness adapter wraps a specific AI CLI (Claude Code, Codex, etc.) |\n| **Effect** | A side-effect requested by a process (task, breakpoint, sleep, orchestrator_task) |\n| **Journal** | Append-only event log for a run, stored in `.a5c/runs/<runId>/journal/` |\n| **State Cache** | Derived replay cache rebuilt from journal (`state/state.json`) |\n| **Replay** | Deterministic re-execution of a process against its journal |\n| **Process** | A JS function (`async function process(inputs, ctx)`) that defines orchestration logic |\n| **Run** | A single execution of a process, stored in `.a5c/runs/<runId>/` |\n| **Breakpoint** | A human approval gate in a process; may be auto-approved by rules |\n| **Strata** | Prompt assembly layers: stable (cached), runtime (per-session), turn-local (per-turn) |\n| **Compaction** | Summarizing or condensing session history to fit within context windows |\n| **MCP** | Model Context Protocol -- standard for AI tool integration |\n| **Pi** | A coding agent with programmatic session support |\n| **Agentic Tools** | 16 tool definitions injectable into Pi sessions |\n| **Observer Dashboard** | Real-time monitoring UI for babysitter runs |\n| **Process Library** | Git-based repository of reusable process definitions |\n\n## Gap ID Prefixes\n\n| Prefix | Category | Directory |\n|--------|----------|-----------|\n| GAP-TOOLS-xxx | Tools & Capabilities | [gaps/tools-capabilities/](./gaps/tools-capabilities/) |\n| GAP-UX-xxx / GAP-USER-xxx | User Experience | [gaps/user-experience/](./gaps/user-experience/) |\n| GAP-PERF-xxx | Performance | [gaps/performance/](./gaps/performance/) |\n| GAP-AGENT-xxx | Agent Delegation | [gaps/agent-delegation/](./gaps/agent-delegation/) |\n| GAP-REMOTE-xxx | Remote Integration | [gaps/remote-integration/](./gaps/remote-integration/) |\n| GAP-STATE-xxx | State Continuity | [gaps/state-continuity/](./gaps/state-continuity/) |\n| GAP-OBS-xxx | Observability | [gaps/observability/](./gaps/observability/) |\n| GAP-SEC-xxx | Security | [gaps/security/](./gaps/security/) |\n| GAP-ECO-xxx | Ecosystem | [gaps/ecosystem/](./gaps/ecosystem/) |\n| GAP-PROMPT-xxx | Prompt Engineering | [gaps/prompt-engineering/](./gaps/prompt-engineering/) |\n| GAP-PAR-xxx | Parallelization | [gaps/parallelization/](./gaps/parallelization/) |\n| GAP-JSON-xxx | JSON Interaction | [gaps/json-interaction/](./gaps/json-interaction/) |\n| GAP-SUBOBS-xxx | Subagent Observability | [gaps/subagent-observability/](./gaps/subagent-observability/) |\n| GAP-HADAPT-xxx | Harness Adaptation | [gaps/harness-adaptation/](./gaps/harness-adaptation/) |\n| GAP-SESSION-xxx | Session Management | [gaps/session-management/](./gaps/session-management/) |\n| GAP-MCPC-xxx | MCP Channels | [gaps/mcp-channels/](./gaps/mcp-channels/) |\n| GAP-PROC-xxx | Process Composition | [gaps/process-composition/](./gaps/process-composition/) |\n| GAP-ROUTE-xxx | Effect Routing | [gaps/effect-routing/](./gaps/effect-routing/) |\n| GAP-BRK-xxx | Breakpoint Workflows | [gaps/breakpoint-workflows/](./gaps/breakpoint-workflows/) |\n| GAP-RUN-xxx | Run Lifecycle | [gaps/run-lifecycle/](./gaps/run-lifecycle/) |\n| GAP-OBS-NEW-xxx | Observer Integration | [gaps/observer-integration/](./gaps/observer-integration/) |\n| GAP-PROF-xxx | Profile Orchestration | [gaps/profile-orchestration/](./gaps/profile-orchestration/) |\n\n## Severity Levels\n\n| Level | Description | Action |\n|-------|-------------|--------|\n| **Critical** | Blocks key use cases or creates significant risk | Immediate action required (Phase 1-2) |\n| **High** | Major capability gap affecting daily workflows | Address in near-term (Phase 2-3) |\n| **Medium** | Notable gap with workarounds available | Plan for medium-term (Phase 3-4) |\n| **Low** | Nice-to-have; minimal impact on core workflows | Address opportunistically (Phase 5) |\n\n## Effort Sizes\n\n| Size | Description | Approximate Duration |\n|------|-------------|---------------------|\n| **S** (Small) | Straightforward change, well-understood scope | 1-2 days |\n| **M** (Medium) | Multi-file change, some design decisions | 3-5 days |\n| **L** (Large) | New module or significant refactor | 1-3 weeks |\n| **XL** (Extra Large) | Major infrastructure, cross-cutting concerns | 3-8 weeks |\n\n## Key File References (Harness Codebase)\n\n### Core SDK\n\n| Component | Path |\n|-----------|------|\n| CLI entry | `packages/sdk/src/cli/main.ts` |\n| MCP entry | `packages/sdk/src/cli/mcpServeEntry.ts` |\n| Runtime | `packages/sdk/src/runtime/` |\n| Orchestrate iteration | `packages/sdk/src/runtime/orchestrateIteration.ts` |\n| Process context | `packages/sdk/src/runtime/processContext.ts` |\n| Exceptions | `packages/sdk/src/runtime/exceptions.ts` |\n| Replay engine | `packages/sdk/src/runtime/replay/createReplayEngine.ts` |\n| Replay cursor | `packages/sdk/src/runtime/replay/replayCursor.ts` |\n| Effect index | `packages/sdk/src/runtime/replay/effectIndex.ts` |\n| State cache | `packages/sdk/src/runtime/replay/stateCache.ts` |\n\n### Storage & Tasks\n\n| Component | Path |\n|-----------|------|\n| Storage module | `packages/sdk/src/storage/` |\n| Task definitions | `packages/sdk/src/tasks/` |\n| Task serializer | `packages/sdk/src/tasks/serializer.ts` |\n| Task registry | `packages/sdk/src/tasks/registry.ts` |\n| Task batching | `packages/sdk/src/tasks/batching.ts` |\n\n### Harness Adapters\n\n| Component | Path |\n|-----------|------|\n| Adapter directory | `packages/sdk/src/harness/` |\n| Harness discovery | `packages/sdk/src/harness/discovery.ts` |\n| Harness invoker | `packages/sdk/src/harness/invoker.ts` |\n| Pi wrapper | `packages/sdk/src/harness/piWrapper.ts` |\n| Pi secure sandbox | `packages/sdk/src/harness/piSecureSandbox.ts` |\n| Agentic tools | `packages/sdk/src/harness/agenticTools.ts` |\n| Adapter registry | `packages/sdk/src/harness/registry.ts` |\n| Install support | `packages/sdk/src/harness/installSupport.ts` |\n\n### Plugins & Extensions\n\n| Component | Path |\n|-----------|------|\n| Plugin types | `packages/sdk/src/plugins/types.ts` |\n| Plugin registry | `packages/sdk/src/plugins/registry.ts` |\n| Plugin marketplace | `packages/sdk/src/plugins/marketplace.ts` |\n| Plugin migrations | `packages/sdk/src/plugins/migrations.ts` |\n| Plugin package reader | `packages/sdk/src/plugins/packageReader.ts` |\n| Process library | `packages/sdk/src/processLibrary/` |\n\n### Security & Breakpoints\n\n| Component | Path |\n|-----------|------|\n| Breakpoint types | `packages/sdk/src/breakpoints/types.ts` |\n| Breakpoint patterns | `packages/sdk/src/breakpoints/patterns.ts` |\n| Breakpoint rules | `packages/sdk/src/breakpoints/rules.ts` |\n| Breakpoint evaluator | `packages/sdk/src/breakpoints/evaluator.ts` |\n\n### Interaction & Prompts\n\n| Component | Path |\n|-----------|------|\n| Interaction module | `packages/sdk/src/interaction/` |\n| Prompts module | `packages/sdk/src/prompts/` |\n| Compression module | `packages/sdk/src/compression/` |\n| Session management | `packages/sdk/src/session/` |\n| Profiles | `packages/sdk/src/profiles/` |\n\n### Observability\n\n| Component | Path |\n|-----------|------|\n| Logging module | `packages/sdk/src/logging/` |\n| Hooks | `packages/sdk/src/hooks/` |\n| Hook dispatcher | `packages/sdk/src/hooks/dispatcher.ts` |\n| Observer dashboard | `packages/observer-dashboard/` |\n| Config | `packages/sdk/src/config/` |\n\n### Harness Plugins\n\n| Plugin | Path |\n|--------|------|\n| Claude Code plugin | `plugins/babysitter/` |\n| Codex plugin | `plugins/babysitter-codex/` |\n| Cursor plugin | `plugins/babysitter-cursor/` |\n| Gemini plugin | `plugins/babysitter-gemini/` |\n| GitHub Copilot plugin | `plugins/babysitter-github/` |\n| Pi plugin | `plugins/babysitter-pi/` |\n| oh-my-pi plugin | `plugins/babysitter-omp/` |\n| Paperclip plugin | `plugins/babysitter-paperclip/` |\n| Marketplace | `plugins/a5c/marketplace/` |\n\n## CC Feature Reference (from inventory)\n\n| CC Feature | Category |\n|-----------|----------|\n| 43+ native tools | Tools |\n| Ink/React TUI | UX |\n| Voice mode (STT/TTS) | UX |\n| Vim mode | UX |\n| Ephemeral prompt caching | Performance |\n| Multi-mode compaction | Performance |\n| AgentTool (subagents) | Agent |\n| TeamCreateTool (swarms) | Agent |\n| SendMessageTool (messaging) | Agent |\n| Daemon mode | Remote |\n| Bridge mode (IDE) | Remote |\n| Remote sessions (WebSocket) | Remote |\n| extractMemories | State |\n| autoDream | State |\n| SessionMemory | State |\n| policyLimits | Security |\n| PermissionRequest hooks | Security |\n| Datadog/Growthbook analytics | Observability |\n| Feature gates (20+) | Ecosystem |\n| MagicDocs | Ecosystem |\n\n## Source Data Files\n\n| Data | Path |\n|------|------|\n| CC Inventory | `.a5c/runs/01KNK8KEQCFNM1BTZW931FFXEW/tasks/01KNK8M2MZP6Z1YTCZQ3037SJT/output.json` |\n| Harness Inventory | `.a5c/runs/01KNK8KEQCFNM1BTZW931FFXEW/tasks/01KNK8M2N0GR1WZPYDYP4ZQ8PR/output.json` |\n| Gap Analysis (100 gaps) | `.a5c/runs/01KNK8KEQCFNM1BTZW931FFXEW/tasks/01KNK99FX28B53JE5DVK6S8QXH/output.json` |\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:docs-harness-features-backlog",
      "to": "page:docs-harness-features-backlog-glossary-references",
      "kind": "contains_page"
    }
  ]
}