Contracts

config-schema-delta.md

Contract Delta — org-pack config schema (subdir)

Target contract file (FR-008): kitty-specs/layered-doctrine-org-layer-01KRNPEE/contracts/config-schema.yaml (currently additionalProperties: false on each pack item, with no subdir).

.kittify/config.yaml — canonical shape (doctrine.org.packs[])

doctrine:
  org:
    packs:
      - name: my-pack
        source_type: git
        url: ssh://git@example.com/org/repo.git
        ref: main
        local_path: .doctrine-cache/repo   # clone root (unchanged)
        subdir: pack                        # NEW — effective pack root = .doctrine-cache/repo/pack

Field contract

PropertyTypeRequiredRule
subdirstringnoRelative path beneath local_path. Rejected: absolute (incl. Windows/UNC), any .. component. ./empty ≡ absent. Effective pack root = local_path / subdir. Clone target stays local_path (C-003).

Behavioral contract (acceptance anchors)

  • OrgPackConfig.effective_root(repo_root) returns local_path/subdir when set, else repo-root-normalized local_path (FR-001/FR-002).
  • A git-sourced pack with org-charter.yaml + drg/fragment.yaml under pack/ and subdir: pack → doctor doctrine reports healthy (SC-001).
  • doctrine fetch reports artifact count at the effective root; a wrong subdir → "0 artifacts" at fetch (SC-003/FR-007).
  • Round-trip: write→read preserves subdir; absent emits no subdir: key (FR-005), on both canonical and legacy inline shapes (FR-006).
  • Escape inputs → structured operator-visible error, not "no org packs" degradation (FR-003).