principles-disciple 1.205.0 → 1.207.0

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

@@ -0,0 +1,45 @@
+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;
+export declare function recordSelfReportFromText(workspaceDir: string, text: unknown, sessionId: string | undefined, 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/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.205.0",
+  "version": "1.207.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.205.0",
+  "version": "1.207.0",
   "activation": {
     "onCapabilities": [
       "hook"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "1.205.0",
+  "version": "1.207.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",