@principles/core 1.73.0

package/dist/runtime-v2/schema-conformance-read-model.js

@@ -0,0 +1,178 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import Database from 'better-sqlite3';
+const EXPECTED_SCHEMA = {
+    tasks: {
+        columns: [
+            'task_id', 'task_kind', 'status', 'created_at', 'updated_at',
+            'lease_owner', 'lease_expires_at', 'attempt_count', 'max_attempts',
+            'last_error', 'input_ref', 'result_ref', 'diagnostic_json',
+        ],
+        indexes: [
+            'idx_tasks_status', 'idx_tasks_created_at', 'idx_tasks_task_kind',
+            'idx_tasks_lease_expires_at', 'idx_tasks_session_id_hint',
+        ],
+    },
+    runs: {
+        columns: [
+            'run_id', 'task_id', 'runtime_kind', 'execution_status', 'started_at',
+            'ended_at', 'reason', 'output_ref', 'input_payload', 'output_payload',
+            'error_category', 'attempt_number', 'created_at', 'updated_at',
+        ],
+        indexes: [
+            'idx_runs_task_id', 'idx_runs_status', 'idx_runs_started_at',
+        ],
+    },
+    artifacts: {
+        columns: [
+            'artifact_id', 'run_id', 'task_id', 'artifact_kind', 'content_json', 'created_at',
+        ],
+        indexes: [
+            'idx_artifacts_task_id', 'idx_artifacts_run_id', 'idx_artifacts_artifact_kind',
+        ],
+    },
+    commits: {
+        columns: [
+            'commit_id', 'task_id', 'run_id', 'artifact_id', 'idempotency_key', 'status', 'created_at',
+        ],
+        indexes: [
+            'idx_commits_task_id', 'idx_commits_artifact_id',
+        ],
+    },
+    principle_candidates: {
+        columns: [
+            'candidate_id', 'artifact_id', 'task_id', 'source_run_id', 'title', 'description',
+            'confidence', 'source_recommendation_json', 'idempotency_key', 'status', 'created_at',
+            'consumed_at', 'recommendation_kind', 'trigger_pattern', 'action', 'abstracted_principle',
+        ],
+        indexes: [
+            'idx_candidates_status', 'idx_candidates_source_run_id',
+            'idx_candidates_task_id', 'idx_candidates_recommendation_kind',
+        ],
+    },
+    pi_artifacts: {
+        columns: [
+            'artifact_id', 'artifact_kind', 'source_task_id', 'source_principle_id',
+            'source_rule_id', 'lineage_artifact_ids', 'validation_status', 'content_json',
+            'created_at', 'updated_at',
+        ],
+        indexes: [
+            'idx_pi_artifacts_source_task_id', 'idx_pi_artifacts_artifact_kind',
+            'idx_pi_artifacts_idempotency',
+        ],
+    },
+};
+const COLUMN_MIGRATION_MAP = {
+    recommendation_kind: 'add_recommendation_kind',
+    trigger_pattern: 'add_trigger_pattern',
+    action: 'add_action',
+    abstracted_principle: 'add_abstracted_principle',
+};
+export class SchemaConformanceReadModel {
+    dbPath;
+    constructor(opts) {
+        this.dbPath = path.join(opts.workspaceDir, '.pd', 'state.db');
+    }
+    check() {
+        const generatedAt = new Date().toISOString();
+        const tables = {};
+        const missingIndexes = [];
+        const migrationsNeeded = [];
+        if (!fs.existsSync(this.dbPath)) {
+            for (const tableName of Object.keys(EXPECTED_SCHEMA)) {
+                const expected = EXPECTED_SCHEMA[tableName];
+                tables[tableName] = { exists: false, missingColumns: (expected ?? { columns: [] }).columns.slice() };
+            }
+            return {
+                overallStatus: 'error',
+                checkedDatabasePath: this.dbPath,
+                tables,
+                indexes: { missingIndexes: Object.values(EXPECTED_SCHEMA).flatMap(t => t.indexes) },
+                migrationsNeeded: ['initialize_database'],
+                generatedAt,
+            };
+        }
+        let db = null;
+        try {
+            db = new Database(this.dbPath, { readonly: true });
+            for (const [tableName, expected] of Object.entries(EXPECTED_SCHEMA)) {
+                const tableInfo = db.prepare(`PRAGMA table_info(${tableName})`).all();
+                const existingColumns = new Set(tableInfo.map(c => c.name));
+                if (tableInfo.length === 0) {
+                    tables[tableName] = {
+                        exists: false,
+                        missingColumns: expected.columns,
+                        extraInfo: 'Table does not exist',
+                    };
+                    missingIndexes.push(...expected.indexes);
+                    migrationsNeeded.push(`create_table_${tableName}`);
+                    continue;
+                }
+                const missingCols = expected.columns.filter(c => !existingColumns.has(c));
+                tables[tableName] = {
+                    exists: true,
+                    missingColumns: missingCols,
+                };
+                for (const col of missingCols) {
+                    const migrationKey = COLUMN_MIGRATION_MAP[col];
+                    if (migrationKey)
+                        migrationsNeeded.push(migrationKey);
+                }
+                const indexList = db.pragma(`index_list(${tableName})`);
+                const existingIndexNames = new Set(indexList.map(i => i.name));
+                for (const idx of expected.indexes) {
+                    if (!existingIndexNames.has(idx)) {
+                        missingIndexes.push(idx);
+                    }
+                }
+            }
+        }
+        catch {
+            for (const tableName of Object.keys(EXPECTED_SCHEMA)) {
+                if (!tables[tableName]) {
+                    const expected = EXPECTED_SCHEMA[tableName];
+                    tables[tableName] = {
+                        exists: false,
+                        missingColumns: (expected ?? { columns: [] }).columns,
+                        extraInfo: 'Database read error',
+                    };
+                }
+            }
+            return {
+                overallStatus: 'error',
+                checkedDatabasePath: this.dbPath,
+                tables,
+                indexes: { missingIndexes: Object.values(EXPECTED_SCHEMA).flatMap(t => t.indexes) },
+                migrationsNeeded: ['initialize_database'],
+                generatedAt,
+            };
+        }
+        finally {
+            if (db) {
+                try {
+                    db.close();
+                }
+                catch { /* ignore */ }
+            }
+        }
+        const hasMissingTables = Object.values(tables).some(t => !t.exists);
+        const hasMissingColumns = Object.values(tables).some(t => t.missingColumns.length > 0);
+        const hasMissingIndexes = missingIndexes.length > 0;
+        let overallStatus = 'ok';
+        if (hasMissingTables) {
+            overallStatus = 'error';
+        }
+        else if (hasMissingColumns || hasMissingIndexes) {
+            overallStatus = 'degraded';
+        }
+        return {
+            overallStatus,
+            checkedDatabasePath: this.dbPath,
+            tables,
+            indexes: { missingIndexes },
+            migrationsNeeded,
+            generatedAt,
+        };
+    }
+}
+//# sourceMappingURL=schema-conformance-read-model.js.map

