@principles/core 1.146.2 → 1.147.0

package/dist/storage-adapter.d.ts

@@ -1,59 +0,0 @@
-/**
- * StorageAdapter interface for the Evolution SDK.
- *
- * This interface decouples the evolution engine from specific persistence
- * implementations (file system, SQLite, remote API). All higher-level
- * modules that need to read or mutate the principle ledger should depend
- * on this interface rather than importing principle-tree-ledger directly.
- *
- * The interface uses HybridLedgerStore from types.ts as the
- * canonical store shape, but future adapters can map alternative backends
- * to this shape.
- */
-import type { HybridLedgerStore } from './types.js';
-/**
- * Abstract storage adapter for the principle ledger.
- *
- * Implementations must guarantee:
- * - Atomic writes (no partial/corrupted state on crash)
- * - Thread-safe concurrent access (locking or equivalent)
- * - Consistent read-after-write visibility
- *
- * The `mutateLedger` method is the preferred way to perform read-modify-write
- * cycles. It encapsulates locking so callers never need to manage it.
- */
-export interface StorageAdapter {
-    /**
-     * Load the current ledger state from persistence.
-     *
-     * If no persisted state exists (first run), returns an empty store.
-     */
-    loadLedger(): Promise<HybridLedgerStore>;
-    /**
-     * Persist the full ledger state.
-     *
-     * Must be atomic -- partial writes must never be visible to readers.
-     */
-    saveLedger(store: HybridLedgerStore): Promise<void>;
-    /**
-     * Perform a read-modify-write cycle with automatic locking.
-     *
-     * The `mutate` function receives the current store and may return a
-     * value synchronously or via Promise. The store is persisted after
-     * the mutate function resolves, regardless of its return value.
-     *
-     * If two concurrent `mutateLedger` calls overlap, one must wait for
-     * the other to complete (pessimistic locking) or retry on conflict
-     * (optimistic locking). The choice is left to the implementation.
-     *
-     * @example
-     * ```ts
-     * const count = await adapter.mutateLedger((store) => {
-     *   store.tree.principles['p-1'] = newPrinciple;
-     *   return Object.keys(store.tree.principles).length;
-     * });
-     * ```
-     */
-    mutateLedger<T>(mutate: (store: HybridLedgerStore) => T | Promise<T>): Promise<T>;
-}
-//# sourceMappingURL=storage-adapter.d.ts.map

package/dist/storage-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage-adapter.d.ts","sourceRoot":"","sources":["../src/storage-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMpD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,UAAU,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAEzC;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACnF"}

package/dist/storage-adapter.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=storage-adapter.js.map

package/dist/storage-adapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"storage-adapter.js","sourceRoot":"","sources":["../src/storage-adapter.ts"],"names":[],"mappings":""}

package/dist/types/workspace-resolver.d.ts

@@ -1,25 +0,0 @@
-/**
- * WorkspaceResolver Interface
- *
- * Framework-agnostic contract for resolving the active workspace directory.
- * Concrete implementation is provided by the openclaw-plugin extension mechanism.
- *
- * D-01: Interface in @principles/core, implementation in openclaw-plugin
- */
-/**
- * Interface for resolving the active workspace directory.
- *
- * Concrete implementation lives in openclaw-plugin via extension/override pattern.
- * CLI commands depend on the interface only — no plugin internals.
- */
-export interface WorkspaceResolver {
-    /**
-     * Resolve the active workspace directory.
-     *
-     * @param workspaceDir - Optional override. If not provided, resolves using
-     *                       platform-specific defaults (env vars, config file, cwd).
-     * @returns The resolved workspace directory path.
-     */
-    resolve(workspaceDir?: string): string;
-}
-//# sourceMappingURL=workspace-resolver.d.ts.map

package/dist/types/workspace-resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspace-resolver.d.ts","sourceRoot":"","sources":["../../src/types/workspace-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;OAMG;IACH,OAAO,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACxC"}

package/dist/types/workspace-resolver.js

