taskledger 0.6.1__tar.gz → 0.6.3__tar.gz

{taskledger-0.6.1 → taskledger-0.6.3}/.github/workflows/pre-commit.yml

@@ -22,7 +22,7 @@ jobs:
       - name: Install Python tools
         run: |
           python -m pip install --upgrade pip
-          python -m pip install "ruff==0.15.12"
+          python -m pip install "ruff==0.16.3"
 
       - name: Install Node tools
         run: |

{taskledger-0.6.1 → taskledger-0.6.3}/.ledger/releaseledger/data/ledgers/main/events/events.jsonl

@@ -11,3 +11,18 @@
 {"data":{"added_source_refs":["git:c1d0982"],"fields":["source_refs"],"removed_source_refs":[],"source_refs_mode":"merge"},"entry_id":"entry-0005","event":"entry.updated","event_id":"event-0011","record_revisions":{"entry:v0.6.1/entry-0005":2},"release_version":"v0.6.1","schema_version":2}
 {"data":{"added_source_refs":["git:94965d3"],"fields":["source_refs"],"removed_source_refs":[],"source_refs_mode":"merge"},"entry_id":"entry-0004","event":"entry.updated","event_id":"event-0012","record_revisions":{"entry:v0.6.1/entry-0004":2},"release_version":"v0.6.1","schema_version":2}
 {"data":{"released_at":"2026-08-14"},"event":"release.finalized","event_id":"event-0013","record_revisions":{"release:v0.6.1":7},"release_version":"v0.6.1","schema_version":2}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0014","record_revisions":{"release:v0.6.2":1},"release_version":"v0.6.2","schema_version":2}
+{"data":{"kind":"added","status":"accepted"},"entry_id":"entry-0001","event":"entry.added","event_id":"event-0015","record_revisions":{"entry:v0.6.2/entry-0001":1,"release:v0.6.2":2},"release_version":"v0.6.2","schema_version":2}
+{"data":{"added_source_refs":[],"fields":["kind","summary"],"removed_source_refs":[],"source_refs_mode":"unchanged"},"entry_id":"entry-0001","event":"entry.updated","event_id":"event-0016","record_revisions":{"entry:v0.6.2/entry-0001":2},"release_version":"v0.6.2","schema_version":2}
+{"data":{"kind":"changed","status":"accepted"},"entry_id":"entry-0002","event":"entry.added","event_id":"event-0017","record_revisions":{"entry:v0.6.2/entry-0002":1,"release:v0.6.2":3},"release_version":"v0.6.2","schema_version":2}
+{"data":{"kind":"fixed","status":"accepted"},"entry_id":"entry-0003","event":"entry.added","event_id":"event-0018","record_revisions":{"entry:v0.6.2/entry-0003":1,"release:v0.6.2":4},"release_version":"v0.6.2","schema_version":2}
+{"data":{"kind":"docs","status":"accepted"},"entry_id":"entry-0004","event":"entry.added","event_id":"event-0019","record_revisions":{"entry:v0.6.2/entry-0004":1,"release:v0.6.2":5},"release_version":"v0.6.2","schema_version":2}
+{"data":{"added_source_refs":[],"fields":["summary"],"removed_source_refs":[],"source_refs_mode":"unchanged"},"entry_id":"entry-0002","event":"entry.updated","event_id":"event-0020","record_revisions":{"entry:v0.6.2/entry-0002":2},"release_version":"v0.6.2","schema_version":2}
+{"data":{"added_source_refs":[],"fields":["summary"],"removed_source_refs":[],"source_refs_mode":"unchanged"},"entry_id":"entry-0003","event":"entry.updated","event_id":"event-0021","record_revisions":{"entry:v0.6.2/entry-0003":2},"release_version":"v0.6.2","schema_version":2}
+{"data":{"released_at":"2026-08-15"},"event":"release.finalized","event_id":"event-0022","record_revisions":{"release:v0.6.2":6},"release_version":"v0.6.2","schema_version":2}
+{"data":{"status":"planned"},"event":"release.created","event_id":"event-0023","record_revisions":{"release:v0.6.3":1},"release_version":"v0.6.3","schema_version":2}
+{"data":{"fields":["git_base_ref","git_base_sha","git_commit_count","git_head_ref","git_head_sha","git_range"]},"event":"release.updated","event_id":"event-0024","record_revisions":{"release:v0.6.3":2},"release_version":"v0.6.3","schema_version":2}
+{"data":{"row_count":1},"event":"audit.created","event_id":"event-0025","record_revisions":{"commit_audit_sheet":1},"release_version":"v0.6.3","schema_version":2}
+{"data":{"updated_rows":1},"event":"audit.updated","event_id":"event-0026","record_revisions":{"commit_audit_sheet":2},"release_version":"v0.6.3","schema_version":2}
+{"data":{"entry_ids":["entry-0001"],"synced_audit_rows":1},"event":"entry.batch_added","event_id":"event-0027","record_revisions":{"commit_audit_sheet":3,"entry:v0.6.3/entry-0001":1,"release:v0.6.3":3},"release_version":"v0.6.3","schema_version":2}
+{"data":{"released_at":"2026-08-19"},"event":"release.finalized","event_id":"event-0028","record_revisions":{"release:v0.6.3":4},"release_version":"v0.6.3","schema_version":2}

