@soddong/agentic-runtime 0.16.0

package/docs/schema/generated/schema.mmd

@@ -0,0 +1,167 @@
+erDiagram
+
+"agentic_execution_runs" }o--o| "agentic_user_requests" : ""
+"agentic_execution_logs" }o--|| "agentic_execution_runs" : ""
+"agentic_execution_outputs" }o--|| "agentic_execution_runs" : ""
+"agentic_project_bundles" }o--|| "agentic_project_modules" : ""
+"agentic_seed_import_runs" }o--|| "agentic_project_bundles" : ""
+"agentic_seed_import_items" }o--|| "agentic_seed_import_runs" : ""
+"agentic_execution_projects" }o--|| "agentic_project_bundles" : ""
+"agentic_execution_project_stages" }o--|| "agentic_execution_projects" : ""
+"agentic_execution_project_activities" }o--|| "agentic_execution_project_stages" : ""
+"agentic_execution_project_activities" }o--|| "agentic_execution_projects" : ""
+
+"agentic_runtime_metadata" {
+  VARCHAR_128_ metadata_key "metadata 항목 식별자"
+  TEXT metadata_value "metadata 값"
+  VARCHAR_16_ value_type "metadata 값의 논리 타입"
+  TEXT metadata_description "metadata 항목 설명"
+  DATETIME updated_at "metadata 최종 수정 시각"
+}
+"agentic_schema_migrations" {
+  VARCHAR_214_ package_name "migration을 제공한 패키지명"
+  VARCHAR_128_ migration_id "migration 식별자"
+  CHAR_64_ checksum_sha256 "migration 파일 내용 검증용 SHA-256 checksum"
+  VARCHAR_64_ applied_by_runtime_version "migration을 적용한 runtime version"
+  DATETIME applied_at "migration 적용 시각"
+}
+"agentic_project_modules" {
+  VARCHAR_214_ package_name "Agentic package 이름"
+  VARCHAR_64_ package_version "등록된 package version"
+  VARCHAR_32_ module_layer "runtime, domain, capability, application, support 등 패키지 계층"
+  JSON manifest_json "package manifest snapshot"
+  INTEGER is_enabled "프로젝트 내 활성화 여부"
+  DATETIME registered_at "프로젝트에 등록된 시각"
+  DATETIME updated_at "등록 상태 최종 수정 시각"
+}
+"agentic_user_requests" {
+  CHAR_36_ request_id "사용자 지시 식별자"
+  TEXT request_text "사용자 지시 원문"
+  VARCHAR_32_ request_source "지시 유입 경로"
+  JSON context_json "지시 context snapshot"
+  DATETIME created_at "지시 접수 시각"
+}
+"agentic_execution_runs" {
+  CHAR_36_ run_id "실행 식별자"
+  CHAR_36_ request_id "사용자 지시 식별자"
+  VARCHAR_214_ package_name "실행을 담당한 package 이름"
+  VARCHAR_128_ command_name "실행된 command 또는 agent 식별자"
+  VARCHAR_32_ run_type "실행 종류"
+  VARCHAR_32_ run_status "실행 상태"
+  DATETIME started_at "실행 시작 시각"
+  DATETIME ended_at "실행 종료 시각"
+  INTEGER duration_ms "실행 소요 시간"
+  INTEGER exit_code "process exit code"
+  TEXT error_message "실패 또는 취소 사유"
+  JSON run_options_json "실행 option snapshot"
+  DATETIME created_at "실행 생성 시각"
+}
+"agentic_execution_logs" {
+  INTEGER log_id "로그 식별자"
+  CHAR_36_ run_id "실행 식별자"
+  INTEGER sequence_no "실행 내 로그 순번"
+  VARCHAR_16_ log_level "로그 레벨"
+  VARCHAR_32_ log_type "로그 종류"
+  TEXT message "로그 메시지"
+  JSON payload_json "구조화 로그 payload"
+  DATETIME created_at "로그 생성 시각"
+}
+"agentic_execution_outputs" {
+  INTEGER output_id "실행 결과 식별자"
+  CHAR_36_ run_id "실행 식별자"
+  VARCHAR_32_ output_type "결과 종류"
+  TEXT content_text "text 결과"
+  JSON content_json "JSON 결과"
+  TEXT file_path "파일 결과 경로"
+  DATETIME created_at "결과 생성 시각"
+}
+"agentic_project_bundles" {
+  INTEGER bundle_id ""
+  VARCHAR_214_ package_name ""
+  VARCHAR_64_ package_version ""
+  VARCHAR_128_ bundle_code ""
+  VARCHAR_64_ bundle_version ""
+  VARCHAR_128_ methodology_code ""
+  VARCHAR_255_ display_name ""
+  TEXT description ""
+  JSON bundle_manifest_json ""
+  JSON validation_result_json ""
+  INTEGER is_enabled ""
+  DATETIME installed_at ""
+  DATETIME updated_at ""
+}
+"agentic_seed_import_runs" {
+  INTEGER seed_import_run_id ""
+  INTEGER bundle_id ""
+  VARCHAR_214_ package_name ""
+  VARCHAR_64_ package_version ""
+  VARCHAR_128_ bundle_code ""
+  VARCHAR_64_ bundle_version ""
+  VARCHAR_128_ methodology_code ""
+  VARCHAR_16_ import_mode ""
+  VARCHAR_32_ import_status ""
+  JSON summary_json ""
+  JSON validation_result_json ""
+  DATETIME created_at ""
+  DATETIME updated_at ""
+}
+"agentic_seed_import_items" {
+  INTEGER seed_import_item_id ""
+  INTEGER seed_import_run_id ""
+  INTEGER item_order ""
+  VARCHAR_64_ source_section ""
+  VARCHAR_214_ target_package ""
+  VARCHAR_64_ target_domain ""
+  VARCHAR_128_ target_operation ""
+  VARCHAR_255_ item_key ""
+  INTEGER item_count ""
+  VARCHAR_32_ item_status ""
+  VARCHAR_128_ reason_code ""
+  TEXT reason_message ""
+  JSON item_payload_json ""
+  DATETIME created_at ""
+}
+"agentic_execution_projects" {
+  INTEGER execution_project_id ""
+  VARCHAR_128_ project_code ""
+  VARCHAR_256_ project_name ""
+  VARCHAR_32_ project_status_code ""
+  INTEGER bundle_id ""
+  VARCHAR_214_ package_name ""
+  VARCHAR_64_ package_version ""
+  VARCHAR_128_ bundle_code ""
+  VARCHAR_64_ bundle_version ""
+  VARCHAR_128_ methodology_code ""
+  VARCHAR_128_ lifecycle_code ""
+  VARCHAR_128_ phase_code ""
+  VARCHAR_128_ process_code ""
+  JSON metadata_json ""
+  DATETIME created_at ""
+  DATETIME updated_at ""
+}
+"agentic_execution_project_stages" {
+  INTEGER execution_project_stage_id ""
+  INTEGER execution_project_id ""
+  VARCHAR_128_ stage_code ""
+  VARCHAR_256_ stage_name ""
+  VARCHAR_32_ stage_status_code ""
+  INTEGER sort_order ""
+  JSON metadata_json ""
+  DATETIME created_at ""
+  DATETIME updated_at ""
+}
+"agentic_execution_project_activities" {
+  INTEGER execution_project_activity_id ""
+  INTEGER execution_project_id ""
+  INTEGER execution_project_stage_id ""
+  VARCHAR_128_ activity_code ""
+  VARCHAR_256_ activity_name ""
+  VARCHAR_32_ activity_status_code ""
+  VARCHAR_128_ primary_artifact_standard_code ""
+  VARCHAR_64_ primary_artifact_standard_version ""
+  VARCHAR_64_ artifact_instance_id ""
+  INTEGER sort_order ""
+  JSON metadata_json ""
+  DATETIME created_at ""
+  DATETIME updated_at ""
+}

