agentplane 0.4.3 → 0.5.0

package/assets/policy/workflow.branch_pr.md

@@ -15,9 +15,10 @@ Use this module when `workflow_mode=branch_pr`.
 4. Keep single-writer discipline per task worktree.
 5. Publish/update PR artifacts from the task worktree.
 6. Verify on the task branch.
-7. CHECKPOINT B: integrate on base branch by INTEGRATOR.
-8. CHECKPOINT C: finish task(s) on base with verification evidence.
-9. Remove merged task branches/worktrees once the hosted-close/finish route has landed.
+7. Queue verified task branches for serialized integration when more than one agent is ready to merge.
+8. CHECKPOINT B: integrate on base branch by INTEGRATOR.
+9. CHECKPOINT C: finish task(s) on base with verification evidence.
+10. Remove merged task branches/worktrees once the hosted-close/finish route has landed.
 
 ## Related task batch worktrees
 
@@ -46,6 +47,8 @@ agentplane task start-ready <task-id> --author <ROLE> --body "Start: ..."
 agentplane pr open <task-id> --branch task/<task-id>/<slug> --author <ROLE>
 agentplane pr update <task-id>
 agentplane verify <task-id> --ok|--rework --by <ROLE> --note "..."
+agentplane integrate queue enqueue <task-id> --branch task/<task-id>/<slug>
+agentplane integrate queue run-next --run-verify
 agentplane integrate <task-id> --branch task/<task-id>/<slug> --run-verify
 agentplane finish <task-id> --author INTEGRATOR --body "Verified: ..." --result "..." --commit <git-rev> --close-commit
 ```
@@ -63,6 +66,7 @@ agentplane finish <task-id> --author INTEGRATOR --body "Verified: ..." --result
   listed, verified independently, and merged through the primary task PR.
 - `pr open` without `--sync-only` SHOULD complete in one pass: sync local artifacts, auto-publish the task branch to `origin` when it has no upstream yet, then create/link the remote GitHub PR.
 - `integrate` defaults to the `merge` strategy so task branch commits stay in base history. Use `--merge-strategy squash` only when intentionally compacting branch history.
+- When several task PRs are ready together, use the integration queue so only one branch owns the merge lane; stale branch heads move to rework instead of blocking later queued work.
 - `task start-ready` MAY surface targeted incident advice for analogous scope/tags; follow it before widening scope.
 - Keep structured resolved external findings in the task README; mark reusable ones with `Fixability: external` (or `IncidentExternal: true`) and let base-branch `finish` or `agentplane incidents collect <task-id>` promote them into `.agentplane/policy/incidents.md`, using optional `Incident*` fields only when the inferred scope/advice needs refinement. Plain `Findings` text remains task-local and does not update the shared incident registry.
 - MUST stop and request re-approval on material drift.

package/assets/policy/workflow.release.md

@@ -10,11 +10,12 @@ 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: choose the workflow-specific publication route after all gates pass.
-6. Record release evidence (commands, outputs, resulting version/tag).
+2. CHECKPOINT B: review/fix active `.agentplane/policy/incidents.md` entries through a dedicated task, archive final evidence, and clean the active incident registry.
+3. CHECKPOINT C: generate release plan and freeze version/tag target.
+4. Generate release notes with complete human-readable coverage of all task-level changes.
+5. Run release prepublish checks.
+6. CHECKPOINT D: choose the workflow-specific publication route after all gates pass.
+7. Record release evidence (commands, outputs, resulting version/tag).
 
 <!-- /ap:fragment -->
 <!-- ap:fragment id="policy.workflow.release.commands.command.contract" slot="commands" mutability="replaceable" -->
@@ -38,6 +39,7 @@ agentplane finish <task-id> --author <ROLE> --body "Verified: release" --result
 ## Constraints
 
 - MUST NOT perform irreversible release actions before explicit approval.
+- MUST NOT start release planning, prepublish, or publish while `.agentplane/policy/incidents.md` contains active incident entries.
 - 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/bin/agentplane.js

@@ -297,7 +297,7 @@ function missingRepoRuntimeDependencies(agentplaneRoot) {
   const requiredSpecifiers = ["@agentplaneorg/core"];
   return requiredSpecifiers.filter((specifier) => {
     try {
-      const resolved = requireFromAgentplane.resolve(specifier);
+      const resolved = requireFromAgentplane.resolve(`${specifier}/package.json`);
       if (isPathInside(frameworkRoot, resolved)) return false;
       return !existsSync(path.join(agentplaneRoot, "node_modules", ...specifier.split("/")));
     } catch {
@@ -332,6 +332,11 @@ async function assertDistUpToDate() {
   if (missingDeps.length > 0) {
     process.stderr.write(
       "error: repo-local runtime dependencies are missing for this framework checkout.\n" +
+        "Code: FRAMEWORK_RUNTIME_DEPENDENCY_MISSING\n" +
+        "Why: the repo-local CLI cannot resolve its workspace runtime packages from this checkout.\n" +
+        "Fix: restore the framework install layout, then rebuild the repo-local packages.\n" +
+        `Safe command: ${FRAMEWORK_DEV_BOOTSTRAP_COMMAND}\n` +
+        "Stop condition: stop if the missing package resolves outside this repository or bun install would need unapproved network access.\n" +
         "This worktree is not bootstrapped yet.\n" +
         "Missing module resolution:\n" +
         missingDeps.map((specifier) => `  ${specifier}\n`).join("") +

package/bin/ap.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+process.env.AGENTPLANE_CLI_ALIAS = "ap";
+process.env.AGENTPLANE_AGENT_MODE = "1";
+process.env.AGENTPLANE_PROMPTS ??= "plain";
+process.env.AGENTPLANE_NO_UPDATE_CHECK ??= "1";
+
+await import("./agentplane.js");

package/bin/runtime-watch.js

@@ -5,6 +5,7 @@ import path from "node:path";
 const WATCHED_RUNTIME_PATHS = {
   agentplane: [
     "src",
+    "bin/ap.js",
     "bin/agentplane.js",
     "bin/dist-guard.js",
     "bin/runtime-context.js",

package/dist/.build-manifest.json

@@ -2,7 +2,7 @@
   "schema_version": 1,
   "manifest_kind": "package",
   "package_name": "agentplane",
-  "package_version": "0.4.3",
-  "git_head": "04ccc002125560cd2ec87094e20cd5a9907d2016",
-  "watched_runtime_snapshot_hash": "5a534e101008bc57436f81a2364408cd0c5368241c43b43a4a814875fa750f68"
+  "package_version": "0.5.0",
+  "git_head": "59109bfdc8a9746402a76fb9c7a428f75d6977f3",
+  "watched_runtime_snapshot_hash": "84365a7e93d3cd3d5b9c54bf9f3787fa7e11b2eaf257ba0c9ab3aa531fac5764"
 }