Skip to content

CAK-04: Git-Z Path Facts Scanner Prototype #32

Description

@skulmakov-oss

Parent tracker: #28
Depends on: #31

CAK-04: Git-Z Path Facts Scanner Prototype

Purpose

Create the first byte parser for Git-Z path facts in the Cerebral Admission Kernel track.

The goal is to read NUL-delimited Git path output as bytes and produce deterministic path facts for later scope checks.

Scope

The prototype should parse byte input and produce path facts for common file states:

  • added;
  • modified;
  • deleted;
  • renamed;
  • untracked.

The parser should preserve path bytes and avoid treating paths as UTF-8 text in the hot path.

Expected implementation direction

Possible module:

  • crates/ccl-core/src/axon_git.rs

Possible concepts:

  • PathFact
  • PathOperation
  • parse_git_z_path_facts

Names may differ if they fit the codebase.

Required tests

  • modified path;
  • added path;
  • deleted path;
  • untracked path;
  • renamed old/new path;
  • path with spaces;
  • byte path that is not valid UTF-8;
  • malformed or incomplete record behavior is deterministic.

Explicit non-goals

  • No Git command execution in this seed.
  • No current scope checker replacement.
  • No admission authority change.
  • No unified diff parser.
  • No SIMD.
  • No parallelism.
  • No regex.
  • No GitHub CI as evidence.

Acceptance criteria

Close this issue when a PR is merged that adds a focused Git-Z path facts parser with tests, keeps existing gate behavior unchanged, and does not replace current scope or admission authority.

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions