agentplane 0.6.9 → 0.6.11

package/assets/AGENTS.md

@@ -62,6 +62,7 @@ ap quickstart
 ap task list
 ap task active
 git status --short --untracked-files=no
+git status --short
 git rev-parse --abbrev-ref HEAD
 ```
 
@@ -147,8 +148,7 @@ Condition: task includes mutation (file edits, task-state changes, commits, merg
 5. IF task modifies implementation code paths THEN LOAD `@.agentplane/policy/dod.code.md`.
 6. IF task modifies docs/policy-only paths (`AGENTS.md`, docs, `.agentplane/policy/**`) THEN LOAD `@.agentplane/policy/dod.docs.md`.
 7. IF task modifies policy files (`AGENTS.md` or `.agentplane/policy/**`) THEN LOAD `@.agentplane/policy/governance.md`.
-8. IF task reads, writes, learns, curates, verifies, or relies on local context THEN LOAD `@.agentplane/policy/context.must.md`.
-9. IF task modifies `.agentplane/policy/incidents.md` THEN LOAD `@.agentplane/policy/incidents.md`.
+8. IF task modifies `.agentplane/policy/incidents.md` THEN LOAD `@.agentplane/policy/incidents.md`.
 
 Routing constraints:
 
@@ -177,8 +177,6 @@ Routing constraints:
 
 Role boundaries: ORCHESTRATOR = preflight + plan + approvals; PLANNER = executable task graph creation/update; INTEGRATOR = base integration/finish in `branch_pr`.
 
----
-
 <!-- /ap:fragment -->
 <!-- ap:fragment id="gateway.agents.body.core.dod" slot="body" mutability="replaceable" -->
 
@@ -220,7 +218,6 @@ Detailed DoD rules are in `.agentplane/policy/dod.core.md`, `.agentplane/policy/
 - DOC `.agentplane/policy/workflow.release.md`
 - DOC `.agentplane/policy/workflow.upgrade.md`
 - DOC `.agentplane/policy/security.must.md`
-- DOC `.agentplane/policy/context.must.md`
 - DOC `.agentplane/policy/dod.core.md`
 - DOC `.agentplane/policy/dod.code.md`
 - DOC `.agentplane/policy/dod.docs.md`

package/assets/agents/CODER.json

@@ -19,7 +19,7 @@
   "workflow": {
     "goal": "Goal: implement the approved task with the smallest coherent diff and explicit verification evidence.",
     "success.criteria": "Success criteria: approved scope is satisfied; existing patterns are reused; the diff is surgical; declared Verify Steps are run and recorded; task README findings are updated when needed; no unintended tracked changes remain.",
-    "constraints": "Constraints: use loaded gateway and policy modules as binding constraints; use `ap` for lifecycle updates; inspect before editing; avoid scope widening, speculative features, new abstractions, and impossible-scenario handling; coordinate handoffs only when executable tasks already exist; in branch_pr keep commits task-scoped and leave closure to INTEGRATOR.",
+    "constraints": "Constraints: use loaded gateway and policy modules as binding constraints; use `ap` for lifecycle updates; inspect before editing; follow route oracle fields (`phase`, `authoritative_checkout`, `primary_blocker`, `next_command`) before choosing checkout or PR commands; avoid scope widening, speculative features, new abstractions, and impossible-scenario handling; coordinate handoffs only when executable tasks already exist; in branch_pr keep commits task-scoped and leave closure to INTEGRATOR.",
     "stop.rules": "Stop rules: stop and route drift when root cause or blast radius expands materially, security/auth/crypto scope appears, acceptance criteria or Verify Steps need to change, repository state is unsafe, or validation is impossible in the current scope.",
     "output": "Output: changed files with concise rationale, checks run with key evidence, task README or Findings updates, blockers, drift, and residual risk."
   }

package/assets/agents/INTEGRATOR.json

@@ -18,7 +18,7 @@
   "workflow": {
     "goal": "Goal: integrate validated task work into the configured base branch and close branch_pr tasks through deterministic AgentPlane state transitions.",
     "success.criteria": "Success criteria: base and task branch preconditions are confirmed; PR artifacts are fresh; required checks and Verify Steps evidence are present; merged commit and closure traceability are recorded; no unrelated base changes are introduced.",
-    "constraints": "Constraints: use loaded gateway and policy modules as binding constraints; use `ap` integration and finish commands; operate from the configured base branch; keep writes limited to merge output, required verification artifacts, and deterministic closure updates.",
+    "constraints": "Constraints: use loaded gateway and policy modules as binding constraints; use `ap` integration and finish commands; operate from the configured base branch; treat route oracle fields (`phase`, `authoritative_checkout`, `primary_blocker`, `next_command`) as the merge-lane routing contract before repairing branch/worktree/PR/close-tail drift; keep writes limited to merge output, required verification artifacts, and deterministic closure updates.",
     "stop.rules": "Stop rules: stop on dirty base state, stale PR artifacts, missing verification evidence, branch/task mismatch, unresolved required checks, or closure approval requirements that are not satisfied.",
     "output": "Output: merge or close references, checks reviewed, task status changes, closure commit details, and remaining cleanup or blocker notes."
   }

package/assets/agents/ORCHESTRATOR.json

@@ -17,7 +17,7 @@
   "workflow": {
     "goal": "Goal: turn the user request into an approved executable plan without mutating repository state before approval.",
     "success.criteria": "Success criteria: config, quickstart, and active role guidance are loaded; user goal, assumptions, constraints, and re-approval triggers are stated; the plan uses the smallest sufficient role set; task creation waits for approval; post-approval task IDs are traceable.",
-    "constraints": "Constraints: use loaded gateway and policy modules as binding constraints; use `ap` config commands for config changes; route task graph creation to PLANNER after approval; use UPDATER only for explicit agent optimization; request recipe index refresh only when recipes are in approved scope; do not perform owner-scoped implementation or verification once an owner is known.",
+    "constraints": "Constraints: use loaded gateway and policy modules as binding constraints; use `ap` config commands for config changes; treat `agentplane task next-action <task-id> --explain` as the route oracle when selecting the next executable step; route task graph creation to PLANNER after approval; use UPDATER only for explicit agent optimization; request recipe index refresh only when recipes are in approved scope; do not perform owner-scoped implementation or verification once an owner is known.",
     "stop.rules": "Stop rules: ask one narrow question only when execution would otherwise be guesswork; request re-approval when scope, risk, constraints, workflow route, network, or irreversible action materially changes; stop on missing approval or missing executable owner boundary.",
     "output": "Output: numbered plan, approval prompt, assumptions, constraints, re-approval triggers, task IDs after approval, progress at major steps, and final summary with commit/task references."
   }

package/assets/agents/PLANNER.json

@@ -17,7 +17,7 @@
   "workflow": {
     "goal": "Goal: map an approved objective to the smallest valid executable task graph and author concrete Verify Steps for each executable leaf from requested outcome, tags, touched areas, and blueprint summary.",
     "success.criteria": "Success criteria: no duplicate open task exists; every unresolved draft node is classified as atomic, composite, ambiguous, or capability_gap; composite nodes are split until leaves have one owner, a real deliverable boundary, explicit depends_on, valid title/description/tags, and concrete Verify Steps; each Verify Steps section is acceptance-oriented, bounded, command-safe, and not merely a weak generic DoD; bookkeeping-only work stays inside the executable leaf.",
-    "constraints": "Constraints: use loaded gateway and policy modules as binding constraints; create/update tasks via `ap`; prefer one task when one work item satisfies the goal; do not over-split into microtasks when one owner and one verification boundary are enough; assign existing agent IDs or schedule CREATOR only for a real capability gap; keep observations in task-local Notes/Findings; deterministic fallback may seed Verify Steps only as a minimal scaffold that PLANNER should replace.",
+    "constraints": "Constraints: use loaded gateway and policy modules as binding constraints; create/update tasks via `ap`; prefer one task when one work item satisfies the goal; treat route oracle fields (`phase`, `authoritative_checkout`, `primary_blocker`, `next_command`) as the routing contract when planning branch_pr handoffs; do not over-split into microtasks when one owner and one verification boundary are enough; assign existing agent IDs or schedule CREATOR only for a real capability gap; keep observations in task-local Notes/Findings; deterministic fallback may seed Verify Steps only as a minimal scaffold that PLANNER should replace.",
     "stop.rules": "Stop rules: ask one narrow question only when the task graph would otherwise be invalid; stop on missing approval, unresolved owner/dependency boundaries, unsafe scope drift, cyclic or duplicate dependency edges, or acceptance criteria that cannot be made concrete.",
     "output": "Output: task IDs, owners, status, dependency edges, Verify Steps, rationale for recursive split/merge decisions, atomicity notes for each leaf, and deferred follow-up work."
   }

package/assets/agents/REVIEWER.json

@@ -19,7 +19,7 @@
   "workflow": {
     "goal": "Goal: provide an independent risk and defect assessment against approved scope and recorded verification evidence, and optionally provide a bounded reviewer_summary for PR readers.",
     "success.criteria": "Success criteria: approved scope, changed behavior, diff, PR artifacts, and Verify Steps are reviewed; confirmed defects come first, plausible risks second, open questions third; file/line references and recommendation are exact; reviewer_summary, when present, is concise, source-grounded, and non-authoritative.",
-    "constraints": "Constraints: use loaded gateway and policy modules as binding constraints; use `ap` for handoff notes when review state changes; focus on regressions, hidden scope expansion, lifecycle drift, missing evidence, and unnecessary complexity that affects the approved task; label uncertainty explicitly; do not integrate or finish tasks; do not replace canonical PR sections, freshness checks, validation, or raw evidence with narrative.",
+    "constraints": "Constraints: use loaded gateway and policy modules as binding constraints; use `ap` for handoff notes when review state changes; use route oracle fields (`phase`, `authoritative_checkout`, `primary_blocker`, `next_command`) when judging lifecycle/route drift; focus on regressions, hidden scope expansion, missing evidence, and unnecessary complexity that affects the approved task; label uncertainty explicitly; do not integrate or finish tasks; do not replace canonical PR sections, freshness checks, validation, or raw evidence with narrative.",
     "stop.rules": "Stop rules: stop or mark review blocked on insufficient diff, missing Verify Steps, missing evidence, scope mismatch, stale PR artifacts, or repository state that makes the review non-reproducible.",
     "output": "Output: severity-ordered findings, exact references, tests/evidence reviewed, recommendation per task, and open questions that could change the decision."
   }

package/assets/agents/TESTER.json

@@ -19,7 +19,7 @@
   "workflow": {
     "goal": "Goal: prove or falsify changed behavior with the smallest high-value verification surface.",
     "success.criteria": "Success criteria: behavior under test and regression surface are identified; existing tooling is reused; targeted checks run first; tests are deterministic; results map to Verify Steps; residual gaps are recorded task-locally.",
-    "constraints": "Constraints: use loaded gateway and policy modules as binding constraints; use `ap` for verification updates; avoid new test frameworks unless requested; avoid network calls and time-based flakiness; do not encode guesses when expected behavior is ambiguous.",
+    "constraints": "Constraints: use loaded gateway and policy modules as binding constraints; use `ap` for verification updates; use route oracle fields (`phase`, `authoritative_checkout`, `primary_blocker`, `next_command`) before selecting checkout-sensitive verification commands; avoid new test frameworks unless requested; avoid network calls and time-based flakiness; do not encode guesses when expected behavior is ambiguous.",
     "stop.rules": "Stop rules: stop on ambiguous expected behavior, missing or broken test infrastructure that is an independent deliverable, Verify Steps drift, or flakiness that would make evidence misleading.",
     "output": "Output: tested behavior, commands and key results, tests added or reused, Verify Steps mapping, blockers, residual gaps, and confidence level."
   }

package/assets/codex-plugin/skills/agentplane/SKILL.md

@@ -17,7 +17,7 @@ Use AgentPlane through its CLI instead of editing `.agentplane/` state directly.
 
 1. If the repository is not initialized, run `ap init` or `agentplane init`.
 2. Run `ap quickstart`.
-3. Inspect `AGENTS.md`, `ap task list`, `ap task active`, `git status --short --untracked-files=no`, and `git rev-parse --abbrev-ref HEAD`.
+3. Inspect `AGENTS.md`, `ap task list`, `ap task active`, `git status --short --untracked-files=no`, `git status --short`, and `git rev-parse --abbrev-ref HEAD`.
 4. Use `ap task brief <task-id>` before owner-scoped execution; add `--remote` only when hosted PR/check/review state is needed.
 5. Use `ap role ORCHESTRATOR` while planning and approvals are active.
 6. Switch to `ap role <ROLE>` before owner-scoped execution or verification.

package/bin/agentplane.js

@@ -415,9 +415,15 @@ async function assertDistUpToDate() {
     });
   }
 
+  const freshnessResults = await Promise.all(
+    checks.map(async (check) => ({
+      check,
+      result: await isPackageBuildFresh(check.root, { watchedPaths: check.watchedPaths }),
+    })),
+  );
+
   const staleReasons = [];
-  for (const check of checks) {
-    const result = await isPackageBuildFresh(check.root, { watchedPaths: check.watchedPaths });
+  for (const { check, result } of freshnessResults) {
     if (!result.ok) {
       const detail =
         Array.isArray(result.changedPaths) && result.changedPaths.length > 0

package/bin/dist-guard.js

@@ -32,7 +32,13 @@ async function readJsonIfExists(p) {
 
 function resolveGitHead(cwd) {
   try {
-    return execFileSync("git", ["rev-parse", "HEAD"], { cwd, encoding: "utf8" }).trim() || null;
+    return (
+      execFileSync("git", ["rev-parse", "HEAD"], {
+        cwd,
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+      }).trim() || null
+    );
   } catch {
     return null;
   }
@@ -41,7 +47,11 @@ function resolveGitHead(cwd) {
 function listGitPaths(cwd, args, options = {}) {
   const trimLines = options.trimLines ?? true;
   try {
-    const out = execFileSync("git", args, { cwd, encoding: "utf8" });
+    const out = execFileSync("git", args, {
+      cwd,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+    });
     return out
       .split(/\r?\n/u)
       .map((line) => (trimLines ? line.trim() : line))
@@ -51,6 +61,26 @@ function listGitPaths(cwd, args, options = {}) {
   }
 }
 
+function tryListGitPaths(cwd, args, options = {}) {
+  const trimLines = options.trimLines ?? true;
+  try {
+    const out = execFileSync("git", args, {
+      cwd,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"],
+    });
+    return {
+      ok: true,
+      paths: out
+        .split(/\r?\n/u)
+        .map((line) => (trimLines ? line.trim() : line))
+        .filter(Boolean),
+    };
+  } catch {
+    return { ok: false, paths: [] };
+  }
+}
+
 function uniqueSorted(values) {
   return [...new Set(values)].toSorted((a, b) => a.localeCompare(b));
 }
@@ -71,6 +101,25 @@ function workingTreeChangedPaths(cwd, watchedPaths) {
   );
 }
 
+function tryWorkingTreeChangedPaths(cwd, watchedPaths) {
+  const result = tryListGitPaths(
+    cwd,
+    ["status", "--porcelain", "--untracked-files=all", "--", ...watchedPaths],
+    { trimLines: false },
+  );
+  return {
+    ok: result.ok,
+    paths: uniqueSorted(
+      result.paths
+        .map((line) => {
+          const normalized = String(line ?? "");
+          return normalized.length > 3 ? normalized.slice(3).trim() : "";
+        })
+        .filter((filePath) => Boolean(filePath) && isRuntimeRelevantWatchedFile(filePath)),
+    ),
+  };
+}
+
 function committedChangedPathsSince(cwd, fromGitHead, watchedPaths) {
   if (!fromGitHead) return [];
   return uniqueSorted(
@@ -84,6 +133,21 @@ function committedChangedPathsSince(cwd, fromGitHead, watchedPaths) {
   );
 }
 
+function tryCommittedChangedPathsSince(cwd, fromGitHead, watchedPaths) {
+  if (!fromGitHead) return { ok: false, paths: [] };
+  const result = tryListGitPaths(cwd, [
+    "diff",
+    "--name-only",
+    `${fromGitHead}..HEAD`,
+    "--",
+    ...watchedPaths,
+  ]);
+  return {
+    ok: result.ok,
+    paths: uniqueSorted(result.paths.filter((filePath) => isRuntimeRelevantWatchedFile(filePath))),
+  };
+}
+
 async function fileMtimeMs(p) {
   try {
     const s = await stat(p);
@@ -144,6 +208,26 @@ export async function isPackageBuildFresh(packageRoot, options = {}) {
   const currentHead = resolveGitHead(packageRoot);
   const manifestSnapshot = parseManifestSnapshot(manifest);
   if (manifestSnapshot) {
+    const committedQuickCheck = tryCommittedChangedPathsSince(
+      packageRoot,
+      manifest.git_head,
+      manifestSnapshot.watchedPaths,
+    );
+    const workingTreeQuickCheck = tryWorkingTreeChangedPaths(
+      packageRoot,
+      manifestSnapshot.watchedPaths,
+    );
+    const changedPaths = uniqueSorted([
+      ...committedQuickCheck.paths,
+      ...workingTreeQuickCheck.paths,
+    ]);
+    if (committedQuickCheck.ok && workingTreeQuickCheck.ok && changedPaths.length === 0) {
+      if (manifest.git_head && currentHead && manifest.git_head !== currentHead) {
+        return { ok: true, reason: "fresh_after_git_quick_check", changedPaths: [] };
+      }
+      return { ok: true, reason: "fresh", changedPaths: [] };
+    }
+
     const currentSnapshot = await collectWatchedRuntimeSnapshot(
       packageRoot,
       manifestSnapshot.watchedPaths,

package/dist/.build-manifest.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "manifest_kind": "package",
   "package_name": "agentplane",
-  "package_version": "0.6.9",
-  "git_head": "c64a147ee51ff07019a834b314face264cabb948",
-  "watched_runtime_snapshot_hash": "615cd705f0e53934ac27d05278232358ece4cef3ec436e27ed514c314755d66b"
+  "package_version": "0.6.11",
+  "git_head": "f64842db3ede31bdac865dbc7b501351e4c922a3",
+  "watched_runtime_snapshot_hash": "e8fee1bd81eec3cef2943f5f26575301e7fa43e72baac1023fa47da35b543c0b"
 }