taskledger-0.6.3/.ledger/releaseledger/data/ledgers/main/releases/v0.6.2/entries/entry-0001.md

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 2
+entry_id: entry-0001
+release_version: v0.6.2
+kind: changed
+summary:
+  Automatic indexes cache bootstrapping before canonical mutations with quarantine-based
+  recovery for unbound caches
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:6305f28
+paths:
+  - taskledger/storage/index_cache.py
+issues: []
+prs: []
+sources: []
+contributors: []
+breaking: false
+internal: false
+order: 1
+---

taskledger-0.6.3/.ledger/releaseledger/data/ledgers/main/releases/v0.6.2/entries/entry-0002.md

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 2
+entry_id: entry-0002
+release_version: v0.6.2
+kind: changed
+summary:
+  Indexes mount is fixed to cache storage; `storage set indexes cache` is now
+  an idempotent topology request and non-cache indexes storage is rejected directly
+status: accepted
+audience: null
+scopes: []
+source_refs: []
+paths:
+  - taskledger/api/storage.py
+issues: []
+prs: []
+sources:
+  - git:6305f28
+contributors: []
+breaking: false
+internal: false
+order: 2
+---

taskledger-0.6.3/.ledger/releaseledger/data/ledgers/main/releases/v0.6.2/entries/entry-0003.md

@@ -0,0 +1,27 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 2
+entry_id: entry-0003
+release_version: v0.6.2
+kind: fixed
+summary:
+  "`reindex` command now reports cache recovery results and surfaces structured
+  errors for recovery failures"
+status: accepted
+audience: null
+scopes: []
+source_refs: []
+paths:
+  - taskledger/services/tasks.py
+issues: []
+prs: []
+sources:
+  - git:6305f28
+contributors: []
+breaking: false
+internal: false
+order: 3
+---

taskledger-0.6.3/.ledger/releaseledger/data/ledgers/main/releases/v0.6.2/entries/entry-0004.md

@@ -0,0 +1,25 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0004
+release_version: v0.6.2
+kind: docs
+summary: Documented indexes cache recovery behavior and multi-machine sync workflow
+status: accepted
+audience: null
+scopes: []
+source_refs: []
+paths:
+  - docs/command_contract.md
+issues: []
+prs: []
+sources:
+  - git:6305f28
+contributors: []
+breaking: false
+internal: false
+order: 4
+---

taskledger-0.6.3/.ledger/releaseledger/data/ledgers/main/releases/v0.6.2/release.md

@@ -0,0 +1,26 @@
+---
+schema_version: 2
+object_type: release
+versioning:
+  schema_version: 1
+  revision: 6
+version: v0.6.2
+status: released
+title: Release v0.6.2
+released_at: "2026-08-15"
+previous_version: v0.6.1
+cancel_reason: null
+superseded_by: null
+changelog_file: null
+boundary_ref: null
+source_refs: []
+source_count: null
+entry_count: 4
+artifact_count: 0
+git_base_ref: null
+git_base_sha: null
+git_head_ref: null
+git_head_sha: null
+git_range: null
+git_commit_count: null
+---

taskledger-0.6.3/.ledger/releaseledger/data/ledgers/main/releases/v0.6.3/audit/commit-audit.yaml

