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 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.1",
6
- "git_head": "03acb7398ddfef745f284a32090ede8e45df99be",
7
- "watched_runtime_snapshot_hash": "d2e990c9cc895be015699b09250b8cde95ddd334c71fbdc9fc283c7375fe26e6"
5
+ "package_version": "0.6.2",
6
+ "git_head": "38d20e02646371b587820adb328039c615323f47",
7
+ "watched_runtime_snapshot_hash": "d9122cf6ac941123139d675eac929456b8e4caf0ce3e811bc69af6ea9905ec2a"
8
8
  }