@principles/core 1.73.0

package/dist/telemetry-event.d.ts

@@ -0,0 +1,102 @@
+/**
+ * TelemetryEvent schema for the Evolution SDK.
+ *
+ * TypeBox schema describing the shape of in-process evolution events.
+ * Per D-07, this is a documentation artifact -- the existing EvolutionLogger
+ * output should conform to this schema. No new TelemetryService is created.
+ *
+ * Per D-08, covers the 3 core events aligned with EvolutionHook:
+ * - pain_detected (maps to EvolutionStage 'pain_detected')
+ * - principle_candidate_created (maps to EvolutionStage 'principle_generated')
+ * - principle_promoted (maps to EvolutionStage 'completed')
+ *
+ * Injection and storage events are out of scope for this phase.
+ */
+import { type Static } from '@sinclair/typebox';
+/**
+ * The 30+ telemetry event types: 3 core evolution + 8 M2 state transition + 1 M3 degradation + 8 M4 diagnostician + 3 M5 commit + 7 M6 runtime adapter.
+ *
+ * Core evolution events (aligned with EvolutionHook methods):
+ * - pain_detected -> EvolutionStage 'pain_detected'
+ * - principle_candidate_created -> EvolutionStage 'principle_generated'
+ * - principle_promoted -> EvolutionStage 'completed'
+ *
+ * M2 state transition events (task/run lifecycle):
+ * - lease_acquired, lease_released, lease_renewed, lease_expired
+ * - task_retried, task_failed, task_succeeded
+ * - run_started, run_completed
+ *
+ * M3 degradation events:
+ * - degradation_triggered — graceful degradation fallback activated
+ *
+ * M4 diagnostician runner events:
+ * - diagnostician_task_leased — runner acquired lease on a task
+ * - diagnostician_context_built — context assembly completed
+ * - diagnostician_run_started — runtime invocation started
+ * - diagnostician_run_failed — runtime execution failed
+ * - diagnostician_output_invalid — output validation failed
+ * - diagnostician_task_succeeded — task marked succeeded
+ * - diagnostician_task_retried — task sent to retry_wait
+ * - diagnostician_task_failed — task permanently failed
+ *
+ * M5: Artifact commit + candidate registration events:
+ * - diagnostician_artifact_committed — artifact + candidates committed successfully
+ * - diagnostician_artifact_commit_failed — commit attempt threw
+ * - principle_candidate_registered — individual candidate registered
+ *
+ * M6: Runtime adapter events:
+ * - runtime_adapter_selected — runtime adapter selected for invocation
+ * - runtime_invocation_started — runtime invocation started
+ * - runtime_invocation_succeeded — runtime invocation succeeded
+ * - runtime_invocation_failed — runtime invocation failed
+ * - output_validation_succeeded — output validation passed
+ * - output_validation_failed — output validation failed
+ * - output_repair_attempted — PRI-71 schema repair attempted (bounded by maxRepairAttempts)
+ * - output_extraction_failed — JSON extraction from LLM response failed (no parseable JSON found)
+ * - output_schema_invalid — PRI-200 schema validation failed (before repair)
+ * - output_repair_exhausted — PRI-200 repair loop exhausted, output still invalid
+ */
+export declare const TelemetryEventType: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"pain_detected">, import("@sinclair/typebox").TLiteral<"principle_candidate_created">, import("@sinclair/typebox").TLiteral<"principle_promoted">, import("@sinclair/typebox").TLiteral<"lease_acquired">, import("@sinclair/typebox").TLiteral<"lease_released">, import("@sinclair/typebox").TLiteral<"lease_renewed">, import("@sinclair/typebox").TLiteral<"lease_expired">, import("@sinclair/typebox").TLiteral<"task_retried">, import("@sinclair/typebox").TLiteral<"task_failed">, import("@sinclair/typebox").TLiteral<"task_succeeded">, import("@sinclair/typebox").TLiteral<"run_started">, import("@sinclair/typebox").TLiteral<"run_completed">, import("@sinclair/typebox").TLiteral<"degradation_triggered">, import("@sinclair/typebox").TLiteral<"diagnostician_task_leased">, import("@sinclair/typebox").TLiteral<"diagnostician_context_built">, import("@sinclair/typebox").TLiteral<"diagnostician_run_started">, import("@sinclair/typebox").TLiteral<"diagnostician_run_failed">, import("@sinclair/typebox").TLiteral<"diagnostician_output_invalid">, import("@sinclair/typebox").TLiteral<"diagnostician_task_succeeded">, import("@sinclair/typebox").TLiteral<"diagnostician_task_retried">, import("@sinclair/typebox").TLiteral<"diagnostician_task_failed">, import("@sinclair/typebox").TLiteral<"diagnostician_cancel_run_failed">, import("@sinclair/typebox").TLiteral<"diagnostician_mark_succeeded_failed">, import("@sinclair/typebox").TLiteral<"diagnostician_artifact_committed">, import("@sinclair/typebox").TLiteral<"diagnostician_artifact_commit_failed">, import("@sinclair/typebox").TLiteral<"principle_candidate_registered">, import("@sinclair/typebox").TLiteral<"runtime_adapter_selected">, import("@sinclair/typebox").TLiteral<"runtime_invocation_started">, import("@sinclair/typebox").TLiteral<"runtime_invocation_succeeded">, import("@sinclair/typebox").TLiteral<"runtime_invocation_failed">, import("@sinclair/typebox").TLiteral<"output_validation_succeeded">, import("@sinclair/typebox").TLiteral<"output_validation_failed">, import("@sinclair/typebox").TLiteral<"output_repair_attempted">, import("@sinclair/typebox").TLiteral<"output_extraction_failed">, import("@sinclair/typebox").TLiteral<"output_schema_invalid">, import("@sinclair/typebox").TLiteral<"output_repair_exhausted">, import("@sinclair/typebox").TLiteral<"output_path_chosen">, import("@sinclair/typebox").TLiteral<"output_path_fallback">, import("@sinclair/typebox").TLiteral<"dreamer_task_leased">, import("@sinclair/typebox").TLiteral<"dreamer_context_built">, import("@sinclair/typebox").TLiteral<"dreamer_run_started">, import("@sinclair/typebox").TLiteral<"dreamer_run_failed">, import("@sinclair/typebox").TLiteral<"dreamer_output_invalid">, import("@sinclair/typebox").TLiteral<"dreamer_output_validated">, import("@sinclair/typebox").TLiteral<"dreamer_task_succeeded">, import("@sinclair/typebox").TLiteral<"dreamer_task_retried">, import("@sinclair/typebox").TLiteral<"dreamer_task_failed">, import("@sinclair/typebox").TLiteral<"dreamer_candidate_generated">, import("@sinclair/typebox").TLiteral<"dreamer_cancel_run_failed">, import("@sinclair/typebox").TLiteral<"dreamer_mark_succeeded_failed">, import("@sinclair/typebox").TLiteral<"dreamer_update_output_failed">, import("@sinclair/typebox").TLiteral<"dreamer_context_partial">, import("@sinclair/typebox").TLiteral<"dreamer_mark_failed_error">, import("@sinclair/typebox").TLiteral<"dreamer_mark_retry_error">]>;
+export type TelemetryEventType = Static<typeof TelemetryEventType>;
+/**
+ * Schema for an in-process telemetry event.
+ *
+ * Fields align with existing EvolutionLogEntry:
+ * - traceId <-> EvolutionLogEntry.traceId
+ * - timestamp <-> EvolutionLogEntry.timestamp
+ * - sessionId <-> EvolutionLogEntry.sessionId
+ * - payload <-> EvolutionLogEntry.metadata
+ *
+ * No PII fields. The agentId field is optional and contains only
+ * system identifiers (e.g., 'main', 'builder'), never user data.
+ */
+export declare const TelemetryEventSchema: import("@sinclair/typebox").TObject<{
+    /** Event type (one of the 3 core types) */
+    eventType: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"pain_detected">, import("@sinclair/typebox").TLiteral<"principle_candidate_created">, import("@sinclair/typebox").TLiteral<"principle_promoted">, import("@sinclair/typebox").TLiteral<"lease_acquired">, import("@sinclair/typebox").TLiteral<"lease_released">, import("@sinclair/typebox").TLiteral<"lease_renewed">, import("@sinclair/typebox").TLiteral<"lease_expired">, import("@sinclair/typebox").TLiteral<"task_retried">, import("@sinclair/typebox").TLiteral<"task_failed">, import("@sinclair/typebox").TLiteral<"task_succeeded">, import("@sinclair/typebox").TLiteral<"run_started">, import("@sinclair/typebox").TLiteral<"run_completed">, import("@sinclair/typebox").TLiteral<"degradation_triggered">, import("@sinclair/typebox").TLiteral<"diagnostician_task_leased">, import("@sinclair/typebox").TLiteral<"diagnostician_context_built">, import("@sinclair/typebox").TLiteral<"diagnostician_run_started">, import("@sinclair/typebox").TLiteral<"diagnostician_run_failed">, import("@sinclair/typebox").TLiteral<"diagnostician_output_invalid">, import("@sinclair/typebox").TLiteral<"diagnostician_task_succeeded">, import("@sinclair/typebox").TLiteral<"diagnostician_task_retried">, import("@sinclair/typebox").TLiteral<"diagnostician_task_failed">, import("@sinclair/typebox").TLiteral<"diagnostician_cancel_run_failed">, import("@sinclair/typebox").TLiteral<"diagnostician_mark_succeeded_failed">, import("@sinclair/typebox").TLiteral<"diagnostician_artifact_committed">, import("@sinclair/typebox").TLiteral<"diagnostician_artifact_commit_failed">, import("@sinclair/typebox").TLiteral<"principle_candidate_registered">, import("@sinclair/typebox").TLiteral<"runtime_adapter_selected">, import("@sinclair/typebox").TLiteral<"runtime_invocation_started">, import("@sinclair/typebox").TLiteral<"runtime_invocation_succeeded">, import("@sinclair/typebox").TLiteral<"runtime_invocation_failed">, import("@sinclair/typebox").TLiteral<"output_validation_succeeded">, import("@sinclair/typebox").TLiteral<"output_validation_failed">, import("@sinclair/typebox").TLiteral<"output_repair_attempted">, import("@sinclair/typebox").TLiteral<"output_extraction_failed">, import("@sinclair/typebox").TLiteral<"output_schema_invalid">, import("@sinclair/typebox").TLiteral<"output_repair_exhausted">, import("@sinclair/typebox").TLiteral<"output_path_chosen">, import("@sinclair/typebox").TLiteral<"output_path_fallback">, import("@sinclair/typebox").TLiteral<"dreamer_task_leased">, import("@sinclair/typebox").TLiteral<"dreamer_context_built">, import("@sinclair/typebox").TLiteral<"dreamer_run_started">, import("@sinclair/typebox").TLiteral<"dreamer_run_failed">, import("@sinclair/typebox").TLiteral<"dreamer_output_invalid">, import("@sinclair/typebox").TLiteral<"dreamer_output_validated">, import("@sinclair/typebox").TLiteral<"dreamer_task_succeeded">, import("@sinclair/typebox").TLiteral<"dreamer_task_retried">, import("@sinclair/typebox").TLiteral<"dreamer_task_failed">, import("@sinclair/typebox").TLiteral<"dreamer_candidate_generated">, import("@sinclair/typebox").TLiteral<"dreamer_cancel_run_failed">, import("@sinclair/typebox").TLiteral<"dreamer_mark_succeeded_failed">, import("@sinclair/typebox").TLiteral<"dreamer_update_output_failed">, import("@sinclair/typebox").TLiteral<"dreamer_context_partial">, import("@sinclair/typebox").TLiteral<"dreamer_mark_failed_error">, import("@sinclair/typebox").TLiteral<"dreamer_mark_retry_error">]>;
+    /** Correlation trace ID for linking events across the pipeline */
+    traceId: import("@sinclair/typebox").TString;
+    /** ISO 8601 timestamp */
+    timestamp: import("@sinclair/typebox").TString;
+    /** Session identifier */
+    sessionId: import("@sinclair/typebox").TString;
+    /** Agent identifier (system identifier only, no PII) */
+    agentId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    /** Event-specific payload */
+    payload: import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>;
+}>;
+export type TelemetryEvent = Static<typeof TelemetryEventSchema>;
+export interface TelemetryEventValidationResult {
+    valid: boolean;
+    errors: string[];
+    event?: TelemetryEvent;
+}
+/**
+ * Validates an arbitrary object against the TelemetryEvent schema.
+ *
+ * Returns a structured result with:
+ * - `valid`: whether the input conforms to the schema
+ * - `errors`: human-readable list of validation failures
+ * - `event`: the typed event (only present when valid)
+ */
+export declare function validateTelemetryEvent(input: unknown): TelemetryEventValidationResult;
+//# sourceMappingURL=telemetry-event.d.ts.map

