create-principles-disciple 1.145.18 → 1.145.20

package/pd-cli/dist/services/pain-recall.js

@@ -0,0 +1,444 @@
+/**
+ * Pain Recall read model — SPEC-PD-PAIN-RECALL-CLI-001.
+ *
+ * Resolves a canonical ledger principle to its verifiably-associated
+ * historical pains through the two authoritative edges only:
+ *
+ *   1. `Principle.reuseEvidence[]` — carries a REAL `painId` (validated at
+ *      the ledger write boundary, appendReuseEvidence);
+ *   2. `Principle.derivedFromPainIds[]` — stores CANDIDATE ids despite its
+ *      legacy pain-oriented name (see PainChainReadModel's linkage note);
+ *      the pain resolves through candidate → task → `tasks.input_ref`
+ *      (fallback: the `diagnosis_<painId>` task-id spelling).
+ *
+ * Anything not reachable through those edges is excluded and REPORTED
+ * (unresolvedAssociations) — never guessed from text similarity, never
+ * resolved through candidateId/taskId/artifactId masquerading as pain ids.
+ *
+ * Strictly read-only: the ledger through readLedgerFileState, trajectory.db
+ * through openTrajectoryDbReadonly, state.db through RuntimeStateManager with
+ * readonly:true + bootstrapIfMissing:false. Missing stays missing; unreadable
+ * stays unreadable; neither is ever reported as an empty result.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { readLedgerFileState } from '@principles/core/principle-tree-ledger';
+import { openTrajectoryDbReadonly } from '@principles/core/trajectory-store';
+import { RuntimeStateManager } from '@principles/core/runtime-v2';
+export const PAIN_RECALL_SCHEMA_VERSION = 'pd.pain-recall.v1';
+export const PAIN_RECALL_DEFAULT_LIMIT = 3;
+export const PAIN_RECALL_MIN_LIMIT = 1;
+export const PAIN_RECALL_MAX_LIMIT = 10;
+function emptyResult(input) {
+    const { query, status } = input;
+    return {
+        schemaVersion: PAIN_RECALL_SCHEMA_VERSION,
+        status,
+        principle: { requestedId: query.requestedPrincipleId, canonicalId: null, identityStatus: 'not_found' },
+        query: {
+            limit: query.limit,
+            ...(query.painId !== undefined ? { painId: query.painId } : {}),
+            contextUsedForRanking: false,
+            truncated: false,
+        },
+        results: [],
+        summary: { returned: 0, availableCandidates: 0, truncated: false },
+        sources: input.sources,
+        unresolvedAssociations: [],
+        ...input.overwrites,
+    };
+}
+// ── Deterministic local ranking (no model, no network) ───────────────────────
+/** Latin/digit runs plus individual Han characters — deterministic, locale-free. */
+function tokenize(text) {
+    const tokens = text.toLowerCase().match(/[a-z0-9]+/g) ?? [];
+    const han = text.match(/\p{Script=Han}/gu) ?? [];
+    return [...tokens, ...han];
+}
+function contextOverlapScore(contextTokens, doc) {
+    if (contextTokens.size === 0)
+        return 0;
+    const docTokens = new Set(tokenize(doc));
+    let score = 0;
+    for (const token of contextTokens) {
+        if (docTokens.has(token))
+            score += 1;
+    }
+    return score;
+}
+// ── Row guards (rc-1/rc-4: every DB/ledger value is guarded before use) ──────
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function ownString(row, key) {
+    const value = row[key];
+    return typeof value === 'string' && value.length > 0 ? value : null;
+}
+function safeParseRecord(json) {
+    try {
+        const parsed = JSON.parse(json);
+        return isRecord(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+// ── Main entry ───────────────────────────────────────────────────────────────
+export async function recallPains(workspaceDir, query) {
+    // 1. Ledger — the identity authority. Missing/unreadable is a source-level
+    //    failure, never a silent empty ledger.
+    const ledgerState = readLedgerFileState(path.join(workspaceDir, '.state'));
+    const ledgerAvailability = ledgerState.availability.status === 'ok'
+        ? 'ok'
+        : ledgerState.availability.status === 'empty'
+            ? 'missing'
+            : 'unreadable';
+    if (ledgerAvailability !== 'ok') {
+        return emptyResult({
+            query,
+            status: ledgerAvailability === 'missing' ? 'source_missing' : 'source_unreadable',
+            sources: { ledger: ledgerAvailability, trajectoryDb: 'not_checked', stateDb: 'not_checked' },
+        });
+    }
+    // 2. Canonical identity: exact ledger-key match only. Display titles and
+    //    draft ids never resolve (there is no title lookup at all).
+    const principleEntry = ledgerState.ledger.tree.principles[query.requestedPrincipleId];
+    if (!isRecord(principleEntry) || ownString(principleEntry, 'id') === null) {
+        return emptyResult({
+            query,
+            status: 'principle_not_found',
+            sources: { ledger: 'ok', trajectoryDb: 'not_checked', stateDb: 'not_checked' },
+        });
+    }
+    const canonicalId = query.requestedPrincipleId;
+    const principleText = ownString(principleEntry, 'text');
+    // 3. state.db — strict readonly, no bootstrap. Missing/unreadable keeps the
+    //    reuse-evidence edges alive and only degrades lineage + diagnoses.
+    const stateDbPath = path.join(workspaceDir, '.pd', 'state.db');
+    let stateDb = 'ok';
+    let manager = null;
+    if (!fs.existsSync(stateDbPath)) {
+        stateDb = 'missing';
+    }
+    else {
+        try {
+            manager = new RuntimeStateManager({ workspaceDir, readonly: true, bootstrapIfMissing: false });
+            await manager.initialize();
+            // getDb() is lazy — force the readonly open NOW so a present-but-corrupt
+            // file is classified unreadable instead of surfacing per-query later.
+            // SQLite defers the header check to the first statement, hence the
+            // read-only liveness probe (SELECT 1 writes nothing).
+            manager.connection.getDb().prepare('SELECT 1 AS probe').get();
+        }
+        catch {
+            manager = null;
+            stateDb = 'unreadable';
+        }
+    }
+    try {
+        // 4. trajectory.db — the pain-event authority. Missing/unreadable is a
+        //    source-level failure (recall's subject is the pain history itself).
+        let trajectoryDb;
+        try {
+            trajectoryDb = openTrajectoryDbReadonly(workspaceDir);
+            // SQLite defers the file-header check to the first statement (same as
+            // state.db above): probe pain_events NOW so a corrupt file or a
+            // schema-less database falls into the source_unreadable classification
+            // instead of escaping as a raw query error. Close before rethrowing so
+            // no handle leaks into the failure path.
+            try {
+                trajectoryDb.prepare('SELECT 1 FROM pain_events LIMIT 1').get();
+            }
+            catch (probeErr) {
+                trajectoryDb.close();
+                throw probeErr;
+            }
+        }
+        catch {
+            const missing = !fs.existsSync(path.join(workspaceDir, '.state', 'trajectory.db'));
+            return emptyResult({
+                query,
+                status: missing ? 'source_missing' : 'source_unreadable',
+                sources: { ledger: 'ok', trajectoryDb: missing ? 'missing' : 'unreadable', stateDb },
+            });
+        }
+        try {
+            // 5. Association edges from the two authoritative sources.
+            const unresolved = [];
+            const edges = [];
+            const { reuseEvidence } = principleEntry;
+            if (Array.isArray(reuseEvidence)) {
+                for (const entry of reuseEvidence) {
+                    if (!isRecord(entry))
+                        continue;
+                    const painId = ownString(entry, 'painId');
+                    const candidateId = ownString(entry, 'candidateId');
+                    if (painId === null || candidateId === null)
+                        continue; // malformed row: not a verifiable edge
+                    edges.push({
+                        painId,
+                        explicit: true,
+                        ref: {
+                            kind: 'reuse_evidence',
+                            candidateId,
+                            ...(ownString(entry, 'decidedAt') !== null ? { decidedAt: ownString(entry, 'decidedAt') ?? undefined } : {}),
+                            ...(ownString(entry, 'decisionId') !== null ? { decisionId: ownString(entry, 'decisionId') ?? undefined } : {}),
+                        },
+                    });
+                }
+            }
+            const derivedIds = principleEntry.derivedFromPainIds;
+            if (Array.isArray(derivedIds)) {
+                for (const value of derivedIds) {
+                    if (typeof value !== 'string' || value.length === 0)
+                        continue;
+                    const candidateId = value; // candidate id by production contract, despite the field name
+                    if (manager === null) {
+                        unresolved.push({ candidateId, reason: 'state_db_unavailable' });
+                        continue;
+                    }
+                    let candidateTaskId = null;
+                    try {
+                        const candidate = await manager.getCandidate(candidateId);
+                        candidateTaskId = candidate !== null && typeof candidate.taskId === 'string' && candidate.taskId.length > 0
+                            ? candidate.taskId
+                            : null;
+                    }
+                    catch {
+                        unresolved.push({ candidateId, reason: 'candidate_query_failed' });
+                        continue;
+                    }
+                    if (candidateTaskId === null) {
+                        unresolved.push({ candidateId, reason: 'candidate_not_found' });
+                        continue;
+                    }
+                    let painId = null;
+                    try {
+                        const task = await manager.getTask(candidateTaskId);
+                        const inputRef = task !== null && typeof task.inputRef === 'string' && task.inputRef.length > 0
+                            ? task.inputRef
+                            : null;
+                        painId = inputRef;
+                    }
+                    catch {
+                        painId = null;
+                    }
+                    if (painId === null && candidateTaskId.startsWith('diagnosis_') && candidateTaskId.length > 'diagnosis_'.length) {
+                        painId = candidateTaskId.slice('diagnosis_'.length); // authoritative task-id spelling fallback
+                    }
+                    if (painId === null) {
+                        unresolved.push({ candidateId, reason: 'pain_unresolvable_from_candidate' });
+                        continue;
+                    }
+                    edges.push({
+                        painId,
+                        explicit: false,
+                        ref: { kind: 'candidate_lineage', candidateId, taskId: candidateTaskId },
+                    });
+                }
+            }
+            // 6. Merge by real pain id — all evidence refs survive the merge.
+            const merged = new Map();
+            for (const edge of edges) {
+                const existing = merged.get(edge.painId);
+                if (existing) {
+                    existing.refs.push(edge.ref);
+                    existing.explicit = existing.explicit || edge.explicit;
+                }
+                else {
+                    merged.set(edge.painId, { painId: edge.painId, refs: [edge.ref], explicit: edge.explicit });
+                }
+            }
+            // 7. Pain events: an edge whose pain has no persisted event is reported,
+            //    not returned, and not silently dropped.
+            const painRows = new Map();
+            const selectPain = trajectoryDb.prepare('SELECT id, source, score, severity, text, reason, canonical_pain_id, runtime_task_id, host_kind, created_at FROM pain_events WHERE canonical_pain_id = ? ORDER BY created_at DESC, id DESC LIMIT 1');
+            for (const painId of [...merged.keys()]) {
+                const row = selectPain.get(painId);
+                if (!isRecord(row)) {
+                    unresolved.push({ painId, reason: 'pain_event_not_found' });
+                    merged.delete(painId);
+                }
+                else {
+                    painRows.set(painId, row);
+                }
+            }
+            // 8. --pain-id: filters WITHIN the verified association set only.
+            if (query.painId !== undefined) {
+                if (!merged.has(query.painId)) {
+                    const exists = isRecord(selectPain.get(query.painId) ?? null);
+                    return emptyResult({
+                        query,
+                        status: 'pain_not_found',
+                        sources: { ledger: 'ok', trajectoryDb: 'ok', stateDb },
+                        overwrites: { statusDetail: exists ? 'not_associated' : 'pain_event_not_found' },
+                    });
+                }
+                for (const painId of [...merged.keys()]) {
+                    if (painId !== query.painId)
+                        merged.delete(painId);
+                }
+            }
+            // 9. Per-pain enrichment (diagnoses + persisted correction evidence).
+            const entries = [];
+            for (const [painId, edge] of merged) {
+                const row = painRows.get(painId);
+                if (!isRecord(row))
+                    continue; // step 7 guaranteed presence; guard anyway (rc-1)
+                const pain = {
+                    occurredAt: ownString(row, 'created_at'),
+                    source: ownString(row, 'source'),
+                    host: ownString(row, 'host_kind') ?? 'unknown',
+                    score: typeof row.score === 'number' ? row.score : null,
+                    severity: ownString(row, 'severity'),
+                    reason: ownString(row, 'reason'),
+                    text: ownString(row, 'text'),
+                    rawStatement: null,
+                };
+                let diagnoses = [];
+                // Every branch below assigns this before use (CodeQL useless-init).
+                let diagnosesAvailability;
+                let correction = null;
+                // Initializer is meaningful: a successful read with no persisted
+                // correction evidence keeps this 'not_recorded'.
+                let correctionAvailability = 'not_recorded';
+                if (manager === null) {
+                    diagnosesAvailability = 'unreadable';
+                    correctionAvailability = 'unreadable';
+                }
+                else {
+                    try {
+                        const records = await manager.getDiagnosesByPainId(painId);
+                        diagnoses = records.map((record) => ({
+                            diagnosisId: record.diagnosisId,
+                            taskId: record.taskId,
+                            category: record.category,
+                            rootCause: record.rootCause,
+                            supportingEvidence: record.evidence.map((e) => ({ sourceRef: e.sourceRef, note: e.note })),
+                            confidence: record.confidence,
+                            isOriginalOwnerStatement: false,
+                        }));
+                        diagnosesAvailability = diagnoses.length > 0 ? 'available' : 'not_recorded';
+                    }
+                    catch {
+                        diagnosesAvailability = 'unreadable';
+                    }
+                    try {
+                        const diagnosisTask = await manager.getTask(`diagnosis_${painId}`);
+                        const payload = diagnosisTask !== null && typeof diagnosisTask.diagnosticJson === 'string'
+                            ? safeParseRecord(diagnosisTask.diagnosticJson)
+                            : null;
+                        const persisted = payload !== null ? payload.correctionEvidence : undefined;
+                        if (isRecord(persisted) && typeof persisted.text === 'string' && persisted.text.length > 0) {
+                            correction = {
+                                text: persisted.text,
+                                ...(ownString(persisted, 'classification') !== null ? { classification: ownString(persisted, 'classification') ?? undefined } : {}),
+                                ...(ownString(persisted, 'channel') !== null ? { channel: ownString(persisted, 'channel') ?? undefined } : {}),
+                                ...(ownString(persisted, 'sessionId') !== null ? { sessionId: ownString(persisted, 'sessionId') ?? undefined } : {}),
+                                ...(ownString(persisted, 'occurredAt') !== null ? { occurredAt: ownString(persisted, 'occurredAt') ?? undefined } : {}),
+                            };
+                            correctionAvailability = 'available';
+                        }
+                    }
+                    catch {
+                        correctionAvailability = 'unreadable';
+                    }
+                }
+                const type = edge.refs.length > 1
+                    ? 'multiple_paths'
+                    : edge.explicit
+                        ? 'explicit_reuse'
+                        : 'derived_from';
+                const lineage = [];
+                for (const ref of edge.refs) {
+                    if (ref.kind === 'candidate_lineage') {
+                        lineage.push({ from: `principle:${canonicalId}`, to: ref.candidateId, relation: 'derived_from_pain_ids' });
+                        lineage.push({ from: ref.candidateId, to: painId, relation: 'task_input_ref' });
+                    }
+                    else {
+                        lineage.push({ from: `principle:${canonicalId}`, to: painId, relation: 'reuse_evidence_pain_id' });
+                    }
+                }
+                entries.push({
+                    painId,
+                    association: {
+                        type,
+                        confidence: edge.explicit ? 'explicit' : 'lineage_verified',
+                        evidenceRefs: edge.refs,
+                    },
+                    pain,
+                    diagnoses,
+                    correctionEvidence: correction,
+                    availability: { painEvent: 'available', diagnoses: diagnosesAvailability, correctionEvidence: correctionAvailability },
+                    lineage,
+                });
+            }
+            // 10. Deterministic ranking. Default: explicit evidence first, then
+            //     newest pain first, then pain id. --context only re-orders this
+            //     list by local token overlap — it never adds associations.
+            const contextTokens = new Set(typeof query.context === 'string' ? tokenize(query.context) : []);
+            const contextUsed = contextTokens.size > 0;
+            const rankOf = (entry) => (entry.association.confidence === 'explicit' ? 0 : 1);
+            const scored = entries.map((entry) => ({
+                entry,
+                score: contextUsed
+                    ? contextOverlapScore(contextTokens, [entry.pain.reason ?? '', entry.pain.text ?? '', ...entry.diagnoses.map((d) => d.rootCause)].join(' '))
+                    : 0,
+            }));
+            scored.sort((a, b) => {
+                if (b.score !== a.score)
+                    return b.score - a.score;
+                const rankDelta = rankOf(a.entry) - rankOf(b.entry);
+                if (rankDelta !== 0)
+                    return rankDelta;
+                const aTime = a.entry.pain.occurredAt ?? '';
+                const bTime = b.entry.pain.occurredAt ?? '';
+                if (aTime !== bTime)
+                    return aTime < bTime ? 1 : -1; // newest first
+                return a.entry.painId < b.entry.painId ? -1 : 1;
+            });
+            const ranked = scored.map((s) => s.entry);
+            // 11. Limit + truncation.
+            const truncated = ranked.length > query.limit;
+            const results = ranked.slice(0, query.limit);
+            // 12. Top-level status: distinguish "nothing recorded" from "cannot read".
+            let status;
+            if (results.length === 0) {
+                status = unresolved.length > 0 ? 'partial' : 'no_matches';
+            }
+            else {
+                const degraded = results.some((r) => r.availability.diagnoses === 'unreadable' || r.availability.correctionEvidence === 'unreadable');
+                status = degraded ? 'partial' : 'ok';
+            }
+            return {
+                schemaVersion: PAIN_RECALL_SCHEMA_VERSION,
+                status,
+                principle: {
+                    requestedId: query.requestedPrincipleId,
+                    canonicalId,
+                    identityStatus: 'resolved',
+                    ...(principleText !== null ? { text: principleText } : {}),
+                },
+                query: {
+                    limit: query.limit,
+                    ...(query.painId !== undefined ? { painId: query.painId } : {}),
+                    contextUsedForRanking: contextUsed,
+                    truncated,
+                },
+                results,
+                summary: { returned: results.length, availableCandidates: ranked.length, truncated },
+                sources: { ledger: 'ok', trajectoryDb: 'ok', stateDb },
+                unresolvedAssociations: unresolved,
+            };
+        }
+        finally {
+            trajectoryDb.close();
+        }
+    }
+    finally {
+        if (manager !== null) {
+            await manager.close().catch(() => undefined);
+        }
+    }
+}
+//# sourceMappingURL=pain-recall.js.map

package/pd-cli/dist/services/pain-recall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pain-recall.js","sourceRoot":"","sources":["../../src/services/pain-recall.ts"],"names":[],"mappings":"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"}

package/pd-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principles/pd-cli",
-  "version": "1.158.6",
+  "version": "1.158.7",
   "description": "PD CLI — Pain recording, sample management, and governance tasks for Principles Disciple",
   "type": "module",
   "bin": {

package/plugin/dist/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Principles Disciple is an AI Agent Governance System. Stop correcting the same AI behavior across sessions. Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles.",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "activation": {
     "onStartup": true,
     "onCapabilities": [

package/plugin/dist/templates/langs/en/skills/pd-cli-operator/SKILL.md

@@ -30,6 +30,22 @@ Confirm that the installed CLI supports a command before running it:
 
 OpenClaw's `/pd-status` primarily reports host status such as GFI/Pain dictionary; it is not a substitute for Runtime health or tracing a specific task.
 
+## Recall a principle's historical pains
+
+Use `pd pain recall` when the principle text alone is not enough: you are unsure why the principle exists, what its trigger boundary is, or whether the current situation matches the original failure. Do not call it when the principle is already clear or the task is unrelated to its history — it only adds latency.
+
+- Recall with a question: `pd pain recall --principle-id "<canonical principle id>" --context "<your current question>" --limit 3 --workspace "<workspace>" --json`
+- One specific pain: `pd pain recall --principle-id "<canonical principle id>" --pain-id "<painId>" --workspace "<workspace>" --json`
+
+Reading the result:
+
+- Pass the canonical ledger principle id (a UUID); display titles and prompt-rendered ids never resolve.
+- Check the top-level `status` first. `ok` / `no_matches` / `partial` are successful reads (exit 0). `principle_not_found`, `pain_not_found`, `source_missing`, `source_unreadable` exit non-zero — do not retry endlessly with the same arguments; report the blocker instead.
+- Each result separates three kinds of information: the pain record (`pain.reason`, `pain.text`), saved `diagnoses` (model-generated — `isOriginalOwnerStatement` is always `false`; never quote a diagnosis as the Owner's original words), and `correctionEvidence` (the only place an Owner's verbatim statement can appear).
+- `--pain-id` filters within this principle's verified associations only; a candidate/task/artifact id is never a pain id.
+- Per-result `availability` distinguishes `not_recorded` (genuinely absent) from `unreadable` (cannot be read); a `partial` top-level status means some sources were unavailable — state the gap, do not guess.
+- Recalled history is context, not authority: it must not override the direct evidence of the current task.
+
 ## Interpret results correctly
 
 - A `painId` proves only that pain registration returned a receipt.

package/plugin/dist/templates/langs/zh/skills/pd-cli-operator/SKILL.md

@@ -30,6 +30,22 @@ disable-model-invocation: false
 
 OpenClaw 的 `/pd-status` 主要展示 GFI/Pain 词典等宿主状态，不应代替 Runtime 健康检查或具体任务追踪。
 
+## 按需召回原则的历史痛苦
+
+当原则文本本身不够用——不确定它为何存在、触发边界是什么、或当前情况是否与当初的失败相似——使用 `pd pain recall`。原则已经清楚或任务与其历史无关时不要调用，那只会增加延迟。
+
+- 带疑问召回：`pd pain recall --principle-id "<规范原则 ID>" --context "<当前疑问>" --limit 3 --workspace "<workspace>" --json`
+- 查看指定痛苦：`pd pain recall --principle-id "<规范原则 ID>" --pain-id "<painId>" --workspace "<workspace>" --json`
+
+结果判读：
+
+- 必须传规范账本原则 ID（UUID）；显示标题和提示词渲染 ID 无法解析。
+- 先看顶层 `status`。`ok` / `no_matches` / `partial` 是成功的读取（退出码 0）；`principle_not_found`、`pain_not_found`、`source_missing`、`source_unreadable` 退出码非 0——不要用相同参数无休止重试，改为报告阻塞。
+- 每条结果区分三类信息：痛苦记录（`pain.reason`、`pain.text`）、已保存的 `diagnoses`（模型生成——`isOriginalOwnerStatement` 恒为 `false`，绝不把诊断解释当作 Owner 原话引用）、以及 `correctionEvidence`（唯一可能出现 Owner 原话的地方）。
+- `--pain-id` 只在该原则已验证的关联集合内筛选；candidateId/taskId/artifactId 永远不是 painId。
+- 每条结果的 `availability` 区分 `not_recorded`（确实没有记录）与 `unreadable`（无法读取）；顶层 `partial` 表示部分来源不可用——如实说明缺口，不要猜测。
+- 召回的历史是背景，不是权威：不得用它覆盖当前任务的直接证据。
+
 ## 结果判定
 
 - `painId` 只证明痛苦登记有回执。

package/plugin/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Principles Disciple is an AI Agent Governance System. Stop correcting the same AI behavior across sessions. Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles.",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "activation": {
     "onStartup": true,
     "onCapabilities": [

package/plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "Principles Disciple is an AI Agent Governance System. Stop correcting the same AI behavior across sessions. Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles.",
   "type": "module",
   "main": "./dist/index.js",

package/plugin/templates/langs/en/skills/pd-cli-operator/SKILL.md

@@ -30,6 +30,22 @@ Confirm that the installed CLI supports a command before running it:
 
 OpenClaw's `/pd-status` primarily reports host status such as GFI/Pain dictionary; it is not a substitute for Runtime health or tracing a specific task.
 
+## Recall a principle's historical pains
+
+Use `pd pain recall` when the principle text alone is not enough: you are unsure why the principle exists, what its trigger boundary is, or whether the current situation matches the original failure. Do not call it when the principle is already clear or the task is unrelated to its history — it only adds latency.
+
+- Recall with a question: `pd pain recall --principle-id "<canonical principle id>" --context "<your current question>" --limit 3 --workspace "<workspace>" --json`
+- One specific pain: `pd pain recall --principle-id "<canonical principle id>" --pain-id "<painId>" --workspace "<workspace>" --json`
+
+Reading the result:
+
+- Pass the canonical ledger principle id (a UUID); display titles and prompt-rendered ids never resolve.
+- Check the top-level `status` first. `ok` / `no_matches` / `partial` are successful reads (exit 0). `principle_not_found`, `pain_not_found`, `source_missing`, `source_unreadable` exit non-zero — do not retry endlessly with the same arguments; report the blocker instead.
+- Each result separates three kinds of information: the pain record (`pain.reason`, `pain.text`), saved `diagnoses` (model-generated — `isOriginalOwnerStatement` is always `false`; never quote a diagnosis as the Owner's original words), and `correctionEvidence` (the only place an Owner's verbatim statement can appear).
+- `--pain-id` filters within this principle's verified associations only; a candidate/task/artifact id is never a pain id.
+- Per-result `availability` distinguishes `not_recorded` (genuinely absent) from `unreadable` (cannot be read); a `partial` top-level status means some sources were unavailable — state the gap, do not guess.
+- Recalled history is context, not authority: it must not override the direct evidence of the current task.
+
 ## Interpret results correctly
 
 - A `painId` proves only that pain registration returned a receipt.

package/plugin/templates/langs/zh/skills/pd-cli-operator/SKILL.md

@@ -30,6 +30,22 @@ disable-model-invocation: false
 
 OpenClaw 的 `/pd-status` 主要展示 GFI/Pain 词典等宿主状态，不应代替 Runtime 健康检查或具体任务追踪。
 
+## 按需召回原则的历史痛苦
+
+当原则文本本身不够用——不确定它为何存在、触发边界是什么、或当前情况是否与当初的失败相似——使用 `pd pain recall`。原则已经清楚或任务与其历史无关时不要调用，那只会增加延迟。
+
+- 带疑问召回：`pd pain recall --principle-id "<规范原则 ID>" --context "<当前疑问>" --limit 3 --workspace "<workspace>" --json`
+- 查看指定痛苦：`pd pain recall --principle-id "<规范原则 ID>" --pain-id "<painId>" --workspace "<workspace>" --json`
+
+结果判读：
+
+- 必须传规范账本原则 ID（UUID）；显示标题和提示词渲染 ID 无法解析。
+- 先看顶层 `status`。`ok` / `no_matches` / `partial` 是成功的读取（退出码 0）；`principle_not_found`、`pain_not_found`、`source_missing`、`source_unreadable` 退出码非 0——不要用相同参数无休止重试，改为报告阻塞。
+- 每条结果区分三类信息：痛苦记录（`pain.reason`、`pain.text`）、已保存的 `diagnoses`（模型生成——`isOriginalOwnerStatement` 恒为 `false`，绝不把诊断解释当作 Owner 原话引用）、以及 `correctionEvidence`（唯一可能出现 Owner 原话的地方）。
+- `--pain-id` 只在该原则已验证的关联集合内筛选；candidateId/taskId/artifactId 永远不是 painId。
+- 每条结果的 `availability` 区分 `not_recorded`（确实没有记录）与 `unreadable`（无法读取）；顶层 `partial` 表示部分来源不可用——如实说明缺口，不要猜测。
+- 召回的历史是背景，不是权威：不得用它覆盖当前任务的直接证据。
+
 ## 结果判定
 
 - `painId` 只证明痛苦登记有回执。

package/release-manager/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,OAAO,EAAE,OAAO,EAA8B,MAAM,gBAAgB,CAAC;AAYrE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAoBvC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAcxG;AAgdD,eAAO,MAAM,OAAO,SAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,OAAO,EAAE,OAAO,EAA8B,MAAM,gBAAgB,CAAC;AAYrE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAoBvC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAcxG;AAodD,eAAO,MAAM,OAAO,SAAgB,CAAC"}

package/release-manager/dist/index.js

@@ -372,7 +372,11 @@ async function runInstall(options) {
                 console.log(`  LLM runtime profile ............ ${installOptions.runtimeProfile.provider} / ${installOptions.runtimeProfile.model ?? '(default)'} (key: $${installOptions.runtimeProfile.apiKeyEnv})${profileLocation}`);
             }
             else {
-                console.log(`  LLM runtime profile ............ not configured (configure via console: pd console open --workspace "${operatorWorkspaceDir}")`);
+                console.log(`  LLM runtime profile ............ NOT CONFIGURED — internal agents stay in needs_setup`);
+                console.log(`             evidence is still captured, but nothing is diagnosed and no principle is proposed`);
+                console.log(`             fix: set provider / model / apiKeyEnv on 'pd.default' in .pd/config.yaml, or`);
+                console.log(`                  re-run with --provider <name> --api-key-env <ENV_VAR_NAME>, or`);
+                console.log(`                  use the console: pd console open --workspace "${operatorWorkspaceDir}"`);
             }
             console.log();
             console.log(t('ready'));