I.
Wiki article
Reading · 2 minprocess/gaps/GAP-L1-P1-repo-graph-session-lifecycle-semantics
GAP-L1-P1-repo-graph-session-lifecycle-semantics reference
The repo defines two per-AgentVersion semantics nodes:
Continue reading
Nearby pages in the same section.
GAP-L1-P0-claude-code-plugin-component-typesGAP-L1-P0-claude-models-pricing-and-lineupGAP-L1-P0-mcp-spec-2025-11-25GAP-L1-P1-adaptive-thinking-vs-extended-thinkingGAP-L1-P1-anthropic-skills-vs-claude-code-skillsGAP-L1-P1-cursor-profiles-and-modesGAP-L1-P1-mcp-elicitation-and-resource-linksGAP-L1-P1-mcp-oauth-resource-serverGAP-L1-P1-repo-graph-discovery-signalGAP-L1-P2-gemini-2-5-and-3GAP-L1-P2-mcp-stdio-vs-http-sse-deprecationGAP-L1-P2-openai-codex-and-responses-apiGAP-L1-P2-repo-graph-cisurface-packagesurfaceGAP-L1-P2-repo-graph-pluginartifactGAP-L1-P3-benchmarks-staleGAP-L2-P0-pathdescriptor-undeclared-but-referencedGAP-L2-P1-edge-kinds-md-vs-yaml-parityGAP-L2-P1-mcptransport-status-attribute-undeclaredGAP-L2-P2-cluster-count-mismatchGAP-L2-P2-coverage-checklist-internal-broken-refsGAP-L2-P2-versionrange-attribute-on-modelversion
GAP-L1-P1-repo-graph-session-lifecycle-semantics
| Field | Value |
|---|---|
| id | gap:repo-graph-session-lifecycle-semantics |
| title | SessionSemantics + LifecycleSemantics NodeKinds from repo absent in v6 schema |
| level | 1 |
| priority | P1 |
| discoveredAt | 2026-04-28T00:00:00Z |
| source | packages/agent-catalog/graph/schema/ontology-schema.yaml |
| status | open |
| owner | tbd |
Current state
The repo defines two per-AgentVersion semantics nodes:
SessionSemantics—sessionDirStrategy,sessionIdSources,resumeSemanticsLifecycleSemantics—runtimeHookMode,stopHookMode,backgroundTaskMode,checkpointMode
v6 schema has SessionModel (cluster 3) but no LifecycleSemantics analog. The persistence/control-plane/structured-transport triple in v6 covers session storage but not these per-product behavioral switches (e.g. "does this agent block on stop hooks?", "can it spawn background tasks?").
Desired state
- Either extend
SessionModelwith the missing fields (sessionIdSources,resumeSemantics) or add a siblingSessionSemanticsNodeKind. - Add new NodeKind
LifecycleSemanticswith the four-attribute set, edgeAgentVersion uses_lifecycle_semantics LifecycleSemantics. - Required for accurate cross-harness behavioral comparison (which is exactly what coverage-checklist row "Per-product comparison-table fields (Vendor, Layers, Surface, Plugin formats, MCP, Hooks, Execution typical, Sandbox default, Resume, Fork)" claims is derivable).
Evidence
- packages/agent-catalog/graph/schema/ontology-schema.yaml (lines 183-201)
Propagation status
- Level 1: open
- Level 2: not-started — coverage-checklist OpenQuestion
oq:repo-22-nodekinds-mapping
Propagation chain
- Level 1: 1 NodeKind extension + 1 new NodeKind.
- Level 2: updates to lifecycle.md and agent-stack.md node-kind specs.
Notes
Resolves second slice of "live 22 NodeKinds vs v6" OpenQuestion.