package/docs/schema/generated/schema.svg

@@ -0,0 +1,266 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN"
+ "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<!-- Generated by graphviz version 12.1.2 (20240928.0832)
+ -->
+<!-- Title: agentic&#45;runtime Pages: 1 -->
+<svg width="2317pt" height="1070pt"
+ viewBox="0.00 0.00 2317.07 1070.40" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 1066.4)">
+<title>agentic&#45;runtime</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-1066.4 2313.07,-1066.4 2313.07,4 -4,4"/>
+<!-- agentic_runtime_metadata -->
+<g id="node1" class="node">
+<title>agentic_runtime_metadata</title>
+<polygon fill="#efefef" stroke="none" points="43.2,-957.8 43.2,-1003.8 386.34,-1003.8 386.34,-957.8 43.2,-957.8"/>
+<polygon fill="none" stroke="black" points="43.2,-957.8 43.2,-1003.8 386.34,-1003.8 386.34,-957.8 43.2,-957.8"/>
+<text text-anchor="start" x="84.68" y="-981.6" font-family="Arial Bold" font-size="18.00">agentic_runtime_metadata</text>
+<text text-anchor="start" x="275.6" y="-981.6" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="306.72" y="-981.6" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="59.94" y="-967.2" font-family="Arial" font-size="14.00" fill="#333333">런타임 DB 식별과 runtime&#45;level metadata를 관리한다.</text>
+<polygon fill="none" stroke="black" points="43.2,-927 43.2,-957.8 386.34,-957.8 386.34,-927 43.2,-927"/>
+<text text-anchor="start" x="50.2" y="-939.2" font-family="Arial" font-size="14.00">metadata_key </text>
+<text text-anchor="start" x="142.03" y="-939.2" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(128)]</text>
+<text text-anchor="start" x="250.95" y="-939.2" font-family="Arial" font-size="14.00"> metadata 항목 식별자</text>
+</g>
+<!-- agentic_schema_migrations -->
+<g id="node2" class="node">
+<title>agentic_schema_migrations</title>
+<polygon fill="#efefef" stroke="none" points="490.76,-973.2 490.76,-1019.2 914.77,-1019.2 914.77,-973.2 490.76,-973.2"/>
+<polygon fill="none" stroke="black" points="490.76,-973.2 490.76,-1019.2 914.77,-1019.2 914.77,-973.2 490.76,-973.2"/>
+<text text-anchor="start" x="567.67" y="-997" font-family="Arial Bold" font-size="18.00">agentic_schema_migrations</text>
+<text text-anchor="start" x="768.61" y="-997" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="799.73" y="-997" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="497.76" y="-982.6" font-family="Arial" font-size="14.00" fill="#333333">runtime 및 각 패키지의 SQLite schema migration 적용 이력을 관리한다.</text>
+<polygon fill="none" stroke="black" points="490.76,-942.4 490.76,-973.2 914.77,-973.2 914.77,-942.4 490.76,-942.4"/>
+<text text-anchor="start" x="497.76" y="-954.6" font-family="Arial" font-size="14.00">package_name </text>
+<text text-anchor="start" x="597.39" y="-954.6" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(214)]</text>
+<text text-anchor="start" x="706.31" y="-954.6" font-family="Arial" font-size="14.00"> migration을 제공한 패키지명</text>
+<polygon fill="none" stroke="black" points="490.76,-911.6 490.76,-942.4 914.77,-942.4 914.77,-911.6 490.76,-911.6"/>
+<text text-anchor="start" x="497.76" y="-923.8" font-family="Arial" font-size="14.00">migration_id </text>
+<text text-anchor="start" x="577.91" y="-923.8" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(128)]</text>
+<text text-anchor="start" x="686.83" y="-923.8" font-family="Arial" font-size="14.00"> migration 식별자</text>
+</g>
+<!-- agentic_project_modules -->
+<g id="node3" class="node">
+<title>agentic_project_modules</title>
+<polygon fill="#efefef" stroke="none" points="786.54,-74 786.54,-120 1153,-120 1153,-74 786.54,-74"/>
+<polygon fill="none" stroke="black" points="786.54,-74 786.54,-120 1153,-120 1153,-74 786.54,-74"/>
+<text text-anchor="start" x="844.67" y="-97.8" font-family="Arial Bold" font-size="18.00">agentic_project_modules</text>
+<text text-anchor="start" x="1025.61" y="-97.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="1056.73" y="-97.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="793.54" y="-83.4" font-family="Arial" font-size="14.00" fill="#333333">현재 실행 프로젝트에 등록된 Agentic package 상태를 관리한다.</text>
+<polygon fill="none" stroke="black" points="786.54,-43.2 786.54,-74 1153,-74 1153,-43.2 786.54,-43.2"/>
+<text text-anchor="start" x="793.54" y="-55.4" font-family="Arial" font-size="14.00">package_name </text>
+<text text-anchor="start" x="893.17" y="-55.4" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(214)]</text>
+<text text-anchor="start" x="1002.09" y="-55.4" font-family="Arial" font-size="14.00"> Agentic package 이름</text>
+</g>
+<!-- agentic_user_requests -->
+<g id="node4" class="node">
+<title>agentic_user_requests</title>
+<polygon fill="#efefef" stroke="none" points="1622.45,-503 1622.45,-549 1883.09,-549 1883.09,-503 1622.45,-503"/>
+<polygon fill="none" stroke="black" points="1622.45,-503 1622.45,-549 1883.09,-549 1883.09,-503 1622.45,-503"/>
+<text text-anchor="start" x="1638.67" y="-526.8" font-family="Arial Bold" font-size="18.00">agentic_user_requests</text>
+<text text-anchor="start" x="1797.61" y="-526.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="1828.73" y="-526.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="1641.91" y="-512.4" font-family="Arial" font-size="14.00" fill="#333333">사용자 지시 원문과 접수 정보를 관리한다.</text>
+<polygon fill="none" stroke="black" points="1622.45,-472.2 1622.45,-503 1883.09,-503 1883.09,-472.2 1622.45,-472.2"/>
+<text text-anchor="start" x="1629.45" y="-484.4" font-family="Arial" font-size="14.00">request_id </text>
+<text text-anchor="start" x="1698.72" y="-484.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<text text-anchor="start" x="1771.06" y="-484.4" font-family="Arial" font-size="14.00"> 사용자 지시 식별자</text>
+</g>
+<!-- agentic_execution_runs -->
+<g id="node5" class="node">
+<title>agentic_execution_runs</title>
+<polygon fill="#efefef" stroke="none" points="1576.95,-743.2 1576.95,-789.2 1928.59,-789.2 1928.59,-743.2 1576.95,-743.2"/>
+<polygon fill="none" stroke="black" points="1576.95,-743.2 1576.95,-789.2 1928.59,-789.2 1928.59,-743.2 1576.95,-743.2"/>
+<text text-anchor="start" x="1632.67" y="-767" font-family="Arial Bold" font-size="18.00">agentic_execution_runs</text>
+<text text-anchor="start" x="1803.61" y="-767" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="1834.73" y="-767" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="1583.95" y="-752.6" font-family="Arial" font-size="14.00" fill="#333333">사용자 지시 또는 runtime command의 실행 단위를 관리한다.</text>
+<polygon fill="none" stroke="black" points="1576.95,-712.4 1576.95,-743.2 1928.59,-743.2 1928.59,-712.4 1576.95,-712.4"/>
+<text text-anchor="start" x="1583.95" y="-724.6" font-family="Arial" font-size="14.00">run_id </text>
+<text text-anchor="start" x="1626.75" y="-724.6" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<text text-anchor="start" x="1699.1" y="-724.6" font-family="Arial" font-size="14.00"> 실행 식별자</text>
+<polygon fill="none" stroke="black" points="1576.95,-681.6 1576.95,-712.4 1928.59,-712.4 1928.59,-681.6 1576.95,-681.6"/>
+<text text-anchor="start" x="1583.95" y="-693.8" font-family="Arial" font-size="14.00">request_id </text>
+<text text-anchor="start" x="1653.22" y="-693.8" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<text text-anchor="start" x="1725.56" y="-693.8" font-family="Arial" font-size="14.00"> 사용자 지시 식별자</text>
+</g>
+<!-- agentic_execution_runs&#45;&gt;agentic_user_requests -->
+<g id="edge1" class="edge">
+<title>agentic_execution_runs:request_id&#45;&gt;agentic_user_requests:request_id</title>
+<path fill="none" stroke="black" d="M1753.46,-670.3C1763.64,-599.96 1883,-662.82 1926.29,-592.2 1954.15,-546.73 1963.89,-510.02 1926.29,-472.2 1871.91,-417.51 1752.77,-394.08 1752.77,-471.2"/>
+<polygon fill="black" stroke="black" points="1753.46,-670.29 1748.3,-679.96 1753.1,-675.61 1752.81,-679.93 1752.81,-679.93 1752.81,-679.93 1753.1,-675.61 1757.28,-680.57 1753.46,-670.29"/>
+</g>
+<!-- agentic_execution_logs -->
+<g id="node6" class="node">
+<title>agentic_execution_logs</title>
+<polygon fill="#efefef" stroke="none" points="1598.63,-957.8 1598.63,-1003.8 1884.91,-1003.8 1884.91,-957.8 1598.63,-957.8"/>
+<polygon fill="none" stroke="black" points="1598.63,-957.8 1598.63,-1003.8 1884.91,-1003.8 1884.91,-957.8 1598.63,-957.8"/>
+<text text-anchor="start" x="1622.17" y="-981.6" font-family="Arial Bold" font-size="18.00">agentic_execution_logs</text>
+<text text-anchor="start" x="1792.11" y="-981.6" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="1823.23" y="-981.6" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="1605.63" y="-967.2" font-family="Arial" font-size="14.00" fill="#333333">실행 중 발생한 로그와 이벤트를 순서대로 관리한다.</text>
+<polygon fill="none" stroke="black" points="1598.63,-927 1598.63,-957.8 1884.91,-957.8 1884.91,-927 1598.63,-927"/>
+<text text-anchor="start" x="1605.63" y="-939.2" font-family="Arial" font-size="14.00">run_id </text>
+<text text-anchor="start" x="1648.44" y="-939.2" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<text text-anchor="start" x="1720.78" y="-939.2" font-family="Arial" font-size="14.00"> 실행 식별자</text>
+</g>
+<!-- agentic_execution_logs&#45;&gt;agentic_execution_runs -->
+<g id="edge2" class="edge">
+<title>agentic_execution_logs:run_id&#45;&gt;agentic_execution_runs:run_id</title>
+<path fill="none" stroke="black" d="M1741.11,-915.94C1731.42,-846.94 1617.84,-901.88 1576.95,-832.4 1553.37,-792.33 1529.46,-727.8 1575.95,-727.8"/>
+<polygon fill="black" stroke="black" points="1741.09,-915.69 1737.26,-925.96 1741.44,-921.01 1741.72,-925.33 1741.72,-925.33 1741.72,-925.33 1741.44,-921.01 1746.24,-925.37 1741.09,-915.69"/>
+</g>
+<!-- agentic_execution_outputs -->
+<g id="node7" class="node">
+<title>agentic_execution_outputs</title>
+<polygon fill="#efefef" stroke="none" points="1989.67,-957.8 1989.67,-1003.8 2265.87,-1003.8 2265.87,-957.8 1989.67,-957.8"/>
+<polygon fill="none" stroke="black" points="1989.67,-957.8 1989.67,-1003.8 2265.87,-1003.8 2265.87,-957.8 1989.67,-957.8"/>
+<text text-anchor="start" x="1996.67" y="-981.6" font-family="Arial Bold" font-size="18.00">agentic_execution_outputs</text>
+<text text-anchor="start" x="2189.61" y="-981.6" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="2220.73" y="-981.6" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="2038.31" y="-967.2" font-family="Arial" font-size="14.00" fill="#333333">실행 결과를 구조화하여 관리한다.</text>
+<polygon fill="none" stroke="black" points="1989.67,-927 1989.67,-957.8 2265.87,-957.8 2265.87,-927 1989.67,-927"/>
+<text text-anchor="start" x="1996.67" y="-939.2" font-family="Arial" font-size="14.00">run_id </text>
+<text text-anchor="start" x="2039.47" y="-939.2" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<text text-anchor="start" x="2111.82" y="-939.2" font-family="Arial" font-size="14.00"> 실행 식별자</text>
+</g>
+<!-- agentic_execution_outputs&#45;&gt;agentic_execution_runs -->
+<g id="edge3" class="edge">
+<title>agentic_execution_outputs:run_id&#45;&gt;agentic_execution_runs:run_id</title>
+<path fill="none" stroke="black" d="M1978.61,-941.54C1899.71,-926.77 2024.84,-727.8 1929.59,-727.8"/>
+<polygon fill="black" stroke="black" points="1978.37,-941.51 1987.95,-946.85 1983.69,-941.97 1988,-942.34 1988,-942.34 1988,-942.34 1983.69,-941.97 1988.72,-937.89 1978.37,-941.51"/>
+</g>
+<!-- agentic_project_bundles -->
+<g id="node8" class="node">
+<title>agentic_project_bundles</title>
+<polygon fill="#efefef" stroke="none" points="840.17,-304 840.17,-339.6 1099.37,-339.6 1099.37,-304 840.17,-304"/>
+<polygon fill="none" stroke="black" points="840.17,-304 840.17,-339.6 1099.37,-339.6 1099.37,-304 840.17,-304"/>
+<text text-anchor="start" x="847.17" y="-317.4" font-family="Arial Bold" font-size="18.00">agentic_project_bundles</text>
+<text text-anchor="start" x="1023.11" y="-317.4" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="1054.23" y="-317.4" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="840.17,-273.2 840.17,-304 1099.37,-304 1099.37,-273.2 840.17,-273.2"/>
+<text text-anchor="start" x="847.17" y="-285.4" font-family="Arial" font-size="14.00">bundle_id </text>
+<text text-anchor="start" x="911.78" y="-285.4" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" points="840.17,-242.4 840.17,-273.2 1099.37,-273.2 1099.37,-242.4 840.17,-242.4"/>
+<text text-anchor="start" x="847.17" y="-254.6" font-family="Arial" font-size="14.00">package_name </text>
+<text text-anchor="start" x="946.8" y="-254.6" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(214)]</text>
+</g>
+<!-- agentic_project_bundles&#45;&gt;agentic_project_modules -->
+<g id="edge4" class="edge">
+<title>agentic_project_bundles:package_name&#45;&gt;agentic_project_modules:package_name</title>
+<path fill="none" stroke="black" d="M970.33,-231.24C980.9,-142.56 1136.52,-246.94 1196.2,-163.2 1227.15,-119.77 1233.82,-81 1196.2,-43.2 1160.69,-7.54 969.77,8.12 969.77,-42.2"/>
+<polygon fill="black" stroke="black" points="970.34,-231.08 965.29,-240.82 970.05,-236.41 969.81,-240.73 969.81,-240.73 969.81,-240.73 970.05,-236.41 974.28,-241.32 970.34,-231.08"/>
+</g>
+<!-- agentic_seed_import_runs -->
+<g id="node9" class="node">
+<title>agentic_seed_import_runs</title>
+<polygon fill="#efefef" stroke="none" points="643.17,-523.6 643.17,-559.2 916.37,-559.2 916.37,-523.6 643.17,-523.6"/>
+<polygon fill="none" stroke="black" points="643.17,-523.6 643.17,-559.2 916.37,-559.2 916.37,-523.6 643.17,-523.6"/>
+<text text-anchor="start" x="650.17" y="-537" font-family="Arial Bold" font-size="18.00">agentic_seed_import_runs</text>
+<text text-anchor="start" x="840.12" y="-537" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="871.23" y="-537" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="643.17,-492.8 643.17,-523.6 916.37,-523.6 916.37,-492.8 643.17,-492.8"/>
+<text text-anchor="start" x="650.17" y="-505" font-family="Arial" font-size="14.00">seed_import_run_id </text>
+<text text-anchor="start" x="777.8" y="-505" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" points="643.17,-462 643.17,-492.8 916.37,-492.8 916.37,-462 643.17,-462"/>
+<text text-anchor="start" x="650.17" y="-474.2" font-family="Arial" font-size="14.00">bundle_id </text>
+<text text-anchor="start" x="714.78" y="-474.2" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+</g>
+<!-- agentic_seed_import_runs&#45;&gt;agentic_project_bundles -->
+<g id="edge5" class="edge">
+<title>agentic_seed_import_runs:bundle_id&#45;&gt;agentic_project_bundles:bundle_id</title>
+<path fill="none" stroke="black" d="M927.21,-474.66C939.15,-465.75 928.18,-437.09 916.37,-418.8 896.06,-387.33 860.38,-414.33 840.17,-382.8 817.58,-347.55 797.3,-288.6 839.17,-288.6"/>
+<polygon fill="black" stroke="black" points="927.33,-474.63 916.49,-472.97 922.19,-476.06 918.01,-477.22 918.01,-477.22 918.01,-477.22 922.19,-476.06 918.9,-481.65 927.33,-474.63"/>
+</g>
+<!-- agentic_seed_import_items -->
+<g id="node10" class="node">
+<title>agentic_seed_import_items</title>
+<polygon fill="#efefef" stroke="none" points="639.17,-733 639.17,-768.6 920.37,-768.6 920.37,-733 639.17,-733"/>
+<polygon fill="none" stroke="black" points="639.17,-733 639.17,-768.6 920.37,-768.6 920.37,-733 639.17,-733"/>
+<text text-anchor="start" x="646.17" y="-746.4" font-family="Arial Bold" font-size="18.00">agentic_seed_import_items</text>
+<text text-anchor="start" x="844.11" y="-746.4" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="875.23" y="-746.4" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="639.17,-702.2 639.17,-733 920.37,-733 920.37,-702.2 639.17,-702.2"/>
+<text text-anchor="start" x="646.17" y="-714.4" font-family="Arial" font-size="14.00">seed_import_run_id </text>
+<text text-anchor="start" x="773.8" y="-714.4" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+</g>
+<!-- agentic_seed_import_items&#45;&gt;agentic_seed_import_runs -->
+<g id="edge6" class="edge">
+<title>agentic_seed_import_items:seed_import_run_id&#45;&gt;agentic_seed_import_runs:seed_import_run_id</title>
+<path fill="none" stroke="black" d="M780.48,-691.04C789.58,-630.18 883.61,-665.69 916.37,-602.4 935.62,-565.22 959.24,-508.2 917.37,-508.2"/>
+<polygon fill="black" stroke="black" points="780.49,-690.89 775.3,-700.55 780.12,-696.21 779.82,-700.53 779.82,-700.53 779.82,-700.53 780.12,-696.21 784.28,-701.18 780.49,-690.89"/>
+</g>
+<!-- agentic_execution_projects -->
+<g id="node11" class="node">
+<title>agentic_execution_projects</title>
+<polygon fill="#efefef" stroke="none" points="1020.68,-523.6 1020.68,-559.2 1300.86,-559.2 1300.86,-523.6 1020.68,-523.6"/>
+<polygon fill="none" stroke="black" points="1020.68,-523.6 1020.68,-559.2 1300.86,-559.2 1300.86,-523.6 1020.68,-523.6"/>
+<text text-anchor="start" x="1027.68" y="-537" font-family="Arial Bold" font-size="18.00">agentic_execution_projects</text>
+<text text-anchor="start" x="1224.6" y="-537" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="1255.72" y="-537" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="1020.68,-492.8 1020.68,-523.6 1300.86,-523.6 1300.86,-492.8 1020.68,-492.8"/>
+<text text-anchor="start" x="1027.68" y="-505" font-family="Arial" font-size="14.00">execution_project_id </text>
+<text text-anchor="start" x="1159.99" y="-505" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" points="1020.68,-462 1020.68,-492.8 1300.86,-492.8 1300.86,-462 1020.68,-462"/>
+<text text-anchor="start" x="1027.68" y="-474.2" font-family="Arial" font-size="14.00">bundle_id </text>
+<text text-anchor="start" x="1092.29" y="-474.2" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+</g>
+<!-- agentic_execution_projects&#45;&gt;agentic_project_bundles -->
+<g id="edge7" class="edge">
+<title>agentic_execution_projects:bundle_id&#45;&gt;agentic_project_bundles:bundle_id</title>
+<path fill="none" stroke="black" d="M1009.83,-474.66C997.87,-465.73 1008.76,-437.02 1020.68,-418.8 1041.74,-386.62 1078.41,-415.05 1099.37,-382.8 1122.18,-347.69 1142.23,-288.6 1100.37,-288.6"/>
+<polygon fill="black" stroke="black" points="1009.73,-474.63 1018.15,-481.65 1014.86,-476.06 1019.04,-477.22 1019.04,-477.22 1019.04,-477.22 1014.86,-476.06 1020.57,-472.98 1009.73,-474.63"/>
+</g>
+<!-- agentic_execution_project_stages -->
+<g id="node12" class="node">
+<title>agentic_execution_project_stages</title>
+<polygon fill="#efefef" stroke="none" points="1146.69,-748.4 1146.69,-784 1472.85,-784 1472.85,-748.4 1146.69,-748.4"/>
+<polygon fill="none" stroke="black" points="1146.69,-748.4 1146.69,-784 1472.85,-784 1472.85,-748.4 1146.69,-748.4"/>
+<text text-anchor="start" x="1153.69" y="-761.8" font-family="Arial Bold" font-size="18.00">agentic_execution_project_stages</text>
+<text text-anchor="start" x="1396.59" y="-761.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="1427.71" y="-761.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="1146.69,-717.6 1146.69,-748.4 1472.85,-748.4 1472.85,-717.6 1146.69,-717.6"/>
+<text text-anchor="start" x="1153.69" y="-729.8" font-family="Arial" font-size="14.00">execution_project_stage_id </text>
+<text text-anchor="start" x="1328.03" y="-729.8" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" points="1146.69,-686.8 1146.69,-717.6 1472.85,-717.6 1472.85,-686.8 1146.69,-686.8"/>
+<text text-anchor="start" x="1153.69" y="-699" font-family="Arial" font-size="14.00">execution_project_id </text>
+<text text-anchor="start" x="1286" y="-699" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+</g>
+<!-- agentic_execution_project_stages&#45;&gt;agentic_execution_projects -->
+<g id="edge8" class="edge">
+<title>agentic_execution_project_stages:execution_project_id&#45;&gt;agentic_execution_projects:execution_project_id</title>
+<path fill="none" stroke="black" d="M1135.72,-699.37C1123.39,-690.18 1133.28,-660.76 1146.69,-643.6 1190.36,-587.72 1257.36,-658.42 1300.86,-602.4 1326.53,-569.33 1343.72,-508.2 1301.86,-508.2"/>
+<polygon fill="black" stroke="black" points="1135.75,-699.38 1144.14,-706.44 1140.88,-700.84 1145.05,-702.02 1145.05,-702.02 1145.05,-702.02 1140.88,-700.84 1146.6,-697.78 1135.75,-699.38"/>
+</g>
+<!-- agentic_execution_project_activities -->
+<g id="node13" class="node">
+<title>agentic_execution_project_activities</title>
+<polygon fill="#efefef" stroke="none" points="1019.2,-978.4 1019.2,-1014 1366.34,-1014 1366.34,-978.4 1019.2,-978.4"/>
+<polygon fill="none" stroke="black" points="1019.2,-978.4 1019.2,-1014 1366.34,-1014 1366.34,-978.4 1019.2,-978.4"/>
+<text text-anchor="start" x="1026.2" y="-991.8" font-family="Arial Bold" font-size="18.00">agentic_execution_project_activities</text>
+<text text-anchor="start" x="1290.09" y="-991.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="1321.2" y="-991.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="1019.2,-947.6 1019.2,-978.4 1366.34,-978.4 1366.34,-947.6 1019.2,-947.6"/>
+<text text-anchor="start" x="1026.2" y="-959.8" font-family="Arial" font-size="14.00">execution_project_id </text>
+<text text-anchor="start" x="1158.5" y="-959.8" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" points="1019.2,-916.8 1019.2,-947.6 1366.34,-947.6 1366.34,-916.8 1019.2,-916.8"/>
+<text text-anchor="start" x="1026.2" y="-929" font-family="Arial" font-size="14.00">execution_project_stage_id </text>
+<text text-anchor="start" x="1200.54" y="-929" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+</g>
+<!-- agentic_execution_project_activities&#45;&gt;agentic_execution_projects -->
+<g id="edge10" class="edge">
+<title>agentic_execution_project_activities:execution_project_id&#45;&gt;agentic_execution_projects:execution_project_id</title>
+<path fill="none" stroke="black" d="M1009.33,-957.89C968.04,-907.93 972.31,-508.2 1019.68,-508.2"/>
+<polygon fill="black" stroke="black" points="1009.24,-957.84 1015.66,-966.73 1013.86,-960.5 1017.62,-962.67 1017.62,-962.67 1017.62,-962.67 1013.86,-960.5 1020.15,-958.93 1009.24,-957.84"/>
+</g>
+<!-- agentic_execution_project_activities&#45;&gt;agentic_execution_project_stages -->
+<g id="edge9" class="edge">
+<title>agentic_execution_project_activities:execution_project_stage_id&#45;&gt;agentic_execution_project_stages:execution_project_stage_id</title>
+<path fill="none" stroke="black" d="M1377.35,-929.34C1389.79,-920.06 1380.2,-890.4 1366.34,-873.6 1302.84,-796.64 1209.94,-904.37 1146.69,-827.2 1120.15,-794.82 1103.82,-733 1145.69,-733"/>
+<polygon fill="black" stroke="black" points="1377.28,-929.36 1366.43,-927.78 1372.15,-930.83 1367.98,-932.02 1367.98,-932.02 1367.98,-932.02 1372.15,-930.83 1368.9,-936.44 1377.28,-929.36"/>
+</g>
+</g>
+</svg>