package/dist/runtime-v2/schema-conformance-read-model.js.map

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

package/dist/runtime-v2/schema-version.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Schema versioning mechanism for PD Runtime v2 contracts.
+ *
+ * Each versioned contract carries a `schemaVersion` field so that
+ * evolution is explicit and detectable at runtime.
+ *
+ * Source: PD Runtime Protocol SPEC v1, Section 11.3
+ */
+import { type Static } from '@sinclair/typebox';
+/** Current schema version for all runtime-v2 contracts. */
+export declare const RUNTIME_V2_SCHEMA_VERSION = "1.0.0";
+/** Version prefix used in schema refs (e.g., "diagnostician-output-v1"). */
+export declare function schemaRef(kind: string, version: number): string;
+/** TypeBox schema for versioned schema references (format: "kind-vN"). */
+export declare const SchemaVersionRefSchema: import("@sinclair/typebox").TString;
+export type SchemaVersionRef = Static<typeof SchemaVersionRefSchema>;
+/** TypeBox literal schema for the current runtime-v2 schema version. */
+export declare const RuntimeV2SchemaVersionSchema: import("@sinclair/typebox").TLiteral<"1.0.0">;
+export type RuntimeV2SchemaVersion = Static<typeof RuntimeV2SchemaVersionSchema>;
+//# sourceMappingURL=schema-version.d.ts.map

