outcomeA Windows-drive absolute path is refused rather than normalized
spec:extraction.excludes.refused-pathPacks: pack:self-hosting-v1
Design: no design entries · no pinned declarations · no decisions
Findings: no errors, no warnings
specs/extraction/excludes.refused-path.sdp.md
No open questions and no blocking questions; implementation binding none, verifier binding present, and expected-outcome oracle none.
Given
the extraction root carries the tree {excludedTree: "foo"} and the similar sibling {similarTree: "foobar"}
the consumer supplies the exclusion {exclusion: "C:/work/specs"}When
the root is discovered
Then
the discovery attempt {outcome: "is refused"}
the refusal states {diagnostic: "normalizeExcludes: invalid exclusion path"} and names the offending pathComposing needs the script.
Intent
- Execute the refusal rule on an exclusion that cannot name a root-relative prefix.
Behavior
Examples
Given the extraction root carries the tree {excludedTree: "foo"} and the similar sibling {similarTree: "foobar"}
Given the consumer supplies the exclusion {exclusion: "C:/work/specs"}
When the root is discovered
Then the discovery attempt {outcome: "is refused"}
Then the refusal states {diagnostic: "normalizeExcludes: invalid exclusion path"} and names the offending pathVerification
Verifier bindings
- test:protocol.excludes.refused-path · the refused-path point verifies the malformed-exclusion refusal · anchored · test anchor binding present ·
test/self-hosting-extraction.test.ts:300External run evidence from
test/self-hosting-extraction.test.tsTest anchors:
test:protocol.build-pipeline.same-invocation,test:protocol.example-runner.red-step-naming,test:protocol.example-runner.step-order,test:protocol.excludes.refused-path,test:protocol.excludes.segment-boundary,test:protocol.executable-contracts.case-colliding-path,test:protocol.executable-contracts.concreteness-refusal,test:protocol.executable-contracts.multi-entry-example,test:protocol.schema-versioning.declared-version. Specs verified by those bindings: spec:extraction.build-pipeline, spec:extraction.build-pipeline.same-invocation, spec:extraction.example-runner, spec:extraction.example-runner.red-step-naming, spec:extraction.example-runner.step-order, spec:extraction.excludes, spec:extraction.excludes.refused-path, spec:extraction.excludes.segment-boundary, spec:extraction.executable-contracts, spec:extraction.executable-contracts.case-colliding-path, spec:extraction.executable-contracts.concreteness-refusal, spec:extraction.executable-contracts.multi-entry-example, spec:extraction.schema-versioning, spec:extraction.schema-versioning.declared-version.Run 1: external run evidence from vitest 4.1.10
Build: CI 380 · Branch: feature/roadmap-and-slices-v0 · Commit: 34909918bf0be0e849959644401797191cae379f · Start: 2026-10-22T17:40:31.456Z · Stop: 2026-10-22T17:42:16.171Z
Name Suite Result Duration executes the bound example against a fresh world One query invocation shares its extracted graph and validation result (spec:extraction.build-pipeline.same-invocation) passed 13.53 ms executes the bound example against a fresh world A prefix excludes its own tree and leaves a similar sibling standing (spec:extraction.excludes.segment-boundary) passed 1.19 ms executes the bound example against a fresh world A Windows-drive absolute path is refused rather than normalized (spec:extraction.excludes.refused-path) passed 0.66 ms executes the bound example against a fresh world A derived payload carries a schema version its consumer can read (spec:extraction.schema-versioning.declared-version) passed 0.42 ms executes the bound example against a fresh world An unbound slot in a used step earns no step contract (spec:extraction.executable-contracts.concreteness-refusal) passed 1.07 ms executes the bound example against a fresh world A second structured entry is named, never left silently inert (spec:extraction.executable-contracts.multi-entry-example) passed 1.8 ms executes the bound example against a fresh world A case-only path collision withholds the whole contracts tree (spec:extraction.executable-contracts.case-colliding-path) passed 0.7 ms executes the bound example against a fresh world A repeated step runs its one handler at each occurrence, in contract order (spec:extraction.example-runner.step-order) passed 0.32 ms executes the bound example against a fresh world A red step names itself before the assertion detail (spec:extraction.example-runner.red-step-naming) passed 0.33 ms
Design view
Requirement drawing
- Satisfying or referencing units: no recorded binding.
The diagram as text
- spec:extraction.excludes.refused-path: A Windows-drive absolute path is refused rather than normalized · declared Spec
- spec:extraction.excludes: Extraction exclusions are strict consumer input · declared Spec
- test:protocol.excludes.refused-path: the refused-path point verifies the malformed-exclusion refusal · anchored test binding · binding present ·
test/self-hosting-extraction.test.ts:300 - spec:extraction.excludes.refused-path refines spec:extraction.excludes · declared
- spec:extraction.excludes.refused-path verifies spec:extraction.excludes · declared
- test:protocol.excludes.refused-path verifies spec:extraction.excludes.refused-path · anchored
Mermaid source
Copyable source; the Studio draws static SVG.
Preferred and chosen syntax: requirementDiagram; exact refines, satisfies and verifies, with claim words in nodes and per-edge comments.
Decisions
No decision record named.
Runtime
No implementation neighborhood recorded.
Runtime observation: not tracked.
Evidence
Runtime observation: not tracked.
Build attestations: not tracked.
Deployments: not tracked.
Bills of materials: not tracked.
Impact
- E2: verifies · declared
The diagram as text
- spec:extraction.excludes: Extraction exclusions are strict consumer input
- spec:extraction.excludes.refused-path: A Windows-drive absolute path is refused rather than normalized
- spec:extraction.excludes.refused-path refines spec:extraction.excludes · declared
- spec:extraction.excludes.refused-path verifies spec:extraction.excludes · declared
Mermaid source
Copyable source; the Studio draws static SVG.
Preferred syntax: flowchart. Chosen syntax: labelled flowchart, preserving exact relations, claims and folds.
Rests on
- refines · spec:extraction.excludes · stated ready, floor ready
Rested on by
No Spec rests on this Spec.
Relations
| Relation and direction | Other end | Claim | Reason | Exercised keys |
|---|---|---|---|---|
| refines · outgoing | Extraction exclusions are strict consumer inputspec:extraction.excludes · resolves | declared | None | None |
| verifies · outgoing | Extraction exclusions are strict consumer inputspec:extraction.excludes · resolves | declared | None | refusedPaths |
Bindings
Implementation binding: none
Design reference: none
Verifier binding: present
- test:protocol.excludes.refused-path · the refused-path point verifies the malformed-exclusion refusal · anchored ·
test/self-hosting-extraction.test.ts:300· test anchor
Expected-outcome oracle: none
Runtime observation: not tracked.
Run results: not recorded in the graph.
Findings
None.
Composing (0)
Composing needs the script.