@team-semicolon/semicolony-cli 4.18.51

package/migrations/125_agent_personas.sql

@@ -0,0 +1,36 @@
+-- 125: agent_personas — 고객용 base 에이전트 행동 SoT (Semi/Colony 및 향후 고객 봇)
+--
+-- 설계: docs/superpowers/specs/2026-06-02-agent-behavior-sot-and-propagation-design.md
+-- 배경: Semi/Colony 행동(SOUL.md)의 단일 SoT 를 DB 로 승격. 프로토타입 hermes SOUL.md 와
+--       미래 고객 install 이 모두 여기서 resolve. operator(슬랙)가 컨펌 기반으로 편집.
+-- 주의: semicolony.agent_definitions(내부 7봇 → ~/.claude/agents 동기화)와는 별개 테이블이다.
+
+BEGIN;
+
+CREATE TABLE IF NOT EXISTS semicolony.agent_personas (
+  slug         TEXT PRIMARY KEY,                 -- 'semi','colony','jumuni' ...
+  display_name TEXT,
+  soul_md      TEXT NOT NULL,                    -- 행동 정의 본문 (= 현 SOUL.md)
+  version      INTEGER NOT NULL DEFAULT 1,
+  status       TEXT NOT NULL DEFAULT 'active'
+                 CHECK (status IN ('active', 'deprecated')),
+  updated_by   TEXT,                             -- 'mark' | 'reus' | ... (감사)
+  created_at   TIMESTAMPTZ NOT NULL DEFAULT now(),
+  updated_at   TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+-- 편집 이력 (롤백·감사·diff 근거). 매 편집마다 append.
+CREATE TABLE IF NOT EXISTS semicolony.agent_persona_revisions (
+  id         UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  slug       TEXT NOT NULL REFERENCES semicolony.agent_personas(slug) ON DELETE CASCADE,
+  version    INTEGER NOT NULL,
+  soul_md    TEXT NOT NULL,
+  updated_by TEXT,
+  note       TEXT,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT now()
+);
+
+CREATE INDEX IF NOT EXISTS idx_agent_persona_revisions_slug
+  ON semicolony.agent_persona_revisions(slug, version);
+
+COMMIT;

package/migrations/128_entity_relations.sql

@@ -0,0 +1,125 @@
+-- 128_entity_relations.sql
+-- semicolony 제품 facade 기반: 고객/플랫폼 엔티티 관계 그래프.
+--
+-- 원칙:
+--   - additive only: 기존 KB/ontology/action_items/bot_commitments write path 변경 없음.
+--   - relation_type은 DB 등록 테이블로 통제한다. free-string relation을 금지한다.
+--   - 추출 relation은 proposed가 기본이며 승인 후 approved로 live projection에 노출한다.
+--   - tenant_id와 scope를 분리해 tenant-local 관계와 platform-global 관계를 구분한다.
+-- runner(db.ts)가 파일 전체를 BEGIN/COMMIT 으로 감싸므로 여기엔 트랜잭션 구문을 넣지 않는다.
+
+CREATE TABLE IF NOT EXISTS semicolony.relation_types (
+  relation_type TEXT PRIMARY KEY,
+  description TEXT NOT NULL,
+  inverse_type TEXT,
+  status TEXT NOT NULL DEFAULT 'active'
+    CHECK (status IN ('active', 'retired')),
+  metadata JSONB NOT NULL DEFAULT '{}'::jsonb,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+COMMENT ON TABLE semicolony.relation_types IS
+  '등록형 relation enum. 코드 배포 없이 relation_type을 통제 추가하되 free-string 관계 생성을 막는다.';
+
+INSERT INTO semicolony.relation_types (relation_type, description, inverse_type)
+VALUES
+  ('owned_by', '엔티티의 소유/책임 주체', 'owns'),
+  ('owns', '소유/책임지는 대상', 'owned_by'),
+  ('depends_on', '완료/운영에 필요한 선행 의존성', 'required_by'),
+  ('required_by', '다른 엔티티가 의존하는 선행 항목', 'depends_on'),
+  ('decided_by', '결정한 사람/팀/에이전트', 'decided'),
+  ('decided', '결정 주체가 내린 결정', 'decided_by'),
+  ('blocks', '다른 업무/엔티티를 막는 원인', 'blocked_by'),
+  ('blocked_by', '다른 업무/엔티티에 의해 막힘', 'blocks'),
+  ('uses_tool', '업무 수행에 사용하는 도구/시스템', 'used_by'),
+  ('used_by', '도구/시스템을 사용하는 주체', 'uses_tool'),
+  ('requires_approval', '실행 전 승인이 필요한 대상', 'approves'),
+  ('approves', '승인 권한/승인 주체', 'requires_approval'),
+  ('reported_to', '보고 대상 사람/팀/에이전트', 'receives_report_from'),
+  ('receives_report_from', '보고를 받는 관계의 역방향', 'reported_to')
+ON CONFLICT (relation_type) DO NOTHING;
+
+CREATE TABLE IF NOT EXISTS semicolony.entity_relations (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id UUID,
+  scope TEXT NOT NULL DEFAULT 'tenant-local'
+    CHECK (scope IN ('tenant-local', 'platform-global')),
+  source_ref JSONB NOT NULL
+    CHECK (jsonb_typeof(source_ref) = 'object'),
+  relation_type TEXT NOT NULL
+    REFERENCES semicolony.relation_types(relation_type),
+  target_ref JSONB NOT NULL
+    CHECK (jsonb_typeof(target_ref) = 'object'),
+  status TEXT NOT NULL DEFAULT 'proposed'
+    CHECK (status IN ('proposed', 'approved', 'retired', 'rejected')),
+  confidence NUMERIC(5,4)
+    CHECK (confidence IS NULL OR (confidence >= 0 AND confidence <= 1)),
+  provenance JSONB NOT NULL DEFAULT '{}'::jsonb,
+  acl JSONB NOT NULL DEFAULT '{}'::jsonb,
+  metadata JSONB NOT NULL DEFAULT '{}'::jsonb,
+  created_by TEXT,
+  approved_by TEXT,
+  approved_at TIMESTAMPTZ,
+  retired_at TIMESTAMPTZ,
+  valid_from TIMESTAMPTZ,
+  valid_to TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  CHECK (scope = 'platform-global' OR tenant_id IS NOT NULL),
+  CHECK (valid_to IS NULL OR valid_from IS NULL OR valid_to >= valid_from)
+);
+
+COMMENT ON TABLE semicolony.entity_relations IS
+  '고객 업무 facade용 관계 그래프. proposed→approved 승인 게이트를 통과한 관계만 live projection에서 사용한다.';
+COMMENT ON COLUMN semicolony.entity_relations.source_ref IS
+  '관계 출발점. 예: {"kind":"agent","id":"ag-team-jumuni"} 또는 {"kind":"kb","domain":"axoracle","key":"decision","sub_key":"..."}';
+COMMENT ON COLUMN semicolony.entity_relations.target_ref IS
+  '관계 도착점. source_ref와 같은 JSON object reference 규약을 쓴다.';
+COMMENT ON COLUMN semicolony.entity_relations.provenance IS
+  '추출/승인 출처. 예: {"source":"onboarding","message_ts":"...","extractor":"colony"}';
+COMMENT ON COLUMN semicolony.entity_relations.acl IS
+  'tenant/user/agent별 읽기·실행 제한 메타데이터. enforcement는 후속 phase에서 적용한다.';
+
+CREATE INDEX IF NOT EXISTS idx_relation_types_status
+  ON semicolony.relation_types (status);
+
+CREATE INDEX IF NOT EXISTS idx_entity_relations_tenant_status
+  ON semicolony.entity_relations (tenant_id, status);
+
+CREATE INDEX IF NOT EXISTS idx_entity_relations_scope_status
+  ON semicolony.entity_relations (scope, status);
+
+CREATE INDEX IF NOT EXISTS idx_entity_relations_type_status
+  ON semicolony.entity_relations (relation_type, status);
+
+CREATE INDEX IF NOT EXISTS idx_entity_relations_source_ref
+  ON semicolony.entity_relations USING GIN (source_ref jsonb_path_ops);
+
+CREATE INDEX IF NOT EXISTS idx_entity_relations_target_ref
+  ON semicolony.entity_relations USING GIN (target_ref jsonb_path_ops);
+
+CREATE OR REPLACE FUNCTION semicolony.trg_relations_updated()
+RETURNS TRIGGER AS $$
+BEGIN
+  NEW.updated_at = NOW();
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+DROP TRIGGER IF EXISTS trg_relation_types_updated ON semicolony.relation_types;
+CREATE TRIGGER trg_relation_types_updated
+  BEFORE UPDATE ON semicolony.relation_types
+  FOR EACH ROW EXECUTE FUNCTION semicolony.trg_relations_updated();
+
+DROP TRIGGER IF EXISTS trg_entity_relations_updated ON semicolony.entity_relations;
+CREATE TRIGGER trg_entity_relations_updated
+  BEFORE UPDATE ON semicolony.entity_relations
+  FOR EACH ROW EXECUTE FUNCTION semicolony.trg_relations_updated();
+
+CREATE OR REPLACE VIEW semicolony.v_entity_relations_live AS
+SELECT *
+FROM semicolony.entity_relations
+WHERE status = 'approved'
+  AND (valid_from IS NULL OR valid_from <= NOW())
+  AND (valid_to IS NULL OR valid_to > NOW());

package/migrations/129_kb_multitenant_gateway.sql

@@ -0,0 +1,86 @@
+-- 129_kb_multitenant_gateway.sql
+-- SemiColony 멀티테넌트 KB 게이트웨이 기반 스키마.
+-- 결정: semicolony/decision/semicolony-gateway-tenancy-auth-persona-resolved
+--       (+ 원 결정 semicolony-kb-access-via-multitenant-api-gateway)
+-- 선례: 128_entity_relations.sql (tenant_id + scope CHECK), 107_agent_service_credentials.sql (token_hash vault).
+--
+-- 핵심 설계(zero blast radius):
+--   - knowledge_base 에 tenant_id + scope 를 **가산적**으로 추가(기존 행은 전부 platform-global/NULL → 무변경).
+--   - 물리적 키 격리는 per-tenant 도메인 `t-{tenantSlug}` 로 수행 → 기존 UNIQUE(domain,key,sub_key) 와
+--     ON CONFLICT(domain,key,sub_key) 를 쓰는 10개 writer 를 **건드리지 않는다**(도메인이 테넌트를 내포).
+--   - tenant_id 컬럼은 RLS(Phase 2)·cascade·분석·게이트웨이 이중검증용 비정규화.
+--
+-- 러너(db.ts)가 파일 전체를 BEGIN/COMMIT 으로 감싸고 `semicolony.` 한정자를 활성 스키마로 retarget 한다.
+--   → 여기엔 트랜잭션 구문을 넣지 않는다. `public.` 은 retarget 대상이 아니므로 appdb 공용 스키마 그대로 유지.
+
+-- ============================================================
+-- 0) ontology_types: 'tenant-kb' 타입 등록
+--    ontology.entity_type → ontology_types.type_key FK 가 있으므로, 게이트웨이가 런타임에
+--    per-tenant 도메인(t-{slug})을 ontology 에 등록하려면 이 타입이 먼저 존재해야 한다.
+--    팀 서비스 카탈로그 타입(service/module/agents…)과 분리된 고객 KB 전용 타입.
+-- ============================================================
+INSERT INTO semicolony.ontology_types (type_key, schema, description)
+VALUES ('tenant-kb', '{}'::jsonb, '고객(Colony) 테넌트 KB 네임스페이스 — per-tenant 도메인 t-{slug}')
+ON CONFLICT (type_key) DO NOTHING;
+
+-- ============================================================
+-- 1) knowledge_base: 테넌트 스코프 (가산적·비파괴, 128 패턴 동형)
+-- ============================================================
+ALTER TABLE semicolony.knowledge_base
+  ADD COLUMN IF NOT EXISTS tenant_id UUID,
+  ADD COLUMN IF NOT EXISTS scope TEXT NOT NULL DEFAULT 'platform-global';
+
+DO $$
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_constraint
+    WHERE conname = 'kb_scope_enum_chk'
+      AND conrelid = 'semicolony.knowledge_base'::regclass
+  ) THEN
+    ALTER TABLE semicolony.knowledge_base
+      ADD CONSTRAINT kb_scope_enum_chk CHECK (scope IN ('tenant-local', 'platform-global'));
+  END IF;
+  -- 128 과 동일한 무결성: tenant-local 행은 반드시 tenant_id 를 가진다.
+  IF NOT EXISTS (
+    SELECT 1 FROM pg_constraint
+    WHERE conname = 'kb_tenant_scope_chk'
+      AND conrelid = 'semicolony.knowledge_base'::regclass
+  ) THEN
+    ALTER TABLE semicolony.knowledge_base
+      ADD CONSTRAINT kb_tenant_scope_chk CHECK (scope = 'platform-global' OR tenant_id IS NOT NULL);
+  END IF;
+END $$;
+
+-- tenant-local 조회/cascade 용 인덱스 (platform-global=NULL 행은 partial 로 제외 → 작고 빠름).
+CREATE INDEX IF NOT EXISTS idx_kb_tenant
+  ON semicolony.knowledge_base (tenant_id)
+  WHERE tenant_id IS NOT NULL;
+
+-- ============================================================
+-- 2) gateway_credentials: per-tenant bearer 자격증명 (107_agent_service_credentials 미러)
+--    게이트웨이가 DB 를 보는 유일한 주체이므로, 외부 Colony 인증의 SoT.
+-- ============================================================
+CREATE TABLE IF NOT EXISTS semicolony.gateway_credentials (
+  id             UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id      UUID NOT NULL REFERENCES public.tenants(id) ON DELETE CASCADE,
+  tenant_slug    TEXT NOT NULL,                       -- 도메인 t-{slug} 파생용 비정규화
+  token_hash     TEXT NOT NULL UNIQUE,                -- sha256(token) — 평문은 저장 안 함
+  token_prefix   TEXT NOT NULL,                       -- 식별용 접두(sck_{slug}_xxxxx)
+  scopes         TEXT[] NOT NULL DEFAULT ARRAY['kb:read','kb:write','persona:read'],
+  status         TEXT NOT NULL DEFAULT 'active' CHECK (status IN ('active','revoked')),
+  issued_at      TIMESTAMPTZ NOT NULL DEFAULT now(),
+  expires_at     TIMESTAMPTZ,
+  last_used_at   TIMESTAMPTZ,
+  revoked_at     TIMESTAMPTZ,
+  revoked_reason TEXT,
+  issued_by      TEXT,
+  metadata       JSONB NOT NULL DEFAULT '{}'::jsonb
+);
+
+CREATE INDEX IF NOT EXISTS idx_gateway_credentials_tenant
+  ON semicolony.gateway_credentials (tenant_id, status);
+
+-- 회전(rotate) 시 활성 자격증명을 빠르게 찾기 위한 부분 인덱스.
+CREATE INDEX IF NOT EXISTS idx_gateway_credentials_active
+  ON semicolony.gateway_credentials (tenant_slug)
+  WHERE status = 'active';