package/dist/runtime-v2/schema-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/schema-version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEtD,2DAA2D;AAC3D,eAAO,MAAM,yBAAyB,UAAU,CAAC;AAEjD,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,qCAAgB,CAAC;AACpD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAErE,wEAAwE;AACxE,eAAO,MAAM,4BAA4B,+CAAwB,CAAC;AAClE,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/runtime-v2/schema-version.js

@@ -0,0 +1,20 @@
+/**
+ * Schema versioning mechanism for PD Runtime v2 contracts.
+ *
+ * Each versioned contract carries a `schemaVersion` field so that
+ * evolution is explicit and detectable at runtime.
+ *
+ * Source: PD Runtime Protocol SPEC v1, Section 11.3
+ */
+import { Type } from '@sinclair/typebox';
+/** Current schema version for all runtime-v2 contracts. */
+export const RUNTIME_V2_SCHEMA_VERSION = '1.0.0';
+/** Version prefix used in schema refs (e.g., "diagnostician-output-v1"). */
+export function schemaRef(kind, version) {
+    return `${kind}-v${version}`;
+}
+/** TypeBox schema for versioned schema references (format: "kind-vN"). */
+export const SchemaVersionRefSchema = Type.String();
+/** TypeBox literal schema for the current runtime-v2 schema version. */
+export const RuntimeV2SchemaVersionSchema = Type.Literal('1.0.0');
+//# sourceMappingURL=schema-version.js.map

package/dist/runtime-v2/schema-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.js","sourceRoot":"","sources":["../../src/runtime-v2/schema-version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAEtD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAO,CAAC;AAEjD,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe;IACrD,OAAO,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC;AAC/B,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;AAGpD,wEAAwE;AACxE,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC"}

package/dist/runtime-v2/store/artifact/artifact-store.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ArtifactStore — abstract interface for artifact queries.
+ */
+import type { CandidateRecord } from '../candidate/candidate-store.js';
+export type { CandidateRecord } from '../candidate/candidate-store.js';
+export interface ArtifactRecord {
+    artifactId: string;
+    runId: string;
+    taskId: string;
+    artifactKind: string;
+    contentJson: string;
+    createdAt: string;
+}
+export interface ArtifactWithCandidates {
+    artifact: ArtifactRecord;
+    candidates: CandidateRecord[];
+}
+export interface ArtifactStore {
+    /**
+     * Returns a single artifact by ID, or null if not found.
+     */
+    getArtifact(artifactId: string): Promise<ArtifactRecord | null>;
+    /**
+     * Returns an artifact with its inline candidate array, or null if artifact not found.
+     */
+    getArtifactWithCandidates(artifactId: string): Promise<ArtifactWithCandidates | null>;
+}
+//# sourceMappingURL=artifact-store.d.ts.map

package/dist/runtime-v2/store/artifact/artifact-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/store/artifact/artifact-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGvE,YAAY,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAEhE;;OAEG;IACH,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;CACvF"}

package/dist/runtime-v2/store/artifact/artifact-store.js

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

package/dist/runtime-v2/store/artifact/artifact-store.js.map

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

package/dist/runtime-v2/store/artifact/index.d.ts

@@ -0,0 +1,4 @@
+export type { ArtifactRecord, ArtifactWithCandidates, ArtifactStore } from './artifact-store.js';
+export { SqliteArtifactStore } from './sqlite-artifact-store.js';
+export { MemoryArtifactStore } from './memory-artifact-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime-v2/store/artifact/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/store/artifact/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/runtime-v2/store/artifact/index.js

@@ -0,0 +1,3 @@
+export { SqliteArtifactStore } from './sqlite-artifact-store.js';
+export { MemoryArtifactStore } from './memory-artifact-store.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime-v2/store/artifact/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime-v2/store/artifact/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/runtime-v2/store/artifact/memory-artifact-store.d.ts

@@ -0,0 +1,14 @@
+/**
+ * ArtifactStore — in-memory test double using a Map.
+ */
+import type { ArtifactRecord, ArtifactWithCandidates, ArtifactStore } from './artifact-store.js';
+import type { CandidateRecord } from '../candidate/candidate-store.js';
+export declare class MemoryArtifactStore implements ArtifactStore {
+    private readonly artifacts;
+    private readonly candidatesByArtifact;
+    getArtifact(artifactId: string): Promise<ArtifactRecord | null>;
+    getArtifactWithCandidates(artifactId: string): Promise<ArtifactWithCandidates | null>;
+    insert(record: ArtifactRecord, candidates?: CandidateRecord[]): void;
+    clear(): void;
+}
+//# sourceMappingURL=memory-artifact-store.d.ts.map

