전체 문서

이 페이지 목차

PostgreSQL 필드·접근 의미 카탈로그

PostgreSQL 필드·접근 의미 카탈로그 · 관계

이 대상을 사용하는 기능·모듈·계약 · 2개

계약 사용 · 조건부 legacy migration과 최종 정의 · migration outcome determines installed physical constraints · db-migration-contract
계약 사용 · PostgreSQL 책임 영역 · PostgreSQL physical/semantic contract · core-edge-3

51개 PostgreSQL 객체의 물리 필드와 정적 SQL 소비를 한곳에서 대조한다. Core 49개는 db/schema.sql, llm_records·llm_usage는 별도 Ensure*Table DDL에서 왔다. 이 페이지의 C/A/P/U는 각각 source로 확인(C), 알려진 shape까지 확인(A), production shape는 알지만 DB가 더 넓거나 한계가 남음(P), 의미를 확인하지 못함(U)을 뜻한다. 실제 운영 DB의 row·role·query plan·retention은 관찰하지 않았다. core schema runtime ledgers

판정과 분모

축	결과	한계
Core 물리 schema	49 table / 520 column / 97 명시 index, function 4 / trigger 22 (C)	고정 source DDL 기준; 운영 drift 미관찰
보조 runtime ledger	2 table / 31 column / 5 명시 index (C 선언, A 가용성)	두 `Ensure*Table` 실패는 log 후 계속
전체 PostgreSQL 선언	51 table / 551 column / 102 명시 index	PK/UNIQUE 내부 index는 명시 index 분모 밖
field type/null/default/FK	551/551 정적 추출(C)	동적 SQL·운영 migration 적용은 미확인
generated/default 선언	explicit generated column 0; `BIGSERIAL` 37개는 implicit sequence-backed default+not-null	generated expression과 sequence default를 혼동하지 않음; upgraded catalog drift는 U
business/encoding 의미	444 C / 93 A / 14 P / 0 U = 551	production allowlist보다 DB writer/column이 넓은 10개 등은 P
reader/writer	production Go의 static SQL, 정적으로 평가한 string expression, runtime template, 닫힌 identifier allowlist를 위치·symbol 단위로 색인(A)	임의 동적 identifier·실제 call reachability·완성 runtime SQL은 U
role/retention	U	DDL에 GRANT/RLS/TTL/partition 없음; deployment role과 운영 보존 기간 미관찰

공통 해석 규칙

nullable=예는 SQL NULL 허용만 뜻한다. JSON의 누락/null/zero-value 구별은 각 request/scan 코드가 정하며 DB가 보장하지 않는다.
TIMESTAMPTZ는 절대 시각을 보존하지만 표시 timezone은 client/session 설정에 달렸다. BIGINT[]·TEXT[]·JSONB[]는 원소 수나 내부 원소 schema를 DB가 제한하지 않는 경우가 많다.
credential·request/response·evidence·prompt·snapshot을 민감 가능 또는 비밀/원문으로 표시했다. 이는 정적 분류이며 실제 값의 redaction/encryption을 보장하지 않는다.
schema에서 GRANT, REVOKE, RLS policy를 찾지 못했다. application은 configured PostgreSQL credential을 공유하므로 최소권한과 운영 role 분리는 배포 설정에서 검증해야 한다(U).
아래 reader/writer는 production Go의 literal SQL, 정적으로 평가한 string expression, 명시적으로 해석한 닫힌 dynamic table allowlist를 exact access matrix에서 집계한 파일이다. 임의 runtime identifier와 실제 call reachability는 U이며, trigger/stored-function 효과는 별도 function/trigger 계약과 함께 본다.
Field 표의 column-level 제약 없음은 해당 column 선언 자체에 제약이 없다는 뜻이다. Composite PK/UNIQUE와 cross-column CHECK는 각 affected field에서 table-level constraint matrix를 함께 연결한다.

`companies`

자산과 scope를 묶는 회사 식별자와 표시 정보를 저장한다.

정적 접근 · reader: db/chat_mentions.go, db/companies.go, db/finding_assets.go, db/task_archives_restore.go, db/task_assets_context.go, db/task_scope.go, db/tasks.go · writer: db/companies.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`name`	`TEXT`	아니오	`—`	표시 이름; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`nkey`	`TEXT`	아니오	`—`	정규화한 unique key; UTF-8 text; 길이 제한 없음	미확정(U)	UNIQUE	C
`logo`	`TEXT`	예	`—`	회사 아바타에 쓰는 원격 이미지 URL이며, 비어 있으면 UI가 회사명 첫 글자로 대체한다. 의미 근거	미확정(U)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_companies_nkey — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`assets`

정규화한 도메인·IP·앱·서비스·endpoint와 관찰 속성, 회사·task provenance를 저장한다.

정적 접근 · reader: db/asset_dsl.go, db/assets.go, db/chat_mentions.go, db/companies.go, db/finding_assets.go, db/finding_retests.go, db/findings.go, db/notification.go, db/task_archives.go, db/task_archives_restore.go, db/task_assets.go, db/task_assets_context.go, db/task_scope.go, db/tasks.go · writer: db/assets.go, db/companies.go, db/task_archives_restore.go, db/task_assets.go, db/tasks.go

transaction·retention · FK delete: SET NULL; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`type`	`TEXT`	아니오	`—`	객체 종류; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (type IN ( 'root_domain','ip','subdomain','app','service','endpoint' ))	C
`company_id`	`BIGINT`	예	`—`	company row 식별자 또는 논리 참조; BIGINT	일반(C)	FK companies(id) ON DELETE SET NULL	A
`company_source`	`TEXT`	아니오	`'explicit'`	company_id 귀속의 출처/우선순위 표지: explicit은 직접 지정, scope는 회사 scope 자동 매칭이며 explicit 귀속을 upsert가 보존한다. 의미 근거	미확정(U)	CHECK (company_source IN ('explicit','scope'))	C
`task_ids`	`BIGINT[]`	아니오	`'{}'`	이 asset을 소유·참조하는 task registry id들의 비정규화 배열이다. task 생성/자산 upsert가 원소를 합치고 task 삭제가 해당 id를 제거한다. 한계: 원소에 FK가 없어 PostgreSQL은 존재하지 않는 task id도 허용한다. 의미 근거	일반(C)	column-level 제약 없음	C
`domain`	`TEXT`	예	`—`	domain 값; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`root_domain`	`TEXT`	예	`—`	등록 가능한 root domain; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`ip`	`TEXT`	예	`—`	IP text; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`c_segment`	`CIDR`	예	`—`	C-segment CIDR; PostgreSQL network type	민감 가능(A)	column-level 제약 없음	C
`port`	`INTEGER`	예	`—`	network port; INTEGER	일반(C)	CHECK (port BETWEEN 1 AND 65535)	C
`icp`	`TEXT`	예	`—`	root-domain/subdomain 자산에 관찰된 ICP 등록·备案 식별 문자열이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`bound_domains`	`TEXT[]`	아니오	`'{}'`	해당 IP에 해석/연결된 도메인 집합이며 upsert·append 시 중복 제거해 합친다; PostgreSQL TEXT[] 배열; 원소 수 제한 없음 의미 근거	미확정(U)	column-level 제약 없음	C
`open_ports`	`JSONB[]`	아니오	`'{}'`	open ports 값; 더 좁은 도메인 의미는 소비 코드에 분산됨; port/service 관찰 객체 배열; 원소의 중앙 SQL 제약은 없음	미확정(U)	column-level 제약 없음	A
`record_type`	`TEXT`	예	`—`	subdomain DNS 레코드 종류이며 A/AAAA일 때 record_value를 IP 자산·바인딩으로 파생한다. 의미 근거	미확정(U)	column-level 제약 없음	C
`record_value`	`TEXT[]`	예	`—`	DNS 레코드 응답 값 목록이며 A/AAAA 값은 IP 후보로 파싱한다; PostgreSQL TEXT[] 배열; 원소 수 제한 없음 의미 근거	미확정(U)	column-level 제약 없음	C
`bundle_id`	`TEXT`	예	`—`	모바일 app package/bundle identifier이며 DB row id가 아니다.; UTF-8 text; 길이 제한 없음 의미 근거	일반(C)	column-level 제약 없음	C
`app_name`	`TEXT`	예	`—`	앱 표시 이름이며 bundle_id가 없을 때 app 자산 중복 제거 키가 된다. 의미 근거	미확정(U)	column-level 제약 없음	C
`category`	`TEXT`	예	`—`	앱 분류/카테고리 문자열이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`app_description`	`TEXT`	예	`—`	앱 자산 설명 문자열이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`app_icp`	`TEXT`	예	`—`	앱에 연결해 저장하는 ICP 등록·备案 식별 문자열이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`url`	`TEXT`	예	`—`	대상 또는 endpoint URL; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`service_type`	`TEXT`	예	`—`	service 자산의 HTTP 계열/기타 구분자이며 현재 writer는 'http' 또는 'other'를 저장한다. 의미 근거	미확정(U)	CHECK (service_type IN ('http','other'))	C
`service_name`	`TEXT`	예	`—`	서비스 이름/프로토콜 표지다. HTTP URL에서는 scheme으로 유도하고 기타 서비스는 입력을 소문자 정규화한다. 의미 근거	미확정(U)	column-level 제약 없음	C
`favicon_mmh3`	`TEXT`	예	`—`	HTTP 서비스 favicon의 MurmurHash3 지문을 문자열로 저장한다. 의미 근거	미확정(U)	column-level 제약 없음	C
`status_code`	`INTEGER`	예	`—`	관찰 HTTP status; INTEGER	일반(C)	column-level 제약 없음	C
`content_length`	`BIGINT`	예	`—`	관찰 content length; BIGINT	일반(C)	column-level 제약 없음	C
`page_title`	`TEXT`	예	`—`	HTTP 서비스 응답에서 관찰한 페이지 제목이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`technologies`	`TEXT[]`	아니오	`'{}'`	HTTP 서비스에서 식별한 기술 스택 문자열 집합이며 upsert 시 중복 제거해 추가 병합한다; PostgreSQL TEXT[] 배열; 원소 수 제한 없음 의미 근거	미확정(U)	column-level 제약 없음	C
`auth`	`JSONB[]`	아니오	`'{}'`	`AuthItem` 배열; type/username/password/token/description을 저장하며 실제 writer/test도 인증 원문을 지속화함 근거	비밀/원문(C)	column-level 제약 없음	C
`method`	`TEXT`	예	`—`	HTTP method; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`params`	`JSONB[]`	아니오	`'{}'`	endpoint `ParamItem` 배열(location/name/value/type); request parameter value에 secret/PII가 포함될 수 있음 근거	민감 가능(A)	column-level 제약 없음	A
`extra`	`JSONB`	아니오	`'{}'`	extra 값; 더 좁은 도메인 의미는 소비 코드에 분산됨; asset 종류별 확장 속성; 중앙 schema 없음	미확정(U)	column-level 제약 없음	A
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`last_seen`	`TIMESTAMPTZ`	아니오	`now()`	마지막 관찰 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · uq_av2_root_domain — asset identity invariant; Upsert* writer가 ON CONFLICT … DO UPDATE로 관찰값·provenance를 merge; partial predicate 밖 row에는 미적용 uq_av2_ip — asset identity invariant; Upsert* writer가 ON CONFLICT … DO UPDATE로 관찰값·provenance를 merge; partial predicate 밖 row에는 미적용 uq_av2_subdomain — asset identity invariant; Upsert* writer가 ON CONFLICT … DO UPDATE로 관찰값·provenance를 merge; partial predicate 밖 row에는 미적용 uq_av2_app_bundle — asset identity invariant; Upsert* writer가 ON CONFLICT … DO UPDATE로 관찰값·provenance를 merge; partial predicate 밖 row에는 미적용 uq_av2_app_name — asset identity invariant; Upsert* writer가 ON CONFLICT … DO UPDATE로 관찰값·provenance를 merge; partial predicate 밖 row에는 미적용 uq_av2_service_http — asset identity invariant; Upsert* writer가 ON CONFLICT … DO UPDATE로 관찰값·provenance를 merge; partial predicate 밖 row에는 미적용 uq_av2_service_other — asset identity invariant; Upsert* writer가 ON CONFLICT … DO UPDATE로 관찰값·provenance를 merge; partial predicate 밖 row에는 미적용 uq_av2_endpoint — asset identity invariant; Upsert* writer가 ON CONFLICT … DO UPDATE로 관찰값·provenance를 merge; partial predicate 밖 row에는 미적용 idx_av2_company — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_av2_company_type — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_av2_task_ids — 배열/JSON 포함 조회의 planner candidate; 실제 query plan 미관찰; write amplification·index 크기 비용 idx_av2_domain — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_av2_root_domain — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_av2_ip — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_av2_c_segment — CIDR containment/overlap 조회의 planner candidate; 실제 query plan 미관찰; GiST 유지 비용; partial predicate 밖 row에는 미적용 idx_av2_technologies — 배열/JSON 포함 조회의 planner candidate; 실제 query plan 미관찰; write amplification·index 크기 비용; partial predicate 밖 row에는 미적용 idx_av2_bound_domains — 배열/JSON 포함 조회의 planner candidate; 실제 query plan 미관찰; write amplification·index 크기 비용; partial predicate 밖 row에는 미적용 idx_av2_open_ports — 배열/JSON 포함 조회의 planner candidate; 실제 query plan 미관찰; write amplification·index 크기 비용; partial predicate 밖 row에는 미적용 idx_av2_last_seen — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰 idx_av2_type_seen — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰

