statecraft.
Catalog/spec-spine

013-edge-paths-grammar-sugar

Edge grammar: `paths:` list sugar on extends/refines items

Lifecycle approvedImplementation completeVerification unknownQualification unknown

Authoring sugar for the predecessor dialect: an `extends:` or `refines:` item may declare `paths: [<file>, ...]` instead of a single `unit:`; the compiler expands each path to a file unit at parse time, emitting N normalized single-unit edges into the registry. Consumers see exactly one edge shape -- `paths:` never reaches registry.json. `unit:` and `paths:` on the same item is malformed (V-002). Unblocks adopting a corpus authored in the OAP dialect (140+ extends-bearing specs) without a mass frontmatter migration.

Read the full pinned specification ↗

Relationships

Claimed units

  • extends
    {
  "nature": "additive",
  "spec": "000-spec-spine-bootstrap",
  "unit": {
    "kind": "file",
    "path": "crates/spec-spine-types/src/edges.rs"
  }
}
  • extends
    {
  "nature": "additive",
  "spec": "001-compile-registry",
  "unit": {
    "kind": "file",
    "path": "crates/spec-spine-core/src/compile.rs"
  }
}
  • extends
    {
  "nature": "additive",
  "spec": "000-spec-spine-bootstrap",
  "unit": {
    "kind": "file",
    "path": "crates/spec-spine-types/src/frontmatter.rs"
  }
}
  • extends
    {
  "nature": "additive",
  "spec": "000-spec-spine-bootstrap",
  "unit": {
    "kind": "file",
    "path": "crates/spec-spine-types/tests/grammar.rs"
  }
}
  • extends
    {
  "nature": "additive",
  "spec": "001-compile-registry",
  "unit": {
    "kind": "file",
    "path": "crates/spec-spine-core/tests/compile.rs"
  }
}

Source headings

  1. 013: `paths:` list sugar on extends/refines items
  2. 1. Purpose
  3. 2. Territory
  4. 3. Behavior
  5. 3.1 Accepted forms
  6. 3.2 Normalization (the sugar never escapes)
  7. 3.3 Equivalence guarantee
  8. 3.4 Tests (minimum)
  9. 4. Out of scope

Frozen anchors

No frozen anchors declared.