package/docs/schema/migrations.md

@@ -0,0 +1,163 @@
+# @soddong/agentic-runtime Migration 정의
+
+## 1. 목적
+
+본 문서는 `@soddong/agentic-runtime`의 SQLite migration 목록과 적용 의도를 정의한다.
+
+## 2. Migration 목록
+
+| 순서 | 파일 | 설명 |
+| --- | --- | --- |
+| 0001 | `src/database/migrations/0001_runtime_base.sql` | runtime metadata, schema migration, project modules, user request, execution, log, output 기본 테이블 생성 |
+| 0002 | `src/database/migrations/0002_runtime_bundles.sql` | consumer 프로젝트에 설치된 methodology/seed bundle 상태 테이블 생성 |
+| 0003 | `src/database/migrations/0003_runtime_seed_imports.sql` | installed bundle 기준 seed import dry-run plan 테이블 생성 |
+| 0004 | `src/database/migrations/0004_runtime_seed_apply_status.sql` | seed apply 실패 상태를 item 단위로 기록할 수 있도록 item status 확장 |
+| 0005 | `src/database/migrations/0005_runtime_execution_projects.sql` | applied bundle 기준 execution project, stage, activity snapshot 테이블 생성 |
+
+## 3. 0001_runtime_base.sql
+
+생성 테이블:
+
+```text
+agentic_runtime_metadata
+agentic_schema_migrations
+agentic_project_modules
+agentic_user_requests
+agentic_execution_runs
+agentic_execution_logs
+agentic_execution_outputs
+```
+
+적용 의도:
+
+```text
+- platform.sqlite가 Agentic Runtime DB임을 식별할 수 있는 metadata 기반을 만든다.
+- 향후 각 패키지의 migration 적용 이력을 기록할 수 있게 한다.
+- 실행 프로젝트에 등록된 Agentic package 상태를 추적할 수 있게 한다.
+- 사용자 지시, 실행 단위, 실행 로그, 실행 결과를 runtime DB에서 추적할 수 있게 한다.
+```
+
+주요 타입/제약:
+
+```text
+- package name: VARCHAR(214)
+- migration id: VARCHAR(128)
+- SHA-256 checksum: CHAR(64) + length CHECK
+- manifest: JSON + json_valid CHECK
+- boolean: INTEGER + 0/1 CHECK
+- timestamp: DATETIME + CURRENT_TIMESTAMP
+- execution id/request id: CHAR(36) + UUID length CHECK
+- execution status/type/log level/output type: VARCHAR + CHECK
+```
+
+## 4. 0002_runtime_bundles.sql
+
+생성 테이블:
+
+```text
+agentic_project_bundles
+```
+
+적용 의도:
+
+```text
+- 실행 프로젝트에 어떤 seed/methodology bundle이 설치되어 있는지 추적한다.
+- bundle 제공 package와 bundle code/version을 분리해 관리한다.
+- bundle manifest와 validation result snapshot을 보관해 후속 seed import/apply 및 상태 조회의 기준으로 사용한다.
+- package module registry와 외래키로 연결해 package 제거 또는 비활성화 시 bundle 상태를 함께 판단할 수 있게 한다.
+```
+
+주요 타입/제약:
+
+```text
+- package name: VARCHAR(214)
+- bundle code/methodology code: VARCHAR(128)
+- bundle manifest / validation result: JSON + json_valid CHECK
+- enabled: INTEGER + 0/1 CHECK
+- UNIQUE(package_name, bundle_code)
+- FOREIGN KEY(package_name) -> agentic_project_modules(package_name)
+```
+
+## 5. 0003_runtime_seed_imports.sql
+
+생성 테이블:
+
+```text
+agentic_seed_import_runs
+agentic_seed_import_items
+```
+
+적용 의도:
+
+```text
+- installed bundle을 기준으로 domain package 반영 계획을 dry-run으로 생성한다.
+- 실제 domain DB write 전 target package 설치/등록 상태를 점검한다.
+- import target section, target package, operation, item count, blocked/warning 사유를 추적한다.
+- seed apply가 사용할 수 있는 import run/item 기준선을 만든다.
+```
+
+주요 타입/제약:
+
+```text
+- import mode: dry_run, apply
+- import status: planned, blocked, failed, applied
+- item status: planned, blocked, warning, skipped, applied
+- summary / validation result / item payload: JSON + json_valid CHECK
+- FOREIGN KEY(bundle_id) -> agentic_project_bundles(bundle_id)
+- FOREIGN KEY(seed_import_run_id) -> agentic_seed_import_runs(seed_import_run_id)
+```
+
+## 6. 0004_runtime_seed_apply_status.sql
+
+변경 테이블:
+
+```text
+agentic_seed_import_items
+```
+
+적용 의도:
+
+```text
+- seed apply 중 target package handler 실패를 item 단위로 기록할 수 있게 한다.
+- 기존 import run/item 구조는 유지하고, item status에 failed를 추가한다.
+- 별도 apply run 테이블 없이 1차 apply 결과를 기존 import plan에 반영한다.
+```
+
+주요 타입/제약:
+
+```text
+- item status: planned, blocked, warning, skipped, applied, failed
+- 기존 row 보존 후 table 재생성 방식으로 CHECK 제약을 확장한다.
+```
+
+## 7. 0005_runtime_execution_projects.sql
+
+생성 테이블:
+
+```text
+agentic_execution_projects
+agentic_execution_project_stages
+agentic_execution_project_activities
+```
+
+적용 의도:
+
+```text
+- 적용 완료된 seed bundle을 실행 프로젝트 단위로 생성하고 추적한다.
+- bundle의 stage와 activity를 runtime DB에 snapshot으로 저장한다.
+- activity별 primary output artifact standard를 기록해 후속 artifact instance 생성 상태와 연결할 수 있게 한다.
+- 1차 범위에서는 workflow engine이 아니라 status 조회와 lifecycle scaffold 기준선을 제공한다.
+```
+
+주요 타입/제약:
+
+```text
+- project/stage/activity status: planned, in_progress, completed, blocked, skipped
+- project code: VARCHAR(128) UNIQUE
+- package/bundle/methodology/lifecycle/phase/process code: VARCHAR
+- metadata: JSON + json_valid CHECK
+- FOREIGN KEY(bundle_id) -> agentic_project_bundles(bundle_id)
+- FOREIGN KEY(execution_project_id) -> agentic_execution_projects(execution_project_id)
+- UNIQUE(execution_project_id, stage_code)
+- UNIQUE(execution_project_id, activity_code)
+```