taskledger

Documentation

• Usage
  • Installation
  • Shell completion
  • Initialize state
  • Storage migration recovery
  • Legacy branch-local task work (migration only)
  • Opaque links and external artifacts
  • Planning guidance profiles
  • Optional worker pipelines
  • Release boundary tags
  • Recording manually completed work
  • Archiving tasks
  • Post-completion follow-up deltas
  • Fresh-context entrypoint
  • Compact implementation loop
  • Fresh-session startup and monitoring
  • Machine-readable output
  • Resolved storage
  • Integrity and recovery
  • Export and snapshots
  • Artifact file-size policy
  • Single-task transfer from a config-only checkout
  • Task-centered traceability
  • Canonical project layout
• Full Task Cycle
  • 1. Initialize The Ledger
  • 2. Create And Activate A Task
  • 3. Start Planning
  • 4. Ask And Answer Questions
  • 5. Propose A Plan
  • 6. Materialize Todos And Approve
  • 7. Start Implementation
  • 8. Complete Implementation Todos
  • 9. Validate The Work
  • 10. Close The Task
  • 11. Recovery And Maintenance Commands
  • Task-centered traceability
• Architecture Documentation
• Introduction and Goals
  • Current canonical storage boundary
  • Requirements Overview
  • Quality Goals
  • Stakeholders
• Architecture Constraints
• Context and Scope
  • Business Context
  • Technical Context
• Solution Strategy
  • Maintenance
  • Strategy Items
  • Layered architecture: CLI → Services → Domain → Storage
  • Strategy
  • Trade-offs
  • Markdown/YAML front matter as canonical records
  • Strategy
  • Trade-offs
  • JSON indexes as rebuildable derived caches
  • Strategy
  • Trade-offs
  • Policy-based lifecycle gate decisions
  • Strategy
  • Trade-offs
  • Atomic file writes for durability
  • Strategy
  • Trade-offs
• Building Block View
  • Whitebox taskledger system
  • Motivation
  • Contained building blocks
  • Important interfaces
• Runtime View
  • Task lifecycle: create through done
  • Lock acquisition, heartbeat, and release
  • Handoff creation and claiming
  • Editable plan input preflight
  • Doctor integrity check
  • Branch-scoped ledger selection and fork
  • Implementation workspace snapshot lifecycle
  • Git sync workflow for shared state
  • Migration, index repair, and doctor interaction
  • Worker pipeline guided handoff
• Deployment View
  • Local development deployment
• Cross-cutting Concepts
  • Actor metadata and role semantics
  • JSON output envelope contract
  • YAML front matter serialization
  • Atomic file writes
  • Append-only event log
  • Exit code taxonomy
  • Editable plan input preflight
  • Implementation workspace snapshot
  • Durable code-review evidence
• Architecture Decisions
  • Markdown/YAML front matter as canonical format
  • Context
  • Decision
  • Consequences
  • Alternatives considered
  • Sidecar summary index as derived rebuildable cache
  • Context
  • Decision
  • Consequences
  • Alternatives considered
  • Explicit lifecycle gates with policy decisions
  • Context
  • Decision
  • Consequences
  • Alternatives considered
  • Typer CLI framework
  • Context
  • Decision
  • Consequences
  • Alternatives considered
  • Task bundle directory layout
  • Context
  • Decision
  • Consequences
  • Alternatives considered
  • External skill packaging
  • Context
  • Decision
  • Consequences
  • Alternatives considered
• Quality Requirements
  • Quality Requirements Overview
  • Quality Scenarios
• Risks and Technical Debt
  • Risk Overview
• Glossary
• Taskledger architecture
  • Owning layers
  • Storage model
  • Lifecycle flow
  • Command surface
  • Architecture records
• Multi-repo context
  • Common workflow
  • Mental model
• API reference
  • Supported modules
  • Import boundary
  • Project API
  • Task API
  • Plan API
  • Question API
  • Run API
  • Review API
  • Other APIs
  • Canonical layout APIs
• Public surface
  • Supported CLI entries
  • question subcommands
  • plan subcommands
  • task reporting and transcripts
  • todo subcommands
  • file subcommands
  • storage and sync subcommands
  • Supported Python API modules
  • Removed legacy surfaces
• CLI Command Contract
  • Global Options
  • Task Scoping
  • Plan guidance command
  • Plan revision commands
  • Plan check command
  • Plan schema command
  • Plan review command
  • Archive import lock policy
  • Transfer archive manifest contract
  • Export task selection
  • Positional Resource Refs
  • Release commands
  • Legacy branch-scoped ledger commands (migration only)
  • Storage and sync helper commands
  • Config commands
  • next-action result contract
  • Run and lock repair
  • Maintenance garbage collection
  • Managed command wrappers
  • Transcript review modes
  • Post-completion follow-up deltas
  • Human monitoring UI
  • Focused context and handoff options
  • Code review commands
  • Removed Pre-Release Aliases
  • Approval escape hatches
  • Todo source inference
  • Storage Compatibility
  • Lock recovery contract
  • Layout and migration commands
• UUID identity and allocation recovery
  • Safety boundary
  • Backup and read-only diagnosis
  • Incomplete allocation repair
  • Reconcile a previously misattributed tombstone
  • Backfill a known relationship UUID
  • Verify and rebuild derived indexes
  • Readio incident runbook (not executed here)
• Transfer archives
  • What transfer archives include
  • Artifact file-size policy
  • Filename policy
  • Single-task transfer from a config-only checkout
  • Dry-run import
  • Lock policy and next action
  • Canonical identity
• Sync taskledger state across PCs
  • Schema-3 project state
  • Shared state Git repo
  • Second PC bootstrap
  • Daily sync protocol
  • Artifact preflight
  • Active lock rule
  • When to use export/import instead
  • Syncthing/rclone caveats
  • Task-centered traceability
  • Canonical mounts
• Service boundary whitelist
  • Module line budget whitelist (>2000 lines)
  • Current split status
  • Function line budget whitelist (>250 lines)
  • CLI→services import whitelist
  • Catch-all exception whitelist (except Exception)
• Documentation freshness
  • Detect documentation affected by code changes
  • Maintain section links
  • Validate and mark sections fresh
  • Review boundaries
• Release checklist
• Changelog
  • [v0.7.2] - 2026-10-07
  • [v0.7.1] - 2026-10-07
  • [v0.7.0] - 2026-10-04
  • [v0.6.11] - 2026-10-02
  • [v0.6.10] - 2026-09-26
  • [v0.6.9] - 2026-09-24
  • [v0.6.8] - 2026-09-11
  • [v0.6.7] - 2026-09-09
  • [v0.6.6] - 2026-09-04
  • [v0.6.5] - 2026-08-22
  • [v0.6.4] - 2026-08-21
  • [v0.6.3] - 2026-08-19
  • [v0.6.2] - 2026-08-15
  • [v0.6.1] - 2026-08-14
  • [v0.6.0] - 2026-07-28