package/migrations/130_jewelry_relation_types.sql

@@ -0,0 +1,36 @@
+-- 130_jewelry_relation_types.sql
+-- 소상공인(주얼리) 1차 온톨로지 컨벤션 — relation_types 데이터 시드.
+-- 원칙(128 계승): 업종별 DDL 금지. generic 테이블에 ROW 만 추가(ON CONFLICT DO NOTHING).
+--   엔티티 kind 는 source_ref/target_ref JSON 의 "kind" 컨벤션:
+--   product·material·category·customer·segment·order·supplier·channel·promo·season·review·care_guide·occasion·brand
+--   속성(가격·소재명·사이즈)은 관계가 아니라 KB(knowledge_base)/ref 에 저장. 여기는 엔티티 간 "관계"만.
+
+INSERT INTO semicolony.relation_types (relation_type, description, inverse_type) VALUES
+  ('made_of', '상품이 사용하는 소재(product→material)', 'material_of'),
+  ('material_of', '소재가 쓰인 상품(역방향)', 'made_of'),
+  ('variant_of', '색상/사이즈 변형이 본품의(variant→base)', 'has_variant'),
+  ('has_variant', '본품이 가지는 변형(역방향)', 'variant_of'),
+  ('in_category', '상품이 속한 카테고리(product→category)', 'category_has'),
+  ('category_has', '카테고리가 포함하는 상품(역방향)', 'in_category'),
+  ('listed_on', '상품이 등록된 판매채널(product→channel)', 'lists_product'),
+  ('lists_product', '채널이 노출하는 상품(역방향)', 'listed_on'),
+  ('supplied_by', '상품/소재의 공급처(→supplier)', 'supplies'),
+  ('supplies', '공급처가 대는 상품/소재(역방향)', 'supplied_by'),
+  ('targets_segment', '상품이 겨냥하는 고객군(product→segment)', 'segment_targeted_by'),
+  ('segment_targeted_by', '고객군을 겨냥하는 상품(역방향)', 'targets_segment'),
+  ('promoted_by', '상품을 홍보하는 이벤트/프로모(product→promo)', 'promotes'),
+  ('promotes', '프로모가 홍보하는 상품(역방향)', 'promoted_by'),
+  ('bundled_with', '함께 묶이는 상품(선물세트, product-product)', 'bundled_with'),
+  ('season_for', '상품이 적합한 시즌/기념일(product→season)', 'season_includes'),
+  ('season_includes', '시즌이 미는 상품(역방향)', 'season_for'),
+  ('gift_suitable_for', '상품이 어울리는 선물 상황(product→occasion)', 'occasion_fits'),
+  ('occasion_fits', '선물 상황에 맞는 상품(역방향)', 'gift_suitable_for'),
+  ('cared_by', '상품의 관리법(product→care_guide)', 'care_for'),
+  ('care_for', '관리법이 적용되는 상품(역방향)', 'cared_by'),
+  ('ordered_by', '주문을 넣은 고객(order→customer)', 'placed_order'),
+  ('placed_order', '고객이 넣은 주문(역방향)', 'ordered_by'),
+  ('contains_item', '주문이 포함하는 상품(order→product)', 'item_in_order'),
+  ('item_in_order', '상품이 담긴 주문(역방향)', 'contains_item'),
+  ('reviewed_in', '상품에 달린 리뷰(product→review)', 'review_of'),
+  ('review_of', '리뷰가 가리키는 상품(역방향)', 'reviewed_in')
+ON CONFLICT (relation_type) DO NOTHING;

