taskledger 0.6.2__tar.gz → 0.6.4__tar.gz

{taskledger-0.6.2 → taskledger-0.6.4}/.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.2/.archledger.toml → taskledger-0.6.4/.ledger/archledger/.archledger-migration-20260821T090309Z/config.toml

@@ -1,15 +1,9 @@
-# Project-local archledger configuration.
-# This file lives in the source project root.
-config_version = 10
-archledger_dir = ".archledger"
-
-# Stable project identity. Commit this with your source tree.
-project_uuid = "c864dcee-bb0a-43e1-b7d0-b9289fe1bf3a"
-project_name = "taskledger"
+# Stable Archledger configuration.
+# Paths are resolved from the project root and canonical data mount.
+config_version = 12
 
 [ledger]
 code = "al"
-name = "archledger"
 
 [ids]
 width = 4
@@ -47,8 +41,7 @@ schema_version = 4
 [build]
 default_output = "ARCHITECTURE.md"
 default_format = "markdown"
-# [build].default_output_dir is relative to the directory containing
-# archledger.toml or .archledger.toml.
+# [build].default_output_dir is relative to the project root.
 default_output_dir = "."
 include_draft = false
 include_superseded = false
@@ -116,6 +109,7 @@ exclude = [
   ".ruff_cache/**",
   "dist/**",
   "build/**",
+  ".ledger/**",
 ]
 max_file_bytes = 1000000
 hash_algorithm = "sha256"

taskledger-0.6.4/.ledger/archledger/.ledger-project.toml

@@ -0,0 +1,6 @@
+schema_version = 1
+layout_version = 3
+project_uuid = "081c7c05-2d10-42b7-9b37-3d814c2f400a"
+tool = "archledger"
+mount = "config"
+storage = "project"

taskledger-0.6.4/.ledger/archledger/config.toml

@@ -0,0 +1,115 @@
+# Stable Archledger configuration.
+# Paths are resolved from the project root and canonical data mount.
+config_version = 12
+
+[ledger]
+code = "al"
+
+[ids]
+width = 4
+
+[ids.kind_map]
+acceptance_criterion = "ac"
+adr = "adr"
+archive_tombstone = "archive"
+black_box = "block"
+concept = "concept"
+constraint = "constraint"
+context_interface = "context"
+diagram = "diagram"
+glossary_term = "glossary"
+infrastructure = "deploy"
+interface = "block"
+quality_goal = "quality"
+quality_requirement = "quality"
+quality_scenario = "quality"
+requirement = "content"
+risk = "risk"
+runtime_scenario = "runtime"
+section = "content"
+stakeholder = "content"
+strategy_item = "strategy"
+white_box = "block"
+
+[source]
+format = "markdown"
+front_matter = "yaml"
+section_extension = ".md"
+record_extension = ".md"
+schema_version = 4
+
+[build]
+default_output = "architecture.md"
+default_format = "markdown"
+# [build].default_output_dir is relative to the project root.
+default_output_dir = "docs"
+include_draft = false
+include_superseded = false
+strict = false
+keep_intermediate = false
+converter = "auto"
+pdf_engine = ""
+reference_docx = ""
+
+[profiles]
+enabled = [
+  "arc42",
+]
+default = "arc42"
+
+[profiles.arc42]
+kind = "documentation"
+template = "arc42"
+sections_dir = "profiles/arc42/sections"
+build_template = "arc42_document"
+include_help = false
+
+[diagrams]
+enabled = false
+renderer = "pass-through"
+default_type = "text"
+output_dir = "diagrams"
+image_format = "svg"
+kroki_url = ""
+
+[arc42]
+template_version = "9.0-EN"
+language = "en"
+title = "Architecture Documentation"
+include_help = false
+
+[skill]
+installed = false
+path = "skills/archledger/SKILL.md"
+
+[tracking]
+enabled = true
+# source-state.json stores SHA-256 content hashes only for files.
+# It does not persist mtimes or file sizes. Directory hashes are
+# derived from file hashes after scanning.
+state_file = "source-state.json"
+scanner = "auto"
+include = [
+  "**/*.py",
+  "**/*.toml",
+  "**/*.md",
+  "**/*.adoc",
+  "**/*.rst",
+  "**/*.j2",
+  "**/*.yaml",
+  "**/*.yml",
+  "**/*.json",
+]
+exclude = [
+  ".git/**",
+  ".venv/**",
+  "**/__pycache__/**",
+  ".mypy_cache/**",
+  ".pytest_cache/**",
+  ".ruff_cache/**",
+  "dist/**",
+  "build/**",
+  ".ledger/**",
+]
+max_file_bytes = 1000000
+hash_algorithm = "sha256"