@@ -0,0 +1,135 @@
+schema_version: 1
+object_type: commit_audit_sheet
+versioning:
+  schema_version: 1
+  revision: 3
+release_version: v0.6.3
+git_base_ref: v0.6.2
+git_base_sha: 196a79e85e7abf1296637bec7500c689011e054d
+git_head_ref: HEAD
+git_head_sha: 713acfa2be8891f88d889121dd769656443947f3
+git_range: 196a79e85e7abf1296637bec7500c689011e054d..713acfa2be8891f88d889121dd769656443947f3
+commit_count: 1
+rows:
+  - sha: 713acfa2be8891f88d889121dd769656443947f3
+    source_ref: git:713acfa2be8891f88d889121dd769656443947f3
+    short_sha: 713acfa
+    changed_paths:
+      - docs/command_contract.md
+      - docs/full_task_cycle.md
+      - docs/usage.md
+      - scripts/find_code_clones.py
+      - skills/taskledger/SKILL.md
+      - specs/behavior/features/implementation_checks/implementation-checks.feature
+      - taskledger/api/__init__.py
+      - taskledger/api/config.py
+      - taskledger/api/handoff.py
+      - taskledger/api/introductions.py
+      - taskledger/api/locks.py
+      - taskledger/api/plans.py
+      - taskledger/api/project.py
+      - taskledger/api/questions.py
+      - taskledger/api/repair.py
+      - taskledger/api/reviews.py
+      - taskledger/api/search.py
+      - taskledger/api/storage.py
+      - taskledger/api/task_runs.py
+      - taskledger/api/tasks.py
+      - taskledger/cli.py
+      - taskledger/cli_archive.py
+      - taskledger/cli_common.py
+      - taskledger/cli_implement.py
+      - taskledger/cli_ledger.py
+      - taskledger/cli_misc.py
+      - taskledger/cli_plan.py
+      - taskledger/cli_storage.py
+      - taskledger/domain/__init__.py
+      - taskledger/services/agent_logging.py
+      - taskledger/services/agent_transcripts.py
+      - taskledger/services/change_tracking.py
+      - taskledger/services/check_tracking.py
+      - taskledger/services/command_runner.py
+      - taskledger/services/doctor.py
+      - taskledger/services/doctor_checks/project_scan.py
+      - taskledger/services/doctor_checks/task_checks.py
+      - taskledger/services/git_sync.py
+      - taskledger/services/handoff.py
+      - taskledger/services/implementation_flow.py
+      - taskledger/services/lock_inventory.py
+      - taskledger/services/navigation.py
+      - taskledger/services/next_action_logic.py
+      - taskledger/services/plan_input.py
+      - taskledger/services/plan_materialization.py
+      - taskledger/services/planning_flow.py
+      - taskledger/services/runtime_info.py
+      - taskledger/services/task_archive.py
+      - taskledger/services/task_collections.py
+      - taskledger/services/task_export.py
+      - taskledger/services/task_lifecycle.py
+      - taskledger/services/task_repair.py
+      - taskledger/services/task_reports.py
+      - taskledger/services/tasks.py
+      - taskledger/services/tree.py
+      - taskledger/services/usage.py
+      - taskledger/services/validation_flow.py
+      - taskledger/services/worker_context.py
+      - taskledger/storage/__init__.py
+      - taskledger/storage/index_cache.py
+      - taskledger/storage/layout_migration.py
+      - taskledger/storage/ledgercore_backend.py
+      - taskledger/storage/migrations.py
+      - taskledger/storage/paths.py
+      - taskledger/storage/project_config.py
+      - taskledger/storage/project_context.py
+      - taskledger/storage/repos.py
+      - taskledger/storage/task_ids.py
+      - taskledger/storage/task_store.py
+      - taskledger/storage/worker_pipeline_config.py
+      - tests/conftest.py
+      - tests/test_agent_command_logging.py
+      - tests/test_agent_session_protocol.py
+      - tests/test_command_example_linter.py
+      - tests/test_compact_mutation_output.py
+      - tests/test_doctor.py
+      - tests/test_domain_policies.py
+      - tests/test_help_subprocess.py
+      - tests/test_implementation_checks.py
+      - tests/test_import_boundaries.py
+      - tests/test_indexes_cache_recovery.py
+      - tests/test_ledgercore_compat.py
+      - tests/test_search.py
+      - tests/test_service_boundaries.py
+      - tests/test_task_report.py
+      - tests/test_taskledger_sibling_storage.py
+      - tests/test_workspace_snapshot.py
+    stats:
+      files_changed: 0
+      insertions: 675
+      deletions: 383
+    inspected: true
+    inspected_paths:
+      - taskledger/cli.py
+      - taskledger/cli_common.py
+      - taskledger/cli_implement.py
+      - taskledger/cli_plan.py
+      - taskledger/services/agent_logging.py
+      - taskledger/services/command_runner.py
+      - taskledger/services/implementation_flow.py
+      - tests/test_agent_command_logging.py
+      - tests/test_implementation_checks.py
+      - docs/command_contract.md
+      - docs/full_task_cycle.md
+      - docs/usage.md
+    observed_behavior:
+      Managed plan and implement command wrappers now preserve the
+      exact child argv, execute from the CLI invocation directory or explicit root,
+      capture stdout and stderr in structured results, show those streams in human mode,
+      and record the child cwd in managed command logs. Focused tests cover argv, cwd,
+      human output, JSON output, and transcript logging.
+    public_impact: public
+    decision: accepted
+    evidence_subject: "feat: improve transcript logging"
+    target_entry_id: entry-0001
+    notes:
+      The remaining changed paths are import/export ordering, formatting, lint
+      cleanup, and supporting refactors without separate release-note behavior.

