spine-framework 0.3.115 → 0.3.116

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework",
-  "version": "0.3.115",
+  "version": "0.3.116",
   "description": "Multi-tenant, modular application platform for modern SaaS systems",
   "type": "module",
   "bin": {
@@ -37,10 +37,6 @@
     ".framework/migrations/028_fix_message_data_permissions.sql",
     ".framework/migrations/029_tighten_support_triage_prompt.sql",
     ".framework/migrations/030_messages_updated_by.sql",
-    ".framework/migrations/031_cil_vector_types.sql",
-    ".framework/migrations/032_cil_agent_config.sql",
-    ".framework/migrations/033_cil_chunk_schema_fields.sql",
-    ".framework/migrations/034_cil_self_seed.sql",
     ".framework/public/",
     ".framework/scripts/",
     ".framework/seeds/",

package/.framework/migrations/031_cil_vector_types.sql

@@ -1,60 +0,0 @@
--- Migration 031: CIL vector types — patch cil_chunk type design_schema
---
--- The seed file (custom/apps/cortex/seed/types.json) defines cil_chunk with
--- no vector_types because the generate() function in embeddings.ts reads
--- vector_types from the type's design_schema at runtime.
---
--- This migration patches in the three CIL vector types for cil_chunk so that
--- calls to generate() produce semantic, structural, and contract vectors.
---
--- Also adds vector_types for cil_config (semantic only) and cil_project (semantic).
---
--- Safe to re-run: uses jsonb_set which is idempotent on the same value.
---
--- NOTE: This only patches rows where the type already exists. The seed must
--- have been applied (via spine install-app) before this migration runs.
-
--- ── cil_chunk: semantic + structural + contract ───────────────────────────────
-UPDATE public.types
-SET design_schema = jsonb_set(
-  design_schema,
-  '{vector_types}',
-  '["semantic", "structural", "contract"]'::jsonb,
-  true  -- create if missing
-)
-WHERE kind = 'item'
-  AND slug = 'cil_chunk';
-
--- ── cil_project: semantic only (project descriptions) ─────────────────────────
-UPDATE public.types
-SET design_schema = jsonb_set(
-  design_schema,
-  '{vector_types}',
-  '["semantic"]'::jsonb,
-  true
-)
-WHERE kind = 'item'
-  AND slug = 'cil_project';
-
--- ── cil_config: semantic (config field descriptions) ──────────────────────────
-UPDATE public.types
-SET design_schema = jsonb_set(
-  design_schema,
-  '{vector_types}',
-  '["semantic"]'::jsonb,
-  true
-)
-WHERE kind = 'item'
-  AND slug = 'cil_config';
-
--- ── embedding_fields for cil_chunk structural vector ─────────────────────────
--- structural vector uses these fields from item.data for its JSON snapshot
-UPDATE public.types
-SET design_schema = jsonb_set(
-  design_schema,
-  '{embedding_fields,structural}',
-  '["chunk_type","file_path","stability","is_dead_code","boundary_confidence","doc_confidence","review_status"]'::jsonb,
-  true
-)
-WHERE kind = 'item'
-  AND slug = 'cil_chunk';

package/.framework/migrations/032_cil_agent_config.sql

@@ -1,122 +0,0 @@
--- Migration 032: CIL AI Agent + Prompt Config
---
--- Seeds the Code Intelligence Layer conversational agent so it can answer
--- questions about the codebase using cil_chunk embeddings as RAG context.
---
--- The agent is scoped to the Cortex app (is_system = false so it can be
--- overridden per-tenant). A second system-level prompt config with
--- retrieval_policy.item_types = ["cil_chunk"] ensures the agent only pulls
--- code chunk embeddings rather than KB articles.
---
--- Safe to re-run: uses INSERT ... ON CONFLICT DO NOTHING on (app_id, name)
--- and ON CONFLICT (slug) DO NOTHING for prompt_configs.
-
--- ── CIL Conversational Agent ─────────────────────────────────────────────────
-INSERT INTO public.ai_agents (
-  id,
-  app_id,
-  name,
-  description,
-  agent_type,
-  system_prompt,
-  model_config,
-  ownership,
-  is_system,
-  is_active,
-  created_at,
-  updated_at
-)
-SELECT
-  gen_random_uuid(),
-  (SELECT id FROM public.apps WHERE slug = 'cortex'),
-  'CIL Codebase Assistant',
-  'Conversational agent that answers questions about the codebase using the Code Intelligence Layer. Retrieves chunk contracts, call graphs, and documentation via semantic search.',
-  'rag',
-  'You are a Code Intelligence Layer assistant. Your job is to answer questions about this codebase accurately and concisely.
-
-You have access to a semantic index of every named chunk in the codebase. Each chunk record contains:
-- chunk_name: the function / class / component name
-- macro: one-sentence purpose statement
-- micro: implementation detail
-- input_spec: parameter names, types, constraints
-- output_spec: return type and shape
-- side_effects: DB writes, API calls, file I/O
-- stability: stable | internal | experimental
-- file_path: source file location
-
-When answering:
-1. Ground your answer in the retrieved chunk contracts — do not invent APIs.
-2. Always cite the chunk_name and file_path when referencing a specific function.
-3. If you cannot find a relevant chunk, say so explicitly — do not guess.
-4. For refactoring questions, always mention callers / blast radius if known.
-5. Keep answers concise. Use markdown code blocks for code examples.
-6. If asked "is X safe to change?", check if stability = stable before confirming.
-
-Avoid hallucinating parameter names, return types, or side effects that are not in the retrieved contracts.',
-  '{"model": "gpt-4o-mini", "temperature": 0.2, "max_tokens": 1500}',
-  'platform',
-  false,
-  true,
-  now(),
-  now()
-WHERE NOT EXISTS (
-  SELECT 1 FROM public.ai_agents
-  WHERE app_id = (SELECT id FROM public.apps WHERE slug = 'cortex')
-    AND name = 'CIL Codebase Assistant'
-);
-
--- ── CIL Agent Prompt Config ───────────────────────────────────────────────────
-INSERT INTO public.prompt_configs (
-  id,
-  app_id,
-  slug,
-  name,
-  context_template,
-  model,
-  temperature,
-  max_tokens,
-  is_multi_turn,
-  max_history_messages,
-  confidence_threshold,
-  output_mode,
-  knowledge_sources,
-  available_tools,
-  metadata,
-  ownership,
-  is_system,
-  is_active,
-  created_at,
-  updated_at
-)
-SELECT
-  gen_random_uuid(),
-  (SELECT id FROM public.apps WHERE slug = 'cortex'),
-  'cil_codebase_assistant',
-  'CIL Codebase Assistant',
-  'Answer the user''s question about the codebase using the retrieved chunk contracts above.
-If the answer involves a specific function, always include: chunk_name, file_path, and what it does.',
-  'gpt-4o-mini',
-  0.2,
-  1500,
-  true,
-  10,
-  0.3,
-  'text',
-  '[]'::jsonb,
-  '[]'::jsonb,
-  jsonb_build_object(
-    'retrieval_policy', jsonb_build_object(
-      'item_types',       jsonb_build_array('cil_chunk'),
-      'vector_types',     jsonb_build_array('semantic', 'contract'),
-      'max_security_level', 'internal',
-      'require_approved', true
-    )
-  ),
-  'platform',
-  false,
-  true,
-  now(),
-  now()
-WHERE NOT EXISTS (
-  SELECT 1 FROM public.prompt_configs WHERE slug = 'cil_codebase_assistant'
-);

package/.framework/migrations/033_cil_chunk_schema_fields.sql

@@ -1,75 +0,0 @@
--- Migration 033: Add missing fields to CIL item type design_schemas
---
--- Adds fields that are written by the backend functions but were absent from
--- the design_schema definitions in types.json:
---
---   cil_chunk:
---     - hash_updated_at   written by custom_cil-validate ?action=update_hash
---     - kb_type           written by custom_cil-ingest pass2 (discriminator field)
---
---   cil_file:
---     - line_count                      written by custom_cil-ingest pass1
---     - existing_marker_names           written by custom_cil-ingest pass1
---     - existing_marker_count           written by custom_cil-ingest pass1
---     - kb_type                         discriminator field
---
--- Safe to re-run: uses jsonb || operator (merge) so existing schema fields are
--- preserved. Only adds new keys — does not overwrite existing ones.
-
--- ── cil_chunk — add hash_updated_at + kb_type ───────────────────────────────
-UPDATE public.types
-SET design_schema = design_schema || jsonb_build_object(
-  'fields', (design_schema->'fields') || jsonb_build_object(
-    'hash_updated_at', jsonb_build_object(
-      'label', 'Hash Updated At',
-      'data_type', 'text'
-    ),
-    'kb_type', jsonb_build_object(
-      'label', 'KB Type',
-      'data_type', 'text'
-    )
-  )
-)
-WHERE slug = 'cil_chunk'
-  AND kind = 'item'
-  AND NOT (design_schema->'fields' ? 'hash_updated_at');
-
--- ── cil_file — add line_count, existing_marker_names, existing_marker_count, kb_type ─
-UPDATE public.types
-SET design_schema = design_schema || jsonb_build_object(
-  'fields', (design_schema->'fields') || jsonb_build_object(
-    'line_count', jsonb_build_object(
-      'label', 'Line Count',
-      'data_type', 'number'
-    ),
-    'existing_marker_names', jsonb_build_object(
-      'label', 'Existing Marker Names',
-      'data_type', 'text'
-    ),
-    'existing_marker_count', jsonb_build_object(
-      'label', 'Existing Marker Count',
-      'data_type', 'number'
-    ),
-    'kb_type', jsonb_build_object(
-      'label', 'KB Type',
-      'data_type', 'text'
-    )
-  )
-)
-WHERE slug = 'cil_file'
-  AND kind = 'item'
-  AND NOT (design_schema->'fields' ? 'kb_type');
-
--- ── cil_project — add kb_type ────────────────────────────────────────────────
-UPDATE public.types
-SET design_schema = design_schema || jsonb_build_object(
-  'fields', (design_schema->'fields') || jsonb_build_object(
-    'kb_type', jsonb_build_object(
-      'label', 'KB Type',
-      'data_type', 'text'
-    )
-  )
-)
-WHERE slug = 'cil_project'
-  AND kind = 'item'
-  AND NOT (design_schema->'fields' ? 'kb_type');

package/.framework/migrations/034_cil_self_seed.sql

@@ -1,116 +0,0 @@
--- Migration 034: CIL Self-Seed — register spine-ia as a CIL project
---
--- Seeds the spine-ia repository itself as a `cil_project` item so that
--- Pass 1–5 of the Code Intelligence Layer pipeline can be run against it
--- immediately after install, without needing to create the project via the UI.
---
--- The repo_path defaults to the standard CascadeProjects location. Operators
--- running the app on a different machine should update the repo_path via:
---   PATCH /api/custom_cil-project?action=update&id=<SPINE_IA_PROJECT_ID>
---   body: { data: { repo_path: "/path/to/your/spine-ia" } }
---
--- Safe to re-run: the INSERT is guarded by WHERE NOT EXISTS on the title.
--- The hard-coded UUID allows other migrations to reference this project.
-
--- Known stable UUID for the spine-ia CIL project (update if your DB uses a different value)
-DO $$
-DECLARE
-  v_cil_project_type_id  uuid;
-  v_spine_account_id     uuid;
-  v_cortex_app_id        uuid;
-  v_existing_id          uuid;
-BEGIN
-  -- Resolve the cil_project type
-  SELECT id INTO v_cil_project_type_id
-    FROM public.types
-   WHERE slug = 'cil_project' AND kind = 'item'
-   LIMIT 1;
-
-  IF v_cil_project_type_id IS NULL THEN
-    RAISE NOTICE 'cil_project type not found — skipping CIL self-seed. Run install-app cortex first.';
-    RETURN;
-  END IF;
-
-  -- Resolve the system account (spine-system or the first account if not found)
-  SELECT id INTO v_spine_account_id
-    FROM public.accounts
-   WHERE slug = 'spine-system'
-   LIMIT 1;
-
-  IF v_spine_account_id IS NULL THEN
-    SELECT id INTO v_spine_account_id FROM public.accounts ORDER BY created_at LIMIT 1;
-  END IF;
-
-  IF v_spine_account_id IS NULL THEN
-    RAISE NOTICE 'No account found — skipping CIL self-seed.';
-    RETURN;
-  END IF;
-
-  -- Resolve the cortex app
-  SELECT id INTO v_cortex_app_id
-    FROM public.apps
-   WHERE slug = 'cortex'
-   LIMIT 1;
-
-  -- Check if the project already exists
-  SELECT id INTO v_existing_id
-    FROM public.items
-   WHERE title = 'spine-ia'
-     AND type_id = v_cil_project_type_id
-     AND account_id = v_spine_account_id
-   LIMIT 1;
-
-  IF v_existing_id IS NOT NULL THEN
-    RAISE NOTICE 'spine-ia CIL project already seeded (id: %). Skipping.', v_existing_id;
-    RETURN;
-  END IF;
-
-  -- Insert the project item
-  INSERT INTO public.items (
-    id,
-    type_id,
-    account_id,
-    app_id,
-    title,
-    description,
-    status,
-    is_active,
-    data,
-    created_at,
-    updated_at
-  ) VALUES (
-    -- Fixed UUID so other tooling can reference it; change if collision occurs
-    '00000001-c11a-4a1e-0000-00000000001a',
-    v_cil_project_type_id,
-    v_spine_account_id,
-    v_cortex_app_id,
-    'spine-ia',
-    'The spine-ia monorepo — Spine framework core + Cortex CIL app',
-    'active',
-    true,
-    jsonb_build_object(
-      'kb_type',           'cil_project',
-      'project_id',        '00000001-c11a-4a1e-0000-00000000001a',
-      'repo_path',         '/Users/thistle/CascadeProjects/spine-ia',
-      'language_mix',      'TypeScript, SQL',
-      'description',       'The spine-ia monorepo — Spine framework core + Cortex CIL app',
-      'ingestion_status',  'not_started',
-      'file_count',        0,
-      'chunk_count',       0,
-      'last_ingested_at',  NULL,
-      'globs',             jsonb_build_array(
-        'custom/**/*.ts', 'custom/**/*.tsx',
-        '.framework/functions/**/*.ts',
-        '.framework/migrations/**/*.sql'
-      ),
-      'exclude_globs',     jsonb_build_array(
-        'node_modules/**', '.assembled/**', 'dist/**', 'build/**',
-        '**/*.test.ts', '**/*.spec.ts', '**/*.d.ts'
-      )
-    ),
-    now(),
-    now()
-  );
-
-  RAISE NOTICE 'spine-ia CIL project seeded successfully (id: 00000001-c11a-4a1e-0000-00000000001a)';
-END $$;