`company_scope`

회사별 허용 domain/IP/CIDR/ICP/keyword scope 항목과 원문·판단 이유를 저장한다.

정적 접근 · reader: db/companies.go · writer: db/companies.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`company_id`	`BIGINT`	아니오	`—`	company row 식별자 또는 논리 참조; BIGINT	일반(C)	FK companies(id) ON DELETE CASCADE <br>table-level: UNIQUE(company_id,domain/net)	A
`kind`	`TEXT`	아니오	`—`	variant 또는 event 종류; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (kind IN ('domain','ip','cidr','icp','keyword')) <br>table-level: kind↔payload CHECK	C
`domain`	`TEXT`	예	`—`	domain 값; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음 <br>table-level: UNIQUE(company_id,domain)+payload CHECK	C
`net`	`CIDR`	예	`—`	IP/CIDR 값; PostgreSQL network type	민감 가능(A)	column-level 제약 없음 <br>table-level: UNIQUE(company_id,net)+payload CHECK	C
`value`	`TEXT`	예	`—`	key가 해석하는 값; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음 <br>table-level: kind↔payload CHECK	C
`raw`	`TEXT`	아니오	`—`	입력 원문; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`reason`	`TEXT`	예	`—`	판정 이유; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_sv2_domain — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_sv2_net — CIDR containment/overlap 조회의 planner candidate; 실제 query plan 미관찰; GiST 유지 비용; partial predicate 밖 row에는 미적용 uq_sv2_value — company scope value dedupe; insert writer의 ON CONFLICT DO NOTHING은 중복을 no-op 처리; partial predicate 밖 row에는 미적용 idx_sv2_icp — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_sv2_company — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`explorations`

task 탐색 graph의 root 상태, 목표와 현재 round를 저장한다.

정적 접근 · reader: db/digest.go, db/exploration.go, db/task_archives.go · writer: db/digest.go, db/exploration.go, db/task_archives_restore.go, db/tasks.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`description`	`TEXT`	예	`—`	설명; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`goal`	`TEXT`	아니오	`—`	완료 목표; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`status`	`TEXT`	아니오	`'open'`	lifecycle 상태; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (status IN ('open','achieved','failed'))	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`round_no`	`BIGINT`	아니오	`0`	exploration round 번호; BIGINT	일반(C)	column-level 제약 없음	C

명시 index와 비용 · 명시 index 없음; PK/UNIQUE가 만드는 내부 index는 102개 분모에 포함하지 않음.

`exploration_nodes`

탐색 graph의 goal/intent/fact/finding/hint/digest 노드, 우선순위와 lifecycle을 저장한다.

정적 접근 · reader: db/assets.go, db/digest.go, db/exploration.go, db/finding_traffic.go, db/findings.go, db/side_questions.go, db/task_archives.go, db/task_archives_restore.go, db/task_assets.go, db/task_assets_context.go, db/task_scope.go, db/tasks.go, db/triggers.go · writer: db/digest.go, db/exploration.go, db/finding_traffic.go, db/findings.go, db/intent_admission.go, db/task_archives_restore.go, db/task_context.go, db/tasks.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`exploration_id`	`BIGINT`	아니오	`—`	exploration row 식별자 또는 논리 참조; BIGINT	일반(C)	FK explorations(id) ON DELETE CASCADE	A
`kind`	`TEXT`	아니오	`—`	variant 또는 event 종류; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음 <br>table-level: ck_node_kind+kind/state CHECK	C
`payload`	`JSONB`	아니오	`'{}'`	kind별 structured payload; kind별 graph payload; agent/db code가 부분적으로 해석하며 중앙 JSON Schema 없음	민감 가능(A)	column-level 제약 없음	A
`priority`	`INT`	아니오	`0`	우선순위; INT	일반(C)	column-level 제약 없음	C
`state`	`TEXT`	아니오	`'open'`	lifecycle 상태; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음 <br>table-level: kind/state CHECK	C
`origin`	`TEXT`	예	`—`	노드를 만든 주체/경로 표지(예: planner, goals, human, worker, system)다. 의미 근거	미확정(U)	column-level 제약 없음	C
`owner`	`TEXT`	예	`—`	running intent를 원자적으로 claim한 실행 주체 표지이며 ClaimIntent가 설정한다. 의미 근거	미확정(U)	column-level 제약 없음	C
`blocked_reason`	`TEXT`	예	`—`	intent를 blocked로 전이시킨 이유이며 동일 이유로 재개할 intent를 찾는 데도 사용한다. 의미 근거	미확정(U)	column-level 제약 없음	C
`delete_reason`	`TEXT`	예	`—`	intent soft-delete(state='deleted') 때 보존하는 사용자 삭제 이유다. 의미 근거	미확정(U)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`completed_at`	`TIMESTAMPTZ`	예	`—`	완료 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`content_version`	`INT`	아니오	`0`	optimistic content version; INT	일반(C)	column-level 제약 없음	C
`cold_since_round`	`BIGINT`	예	`—`	노드가 live downstream branch를 잃어 cold가 된 가장 최근 planner round 번호이며 NULL은 hot이다. 의미 근거	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_expnodes_part — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_expnodes_frontier — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용

`exploration_edges`

한 exploration 안에서 source/destination 노드의 관계 종류를 저장한다.

정적 접근 · reader: db/digest.go, db/exploration.go, db/task_archives.go · writer: db/digest.go, db/exploration.go, db/finding_traffic.go, db/findings.go, db/task_archives_restore.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`exploration_id`	`BIGINT`	아니오	`—`	exploration row 식별자 또는 논리 참조; BIGINT	일반(C)	FK explorations(id) ON DELETE CASCADE <br>table-level: composite PK	A
`src_id`	`BIGINT`	아니오	`—`	src row 식별자 또는 논리 참조; BIGINT	일반(C)	FK exploration_nodes(id) ON DELETE CASCADE <br>table-level: composite PK+no-self	A
`dst_id`	`BIGINT`	아니오	`—`	dst row 식별자 또는 논리 참조; BIGINT	일반(C)	FK exploration_nodes(id) ON DELETE CASCADE <br>table-level: composite PK+no-self	A
`rel`	`TEXT`	아니오	`—`	방향성 탐색 그래프 edge 종류(spawns, derived_from, yields, proves, covers)이며 covers는 digest→member 관계다. 의미 근거	미확정(U)	column-level 제약 없음 <br>table-level: composite PK+rel CHECK	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_expedges_src — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_expedges_dst — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`exploration_anchors`

탐색 노드를 실제 asset에 연결한다.

정적 접근 · reader: db/assets.go, db/digest.go, db/exploration.go, db/findings.go, db/task_archives.go, db/task_archives_restore.go, db/task_assets.go, db/task_assets_context.go, db/task_scope.go, db/tasks.go · writer: db/exploration.go, db/finding_traffic.go, db/findings.go, db/task_archives_restore.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`node_id`	`BIGINT`	아니오	`—`	node row 식별자 또는 논리 참조; BIGINT	일반(C)	FK exploration_nodes(id) ON DELETE CASCADE <br>table-level: composite PK	A
`asset_id`	`BIGINT`	아니오	`—`	asset row 식별자 또는 논리 참조; BIGINT	일반(C)	FK assets(id) ON DELETE CASCADE <br>table-level: composite PK	A

명시 index와 비용 · idx_anchor_asset — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`task_constraints`

탐색별 scope·운영 제약과 그 출처를 저장한다.

정적 접근 · reader: db/constraints.go, db/finding_retests.go, db/task_archives.go · writer: db/constraints.go, db/task_archives_restore.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`exploration_id`	`BIGINT`	아니오	`—`	exploration row 식별자 또는 논리 참조; BIGINT	일반(C)	FK explorations(id) ON DELETE CASCADE	A
`kind`	`TEXT`	아니오	`—`	variant 또는 event 종류; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (kind IN ('allow','deny'))	C
`text`	`TEXT`	아니오	`—`	operator/agent가 작성해 planner·worker prompt에 주입하는 allow/deny 운영 제약의 본문이다. 의미 근거	민감 가능(A)	column-level 제약 없음	C
`origin`	`TEXT`	예	`—`	제약을 만든 주체 표지이며 현재 goals, human, system 계열 값이 사용된다. 의미 근거	미확정(U)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_task_constraints_exp — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`activity`

worker/tool 실행과 token 사용, 오류·요약·detail을 탐색 timeline으로 기록한다.

정적 접근 · reader: db/commands.go, db/exploration.go, db/intercept_execution.go, db/task_archives.go, db/triggers.go · writer: db/exploration.go, db/findings.go, db/intent_admission.go, db/task_archives_restore.go

transaction·retention · FK delete: CASCADE, SET NULL; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`exploration_id`	`BIGINT`	아니오	`—`	exploration row 식별자 또는 논리 참조; BIGINT	일반(C)	FK explorations(id) ON DELETE CASCADE	A
`node_id`	`BIGINT`	예	`—`	node row 식별자 또는 논리 참조; BIGINT	일반(C)	FK exploration_nodes(id) ON DELETE SET NULL	A
`worker`	`TEXT`	예	`—`	worker 식별자; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`kind`	`TEXT`	예	`—`	task exploration 실행 trace 행의 event 종류다. 현재 production writer는 text, thinking, tool_use, tool_result, usage, result, user, round, llm_switch, llm_failover, intercept_request, system을 기록한다. 한계: AppendActivity는 임의 kind를 받고 DB CHECK가 없으므로 닫힌 enum 보장은 아니다. 의미 근거	미확정(U)	column-level 제약 없음	P
`tool`	`TEXT`	예	`—`	tool 이름; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`tool_use_id`	`TEXT`	예	`—`	모델 tool-call 식별자; UTF-8 text; 길이 제한 없음	일반(C)	column-level 제약 없음	C
`is_error`	`BOOLEAN`	아니오	`false`	실행 오류 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`summary`	`TEXT`	예	`—`	요약; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`detail`	`TEXT`	예	`—`	상세 내용; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`metadata`	`JSONB`	아니오	`'{}'`	event별 부가 metadata; activity 종류별 metadata; 생산자별 shape	민감 가능(A)	column-level 제약 없음	A
`input_tokens`	`INTEGER`	예	`—`	입력 token 수; INTEGER	일반(C)	column-level 제약 없음	C
`output_tokens`	`INTEGER`	예	`—`	출력 token 수; INTEGER	일반(C)	column-level 제약 없음	C
`cache_read_tokens`	`INTEGER`	예	`—`	cache read token 수; INTEGER	일반(C)	column-level 제약 없음	C
`cache_write_tokens`	`INTEGER`	예	`—`	cache write token 수; INTEGER	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`main_seg`	`INTEGER`	예	`—`	resettable main-agent 대화 segment 번호다. NULL은 legacy segment 0이고 worker='mainagent' 행에만 사용된다. 의미 근거	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_act_node — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_act_since — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_act_tool_call — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_act_worker — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_act_main_seg — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_act_result_usage — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_act_latest — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰

`main_sessions`

exploration별 main-agent session 순번을 단조 증가시키는 cursor다.

정적 접근 · reader: db/exploration.go · writer: db/exploration.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`exploration_id`	`BIGINT`	아니오	`—`	exploration row 식별자 또는 논리 참조; BIGINT	일반(C)	FK explorations(id) ON DELETE CASCADE <br>table-level: composite PK	A
`seq`	`INTEGER`	아니오	`—`	단조 증가 session 순번; INTEGER	일반(C)	column-level 제약 없음 <br>table-level: composite PK	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · 명시 index 없음; PK/UNIQUE가 만드는 내부 index는 102개 분모에 포함하지 않음.

`settings`

서버 전역 key/value 설정을 저장한다. value의 내부 형식은 key별 소비 코드가 정한다.

정적 접근 · reader: db/settings.go, server/finding_retests.go · writer: db/settings.go, server/finding_retests.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`key`	`TEXT`	아니오	`—`	설정 또는 registry key; UTF-8 text; 길이 제한 없음	미확정(U)	PRIMARY KEY	C
`value`	`TEXT`	아니오	`—`	key가 해석하는 값; UTF-8 text; 길이 제한 없음	key 의존 비밀/원문(C/A)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · 명시 index 없음; PK/UNIQUE가 만드는 내부 index는 102개 분모에 포함하지 않음.

