Metadata-Version: 2.4
Name: trueline
Version: 0.1.0.dev0
Summary: Spec-Driven Development (SDD) framework for Claude Code users.
Project-URL: Homepage, https://gitlab.com/simple-tools1/trueline
Project-URL: Repository, https://gitlab.com/simple-tools1/trueline
Author: Luis Muller
License-Expression: MIT
License-File: LICENSE
License-File: THIRD-PARTY-NOTICES.md
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Code Generators
Requires-Python: >=3.12
Requires-Dist: claude-agent-sdk>=0.2.98
Requires-Dist: pydantic>=2.7
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13
Requires-Dist: typer>=0.24
Description-Content-Type: text/markdown

# trueline

**Spec-Driven Development (SDD) framework for Claude Code users**:
specs and architecture as living documents and source of truth, evolution via
spec deltas and ADRs, finalization with a judge-until-convergence loop and a
human gate — all driven by an external orchestrator over a headless core.

**Status:** Milestone 1 (skeleton) implemented — strict schemas, fold-engine
with byte-for-byte parity with OpenSpec, ADR log with projected state,
derived state machine, cumulative gates, judge-until-convergence loop,
headless invocation (SDK/CLI) and the full CLI surface.

```
trueline init                 # .trueline/ skeleton + config.yaml
trueline propose <id>         # phases: propose → plan → decompose → build
trueline validate [<id>|--ci] # battery of checks (drift) / post-merge net
trueline finalize <id>        # refactor short-circuit or judge loop
trueline approve|reject <id>  # human gate of finalization
trueline status [<id>]        # derived state + next step
trueline adr list             # decision log with display numbering
```

## Documents

- [docs/DESIGN.md](docs/DESIGN.md) — conceptual design (v5). In conflict with the spec, the design wins.
- [docs/M1-SPEC.md](docs/M1-SPEC.md) — technical specification of Milestone 1 (r4, FINAL): the source of truth of the implementation.
- [docs/M1-HANDOFF.md](docs/M1-HANDOFF.md) — implementation state, agenda and working style.

## License

MIT — see [LICENSE](LICENSE). The fold-engine parity suite is translated
from the OpenSpec test suite (MIT) — see
[THIRD-PARTY-NOTICES.md](THIRD-PARTY-NOTICES.md).
