agentplane 0.2.25 → 0.3.1

package/assets/policy/workflow.release.md

@@ -0,0 +1,31 @@
+# Workflow: release
+
+Use this module when task touches release/version/publish flows.
+
+## Required sequence
+
+1. CHECKPOINT A: confirm clean tracked tree and approved scope.
+2. CHECKPOINT B: generate release plan and freeze version/tag target.
+3. Generate release notes with complete human-readable coverage of all task-level changes.
+4. Run release prepublish checks.
+5. CHECKPOINT C: apply release and push/tag only after all gates pass.
+6. Record release evidence (commands, outputs, resulting version/tag).
+
+## Command contract
+
+```bash
+git status --short --untracked-files=no
+agentplane task plan set <task-id> --text "Release plan: version=<v>, tag=<t>, scope=<...>" --updated-by <ROLE>
+agentplane task plan approve <task-id> --by ORCHESTRATOR
+agentplane release plan --patch
+agentplane release apply --push --yes
+agentplane verify <task-id> --ok|--rework --by <ROLE> --note "Release checks: ..."
+agentplane finish <task-id> --author <ROLE> --body "Verified: release" --result "Release <v> published" --commit <git-rev> --close-commit
+```
+
+## Constraints
+
+- MUST NOT perform irreversible release actions before explicit approval.
+- MUST NOT skip parity/version checks.
+- MUST NOT bypass required notes validation.
+- MUST stop and request re-approval if release scope/tag/version changes.

package/assets/policy/workflow.upgrade.md

@@ -0,0 +1,20 @@
+# Workflow: upgrade
+
+Use this module when task runs `agentplane upgrade` or touches `.agentplane/.upgrade/**`.
+
+## Required sequence
+
+1. Run upgrade command and capture run directory.
+2. Read upgrade review report:
+   - agent mode: `.agentplane/.upgrade/agent/<runId>/review.json`
+   - auto mode: `.agentplane/.upgrade/last-review.json`
+3. Apply upgrade as replace-all for managed files (`agentplane upgrade --auto`), excluding task data paths.
+4. For `.agentplane/policy/incidents.md`, keep existing local content and append incoming policy content (never replace non-empty local incidents file).
+5. Ensure the upgrade produced a dedicated upgrade commit with version in commit message.
+6. Verify policy/agent consistency and routing checks.
+7. Record run path and reviewed files in task notes.
+
+## Minimum verification
+
+- `node .agentplane/policy/check-routing.mjs`
+- `agentplane agents`