@@ -1,10 +0,0 @@
-/**
- * WorkspaceResolver Interface
- *
- * Framework-agnostic contract for resolving the active workspace directory.
- * Concrete implementation is provided by the openclaw-plugin extension mechanism.
- *
- * D-01: Interface in @principles/core, implementation in openclaw-plugin
- */
-export {};
-//# sourceMappingURL=workspace-resolver.js.map

package/dist/types/workspace-resolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspace-resolver.js","sourceRoot":"","sources":["../../src/types/workspace-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/types.d.ts

@@ -1,56 +0,0 @@
-/**
- * Duplicated type shapes for principles-core.
- *
- * These types are minimal shapes duplicated from openclaw-plugin to avoid
- * cross-package imports. principles-core must NOT depend on openclaw-plugin.
- *
- * MAINTENANCE CONTRACT: When updating these types, also update the corresponding
- * source types in openclaw-plugin and vice-versa. These are the same shapes --
- * drift between them will cause subtle storage/pipeline bugs.
- *
- * Source locations:
- * - InjectablePrinciple  -> openclaw-plugin/src/core/principle-injection.ts
- * - HybridLedgerStore     -> openclaw-plugin/src/core/principle-tree-ledger.ts
- */
-/**
- * Minimal InjectablePrinciple shape for principle injection.
- * Must stay in sync with openclaw-plugin/src/core/principle-injection.ts.
- */
-export interface InjectablePrinciple {
-    id: string;
-    text: string;
-    /** Priority level. Defaults to 'P1' if not set by the source. */
-    priority?: 'P0' | 'P1' | 'P2';
-    createdAt: string;
-}
-/**
- * Minimal HybridLedgerStore shape for storage adapter interface.
- * Must stay in sync with openclaw-plugin/src/core/principle-tree-ledger.ts.
- *
- * Note: tree.* fields use `unknown` to avoid importing the actual node types.
- * This is an intentional trade-off -- StorageAdapter implementations must
- * be careful to validate the shape of objects they store/retrieve.
- */
-export interface HybridLedgerStore {
-    trainingStore: Record<string, {
-        principleId: string;
-        evaluability: 'deterministic' | 'weak_heuristic' | 'manual_only';
-        applicableOpportunityCount: number;
-        observedViolationCount: number;
-        complianceRate: number;
-        violationTrend: number;
-        generatedSampleCount: number;
-        approvedSampleCount: number;
-        includedTrainRunIds: string[];
-        deployedCheckpointIds: string[];
-        internalizationStatus: 'prompt_only' | 'needs_training' | 'in_training' | 'deployed_pending_eval' | 'internalized' | 'regressed';
-    }>;
-    tree: {
-        principles: Record<string, unknown>;
-        rules: Record<string, unknown>;
-        implementations: Record<string, unknown>;
-        metrics: Record<string, unknown>;
-        lastUpdated: string;
-    };
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;QAC5B,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,eAAe,GAAG,gBAAgB,GAAG,aAAa,CAAC;QACjE,0BAA0B,EAAE,MAAM,CAAC;QACnC,sBAAsB,EAAE,MAAM,CAAC;QAC/B,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,mBAAmB,EAAE,MAAM,EAAE,CAAC;QAC9B,qBAAqB,EAAE,MAAM,EAAE,CAAC;QAChC,qBAAqB,EAAE,aAAa,GAAG,gBAAgB,GAAG,aAAa,GAAG,uBAAuB,GAAG,cAAc,GAAG,WAAW,CAAC;KAClI,CAAC,CAAC;IACH,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH"}

package/dist/types.js

@@ -1,16 +0,0 @@
-/**
- * Duplicated type shapes for principles-core.
- *
- * These types are minimal shapes duplicated from openclaw-plugin to avoid
- * cross-package imports. principles-core must NOT depend on openclaw-plugin.
- *
- * MAINTENANCE CONTRACT: When updating these types, also update the corresponding
- * source types in openclaw-plugin and vice-versa. These are the same shapes --
- * drift between them will cause subtle storage/pipeline bugs.
- *
- * Source locations:
- * - InjectablePrinciple  -> openclaw-plugin/src/core/principle-injection.ts
- * - HybridLedgerStore     -> openclaw-plugin/src/core/principle-tree-ledger.ts
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}