@cat-factory/node-server 0.145.0 → 0.147.0

package/dist/db/tables/foundational-services.js

@@ -0,0 +1,92 @@
+import { sql } from 'drizzle-orm';
+import { bigint, index, integer, pgTable, primaryKey, text, uniqueIndex } from 'drizzle-orm/pg-core';
+// ---------------------------------------------------------------------------
+// The FOUNDATIONAL SERVICES tables, mirroring the Cloudflare D1 tables column-for-column
+// (snake_case field names = column names) exactly as the rest of the Node schema does.
+//
+// One cohesive group — the tiered catalog of shared capabilities an Architect designs against
+// (`foundational_services`), the API contract DOCUMENTS its consumers lazily read
+// (`api_contracts`), and the repo links a sync keeps them fresh from
+// (`foundational_service_sources`). Split out of `../schema.ts` so that module stays within its
+// file-size budget; see docs/initiatives/foundational-services.md.
+// ---------------------------------------------------------------------------
+// Foundational services (docs/initiatives/foundational-services.md; mirror of D1 migration 0073).
+// A tiered catalog of shared capabilities an Architect designs against, owner-scoped by an
+// (owner_kind, owner_id) pair exactly like the prompt-fragment library. Identity and DOCUMENTS
+// are separate tables on purpose: the catalog read runs on every design dispatch and must never
+// load a contract body, while only the consumer steps — for only the services the design
+// declared — read `api_contracts.body`.
+export const foundationalServices = pgTable('foundational_services', {
+    service_id: text('service_id').notNull(),
+    owner_kind: text('owner_kind').notNull(),
+    owner_id: text('owner_id').notNull(),
+    name: text('name').notNull(),
+    summary: text('summary').notNull(),
+    description: text('description').notNull().default(''),
+    // JSON string[] of capability tags.
+    capabilities: text('capabilities').notNull().default('[]'),
+    source_id: text('source_id'),
+    source_path: text('source_path'),
+    pinned_commit: text('pinned_commit'),
+    created_at: bigint('created_at', { mode: 'number' }).notNull(),
+    updated_at: bigint('updated_at', { mode: 'number' }).notNull(),
+    deleted_at: bigint('deleted_at', { mode: 'number' }),
+}, (t) => [
+    primaryKey({ columns: [t.owner_kind, t.owner_id, t.service_id] }),
+    index('idx_foundational_services_owner')
+        .on(t.owner_kind, t.owner_id)
+        .where(sql `${t.deleted_at} IS NULL`),
+    index('idx_foundational_services_source')
+        .on(t.source_id)
+        .where(sql `${t.deleted_at} IS NULL`),
+]);
+export const apiContracts = pgTable('api_contracts', {
+    owner_kind: text('owner_kind').notNull(),
+    owner_id: text('owner_id').notNull(),
+    service_id: text('service_id').notNull(),
+    contract_id: text('contract_id').notNull(),
+    format: text('format').notNull(),
+    title: text('title').notNull(),
+    // The document verbatim. Never selected by the catalog read (see the table note).
+    body: text('body').notNull(),
+    // Operations indexed ONCE at write time; JSON string[], empty for the TypeScript formats.
+    operations: text('operations').notNull().default('[]'),
+    omitted_operations: integer('omitted_operations').notNull().default(0),
+    source_path: text('source_path'),
+    source_sha: text('source_sha'),
+    created_at: bigint('created_at', { mode: 'number' }).notNull(),
+    updated_at: bigint('updated_at', { mode: 'number' }).notNull(),
+}, (t) => [
+    primaryKey({ columns: [t.owner_kind, t.owner_id, t.service_id, t.contract_id] }),
+    index('idx_api_contracts_owner').on(t.owner_kind, t.owner_id, t.service_id),
+]);
+export const foundationalServiceSources = pgTable('foundational_service_sources', {
+    id: text('id').primaryKey(),
+    owner_kind: text('owner_kind').notNull(),
+    owner_id: text('owner_id').notNull(),
+    repo_owner: text('repo_owner').notNull(),
+    repo_name: text('repo_name').notNull(),
+    git_ref: text('git_ref').notNull().default('HEAD'),
+    // 'directory' scans <dir_path>/<service>/; 'files' reads an explicit path list for ONE service.
+    mode: text('mode').notNull().default('directory'),
+    dir_path: text('dir_path').notNull().default(''),
+    // JSON string[]; 'files' mode only.
+    file_paths: text('file_paths').notNull().default('[]'),
+    service_id: text('service_id'),
+    service_name: text('service_name'),
+    service_summary: text('service_summary'),
+    last_synced_commit: text('last_synced_commit'),
+    last_synced_at: bigint('last_synced_at', { mode: 'number' }),
+    created_at: bigint('created_at', { mode: 'number' }).notNull(),
+    deleted_at: bigint('deleted_at', { mode: 'number' }),
+}, (t) => [
+    uniqueIndex('idx_foundational_sources_unique').on(t.owner_kind, t.owner_id, t.repo_owner, t.repo_name, t.git_ref, t.dir_path),
+    index('idx_foundational_sources_owner')
+        .on(t.owner_kind, t.owner_id)
+        .where(sql `${t.deleted_at} IS NULL`),
+    // The autorefresh sweep drains the oldest-synced live sources in bounded batches.
+    index('idx_foundational_sources_stale')
+        .on(t.last_synced_at)
+        .where(sql `${t.deleted_at} IS NULL`),
+]);
+//# sourceMappingURL=foundational-services.js.map

package/dist/db/tables/foundational-services.js.map

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