package/migrations/131_concierge_requests.sql

@@ -0,0 +1,38 @@
+-- 131_concierge_requests.sql
+-- E4 컨시어지 요청 큐 — 고객이 요청(예: 이미지 생성)하면 적재 → 우리 팀이 처리 → 산출물 전달.
+-- additive only. tenant_id 격리(129 패턴). kind 통제(현재 image; 확장 가능).
+CREATE TABLE IF NOT EXISTS semicolony.concierge_requests (
+  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  tenant_id UUID NOT NULL,
+  kind TEXT NOT NULL DEFAULT 'image'
+    CHECK (kind IN ('image', 'other')),
+  payload JSONB NOT NULL DEFAULT '{}'::jsonb,       -- 요청 상세(상품·스타일·문구 등)
+  status TEXT NOT NULL DEFAULT 'pending'
+    CHECK (status IN ('pending', 'in_progress', 'delivered', 'rejected', 'canceled')),
+  requested_by TEXT,                                 -- 사장님/에이전트
+  assignee TEXT,                                     -- 처리 담당(우리 팀)
+  result_ref JSONB,                                  -- 전달 산출물 참조(중앙 저장 경로 등)
+  notified_at TIMESTAMPTZ,                           -- 우리 슬랙 알림 시각
+  delivered_at TIMESTAMPTZ,
+  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+COMMENT ON TABLE semicolony.concierge_requests IS
+  'E4 컨시어지 요청 큐(이미지 등). pending→in_progress→delivered. tenant 격리.';
+
+CREATE INDEX IF NOT EXISTS idx_concierge_tenant_status
+  ON semicolony.concierge_requests (tenant_id, status);
+CREATE INDEX IF NOT EXISTS idx_concierge_status_created
+  ON semicolony.concierge_requests (status, created_at);
+
+DROP TRIGGER IF EXISTS trg_concierge_updated ON semicolony.concierge_requests;
+CREATE TRIGGER trg_concierge_updated
+  BEFORE UPDATE ON semicolony.concierge_requests
+  FOR EACH ROW EXECUTE FUNCTION semicolony.trg_relations_updated();  -- 128에서 정의한 updated_at 트리거 재사용
+
+-- 우리 팀 처리 대기열 뷰(오래된 순)
+CREATE OR REPLACE VIEW semicolony.v_concierge_queue AS
+SELECT id, tenant_id, kind, payload, requested_by, created_at
+FROM semicolony.concierge_requests
+WHERE status = 'pending'
+ORDER BY created_at;

package/migrations/132_kb_supersession.sql

@@ -0,0 +1,27 @@
+-- 132_kb_supersession.sql
+-- 지식 도서관 "폐가/최신판 관리"(G2) — 본문 supersession 컬럼.
+-- 설계: docs/superpowers/specs/2026-06-12-knowledge-library-design.md (M1).
+-- additive only / 멱등. ⚠️ kb_history(113) 트리거는 OLD 스냅샷(감사)만 보관 → 검색가능한 superseded 행이 아님.
+--   따라서 "현행 유효 vs 폐기" 구분은 아래 컬럼으로 표현한다. 기존 행은 전부 is_latest=true(default)로 무해.
+-- ⚠️ 검색 기본필터(is_latest) 적용은 코드 측 "검색 계약"(D4) 변경 + 회귀테스트 통과 후 별도 적용.
+
+ALTER TABLE semicolony.knowledge_base
+  ADD COLUMN IF NOT EXISTS is_latest     BOOLEAN NOT NULL DEFAULT TRUE,
+  ADD COLUMN IF NOT EXISTS superseded_by BIGINT  NULL REFERENCES semicolony.knowledge_base(kb_id),
+  ADD COLUMN IF NOT EXISTS supersedes    BIGINT  NULL REFERENCES semicolony.knowledge_base(kb_id),
+  ADD COLUMN IF NOT EXISTS valid_from    TIMESTAMPTZ NULL,   -- 현실시간 유효 시작(미상=NULL 허용)
+  ADD COLUMN IF NOT EXISTS valid_to      TIMESTAMPTZ NULL;   -- 폐기/만료(미상=NULL)
+
+COMMENT ON COLUMN semicolony.knowledge_base.is_latest IS
+  '현행 유효 장서 여부. 모순 대체 시 옛 행 false. 검색 기본은 is_latest=true (검색계약 D4).';
+COMMENT ON COLUMN semicolony.knowledge_base.superseded_by IS '이 장서를 대체한 새 장서 kb_id.';
+
+-- 현행 장서 빠른 조회용 partial index
+CREATE INDEX IF NOT EXISTS idx_kb_is_latest
+  ON semicolony.knowledge_base (domain, is_latest) WHERE is_latest = TRUE;
+CREATE INDEX IF NOT EXISTS idx_kb_superseded_by
+  ON semicolony.knowledge_base (superseded_by) WHERE superseded_by IS NOT NULL;
+
+-- 현행 장서 뷰(검색계약 적용 전, 코드가 점진 채택)
+CREATE OR REPLACE VIEW semicolony.v_kb_current AS
+  SELECT * FROM semicolony.knowledge_base WHERE is_latest = TRUE;

package/migrations/133_kb_claims.sql

@@ -0,0 +1,52 @@
+-- 133_kb_claims.sql
+-- 지식 도서관 "원자 사실 카드"(G1) sidecar — 문서 행을 쪼개지 않고 옆에 붙인다.
+-- 설계: docs/superpowers/specs/2026-06-12-knowledge-library-design.md (M2).
+-- additive only / 멱등. 가격·담당자·상태·정책·영업시간·고객속성 등 바뀌고 검증가능한 최소 단위.
+-- 권위 모델: Colony 추출 등은 status='proposed'로만 적재 → 승인(D3 선택 게이트) 후 approved 만 응대에 사용.
+
+CREATE TABLE IF NOT EXISTS semicolony.kb_claims (
+  kb_claim_id      BIGSERIAL PRIMARY KEY,
+  tenant_id        UUID NOT NULL,
+  scope            TEXT NOT NULL DEFAULT 'tenant-local'
+    CHECK (scope IN ('tenant-local', 'platform-global')),
+  source_kb_id     BIGINT NULL REFERENCES semicolony.knowledge_base(kb_id),  -- 출처 문서(있으면)
+  subject_ref      JSONB NOT NULL,             -- 주어(엔티티) 참조 {kind,id,...}
+  predicate        TEXT  NOT NULL,             -- 술어(통제 어휘 권장)
+  object_ref       JSONB NULL,                 -- 목적어가 엔티티면
+  object_value     TEXT  NULL,                 -- 목적어가 리터럴(가격·상태 등)이면
+  status           TEXT  NOT NULL DEFAULT 'proposed'
+    CHECK (status IN ('proposed', 'approved', 'retired', 'rejected')),
+  confidence       NUMERIC NULL CHECK (confidence IS NULL OR (confidence >= 0 AND confidence <= 1)),
+  evidence         JSONB NULL,                 -- 근거(메시지 ts·span·출처)
+  extractor_version TEXT NULL,                 -- 어떤 추출기/버전이 제안했나
+  valid_from       TIMESTAMPTZ NULL,           -- 현실시간 유효(미상=NULL 허용)
+  valid_to         TIMESTAMPTZ NULL,
+  tx_from          TIMESTAMPTZ NOT NULL DEFAULT NOW(),  -- DB 시간(bitemporal)
+  tx_to            TIMESTAMPTZ NULL,
+  created_by       TEXT NULL,
+  approved_by      TEXT NULL,
+  approved_at      TIMESTAMPTZ NULL,
+  created_at       TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at       TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  CHECK (object_ref IS NOT NULL OR object_value IS NOT NULL)
+);
+COMMENT ON TABLE semicolony.kb_claims IS
+  '원자 사실 카드(sidecar). proposed→approved 게이트. bitemporal(valid_*/tx_*). 응대는 approved+current만.';
+
+CREATE INDEX IF NOT EXISTS idx_kb_claims_tenant_status ON semicolony.kb_claims (tenant_id, status);
+CREATE INDEX IF NOT EXISTS idx_kb_claims_subject       ON semicolony.kb_claims USING gin (subject_ref);
+CREATE INDEX IF NOT EXISTS idx_kb_claims_source        ON semicolony.kb_claims (source_kb_id) WHERE source_kb_id IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_kb_claims_current       ON semicolony.kb_claims (tenant_id, predicate)
+  WHERE status = 'approved' AND tx_to IS NULL;
+
+DROP TRIGGER IF EXISTS trg_kb_claims_updated ON semicolony.kb_claims;
+CREATE TRIGGER trg_kb_claims_updated
+  BEFORE UPDATE ON semicolony.kb_claims
+  FOR EACH ROW EXECUTE FUNCTION semicolony.trg_relations_updated();  -- 128 정의 updated_at 트리거 재사용
+
+-- 현행·승인된 사실만(응대 그라운딩용)
+CREATE OR REPLACE VIEW semicolony.v_kb_claims_current AS
+  SELECT * FROM semicolony.kb_claims
+  WHERE status = 'approved'
+    AND tx_to IS NULL
+    AND (valid_to IS NULL OR valid_to > NOW());

package/migrations/134_migration_registry.sql

@@ -0,0 +1,18 @@
+-- 134: unified migration registry (additive only, no behavior change)
+--
+-- `sc db migrate` 가 두 마이그레이션 트리(cli/migrations=semicolony, semicolony-dashboard/migrations=public)를
+-- 하나의 순서화된 이력으로 적용하기 위한 레지스트리. namespace+version 으로 멱등 재적용을 막고,
+-- checksum 으로 적용 후 파일 변조를 감지하며, transaction_mode 로 비-트랜잭션 마이그(@transaction: off)를
+-- 구분한다. 기존 semicolony.schema_migrations 와 공존(점진 이행)하며 RLS/동작 변경은 없다.
+CREATE TABLE IF NOT EXISTS semicolony.migration_files (
+  namespace        TEXT NOT NULL,
+  version          TEXT NOT NULL,
+  name             TEXT NOT NULL,
+  path             TEXT NOT NULL,
+  checksum         TEXT NOT NULL,
+  transaction_mode TEXT NOT NULL DEFAULT 'transaction'
+    CHECK (transaction_mode IN ('transaction', 'none')),
+  applied_at       TIMESTAMPTZ NOT NULL DEFAULT now(),
+  PRIMARY KEY (namespace, version),
+  UNIQUE (path)
+);

package/migrations/135_sc_roles.sql

@@ -0,0 +1,102 @@
+-- @schema-retarget: off
+-- 135_sc_roles.sql
+-- SemiColony RLS 기반: 비-소유자 앱 역할 + RLS 헬퍼 함수.
+--
+-- 결정: semicolony/decision/rls-trusted-service-guc-boundary-2026-06-19.
+-- 선례: 129_kb_multitenant_gateway.sql (tenant scope), 128_entity_relations.sql.
+--
+-- 핵심 불변식(NON-NEGOTIABLE):
+--   - sc_app / sc_provider 는 SUPERUSER / BYPASSRLS 가 아니다 → RLS 가 항상 적용된다.
+--   - 두 역할은 DDL/소유권이 없다(SELECT/INSERT/UPDATE 만). 마이그레이션/스키마 변경은
+--     소유자(중앙) 역할이 수행한다.
+--   - 테넌트 VM 은 이 자격증명을 절대 받지 않는다 → 중앙 trusted 서비스만 사용.
+--
+-- @schema-retarget: off 이유:
+--   - 이 파일은 `public.` 헬퍼 함수와 `pg_roles` 를 참조한다(테넌트 스키마와 무관).
+--   - GRANT 대상 테이블의 스키마는 아래에서 `current_setting('search_path')` 가 아니라
+--     활성 스키마를 동적으로 결정해야 하므로, retarget 을 끄고 `DO` 블록에서 직접 처리한다.
+--   - public.current_tenant_id()/is_provider() 는 절대 retarget 되면 안 된다(GUC 계약).
+
+-- ============================================================
+-- 1) 역할 생성 (멱등) — LOGIN, 비-소유자, NOBYPASSRLS
+-- ============================================================
+DO $$
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'sc_app') THEN
+    CREATE ROLE sc_app LOGIN NOSUPERUSER NOCREATEDB NOCREATEROLE NOINHERIT NOBYPASSRLS;
+  END IF;
+  IF NOT EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'sc_provider') THEN
+    CREATE ROLE sc_provider LOGIN NOSUPERUSER NOCREATEDB NOCREATEROLE NOINHERIT NOBYPASSRLS;
+  END IF;
+END $$;
+
+-- ============================================================
+-- 2) RLS 헬퍼 함수 (public 고정 — GUC 계약의 단일 진실)
+--    STABLE: 한 쿼리/트랜잭션 내에서 GUC 값이 고정.
+--    current_setting(..., true): GUC 미설정 시 NULL(은 RLS 에서 fail-closed).
+-- ============================================================
+CREATE OR REPLACE FUNCTION public.current_tenant_id() RETURNS uuid
+  LANGUAGE sql STABLE
+  AS $$ SELECT NULLIF(current_setting('app.current_tenant_id', true), '')::uuid $$;
+
+CREATE OR REPLACE FUNCTION public.is_provider() RETURNS boolean
+  LANGUAGE sql STABLE
+  AS $$ SELECT coalesce(current_setting('app.is_provider', true), 'off') = 'on' $$;
+
+COMMENT ON FUNCTION public.current_tenant_id() IS
+  'RLS 헬퍼: SET LOCAL app.current_tenant_id 로 주입된 현재 테넌트 UUID. 미설정 시 NULL(fail-closed).';
+COMMENT ON FUNCTION public.is_provider() IS
+  'RLS 헬퍼: SET LOCAL app.is_provider=on 일 때만 true. 테넌트 인증 경로에서 설정 금지.';
+
+-- 헬퍼 함수는 두 앱 역할이 RLS 정책 평가 시 실행할 수 있어야 한다.
+GRANT EXECUTE ON FUNCTION public.current_tenant_id() TO sc_app, sc_provider;
+GRANT EXECUTE ON FUNCTION public.is_provider() TO sc_app, sc_provider;
+
+-- ============================================================
+-- 3) GRANT — sc_app 에 서비스 테이블 SELECT/INSERT/UPDATE 만 부여.
+--    DDL/DELETE/소유권 없음. 활성 스키마(semicolony 또는 flip 후 semicolony)와 public 양쪽.
+--    스키마명을 retarget 없이 동적으로 결정하기 위해 GUC(app.runtime_schema, 미설정 시 'semicolony')
+--    를 사용한다(러너가 flip 시 SET app.runtime_schema 가능). EXECUTE 로 명시 GRANT.
+-- ============================================================
+DO $$
+DECLARE
+  active_schema text := coalesce(nullif(current_setting('app.runtime_schema', true), ''), 'semicolony');
+  svc_table text;
+  svc_tables text[] := ARRAY[
+    'bot_status', 'bot_sessions', 'bot_commitments', 'action_items',
+    'agent_personas', 'agent_persona_revisions',
+    'knowledge_base', 'entity_relations', 'kb_claims', 'concierge_requests'
+  ];
+BEGIN
+  -- 스키마 USAGE (DDL 아님 — 객체 참조 권한만)
+  EXECUTE format('GRANT USAGE ON SCHEMA %I TO sc_app, sc_provider', active_schema);
+  EXECUTE 'GRANT USAGE ON SCHEMA public TO sc_app, sc_provider';
+
+  -- 활성 스키마의 서비스 테이블: SELECT/INSERT/UPDATE 만 (존재하는 것만)
+  FOREACH svc_table IN ARRAY svc_tables LOOP
+    IF to_regclass(format('%I.%I', active_schema, svc_table)) IS NOT NULL THEN
+      EXECUTE format(
+        'GRANT SELECT, INSERT, UPDATE ON %I.%I TO sc_app',
+        active_schema, svc_table
+      );
+    END IF;
+  END LOOP;
+
+  -- public 멀티테넌트 테이블: 게이트웨이/런타임-컨트롤이 trusted 로 읽고 쓴다.
+  IF to_regclass('public.tenants') IS NOT NULL THEN
+    EXECUTE 'GRANT SELECT ON public.tenants TO sc_app';
+  END IF;
+  IF to_regclass('public.agent_installs') IS NOT NULL THEN
+    EXECUTE 'GRANT SELECT, INSERT, UPDATE ON public.agent_installs TO sc_app';
+  END IF;
+  IF to_regclass('public.agent_activity') IS NOT NULL THEN
+    EXECUTE 'GRANT SELECT, INSERT, UPDATE ON public.agent_activity TO sc_app';
+  END IF;
+  IF to_regclass('public.agent_listings') IS NOT NULL THEN
+    -- 라이브러리(플랫폼 카탈로그)는 RLS 미적용 — 읽기만 부여.
+    EXECUTE 'GRANT SELECT ON public.agent_listings TO sc_app';
+  END IF;
+
+  -- 시퀀스 USAGE (BIGSERIAL/uuid default 가 아닌 serial 컬럼 INSERT 대비)
+  EXECUTE format('GRANT USAGE ON ALL SEQUENCES IN SCHEMA %I TO sc_app', active_schema);
+END $$;