settings.value key-dependent 민감도 · auth.password_hash는 bcrypt hash, provider 검색 설정의 Brave/Tavily key는 credential이다. boolean/URL/일반 정책 key도 같은 TEXT column을 공유하므로 row의 민감도와 encoding은 key consumer가 결정한다. DB column 수준 redaction/encryption은 없다. auth setting runtime setting consumer

`llm_profiles`

LLM endpoint/model/credential, quota, reasoning, retry와 streaming 정책을 저장한다.

정적 접근 · reader: db/config.go, db/task_archives_restore.go · writer: db/config.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`name`	`TEXT`	아니오	`—`	표시 이름; UTF-8 text; 길이 제한 없음	미확정(U)	UNIQUE	C
`format`	`TEXT`	아니오	`—`	provider wire/API 형식 선택자: openai, anthropic, openai-responses다. 의미 근거	미확정(U)	CHECK (format IN ('openai','anthropic','openai-responses'))	C
`base_url`	`TEXT`	예	`—`	LLM/MCP endpoint base URL; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`proxy`	`TEXT`	예	`—`	outbound proxy URL; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`model`	`TEXT`	아니오	`—`	모델 식별자; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`api_key`	`TEXT`	예	`—`	LLM provider 비밀 키; UTF-8 text; 길이 제한 없음	비밀/원문(C)	column-level 제약 없음	C
`api_key_hint`	`TEXT`	예	`—`	API key가 4자 이상이면 ellipsis+마지막 4자로 생성하는 secret-derived UI hint 근거	민감 파생(C)	column-level 제약 없음	C
`rate_per_second`	`DOUBLE PRECISION`	아니오	`0`	초당 LLM 호출 제한; DOUBLE PRECISION	일반(C)	column-level 제약 없음	C
`rate_per_minute`	`DOUBLE PRECISION`	아니오	`0`	분당 LLM 호출 제한; DOUBLE PRECISION	일반(C)	column-level 제약 없음	C
`context_window_k`	`INTEGER`	아니오	`0`	모델 context window를 천 token 단위로 저장해 local compaction 임계값을 정한다. 0은 200K 기본, 최대 1000(1M)으로 clamp한다. 의미 근거	일반(C)	column-level 제약 없음	C
`reasoning_effort`	`TEXT`	아니오	`''`	reasoning 강도 요청값이다. 빈 값은 미전송, 현재 low/medium/high/xhigh/max가 의미 있는 값이며 thinking_type과 독립이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`thinking_type`	`TEXT`	아니오	`''`	thinking 기능 on/off 요청값이다. 빈 값은 미전송, disabled는 명시적 off, enabled는 on이며 reasoning_effort와 독립이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`is_default`	`BOOLEAN`	아니오	`false`	기본 LLM profile 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`priority`	`INTEGER`	아니오	`0`	우선순위; INTEGER	일반(C)	column-level 제약 없음	C
`pool_exclude`	`BOOLEAN`	아니오	`false`	fallback pool 제외 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`streaming`	`BOOLEAN`	아니오	`true`	LLM streaming 사용 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`max_tokens`	`INTEGER`	아니오	`0`	한 번의 모델 답변 output token 상한이다. 0이면 필드를 보내지 않고 endpoint 기본값을 쓴다. 의미 근거	일반(C)	column-level 제약 없음	C
`max_tokens_field`	`TEXT`	아니오	`''`	format=openai에서 output 상한을 보낼 key 선택자다. 빈 값은 max_tokens, 다른 허용값은 max_completion_tokens다. 의미 근거	미확정(U)	column-level 제약 없음	C
`session_header_key`	`TEXT`	아니오	`''`	비어 있지 않으면 매 LLM 요청에 이 이름의 HTTP header를 넣고 현재 run session id를 값으로 보낸다. 의미 근거	미확정(U)	column-level 제약 없음	C
`retry_connect_attempts`	`INTEGER`	아니오	`0`	연결 단계 retry 횟수 override: 0은 global 상속, -1은 비활성, 양수는 해당 횟수다. 의미 근거	일반(C)	column-level 제약 없음	C
`retry_connect_interval_ms`	`INTEGER`	아니오	`0`	retry connect interval 시간(ms); INTEGER	일반(C)	column-level 제약 없음	A
`retry_empty_attempts`	`INTEGER`	아니오	`0`	빈 응답 retry 횟수 override: 0은 global 상속, -1은 비활성, 양수는 해당 횟수다. 의미 근거	일반(C)	column-level 제약 없음	C
`retry_empty_interval_ms`	`INTEGER`	아니오	`0`	retry empty interval 시간(ms); INTEGER	일반(C)	column-level 제약 없음	A
`retry_stream_attempts`	`INTEGER`	아니오	`0`	출력을 아직 전달하지 않은 동일 provider stream 중단 retry 횟수 override: 0 상속, -1 비활성, 양수는 횟수다. 의미 근거	일반(C)	column-level 제약 없음	C
`retry_stream_interval_ms`	`INTEGER`	아니오	`0`	retry stream interval 시간(ms); INTEGER	일반(C)	column-level 제약 없음	A
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · uq_llm_one_default — unique invariant; competing writer 결과는 해당 SQL의 conflict clause/transaction을 확인(U); partial predicate 밖 row에는 미적용

`llm_profile_health`

profile별 circuit-breaker 실패 횟수와 냉각 종료 시각을 재시작 사이에 보존한다.

