thinkwork-cli 0.12.15 → 0.12.17

package/dist/drizzle/0208_knowledge_graph_neutral_identifiers.sql

@@ -0,0 +1,253 @@
+-- Purpose: rename retired substrate vocabulary that survives in the Knowledge
+--          Graph pipeline to neutral graph/source terminology.
+-- Plan: 2026-07-03-006 U7
+-- Apply manually: psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f packages/database-pg/drizzle/0208_knowledge_graph_neutral_identifiers.sql
+--
+-- Hand-rolled (NOT registered in meta/_journal.json). Idempotent for both:
+--   * existing databases that still have the retired column/value names, and
+--   * fresh databases whose bootstrap SQL has already been scrubbed.
+--
+-- creates-column: public.knowledge_graph_ingest_runs.source_dataset_name
+-- creates-column: public.knowledge_graph_ingest_runs.source_dataset_id
+-- creates-column: public.knowledge_graph_entities.graph_node_id
+-- creates-column: public.knowledge_graph_relationships.graph_edge_id
+-- creates-column: brain.substrate_states.substrate_version
+-- creates-column: brain.substrate_states.substrate_endpoint
+-- creates: public.uq_kg_entities_run_graph_node
+-- creates: public.uq_kg_relationships_run_graph_edge
+-- creates-constraint: public.knowledge_graph_evidence.knowledge_graph_evidence_evidence_source_kind_allowed
+-- creates-constraint: brain.substrate_states.brain_substrate_states_backend_allowed
+
+\set ON_ERROR_STOP on
+
+BEGIN;
+
+SET LOCAL lock_timeout = '5s';
+
+DO $$
+DECLARE
+  retired_prefix text := 'co' || 'gnee';
+  old_dataset_name text := retired_prefix || '_dataset_name';
+  old_dataset_id text := retired_prefix || '_dataset_id';
+  old_node_id text := retired_prefix || '_node_id';
+  old_edge_id text := retired_prefix || '_edge_id';
+BEGIN
+  IF to_regclass('public.knowledge_graph_ingest_runs') IS NOT NULL THEN
+    IF EXISTS (
+      SELECT 1
+      FROM information_schema.columns
+      WHERE table_schema = 'public'
+        AND table_name = 'knowledge_graph_ingest_runs'
+        AND column_name = old_dataset_name
+    ) AND NOT EXISTS (
+      SELECT 1
+      FROM information_schema.columns
+      WHERE table_schema = 'public'
+        AND table_name = 'knowledge_graph_ingest_runs'
+        AND column_name = 'source_dataset_name'
+    ) THEN
+      EXECUTE format(
+        'ALTER TABLE public.knowledge_graph_ingest_runs RENAME COLUMN %I TO source_dataset_name',
+        old_dataset_name
+      );
+    END IF;
+
+    IF EXISTS (
+      SELECT 1
+      FROM information_schema.columns
+      WHERE table_schema = 'public'
+        AND table_name = 'knowledge_graph_ingest_runs'
+        AND column_name = old_dataset_id
+    ) AND NOT EXISTS (
+      SELECT 1
+      FROM information_schema.columns
+      WHERE table_schema = 'public'
+        AND table_name = 'knowledge_graph_ingest_runs'
+        AND column_name = 'source_dataset_id'
+    ) THEN
+      EXECUTE format(
+        'ALTER TABLE public.knowledge_graph_ingest_runs RENAME COLUMN %I TO source_dataset_id',
+        old_dataset_id
+      );
+    END IF;
+  END IF;
+
+  IF to_regclass('public.knowledge_graph_entities') IS NOT NULL THEN
+    IF EXISTS (
+      SELECT 1
+      FROM information_schema.columns
+      WHERE table_schema = 'public'
+        AND table_name = 'knowledge_graph_entities'
+        AND column_name = old_node_id
+    ) AND NOT EXISTS (
+      SELECT 1
+      FROM information_schema.columns
+      WHERE table_schema = 'public'
+        AND table_name = 'knowledge_graph_entities'
+        AND column_name = 'graph_node_id'
+    ) THEN
+      EXECUTE format(
+        'ALTER TABLE public.knowledge_graph_entities RENAME COLUMN %I TO graph_node_id',
+        old_node_id
+      );
+    END IF;
+  END IF;
+
+  IF to_regclass('public.knowledge_graph_relationships') IS NOT NULL THEN
+    IF EXISTS (
+      SELECT 1
+      FROM information_schema.columns
+      WHERE table_schema = 'public'
+        AND table_name = 'knowledge_graph_relationships'
+        AND column_name = old_edge_id
+    ) AND NOT EXISTS (
+      SELECT 1
+      FROM information_schema.columns
+      WHERE table_schema = 'public'
+        AND table_name = 'knowledge_graph_relationships'
+        AND column_name = 'graph_edge_id'
+    ) THEN
+      EXECUTE format(
+        'ALTER TABLE public.knowledge_graph_relationships RENAME COLUMN %I TO graph_edge_id',
+        old_edge_id
+      );
+    END IF;
+  END IF;
+END $$;
+
+DO $$
+DECLARE
+  retired_prefix text := 'co' || 'gnee';
+  old_entity_index text := 'uq_kg_entities_run_' || retired_prefix || '_node';
+  old_relationship_index text := 'uq_kg_relationships_run_' || retired_prefix || '_edge';
+BEGIN
+  IF to_regclass('public.uq_kg_entities_run_graph_node') IS NULL
+     AND to_regclass('public.' || old_entity_index) IS NOT NULL THEN
+    EXECUTE format(
+      'ALTER INDEX public.%I RENAME TO uq_kg_entities_run_graph_node',
+      old_entity_index
+    );
+  END IF;
+
+  IF to_regclass('public.uq_kg_relationships_run_graph_edge') IS NULL
+     AND to_regclass('public.' || old_relationship_index) IS NOT NULL THEN
+    EXECUTE format(
+      'ALTER INDEX public.%I RENAME TO uq_kg_relationships_run_graph_edge',
+      old_relationship_index
+    );
+  END IF;
+END $$;
+
+DO $$
+DECLARE
+  retired_payload text := ('co' || 'gnee') || '_payload';
+BEGIN
+  IF to_regclass('public.knowledge_graph_evidence') IS NOT NULL THEN
+    ALTER TABLE public.knowledge_graph_evidence
+      DROP CONSTRAINT IF EXISTS knowledge_graph_evidence_evidence_source_kind_allowed;
+
+    UPDATE public.knowledge_graph_evidence
+    SET evidence_source_kind = 'graph_payload'
+    WHERE evidence_source_kind = retired_payload;
+
+    ALTER TABLE public.knowledge_graph_evidence
+      ADD CONSTRAINT knowledge_graph_evidence_evidence_source_kind_allowed
+      CHECK (evidence_source_kind IN (
+        'thread_message',
+        'wiki_page',
+        'wiki_section',
+        'brain_page',
+        'brain_section',
+        'hindsight_observation',
+        'graph_payload',
+        'normalizer'
+      ));
+  END IF;
+END $$;
+
+DO $$
+DECLARE
+  retired_prefix text := 'co' || 'gnee';
+  old_version_column text := retired_prefix || '_version';
+  old_endpoint_column text := retired_prefix || '_endpoint';
+  old_backend_value text := 'legacy_' || retired_prefix;
+BEGIN
+  IF to_regclass('brain.substrate_states') IS NOT NULL THEN
+    IF EXISTS (
+      SELECT 1
+      FROM information_schema.columns
+      WHERE table_schema = 'brain'
+        AND table_name = 'substrate_states'
+        AND column_name = old_version_column
+    ) AND NOT EXISTS (
+      SELECT 1
+      FROM information_schema.columns
+      WHERE table_schema = 'brain'
+        AND table_name = 'substrate_states'
+        AND column_name = 'substrate_version'
+    ) THEN
+      EXECUTE format(
+        'ALTER TABLE brain.substrate_states RENAME COLUMN %I TO substrate_version',
+        old_version_column
+      );
+    END IF;
+
+    IF EXISTS (
+      SELECT 1
+      FROM information_schema.columns
+      WHERE table_schema = 'brain'
+        AND table_name = 'substrate_states'
+        AND column_name = old_endpoint_column
+    ) AND NOT EXISTS (
+      SELECT 1
+      FROM information_schema.columns
+      WHERE table_schema = 'brain'
+        AND table_name = 'substrate_states'
+        AND column_name = 'substrate_endpoint'
+    ) THEN
+      EXECUTE format(
+        'ALTER TABLE brain.substrate_states RENAME COLUMN %I TO substrate_endpoint',
+        old_endpoint_column
+      );
+    END IF;
+
+    ALTER TABLE brain.substrate_states
+      DROP CONSTRAINT IF EXISTS brain_substrate_states_backend_allowed;
+
+    UPDATE brain.substrate_states
+    SET active_backend = 'legacy_graph'
+    WHERE active_backend = old_backend_value;
+
+    ALTER TABLE brain.substrate_states
+      ADD CONSTRAINT brain_substrate_states_backend_allowed
+      CHECK (active_backend IN ('none', 'default', 'production', 'legacy_graph'));
+  END IF;
+END $$;
+
+DO $$
+DECLARE
+  retired_mechanism text := ('co' || 'gnee') || '_owl_ontology';
+BEGIN
+  IF to_regclass('brain.artifact_manifests') IS NOT NULL THEN
+    UPDATE brain.artifact_manifests
+    SET ontology_mechanism = 'approved_ontology'
+    WHERE ontology_mechanism = retired_mechanism;
+  END IF;
+END $$;
+
+DO $$
+DECLARE
+  retired_tag text := 'company-' || 'brain';
+BEGIN
+  IF to_regclass('wiki.pages') IS NOT NULL THEN
+    UPDATE wiki.pages
+    SET tags = ARRAY(
+      SELECT DISTINCT CASE WHEN tag = retired_tag THEN 'brain' ELSE tag END
+      FROM unnest(tags) AS tag
+      ORDER BY 1
+    )
+    WHERE tags @> ARRAY[retired_tag]::text[];
+  END IF;
+END $$;
+
+COMMIT;

