taskledger 0.5.0__tar.gz → 0.5.2__tar.gz

{taskledger-0.5.0 → taskledger-0.5.2}/.planledger.toml

@@ -3,4 +3,4 @@ name = "taskledger"
 uuid = "fe3469ad-0e17-4ade-9d38-b4d4cf810beb"
 
 [storage]
-planledger_dir = "../planledger-state/taskledger"
+planledger_dir = "../ledger/plan/taskledger"

{taskledger-0.5.0 → taskledger-0.5.2}/.taskledger.toml

@@ -1,7 +1,7 @@
 # Project-local taskledger configuration.
 # This file lives in the source project root.
 config_version = 2
-taskledger_dir = '../taskledger-state/taskledger'
+taskledger_dir = '../ledger/task/taskledger'
 
 # Stable project identity. Commit this with your source tree.
 project_uuid = "081c7c05-2d10-42b7-9b37-3d814c2f400a"
@@ -9,7 +9,7 @@ project_uuid = "081c7c05-2d10-42b7-9b37-3d814c2f400a"
 # Taskledger branch-scoped state. This block is intentionally safe to commit.
 ledger_ref = "main"
 ledger_parent_ref = ""
-ledger_next_task_number = 132
+ledger_next_task_number = 139
 ledger_branch_guard = "off"
 
 [prompt_profiles.planning]

{taskledger-0.5.0 → taskledger-0.5.2}/AGENTS.md

@@ -124,8 +124,8 @@ Use the owning layer before editing.
 - `taskledger/errors.py` — public exception taxonomy and exit codes
 - `taskledger/command_inventory.py` — registered command metadata
 - `skills/taskledger/SKILL.md` — external agent skill protocol
-- `docs/command_contract.rst` — CLI grammar contract
-- `API.md`, `docs/api.rst`, `docs/public_surface.rst` — public API documentation
+- `docs/command_contract.md` — CLI grammar contract
+- `API.md`, `docs/api.md`, `docs/public_surface.md` — public API documentation
 
 ## 4. Packaging Rule for Skills
 

{taskledger-0.5.0 → taskledger-0.5.2}/API.md