정적 접근 · reader: db/llmhealth.go · writer: db/llmhealth.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`profile_id`	`BIGINT`	아니오	`—`	profile row 식별자 또는 논리 참조; BIGINT	일반(C)	FK llm_profiles(id) ON DELETE CASCADE; PRIMARY KEY	A
`fails`	`INTEGER`	아니오	`0`	연속 실패 횟수; INTEGER	일반(C)	column-level 제약 없음	C
`trips`	`INTEGER`	아니오	`0`	누적 circuit-breaker trip 횟수; INTEGER	일반(C)	column-level 제약 없음	C
`open_until`	`TIMESTAMPTZ`	예	`—`	circuit breaker 냉각 종료 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`last_error`	`TEXT`	아니오	`''`	마지막 실패 내용; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`last_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 상태 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · 명시 index 없음; PK/UNIQUE가 만드는 내부 index는 102개 분모에 포함하지 않음.

`task_categories`

task를 묶는 사용자 정의 category와 정규화 key를 저장한다.

정적 접근 · reader: db/task_archives.go, db/task_archives_restore.go, db/task_categories.go, db/tasks.go · writer: db/task_categories.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`name`	`TEXT`	아니오	`—`	표시 이름; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`nkey`	`TEXT`	아니오	`—`	정규화한 unique key; UTF-8 text; 길이 제한 없음	미확정(U)	UNIQUE	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_task_categories_name — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`tasks`

task 입력·실행/queue/archive lifecycle, timeout, 회사와 LLM chain 선택을 소유한다.

정적 접근 · reader: db/asset_dsl.go, db/assets.go, db/config.go, db/exploration.go, db/exploration_sources.go, db/finding_assets.go, db/finding_retests.go, db/finding_traffic.go, db/findings.go, db/intercept_execution.go, db/side_questions.go, db/task_archives.go, db/task_archives_restore.go, db/task_assets.go, db/task_assets_context.go, db/task_categories.go, db/task_context.go, db/task_scope.go, db/tasks.go, db/triggers.go · writer: db/config.go, db/task_archives_restore.go, db/task_categories.go, db/task_context.go, db/tasks.go, server/manager.go

transaction·retention · FK delete: RESTRICT, SET NULL; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`name`	`TEXT`	아니오	`''`	표시 이름; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`category_id`	`BIGINT`	예	`—`	category row 식별자 또는 논리 참조; BIGINT	일반(C)	FK task_categories(id) ON DELETE SET NULL	A
`description`	`TEXT`	아니오	`—`	설명; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`goal`	`TEXT`	아니오	`—`	완료 목표; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`exploration_id`	`BIGINT`	아니오	`—`	exploration row 식별자 또는 논리 참조; BIGINT	일반(C)	FK explorations(id) ON DELETE RESTRICT; UNIQUE	A
`status`	`TEXT`	아니오	`'created'`	lifecycle 상태; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (status IN ('created','running','paused','done','failed','timeout'))	C
`paused`	`BOOLEAN`	아니오	`false`	task 일시정지 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`queued`	`BOOLEAN`	아니오	`false`	queue 대기 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`queued_at`	`TIMESTAMPTZ`	예	`—`	queue 등록 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`queue_mode`	`TEXT`	아니오	`''`	concurrency queue admission 종류다. bootstrap은 첫 실행, resume은 기존 graph/history가 있는 탐색 재개이며 빈 legacy 값은 graph로 추론한다. 의미 근거	미확정(U)	column-level 제약 없음	C
`llm_profile_id`	`BIGINT`	예	`—`	llm profile row 식별자 또는 논리 참조; BIGINT	일반(C)	FK llm_profiles(id) ON DELETE SET NULL	A
`active_llm_profile_id`	`BIGINT`	예	`—`	active llm profile row 식별자 또는 논리 참조; BIGINT	일반(C)	FK llm_profiles(id) ON DELETE SET NULL	A
`llm_chain_revision`	`BIGINT`	아니오	`0`	task LLM failover chain의 optimistic revision/cursor로, chain 교체나 active profile 전진 때 증가해 stale 전환을 거부한다. 의미 근거	일반(C)	column-level 제약 없음	C
`company_id`	`BIGINT`	예	`—`	company row 식별자 또는 논리 참조; BIGINT	일반(C)	FK companies(id) ON DELETE SET NULL	A
`parent_ref`	`TEXT`	예	`—`	orchestration spawn_task가 기록하는 부모 task id 문자열이다. 내용 상속(source_task_ids)과 별개인 부모/자식 포인터다. 의미 근거	미확정(U)	column-level 제약 없음	C
`timeout_seconds`	`INTEGER`	아니오	`0`	timeout 길이(초); INTEGER	일반(C)	column-level 제약 없음	C
`plan_heartbeat_seconds`	`INTEGER`	아니오	`300`	planner heartbeat 간격(초); INTEGER	일반(C)	column-level 제약 없음	C
`coverage_enabled`	`BOOLEAN`	아니오	`true`	coverage loop 사용 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`pinned_at`	`TIMESTAMPTZ`	예	`—`	UI pin 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`first_run_at`	`TIMESTAMPTZ`	예	`—`	첫 실행 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`deadline_at`	`TIMESTAMPTZ`	예	`—`	task 강제 종료 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`archived_at`	`TIMESTAMPTZ`	예	`—`	archive 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`deleted_at`	`TIMESTAMPTZ`	예	`—`	soft-delete 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`completed_at`	`TIMESTAMPTZ`	예	`—`	완료 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_tasks_alive — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_tasks_status — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_tasks_category — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_tasks_pinned — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_tasks_archived — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_tasks_llm_profile — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_tasks_active_llm_profile — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용

`task_archives`

archive job 진행 상태와 생성 artifact 경로/hash, 복원용 snapshot 통계를 저장한다.

정적 접근 · reader: db/finding_traffic.go, db/task_archives.go, db/task_archives_restore.go · writer: db/task_archives.go, db/task_archives_restore.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`task_id`	`BIGINT`	아니오	`—`	task row 식별자 또는 논리 참조; BIGINT	일반(C)	FK tasks(id) ON DELETE CASCADE; UNIQUE	A
`state`	`TEXT`	아니오	`'archive_queued'`	lifecycle 상태; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (state IN ( 'archive_queued','archiving','archive_failed','ready', 'restore_queued','restoring','restore_failed', 'delete_queued','deleting','delete_failed' ))	C
`phase`	`TEXT`	아니오	`'queued'`	현재 archive/restore/delete job 내부 처리 단계 이름이다. state보다 세밀한 진행 위치를 UI/복구에 제공한다. 의미 근거	미확정(U)	column-level 제약 없음	C
`progress`	`INTEGER`	아니오	`0`	archive job 진행률 0..100 정수다. 의미 근거	일반(C)	CHECK (progress BETWEEN 0 AND 100)	C
`error`	`TEXT`	아니오	`''`	실패 내용; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`warnings`	`JSONB`	아니오	`'[]'`	archive/restore 과정의 비치명 경고 문자열 배열을 JSON으로 저장한다. 의미 근거	미확정(U)	column-level 제약 없음	P
`format_version`	`INTEGER`	아니오	`2`	archive format version; INTEGER	일반(C)	column-level 제약 없음	C
`archive_path`	`TEXT`	아니오	`''`	archive artifact 경로; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`sha256`	`TEXT`	아니오	`''`	archive artifact SHA-256; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`original_size`	`BIGINT`	아니오	`0`	원본 byte 크기; BIGINT	일반(C)	column-level 제약 없음	C
`compressed_size`	`BIGINT`	아니오	`0`	압축 byte 크기; BIGINT	일반(C)	column-level 제약 없음	C
`task_name`	`TEXT`	아니오	`''`	cold archive 생성 시점 task 이름 snapshot이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`task_description`	`TEXT`	아니오	`''`	cold archive 생성 시점 task description snapshot이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`task_goal`	`TEXT`	아니오	`''`	cold archive 생성 시점 task goal snapshot이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`original_status`	`TEXT`	아니오	`''`	archive 직전 task status snapshot으로 restore 때 원 상태를 복원하는 값이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`category_id_snapshot`	`BIGINT`	예	`—`	archive 시점 task category id snapshot이며 category가 사라질 수 있어 FK가 아니다. 의미 근거	일반(C)	column-level 제약 없음	C
`category_name_snapshot`	`TEXT`	아니오	`''`	archive 시점 task category 표시 이름 snapshot이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`source_task_ids`	`BIGINT[]`	아니오	`'{}'`	archive provenance task 목록; PostgreSQL BIGINT[] 배열; 원소 수 제한 없음	일반(C)	column-level 제약 없음	A
`remaining_timeout_seconds`	`BIGINT`	아니오	`0`	remaining timeout 시간(초); BIGINT	일반(C)	column-level 제약 없음	A
`data_counts`	`JSONB`	아니오	`'{}'`	archive 객체별 건수; archive 내 객체별 count map	미확정(U)	column-level 제약 없음	A
`aggregate_stats`	`JSONB`	아니오	`'{}'`	archive 집계 통계; archive 집계 map; format_version과 함께 해석	미확정(U)	column-level 제약 없음	A
`archived_at`	`TIMESTAMPTZ`	예	`—`	archive 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`requested_at`	`TIMESTAMPTZ`	아니오	`now()`	archive 요청 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_task_archives_state — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_task_archives_archived — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰 idx_task_archives_sources — 배열/JSON 포함 조회의 planner candidate; 실제 query plan 미관찰; write amplification·index 크기 비용

`task_templates`

재사용할 task 설명·goal·category와 intercept rule snapshot을 저장한다.

정적 접근 · reader: db/task_templates.go · writer: db/task_templates.go

transaction·retention · FK delete: SET NULL; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`name`	`TEXT`	아니오	`—`	표시 이름; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`nkey`	`TEXT`	아니오	`—`	정규화한 unique key; UTF-8 text; 길이 제한 없음	미확정(U)	UNIQUE	C
`description`	`TEXT`	아니오	`—`	설명; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`goal`	`TEXT`	아니오	`—`	완료 목표; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`category_id`	`BIGINT`	예	`—`	category row 식별자 또는 논리 참조; BIGINT	일반(C)	FK task_categories(id) ON DELETE SET NULL	A
`intercept_rules`	`JSONB`	아니오	`'[]'`	template의 intercept rule snapshot; template 적용 시 복원할 intercept rule 배열	미확정(U)	column-level 제약 없음	A
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_task_templates_updated — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰

`task_relations`

파생 task와 source task 사이 provenance edge를 저장한다.

정적 접근 · reader: db/asset_dsl.go, db/exploration_sources.go, db/task_archives.go, db/task_archives_restore.go, db/task_assets.go, db/task_assets_context.go, db/task_context.go, db/task_scope.go · writer: db/task_archives_restore.go, db/tasks.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`task_id`	`BIGINT`	아니오	`—`	task row 식별자 또는 논리 참조; BIGINT	일반(C)	FK tasks(id) ON DELETE CASCADE <br>table-level: composite PK+no-self	A
`source_task_id`	`BIGINT`	아니오	`—`	source task row 식별자 또는 논리 참조; BIGINT	일반(C)	FK tasks(id) ON DELETE CASCADE <br>table-level: composite PK+no-self	A
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_task_relations_source — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`task_asset_links`

task와 asset 연결의 출처, 요약과 source exploration node를 저장한다.

정적 접근 · reader: db/task_archives.go, db/task_assets.go · writer: db/task_archives_restore.go, db/task_assets.go, db/tasks.go

transaction·retention · FK delete: CASCADE, SET NULL; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`task_id`	`BIGINT`	아니오	`—`	task row 식별자 또는 논리 참조; BIGINT	일반(C)	FK tasks(id) ON DELETE CASCADE <br>table-level: composite PK	A
`asset_id`	`BIGINT`	아니오	`—`	asset row 식별자 또는 논리 참조; BIGINT	일반(C)	FK assets(id) ON DELETE CASCADE <br>table-level: composite PK	A
`source`	`TEXT`	아니오	`'system'`	task-asset 연결 provenance 종류다. 현재 system, legacy, auto/agent/manual 및 상세 writer가 쓰는 출처를 operator review에 노출한다; DB enum은 없다. 의미 근거	미확정(U)	column-level 제약 없음	P
`source_summary`	`TEXT`	아니오	`''`	task-asset 연결이 생긴 이유를 사람이 읽을 수 있게 저장한 provenance 설명이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`source_node_id`	`BIGINT`	예	`—`	source node row 식별자 또는 논리 참조; BIGINT	일반(C)	FK exploration_nodes(id) ON DELETE SET NULL	A
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_task_asset_links_asset — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_task_asset_links_node — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용

`task_llm_profiles`

task별 LLM fallback chain의 순서와 소진 상태를 저장한다.

정적 접근 · reader: db/config.go, db/task_archives.go, db/task_context.go · writer: db/config.go, db/task_archives_restore.go, db/task_context.go, db/tasks.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`task_id`	`BIGINT`	아니오	`—`	task row 식별자 또는 논리 참조; BIGINT	일반(C)	FK tasks(id) ON DELETE CASCADE <br>table-level: composite PK+UNIQUE position	A
`profile_id`	`BIGINT`	아니오	`—`	profile row 식별자 또는 논리 참조; BIGINT	일반(C)	FK llm_profiles(id) ON DELETE CASCADE <br>table-level: composite PK	A
`position`	`INTEGER`	아니오	`—`	정렬 순서; INTEGER	일반(C)	CHECK (position >= 0) <br>table-level: UNIQUE(task_id,position)	C
`status`	`TEXT`	아니오	`'ready'`	lifecycle 상태; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (status IN ('ready','quota_exhausted'))	C
`last_error`	`TEXT`	예	`—`	마지막 실패 내용; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`exhausted_at`	`TIMESTAMPTZ`	예	`—`	exhausted 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	A
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_task_llm_profiles_order — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_task_llm_profiles_profile — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`task_scope`

task에 적용할 company/domain/IP/CIDR/ICP/keyword scope와 출처를 저장한다.

정적 접근 · reader: db/asset_dsl.go, db/task_archives.go, db/task_assets_context.go, db/task_context.go, db/task_scope.go · writer: db/task_archives_restore.go, db/task_scope.go, db/tasks.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`task_id`	`BIGINT`	아니오	`—`	task row 식별자 또는 논리 참조; BIGINT	일반(C)	FK tasks(id) ON DELETE CASCADE	A
`kind`	`TEXT`	아니오	`—`	variant 또는 event 종류; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (kind IN ('company','root_domain','subdomain','ip','cidr','icp','keyword'))	C
`company_id`	`BIGINT`	예	`—`	company row 식별자 또는 논리 참조; BIGINT	일반(C)	FK companies(id) ON DELETE CASCADE	A
`domain`	`TEXT`	예	`—`	domain 값; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`net`	`CIDR`	예	`—`	IP/CIDR 값; PostgreSQL network type	민감 가능(A)	column-level 제약 없음	C
`value`	`TEXT`	예	`—`	key가 해석하는 값; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`source`	`TEXT`	아니오	`'auto'`	scope 항목 생성 경로: auto는 자산 삽입 자동 범위, agent는 add_task_scope, manual은 UI/사용자 입력이다. 의미 근거	미확정(U)	CHECK (source IN ('auto','agent','manual'))	C
`reason`	`TEXT`	예	`—`	판정 이유; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · uq_task_scope_v2 — task scope identity dedupe; insert writer의 ON CONFLICT DO NOTHING은 중복을 no-op 처리; same-name stale index definition은 startup이 수리하지 않음 idx_ts_domain — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_ts_net — CIDR containment/overlap 조회의 planner candidate; 실제 query plan 미관찰; GiST 유지 비용; partial predicate 밖 row에는 미적용 idx_ts_company — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용

`agents`

agent role, prompt/profile binding, turn/time limit, tool mode와 trigger 실행 정책을 저장한다.

정적 접근 · reader: db/config.go, db/db.go · writer: db/config.go, db/db.go, server/finding_retests.go

transaction·retention · FK delete: SET NULL; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

trigger_run_mode/trigger_merge_mode CHECK는 fresh table에는 있지만 legacy ADD COLUMN 경로에는 없다. 아래 제약 열은 fresh 최종 선언이며 upgraded DB 전역에 보편적으로 적용된다고 단정하지 않는다. fresh/upgrade 경계

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`key`	`TEXT`	아니오	`—`	설정 또는 registry key; UTF-8 text; 길이 제한 없음	미확정(U)	UNIQUE; CHECK (key ~ '^[a-z][a-z0-9_]*$')	C
`name`	`TEXT`	아니오	`—`	표시 이름; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`description`	`TEXT`	예	`—`	설명; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`role`	`TEXT`	아니오	`—`	agent 실행 역할 allowlist(goals, main, planner, worker, assistant)이며 relation/evidence role이 아니다.; UTF-8 text; 길이 제한 없음 의미 근거	미확정(U)	column-level 제약 없음 <br>table-level: agents_role_ck	C
`builtin`	`BOOLEAN`	아니오	`true`	built-in 객체 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`enabled`	`BOOLEAN`	아니오	`true`	활성화 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`llm_profile_id`	`BIGINT`	예	`—`	llm profile row 식별자 또는 논리 참조; BIGINT	일반(C)	FK llm_profiles(id) ON DELETE SET NULL	A
`current_prompt_id`	`BIGINT`	예	`—`	current prompt row 식별자 또는 논리 참조; BIGINT	일반(C)	fixed-source/startup intent: FK agent_prompts(id) ON DELETE SET NULL; same-name wrong definition은 `duplicate_object`로 미수리 가능	A
`max_turns`	`INTEGER`	아니오	`0`	agent 최대 turn 수; INTEGER	일반(C)	column-level 제약 없음	C
`run_seconds`	`INTEGER`	아니오	`1200`	agent 실행 제한(초); INTEGER	일반(C)	column-level 제약 없음	C
`web_search`	`BOOLEAN`	아니오	`false`	agent web search 허용 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`interactive_shell`	`BOOLEAN`	아니오	`false`	agent interactive shell 허용 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`wrapup_prompt`	`TEXT`	아니오	`''`	wrapup 시 사용할 prompt; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	A
`wrapup_max_turns`	`INTEGER`	아니오	`0`	wrapup prompt 최대 turn; INTEGER	일반(C)	column-level 제약 없음	A
`task_timeout_wrapup_prompt`	`TEXT`	아니오	`''`	task timeout wrapup 시 사용할 prompt; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	A
`task_timeout_wrapup_max_turns`	`INTEGER`	아니오	`0`	task timeout wrapup prompt 최대 turn; INTEGER	일반(C)	column-level 제약 없음	A
`trigger_run_mode`	`TEXT`	아니오	`'serial'`	agent trigger fire 실행 방식: serial은 agent별 1개씩, parallel은 각 fire를 별도 대화로 동시 실행한다. 의미 근거	미확정(U)	CHECK (trigger_run_mode IN ('serial','parallel'))	C
`trigger_merge_mode`	`TEXT`	아니오	`'all'`	serial trigger queue의 병합 정책: by_task, all, none이며 parallel에서는 무시된다. 의미 근거	미확정(U)	CHECK (trigger_merge_mode IN ('by_task','all','none'))	C
`trigger_max_parallel`	`INTEGER`	아니오	`5`	parallel trigger mode의 agent별 동시 실행 상한이다. 0 이하이면 무제한으로 처리한다. 의미 근거	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_agents_llm_profile — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용

`agent_prompts`

agent prompt template의 version history와 작성 메타데이터를 저장한다.

정적 접근 · reader: db/config.go · writer: db/config.go, server/finding_retests.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`agent_id`	`BIGINT`	아니오	`—`	agent row 식별자 또는 논리 참조; BIGINT	일반(C)	FK agents(id) ON DELETE CASCADE <br>table-level: UNIQUE(agent_id,version)	A
`version`	`INT`	아니오	`—`	version 번호; INT	일반(C)	column-level 제약 없음 <br>table-level: UNIQUE(agent_id,version)	C
`template_text`	`TEXT`	아니오	`—`	agent prompt template; UTF-8 text; 길이 제한 없음	비밀/원문(C)	column-level 제약 없음	C
`note`	`TEXT`	예	`—`	운영 메모; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`updated_by`	`TEXT`	예	`—`	prompt version을 저장하거나 seed한 actor/source 표지(예: system 또는 요청자 값)다. 의미 근거	미확정(U)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · 명시 index 없음; PK/UNIQUE가 만드는 내부 index는 102개 분모에 포함하지 않음.

`agent_prompt_vars`

agent prompt에서 치환할 변수의 설명·예시·source를 저장한다.

정적 접근 · reader: db/config.go · writer: db/db.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`agent_id`	`BIGINT`	아니오	`—`	agent row 식별자 또는 논리 참조; BIGINT	일반(C)	FK agents(id) ON DELETE CASCADE <br>table-level: UNIQUE(agent_id,var_name)	A
`var_name`	`TEXT`	아니오	`—`	Go text/template에서 {{.Name}} 형태로 참조하는 prompt 변수 이름이다. 의미 근거	미확정(U)	column-level 제약 없음 <br>table-level: UNIQUE(agent_id,var_name)	C
`description`	`TEXT`	예	`—`	설명; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`example`	`TEXT`	예	`—`	prompt preview에 쓰는 해당 변수의 예시 값이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`source`	`TEXT`	아니오	`—`	변수 값의 공급 계층: exploration, runtime, distilled 중 하나다. 의미 근거	미확정(U)	CHECK (source IN ('exploration','runtime','distilled'))	C

명시 index와 비용 · 명시 index 없음; PK/UNIQUE가 만드는 내부 index는 102개 분모에 포함하지 않음.

`mcp_servers`

MCP transport/command/URL/environment와 활성화·TLS 완화 설정을 저장한다.

정적 접근 · reader: db/config.go · writer: db/config.go, db/db.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`name`	`TEXT`	아니오	`—`	표시 이름; UTF-8 text; 길이 제한 없음	미확정(U)	UNIQUE	C
`transport`	`TEXT`	아니오	`—`	MCP 연결 방식 선택자: stdio, http, sse다. 의미 근거	미확정(U)	CHECK (transport IN ('stdio','http','sse'))	C
`command`	`TEXT`	예	`—`	transport=stdio일 때 실행할 MCP server 프로그램/command이며 네트워크 transport에서는 비어 있을 수 있다. 의미 근거	미확정(U)	column-level 제약 없음	C
`args`	`JSONB`	아니오	`'[]'`	stdio MCP command 인자 JSON 배열; CLI flag/value에 credential이 들어갈 수 있음 근거	민감 가능(A)	column-level 제약 없음	A
`env`	`JSONB`	아니오	`'{}'`	MCP child process 환경 변수; 환경 변수 key/value object; 비밀 포함 가능	비밀/원문(C)	column-level 제약 없음	A
`url`	`TEXT`	예	`—`	대상 또는 endpoint URL; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`enabled`	`BOOLEAN`	아니오	`true`	활성화 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`insecure`	`BOOLEAN`	아니오	`false`	TLS 검증 완화 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · 명시 index 없음; PK/UNIQUE가 만드는 내부 index는 102개 분모에 포함하지 않음.

`mcp_tools_cache`

MCP discovery 결과인 tool 이름·설명·input schema snapshot을 저장한다.

정적 접근 · reader: db/config.go · writer: db/config.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`server_id`	`BIGINT`	아니오	`—`	server row 식별자 또는 논리 참조; BIGINT	일반(C)	FK mcp_servers(id) ON DELETE CASCADE <br>table-level: UNIQUE(server_id,tool_name)	A
`tool_name`	`TEXT`	아니오	`—`	원격 MCP tools/list에서 발견해 해당 server_id 아래 cache한 tool 이름이다. 의미 근거	미확정(U)	column-level 제약 없음 <br>table-level: UNIQUE(server_id,tool_name)	C
`description`	`TEXT`	예	`—`	설명; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`schema`	`JSONB`	예	`—`	tool/MCP input JSON Schema; MCP tool input JSON Schema	미확정(U)	column-level 제약 없음	A
`discovered_at`	`TIMESTAMPTZ`	아니오	`now()`	MCP discovery 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · 명시 index 없음; PK/UNIQUE가 만드는 내부 index는 102개 분모에 포함하지 않음.

`agent_visibility`

agent가 볼 MCP server/tool 또는 resource의 allow/deny override를 저장한다.

정적 접근 · reader: db/config.go · writer: db/config.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`agent_id`	`BIGINT`	아니오	`—`	agent row 식별자 또는 논리 참조; BIGINT	일반(C)	FK agents(id) ON DELETE CASCADE <br>table-level: composite PK	A
`resource_kind`	`TEXT`	아니오	`—`	agent visibility 대상 종류이며 현재 schema allowlist는 mcp 하나다. 의미 근거	미확정(U)	CHECK (resource_kind IN ('mcp')) <br>table-level: composite PK	C
`resource_id`	`BIGINT`	아니오	`—`	resource_kind=mcp인 가시성 행에서 노출 대상 MCP server의 id다. agent별/자원별 조회와 삭제가 같은 (kind, resource_id)를 사용한다. 한계: mcp_servers(id) FK가 없어 삭제 정합성은 application 경로에 의존한다. 의미 근거	일반(C)	column-level 제약 없음 <br>table-level: composite PK	C
`mcp_tool_name`	`TEXT`	아니오	`''`	복합 PK의 MCP tool 세분화 자리지만 현재 production visibility writer/reader는 server 단위 resource_id만 사용하고 이 값은 기본 빈 문자열이다. tool-level 의미/consumer는 구현되지 않았다. 의미 근거	미확정(U)	column-level 제약 없음 <br>table-level: composite PK	C
`enabled`	`BOOLEAN`	아니오	`true`	활성화 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_vis_resource — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`agent_skill_visibility`

agent별 skill 노출 override를 저장한다.

정적 접근 · reader: db/config.go · writer: db/config.go, db/db.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`agent_id`	`BIGINT`	아니오	`—`	agent row 식별자 또는 논리 참조; BIGINT	일반(C)	FK agents(id) ON DELETE CASCADE <br>table-level: composite PK	A
`skill_name`	`TEXT`	아니오	`—`	agent에게 보이도록 허용한 filesystem skill의 이름이다. 의미 근거	미확정(U)	column-level 제약 없음 <br>table-level: composite PK	C
`enabled`	`BOOLEAN`	아니오	`true`	활성화 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_askv_skill — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`skill_usage`

skill 탐색/호출의 task·intent·session attribution과 발견 여부를 기록한다.

정적 접근 · reader: db/skill_usage.go, db/task_archives.go · writer: db/skill_usage.go, db/task_archives_restore.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`ts`	`TIMESTAMPTZ`	아니오	`now()`	event 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`skill`	`TEXT`	아니오	`—`	Skill 호출에서 모델이 요청한 skill 이름이다. found=false면 존재하지 않은 이름도 gap 분석을 위해 남긴다. 의미 근거	미확정(U)	column-level 제약 없음	C
`agent_key`	`TEXT`	예	`—`	agent registry key; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`task_id`	`BIGINT`	예	`—`	Skill 호출이 귀속된 task registry id다. chat/non-task 실행은 RunInfo의 0을 SQL NULL로 저장하며 task 삭제 뒤에도 통계를 보존한다. 의미 근거	일반(C)	column-level 제약 없음	C
`exploration_id`	`BIGINT`	예	`—`	Skill 호출이 귀속된 exploration id다. RunInfo에서 알 수 없으면 0을 SQL NULL로 저장한다. 의미 근거	일반(C)	column-level 제약 없음	C
`intent_id`	`BIGINT`	예	`—`	Skill 호출이 귀속된 worker intent node id다. planner/mainagent/chat 또는 알 수 없는 실행은 0을 SQL NULL로 저장한다. 의미 근거	일반(C)	column-level 제약 없음	C
`session_id`	`TEXT`	예	`—`	agent/LLM session 식별자; UTF-8 text; 길이 제한 없음	일반(C)	column-level 제약 없음	C
`args_len`	`INTEGER`	아니오	`0`	Skill 호출 input args 문자열의 Go len 값, 즉 UTF-8 byte 길이다. 본문 자체는 저장하지 않는다. 의미 근거	일반(C)	column-level 제약 없음	C
`found`	`BOOLEAN`	아니오	`true`	skill 발견 여부; BOOLEAN	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_skill_usage_skill — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰 idx_skill_usage_task — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`tool_usage`

tool 호출의 task·intent·session attribution을 기록한다.

정적 접근 · reader: db/task_archives.go, db/tool_usage.go · writer: db/task_archives_restore.go, db/tool_usage.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`ts`	`TIMESTAMPTZ`	아니오	`now()`	event 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`tool_key`	`TEXT`	아니오	`—`	tool registry key; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`agent_key`	`TEXT`	예	`—`	agent registry key; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`task_id`	`BIGINT`	예	`—`	catalog tool 호출이 귀속된 task registry id다. RunInfo의 0은 SQL NULL이며 task 삭제 뒤에도 통계를 보존한다. 의미 근거	일반(C)	column-level 제약 없음	C
`exploration_id`	`BIGINT`	예	`—`	catalog tool 호출이 귀속된 exploration id다. RunInfo에서 알 수 없으면 0을 SQL NULL로 저장한다. 의미 근거	일반(C)	column-level 제약 없음	C
`intent_id`	`BIGINT`	예	`—`	catalog tool 호출이 귀속된 worker intent node id다. planner/mainagent/chat 또는 알 수 없는 실행은 0을 SQL NULL로 저장한다. 의미 근거	일반(C)	column-level 제약 없음	C
`session_id`	`TEXT`	예	`—`	agent/LLM session 식별자; UTF-8 text; 길이 제한 없음	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_tool_usage_tool — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰 idx_tool_usage_task — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`tools`

built-in/custom tool의 schema, agent visibility, exec binding과 deferred flag를 저장한다.

정적 접근 · reader: db/config.go, db/tools.go · writer: db/tools.go, server/finding_traffic.go, server/finding_workflow.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`key`	`TEXT`	아니오	`—`	설정 또는 registry key; UTF-8 text; 길이 제한 없음	미확정(U)	PRIMARY KEY	C
`system`	`BOOLEAN`	아니오	`true`	system tool 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`description`	`TEXT`	아니오	`''`	설명; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`schema`	`JSONB`	아니오	`'{}'`	tool/MCP input JSON Schema; tool input JSON Schema	미확정(U)	column-level 제약 없음	A
`agents`	`JSONB`	아니오	`'[]'`	agents 값; 더 좁은 도메인 의미는 소비 코드에 분산됨; 노출 agent key 배열	미확정(U)	column-level 제약 없음	A
`enabled`	`BOOLEAN`	아니오	`true`	활성화 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`kind`	`TEXT`	아니오	`'builtin'`	tool kind를 구분한다. builtin은 seeded platform tool, command/script/http는 실행 가능한 custom tool, shell은 Bash 환경 선언·hint이며 callable custom dispatch 대상이 아니다. 한계: DB CHECK가 없고 낮은 수준 DB writer는 임의 문자열을 저장할 수 있다. 의미 근거	미확정(U)	column-level 제약 없음	P
`exec`	`JSONB`	아니오	`'{}'`	executable custom tool의 command template, Python script 또는 HTTP URL/header/body/proxy spec이다. shell row는 환경 metadata라 dispatcher가 exec를 쓰지 않지만 DB는 임의 JSON을 보존할 수 있다. Authorization/Bearer 같은 credential-bearing 구성을 저장할 수 있음 근거	민감 가능(A)	JSON 구조의 DB CHECK 없음	A
`deferred`	`BOOLEAN`	아니오	`false`	지연 실행 tool 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · 명시 index 없음; PK/UNIQUE가 만드는 내부 index는 102개 분모에 포함하지 않음.

`conversations`

대화형 agent session의 agent/profile binding, title과 pin 시각을 저장한다.

정적 접근 · reader: db/config.go, db/conversation.go, db/intercept.go, db/intercept_detail.go, db/side_questions.go · writer: db/conversation.go, db/finding_retests.go

transaction·retention · FK delete: SET NULL; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`agent_key`	`TEXT`	아니오	`—`	agent registry key; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`title`	`TEXT`	아니오	`''`	대화 목록/UI에 표시하는 conversation 제목이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`llm_profile_id`	`BIGINT`	예	`—`	llm profile row 식별자 또는 논리 참조; BIGINT	일반(C)	FK llm_profiles(id) ON DELETE SET NULL	A
`pinned_at`	`TIMESTAMPTZ`	예	`—`	UI pin 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_conversations_llm_profile — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_conversations_pinned — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용

`conversation_activities`

conversation worker/tool timeline, 오류·token accounting을 저장한다.

정적 접근 · reader: db/conversation.go, db/intercept_execution.go · writer: db/conversation.go, db/finding_retests.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`conversation_id`	`BIGINT`	아니오	`—`	conversation row 식별자 또는 논리 참조; BIGINT	일반(C)	FK conversations(id) ON DELETE CASCADE	A
`worker`	`TEXT`	예	`—`	worker 식별자; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`kind`	`TEXT`	예	`—`	대화 trace의 human/agent execution event 종류다. 현재 production writer는 user, text, thinking, tool_use, tool_result, usage, result, intercept_request를 기록한다. 한계: AppendConvActivity는 임의 kind를 받고 DB CHECK가 없으므로 닫힌 enum 보장은 아니다. 의미 근거	미확정(U)	column-level 제약 없음	P
`tool`	`TEXT`	예	`—`	tool 이름; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`tool_use_id`	`TEXT`	예	`—`	모델 tool-call 식별자; UTF-8 text; 길이 제한 없음	일반(C)	column-level 제약 없음	C
`is_error`	`BOOLEAN`	아니오	`false`	실행 오류 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`summary`	`TEXT`	예	`—`	요약; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`detail`	`TEXT`	예	`—`	상세 내용; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`input_tokens`	`INTEGER`	예	`—`	입력 token 수; INTEGER	일반(C)	column-level 제약 없음	C
`output_tokens`	`INTEGER`	예	`—`	출력 token 수; INTEGER	일반(C)	column-level 제약 없음	C
`cache_read_tokens`	`INTEGER`	예	`—`	cache read token 수; INTEGER	일반(C)	column-level 제약 없음	C
`cache_write_tokens`	`INTEGER`	예	`—`	cache write token 수; INTEGER	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_conv_act — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_conv_act_tool_call — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용

`agent_triggers`

agent의 interval·event trigger 조건, message와 마지막 실행 시각을 저장한다.

정적 접근 · reader: db/triggers.go · writer: db/triggers.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`agent_key`	`TEXT`	아니오	`—`	agent registry key; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`enabled`	`BOOLEAN`	아니오	`true`	활성화 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`interval_sec`	`INTEGER`	아니오	`0`	trigger interval(초); INTEGER	일반(C)	column-level 제약 없음	C
`on_finding`	`BOOLEAN`	아니오	`false`	새 finding event가 persisted watermark를 넘을 때 이 agent trigger를 발화할지 정한다. 의미 근거	일반(C)	column-level 제약 없음	C
`on_goal_met`	`BOOLEAN`	아니오	`false`	goal이 met로 바뀐 event에 이 agent trigger를 발화할지 정한다. 의미 근거	일반(C)	column-level 제약 없음	C
`on_task_timeout`	`BOOLEAN`	아니오	`false`	task가 timeout terminal state에 새로 진입했을 때 trigger를 발화할지 정한다. 의미 근거	일반(C)	column-level 제약 없음	C
`on_tool_call`	`BOOLEAN`	아니오	`false`	선택한 tool_names의 tool_result event에 trigger를 발화할지 정한다. 의미 근거	일반(C)	column-level 제약 없음	C
`on_task_create`	`BOOLEAN`	아니오	`false`	새 task id가 persisted watermark를 넘을 때 trigger를 발화할지 정한다. 의미 근거	일반(C)	column-level 제약 없음	C
`interval_message`	`TEXT`	아니오	`''`	interval trigger message; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	A
`finding_message`	`TEXT`	아니오	`''`	finding trigger message; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	A
`goal_message`	`TEXT`	아니오	`''`	goal trigger message; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	A
`task_timeout_message`	`TEXT`	아니오	`''`	task timeout trigger message; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	A
`tool_call_message`	`TEXT`	아니오	`''`	tool call trigger message; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	A
`task_create_message`	`TEXT`	아니오	`''`	task create trigger message; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	A
`tool_names`	`TEXT`	아니오	`''`	on_tool_call trigger가 감시할 tool key 목록을 JSON text로 encode한 값이며 empty on_tool_call은 API가 거부한다. 의미 근거	미확정(U)	column-level 제약 없음	C
`last_fire`	`TIMESTAMPTZ`	예	`—`	trigger 마지막 실행 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_agent_triggers_agent — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`scheduler_state`

scheduler cursor/watermark 같은 작은 key/value 상태를 저장한다.

정적 접근 · reader: db/triggers.go · writer: db/triggers.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`key`	`TEXT`	아니오	`—`	설정 또는 registry key; UTF-8 text; 길이 제한 없음	미확정(U)	PRIMARY KEY	C
`value`	`TEXT`	아니오	`''`	key가 해석하는 값; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C

명시 index와 비용 · 명시 index 없음; PK/UNIQUE가 만드는 내부 index는 102개 분모에 포함하지 않음.

`intercept_rules`

tool-call 승인/차단 규칙의 match 조건, action과 timeout 결정을 저장한다.

정적 접근 · reader: db/db.go, db/intercept.go, db/intercept_detail.go · writer: db/db.go, db/intercept.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`name`	`TEXT`	아니오	`—`	표시 이름; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`enabled`	`BOOLEAN`	아니오	`true`	활성화 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`priority`	`INTEGER`	아니오	`0`	우선순위; INTEGER	일반(C)	column-level 제약 없음	C
`match_target`	`TEXT`	아니오	`—`	규칙이 비교할 대상: tool_name 또는 직렬화된 tool_input이다. 의미 근거	미확정(U)	CHECK (match_target IN ('tool_name', 'tool_input'))	C
`match_type`	`TEXT`	아니오	`—`	pattern 해석 방식: literal string 또는 regex다. 의미 근거	미확정(U)	CHECK (match_type IN ('string', 'regex'))	C
`pattern`	`TEXT`	아니오	`—`	match pattern; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`action`	`TEXT`	아니오	`—`	rule 결정; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (action IN ('allow', 'deny', 'ask'))	C
`message`	`TEXT`	아니오	`''`	rule 또는 trigger message; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`timeout_enabled`	`BOOLEAN`	아니오	`true`	승인 timeout 사용 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`timeout_seconds`	`INTEGER`	아니오	`60`	timeout 길이(초); INTEGER	일반(C)	column-level 제약 없음	C
`timeout_action`	`TEXT`	아니오	`'deny'`	승인 timeout 시 결정; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`NOW()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`NOW()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · 명시 index 없음; PK/UNIQUE가 만드는 내부 index는 102개 분모에 포함하지 않음.

`intercept_pending`

승인 대기 tool call의 원 입력·결정·감사 기록과 conversation/task 문맥을 저장한다.

정적 접근 · reader: db/intercept.go, db/intercept_detail.go, db/task_archives.go · writer: db/intercept.go, db/intercept_detail.go, db/task_archives_restore.go

transaction·retention · FK delete: CASCADE, SET NULL; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

decision_source 빈 값은 startup마다 rule/model/unknown으로 반복 backfill된다. Field default가 빈 문자열이라도 startup 후 기존 row의 실제 값은 이 CASE 조건에 달려 있다. migration 경계

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`rule_id`	`BIGINT`	예	`—`	rule row 식별자 또는 논리 참조; BIGINT	일반(C)	FK intercept_rules(id) ON DELETE SET NULL	A
`conversation_id`	`BIGINT`	예	`—`	conversation row 식별자 또는 논리 참조; BIGINT	일반(C)	FK conversations(id) ON DELETE CASCADE	A
`task_id`	`TEXT`	예	`—`	승인 대기 tool call이 속한 task registry id를 십진 문자열로 저장한다. background/conversation-only 요청은 NULL이며 실행 재구성 시 양의 int64로 parse해 live task를 확인한다. 한계: TEXT이고 FK가 없어 형식·존재는 DB가 강제하지 않는다. 의미 근거	일반(C)	column-level 제약 없음	C
`agent_name`	`TEXT`	아니오	`''`	승인 대기 중인 tool call을 요청한 agent 이름/key 표지다. 의미 근거	미확정(U)	column-level 제약 없음	C
`tool_name`	`TEXT`	아니오	`—`	승인 판단 대상 tool call의 tool 이름이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`tool_input`	`JSONB`	아니오	`'{}'`	승인 대상 tool 입력; 원 tool-call 입력 object	비밀/원문(C)	column-level 제약 없음	A
`status`	`TEXT`	아니오	`'pending'`	lifecycle 상태; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (status IN ('pending', 'allowed', 'denied', 'timeout'))	C
`reason`	`TEXT`	아니오	`''`	판정 이유; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`decided_at`	`TIMESTAMPTZ`	예	`—`	승인 결정 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`NOW()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`audit`	`JSONB`	예	`—`	승인/차단 감사 정보; 결정 source/actor 등 감사 metadata; writer별 세부 shape	민감 가능(A)	column-level 제약 없음	A
`decision_source`	`TEXT`	아니오	`''`	승인 결과 출처다. legacy backfill은 rule, model, unknown으로 분류한다. 의미 근거	미확정(U)	column-level 제약 없음	C

