schema

type Edge struct {
	Source string `protobuf:"bytes,1,opt,name=source,proto3" json:"source,omitempty"`
	Target string `protobuf:"bytes,2,opt,name=target,proto3" json:"target,omitempty"`
	Kind   string `protobuf:"bytes,3,opt,name=kind,proto3" json:"kind,omitempty"`
	// Optional call-site coordinates. Per RESEARCH Pitfall 2 / Open Question
	// 3: the Pebble edge KEY (`e/<src>/<kind>/<dst>`, D-03) intentionally
	// omits line/col today, so two call sites between the same (source,
	// kind, target) collapse to one stored edge. That key-identity decision
	// is deferred to Phase 2 extractor design — this record must still be
	// able to CARRY line/col so a future key-shape change (or an
	// annotation/audit trail) doesn't lose the data that's available at
	// extraction time.
	Line int32 `protobuf:"varint,4,opt,name=line,proto3" json:"line,omitempty"`
	Col  int32 `protobuf:"varint,5,opt,name=col,proto3" json:"col,omitempty"`
	// provenance records how this edge was derived. Phase 2 writes only
	// ground-truth values ("ast" or empty) per D-03a; "heuristic" provenance
	// (fuzzy/inferred edges) is Phase 5's addition, not written here.
	Provenance string `protobuf:"bytes,6,opt,name=provenance,proto3" json:"provenance,omitempty"`
	// metadata is an open extension bag for edge-kind-specific extractor
	// annotations that do not warrant their own field yet. Additive schema
	// field (D-03).
	Metadata map[string]string `` /* 143-byte string literal not displayed */
	// contains filtered or unexported fields
}

type ExcludedFile struct {
	Path      string          `protobuf:"bytes,1,opt,name=path,proto3" json:"path,omitempty"`
	Reason    ExclusionReason `protobuf:"varint,2,opt,name=reason,proto3,enum=codegraph.v1.ExclusionReason" json:"reason,omitempty"`
	Detail    string          `protobuf:"bytes,3,opt,name=detail,proto3" json:"detail,omitempty"`
	SizeBytes int64           `protobuf:"varint,4,opt,name=size_bytes,json=sizeBytes,proto3" json:"size_bytes,omitempty"`
	// contains filtered or unexported fields
}

type ExclusionReason int32

type File struct {
	Path string `protobuf:"bytes,1,opt,name=path,proto3" json:"path,omitempty"`
	// content_hash MUST be a collision-resistant hash (SHA-256 — see
	// Security Domain V6 in 01-RESEARCH.md), never a weak hash like MD5.
	// The hash computation itself lands with the Phase 2 indexer; this
	// field only defines its storage shape.
	ContentHash string `protobuf:"bytes,2,opt,name=content_hash,json=contentHash,proto3" json:"content_hash,omitempty"`
	Language    string `protobuf:"bytes,3,opt,name=language,proto3" json:"language,omitempty"`
	NodeCount   int64  `protobuf:"varint,4,opt,name=node_count,json=nodeCount,proto3" json:"node_count,omitempty"`
	EdgeCount   int64  `protobuf:"varint,5,opt,name=edge_count,json=edgeCount,proto3" json:"edge_count,omitempty"`
	// errors records per-file extraction failures (e.g. oversized or
	// unparseable source) so one bad file does not abort the whole index run
	// (RESEARCH Assumptions Log A2, Pitfall 4). Additive extension of D-03's
	// File record.
	Errors []string `protobuf:"bytes,6,rep,name=errors,proto3" json:"errors,omitempty"`
	// mtime_unix_ns is the file's on-disk modification time (nanoseconds
	// since epoch) as observed by the writer. Additive Phase-4 field
	// (D-01a); written by both `index` and `sync` so the incremental sync
	// engine's stat pre-filter can cheaply shortlist changed files before
	// paying for a content_hash recompute.
	MtimeUnixNs int64 `protobuf:"varint,7,opt,name=mtime_unix_ns,json=mtimeUnixNs,proto3" json:"mtime_unix_ns,omitempty"`
	// size_bytes is the file's on-disk size in bytes as observed by the
	// writer. Additive Phase-4 field (D-01a); written by both `index` and
	// `sync` alongside mtime_unix_ns for the same stat pre-filter.
	SizeBytes int64 `protobuf:"varint,8,opt,name=size_bytes,json=sizeBytes,proto3" json:"size_bytes,omitempty"`
	// contains filtered or unexported fields
}