package/migrations/136_runtime_tenant_columns.sql

@@ -0,0 +1,71 @@
+-- 136_runtime_tenant_columns.sql
+-- 런타임 테이블에 tenant_id / scope / install_id 를 **가산적**으로 추가(RLS Phase 2 준비).
+--
+-- 결정: semicolony/decision/rls-trusted-service-guc-boundary-2026-06-19.
+-- 선례: 129_kb_multitenant_gateway.sql (knowledge_base tenant_id+scope 동형 패턴).
+--
+-- 원칙(zero blast radius):
+--   - 모든 컬럼 ADD COLUMN IF NOT EXISTS → 재실행 멱등, 기존 행 무변경.
+--   - scope DEFAULT 'platform-global' → 기존 모든 행은 platform-global 로 분류(RLS read 허용),
+--     백필(137) 후 tenant-local 로 재분류한다.
+--   - scope/tenant_id 연결 CHECK 는 여기서 추가하지 않는다 → 백필(137) 완료 후 138 에서
+--     NOT VALID + VALIDATE 로 안전하게 건다(긴 락 회피).
+--   - 러너가 `semicolony.` 를 활성 스키마로 retarget 하고 파일 전체를 BEGIN/COMMIT 으로 감싼다.
+--     → 여기엔 트랜잭션 구문/`@schema-retarget: off` 를 넣지 않는다.
+
+-- ── bot_status ──────────────────────────────────────────────
+ALTER TABLE semicolony.bot_status
+  ADD COLUMN IF NOT EXISTS tenant_id UUID,
+  ADD COLUMN IF NOT EXISTS scope TEXT NOT NULL DEFAULT 'platform-global'
+    CHECK (scope IN ('tenant-local', 'platform-global')),
+  ADD COLUMN IF NOT EXISTS install_id UUID;
+CREATE INDEX IF NOT EXISTS idx_bot_status_tenant
+  ON semicolony.bot_status (tenant_id) WHERE tenant_id IS NOT NULL;
+
+-- ── bot_sessions ────────────────────────────────────────────
+ALTER TABLE semicolony.bot_sessions
+  ADD COLUMN IF NOT EXISTS tenant_id UUID,
+  ADD COLUMN IF NOT EXISTS scope TEXT NOT NULL DEFAULT 'platform-global'
+    CHECK (scope IN ('tenant-local', 'platform-global')),
+  ADD COLUMN IF NOT EXISTS install_id UUID;
+CREATE INDEX IF NOT EXISTS idx_bot_sessions_tenant
+  ON semicolony.bot_sessions (tenant_id) WHERE tenant_id IS NOT NULL;
+
+-- ── bot_commitments ─────────────────────────────────────────
+ALTER TABLE semicolony.bot_commitments
+  ADD COLUMN IF NOT EXISTS tenant_id UUID,
+  ADD COLUMN IF NOT EXISTS scope TEXT NOT NULL DEFAULT 'platform-global'
+    CHECK (scope IN ('tenant-local', 'platform-global')),
+  ADD COLUMN IF NOT EXISTS install_id UUID;
+CREATE INDEX IF NOT EXISTS idx_bot_commitments_tenant
+  ON semicolony.bot_commitments (tenant_id) WHERE tenant_id IS NOT NULL;
+
+-- ── action_items ────────────────────────────────────────────
+-- (semicolony.service_action_items 는 이 베이스 테이블에 대한 VIEW — 자동 전파)
+ALTER TABLE semicolony.action_items
+  ADD COLUMN IF NOT EXISTS tenant_id UUID,
+  ADD COLUMN IF NOT EXISTS scope TEXT NOT NULL DEFAULT 'platform-global'
+    CHECK (scope IN ('tenant-local', 'platform-global')),
+  ADD COLUMN IF NOT EXISTS install_id UUID;
+CREATE INDEX IF NOT EXISTS idx_action_items_tenant
+  ON semicolony.action_items (tenant_id) WHERE tenant_id IS NOT NULL;
+
+-- ── agent_personas ──────────────────────────────────────────
+ALTER TABLE semicolony.agent_personas
+  ADD COLUMN IF NOT EXISTS tenant_id UUID,
+  ADD COLUMN IF NOT EXISTS scope TEXT NOT NULL DEFAULT 'platform-global'
+    CHECK (scope IN ('tenant-local', 'platform-global')),
+  ADD COLUMN IF NOT EXISTS install_id UUID;
+CREATE INDEX IF NOT EXISTS idx_agent_personas_tenant
+  ON semicolony.agent_personas (tenant_id) WHERE tenant_id IS NOT NULL;
+
+-- ── agent_persona_revisions ─────────────────────────────────
+-- install_id 는 슬러그 단위로 의미가 옅으므로 tenant_id + scope 만 추가(revision 은
+-- 부모 persona 의 tenant 를 상속). install_id 도 가산해 분석 일관성을 유지한다.
+ALTER TABLE semicolony.agent_persona_revisions
+  ADD COLUMN IF NOT EXISTS tenant_id UUID,
+  ADD COLUMN IF NOT EXISTS scope TEXT NOT NULL DEFAULT 'platform-global'
+    CHECK (scope IN ('tenant-local', 'platform-global')),
+  ADD COLUMN IF NOT EXISTS install_id UUID;
+CREATE INDEX IF NOT EXISTS idx_agent_persona_revisions_tenant
+  ON semicolony.agent_persona_revisions (tenant_id) WHERE tenant_id IS NOT NULL;