@principles/workbuddy-adapter 0.2.6 → 0.2.9

package/dist/explicit-owner-statement.js

@@ -3,10 +3,17 @@ import { admitGovernanceSignals, ensureGovernanceDiagnosticianTask, parseOwnerSt
 export async function recordWorkbuddyOwnerStatement(event, workspaceDir) {
     if (event.kind !== 'before_prompt_build')
         return undefined;
+    const rejected = (reason, nextAction) => `[PD] host=workbuddy status=rejected reason=owner_statement_${reason} nextAction=${nextAction}`;
     const parsed = parseOwnerStatementPrefix(event.context.promptContent);
-    if (!parsed.matched)
+    if (!parsed.matched) {
+        // Near-miss prefixes (e.g. half-width colon, leading whitespace) must not
+        // vanish silently: the Owner clearly intended the explicit channel, so
+        // return an actionable format notice instead of no feedback at all.
+        if (typeof event.context.promptContent === 'string' && event.context.promptContent.trimStart().startsWith('PD记录痛苦')) {
+            return rejected('prefix_format', 'Use the exact prefix PD记录痛苦： (full-width colon) at the very start, followed by the Owner statement of 1–500 characters; nothing was recorded.');
+        }
         return undefined;
-    const rejected = (reason, nextAction) => `[PD] host=workbuddy status=rejected reason=owner_statement_${reason} nextAction=${nextAction}`;
+    }
     if (parsed.text === null)
         return rejected(parsed.reason ?? 'statement_empty', 'Resubmit PD记录痛苦：<Owner statement of 1–500 characters>; nothing was recorded.');
     const raw = event.rawPayload;

package/dist/pd-hook.js

@@ -37,7 +37,7 @@ import path from 'node:path';
 import process from 'node:process';
 import { pathToFileURL, fileURLToPath } from 'node:url';
 import { appendEventLogLine, redactTelemetryString, isRuleHostEvaluatedEventData } from '@principles/core/runtime-v2';
-import { createProductionHostRuntime, loadPdConfigForPlugin, parseOwnerStatementPrefix, assessWorkbuddyLiveKeyword, admitTrustedWorkbuddyLiveCorrection, ensureGovernanceDiagnosticianTask } from '@principles/host-runtime';
+import { createProductionHostRuntime, loadPdConfigForPlugin, parseOwnerStatementPrefix, assessWorkbuddyLiveKeyword, resolveSharedCorrectionKeywordStoreForDetection, admitTrustedWorkbuddyLiveCorrection, ensureGovernanceDiagnosticianTask } from '@principles/host-runtime';
 import { computeFeatureFlagsFromConfig } from '@principles/core/runtime-v2';
 import { WorkBuddyHooksHostAdapter } from './host-adapter.js';
 import { WORKBUDDY_TOOL_SEMANTICS } from './tool-semantics.js';
@@ -270,7 +270,10 @@ export async function processWorkbuddyHookInvocation(rawStdin, channelEventName,
             const explicitReserved = typeof prompt === 'string' && prompt.trimStart().startsWith('PD记录痛苦');
             if (fromOwner && nativeId !== undefined && nativeId.trim().length > 0 &&
                 typeof prompt === 'string' && !explicitReserved) {
-                const matched = assessWorkbuddyLiveKeyword(prompt, event.context.sessionId);
+                // AUDIT-P3-01: 预检与 admitTrustedWorkbuddyLiveCorrection 内部使用同一份
+                // 共享 live 词库（seed ∪ learned）——预检不会漏掉学习词，也不会比准入
+                // 更宽。startsWith 预过滤与 matched 判据不变（无 LLM、无 transcript）。
+                const matched = assessWorkbuddyLiveKeyword(prompt, event.context.sessionId, resolveSharedCorrectionKeywordStoreForDetection(resolution.workspaceDir));
                 if (matched.matched) {
                     const admitted = admitTrustedWorkbuddyLiveCorrection({
                         workspaceDir: resolution.workspaceDir,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principles/workbuddy-adapter",
-  "version": "0.2.6",
+  "version": "0.2.9",
   "description": "WorkBuddy host adapter for Principles Disciple — implements the HostAdapter interface for WorkBuddy's Git Bash command-hook model (ADR-0020 third host, SPEC workbuddy-host-adapter v0.3.0).",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,8 +42,8 @@
     "lint": "eslint \"src/**/*.ts\""
   },
   "dependencies": {
-    "@principles/core": "^1.295.0",
-    "@principles/host-runtime": "^0.12.0",
+    "@principles/core": "^1.295.2",
+    "@principles/host-runtime": "^0.12.1",
     "@principles/install-layout": "^0.4.0"
   },
   "devDependencies": {

package/plugin/.codebuddy-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Principles Disciple — Owner-governed behavior internalization for AI agents (WorkBuddy host adapter, ADR-0020 third host). Requires explicit setup and host.workbuddy feature enablement; inactive until then.",
   "defaultEnabled": false
 }

package/plugin/skills/pd-cli-operator/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: pd-cli-operator
+description: 检查 WorkBuddy 中 PD 的运行状态、治理开关、worker 活性，或只读查询痛苦、任务和证据链。使用 WorkBuddy 固定治理工作区，不负责登记痛苦、Owner 审阅或启停操作。
+---
+
+# PD CLI Operator（WorkBuddy）
+
+## 工作区
+
+始终使用 WorkBuddy 固定治理工作区 `~/.workbuddy/pd-workspace`，先将 `~` 解析为当前用户主目录的绝对路径。不得切换到当前项目目录、Codex 工作区或 OpenClaw 工作区。
+
+## 检查步骤
+
+1. 先运行以下只读命令，确认 Runtime 功能和 worker 状态：
+
+       pd runtime features --workspace "<用户主目录>/.workbuddy/pd-workspace" --json
+       pd workbuddy worker --status --workspace "<用户主目录>/.workbuddy/pd-workspace" --json
+
+2. 按需使用 CLI 帮助确认其他只读命令的可用性，再查询痛苦、任务、运行记录、候选或证据链，例如 `pd pain list --workspace "<workspace>" --json`、`pd task show "<taskId>" --workspace "<workspace>" --json`、`pd run show "<runId>" --workspace "<workspace>"`、`pd runtime trace show --pain-id "<painId>" --workspace "<workspace>" --json`。其中 `<workspace>` 必须替换为上面的 WorkBuddy 固定治理工作区，不能换成当前项目目录。
+3. 报告真实输出中的 `host.workbuddy` 开关、worker 模式和错误原因。worker 已注册不等于 worker 正在运行；插件存在不等于技能已加载；健康检查通过不等于某条痛苦已经完成诊断。
+4. 追踪具体问题时使用登记回执中的真实 ID，逐段核实登记、诊断、候选准入和治理状态。
+
+## 失败处理
+
+命令缺失、安装不完整或状态不可读取时，保留真实错误和下一步建议。需要停用时使用 `pd-control`；需要审阅候选时使用 `pd-review`；需要登记 Owner 反馈时使用 `pd-pain-signal`。
+
+## 禁止
+
+- 不初始化项目目录或切换到其他宿主的治理库。
+- 不手工修改配置、数据库或内部工件。
+- 不将 worker 注册/插件存在描述为真实运行或行为生效。
+- 不通过 CLI 或脚本批准、拒绝或激活原则。

package/plugin/skills/pd-control/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: pd-control
+description: 当 Owner 明确要求管理 WorkBuddy 的 PD 接入、停用或修复时使用。当前随插件交付的控制脚本只提供停用操作；不得猜测启用命令或手工修改配置。
+---
+
+# PD Control（WorkBuddy）
+
+## 前提
+
+只在 Owner 明确要求停用 WorkBuddy PD 时执行操作。WorkBuddy 的固定治理工作区是 `~/.workbuddy/pd-workspace`；安装/注册插件不等于启用治理，插件默认状态为关闭。
+
+## 停用
+
+根据当前技能文件所在位置定位同一插件根目录，运行随插件交付的控制脚本：
+
+    node "<plugin-root>/scripts/pd-control.cjs" disable
+
+不要搜索任意 npm 缓存，也不要使用其他宿主的脚本。
+
+只有退出码为 0 且 JSON 回执确认 `ok=true`、`enabled=false`、`host=workbuddy` 时，才能报告停用成功。报告真实回执中的工作区与状态。新 Hook 调用读取该开关；已运行中的任务是否停止必须另行核验。
+
+## 安装、启用与修复
+
+当前插件内的 `pd-control.cjs` 只实现停用。安装/注册、启用或修复必须使用正式 WorkBuddy 插件安装器/宿主管理流程。若该流程没有提供可验证的启用操作，明确报告不支持；不得猜测命令、手工修改配置或调用私有安装器函数。
+
+## 禁止
+
+- 不直接编辑配置、数据库、Runtime 或业务状态文件。
+- 不删除数据来实现停用。
+- 不将安装、注册或配置存在描述为 PD 已实际启用。
+- 不批准、拒绝或激活原则。

package/plugin/skills/pd-pain-signal/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: pd-pain-signal
+description: 当 Owner 要求记录 WorkBuddy 智能体的行为错误、痛苦反馈或行为改进证据时使用。只使用 Owner 当前明确提交的原文和 WorkBuddy 原生 Hook 回执。
+---
+
+# PD Pain Signal（WorkBuddy）
+
+## 唯一的正常入口
+
+Owner 在当前 WorkBuddy 会话中提交：
+
+    PD记录痛苦：<Owner 原文>
+
+- 前缀必须位于 Owner 消息开头，使用全角冒号；正文为 1–500 个字符。
+- 超长输入必须拒绝并请 Owner 精简，不能静默截断。
+- 只记录 Owner 明确提供的原文，不补写根因、评分或模型自述。
+- 代理生成的文本、引用和工具输出不构成新的 Owner 提交。不要代发或模拟宿主事件。
+- 如果当前消息没有此前缀，只提供格式示例，请 Owner 在当前会话中提交；不要绕过 Hook 直接调用 CLI。
+
+## 回执
+
+若当前消息已触发 UserPromptSubmit Hook，读取本次 Hook 的真实回执。只有回执包含真实 `painId`、`taskId`、`host=workbuddy` 和状态时，才能报告登记成功；否则明确说明尚未确认，并保留实际拒绝原因。
+
+WorkBuddy 的治理工作区固定为 `~/.workbuddy/pd-workspace`。不得猜测或扫描 session/turn 标识，不得使用 OpenClaw 的 `/pd-pain`，也不得用通用 CLI 手工重建 WorkBuddy 的宿主 lineage 来代替原生入口。
+
+## 下游结果
+
+Owner 陈述是未经独立验证的 `owner_statement`。登记成功只证明痛苦和任务已登记；诊断、候选准入、原则审批和生效必须分别查证。需要检查状态时使用 `pd-cli-operator`；需要 Owner 审阅时使用 `pd-review`。
+
+## 禁止
+
+- 不改写 Owner 原话，不伪造宿主身份或行为轨迹。
+- 不重复提交已确认登记的同一事件。
+- 不直接写痛苦数据库、候选账本或准入状态。
+- 不自动批准或激活原则。

package/plugin/skills/pd-review/SKILL.md

@@ -1,16 +1,30 @@
 ---
 name: pd-review
-description: 打开 WorkBuddy 的 PD Owner 审阅控制台，查看痛苦、诊断、原则候选或进行 Owner 审批。
+description: 打开 WorkBuddy 的 PD Owner Console，审阅痛苦、诊断、候选或原则治理状态。所有批准、拒绝和激活决定必须由 Owner 在正式 Web Console 中完成。
 ---
 
-# WorkBuddy Owner 审阅
+# PD Review（WorkBuddy）
 
-将用户主目录解析为绝对路径，然后运行正式 CLI：
+## 固定治理工作区
 
-```text
-pd console open --workspace "<用户主目录>/.workbuddy/pd-workspace"
-```
+WorkBuddy 的治理工作区固定为 `~/.workbuddy/pd-workspace`，与 WorkBuddy Hook 和 worker 使用的数据库一致。将 `~` 解析为当前用户主目录的绝对路径；不得用当前项目目录或其他宿主的工作区替代。
 
-只报告命令实际返回的控制台地址和状态。失败时保留错误原因，不声称已打开。此工作区与 WorkBuddy Hook、worker 使用的治理库相同；当前项目目录不能替代它。
+## 打开 Console
 
-Owner 在控制台审阅证据并决定批准、拒绝或关闭。展示 Owner 原话、模型诊断和已核实证据之间的区别。打开控制台不构成审批或激活，代理不得自动代替 Owner 决策。
+运行正式 CLI：
+
+    pd console open --workspace "<用户主目录>/.workbuddy/pd-workspace"
+
+只报告命令真实返回的 Console 地址和状态。失败时保留错误原因，不声称已打开；需要排查安装/运行状态时使用 `pd-cli-operator`，需要修复宿主接入时使用 `pd-control`。
+
+## Owner 治理
+
+帮助 Owner 区分原始反馈、宿主证据、模型诊断和准入决定。Owner 在 Console 中审阅证据并亲自批准、拒绝或完成其他治理动作。
+
+打开 Console 不构成审批；候选存在不代表已批准；批准不自动证明原则已激活或后续行为已改变。
+
+## 强制禁止
+
+- 不通过 CLI、脚本、数据库或文件批准、拒绝或激活原则。
+- Console 不可用时，不得切换到 CLI 审批。
+- 不伪造 Owner 已经作出的决定。

package/plugin/skills/pd-disable/SKILL.md

@@ -1,18 +0,0 @@
----
-name: pd-disable
-description: 当 Owner 要求停止或关闭 WorkBuddy 的 Principles Disciple 行为时，关闭此宿主治理开关并保留数据。
----
-
-# 关闭 WorkBuddy PD
-
-Owner 的关闭请求已经授权这次操作。根据本技能文件的路径定位同一插件根目录（`skills/pd-disable/SKILL.md` 的上三级目录），运行随插件交付的控制脚本：
-
-```text
-node "<插件根目录>/scripts/pd-control.cjs" disable
-```
-
-脚本调用正式安装器的 `setWorkbuddyGovernanceFlag` API，在用户固定工作区 `~/.workbuddy/pd-workspace` 关闭 `host.workbuddy` 并读回验证。它保留治理数据和其他宿主配置，不手工修改数据库或已安装运行时代码。
-
-只有退出码为 0 且 JSON 回执 `ok=true`、`enabled=false`、`host=workbuddy` 时才确认开关已关闭。报告回执中的工作区和状态；新 Hook 调用将读取该配置。已运行中的任务是否停止须另查证。
-
-如果正式安装器 API 或工作区缺失，脚本明确失败；按回执使用官方安装/修复流程恢复能力。不要搜索 npm 缓存、拼装第二套写开关逻辑或用删除文件替代关闭。

package/plugin/skills/pd-record-pain/SKILL.md

@@ -1,21 +0,0 @@
----
-name: pd-record-pain
-description: 记录 WorkBuddy 行为失误或痛苦反馈。当 Owner 要求登记痛苦、记录错误或留下行为改进证据时使用。
----
-
-# WorkBuddy 痛苦登记
-
-入口是 Owner 在当前 WorkBuddy 会话提交的一条消息：
-
-```text
-PD记录痛苦：<Owner 原文>
-```
-
-1. 仅使用当前 Owner 明确提供的陈述，正文须为 1–500 个字符。保留原文，不补写技术根因、评分或模型自述；超长时请 Owner 提供较短原文，不静默截断。
-2. 若当前消息已以 `PD记录痛苦：` 开头，检查本次 UserPromptSubmit Hook 的真实回执。Hook 使用宿主的会话标识登记到 `~/.workbuddy/pd-workspace`。
-3. 若 Owner 仅要求登记而消息没有该前缀，给出带前缀和 Owner 原文的完整消息，请 Owner 在当前会话提交。代理输出、引用和工具输出不构成新的 Owner 提交。不要代发或模拟宿主事件。
-4. 只有回执包含真实 `painId`、`taskId`、`host=workbuddy` 和状态时才报告登记成功；原样呈现这些字段。缺失回执或返回拒绝时，说明尚未确认登记并报告真实原因，使用 `pd-status` 检查运行状态。
-
-Owner 陈述是未经独立验证的 `owner_statement`。登记成功只证明痛苦和任务已登记；诊断、准入、原则审批和生效须分别查证。Owner 审批沿用 `pd-review`，不得自动批准或激活。
-
-此入口不要求模型猜测 session/turn 标识或扫描最新会话。不要改用 OpenClaw `/pd-pain` 或 CLI `pd pain record --host workbuddy`，也不要通过省略宿主参数绕过限制。

package/plugin/skills/pd-status/SKILL.md

@@ -1,17 +0,0 @@
----
-name: pd-status
-description: 检查 WorkBuddy 的 Principles Disciple 运行状态、治理开关或诊断 worker 状态。
----
-
-# WorkBuddy PD 状态
-
-使用当前用户固定治理工作区 `~/.workbuddy/pd-workspace`，将 `~` 解析为操作系统用户主目录的绝对路径，再运行：
-
-```text
-pd runtime features --workspace "<用户主目录>/.workbuddy/pd-workspace" --json
-pd workbuddy worker --status --workspace "<用户主目录>/.workbuddy/pd-workspace" --json
-```
-
-报告实际命令结果、`host.workbuddy` 有效开关和 worker 模式；命令失败或安装缺失时如实报告错误，建议通过正式安装器修复。不要初始化项目目录或切换到其他宿主的治理库。
-
-worker 状态不证明当前痛苦已完成诊断，插件存在也不证明技能已加载或原则已生效。核对具体任务应使用真实登记回执中的 ID，在 `pd-review` 指向的同一工作区审阅。