create-principles-disciple 1.105.0 → 1.107.0

package/plugin/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/plugin/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/plugin/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/plugin/dist/openclaw-sdk.d.ts

@@ -195,14 +195,28 @@ export interface PluginHookBeforePromptBuildResult {
 }
 export interface PluginHookBeforeToolCallEvent {
     toolName: string;
+    /** Host-provided tool call arguments (OpenClaw 2026.7.x sends `params`). */
     params?: Record<string, unknown>;
+    /** @deprecated Host sends `params`; kept for older adapter shims. */
     toolArgs?: Record<string, unknown>;
     agentId?: string;
     sessionId?: string;
     [key: string]: unknown;
 }
 export interface PluginHookBeforeToolCallResult {
+    /**
+     * Host merge contract (OpenClaw 2026.7.x, hook-before-tool-call-result.ts):
+     * only `params`, `block`, `blockReason`, `requireApproval` are read from the
+     * hook result. New code must use these fields.
+     */
+    params?: Record<string, unknown>;
+    block?: boolean;
+    blockReason?: string;
+    /** Shape is host-defined (approval request details). */
+    requireApproval?: unknown;
+    /** @deprecated Use `params`. Host does not read `toolArgs`. */
     toolArgs?: Record<string, unknown>;
+    /** @deprecated Blocking is expressed via `block: true`. Host does not read `skipToolCall`. */
     skipToolCall?: boolean;
     [key: string]: unknown;
 }
@@ -250,15 +264,21 @@ export interface PluginHookSubagentEndedEvent {
     [key: string]: unknown;
 }
 export interface PluginHookLlmOutputEvent {
-    output: string;
+    /**
+     * @deprecated Host (OpenClaw 2026.7.x) does not send `output`. It fires once
+     * per model-loop attempt with `assistantTexts` + `lastAssistant`; read those.
+     */
+    output?: string;
     agentId?: string;
     sessionId?: string;
     runId?: string;
     provider?: string;
     model?: string;
     usage?: TokenUsage;
+    /** Host-provided full assistant texts for this model-loop attempt. */
     assistantTexts?: string[];
     trigger?: string;
+    /** Last complete assistant message object (host-defined shape). */
     lastAssistant?: unknown;
     [key: string]: unknown;
 }
@@ -314,6 +334,8 @@ export interface PluginHookBeforeMessageWriteResult {
         role?: string;
         content?: unknown;
     };
+    /** Host contract: `block: true` prevents the transcript write entirely. */
+    block?: boolean;
     [key: string]: unknown;
 }
 export interface OpenClawPluginHttpRouteParams {

package/plugin/dist/openclaw.plugin.json

@@ -9,7 +9,6 @@
     ]
   },
   "skills": [
-    "templates/langs/en/skills",
     "templates/langs/zh/skills"
   ],
   "configSchema": {

package/plugin/openclaw.plugin.json

@@ -2,14 +2,13 @@
   "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.203.0",
+  "version": "1.207.1",
   "activation": {
     "onCapabilities": [
       "hook"
     ]
   },
   "skills": [
-    "templates/langs/en/skills",
     "templates/langs/zh/skills"
   ],
   "configSchema": {

package/plugin/package.json

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

package/plugin/scripts/sync-plugin.mjs

@@ -686,24 +686,33 @@ function syncFilteredManifest(lang) {
         process.exit(1);
     }
 
-    const filtered = manifest.skills.filter(sp => {
-        if (typeof sp !== 'string') return false;
-        return sp.includes(`/langs/${selectedLang}/`);
-    });
+    // PR #1332 companion: the source manifest declares exactly one root
+    // (zh, product default). REPLACE language roots with the selected one
+    // instead of only filtering, so `--lang en` works against a zh-default
+    // source manifest. Mirrors the production transform in
+    // create-principles-disciple/src/skill-language.ts.
+    const langRoots = {
+        zh: 'templates/langs/zh/skills',
+        en: 'templates/langs/en/skills',
+    };
+    const isLangRoot = (sp) =>
+        typeof sp === 'string' &&
+        (sp.replaceAll('\\', '/') === langRoots.zh || sp.replaceAll('\\', '/') === langRoots.en);
 
-    if (filtered.length === 0) {
-        console.error(`❌ No skills match language "${selectedLang}" in source manifest`);
+    if (!existsSync(join(SOURCE_DIR, langRoots[selectedLang]))) {
+        console.error(`❌ Skill templates missing for language "${selectedLang}": ${langRoots[selectedLang]}`);
         process.exit(1);
     }
 
-    manifest.skills = filtered;
+    const kept = manifest.skills.filter((sp) => !isLangRoot(sp));
+    manifest.skills = [...kept, langRoots[selectedLang]];
 
     // Use syncItem semantics: remove target, then write freshly
     if (existsSync(targetPath)) {
         rmSync(targetPath, { force: true });
     }
     writeFileSync(targetPath, JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
-    console.log(`  ✅ skills filtered to lang: ${selectedLang} (${filtered.length} path(s))`);
+    console.log(`  ✅ skills filtered to lang: ${selectedLang} (${manifest.skills.length} path(s))`);
 }
 
 /**

package/plugin/scripts/verify-build.mjs

@@ -94,14 +94,25 @@ for (const [path, config] of Object.entries(expectedCounts)) {
   }
 }
 
-// 3. List skill files for visibility (agents migrated to skills in templates/)
-const skillsDir = join(rootDir, 'dist/templates/langs/zh/skills');
-if (existsSync(skillsDir)) {
-  const skillFiles = readdirSync(skillsDir)
-    .filter(f => f.endsWith('.md'));
-  
-  if (skillFiles.length > 0) {
-    console.log(`\n📦 Skills available: ${skillFiles.length} (in dist/templates/langs/zh/skills/)`);
+// 3. Verify skill template roots for BOTH languages ship in dist — the
+// installer rewrites the installed manifest per --lang (PR #1332 companion),
+// so a missing root breaks install-time language selection. A "publishable"
+// skill is an immediate child directory containing SKILL.md (what OpenClaw
+// links into ~/.openclaw/plugin-skills).
+for (const lang of ['zh', 'en']) {
+  const skillsDir = join(rootDir, 'dist/templates/langs', lang, 'skills');
+  if (!existsSync(skillsDir)) {
+    console.error(`❌ Missing skill templates: dist/templates/langs/${lang}/skills`);
+    hasError = true;
+    continue;
+  }
+  const publishable = readdirSync(skillsDir, { withFileTypes: true })
+    .filter((e) => e.isDirectory() && existsSync(join(skillsDir, e.name, 'SKILL.md')));
+  if (publishable.length < 20) {
+    console.error(`❌ dist/templates/langs/${lang}/skills has only ${publishable.length} publishable skills (expected at least 20)`);
+    hasError = true;
+  } else {
+    console.log(`✅ ${lang} skills: ${publishable.length} (dist/templates/langs/${lang}/skills/)`);
   }
 }