brief-spec 0.5.0__py3-none-any.whl

brief_spec/__init__.py

@@ -0,0 +1,15 @@
+"""Canonical Brief-Spec package.
+
+The implementation remains import-compatible with the historical ``briefspec``
+package throughout the 0.x line.  Sharing the legacy package search path makes
+``brief_spec.<module>`` imports resolve to the same dependency-free sources
+without maintaining two divergent implementations.
+"""
+
+from __future__ import annotations
+
+from briefspec import __path__ as _legacy_path
+from briefspec import __version__
+
+__all__ = ["__version__"]
+__path__ = _legacy_path

brief_spec/__main__.py

@@ -0,0 +1,5 @@
+from __future__ import annotations
+
+from brief_spec.cli import main
+
+raise SystemExit(main())

brief_spec-0.5.0.dist-info/METADATA

@@ -0,0 +1,577 @@
+Metadata-Version: 2.5
+Name: brief-spec
+Version: 0.5.0
+Summary: Type-aware, evidence-backed delivery contracts for AI coding harnesses.
+Project-URL: Homepage, https://github.com/luanmorenommaciel/brief-spec
+Project-URL: Repository, https://github.com/luanmorenommaciel/brief-spec
+Project-URL: Issues, https://github.com/luanmorenommaciel/brief-spec/issues
+Author: Luan Moreno Maciel
+License: MIT License
+        
+        Copyright (c) 2026 Luan Moreno Maciel
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: agents,brief-spec,claude,codex,copilot,developer-tools,productivity
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# Brief-Spec
+
+<p align="center">
+  <img src="assets/lockup-hero.png" alt="BRIEF-SPEC — Different agents in. One predictable human handoff out." width="100%">
+</p>
+
+<p align="center"><strong>Different agents in. One predictable human handoff out.</strong></p>
+
+Brief-Spec is a type-aware, evidence-backed delivery contract for AI coding harnesses. Same fields, same order, preserved evidence. It does not make every answer shorter; it makes every important answer legible. Brief-Spec standardizes the explanation and handoff, not the agent's reasoning. It never calls a model.
+
+<p align="center">
+  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.11%2B-A56BFF?labelColor=111720" alt="Python 3.11+"></a>
+  <a href="https://github.com/luanmorenommaciel/brief-spec/releases/tag/v0.2.0"><img src="https://img.shields.io/badge/public_release-v0.2.0-070A0F?labelColor=111720" alt="Public release v0.2.0"></a>
+  <a href="docs/verification.md"><img src="https://img.shields.io/badge/source_candidate-0.5.0-29313A?labelColor=111720" alt="Source candidate 0.5.0"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-29313A?labelColor=111720" alt="MIT License"></a>
+</p>
+
+**Public release v0.2.0** · Source candidate 0.5.0 · Not on PyPI
+
+- Public release: `v0.2.0` on GitHub.
+- Source candidate: `v0.5.0` in this checkout. Locally verified is not hosted or published.
+
+[The problem](#the-problem) · [How it works](#how-it-works) · [Outcome Brief](#outcome-brief) · [Docs](#documentation) · [Skills](#why-the-skills-exist) · [Harness](#harness-support) · [CLI](#cli) · [Install](#install)
+
+---
+
+## The problem
+
+Good agent output can still be exhausting to consume.
+
+Once several agents are running, generation is no longer the only bottleneck. Re-entry becomes the bottleneck. One response begins with a narrative. Another hides the decision below a test log. A third mixes completed work, caveats, and suggested work into the same paragraph.
+
+Before acting, you must first discover how to read the answer.
+
+![The same engineering session without Brief-Spec as a dense, irregular chat and with Brief-Spec as a calm, consistently structured handoff.](assets/briefspec-before-after.png)
+
+Brief-Spec makes that last mile predictable. It keeps the agent's full work available while giving the human handoff a stable shape.
+
+![Scattered session evidence flows into a Brief-Spec Outcome Brief and emerges as three directly answered human questions, while proof and unresolved boundaries remain visible.](assets/briefspec-output-comparison.png)
+
+---
+
+## How it works
+
+<p align="center">
+  <img src="assets/flow.png" alt="How Brief-Spec works — host task through adapter, local type classification, and type-specific explanation; at a boundary a Checkpoint (Orient, Teach, or Spoken) or an Outcome Brief becomes a canonical delivery object and verified downloads, with inspectable proof from a repository, command, test, URL, or artifact." width="100%">
+</p>
+
+<details>
+<summary>View diagram source</summary>
+
+```mermaid
+%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#111720', 'primaryTextColor': '#F5F2EA', 'primaryBorderColor': '#A56BFF', 'lineColor': '#29313A', 'secondaryColor': '#070A0F', 'tertiaryColor': '#29313A', 'background': '#070A0F', 'mainBkg': '#111720', 'nodeBorder': '#A56BFF', 'clusterBkg': '#111720', 'titleColor': '#F5F2EA', 'edgeLabelBackground': '#111720'}}}%%
+flowchart LR
+    A["Host task"] --> B["Harness adapter"]
+    B --> C["Local type classification"]
+    C --> D["Type-specific explanation"]
+    D --> E{"Eligible and at a boundary?"}
+    E -->|"Checkpoint"| F["Orient, Teach, or Spoken Brief"]
+    E -->|"Agent stopping"| G["Outcome Brief"]
+    F --> H["Canonical delivery object"]
+    G --> H
+    H --> I["Verified downloads"]
+    J["Repository, command, test, URL, or artifact"] -. "inspectable proof" .-> I
+
+    style A fill:#111720,stroke:#29313A,color:#F5F2EA
+    style B fill:#111720,stroke:#29313A,color:#F5F2EA
+    style C fill:#111720,stroke:#29313A,color:#F5F2EA
+    style D fill:#111720,stroke:#29313A,color:#F5F2EA
+    style E fill:#29313A,stroke:#A56BFF,color:#F5F2EA
+    style F fill:#111720,stroke:#29313A,color:#F5F2EA
+    style G fill:#A56BFF,stroke:#A56BFF,color:#F5F2EA
+    style H fill:#111720,stroke:#A56BFF,color:#F5F2EA
+    style I fill:#111720,stroke:#29313A,color:#F5F2EA
+    style J fill:#111720,stroke:#29313A,color:#F5F2EA
+```
+
+</details>
+
+The host integrations normalize lifecycle events when the host provides them: session start, user prompt, tool use, pre-compaction, agent stop, and session end.
+
+Brief-Spec records bounded operational state, applies eligibility and cooldown rules, and injects guidance at the next available boundary. Full guidance arrives once per context window; later prompts get a one-line reminder with the exact typed marker. Background task notifications, system reminders, and hook feedback are ignored as host text. A valid Outcome Brief closes the task, so the next request is classified afresh. Hooks fail open: an internal Brief-Spec error is reported to standard error and the host receives an empty decision rather than a blocked session.
+
+---
+
+## Outcome Brief
+
+A stable end-of-task contract. Seven fields, fixed order, five honest statuses.
+
+<p align="center">
+  <img src="assets/contract.png" alt="Outcome Brief seven-field contract in order — Status, Outcome, Human action, Proof, Gaps, Next, Open — with Outcome in Ion Violet. Statuses: DONE, REVIEW, DECIDE, BLOCKED, FAILED." width="100%">
+</p>
+
+<details>
+<summary>View diagram source</summary>
+
+```mermaid
+%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#111720', 'primaryTextColor': '#F5F2EA', 'primaryBorderColor': '#A56BFF', 'lineColor': '#29313A', 'secondaryColor': '#070A0F', 'tertiaryColor': '#29313A', 'background': '#070A0F', 'mainBkg': '#111720', 'nodeBorder': '#A56BFF', 'clusterBkg': '#111720', 'titleColor': '#F5F2EA', 'edgeLabelBackground': '#111720'}}}%%
+flowchart LR
+    S["Status"] --> O["Outcome"]
+    O --> H["Human action"]
+    H --> P["Proof"]
+    P --> G["Gaps"]
+    G --> N["Next"]
+    N --> X["Open"]
+
+    style S fill:#111720,stroke:#29313A,color:#F5F2EA
+    style O fill:#A56BFF,stroke:#A56BFF,color:#F5F2EA
+    style H fill:#111720,stroke:#29313A,color:#F5F2EA
+    style P fill:#111720,stroke:#29313A,color:#F5F2EA
+    style G fill:#111720,stroke:#29313A,color:#F5F2EA
+    style N fill:#111720,stroke:#29313A,color:#F5F2EA
+    style X fill:#111720,stroke:#29313A,color:#F5F2EA
+```
+
+</details>
+
+### The contract
+
+```text
+Status → Outcome → Human action → Proof → Gaps → Next → Open
+```
+
+| Status | Meaning | Constraints |
+| --- | --- | --- |
+| `DONE` | Requested outcome achieved and directly verified | No required action, no unresolved gaps |
+| `REVIEW` | Implementation ready for human inspection | Requires human action |
+| `DECIDE` | A meaningful choice is required | Requires human action and an open decision |
+| `BLOCKED` | External dependency prevents continuation | Requires a gap and a next action |
+| `FAILED` | The attempt did not achieve the requested outcome | Requires a gap and a next action |
+
+### Example
+
+```markdown
+<!-- briefspec:outcome:v1 -->
+## Outcome Brief
+
+Status: REVIEW
+Outcome: The Copilot plugin, project bridge, and hook adapter are implemented.
+Human action: Review the generated repository files before enabling the cloud hook.
+
+Proof:
+- [direct/info] `.github/plugin/marketplace.json` — declares the Copilot plugin source
+- [direct/pass] `brief-spec doctor copilot --scope project --probe` → synthetic hook passed
+
+Gaps:
+- An authenticated Copilot cloud run has not been observed in this environment.
+
+Next:
+- Run the cloud acceptance scenario and retain its run URL.
+
+Open:
+- Whether cloud checkpoints should persist beyond the job.
+<!-- /briefspec -->
+```
+
+Proof items are prefixed `[direct|derived|reported]/[pass|fail|info]`. See [`schemas/`](schemas/) for the machine-readable contracts.
+
+A `DONE` result with nothing left for the human may use the compact form, which keeps only Status, Outcome, and Proof. Brief-Spec reads the missing fields as `None`, so the canonical object is the same as the full form. Every other status needs all seven fields.
+
+```markdown
+<!-- briefspec:outcome:v1 -->
+## Outcome Brief
+
+Status: DONE
+Outcome: The parser now accepts empty input.
+Proof: [direct/pass] `uv run pytest tests/test_parser.py` → 12 passed
+<!-- /briefspec -->
+```
+
+---
+
+## Documentation
+
+| Topic | Link |
+| --- | --- |
+| Changelog | [CHANGELOG.md](CHANGELOG.md) |
+| Skills reference | [docs/skills.md](docs/skills.md) |
+| Installation | [docs/installation.md](docs/installation.md) |
+| Configuration | [docs/configuration.md](docs/configuration.md) |
+| Architecture | [docs/architecture.md](docs/architecture.md) |
+| Behavior examples | [docs/examples.md](docs/examples.md) |
+| Human Continuity | [docs/human-continuity.md](docs/human-continuity.md) |
+| Repository layout | [docs/repository-layout.md](docs/repository-layout.md) |
+| Verified delivery | [docs/delivery.md](docs/delivery.md) |
+| Compatibility | [docs/compatibility.md](docs/compatibility.md) |
+| Verification record | [docs/verification.md](docs/verification.md) |
+| Design theory | [docs/theory.md](docs/theory.md) |
+| Brand assets | [assets/ASSETS.md](assets/ASSETS.md) |
+| Contributing | [CONTRIBUTING.md](CONTRIBUTING.md) |
+| Security | [SECURITY.md](SECURITY.md) |
+
+---
+
+## Why the skills exist
+
+The CLI validates. The skills are how a chat agent finds the contract.
+
+<table>
+<thead>
+<tr>
+<th>Skill</th>
+<th>Why it exists</th>
+<th>When / not</th>
+<th>Gate</th>
+<th>Optional?</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>brief-spec</code></td>
+<td>Classify substantive work and shape the full explanation for the selected profile</td>
+<td>
+<strong>When</strong> a task begins or clearly pivots; when the user asks Brief-Spec to explain work; or when a lifecycle hook supplies a type decision.<br>
+<strong>Not</strong> sending task text to another model or network; inventing Grok classification metadata.
+</td>
+<td><code>brief-spec classify</code></td>
+<td>No</td>
+</tr>
+<tr>
+<td><code>outcome-brief</code></td>
+<td>Close substantive work with a consistently ordered, evidence-backed handoff</td>
+<td>
+<strong>When</strong> a task reaches a terminal outcome; when the user asks what shipped, what changed, what needs attention, or what happens next; or when a host hook requests a valid outcome.<br>
+<strong>Not</strong> turning formatting into proof; claiming DONE with required action or unresolved gaps.
+</td>
+<td><code>brief-spec validate outcome</code></td>
+<td>No</td>
+</tr>
+<tr>
+<td><code>session-checkpoint</code></td>
+<td>Re-orient a long, dense, or interruption-prone session without replacing the underlying evidence</td>
+<td>
+<strong>When</strong> the user asks for a recap, orientation, teaching explanation, or spoken summary; many turns or tool calls; before compaction; or a hook says a checkpoint is eligible.<br>
+<strong>Not</strong> treating spoken mode as audio generation; claiming the checkpoint is canonical project memory; silently ingesting into Nexo or Obsidian.
+</td>
+<td><code>brief-spec validate checkpoint</code></td>
+<td>No</td>
+</tr>
+</tbody>
+</table>
+
+### Eight work types
+
+Each type has an ordered explanation profile loaded by the `brief-spec` router.
+
+| Type | Explanation order |
+| --- | --- |
+| `general` | Answer, rationale, next action |
+| `exploration` | Question, system map, entry points, flow, unknowns, next probe |
+| `review` | Scope, verdict, findings, risk, validation, recommendation |
+| `implementation` | Intent, changes, resulting behavior, verification, tradeoffs |
+| `debugging` | Symptom, root cause, fix, regression protection, residual risk |
+| `planning` | Goal, decisions, approach, sequence, gates |
+| `research` | Question, synthesis, evidence quality, limitations, recommendation |
+| `operations` | Event, impact, current state, actions, recovery, follow-up |
+
+### Four reading experiences
+
+| Experience | Purpose |
+| --- | --- |
+| **Outcome** | Terminal handoff: what is true, what requires the human, what proves the claim |
+| **Orient** | 30–45 second operational scan: where we are, what changed, next move |
+| **Teach** | Plain-language mental model: what we did, why it works, example, watch-outs |
+| **Spoken** | 80–240 word sequential script designed to be heard |
+
+---
+
+## Harness support
+
+`brief-spec setup` installs skills and lifecycle hooks for each harness. Project destinations vary by host.
+
+| Harness | Status | Command | Project destination |
+| --- | --- | --- | --- |
+| Codex | Required | `brief-spec setup codex` | `.codex/`, `.agents/skills/` |
+| Claude Code | Required | `brief-spec setup claude` | `.claude/` |
+| OMP | Required | `brief-spec setup omp` | `.omp/` |
+| Grok Build | Required | `brief-spec setup grok` | `.grok/` |
+| Kimi Code | Required | `brief-spec setup kimi` | `.kimi-code/skills/` (skills only) |
+| Copilot | Experimental | `brief-spec setup copilot --scope project` | `.agents/skills/`, `.github/` |
+| Cursor Agent | Experimental | `brief-spec setup cursor` | `.cursor/` |
+| Goose | Experimental | `brief-spec setup goose` | `.agents/skills/`, `.goose/` |
+
+The five required harnesses pass the live host matrix recorded in the [verification record](docs/verification.md). Copilot, Cursor Agent, and Goose are experimental: they install and pass a synthetic hook probe, but no live host gate covers them. Kimi lifecycle hooks exist only in the user-wide plugin, so a Kimi project install adds skills only.
+
+Codex runs a hook only after you approve it in `/hooks`, and `codex exec` skips unapproved hooks without an error. `brief-spec doctor codex` reports which Brief-Spec hooks are approved.
+
+Project-scoped Copilot installation also creates the network-free bridge used by Copilot cloud coding agents:
+
+```text
+.agents/skills/{brief-spec,outcome-brief,session-checkpoint}/
+.github/brief-spec/brief-spec.pyz
+.github/hooks/brief-spec.json
+.github/instructions/brief-spec.instructions.md
+```
+
+The installer merges lifecycle hooks instead of replacing the host file, refuses to overwrite foreign skill files, restores prior files if installation fails, and records what it owns.
+
+A `.claude-plugin/` directory is present in this repository for local plugin development.
+
+---
+
+## CLI
+
+### First journey
+
+The public `v0.2.0` release predates the commands below. It installs only the `briefspec`
+command with `install`, `uninstall`, `doctor`, `validate`, `config`, and `state`. The journey
+below uses the `0.5.0` source candidate; see [Install](#install).
+
+```bash
+# Install the source candidate from a checkout
+uv tool install --force .
+
+# Verify the installation
+brief-spec --version
+
+# See the eight work types
+brief-spec types list
+
+# Classify bounded task text (no network)
+echo "Review the authentication module" | brief-spec classify - --json
+
+# Validate an Outcome Brief
+brief-spec validate outcome path/to/handoff.md
+
+# Validate a Checkpoint
+brief-spec validate checkpoint path/to/checkpoint.md --mode spoken
+
+# Install harness integrations
+brief-spec setup codex
+brief-spec setup all --scope user --require codex,claude,omp,grok,kimi
+
+# Check installation health
+brief-spec doctor all --scope user --probe --all-scopes
+```
+
+### Export and verify
+
+```bash
+# Export to multiple formats
+brief-spec export handoff.md \
+  --formats markdown,json,html \
+  --output-dir delivery/
+
+# Bundle with manifest
+brief-spec bundle handoff.md --output handoff.zip
+
+# Verify the bundle
+brief-spec verify handoff.zip --level rendered --offline --no-plugins
+
+# Deliver with receipt
+brief-spec deliver handoff.zip --to /path/to/deliveries/
+brief-spec verify /path/to/deliveries/handoff.zip.receipt.json --level delivered
+```
+
+Verification levels are cumulative: `structural` → `resolved` → `rendered` → `delivered`. See [docs/delivery.md](docs/delivery.md) for the complete export and verification reference.
+
+### Configuration
+
+Create user or project configuration:
+
+```bash
+brief-spec config init
+brief-spec config show
+brief-spec config init --scope project --project /path/to/repository
+```
+
+Project values override user values. See [docs/configuration.md](docs/configuration.md) for policy options.
+
+---
+
+## Install
+
+Brief-Spec requires **Python 3.11+**. The canonical distribution is not yet on PyPI.
+
+### Public release (v0.2.0)
+
+```bash
+uv tool install git+https://github.com/luanmorenommaciel/brief-spec.git@v0.2.0
+briefspec install all --scope user
+briefspec doctor all --probe
+```
+
+This older release uses the `briefspec` command and does not include work types, classification,
+exports, or the Grok, OMP, and Kimi integrations.
+
+### Dogfood from checkout (0.5.0)
+
+```bash
+uv tool install --force --reinstall \
+  --with ./packages/brief-spec-renderer-pdf \
+  --with ./packages/brief-spec-renderer-audio \
+  .
+brief-spec setup all --scope user --require codex,claude,omp,grok,kimi
+brief-spec doctor all --scope user --probe --all-scopes
+```
+
+Project-scoped installation keeps the integration inside one repository:
+
+```bash
+brief-spec setup all --scope project --project /path/to/repository
+brief-spec doctor all --scope project --project /path/to/repository --probe
+```
+
+The tagged URL installs a versioned release instead of whatever happens to be on `main`.
+
+---
+
+## Who this is for
+
+Brief-Spec is for engineers and teams running multiple AI coding agents who want a predictable handoff without rebuilding their workflow.
+
+### Who this is not for
+
+- If you want a second brain or knowledge graph, Brief-Spec is not that. Use Nexo, Obsidian, or your preferred knowledge system.
+- If you want an agent orchestrator, Brief-Spec is not that. It is the human handoff, not the task executor.
+- If you want to replace Git, CI, or your issue tracker, Brief-Spec is not that. Original evidence remains authoritative.
+
+Brief-Spec is a presentation layer. The original repository, command output, document, or host transcript remains the source of truth.
+
+---
+
+## Safety invariants
+
+Brief-Spec compresses presentation, not provenance.
+
+- A brief is never more authoritative than its source.
+- A passing syntax check does not prove a live integration.
+- A local commit does not prove publication.
+- Planned work is not completed work.
+- Direct, derived, and reported evidence must remain distinguishable.
+- Unknown or unverified state is a gap, not a reason to infer success.
+- Hooks fail open on internal errors.
+- Installation refuses destructive overwrite of foreign files.
+- Nothing is silently ingested into Nexo, Obsidian, or another knowledge system.
+
+The JSON schemas in [`schemas/`](schemas/) define the portable data contracts.
+
+## Honest limits
+
+- A consistent format cannot make an unsupported claim true.
+- A checkpoint cannot recover evidence the host never exposed.
+- Lifecycle automation depends on the events supported by each host version.
+- Spoken Brief is text until a separate text-to-speech system renders it.
+- Automatic checkpoint thresholds are heuristics and remain configurable.
+- Brief-Spec reduces reading friction; high-risk changes still deserve direct inspection.
+
+---
+
+## Experimental: Human Continuity
+
+The source tree contains an optional, independently versioned Chronicle extension. It does not change the frozen Outcome Brief or Session Checkpoint `1.0` contracts and is not part of the public v0.2.0 or source candidate 0.5.0 publication claims.
+
+Chronicle is never activated globally. It records what Brief-Spec observed; it does not replace Seamwise intent, Task-Spec acceptance, Converge authorization, Git evidence, or reviewed durable knowledge.
+
+Read the complete [Human Continuity architecture](docs/human-continuity.md).
+
+---
+
+## Release truth
+
+| Version | State | Notes |
+| --- | --- | --- |
+| v0.2.0 | Published GitHub release | Latest public release |
+| 0.5.0 | Source candidate | Locally verified; awaits live/hosted/publication gates |
+| 0.3.0, 0.4.0 | Unpublished | Folded into 0.5.0 |
+
+"Locally verified" does not mean hosted or published. See the full [changelog](CHANGELOG.md) and [verification record](docs/verification.md).
+
+---
+
+## Repository map
+
+```text
+skills/
+  brief-spec/            Type router and eight compact profiles
+  outcome-brief/         Stable terminal handoff
+  session-checkpoint/    Orient, Teach, and Spoken Brief
+src/brief_spec/          Canonical Python import
+src/briefspec/
+  adapters/              Host payload normalization
+  delivery.py            Canonical envelope and core renderers
+  verification.py        Structural through delivered verification
+  hooks.py               Safe-boundary and one-repair control
+  installers.py          Transactional user/project integration
+packages/
+  brief-spec-renderer-pdf/    Optional HTML-to-PDF renderer
+  brief-spec-renderer-audio/  Optional script-to-MP3 renderer
+  brief-spec-chronicle/       Optional project continuity extension
+  brief-spec-renderer-video/  Experimental Chronicle video renderer
+schemas/                 Portable machine-readable contracts
+docs/                    Theory, architecture, examples, installation
+```
+
+See [docs/repository-layout.md](docs/repository-layout.md) for the complete ownership map.
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and quality gates.
+
+```bash
+git clone https://github.com/luanmorenommaciel/brief-spec.git
+cd brief-spec
+uv sync --group dev
+uv run ruff check .
+uv run ruff format --check .
+uv run pytest --cov=briefspec --cov-report=term-missing
+```
+
+---
+
+## Uninstall
+
+```bash
+# Preview removal
+brief-spec uninstall all --dry-run
+
+# Remove user installation
+brief-spec uninstall all
+
+# Remove one project installation
+brief-spec uninstall copilot --scope project --project /path/to/repository
+```
+
+Brief-Spec removes receipt-owned files only when their content still matches the installed hash.
+
+---
+
+## License
+
+[MIT](LICENSE)

brief_spec-0.5.0.dist-info/RECORD

@@ -0,0 +1,77 @@
+brief_spec/__init__.py,sha256=umyJNJ2Tj1bcfmR8fLA1SOpKiHPUtJr9vgdfPAG32Iw,492
+brief_spec/__main__.py,sha256=ptNGeIyh5qomwYZTEFrLvGMVB-3SSKiXJOOrp9euP1M,94
+briefspec/__init__.py,sha256=C4RwkYi5bhZy76q6MFNYgta5FNTHNUHr-S12Qhl5SQM,164
+briefspec/__main__.py,sha256=TlIJ4645xMiNHCXfb6-lBw0AET-VhhIjvIxwmKyqoC4,93
+briefspec/artifacts.py,sha256=dm1u_O9Ez7SNLFd-ADnBOqxxdBdafFnhhzpJJg1h_a4,4094
+briefspec/bundle.py,sha256=9kKY3IA4a5CRvNIG6lYlURT7wCYJ1IFWDKp-cZALgxE,13302
+briefspec/capabilities.py,sha256=NhKzCZH1Xarq9HTEyQkF0TLVhJXmF2ghAydFeO7wivs,350
+briefspec/cli.py,sha256=qvMCpWF73KI7Nb93mBfx6B_XGBaaz6HAv148ZI_vCfs,28253
+briefspec/config.py,sha256=nCXvOgL3p8h9VXgY5fxL2dWQ20QMDvDAIJIEe4dj55o,3475
+briefspec/continuity.py,sha256=IbO98r-puZJ0V0F9Sw5oB7AdjSIeaCp6JCVqTLu0IHA,3764
+briefspec/delivery.py,sha256=ar9a_YK5n2UEIiyXQ__PS8zv3Gj3pO4g9XQbqJVhaB4,43751
+briefspec/diagnostics.py,sha256=nsicPc4WN7HXzqnT-0VRCcgg02mC_gOjoF0Kq_qG18U,18332
+briefspec/errors.py,sha256=VpDIcg8H-Ljrd96hLzlZpIMWxwCI4iUKN8LDPAPmr3g,454
+briefspec/events.py,sha256=EkTb1Nt9Wtz_0ooPzYa16lM82bmnGHxGtWo19rWeEjw,16271
+briefspec/frames.py,sha256=hcmJ_nBXDGj3K8OeGH1XTaieB-J5qGYPCMf5xTMpGsE,3759
+briefspec/harnesses.py,sha256=Zsbq6WNGOVArPiVNKR6TTMSufnJgUG78A5ZOKaRJ1Xc,8276
+briefspec/hooks.py,sha256=1U60yDqrgfr3HNNkq0Od35k2ja-Qy0q-SF_B1b3HNpE,26303
+briefspec/installers.py,sha256=bC4trWI3LqlNYgiTHrl0Zk6gwqXEjjtpm0aeiyj8kC4,42330
+briefspec/markdown.py,sha256=_DKXYX3uRGSUHUhUPWvDUliP4QpZufrQmBxiRSBq2ZA,14051
+briefspec/models.py,sha256=j_GIiSjrvqumm4NZ6RUQ3nY2agkb9M1c_oo495ak-dE,8456
+briefspec/renderers.py,sha256=XApct5KKyIGSfgI4ZNwxC9j-J3hWzvsRiUmhRQOM6cQ,4509
+briefspec/resources.py,sha256=bV9IaH3rlF_LR8oyUCv8JyfUc7J4hySHFZGU1emjuKs,727
+briefspec/state.py,sha256=_iX74uwHdIuZqQUGHsPCmhlgqrd3mBH6wPYBO-GxN_8,7514
+briefspec/triggers.py,sha256=fdl2vjbVluvVbgdXPoYlMPVkveZyIVop9HknxRm5GLA,3486
+briefspec/verification.py,sha256=wbIQMTGPSAQu9J_cs6jNTBLfcdZ782oeb_T-nHKQLCM,30969
+briefspec/work_types.py,sha256=SdqvrXgASDoLOvZ3hshzUKZbwiRpFpbNVEhPvnWqXzc,26364
+briefspec/adapters/__init__.py,sha256=sTuUNH72lZhLfCnSQarG4Stpcfu8G-1ZiIl6smLqBlU,87
+briefspec/adapters/base.py,sha256=P9Nad-2CeIJq7aGMod7GVOm9LxoGWqqlte81-p8Twx8,6925
+briefspec/adapters/claude.py,sha256=vxZlh0qrqTHb_O-MGsILDM_rVuzcv6ndEcimDepZ82k,318
+briefspec/adapters/codex.py,sha256=rf2EJEoHOrJPmsB7tesfSuTcVydE21ZQHfpO9AlLUTw,317
+briefspec/adapters/copilot.py,sha256=KJ9tptOuL2DzxpGFCQWyKKUdp9zgbJbLHNJNVnULBXU,319
+briefspec/adapters/registry.py,sha256=ojAAsv5SIRcRFPKa3A4VzWixzA1zBmZyazCJSM_GRhc,687
+briefspec/resources/hooks/copilot.json,sha256=4R1dPY2pAIdOtCS2o1VICxMbe4tF-Y5MlIHVZs6nMVY,1639
+briefspec/resources/hooks/hooks.json,sha256=dWkR-rimm_sNlYkbSz-OyAjTd2mW4yYYo1U8h1Y68DA,1405
+briefspec/resources/schemas/brief-spec-bundle-manifest.schema.json,sha256=GXo431RIKBwsN-IEc8putaLr2J2fxylOcLlWhekB4Lo,1607
+briefspec/resources/schemas/brief-spec-delivery-receipt.schema.json,sha256=-T8SPVGBocJQ73SLo0dNjut-nDwTWRoSXTaFa9oOzL8,1557
+briefspec/resources/schemas/brief-spec-delivery.schema.json,sha256=PiFmJk9no4tO4ZqzI7SnNDrmws6EMeAEtQaI7J230Lo,6171
+briefspec/resources/schemas/brief-spec-event.schema.json,sha256=3qfKOgeQqoTEaWJvCFbIHAubeFa4C7UTin6bjr3iwtc,2817
+briefspec/resources/schemas/brief-spec-evidence.schema.json,sha256=Zrq3f18y4xb2mpKJO5CMjhHPeqggDRMeYFraEUqNw6E,860
+briefspec/resources/schemas/brief-spec-frame-receipt.schema.json,sha256=gtZSJR6VkCVNpIMytaixbNh1KtyLkLfiu4eTKd4PO5Y,1097
+briefspec/resources/schemas/brief-spec-frame-request.schema.json,sha256=vsooiQmq7_IJW6I0_7dy2UVRkG8m1Op9hLmIs3MjDvU,712
+briefspec/resources/schemas/brief-spec-outcome-brief.schema.json,sha256=s-ATDoIw1PYACfEqGpfWfhyiZakterHXqa3a7_PuqAs,1106
+briefspec/resources/schemas/brief-spec-session-checkpoint.schema.json,sha256=cS286LEb4JzH3wh-HV8ZbnGLbUvKjsNZWZAd6AgX7dI,2238
+briefspec/resources/schemas/briefspec-delivery.schema.json,sha256=wr2X0AefQLajqnTwbZKFrUXpFsaYXvG-6-1jGBNztG8,3805
+briefspec/resources/schemas/bundle-manifest.schema.json,sha256=1QX1BxQRIGeMciZuuGmL3iArvg4ZsPa3unqInq9EBzc,1545
+briefspec/resources/schemas/delivery-receipt.schema.json,sha256=aAzIcvHOaoYAdeHHQOhDhJrif8E-YpuV2xKKdraFOOA,1485
+briefspec/resources/schemas/evidence.schema.json,sha256=E5hEpRTTyBNTR5_ja3AmcxNG0lU4hOajdv7aGh96U8U,895
+briefspec/resources/schemas/outcome-brief.schema.json,sha256=2ssKT4azOp96z37KmFXW14XRm6hqQR7gjsGMoeUsPi0,1218
+briefspec/resources/schemas/session-checkpoint.schema.json,sha256=np6pGG50foBOLhaA6dIJjgKB4KYMO1K77mALxTZpQeo,2754
+briefspec/resources/skills/brief-spec/SKILL.md,sha256=6N4yMUVSYSjniwvm1p0sv1d5S4DDqxI0HBBeChJuJGY,4706
+briefspec/resources/skills/brief-spec/agents/openai.yaml,sha256=lLzBb3y1yIBnpYptn3-F5CEJMEI4WNZT4RCk0mQvasI,261
+briefspec/resources/skills/brief-spec/references/debugging.md,sha256=bXvniYwxo-_VrKH-VWFAxyLXdXWmY-HDU_DOHITgd-Q,307
+briefspec/resources/skills/brief-spec/references/exploration.md,sha256=WR--dnJsflusafXkwLelDIKAVceGhzTYcK-1SIDwPLg,315
+briefspec/resources/skills/brief-spec/references/general.md,sha256=jKIq0NMmWY52Zkl8ZjO47ktkcuLuKoVnJH6nwTl2TAM,269
+briefspec/resources/skills/brief-spec/references/implementation.md,sha256=rs7dJsoCbCZACh69ZM-pfJDp_r57NF-tSJJuyBL5Y_0,297
+briefspec/resources/skills/brief-spec/references/operations.md,sha256=20RYYTlRopR26YK3JY3HwpnCoxrnIijmteYktze8cXo,299
+briefspec/resources/skills/brief-spec/references/planning.md,sha256=Gt9ezZ5j5nC3aNR-mJ3FTlGv9XnFnZNOXIRItoMAU9o,269
+briefspec/resources/skills/brief-spec/references/research.md,sha256=FFVyDLWZn8aXWX-xGOEQIZlXCiJPaAvqrmmIJRv3uGo,304
+briefspec/resources/skills/brief-spec/references/review.md,sha256=GCteDseZVgVJ9buCRZ4wHLDp8Ouv5yN6FYytvLmILkQ,294
+briefspec/resources/skills/outcome-brief/SKILL.md,sha256=3x4cawDxlAbmRRkPX74ecLWlpE069Tpjnuy2rIAfm5Y,2847
+briefspec/resources/skills/outcome-brief/agents/openai.yaml,sha256=O1_TA43vSl6hs2gU8Qy6OL6rSeGIhbsKR9S_mQtFi7s,240
+briefspec/resources/skills/outcome-brief/references/contract.md,sha256=n90CBCMxgAP11U2BZb8FPE7LKOxSajee-iZIz4zMRdA,1753
+briefspec/resources/skills/outcome-brief/references/examples.md,sha256=riVJEL2F32PZQyG9ePSWDfGDPISvf40zGLFzOfnkO3Y,996
+briefspec/resources/skills/session-checkpoint/SKILL.md,sha256=3P1oXUVIVAFDxb-dsO1aEYE2n1Ak4KhuWcqpSJHCehA,2180
+briefspec/resources/skills/session-checkpoint/agents/openai.yaml,sha256=8d8KiTvy4dxn44v4HFSpK58M3t5Vhr55HE56fBOTF2s,254
+briefspec/resources/skills/session-checkpoint/references/examples.md,sha256=dFvAuiA8MkyJeEvyk0p_9aqpOgrDKObxsCHR76n-UPI,1706
+briefspec/resources/skills/session-checkpoint/references/modes.md,sha256=Uu96viWnHnWHa8tzMqeTo3kLd5-CbQ70ww4xUzYzOUc,1355
+briefspec/resources/integrations/copilot/settings.json.example,sha256=qB05fan9cyxThF7zWyZWxW1icfHxZz_DogmsWTDkuE0,251
+briefspec/resources/integrations/copilot/cloud/README.md,sha256=WBbHx3p6HECYi9pMkXYsQAj-fRIRCBy8InRydyd66SA,1164
+briefspec/resources/manifests/claude-plugin.json,sha256=-Q1ekDYCcwUH-NJxbidPrZEvInmLZuoYIq_uh_rBrGA,466
+briefspec/resources/manifests/codex-plugin.json,sha256=1eRFsEyLMNSbRUxuShUvA8E5k1WRV6SCxgXxCR45oxE,1227
+briefspec/resources/manifests/plugin.json,sha256=dyXJSP495qpfeNO1at9mFIorUhSxzm9772_e1kGRzy4,496
+brief_spec-0.5.0.dist-info/METADATA,sha256=676nl3uUP-muVjsMTQQ2pge84RUTAoFz7gXyJECY5Xc,24160
+brief_spec-0.5.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+brief_spec-0.5.0.dist-info/entry_points.txt,sha256=GPpzuU4sBfR6KsRb4mqSX4Yg0u4jaYZfeFuQbZkW1ms,82
+brief_spec-0.5.0.dist-info/licenses/LICENSE,sha256=kLH5LE2Q_hBWOTkAnJ6JbhKbz1ZW2SPQj-lOpTqXPjw,1075
+brief_spec-0.5.0.dist-info/RECORD,,