@geraldmaron/construct 1.0.0 → 1.0.1

package/lib/storage/sync.mjs

@@ -5,7 +5,11 @@
 import crypto from 'node:crypto';
 import { loadStateSnapshot } from './state-source.mjs';
 import { createSqlClient, closeSqlClient, readVectorConfig } from './backend.mjs';
-import { EMBEDDING_MODEL, embedText } from './embeddings.mjs';
+import { embedBatch, getEmbeddingModelInfo } from './embeddings-engine.mjs';
+import { writeLocalVectorIndex } from './vector-store.mjs';
+import { runMigrations } from './migrations.mjs';
+import { isManagedConstructPostgresUrl } from '../service-manager.mjs';
+import { floatArrayToPgVector } from './vector-client.mjs';
 
 function hashContent(content) {
   return crypto.createHash('sha256').update(String(content || '')).digest('hex');
@@ -29,21 +33,6 @@ function toDocumentRows(rootDir, snapshot, project = 'construct') {
     });
   }
 
-  if (snapshot.workflow) {
-    const body = JSON.stringify(snapshot.workflow, null, 2);
-    rows.push({
-      id: `${project}:workflow`,
-      project,
-      kind: 'workflow',
-      title: snapshot.workflow.title || 'Workflow state',
-      summary: snapshot.workflow.summary || null,
-      body,
-      source_path: '.cx/workflow.json',
-      tags: ['workflow', 'state', 'cx'],
-      content_hash: hashContent(body),
-    });
-  }
-
   if (snapshot.architecture) {
     const body = snapshot.architecture;
     rows.push({
@@ -53,7 +42,7 @@ function toDocumentRows(rootDir, snapshot, project = 'construct') {
       title: 'Architecture docs',
       summary: body.slice(0, 240),
       body,
-      source_path: 'docs/architecture.md',
+      source_path: 'docs/concepts/architecture.md',
       tags: ['architecture', 'docs'],
       content_hash: hashContent(body),
     });
@@ -81,7 +70,7 @@ function toDocumentRows(rootDir, snapshot, project = 'construct') {
       ? 'prd'
       : rel.startsWith('docs/meta-prd/')
         ? 'meta-prd'
-        : 'product-intel';
+        : 'knowledge';
     rows.push({
       id: `${project}:${rel}`,
       project,
@@ -90,7 +79,7 @@ function toDocumentRows(rootDir, snapshot, project = 'construct') {
       summary: body.slice(0, 240),
       body,
       source_path: rel,
-      tags: ['product-intel', kind],
+      tags: ['knowledge', kind],
       content_hash: hashContent(body),
     });
   }
@@ -98,24 +87,133 @@ function toDocumentRows(rootDir, snapshot, project = 'construct') {
   return rows;
 }
 
+/**
+ * Ensure the hybrid storage schema is current by running every pending
+ * migration in order. Uses `lib/storage/migrations.mjs` which tracks
+ * applied state in `construct_schema_migrations` and surfaces drift on
+ * changed files.
+ */
 export async function ensureHybridSchema(client) {
-  const schema = await import('node:fs/promises').then((fs) => fs.readFile(new URL('../../db/migrations/001_init.sql', import.meta.url), 'utf8'));
-  await client.unsafe(schema);
+  await runMigrations(client);
 }
 
 export async function syncFileStateToSql(rootDir, { env = process.env, project = 'construct' } = {}) {
-  const client = createSqlClient(env);
-  if (!client) return { status: 'unavailable', note: 'No DATABASE_URL configured' };
+  const snapshot = loadStateSnapshot(rootDir);
+  const rows = toDocumentRows(rootDir, snapshot, project);
+  const vectorConfig = readVectorConfig(env);
+
+  // Resolve the active embedding model once per sync so every record carries
+  // a consistent model id and dimensionality.
+  const modelInfo = await getEmbeddingModelInfo({ env });
+  const embeddingModel = modelInfo.model;
+
+  // Pre-flight check: verify database is reachable before attempting sync
+  const probeClient = createSqlClient(env);
+  if (probeClient) {
+    try {
+      await probeClient`SELECT 1`;
+    } catch (error) {
+      // Database unreachable - check if it's a managed Postgres that needs startup
+      const databaseUrl = env.DATABASE_URL || '';
+      await closeSqlClient(probeClient);
+      
+      if (isManagedConstructPostgresUrl(databaseUrl)) {
+        return {
+          status: 'degraded',
+          error: 'Managed Postgres is not running. Run `construct up` to start services, then retry.',
+          documentsSynced: 0,
+          embeddingsSynced: 0,
+          embeddingModel,
+          vector: vectorConfig,
+          localVector: { status: 'unavailable', note: 'Sync failed - database offline' },
+          sql: { status: 'unavailable', error: 'ECONNREFUSED - Postgres not running' },
+          hint: 'Run `construct up` to start managed Postgres and other runtime services',
+        };
+      }
+      
+      return {
+        status: 'degraded',
+        error: `Database connection failed: ${error.message}`,
+        documentsSynced: 0,
+        embeddingsSynced: 0,
+        embeddingModel,
+        vector: vectorConfig,
+        localVector: { status: 'unavailable', note: 'Sync failed - database offline' },
+        sql: { status: 'unavailable', error: error.message },
+      };
+    }
+    await closeSqlClient(probeClient);
+  }
+
+  // Batch-embed all documents through the engine. The engine selects the
+  // configured adapter (local ONNX, openai, ollama, hashing) and returns
+  // Float32Array embeddings of `modelInfo.dimensions` length.
+  const embedTexts = rows.map((row) =>
+    [row.title, row.summary, row.body, row.source_path, row.kind].filter(Boolean).join('\n')
+  );
+  const embeddings = embedTexts.length > 0 ? await embedBatch(embedTexts, { env }) : [];
+
+  const localVectorRecords = rows.map((row, i) => ({
+    id: row.id,
+    project: row.project,
+    kind: row.kind,
+    title: row.title,
+    summary: row.summary,
+    body: row.body,
+    source_path: row.source_path,
+    tags: row.tags,
+    content_hash: row.content_hash,
+    embedding: Array.from(embeddings[i].embedding).map((v) => Number(v)),
+    updatedAt: new Date().toISOString(),
+  }));
+
+  let localVector = { status: 'unavailable', note: 'No local vector index configured', recordsSynced: 0 };
+  if (vectorConfig.indexPath) {
+    const payload = writeLocalVectorIndex(vectorConfig.indexPath, localVectorRecords, { model: embeddingModel });
+    localVector = {
+      status: 'ok',
+      indexPath: vectorConfig.indexPath,
+      model: payload.model,
+      recordsSynced: payload.records.length,
+      updatedAt: payload.updatedAt,
+    };
+  }
+
+  if (!probeClient) {
+    return {
+      status: localVector.status === 'ok' ? 'ok' : 'unavailable',
+      note: 'No DATABASE_URL configured',
+      documentsSynced: rows.length,
+      embeddingsSynced: localVector.recordsSynced,
+      embeddingModel,
+      vector: vectorConfig,
+      localVector,
+      sql: { status: 'unavailable', note: 'No DATABASE_URL configured' },
+    };
+  }
+
+  // Create a fresh client for the actual sync operation
+  const syncClient = createSqlClient(env);
+  if (!syncClient) {
+    return {
+      status: localVector.status === 'ok' ? 'ok' : 'unavailable',
+      note: 'No DATABASE_URL configured',
+      documentsSynced: rows.length,
+      embeddingsSynced: localVector.recordsSynced,
+      embeddingModel,
+      vector: vectorConfig,
+      localVector,
+      sql: { status: 'unavailable', note: 'No DATABASE_URL configured' },
+    };
+  }
 
   try {
-    await ensureHybridSchema(client);
-    const snapshot = loadStateSnapshot(rootDir);
-    const rows = toDocumentRows(rootDir, snapshot, project);
+    await ensureHybridSchema(syncClient);
 
     let documentsSynced = 0;
     let embeddingsSynced = 0;
     for (const row of rows) {
-      await client`
+      await syncClient`
         insert into construct_documents (id, project, kind, title, summary, body, source_path, tags, content_hash, updated_at)
         values (${row.id}, ${row.project}, ${row.kind}, ${row.title}, ${row.summary}, ${row.body}, ${row.source_path}, ${JSON.stringify(row.tags)}, ${row.content_hash}, now())
         on conflict (id) do update set
@@ -131,10 +229,10 @@ export async function syncFileStateToSql(rootDir, { env = process.env, project =
       `;
       documentsSynced += 1;
 
-      const embedding = embedText([row.title, row.summary, row.body, row.source_path, row.kind].filter(Boolean).join('\n'));
-      await client`
+      const embeddingVec = floatArrayToPgVector(localVectorRecords[documentsSynced - 1].embedding);
+      await syncClient`
         insert into construct_embeddings (document_id, model, embedding, content_hash, updated_at)
-        values (${row.id}, ${EMBEDDING_MODEL}, ${embedding}, ${row.content_hash}, now())
+        values (${row.id}, ${embeddingModel}, ${embeddingVec}, ${row.content_hash}, now())
         on conflict (document_id) do update set
           model = excluded.model,
           embedding = excluded.embedding,
@@ -144,7 +242,7 @@ export async function syncFileStateToSql(rootDir, { env = process.env, project =
       embeddingsSynced += 1;
     }
 
-    await client`
+    await syncClient`
       insert into construct_sync_runs (project, source, documents_synced, embeddings_synced, status, note)
       values (${project}, ${'file-state'}, ${documentsSynced}, ${0}, ${'ok'}, ${'synced file-state documents'})
     `;
@@ -153,12 +251,23 @@ export async function syncFileStateToSql(rootDir, { env = process.env, project =
       status: 'ok',
       documentsSynced,
       embeddingsSynced,
-      embeddingModel: EMBEDDING_MODEL,
-      vector: readVectorConfig(env),
+      embeddingModel,
+      vector: vectorConfig,
+      localVector,
+      sql: { status: 'ok' },
     };
   } catch (error) {
-    return { status: 'degraded', error: error?.message || 'sync failed' };
+    return {
+      status: localVector.status === 'ok' ? 'degraded' : 'degraded',
+      error: error?.message || 'sync failed',
+      documentsSynced: rows.length,
+      embeddingsSynced: localVector.recordsSynced,
+      embeddingModel,
+      vector: vectorConfig,
+      localVector,
+      sql: { status: 'degraded', error: error?.message || 'sync failed' },
+    };
   } finally {
-    await closeSqlClient(client);
+    await closeSqlClient(syncClient);
   }
 }