@principles/core 1.73.0

package/dist/adapters/writing/writing-types.js.map

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

package/dist/evolution-hook.d.ts

@@ -0,0 +1,70 @@
+/**
+ * EvolutionHook interface for the Evolution SDK.
+ *
+ * Provides a callback-based interface for observing evolution lifecycle
+ * events: pain detection, principle creation, and principle promotion.
+ *
+ * Per D-03, this interface contains only the 3 core event methods.
+ * Per D-04, consumers implement the interface directly (no EventEmitter).
+ * Hooks not needed can use the provided noOpEvolutionHook and override
+ * individual methods.
+ */
+import type { PainSignal } from './pain-signal.js';
+/** Event payload for principle creation lifecycle events. */
+export interface PrincipleCreatedEvent {
+    /** Unique principle identifier */
+    id: string;
+    /** Principle text ("When X, then Y.") */
+    text: string;
+    /** What triggered this principle's creation */
+    trigger: string;
+}
+/** Event payload for principle promotion lifecycle events. */
+export interface PrinciplePromotedEvent {
+    /** Unique principle identifier */
+    id: string;
+    /** Previous status tier */
+    from: string;
+    /** New status tier */
+    to: string;
+}
+/**
+ * Callback interface for observing evolution lifecycle events.
+ *
+ * Implement all 3 methods, or spread noOpEvolutionHook and override
+ * only the methods you need:
+ *
+ * @example
+ * ```ts
+ * const myHook: EvolutionHook = {
+ *   ...noOpEvolutionHook,
+ *   onPainDetected(signal) { console.log(signal); },
+ * };
+ * ```
+ *
+ * Error handling: implementations MUST NOT throw. Throwing will propagate
+ * exceptions to the caller of the hook. If a hook needs to perform fallible
+ * operations (e.g., network calls, file I/O), it should catch internally
+ * and return gracefully. This constraint ensures the core evolution pipeline
+ * is not disrupted by hook failures.
+ */
+export interface EvolutionHook {
+    /**
+     * Called when a pain signal is detected and recorded.
+     * Implementations MUST NOT throw.
+     */
+    onPainDetected(signal: PainSignal): void;
+    /**
+     * Called when a new principle candidate is created.
+     * Implementations MUST NOT throw.
+     */
+    onPrincipleCreated(event: PrincipleCreatedEvent): void;
+    /**
+     * Called when a principle is promoted to a higher tier.
+     * Implementations MUST NOT throw.
+     */
+    onPrinciplePromoted(event: PrinciplePromotedEvent): void;
+}
+/** No-op implementation -- consumers can spread and override individual methods. */
+export declare const noOpEvolutionHook: EvolutionHook;
+//# sourceMappingURL=evolution-hook.d.ts.map

package/dist/evolution-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolution-hook.d.ts","sourceRoot":"","sources":["../src/evolution-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD,6DAA6D;AAC7D,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8DAA8D;AAC9D,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;CACZ;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACzC;;;OAGG;IACH,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACvD;;;OAGG;IACH,mBAAmB,CAAC,KAAK,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC1D;AAMD,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,EAAE,aAI/B,CAAC"}

package/dist/evolution-hook.js

@@ -0,0 +1,10 @@
+// ---------------------------------------------------------------------------
+// No-op Helper
+// ---------------------------------------------------------------------------
+/** No-op implementation -- consumers can spread and override individual methods. */
+export const noOpEvolutionHook = {
+    onPainDetected(_signal) { },
+    onPrincipleCreated(_event) { },
+    onPrinciplePromoted(_event) { },
+};
+//# sourceMappingURL=evolution-hook.js.map

package/dist/evolution-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolution-hook.js","sourceRoot":"","sources":["../src/evolution-hook.ts"],"names":[],"mappings":"AA+EA,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,oFAAoF;AACpF,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,cAAc,CAAC,OAAmB,IAAqB,CAAC;IACxD,kBAAkB,CAAC,MAA6B,IAAqB,CAAC;IACtE,mBAAmB,CAAC,MAA8B,IAAqB,CAAC;CACzE,CAAC"}

