@team-semicolon/semicolony-cli 4.18.51

package/migrations/069_action_items_sot.sql

@@ -0,0 +1,156 @@
+-- 069: action_items — Single Source of Truth 전환
+--
+-- 변경 사항:
+--   A. owner_domain, target_domain 컬럼 추가 (ontology FK)
+--   B. 기존 데이터 마이그레이션 (project_id → target_domain, assignee → owner_domain)
+--   C. NOT NULL + FK 제약조건 설정
+--   D. project_id 컬럼 및 깨진 FK 제거
+--   E. 테이블 리네이밍: service_action_items → action_items
+--   F. 새 인덱스 생성
+--   G. 하위호환 VIEW 생성
+--   H. KB 스키마에서 action-item 키 제거
+--
+-- 배경:
+--   - service_action_items.project_id FK가 migration 052에서 리네이밍 누락되어 깨진 상태
+--   - KB와 DB 이중 구조 → DB를 유일한 SoT로 전환
+--   - 액션 아이템은 반드시 주체(owner_domain: team/person/bot)가 있어야 함
+--   - 대상 서비스/프로젝트(target_domain)는 선택적
+--
+-- 선행 조건: 068_migrate_incubator_data.sql
+
+BEGIN;
+
+-- ============================================================
+-- 선행 검증: semicolon 도메인 존재 확인 (B5 폴백에 필요)
+-- ============================================================
+DO $$
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM semicolony.ontology WHERE domain = 'semicolon') THEN
+    RAISE EXCEPTION 'ontology domain "semicolon" must exist before this migration';
+  END IF;
+END $$;
+
+-- ============================================================
+-- A. 새 컬럼 추가
+-- ============================================================
+
+ALTER TABLE semicolony.service_action_items
+  ADD COLUMN IF NOT EXISTS owner_domain VARCHAR(100),
+  ADD COLUMN IF NOT EXISTS target_domain VARCHAR(100);
+
+-- ============================================================
+-- B. 기존 데이터 마이그레이션
+-- ============================================================
+
+-- B1: target_domain ← service_id → services.service_domain
+UPDATE semicolony.service_action_items ai
+SET target_domain = s.service_domain
+FROM semicolony.services s
+WHERE ai.service_id = s.service_id
+  AND ai.target_domain IS NULL;
+
+-- B2: owner_domain ← assignee가 ontology domain과 직접 매칭 (team 타입)
+UPDATE semicolony.service_action_items ai
+SET owner_domain = o.domain
+FROM semicolony.ontology o
+WHERE o.entity_type = 'team'
+  AND LOWER(ai.assignee) = LOWER(o.domain)
+  AND ai.owner_domain IS NULL;
+
+-- B3: owner_domain ← kb-sync 메타데이터의 kb_domain
+UPDATE semicolony.service_action_items
+SET owner_domain = metadata->>'kb_domain'
+WHERE owner_domain IS NULL
+  AND source = 'kb-sync'
+  AND metadata->>'kb_domain' IS NOT NULL
+  AND EXISTS (
+    SELECT 1 FROM semicolony.ontology WHERE domain = metadata->>'kb_domain'
+  );
+
+-- B4: owner_domain ← assignee가 nickname과 매칭
+UPDATE semicolony.service_action_items ai
+SET owner_domain = kb.domain
+FROM semicolony.knowledge_base kb
+WHERE kb.key = 'nickname'
+  AND LOWER(TRIM(kb.content)) = LOWER(ai.assignee)
+  AND ai.owner_domain IS NULL;
+
+-- B5: owner_domain 남은 NULL → target_domain 폴백, 최종적으로 'semicolon'
+UPDATE semicolony.service_action_items
+SET owner_domain = COALESCE(target_domain, 'semicolon')
+WHERE owner_domain IS NULL;
+
+-- ============================================================
+-- C. NOT NULL + FK 제약조건
+-- ============================================================
+
+ALTER TABLE semicolony.service_action_items
+  ALTER COLUMN owner_domain SET NOT NULL;
+
+ALTER TABLE semicolony.service_action_items
+  ADD CONSTRAINT action_items_owner_domain_fkey
+    FOREIGN KEY (owner_domain) REFERENCES semicolony.ontology(domain);
+
+ALTER TABLE semicolony.service_action_items
+  ADD CONSTRAINT action_items_target_domain_fkey
+    FOREIGN KEY (target_domain) REFERENCES semicolony.ontology(domain);
+
+-- ============================================================
+-- D. service_id 컬럼 및 FK 제거 (owner_domain + target_domain으로 대체)
+-- ============================================================
+
+ALTER TABLE semicolony.service_action_items
+  DROP CONSTRAINT IF EXISTS service_action_items_service_id_fkey;
+
+DROP INDEX IF EXISTS semicolony.idx_sai_project_status;
+
+ALTER TABLE semicolony.service_action_items
+  DROP COLUMN IF EXISTS service_id;
+
+-- ============================================================
+-- E. 테이블 리네이밍
+-- ============================================================
+
+ALTER TABLE semicolony.service_action_items RENAME TO action_items;
+
+DO $$ BEGIN
+  ALTER TRIGGER trg_service_action_items_updated ON semicolony.action_items
+    RENAME TO trg_action_items_updated;
+EXCEPTION WHEN undefined_object THEN NULL;
+END $$;
+
+DO $$ BEGIN
+  ALTER INDEX semicolony.idx_sai_assignee
+    RENAME TO idx_action_items_assignee;
+EXCEPTION WHEN undefined_object THEN NULL;
+END $$;
+
+-- ============================================================
+-- F. 새 인덱스
+-- ============================================================
+
+CREATE INDEX idx_action_items_owner_status
+  ON semicolony.action_items(owner_domain, status);
+
+CREATE INDEX idx_action_items_target_status
+  ON semicolony.action_items(target_domain, status)
+  WHERE target_domain IS NOT NULL;
+
+CREATE INDEX idx_action_items_created
+  ON semicolony.action_items(created_at DESC);
+
+-- ============================================================
+-- G. 하위호환 VIEW (기존 코드가 service_action_items 참조 시 호환)
+-- ============================================================
+
+CREATE VIEW semicolony.service_action_items AS
+  SELECT * FROM semicolony.action_items;
+
+-- ============================================================
+-- H. KB 스키마에서 action-item 키 제거
+-- ============================================================
+
+DELETE FROM semicolony.kb_type_schema
+WHERE scheme_key = 'action-item';
+
+COMMIT;