명시 index와 비용 · idx_intercept_pending_status — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰 idx_intercept_pending_task — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰

`findings`

검증된 finding의 분류·severity·근거·보고서, asset 연결과 evidence version을 저장한다.

정적 접근 · reader: db/chat_mentions.go, db/exploration.go, db/finding_assets.go, db/finding_retests.go, db/finding_traffic.go, db/finding_traffic_archive.go, db/findings.go, db/notification.go, db/task_archives.go, evidence/store.go · writer: db/exploration.go, db/finding_traffic.go, db/findings.go, db/notification.go, db/task_archives_restore.go, db/tasks.go

transaction·retention · FK delete: SET NULL; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`task_id`	`BIGINT`	예	`—`	task row 식별자 또는 논리 참조; BIGINT	일반(C)	FK tasks(id) ON DELETE SET NULL	A
`node_id`	`BIGINT`	예	`—`	node row 식별자 또는 논리 참조; BIGINT	일반(C)	FK exploration_nodes(id) ON DELETE SET NULL	A
`vulnclass`	`TEXT`	아니오	`''`	취약점 분류; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`name`	`TEXT`	아니오	`''`	표시 이름; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`severity`	`TEXT`	아니오	`''`	finding severity; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`summary`	`TEXT`	아니오	`''`	요약; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`evidence`	`TEXT`	아니오	`''`	finding 또는 retest 근거; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`worker`	`TEXT`	아니오	`''`	worker 식별자; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`asset_ids`	`JSONB`	아니오	`'[]'`	finding에 관련된 asset id 목록의 production JSON 배열이다. PostgreSQL은 임의 JSONB도 허용하므로 물리 shape는 강제되지 않는다. 의미 근거	일반(C)	column-level 제약 없음	P
`status`	`TEXT`	아니오	`'pending'`	finding triage 상태다. 현재 application allowlist는 pending, in_progress, confirmed, resolved, fixed, false_positive, ignored, duplicate, risk_accepted다. 한계: DB CHECK가 없으므로 물리적으로는 이 allowlist보다 넓다. 의미 근거	미확정(U)	column-level 제약 없음	P
`report`	`TEXT`	아니오	`''`	finding 보고서 본문; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`evidence_version`	`BIGINT`	아니오	`0`	finding에 bind된 traffic evidence set의 변경 revision이며 binding 추가/삭제/순서 변경 때 증가한다. 의미 근거	일반(C)	column-level 제약 없음	C
`report_evidence_version`	`BIGINT`	아니오	`0`	현재 report를 작성할 때 사용한 evidence_version snapshot이다. evidence_version과 다르면 report stale로 표시한다. 의미 근거	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_findings_task — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰 idx_findings_time — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰 idx_findings_status — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰 idx_findings_asset_ids — 배열/JSON 포함 조회의 planner candidate; 실제 query plan 미관찰; write amplification·index 크기 비용