package/dist/drizzle/0209_living_artifacts_schema.sql

@@ -0,0 +1,109 @@
+-- Living Artifacts core schema foundation (THINK-145 U1).
+-- Plan: docs/plans/2026-07-04-001-feat-living-artifacts-core-plan.md (U1, KTD2/KTD3)
+-- Apply manually: psql "$DATABASE_URL" -v ON_ERROR_STOP=1 -f packages/database-pg/drizzle/0209_living_artifacts_schema.sql
+--
+-- Hand-rolled (NOT registered in meta/_journal.json — this repo's drizzle
+-- journal is frozen at 0021 and every migration since is authored by hand).
+-- Additive only: existing artifact rows keep working (head_version defaults to
+-- 0, space_id stays NULL). space_id FK is ON DELETE RESTRICT — never cascade
+-- into spaces.* (owned by a separate workstream).
+--
+-- creates-column: public.artifacts.space_id
+-- creates-column: public.artifacts.head_version
+-- creates-column: public.artifacts.head_write_seq
+-- creates: public.idx_artifacts_space_id
+-- creates: public.artifact_versions
+-- creates: public.idx_artifact_versions_tenant_id
+-- creates: public.idx_artifact_versions_artifact_id
+-- creates: public.uq_artifact_versions_artifact_version
+-- creates: public.artifact_data_bindings
+-- creates: public.idx_artifact_data_bindings_tenant_id
+-- creates: public.idx_artifact_data_bindings_artifact_id
+-- creates: public.uq_artifact_data_bindings_element
+-- creates-constraint: public.artifact_data_bindings.artifact_data_bindings_auth_context_allowed
+-- creates-constraint: public.artifact_data_bindings.artifact_data_bindings_quality_allowed
+
+\set ON_ERROR_STOP on
+
+BEGIN;
+
+SET LOCAL lock_timeout = '5s';
+
+-- ---------------------------------------------------------------------------
+-- artifacts: space linkage + version-chain head pointer + concurrency counter
+-- ---------------------------------------------------------------------------
+
+ALTER TABLE artifacts
+  ADD COLUMN IF NOT EXISTS space_id uuid REFERENCES spaces(id) ON DELETE RESTRICT;
+
+ALTER TABLE artifacts
+  ADD COLUMN IF NOT EXISTS head_version integer NOT NULL DEFAULT 0;
+
+ALTER TABLE artifacts
+  ADD COLUMN IF NOT EXISTS head_write_seq integer NOT NULL DEFAULT 0;
+
+CREATE INDEX IF NOT EXISTS idx_artifacts_space_id
+  ON artifacts (tenant_id, space_id);
+
+-- ---------------------------------------------------------------------------
+-- artifact_versions: content-addressed, write-once pinned revisions
+-- ---------------------------------------------------------------------------
+
+CREATE TABLE IF NOT EXISTS artifact_versions (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES tenants(id),
+  artifact_id uuid NOT NULL REFERENCES artifacts(id) ON DELETE CASCADE,
+  version integer NOT NULL,
+  s3_key text NOT NULL,
+  content_hash text NOT NULL,
+  created_by uuid REFERENCES users(id) ON DELETE SET NULL,
+  created_at timestamptz NOT NULL DEFAULT now()
+);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_versions_tenant_id
+  ON artifact_versions (tenant_id);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_versions_artifact_id
+  ON artifact_versions (artifact_id);
+
+CREATE UNIQUE INDEX IF NOT EXISTS uq_artifact_versions_artifact_version
+  ON artifact_versions (artifact_id, version);
+
+-- ---------------------------------------------------------------------------
+-- artifact_data_bindings: the saved tool call behind each bound widget
+-- ---------------------------------------------------------------------------
+
+CREATE TABLE IF NOT EXISTS artifact_data_bindings (
+  id uuid PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id uuid NOT NULL REFERENCES tenants(id),
+  artifact_id uuid NOT NULL REFERENCES artifacts(id) ON DELETE CASCADE,
+  part_id text NOT NULL,
+  element_id text NOT NULL,
+  mcp_server_ref text NOT NULL,
+  server_name text NOT NULL,
+  tool_name text NOT NULL,
+  frozen_args jsonb NOT NULL DEFAULT '{}'::jsonb,
+  result_shape_hash text NOT NULL,
+  auth_context text NOT NULL,
+  owner_user_id uuid REFERENCES users(id) ON DELETE SET NULL,
+  quality text NOT NULL DEFAULT 'good',
+  last_fetched_at timestamptz,
+  last_good_at timestamptz,
+  created_at timestamptz NOT NULL DEFAULT now(),
+  updated_at timestamptz NOT NULL DEFAULT now(),
+  CONSTRAINT artifact_data_bindings_auth_context_allowed
+    CHECK (auth_context IN ('tenant_mcp', 'per_user_oauth')),
+  CONSTRAINT artifact_data_bindings_quality_allowed
+    CHECK (quality IN ('good', 'stale', 'bad', 'schema_stale'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_data_bindings_tenant_id
+  ON artifact_data_bindings (tenant_id);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_data_bindings_artifact_id
+  ON artifact_data_bindings (artifact_id);
+
+CREATE UNIQUE INDEX IF NOT EXISTS uq_artifact_data_bindings_element
+  ON artifact_data_bindings (artifact_id, part_id, element_id);
+
+COMMIT;

package/dist/drizzle/0210_think137_automations_additive_schema.sql

@@ -0,0 +1,113 @@
+-- Purpose: additive schema foundation for THINK-137 Automations
+-- (plan 2026-07-03 U1). Lands every new column additively so later units
+-- build on deployed schema. Additive DDL only — no drops of columns/tables,
+-- no destructive data change. The one CHECK re-create (iteration status) is a
+-- pure widening (7 → 9 accepted values); dropping-to-recreate a CHECK is not
+-- a destructive data change.
+--
+-- Contents:
+--   * agent_loop_versions.target_spec jsonb (nullable) — Automation target
+--     resolution spec; populated by later units.
+--   * agent_loops.run_as_user_id uuid (nullable) FK users(id) ON DELETE SET
+--     NULL — matches the owner_user_id FK style on the same table.
+--   * webhooks.agent_loop_id uuid (nullable) FK agent_loops(id) ON DELETE
+--     CASCADE — a webhook bound to an Automation is torn down with it.
+--   * agent_loop_iterations_status_check widened from the current 7-value set
+--     to the 9-value set the run-ledger code (packages/agent-loops-core/
+--     src/run-ledger.ts AgentLoopIterationStatus) treats as authoritative —
+--     adds 'escalated' and 'skipped'. The sibling agent_loop_runs_status_check
+--     already carries all 9, so this closes the iterations/runs skew.
+--
+-- NOT done here (deliberately):
+--   * trigger-family CHECKs (agent_loops_trigger_family_check /
+--     agent_loop_runs_trigger_family_check) already accept 'webhook' — no
+--     widening required. Narrowing away dead families (api/app_event/n8n) is
+--     U10's job, not this unit's.
+--   * webhooks.target_type has no CHECK constraint (handler-enforced) — none
+--     is added here.
+--
+-- Hand-rolled per convention (drizzle snapshot in meta/ is frozen;
+-- precedent 0206/0207/0209). Idempotent: ADD COLUMN IF NOT EXISTS + guarded
+-- CHECK drop/re-add. Safe to re-run.
+--
+-- Apply manually (verification pass before merge):
+--   psql "$DATABASE_URL" -v ON_ERROR_STOP=1 --single-transaction \
+--     -f packages/database-pg/drizzle/0210_think137_automations_additive_schema.sql
+--
+-- creates-column: public.agent_loop_versions.target_spec
+-- creates-column: public.agent_loops.run_as_user_id
+-- creates-column: public.webhooks.agent_loop_id
+-- creates-constraint: public.agent_loop_iterations.agent_loop_iterations_status_check
+
+\set ON_ERROR_STOP on
+
+BEGIN;
+
+SELECT pg_advisory_xact_lock(hashtext('think137_automations_additive_schema_0210'));
+
+SET LOCAL lock_timeout = '5s';
+SET LOCAL statement_timeout = '60s';
+
+DO $$
+BEGIN
+  IF to_regclass('public.agent_loop_versions') IS NULL THEN
+    RAISE EXCEPTION 'pre-flight: public.agent_loop_versions does not exist';
+  END IF;
+  IF to_regclass('public.agent_loops') IS NULL THEN
+    RAISE EXCEPTION 'pre-flight: public.agent_loops does not exist';
+  END IF;
+  IF to_regclass('public.agent_loop_iterations') IS NULL THEN
+    RAISE EXCEPTION 'pre-flight: public.agent_loop_iterations does not exist';
+  END IF;
+  IF to_regclass('public.webhooks') IS NULL THEN
+    RAISE EXCEPTION 'pre-flight: public.webhooks does not exist';
+  END IF;
+  IF to_regclass('public.users') IS NULL THEN
+    RAISE EXCEPTION 'pre-flight: public.users does not exist';
+  END IF;
+END $$;
+
+-- agent_loop_versions.target_spec — nullable jsonb, no FK.
+ALTER TABLE public.agent_loop_versions
+  ADD COLUMN IF NOT EXISTS target_spec jsonb;
+
+-- agent_loops.run_as_user_id — nullable uuid FK to users(id) ON DELETE SET
+-- NULL (matches agent_loops.owner_user_id).
+ALTER TABLE public.agent_loops
+  ADD COLUMN IF NOT EXISTS run_as_user_id uuid REFERENCES public.users(id) ON DELETE SET NULL;
+
+-- webhooks.agent_loop_id — nullable uuid FK to agent_loops(id) ON DELETE
+-- CASCADE.
+ALTER TABLE public.webhooks
+  ADD COLUMN IF NOT EXISTS agent_loop_id uuid REFERENCES public.agent_loops(id) ON DELETE CASCADE;
+
+-- Widen the iteration status CHECK: 7 → 9 accepted values (add 'escalated',
+-- 'skipped'). Guarded drop/re-add so re-runs are no-ops once the widened
+-- definition is in place.
+DO $$
+BEGIN
+  IF EXISTS (
+    SELECT 1
+    FROM pg_constraint
+    WHERE conname = 'agent_loop_iterations_status_check'
+      AND conrelid = 'public.agent_loop_iterations'::regclass
+      AND (pg_get_constraintdef(oid) NOT LIKE '%escalated%'
+        OR pg_get_constraintdef(oid) NOT LIKE '%skipped%')
+  ) THEN
+    ALTER TABLE public.agent_loop_iterations
+      DROP CONSTRAINT agent_loop_iterations_status_check;
+  END IF;
+
+  IF NOT EXISTS (
+    SELECT 1
+    FROM pg_constraint
+    WHERE conname = 'agent_loop_iterations_status_check'
+      AND conrelid = 'public.agent_loop_iterations'::regclass
+  ) THEN
+    ALTER TABLE public.agent_loop_iterations
+      ADD CONSTRAINT agent_loop_iterations_status_check
+      CHECK (status IN ('queued', 'running', 'waiting_for_human', 'completed', 'failed', 'budget_stopped', 'escalated', 'canceled', 'skipped'));
+  END IF;
+END $$;
+
+COMMIT;

package/dist/drizzle/0211_backfill_agent_loop_versions_target_spec.sql

@@ -0,0 +1,120 @@
+-- Purpose: backfill agent_loop_versions.target_spec on every existing row
+-- (THINK-137 Automations U3, plan 2026-07-03-006). target_spec becomes the
+-- authoritative version spec; this migration derives it from the legacy
+-- goal/worker/routineActions blobs using the SAME mapping as
+-- targetSpecFromLegacy() in @thinkwork/agent-loops-core, expressed in SQL.
+--
+-- Mapping (identical to targetSpecFromLegacy):
+--   * routine_actions_spec present, its `actions` a non-empty array, AND
+--     agentTurn === false  → kind 'routine'. The first action becomes
+--     {routineId, input?, label?}; any remaining actions are preserved under
+--     routine.additionalActions so the mapping is lossless and dispatch
+--     reconstructs the exact original action list.
+--   * everything else (agent-turn, or mixed agentTurn:true) → kind
+--     'agent_thread' from goal_spec.objective + goal_spec.completionCriteria +
+--     worker_spec.id/type, threadMode 'new_per_run'. A mixed Automation's
+--     bolt-on routine actions stay in routine_actions_spec (they are pre-steps
+--     of the agent-thread target, not the target) and are read from there at
+--     dispatch.
+--
+-- Data-only migration: the target_spec COLUMN already exists (added additively
+-- in 0210). This file writes data, not schema. Following the 0202 data-backfill
+-- precedent, it publishes a drift-marker VIEW whose presence proves the whole
+-- transaction committed; the `-- creates:` marker below is what the drift
+-- reporter (scripts/db-migrate-manual.sh) probes.
+--
+-- Idempotent: only rows WHERE target_spec IS NULL are updated; the marker view
+-- is CREATE OR REPLACE. Safe to re-run. dev has ~7 version rows; customer
+-- stages have 0.
+--
+-- Apply manually (verification pass before merge):
+--   psql "$DATABASE_URL" -v ON_ERROR_STOP=1 --single-transaction \
+--     -f packages/database-pg/drizzle/0211_backfill_agent_loop_versions_target_spec.sql
+--
+-- creates: public.view_agent_loop_versions_target_spec_backfilled
+
+\set ON_ERROR_STOP on
+
+BEGIN;
+
+SELECT pg_advisory_xact_lock(hashtext('agent_loop_versions_target_spec_backfill_0211'));
+
+SET LOCAL lock_timeout = '5s';
+SET LOCAL statement_timeout = '60s';
+
+DO $$
+BEGIN
+  IF to_regclass('public.agent_loop_versions') IS NULL THEN
+    RAISE EXCEPTION 'pre-flight: public.agent_loop_versions does not exist';
+  END IF;
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.columns
+    WHERE table_schema = 'public'
+      AND table_name = 'agent_loop_versions'
+      AND column_name = 'target_spec'
+  ) THEN
+    RAISE EXCEPTION 'pre-flight: public.agent_loop_versions.target_spec column missing (apply 0210 first)';
+  END IF;
+END $$;
+
+UPDATE public.agent_loop_versions v
+SET target_spec = CASE
+  WHEN v.routine_actions_spec IS NOT NULL
+   AND jsonb_typeof(v.routine_actions_spec -> 'actions') = 'array'
+   AND jsonb_array_length(v.routine_actions_spec -> 'actions') >= 1
+   AND (v.routine_actions_spec -> 'agentTurn') = to_jsonb(false)
+  THEN jsonb_strip_nulls(jsonb_build_object(
+    'kind', 'routine',
+    'routine', jsonb_strip_nulls(jsonb_build_object(
+      'routineId', v.routine_actions_spec -> 'actions' -> 0 ->> 'routineId',
+      'input', v.routine_actions_spec -> 'actions' -> 0 -> 'input',
+      'label', v.routine_actions_spec -> 'actions' -> 0 -> 'label',
+      'additionalActions', CASE
+        WHEN jsonb_array_length(v.routine_actions_spec -> 'actions') > 1
+        THEN (
+          SELECT jsonb_agg(a.elem ORDER BY a.ord)
+          FROM jsonb_array_elements(v.routine_actions_spec -> 'actions')
+               WITH ORDINALITY AS a(elem, ord)
+          WHERE a.ord > 1
+        )
+        ELSE NULL
+      END
+    ))
+  ))
+  ELSE jsonb_strip_nulls(jsonb_build_object(
+    'kind', 'agent_thread',
+    'agentThread', jsonb_strip_nulls(jsonb_build_object(
+      'instructions', COALESCE(v.goal_spec ->> 'objective', ''),
+      'completionCriteria', CASE
+        WHEN jsonb_typeof(v.goal_spec -> 'completionCriteria') = 'array'
+         AND jsonb_array_length(v.goal_spec -> 'completionCriteria') >= 1
+        THEN v.goal_spec -> 'completionCriteria'
+        ELSE NULL
+      END,
+      'workerId', v.worker_spec ->> 'id',
+      'workerType', CASE
+        WHEN v.worker_spec ->> 'type' IN ('agent', 'agent_profile')
+        THEN v.worker_spec ->> 'type'
+        ELSE NULL
+      END,
+      'threadMode', 'new_per_run'
+    ))
+  ))
+END
+WHERE v.target_spec IS NULL;
+
+-- Drift marker + summary. Presence proves the backfill transaction committed.
+CREATE OR REPLACE VIEW public.view_agent_loop_versions_target_spec_backfilled AS
+SELECT
+  COUNT(*)::int AS total_versions,
+  COUNT(*) FILTER (WHERE target_spec IS NOT NULL)::int AS with_target_spec,
+  COUNT(*) FILTER (WHERE target_spec IS NULL)::int AS missing_target_spec,
+  COUNT(*) FILTER (WHERE target_spec ->> 'kind' = 'agent_thread')::int AS agent_thread_targets,
+  COUNT(*) FILTER (WHERE target_spec ->> 'kind' = 'routine')::int AS routine_targets,
+  now() AS checked_at
+FROM public.agent_loop_versions;
+
+COMMENT ON VIEW public.view_agent_loop_versions_target_spec_backfilled IS
+  'Drift marker and summary for 0211_backfill_agent_loop_versions_target_spec.sql.';
+
+COMMIT;