@team-semicolon/semicolony-cli 4.18.51

package/migrations/013_kb_workspace_domains.sql

@@ -0,0 +1,88 @@
+-- Migration 013: Add bot-config, spec, skill ontology domains
+-- bot_workspace_files → KB 전환을 위한 새 도메인 추가.
+-- 봇 메타/규격, 문서/스펙, 스킬 정의를 KB로 관리.
+
+-- 1. bot-config 도메인: 봇 메타데이터 및 규격 문서
+INSERT INTO semicolony.ontology (domain, schema, description, version)
+VALUES (
+  'bot-config',
+  '{
+    "type": "object",
+    "properties": {
+      "content": { "type": "string", "description": "문서 본문 (Markdown)" },
+      "metadata": {
+        "type": "object",
+        "properties": {
+          "bot_id": { "type": "string", "description": "봇 ID (semiclaw, workclaw 등)" },
+          "file_type": {
+            "type": "string",
+            "enum": ["identity", "agents", "rules", "tools", "heartbeat", "bootstrap", "claude"],
+            "description": "원본 파일 종류"
+          },
+          "source_path": { "type": "string", "description": "원본 파일 경로" }
+        },
+        "required": ["bot_id", "file_type"]
+      }
+    }
+  }'::jsonb,
+  '봇 메타데이터 및 규격 문서 (IDENTITY.md, AGENTS.md, RULES.md, TOOLS.md, HEARTBEAT.md, BOOTSTRAP.md, CLAUDE.md)',
+  1
+)
+ON CONFLICT (domain) DO NOTHING;
+
+-- 2. spec 도메인: 프로젝트 스펙/설계 문서
+INSERT INTO semicolony.ontology (domain, schema, description, version)
+VALUES (
+  'spec',
+  '{
+    "type": "object",
+    "properties": {
+      "content": { "type": "string", "description": "스펙 문서 본문 (Markdown)" },
+      "metadata": {
+        "type": "object",
+        "properties": {
+          "project": { "type": "string", "description": "관련 프로젝트명" },
+          "doc_type": {
+            "type": "string",
+            "enum": ["prd", "spec", "plan", "design", "epic", "protocol"],
+            "description": "문서 유형"
+          },
+          "author": { "type": "string", "description": "작성자 (봇 ID 또는 사용자)" },
+          "source_bot": { "type": "string", "description": "원본이 있던 봇 워크스페이스" }
+        }
+      }
+    }
+  }'::jsonb,
+  '프로젝트 스펙, PRD, 설계 문서, 구현 계획',
+  1
+)
+ON CONFLICT (domain) DO NOTHING;
+
+-- 3. skill 도메인: 봇 스킬 정의 및 참조 문서
+INSERT INTO semicolony.ontology (domain, schema, description, version)
+VALUES (
+  'skill',
+  '{
+    "type": "object",
+    "properties": {
+      "content": { "type": "string", "description": "스킬 정의 또는 참조 문서 (Markdown)" },
+      "metadata": {
+        "type": "object",
+        "properties": {
+          "bot_id": { "type": "string", "description": "스킬 소유 봇 ID" },
+          "skill_name": { "type": "string", "description": "스킬 이름" },
+          "content_type": {
+            "type": "string",
+            "enum": ["definition", "reference"],
+            "description": "definition=SKILL.md, reference=references/*.md"
+          },
+          "ref_name": { "type": "string", "description": "참조 문서 이름 (reference 타입일 때)" }
+        },
+        "required": ["bot_id", "skill_name", "content_type"]
+      }
+    }
+  }'::jsonb,
+  '봇 스킬 정의 (SKILL.md) 및 참조 문서 (references/*.md). scripts/는 제외 (로컬 실행 필요)',
+  1
+)
+ON CONFLICT (domain) DO NOTHING;

package/migrations/014_timestamp_to_timestamptz.sql