package/migrations/069_cost_log_tokens.sql

@@ -0,0 +1,45 @@
+-- 069: bot_cost_log에 토큰 추적 컬럼 추가 + 비용 뷰를 bot_cost_log 기반으로 전환
+-- Agent SDK SDKResultMessage.usage.apiUsage에서 토큰 데이터 기록
+
+BEGIN;
+
+-- 1. 토큰 컬럼 추가
+ALTER TABLE semicolony.bot_cost_log
+  ADD COLUMN IF NOT EXISTS input_tokens INT DEFAULT 0,
+  ADD COLUMN IF NOT EXISTS output_tokens INT DEFAULT 0,
+  ADD COLUMN IF NOT EXISTS cache_read_tokens INT DEFAULT 0,
+  ADD COLUMN IF NOT EXISTS cache_creation_tokens INT DEFAULT 0,
+  ADD COLUMN IF NOT EXISTS num_turns INT DEFAULT 1,
+  ADD COLUMN IF NOT EXISTS duration_ms INT;
+
+-- 2. service_id 인덱스 (프로젝트별 비용 집계용)
+CREATE INDEX IF NOT EXISTS idx_cost_log_service
+  ON semicolony.bot_cost_log (service_id) WHERE service_id IS NOT NULL;
+
+-- 3. 기존 뷰 DROP 후 bot_cost_log 기반으로 재생성 (레거시 bot_query_logs → bot_cost_log)
+-- bot_id 타입이 다를 수 있으므로 CREATE OR REPLACE 대신 DROP + CREATE
+DROP VIEW IF EXISTS semicolony.bot_cost_summary;
+DROP VIEW IF EXISTS semicolony.bot_cost_daily;
+
+CREATE VIEW semicolony.bot_cost_summary AS
+SELECT bot_id,
+       date_trunc('month', created_at)::date AS month,
+       COUNT(*) AS query_count,
+       COALESCE(SUM(input_tokens), 0) AS total_input_tokens,
+       COALESCE(SUM(output_tokens), 0) AS total_output_tokens,
+       COALESCE(SUM(cost_usd), 0) AS total_cost_usd,
+       COALESCE(AVG(duration_ms), 0)::int AS avg_latency_ms
+FROM semicolony.bot_cost_log
+GROUP BY bot_id, date_trunc('month', created_at);
+
+CREATE VIEW semicolony.bot_cost_daily AS
+SELECT bot_id,
+       created_at::date AS day,
+       COUNT(*) AS query_count,
+       COALESCE(SUM(input_tokens), 0) AS total_input_tokens,
+       COALESCE(SUM(output_tokens), 0) AS total_output_tokens,
+       COALESCE(SUM(cost_usd), 0) AS total_cost_usd
+FROM semicolony.bot_cost_log
+GROUP BY bot_id, created_at::date;
+
+COMMIT;