package/dist/telemetry-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-event.d.ts","sourceRoot":"","sources":["../src/telemetry-event.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAOtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,kBAAkB,g8GA8D7B,CAAC;AAGH,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAMnE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB;IAC/B,2CAA2C;;IAE3C,kEAAkE;;IAElE,yBAAyB;;IAEzB,yBAAyB;;IAEzB,wDAAwD;;IAExD,6BAA6B;;EAE7B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMjE,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,8BAA8B,CA8BrF"}

package/dist/telemetry-event.js

@@ -0,0 +1,186 @@
+/**
+ * TelemetryEvent schema for the Evolution SDK.
+ *
+ * TypeBox schema describing the shape of in-process evolution events.
+ * Per D-07, this is a documentation artifact -- the existing EvolutionLogger
+ * output should conform to this schema. No new TelemetryService is created.
+ *
+ * Per D-08, covers the 3 core events aligned with EvolutionHook:
+ * - pain_detected (maps to EvolutionStage 'pain_detected')
+ * - principle_candidate_created (maps to EvolutionStage 'principle_generated')
+ * - principle_promoted (maps to EvolutionStage 'completed')
+ *
+ * Injection and storage events are out of scope for this phase.
+ */
+import { Type } from '@sinclair/typebox';
+import { Value } from '@sinclair/typebox/value';
+// ---------------------------------------------------------------------------
+// Event Type Union
+// ---------------------------------------------------------------------------
+/**
+ * The 30+ telemetry event types: 3 core evolution + 8 M2 state transition + 1 M3 degradation + 8 M4 diagnostician + 3 M5 commit + 7 M6 runtime adapter.
+ *
+ * Core evolution events (aligned with EvolutionHook methods):
+ * - pain_detected -> EvolutionStage 'pain_detected'
+ * - principle_candidate_created -> EvolutionStage 'principle_generated'
+ * - principle_promoted -> EvolutionStage 'completed'
+ *
+ * M2 state transition events (task/run lifecycle):
+ * - lease_acquired, lease_released, lease_renewed, lease_expired
+ * - task_retried, task_failed, task_succeeded
+ * - run_started, run_completed
+ *
+ * M3 degradation events:
+ * - degradation_triggered — graceful degradation fallback activated
+ *
+ * M4 diagnostician runner events:
+ * - diagnostician_task_leased — runner acquired lease on a task
+ * - diagnostician_context_built — context assembly completed
+ * - diagnostician_run_started — runtime invocation started
+ * - diagnostician_run_failed — runtime execution failed
+ * - diagnostician_output_invalid — output validation failed
+ * - diagnostician_task_succeeded — task marked succeeded
+ * - diagnostician_task_retried — task sent to retry_wait
+ * - diagnostician_task_failed — task permanently failed
+ *
+ * M5: Artifact commit + candidate registration events:
+ * - diagnostician_artifact_committed — artifact + candidates committed successfully
+ * - diagnostician_artifact_commit_failed — commit attempt threw
+ * - principle_candidate_registered — individual candidate registered
+ *
+ * M6: Runtime adapter events:
+ * - runtime_adapter_selected — runtime adapter selected for invocation
+ * - runtime_invocation_started — runtime invocation started
+ * - runtime_invocation_succeeded — runtime invocation succeeded
+ * - runtime_invocation_failed — runtime invocation failed
+ * - output_validation_succeeded — output validation passed
+ * - output_validation_failed — output validation failed
+ * - output_repair_attempted — PRI-71 schema repair attempted (bounded by maxRepairAttempts)
+ * - output_extraction_failed — JSON extraction from LLM response failed (no parseable JSON found)
+ * - output_schema_invalid — PRI-200 schema validation failed (before repair)
+ * - output_repair_exhausted — PRI-200 repair loop exhausted, output still invalid
+ */
+export const TelemetryEventType = Type.Union([
+    Type.Literal('pain_detected'),
+    Type.Literal('principle_candidate_created'),
+    Type.Literal('principle_promoted'),
+    // M2: Task/Run state transition events
+    Type.Literal('lease_acquired'),
+    Type.Literal('lease_released'),
+    Type.Literal('lease_renewed'),
+    Type.Literal('lease_expired'),
+    Type.Literal('task_retried'),
+    Type.Literal('task_failed'),
+    Type.Literal('task_succeeded'),
+    Type.Literal('run_started'),
+    Type.Literal('run_completed'),
+    // M3: Degradation events
+    Type.Literal('degradation_triggered'),
+    // M4: Diagnostician runner events
+    Type.Literal('diagnostician_task_leased'),
+    Type.Literal('diagnostician_context_built'),
+    Type.Literal('diagnostician_run_started'),
+    Type.Literal('diagnostician_run_failed'),
+    Type.Literal('diagnostician_output_invalid'),
+    Type.Literal('diagnostician_task_succeeded'),
+    Type.Literal('diagnostician_task_retried'),
+    Type.Literal('diagnostician_task_failed'),
+    Type.Literal('diagnostician_cancel_run_failed'),
+    Type.Literal('diagnostician_mark_succeeded_failed'),
+    // M5: Artifact commit events
+    Type.Literal('diagnostician_artifact_committed'),
+    Type.Literal('diagnostician_artifact_commit_failed'),
+    Type.Literal('principle_candidate_registered'),
+    // M6: Runtime adapter events
+    Type.Literal('runtime_adapter_selected'),
+    Type.Literal('runtime_invocation_started'),
+    Type.Literal('runtime_invocation_succeeded'),
+    Type.Literal('runtime_invocation_failed'),
+    Type.Literal('output_validation_succeeded'),
+    Type.Literal('output_validation_failed'),
+    Type.Literal('output_repair_attempted'),
+    Type.Literal('output_extraction_failed'),
+    Type.Literal('output_schema_invalid'),
+    Type.Literal('output_repair_exhausted'),
+    // PRI-271: Weak-model output path events
+    Type.Literal('output_path_chosen'),
+    Type.Literal('output_path_fallback'),
+    // PRI-67: Dreamer runner events
+    Type.Literal('dreamer_task_leased'),
+    Type.Literal('dreamer_context_built'),
+    Type.Literal('dreamer_run_started'),
+    Type.Literal('dreamer_run_failed'),
+    Type.Literal('dreamer_output_invalid'),
+    Type.Literal('dreamer_output_validated'),
+    Type.Literal('dreamer_task_succeeded'),
+    Type.Literal('dreamer_task_retried'),
+    Type.Literal('dreamer_task_failed'),
+    Type.Literal('dreamer_candidate_generated'),
+    Type.Literal('dreamer_cancel_run_failed'),
+    Type.Literal('dreamer_mark_succeeded_failed'),
+    Type.Literal('dreamer_update_output_failed'),
+    Type.Literal('dreamer_context_partial'),
+    Type.Literal('dreamer_mark_failed_error'),
+    Type.Literal('dreamer_mark_retry_error'),
+]);
+// ---------------------------------------------------------------------------
+// TelemetryEvent Schema
+// ---------------------------------------------------------------------------
+/**
+ * Schema for an in-process telemetry event.
+ *
+ * Fields align with existing EvolutionLogEntry:
+ * - traceId <-> EvolutionLogEntry.traceId
+ * - timestamp <-> EvolutionLogEntry.timestamp
+ * - sessionId <-> EvolutionLogEntry.sessionId
+ * - payload <-> EvolutionLogEntry.metadata
+ *
+ * No PII fields. The agentId field is optional and contains only
+ * system identifiers (e.g., 'main', 'builder'), never user data.
+ */
+export const TelemetryEventSchema = Type.Object({
+    /** Event type (one of the 3 core types) */
+    eventType: TelemetryEventType,
+    /** Correlation trace ID for linking events across the pipeline */
+    traceId: Type.String({ minLength: 1 }),
+    /** ISO 8601 timestamp */
+    timestamp: Type.String({ minLength: 1 }),
+    /** Session identifier */
+    sessionId: Type.String(),
+    /** Agent identifier (system identifier only, no PII) */
+    agentId: Type.Optional(Type.String()),
+    /** Event-specific payload */
+    payload: Type.Record(Type.String(), Type.Unknown()),
+});
+/**
+ * Validates an arbitrary object against the TelemetryEvent schema.
+ *
+ * Returns a structured result with:
+ * - `valid`: whether the input conforms to the schema
+ * - `errors`: human-readable list of validation failures
+ * - `event`: the typed event (only present when valid)
+ */
+export function validateTelemetryEvent(input) {
+    if (typeof input !== 'object' || input === null || Array.isArray(input)) {
+        return { valid: false, errors: ['Input must be a non-null object'] };
+    }
+    const raw = input;
+    // Validate ISO 8601 timestamp format
+    if (typeof raw.timestamp === 'string' &&
+        isNaN(Date.parse(raw.timestamp))) {
+        return { valid: false, errors: ['timestamp must be a valid ISO 8601 date string'] };
+    }
+    const errors = [...Value.Errors(TelemetryEventSchema, input)];
+    if (errors.length > 0) {
+        return {
+            valid: false,
+            errors: errors.map((e) => `${e.path ? `${e.path}: ` : ''}${e.message}`),
+        };
+    }
+    return {
+        valid: true,
+        errors: [],
+        event: Value.Cast(TelemetryEventSchema, input),
+    };
+}
+//# sourceMappingURL=telemetry-event.js.map