@@ -0,0 +1,33 @@
+-- 014_timestamp_to_timestamptz.sql
+-- Fix timezone double-conversion bug: TIMESTAMP → TIMESTAMPTZ
+--
+-- DB session timezone = Asia/Seoul (KST).
+-- Application-provided timestamps (last_active, last_activity, last_run, next_run)
+--   were stored from toISOString() with 'Z' stripped → raw UTC digits.
+-- Database-generated timestamps (synced_at via NOW())
+--   were stored as KST digits.
+
+-- bot_status
+ALTER TABLE semicolony.bot_status
+  ALTER COLUMN last_active TYPE TIMESTAMPTZ USING last_active AT TIME ZONE 'UTC',
+  ALTER COLUMN synced_at   TYPE TIMESTAMPTZ USING synced_at   AT TIME ZONE 'Asia/Seoul';
+
+ALTER TABLE semicolony.bot_status
+  ALTER COLUMN synced_at SET DEFAULT NOW();
+
+-- bot_sessions
+ALTER TABLE semicolony.bot_sessions
+  ALTER COLUMN last_activity TYPE TIMESTAMPTZ USING last_activity AT TIME ZONE 'UTC',
+  ALTER COLUMN synced_at     TYPE TIMESTAMPTZ USING synced_at     AT TIME ZONE 'Asia/Seoul';
+
+ALTER TABLE semicolony.bot_sessions
+  ALTER COLUMN synced_at SET DEFAULT NOW();
+
+-- bot_cron_jobs
+ALTER TABLE semicolony.bot_cron_jobs
+  ALTER COLUMN last_run  TYPE TIMESTAMPTZ USING last_run  AT TIME ZONE 'UTC',
+  ALTER COLUMN next_run  TYPE TIMESTAMPTZ USING next_run  AT TIME ZONE 'UTC',
+  ALTER COLUMN synced_at TYPE TIMESTAMPTZ USING synced_at AT TIME ZONE 'Asia/Seoul';
+
+ALTER TABLE semicolony.bot_cron_jobs
+  ALTER COLUMN synced_at SET DEFAULT NOW();

package/migrations/015_kb_domain_enforcement.sql

@@ -0,0 +1,83 @@
+-- Migration 015: KB Domain Enforcement + KPI/Decision Ontology Update
+--
+-- 1. 고아 도메인 자동 등록 (FK 추가 전 안전장치)
+-- 2. FK 제약 추가 (domain → ontology)
+-- 3. KPI/Decision 온톨로지 스키마 업데이트
+-- 4. 임베딩 NULL 인덱스
+
+BEGIN;
+
+-- ============================================================
+-- 1. 고아 도메인 자동 등록
+-- ============================================================
+INSERT INTO semicolony.ontology (domain, schema, description, version)
+SELECT DISTINCT kb.domain,
+       '{"type":"object","properties":{"content":{"type":"string"}}}'::jsonb,
+       'Auto-created during FK migration', 1
+FROM semicolony.knowledge_base kb
+WHERE NOT EXISTS (SELECT 1 FROM semicolony.ontology o WHERE o.domain = kb.domain)
+ON CONFLICT (domain) DO NOTHING;
+
+-- ============================================================
+-- 2. FK 추가 (ON UPDATE CASCADE, ON DELETE RESTRICT)
+-- ============================================================
+ALTER TABLE semicolony.knowledge_base
+  ADD CONSTRAINT fk_kb_domain_ontology
+  FOREIGN KEY (domain) REFERENCES semicolony.ontology(domain)
+  ON UPDATE CASCADE ON DELETE RESTRICT;
+
+-- ============================================================
+-- 3. KPI 온톨로지 스키마 업데이트
+-- ============================================================
+UPDATE semicolony.ontology SET schema = '{
+  "type": "object",
+  "required": ["content"],
+  "properties": {
+    "content": {"type": "string"},
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "project": {"type": "string", "description": "프로젝트 ID (예: my-service)"},
+        "record_type": {"type": "string", "enum": ["current", "weekly", "target"], "description": "current=최신 스냅샷, weekly=주간 기록, target=목표"},
+        "week": {"type": "string", "description": "YYYY-WNN 형식 (weekly 타입만)"},
+        "measured_at": {"type": "string", "description": "측정일 ISO 8601"}
+      },
+      "required": ["project", "record_type"]
+    }
+  }
+}'::jsonb,
+description = 'KPI 지표. key 형식: {project}/current | {project}/target | {project}/YYYY-WNN',
+version = version + 1
+WHERE domain = 'kpi';
+
+-- ============================================================
+-- 4. Decision 온톨로지 스키마 업데이트
+-- ============================================================
+UPDATE semicolony.ontology SET schema = '{
+  "type": "object",
+  "required": ["content"],
+  "properties": {
+    "content": {"type": "string"},
+    "metadata": {
+      "type": "object",
+      "properties": {
+        "date": {"type": "string", "description": "결정일 YYYY-MM-DD"},
+        "participants": {"type": "array", "items": {"type": "string"}, "description": "참여자 목록"},
+        "status": {"type": "string", "enum": ["active", "superseded", "revoked"], "description": "결정 상태"},
+        "source_meeting": {"type": "string", "description": "관련 회의 링크"}
+      },
+      "required": ["date"]
+    }
+  }
+}'::jsonb,
+description = '의사결정 기록 (ADR). key: {YYYY-MM-DD}/{slug}. 하나의 엔트리에 전체 결정 포함.',
+version = version + 1
+WHERE domain = 'decision';
+
+-- ============================================================
+-- 5. 임베딩 NULL 인덱스 (backfill 쿼리 최적화)
+-- ============================================================
+CREATE INDEX IF NOT EXISTS idx_kb_embedding_null
+  ON semicolony.knowledge_base(domain) WHERE embedding IS NULL;
+
+COMMIT;