package/migrations/070_services_sot_columns.sql

@@ -0,0 +1,78 @@
+-- 070: services 테이블 SoT 강화 — KB-only 메타데이터를 DB 컬럼으로 이전
+-- KB의 singleton 키(tech-stack, service-url, bm, repo, slack-channel)를 services 컬럼으로 승격.
+-- status, po(owner_name)는 이미 DB에 있으므로 KB 키만 제거 대상.
+
+BEGIN;
+
+-- 1. 컬럼 추가
+ALTER TABLE semicolony.services
+  ADD COLUMN IF NOT EXISTS tech_stack TEXT,
+  ADD COLUMN IF NOT EXISTS service_url TEXT,
+  ADD COLUMN IF NOT EXISTS bm TEXT,
+  ADD COLUMN IF NOT EXISTS repo TEXT,
+  ADD COLUMN IF NOT EXISTS slack_channel TEXT;
+
+-- 2. KB → DB 데이터 이전 (tech-stack — 원문 그대로 저장, 마크다운/리스트 혼재)
+UPDATE semicolony.services s SET tech_stack = (
+  SELECT TRIM(kb.content)
+  FROM semicolony.knowledge_base kb
+  WHERE kb.domain = s.service_domain
+    AND kb.key = 'tech-stack' AND kb.sub_key = ''
+    AND kb.content IS NOT NULL AND kb.content != ''
+    AND kb.content NOT LIKE '%(미입력)%'
+)
+WHERE s.service_domain IS NOT NULL AND s.tech_stack IS NULL;
+
+-- 3. KB → DB 데이터 이전 (service-url)
+UPDATE semicolony.services s SET service_url = (
+  SELECT kb.content
+  FROM semicolony.knowledge_base kb
+  WHERE kb.domain = s.service_domain
+    AND kb.key = 'service-url' AND kb.sub_key = ''
+    AND kb.content IS NOT NULL AND kb.content != ''
+    AND kb.content NOT LIKE '%(미입력)%'
+)
+WHERE s.service_domain IS NOT NULL AND s.service_url IS NULL;
+
+-- 4. KB → DB 데이터 이전 (bm)
+UPDATE semicolony.services s SET bm = (
+  SELECT kb.content
+  FROM semicolony.knowledge_base kb
+  WHERE kb.domain = s.service_domain
+    AND kb.key = 'bm' AND kb.sub_key = ''
+    AND kb.content IS NOT NULL AND kb.content != ''
+    AND kb.content NOT LIKE '%(미입력)%'
+)
+WHERE s.service_domain IS NOT NULL AND s.bm IS NULL;
+
+-- 5. KB → DB 데이터 이전 (repo)
+UPDATE semicolony.services s SET repo = (
+  SELECT kb.content
+  FROM semicolony.knowledge_base kb
+  WHERE kb.domain = s.service_domain
+    AND kb.key = 'repo' AND kb.sub_key = ''
+    AND kb.content IS NOT NULL AND kb.content != ''
+    AND kb.content NOT LIKE '%(미입력)%'
+)
+WHERE s.service_domain IS NOT NULL AND s.repo IS NULL;
+
+-- 6. KB → DB 데이터 이전 (slack-channel)
+UPDATE semicolony.services s SET slack_channel = (
+  SELECT kb.content
+  FROM semicolony.knowledge_base kb
+  WHERE kb.domain = s.service_domain
+    AND kb.key = 'slack-channel' AND kb.sub_key = ''
+    AND kb.content IS NOT NULL AND kb.content != ''
+    AND kb.content NOT LIKE '%(미입력)%'
+)
+WHERE s.service_domain IS NOT NULL AND s.slack_channel IS NULL;
+
+-- 7. KB service 타입 스키마에서 이전된 키 제거
+DELETE FROM semicolony.kb_type_schema
+WHERE type_key = 'service'
+  AND scheme_key IN ('tech-stack', 'service-url', 'bm', 'repo', 'slack-channel', 'status', 'po');
+
+-- 8. 이전된 KB 엔트리는 보존 (향후 정리 시 수동 삭제 가능)
+-- KB 데이터 자체는 삭제하지 않음 — 스키마 키만 제거하여 신규 upsert 차단
+
+COMMIT;

package/migrations/071_cleanup_deprecated_service_kb.sql

