{
  "id": "page:process-gaps-GAP-L1-P2-repo-graph-cisurface-packagesurface",
  "_kind": "Page",
  "_file": "wiki/process/gaps/GAP-L1-P2-repo-graph-cisurface-packagesurface.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "title": "GAP-L1-P2-repo-graph-cisurface-packagesurface",
    "displayName": "GAP-L1-P2-repo-graph-cisurface-packagesurface",
    "slug": "process/gaps/GAP-L1-P2-repo-graph-cisurface-packagesurface",
    "articlePath": "wiki/process/gaps/GAP-L1-P2-repo-graph-cisurface-packagesurface.md",
    "article": "# GAP-L1-P2-repo-graph-cisurface-packagesurface\n\n| Field | Value |\n|---|---|\n| id | gap:repo-graph-cisurface-packagesurface |\n| title | CiSurface, PackageSurface, PathDescriptor — repo NodeKinds for build/release surfaces absent in v6 |\n| level | 1 |\n| priority | P2 |\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\nRepo defines:\n- `PackageSurface` (npm package metadata: workspacePath, moduleType, surfaceKinds, sourceOfTruthRole)\n- `CiSurface` (scripts, publishStrategy, releaseChannels, validationCommands)\n- `PathDescriptor` (path, pathKind, ownerKind, ownerId, platform)\n\nv6 has `ProcessDescriptor` (cluster 11) — partially overlaps with `PackageSurface` but doesn't include CI fields or release channels. `PathDescriptor` is referenced multiple times in coverage-checklist (e.g. \"Run dir layout PathDescriptor per file\") but no NodeKind by that name exists in v6 ontology-schema.yaml.\n\n## Desired state\n- Add `PathDescriptor` NodeKind (called out by coverage-checklist but missing — internal contradiction).\n- Either extend `ProcessDescriptor` with CI fields or add `CiSurface` sibling NodeKind.\n- Add `PackageSurface` (or merge into ProcessDescriptor with new attributes `moduleType`, `sourceOfTruthRole`).\n\n## Evidence\n- packages/agent-catalog/graph/schema/ontology-schema.yaml (lines 212-247)\n- C:/work/v6/graph/coverage-checklist.md (multiple rows reference `PathDescriptor`)\n\n## Propagation status\n- Level 1: open\n- Level 2: not-started — coverage-checklist has internally-inconsistent `PathDescriptor` references\n\n## Propagation chain\n- Level 1: 1 missing NodeKind + 1 ProcessDescriptor extension OR 2 sibling NodeKinds.\n- Level 2: catalog-meta.md / sourceref-and-scope.md updates.\n\n## Notes\nInternal-consistency fix: schema mentions PathDescriptor as if it exists; it does not.\n",
    "documents": []
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "page:process-gaps",
      "to": "page:process-gaps-GAP-L1-P2-repo-graph-cisurface-packagesurface",
      "kind": "contains_page"
    }
  ]
}