taskledger-0.6.3/.ledger/releaseledger/data/ledgers/main/releases/v0.6.3/entries/entry-0001.md

@@ -0,0 +1,40 @@
+---
+schema_version: 2
+object_type: release_entry
+versioning:
+  schema_version: 1
+  revision: 1
+entry_id: entry-0001
+release_version: v0.6.3
+kind: changed
+summary:
+  Improved managed commands to preserve child arguments, working directories,
+  output, and execution context
+status: accepted
+audience: null
+scopes: []
+source_refs:
+  - git:713acfa2be8891f88d889121dd769656443947f3
+paths:
+  - taskledger/cli.py
+  - taskledger/cli_common.py
+  - taskledger/cli_implement.py
+  - taskledger/cli_plan.py
+  - taskledger/services/agent_logging.py
+  - taskledger/services/command_runner.py
+  - taskledger/services/implementation_flow.py
+  - tests/test_agent_command_logging.py
+  - tests/test_implementation_checks.py
+  - docs/command_contract.md
+  - docs/full_task_cycle.md
+  - docs/usage.md
+issues: []
+prs: []
+sources: []
+contributors: []
+breaking: false
+internal: false
+order: 1
+---
+
+Planning and implementation command results and managed command logs now expose the child working directory and captured stdout/stderr. Human mode emits captured streams, while JSON mode keeps them in the result envelope.

taskledger-0.6.3/.ledger/releaseledger/data/ledgers/main/releases/v0.6.3/release.md

@@ -0,0 +1,26 @@
+---
+schema_version: 2
+object_type: release
+versioning:
+  schema_version: 1
+  revision: 4
+version: v0.6.3
+status: released
+title: Release v0.6.3
+released_at: "2026-08-19"
+previous_version: v0.6.2
+cancel_reason: null
+superseded_by: null
+changelog_file: docs/changelog.md
+boundary_ref: null
+source_refs: []
+source_count: null
+entry_count: 1
+artifact_count: 0
+git_base_ref: v0.6.2
+git_base_sha: 196a79e85e7abf1296637bec7500c689011e054d
+git_head_ref: HEAD
+git_head_sha: 713acfa2be8891f88d889121dd769656443947f3
+git_range: 196a79e85e7abf1296637bec7500c689011e054d..713acfa2be8891f88d889121dd769656443947f3
+git_commit_count: 1
+---