@@ -0,0 +1,38 @@
+-- 071: service 타입 deprecated KB 엔트리 정리 + DB 트리거
+-- migration 070에서 services 테이블로 데이터 복사 완료 후 스키마만 제거했으나,
+-- 레거시 KB 엔트리가 남아있고 raw SQL 쓰기 차단이 없었음.
+
+BEGIN;
+
+-- Part A: service 타입 도메인의 deprecated KB 엔트리 삭제
+-- (migration 070에서 이미 services 테이블로 데이터 복사 완료)
+DELETE FROM semicolony.knowledge_base kb
+USING semicolony.ontology o
+WHERE kb.domain = o.domain
+  AND o.entity_type = 'service'
+  AND kb.key IN ('status', 'po', 'tech-stack', 'service-url', 'bm', 'repo', 'slack-channel')
+  AND kb.sub_key = '';
+
+-- Part B: raw SQL 통한 deprecated 키 쓰기 차단 트리거
+CREATE OR REPLACE FUNCTION semicolony.reject_deprecated_service_kb_keys()
+RETURNS TRIGGER AS $$
+BEGIN
+  IF NEW.key IN ('status', 'po', 'tech-stack', 'service-url', 'bm', 'repo', 'slack-channel')
+     AND NEW.sub_key = ''
+     AND EXISTS (
+       SELECT 1 FROM semicolony.ontology
+       WHERE domain = NEW.domain AND entity_type = 'service'
+     )
+  THEN
+    RAISE EXCEPTION 'KB key "%" is deprecated for service-type domains. Use: semicolony service update --domain %', NEW.key, NEW.domain;
+  END IF;
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE TRIGGER trg_reject_deprecated_service_kb
+  BEFORE INSERT OR UPDATE ON semicolony.knowledge_base
+  FOR EACH ROW
+  EXECUTE FUNCTION semicolony.reject_deprecated_service_kb_keys();
+
+COMMIT;

package/migrations/072_incubator_heartbeat.sql

@@ -0,0 +1,12 @@
+-- 072: Incubator Sessions Heartbeat
+-- channel-slack이 주기적으로 heartbeat를 전송하여 세션 활성 상태를 증명.
+-- orchestrator는 heartbeat가 stale인 세션을 자동 정리하여 중복 응답 방지.
+
+ALTER TABLE semicolony.incubator_sessions
+  ADD COLUMN IF NOT EXISTS last_heartbeat TIMESTAMPTZ DEFAULT NULL,
+  ADD COLUMN IF NOT EXISTS heartbeat_stale_threshold_sec INTEGER DEFAULT 180,
+  ADD COLUMN IF NOT EXISTS stopped_reason TEXT DEFAULT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_incubator_heartbeat
+  ON semicolony.incubator_sessions(status, last_heartbeat)
+  WHERE status = 'active';

package/migrations/072_service_role_schema.sql

@@ -0,0 +1,57 @@
+-- 072: 서비스 Role 시스템 표준화
+--
+-- 변경 사항:
+--   1. kb_type_schema에 'role' collection 키 추가 (service 타입)
+--   2. 사용되지 않는 'members' 키 제거
+--   3. role/po upsert 시 services.owner_name 자동 동기화 trigger
+--
+-- 배경:
+--   서비스별 역할(PO, 개발, 디자인 등)이 base-information에 자유형으로 섞여있어
+--   검색/조회 불가. role/{role-name} collection 키로 표준화.
+--
+-- 선행 조건: 071
+
+BEGIN;
+
+-- ============================================================
+-- 1. role collection 키 추가
+-- ============================================================
+
+INSERT INTO semicolony.kb_type_schema (type_key, scheme_key, scheme_description, required, value_hint, sort_order, key_type)
+VALUES ('service', 'role', '서비스 역할 매핑 (PO, 개발, 디자인 등)', false,
+        'role/po, role/lead-dev, role/backend, role/frontend, role/designer, role/ops, role/planner. content는 ontology team 도메인 (소문자). 복수: 쉼표 구분.', 15, 'collection')
+ON CONFLICT DO NOTHING;
+
+-- ============================================================
+-- 2. members 키 제거 (dead key — 전체 서비스 KB 엔트리 0건)
+-- ============================================================
+
+DELETE FROM semicolony.kb_type_schema
+WHERE type_key = 'service' AND scheme_key = 'members';
+
+-- ============================================================
+-- 3. role/po → services.owner_name 동기화 trigger
+-- ============================================================
+
+CREATE OR REPLACE FUNCTION semicolony.sync_role_po_to_owner()
+RETURNS TRIGGER AS $$
+BEGIN
+  IF NEW.key = 'role' AND NEW.sub_key = 'po' THEN
+    UPDATE semicolony.services
+    SET owner_name = TRIM(SPLIT_PART(NEW.content, ',', 1))
+    WHERE service_domain = NEW.domain;
+  END IF;
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+-- 기존 trigger가 있으면 교체
+DROP TRIGGER IF EXISTS trg_sync_role_po ON semicolony.knowledge_base;
+
+CREATE TRIGGER trg_sync_role_po
+  AFTER INSERT OR UPDATE ON semicolony.knowledge_base
+  FOR EACH ROW
+  WHEN (NEW.key = 'role' AND NEW.sub_key = 'po')
+  EXECUTE FUNCTION semicolony.sync_role_po_to_owner();
+
+COMMIT;

