principles-disciple 1.151.0 → 1.152.0

package/dist/commands/pain.js

@@ -5,6 +5,7 @@ import { resolvePluginCommandWorkspaceDir } from '../utils/workspace-resolver.js
 import { computeHash } from '../utils/hashing.js';
 import { PainToPrincipleService, PrincipleTreeLedgerAdapter } from '@principles/core/runtime-v2';
 import { loadPdConfigForPlugin } from '../core/pd-config-loader.js';
+import { createIntentDocReader } from '../core/intent-doc-reader-adapter.js';
 /**
  * Creates a visual progress bar (e.g., [██████░░░░])
  */
@@ -274,6 +275,7 @@ export async function handlePainReportCommand(ctx) {
             autoIntakeEnabled: true,
             effectiveConfig: configResult.effective,
             getEnvVar: (name) => process.env[name],
+            intentDocReader: createIntentDocReader(wctx.workspaceDir),
         });
         const result = await service.recordPain({
             painId: painData.painId,

package/dist/core/intent-doc-reader-adapter.d.ts

@@ -0,0 +1,28 @@
+/**
+ * PRI-468 — Plugin adapter implementing the core `IntentDocReader` port.
+ *
+ * Bridges the plugin-owned `safeReadIntentDoc()` I/O function to the
+ * core-owned `IntentDocReader` interface so Stage A (in core) can read
+ * INTENT.md without core performing any filesystem I/O.
+ *
+ * This adapter only MAPS types — it adds no new I/O, no new flag checks,
+ * and no new telemetry. The underlying `safeReadIntentDoc()` already
+ * performs the flag-first check (SPEC §12), TTL+mtime cache, and size cap.
+ *
+ * ERR checklist:
+ *   EP-01 / ERR-001: never `as` — field-by-field mapping with typeof checks
+ *   EP-02 / ERR-025: plugin I/O file, whitelisted in architecture-regression
+ *   EP-03 / ERR-002: every degraded path flows through with reason + nextAction
+ *
+ * Architecture: this file is I/O (delegates to fs-reading safeReadIntentDoc).
+ * It will be added to KNOWN_PLUGIN_CORE_FILES in architecture-regression.test.ts.
+ */
+import type { IntentDocReader } from '@principles/core/runtime-v2';
+/**
+ * Create an IntentDocReader bound to a specific workspace.
+ *
+ * The returned reader is stateless beyond the workspace binding — each
+ * `readIntentDoc()` call delegates to `safeReadIntentDoc()`, which owns
+ * the TTL+mtime cache.
+ */
+export declare function createIntentDocReader(workspaceDir: string): IntentDocReader;

package/dist/core/intent-doc-reader-adapter.js

@@ -0,0 +1,56 @@
+/**
+ * PRI-468 — Plugin adapter implementing the core `IntentDocReader` port.
+ *
+ * Bridges the plugin-owned `safeReadIntentDoc()` I/O function to the
+ * core-owned `IntentDocReader` interface so Stage A (in core) can read
+ * INTENT.md without core performing any filesystem I/O.
+ *
+ * This adapter only MAPS types — it adds no new I/O, no new flag checks,
+ * and no new telemetry. The underlying `safeReadIntentDoc()` already
+ * performs the flag-first check (SPEC §12), TTL+mtime cache, and size cap.
+ *
+ * ERR checklist:
+ *   EP-01 / ERR-001: never `as` — field-by-field mapping with typeof checks
+ *   EP-02 / ERR-025: plugin I/O file, whitelisted in architecture-regression
+ *   EP-03 / ERR-002: every degraded path flows through with reason + nextAction
+ *
+ * Architecture: this file is I/O (delegates to fs-reading safeReadIntentDoc).
+ * It will be added to KNOWN_PLUGIN_CORE_FILES in architecture-regression.test.ts.
+ */
+import { safeReadIntentDoc } from './intent-doc-reader.js';
+/**
+ * Create an IntentDocReader bound to a specific workspace.
+ *
+ * The returned reader is stateless beyond the workspace binding — each
+ * `readIntentDoc()` call delegates to `safeReadIntentDoc()`, which owns
+ * the TTL+mtime cache.
+ */
+export function createIntentDocReader(workspaceDir) {
+    return {
+        readIntentDoc() {
+            const result = safeReadIntentDoc(workspaceDir);
+            if (result.ok && result.doc) {
+                const doc = result.doc;
+                const reference = {
+                    raw: typeof doc.raw === 'string' ? doc.raw : '',
+                    contentHash: typeof doc.contentHash === 'string' ? doc.contentHash : '',
+                    path: typeof doc.path === 'string' ? doc.path : '',
+                };
+                return {
+                    ok: true,
+                    found: true,
+                    flagEnabled: true,
+                    doc: reference,
+                };
+            }
+            // Degraded path — preserve structured reason + nextAction (EP-03 / ERR-002)
+            return {
+                ok: false,
+                found: result.found,
+                flagEnabled: result.flagEnabled,
+                reason: result.reason,
+                nextAction: result.nextAction,
+            };
+        },
+    };
+}

package/dist/hooks/pain.js

@@ -25,6 +25,7 @@ import { resolveWorkspaceDirForRuntimeV2 } from '../utils/workspace-resolver.js'
 import { PainToPrincipleService, PrincipleTreeLedgerAdapter } from '@principles/core/runtime-v2';
 import { evaluatePainDiagnosticGate } from '../core/pain-diagnostic-gate.js';
 import { loadPdConfigForPlugin, loadFeatureFlagFromConfig } from '../core/pd-config-loader.js';
+import { createIntentDocReader } from '../core/intent-doc-reader-adapter.js';
 import { evaluateTriggerController } from '@principles/core/runtime-v2';
 import { isSharedCooldownActive, markSharedEpisodeAsDiagnosed } from './trigger-cooldown-tracker.js';
 import { buildManualPainObservation, resolveSourceKind } from './raw-observation-adapter.js';
@@ -44,6 +45,10 @@ function createPainToPrincipleService(wctx) {
         autoIntakeEnabled: true,
         effectiveConfig: configResult.effective,
         getEnvVar: (name) => process.env[name],
+        // PRI-468: wire INTENT.md reader so Stage A can produce intentTension
+        // when intent_engineering flag is on. Adapter performs no I/O beyond
+        // delegating to safeReadIntentDoc (which owns the flag-first check).
+        intentDocReader: createIntentDocReader(wctx.workspaceDir),
     });
 }
 // buildTrajectoryEvidence is in ./trajectory-evidence.ts (re-exported above)

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "principles-disciple",
   "name": "Principles Disciple",
   "description": "Evolutionary programming agent framework with strategic guardrails and reflection loops.",
-  "version": "1.151.0",
+  "version": "1.152.0",
   "activation": {
     "onCapabilities": [
       "hook"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "principles-disciple",
-  "version": "1.151.0",
+  "version": "1.152.0",
   "description": "Native OpenClaw plugin for Principles Disciple",
   "type": "module",
   "main": "./dist/bundle.js",