taskledger-0.6.4/.ledger/archledger/data/.ledger-project.toml

@@ -0,0 +1,6 @@
+schema_version = 1
+layout_version = 3
+project_uuid = "081c7c05-2d10-42b7-9b37-3d814c2f400a"
+tool = "archledger"
+mount = "data"
+storage = "project"

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/document-state.json

@@ -1,9 +1,9 @@
 {
   "documents": {
     "arc42:markdown:draft=false:superseded=false": {
-      "fingerprint": "sha256:90460011ff7f175475e9656f06c3472dfaf38d193f6b057612d880e739849df2",
+      "fingerprint": "sha256:c8cf1037ab0c60db24aa1e20bc8a1bc3cf4d54c758ffe4b876f3b2ed80f5cb01",
       "input_count": 84,
-      "version": 1
+      "version": 5
     }
   },
   "schema": "archledger.document-state.v1"

taskledger-0.6.4/.ledger/archledger/data/migrations/20260821T090309Z-ledgercore-0.4-repository-storage.json

@@ -0,0 +1,118 @@
+{
+  "backup": "/home/nahrstaedt/src/ledger/taskledger/.ledger/backups/archledger-20260821T090309Z",
+  "copied": [
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/archive/records/building_blocks/block-0083.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/archive/records/concepts/concept-0081.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/archive/records/runtime/runtime-0076.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/archive/records/runtime/runtime-0084.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/document-state.json",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/profiles/arc42/sections/content-0001.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/profiles/arc42/sections/content-0002.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/profiles/arc42/sections/content-0003.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/profiles/arc42/sections/content-0004.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/profiles/arc42/sections/content-0005.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/profiles/arc42/sections/content-0006.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/profiles/arc42/sections/content-0007.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/profiles/arc42/sections/content-0008.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/profiles/arc42/sections/content-0009.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/profiles/arc42/sections/content-0010.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/profiles/arc42/sections/content-0011.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/profiles/arc42/sections/content-0012.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/building_blocks/block-0029.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/building_blocks/block-0030.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/building_blocks/block-0031.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/building_blocks/block-0032.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/building_blocks/block-0033.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/building_blocks/block-0034.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/concepts/concept-0040.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/concepts/concept-0041.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/concepts/concept-0042.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/concepts/concept-0043.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/concepts/concept-0044.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/concepts/concept-0045.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/concepts/concept-0082.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/concepts/concept-0085.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/concepts/concept-0086.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/constraints/constraint-0016.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/constraints/constraint-0017.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/constraints/constraint-0018.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/constraints/constraint-0019.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/contexts/context-0020.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/contexts/context-0021.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/contexts/context-0022.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/contexts/context-0023.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/decisions/adr-0046.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/decisions/adr-0047.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/decisions/adr-0048.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/decisions/adr-0049.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/decisions/adr-0050.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/decisions/adr-0051.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/deployment/deploy-0039.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/glossary/glossary-0061.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/glossary/glossary-0062.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/glossary/glossary-0063.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/glossary/glossary-0064.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/glossary/glossary-0065.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/glossary/glossary-0066.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/glossary/glossary-0067.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/glossary/glossary-0068.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/glossary/glossary-0069.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/glossary/glossary-0070.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/glossary/glossary-0071.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/glossary/glossary-0072.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/glossary/glossary-0073.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/quality_requirements/quality-0052.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/quality_requirements/quality-0053.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/quality_requirements/quality-0054.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/quality_requirements/quality-0055.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/quality_requirements/quality-0056.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/requirements/content-0013.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/requirements/content-0014.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/requirements/content-0015.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/risks/risk-0057.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/risks/risk-0058.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/risks/risk-0059.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/risks/risk-0060.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/runtime/runtime-0035.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/runtime/runtime-0036.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/runtime/runtime-0037.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/runtime/runtime-0038.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/runtime/runtime-0074.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/runtime/runtime-0075.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/runtime/runtime-0077.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/runtime/runtime-0078.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/runtime/runtime-0087.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/runtime/runtime-0088.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/stakeholders/content-0079.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/stakeholders/content-0080.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/strategy/strategy-0024.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/strategy/strategy-0025.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/strategy/strategy-0026.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/strategy/strategy-0027.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/records/strategy/strategy-0028.md",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/source-state.json",
+    "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/.archledger-migration-20260821T090309Z/archledger/storage.yaml"
+  ],
+  "kind": "archledger_project_migration",
+  "source": "/home/nahrstaedt/src/ledger/taskledger/.archledger",
+  "target": "/home/nahrstaedt/src/ledger/taskledger/.ledger/archledger/data",
+  "uuid_evidence": [
+    [
+      "/home/nahrstaedt/src/ledger/taskledger/.ledger/ledger.toml",
+      "081c7c05-2d10-42b7-9b37-3d814c2f400a"
+    ],
+    [
+      "/home/nahrstaedt/src/ledger/taskledger/.archledger.toml",
+      "081c7c05-2d10-42b7-9b37-3d814c2f400a"
+    ],
+    [
+      "/home/nahrstaedt/src/ledger/taskledger/.archledger/storage.yaml",
+      "081c7c05-2d10-42b7-9b37-3d814c2f400a"
+    ],
+    [
+      "/home/nahrstaedt/src/ledger/taskledger/.archledger/source-state.json",
+      "081c7c05-2d10-42b7-9b37-3d814c2f400a"
+    ]
+  ],
+  "version": 1
+}

taskledger-0.6.4/.ledger/archledger/data/migrations/migration-cbe21be3f9dc3db4b03f6366.json

@@ -0,0 +1,14 @@
+{
+  "migration_id": "migration-cbe21be3f9dc3db4b03f6366",
+  "migration": "identity-ledgercore",
+  "completed_at": "2026-08-21T09:03:50.559860+00:00",
+  "project_uuid_before": "081c7c05-2d10-42b7-9b37-3d814c2f400a",
+  "project_uuid_after": "081c7c05-2d10-42b7-9b37-3d814c2f400a",
+  "source_fingerprint": "sha256:1ba4d0cdcaf09e4a0f706e6d3325b36bb8f07c99a47f99b9a4350efa9e384508",
+  "canonical_fingerprint": "sha256:1ba4d0cdcaf09e4a0f706e6d3325b36bb8f07c99a47f99b9a4350efa9e384508",
+  "legacy_source_preserved": true,
+  "cleanup_available": true,
+  "cleanup_command": "archledger migrate cleanup identity-ledgercore --dry-run",
+  "copied_paths": [],
+  "rewritten_paths": []
+}

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/profiles/arc42/sections/content-0001.md

@@ -8,14 +8,20 @@ order: 10
 status: accepted
 body_format: markdown
 kind: content
-version: 2
+version: 4
 ---
 
-taskledger is a task-first durable state layer for staged coding work. It provides a Python CLI and library that manages the full lifecycle of coding tasks: creation, planning, user approval, implementation, validation, and completion.
+## Current canonical storage boundary
+
+The current canonical design uses the schema-3 Ledgercore project at `.ledger/ledger.toml` with Taskledger configuration at `.ledger/task/config.toml`. Taskledger mounts are separated into authoritative durable `data`, checkout-local `runtime`, diagnostic `logs`, and rebuildable cache `indexes`. Canonical initialization never creates `.taskledger/` or root `taskledger.toml`; those names are legacy migration inputs only.
+
+Taskledger operational state is resolved outside the application source repository by default. `.ledger/ledger.local.toml` is a machine-local override and `.taskledger/` is ignored as legacy residue. The legacy `.taskledger` layout described in older sections remains compatibility and migration material, not the canonical storage design.
+
+Taskledger is a task-first durable state layer for staged coding work. It provides a Python CLI and library that manages the full lifecycle of coding tasks: creation, planning, user approval, implementation, validation, and completion.
 
 The system is designed for use by both human developers and automated coding agents. Its primary goals are:
 
-- **Durable task state**: Every task, plan, run, lock, todo, and validation check is persisted as a Markdown record with YAML front matter in the project `.taskledger/` directory. State survives process restarts, context switches, and handoffs between actors.
+- **Durable task state**: Every task, plan, run, lock, todo, and validation check is persisted as a Markdown record with YAML front matter in the project Ledgercore data mount. State survives process restarts, context switches, and handoffs between actors.
 - **Explicit lifecycle gates**: Transitions between stages (draft -> planning -> plan_review -> approved -> implementing -> implemented -> validating -> done) are enforced by policy decisions. User approval is required before implementation begins. Validation checks gate completion.
 - **Fresh-context handoffs**: Agents and humans can create, claim, and close handoff records that capture enough context (task state, plan, todos, questions, lock status) for a fresh process to continue work without reading the entire history.
 - **Machine-readable output**: Every CLI command supports `--json` for structured output with a stable envelope shape (`ok`, `command`, `result_type`, `result`, `events`, `warnings`) and deterministic exit codes.

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/profiles/arc42/sections/content-0002.md

@@ -8,14 +8,14 @@ order: 20
 status: accepted
 body_format: markdown
 kind: content
-version: 2
+version: 5
 ---
 
-taskledger operates under several fixed constraints that shape its architecture:
+Taskledger operates under several fixed constraints that shape its architecture:
 
 - **Python 3.10+ with minimal dependencies**: The runtime depends only on `typer`, `click`, `PyYAML`, `tomli` (Python <3.11), and `ledgercore` for atomic I/O, JSON I/O, YAML I/O, front matter parsing, and cross-ledger ref parsing. No database, no network server, no external service is required.
-- **File-system canonical storage**: All durable state lives in the project `.taskledger/` directory as Markdown files with YAML front matter. This makes state inspectable, diffable, and version-controllable alongside source code.
+- **File-system canonical storage**: All durable state lives in the project Ledgercore mounts configured by `.ledger/ledger.toml`, as Markdown files with YAML front matter. This makes state inspectable, diffable, and version-controllable alongside source code.
 - **CLI-first with machine-readable JSON output**: The primary interface is the `taskledger` CLI command. Every command supports `--json` for structured output. The JSON envelope shape and exit codes are part of the public contract.
 - **Skills outside the package**: Agent skill files (for example `skills/taskledger/SKILL.md`) live outside the Python package and are never packaged as Python package data. The package provides the CLI and library; skill distribution is separate.
-- **Project-local configuration**: Each project has its own `taskledger.toml` and `.taskledger/` directory. There is no global state or central server.
-- **Source-first architecture records**: Arc42 architecture records live under `.archledger/` and are the source of truth for `ARCHITECTURE.md`. `docs/architecture_taskledger_split.md` is a concise human-maintained summary. Skills stay outside both the Python package and the archledger build output.
+- **Project-local configuration**: Each project has its Ledgercore manifest at `.ledger/ledger.toml` and ledger-specific configuration under `.ledger/`. There is no global state or central server.
+- **Source-first architecture records**: Arc42 architecture records are stored in `.ledger/archledger/data` and are the source of truth for `docs/architecture.md`. `docs/architecture_taskledger_split.md` is a concise human-maintained summary. Skills stay outside both the Python package and the archledger build output.

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/profiles/arc42/sections/content-0003.md

@@ -8,10 +8,10 @@ order: 30
 status: accepted
 body_format: markdown
 kind: content
-version: 2
+version: 3
 ---
 
-taskledger operates as a self-contained tool within a software development project. It interacts with four categories of external actors:
+Taskledger operates as a self-contained tool within a software development project. It interacts with four categories of external actors:
 
 1. **Agent harnesses** (pi, codex, chatgpt, and similar) invoke taskledger CLI commands to create tasks, propose plans, log implementation changes, run validation checks, and manage handoffs. They consume `--json` output.
 2. **Human developers** use the CLI directly in terminals for task creation, plan review, approval, lock management, and inspection (`status`, `context`, `next-action`, `doctor`, `monitor`).

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/profiles/arc42/sections/content-0004.md

@@ -8,10 +8,10 @@ order: 40
 status: accepted
 body_format: markdown
 kind: content
-version: 2
+version: 5
 ---
 
-taskledger uses a layered architecture with clear dependency direction: upper layers depend on lower layers, never the reverse.
+Taskledger uses a layered architecture with clear dependency direction: upper layers depend on lower layers, never the reverse.
 
 1. **CLI Layer** (`taskledger/cli*.py`) — Typer commands that parse arguments, resolve task references, call service functions, and render output (human text or JSON).
 2. **API Layer** (`taskledger/api/*.py`) — Stable public wrappers that mirror the CLI surface for programmatic use.
@@ -32,9 +32,9 @@ Key architectural choices:
 
 ## Maintenance
 
-`ARCHITECTURE.md` in the repository root is generated from archledger source records. Do not edit it directly.
+`docs/architecture.md` is generated from Archledger source records. Do not edit it directly.
 
-- **Edit**: `.archledger/profiles/arc42/sections/*.md` for section content, `.archledger/records/**/*.md` for individual records.
-- **Regenerate**: Run `archledger build` to regenerate `ARCHITECTURE.md`.
+- **Edit**: `.ledger/archledger/data/profiles/arc42/sections/*.md` for section content and `.ledger/archledger/data/records/**/*.md` for individual records.
+- **Regenerate**: Run `archledger build` to regenerate `docs/architecture.md`.
 - **Verify**: Run `archledger check` and `pytest -q tests/test_docs_and_skill.py tests/test_service_boundaries.py` after changes.
-- **Authoritative source**: The archledger records under `.archledger/` are the single source of truth for architecture documentation. `docs/architecture_taskledger_split.md` is a concise human-maintained summary.
+- **Authoritative source**: The Archledger records under `.ledger/archledger/data` are the single source of truth for architecture documentation. `docs/architecture_taskledger_split.md` is a concise human-maintained summary.

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/profiles/arc42/sections/content-0007.md

@@ -8,10 +8,10 @@ order: 70
 status: accepted
 body_format: markdown
 kind: content
-version: 2
+version: 3
 ---
 
-taskledger is a single-node, file-system-based tool. Deployment consists of:
+Taskledger is a single-node, file-system-based tool. Deployment consists of:
 
 - **Installation**: `pip install taskledger` (PyPI) or local `pip install -e .`
 - **Project initialization**: `taskledger init` creates `taskledger.toml` and `.taskledger/` in the project root

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/profiles/arc42/sections/content-0012.md

@@ -8,7 +8,7 @@ order: 120
 status: accepted
 body_format: markdown
 kind: content
-version: 2
+version: 3
 ---
 
-Domain terms used throughout taskledger. The full glossary lives in the per-term `glossary-NNNN` records under `.archledger/records/glossary/`. Each term is stored as a record with `term`, `definition`, and reference metadata rather than in this section body.
+Domain terms used throughout taskledger. The full glossary lives in the per-term `glossary-NNNN` records under `.ledger/archledger/data/records/glossary/`. Each term is stored as a record with `term`, `definition`, and reference metadata rather than in this section body.

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/records/building_blocks/block-0029.md

@@ -13,12 +13,12 @@ quality_characteristics: []
 tags: []
 body_format: markdown
 kind: block
-version: 2
+version: 3
 ---
 
 ## Motivation
 
-taskledger decomposes into core layers with downward dependency flow. This isolates persistence, business rules, orchestration, and public interfaces. Low-level persistence primitives are delegated to `ledgercore`, but the layer boundary above it stays in `taskledger/storage/`.
+Taskledger decomposes into core layers with downward dependency flow. This isolates persistence, business rules, orchestration, and public interfaces. Low-level persistence primitives are delegated to `ledgercore`, but the layer boundary above it stays in `taskledger/storage/`.
 
 ## Contained building blocks
 

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/records/concepts/concept-0082.md

@@ -6,7 +6,8 @@ title: Durable code-review evidence
 status: proposed
 section: cross_cutting_concepts
 order: 80
-applies_to: taskledger review record
+applies_to:
+  - taskledger review record
 body_format: markdown
 source_refs:
   - path: taskledger/domain/review.py
@@ -16,7 +17,7 @@ source_refs:
 test_refs:
   - tests/test_code_reviews.py
 kind: concept
-version: 3
+version: 4
 ---
 
 Code review is durable evidence attached to a task. A record captures result, summary/body, reviewer and harness, implementation run, worker step, handoff, and optional Git working-tree or commit metadata. Review records are append-only and may be recorded after a task reaches `done`. They do not create a lifecycle stage, reopen completed work, replace acceptance criteria, or weaken validation completion rules. Source: `taskledger/domain/review.py`, `taskledger/services/code_review.py`. Test coverage: `tests/test_code_reviews.py`.

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/records/concepts/concept-0085.md

@@ -7,10 +7,12 @@ title: Editable plan input preflight
 status: accepted
 section: cross_cutting_concepts
 order: 70
-version: 4
+version: 5
 applies_to:
-  taskledger plan check; taskledger plan upsert; taskledger plan lint; taskledger
-  plan review
+  - taskledger plan check
+  - taskledger plan upsert
+  - taskledger plan lint
+  - taskledger plan review
 body_format: markdown
 ---
 

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/records/concepts/concept-0086.md

@@ -7,10 +7,12 @@ title: Implementation workspace snapshot
 status: accepted
 section: cross_cutting_concepts
 order: 75
-version: 5
+version: 6
 applies_to:
-  taskledger implement start; taskledger implement finish; taskledger validate
-  start; taskledger implement snapshot refresh
+  - taskledger implement start
+  - taskledger implement finish
+  - taskledger validate start
+  - taskledger implement snapshot refresh
 body_format: markdown
 source_refs.1: "path: taskledger/services/implementation_flow.py
 

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/records/strategy/strategy-0024.md

@@ -6,11 +6,21 @@ title: "Layered architecture: CLI → Services → Domain → Storage"
 status: accepted
 section: solution_strategy
 order: 10
-drivers: decoupled layers; testable services; fast agent integration
+drivers:
+  - decoupled layers
+  - testable services
+  - fast agent integration
 constraints:
-  no domain I/O; storage uses ledgercore primitives; bounded CLI filesystem
-  use
-related_adrs: adr-0046 adr-0047 adr-0048 adr-0049 adr-0050 adr-0051
+  - no domain I/O
+  - storage uses ledgercore primitives
+  - bounded CLI filesystem use
+related_adrs:
+  - adr-0046
+  - adr-0047
+  - adr-0048
+  - adr-0049
+  - adr-0050
+  - adr-0051
 body_format: markdown
 kind: strategy
 version: 5

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/records/strategy/strategy-0025.md

@@ -6,11 +6,17 @@ title: Markdown/YAML front matter as canonical records
 status: proposed
 section: solution_strategy
 order: 20
-drivers: human readable state; git diffable records; no database dependency
+drivers:
+  - human readable state
+  - git diffable records
+  - no database dependency
 constraints:
-  strict front matter validation; ledgercore front matter parsing; storage
-  layout v3
-related_adrs: adr-0046 adr-0050
+  - strict front matter validation
+  - ledgercore front matter parsing
+  - storage layout v3
+related_adrs:
+  - adr-0046
+  - adr-0050
 body_format: markdown
 kind: strategy
 version: 4

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/records/strategy/strategy-0026.md

@@ -6,9 +6,14 @@ title: JSON indexes as rebuildable derived caches
 status: proposed
 section: solution_strategy
 order: 30
-drivers: fast list and query operations; canonical records remain source of truth
-constraints: summary index rebuildable on miss; reindex after out of band changes
-related_adrs: adr-0047
+drivers:
+  - fast list and query operations
+  - canonical records remain source of truth
+constraints:
+  - summary index rebuildable on miss
+  - reindex after out of band changes
+related_adrs:
+  - adr-0047
 body_format: markdown
 kind: strategy
 version: 5

{taskledger-0.6.2/.archledger → taskledger-0.6.4/.ledger/archledger/data}/records/strategy/strategy-0027.md

@@ -6,9 +6,14 @@ title: Policy-based lifecycle gate decisions
 status: proposed
 section: solution_strategy
 order: 40
-drivers: testable gate logic; user only actions enforced
-constraints: PolicyContext is gathered explicitly; no I/O in policy functions
-related_adrs: adr-0048
+drivers:
+  - testable gate logic
+  - user only actions enforced
+constraints:
+  - PolicyContext is gathered explicitly
+  - no I/O in policy functions
+related_adrs:
+  - adr-0048
 body_format: markdown
 kind: strategy
 version: 4