package/migrations/073_service_type_and_platform.sql

@@ -0,0 +1,8 @@
+-- 073: service_type_and_platform (공개 배포용 no-op 스텁)
+--
+-- 원본은 세미콜론 tenant 전용 parent-child 서비스 매핑을 포함.
+--
+-- 세미콜론 DB 는 이미 적용됨. 신규 설치자는 이 파일을 건너뛴다 (schema 변경 없음).
+BEGIN;
+-- historical no-op
+COMMIT;

package/migrations/074_schema_ref_type.sql

@@ -0,0 +1,16 @@
+-- 074_schema_ref_type.sql
+-- kb_type_schema에 ref_type 컬럼 추가
+-- 특정 키의 값이 다른 온톨로지 도메인을 참조해야 할 때, 참조 대상 타입을 지정
+-- upsert 시 content가 해당 타입의 등록된 도메인인지 자동 검증
+
+-- 1. ref_type 컬럼 추가
+ALTER TABLE semicolony.kb_type_schema
+  ADD COLUMN IF NOT EXISTS ref_type VARCHAR(100)
+    REFERENCES semicolony.ontology_types(type_key);
+
+COMMENT ON COLUMN semicolony.kb_type_schema.ref_type IS
+  '값이 참조해야 하는 온톨로지 타입. 설정 시 content가 해당 타입의 도메인으로 존재하는지 upsert 시 검증.';
+
+-- 2. person.organization은 하이브리드 허용 (도메인명 우선, 자유 텍스트 폴백)
+-- ref_type 강제 검증을 걸지 않고 value_hint로만 가이드한다.
+-- ref_type이 필요한 키가 생기면 여기에 UPDATE 추가.

package/migrations/075_routing_delegation.sql

@@ -0,0 +1,34 @@
+-- 075_routing_delegation.sql
+-- bot_delegation에 KB-driven 라우팅 데이터 추가
+-- orchestrator router.ts의 하드코딩 라우팅을 DB 기반으로 전환
+
+BEGIN;
+
+-- 1. metadata 컬럼 추가 (스킬 힌트, 정렬 순서 등 확장용)
+ALTER TABLE semicolony.bot_delegation ADD COLUMN IF NOT EXISTS metadata JSONB DEFAULT '{}';
+
+-- 2. unique constraint 완화 (같은 봇에 routing 여러 행 허용 — designclaw stitch + 일반)
+ALTER TABLE semicolony.bot_delegation
+  DROP CONSTRAINT IF EXISTS bot_delegation_from_bot_id_to_bot_id_delegation_type_key;
+
+CREATE UNIQUE INDEX IF NOT EXISTS bot_delegation_unique_v2
+  ON semicolony.bot_delegation (from_bot_id, to_bot_id, delegation_type, COALESCE(metadata->>'label', ''));
+
+-- 3. 키워드 라우팅 시드 (orchestrator → 봇, metadata.order로 우선순위 관리)
+INSERT INTO semicolony.bot_delegation (from_bot_id, to_bot_id, delegation_type, domains, method, priority, metadata) VALUES
+  ('orchestrator', 'designclaw', 'routing', ARRAY['stitch 리뷰 완료','스티치 리뷰 완료','스티치 완료','디자인 승인'], 'keyword', 'high',   '{"label":"stitch","order":1}'),
+  ('orchestrator', 'infraclaw',  'routing', ARRAY['인프라','배포','cicd','deploy','서버','쿠버','k8s','docker','argocd'], 'keyword', 'medium', '{"label":"infra","order":2}'),
+  ('orchestrator', 'designclaw', 'routing', ARRAY['디자인','ui','ux','컬러','폰트','레이아웃','tailwind','css','퍼블리싱'], 'keyword', 'medium', '{"label":"design","order":3}'),
+  ('orchestrator', 'reviewclaw', 'routing', ARRAY['리뷰','review','qa','테스트','test','버그','bug','품질'], 'keyword', 'medium', '{"label":"review","order":4}'),
+  ('orchestrator', 'growthclaw', 'routing', ARRAY['마케팅','seo','그로스','트래픽','전환율','키워드','콘텐츠','광고','트래킹','커뮤니티 게시','백링크','조회수'], 'keyword', 'medium', '{"label":"growth","order":5}'),
+  ('orchestrator', 'workclaw',   'routing', ARRAY['코딩','구현','개발','코드','fix','feature','pr','풀리퀘'], 'keyword', 'medium', '{"label":"work","order":6}'),
+  ('orchestrator', 'planclaw',   'routing', ARRAY['기획','스펙','prd','요구사항','epic','유저스토리','플로우'], 'keyword', 'medium', '{"label":"plan","order":7}')
+ON CONFLICT DO NOTHING;
+
+-- 4. 스킬 라우팅 시드 (orchestrator → 봇 + 스킬 힌트)
+INSERT INTO semicolony.bot_delegation (from_bot_id, to_bot_id, delegation_type, domains, method, metadata) VALUES
+  ('orchestrator', 'semiclaw', 'skill-routing', ARRAY['액션아이템','action item','할일','todo 확인','할일 추적'], 'keyword', '{"skill":"action-item-tracker","label":"action-items"}'),
+  ('orchestrator', 'semiclaw', 'skill-routing', ARRAY['서비스 현황','서비스 상태','서비스 조회','서비스 목록','서비스 브리핑','service status','service list'], 'keyword', '{"skill":"service-briefing","label":"service-briefing"}')
+ON CONFLICT DO NOTHING;
+
+COMMIT;

