@team-semicolon/semicolony-cli 4.18.51

package/dist/templates/launchd/ai.semicolony.host-signals-sidecar.plist

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  SemiColony host-signals sidecar — pushes pgrep/PID/auth-profile signals to semicolony.host_signals.
+
+  Spec: KB semicolony decision/dashboard-host-signals-sidecar-2026-05-07
+  Action item: 4ddac18f
+
+  Install:
+    cp packages/cli/templates/launchd/ai.semicolony.host-signals-sidecar.plist \
+       ~/Library/LaunchAgents/
+    launchctl load ~/Library/LaunchAgents/ai.semicolony.host-signals-sidecar.plist
+
+  Verify:
+    launchctl list | grep host-signals
+    semicolony host-signals show --limit 20
+
+  Polling: every 90 seconds (StartInterval). 5-minute dashboard freshness window
+  means missing 3 cycles → stale_count increments → daemon detection alert.
+-->
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>ai.semicolony.host-signals-sidecar</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/usr/local/bin/semicolony</string>
+    <string>host-signals</string>
+    <string>push</string>
+    <string>--quiet</string>
+  </array>
+  <key>StartInterval</key><integer>90</integer>
+  <key>StandardOutPath</key><string>/Users/reus/.semicolony/logs/host-signals-sidecar.log</string>
+  <key>StandardErrorPath</key><string>/Users/reus/.semicolony/logs/host-signals-sidecar.log</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>HOME</key><string>/Users/reus</string>
+    <key>PATH</key><string>/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
+  </dict>
+  <key>RunAtLoad</key><true/>
+</dict>
+</plist>

package/migrations/001_initial.sql

