principles-disciple 1.147.0 → 1.149.0

package/dist/core/reflection/reflection-context.d.ts

@@ -1,7 +1,7 @@
+import { type LedgerPrinciple } from '../principle-tree-ledger.js';
 import type { TrajectoryDatabase } from '../trajectory.js';
-import type { Principle } from '../../types/principle-tree-schema.js';
 export interface ReflectionContext {
-    principle: Principle;
+    principle: LedgerPrinciple;
     painEvents: Array<{
         source: string;
         score: number;

package/dist/core/workspace-context.d.ts

@@ -6,12 +6,11 @@ import { HygieneTracker } from './hygiene/tracker.js';
 import { EvolutionReducerImpl } from './evolution-reducer.js';
 import type { TrajectoryDatabase } from './trajectory.js';
 import { PrincipleLifecycleService } from './principle-internalization/principle-lifecycle-service.js';
-import { type PrincipleSubtree } from './principle-tree-ledger.js';
-import type { Principle, PrincipleValueMetrics } from '../types/principle-tree-schema.js';
+import { type PrincipleSubtree, type LedgerPrinciple, type PrincipleValueMetrics } from './principle-tree-ledger.js';
 import type { Principle as ActivePrinciple } from './evolution-types.js';
 interface PrincipleTreeLedgerAccessor {
     getPrincipleSubtree(_principleId: string): PrincipleSubtree | undefined;
-    updatePrinciple(_principleId: string, updates: Partial<Principle>): Principle;
+    updatePrinciple(_principleId: string, updates: Partial<LedgerPrinciple>): LedgerPrinciple;
     updatePrincipleValueMetrics(principleId: string, _metrics: PrincipleValueMetrics): PrincipleValueMetrics;
 }
 /**

package/dist/index.d.ts

@@ -45,6 +45,6 @@ declare const plugin: {
     description: string;
     register(api: OpenClawPluginApi): void;
 };
-export { PrincipleTreeLedgerAdapter } from './core/principle-tree-ledger-adapter.js';
+export { PrincipleTreeLedgerAdapter } from '@principles/core/runtime-v2';
 export { loadFeatureFlagFromWorkspace, isRecord };
 export default plugin;

package/dist/index.js

@@ -31,7 +31,6 @@ import { CorrectionObserverService } from './service/correction-observer-service
 import { InternalizationAutoConsumerService } from './service/internalization-auto-consumer-service.js';
 import { TrajectoryService } from './service/trajectory-service.js';
 import { PDTaskService } from './core/pd-task-service.js';
-import { CentralSyncService } from './service/central-sync-service.js';
 import { ensureWorkspaceTemplates } from './core/init.js';
 import { migrateDirectoryStructure } from './core/migration.js';
 import { migrateStaleWorkspaceGuidance } from './core/workspace-guidance-migrator.js';
@@ -408,9 +407,6 @@ const plugin = {
             const guardedPdTask = guardService('service:pd-task', PDTaskService, api.logger);
             if (guardedPdTask)
                 api.registerService(guardedPdTask);
-            const guardedCentralSync = guardService('service:central-sync', CentralSyncService, api.logger);
-            if (guardedCentralSync)
-                api.registerService(guardedCentralSync);
             const guardedAutoConsumer = guardService('service:internalization-auto-consumer', InternalizationAutoConsumerService, api.logger);
             if (guardedAutoConsumer)
                 api.registerService(guardedAutoConsumer);
@@ -745,7 +741,10 @@ const plugin = {
         });
     }
 };
-export { PrincipleTreeLedgerAdapter } from './core/principle-tree-ledger-adapter.js';
+// PrincipleTreeLedgerAdapter is exported from @principles/core/runtime-v2 (canonical,
+// consolidated in PRI-459). The plugin-local duplicate was removed; re-export the core
+// symbol so any external consumer importing from the plugin still resolves it.
+export { PrincipleTreeLedgerAdapter } from '@principles/core/runtime-v2';
 /* istanbul ignore next — test exports for evolution worker gate */
 export { loadFeatureFlagFromWorkspace, isRecord };
 export default plugin;

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.147.0",
+  "version": "1.149.0",
   "activation": {
     "onCapabilities": [
       "hook"

package/package.json

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

package/dist/core/principle-tree-ledger-adapter.d.ts

@@ -1,32 +0,0 @@
-import type { LedgerAdapter, LedgerPrincipleEntry } from '@principles/core/runtime-v2';
-/**
- * PrincipleTreeLedgerAdapter — bridges 11-field LedgerPrincipleEntry to 18+ field LedgerPrinciple.
- *
- * This adapter maintains an in-memory idempotency map. Create once and reuse
- * across calls within the same process lifetime. Do not create a new instance
- * per intake call.
- */
-export declare class PrincipleTreeLedgerAdapter implements LedgerAdapter {
-    #private;
-    constructor(opts: {
-        stateDir: string;
-    });
-    /**
-     * Write a probation entry to the ledger.
-     *
-     * Idempotency: if the same candidateId was already written, returns the
-     * existing entry without writing again.
-     *
-     * @throws CandidateIntakeError with code LEDGER_WRITE_FAILED on write failure.
-     */
-    writeProbationEntry(entry: LedgerPrincipleEntry): LedgerPrincipleEntry;
-    /**
-     * Check if a ledger entry already exists for a given candidate.
-     *
-     * Queries both the in-memory Map (fast path for same-process repeat calls)
-     * and the ledger file (for cross-process idempotency across CLI invocations).
-     *
-     * @returns The existing LedgerPrincipleEntry if found, null otherwise.
-     */
-    existsForCandidate(candidateId: string): LedgerPrincipleEntry | null;
-}

package/dist/core/principle-tree-ledger-adapter.js

@@ -1,125 +0,0 @@
-import { CandidateIntakeError, INTAKE_ERROR_CODES } from '@principles/core/runtime-v2';
-import { addPrincipleToLedger, loadLedger } from './principle-tree-ledger.js';
-const VALID_EVALUABILITIES = ['deterministic', 'weak_heuristic', 'manual_only'];
-/**
- * PrincipleTreeLedgerAdapter — bridges 11-field LedgerPrincipleEntry to 18+ field LedgerPrinciple.
- *
- * This adapter maintains an in-memory idempotency map. Create once and reuse
- * across calls within the same process lifetime. Do not create a new instance
- * per intake call.
- */
-export class PrincipleTreeLedgerAdapter {
-    #stateDir;
-    #entryMap = new Map();
-    constructor(opts) {
-        this.#stateDir = opts.stateDir;
-    }
-    /**
-     * Write a probation entry to the ledger.
-     *
-     * Idempotency: if the same candidateId was already written, returns the
-     * existing entry without writing again.
-     *
-     * @throws CandidateIntakeError with code LEDGER_WRITE_FAILED on write failure.
-     */
-    writeProbationEntry(entry) {
-        const candidateId = this.#extractCandidateId(entry.sourceRef);
-        const existing = this.#entryMap.get(candidateId);
-        if (existing)
-            return existing;
-        const ledgerPrinciple = this.#expandToLedgerPrinciple(entry, candidateId);
-        try {
-            addPrincipleToLedger(this.#stateDir, ledgerPrinciple);
-        }
-        catch (err) {
-            throw new CandidateIntakeError(INTAKE_ERROR_CODES.LEDGER_WRITE_FAILED, `Failed to write principle ${entry.id} to ledger: ${String(err)}`, { cause: err });
-        }
-        this.#entryMap.set(candidateId, entry);
-        return entry;
-    }
-    /**
-     * Check if a ledger entry already exists for a given candidate.
-     *
-     * Queries both the in-memory Map (fast path for same-process repeat calls)
-     * and the ledger file (for cross-process idempotency across CLI invocations).
-     *
-     * @returns The existing LedgerPrincipleEntry if found, null otherwise.
-     */
-    existsForCandidate(candidateId) {
-        // Fast path: check in-memory Map (covers same-process repeat calls)
-        const cached = this.#entryMap.get(candidateId);
-        if (cached)
-            return cached;
-        // Cross-process path: check ledger file by derivedFromPainIds
-        const ledger = loadLedger(this.#stateDir);
-        const found = Object.values(ledger.tree.principles).find((p) => p.derivedFromPainIds.includes(candidateId));
-        if (!found)
-            return null;
-        // Reconstruct LedgerPrincipleEntry from LedgerPrinciple fields
-        // Note: sourceRef, artifactRef, taskRef are not stored in LedgerPrinciple,
-        // so we cannot fully reconstruct the original LedgerPrincipleEntry.
-        // Return minimal entry sufficient for idempotency signaling.
-        return {
-            id: found.id,
-            title: '',
-            status: 'probation',
-            sourceRef: `candidate://${candidateId}`,
-            artifactRef: '',
-            taskRef: '',
-            text: found.text,
-            triggerPattern: found.triggerPattern,
-            action: found.action,
-            evaluability: 'weak_heuristic',
-            createdAt: found.createdAt,
-        };
-    }
-    /**
-     * Extract candidateId from sourceRef by stripping the 'candidate://' prefix.
-     *
-     * @internal
-     */
-    #extractCandidateId(sourceRef) {
-        if (sourceRef.startsWith('candidate://')) {
-            return sourceRef.slice('candidate://'.length);
-        }
-        return sourceRef;
-    }
-    /**
-     * Expand an 11-field LedgerPrincipleEntry to an 18+ field LedgerPrinciple.
-     *
-     * Applies the field expansion table from CONTEXT.md:
-     * - status: 'probation' → 'candidate'
-     * - triggerPattern/action: pass through (empty string if absent)
-     * - All defaults applied per CONTEXT.md expansion table
-     * - sourceRef/artifactRef/taskRef are NOT written to LedgerPrinciple (not stored)
-     * - title is NOT written to LedgerPrinciple — intentionally excluded; title
-     *   is available in LedgerPrincipleEntry but LedgerPrinciple has no title field
-     *
-     * @internal
-     */
-    #expandToLedgerPrinciple(entry, candidateId) {
-        if (!VALID_EVALUABILITIES.includes(entry.evaluability)) {
-            throw new CandidateIntakeError(INTAKE_ERROR_CODES.INPUT_INVALID, `Invalid evaluability value: ${entry.evaluability}. Must be one of: ${VALID_EVALUABILITIES.join(', ')}`);
-        }
-        const result = {
-            id: entry.id,
-            version: 1,
-            text: entry.text,
-            triggerPattern: entry.triggerPattern ?? '',
-            action: entry.action ?? '',
-            status: 'candidate',
-            evaluability: entry.evaluability,
-            priority: 'P1',
-            scope: 'general',
-            valueScore: 0,
-            adherenceRate: 0,
-            painPreventedCount: 0,
-            derivedFromPainIds: [candidateId],
-            ruleIds: [],
-            conflictsWithPrincipleIds: [],
-            createdAt: entry.createdAt,
-            updatedAt: entry.createdAt,
-        };
-        return result;
-    }
-}

package/dist/service/central-database.d.ts

@@ -1,138 +0,0 @@
-export interface WorkspaceInfo {
-    name: string;
-    path: string;
-    lastSync: string | null;
-}
-/**
- * Central database that aggregates data from all agent workspaces.
- * Stored in ~/.openclaw/.central/ (NOT in memory/ which is for embeddings)
- */
-export declare class CentralDatabase {
-    private readonly dbPath;
-    private readonly db;
-    private readonly workspaces;
-    private _closed;
-    /** Whether this connection has been closed. Used by the singleton to auto-reopen. */
-    get isClosed(): boolean;
-    constructor(dbPath?: string);
-    dispose(): void;
-    private static tableExists;
-    private initSchema;
-    private discoverWorkspaces;
-    /**
-     * Sync data from a single workspace into the central database
-     */
-    syncWorkspace(workspaceName: string): number;
-    syncEnabled(): Map<string, number>;
-    /**
-     * Sync all workspaces (legacy method - syncs all regardless of config)
-     */
-    syncAll(): Map<string, number>;
-    private getEnabledWorkspaceFilter;
-    /**
-     * Get aggregated overview stats (only from enabled workspaces)
-     */
-    getOverviewStats(): {
-        totalSessions: number;
-        totalToolCalls: number;
-        totalFailures: number;
-        totalPainEvents: number;
-        totalCorrections: number;
-        totalThinkingEvents: number;
-        totalSamples: number;
-        pendingSamples: number;
-        approvedSamples: number;
-        rejectedSamples: number;
-        workspaceCount: number;
-        enabledWorkspaceCount: number;
-        workspaceNames: string[];
-        enabledWorkspaceNames: string[];
-    };
-    /**
-     * Get daily trend data
-     */
-    getDailyTrend(days?: number): {
-        day: string;
-        toolCalls: number;
-        failures: number;
-        userCorrections: number;
-        thinkingTurns: number;
-    }[];
-    /**
-     * Get top regressions
-     */
-    getTopRegressions(limit?: number): {
-        toolName: string;
-        errorType: string;
-        occurrences: number;
-    }[];
-    /**
-     * Get thinking model stats
-     */
-    getThinkingModelStats(): {
-        totalModels: number;
-        activeModels: number;
-        models: {
-            modelId: string;
-            hits: number;
-            coverageRate: number;
-        }[];
-    };
-    /**
-     * Get workspace list
-     */
-    getWorkspaces(): WorkspaceInfo[];
-    getWorkspaceConfigs(): {
-        workspaceName: string;
-        enabled: boolean;
-        displayName: string | null;
-        syncEnabled: boolean;
-    }[];
-    updateWorkspaceConfig(workspaceName: string, updates: {
-        enabled?: boolean;
-        displayName?: string | null;
-        syncEnabled?: boolean;
-    }): void;
-    isWorkspaceEnabled(workspaceName: string): boolean;
-    getEnabledWorkspaces(): WorkspaceInfo[];
-    addCustomWorkspace(name: string, workspacePath: string): void;
-    removeWorkspace(workspaceName: string): void;
-    getGlobalConfig(key: string): string | null;
-    setGlobalConfig(key: string, value: string): void;
-    /**
-     * Clear all aggregated data (for testing/reset)
-     */
-    clearAll(): void;
-    /**
-     * Get total task outcomes count across enabled workspaces (D-02)
-     */
-    getTaskOutcomes(): number;
-    /**
-     * Get total principle events count across enabled workspaces (D-03)
-     */
-    getPrincipleEventCount(): number;
-    /**
-     * Get sample counts grouped by review_status across enabled workspaces (D-06)
-     */
-    getSampleCountersByStatus(): Record<string, number>;
-    /**
-     * Get top N most recent pending/approved samples across all enabled workspaces (D-04)
-     */
-    getSamplePreview(limit?: number): {
-        sampleId: string;
-        sessionId: string;
-        workspace: string;
-        qualityScore: number;
-        reviewStatus: string;
-        createdAt: string;
-    }[];
-    /**
-     * Get the most recent lastSync timestamp across all workspaces (D-05)
-     */
-    getMostRecentSync(): string | null;
-}
-export declare function getCentralDatabase(): CentralDatabase;
-/**
- * Reset the singleton instance. Used for testing.
- */
-export declare function resetCentralDatabase(): void;