package/migrations/076_meeting_service_link.sql

@@ -0,0 +1,5 @@
+-- 회의에 서비스/프로젝트 연동 (optional FK)
+ALTER TABLE semicolony.meetings
+  ADD COLUMN IF NOT EXISTS service_id UUID REFERENCES semicolony.services(service_id);
+
+CREATE INDEX IF NOT EXISTS idx_meetings_service ON semicolony.meetings (service_id);

package/migrations/077_agents_ontology_type.sql

@@ -0,0 +1,93 @@
+-- 077: agents 온톨로지 타입 + Architecture B 에이전트 KB 시딩
+BEGIN;
+
+-- 1. agents 타입 생성
+INSERT INTO semicolony.ontology_types (type_key, description)
+VALUES ('agents', 'Architecture B 에이전트 — 정체성, 위임, 도구, 슬랙 프로필')
+ON CONFLICT (type_key) DO NOTHING;
+
+-- 2. 스키마 키 등록
+INSERT INTO semicolony.kb_type_schema (type_key, scheme_key, scheme_description, required, value_hint, sort_order, key_type) VALUES
+  ('agents', 'identity',       '에이전트 기본 정보 (이름, 이모지, 역할)',               true,  'YAML: name, emoji, tagline, role, agent_type (orchestrator|specialist)', 1, 'singleton'),
+  ('agents', 'model-config',   '모델 설정 (기본 모델, 예산, opus 트리거)',              true,  'YAML: base_model, max_turns, max_budget, opus_trigger_keywords[]', 2, 'singleton'),
+  ('agents', 'delegation',     '담당 도메인 + 위임 규칙',                              true,  '마크다운: 담당 키워드, 에스컬레이션 대상', 3, 'singleton'),
+  ('agents', 'tools',          '사용 가능한 도구 목록',                                false, 'YAML: tools[], mcp_servers{}', 4, 'singleton'),
+  ('agents', 'skills',         '할당된 스킬 목록',                                     false, '스킬 이름 + 트리거 키워드', 5, 'collection'),
+  ('agents', 'slack-profile',  'Slack 표시 정체성',                                    true,  'YAML: username, icon_emoji, slack_user_id', 6, 'singleton'),
+  ('agents', 'kb-access',      'KB 접근 허용 도메인 목록',                              false, 'YAML: domains[] (빈 = 전체 허용)', 7, 'singleton'),
+  ('agents', 'status',         '현재 상태',                                            true,  'online | offline | maintenance', 8, 'singleton'),
+  ('agents', 'cron-schedule',  '크론 작업 목록',                                       false, '마크다운: 스케줄 + 설명 테이블', 9, 'singleton')
+ON CONFLICT (type_key, scheme_key) DO UPDATE SET
+  scheme_description = EXCLUDED.scheme_description,
+  required = EXCLUDED.required,
+  value_hint = EXCLUDED.value_hint,
+  sort_order = EXCLUDED.sort_order;
+
+-- 3. 기존 bot 도메인 → agents 타입으로 전환
+UPDATE semicolony.ontology
+SET entity_type = 'agents'
+WHERE entity_type = 'bot'
+  AND domain IN (SELECT bot_id FROM semicolony.bot_status WHERE status != 'retired');
+
+-- 4. identity 시딩 (bot_status → KB)
+INSERT INTO semicolony.knowledge_base (domain, key, sub_key, content, metadata, created_by)
+SELECT
+  bs.bot_id, 'identity', '',
+  format(E'name: %s\nemoji: %s\ntagline: %s\nrole: %s\nagent_type: %s',
+    COALESCE(bs.name, bs.bot_id),
+    COALESCE(bs.emoji, ':robot_face:'),
+    COALESCE(bs.role, bs.bot_id || ' 에이전트'),
+    COALESCE(bs.role, '-'),
+    CASE WHEN bs.bot_id = 'semiclaw' THEN 'orchestrator' ELSE 'specialist' END
+  ),
+  '{}', 'migration-077'
+FROM semicolony.bot_status bs
+WHERE bs.status != 'retired'
+ON CONFLICT (domain, key, sub_key) DO UPDATE SET
+  content = EXCLUDED.content, updated_at = now();
+
+-- 5. delegation 시딩 (bot_delegation → KB)
+INSERT INTO semicolony.knowledge_base (domain, key, sub_key, content, metadata, created_by)
+SELECT
+  sub.to_bot_id, 'delegation', '',
+  format(E'## 수신 키워드\n%s\n\n## 에스컬레이션\n- 담당 밖 요청 → escalate("semiclaw", reason, context)', sub.keyword_list),
+  '{}', 'migration-077'
+FROM (
+  SELECT
+    to_bot_id,
+    string_agg('- ' || kw, E'\n' ORDER BY kw) AS keyword_list
+  FROM (
+    SELECT to_bot_id, unnest(domains) AS kw
+    FROM semicolony.bot_delegation
+    WHERE is_active = true
+  ) expanded
+  GROUP BY to_bot_id
+) sub
+ON CONFLICT (domain, key, sub_key) DO UPDATE SET
+  content = EXCLUDED.content, updated_at = now();
+
+-- 6. model-config 시딩
+INSERT INTO semicolony.knowledge_base (domain, key, sub_key, content, metadata, created_by) VALUES
+  ('semiclaw',   'model-config', '', E'base_model: sonnet\nmax_turns: 50\nmax_budget: 1.5',  '{}', 'migration-077'),
+  ('planclaw',   'model-config', '', E'base_model: sonnet\nmax_turns: 40\nmax_budget: 1.0',  '{}', 'migration-077'),
+  ('designclaw', 'model-config', '', E'base_model: sonnet\nmax_turns: 40\nmax_budget: 1.0',  '{}', 'migration-077'),
+  ('workclaw',   'model-config', '', E'base_model: sonnet\nmax_turns: 40\nmax_budget: 1.5',  '{}', 'migration-077'),
+  ('reviewclaw', 'model-config', '', E'base_model: sonnet\nmax_turns: 40\nmax_budget: 0.8',  '{}', 'migration-077'),
+  ('infraclaw',  'model-config', '', E'base_model: sonnet\nmax_turns: 40\nmax_budget: 1.0',  '{}', 'migration-077'),
+  ('growthclaw', 'model-config', '', E'base_model: sonnet\nmax_turns: 40\nmax_budget: 0.5',  '{}', 'migration-077')
+ON CONFLICT (domain, key, sub_key) DO UPDATE SET
+  content = EXCLUDED.content, updated_at = now();
+
+-- 7. status 시딩
+INSERT INTO semicolony.knowledge_base (domain, key, sub_key, content, metadata, created_by)
+SELECT bot_id, 'status', '', COALESCE(status, 'online'), '{}', 'migration-077'
+FROM semicolony.bot_status WHERE status != 'retired'
+ON CONFLICT (domain, key, sub_key) DO UPDATE SET
+  content = EXCLUDED.content, updated_at = now();
+
+-- 8. bot 타입 deprecated 마킹
+UPDATE semicolony.ontology_types
+SET description = '[DEPRECATED — agents 타입 사용] OpenClaw 봇 에이전트'
+WHERE type_key = 'bot';
+
+COMMIT;