@@ -0,0 +1,280 @@
+-- 001_initial.sql
+-- 기존 semicolony 스키마 문서화 (모든 테이블은 이미 존재)
+-- IF NOT EXISTS로 안전하게 작성 — 새 환경에서도 적용 가능
+
+CREATE SCHEMA IF NOT EXISTS semicolony;
+
+-- pgvector
+CREATE EXTENSION IF NOT EXISTS vector;
+
+-- ============================================================
+-- 1. skills
+-- ============================================================
+CREATE TABLE IF NOT EXISTS semicolony.skills (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name VARCHAR(100) NOT NULL UNIQUE,
+  display_name VARCHAR(100),
+  description TEXT,
+  content TEXT NOT NULL,
+  category VARCHAR(50),
+  package VARCHAR(50) DEFAULT 'core',
+  is_active BOOLEAN DEFAULT true,
+  is_required BOOLEAN DEFAULT false,
+  install_order INT DEFAULT 100,
+  version VARCHAR(20) DEFAULT '1.0.0',
+  metadata JSONB DEFAULT '{}',
+  created_at TIMESTAMPTZ DEFAULT now(),
+  updated_at TIMESTAMPTZ DEFAULT now()
+);
+
+-- ============================================================
+-- 2. commands
+-- ============================================================
+CREATE TABLE IF NOT EXISTS semicolony.commands (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name VARCHAR(100) NOT NULL,
+  folder VARCHAR(50) NOT NULL,
+  content TEXT NOT NULL,
+  description TEXT,
+  is_active BOOLEAN DEFAULT true,
+  created_at TIMESTAMPTZ DEFAULT now(),
+  updated_at TIMESTAMPTZ DEFAULT now(),
+  UNIQUE(folder, name)
+);
+
+-- ============================================================
+-- 3. agents
+-- ============================================================
+CREATE TABLE IF NOT EXISTS semicolony.agents (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name VARCHAR(100) NOT NULL UNIQUE,
+  display_name VARCHAR(100),
+  content TEXT NOT NULL,
+  package VARCHAR(50) DEFAULT 'core',
+  is_active BOOLEAN DEFAULT true,
+  install_order INT DEFAULT 100,
+  created_at TIMESTAMPTZ DEFAULT now(),
+  updated_at TIMESTAMPTZ DEFAULT now()
+);
+
+-- ============================================================
+-- 4. packages
+-- ============================================================
+CREATE TABLE IF NOT EXISTS semicolony.packages (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name VARCHAR(100) NOT NULL UNIQUE,
+  display_name VARCHAR(100),
+  description TEXT,
+  layer VARCHAR(50),
+  package_type VARCHAR(50),
+  version VARCHAR(20) DEFAULT '1.0.0',
+  is_active BOOLEAN DEFAULT true,
+  is_required BOOLEAN DEFAULT false,
+  install_order INT DEFAULT 100,
+  created_at TIMESTAMPTZ DEFAULT now(),
+  updated_at TIMESTAMPTZ DEFAULT now()
+);
+
+-- ============================================================
+-- 5. knowledge_base (공통 KB)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS semicolony.knowledge_base (
+  kb_id BIGSERIAL PRIMARY KEY,
+  domain VARCHAR(100) NOT NULL,
+  key VARCHAR(255) NOT NULL,
+  content TEXT NOT NULL,
+  embedding vector(1024),
+  metadata JSONB DEFAULT '{}',
+  version INT DEFAULT 1,
+  created_by VARCHAR(50),
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  updated_at TIMESTAMPTZ DEFAULT NOW(),
+  UNIQUE(domain, key)
+);
+
+-- ============================================================
+-- 6. bot_knowledge (봇별 KB)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS semicolony.bot_knowledge (
+  id BIGSERIAL PRIMARY KEY,
+  bot_id VARCHAR(50) NOT NULL,
+  domain VARCHAR(100) NOT NULL,
+  key VARCHAR(255) NOT NULL,
+  content TEXT NOT NULL,
+  embedding vector(1024),
+  metadata JSONB DEFAULT '{}',
+  version INT DEFAULT 1,
+  synced_at TIMESTAMPTZ,
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  updated_at TIMESTAMPTZ DEFAULT NOW(),
+  UNIQUE(bot_id, domain, key)
+);
+
+-- ============================================================
+-- 7. ontology (도메인 스키마)
+-- ============================================================
+CREATE TABLE IF NOT EXISTS semicolony.ontology (
+  id BIGSERIAL PRIMARY KEY,
+  domain VARCHAR(100) NOT NULL UNIQUE,
+  schema JSONB NOT NULL,
+  description TEXT,
+  version INT DEFAULT 1,
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- ============================================================
+-- 8. bot_status
+-- ============================================================
+CREATE TABLE IF NOT EXISTS semicolony.bot_status (
+  bot_id TEXT PRIMARY KEY,
+  name TEXT,
+  emoji TEXT,
+  role TEXT,
+  last_active TIMESTAMP,
+  session_count INTEGER DEFAULT 0,
+  workspace_path TEXT,
+  status TEXT,
+  synced_at TIMESTAMP DEFAULT NOW()
+);
+
+-- ============================================================
+-- 9. bot_sessions
+-- ============================================================
+CREATE TABLE IF NOT EXISTS semicolony.bot_sessions (
+  bot_id TEXT NOT NULL,
+  session_key TEXT NOT NULL,
+  label TEXT,
+  kind TEXT,
+  chat_type TEXT,
+  last_activity TIMESTAMP,
+  message_count INTEGER DEFAULT 0,
+  synced_at TIMESTAMP DEFAULT NOW(),
+  PRIMARY KEY (bot_id, session_key)
+);
+
+-- ============================================================
+-- 10. bot_cron_jobs
+-- ============================================================
+CREATE TABLE IF NOT EXISTS semicolony.bot_cron_jobs (
+  bot_id TEXT NOT NULL,
+  job_id TEXT NOT NULL,
+  name TEXT,
+  schedule JSONB,
+  enabled BOOLEAN DEFAULT TRUE,
+  last_run TIMESTAMP,
+  next_run TIMESTAMP,
+  session_target TEXT,
+  synced_at TIMESTAMP DEFAULT NOW(),
+  PRIMARY KEY (bot_id, job_id)
+);
+
+-- ============================================================
+-- 11. bot_query_logs
+-- ============================================================
+CREATE TABLE IF NOT EXISTS semicolony.bot_query_logs (
+  id BIGSERIAL PRIMARY KEY,
+  bot_id TEXT NOT NULL,
+  user_id TEXT,
+  user_name TEXT,
+  channel TEXT,
+  channel_id TEXT,
+  thread_id TEXT,
+  query TEXT NOT NULL,
+  response TEXT,
+  model TEXT,
+  latency_ms INTEGER,
+  token_input INTEGER,
+  token_output INTEGER,
+  metadata JSONB DEFAULT '{}',
+  created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- ============================================================
+-- 기존 인덱스 (이미 존재하면 skip)
+-- ============================================================
+CREATE INDEX IF NOT EXISTS idx_semicolony_skills_name ON semicolony.skills(name);
+CREATE INDEX IF NOT EXISTS idx_semicolony_skills_active ON semicolony.skills(is_active);
+CREATE INDEX IF NOT EXISTS idx_semicolony_skills_category ON semicolony.skills(category);
+CREATE INDEX IF NOT EXISTS idx_semicolony_commands_folder ON semicolony.commands(folder);
+CREATE INDEX IF NOT EXISTS idx_semicolony_commands_active ON semicolony.commands(is_active);
+CREATE INDEX IF NOT EXISTS idx_semicolony_agents_name ON semicolony.agents(name);
+CREATE INDEX IF NOT EXISTS idx_semicolony_agents_active ON semicolony.agents(is_active);
+CREATE INDEX IF NOT EXISTS idx_semicolony_packages_name ON semicolony.packages(name);
+CREATE INDEX IF NOT EXISTS idx_semicolony_packages_layer ON semicolony.packages(layer);
+CREATE INDEX IF NOT EXISTS idx_semicolony_packages_active ON semicolony.packages(is_active);
+CREATE INDEX IF NOT EXISTS idx_kb_domain ON semicolony.knowledge_base(domain);
+CREATE INDEX IF NOT EXISTS idx_kb_created_by ON semicolony.knowledge_base(created_by);
+CREATE INDEX IF NOT EXISTS idx_kb_updated_at ON semicolony.knowledge_base(updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_kb_embedding ON semicolony.knowledge_base USING hnsw (embedding vector_cosine_ops) WITH (m = 16, ef_construction = 64);
+CREATE INDEX IF NOT EXISTS idx_botk_bot_id ON semicolony.bot_knowledge(bot_id);
+CREATE INDEX IF NOT EXISTS idx_botk_domain ON semicolony.bot_knowledge(bot_id, domain);
+CREATE INDEX IF NOT EXISTS idx_botk_updated_at ON semicolony.bot_knowledge(updated_at DESC);
+CREATE INDEX IF NOT EXISTS idx_botk_embedding ON semicolony.bot_knowledge USING hnsw (embedding vector_cosine_ops) WITH (m = 16, ef_construction = 64);
+CREATE INDEX IF NOT EXISTS idx_bot_status_synced_at ON semicolony.bot_status(synced_at);
+CREATE INDEX IF NOT EXISTS idx_bot_sessions_bot_id ON semicolony.bot_sessions(bot_id);
+CREATE INDEX IF NOT EXISTS idx_bot_sessions_last_activity ON semicolony.bot_sessions(last_activity DESC);
+CREATE INDEX IF NOT EXISTS idx_bot_cron_jobs_bot_id ON semicolony.bot_cron_jobs(bot_id);
+CREATE INDEX IF NOT EXISTS idx_bot_cron_jobs_next_run ON semicolony.bot_cron_jobs(next_run);
+
+-- ============================================================
+-- Helper: updated_at trigger function
+-- ============================================================
+CREATE OR REPLACE FUNCTION semicolony.update_updated_at()
+RETURNS TRIGGER AS $$
+BEGIN
+    NEW.updated_at = NOW();
+    NEW.version = COALESCE(OLD.version, 0) + 1;
+    RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+DO $$
+BEGIN
+    IF NOT EXISTS (SELECT 1 FROM pg_trigger WHERE tgname = 'trg_kb_updated_at') THEN
+        CREATE TRIGGER trg_kb_updated_at BEFORE UPDATE ON semicolony.knowledge_base
+            FOR EACH ROW EXECUTE FUNCTION semicolony.update_updated_at();
+    END IF;
+    IF NOT EXISTS (SELECT 1 FROM pg_trigger WHERE tgname = 'trg_botk_updated_at') THEN
+        CREATE TRIGGER trg_botk_updated_at BEFORE UPDATE ON semicolony.bot_knowledge
+            FOR EACH ROW EXECUTE FUNCTION semicolony.update_updated_at();
+    END IF;
+    IF NOT EXISTS (SELECT 1 FROM pg_trigger WHERE tgname = 'trg_onto_updated_at') THEN
+        CREATE TRIGGER trg_onto_updated_at BEFORE UPDATE ON semicolony.ontology
+            FOR EACH ROW EXECUTE FUNCTION semicolony.update_updated_at();
+    END IF;
+END $$;
+
+-- ============================================================
+-- Helper functions
+-- ============================================================
+CREATE OR REPLACE FUNCTION semicolony.get_active_skills()
+RETURNS TABLE (
+  name VARCHAR(100),
+  content TEXT,
+  category VARCHAR(50),
+  install_order INT
+) AS $$
+BEGIN
+  RETURN QUERY
+  SELECT s.name, s.content, s.category, s.install_order
+  FROM semicolony.skills s
+  WHERE s.is_active = true
+  ORDER BY s.install_order;
+END;
+$$ LANGUAGE plpgsql;
+
+CREATE OR REPLACE FUNCTION semicolony.get_skill_count_by_category()
+RETURNS TABLE (
+  category VARCHAR(50),
+  count BIGINT
+) AS $$
+BEGIN
+  RETURN QUERY
+  SELECT s.category, COUNT(*)::BIGINT
+  FROM semicolony.skills s
+  WHERE s.is_active = true
+  GROUP BY s.category
+  ORDER BY MIN(s.install_order);
+END;
+$$ LANGUAGE plpgsql;

package/migrations/002_add_indexes.sql

@@ -0,0 +1,11 @@
+-- 002_add_indexes.sql
+-- P1-2: 누락된 성능 인덱스 추가
+
+-- bot_status.status 필터용
+CREATE INDEX IF NOT EXISTS idx_bot_status_status ON semicolony.bot_status(status);
+
+-- bot_query_logs 조회 최적화
+CREATE INDEX IF NOT EXISTS idx_bql_bot_id ON semicolony.bot_query_logs(bot_id);
+CREATE INDEX IF NOT EXISTS idx_bql_user_id ON semicolony.bot_query_logs(user_id);
+CREATE INDEX IF NOT EXISTS idx_bql_created_at ON semicolony.bot_query_logs(created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_bql_channel_id ON semicolony.bot_query_logs(channel_id);

package/migrations/003_add_fk.sql

@@ -0,0 +1,32 @@
+-- 003_add_fk.sql
+-- P1-3: FK 제약 추가
+
+-- bot_sessions.bot_id → bot_status.bot_id
+DO $$
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.table_constraints
+    WHERE constraint_name = 'fk_sessions_bot'
+      AND table_schema = 'semicolony'
+  ) THEN
+    ALTER TABLE semicolony.bot_sessions
+      ADD CONSTRAINT fk_sessions_bot
+      FOREIGN KEY (bot_id) REFERENCES semicolony.bot_status(bot_id) ON DELETE CASCADE;
+  END IF;
+END $$;
+
+-- bot_cron_jobs.bot_id → bot_status.bot_id
+DO $$
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.table_constraints
+    WHERE constraint_name = 'fk_cron_jobs_bot'
+      AND table_schema = 'semicolony'
+  ) THEN
+    ALTER TABLE semicolony.bot_cron_jobs
+      ADD CONSTRAINT fk_cron_jobs_bot
+      FOREIGN KEY (bot_id) REFERENCES semicolony.bot_status(bot_id) ON DELETE CASCADE;
+  END IF;
+END $$;
+
+-- bot_query_logs는 FK 제외 — 로그 테이블은 참조 무결성보다 적재 안정성 우선

package/migrations/004_session_count_trigger.sql

@@ -0,0 +1,35 @@
+-- 004_session_count_trigger.sql
+-- P0-3: session_count 경쟁 조건 해결
+-- bot_sessions INSERT/DELETE 시 bot_status.session_count 자동 갱신 트리거
+
+CREATE OR REPLACE FUNCTION semicolony.update_session_count()
+RETURNS TRIGGER AS $$
+DECLARE
+  target_bot_id TEXT;
+BEGIN
+  IF TG_OP = 'DELETE' THEN
+    target_bot_id := OLD.bot_id;
+  ELSE
+    target_bot_id := NEW.bot_id;
+  END IF;
+
+  UPDATE semicolony.bot_status
+  SET session_count = (
+    SELECT COUNT(*) FROM semicolony.bot_sessions WHERE bot_id = target_bot_id
+  )
+  WHERE bot_id = target_bot_id;
+
+  IF TG_OP = 'DELETE' THEN
+    RETURN OLD;
+  ELSE
+    RETURN NEW;
+  END IF;
+END;
+$$ LANGUAGE plpgsql;
+
+-- 기존 트리거 있으면 교체
+DROP TRIGGER IF EXISTS trg_session_count ON semicolony.bot_sessions;
+
+CREATE TRIGGER trg_session_count
+  AFTER INSERT OR DELETE ON semicolony.bot_sessions
+  FOR EACH ROW EXECUTE FUNCTION semicolony.update_session_count();

package/migrations/005_bot_workspace_audits.sql

@@ -0,0 +1,16 @@
+-- Bot Workspace Audits
+-- 봇 워크스페이스 표준 구조 compliance 감사 결과 저장
+
+CREATE TABLE IF NOT EXISTS semicolony.bot_workspace_audits (
+  id          BIGSERIAL PRIMARY KEY,
+  bot_id      TEXT NOT NULL,
+  run_id      TEXT NOT NULL,
+  rating      TEXT NOT NULL,           -- 'GOOD' | 'NEEDS-WORK' | 'POOR'
+  score       INT NOT NULL DEFAULT 0,  -- 0-100
+  checks      JSONB NOT NULL,          -- [{ name, passed, detail }]
+  created_at  TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_bwa_bot_id ON semicolony.bot_workspace_audits(bot_id);
+CREATE INDEX IF NOT EXISTS idx_bwa_run_id ON semicolony.bot_workspace_audits(run_id);
+CREATE INDEX IF NOT EXISTS idx_bwa_created_at ON semicolony.bot_workspace_audits(created_at DESC);

package/migrations/006_bot_kb_subscriptions.sql

@@ -0,0 +1,24 @@
+-- 006: Bot KB Subscriptions
+-- 봇별 KB 도메인 구독 + 변경 다이제스트 워터마크
+
+CREATE TABLE IF NOT EXISTS semicolony.bot_kb_subscriptions (
+  bot_id VARCHAR(50) NOT NULL,
+  domain VARCHAR(100) NOT NULL,
+  last_synced_at TIMESTAMPTZ DEFAULT '1970-01-01T00:00:00Z',
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  PRIMARY KEY (bot_id, domain)
+);
+
+CREATE INDEX IF NOT EXISTS idx_bot_kb_subs_bot_id
+  ON semicolony.bot_kb_subscriptions(bot_id);
+
+-- Seed: 봇별 구독 도메인
+INSERT INTO semicolony.bot_kb_subscriptions (bot_id, domain) VALUES
+  ('semiclaw', 'team'), ('semiclaw', 'project'), ('semiclaw', 'decision'), ('semiclaw', 'process'), ('semiclaw', 'infra'),
+  ('workclaw', 'team'), ('workclaw', 'project'), ('workclaw', 'decision'), ('workclaw', 'process'),
+  ('reviewclaw', 'team'), ('reviewclaw', 'project'), ('reviewclaw', 'decision'),
+  ('planclaw', 'team'), ('planclaw', 'project'), ('planclaw', 'decision'), ('planclaw', 'process'),
+  ('designclaw', 'team'), ('designclaw', 'project'), ('designclaw', 'decision'),
+  ('infraclaw', 'team'), ('infraclaw', 'infra'), ('infraclaw', 'decision'),
+  ('growthclaw', 'team'), ('growthclaw', 'project'), ('growthclaw', 'decision')
+ON CONFLICT DO NOTHING;

package/migrations/007_flatten_skill_names.sql

@@ -0,0 +1,16 @@
+-- 007_flatten_skill_names.sql
+-- Flat skill naming: botId/skillName → skillName + metadata.bot_ids
+--
+-- 1. metadata.bot_id (string) → metadata.bot_ids (array) 변환
+-- 2. name에서 botId/ 프리픽스 제거
+
+-- Step 1: metadata.bot_id → metadata.bot_ids 배열로 변환
+UPDATE skill_definitions
+SET metadata = (metadata - 'bot_id') || jsonb_build_object('bot_ids', jsonb_build_array(metadata->>'bot_id'))
+WHERE metadata ? 'bot_id';
+
+-- Step 2: name에서 botId/ 프리픽스 제거
+UPDATE skill_definitions
+SET name = SUBSTRING(name FROM POSITION('/' IN name) + 1)
+WHERE name LIKE '%/%'
+  AND office_id IS NULL;

package/migrations/008_bot_workspace_files.sql

@@ -0,0 +1,14 @@
+-- Bot workspace file storage for Dashboard DB-based access
+-- Replaces local filesystem reads with DB queries
+
+CREATE TABLE IF NOT EXISTS semicolony.bot_workspace_files (
+    bot_id      TEXT NOT NULL,
+    file_path   TEXT NOT NULL,
+    content     TEXT NOT NULL,
+    file_size   INTEGER,
+    file_hash   TEXT,                   -- SHA-256, 변경 감지용
+    synced_at   TIMESTAMPTZ DEFAULT NOW(),
+    PRIMARY KEY (bot_id, file_path)
+);
+
+CREATE INDEX IF NOT EXISTS idx_bwf_bot ON semicolony.bot_workspace_files(bot_id);

package/migrations/009_enforce_flat_skill_names.sql

@@ -0,0 +1,53 @@
+-- 009_enforce_flat_skill_names.sql
+-- Enforce flat skill names (strip any remaining slashes)
+-- Also add CHECK constraint to prevent future slashes
+
+-- Step 1: flat 이름이 이미 존재하면 slash 버전의 metadata.bot_ids를 flat 버전에 병합 후 삭제
+-- (slash 버전에만 있는 bot_ids를 보존)
+WITH slash_skills AS (
+  SELECT id, name,
+         SUBSTRING(name FROM POSITION('/' IN name) + 1) AS flat_name,
+         metadata
+  FROM skill_definitions
+  WHERE name LIKE '%/%' AND office_id IS NULL
+),
+has_flat AS (
+  SELECT s.id AS slash_id, s.flat_name, s.metadata AS slash_meta,
+         f.id AS flat_id, f.metadata AS flat_meta
+  FROM slash_skills s
+  JOIN skill_definitions f ON f.name = s.flat_name AND f.office_id IS NULL
+)
+-- Merge bot_ids from slash version into flat version
+UPDATE skill_definitions f
+SET metadata = CASE
+  WHEN f.metadata ? 'bot_ids' AND hf.slash_meta ? 'bot_ids'
+    THEN jsonb_set(f.metadata, '{bot_ids}',
+      (SELECT jsonb_agg(DISTINCT val)
+       FROM (
+         SELECT val FROM jsonb_array_elements(f.metadata->'bot_ids') val
+         UNION
+         SELECT val FROM jsonb_array_elements(hf.slash_meta->'bot_ids') val
+       ) combined))
+  WHEN hf.slash_meta ? 'bot_ids'
+    THEN COALESCE(f.metadata, '{}'::jsonb) || jsonb_build_object('bot_ids', hf.slash_meta->'bot_ids')
+  ELSE f.metadata
+END
+FROM has_flat hf
+WHERE f.id = hf.flat_id;
+
+-- Step 2: Delete slash versions that have a flat counterpart
+DELETE FROM skill_definitions
+WHERE name LIKE '%/%'
+  AND office_id IS NULL
+  AND SUBSTRING(name FROM POSITION('/' IN name) + 1) IN (
+    SELECT name FROM skill_definitions WHERE name NOT LIKE '%/%' AND office_id IS NULL
+  );
+
+-- Step 3: Rename remaining slash versions (no flat counterpart)
+UPDATE skill_definitions
+SET name = SUBSTRING(name FROM POSITION('/' IN name) + 1)
+WHERE name LIKE '%/%' AND office_id IS NULL;
+
+-- Step 4: Prevent future slashes
+ALTER TABLE skill_definitions
+ADD CONSTRAINT skill_name_no_slash CHECK (name NOT LIKE '%/%');

package/migrations/010_bot_delegation.sql

@@ -0,0 +1,27 @@
+-- 010_bot_delegation.sql
+-- Bot delegation matrix: who can delegate what to whom
+
+CREATE TABLE IF NOT EXISTS semicolony.bot_delegation (
+  id SERIAL PRIMARY KEY,
+  from_bot_id TEXT NOT NULL,
+  to_bot_id TEXT NOT NULL,
+  delegation_type TEXT NOT NULL DEFAULT 'task',
+  domains TEXT[] NOT NULL DEFAULT '{}',
+  method TEXT NOT NULL DEFAULT 'github_issue',
+  channel TEXT,
+  max_roundtrips INT DEFAULT 5,
+  priority TEXT DEFAULT 'medium',
+  is_active BOOLEAN DEFAULT true,
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  updated_at TIMESTAMPTZ DEFAULT NOW(),
+  UNIQUE (from_bot_id, to_bot_id, delegation_type)
+);
+
+-- Protocol metadata (structured version of PROTOCOL.md)
+CREATE TABLE IF NOT EXISTS semicolony.bot_protocol (
+  id SERIAL PRIMARY KEY,
+  key TEXT NOT NULL UNIQUE,
+  value JSONB NOT NULL,
+  description TEXT,
+  updated_at TIMESTAMPTZ DEFAULT NOW()
+);

package/migrations/011_drop_legacy_tables.sql

@@ -0,0 +1,35 @@
+-- 011_drop_legacy_tables.sql
+-- 레거시 정규화 테이블 정리: KB(domain='project')가 SoT로 확정됨
+-- FK 의존관계 순서: 자식 → 부모
+
+BEGIN;
+
+-- Group A: 프로젝트 관리 계층 (KB domain='project'로 대체됨)
+DROP TABLE IF EXISTS semicolony.kpi_snapshots;
+DROP TABLE IF EXISTS semicolony.project_kpi;
+DROP TABLE IF EXISTS semicolony.tasks;          -- FK: projects, epics, sprints
+DROP TABLE IF EXISTS semicolony.sprints;        -- FK: projects
+DROP TABLE IF EXISTS semicolony.epics;          -- FK: projects
+DROP TABLE IF EXISTS semicolony.projects;       -- 루트 — KB가 SoT
+
+-- Group B: 워크플로우 엔진 (생성만 되고 사용 안 됨)
+DROP TABLE IF EXISTS semicolony.workflow_node_executions;  -- FK: instances, nodes
+DROP TABLE IF EXISTS semicolony.workflow_instances;         -- FK: definitions, nodes
+DROP TABLE IF EXISTS semicolony.workflow_nodes;             -- FK: definitions
+DROP TABLE IF EXISTS semicolony.workflow_definitions;       -- 루트
+
+-- Group C: 아카이브 코드에서만 참조 (mcp-server/_archived)
+DROP TABLE IF EXISTS semicolony.sessions;
+DROP TABLE IF EXISTS semicolony.interaction_logs;
+DROP TABLE IF EXISTS semicolony.embedding_requests;
+DROP TABLE IF EXISTS semicolony.user_facts;
+DROP TABLE IF EXISTS semicolony.memory_stats;
+DROP VIEW IF EXISTS semicolony.index_usage;
+DROP TABLE IF EXISTS semicolony.audit_logs;
+
+-- 마이그레이션 기록
+INSERT INTO semicolony.schema_migrations (version)
+VALUES ('011_drop_legacy_tables')
+ON CONFLICT (version) DO NOTHING;
+
+COMMIT;

package/migrations/012_drop_bot_knowledge.sql

@@ -0,0 +1,16 @@
+-- Migration 012: Drop bot_knowledge and bot_kb_subscriptions
+-- bot_knowledge 데이터를 knowledge_base로 이관 후 테이블 DROP.
+-- 봇 프라이빗 KB를 폐기하고 knowledge_base 단일 테이블로 통일.
+
+-- 1. bot_knowledge → knowledge_base 이관 (중복 시 skip)
+INSERT INTO semicolony.knowledge_base (domain, key, content, metadata, embedding, created_by)
+SELECT domain, key, content, metadata, embedding, bot_id AS created_by
+FROM semicolony.bot_knowledge
+ON CONFLICT (domain, key) DO NOTHING;
+
+-- 2. 테이블 DROP
+DROP TABLE IF EXISTS semicolony.bot_knowledge;
+DROP TABLE IF EXISTS semicolony.bot_kb_subscriptions;
+
+-- 3. bot:* 온톨로지 제거 (봇 프라이빗 KB 폐기로 불필요)
+DELETE FROM semicolony.ontology WHERE domain LIKE 'bot:%';