`finding_retests`

finding 재검증 run의 conversation, verdict, snapshot·근거와 lifecycle을 저장한다.

정적 접근 · reader: db/finding_retests.go · writer: db/finding_retests.go

transaction·retention · FK delete: CASCADE, SET NULL; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`finding_id`	`BIGINT`	아니오	`—`	finding row 식별자 또는 논리 참조; BIGINT	일반(C)	FK findings(id) ON DELETE CASCADE	A
`conversation_id`	`BIGINT`	예	`—`	conversation row 식별자 또는 논리 참조; BIGINT	일반(C)	FK conversations(id) ON DELETE SET NULL; UNIQUE	A
`status`	`TEXT`	아니오	`'pending'`	lifecycle 상태; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (status IN ('pending','running','completed','failed','stopped'))	C
`verdict`	`TEXT`	아니오	`''`	재검증 판정; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (verdict IN ('','reproduced','fixed','inconclusive'))	C
`notes`	`TEXT`	아니오	`''`	사용자가 retest를 시작할 때 넣는 최대 4000자 보충 지시/설명이며 retest agent 초기 메시지에 포함된다. 의미 근거	미확정(U)	column-level 제약 없음	C
`snapshot`	`JSONB`	아니오	`—`	시점 고정 snapshot; retest 시작 시 finding/context snapshot	비밀/원문(C)	column-level 제약 없음	A
`summary`	`TEXT`	아니오	`''`	요약; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`evidence`	`TEXT`	아니오	`''`	finding 또는 retest 근거; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`error`	`TEXT`	아니오	`''`	실패 내용; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`started_at`	`TIMESTAMPTZ`	예	`—`	시작 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`finished_at`	`TIMESTAMPTZ`	예	`—`	종료 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_finding_retests_history — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰 idx_finding_retests_active — finding별 active retest 하나의 partial unique backstop; writer의 row-lock/existing check 뒤 남은 race·schema drift는 DB error가 될 수 있음

