{
  "id": "page:process-gaps-GAP-L1-P1-repo-graph-session-lifecycle-semantics",
  "_kind": "Page",
  "_file": "wiki/process/gaps/GAP-L1-P1-repo-graph-session-lifecycle-semantics.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "title": "GAP-L1-P1-repo-graph-session-lifecycle-semantics",
    "displayName": "GAP-L1-P1-repo-graph-session-lifecycle-semantics",
    "slug": "process/gaps/GAP-L1-P1-repo-graph-session-lifecycle-semantics",
    "articlePath": "wiki/process/gaps/GAP-L1-P1-repo-graph-session-lifecycle-semantics.md",
    "article": "# GAP-L1-P1-repo-graph-session-lifecycle-semantics\n\n| Field | Value |\n|---|---|\n| id | gap:repo-graph-session-lifecycle-semantics |\n| title | SessionSemantics + LifecycleSemantics NodeKinds from repo absent in v6 schema |\n| level | 1 |\n| priority | P1 |\n| discoveredAt | 2026-04-28T00:00:00Z |\n| source | packages/agent-catalog/graph/schema/ontology-schema.yaml |\n| status | open |\n| owner | tbd |\n\n## Current state\nThe repo defines two per-AgentVersion semantics nodes:\n- `SessionSemantics` — `sessionDirStrategy`, `sessionIdSources`, `resumeSemantics`\n- `LifecycleSemantics` — `runtimeHookMode`, `stopHookMode`, `backgroundTaskMode`, `checkpointMode`\n\nv6 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?\").\n\n## Desired state\n- Either extend `SessionModel` with the missing fields (`sessionIdSources`, `resumeSemantics`) or add a sibling `SessionSemantics` NodeKind.\n- Add new NodeKind `LifecycleSemantics` with the four-attribute set, edge `AgentVersion uses_lifecycle_semantics LifecycleSemantics`.\n- 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).\n\n## Evidence\n- packages/agent-catalog/graph/schema/ontology-schema.yaml (lines 183-201)\n\n## Propagation status\n- Level 1: open\n- Level 2: not-started — coverage-checklist OpenQuestion `oq:repo-22-nodekinds-mapping`\n\n## Propagation chain\n- Level 1: 1 NodeKind extension + 1 new NodeKind.\n- Level 2: updates to lifecycle.md and agent-stack.md node-kind specs.\n\n## Notes\nResolves second slice of \"live 22 NodeKinds vs v6\" OpenQuestion.\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:process-gaps",
      "to": "page:process-gaps-GAP-L1-P1-repo-graph-session-lifecycle-semantics",
      "kind": "contains_page"
    }
  ]
}