package/dist/runtime-v2/store/artifact/memory-artifact-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-artifact-store.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/store/artifact/memory-artifact-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;IAC/D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAwC;IAEvE,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI/D,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAS3F,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,GAAE,eAAe,EAAO,GAAG,IAAI;IAKxE,KAAK,IAAI,IAAI;CAId"}

package/dist/runtime-v2/store/artifact/memory-artifact-store.js

@@ -0,0 +1,25 @@
+export class MemoryArtifactStore {
+    artifacts = new Map();
+    candidatesByArtifact = new Map();
+    async getArtifact(artifactId) {
+        return this.artifacts.get(artifactId) ?? null;
+    }
+    async getArtifactWithCandidates(artifactId) {
+        const artifact = this.artifacts.get(artifactId);
+        if (!artifact)
+            return null;
+        return {
+            artifact,
+            candidates: this.candidatesByArtifact.get(artifactId) ?? [],
+        };
+    }
+    insert(record, candidates = []) {
+        this.artifacts.set(record.artifactId, record);
+        this.candidatesByArtifact.set(record.artifactId, candidates);
+    }
+    clear() {
+        this.artifacts.clear();
+        this.candidatesByArtifact.clear();
+    }
+}
+//# sourceMappingURL=memory-artifact-store.js.map

package/dist/runtime-v2/store/artifact/memory-artifact-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-artifact-store.js","sourceRoot":"","sources":["../../../../src/runtime-v2/store/artifact/memory-artifact-store.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,mBAAmB;IACb,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC9C,oBAAoB,GAAG,IAAI,GAAG,EAA6B,CAAC;IAE7E,KAAK,CAAC,WAAW,CAAC,UAAkB;QAClC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,yBAAyB,CAAC,UAAkB;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,OAAO;YACL,QAAQ;YACR,UAAU,EAAE,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE;SAC5D,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,MAAsB,EAAE,aAAgC,EAAE;QAC/D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,CAAC;IACpC,CAAC;CACF"}

package/dist/runtime-v2/store/artifact/sqlite-artifact-store.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SQLite implementation of ArtifactStore.
+ */
+import type { SqliteConnection } from '../sqlite-connection.js';
+import type { ArtifactRecord, ArtifactWithCandidates, ArtifactStore } from './artifact-store.js';
+export declare class SqliteArtifactStore implements ArtifactStore {
+    private readonly connection;
+    constructor(connection: SqliteConnection);
+    getArtifact(artifactId: string): Promise<ArtifactRecord | null>;
+    getArtifactWithCandidates(artifactId: string): Promise<ArtifactWithCandidates | null>;
+}
+//# sourceMappingURL=sqlite-artifact-store.d.ts.map

package/dist/runtime-v2/store/artifact/sqlite-artifact-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-artifact-store.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/store/artifact/sqlite-artifact-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGjG,qBAAa,mBAAoB,YAAW,aAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,gBAAgB;IAEnD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAiB/D,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;CAyB5F"}

package/dist/runtime-v2/store/artifact/sqlite-artifact-store.js