@@ -115,6 +115,8 @@ from taskledger.errors import (
 - `propose_plan`
 - `plan_template`
 - `upsert_plan`
+- `check_plan_input`
+- `plan_input_schema_text`
 - `PlanReviewOptions`
 - `build_plan_review_payload`
 - `render_plan_review`
@@ -159,6 +161,7 @@ payload = plan_guidance(Path.cwd(), "task-0001")
 - `start_implementation`
 - `restart_implementation`
 - `resume_implementation`
+- `refresh_implementation_snapshot`
 - `log_implementation`
 - `add_implementation_deviation`
 - `add_implementation_artifact`

{taskledger-0.5.0 → taskledger-0.5.2}/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [v0.5.2] - 2026-07-10
+
+### Added
+
+- Added plan review approval brief with decision status, question status, and structured body heading lint rule
+
+### Quality
+
+- Improved type safety in WorkspaceContentSnapshot and WorktreePathEntry deserialization with round-trip tests
+
+<!-- generated by releaseledger -->
+
+## [v0.5.1] - 2026-06-26
+
+### Added
+
+- Added plan check command and plan input service for validating editable plan input without creating or revising plans
+- Added implement snapshot refresh command to accept current workspace as implementation snapshot when validation is blocked by IMPLEMENTATION_SNAPSHOT_MISMATCH
+
+### Documentation
+
+- Converted Sphinx RST documentation to Markdown with myst-parser
+
+<!-- generated by releaseledger -->
+
 ## [v0.5.0] - 2026-06-14
 
 ### Added

{taskledger-0.5.0/taskledger.egg-info → taskledger-0.5.2}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: taskledger
-Version: 0.5.0
+Version: 0.5.2
 Summary: Durable project-state storage and CLI for coding workflows
 Author: Taskledger Contributors
 Maintainer: Holger Nahrstaedt
 License-Expression: Apache-2.0
-Project-URL: Homepage, https://github.com/holgern/taskledger
-Project-URL: Repository, https://github.com/holgern/taskledger
-Project-URL: Issues, https://github.com/holgern/taskledger/issues
-Project-URL: Changelog, https://github.com/holgern/taskledger/releases
+Project-URL: Homepage, https://github.com/ledgerwerk/taskledger
+Project-URL: Repository, https://github.com/ledgerwerk/taskledger
+Project-URL: Issues, https://github.com/ledgerwerk/taskledger/issues
+Project-URL: Changelog, https://github.com/ledgerwerk/taskledger/releases
 Keywords: cli,durable-state,project-state,developer-tools,workflows
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -39,6 +39,11 @@ Requires-Dist: pytest-xdist; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
 Requires-Dist: twine; extra == "dev"
 Requires-Dist: types-PyYAML; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx-rtd-theme; extra == "docs"
+Requires-Dist: myst-parser; extra == "docs"
+Requires-Dist: rst-to-myst; extra == "docs"
 Provides-Extra: rich
 Requires-Dist: rich; extra == "rich"
 Dynamic: license-file
@@ -68,7 +73,7 @@ The normal agent path is deliberately small:
 actor whoami
 task active | task show | task create | task activate | task follow-up
 next-action | context | can
-plan start -> plan template -> plan upsert -> plan lint -> plan accept
+plan start -> plan guidance -> plan template -> plan check -> plan upsert -> plan lint -> plan accept
 question add | question add-many | question answer | question answer-many | question status | question answers
 todo next | todo show | todo done | todo status
 implement start | implement resume | implement change | implement scan-changes | implement finish
@@ -172,7 +177,7 @@ taskledger --json plan guidance
 
 This guidance is advisory and cannot override lifecycle gates, user approval,
 validation requirements, lock rules, or higher-priority harness instructions.
-See `docs/usage.rst` for the full key reference and workflow details.
+See `docs/usage.md` for the full key reference and workflow details.
 
 Quick config inspection/edit examples:
 
@@ -602,7 +607,7 @@ taskledger sync git push
 taskledger sync git push --message "Sync project-a taskledger state"
 ```
 
-See `docs/sync.rst` for the full second-PC bootstrap, daily sync protocol, and
+See `docs/sync.md` for the full second-PC bootstrap, daily sync protocol, and
 Syncthing/rclone caveats.
 
 ## JSON output
@@ -733,7 +738,7 @@ $ taskledger handoff show handoff-0001 --task task-0001 --format text
 $ taskledger handoff close handoff-0001 --task task-0001 --reason "Continued."
 ```
 
-See [docs/usage.rst](docs/usage.rst) and
+See [docs/usage.md](docs/usage.md) and
 [skills/taskledger/SKILL.md](skills/taskledger/SKILL.md)
 for task-first handoff guidance.
 

{taskledger-0.5.0 → taskledger-0.5.2}/README.md

@@ -23,7 +23,7 @@ The normal agent path is deliberately small:
 actor whoami
 task active | task show | task create | task activate | task follow-up
 next-action | context | can
-plan start -> plan template -> plan upsert -> plan lint -> plan accept
+plan start -> plan guidance -> plan template -> plan check -> plan upsert -> plan lint -> plan accept
 question add | question add-many | question answer | question answer-many | question status | question answers
 todo next | todo show | todo done | todo status
 implement start | implement resume | implement change | implement scan-changes | implement finish
@@ -127,7 +127,7 @@ taskledger --json plan guidance
 
 This guidance is advisory and cannot override lifecycle gates, user approval,
 validation requirements, lock rules, or higher-priority harness instructions.
-See `docs/usage.rst` for the full key reference and workflow details.
+See `docs/usage.md` for the full key reference and workflow details.
 
 Quick config inspection/edit examples:
 
@@ -557,7 +557,7 @@ taskledger sync git push
 taskledger sync git push --message "Sync project-a taskledger state"
 ```
 
-See `docs/sync.rst` for the full second-PC bootstrap, daily sync protocol, and
+See `docs/sync.md` for the full second-PC bootstrap, daily sync protocol, and
 Syncthing/rclone caveats.
 
 ## JSON output
@@ -688,7 +688,7 @@ $ taskledger handoff show handoff-0001 --task task-0001 --format text
 $ taskledger handoff close handoff-0001 --task task-0001 --reason "Continued."
 ```
 
-See [docs/usage.rst](docs/usage.rst) and
+See [docs/usage.md](docs/usage.md) and
 [skills/taskledger/SKILL.md](skills/taskledger/SKILL.md)
 for task-first handoff guidance.
 

taskledger-0.5.2/docs/api.md

@@ -0,0 +1,216 @@
+# API reference
+
+`taskledger` exposes a task-first public API through `taskledger.api`.
+
+## Supported modules
+
+- `taskledger.api.project`
+- `taskledger.api.tasks`
+- `taskledger.api.plans`
+- `taskledger.api.questions`
+- `taskledger.api.task_runs`
+- `taskledger.api.reviews`
+- `taskledger.api.introductions`
+- `taskledger.api.locks`
+- `taskledger.api.handoff`
+- `taskledger.api.releases`
+- `taskledger.api.storage`
+- `taskledger.api.sync`
+- `taskledger.api.search`
+
+## Import boundary
+
+Consumers should not import from `taskledger.storage`, `taskledger.services`,
+`taskledger.domain`, or `taskledger.search` directly.
+
+## Project API
+
+- `init_project`
+- `project_status`
+- `project_status_summary`
+- `project_doctor`
+- `project_export`
+- `project_import`
+- `project_export_archive`
+- `project_import_archive`
+- `project_snapshot`
+- `project_tree`
+
+## Task API
+
+- `create_task`
+- `record_completed_task`
+- `show_active_task`
+- `activate_task`
+- `deactivate_task`
+- `clear_active_task`
+- `resolve_active_task`
+- `list_task_summaries`
+- `show_task`
+- `edit_task`
+- `cancel_task`
+- `uncancel_task`
+- `close_task`
+- `archive_task`
+- `unarchive_task`
+- `create_follow_up_task`
+- `list_archived_task_summaries`
+- `add_requirement`
+- `remove_requirement`
+- `waive_requirement`
+- `add_file_link`
+- `file_status`
+- `remove_file_link`
+- `list_file_links`
+- `refresh_file_baseline`
+- `add_todo`
+- `set_todo_done`
+- `show_todo`
+- `todo_status`
+- `next_todo`
+- `task_dossier`
+- `render_task_report`
+- `TaskReportOptions`
+- `export_task_markdown`
+- `TaskMarkdownExportOptions`
+- `next_action`
+- `can_perform`
+- `reindex`
+- `repair_task_record`
+- `repair_orphaned_planning_run`
+- `repair_planning_command_changes`
+
+## Plan API
+
+- `start_planning`
+- `propose_plan`
+- `plan_template`
+- `upsert_plan`
+- `check_plan_input`
+- `plan_input_schema_text`
+- `PlanReviewOptions`
+- `build_plan_review_payload`
+- `render_plan_review`
+- `export_plan`
+- `amend_plan`
+- `list_plan_versions`
+- `show_plan`
+- `diff_plan`
+- `lint_plan`
+- `plan_guidance`
+- `approve_plan`
+- `reject_plan`
+- `revise_plan`
+- `regenerate_plan_from_answers`
+- `materialize_plan_todos`
+- `run_planning_command`
+
+Planning guidance example:
+
+```python
+from pathlib import Path
+from taskledger.api.plans import plan_guidance
+
+payload = plan_guidance(Path.cwd(), "task-0001")
+```
+
+## Question API
+
+- `add_question`
+- `add_questions`
+- `answer_question`
+- `answer_questions`
+- `list_questions`
+- `list_open_questions`
+- `dismiss_question`
+- `question_status`
+
+## Run API
+
+- `start_implementation`
+- `restart_implementation`
+- `resume_implementation`
+- `refresh_implementation_snapshot`
+- `log_implementation`
+- `add_implementation_deviation`
+- `add_implementation_artifact`
+- `add_change`
+- `scan_changes`
+- `run_implementation_command`
+- `finish_implementation`
+- `show_task_run`
+- `start_validation`
+- `add_validation_check`
+- `validation_status`
+- `waive_criterion`
+- `finish_validation`
+- `list_runs`
+- `list_changes`
+
+## Review API
+
+- `record_code_review`
+- `list_code_review_records`
+- `show_code_review`
+
+## Other APIs
+
+### Introduction API
+
+- `create_introduction`
+- `list_introductions`
+- `resolve_introduction`
+- `link_introduction`
+
+### Lock API
+
+- `show_lock`
+- `break_lock`
+- `list_locks`
+- `load_active_locks`
+
+### Handoff API
+
+- `render_handoff`
+- `create_handoff`
+- `list_all_handoffs`
+- `show_handoff`
+- `claim_handoff_api`
+- `close_handoff_api`
+- `cancel_handoff_api`
+
+### Release API
+
+- `list_release_records`
+- `show_release`
+- `tag_release`
+
+### Storage API
+
+- `storage_where`
+- `storage_move`
+- `sync_preflight`
+- `sync_status`
+- `sync_commit`
+
+### Search API
+
+- `search_workspace`
+- `grep_workspace`
+- `symbols_workspace`
+- `dependencies_for_module`
+
+### Sync API
+
+- `sync_git_init`
+- `sync_git_paths`
+- `sync_git_status`
+- `sync_git_import_local`
+- `sync_git_commit`
+- `sync_git_export_local`
+- `sync_git_pull`
+- `sync_git_push`
+- `sync_git_sync`
+- `sync_git_hooks_install`
+- `sync_git_hooks_status`
+- `sync_git_hooks_uninstall`

taskledger-0.5.2/docs/architecture_taskledger_split.md

@@ -0,0 +1,37 @@
+# Taskledger architecture
+
+`taskledger` is a task-first CLI and Python package for staged coding work.
+The canonical workflow is:
+
+```text
+task -> plan -> approval -> implement -> validate -> done
+```
+
+## Owning layers
+
+- `taskledger/domain/` owns lifecycle enums, policies, and record models.
+- `taskledger/storage/task_store.py` and `taskledger/storage/locks.py` own persisted
+  task bundles and visible lock files under `.taskledger/`.
+- `taskledger/services/tasks.py` owns task lifecycle orchestration.
+- `taskledger/services/handoff.py` owns handoff payloads and rendering.
+- `taskledger/services/doctor.py` owns integrity checks.
+- `taskledger/api/*` exposes public wrappers.
+- `taskledger/cli*.py` wires commands only.
+
+## Storage model
+
+Markdown records are canonical. Task, plan, and run reads come from those
+records directly. JSON files under `.taskledger/indexes/` are optional derived
+caches or registries. Active stages require visible lock files, and stale locks
+are reported instead of being cleared silently.
+
+## Command surface
+
+The supported command groups are `task`, `plan`, `question`,
+`implement`, `validate`, `review`, `todo`, `intro`, `file`, `link`,
+`require`, `release`, `lock`, `handoff`, `context`, `actor`,
+`harness`, `view`, `tree`, `next-action`, `can`, `search`,
+`grep`, `symbols`, `deps`, `doctor`, `repair`, `reindex`,
+`migrate`, `init`, `status`, `export`, `import`, `snapshot`,
+`storage`, `sync`, `ledger`, `report`, `serve`, `pipeline`,
+`commands`, and `review` (code-review records).