package/migrations/078_incubator_agent.sql

@@ -0,0 +1,45 @@
+-- 078: Incubator Agent 등록
+-- incubator 전용 에이전트: 인큐베이터 파이프라인 오케스트레이션 전담
+
+-- 1. bot_status 등록
+INSERT INTO semicolony.bot_status (bot_id, name, emoji, role, status, workspace_path)
+VALUES ('incubator', 'Incubator', ':hatching_chick:', 'Incubator Pipeline Orchestrator', 'online', '~/.semicolony-bot-sessions/incubator')
+ON CONFLICT (bot_id) DO UPDATE SET status = 'online', role = EXCLUDED.role, name = EXCLUDED.name, emoji = EXCLUDED.emoji;
+
+-- 2. ontology 도메인 등록 (agents 타입)
+INSERT INTO semicolony.ontology (domain, entity_type, description, parent, schema)
+VALUES ('incubator', 'agents', 'Incubator Pipeline Orchestrator', 'semicolony', '{}'::jsonb)
+ON CONFLICT (domain) DO UPDATE SET entity_type = 'agents', description = EXCLUDED.description;
+
+-- 3. orchestrator → incubator 키워드 라우팅
+INSERT INTO semicolony.bot_delegation (from_bot_id, to_bot_id, delegation_type, domains, method, is_active, metadata)
+VALUES ('orchestrator', 'incubator', 'routing',
+  ARRAY['인큐베이팅','인큐베이터','incubator','incubating','샌드박스 시작','sandbox create'],
+  'keyword', true, '{"label":"incubator","order":0}')
+ON CONFLICT (from_bot_id, to_bot_id, delegation_type, COALESCE(metadata->>'label', '')) DO NOTHING;
+
+-- 4. orchestrator → incubator 스킬 라우팅
+INSERT INTO semicolony.bot_delegation (from_bot_id, to_bot_id, delegation_type, domains, method, is_active, metadata)
+VALUES ('orchestrator', 'incubator', 'skill-routing',
+  ARRAY['인큐베이팅 시작','인큐베이팅 진행','인큐베이팅 이어서','인큐베이팅 현황','인큐베이터 시작','sandbox'],
+  'keyword', true, '{"skill":"semicolony-incubator","label":"incubator-skill"}')
+ON CONFLICT (from_bot_id, to_bot_id, delegation_type, COALESCE(metadata->>'label', '')) DO NOTHING;
+
+-- 5. incubator → 전문 봇 위임 (CP별)
+INSERT INTO semicolony.bot_delegation (from_bot_id, to_bot_id, delegation_type, domains, method, is_active, metadata) VALUES
+  ('incubator', 'planclaw',   'task', ARRAY['planning','requirements','prd','cp-2','cp-3'],       'escalation', true, '{"label":"cp-plan"}'),
+  ('incubator', 'designclaw', 'task', ARRAY['design','ui','ux','cp-3'],                           'escalation', true, '{"label":"cp-design"}'),
+  ('incubator', 'infraclaw',  'task', ARRAY['infra','deploy','cp-4','cp-7','cp-8','cp-9'],        'escalation', true, '{"label":"cp-infra"}'),
+  ('incubator', 'workclaw',   'task', ARRAY['implementation','dev','cp-5'],                       'escalation', true, '{"label":"cp-work"}'),
+  ('incubator', 'reviewclaw', 'task', ARRAY['review','qa','cp-6'],                                'escalation', true, '{"label":"cp-review"}'),
+  ('incubator', 'growthclaw', 'task', ARRAY['growth','marketing','cp-9'],                         'escalation', true, '{"label":"cp-growth"}')
+ON CONFLICT (from_bot_id, to_bot_id, delegation_type, COALESCE(metadata->>'label', '')) DO NOTHING;
+
+-- 6. semicolony-incubator 스킬을 incubator 봇으로 이전
+UPDATE semicolony.skill_definitions
+SET metadata = jsonb_set(
+  COALESCE(metadata, '{}'::jsonb),
+  '{bot_ids}',
+  '["incubator"]'::jsonb
+)
+WHERE name = 'semicolony-incubator';

package/migrations/079_drop_audio_blob_url.sql

@@ -0,0 +1,4 @@
+-- 079: 미사용 audio_blob_url 컬럼 제거
+-- Vercel Blob 도입 후 철회 (bytea 유지 결정). 077에서 추가된 컬럼 정리.
+
+ALTER TABLE semicolony.meetings DROP COLUMN IF EXISTS audio_blob_url;

package/migrations/080_kb_metadata_indexing.sql

@@ -0,0 +1,9 @@
+-- 080: GIN index on knowledge_base.metadata for JSONB filtering queries
+-- Enables KB as universal data layer with metadata-based querying
+
+CREATE INDEX IF NOT EXISTS idx_kb_metadata_gin
+  ON semicolony.knowledge_base USING GIN(metadata jsonb_path_ops);
+
+CREATE INDEX IF NOT EXISTS idx_kb_metadata_status
+  ON semicolony.knowledge_base((metadata->>'status'))
+  WHERE metadata->>'status' IS NOT NULL;