@akagilnc/pi-workflow-roles 0.1.4403 → 0.1.4419
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/README.md +4 -3
- package/README.zh-CN.md +5 -4
- package/THIRD_PARTY_NOTICES.md +8 -6
- package/dist/acp-host/production-host.js +249 -624
- package/dist/headless-host/production-host.js +251 -626
- package/dist/migrate-book-topology.js +23 -6
- package/dist/package-resources/method-skill.js +6 -1
- package/dist/pi/role-turn-host.js +3 -1
- package/dist/public-cli/invocation.js +83 -32
- package/dist/public-cli/main.js +240 -306
- package/dist/public-cli/option-definitions.js +23 -6
- package/dist/public-cli/post-admission.js +0 -4
- package/dist/public-cli/run-lifecycle.js +25 -4
- package/dist/public-cli/settlement.js +6 -77
- package/dist/role-activation-flags.js +1 -0
- package/extensions/role-runtime.ts +3 -5
- package/package.json +1 -1
- package/resources/836-deleted-machine-instruction-inventory.md +1 -1
- package/resources/methods/ak-cross-m-review/CONTEXT.md +48 -0
- package/resources/methods/ak-cross-m-review/LICENSE +21 -0
- package/resources/methods/ak-cross-m-review/SKILL.md +170 -0
- package/resources/methods/ak-cross-m-review/prompts/cmr-completeness.md +118 -0
- package/resources/methods/ak-cross-m-review/prompts/cmr-reviewer.md +128 -0
- package/resources/methods/ak-cross-m-review/provenance.json +41 -0
- package/souls/judge.md +1 -1
- package/souls/reviewer.md +1 -1
- package/src/archivist-record-entry.ts +1 -1
- package/src/canonical-skill-binding.ts +2 -2
- package/src/host-contracts.ts +2 -0
- package/src/package-contracts/reviewer-output.ts +4 -2
- package/src/package-resources/method-skill.ts +7 -2
- package/src/pi/role-turn-host.ts +3 -1
- package/src/public-cli/invocation.ts +108 -39
- package/src/public-cli/option-definitions.ts +23 -6
- package/src/public-cli/post-admission.ts +0 -4
- package/src/public-cli/reviewer-run.ts +39 -16
- package/src/public-cli/run-lifecycle.ts +33 -3
- package/src/public-cli/settlement.ts +8 -73
- package/src/reviewer-role.ts +27 -16
- package/src/role-activation-flags.ts +1 -0
- package/src/role-runtime-dependencies.ts +2 -4
- package/src/role-runtime.ts +9 -26
- package/src/worker-role.ts +1 -1
- package/dist/adr-path-refs.js +0 -23
- package/dist/public-cli/reviewer-dispatch-rejection.js +0 -77
- package/dist/reviewer-dispatch.js +0 -14
- package/dist/reviewer-git-snapshot.js +0 -32
- package/dist/reviewer-pinned-git.js +0 -308
- package/dist/reviewer-preflight-error.js +0 -15
- package/dist/reviewer-prompt-identity.js +0 -10
- package/resources/methods/code-review/SKILL.md +0 -92
- package/resources/methods/code-review/agents/openai.yaml +0 -3
- package/resources/methods/code-review/provenance.json +0 -26
- package/src/adr-path-refs.ts +0 -25
- package/src/public-cli/reviewer-dispatch-rejection.ts +0 -106
- package/src/reviewer-dispatch.ts +0 -39
- package/src/reviewer-git-snapshot.ts +0 -45
- package/src/reviewer-pinned-git.ts +0 -330
- package/src/reviewer-preflight-error.ts +0 -14
- package/src/reviewer-prompt-identity.ts +0 -17
package/README.md
CHANGED
|
@@ -52,7 +52,7 @@ ak-role config unset-host judge
|
|
|
52
52
|
ak-role config set-auto-resume-limit 3
|
|
53
53
|
```
|
|
54
54
|
|
|
55
|
-
**Host axis (invocation-insensible after default):** `--host` is a global public option on every callable role and on `resume`. Resolution is invocation `--host` → persistent seat host (`config set-host`) → package default (`pi`). After `config set-host <seat> <name>`, the same command face used with Pi runs that seat on the named host with zero extra flags and zero caller-side changes; bare `resume` follows the same table.
|
|
55
|
+
**Host axis (invocation-insensible after default):** `--host` is a global public option on every callable role and on `resume`. Resolution is invocation `--host` → persistent seat host (`config set-host`) → package default (`pi`). After `config set-host <seat> <name>`, the same command face used with Pi runs that seat on the named host with zero extra flags and zero caller-side changes; bare `resume` follows the same table. Public callable roles and their institutional sub-legs (soul audit, doctor audit) share the in-process institutional session seam; Reviewer method Skill delivery is Pi-native `/skill:ak-cross-m-review` today — non-Pi host-native loader remains OPEN ([#922](https://github.com/Akagilnc/ak-pi-workflow-roles/issues/922)).
|
|
56
56
|
|
|
57
57
|
**Host providers (#788):** seat rows keep one provider name. Owner edits `~/.ak-roles/host-providers.json` (`{ "hermes": { "xai": "xai-oauth" } }`); code only reads it. Missing table entries ask the host directory (hermes this ticket): unique match wins, zero or many fail loud. Priority is table > unique > fail — no package discretion. `config show` prints the table as written.
|
|
58
58
|
|
|
@@ -87,8 +87,9 @@ ak-role judge --model <provider/model[:thinking]> --attach ./findings.md --attac
|
|
|
87
87
|
ak-role coder --model <provider/model[:thinking]> plan "Propose the first implementation plan."
|
|
88
88
|
ak-role coder --model <provider/model[:thinking]> apply --attach ./plan.md "Implement the approved slice."
|
|
89
89
|
|
|
90
|
-
# reviewer — fixed-target
|
|
91
|
-
ak-role reviewer --model <provider/model[:thinking]> --base main "Review the branch."
|
|
90
|
+
# reviewer — fixed-target single-lens review (completeness|correctness); completed ≠ approved, read the findings
|
|
91
|
+
ak-role reviewer --model <provider/model[:thinking]> --base main --lens completeness --authority-ref docs/adr/0001-roles-grow-by-demand.md "Review the branch."
|
|
92
|
+
ak-role reviewer --model <provider/model[:thinking]> --base main --lens correctness --authority-ref CLAUDE.md
|
|
92
93
|
|
|
93
94
|
# collector — GitHub PR review evidence (bind target, read handbook/field activity, trigger as needed, wait window, return materials)
|
|
94
95
|
ak-role collector --model <provider/model[:thinking]> --pr 42 --repo owner/repository "Collect findings for the assigned issue."
|
package/README.zh-CN.md
CHANGED
|
@@ -52,7 +52,7 @@ ak-role config unset-host judge
|
|
|
52
52
|
ak-role config set-auto-resume-limit 3
|
|
53
53
|
```
|
|
54
54
|
|
|
55
|
-
**宿主轴(配置默认 host 后调用无感):** `--host` 为全局公开旗,全部可调用角色与 `resume` 受理。解析序为调用 `--host` → 席位持久 host(`config set-host`)→ 包默认(`pi`)。`config set-host <seat> <name>` 之后,与 Pi 完全相同的命令面即可在该席跑命名宿主——零额外旗、零调用侧改动;裸 `resume`
|
|
55
|
+
**宿主轴(配置默认 host 后调用无感):** `--host` 为全局公开旗,全部可调用角色与 `resume` 受理。解析序为调用 `--host` → 席位持久 host(`config set-host`)→ 包默认(`pi`)。`config set-host <seat> <name>` 之后,与 Pi 完全相同的命令面即可在该席跑命名宿主——零额外旗、零调用侧改动;裸 `resume` 同序取表。可调用角色及其机构子腿(审刑审计、太医审计)共享进程内机构子会话接缝;御史台方法 Skill 现行仅 Pi 原生 `/skill:ak-cross-m-review` 交付——非 Pi 宿主原生装载仍 OPEN([#922](https://github.com/Akagilnc/ak-pi-workflow-roles/issues/922))。
|
|
56
56
|
|
|
57
57
|
**宿主 provider 表(#788):** 席位行只写一份 provider 名。owner 手改 `~/.ak-roles/host-providers.json`(形如 `{ "hermes": { "xai": "xai-oauth" } }`);代码只读。表里没有的问宿主目录(本票 hermes):唯一即用,零个或多个响亮失败。优先级:表 > 唯一 > 失败,代码无裁量。`config show` 原样打印该表。
|
|
58
58
|
|
|
@@ -77,8 +77,9 @@ ak-role judge --model <provider/model[:thinking]> --attach ./findings.md --attac
|
|
|
77
77
|
ak-role coder --model <provider/model[:thinking]> plan "Propose the first implementation plan."
|
|
78
78
|
ak-role coder --model <provider/model[:thinking]> apply --attach ./plan.md "Implement the approved slice."
|
|
79
79
|
|
|
80
|
-
#
|
|
81
|
-
ak-role reviewer --model <provider/model[:thinking]> --base main "Review the branch."
|
|
80
|
+
# 御史台——固定目标、调用者选定单 lens 察举;completed ≠ 准行,findings 在 Terminal 里
|
|
81
|
+
ak-role reviewer --model <provider/model[:thinking]> --base main --lens completeness --authority-ref docs/adr/0001-roles-grow-by-demand.md "Review the branch."
|
|
82
|
+
ak-role reviewer --model <provider/model[:thinking]> --base main --lens correctness --authority-ref CLAUDE.md
|
|
82
83
|
|
|
83
84
|
# 通进司——GitHub PR 收证(认票、读手册/现场活动、按需触发、等待窗、交回材料)
|
|
84
85
|
ak-role collector --model <provider/model[:thinking]> --pr 42 --repo owner/repository "为所指 issue 收证。"
|
|
@@ -133,7 +134,7 @@ ak-role --model <provider/model[:thinking]> resume <runId> "<裁定>"
|
|
|
133
134
|
| --- | --- | --- |
|
|
134
135
|
| **将作监** | coder | **营造新作。** 承接新的谋划与需求,从一片空白开始设计、建造,直到形成可供使用的新成果。讲究先明其意,再定其形,不妄增枝节,只做当下所需之事。 |
|
|
135
136
|
| **修内司** | fixer | **缮修旧物。** 面对已有问题,不急于表面修补,而是追寻问题根源,找到真正需要修整之处。既要修复眼前缺漏,也要防止同类问题再次出现。 |
|
|
136
|
-
| **御史台** | reviewer | **察举百弊,风闻奏事。**
|
|
137
|
+
| **御史台** | reviewer | **察举百弊,风闻奏事。** 置身事外审视成果;调用者选定单 lens(completeness/correctness),本席自跑包内 `ak-cross-m-review`,交薄回执与 amendment。弹章须指明所劾之处,言不为狱——不负坐实义务,坐实归大理寺。 |
|
|
137
138
|
| **大理寺** | judge | **审理定谳。** 承接各方意见与材料,依照既定规则逐项判断,辨明是非曲直。可以准行、退回或请示更高决定,但自身不参与建设与修改。 |
|
|
138
139
|
| **审刑院** | judge-auditor/doctor-auditor(无 CLI,共享内部接缝;御史台侧闸已退役) | **复核成案。** 不重新争论事情本身,而是检查整个办理过程是否合乎规矩。关注是否有人越过职责、是否遗漏必要步骤、是否以错误方式得出正确结果。直属陛下,不入门下省编制。 |
|
|
139
140
|
| **门下省** | gatekeeper(交卷闸不再自动出席;可 `ak-role gatekeeper` 独立直调) | **审署诏敕与质量保证的省。** 交卷闸按受审物直接传召台院/符宝郎,本省不介入选席;调用者仍可独立传召本省作 dispatch/pass;给事中票庭由调用者开工前传召;左拾遗由调用者合并前传召;省内政,不是外层编排器。规范见 [ADR 0067](docs/adr/0067-menxia-province-founding-jishizhong-fubaolang.md)、[ADR 0072](docs/adr/0072-menxia-pre-pr-submission-hooks.md)、[ADR 0074](docs/adr/0074-gate-province-reorg-jishizhong-chaiyuan-split.md)、[ADR 0079](docs/adr/0079-direct-officer-summons-ticket-memory-pointer-input.md)。 |
|
package/THIRD_PARTY_NOTICES.md
CHANGED
|
@@ -21,12 +21,6 @@ commit/tag identity, per-file digests and git blob OIDs, and attribution under
|
|
|
21
21
|
package adaptation `fixer-boundary-no-external-skill-chain` so the Fixer
|
|
22
22
|
method cannot automatically launch architecture Grill or other role-external
|
|
23
23
|
Skill chains (#110)
|
|
24
|
-
- `code-review` — shipped under `resources/methods/code-review/` from
|
|
25
|
-
upstream `skills/engineering/code-review` at the same commit/tag, with
|
|
26
|
-
package adaptation `reviewer-no-setup-fixed-target-two-axis` so Reviewer
|
|
27
|
-
remains usable without Matt setup files, does not modify project governance
|
|
28
|
-
as setup, preserves Standards/Spec axes, and never turns scratch probes into
|
|
29
|
-
product repairs (#111)
|
|
30
24
|
- `resolving-merge-conflicts` — shipped under `resources/methods/resolving-merge-conflicts/` from
|
|
31
25
|
upstream `skills/engineering/resolving-merge-conflicts` at the same commit/tag, with
|
|
32
26
|
package adaptation `merger-merge-only-escalate-new-intent` so Merger stays merge-only,
|
|
@@ -58,3 +52,11 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
58
52
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
59
53
|
SOFTWARE.
|
|
60
54
|
```
|
|
55
|
+
|
|
56
|
+
## First-party method (not third-party)
|
|
57
|
+
|
|
58
|
+
- `ak-cross-m-review` — shipped verbatim under `resources/methods/ak-cross-m-review/`
|
|
59
|
+
from [Akagilnc/ak-cross-m-review](https://github.com/Akagilnc/ak-cross-m-review)
|
|
60
|
+
commit `57b10e2cea9ff008e2b36b98b55610e58cdfd512` (VERSION `0.5.2.0`, MIT,
|
|
61
|
+
Copyright (c) 2026 Akagi). `packageAdaptation` = `verbatim-upstream`. This is
|
|
62
|
+
first-party material owned by the same author line, not a third-party skill.
|