agentplane 0.6.1 → 0.6.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/assets/AGENTS.md +1 -0
- package/assets/policy/framework.dev.md +20 -0
- package/assets/policy/workflow.branch_pr.md +13 -0
- package/dist/.build-manifest.json +3 -3
- package/dist/cli.js +672 -546
- package/package.json +6 -5
package/assets/AGENTS.md
CHANGED
|
@@ -172,6 +172,7 @@ Routing constraints:
|
|
|
172
172
|
- MUST stage/commit only intentional changes for the active task scope.
|
|
173
173
|
- MUST stop and request re-approval when scope, risk, or verification criteria materially drift.
|
|
174
174
|
- MUST NOT let ORCHESTRATOR perform owner-scoped implementation or verification once a task owner is known, unless the approved plan explicitly makes ORCHESTRATOR the owner.
|
|
175
|
+
- MUST treat user-authenticated GitHub actions as user-attributed publication and route post-merge fixes through a new task or explicit `post-merge-` branch or `followup` slug token.
|
|
175
176
|
|
|
176
177
|
Role boundaries: ORCHESTRATOR = preflight + plan + approvals; PLANNER = executable task graph creation/update; INTEGRATOR = base integration/finish in `branch_pr`.
|
|
177
178
|
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
<!-- ap:fragment id="policy.framework_dev.body.framework.dev" slot="body" mutability="replaceable" -->
|
|
2
|
+
|
|
3
|
+
# Framework Development Policy
|
|
4
|
+
|
|
5
|
+
Use this module only inside the AgentPlane framework checkout.
|
|
6
|
+
|
|
7
|
+
This module is intentionally excluded from normal initialized repositories and must load only when
|
|
8
|
+
the prompt-module compiler context has `repo_type=framework`.
|
|
9
|
+
|
|
10
|
+
<!-- /ap:fragment -->
|
|
11
|
+
<!-- ap:fragment id="policy.framework_dev.hard_constraint.framework.scope" slot="hard_constraint" mutability="append_only" -->
|
|
12
|
+
|
|
13
|
+
## Framework Scope
|
|
14
|
+
|
|
15
|
+
- MUST treat `packages/agentplane/bin/agentplane.js` as the canonical direct repo-local CLI entrypoint.
|
|
16
|
+
- MUST keep framework-only commands unavailable outside framework checkouts, not merely hidden from normal help.
|
|
17
|
+
- MUST run `bun run framework:dev:bootstrap` after changes to watched runtime, CLI, prompt, or built asset surfaces before relying on repo-local runtime parity.
|
|
18
|
+
- MUST NOT require installed user repositories to depend on framework helper scripts.
|
|
19
|
+
|
|
20
|
+
<!-- /ap:fragment -->
|
|
@@ -53,6 +53,11 @@ agentplane integrate <task-id> --branch task/<task-id>/<slug> --run-verify
|
|
|
53
53
|
agentplane finish <task-id> --author INTEGRATOR --body "Verified: ..." --result "..." --commit <git-rev> --close-commit
|
|
54
54
|
```
|
|
55
55
|
|
|
56
|
+
Default branch names are `task/<task-id>/<slug>` for implementation branches and
|
|
57
|
+
`task-close/<task-id>/<sha12>` for close-tail branches. Repositories MAY override only the prefixes
|
|
58
|
+
through `branch.task_prefix` and `branch.task_close_prefix`; task id, slug, and sha positions remain
|
|
59
|
+
fixed.
|
|
60
|
+
|
|
56
61
|
<!-- /ap:fragment -->
|
|
57
62
|
<!-- ap:fragment id="policy.workflow.branch_pr.hard_constraint.constraints" slot="hard_constraint" mutability="append_only" -->
|
|
58
63
|
|
|
@@ -73,6 +78,14 @@ agentplane finish <task-id> --author INTEGRATOR --body "Verified: ..." --result
|
|
|
73
78
|
after the first green rollup), then merge it through GitHub. If auto-merge remains blocked
|
|
74
79
|
after stable green checks, the agent MUST continue with the permitted GitHub merge route
|
|
75
80
|
available to its credentials instead of stopping at enabled auto-merge.
|
|
81
|
+
- Claude Code and other agents that inherit the user's GitHub session MUST treat `gh pr merge`,
|
|
82
|
+
GitHub UI merge, and auto-merge enablement as user-attributed publication. Before using those
|
|
83
|
+
actions, verify the integration queue/handoff route, stable hosted checks, and explicit approval
|
|
84
|
+
for the merge lane; record the GitHub PR number and merge commit in task artifacts after merge.
|
|
85
|
+
- If a task is already `DONE` and needs a post-merge fix, create a new task unless the follow-up
|
|
86
|
+
branch slug explicitly starts with `post-merge-` or uses `followup` as a separate slug token
|
|
87
|
+
bounded by the start, end, or hyphens; generic slugs under an already closed task id are treated
|
|
88
|
+
as conflicting closure attempts.
|
|
76
89
|
- `integrate` defaults to the `merge` strategy so task branch commits stay in base history. Use `--merge-strategy squash` only when intentionally compacting branch history.
|
|
77
90
|
- When several task PRs are ready together, use the integration queue so only one branch owns the merge lane; agents waiting behind `claimed` or `handoff` entries SHOULD use bounded polling (`--wait --poll-interval-ms 30000 --timeout-ms 600000`) instead of retrying ad hoc; stale branch heads move to rework instead of blocking later queued work.
|
|
78
91
|
- `task start-ready` MAY surface targeted incident advice for analogous scope/tags; follow it before widening scope.
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"schema_version": 1,
|
|
3
3
|
"manifest_kind": "package",
|
|
4
4
|
"package_name": "agentplane",
|
|
5
|
-
"package_version": "0.6.
|
|
6
|
-
"git_head": "
|
|
7
|
-
"watched_runtime_snapshot_hash": "
|
|
5
|
+
"package_version": "0.6.2",
|
|
6
|
+
"git_head": "38d20e02646371b587820adb328039c615323f47",
|
|
7
|
+
"watched_runtime_snapshot_hash": "d9122cf6ac941123139d675eac929456b8e4caf0ce3e811bc69af6ea9905ec2a"
|
|
8
8
|
}
|