agentplane 0.2.25 → 0.2.26

package/bin/agentplane.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
+import { execFileSync } from "node:child_process";
 import path from "node:path";
-import { readdir, stat } from "node:fs/promises";
+import { readFile, stat } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
 
 async function exists(p) {
@@ -35,47 +36,88 @@ async function maybeWarnGlobalBinaryInRepoCheckout() {
   );
 }
 
-function isTestLikePath(absPath) {
-  // The repo build does not emit test files to dist. If we treat test mtimes as
-  // "src is newer than dist", we can block normal commits that only change tests.
-  const normalized = absPath.replaceAll("\\", "/");
-  if (normalized.includes("/__snapshots__/")) return true;
-  if (normalized.endsWith(".snap")) return true;
-  if (/\.(unit\.)?test\.[cm]?ts$/.test(normalized)) return true;
-  if (/\.(unit\.)?test\.tsx$/.test(normalized)) return true;
-  return false;
+async function readJsonIfExists(p) {
+  let raw = "";
+  try {
+    raw = await readFile(p, "utf8");
+  } catch {
+    return null;
+  }
+  try {
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
 }
 
-// Keep this file dependency-free and simple: rely on directory mtime scans below.
-async function newestMtimeMsInDir(dir) {
-  let newest = 0;
-  const stack = [dir];
-  while (stack.length > 0) {
-    const current = stack.pop();
-    if (!current) continue;
-    let entries;
-    try {
-      entries = await readdir(current, { withFileTypes: true });
-    } catch {
-      continue;
-    }
-    for (const entry of entries) {
-      const abs = path.join(current, entry.name);
-      if (entry.isDirectory()) {
-        stack.push(abs);
-        continue;
-      }
-      if (!entry.isFile()) continue;
-      if (isTestLikePath(abs)) continue;
-      try {
-        const s = await stat(abs);
-        if (s.mtimeMs > newest) newest = s.mtimeMs;
-      } catch {
-        // ignore
-      }
-    }
+function resolveGitHead(cwd) {
+  try {
+    return execFileSync("git", ["rev-parse", "HEAD"], { cwd, encoding: "utf8" }).trim() || null;
+  } catch {
+    return null;
   }
-  return newest;
+}
+
+function hasSrcChanges(cwd) {
+  try {
+    const out = execFileSync(
+      "git",
+      ["status", "--porcelain", "--untracked-files=all", "--", "src"],
+      {
+        cwd,
+        encoding: "utf8",
+      },
+    );
+    return out.trim().length > 0;
+  } catch {
+    return false;
+  }
+}
+
+async function fileMtimeMs(p) {
+  try {
+    const s = await stat(p);
+    if (!s.isFile()) return null;
+    return s.mtimeMs;
+  } catch {
+    return null;
+  }
+}
+
+async function isPackageBuildFresh(packageRoot) {
+  const manifestPath = path.join(packageRoot, "dist", ".build-manifest.json");
+  const manifest = await readJsonIfExists(manifestPath);
+  if (!manifest || manifest.schema_version !== 1) {
+    return { ok: false, reason: "manifest_missing" };
+  }
+
+  const currentHead = resolveGitHead(packageRoot);
+  if (manifest.git_head && currentHead && manifest.git_head !== currentHead) {
+    return { ok: false, reason: "git_head_changed" };
+  }
+
+  if (hasSrcChanges(packageRoot)) {
+    return { ok: false, reason: "src_dirty" };
+  }
+
+  const srcCliMtimeMs = await fileMtimeMs(path.join(packageRoot, "src", "cli.ts"));
+  const srcIndexMtimeMs = await fileMtimeMs(path.join(packageRoot, "src", "index.ts"));
+  if (
+    typeof manifest.src_cli_mtime_ms === "number" &&
+    typeof srcCliMtimeMs === "number" &&
+    srcCliMtimeMs > manifest.src_cli_mtime_ms
+  ) {
+    return { ok: false, reason: "src_cli_newer_than_manifest" };
+  }
+  if (
+    typeof manifest.src_index_mtime_ms === "number" &&
+    typeof srcIndexMtimeMs === "number" &&
+    srcIndexMtimeMs > manifest.src_index_mtime_ms
+  ) {
+    return { ok: false, reason: "src_index_newer_than_manifest" };
+  }
+
+  return { ok: true, reason: "fresh" };
 }
 
 async function assertDistUpToDate() {
@@ -97,29 +139,24 @@ async function assertDistUpToDate() {
     return false;
   }
 
-  const agentplaneSrcDir = path.join(agentplaneRoot, "src");
-  const agentplaneSrcNewest = await newestMtimeMsInDir(agentplaneSrcDir);
-  const agentplaneDistNewest = await newestMtimeMsInDir(agentplaneDistDir);
-  const isStaleAgentplane = agentplaneSrcNewest > agentplaneDistNewest;
-
-  // If we're in the monorepo, also check core dist because the CLI imports it.
   const repoRoot = path.resolve(agentplaneRoot, "..", "..");
   const coreRoot = path.join(repoRoot, "packages", "core");
-  const coreSrcDir = path.join(coreRoot, "src");
-  const coreDistDir = path.join(coreRoot, "dist");
-  let isStaleCore = false;
-  if ((await exists(coreSrcDir)) && (await exists(coreDistDir))) {
-    const coreSrcNewest = await newestMtimeMsInDir(coreSrcDir);
-    const coreDistNewest = await newestMtimeMsInDir(coreDistDir);
-    isStaleCore = coreSrcNewest > coreDistNewest;
+  const checks = [{ name: "agentplane", root: agentplaneRoot }];
+  if (await exists(path.join(coreRoot, "src"))) checks.push({ name: "core", root: coreRoot });
+
+  const staleReasons = [];
+  for (const check of checks) {
+    const result = await isPackageBuildFresh(check.root);
+    if (!result.ok) staleReasons.push(`${check.name}:${result.reason}`);
   }
 
-  if ((isStaleAgentplane || isStaleCore) && !allowStale) {
+  if (staleReasons.length > 0 && !allowStale) {
     process.stderr.write(
-      "error: refusing to run a stale repo build (dist is older than src).\n" +
+      "error: refusing to run a stale repo build (manifest/git quick-check failed).\n" +
         "Fix:\n" +
         "  bun run --filter=@agentplaneorg/core build\n" +
         "  bun run --filter=agentplane build\n" +
+        `Detected: ${staleReasons.join(", ")}\n` +
         "Override (not recommended): set AGENTPLANE_DEV_ALLOW_STALE_DIST=1\n",
     );
     process.exitCode = 2;

package/dist/.build-manifest.json

@@ -0,0 +1,11 @@
+{
+  "schema_version": 1,
+  "package_dir": "/home/runner/work/agentplane/agentplane/packages/agentplane",
+  "generated_at": "2026-03-05T13:42:04.968Z",
+  "git_head": "7fdf3f088d7d98748b9ef5db06f5bef3766b534d",
+  "src_cli_mtime_ms": 1772718067546.3232,
+  "src_index_mtime_ms": null,
+  "dist_cli_mtime_ms": 1772718124490.9443,
+  "dist_index_mtime_ms": null,
+  "tsbuildinfo_mtime_ms": 1772718124554.9443
+}

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

@@ -3,6 +3,7 @@ export declare class LocalBackend implements TaskBackend {
     id: string;
     root: string;
     updatedBy: string;
+    private lastListWarnings;
     constructor(settings?: {
         dir?: string;
         updatedBy?: string;
@@ -12,6 +13,7 @@ export declare class LocalBackend implements TaskBackend {
         attempts: number;
     }): Promise<string>;
     listTasks(): Promise<TaskData[]>;
+    getLastListWarnings(): string[];
     getTask(taskId: string): Promise<TaskData | null>;
     getTasks(taskIds: string[]): Promise<(TaskData | null)[]>;
     getTaskDoc(taskId: string): Promise<string>;

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;gBAEN,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;IAgHhC,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;IAuB1E,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;IAoF/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,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;IAuB1E,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;IAoF/D,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIzD"}

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

@@ -9,6 +9,7 @@ export class LocalBackend {
     id = "local";
     root;
     updatedBy;
+    lastListWarnings = [];
     constructor(settings) {
         this.root = path.resolve(settings?.dir ?? ".agentplane/tasks");
         this.updatedBy = settings?.updatedBy ?? DEFAULT_DOC_UPDATED_BY;
@@ -38,6 +39,7 @@ export class LocalBackend {
     }
     async listTasks() {
         const tasks = [];
+        const warnings = [];
         const entries = await readdir(this.root, { withFileTypes: true }).catch(() => []);
         const indexPath = resolveTaskIndexPath(this.root);
         const cachedIndex = await loadTaskIndex(indexPath);
@@ -65,6 +67,7 @@ export class LocalBackend {
                 stats = await stat(readme);
             }
             catch {
+                warnings.push(`skip:${dirName}: missing_or_unreadable_readme`);
                 return null;
             }
             if (!stats.isFile())
@@ -79,6 +82,7 @@ export class LocalBackend {
                 text = await readFile(readme, "utf8");
             }
             catch {
+                warnings.push(`skip:${dirName}: unreadable_readme`);
                 return null;
             }
             let parsed;
@@ -86,11 +90,14 @@ export class LocalBackend {
                 parsed = parseTaskReadme(text);
             }
             catch {
+                warnings.push(`skip:${dirName}: invalid_readme_frontmatter`);
                 return null;
             }
             const fm = parsed.frontmatter;
-            if (!isRecord(fm) || Object.keys(fm).length === 0)
+            if (!isRecord(fm) || Object.keys(fm).length === 0) {
+                warnings.push(`skip:${dirName}: empty_or_invalid_frontmatter`);
                 return null;
+            }
             const taskId = (typeof fm.id === "string" ? fm.id : dirName).trim();
             const task = taskRecordToData({
                 id: taskId,
@@ -141,8 +148,12 @@ export class LocalBackend {
                 // Best-effort cache; ignore failures.
             }
         }
+        this.lastListWarnings = warnings;
         return tasks;
     }
+    getLastListWarnings() {
+        return [...this.lastListWarnings];
+    }
     async getTask(taskId) {
         const readme = taskReadmePath(this.root, taskId);
         let text = "";

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

@@ -1 +1 @@
-{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/redmine/mapping.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,QAAQ,EACd,MAAM,cAAc,CAAC;AAMtB,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASjE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIhE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,QAAQ,GAAG,IAAI,CAwElB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7F,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyC1B"}
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../../../src/backends/task-backend/redmine/mapping.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,QAAQ,EACd,MAAM,cAAc,CAAC;AAMtB,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASjE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIhE;AA2BD,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,GAAG,QAAQ,GAAG,IAAI,CAwElB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7F,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyC1B"}

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

@@ -23,6 +23,31 @@ export function doneRatioForStatus(status) {
         return 100;
     return 0;
 }
+function inferStatusFromIssue(issue) {
+    const statusVal = isRecord(issue.status) ? issue.status : null;
+    const statusName = toStringSafe(statusVal?.name).trim().toLowerCase();
+    const doneRatio = typeof issue.done_ratio === "number" ? issue.done_ratio : null;
+    const isClosed = statusVal?.is_closed === true;
+    // Redmine defaults (without explicit status_map) commonly use these ids.
+    const statusId = typeof statusVal?.id === "number" ? statusVal.id : null;
+    if (statusId === 2)
+        return "DOING";
+    if (statusId === 3 || statusId === 5 || statusId === 6)
+        return "DONE";
+    if (isClosed || (doneRatio !== null && doneRatio >= 100))
+        return "DONE";
+    if (statusName.includes("progress") || statusName.includes("doing"))
+        return "DOING";
+    if (statusName.includes("done") ||
+        statusName.includes("closed") ||
+        statusName.includes("resolved") ||
+        statusName.includes("complete")) {
+        return "DONE";
+    }
+    if (doneRatio !== null && doneRatio > 0)
+        return "DOING";
+    return "TODO";
+}
 export function issueToTask(opts) {
     const taskId = opts.taskIdOverride ?? customFieldValue(opts.issue, opts.customFields.task_id);
     if (!taskId)
@@ -31,7 +56,7 @@ export function issueToTask(opts) {
     const statusId = statusVal && typeof statusVal.id === "number" ? statusVal.id : null;
     const status = statusId !== null && opts.reverseStatus.has(statusId)
         ? opts.reverseStatus.get(statusId)
-        : "TODO";
+        : inferStatusFromIssue(opts.issue);
     const verifyVal = customFieldValue(opts.issue, opts.customFields.verify);
     const commitVal = customFieldValue(opts.issue, opts.customFields.commit);
     const docVal = customFieldValue(opts.issue, opts.customFields.doc);

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

@@ -25,6 +25,7 @@ export declare class RedmineBackend implements TaskBackend {
     cache: LocalBackend | null;
     issueCache: Map<string, Record<string, unknown>>;
     reverseStatus: Map<number, string>;
+    inferredStatusByTaskStatus: Map<string, number> | null;
     constructor(settings: RedmineSettings, opts: {
         cache?: LocalBackend | null;
     });
@@ -62,6 +63,9 @@ export declare class RedmineBackend implements TaskBackend {
     private setIssueCustomFieldValue;
     private listTasksRemote;
     private issueFromPayload;
+    private inferStatusIdForTaskStatus;
+    private loadInferredStatusByTaskStatus;
+    private selectInferredStatus;
     private findIssueByTaskId;
     private issueToTask;
     private taskToIssuePayload;

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

@@ -22,6 +22,7 @@ export class RedmineBackend {
     cache;
     issueCache = new Map();
     reverseStatus = new Map();
+    inferredStatusByTaskStatus = null;
     constructor(settings, opts) {
         const env = readRedmineEnv();
         this.baseUrl = firstNonEmptyString(env.url, settings.url).replaceAll(/\/+$/gu, "");
@@ -89,11 +90,8 @@ export class RedmineBackend {
     }
     async listTasks() {
         try {
-            const tasks = await this.listTasksRemote();
-            for (const task of tasks) {
-                await this.cacheTask(task, false);
-            }
-            return tasks;
+            // Read-only listing must not rewrite local task READMEs through cache updates.
+            return await this.listTasksRemote();
         }
         catch (err) {
             if (err instanceof RedmineUnavailable) {
@@ -119,10 +117,8 @@ export class RedmineBackend {
             const issue = await this.findIssueByTaskId(taskId);
             if (!issue)
                 return null;
-            const task = this.issueToTask(issue, taskId);
-            if (task)
-                await this.cacheTask(task, false);
-            return task;
+            // Read-only fetch must not rewrite local task READMEs through cache updates.
+            return this.issueToTask(issue, taskId);
         }
         catch (err) {
             if (err instanceof RedmineUnavailable) {
@@ -249,6 +245,11 @@ export class RedmineBackend {
                 existingIssue = this.issueFromPayload(payload);
             }
             const payload = this.taskToIssuePayload(task, existingIssue ?? undefined);
+            if (payload.status_id === undefined) {
+                const inferredStatusId = await this.inferStatusIdForTaskStatus(task.status);
+                if (inferredStatusId !== null)
+                    payload.status_id = inferredStatusId;
+            }
             if (issueIdText) {
                 await this.requestJson("PUT", `issues/${issueIdText}.json`, { issue: payload });
             }
@@ -437,6 +438,88 @@ export class RedmineBackend {
     issueFromPayload(payload) {
         return isRecord(payload.issue) ? payload.issue : null;
     }
+    async inferStatusIdForTaskStatus(statusRaw) {
+        const status = toStringSafe(statusRaw).trim().toUpperCase();
+        if (!status)
+            return null;
+        const explicit = this.statusMap?.[status];
+        if (typeof explicit === "number" && Number.isFinite(explicit))
+            return explicit;
+        const inferred = await this.loadInferredStatusByTaskStatus();
+        return inferred.get(status) ?? null;
+    }
+    async loadInferredStatusByTaskStatus() {
+        if (this.inferredStatusByTaskStatus)
+            return this.inferredStatusByTaskStatus;
+        const map = new Map();
+        this.inferredStatusByTaskStatus = map;
+        try {
+            const payload = await this.requestJson("GET", "issue_statuses.json");
+            const statuses = Array.isArray(payload.issue_statuses) ? payload.issue_statuses : [];
+            const parsed = [];
+            for (const item of statuses) {
+                if (!isRecord(item))
+                    continue;
+                const id = typeof item.id === "number" ? item.id : null;
+                if (!id || !Number.isFinite(id))
+                    continue;
+                parsed.push({
+                    id,
+                    name: toStringSafe(item.name).trim().toLowerCase(),
+                    isClosed: item.is_closed === true,
+                    isDefault: item.is_default === true,
+                });
+            }
+            const done = this.selectInferredStatus(parsed, "DONE");
+            const doing = this.selectInferredStatus(parsed, "DOING");
+            const todo = this.selectInferredStatus(parsed, "TODO");
+            if (done !== null)
+                map.set("DONE", done);
+            if (doing !== null)
+                map.set("DOING", doing);
+            if (todo !== null)
+                map.set("TODO", todo);
+        }
+        catch {
+            // Best effort: keep previous behavior when status discovery is unavailable.
+        }
+        return map;
+    }
+    selectInferredStatus(statuses, target) {
+        if (statuses.length === 0)
+            return null;
+        if (target === "DOING") {
+            const byId = statuses.find((item) => item.id === 2);
+            if (byId)
+                return byId.id;
+            const byName = statuses.find((item) => item.name.includes("progress") || item.name.includes("doing"));
+            if (byName)
+                return byName.id;
+            return null;
+        }
+        if (target === "DONE") {
+            const closed = statuses.find((item) => item.isClosed);
+            if (closed)
+                return closed.id;
+            const byId = statuses.find((item) => item.id === 5 || item.id === 3 || item.id === 6);
+            if (byId)
+                return byId.id;
+            const byName = statuses.find((item) => item.name.includes("done") ||
+                item.name.includes("closed") ||
+                item.name.includes("resolved") ||
+                item.name.includes("complete"));
+            if (byName)
+                return byName.id;
+            return null;
+        }
+        const byDefault = statuses.find((item) => item.isDefault);
+        if (byDefault)
+            return byDefault.id;
+        const byId = statuses.find((item) => item.id === 1);
+        if (byId)
+            return byId.id;
+        return statuses[0]?.id ?? null;
+    }
     async findIssueByTaskId(taskId) {
         const taskFieldId = this.taskIdFieldId();
         return await findIssueByTaskIdImpl({

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

@@ -58,6 +58,7 @@ export type TaskDocMeta = Pick<TaskData, "doc" | "doc_version" | "doc_updated_at
 export type TaskBackend = {
     id: string;
     listTasks(): Promise<TaskData[]>;
+    getLastListWarnings?(): string[];
     getTask(taskId: string): Promise<TaskData | null>;
     getTasks?(taskIds: string[]): Promise<(TaskData | null)[]>;
     writeTask(task: TaskData): 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-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-index.d.ts","sourceRoot":"","sources":["../../src/backends/task-index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAI3C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,CAAC,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC;AAE5C,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU7D;AA8ED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAWpF;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5F;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,cAAc,CAMhB"}
+{"version":3,"file":"task-index.d.ts","sourceRoot":"","sources":["../../src/backends/task-index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAI3C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,CAAC,CAAC;IAClB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,cAAc,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,eAAe,CAAC;AAE5C,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU7D;AA8ED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAWpF;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5F;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,cAAc,CAahB"}

package/dist/backends/task-index.js

@@ -123,8 +123,15 @@ export async function saveTaskIndex(indexPath, index) {
     await writeJsonStableIfChanged(indexPath, index);
 }
 export function buildTaskIndexEntry(task, readmePath, mtimeMs) {
+    const compactTask = {
+        ...task,
+        // Keep the index payload lean for list/search/next paths.
+        doc: undefined,
+        comments: undefined,
+        events: undefined,
+    };
     return {
-        task,
+        task: compactTask,
         readmePath,
         mtimeMs,
     };

package/dist/cli/command-guide.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-guide.d.ts","sourceRoot":"","sources":["../../src/cli/command-guide.ts"],"names":[],"mappings":"AAgMA,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CA8EzC"}
+{"version":3,"file":"command-guide.d.ts","sourceRoot":"","sources":["../../src/cli/command-guide.ts"],"names":[],"mappings":"AAkMA,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAEpC;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CA2FzC"}

package/dist/cli/command-guide.js

@@ -1,3 +1,4 @@
+import { COMMAND_SNIPPETS } from "./command-snippets.js";
 const CHEAT_SHEET_ROWS = [
     {
         operation: "PLANNER: list/show tasks",
@@ -143,7 +144,7 @@ const ROLE_GUIDES = [
     {
         role: "REDMINE",
         lines: [
-            "- Sync before/after updates: `agentplane sync redmine --direction pull` / `agentplane sync redmine --direction push --yes`",
+            `- Sync before/after updates: \`${COMMAND_SNIPPETS.sync.pullRedmineExplicit}\` / \`${COMMAND_SNIPPETS.sync.pushRedmineExplicitWithYes}\``,
             "- Then use normal task/doc commands (`agentplane task list` / `agentplane task show` / `agentplane task update` / `agentplane task doc set`) as needed.",
         ],
     },
@@ -201,11 +202,18 @@ export function renderQuickstart() {
         "",
         "## Daily task workflow",
         "",
-        "- `agentplane task list` / `agentplane task show <task-id>`",
-        '- `agentplane task new --title "..." --description "..." --priority med --owner CODER --tag <tag>`',
-        '- `agentplane start <task-id> --author <ROLE> --body "Start: ..."`',
-        '- `agentplane verify <task-id> --ok|--rework --by <ROLE> --note "..."`',
-        '- `agentplane finish <task-id> --author <ROLE> --body "Verified: ..." --commit <git-rev> --close-commit`',
+        `- \`${COMMAND_SNIPPETS.core.taskList}\` / \`${COMMAND_SNIPPETS.core.taskShow}\``,
+        `- \`${COMMAND_SNIPPETS.core.taskNew}\``,
+        `- \`${COMMAND_SNIPPETS.core.startTask}\``,
+        `- \`${COMMAND_SNIPPETS.core.verifyTask}\``,
+        `- \`${COMMAND_SNIPPETS.core.finishTask}\``,
+        "",
+        "## Harness engeneering loop",
+        "",
+        "- Constrain: policy + workflow contract first.",
+        "- Execute: small explicit transitions.",
+        "- Observe: structured artifacts and diagnostics.",
+        "- Recover: deterministic fallback before manual repair.",
         "",
         "## Branch workflow (branch_pr)",
         "",
@@ -213,7 +221,12 @@ export function renderQuickstart() {
         "- `agentplane pr open <task-id>` / `agentplane pr update <task-id>` / `agentplane pr check <task-id>`",
         "- `agentplane integrate <task-id> --branch task/<task-id>/<slug> --run-verify`",
         "",
-        "## Recipes and scenarios",
+        "## Workflow operations (core)",
+        "- `agentplane workflow debug`",
+        "- `agentplane workflow sync`",
+        "- `agentplane workflow land`",
+        "",
+        "## Recipes and scenarios (extensions)",
         "",
         "- `agentplane recipes list`",
         "- `agentplane recipes list --tag <tag>`",
@@ -223,7 +236,7 @@ export function renderQuickstart() {
         "",
         "## More guidance",
         "",
-        "- `agentplane quickstart` and `agentplane role <ROLE>` show command guidance.",
+        `- \`${COMMAND_SNIPPETS.core.quickstart}\` and \`${COMMAND_SNIPPETS.core.role}\` show command guidance.`,
         "",
         "## Agent cheat sheet",
         "",

package/dist/cli/command-snippets.d.ts

@@ -0,0 +1,24 @@
+export declare const COMMAND_SNIPPETS: {
+    readonly core: {
+        readonly taskList: "agentplane task list";
+        readonly taskShow: "agentplane task show <task-id>";
+        readonly taskNew: "agentplane task new --title \"...\" --description \"...\" --priority med --owner CODER --tag <tag>";
+        readonly startTask: "agentplane start <task-id> --author <ROLE> --body \"Start: ...\"";
+        readonly verifyTask: "agentplane verify <task-id> --ok|--rework --by <ROLE> --note \"...\"";
+        readonly finishTask: "agentplane finish <task-id> --author <ROLE> --body \"Verified: ...\" --commit <git-rev> --close-commit";
+        readonly quickstart: "agentplane quickstart";
+        readonly role: "agentplane role <ROLE>";
+    };
+    readonly sync: {
+        readonly pullConfigured: "agentplane sync --direction pull";
+        readonly pushConfiguredWithYes: "agentplane sync --direction push --yes";
+        readonly pullRedmineExplicit: "agentplane sync redmine --direction pull";
+        readonly pushRedmineExplicitWithYes: "agentplane sync redmine --direction push --yes";
+    };
+    readonly backendSync: {
+        readonly pullLocal: "agentplane backend sync local --direction pull";
+        readonly pullRedmine: "agentplane backend sync redmine --direction pull";
+        readonly pushRedmineWithYes: "agentplane backend sync redmine --direction push --yes";
+    };
+};
+//# sourceMappingURL=command-snippets.d.ts.map

package/dist/cli/command-snippets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-snippets.d.ts","sourceRoot":"","sources":["../../src/cli/command-snippets.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;CAwBnB,CAAC"}