@@ -0,0 +1,51 @@
+import { resolveRecommendationKind } from '../candidate/recommendation-kind-resolver.js';
+export class SqliteArtifactStore {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    async getArtifact(artifactId) {
+        const db = this.connection.getDb();
+        const row = db.prepare(`
+      SELECT artifact_id, run_id, task_id, artifact_kind, content_json, created_at
+      FROM artifacts WHERE artifact_id = ?
+    `).get(artifactId);
+        if (!row)
+            return null;
+        return {
+            artifactId: row.artifact_id,
+            runId: row.run_id,
+            taskId: row.task_id,
+            artifactKind: row.artifact_kind,
+            contentJson: row.content_json,
+            createdAt: row.created_at,
+        };
+    }
+    async getArtifactWithCandidates(artifactId) {
+        const artifact = await this.getArtifact(artifactId);
+        if (!artifact)
+            return null;
+        const db = this.connection.getDb();
+        const candidateRows = db.prepare(`
+      SELECT candidate_id, artifact_id, task_id, source_run_id, title, description,
+             confidence, source_recommendation_json, recommendation_kind, status, created_at
+      FROM principle_candidates WHERE artifact_id = ?
+      ORDER BY created_at DESC
+    `).all(artifactId);
+        const candidates = candidateRows.map((r) => ({
+            candidateId: r.candidate_id,
+            artifactId: r.artifact_id,
+            taskId: r.task_id,
+            sourceRunId: r.source_run_id,
+            title: r.title,
+            description: r.description,
+            confidence: r.confidence,
+            sourceRecommendationJson: r.source_recommendation_json,
+            recommendationKind: resolveRecommendationKind(r.recommendation_kind),
+            status: r.status,
+            createdAt: r.created_at,
+        }));
+        return { artifact, candidates };
+    }
+}
+//# sourceMappingURL=sqlite-artifact-store.js.map

package/dist/runtime-v2/store/artifact/sqlite-artifact-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-artifact-store.js","sourceRoot":"","sources":["../../../../src/runtime-v2/store/artifact/sqlite-artifact-store.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAEzF,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,UAA4B;QAA5B,eAAU,GAAV,UAAU,CAAkB;IAAG,CAAC;IAE7D,KAAK,CAAC,WAAW,CAAC,UAAkB;QAClC,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC;;;KAGtB,CAAC,CAAC,GAAG,CAAC,UAAU,CAA0I,CAAC;QAC5J,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO;YACL,UAAU,EAAE,GAAG,CAAC,WAAW;YAC3B,KAAK,EAAE,GAAG,CAAC,MAAM;YACjB,MAAM,EAAE,GAAG,CAAC,OAAO;YACnB,YAAY,EAAE,GAAG,CAAC,aAAa;YAC/B,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,SAAS,EAAE,GAAG,CAAC,UAAU;SAC1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,yBAAyB,CAAC,UAAkB;QAChD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,aAAa,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;KAKhC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAgQ,CAAC;QAClR,MAAM,UAAU,GAAsB,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9D,WAAW,EAAE,CAAC,CAAC,YAAY;YAC3B,UAAU,EAAE,CAAC,CAAC,WAAW;YACzB,MAAM,EAAE,CAAC,CAAC,OAAO;YACjB,WAAW,EAAE,CAAC,CAAC,aAAa;YAC5B,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,wBAAwB,EAAE,CAAC,CAAC,0BAA0B;YACtD,kBAAkB,EAAE,yBAAyB,CAAC,CAAC,CAAC,mBAAmB,CAAC;YACpE,MAAM,EAAE,CAAC,CAAC,MAAmC;YAC7C,SAAS,EAAE,CAAC,CAAC,UAAU;SACxB,CAAC,CAAC,CAAC;QACJ,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAClC,CAAC;CACF"}

package/dist/runtime-v2/store/artifact/sqlite-pi-artifact-store.d.ts

@@ -0,0 +1,13 @@
+import type { SqliteConnection } from '../sqlite-connection.js';
+import type { PIArtifactRecord, PIArtifactStore } from '../../internalization/pi-artifact.js';
+export declare class SqlitePIArtifactStore implements PIArtifactStore {
+    private readonly connection;
+    constructor(connection: SqliteConnection);
+    createArtifact(record: PIArtifactRecord): Promise<PIArtifactRecord>;
+    upsertArtifact(record: PIArtifactRecord): Promise<PIArtifactRecord>;
+    getArtifactById(artifactId: string): Promise<PIArtifactRecord | null>;
+    listBySourceTaskId(sourceTaskId: string): Promise<PIArtifactRecord[]>;
+    listLineage(artifactId: string): Promise<PIArtifactRecord[]>;
+    updateValidationStatus(artifactId: string, validationStatus: PIArtifactRecord['validationStatus']): Promise<boolean>;
+}
+//# sourceMappingURL=sqlite-pi-artifact-store.d.ts.map