package/migrations/016_ontology_redesign.sql

@@ -0,0 +1,108 @@
+-- 016_ontology_redesign.sql
+-- 온톨로지 재설계: 서비스(프로젝트) 단위 + 타입 분리
+-- Discussion #235 (2026-03-22) 합의 기반
+
+BEGIN;
+
+-- ============================================================
+-- 1. ontology_types 테이블 (구조적 템플릿, 서비스와 독립)
+-- ============================================================
+
+CREATE TABLE IF NOT EXISTS semicolony.ontology_types (
+    id          BIGSERIAL PRIMARY KEY,
+    type_key    VARCHAR(100) NOT NULL UNIQUE,
+    schema      JSONB NOT NULL DEFAULT '{}',
+    description TEXT,
+    version     INT DEFAULT 1,
+    created_at  TIMESTAMPTZ DEFAULT NOW(),
+    updated_at  TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- 시드 타입 등록
+INSERT INTO semicolony.ontology_types (type_key, schema, description) VALUES
+('service',    '{"type":"object","properties":{"content":{"type":"string"},"metadata":{"type":"object","properties":{"status":{"type":"string","enum":["active","archived","planned"]},"tech_stack":{"type":"array","items":{"type":"string"}}}}}}', '서비스(프로젝트) 프로필'),
+('person',     '{"type":"object","properties":{"content":{"type":"string"},"metadata":{"type":"object","properties":{"role":{"type":"string"},"squad":{"type":"string"}}}}}', '팀원 정보'),
+('decision',   '{"type":"object","properties":{"content":{"type":"string"},"metadata":{"type":"object","required":["date","status"],"properties":{"date":{"type":"string","format":"date"},"status":{"type":"string","enum":["proposed","accepted","deprecated"]},"participants":{"type":"array","items":{"type":"string"}}}}}}', '의사결정 기록'),
+('process',    '{"type":"object","properties":{"content":{"type":"string"},"metadata":{"type":"object","properties":{"owner":{"type":"string"},"frequency":{"type":"string"}}}}}', '업무 프로세스'),
+('kpi',        '{"type":"object","properties":{"content":{"type":"string"},"metadata":{"type":"object","properties":{"project":{"type":"string"},"period":{"type":"string"},"value":{"type":"number"},"target":{"type":"number"}}}}}', 'KPI 지표'),
+('milestone',  '{"type":"object","properties":{"content":{"type":"string"},"metadata":{"type":"object","required":["project","title","start_date","end_date","status"],"properties":{"project":{"type":"string"},"title":{"type":"string"},"start_date":{"type":"string","format":"date"},"end_date":{"type":"string","format":"date"},"status":{"type":"string","enum":["planned","in-progress","completed"]},"order":{"type":"integer"}}}}}', '마일스톤'),
+('infra',      '{"type":"object","properties":{"content":{"type":"string"},"metadata":{"type":"object","properties":{"provider":{"type":"string"},"region":{"type":"string"}}}}}', '인프라 구성'),
+('spec',       '{"type":"object","properties":{"content":{"type":"string"},"metadata":{"type":"object","properties":{"status":{"type":"string","enum":["draft","review","approved","archived"]},"author":{"type":"string"}}}}}', '스펙/설계 문서'),
+('bot-config', '{"type":"object","properties":{"content":{"type":"string"},"metadata":{"type":"object","properties":{"bot_id":{"type":"string"},"file_type":{"type":"string"}}}}}', '봇 설정/규격'),
+('skill',      '{"type":"object","properties":{"content":{"type":"string"},"metadata":{"type":"object","properties":{"bot_ids":{"type":"array","items":{"type":"string"}},"category":{"type":"string"}}}}}', '스킬 정의'),
+('glossary',   '{"type":"object","properties":{"content":{"type":"string"},"metadata":{"type":"object","properties":{"aliases":{"type":"array","items":{"type":"string"}}}}}}', '용어 사전'),
+('memory',     '{"type":"object","properties":{"content":{"type":"string"},"metadata":{"type":"object","required":["source_type","source_id","date"],"properties":{"source_type":{"type":"string","enum":["bot","local-session"]},"source_id":{"type":"string"},"date":{"type":"string","format":"date"},"content_hash":{"type":"string"},"original_size":{"type":"integer"},"synced_at":{"type":"string","format":"date-time"}}}}}', '봇/세션 일일 메모리 (L1→L2 싱크). key: {sourceId}/{YYYY-MM-DD}')
+ON CONFLICT (type_key) DO NOTHING;
+
+-- ============================================================
+-- 2. ontology 테이블 컬럼 확장
+-- ============================================================
+
+ALTER TABLE semicolony.ontology
+  ADD COLUMN IF NOT EXISTS service     VARCHAR(100),
+  ADD COLUMN IF NOT EXISTS entity_type VARCHAR(100),
+  ADD COLUMN IF NOT EXISTS parent      VARCHAR(100),
+  ADD COLUMN IF NOT EXISTS tags        TEXT[] DEFAULT '{}';
+
+-- ============================================================
+-- 3. 기존 도메인 backfill (entity_type 매핑)
+-- ============================================================
+
+UPDATE semicolony.ontology SET entity_type = 'person'     WHERE domain = 'team'       AND entity_type IS NULL;
+UPDATE semicolony.ontology SET entity_type = 'service'    WHERE domain = 'project'    AND entity_type IS NULL;
+UPDATE semicolony.ontology SET entity_type = 'decision'   WHERE domain = 'decision'   AND entity_type IS NULL;
+UPDATE semicolony.ontology SET entity_type = 'process'    WHERE domain = 'process'    AND entity_type IS NULL;
+UPDATE semicolony.ontology SET entity_type = 'infra'      WHERE domain = 'infra'      AND entity_type IS NULL;
+UPDATE semicolony.ontology SET entity_type = 'kpi'        WHERE domain = 'kpi'        AND entity_type IS NULL;
+UPDATE semicolony.ontology SET entity_type = 'bot-config' WHERE domain = 'bot-config' AND entity_type IS NULL;
+UPDATE semicolony.ontology SET entity_type = 'spec'       WHERE domain = 'spec'       AND entity_type IS NULL;
+UPDATE semicolony.ontology SET entity_type = 'skill'      WHERE domain = 'skill'      AND entity_type IS NULL;
+UPDATE semicolony.ontology SET entity_type = 'milestone'  WHERE domain = 'milestone'  AND entity_type IS NULL;
+
+-- ============================================================
+-- 4. memory 도메인 등록 (L1→L2 동기화용)
+-- ============================================================
+
+INSERT INTO semicolony.ontology (domain, entity_type, schema, description) VALUES
+('memory', 'memory', '{
+  "type": "object",
+  "properties": {
+    "content": {"type": "string"},
+    "metadata": {
+      "type": "object",
+      "required": ["source_type", "source_id", "date"],
+      "properties": {
+        "source_type": {"enum": ["bot", "local-session"]},
+        "source_id": {"type": "string"},
+        "date": {"type": "string", "format": "date"},
+        "content_hash": {"type": "string"},
+        "original_size": {"type": "integer"},
+        "synced_at": {"type": "string", "format": "date-time"}
+      }
+    }
+  }
+}', '봇/세션 일일 메모리 (L1→L2 싱크). key: {sourceId}/{YYYY-MM-DD}')
+ON CONFLICT (domain) DO UPDATE SET
+  entity_type = EXCLUDED.entity_type,
+  schema = EXCLUDED.schema,
+  description = EXCLUDED.description;
+
+-- ============================================================
+-- 5. knowledge_base — generated column for service extraction
+-- ============================================================
+
+ALTER TABLE semicolony.knowledge_base
+  ADD COLUMN IF NOT EXISTS service VARCHAR(100)
+    GENERATED ALWAYS AS (
+      CASE WHEN domain LIKE '%.%' THEN split_part(domain, '.', 1) ELSE NULL END
+    ) STORED;
+
+-- ============================================================
+-- 6. 인덱스
+-- ============================================================
+
+CREATE INDEX IF NOT EXISTS idx_ontology_service     ON semicolony.ontology (service) WHERE service IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_ontology_entity_type ON semicolony.ontology (entity_type) WHERE entity_type IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_kb_service           ON semicolony.knowledge_base (service) WHERE service IS NOT NULL;
+
+COMMIT;

package/migrations/017_ontology_instance_model.sql

@@ -0,0 +1,151 @@
+-- 017_ontology_instance_model.sql
+-- 온톨로지 인스턴스 모델: 서비스 인스턴스 중심 재구성 + entity_type FK
+-- Discussion #235 (2026-03-22) 합의 기반
+--
+-- 핵심 변경:
+--   1. ontology.entity_type → FK 참조 ontology_types.type_key
+--   2. 서비스 인스턴스를 ontology 1등 시민으로 등록
+--   3. 글로벌 도메인에 service='_global' 태깅
+--   4. KB 엔트리 도메인을 서비스 인스턴스 스코프(dot-notation)로 전환
+
+BEGIN;
+
+-- ============================================================
+-- 1. entity_type backfill (NULL → 적절한 타입 매핑)
+-- ============================================================
+
+-- 서비스 스코프 도메인 (my-service.kpi → kpi)
+UPDATE semicolony.ontology
+SET entity_type = split_part(domain, '.', 2)
+WHERE entity_type IS NULL AND domain LIKE '%.%'
+  AND split_part(domain, '.', 2) IN (
+    SELECT type_key FROM semicolony.ontology_types
+  );
+
+-- 서비스 프로필 도메인 (my-service → service)
+-- NOTE: organization 도메인은 INSERT 시 entity_type='organization' 이 설정되므로
+-- entity_type IS NULL 필터에 걸리지 않아 별도 제외 목록이 불필요하다.
+UPDATE semicolony.ontology
+SET entity_type = 'service'
+WHERE entity_type IS NULL
+  AND domain NOT LIKE '%.%'
+  AND domain NOT IN (
+    'team','project','decision','process','infra','kpi',
+    'bot-config','spec','skill','milestone','memory','glossary',
+    'session-log'
+  );
+
+-- 나머지 NULL → glossary (안전망)
+UPDATE semicolony.ontology
+SET entity_type = 'glossary'
+WHERE entity_type IS NULL;
+
+-- ============================================================
+-- 2. entity_type FK 제약 추가
+-- ============================================================
+
+-- 누락된 entity_type 값이 ontology_types에 없으면 등록
+INSERT INTO semicolony.ontology_types (type_key, schema, description)
+SELECT DISTINCT o.entity_type, '{}'::jsonb, o.entity_type || ' (auto-registered)'
+FROM semicolony.ontology o
+WHERE NOT EXISTS (
+  SELECT 1 FROM semicolony.ontology_types t WHERE t.type_key = o.entity_type
+)
+ON CONFLICT (type_key) DO NOTHING;
+
+ALTER TABLE semicolony.ontology
+  ALTER COLUMN entity_type SET NOT NULL;
+
+DO $$
+BEGIN
+  IF NOT EXISTS (
+    SELECT 1 FROM information_schema.table_constraints
+    WHERE constraint_name = 'fk_ontology_entity_type'
+      AND table_schema = 'semicolony'
+  ) THEN
+    ALTER TABLE semicolony.ontology
+      ADD CONSTRAINT fk_ontology_entity_type
+        FOREIGN KEY (entity_type) REFERENCES semicolony.ontology_types(type_key);
+  END IF;
+END $$;
+
+-- ============================================================
+-- 3. 서비스 인스턴스 등록 (1등 시민)
+-- ============================================================
+
+-- organization 타입 등록 (팀/조직)
+INSERT INTO semicolony.ontology_types (type_key, schema, description) VALUES
+  ('organization', '{}'::jsonb, '팀/조직 (서비스 상위 개체)'),
+  ('session-log',  '{}'::jsonb, '세션 로그')
+ON CONFLICT (type_key) DO NOTHING;
+
+-- NOTE: 신규 OSS 인스턴스는 organization/service ontology row 를
+-- `semicolony kb ontology --action register` 로 직접 등록한다.
+-- 과거 세미콜론 인스턴스에 시드되었던 행(`semicolon` org, `jungchipan`/`playland` service)은
+-- migration 108 에서 KB 데이터 0건일 때만 조건부 삭제된다.
+
+-- ============================================================
+-- 4. 글로벌 도메인에 service='_global' 태깅
+-- ============================================================
+
+UPDATE semicolony.ontology
+SET service = '_global'
+WHERE service IS NULL
+  AND entity_type NOT IN ('service', 'organization');
+
+-- ============================================================
+-- 5. KB 엔트리 도메인 전환 (flat → service-scoped dot-notation)
+--    team → _global.team, project → _global.project 등
+--    단, 이미 dot-notation인 도메인(my-service.kpi)은 유지
+-- ============================================================
+
+-- 먼저 대상 도메인을 온톨로지에 등록 (dot-notation)
+-- 단, service/organization 인스턴스는 제외 (my-org, my-service 등은 top-level 유지)
+INSERT INTO semicolony.ontology (domain, entity_type, service, schema, description)
+SELECT '_global.' || o.domain, o.entity_type, '_global', o.schema, o.description
+FROM semicolony.ontology o
+WHERE o.service = '_global'
+  AND o.domain NOT LIKE '%.%'
+  AND o.entity_type NOT IN ('service', 'organization')
+  AND NOT EXISTS (
+    SELECT 1 FROM semicolony.ontology WHERE domain = '_global.' || o.domain
+  )
+ON CONFLICT (domain) DO NOTHING;
+
+-- KB 엔트리 도메인 키 전환
+-- 단, service/organization 인스턴스 도메인은 제외
+UPDATE semicolony.knowledge_base
+SET domain = '_global.' || domain
+WHERE domain NOT LIKE '%.%'
+  AND domain IN (
+    SELECT domain FROM semicolony.ontology
+    WHERE service = '_global'
+      AND domain NOT LIKE '%.%'
+      AND entity_type NOT IN ('service', 'organization')
+  );
+
+-- 기존 flat 도메인 온톨로지 엔트리 제거 (dot-notation으로 이전됨)
+-- 단, service/organization 인스턴스는 유지
+DELETE FROM semicolony.ontology
+WHERE service = '_global'
+  AND domain NOT LIKE '%.%'
+  AND entity_type NOT IN ('service', 'organization')
+  AND EXISTS (
+    SELECT 1 FROM semicolony.ontology o2 WHERE o2.domain = '_global.' || semicolony.ontology.domain
+  );
+
+-- ============================================================
+-- 6. 인덱스
+-- ============================================================
+
+CREATE INDEX IF NOT EXISTS idx_ontology_entity_type_fk
+  ON semicolony.ontology (entity_type);
+
+-- ============================================================
+-- 7. knowledge_base service generated column 갱신
+--    기존: service = split_part(domain, '.', 1) WHERE domain LIKE '%.%'
+--    변경 없음 — _global.team → service='_global', my-service.kpi → service='my-service'
+--    generated column은 ALTER 불가이므로 그대로 유지
+-- ============================================================
+
+COMMIT;

package/migrations/018_type_schema.sql

@@ -0,0 +1,11 @@
+-- 018: type_schema (공개 배포용 no-op 스텁)
+--
+-- 이 번호의 마이그레이션은 세미콜론 내부 DB 에 이미 적용 완료됨.
+-- semicolon tenant 전용 데이터(서비스 도메인 샘플 예시 등)를 포함하므로
+-- 공개 배포 빌드에서는 실행되지 않는다.
+--
+-- 세미콜론 DB 는 schema_migrations 에 018_type_schema 가 이미 기록되어 있어 이 파일을 skip.
+-- 신규(공개) 설치자는 이 파일이 실행되어도 ontology 스키마에 영향 없음.
+BEGIN;
+-- historical no-op
+COMMIT;

package/migrations/019_test_management.sql

@@ -0,0 +1,69 @@
+-- 019_test_management.sql
+-- SEMICOLONY 테스트 관리 시스템: 스위트 레지스트리 + 실행 이력 + TC 결과 추적
+
+BEGIN;
+
+-- 1. test_suites: 테스트 스위트 레지스트리
+CREATE TABLE IF NOT EXISTS semicolony.test_suites (
+  suite_id      TEXT PRIMARY KEY,
+  name          TEXT NOT NULL,
+  layer         TEXT NOT NULL DEFAULT 'integration',
+  runner_type   TEXT NOT NULL DEFAULT 'tsx',
+  runner_path   TEXT NOT NULL,
+  schedule      TEXT,
+  enabled       BOOLEAN DEFAULT true,
+  created_at    TIMESTAMPTZ DEFAULT NOW(),
+  updated_at    TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- 2. test_cases: 개별 TC 정의 (첫 실행 시 자동 등록)
+CREATE TABLE IF NOT EXISTS semicolony.test_cases (
+  case_id       TEXT NOT NULL,
+  suite_id      TEXT NOT NULL REFERENCES semicolony.test_suites(suite_id) ON DELETE CASCADE,
+  name          TEXT NOT NULL,
+  category      TEXT,
+  severity      TEXT DEFAULT 'normal',
+  created_at    TIMESTAMPTZ DEFAULT NOW(),
+  PRIMARY KEY (suite_id, case_id)
+);
+
+-- 3. test_runs: 실행 이력
+CREATE TABLE IF NOT EXISTS semicolony.test_runs (
+  run_id        TEXT PRIMARY KEY,
+  suite_id      TEXT NOT NULL REFERENCES semicolony.test_suites(suite_id) ON DELETE CASCADE,
+  triggered_by  TEXT NOT NULL DEFAULT 'manual',
+  started_at    TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  finished_at   TIMESTAMPTZ,
+  total_pass    INT DEFAULT 0,
+  total_fail    INT DEFAULT 0,
+  total_warn    INT DEFAULT 0,
+  status        TEXT DEFAULT 'running',
+  summary       TEXT
+);
+
+-- 4. test_results: 개별 TC 결과
+CREATE TABLE IF NOT EXISTS semicolony.test_results (
+  id            BIGSERIAL PRIMARY KEY,
+  run_id        TEXT NOT NULL REFERENCES semicolony.test_runs(run_id) ON DELETE CASCADE,
+  case_id       TEXT NOT NULL,
+  suite_id      TEXT NOT NULL,
+  label         TEXT NOT NULL,
+  status        TEXT NOT NULL,
+  detail        TEXT,
+  duration_ms   INT,
+  created_at    TIMESTAMPTZ DEFAULT NOW()
+);
+
+-- Indexes
+CREATE INDEX IF NOT EXISTS idx_test_runs_suite ON semicolony.test_runs(suite_id, started_at DESC);
+CREATE INDEX IF NOT EXISTS idx_test_results_run ON semicolony.test_results(run_id);
+
+-- Seed: 기존 4개 테스트 스위트 등록
+INSERT INTO semicolony.test_suites (suite_id, name, layer, runner_type, runner_path) VALUES
+  ('017-migration',      '017 Migration Validation',  'integration', 'tsx',   'packages/mcp-kb/test-017-migration.ts'),
+  ('018-transplant',     '018 Data Transplant',       'integration', 'tsx',   'packages/mcp-kb/test-018-data-transplant.ts'),
+  ('018-ai-integration', '018 AI Integration E2E',    'e2e',         'tsx',   'packages/mcp-kb/test-018-ai-integration.ts'),
+  ('workspace-audit',    'Bot Workspace Compliance',  'compliance',  'shell', '~/.openclaw-shared/workspace-audit/run-audit.sh')
+ON CONFLICT (suite_id) DO NOTHING;
+
+COMMIT;