package/bin/agentplane.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import path from "node:path";
-import { readdir, stat } from "node:fs/promises";
+import { stat } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
+import { distExists, isPackageBuildFresh } from "./dist-guard.js";
 
 async function exists(p) {
   try {
@@ -35,47 +36,18 @@ 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;
+function isHooksRunCommitMsgInvocation(argv) {
+  const args = argv.slice(2).map((value) => String(value ?? "").trim());
+  for (let i = 0; i < args.length; i += 1) {
+    if (args[i] !== "hooks") continue;
+    return args[i + 1] === "run" && args[i + 2] === "commit-msg";
+  }
   return false;
 }
 
-// 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
-      }
-    }
-  }
-  return newest;
+function isPathInside(baseDir, targetPath) {
+  const rel = path.relative(path.resolve(baseDir), path.resolve(targetPath));
+  return rel === "" || (!rel.startsWith("..") && !path.isAbsolute(rel));
 }
 
 async function assertDistUpToDate() {
@@ -85,8 +57,7 @@ async function assertDistUpToDate() {
   if (!inRepo) return true;
 
   const allowStale = (process.env.AGENTPLANE_DEV_ALLOW_STALE_DIST ?? "").trim() === "1";
-  const agentplaneDistDir = path.join(agentplaneRoot, "dist");
-  if (!(await exists(agentplaneDistDir))) {
+  if (!(await distExists(agentplaneRoot))) {
     process.stderr.write(
       "error: agentplane dist is missing for this repo checkout.\n" +
         "Fix:\n" +
@@ -97,29 +68,48 @@ 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,
+      watchedPaths: ["src", "bin/agentplane.js", "bin/dist-guard.js"],
+    },
+  ];
+  if (await exists(path.join(coreRoot, "src")))
+    checks.push({ name: "core", root: coreRoot, watchedPaths: ["src"] });
+
+  const staleReasons = [];
+  for (const check of checks) {
+    const result = await isPackageBuildFresh(check.root, { watchedPaths: check.watchedPaths });
+    if (!result.ok) {
+      const detail =
+        Array.isArray(result.changedPaths) && result.changedPaths.length > 0
+          ? `(${result.changedPaths.slice(0, 5).join(", ")}${result.changedPaths.length > 5 ? ", ..." : ""})`
+          : "";
+      staleReasons.push(`${check.name}:${result.reason}${detail}`);
+    }
   }
 
-  if ((isStaleAgentplane || isStaleCore) && !allowStale) {
+  if (staleReasons.length > 0 && !allowStale) {
+    const runningInsideCheckout = isPathInside(repoRoot, process.cwd());
+    if (!runningInsideCheckout) {
+      process.stderr.write(
+        "warning: linked development binary has a stale build, but current working directory is outside the agentplane checkout.\n" +
+          "proceeding with existing dist output.\n" +
+          `detected: ${staleReasons.join(", ")}\n` +
+          "tip: rebuild (`bun run --filter=@agentplaneorg/core build && bun run --filter=agentplane build`) or reinstall from npm for stable global usage.\n",
+      );
+      return true;
+    }
+
     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;
@@ -130,5 +120,5 @@ async function assertDistUpToDate() {
 }
 
 await maybeWarnGlobalBinaryInRepoCheckout();
-const ok = await assertDistUpToDate();
+const ok = isHooksRunCommitMsgInvocation(process.argv) ? true : await assertDistUpToDate();
 if (ok) await import("../dist/cli.js");

package/bin/dist-guard.js

@@ -0,0 +1,124 @@
+import { execFileSync } from "node:child_process";
+import path from "node:path";
+import { readFile, stat } from "node:fs/promises";
+
+async function exists(p) {
+  try {
+    await stat(p);
+    return true;
+  } catch {
+    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;
+  }
+}
+
+function resolveGitHead(cwd) {
+  try {
+    return execFileSync("git", ["rev-parse", "HEAD"], { cwd, encoding: "utf8" }).trim() || null;
+  } catch {
+    return null;
+  }
+}
+
+function listGitPaths(cwd, args) {
+  try {
+    const out = execFileSync("git", args, { cwd, encoding: "utf8" });
+    return out
+      .split(/\r?\n/u)
+      .map((line) => line.trim())
+      .filter(Boolean);
+  } catch {
+    return [];
+  }
+}
+
+function uniqueSorted(values) {
+  return [...new Set(values)].toSorted((a, b) => a.localeCompare(b));
+}
+
+function workingTreeChangedPaths(cwd, watchedPaths) {
+  const lines = listGitPaths(cwd, [
+    "status",
+    "--porcelain",
+    "--untracked-files=all",
+    "--",
+    ...watchedPaths,
+  ]);
+  return uniqueSorted(lines.map((line) => line.slice(3).trim()).filter(Boolean));
+}
+
+function committedChangedPathsSince(cwd, fromGitHead, watchedPaths) {
+  if (!fromGitHead) return [];
+  return uniqueSorted(
+    listGitPaths(cwd, ["diff", "--name-only", `${fromGitHead}..HEAD`, "--", ...watchedPaths]),
+  );
+}
+
+async function fileMtimeMs(p) {
+  try {
+    const s = await stat(p);
+    if (!s.isFile()) return null;
+    return s.mtimeMs;
+  } catch {
+    return null;
+  }
+}
+
+export async function isPackageBuildFresh(packageRoot, options = {}) {
+  const watchedPaths = options.watchedPaths ?? ["src"];
+  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", changedPaths: [] };
+  }
+
+  const currentHead = resolveGitHead(packageRoot);
+  const changedPaths = uniqueSorted([
+    ...committedChangedPathsSince(packageRoot, manifest.git_head, watchedPaths),
+    ...workingTreeChangedPaths(packageRoot, watchedPaths),
+  ]);
+
+  if (changedPaths.length > 0) {
+    return { ok: false, reason: "watched_paths_changed", changedPaths };
+  }
+
+  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", changedPaths: [] };
+  }
+  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", changedPaths: [] };
+  }
+
+  if (manifest.git_head && currentHead && manifest.git_head !== currentHead) {
+    return { ok: true, reason: "fresh_after_non_runtime_head_change", changedPaths: [] };
+  }
+
+  return { ok: true, reason: "fresh", changedPaths: [] };
+}
+
+export async function distExists(packageRoot) {
+  return await exists(path.join(packageRoot, "dist"));
+}

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-06T15:25:37.651Z",
+  "git_head": "1be96fc47916b76925f9bc59ce7d24176216a87f",
+  "src_cli_mtime_ms": 1772810682734.0005,
+  "src_index_mtime_ms": null,
+  "dist_cli_mtime_ms": 1772810737168.81,
+  "dist_index_mtime_ms": null,
+  "tsbuildinfo_mtime_ms": 1772810737234.8098
+}

package/dist/agents/agents-template.d.ts

@@ -1,10 +1,17 @@
+import { type PolicyGatewayFlavor } from "../shared/policy-gateway.js";
 export type WorkflowMode = "direct" | "branch_pr";
 type AgentTemplate = {
     fileName: string;
     contents: string;
 };
+export type PolicyTemplate = {
+    relativePath: string;
+    contents: string;
+};
 export declare function loadAgentsTemplate(): Promise<string>;
 export declare function loadAgentTemplates(): Promise<AgentTemplate[]>;
+export declare function loadPolicyTemplates(): Promise<PolicyTemplate[]>;
 export declare function filterAgentsByWorkflow(template: string, workflow: WorkflowMode): string;
+export declare function loadPolicyGatewayTemplate(flavor: PolicyGatewayFlavor): Promise<string>;
 export {};
 //# sourceMappingURL=agents-template.d.ts.map

package/dist/agents/agents-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents-template.d.ts","sourceRoot":"","sources":["../../src/agents/agents-template.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAElD,KAAK,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAwC5D,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAG1D;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAanE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CASvF"}
+{"version":3,"file":"agents-template.d.ts","sourceRoot":"","sources":["../../src/agents/agents-template.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAC;AAUrC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,WAAW,CAAC;AAElD,KAAK,aAAa,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAwCxE,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAE1D;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAanE;AAsBD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAerE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CASvF;AAED,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAI5F"}

package/dist/agents/agents-template.js

@@ -1,8 +1,10 @@
 import { readdir, readFile } from "node:fs/promises";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { policyGatewayFileName, renderPolicyGatewayTemplateText, } from "../shared/policy-gateway.js";
 const AGENTS_TEMPLATE_URL = new URL("../../assets/AGENTS.md", import.meta.url);
 const AGENTS_DIR_URL = new URL("../../assets/agents/", import.meta.url);
+const POLICY_DIR_URL = new URL("../../assets/policy/", import.meta.url);
 const HEADING_RE = /^(#+)\s+(.*)$/;
 function ensureTrailingNewline(text) {
     return text.endsWith("\n") ? text : `${text}\n`;
@@ -41,8 +43,7 @@ function removeSections(lines, titles) {
     return lines.filter((_line, index) => !shouldRemove.has(index));
 }
 export async function loadAgentsTemplate() {
-    const text = await readFile(AGENTS_TEMPLATE_URL, "utf8");
-    return ensureTrailingNewline(text.trimEnd());
+    return loadPolicyGatewayTemplate("codex");
 }
 export async function loadAgentTemplates() {
     const dirPath = fileURLToPath(AGENTS_DIR_URL);
@@ -56,6 +57,39 @@ export async function loadAgentTemplates() {
     }
     return templates;
 }
+async function listFilesRecursive(dirPath, relPrefix = "") {
+    const entries = await readdir(dirPath, { withFileTypes: true });
+    const sorted = entries.toSorted((a, b) => a.name.localeCompare(b.name));
+    const files = [];
+    for (const entry of sorted) {
+        // Ignore editor/OS hidden metadata files.
+        if (entry.name.startsWith("."))
+            continue;
+        const absPath = path.join(dirPath, entry.name);
+        const relPath = relPrefix ? `${relPrefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            files.push(...(await listFilesRecursive(absPath, relPath)));
+            continue;
+        }
+        if (entry.isFile())
+            files.push(relPath);
+    }
+    return files;
+}
+export async function loadPolicyTemplates() {
+    const dirPath = fileURLToPath(POLICY_DIR_URL);
+    const relFiles = await listFilesRecursive(dirPath);
+    const templates = [];
+    for (const relFile of relFiles) {
+        const filePath = path.join(dirPath, relFile);
+        const contents = await readFile(filePath, "utf8");
+        templates.push({
+            relativePath: relFile.replaceAll("\\", "/"),
+            contents: ensureTrailingNewline(contents.trimEnd()),
+        });
+    }
+    return templates;
+}
 export function filterAgentsByWorkflow(template, workflow) {
     const lines = template.replaceAll("\r\n", "\n").split("\n");
     const removeTitles = workflow === "direct"
@@ -64,3 +98,8 @@ export function filterAgentsByWorkflow(template, workflow) {
     const filtered = removeSections(lines, removeTitles);
     return ensureTrailingNewline(filtered.join("\n").trimEnd());
 }
+export async function loadPolicyGatewayTemplate(flavor) {
+    const text = await readFile(AGENTS_TEMPLATE_URL, "utf8");
+    const rendered = renderPolicyGatewayTemplateText(text, policyGatewayFileName(flavor));
+    return ensureTrailingNewline(rendered.trimEnd());
+}

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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"}