{taskledger-0.6.1/taskledger.egg-info → taskledger-0.6.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: taskledger
-Version: 0.6.1
+Version: 0.6.3
 Summary: Durable project-state storage and CLI for coding workflows
 Author: Taskledger Contributors
 Maintainer: Holger Nahrstaedt

{taskledger-0.6.1 → taskledger-0.6.3}/docs/changelog.md

@@ -2,6 +2,31 @@
 
 > **Generated by releaseledger.** Manual edits may be overwritten. Update releaseledger entries and rebuild this file instead.
 
+## [v0.6.3] - 2026-08-19
+
+### Changed
+
+- Improved managed commands to preserve child arguments, working directories, output, and execution context
+
+<!-- generated by releaseledger -->
+
+## [v0.6.2] - 2026-08-15
+
+### Changed
+
+- Automatic indexes cache bootstrapping before canonical mutations with quarantine-based recovery for unbound caches
+- Indexes mount is fixed to cache storage; `storage set indexes cache` is now an idempotent topology request and non-cache indexes storage is rejected directly
+
+### Fixed
+
+- `reindex` command now reports cache recovery results and surfaces structured errors for recovery failures
+
+### Documentation
+
+- Documented indexes cache recovery behavior and multi-machine sync workflow
+
+<!-- generated by releaseledger -->
+
 ## [v0.6.1] - 2026-08-14
 
 ### Added

{taskledger-0.6.1 → taskledger-0.6.3}/docs/command_contract.md

@@ -443,7 +443,16 @@ to a durable non-active stage rather than directly re-entering an active stage.
 ## Managed command wrappers
 
 `plan command` and `implement command` mirror the inner command exit code by
-default.
+default. Both wrappers pass the argument vector after `--` to the child without a
+shell. They execute the child from the CLI invocation directory, or the explicit
+`--root` directory, even when Taskledger discovers an ancestor workspace root for
+ledger state, artifacts, and logs.
+
+Captured stdout and stderr are included in the command result. Human mode emits
+those streams before the recorded-command summary, while JSON mode keeps them only
+inside the single JSON result envelope. The result and managed-shell log also record
+the child cwd. `--allow-failure` changes only the wrapper exit code; the recorded
+child exit code and failed check remain unchanged.
 
 Use `--allow-failure` when you intentionally want to record a non-zero inner
 exit code while returning wrapper exit code `0`:
@@ -664,15 +673,24 @@ taskledger ledger doctor
 ```
 
 Checkout-scoped indexes under the resolved cache mount are optional derived
-caches or registries. Task, plan, and run commands must continue to work from
-canonical Markdown/YAML records even when cache files are absent. The remaining
-derived caches may be plain JSON arrays with no version metadata and can be
-rebuilt with:
+caches or registries. Read-only commands continue to work from canonical
+Markdown/YAML records and do not initialize a missing cache. Before a canonical
+mutation, Taskledger initializes a missing or empty cache binding and rebuilds
+the derived indexes. A non-empty cache without its binding marker is atomically
+quarantined beside the cache and rebuilt from canonical records. Conflicting or
+invalid markers, symlinks, and non-directory cache paths are not adopted
+automatically. The remaining derived caches may be plain JSON arrays with no
+version metadata and can be rebuilt explicitly with:
 
 ```bash
 taskledger reindex
 ```
 
+`taskledger repair index` uses the same recovery path and reports any quarantine
+location. The `indexes` mount is fixed to cache storage, so
+`taskledger storage set indexes cache` is an idempotent topology request;
+non-cache indexes storage is rejected directly.
+
 A newer storage version than the installed taskledger supports is rejected with
 a clear error.
 

{taskledger-0.6.1 → taskledger-0.6.3}/docs/full_task_cycle.md

@@ -118,10 +118,12 @@ taskledger plan command -- pytest tests/test_parser.py -q
 taskledger plan command -- python -m compileall taskledger
 ```
 
-`plan command` records command exit code and output in planning diagnostics.
-With transcript logging enabled, the same output is also captured in the
-ledger-level command transcript. Use it to build evidence into the plan before
-proposal.
+`plan command` records command exit code, stdout, stderr, and actual child cwd in
+planning diagnostics. It passes the inner argv without a shell and runs from the CLI
+invocation directory. Workspace discovery may use an ancestor for Taskledger state,
+but it must not change the managed child's cwd. With transcript logging enabled, the
+same output is also captured in the ledger-level command transcript. Use it to build
+evidence into the plan before proposal.
 
 ## 6. Materialize Todos And Approve
 
@@ -188,7 +190,10 @@ taskledger implement status
 ```
 
 Use `implement command` when you want taskledger to record a command run as
-part of implementation. With transcript logging enabled, it also records managed
+part of implementation. It preserves the inner argv, runs from the CLI invocation
+directory, and records the child cwd, exit code, stdout, and stderr. In human mode,
+captured child output is shown before the command summary. In JSON mode, streams stay
+inside the result envelope. With transcript logging enabled, it also records managed
 stdout/stderr in the task transcript. Use `implement deviation` when the
 implementation differs from the approved plan.
 

{taskledger-0.6.1 → taskledger-0.6.3}/docs/sync.md

@@ -42,6 +42,15 @@ taskledger sync git push
 
 ## Second PC bootstrap
 
+Indexes are checkout-local derived state and are not synchronized between PCs.
+After opening a project on a new machine, deleting the local cache, or allowing
+the cache to be evicted, read-only commands continue to use canonical records.
+The first mutating command creates the local Ledgercore cache binding and
+rebuilds the indexes automatically; no second `taskledger init` is required.
+If a non-empty unbound cache is found, Taskledger preserves it as an
+`indexes.quarantine-*` sibling before rebuilding. Use `taskledger repair index`
+for explicit cache health repair.
+
 Clone both repositories as siblings:
 
 ```bash

{taskledger-0.6.1 → taskledger-0.6.3}/docs/usage.md

@@ -593,10 +593,14 @@ taskledger implement command --allow-failure -- python -c "raise SystemExit(7)"
 ```
 
 When `[agent_logging].enabled = true` in `.ledger/taskledger/config.toml`, `taskledger`
-records CLI invocations and managed command outputs. Keep logging opt-in because
-stdout/stderr may contain sensitive data. Route task-relevant commands through
-`plan command` and `implement command` so their output is included in task
-transcripts and reports.
+records CLI invocations and managed command outputs. Both managed wrappers execute
+the exact argv after `--` without a shell and from the CLI invocation directory, or
+the explicit `--root` directory. Taskledger may discover an ancestor workspace for
+ledger state, but that does not change the child's cwd. Human mode displays captured
+stdout/stderr before the summary. JSON mode contains stdout/stderr and cwd only in
+the result object. Keep logging opt-in because stdout/stderr may contain sensitive
+data. Route task-relevant commands through `plan command` and `implement command`
+so their output is included in task transcripts and reports.
 
 > taskledger context --for implementation --format markdown
 > taskledger implement start

{taskledger-0.6.1 → taskledger-0.6.3}/scripts/find_code_clones.py

@@ -119,7 +119,7 @@ def _normalized_windows(
     if len(normalized) < min_lines:
         return []
     windows: list[tuple[int, tuple[str, ...]]] = []
-    for offset in range(0, len(normalized) - min_lines + 1):
+    for offset in range(len(normalized) - min_lines + 1):
         start_line = normalized[offset][0]
         body = tuple(item[1] for item in normalized[offset : offset + min_lines])
         windows.append((start_line, body))

{taskledger-0.6.1 → taskledger-0.6.3}/skills/taskledger/SKILL.md

@@ -281,7 +281,9 @@ The plan file should use version ids like `plan-v1`, `plan-v2` in references. Do
    - Make the code changes
    - `taskledger implement change --path ... --kind edit --summary "..."`
    - Run verification through `taskledger implement command -- ...` so exit code and output are recorded.
-   - `implement command` mirrors the inner command exit code by default. Use `--allow-failure` when you intentionally want to record a non-zero command without failing the wrapper command.
+   - Managed `plan command` and `implement command` pass argv after `--` without a shell and run from the CLI invocation directory, or explicit `--root` directory. Workspace discovery does not change the child cwd.
+   - Human mode emits captured child stdout/stderr before the summary. JSON mode keeps stdout/stderr and the actual child cwd inside the result envelope.
+   - Both wrappers mirror the inner command exit code by default. Use `--allow-failure` when you intentionally want to record a non-zero inner command without failing the wrapper command; the recorded child failure remains unchanged.
    - Mark each todo done only after the relevant command or inspection evidence exists: `taskledger todo done <todo-id> --evidence "check-NNNN exited 0"`.
    - Optional: add `--source planner|implementer|user` to override the inferred source, though this is rarely needed.
 6. `taskledger implement checklist` after each meaningful change to track progress.
@@ -393,7 +395,7 @@ taskledger validate check --criterion ac-0001 --status pass --evidence "pytest t
 - Log every meaningful implementation change with `taskledger implement change`.
 - Record deviations from the approved plan with `taskledger implement deviation`.
 - Mark todos done with evidence: `taskledger todo done <todo-id> --evidence "pytest -q"`.
-- When transcript logging is enabled in project config, run task-relevant commands through `taskledger plan command -- ...` or `taskledger implement command -- ...` so stdout/stderr becomes durable transcript evidence.
+- When transcript logging is enabled in project config, run task-relevant commands through `taskledger plan command -- ...` or `taskledger implement command -- ...` so stdout/stderr becomes durable transcript evidence. The managed result and shell log include the actual child cwd.
 - Do not paste secrets into command arguments, evidence strings, or expected command output when transcript logging is enabled.
 - Use `taskledger handoff create --mode implementation|validation --intended-actor agent --intended-harness codex` when switching actor or harness.
 - Use `taskledger handoff claim handoff-0001` before continuing work from a handoff.
@@ -459,7 +461,13 @@ Lock recovery decision tree:
 - If doctor reports a running implementation run with no matching lock and the task is still resumable, run `taskledger implement resume --task TASK --run RUN --reason "Reacquire implementation lock."`.
 - Never use repair to bypass approval, validation, or active implementation locks.
 - If validation fails, record the failure and return to implementation or replanning.
-- If indexes are stale, run `taskledger repair index`; `taskledger reindex` is a compatibility alias.
+- Missing or empty checkout-local indexes caches are bootstrapped automatically
+  before canonical mutations and rebuilt from authoritative records. A
+  non-empty unbound cache is quarantined rather than deleted; conflicting
+  markers are not auto-adopted. Read-only commands do not bootstrap the cache.
+- If indexes are stale or an unusual cache-binding problem needs explicit
+  repair, run `taskledger repair index`; `taskledger reindex` is a compatibility
+  alias. Do not tell users to manually create `.ledger-project.toml`.
 - If a task is truly cancelled and the user wants to continue, use `taskledger task uncancel --task TASK_REF --reason "..." [--to STAGE]` to restore a safe durable stage before re-entering an active stage.
 - If dependencies must be bypassed, only a user waiver may unblock implementation.
 

{taskledger-0.6.1 → taskledger-0.6.3}/specs/behavior/features/implementation_checks/implementation-checks.feature

@@ -43,18 +43,10 @@ Feature: Implementation Checks
     @req-REQ-0026 @ac-AC-0321
     Example: Human Output Shows Check
       Given the pytest test setup is prepared
-      When human output shows check is executed
+      When managed command execution is exercised
       Then r.exit_code equals 0
       Then 'recorded check check-' is in r.output
-
-    @req-REQ-0026 @ac-AC-0320
-    Example: Failed Command Creates Failed Check
-      Given the pytest test setup is prepared
-      When failed command creates failed check is executed
-      Then r.exit_code equals 1
-
-    @req-REQ-0026 @ac-AC-0315
-    Example: Allow Failure Records Check
-      Given the pytest test setup is prepared
-      When allow failure records check is executed
-      Then r.exit_code equals 0
+      Then child stdout and stderr are visible in human output
+      Then the managed result reports the actual child cwd
+      Then the child receives the exact argv after --
+      Then planning and implementation wrappers use the same execution contract

{taskledger-0.6.1 → taskledger-0.6.3}/taskledger/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.6.1'
-__version_tuple__ = version_tuple = (0, 6, 1)
+__version__ = version = '0.6.3'
+__version_tuple__ = version_tuple = (0, 6, 3)
 
-__commit_id__ = commit_id = 'g7491339c7'
+__commit_id__ = commit_id = 'gecce3598f'

{taskledger-0.6.1 → taskledger-0.6.3}/taskledger/api/locks.py

@@ -1,4 +1,4 @@
 from taskledger.services.tasks import break_lock, list_locks, show_lock
 from taskledger.storage.task_store import load_active_locks
 
-__all__ = ["show_lock", "break_lock", "list_locks", "load_active_locks"]
+__all__ = ["break_lock", "list_locks", "load_active_locks", "show_lock"]

{taskledger-0.6.1 → taskledger-0.6.3}/taskledger/api/repair.py

@@ -166,7 +166,7 @@ def repair_locks(
         try:
             break_lock(workspace_root, entry.task_id, reason=reason)
             repaired.append(entry.task_id)
-        except Exception as exc:
+        except Exception as exc:  # noqa: BLE001
             failed.append(
                 {
                     "task_id": entry.task_id,