package/dist/runtime-v2/store/artifact/sqlite-pi-artifact-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-pi-artifact-store.d.ts","sourceRoot":"","sources":["../../../../src/runtime-v2/store/artifact/sqlite-pi-artifact-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AA8B9F,qBAAa,qBAAsB,YAAW,eAAe;IAC/C,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,gBAAgB;IAEnD,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgCnE,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6BnE,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAUrE,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAUrE,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAe5D,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAS3H"}

package/dist/runtime-v2/store/artifact/sqlite-pi-artifact-store.js

@@ -0,0 +1,98 @@
+function rowToRecord(row) {
+    return {
+        artifactId: row.artifact_id,
+        artifactKind: row.artifact_kind,
+        sourceTaskId: row.source_task_id,
+        sourcePrincipleId: row.source_principle_id ?? undefined,
+        sourceRuleId: row.source_rule_id ?? undefined,
+        lineageArtifactIds: JSON.parse(row.lineage_artifact_ids),
+        validationStatus: row.validation_status,
+        contentJson: row.content_json,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+export class SqlitePIArtifactStore {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    async createArtifact(record) {
+        const db = this.connection.getDb();
+        const lineageJson = JSON.stringify(record.lineageArtifactIds);
+        try {
+            db.prepare(`
+        INSERT INTO pi_artifacts (artifact_id, artifact_kind, source_task_id, source_principle_id, source_rule_id, lineage_artifact_ids, validation_status, content_json, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(record.artifactId, record.artifactKind, record.sourceTaskId, record.sourcePrincipleId ?? null, record.sourceRuleId ?? null, lineageJson, record.validationStatus, record.contentJson, record.createdAt, record.updatedAt);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes('UNIQUE constraint failed')) {
+                throw new Error(`Duplicate PIArtifact: sourceTaskId=${record.sourceTaskId} artifactKind=${record.artifactKind} already exists`, { cause: err });
+            }
+            throw err;
+        }
+        return record;
+    }
+    async upsertArtifact(record) {
+        const db = this.connection.getDb();
+        const lineageJson = JSON.stringify(record.lineageArtifactIds);
+        db.prepare(`
+      INSERT INTO pi_artifacts (artifact_id, artifact_kind, source_task_id, source_principle_id, source_rule_id, lineage_artifact_ids, validation_status, content_json, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(source_task_id, artifact_kind) DO UPDATE SET
+        artifact_id = excluded.artifact_id,
+        source_principle_id = excluded.source_principle_id,
+        source_rule_id = excluded.source_rule_id,
+        lineage_artifact_ids = excluded.lineage_artifact_ids,
+        validation_status = excluded.validation_status,
+        content_json = excluded.content_json,
+        updated_at = excluded.updated_at
+    `).run(record.artifactId, record.artifactKind, record.sourceTaskId, record.sourcePrincipleId ?? null, record.sourceRuleId ?? null, lineageJson, record.validationStatus, record.contentJson, record.createdAt, record.updatedAt);
+        return record;
+    }
+    async getArtifactById(artifactId) {
+        const db = this.connection.getDb();
+        const row = db.prepare(`
+      SELECT artifact_id, artifact_kind, source_task_id, source_principle_id, source_rule_id, lineage_artifact_ids, validation_status, content_json, created_at, updated_at
+      FROM pi_artifacts WHERE artifact_id = ?
+    `).get(artifactId);
+        if (!row)
+            return null;
+        return rowToRecord(row);
+    }
+    async listBySourceTaskId(sourceTaskId) {
+        const db = this.connection.getDb();
+        const rows = db.prepare(`
+      SELECT artifact_id, artifact_kind, source_task_id, source_principle_id, source_rule_id, lineage_artifact_ids, validation_status, content_json, created_at, updated_at
+      FROM pi_artifacts WHERE source_task_id = ?
+      ORDER BY created_at ASC
+    `).all(sourceTaskId);
+        return rows.map(rowToRecord);
+    }
+    async listLineage(artifactId) {
+        const db = this.connection.getDb();
+        const artifact = await this.getArtifactById(artifactId);
+        if (!artifact)
+            return [];
+        if (artifact.lineageArtifactIds.length === 0)
+            return [];
+        const placeholders = artifact.lineageArtifactIds.map(() => '?').join(',');
+        const rows = db.prepare(`
+      SELECT artifact_id, artifact_kind, source_task_id, source_principle_id, source_rule_id, lineage_artifact_ids, validation_status, content_json, created_at, updated_at
+      FROM pi_artifacts WHERE artifact_id IN (${placeholders})
+    `).all(...artifact.lineageArtifactIds);
+        return rows.map(rowToRecord);
+    }
+    async updateValidationStatus(artifactId, validationStatus) {
+        const db = this.connection.getDb();
+        const now = new Date().toISOString();
+        const result = db.prepare(`
+      UPDATE pi_artifacts SET validation_status = ?, updated_at = ?
+      WHERE artifact_id = ?
+    `).run(validationStatus, now, artifactId);
+        return result.changes > 0;
+    }
+}
+//# sourceMappingURL=sqlite-pi-artifact-store.js.map

package/dist/runtime-v2/store/artifact/sqlite-pi-artifact-store.js.map

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

package/dist/runtime-v2/store/candidate/__tests__/recommendation-kind-resolver.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=recommendation-kind-resolver.test.d.ts.map

package/dist/runtime-v2/store/candidate/__tests__/recommendation-kind-resolver.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendation-kind-resolver.test.d.ts","sourceRoot":"","sources":["../../../../../src/runtime-v2/store/candidate/__tests__/recommendation-kind-resolver.test.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/store/candidate/__tests__/recommendation-kind-resolver.test.js

@@ -0,0 +1,34 @@
+import { describe, it, expect } from 'vitest';
+import { resolveRecommendationKind, VALID_RECOMMENDATION_KINDS } from '../recommendation-kind-resolver.js';
+describe('resolveRecommendationKind', () => {
+    it('returns valid kinds as-is', () => {
+        expect(resolveRecommendationKind('principle')).toBe('principle');
+        expect(resolveRecommendationKind('rule')).toBe('rule');
+        expect(resolveRecommendationKind('implementation')).toBe('implementation');
+        expect(resolveRecommendationKind('prompt')).toBe('prompt');
+        expect(resolveRecommendationKind('defer')).toBe('defer');
+    });
+    it('falls back to principle for strings outside whitelist', () => {
+        expect(resolveRecommendationKind('skill')).toBe('principle');
+        expect(resolveRecommendationKind('model_training')).toBe('principle');
+        expect(resolveRecommendationKind('')).toBe('principle');
+        expect(resolveRecommendationKind('PRINCIPLE')).toBe('principle');
+    });
+    it('falls back to principle for non-string types', () => {
+        expect(resolveRecommendationKind(null)).toBe('principle');
+        expect(resolveRecommendationKind(undefined)).toBe('principle');
+        expect(resolveRecommendationKind(42)).toBe('principle');
+        expect(resolveRecommendationKind(true)).toBe('principle');
+        expect(resolveRecommendationKind({})).toBe('principle');
+        expect(resolveRecommendationKind([])).toBe('principle');
+    });
+    it('VALID_RECOMMENDATION_KINDS contains exactly the five known kinds', () => {
+        expect(VALID_RECOMMENDATION_KINDS.size).toBe(5);
+        expect(VALID_RECOMMENDATION_KINDS.has('principle')).toBe(true);
+        expect(VALID_RECOMMENDATION_KINDS.has('rule')).toBe(true);
+        expect(VALID_RECOMMENDATION_KINDS.has('implementation')).toBe(true);
+        expect(VALID_RECOMMENDATION_KINDS.has('prompt')).toBe(true);
+        expect(VALID_RECOMMENDATION_KINDS.has('defer')).toBe(true);
+    });
+});
+//# sourceMappingURL=recommendation-kind-resolver.test.js.map

package/dist/runtime-v2/store/candidate/__tests__/recommendation-kind-resolver.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendation-kind-resolver.test.js","sourceRoot":"","sources":["../../../../../src/runtime-v2/store/candidate/__tests__/recommendation-kind-resolver.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAE3G,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,yBAAyB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjE,MAAM,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,MAAM,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC3E,MAAM,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC7D,MAAM,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACtE,MAAM,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxD,MAAM,CAAC,yBAAyB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1D,MAAM,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/D,MAAM,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxD,MAAM,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1D,MAAM,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxD,MAAM,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,0BAA0B,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,MAAM,CAAC,0BAA0B,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,CAAC,0BAA0B,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,CAAC,0BAA0B,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,CAAC,0BAA0B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}