package/dist/evolution-store.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Evolution Store — evolution task primitives for SDK use.
+ *
+ * Extracts listEvolutionTasks and getEvolutionTask from TrajectoryDatabase
+ * as pure functions that can be used without openclaw-plugin dependency.
+ *
+ * @example
+ * import { listEvolutionTasks, getEvolutionTask } from '@principles/core/evolution-store';
+ */
+export type TaskKind = 'coding' | 'debugging' | 'reasoning' | 'creative';
+export type TaskPriority = 'low' | 'normal' | 'high' | 'critical';
+export interface EvolutionTaskRecord {
+    id: number;
+    taskId: string;
+    traceId: string;
+    source: string;
+    reason: string | null;
+    score: number;
+    status: string;
+    enqueuedAt: string | null;
+    startedAt: string | null;
+    completedAt: string | null;
+    resolution: string | null;
+    createdAt: string;
+    updatedAt: string;
+    taskKind: TaskKind | null;
+    priority: TaskPriority | null;
+    retryCount: number | null;
+    maxRetries: number | null;
+    lastError: string | null;
+    resultRef: string | null;
+}
+export interface EvolutionTaskFilters {
+    status?: string;
+    dateFrom?: string;
+    dateTo?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * List evolution tasks with optional filtering.
+ *
+ * @param workspaceDir - The workspace directory (DB path: {workspaceDir}/.state/.trajectory.db)
+ * @param filters - Optional filters (status, dateFrom, dateTo, limit, offset)
+ * @returns Array of EvolutionTaskRecord, or empty array if DB does not exist
+ */
+export declare function listEvolutionTasks(workspaceDir: string, filters?: EvolutionTaskFilters): EvolutionTaskRecord[];
+/**
+ * Get a single evolution task by numeric id or string taskId.
+ *
+ * @param workspaceDir - The workspace directory (DB path: {workspaceDir}/.state/.trajectory.db)
+ * @param idOrTaskId - Numeric id or string taskId
+ * @returns EvolutionTaskRecord or null if not found
+ */
+export declare function getEvolutionTask(workspaceDir: string, idOrTaskId: string | number): EvolutionTaskRecord | null;
+//# sourceMappingURL=evolution-store.d.ts.map

package/dist/evolution-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolution-store.d.ts","sourceRoot":"","sources":["../src/evolution-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AACzE,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAcD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,EAAE,CAmEvB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GAAG,MAAM,GAC1B,mBAAmB,GAAG,IAAI,CAqD5B"}

package/dist/evolution-store.js

@@ -0,0 +1,150 @@
+/**
+ * Evolution Store — evolution task primitives for SDK use.
+ *
+ * Extracts listEvolutionTasks and getEvolutionTask from TrajectoryDatabase
+ * as pure functions that can be used without openclaw-plugin dependency.
+ *
+ * @example
+ * import { listEvolutionTasks, getEvolutionTask } from '@principles/core/evolution-store';
+ */
+import Database from 'better-sqlite3';
+import { join } from 'path';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function getDbPath(workspaceDir) {
+    return join(workspaceDir, '.state', '.trajectory.db');
+}
+// ---------------------------------------------------------------------------
+// Core functions
+// ---------------------------------------------------------------------------
+/**
+ * List evolution tasks with optional filtering.
+ *
+ * @param workspaceDir - The workspace directory (DB path: {workspaceDir}/.state/.trajectory.db)
+ * @param filters - Optional filters (status, dateFrom, dateTo, limit, offset)
+ * @returns Array of EvolutionTaskRecord, or empty array if DB does not exist
+ */
+export function listEvolutionTasks(workspaceDir, filters = {}) {
+    const dbPath = getDbPath(workspaceDir);
+    // eslint-disable-next-line @typescript-eslint/init-declarations
+    let db;
+    try {
+        db = new Database(dbPath, { readonly: true });
+    }
+    catch {
+        // Graceful fallback: DB does not exist yet
+        return [];
+    }
+    try {
+        const conditions = [];
+        const values = [];
+        if (filters.status) {
+            conditions.push('status = ?');
+            values.push(filters.status);
+        }
+        if (filters.dateFrom) {
+            conditions.push('created_at >= ?');
+            values.push(filters.dateFrom);
+        }
+        if (filters.dateTo) {
+            conditions.push('created_at <= ?');
+            values.push(filters.dateTo);
+        }
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const limit = filters.limit ?? 50;
+        const offset = filters.offset ?? 0;
+        const rows = db.prepare(`
+      SELECT id, task_id, trace_id, source, reason, score, status,
+             enqueued_at, started_at, completed_at, resolution, created_at, updated_at,
+             task_kind, priority, retry_count, max_retries, last_error, result_ref
+      FROM evolution_tasks
+      ${whereClause}
+      ORDER BY created_at DESC
+      LIMIT ? OFFSET ?
+    `).all(...values, limit, offset);
+        return rows.map((row) => ({
+            id: Number(row.id),
+            taskId: String(row.task_id),
+            traceId: String(row.trace_id),
+            source: String(row.source),
+            reason: row.reason ? String(row.reason) : null,
+            score: Number(row.score ?? 0),
+            status: String(row.status),
+            enqueuedAt: row.enqueued_at ? String(row.enqueued_at) : null,
+            startedAt: row.started_at ? String(row.started_at) : null,
+            completedAt: row.completed_at ? String(row.completed_at) : null,
+            resolution: row.resolution ? String(row.resolution) : null,
+            createdAt: String(row.created_at),
+            updatedAt: String(row.updated_at),
+            taskKind: row.task_kind ? row.task_kind : null,
+            priority: row.priority ? row.priority : null,
+            retryCount: row.retry_count != null ? Number(row.retry_count) : null,
+            maxRetries: row.max_retries != null ? Number(row.max_retries) : null,
+            lastError: row.last_error ? String(row.last_error) : null,
+            resultRef: row.result_ref ? String(row.result_ref) : null,
+        }));
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Get a single evolution task by numeric id or string taskId.
+ *
+ * @param workspaceDir - The workspace directory (DB path: {workspaceDir}/.state/.trajectory.db)
+ * @param idOrTaskId - Numeric id or string taskId
+ * @returns EvolutionTaskRecord or null if not found
+ */
+export function getEvolutionTask(workspaceDir, idOrTaskId) {
+    const dbPath = getDbPath(workspaceDir);
+    // eslint-disable-next-line @typescript-eslint/init-declarations
+    let db;
+    try {
+        db = new Database(dbPath, { readonly: true });
+    }
+    catch {
+        // Graceful fallback: DB does not exist yet
+        return null;
+    }
+    try {
+        const isNumeric = typeof idOrTaskId === 'number';
+        const whereClause = isNumeric ? 'WHERE id = ?' : 'WHERE task_id = ?';
+        const param = isNumeric ? idOrTaskId : String(idOrTaskId);
+        const row = db.prepare(`
+      SELECT id, task_id, trace_id, source, reason, score, status,
+             enqueued_at, started_at, completed_at, resolution, created_at, updated_at,
+             task_kind, priority, retry_count, max_retries, last_error, result_ref
+      FROM evolution_tasks
+      ${whereClause}
+    `).get(param);
+        if (!row) {
+            return null;
+        }
+        return {
+            id: Number(row.id),
+            taskId: String(row.task_id),
+            traceId: String(row.trace_id),
+            source: String(row.source),
+            reason: row.reason ? String(row.reason) : null,
+            score: Number(row.score ?? 0),
+            status: String(row.status),
+            enqueuedAt: row.enqueued_at ? String(row.enqueued_at) : null,
+            startedAt: row.started_at ? String(row.started_at) : null,
+            completedAt: row.completed_at ? String(row.completed_at) : null,
+            resolution: row.resolution ? String(row.resolution) : null,
+            createdAt: String(row.created_at),
+            updatedAt: String(row.updated_at),
+            taskKind: row.task_kind ? row.task_kind : null,
+            priority: row.priority ? row.priority : null,
+            retryCount: row.retry_count != null ? Number(row.retry_count) : null,
+            maxRetries: row.max_retries != null ? Number(row.max_retries) : null,
+            lastError: row.last_error ? String(row.last_error) : null,
+            resultRef: row.result_ref ? String(row.result_ref) : null,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=evolution-store.js.map

package/dist/evolution-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evolution-store.js","sourceRoot":"","sources":["../src/evolution-store.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @principles/core -- Universal Evolution SDK
+ *
+ * Framework-agnostic pain signal capture and principle injection.
+ *
+ * @example
+ * import { PainSignalSchema, validatePainSignal, deriveSeverity } from '@principles/core';
+ * import type { PainSignal } from '@principles/core';
+ * import type { PainSignalAdapter } from '@principles/core';
+ * import type { PrincipleInjector, InjectionContext } from '@principles/core';
+ * import { DefaultPrincipleInjector } from '@principles/core';
+ */
+export { PainSignalSchema, validatePainSignal, deriveSeverity, PainSeverity } from './pain-signal.js';
+export type { PainSignal, PainSignalValidationResult } from './pain-signal.js';
+export { PainSignalAdapter } from './pain-signal-adapter.js';
+export { EvolutionHook, noOpEvolutionHook } from './evolution-hook.js';
+export type { PrincipleCreatedEvent, PrinciplePromotedEvent } from './evolution-hook.js';
+export { TelemetryEventSchema, validateTelemetryEvent } from './telemetry-event.js';
+export type { TelemetryEvent, TelemetryEventValidationResult, TelemetryEventType } from './telemetry-event.js';
+export { StorageAdapter } from './storage-adapter.js';
+export { PrincipleInjector, DefaultPrincipleInjector, InjectionContext } from './principle-injector.js';
+export type { InjectablePrinciple } from './types.js';
+export type { HybridLedgerStore } from './types.js';
+export type { WorkspaceResolver } from './types/workspace-resolver.js';
+export { atomicWriteFileSync } from './io.js';
+export { recordPainSignal } from './pain-recorder.js';
+export type { PainSignalInput } from './pain-recorder.js';
+export { resolvePainFlagPath } from './pain-flag-resolver.js';
+export { buildAttitudeDirective, detectCorrectionCue, extractMessageContent, isMinimalTrigger, truncateInjectionToBudget, } from './prompt-builder/index.js';
+export type { PromptInjectionPart, SizeGuardOptions } from './prompt-builder/index.js';
+export { matchEmpathyKeywords, createDefaultKeywordStore, applyKeywordUpdates, shouldTriggerOptimization, getKeywordStoreSummary, EMPATHY_SEED_KEYWORDS, DEFAULT_EMPATHY_KEYWORD_CONFIG, scoreToSeverity, severityToPenalty, normalizeSeverity, } from './prompt-builder/index.js';
+export type { EmpathyKeywordStore, EmpathyKeywordEntry, EmpathyKeywordStats, EmpathyMatchResult, EmpathyKeywordUpdate, EmpathyOptimizationResult, SeedKeywordEntry, EmpathyKeywordConfig, } from './prompt-builder/index.js';
+export { extractVersion, extractDate, extractSummary, parseWorkingMemorySection, workingMemoryToInjection, extractMilestones, validateCurrentFocus, mergeWorkingMemory, compressFocusContent, DEFAULT_FOCUS_COMPRESSION_OPTIONS, } from './prompt-builder/index.js';
+export type { FileArtifact, WorkingMemorySnapshot, FocusCompressionOptions, FocusCompressionResult, } from './prompt-builder/index.js';
+export { listCorrectionSamples, reviewCorrectionSample } from './trajectory-store.js';
+export type { CorrectionSampleRecord, CorrectionSampleReviewStatus } from './trajectory-store.js';
+export { RUNTIME_V2_SCHEMA_VERSION, schemaRef, SchemaVersionRefSchema, RuntimeV2SchemaVersionSchema, PDErrorCategorySchema, PD_ERROR_CATEGORIES, PDRuntimeError, isPDErrorCategory, } from './runtime-v2/index.js';
+export { AGENT_IDS, AgentCapabilityRequirementsSchema, AgentTimeoutPolicySchema, AgentRetryPolicySchema, AgentSpecSchema, } from './runtime-v2/index.js';
+export { RuntimeKindSchema, RuntimeCapabilitiesSchema, RuntimeHealthSchema, RunHandleSchema, RunExecutionStatusSchema, RunStatusSchema, ContextItemSchema, AgentSpecRefSchema, WorkflowRefSchema, TaskRefSchema, StartRunInputSchema, StructuredRunOutputSchema, RuntimeArtifactRefSchema, } from './runtime-v2/index.js';
+export { PDTaskStatusSchema, TaskRecordSchema, DiagnosticianTaskRecordSchema, } from './runtime-v2/index.js';
+export { RuntimeSelectionCriteriaSchema, } from './runtime-v2/index.js';
+export { HistoryQueryEntrySchema, TrajectoryLocateQuerySchema, TrajectoryCandidateSchema, TrajectoryLocateResultSchema, HistoryQueryResultSchema, DiagnosisTargetSchema, ContextPayloadSchema, DiagnosticianContextPayloadSchema, } from './runtime-v2/index.js';
+export { DiagnosticianViolatedPrincipleSchema, DiagnosticianEvidenceSchema, RecommendationKindSchema, DiagnosticianRecommendationSchema, DiagnosticianOutputV1Schema, DiagnosticianInvocationInputSchema, } from './runtime-v2/index.js';
+export type { PDErrorCategory, AgentSpec, AgentCapabilityRequirements, AgentTimeoutPolicy, AgentRetryPolicy, WellKnownAgentId, RuntimeKind, RuntimeCapabilities, RuntimeHealth, RunHandle, RunExecutionStatus, RunStatus, ContextItem, AgentSpecRef, WorkflowRef, TaskRef, StartRunInput, StructuredRunOutput, RuntimeArtifactRef, PDRuntimeAdapter, RuntimeSelector, RuntimeSelectionCriteria, RuntimeSelectionResult, PDTaskStatus, TaskRecord, DiagnosticianTaskRecord, HistoryQueryEntry, TrajectoryLocateQuery, TrajectoryCandidate, TrajectoryLocateResult, HistoryQueryResult, DiagnosisTarget, ContextPayload, DiagnosticianContextPayload, DiagnosticianOutputV1, DiagnosticianViolatedPrinciple, DiagnosticianEvidence, RecommendationKind, DiagnosticianRecommendation, DiagnosticianInvocationInput, } from './runtime-v2/index.js';
+export { RuntimeStateManager } from './runtime-v2/index.js';
+export type { RuntimeStateManagerOptions } from './runtime-v2/index.js';
+export { SqliteTaskStore, SqliteRunStore, SqliteConnection, SqliteTrajectoryLocator, SqliteSourceTraceLocator, SqliteHistoryQuery, SqliteContextAssembler, ResilientContextAssembler, ResilientHistoryQuery, DEFAULT_HISTORY_PAGE_SIZE, MAX_HISTORY_PAGE_SIZE, DEFAULT_TIME_WINDOW_MS, } from './runtime-v2/index.js';
+export type { HistoryQuery, HistoryQueryCursorData, HistoryQueryOptions, } from './runtime-v2/index.js';
+export type { ContextAssembler } from './runtime-v2/store/context/context-assembler.js';
+export type { TaskStore, TaskStoreFilter, TaskStoreUpdatePatch, } from './runtime-v2/store/task/task-store.js';
+export type { RunStore, RunRecord, } from './runtime-v2/store/run/run-store.js';
+export type { TrajectoryLocator } from './runtime-v2/store/trajectory/trajectory-locator.js';
+export { DefaultLeaseManager } from './runtime-v2/index.js';
+export type { LeaseManager, AcquireLeaseOptions } from './runtime-v2/index.js';
+export { DefaultRetryPolicy } from './runtime-v2/index.js';
+export type { RetryPolicy, RetryPolicyConfig } from './runtime-v2/index.js';
+export { DefaultRecoverySweep } from './runtime-v2/index.js';
+export type { RecoverySweep, RecoveryResult } from './runtime-v2/index.js';
+export { StoreEventEmitter, storeEmitter } from './runtime-v2/index.js';
+export { WorkflowFunnelLoader } from './workflow-funnel-loader.js';
+export type { WorkflowStage, WorkflowFunnel, FunnelPolicy, WorkflowFunnelConfig, } from './workflow-funnel-loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,64 @@
+/**
+ * @principles/core -- Universal Evolution SDK
+ *
+ * Framework-agnostic pain signal capture and principle injection.
+ *
+ * @example
+ * import { PainSignalSchema, validatePainSignal, deriveSeverity } from '@principles/core';
+ * import type { PainSignal } from '@principles/core';
+ * import type { PainSignalAdapter } from '@principles/core';
+ * import type { PrincipleInjector, InjectionContext } from '@principles/core';
+ * import { DefaultPrincipleInjector } from '@principles/core';
+ */
+// PainSignal schema and validation
+export { PainSignalSchema, validatePainSignal, deriveSeverity, PainSeverity } from './pain-signal.js';
+// EvolutionHook interface
+export { noOpEvolutionHook } from './evolution-hook.js';
+// TelemetryEvent schema
+export { TelemetryEventSchema, validateTelemetryEvent } from './telemetry-event.js';
+// PrincipleInjector interface and DefaultPrincipleInjector
+export { DefaultPrincipleInjector } from './principle-injector.js';
+// I/O utilities (D-03: atomicWriteFileSync for crash-safe writes)
+export { atomicWriteFileSync } from './io.js';
+// PainRecorder — pure function for pain signal recording (D-02)
+export { recordPainSignal } from './pain-recorder.js';
+// PainFlagPathResolver — pure function for resolving pain flag paths (D-04)
+export { resolvePainFlagPath } from './pain-flag-resolver.js';
+// Prompt builder primitives — pure functions extracted from openclaw-plugin prompt hook (PRI-75)
+export { buildAttitudeDirective, detectCorrectionCue, extractMessageContent, isMinimalTrigger, truncateInjectionToBudget, } from './prompt-builder/index.js';
+// Prompt builder — empathy keyword matching (PRI-81 Phase A)
+export { matchEmpathyKeywords, createDefaultKeywordStore, applyKeywordUpdates, shouldTriggerOptimization, getKeywordStoreSummary, EMPATHY_SEED_KEYWORDS, DEFAULT_EMPATHY_KEYWORD_CONFIG, scoreToSeverity, severityToPenalty, normalizeSeverity, } from './prompt-builder/index.js';
+// Prompt builder — focus compression (PRI-81 Phase B)
+export { extractVersion, extractDate, extractSummary, parseWorkingMemorySection, workingMemoryToInjection, extractMilestones, validateCurrentFocus, mergeWorkingMemory, compressFocusContent, DEFAULT_FOCUS_COMPRESSION_OPTIONS, } from './prompt-builder/index.js';
+// TrajectoryStore — correction sample primitives (SAMPLES-01, SAMPLES-02)
+export { listCorrectionSamples, reviewCorrectionSample } from './trajectory-store.js';
+// Runtime v2 Foundation Contracts (M1)
+// Import via '@principles/core/runtime-v2' for the full contract set,
+// or import individual types and schemas from this barrel export.
+// Versioning + error categories
+export { RUNTIME_V2_SCHEMA_VERSION, schemaRef, SchemaVersionRefSchema, RuntimeV2SchemaVersionSchema, PDErrorCategorySchema, PD_ERROR_CATEGORIES, PDRuntimeError, isPDErrorCategory, } from './runtime-v2/index.js';
+// Agent specification schemas
+export { AGENT_IDS, AgentCapabilityRequirementsSchema, AgentTimeoutPolicySchema, AgentRetryPolicySchema, AgentSpecSchema, } from './runtime-v2/index.js';
+// Runtime protocol schemas
+export { RuntimeKindSchema, RuntimeCapabilitiesSchema, RuntimeHealthSchema, RunHandleSchema, RunExecutionStatusSchema, RunStatusSchema, ContextItemSchema, AgentSpecRefSchema, WorkflowRefSchema, TaskRefSchema, StartRunInputSchema, StructuredRunOutputSchema, RuntimeArtifactRefSchema, } from './runtime-v2/index.js';
+// Task status schemas
+export { PDTaskStatusSchema, TaskRecordSchema, DiagnosticianTaskRecordSchema, } from './runtime-v2/index.js';
+// Runtime selector schemas
+export { RuntimeSelectionCriteriaSchema, } from './runtime-v2/index.js';
+// Context payload schemas (Phase 2)
+export { HistoryQueryEntrySchema, TrajectoryLocateQuerySchema, TrajectoryCandidateSchema, TrajectoryLocateResultSchema, HistoryQueryResultSchema, DiagnosisTargetSchema, ContextPayloadSchema, DiagnosticianContextPayloadSchema, } from './runtime-v2/index.js';
+// Diagnostician output schemas (Phase 2)
+export { DiagnosticianViolatedPrincipleSchema, DiagnosticianEvidenceSchema, RecommendationKindSchema, DiagnosticianRecommendationSchema, DiagnosticianOutputV1Schema, DiagnosticianInvocationInputSchema, } from './runtime-v2/index.js';
+// Runtime integration layer
+export { RuntimeStateManager } from './runtime-v2/index.js';
+// Store exports (for pd-cli and openclaw-plugin direct usage)
+export { SqliteTaskStore, SqliteRunStore, SqliteConnection, SqliteTrajectoryLocator, SqliteSourceTraceLocator, SqliteHistoryQuery, SqliteContextAssembler, ResilientContextAssembler, ResilientHistoryQuery, DEFAULT_HISTORY_PAGE_SIZE, MAX_HISTORY_PAGE_SIZE, DEFAULT_TIME_WINDOW_MS, } from './runtime-v2/index.js';
+// Lease & Recovery
+export { DefaultLeaseManager } from './runtime-v2/index.js';
+export { DefaultRetryPolicy } from './runtime-v2/index.js';
+export { DefaultRecoverySweep } from './runtime-v2/index.js';
+// Event emitter
+export { StoreEventEmitter, storeEmitter } from './runtime-v2/index.js';
+// Workflow funnel loader
+export { WorkflowFunnelLoader } from './workflow-funnel-loader.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/io.d.ts

@@ -0,0 +1,36 @@
+/**
+ * I/O utilities for @principles/core SDK.
+ *
+ * Provides atomic file write operations that are crash-safe.
+ * No dependencies on openclaw-plugin — self-contained.
+ */
+/**
+ * AsyncQueueLock — lightweight in-process async queue lock.
+ * Serializes async operations on the same key within a single Node.js process.
+ * NOT a distributed lock — use for CLI-in-process concurrency only.
+ */
+export declare class AsyncQueueLock {
+    private readonly queues;
+    /**
+     * Execute a function while holding an exclusive lock on the given key.
+     * Uses a promise chain to serialize operations — only one operation runs at a time
+     * for any given key within this process.
+     *
+     * @param key - Lock key (e.g. file path to serialize)
+     * @param fn - Async function to execute
+     */
+    withLock<T>(key: string, fn: () => Promise<T>): Promise<T>;
+}
+export declare const painFlagLock: AsyncQueueLock;
+/**
+ * Atomic file write — write to temp file then rename.
+ *
+ * Prevents corruption if process crashes mid-write.
+ * On Windows, retries with exponential backoff on EPERM/EBUSY/EACCES
+ * to handle transient file locks.
+ *
+ * @param filePath - Target file path
+ * @param data - Content to write (UTF-8 string)
+ */
+export declare function atomicWriteFileSync(filePath: string, data: string): void;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAE3D;;;;;;;OAOG;IACG,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAkBjE;AAGD,eAAO,MAAM,YAAY,gBAAuB,CAAC;AAQjD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAiCxE"}

package/dist/io.js

@@ -0,0 +1,99 @@
+/**
+ * I/O utilities for @principles/core SDK.
+ *
+ * Provides atomic file write operations that are crash-safe.
+ * No dependencies on openclaw-plugin — self-contained.
+ */
+import * as fs from 'fs';
+/**
+ * AsyncQueueLock — lightweight in-process async queue lock.
+ * Serializes async operations on the same key within a single Node.js process.
+ * NOT a distributed lock — use for CLI-in-process concurrency only.
+ */
+export class AsyncQueueLock {
+    queues = new Map();
+    /**
+     * Execute a function while holding an exclusive lock on the given key.
+     * Uses a promise chain to serialize operations — only one operation runs at a time
+     * for any given key within this process.
+     *
+     * @param key - Lock key (e.g. file path to serialize)
+     * @param fn - Async function to execute
+     */
+    async withLock(key, fn) {
+        const lockPath = key;
+        // eslint-disable-next-line @typescript-eslint/init-declarations
+        let resolveRelease;
+        const releasePromise = new Promise(r => { resolveRelease = r; });
+        const previousQueue = this.queues.get(lockPath) || Promise.resolve();
+        const currentQueue = previousQueue.then(() => releasePromise);
+        this.queues.set(lockPath, currentQueue);
+        try {
+            await previousQueue;
+            return await fn();
+        }
+        finally {
+            resolveRelease?.();
+            if (this.queues.get(lockPath) === currentQueue) {
+                this.queues.delete(lockPath);
+            }
+        }
+    }
+}
+// Module-level singleton for recordPainSignal to use
+export const painFlagLock = new AsyncQueueLock();
+// Sync mutex: promise chain for synchronous code sections that need serialization.
+// Use for single-process CLI tools that need atomic file access within the same process.
+// NOT a distributed lock — each process gets its own chain on import.
+const RENAME_MAX_RETRIES = 3;
+const RENAME_BASE_DELAY_MS = 50;
+/**
+ * Atomic file write — write to temp file then rename.
+ *
+ * Prevents corruption if process crashes mid-write.
+ * On Windows, retries with exponential backoff on EPERM/EBUSY/EACCES
+ * to handle transient file locks.
+ *
+ * @param filePath - Target file path
+ * @param data - Content to write (UTF-8 string)
+ */
+export function atomicWriteFileSync(filePath, data) {
+    const tmpPath = filePath + '.tmp';
+    fs.writeFileSync(tmpPath, data, 'utf8');
+    // eslint-disable-next-line @typescript-eslint/init-declarations
+    let lastError;
+    for (let attempt = 0; attempt < RENAME_MAX_RETRIES; attempt++) {
+        try {
+            fs.renameSync(tmpPath, filePath);
+            return;
+        }
+        catch (err) {
+            lastError = err;
+            const { code } = /** @type {{ code?: string }} */ err;
+            // Only retry on Windows transient lock errors
+            if (code === 'EPERM' || code === 'EBUSY' || code === 'EACCES') {
+                if (attempt < RENAME_MAX_RETRIES - 1) {
+                    const delay = RENAME_BASE_DELAY_MS * Math.pow(2, attempt);
+                    // Synchronous sleep using a tight spin with accessSync yield
+                    const waitUntil = Date.now() + delay;
+                    while (Date.now() < waitUntil) {
+                        try {
+                            fs.accessSync?.(tmpPath);
+                        }
+                        catch { /* ignore */ }
+                    }
+                }
+                continue;
+            }
+            // Non-retryable error — throw immediately
+            break;
+        }
+    }
+    // Clean up temp file on failure
+    try {
+        fs.unlinkSync(tmpPath);
+    }
+    catch { /* best effort */ }
+    throw lastError ?? new Error('atomicWriteFileSync: rename failed');
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"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"}

package/dist/pain-flag-resolver.d.ts

@@ -0,0 +1,18 @@
+/**
+ * PainFlagPathResolver — Pure function for resolving pain flag file paths.
+ *
+ * D-04: resolvePainFlagPath(workspaceDir: string): string
+ *
+ * Usage:
+ *   import { resolvePainFlagPath } from '@principles/core';
+ *   const flagPath = resolvePainFlagPath('/path/to/workspace');
+ *   // => '/path/to/workspace/.state/.pain_flag'
+ */
+/**
+ * Resolve the absolute path to the .pain_flag file for a given workspace.
+ *
+ * @param workspaceDir - Absolute path to the workspace directory
+ * @returns The absolute path to the .pain_flag file
+ */
+export declare function resolvePainFlagPath(workspaceDir: string): string;
+//# sourceMappingURL=pain-flag-resolver.d.ts.map

package/dist/pain-flag-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pain-flag-resolver.d.ts","sourceRoot":"","sources":["../src/pain-flag-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhE"}