iiRecord
Agentic AI Atlas · GAP-L1-P2-repo-graph-cisurface-packagesurface
page:process-gaps-GAP-L1-P2-repo-graph-cisurface-packagesurfacea5c.ai
II.
Page reference

page:process-gaps-GAP-L1-P2-repo-graph-cisurface-packagesurface

Reading · 2 min

GAP-L1-P2-repo-graph-cisurface-packagesurface reference

Repo defines:

Pagewiki/process/gaps/GAP-L1-P2-repo-graph-cisurface-packagesurface.mdOutgoing · 0Incoming · 1

GAP-L1-P2-repo-graph-cisurface-packagesurface

FieldValue
idgap:repo-graph-cisurface-packagesurface
titleCiSurface, PackageSurface, PathDescriptor — repo NodeKinds for build/release surfaces absent in v6
level1
priorityP2
discoveredAt2026-04-28T00:00:00Z
sourcepackages/agent-catalog/graph/schema/ontology-schema.yaml
statusopen
ownertbd

Current state

Repo defines:

  • PackageSurface (npm package metadata: workspacePath, moduleType, surfaceKinds, sourceOfTruthRole)
  • CiSurface (scripts, publishStrategy, releaseChannels, validationCommands)
  • PathDescriptor (path, pathKind, ownerKind, ownerId, platform)

v6 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.

Desired state

  • Add PathDescriptor NodeKind (called out by coverage-checklist but missing — internal contradiction).
  • Either extend ProcessDescriptor with CI fields or add CiSurface sibling NodeKind.
  • Add PackageSurface (or merge into ProcessDescriptor with new attributes moduleType, sourceOfTruthRole).

Evidence

  • packages/agent-catalog/graph/schema/ontology-schema.yaml (lines 212-247)
  • C:/work/v6/graph/coverage-checklist.md (multiple rows reference PathDescriptor)

Propagation status

  • Level 1: open
  • Level 2: not-started — coverage-checklist has internally-inconsistent PathDescriptor references

Propagation chain

  • Level 1: 1 missing NodeKind + 1 ProcessDescriptor extension OR 2 sibling NodeKinds.
  • Level 2: catalog-meta.md / sourceref-and-scope.md updates.

Notes

Internal-consistency fix: schema mentions PathDescriptor as if it exists; it does not.