`traffic_evidence_snapshots`

finding에 고정한 HTTP 교환의 request/response metadata·header/hash를 보존한다.

정적 접근 · reader: db/finding_traffic.go, db/task_archives.go, evidence/store.go · writer: db/finding_traffic.go, db/finding_traffic_archive.go, evidence/store.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`TEXT`	아니오	`—`	row 식별자; UTF-8 text; 길이 제한 없음	일반(C)	PRIMARY KEY	C
`source_traffic_id`	`TEXT`	아니오	`—`	증거 snapshot을 만들 때 읽은 원본 Traffic SQLite exchange의 id다. CAS body와 정규화 metadata를 PostgreSQL snapshot으로 복제할 때 원본 참조를 보존한다. 한계: Traffic SQLite에 대한 cross-store FK는 없다. 의미 근거	일반(C)	column-level 제약 없음	C
`captured_at`	`BIGINT`	아니오	`—`	`ExchangeMeta.TS` (`time.Now().Unix()`) 복사본인 Unix seconds capture 시각 근거	일반(C)	column-level 제약 없음	C
`url`	`TEXT`	아니오	`—`	대상 또는 endpoint URL; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`method`	`TEXT`	아니오	`—`	HTTP method; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`status`	`INTEGER`	아니오	`—`	captured HTTP response status code다.; INTEGER 의미 근거	일반(C)	column-level 제약 없음	C
`content_type`	`TEXT`	아니오	`''`	HTTP content type; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`req_head`	`TEXT`	아니오	`—`	HTTP request header; UTF-8 text; 길이 제한 없음	비밀/원문(C)	column-level 제약 없음	C
`resp_head`	`TEXT`	아니오	`—`	HTTP response header; UTF-8 text; 길이 제한 없음	비밀/원문(C)	column-level 제약 없음	C
`req_hash`	`TEXT`	아니오	`—`	request body hash; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`resp_hash`	`TEXT`	아니오	`—`	response body hash; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`req_len`	`BIGINT`	아니오	`—`	request body byte 길이; BIGINT	일반(C)	column-level 제약 없음	C
`resp_len`	`BIGINT`	아니오	`—`	response body byte 길이; BIGINT	일반(C)	column-level 제약 없음	C
`unreferenced_at`	`TIMESTAMPTZ`	예	`—`	finding 참조가 사라진 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · 명시 index 없음; PK/UNIQUE가 만드는 내부 index는 102개 분모에 포함하지 않음.

`finding_traffic_bindings`

finding과 immutable traffic snapshot의 역할·순서 연결을 저장한다.

정적 접근 · reader: db/finding_traffic.go, db/finding_traffic_archive.go, db/findings.go, db/task_archives.go, evidence/store.go · writer: db/finding_traffic.go, db/finding_traffic_archive.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`finding_id`	`BIGINT`	아니오	`—`	finding row 식별자 또는 논리 참조; BIGINT	일반(C)	FK findings(id) ON DELETE CASCADE <br>table-level: UNIQUE(finding_id,snapshot_id)	A
`snapshot_id`	`TEXT`	아니오	`—`	snapshot row 식별자 또는 논리 참조; UTF-8 text; 길이 제한 없음	일반(C)	FK traffic_evidence_snapshots(id) <br>table-level: UNIQUE(finding_id,snapshot_id)	A
`role`	`TEXT`	아니오	`'supporting'`	traffic snapshot이 finding 결론을 지지하는 용도다. 현재 application allowlist는 baseline, proof, verification, supporting이며 빈 입력은 supporting으로 정규화한다. 한계: DB CHECK가 없으므로 물리적으로는 이 allowlist보다 넓다. 의미 근거	미확정(U)	column-level 제약 없음	P
`note`	`TEXT`	아니오	`''`	운영 메모; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`position`	`INTEGER`	아니오	`—`	정렬 순서; INTEGER	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_finding_traffic_order — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_finding_traffic_snapshot — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`server_logs`

서버가 DB에 남긴 level/tag/text 로그를 시간순으로 저장한다.

정적 접근 · reader: db/logs.go · writer: db/logs.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`level`	`TEXT`	아니오	`'info'`	persisted backend log의 severity/level 문자열이다. 의미 근거	미확정(U)	column-level 제약 없음	C
`tag`	`TEXT`	아니오	`''`	persisted backend log의 component/category tag다. 의미 근거	미확정(U)	column-level 제약 없음	C
`text`	`TEXT`	아니오	`''`	persisted backend log message 본문이다. 의미 근거	민감 가능(A)	column-level 제약 없음	C

명시 index와 비용 · idx_server_logs_id — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰

`side_question_sessions`

side-question의 session snapshot, generation/version과 memory를 저장한다.

정적 접근 · reader: db/side_questions.go, db/task_archives.go · writer: db/exploration.go, db/side_questions.go, db/task_archives_restore.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`session_key`	`TEXT`	아니오	`—`	parent context를 식별하는 합성 key: conv-ID, task-ID-exp-ID-main, 또는 task-ID-exp-ID-worker-iINTENT 형식이다. 의미 근거	미확정(U)	PRIMARY KEY	C
`conversation_id`	`BIGINT`	예	`—`	conversation row 식별자 또는 논리 참조; BIGINT	일반(C)	FK conversations(id) ON DELETE CASCADE <br>table-level: parent XOR CHECK	A
`task_id`	`BIGINT`	예	`—`	task row 식별자 또는 논리 참조; BIGINT	일반(C)	FK tasks(id) ON DELETE CASCADE <br>table-level: parent XOR CHECK	A
`exploration_id`	`BIGINT`	예	`—`	exploration row 식별자 또는 논리 참조; BIGINT	일반(C)	FK explorations(id) ON DELETE CASCADE <br>table-level: parent XOR CHECK	A
`intent_id`	`BIGINT`	예	`—`	intent row 식별자 또는 논리 참조; BIGINT	일반(C)	FK exploration_nodes(id) ON DELETE CASCADE <br>table-level: parent XOR CHECK(intent optional)	A
`run_id`	`BIGINT`	아니오	`—`	Capture attach마다 time.Now().UnixNano()로 만든 run freshness id이며 DB row 참조가 아니다.; BIGINT 의미 근거	일반(C)	column-level 제약 없음	C
`version`	`BIGINT`	아니오	`—`	version 번호; BIGINT	일반(C)	column-level 제약 없음	C
`snapshot`	`JSONB`	아니오	`—`	시점 고정 snapshot; side-question 실행 문맥 snapshot	비밀/원문(C)	column-level 제약 없음	A
`generation`	`BIGINT`	아니오	`0`	side-question generation; BIGINT	일반(C)	column-level 제약 없음	C
`memory`	`JSONB`	아니오	`'{}'`	side-question 압축 memory; 압축된 대화 memory object	비밀/원문(C)	column-level 제약 없음	A

명시 index와 비용 · idx_side_sessions_conv — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_side_sessions_task — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_side_sessions_exp — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_side_sessions_intent — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`side_question_requests`

side-question 요청/응답, 상태, model, usage와 순서를 저장한다.

정적 접근 · reader: db/side_questions.go, db/task_archives.go · writer: db/side_questions.go, db/task_archives_restore.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`TEXT`	아니오	`—`	row 식별자; UTF-8 text; 길이 제한 없음	일반(C)	PRIMARY KEY	C
`ordinal`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	session 안 요청 순번; BIGSERIAL	미확정(U)	UNIQUE	C
`session_key`	`TEXT`	아니오	`—`	질문이 속한 side-question parent session의 합성 key이며 session row에 cascade FK로 연결된다. 의미 근거	미확정(U)	FK side_question_sessions(session_key) ON DELETE CASCADE <br>table-level: UNIQUE(session,generation,client)	C
`generation`	`BIGINT`	아니오	`—`	side-question generation; BIGINT	일반(C)	column-level 제약 없음 <br>table-level: UNIQUE(session,generation,client)	C
`client_id`	`TEXT`	아니오	`—`	caller가 보내는 client_request_id로, 같은 session generation 내 idempotency key다.; UTF-8 text; 길이 제한 없음 의미 근거	일반(C)	column-level 제약 없음 <br>table-level: UNIQUE(session,generation,client)	C
`question`	`TEXT`	아니오	`—`	사용자/agent 질문; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`answer`	`TEXT`	아니오	`''`	모델 답변; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`status`	`TEXT`	아니오	`—`	lifecycle 상태; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK(status IN ('running','completed','failed','cancelled','interrupted'))	C
`error`	`TEXT`	아니오	`''`	실패 내용; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`model`	`JSONB`	아니오	`—`	질문에 사용한 credential-free model identity snapshot(profile id/name/format/model/identity/streaming/window tokens)의 JSON이다. 의미 근거	미확정(U)	column-level 제약 없음	P
`snapshot_at`	`TIMESTAMPTZ`	아니오	`—`	문맥 snapshot 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`sequence`	`BIGINT`	아니오	`0`	event sequence; BIGINT	일반(C)	column-level 제약 없음	C
`usage`	`JSONB`	아니오	`'{}'`	usage 값; 더 좁은 도메인 의미는 소비 코드에 분산됨; provider token usage object	미확정(U)	column-level 제약 없음	A
`context_info`	`JSONB`	아니오	`'{}'`	context info 값; 더 좁은 도메인 의미는 소비 코드에 분산됨; 질문 문맥 provenance object	민감 가능(A)	column-level 제약 없음	A

명시 index와 비용 · idx_side_request_running — session별 running request 하나의 partial unique backstop; busy check 뒤 남은 race·schema drift는 DB error가 될 수 있음 idx_side_requests_history — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰

`asset_intercept_rules`

asset 수준의 built-in/custom intercept match rule을 저장한다.

정적 접근 · reader: db/asset_intercept.go · writer: db/asset_intercept.go, db/db.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`enabled`	`BOOLEAN`	아니오	`true`	활성화 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`kind`	`TEXT`	아니오	`—`	variant 또는 event 종류; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (kind IN ( 'exact_domain', 'exact_ip', 'exact_url', 'fuzzy_domain', 'fuzzy_ip', 'fuzzy_url', 'cidr'))	C
`pattern`	`TEXT`	아니오	`—`	match pattern; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`note`	`TEXT`	아니오	`''`	운영 메모; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`builtin`	`BOOLEAN`	아니오	`false`	built-in 객체 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`NOW()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`NOW()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_asset_intercept_enabled — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`task_intercept_rules`

task 수준의 intercept allow/deny/approval rule을 저장한다.

정적 접근 · reader: db/task_intercept.go · writer: db/task_intercept.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

action CHECK는 fresh table에는 있지만 legacy ADD COLUMN 경로에는 없다. 아래 제약 열은 fresh 선언을 표시하며 upgraded DB의 무결성은 backend 쓰기 검증을 함께 봐야 한다. fresh/upgrade 경계

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`task_id`	`BIGINT`	아니오	`—`	task row 식별자 또는 논리 참조; BIGINT	일반(C)	FK tasks(id) ON DELETE CASCADE	A
`enabled`	`BOOLEAN`	아니오	`true`	활성화 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`action`	`TEXT`	아니오	`'block'`	rule 결정; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (action IN ('block','allow'))	C
`kind`	`TEXT`	아니오	`—`	variant 또는 event 종류; UTF-8 text; 길이 제한 없음	미확정(U)	CHECK (kind IN ( 'exact_domain', 'exact_ip', 'exact_url', 'fuzzy_domain', 'fuzzy_ip', 'fuzzy_url', 'cidr'))	C
`pattern`	`TEXT`	아니오	`—`	match pattern; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`note`	`TEXT`	아니오	`''`	운영 메모; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`NOW()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`NOW()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_task_intercept_task — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`notification_channels`

알림 채널 종류·credential 포함 설정, filter/mode와 rate limit을 저장한다.