type Meta struct {
	SchemaVersion  uint32 `protobuf:"varint,1,opt,name=schema_version,json=schemaVersion,proto3" json:"schema_version,omitempty"`
	NodeCount      int64  `protobuf:"varint,2,opt,name=node_count,json=nodeCount,proto3" json:"node_count,omitempty"`
	EdgeCount      int64  `protobuf:"varint,3,opt,name=edge_count,json=edgeCount,proto3" json:"edge_count,omitempty"`
	LastSyncUnixMs int64  `protobuf:"varint,4,opt,name=last_sync_unix_ms,json=lastSyncUnixMs,proto3" json:"last_sync_unix_ms,omitempty"`
	Healthy        bool   `protobuf:"varint,5,opt,name=healthy,proto3" json:"healthy,omitempty"`
	HealthMessage  string `protobuf:"bytes,6,opt,name=health_message,json=healthMessage,proto3" json:"health_message,omitempty"`
	// has_file_index reports whether this graph's on-disk store has been
	// populated with the Phase-4 `x/` file-owned secondary index (D-02).
	// Additive Phase-4 field (D-02b); false means a pre-Phase-4 graph that
	// lacks the index, signaling `sync` to perform a one-time full
	// re-index backfill before switching to incremental updates.
	HasFileIndex bool `protobuf:"varint,7,opt,name=has_file_index,json=hasFileIndex,proto3" json:"has_file_index,omitempty"`
	// commit_sha records the git commit the index was built at (Phase 1
	// ENG-04, D-05). Absent or empty means a pre-upgrade graph — one built
	// before this field existed — OR a non-git checkout; consumers must
	// treat it as unknown rather than as an error. Accepted forms are
	// exactly 40 (SHA-1) or 64 (SHA-256) characters of lowercase hex; any
	// other value is never written. This field number is now spent
	// permanently (D-02a): once shipped, field 8 can never be renumbered or
	// reused — retiring it means adding 8 to a `reserved` clause.
	CommitSha string `protobuf:"bytes,8,opt,name=commit_sha,json=commitSha,proto3" json:"commit_sha,omitempty"`
	// has_coverage reports whether this graph's on-disk store has been
	// populated with the Phase-10 `c/` exclusion-reason namespace (D-06).
	// Additive Phase-10 field, following has_file_index's precedent
	// exactly: absent/false means coverage is UNKNOWN — never 0/0, never
	// inferred from `c/` key presence (a repo with genuinely zero
	// exclusions would otherwise be indistinguishable from a pre-Phase-10
	// graph). A store whose Meta lacks this field must re-index to record
	// coverage.
	HasCoverage bool `protobuf:"varint,9,opt,name=has_coverage,json=hasCoverage,proto3" json:"has_coverage,omitempty"`
	// coverage_generation is a monotonically-incrementing counter, bumped by
	// exactly 1 at every one of the same three meta-write sites that stamp
	// has_coverage (Phase 10 WR-01). It replaces last_sync_unix_ms as the
	// page-token generation marker for CoverageRows: a wall-clock,
	// millisecond-resolution marker can alias when two coverage-affecting
	// commits land within the same millisecond, silently defeating the
	// "index changed since the last page fetch" check. A plain integer
	// counter guarantees two distinct writes imply two distinct generations
	// regardless of clock resolution or backward clock steps. Additive
	// Phase-10 field, following has_coverage's own precedent exactly:
	// absent/zero means either a pre-this-fix graph or a graph that has
	// never recorded coverage — CoverageRows' has_coverage short-circuit
	// already refuses to mint a token in that case (D-06), so an unset
	// value here is never observed by a real page token.
	CoverageGeneration int64 `protobuf:"varint,10,opt,name=coverage_generation,json=coverageGeneration,proto3" json:"coverage_generation,omitempty"`
	// contains filtered or unexported fields
}

type Node struct {
	Id            string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	Kind          string `protobuf:"bytes,2,opt,name=kind,proto3" json:"kind,omitempty"`
	Name          string `protobuf:"bytes,3,opt,name=name,proto3" json:"name,omitempty"`
	QualifiedName string `protobuf:"bytes,4,opt,name=qualified_name,json=qualifiedName,proto3" json:"qualified_name,omitempty"`
	FilePath      string `protobuf:"bytes,5,opt,name=file_path,json=filePath,proto3" json:"file_path,omitempty"`
	Language      string `protobuf:"bytes,6,opt,name=language,proto3" json:"language,omitempty"`
	StartLine     int32  `protobuf:"varint,7,opt,name=start_line,json=startLine,proto3" json:"start_line,omitempty"`
	EndLine       int32  `protobuf:"varint,8,opt,name=end_line,json=endLine,proto3" json:"end_line,omitempty"`
	StartCol      int32  `protobuf:"varint,9,opt,name=start_col,json=startCol,proto3" json:"start_col,omitempty"`
	EndCol        int32  `protobuf:"varint,10,opt,name=end_col,json=endCol,proto3" json:"end_col,omitempty"`
	// signature is the extractor-rendered parameter/return signature string
	// (e.g. "func(a int, b string) error"). Additive schema field (D-03);
	// written by the Phase 2 goextract symbol pass.
	Signature string `protobuf:"bytes,11,opt,name=signature,proto3" json:"signature,omitempty"`
	// docstring is the leading comment/doc block attached to the symbol, as
	// captured verbatim by the extractor. Additive schema field (D-03);
	// written by the Phase 2 goextract symbol pass.
	Docstring string `protobuf:"bytes,12,opt,name=docstring,proto3" json:"docstring,omitempty"`
	// visibility is the language-level access modifier ("public", "private",
	// "package", etc.) as classified by the extractor. Additive schema
	// field (D-03); written by the Phase 2 goextract symbol pass.
	Visibility string `protobuf:"bytes,13,opt,name=visibility,proto3" json:"visibility,omitempty"`
	// is_exported reports whether the symbol crosses the package/module
	// boundary (Go: identifier starts uppercase). Additive schema field
	// (D-03); written by the Phase 2 goextract symbol pass.
	IsExported bool `protobuf:"varint,14,opt,name=is_exported,json=isExported,proto3" json:"is_exported,omitempty"`
	// return_type is the extractor-rendered return type string, when the
	// symbol kind has one (function/method). Additive schema field
	// (D-03); written by the Phase 2 goextract symbol pass.
	ReturnType string `protobuf:"bytes,15,opt,name=return_type,json=returnType,proto3" json:"return_type,omitempty"`
	// contains filtered or unexported fields
}