principles-disciple 1.204.1 → 1.206.0

package/dist/core/principle-application-ledger.d.ts

@@ -0,0 +1,41 @@
+export type PrincipleApplicationLevel = 'effect' | 'presence';
+export type PrincipleApplicationKind = 'rule_blocked' | 'auto_correct_applied' | 'self_reported' | 'prompt_injected';
+export interface PrincipleApplicationInput {
+    principleId: string;
+    activationId?: string;
+    ruleId?: string;
+    channel: 'code_tool_hook' | 'prompt';
+    level: PrincipleApplicationLevel;
+    kind: PrincipleApplicationKind;
+    sessionId?: string;
+    toolName?: string;
+    filePath?: string;
+    digest?: string;
+}
+/**
+ * Record one application event. Returns true when a row was written (or
+ * deduped), false on failure — callers must surface the reason (rc-9).
+ */
+export declare function recordPrincipleApplication(workspaceDir: string, input: PrincipleApplicationInput): boolean;
+/**
+ * Align activation ids with the actually-injected principle subset (PRI-531
+ * review fix). Budget truncation can drop principles from the tail of the
+ * full list — pairing by raw index would attach the wrong activation_id to a
+ * presence row (rc-6-adjacent data pairing).
+ */
+export declare function alignActivationIds(principles: ReadonlyArray<{
+    principleId: string;
+    activationId?: string;
+}>, injectedIds: ReadonlySet<string>): string[];
+/**
+ * Presence rows for a prompt injection event — one per principle, deduped per
+ * session×principle by the partial unique index (restarts included).
+ * Returns the number of NEW rows written (0 when all were already present).
+ * Failures are warned via the optional logger (rc-9) — never thrown.
+ */
+export declare function recordInjectionPresence(workspaceDir: string, principleIds: readonly string[], sessionId: string | undefined, activationIds?: readonly string[], logger?: {
+    warn?: (message: string) => void;
+    info?: (message: string) => void;
+}): number;
+/** Test hook: close cached connections and reset the retention sweep clock. */
+export declare function clearPrincipleApplicationLedgerCache(): void;

package/dist/core/principle-receipt-metadata.d.ts

@@ -0,0 +1,15 @@
+export interface PrincipleReceiptMetadata {
+    /** Resolved display title (fallback chain result; never empty). */
+    title: string;
+    /** Owner approval date (ISO string) — approvals.decided_at, fallback activations.activated_at. */
+    approvedAt?: string;
+    /** Source correction summary — only present when the artifact carries painReasonSummary. */
+    sourceSummary?: string;
+}
+/**
+ * Resolve receipt metadata for a blocked rule. Returns undefined when nothing
+ * useful can be resolved (caller degrades to the generic copy).
+ */
+export declare function loadPrincipleReceiptMetadata(workspaceDir: string, ruleId: string | undefined, principleId: string | undefined): PrincipleReceiptMetadata | undefined;
+/** Test hook: clear caches between tests. */
+export declare function clearPrincipleReceiptMetadataCache(): void;

package/dist/hooks/gate-block-helper.d.ts

@@ -21,6 +21,10 @@ export interface BlockContext {
     sessionId?: string;
     /** Source module that triggered the block (for audit trail) */
     blockSource?: string;
+    /** RuleHost rule id — enables PRI-530 receipt copy attribution */
+    ruleId?: string;
+    /** Principle id from the rule result — enables PRI-530 receipt copy attribution */
+    principleId?: string;
 }
 /**
  * Single authoritative block helper.

package/dist/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles. Stop correcting the same AI behavior across sessions.",
-  "version": "1.204.1",
+  "version": "1.206.0",
   "activation": {
     "onCapabilities": [
       "hook"

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles. Stop correcting the same AI behavior across sessions.",
-  "version": "1.204.1",
+  "version": "1.206.0",
   "activation": {
     "onCapabilities": [
       "hook"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "1.204.1",
+  "version": "1.206.0",
   "description": "Turn repeated Agent corrections into Owner-approved, observable, reversible behavior principles. Stop correcting the same AI behavior across sessions.",
   "type": "module",
   "main": "./dist/index.js",