정적 접근 · reader: db/notification.go, db/notification_delivery.go · writer: db/notification.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`name`	`TEXT`	아니오	`—`	표시 이름; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`kind`	`TEXT`	아니오	`—`	notification channel adapter 종류다. 현재 registry/server allowlist는 dingtalk, feishu, wecom, webhook, telegram, email이다. 한계: server가 검사하지만 DB CHECK는 없어 낮은 수준 writer는 더 넓은 값을 저장할 수 있다. 의미 근거	미확정(U)	column-level 제약 없음	P
`enabled`	`BOOLEAN`	아니오	`true`	활성화 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`config`	`JSONB`	아니오	`'{}'`	종류별 설정; credential을 포함할 수 있음; kind별: dingtalk/feishu {webhook,secret}; wecom {webhook}; webhook {url,method,content_type,headers,body_template}; telegram {bot_token,chat_id,base_url}; email {host,port,username,password,from,to,tls}	비밀/원문(C)	column-level 제약 없음	A
`mode`	`TEXT`	아니오	`'realtime'`	알림 전달 시점: realtime은 event별 즉시, digest는 주기별 batch 집계다. 의미 근거	미확정(U)	column-level 제약 없음	C
`filter`	`JSONB`	아니오	`'{}'`	알림 필터 조건; min_severity, task_ids, asset_ids, vulnclass_include/exclude, on_status_change	미확정(U)	column-level 제약 없음	A
`rate_per_min`	`INTEGER`	아니오	`20`	분당 전송 제한; INTEGER	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`updated_at`	`TIMESTAMPTZ`	아니오	`now()`	마지막 변경 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · 명시 index 없음; PK/UNIQUE가 만드는 내부 index는 102개 분모에 포함하지 않음.

`notification_events`

finding/상태 변경 시점의 immutable notification snapshot과 fan-out 상태를 저장한다.

정적 접근 · reader: db/notification.go, db/notification_delivery.go · writer: db/notification.go

transaction·retention · FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`kind`	`TEXT`	아니오	`—`	finding notification event 종류다. 현재 producer 상수는 finding_created와 finding_status_changed다. 한계: RecordNotificationEventTx/AddNotificationEvent 인자와 DB는 임의 문자열을 받아 닫힌 enum을 강제하지 않는다. 의미 근거	미확정(U)	column-level 제약 없음	P
`finding_id`	`BIGINT`	아니오	`—`	event를 발생시킨 finding id다. `RecordNotificationEventTx`는 실제 finding id를 쓰며, standalone `AddNotificationEvent`는 BIGINT 인자를 존재 검증 없이 받는다. 의도적으로 FK가 없어 finding 삭제 뒤에도 id와 snapshot을 보존한다. 한계: standalone helper의 production caller를 찾지 못했고, DB는 id의 실제 finding 존재를 강제하지 않는다. 의미 근거	일반(C)	column-level 제약 없음	C
`snapshot`	`JSONB`	아니오	`—`	시점 고정 snapshot; finding/event 발생 시점 render snapshot	비밀/원문(C)	column-level 제약 없음	A
`fanned_out`	`BOOLEAN`	아니오	`false`	delivery fan-out 생성 완료 여부; BOOLEAN	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_notification_events_pending — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용

`notification_deliveries`

event×channel delivery 상태, retry, batch와 전송 시각을 저장한다.

정적 접근 · reader: db/notification.go, db/notification_delivery.go · writer: db/notification.go, db/notification_delivery.go

transaction·retention · FK delete: CASCADE; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`event_id`	`BIGINT`	아니오	`—`	event row 식별자 또는 논리 참조; BIGINT	일반(C)	FK notification_events(id) ON DELETE CASCADE	A
`channel_id`	`BIGINT`	아니오	`—`	channel row 식별자 또는 논리 참조; BIGINT	일반(C)	FK notification_channels(id) ON DELETE CASCADE	A
`state`	`TEXT`	아니오	`'pending'`	notification delivery의 queue/lease/result 상태다. 현재 상태는 pending, sending, sent, failed, skipped다. 한계: DB CHECK가 없어 물리적으로는 이 상태 집합보다 넓다. 의미 근거	미확정(U)	column-level 제약 없음	P
`attempts`	`INTEGER`	아니오	`0`	delivery 시도 횟수; INTEGER	일반(C)	column-level 제약 없음	C
`next_attempt_at`	`TIMESTAMPTZ`	아니오	`now()`	다음 delivery 재시도 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`last_error`	`TEXT`	아니오	`''`	마지막 실패 내용; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`batch_id`	`BIGINT`	예	`—`	digest batch 구성원의 최소 delivery id를 안정적인 batch 번호로 공유한다; realtime은 NULL이다.; BIGINT 의미 근거	일반(C)	column-level 제약 없음	C
`created_at`	`TIMESTAMPTZ`	아니오	`now()`	생성 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`sent_at`	`TIMESTAMPTZ`	예	`—`	전송 성공 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C

명시 index와 비용 · idx_notification_deliveries_due — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_notification_deliveries_history — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰 idx_notification_deliveries_batch — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰; partial predicate 밖 row에는 미적용 idx_notification_deliveries_channel — 최근 순서 조회의 planner candidate; 실제 query plan·효과 미관찰

`llm_records`

LLM request/response 원문과 token·latency·status를 기록하는 선택적 runtime ledger다.

정적 접근 · reader: db/commands.go, db/task_archives.go · writer: db/commands.go, db/task_archives_restore.go, db/tasks.go

transaction·retention · startup Ensure*Table best-effort; 실패해도 server는 계속된다; FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`ts`	`TIMESTAMPTZ`	예	`now()`	event 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`model`	`TEXT`	예	`—`	모델 식별자; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`profile_name`	`TEXT`	예	`—`	LLM profile 이름; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`session_id`	`TEXT`	예	`—`	agent/LLM session 식별자; UTF-8 text; 길이 제한 없음	일반(C)	column-level 제약 없음	C
`task_id`	`TEXT`	예	`—`	full-body LLM trace가 귀속된 task registry id를 문자열로 저장한다. 빈 task id는 SQL NULL이며 task 단위 조회·삭제의 key다. 한계: TEXT이고 tasks FK가 없다. 의미 근거	일반(C)	column-level 제약 없음	C
`worker`	`TEXT`	예	`—`	worker 식별자; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`latency_ms`	`INTEGER`	예	`—`	호출 지연 시간(ms); INTEGER	일반(C)	column-level 제약 없음	C
`input_tokens`	`INTEGER`	예	`—`	입력 token 수; INTEGER	일반(C)	column-level 제약 없음	C
`output_tokens`	`INTEGER`	예	`—`	출력 token 수; INTEGER	일반(C)	column-level 제약 없음	C
`cache_read`	`INTEGER`	예	`—`	cache read token 수; INTEGER	일반(C)	column-level 제약 없음	C
`cache_write`	`INTEGER`	예	`—`	cache write token 수; INTEGER	일반(C)	column-level 제약 없음	C
`status`	`TEXT`	예	`—`	full-body LLM trace의 completion 결과다. Recorder는 provider 호출 성공이면 ok, error가 있으면 error를 쓴다. 한계: InsertLLMRecord와 DB는 임의 문자열을 허용한다. 의미 근거	미확정(U)	column-level 제약 없음	P
`error`	`TEXT`	예	`—`	실패 내용; UTF-8 text; 길이 제한 없음	민감 가능(A)	column-level 제약 없음	C
`request_body`	`TEXT`	예	`—`	LLM 요청 본문; provider 요청 JSON	비밀/원문(C)	column-level 제약 없음	C
`response_body`	`TEXT`	예	`—`	LLM 응답 본문; provider 응답 JSON	비밀/원문(C)	column-level 제약 없음	C
`raw_request`	`TEXT`	예	`—`	provider로 보낸 원시 요청; 전송 직전 provider payload	비밀/원문(C)	column-level 제약 없음	C
`raw_response`	`TEXT`	예	`—`	provider 원시 응답; provider 원시 payload	비밀/원문(C)	column-level 제약 없음	C

명시 index와 비용 · idx_llm_records_ts — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_llm_records_session — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

`llm_usage`

LLM 호출별 task/exploration/worker attribution과 token·latency 집계를 기록하는 runtime ledger다.

정적 접근 · reader: db/llm_usage.go, db/task_archives.go · writer: db/llm_usage.go, db/task_archives_restore.go

transaction·retention · startup Ensure*Table best-effort; 실패해도 server는 계속된다; FK delete 동작이 없거나 앱이 관계를 관리한다; schema에 TTL/partition 자동 보존 정책 없음; handler/cleanup/archive 삭제 경로와 운영 보존기간은 별도 확인(U)

정확한 production SQL · symbol·verb·query access matrix

필드	타입	null	default	의미·encoding	민감도	제약	판정
`id`	`BIGSERIAL`	아니오	`nextval(<implicit sequence>)`	row 식별자; BIGSERIAL	일반(C)	PRIMARY KEY	C
`ts`	`TIMESTAMPTZ`	아니오	`now()`	event 시각; 절대 시각; DB `now()` 또는 앱 입력	일반(C)	column-level 제약 없음	C
`task_id`	`TEXT`	예	`—`	always-on LLM usage row가 귀속된 task registry id이며 llm_records.task_id와 같은 문자열 key다. 빈 값은 SQL NULL이다. 한계: TEXT이고 tasks FK가 없다. 의미 근거	일반(C)	column-level 제약 없음	C
`exploration_id`	`BIGINT`	예	`—`	LLM usage row가 귀속된 exploration id다. session에서 parse할 수 없거나 non-task이면 0이고 SQL NULL로 저장한다. 의미 근거	일반(C)	column-level 제약 없음	C
`worker`	`TEXT`	예	`—`	worker 식별자; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`model`	`TEXT`	예	`—`	모델 식별자; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`profile_name`	`TEXT`	예	`—`	LLM profile 이름; UTF-8 text; 길이 제한 없음	미확정(U)	column-level 제약 없음	C
`latency_ms`	`INTEGER`	예	`—`	호출 지연 시간(ms); INTEGER	일반(C)	column-level 제약 없음	C
`input_tokens`	`INTEGER`	아니오	`0`	입력 token 수; INTEGER	일반(C)	column-level 제약 없음	C
`output_tokens`	`INTEGER`	아니오	`0`	출력 token 수; INTEGER	일반(C)	column-level 제약 없음	C
`cache_read`	`INTEGER`	아니오	`0`	cache read token 수; INTEGER	일반(C)	column-level 제약 없음	C
`cache_write`	`INTEGER`	아니오	`0`	cache write token 수; INTEGER	일반(C)	column-level 제약 없음	C
`status`	`TEXT`	예	`—`	always-on LLM usage row의 completion 결과다. Recorder는 성공이면 ok, provider/stream error면 error를 기록한다. 한계: InsertLLMUsage와 DB는 임의 문자열을 허용한다. 의미 근거	미확정(U)	column-level 제약 없음	P

명시 index와 비용 · idx_llm_usage_task — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_llm_usage_model — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰 idx_llm_usage_exp — 해당 equality/join/filter/정렬의 planner candidate; 실제 query plan·효과 미관찰

의미 완결성

물리 field 계약은 551/551개 C다. 별도 business/encoding 의미 판정은 source로 확인한 444개 C, 알려진 shape까지 확인한 93개 A, production allowlist 또는 shape는 확인했지만 DB가 더 넓거나 한계가 남은 14개 P, 미처분 U 0개다. 이는 운영 값·cardinality·query plan 검증을 포함하지 않는다.
14개 P 중 10개는 current production 값 집합을 확인했지만 PostgreSQL column 또는 low-level writer가 더 넓어 닫힌 enum으로 보장할 수 없는 경우다. 나머지 4개는 DB에 저장 가능한 shape가 production DTO보다 넓다. 각 field 행의 한계를 기준으로 해석한다.
민감도는 별도 분모로 일반 C 311, 미확정 U 173, 민감 가능 A 49, settings.value key 의존 비밀/원문 C/A 1, 비밀/원문 C 16, 민감 파생 hint C 1이다. business 의미를 C/P로 올렸더라도 실제 row 값의 민감도는 별도 판정이다.
table 목적 51/51은 DDL 주석과 production query를 대조했다. reader/writer는 static SQL, 정적으로 평가한 expression, source fragment가 확인된 runtime template와 세 닫힌 identifier allowlist를 색인한다. Runtime template의 최종 predicate/order/placeholder, 임의 동적 identifier, 실제 call reachability와 transaction 범위는 U다.
실제 role/grant, row 규모, retention 기간, encryption-at-rest와 운영 migration 적용은 U다. 이 항목은 배포 DB 관찰 없이는 C로 올리지 않는다.

상위 영역: 데이터 모델과 저장 계약

전체로 돌아가기 · Markdown 원본