agentplane 0.3.4 → 0.3.5

package/dist/.build-manifest.json

@@ -1,13 +1,13 @@
 {
   "schema_version": 1,
   "package_dir": "/home/runner/work/agentplane/agentplane/packages/agentplane",
-  "generated_at": "2026-03-08T19:03:52.699Z",
-  "git_head": "da184e2923016f21bcaa564bc845f32c6e3e93b0",
-  "src_cli_mtime_ms": 1772996575672.1035,
+  "generated_at": "2026-03-09T11:27:01.401Z",
+  "git_head": "048eac0e4c4643f9706ee28a314a47900c8aeda2",
+  "src_cli_mtime_ms": 1773055566738.3289,
   "src_index_mtime_ms": null,
-  "dist_cli_mtime_ms": 1772996631924.989,
+  "dist_cli_mtime_ms": 1773055620787.9597,
   "dist_index_mtime_ms": null,
-  "tsbuildinfo_mtime_ms": 1772996631987.989,
+  "tsbuildinfo_mtime_ms": 1773055620840.9602,
   "watched_runtime_paths": [
     "src",
     "bin/agentplane.js",
@@ -15,7 +15,7 @@
     "bin/runtime-context.js",
     "bin/stale-dist-policy.js"
   ],
-  "watched_runtime_snapshot_hash": "47e9d19f424b6e5b321d1799baea02620444954807af4126b727596d247f6338",
+  "watched_runtime_snapshot_hash": "90fec1d16ff7e43a183c043b40ce90d2da4e35df365aed7509c0ef6a4ee8f40e",
   "watched_runtime_files": [
     {
       "path": "bin/agentplane.js",
@@ -59,8 +59,8 @@
     },
     {
       "path": "src/adapters/task-backend/task-backend-adapter.ts",
-      "sha256": "7a108367bd1f59e9b6a41633258b773558acdeb02759c2d967c01e206fa68676",
-      "size_bytes": 913
+      "sha256": "b071098191f407302cbb37793fd45934d17891b2e2ac628e69903535c5204dc6",
+      "size_bytes": 1034
     },
     {
       "path": "src/agents/agents-template.test.ts",
@@ -84,13 +84,13 @@
     },
     {
       "path": "src/backends/task-backend.test.ts",
-      "sha256": "a11d7bc0242d1019415e4f29377f039868ee1823fafd2e220f135a66023cc3e7",
-      "size_bytes": 75233
+      "sha256": "7995d304c2b494e69a80cb5f1d2ba5c26686d2aeebdca163187ca04b1f426059",
+      "size_bytes": 77948
     },
     {
       "path": "src/backends/task-backend.ts",
-      "sha256": "578eecda648f8893a9babab2dd0c59015e99c8c702aa775592a1f3c6c86a952d",
-      "size_bytes": 572
+      "sha256": "bf16b2ba5f73df3de0f5559ef26d4997926aed81b97b63d59bb5decabcd8e09c",
+      "size_bytes": 641
     },
     {
       "path": "src/backends/task-backend/load.ts",
@@ -99,13 +99,13 @@
     },
     {
       "path": "src/backends/task-backend/local-backend.ts",
-      "sha256": "f040a3f4223d7715d209c24471f60a2d7f6216430798bd423e4c24bf1a0e1475",
-      "size_bytes": 15356
+      "sha256": "4d2adf9517bd8e791a2f0993b90f4755f9d221d53eae6a85dc67477f8832d4bc",
+      "size_bytes": 15922
     },
     {
       "path": "src/backends/task-backend/redmine-backend.ts",
-      "sha256": "1222f78dd54994ac61e419400cb318d6d7b551c3da2b27ca814492c1bc10a73e",
-      "size_bytes": 25868
+      "sha256": "446f0a9b73c0aac28233c623b6ca234908ab725a64cce48794a2a04c86bd6e41",
+      "size_bytes": 26863
     },
     {
       "path": "src/backends/task-backend/redmine/client.ts",
@@ -132,6 +132,11 @@
       "sha256": "edd3a5fd31f139b7cec5eefccd78ff784dc8a44c62a133165208261094fff4f1",
       "size_bytes": 1483
     },
+    {
+      "path": "src/backends/task-backend/redmine/live.test.ts",
+      "sha256": "ff60d64abaf765448bec556d3ebdd2c35e1711ef2ba9244cc9c5b09fbd201c17",
+      "size_bytes": 3189
+    },
     {
       "path": "src/backends/task-backend/redmine/mapping.ts",
       "sha256": "cd327da5e9745c35cf20ca4e5b63cb6e29cea947e6e312a22d219181a0925d3b",
@@ -149,8 +154,8 @@
     },
     {
       "path": "src/backends/task-backend/shared.ts",
-      "sha256": "7921ae58c128342a09f153cbc02c1fe187d0461083edd95162e1f6c0034cf74a",
-      "size_bytes": 672
+      "sha256": "f892c20754f8c43bbb8270c7f574fc15abbbe21ce57d7612f5cb7e4f2fd01d63",
+      "size_bytes": 731
     },
     {
       "path": "src/backends/task-backend/shared/concurrency.ts",
@@ -204,8 +209,8 @@
     },
     {
       "path": "src/backends/task-backend/shared/types.ts",
-      "sha256": "19eb19aa4c221b7c1ac5461312c5c05e8b35307bd4432c955986b5673dc8c47e",
-      "size_bytes": 2301
+      "sha256": "6e7ee2be6a314c92fab96630dea044eac767710d0089dbc38e2f3e9c5bdb44c3",
+      "size_bytes": 3070
     },
     {
       "path": "src/backends/task-index.ts",
@@ -349,8 +354,8 @@
     },
     {
       "path": "src/cli/local-ci-selection.test.ts",
-      "sha256": "afe6f19339b0ae29296c44d26b33649d6d0be34e429666114207bd6757d55be3",
-      "size_bytes": 8052
+      "sha256": "a32dd8188e3410037b1cbe31a307be645110249e255c3c32a783397da054104a",
+      "size_bytes": 8783
     },
     {
       "path": "src/cli/output.test.ts",
@@ -459,8 +464,8 @@
     },
     {
       "path": "src/cli/run-cli.core.tasks.test.ts",
-      "sha256": "852ecffaf3e316e2b25fd3212a68efc2c04b7404c61e3cdeaa23a1af05b8547a",
-      "size_bytes": 73052
+      "sha256": "409ca8844e6439bd731f0573b49664ff49a7937f1635f7dfb0bbe783db1e42e3",
+      "size_bytes": 75281
     },
     {
       "path": "src/cli/run-cli.core.test.ts",
@@ -854,8 +859,8 @@
     },
     {
       "path": "src/commands/doctor.command.test.ts",
-      "sha256": "adb2daa2a3b6347ef8ccae3854648c0ef588ce4de3d5206cf115caf66ddfd37e",
-      "size_bytes": 28295
+      "sha256": "5bebb82be6d8529d0c383a6e336582a33d691bf050ff316ab71c77ee2ea85e44",
+      "size_bytes": 33600
     },
     {
       "path": "src/commands/doctor.command.ts",
@@ -869,8 +874,8 @@
     },
     {
       "path": "src/commands/doctor.run.ts",
-      "sha256": "43ed51e6f9433e29fb2aa6fa1da7f36d334c40bbaa4ca3807edb42576e8c54e5",
-      "size_bytes": 2834
+      "sha256": "5ab07ce809fca591d882ae1259d9ee484469b2fba8f4358e62c2db990259654b",
+      "size_bytes": 3098
     },
     {
       "path": "src/commands/doctor.spec.ts",
@@ -904,8 +909,8 @@
     },
     {
       "path": "src/commands/doctor/workspace.ts",
-      "sha256": "340789e6493dbb4d62e6d79e6fad08f06667b6f151a441a742ee3f735cffb9dd",
-      "size_bytes": 6582
+      "sha256": "d7d33a2f6906bbf731197261af8fc15b1d0d1a25cdf113b002c7667a75460b3e",
+      "size_bytes": 9961
     },
     {
       "path": "src/commands/finish.command.ts",
@@ -1339,8 +1344,8 @@
     },
     {
       "path": "src/commands/release/apply.test.ts",
-      "sha256": "6e81acd08736add789bfb964c67cd465468d932a24bb19c589cf3819fb52fe57",
-      "size_bytes": 27430
+      "sha256": "bfcb939cdefbc0e0bc30f4c38140736589ca9a1da40ba7d6b477474b601f7a93",
+      "size_bytes": 27438
     },
     {
       "path": "src/commands/release/apply.types.ts",
@@ -1439,13 +1444,13 @@
     },
     {
       "path": "src/commands/shared/git-context.test.ts",
-      "sha256": "f5c0bc396ddc6fea4db7885eb61d2bcabab6bfaa67eba61564abaef1d6a7dc0c",
-      "size_bytes": 2607
+      "sha256": "4dfafb9bdb4d57ad4671bf28553a69575427248de7bdc06b1a495647a4e81f8b",
+      "size_bytes": 3047
     },
     {
       "path": "src/commands/shared/git-context.ts",
-      "sha256": "7d640519d01dff1aab9d1df7c17bcda2fd10eb09085313e2c5f9dcac7080e798",
-      "size_bytes": 5445
+      "sha256": "25ba607fbb8fd17f9b61348a0edfc397c42786c54bad0411e7c75309b02baf1a",
+      "size_bytes": 5586
     },
     {
       "path": "src/commands/shared/git-diff.ts",
@@ -1514,8 +1519,8 @@
     },
     {
       "path": "src/commands/shared/task-backend.ts",
-      "sha256": "8d339ca7d8e765c98b0beb47af5773f9b83d2692a2b5d0c297c64e15762e8b38",
-      "size_bytes": 4748
+      "sha256": "7c9e1c1601a984c92e9c50e3a81078d5f27bdc92829eeae751d141e16decab09",
+      "size_bytes": 5624
     },
     {
       "path": "src/commands/shared/task-store.test.ts",
@@ -1634,18 +1639,23 @@
     },
     {
       "path": "src/commands/task/export.ts",
-      "sha256": "2a8585f69e1ed3f0b36313d5cf0e336cde7c1ec0c1f25ad1b7d6a024525732b2",
-      "size_bytes": 1120
+      "sha256": "1083c3a4b33b5b20a4e3cb3659fb036e5875f8cd0778cf1ef841e7efa79c7c3e",
+      "size_bytes": 1229
+    },
+    {
+      "path": "src/commands/task/export.unit.test.ts",
+      "sha256": "861656d40ace849513d5d4ee3f859edbf3ff2f049211c2453d3f3f0e590c3091",
+      "size_bytes": 2729
     },
     {
       "path": "src/commands/task/finish.ts",
-      "sha256": "06e28a7057abcac3484d4a2310ab09ebbb86a4505c5d3850cae547d49dad0bd1",
-      "size_bytes": 15948
+      "sha256": "946d09b225659ce3b14321748a02fb6efe60263ee85a2ac1611778373aa4c587",
+      "size_bytes": 16076
     },
     {
       "path": "src/commands/task/finish.unit.test.ts",
-      "sha256": "7037a179e51e1f8b572d42bd7bdf670dc36b8a9b0c8f15fc2eb461655312ba2d",
-      "size_bytes": 26103
+      "sha256": "a09144e1e2ba31614203280ffc979e01be78af29f9ffbfc4d333217ac9616478",
+      "size_bytes": 30822
     },
     {
       "path": "src/commands/task/index.ts",
@@ -1689,13 +1699,13 @@
     },
     {
       "path": "src/commands/task/migrate-doc.test.ts",
-      "sha256": "2099b8f2eb2383f98b4321e1c6617b6db763dd4c467eda00622356ee45893929",
-      "size_bytes": 10909
+      "sha256": "41cbc75077261ecb891c22bc8ad31b6d1dee7d039c4a1b32703c1bb766a0866c",
+      "size_bytes": 14614
     },
     {
       "path": "src/commands/task/migrate-doc.ts",
-      "sha256": "04feaa4650b3bc50f4be1579753c6edc7d2b4145679fca91124b9729e39dc56b",
-      "size_bytes": 11503
+      "sha256": "74217cbbf2073bc4be293d3ddab2e1dc0f6a6c8998fd8f0805b568781bf0a00e",
+      "size_bytes": 12115
     },
     {
       "path": "src/commands/task/migrate.command.ts",
@@ -2249,8 +2259,8 @@
     },
     {
       "path": "src/ports/task-backend-port.ts",
-      "sha256": "c6f863fa4193c1a37639ce5f5186700c8c3cdd63dc43e9a73ba3aa65211706d0",
-      "size_bytes": 274
+      "sha256": "ab0830696cd8b97bc9daedbbd63650a668ee615597b8dc2628a69cd8feda7fd9",
+      "size_bytes": 283
     },
     {
       "path": "src/recipes/bundled-recipes.ts",

package/dist/adapters/task-backend/task-backend-adapter.d.ts

@@ -7,6 +7,6 @@ export declare class TaskBackendAdapter implements TaskBackendPort {
     listTasks(): Promise<TaskData[]>;
     getTask(id: string): Promise<TaskData | null>;
     writeTask(task: TaskData): Promise<void>;
-    exportTasksJson(path: string): Promise<void>;
+    exportProjectionSnapshot(path: string): Promise<void>;
 }
 //# sourceMappingURL=task-backend-adapter.d.ts.map

package/dist/adapters/task-backend/task-backend-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-backend-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/task-backend/task-backend-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;gBAEzB,GAAG,EAAE,cAAc;IAI/B,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAIhC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAI7C,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO7C"}
+{"version":3,"file":"task-backend-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/task-backend/task-backend-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAE5E,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;gBAEzB,GAAG,EAAE,cAAc;IAI/B,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAIhC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAI7C,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAUtD"}

package/dist/adapters/task-backend/task-backend-adapter.js

@@ -12,10 +12,13 @@ export class TaskBackendAdapter {
     writeTask(task) {
         return this.ctx.taskBackend.writeTask(task);
     }
-    exportTasksJson(path) {
+    exportProjectionSnapshot(path) {
         const backend = this.ctx.taskBackend;
+        if (backend.exportProjectionSnapshot) {
+            return backend.exportProjectionSnapshot(path);
+        }
         if (!backend.exportTasksJson) {
-            throw new Error("Backend does not support exportTasksJson");
+            throw new Error("Backend does not support exportProjectionSnapshot");
         }
         return backend.exportTasksJson(path);
     }

package/dist/backends/task-backend/local-backend.d.ts

@@ -1,6 +1,17 @@
 import { type TaskBackend, type TaskData } from "./shared.js";
 export declare class LocalBackend implements TaskBackend {
     id: string;
+    capabilities: {
+        readonly canonical_source: "local";
+        readonly projection: "canonical";
+        readonly reads_from_projection_by_default: true;
+        readonly writes_task_readmes: true;
+        readonly may_access_network_on_read: false;
+        readonly may_access_network_on_write: false;
+        readonly supports_projection_refresh: false;
+        readonly supports_push_sync: false;
+        readonly supports_snapshot_export: true;
+    };
     root: string;
     updatedBy: string;
     private lastListWarnings;
@@ -13,6 +24,7 @@ export declare class LocalBackend implements TaskBackend {
         attempts: number;
     }): Promise<string>;
     listTasks(): Promise<TaskData[]>;
+    listProjectionTasks(): Promise<TaskData[]>;
     getLastListWarnings(): string[];
     getTask(taskId: string): Promise<TaskData | null>;
     getTasks(taskIds: string[]): Promise<(TaskData | null)[]>;
@@ -26,5 +38,6 @@ export declare class LocalBackend implements TaskBackend {
         changed: number;
     }>;
     exportTasksJson(outputPath: string): Promise<void>;
+    exportProjectionSnapshot(outputPath: string): Promise<void>;
 }
 //# sourceMappingURL=local-backend.d.ts.map

package/dist/backends/task-backend/local-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-backend.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/local-backend.ts"],"names":[],"mappings":"AAqBA,OAAO,EAiBL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAErB,qBAAa,YAAa,YAAW,WAAW;IAC9C,EAAE,SAAW;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,gBAAgB,CAAgB;gBAE5B,QAAQ,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAKrD,cAAc,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB3E,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAwHtC,mBAAmB,IAAI,MAAM,EAAE;IAIzB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAoBjD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;IAKzD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO3C,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAyExC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB1E,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvE,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,cAAc,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAuF/D,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIzD"}
+{"version":3,"file":"local-backend.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/local-backend.ts"],"names":[],"mappings":"AAqBA,OAAO,EAiBL,KAAK,WAAW,EAChB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAErB,qBAAa,YAAa,YAAW,WAAW;IAC9C,EAAE,SAAW;IACb,YAAY;;;;;;;;;;MAUD;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,gBAAgB,CAAgB;gBAE5B,QAAQ,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAKrD,cAAc,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAqB3E,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAwHhC,mBAAmB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAIhD,mBAAmB,IAAI,MAAM,EAAE;IAIzB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAoBjD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;IAKzD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO3C,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAyExC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB1E,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBvE,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,cAAc,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAuF/D,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlE"}

package/dist/backends/task-backend/local-backend.js

@@ -7,6 +7,17 @@ import { buildTaskIndexEntry, loadTaskIndex, resolveTaskIndexPath, saveTaskIndex
 import { DEFAULT_DOC_UPDATED_BY, defaultPlanApproval, defaultVerificationResult, extractTaskDoc, generateTaskId, invalidLengthMessage, mapLimit, mergeTaskDoc, missingTaskIdMessage, normalizeDocVersion, nowIso, resolveDocUpdatedByFromFrontmatter, resolveDocUpdatedByFromTask, taskRecordToData, validateTaskId, writeTasksExportFromTasks, } from "./shared.js";
 export class LocalBackend {
     id = "local";
+    capabilities = {
+        canonical_source: "local",
+        projection: "canonical",
+        reads_from_projection_by_default: true,
+        writes_task_readmes: true,
+        may_access_network_on_read: false,
+        may_access_network_on_write: false,
+        supports_projection_refresh: false,
+        supports_push_sync: false,
+        supports_snapshot_export: true,
+    };
     root;
     updatedBy;
     lastListWarnings = [];
@@ -151,6 +162,9 @@ export class LocalBackend {
         this.lastListWarnings = warnings;
         return tasks;
     }
+    async listProjectionTasks() {
+        return await this.listTasks();
+    }
     getLastListWarnings() {
         return [...this.lastListWarnings];
     }
@@ -365,4 +379,7 @@ export class LocalBackend {
         const tasks = await this.listTasks();
         await writeTasksExportFromTasks({ outputPath, tasks });
     }
+    async exportProjectionSnapshot(outputPath) {
+        await this.exportTasksJson(outputPath);
+    }
 }

package/dist/backends/task-backend/redmine-backend.d.ts

@@ -13,6 +13,17 @@ export type RedmineSettings = {
 };
 export declare class RedmineBackend implements TaskBackend {
     id: string;
+    capabilities: {
+        readonly canonical_source: "remote";
+        readonly projection: "cache";
+        readonly reads_from_projection_by_default: true;
+        readonly writes_task_readmes: true;
+        readonly may_access_network_on_read: false;
+        readonly may_access_network_on_write: true;
+        readonly supports_projection_refresh: true;
+        readonly supports_push_sync: true;
+        readonly supports_snapshot_export: true;
+    };
     baseUrl: string;
     apiKey: string;
     projectId: string;
@@ -34,7 +45,14 @@ export declare class RedmineBackend implements TaskBackend {
         attempts: number;
     }): Promise<string>;
     listTasks(): Promise<TaskData[]>;
+    listProjectionTasks(): Promise<TaskData[]>;
     exportTasksJson(outputPath: string): Promise<void>;
+    exportProjectionSnapshot(outputPath: string): Promise<void>;
+    refreshProjection(opts: {
+        allowNetwork: boolean;
+        quiet?: boolean;
+        conflict?: "diff" | "prefer-local" | "prefer-remote" | "fail";
+    }): Promise<void>;
     normalizeTasks(): Promise<{
         scanned: number;
         changed: number;

package/dist/backends/task-backend/redmine-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redmine-backend.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/redmine-backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"redmine-backend.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/redmine-backend.ts"],"names":[],"mappings":"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"}

package/dist/backends/task-backend/redmine-backend.js

@@ -10,6 +10,17 @@ import { readRedmineEnv } from "./redmine/env.js";
 import { BackendError, DEFAULT_DOC_UPDATED_BY, DOC_VERSION, RedmineUnavailable, ensureDocMetadata, firstNonEmptyString, generateTaskId, mapLimit, missingTaskIdMessage, normalizeDocVersion, nowIso, redmineConfigMissingEnvMessage, redmineIssueIdMissingMessage, sleep, toStringSafe, unknownTaskIdMessage, validateTaskId, writeTasksExportFromTasks, } from "./shared.js";
 export class RedmineBackend {
     id = "redmine";
+    capabilities = {
+        canonical_source: "remote",
+        projection: "cache",
+        reads_from_projection_by_default: true,
+        writes_task_readmes: true,
+        may_access_network_on_read: false,
+        may_access_network_on_write: true,
+        supports_projection_refresh: true,
+        supports_push_sync: true,
+        supports_snapshot_export: true,
+    };
     baseUrl;
     apiKey;
     projectId;
@@ -89,23 +100,34 @@ export class RedmineBackend {
         });
     }
     async listTasks() {
-        try {
-            // Read-only listing must not rewrite local task READMEs through cache updates.
-            return await this.listTasksRemote();
+        if (!this.cache) {
+            throw new BackendError("Redmine cache is disabled; projection reads are unavailable", "E_BACKEND");
         }
-        catch (err) {
-            if (err instanceof RedmineUnavailable) {
-                if (!this.cache)
-                    throw err;
-                return await this.cache.listTasks();
-            }
-            throw err;
+        return await this.cache.listTasks();
+    }
+    async listProjectionTasks() {
+        if (!this.cache) {
+            throw new BackendError("Redmine cache is disabled; projection reads are unavailable", "E_BACKEND");
         }
+        return await this.cache.listTasks();
     }
     async exportTasksJson(outputPath) {
         const tasks = await this.listTasks();
         await writeTasksExportFromTasks({ outputPath, tasks });
     }
+    async exportProjectionSnapshot(outputPath) {
+        if (!this.cache) {
+            throw new BackendError("Redmine cache is disabled; projection snapshot export is unavailable", "E_BACKEND");
+        }
+        const tasks = await this.cache.listTasks();
+        await writeTasksExportFromTasks({ outputPath, tasks });
+    }
+    async refreshProjection(opts) {
+        if (!opts.allowNetwork) {
+            throw new BackendError("Projection refresh requires network access approval", "E_BACKEND");
+        }
+        await this.syncPull(opts.conflict ?? "prefer-remote", opts.quiet ?? true);
+    }
     async normalizeTasks() {
         // Remote backends should avoid expensive downloads; best-effort normalize the local cache if present.
         if (this.cache?.normalizeTasks)
@@ -113,22 +135,10 @@ export class RedmineBackend {
         return { scanned: 0, changed: 0 };
     }
     async getTask(taskId) {
-        try {
-            const issue = await this.findIssueByTaskId(taskId);
-            if (!issue)
-                return null;
-            // Read-only fetch must not rewrite local task READMEs through cache updates.
-            return this.issueToTask(issue, taskId);
-        }
-        catch (err) {
-            if (err instanceof RedmineUnavailable) {
-                if (!this.cache)
-                    throw err;
-                const cached = await this.cache.getTask(taskId);
-                return cached ?? null;
-            }
-            throw err;
+        if (!this.cache) {
+            throw new BackendError("Redmine cache is disabled; projection reads are unavailable", "E_BACKEND");
         }
+        return (await this.cache.getTask(taskId)) ?? null;
     }
     async getTasks(taskIds) {
         // Use limited parallelism to avoid hammering the Redmine API.

package/dist/backends/task-backend/shared/types.d.ts

@@ -55,9 +55,27 @@ export type TaskData = {
     id_source?: string;
 };
 export type TaskDocMeta = Pick<TaskData, "doc" | "doc_version" | "doc_updated_at" | "doc_updated_by">;
+export type TaskBackendCapabilities = {
+    canonical_source: "local" | "remote";
+    projection: "canonical" | "cache";
+    reads_from_projection_by_default: boolean;
+    writes_task_readmes?: boolean;
+    may_access_network_on_read: boolean;
+    may_access_network_on_write: boolean;
+    supports_projection_refresh: boolean;
+    supports_push_sync: boolean;
+    supports_snapshot_export: boolean;
+};
+export type TaskProjectionRefreshOptions = {
+    allowNetwork: boolean;
+    quiet?: boolean;
+    conflict?: "diff" | "prefer-local" | "prefer-remote" | "fail";
+};
 export type TaskBackend = {
     id: string;
+    capabilities: TaskBackendCapabilities;
     listTasks(): Promise<TaskData[]>;
+    listProjectionTasks?(): Promise<TaskData[]>;
     getLastListWarnings?(): string[];
     getTask(taskId: string): Promise<TaskData | null>;
     getTasks?(taskIds: string[]): Promise<(TaskData | null)[]>;
@@ -67,6 +85,8 @@ export type TaskBackend = {
         scanned: number;
         changed: number;
     }>;
+    refreshProjection?(opts: TaskProjectionRefreshOptions): Promise<void>;
+    exportProjectionSnapshot?(outputPath: string): Promise<void>;
     exportTasksJson?(outputPath: string): Promise<void>;
     getTaskDoc?(taskId: string): Promise<string>;
     setTaskDoc?(taskId: string, doc: string, updatedBy?: string): Promise<void>;

package/dist/backends/task-backend/shared/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/shared/types.ts"],"names":[],"mappings":"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"}

package/dist/backends/task-backend/shared.d.ts

@@ -1,5 +1,5 @@
 export { DEFAULT_DOC_UPDATED_BY, DOC_VERSION, TASK_ID_RE } from "./shared/constants.js";
-export type { PlanApproval, PlanApprovalState, TaskBackend, TaskData, TaskDocMeta, TaskEvent, TaskEventType, VerificationResult, VerificationState, } from "./shared/types.js";
+export type { PlanApproval, PlanApprovalState, TaskBackend, TaskBackendCapabilities, TaskData, TaskDocMeta, TaskEvent, TaskEventType, TaskProjectionRefreshOptions, VerificationResult, VerificationState, } from "./shared/types.js";
 export * from "./shared/concurrency.js";
 export * from "./shared/doc.js";
 export * from "./shared/errors.js";

package/dist/backends/task-backend/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExF,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/backends/task-backend/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExF,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,uBAAuB,EACvB,QAAQ,EACR,WAAW,EACX,SAAS,EACT,aAAa,EACb,4BAA4B,EAC5B,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/backends/task-backend.d.ts

@@ -1,4 +1,4 @@
-export { BackendError, RedmineUnavailable, buildTasksExportSnapshotFromTasks, extractTaskDoc, mergeTaskDoc, taskRecordToData, writeTasksExportFromTasks, type PlanApproval, type PlanApprovalState, type TaskBackend, type TaskData, type TaskEvent, type TaskEventType, type VerificationResult, type VerificationState, } from "./task-backend/shared.js";
+export { BackendError, RedmineUnavailable, buildTasksExportSnapshotFromTasks, extractTaskDoc, mergeTaskDoc, taskRecordToData, writeTasksExportFromTasks, type PlanApproval, type PlanApprovalState, type TaskBackend, type TaskBackendCapabilities, type TaskData, type TaskEvent, type TaskEventType, type TaskProjectionRefreshOptions, type VerificationResult, type VerificationState, } from "./task-backend/shared.js";
 export { LocalBackend } from "./task-backend/local-backend.js";
 export { RedmineBackend } from "./task-backend/redmine-backend.js";
 export { loadTaskBackend } from "./task-backend/load.js";

package/dist/backends/task-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../src/backends/task-backend.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iCAAiC,EACjC,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../src/backends/task-backend.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,iCAAiC,EACjC,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,EACzB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,4BAA4B,EACjC,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,GACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/commands/doctor/workspace.d.ts

@@ -1,2 +1,5 @@
-export declare function checkWorkspace(repoRoot: string): Promise<string[]>;
+import { type CommandContext } from "../shared/task-backend.js";
+export declare function checkWorkspace(repoRoot: string, opts?: {
+    ctx?: CommandContext;
+}): Promise<string[]>;
 //# sourceMappingURL=workspace.d.ts.map

package/dist/commands/doctor/workspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/workspace.ts"],"names":[],"mappings":"AAqIA,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsDxE"}
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/workspace.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA6NpF,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,cAAc,CAAA;CAAE,GAC9B,OAAO,CAAC,MAAM,EAAE,CAAC,CAyDnB"}

package/dist/commands/doctor/workspace.js

@@ -3,6 +3,8 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { renderDiagnosticFinding } from "../../shared/diagnostics.js";
 import { resolvePolicyGatewayForRepo } from "../../shared/policy-gateway.js";
+import { GitContext } from "../shared/git-context.js";
+import { listTaskProjection } from "../shared/task-backend.js";
 async function pathExists(absPath) {
     try {
         await fs.access(absPath);
@@ -44,7 +46,14 @@ async function listMissingManagedPolicyFiles(repoRoot) {
     }
     return missing.toSorted();
 }
-async function checkTaskReadmeMigrationState(repoRoot) {
+function taskDataToSnapshot(task) {
+    return {
+        id: task.id,
+        status: task.status,
+        doc_version: task.doc_version,
+    };
+}
+async function readTaskDocSnapshotsFromTasksJson(repoRoot) {
     const tasksPath = path.join(repoRoot, ".agentplane", "tasks.json");
     let raw = "";
     try {
@@ -60,7 +69,22 @@ async function checkTaskReadmeMigrationState(repoRoot) {
     catch {
         return [];
     }
-    const tasks = Array.isArray(parsed.tasks) ? parsed.tasks : [];
+    return Array.isArray(parsed.tasks) ? parsed.tasks : [];
+}
+async function readTaskDocSnapshotsFromProjection(ctx) {
+    if (!ctx)
+        return null;
+    try {
+        const tasks = await listTaskProjection(ctx);
+        if (tasks === null)
+            return null;
+        return tasks.map((task) => taskDataToSnapshot(task));
+    }
+    catch {
+        return null;
+    }
+}
+function buildTaskReadmeMigrationFindings(tasks) {
     if (tasks.length === 0)
         return [];
     const legacy = tasks.filter((task) => task.doc_version !== 3);
@@ -114,7 +138,66 @@ async function checkTaskReadmeMigrationState(repoRoot) {
         }),
     ];
 }
-export async function checkWorkspace(repoRoot) {
+async function checkTaskReadmeMigrationState(repoRoot, ctx) {
+    const projectionTasks = await readTaskDocSnapshotsFromProjection(ctx);
+    const tasks = projectionTasks && projectionTasks.length > 0
+        ? projectionTasks
+        : await readTaskDocSnapshotsFromTasksJson(repoRoot);
+    return buildTaskReadmeMigrationFindings(tasks);
+}
+async function readUntrackedPaths(repoRoot, ctx) {
+    try {
+        const git = ctx?.git ?? new GitContext({ gitRoot: repoRoot });
+        return new Set(await git.statusUntrackedPaths());
+    }
+    catch {
+        return new Set();
+    }
+}
+async function checkDoneTaskReadmeArchiveDrift(repoRoot, ctx) {
+    const projectionTasks = await readTaskDocSnapshotsFromProjection(ctx);
+    const tasks = projectionTasks && projectionTasks.length > 0
+        ? projectionTasks
+        : await readTaskDocSnapshotsFromTasksJson(repoRoot);
+    if (tasks.length === 0)
+        return [];
+    const workflowDir = (ctx?.config.paths.workflow_dir ?? ".agentplane/tasks").replaceAll("\\", "/");
+    const untracked = await readUntrackedPaths(repoRoot, ctx);
+    if (untracked.size === 0)
+        return [];
+    const affected = tasks
+        .filter((task) => {
+        const status = typeof task.status === "string" ? task.status.trim().toUpperCase() : "";
+        const taskId = typeof task.id === "string" ? task.id.trim() : "";
+        if (status !== "DONE" || !taskId)
+            return false;
+        return untracked.has(`${workflowDir}/${taskId}/README.md`);
+    })
+        .map((task) => String(task.id))
+        .toSorted();
+    if (affected.length === 0)
+        return [];
+    const examples = affected.slice(0, 5).join(", ");
+    const stagedCommand = `git add ${affected
+        .map((taskId) => `${workflowDir}/${taskId}/README.md`)
+        .join(" ")}`;
+    return [
+        renderDiagnosticFinding({
+            severity: "WARN",
+            state: "DONE task archive README files exist on disk but are missing from the git index",
+            likelyCause: "task metadata reached DONE state, but the human-readable task README archive never landed in a tracked close commit",
+            nextAction: {
+                command: stagedCommand,
+                reason: "stage the missing archived task README files and commit them before continuing",
+            },
+            details: [
+                `Affected DONE tasks: ${affected.length}`,
+                examples ? `Examples: ${examples}` : "Examples unavailable.",
+            ],
+        }),
+    ];
+}
+export async function checkWorkspace(repoRoot, opts) {
     const problems = [];
     const requiredFiles = [path.join(repoRoot, ".agentplane", "config.json")];
     for (const filePath of requiredFiles) {
@@ -160,6 +243,6 @@ export async function checkWorkspace(repoRoot) {
     if (!hasJson) {
         problems.push("No agent profiles found in .agentplane/agents (*.json expected).");
     }
-    problems.push(...(await checkTaskReadmeMigrationState(repoRoot)));
+    problems.push(...(await checkTaskReadmeMigrationState(repoRoot, opts?.ctx)), ...(await checkDoneTaskReadmeArchiveDrift(repoRoot, opts?.ctx)));
     return problems;
 }

package/dist/commands/doctor.run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.run.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAYrD,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CAuDlD,CAAC"}
+{"version":3,"file":"doctor.run.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.run.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAarD,eAAO,MAAM,SAAS,EAAE,cAAc,CAAC,YAAY,CA6DlD,CAAC"}

package/dist/commands/doctor.run.js

@@ -1,5 +1,6 @@
 import { loadConfig, resolveProject } from "@agentplaneorg/core";
 import { warnMessage, successMessage } from "../cli/output.js";
+import { loadCommandContext } from "./shared/task-backend.js";
 import { checkDoneTaskCommitInvariants } from "./doctor/archive.js";
 import { safeFixGitignore, safeFixTaskIndex } from "./doctor/fixes.js";
 import { checkLayering } from "./doctor/layering.js";
@@ -11,9 +12,15 @@ export const runDoctor = async (ctx, p) => {
     const resolved = await resolveProject({ cwd: ctx.cwd, rootOverride: ctx.rootOverride ?? null });
     const repoRoot = resolved.gitRoot;
     const loadedConfig = await loadConfig(resolved.agentplaneDir);
+    const commandCtx = await loadCommandContext({
+        cwd: ctx.cwd,
+        rootOverride: ctx.rootOverride ?? null,
+        resolvedProject: resolved,
+        config: loadedConfig.config,
+    });
     const runChecks = async () => {
         let checks = [
-            ...(await checkWorkspace(repoRoot)),
+            ...(await checkWorkspace(repoRoot, { ctx: commandCtx })),
             ...checkRuntimeSourceFacts(ctx.cwd, loadedConfig.config),
             ...(await checkDoneTaskCommitInvariants(repoRoot, { fullArchive: p.archiveFull })),
         ];

package/dist/commands/shared/git-context.d.ts

@@ -7,6 +7,7 @@ export declare class GitContext {
     private statusPorcelainZ;
     statusChangedPaths(): Promise<string[]>;
     statusStagedPaths(): Promise<string[]>;
+    statusUntrackedPaths(): Promise<string[]>;
     statusUnstagedTrackedPaths(): Promise<string[]>;
     headCommit(): Promise<string>;
     stage(paths: string[]): Promise<void>;

package/dist/commands/shared/git-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-context.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-context.ts"],"names":[],"mappings":"AAyEA,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,IAAI,CAGL;gBAEK,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;YAIvB,gBAAgB;IAmBxB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvC,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKtC,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKrD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAWvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxF,iBAAiB,CAAC,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,eAAe,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAWpE"}
+{"version":3,"file":"git-context.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/git-context.ts"],"names":[],"mappings":"AAyEA,qBAAa,UAAU;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,OAAO,CAAC,IAAI,CAGL;gBAEK,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;YAIvB,gBAAgB;IAmBxB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvC,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKtC,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzC,0BAA0B,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKrD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAWvB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWrC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcxF,iBAAiB,CAAC,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWpE,eAAe,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAWpE"}

package/dist/commands/shared/git-context.js

@@ -87,6 +87,10 @@ export class GitContext {
         const status = await this.statusPorcelainZ();
         return status.stagedPaths;
     }
+    async statusUntrackedPaths() {
+        const status = await this.statusPorcelainZ();
+        return status.untrackedPaths;
+    }
     async statusUnstagedTrackedPaths() {
         const status = await this.statusPorcelainZ();
         return status.unstagedTrackedPaths;

package/dist/commands/shared/task-backend.d.ts

@@ -44,4 +44,9 @@ export declare function loadBackendTask(opts: {
     task: TaskData;
 }>;
 export declare function listTasksMemo(ctx: CommandContext): Promise<TaskData[]>;
+export declare function listTaskProjection(ctx: CommandContext): Promise<TaskData[] | null>;
+export declare function exportTaskProjectionSnapshot(opts: {
+    ctx: CommandContext;
+    outputPath: string;
+}): Promise<void>;
 //# sourceMappingURL=task-backend.d.ts.map

package/dist/commands/shared/task-backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-backend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACzE,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9D,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,GAAG,EAAE,UAAU,CAAC;IAEhB,IAAI,EAAE,WAAW,CAAC;IAGlB,QAAQ,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAC5C,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;CACxC,CAAC;AASF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+B7E;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B,GAAG,OAAO,CAAC,cAAc,CAAC,CAmB1B;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAepB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAC5C,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC,CAaD;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAG5E"}
+{"version":3,"file":"task-backend.d.ts","sourceRoot":"","sources":["../../../src/commands/shared/task-backend.ts"],"names":[],"mappings":"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"}

package/dist/commands/shared/task-backend.js

@@ -99,3 +99,27 @@ export async function listTasksMemo(ctx) {
     ctx.memo.taskList ??= ctx.taskBackend.listTasks();
     return await ctx.memo.taskList;
 }
+export async function listTaskProjection(ctx) {
+    if (ctx.taskBackend.listProjectionTasks) {
+        return await ctx.taskBackend.listProjectionTasks();
+    }
+    if (ctx.taskBackend.capabilities.reads_from_projection_by_default) {
+        return await listTasksMemo(ctx);
+    }
+    return null;
+}
+export async function exportTaskProjectionSnapshot(opts) {
+    if (opts.ctx.taskBackend.exportProjectionSnapshot) {
+        await opts.ctx.taskBackend.exportProjectionSnapshot(opts.outputPath);
+        return;
+    }
+    if (opts.ctx.taskBackend.exportTasksJson) {
+        await opts.ctx.taskBackend.exportTasksJson(opts.outputPath);
+        return;
+    }
+    throw new CliError({
+        exitCode: 3,
+        code: "E_VALIDATION",
+        message: "Configured backend does not support exporting a task snapshot",
+    });
+}

package/dist/commands/task/export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/commands/task/export.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEpF,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlB"}
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/commands/task/export.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAEnC,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlB"}

package/dist/commands/task/export.js

@@ -2,20 +2,20 @@ import path from "node:path";
 import { mapBackendError } from "../../cli/error-map.js";
 import { backendNotSupportedMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
-import { loadCommandContext } from "../shared/task-backend.js";
+import { exportTaskProjectionSnapshot, loadCommandContext, } from "../shared/task-backend.js";
 export async function cmdTaskExport(opts) {
     try {
         const ctx = opts.ctx ??
             (await loadCommandContext({ cwd: opts.cwd, rootOverride: opts.rootOverride ?? null }));
         const outPath = path.join(ctx.resolvedProject.gitRoot, ctx.config.paths.tasks_path);
-        if (!ctx.taskBackend.exportTasksJson) {
+        if (!ctx.taskBackend.exportProjectionSnapshot && !ctx.taskBackend.exportTasksJson) {
             throw new CliError({
                 exitCode: 3,
                 code: "E_VALIDATION",
-                message: backendNotSupportedMessage("exportTasksJson()"),
+                message: backendNotSupportedMessage("exportProjectionSnapshot()"),
             });
         }
-        await ctx.taskBackend.exportTasksJson(outPath);
+        await exportTaskProjectionSnapshot({ ctx, outputPath: outPath });
         process.stdout.write(`${path.relative(ctx.resolvedProject.gitRoot, outPath)}\n`);
         return 0;
     }

package/dist/commands/task/finish.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAqCnC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2XlB"}
+{"version":3,"file":"finish.d.ts","sourceRoot":"","sources":["../../../src/commands/task/finish.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAqCnC,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;IAC/B,wBAAwB,EAAE,OAAO,CAAC;IAClC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4XlB"}

package/dist/commands/task/finish.js

@@ -114,8 +114,9 @@ export async function cmdFinish(opts) {
             : await readHeadCommit(gitRoot);
         const useStore = backendIsLocalFileBackend(ctx);
         const store = useStore ? getTaskStore(ctx) : null;
+        const backendWritesTaskReadmes = ctx.taskBackend.capabilities.writes_task_readmes === true;
         const defaultDirectCloseCommit = ctx.config.workflow_mode === "direct" &&
-            useStore &&
+            backendWritesTaskReadmes &&
             opts.taskIds.length === 1 &&
             !opts.commitFromComment &&
             !statusCommitRequested;
@@ -275,7 +276,7 @@ export async function cmdFinish(opts) {
             await (useStore
                 ? store.update(primaryTaskId, () => updatedAfterCommit)
                 : ctx.taskBackend.writeTask(updatedAfterCommit));
-            if (useStore) {
+            if (backendWritesTaskReadmes) {
                 const workflowReadmeRelPath = path.join(ctx.config.paths.workflow_dir, primaryTaskId, "README.md");
                 await ctx.git.stage([workflowReadmeRelPath]);
                 const env = buildGitCommitEnv({

package/dist/commands/task/migrate-doc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrate-doc.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate-doc.ts"],"names":[],"mappings":"AAkSA,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAwClB"}
+{"version":3,"file":"migrate-doc.d.ts","sourceRoot":"","sources":["../../../src/commands/task/migrate-doc.ts"],"names":[],"mappings":"AAiSA,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqDlB"}

package/dist/commands/task/migrate-doc.js

@@ -6,11 +6,11 @@ import { exitCodeForError } from "../../cli/exit-codes.js";
 import { fileExists, getPathKind } from "../../cli/fs-utils.js";
 import { successMessage } from "../../cli/output.js";
 import { CliError } from "../../shared/errors.js";
+import { exportTaskProjectionSnapshot, loadCommandContext } from "../shared/task-backend.js";
 import { extractDocSection, extractTaskObservationSection, normalizeTaskDocVersion, normalizeVerificationSectionLayout, } from "./shared/docs.js";
 import { defaultTaskDocV3 } from "./doc-template.js";
 const V3_CANONICAL_ORDER = [
     "Summary",
-    "Context",
     "Scope",
     "Plan",
     "Verify Steps",
@@ -98,8 +98,6 @@ function migrateDocToV3(opts) {
         const currentText = firstSectionText(currentSections, title);
         const defaultText = firstSectionText(defaultSections, title) ?? "";
         let nextText = currentText ?? defaultText;
-        if (title === "Context" && !(currentText ?? "").trim())
-            continue;
         if (title === "Verification") {
             nextText = normalizeVerificationSectionLayout(currentText ?? defaultText, 3);
         }
@@ -242,6 +240,12 @@ export async function cmdTaskMigrateDoc(opts) {
             rootOverride: opts.rootOverride ?? null,
         });
         const loaded = await loadConfig(resolved.agentplaneDir);
+        const ctx = await loadCommandContext({
+            cwd: opts.cwd,
+            rootOverride: opts.rootOverride ?? null,
+            resolvedProject: resolved,
+            config: loaded.config,
+        });
         const tasksDir = path.join(resolved.gitRoot, loaded.config.paths.workflow_dir);
         const readmePaths = await resolveReadmePaths({ tasksDir, params });
         if (!params.all) {
@@ -262,6 +266,12 @@ export async function cmdTaskMigrateDoc(opts) {
             if (res.changed)
                 changed += 1;
         }
+        // Refresh the local export snapshot so doctor and other snapshot-based checks
+        // immediately observe the migrated README contract without a separate task export.
+        if (ctx.taskBackend.exportProjectionSnapshot || ctx.taskBackend.exportTasksJson) {
+            const outPath = path.join(resolved.gitRoot, loaded.config.paths.tasks_path);
+            await exportTaskProjectionSnapshot({ ctx, outputPath: outPath });
+        }
         if (!params.quiet) {
             process.stdout.write(`${successMessage("migrated task docs", undefined, `changed=${changed}`)}\n`);
         }

package/dist/ports/task-backend-port.d.ts

@@ -3,6 +3,6 @@ export type TaskBackendPort = {
     listTasks(): Promise<TaskData[]>;
     getTask(id: string): Promise<TaskData | null>;
     writeTask(task: TaskData): Promise<void>;
-    exportTasksJson(path: string): Promise<void>;
+    exportProjectionSnapshot(path: string): Promise<void>;
 };
 //# sourceMappingURL=task-backend-port.d.ts.map

package/dist/ports/task-backend-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-backend-port.d.ts","sourceRoot":"","sources":["../../src/ports/task-backend-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC9C,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C,CAAC"}
+{"version":3,"file":"task-backend-port.d.ts","sourceRoot":"","sources":["../../src/ports/task-backend-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC9C,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentplane",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Agent Plane CLI for task workflows, recipes, and project automation.",
   "keywords": [
     "agentplane",
@@ -55,7 +55,7 @@
     "prepublishOnly": "node ../../scripts/enforce-github-publish.mjs && npm run prepack"
   },
   "dependencies": {
-    "@agentplaneorg/core": "0.3.4",
+    "@agentplaneorg/core": "0.3.5",
     "yauzl": "^2.10.0"
   },
   "devDependencies": {