package/dist/telemetry-event.js.map

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

package/dist/trajectory-store.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Trajectory Store — correction sample primitives for SDK use.
+ *
+ * Extracts listCorrectionSamples and reviewCorrectionSample from TrajectoryDatabase
+ * as pure functions that can be used without openclaw-plugin dependency.
+ *
+ * @example
+ * import { listCorrectionSamples, reviewCorrectionSample } from '@principles/core/trajectory-store';
+ */
+export type CorrectionSampleReviewStatus = 'pending' | 'approved' | 'rejected';
+export type CorrectionExportMode = 'raw' | 'redacted';
+export interface CorrectionSampleRecord {
+    sampleId: string;
+    sessionId: string;
+    badAssistantTurnId: number;
+    userCorrectionTurnId: number;
+    recoveryToolSpanJson: string;
+    diffExcerpt: string;
+    principleIdsJson: string;
+    qualityScore: number;
+    reviewStatus: CorrectionSampleReviewStatus;
+    exportMode: CorrectionExportMode;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * List correction samples by review status.
+ *
+ * @param workspaceDir - The workspace directory (DB path: {workspaceDir}/.state/.trajectory.db)
+ * @param status - Filter by review status (default: 'pending')
+ * @returns Array of CorrectionSampleRecord, or empty array if DB does not exist
+ */
+export declare function listCorrectionSamples(workspaceDir: string, status?: CorrectionSampleReviewStatus): CorrectionSampleRecord[];
+/**
+ * Review a correction sample (approve or reject).
+ *
+ * @param sampleId - The sample ID to review
+ * @param decision - 'approved' or 'rejected'
+ * @param note - Optional review note
+ * @param workspaceDir - The workspace directory (DB path: {workspaceDir}/.state/.trajectory.db)
+ * @returns The updated CorrectionSampleRecord
+ * @throws Error if the sample is not found or DB cannot be opened
+ */
+export declare function reviewCorrectionSample(sampleId: string, decision: 'approved' | 'rejected', note: string | undefined, workspaceDir: string): CorrectionSampleRecord;
+//# sourceMappingURL=trajectory-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trajectory-store.d.ts","sourceRoot":"","sources":["../src/trajectory-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/E,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,UAAU,CAAC;AAEtD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,4BAA4B,CAAC;IAC3C,UAAU,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAkBD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,MAAM,GAAE,4BAAwC,GAC/C,sBAAsB,EAAE,CA2C1B;AAED;;;;;;;;;GASG;AAEH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,UAAU,GAAG,UAAU,EACjC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,YAAY,EAAE,MAAM,GACnB,sBAAsB,CA0DxB"}

package/dist/trajectory-store.js

@@ -0,0 +1,139 @@
+/**
+ * Trajectory Store — correction sample primitives for SDK use.
+ *
+ * Extracts listCorrectionSamples and reviewCorrectionSample from TrajectoryDatabase
+ * as pure functions that can be used without openclaw-plugin dependency.
+ *
+ * @example
+ * import { listCorrectionSamples, reviewCorrectionSample } from '@principles/core/trajectory-store';
+ */
+import Database from 'better-sqlite3';
+import { join } from 'path';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function nowIso() {
+    return new Date().toISOString();
+}
+function getDbPath(workspaceDir) {
+    return join(workspaceDir, '.state', '.trajectory.db');
+}
+// ---------------------------------------------------------------------------
+// Core functions
+// ---------------------------------------------------------------------------
+/**
+ * List correction samples by review status.
+ *
+ * @param workspaceDir - The workspace directory (DB path: {workspaceDir}/.state/.trajectory.db)
+ * @param status - Filter by review status (default: 'pending')
+ * @returns Array of CorrectionSampleRecord, or empty array if DB does not exist
+ */
+export function listCorrectionSamples(workspaceDir, status = 'pending') {
+    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 rows = db.prepare(`
+      SELECT sample_id, session_id, bad_assistant_turn_id, user_correction_turn_id,
+             recovery_tool_span_json, diff_excerpt, principle_ids_json, quality_score,
+             review_status, export_mode, created_at, updated_at
+      FROM correction_samples
+      WHERE review_status = ?
+      ORDER BY created_at DESC
+    `).all(status);
+        return rows.map((row) => ({
+            sampleId: String(row.sample_id),
+            sessionId: String(row.session_id),
+            badAssistantTurnId: Number(row.bad_assistant_turn_id),
+            userCorrectionTurnId: Number(row.user_correction_turn_id),
+            recoveryToolSpanJson: String(row.recovery_tool_span_json ?? ''),
+            diffExcerpt: String(row.diff_excerpt ?? ''),
+            principleIdsJson: String(row.principle_ids_json ?? '[]'),
+            qualityScore: Number(row.quality_score),
+            reviewStatus: row.review_status,
+            exportMode: row.export_mode,
+            createdAt: String(row.created_at),
+            updatedAt: String(row.updated_at),
+        }));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[PD:TrajectoryStore] Failed to list correction samples: ${msg}`);
+        return [];
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Review a correction sample (approve or reject).
+ *
+ * @param sampleId - The sample ID to review
+ * @param decision - 'approved' or 'rejected'
+ * @param note - Optional review note
+ * @param workspaceDir - The workspace directory (DB path: {workspaceDir}/.state/.trajectory.db)
+ * @returns The updated CorrectionSampleRecord
+ * @throws Error if the sample is not found or DB cannot be opened
+ */
+// eslint-disable-next-line @typescript-eslint/max-params
+export function reviewCorrectionSample(sampleId, decision, note, workspaceDir) {
+    const dbPath = getDbPath(workspaceDir);
+    // eslint-disable-next-line @typescript-eslint/init-declarations
+    let db;
+    try {
+        db = new Database(dbPath);
+    }
+    catch {
+        throw new Error(`Database not found or cannot be opened: ${dbPath}`);
+    }
+    const updatedAt = nowIso();
+    try {
+        const updateResult = db.prepare(`
+      UPDATE correction_samples
+      SET review_status = ?, updated_at = ?
+      WHERE sample_id = ?
+    `).run(decision, updatedAt, sampleId);
+        if (updateResult.changes === 0) {
+            throw new Error(`Sample not found: ${sampleId}`);
+        }
+        db.prepare(`
+      INSERT INTO sample_reviews (sample_id, review_status, note, created_at)
+      VALUES (?, ?, ?, ?)
+    `).run(sampleId, decision, note ?? null, updatedAt);
+        const record = db.prepare(`
+      SELECT sample_id, session_id, bad_assistant_turn_id, user_correction_turn_id,
+             recovery_tool_span_json, diff_excerpt, principle_ids_json, quality_score,
+             review_status, export_mode, created_at, updated_at
+      FROM correction_samples
+      WHERE sample_id = ?
+    `).get(sampleId);
+        if (!record) {
+            throw new Error(`Sample not found after update: ${sampleId}`);
+        }
+        return {
+            sampleId: String(record.sample_id),
+            sessionId: String(record.session_id),
+            badAssistantTurnId: Number(record.bad_assistant_turn_id),
+            userCorrectionTurnId: Number(record.user_correction_turn_id),
+            recoveryToolSpanJson: String(record.recovery_tool_span_json ?? ''),
+            diffExcerpt: String(record.diff_excerpt ?? ''),
+            principleIdsJson: String(record.principle_ids_json ?? '[]'),
+            qualityScore: Number(record.quality_score),
+            reviewStatus: record.review_status,
+            exportMode: record.export_mode,
+            createdAt: String(record.created_at),
+            updatedAt: String(record.updated_at),
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=trajectory-store.js.map

package/dist/trajectory-store.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,10 @@
+/**
+ * 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

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

package/dist/types.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,16 @@
+/**
+ * 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

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