@soddong/agentic-runtime 0.16.0

package/docs/schema/generated/agentic_project_modules.md

@@ -0,0 +1,77 @@
+# agentic_project_modules
+
+## Description
+
+현재 실행 프로젝트에 등록된 Agentic package 상태를 관리한다.
+
+<details>
+<summary><strong>Table Definition</strong></summary>
+
+```sql
+CREATE TABLE agentic_project_modules (
+  -- Agentic package 이름
+  package_name VARCHAR(214) PRIMARY KEY,
+
+  -- 등록된 package version
+  package_version VARCHAR(64) NOT NULL,
+
+  -- runtime, domain, capability, application, support 등 패키지 계층
+  module_layer VARCHAR(32)
+    CHECK (
+      module_layer IS NULL OR
+      module_layer IN ('runtime', 'domain', 'capability', 'application', 'support')
+    ),
+
+  -- package manifest snapshot
+  manifest_json JSON NOT NULL DEFAULT '{}'
+    CHECK (json_valid(manifest_json)),
+
+  -- 프로젝트 내 활성화 여부. 1은 활성, 0은 비활성
+  is_enabled INTEGER NOT NULL DEFAULT 1
+    CHECK (is_enabled IN (0, 1)),
+
+  -- 프로젝트에 등록된 시각
+  registered_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 등록 상태 최종 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+)
+```
+
+</details>
+
+## Columns
+
+| Name            | Type         | Default           | Nullable | Children                                              | Comment                                                          |
+| --------------- | ------------ | ----------------- | -------- | ----------------------------------------------------- | ---------------------------------------------------------------- |
+| package_name    | VARCHAR(214) |                   | true     | [agentic_project_bundles](agentic_project_bundles.md) | Agentic package 이름                                               |
+| package_version | VARCHAR(64)  |                   | false    |                                                       | 등록된 package version                                              |
+| module_layer    | VARCHAR(32)  |                   | true     |                                                       | runtime, domain, capability, application, support 등 패키지 계층       |
+| manifest_json   | JSON         | '{}'              | false    |                                                       | package manifest snapshot                                        |
+| is_enabled      | INTEGER      | 1                 | false    |                                                       | 프로젝트 내 활성화 여부                                                    |
+| registered_at   | DATETIME     | CURRENT_TIMESTAMP | false    |                                                       | 프로젝트에 등록된 시각                                                     |
+| updated_at      | DATETIME     | CURRENT_TIMESTAMP | false    |                                                       | 등록 상태 최종 수정 시각                                                   |
+
+## Constraints
+
+| Name                                       | Type        | Definition                                                                                                      |
+| ------------------------------------------ | ----------- | --------------------------------------------------------------------------------------------------------------- |
+| package_name                               | PRIMARY KEY | PRIMARY KEY (package_name)                                                                                      |
+| sqlite_autoindex_agentic_project_modules_1 | PRIMARY KEY | PRIMARY KEY (package_name)                                                                                      |
+| -                                          | CHECK       | CHECK ( module_layer IS NULL OR module_layer IN ('runtime', 'domain', 'capability', 'application', 'support') ) |
+| -                                          | CHECK       | CHECK (json_valid(manifest_json))                                                                               |
+| -                                          | CHECK       | CHECK (is_enabled IN (0, 1))                                                                                    |
+
+## Indexes
+
+| Name                                       | Definition                 |
+| ------------------------------------------ | -------------------------- |
+| sqlite_autoindex_agentic_project_modules_1 | PRIMARY KEY (package_name) |
+
+## Relations
+
+![er](agentic_project_modules.svg)
+
+---
+
+> Generated by [tbls](https://github.com/k1LoW/tbls)

package/docs/schema/generated/agentic_project_modules.svg

@@ -0,0 +1,49 @@
+<?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_project_modules Pages: 1 -->
+<svg width="480pt" height="397pt"
+ viewBox="0.00 0.00 480.26 396.80" 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 392.8)">
+<title>agentic_project_modules</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-392.8 476.26,-392.8 476.26,4 -4,4"/>
+<!-- agentic_project_modules -->
+<g id="node1" class="node">
+<title>agentic_project_modules</title>
+<polygon fill="#efefef" stroke="none" points="46.2,-77 46.2,-123 412.65,-123 412.65,-77 46.2,-77"/>
+<polygon fill="none" stroke="black" points="46.2,-77 46.2,-123 412.65,-123 412.65,-77 46.2,-77"/>
+<text text-anchor="start" x="104.33" y="-100.8" font-family="Arial Bold" font-size="18.00">agentic_project_modules</text>
+<text text-anchor="start" x="285.27" y="-100.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="316.39" y="-100.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="53.2" y="-86.4" font-family="Arial" font-size="14.00" fill="#333333">현재 실행 프로젝트에 등록된 Agentic package 상태를 관리한다.</text>
+<polygon fill="none" stroke="black" points="46.2,-46.2 46.2,-77 412.65,-77 412.65,-46.2 46.2,-46.2"/>
+<text text-anchor="start" x="53.2" y="-58.4" font-family="Arial" font-size="14.00">package_name </text>
+<text text-anchor="start" x="152.83" y="-58.4" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(214)]</text>
+<text text-anchor="start" x="261.74" y="-58.4" font-family="Arial" font-size="14.00"> Agentic package 이름</text>
+<polygon fill="none" stroke="black" stroke-width="3" points="44.7,-44.7 44.7,-124.5 414.15,-124.5 414.15,-44.7 44.7,-44.7"/>
+</g>
+<!-- agentic_project_bundles -->
+<g id="node2" class="node">
+<title>agentic_project_bundles</title>
+<polygon fill="#efefef" stroke="none" points="99.83,-310 99.83,-345.6 359.02,-345.6 359.02,-310 99.83,-310"/>
+<polygon fill="none" stroke="black" points="99.83,-310 99.83,-345.6 359.02,-345.6 359.02,-310 99.83,-310"/>
+<text text-anchor="start" x="106.83" y="-323.4" font-family="Arial Bold" font-size="18.00">agentic_project_bundles</text>
+<text text-anchor="start" x="282.77" y="-323.4" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="313.89" y="-323.4" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="99.83,-279.2 99.83,-310 359.02,-310 359.02,-279.2 99.83,-279.2"/>
+<text text-anchor="start" x="106.83" y="-291.4" font-family="Arial" font-size="14.00">bundle_id </text>
+<text text-anchor="start" x="171.44" y="-291.4" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" points="99.83,-248.4 99.83,-279.2 359.02,-279.2 359.02,-248.4 99.83,-248.4"/>
+<text text-anchor="start" x="106.83" y="-260.6" font-family="Arial" font-size="14.00">package_name </text>
+<text text-anchor="start" x="206.46" y="-260.6" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(214)]</text>
+</g>
+<!-- agentic_project_bundles&#45;&gt;agentic_project_modules -->
+<g id="edge1" class="edge">
+<title>agentic_project_bundles:package_name&#45;&gt;agentic_project_modules:package_name</title>
+<path fill="none" stroke="black" d="M230,-237.12C240.7,-147.44 398.3,-253.81 458.85,-169.2 474.76,-146.97 478.14,-65.57 458.85,-46.2 422.88,-10.07 229.43,5.78 229.43,-45.2"/>
+<polygon fill="black" stroke="black" points="230,-237.08 224.95,-246.82 229.71,-242.41 229.46,-246.73 229.46,-246.73 229.46,-246.73 229.71,-242.41 233.94,-247.32 230,-237.08"/>
+</g>
+</g>
+</svg>

package/docs/schema/generated/agentic_runtime_metadata.md

@@ -0,0 +1,62 @@
+# agentic_runtime_metadata
+
+## Description
+
+런타임 DB 식별과 runtime-level metadata를 관리한다.
+
+<details>
+<summary><strong>Table Definition</strong></summary>
+
+```sql
+CREATE TABLE agentic_runtime_metadata (
+  -- metadata 항목 식별자
+  metadata_key VARCHAR(128) PRIMARY KEY,
+
+  -- metadata 값
+  metadata_value TEXT NOT NULL,
+
+  -- metadata 값의 논리 타입
+  value_type VARCHAR(16) NOT NULL DEFAULT 'string'
+    CHECK (value_type IN ('string', 'integer', 'boolean', 'json')),
+
+  -- metadata 항목 설명
+  metadata_description TEXT,
+
+  -- metadata 최종 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+)
+```
+
+</details>
+
+## Columns
+
+| Name                 | Type         | Default           | Nullable | Comment                 |
+| -------------------- | ------------ | ----------------- | -------- | ----------------------- |
+| metadata_key         | VARCHAR(128) |                   | true     | metadata 항목 식별자         |
+| metadata_value       | TEXT         |                   | false    | metadata 값              |
+| value_type           | VARCHAR(16)  | 'string'          | false    | metadata 값의 논리 타입       |
+| metadata_description | TEXT         |                   | true     | metadata 항목 설명          |
+| updated_at           | DATETIME     | CURRENT_TIMESTAMP | false    | metadata 최종 수정 시각       |
+
+## Constraints
+
+| Name                                        | Type        | Definition                                                     |
+| ------------------------------------------- | ----------- | -------------------------------------------------------------- |
+| metadata_key                                | PRIMARY KEY | PRIMARY KEY (metadata_key)                                     |
+| sqlite_autoindex_agentic_runtime_metadata_1 | PRIMARY KEY | PRIMARY KEY (metadata_key)                                     |
+| -                                           | CHECK       | CHECK (value_type IN ('string', 'integer', 'boolean', 'json')) |
+
+## Indexes
+
+| Name                                        | Definition                 |
+| ------------------------------------------- | -------------------------- |
+| sqlite_autoindex_agentic_runtime_metadata_1 | PRIMARY KEY (metadata_key) |
+
+## Relations
+
+![er](agentic_runtime_metadata.svg)
+
+---
+
+> Generated by [tbls](https://github.com/k1LoW/tbls)

package/docs/schema/generated/agentic_runtime_metadata.svg

@@ -0,0 +1,28 @@
+<?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_runtime_metadata Pages: 1 -->
+<svg width="444pt" height="177pt"
+ viewBox="0.00 0.00 443.54 177.20" 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 173.2)">
+<title>agentic_runtime_metadata</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-173.2 439.54,-173.2 439.54,4 -4,4"/>
+<!-- agentic_runtime_metadata -->
+<g id="node1" class="node">
+<title>agentic_runtime_metadata</title>
+<polygon fill="#efefef" stroke="none" points="46.2,-77 46.2,-123 389.34,-123 389.34,-77 46.2,-77"/>
+<polygon fill="none" stroke="black" points="46.2,-77 46.2,-123 389.34,-123 389.34,-77 46.2,-77"/>
+<text text-anchor="start" x="87.68" y="-100.8" font-family="Arial Bold" font-size="18.00">agentic_runtime_metadata</text>
+<text text-anchor="start" x="278.6" y="-100.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="309.72" y="-100.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="62.94" y="-86.4" font-family="Arial" font-size="14.00" fill="#333333">런타임 DB 식별과 runtime&#45;level metadata를 관리한다.</text>
+<polygon fill="none" stroke="black" points="46.2,-46.2 46.2,-77 389.34,-77 389.34,-46.2 46.2,-46.2"/>
+<text text-anchor="start" x="53.2" y="-58.4" font-family="Arial" font-size="14.00">metadata_key </text>
+<text text-anchor="start" x="145.03" y="-58.4" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(128)]</text>
+<text text-anchor="start" x="253.95" y="-58.4" font-family="Arial" font-size="14.00"> metadata 항목 식별자</text>
+<polygon fill="none" stroke="black" stroke-width="3" points="44.7,-44.7 44.7,-124.5 390.84,-124.5 390.84,-44.7 44.7,-44.7"/>
+</g>
+</g>
+</svg>

package/docs/schema/generated/agentic_schema_migrations.md

@@ -0,0 +1,65 @@
+# agentic_schema_migrations
+
+## Description
+
+runtime 및 각 패키지의 SQLite schema migration 적용 이력을 관리한다.
+
+<details>
+<summary><strong>Table Definition</strong></summary>
+
+```sql
+CREATE TABLE agentic_schema_migrations (
+  -- migration을 제공한 패키지명
+  package_name VARCHAR(214) NOT NULL,
+
+  -- migration 식별자
+  migration_id VARCHAR(128) NOT NULL,
+
+  -- migration 파일 내용 검증용 SHA-256 checksum
+  checksum_sha256 CHAR(64)
+    CHECK (checksum_sha256 IS NULL OR length(checksum_sha256) = 64),
+
+  -- migration을 적용한 runtime version
+  applied_by_runtime_version VARCHAR(64),
+
+  -- migration 적용 시각
+  applied_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  PRIMARY KEY (package_name, migration_id)
+)
+```
+
+</details>
+
+## Columns
+
+| Name                       | Type         | Default           | Nullable | Comment                                     |
+| -------------------------- | ------------ | ----------------- | -------- | ------------------------------------------- |
+| package_name               | VARCHAR(214) |                   | false    | migration을 제공한 패키지명                         |
+| migration_id               | VARCHAR(128) |                   | false    | migration 식별자                               |
+| checksum_sha256            | CHAR(64)     |                   | true     | migration 파일 내용 검증용 SHA-256 checksum        |
+| applied_by_runtime_version | VARCHAR(64)  |                   | true     | migration을 적용한 runtime version              |
+| applied_at                 | DATETIME     | CURRENT_TIMESTAMP | false    | migration 적용 시각                             |
+
+## Constraints
+
+| Name                                         | Type        | Definition                                                      |
+| -------------------------------------------- | ----------- | --------------------------------------------------------------- |
+| package_name                                 | PRIMARY KEY | PRIMARY KEY (package_name)                                      |
+| migration_id                                 | PRIMARY KEY | PRIMARY KEY (migration_id)                                      |
+| sqlite_autoindex_agentic_schema_migrations_1 | PRIMARY KEY | PRIMARY KEY (package_name, migration_id)                        |
+| -                                            | CHECK       | CHECK (checksum_sha256 IS NULL OR length(checksum_sha256) = 64) |
+
+## Indexes
+
+| Name                                         | Definition                               |
+| -------------------------------------------- | ---------------------------------------- |
+| sqlite_autoindex_agentic_schema_migrations_1 | PRIMARY KEY (package_name, migration_id) |
+
+## Relations
+
+![er](agentic_schema_migrations.svg)
+
+---
+
+> Generated by [tbls](https://github.com/k1LoW/tbls)

package/docs/schema/generated/agentic_schema_migrations.svg

@@ -0,0 +1,32 @@
+<?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_schema_migrations Pages: 1 -->
+<svg width="524pt" height="208pt"
+ viewBox="0.00 0.00 524.41 208.00" 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 204)">
+<title>agentic_schema_migrations</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-204 520.41,-204 520.41,4 -4,4"/>
+<!-- agentic_schema_migrations -->
+<g id="node1" class="node">
+<title>agentic_schema_migrations</title>
+<polygon fill="#efefef" stroke="none" points="46.2,-107.8 46.2,-153.8 470.21,-153.8 470.21,-107.8 46.2,-107.8"/>
+<polygon fill="none" stroke="black" points="46.2,-107.8 46.2,-153.8 470.21,-153.8 470.21,-107.8 46.2,-107.8"/>
+<text text-anchor="start" x="123.11" y="-131.6" font-family="Arial Bold" font-size="18.00">agentic_schema_migrations</text>
+<text text-anchor="start" x="324.05" y="-131.6" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="355.16" y="-131.6" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="53.2" y="-117.2" font-family="Arial" font-size="14.00" fill="#333333">runtime 및 각 패키지의 SQLite schema migration 적용 이력을 관리한다.</text>
+<polygon fill="none" stroke="black" points="46.2,-77 46.2,-107.8 470.21,-107.8 470.21,-77 46.2,-77"/>
+<text text-anchor="start" x="53.2" y="-89.2" font-family="Arial" font-size="14.00">package_name </text>
+<text text-anchor="start" x="152.83" y="-89.2" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(214)]</text>
+<text text-anchor="start" x="261.74" y="-89.2" font-family="Arial" font-size="14.00"> migration을 제공한 패키지명</text>
+<polygon fill="none" stroke="black" points="46.2,-46.2 46.2,-77 470.21,-77 470.21,-46.2 46.2,-46.2"/>
+<text text-anchor="start" x="53.2" y="-58.4" font-family="Arial" font-size="14.00">migration_id </text>
+<text text-anchor="start" x="133.35" y="-58.4" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(128)]</text>
+<text text-anchor="start" x="242.27" y="-58.4" font-family="Arial" font-size="14.00"> migration 식별자</text>
+<polygon fill="none" stroke="black" stroke-width="3" points="44.7,-44.7 44.7,-155.3 471.71,-155.3 471.71,-44.7 44.7,-44.7"/>
+</g>
+</g>
+</svg>

package/docs/schema/generated/agentic_seed_import_items.md

@@ -0,0 +1,85 @@
+# agentic_seed_import_items
+
+## Description
+
+<details>
+<summary><strong>Table Definition</strong></summary>
+
+```sql
+CREATE TABLE "agentic_seed_import_items" (
+  seed_import_item_id INTEGER PRIMARY KEY AUTOINCREMENT,
+  seed_import_run_id INTEGER NOT NULL,
+  item_order INTEGER NOT NULL
+    CHECK (item_order >= 0),
+  source_section VARCHAR(64) NOT NULL,
+  target_package VARCHAR(214) NOT NULL,
+  target_domain VARCHAR(64),
+  target_operation VARCHAR(128) NOT NULL,
+  item_key VARCHAR(255),
+  item_count INTEGER NOT NULL DEFAULT 0
+    CHECK (item_count >= 0),
+  item_status VARCHAR(32) NOT NULL DEFAULT 'planned'
+    CHECK (item_status IN ('planned', 'blocked', 'warning', 'skipped', 'applied', 'failed')),
+  reason_code VARCHAR(128),
+  reason_message TEXT,
+  item_payload_json JSON
+    CHECK (item_payload_json IS NULL OR json_valid(item_payload_json)),
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (seed_import_run_id)
+    REFERENCES agentic_seed_import_runs (seed_import_run_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (seed_import_run_id, item_order)
+)
+```
+
+</details>
+
+## Columns
+
+| Name                | Type         | Default           | Nullable | Parents                                                 |
+| ------------------- | ------------ | ----------------- | -------- | ------------------------------------------------------- |
+| seed_import_item_id | INTEGER      |                   | true     |                                                         |
+| seed_import_run_id  | INTEGER      |                   | false    | [agentic_seed_import_runs](agentic_seed_import_runs.md) |
+| item_order          | INTEGER      |                   | false    |                                                         |
+| source_section      | VARCHAR(64)  |                   | false    |                                                         |
+| target_package      | VARCHAR(214) |                   | false    |                                                         |
+| target_domain       | VARCHAR(64)  |                   | true     |                                                         |
+| target_operation    | VARCHAR(128) |                   | false    |                                                         |
+| item_key            | VARCHAR(255) |                   | true     |                                                         |
+| item_count          | INTEGER      | 0                 | false    |                                                         |
+| item_status         | VARCHAR(32)  | 'planned'         | false    |                                                         |
+| reason_code         | VARCHAR(128) |                   | true     |                                                         |
+| reason_message      | TEXT         |                   | true     |                                                         |
+| item_payload_json   | JSON         |                   | true     |                                                         |
+| created_at          | DATETIME     | CURRENT_TIMESTAMP | false    |                                                         |
+
+## Constraints
+
+| Name                                         | Type        | Definition                                                                                                                                 |
+| -------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| seed_import_item_id                          | PRIMARY KEY | PRIMARY KEY (seed_import_item_id)                                                                                                          |
+| - (Foreign key ID: 0)                        | FOREIGN KEY | FOREIGN KEY (seed_import_run_id) REFERENCES agentic_seed_import_runs (seed_import_run_id) ON UPDATE NO ACTION ON DELETE CASCADE MATCH NONE |
+| sqlite_autoindex_agentic_seed_import_items_1 | UNIQUE      | UNIQUE (seed_import_run_id, item_order)                                                                                                    |
+| -                                            | CHECK       | CHECK (item_order >= 0)                                                                                                                    |
+| -                                            | CHECK       | CHECK (item_count >= 0)                                                                                                                    |
+| -                                            | CHECK       | CHECK (item_status IN ('planned', 'blocked', 'warning', 'skipped', 'applied', 'failed'))                                                   |
+| -                                            | CHECK       | CHECK (item_payload_json IS NULL OR json_valid(item_payload_json))                                                                         |
+
+## Indexes
+
+| Name                                         | Definition                                                                                                     |
+| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| idx_agentic_seed_import_items_status         | CREATE INDEX idx_agentic_seed_import_items_status<br />  ON agentic_seed_import_items (item_status)            |
+| idx_agentic_seed_import_items_target_package | CREATE INDEX idx_agentic_seed_import_items_target_package<br />  ON agentic_seed_import_items (target_package) |
+| idx_agentic_seed_import_items_run_id         | CREATE INDEX idx_agentic_seed_import_items_run_id<br />  ON agentic_seed_import_items (seed_import_run_id)     |
+| sqlite_autoindex_agentic_seed_import_items_1 | UNIQUE (seed_import_run_id, item_order)                                                                        |
+
+## Relations
+
+![er](agentic_seed_import_items.svg)
+
+---
+
+> Generated by [tbls](https://github.com/k1LoW/tbls)

package/docs/schema/generated/agentic_seed_import_items.svg

@@ -0,0 +1,47 @@
+<?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_seed_import_items Pages: 1 -->
+<svg width="382pt" height="386pt"
+ viewBox="0.00 0.00 381.60 386.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 382.4)">
+<title>agentic_seed_import_items</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-382.4 377.6,-382.4 377.6,4 -4,4"/>
+<!-- agentic_seed_import_items -->
+<g id="node1" class="node">
+<title>agentic_seed_import_items</title>
+<polygon fill="#efefef" stroke="none" points="46.2,-296.6 46.2,-332.2 327.4,-332.2 327.4,-296.6 46.2,-296.6"/>
+<polygon fill="none" stroke="black" points="46.2,-296.6 46.2,-332.2 327.4,-332.2 327.4,-296.6 46.2,-296.6"/>
+<text text-anchor="start" x="53.2" y="-310" font-family="Arial Bold" font-size="18.00">agentic_seed_import_items</text>
+<text text-anchor="start" x="251.15" y="-310" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="282.26" y="-310" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="46.2,-265.8 46.2,-296.6 327.4,-296.6 327.4,-265.8 46.2,-265.8"/>
+<text text-anchor="start" x="53.2" y="-278" font-family="Arial" font-size="14.00">seed_import_run_id </text>
+<text text-anchor="start" x="180.83" y="-278" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" stroke-width="3" points="44.7,-264.3 44.7,-333.7 328.9,-333.7 328.9,-264.3 44.7,-264.3"/>
+</g>
+<!-- agentic_seed_import_runs -->
+<g id="node2" class="node">
+<title>agentic_seed_import_runs</title>
+<polygon fill="#efefef" stroke="none" points="50.2,-104.8 50.2,-140.4 323.4,-140.4 323.4,-104.8 50.2,-104.8"/>
+<polygon fill="none" stroke="black" points="50.2,-104.8 50.2,-140.4 323.4,-140.4 323.4,-104.8 50.2,-104.8"/>
+<text text-anchor="start" x="57.2" y="-118.2" font-family="Arial Bold" font-size="18.00">agentic_seed_import_runs</text>
+<text text-anchor="start" x="247.15" y="-118.2" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="278.27" y="-118.2" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="50.2,-74 50.2,-104.8 323.4,-104.8 323.4,-74 50.2,-74"/>
+<text text-anchor="start" x="57.2" y="-86.2" font-family="Arial" font-size="14.00">seed_import_run_id </text>
+<text text-anchor="start" x="184.83" y="-86.2" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" points="50.2,-43.2 50.2,-74 323.4,-74 323.4,-43.2 50.2,-43.2"/>
+<text text-anchor="start" x="57.2" y="-55.4" font-family="Arial" font-size="14.00">bundle_id </text>
+<text text-anchor="start" x="121.81" y="-55.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="edge1" 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="M187.62,-254.6C197.31,-199.2 290.01,-241.58 323.4,-183.6 344.3,-147.32 366.27,-89.4 324.4,-89.4"/>
+<polygon fill="black" stroke="black" points="187.63,-254.5 182.34,-264.11 187.2,-259.82 186.85,-264.13 186.85,-264.13 186.85,-264.13 187.2,-259.82 191.31,-264.83 187.63,-254.5"/>
+</g>
+</g>
+</svg>

package/docs/schema/generated/agentic_seed_import_runs.md

@@ -0,0 +1,103 @@
+# agentic_seed_import_runs
+
+## Description
+
+<details>
+<summary><strong>Table Definition</strong></summary>
+
+```sql
+CREATE TABLE agentic_seed_import_runs (
+  -- seed import run 식별자
+  seed_import_run_id INTEGER PRIMARY KEY AUTOINCREMENT,
+
+  -- import 대상 project bundle 식별자
+  bundle_id INTEGER NOT NULL,
+
+  -- bundle provider package 이름
+  package_name VARCHAR(214) NOT NULL,
+
+  -- bundle provider package version
+  package_version VARCHAR(64) NOT NULL,
+
+  -- package 내부 bundle 식별자
+  bundle_code VARCHAR(128) NOT NULL,
+
+  -- bundle 자체 version
+  bundle_version VARCHAR(64) NOT NULL,
+
+  -- bundle이 제공하는 methodology code
+  methodology_code VARCHAR(128),
+
+  -- import 실행 mode
+  import_mode VARCHAR(16) NOT NULL DEFAULT 'dry_run'
+    CHECK (import_mode IN ('dry_run', 'apply')),
+
+  -- import 계획 상태
+  import_status VARCHAR(32) NOT NULL DEFAULT 'planned'
+    CHECK (import_status IN ('planned', 'blocked', 'failed', 'applied')),
+
+  -- import plan summary snapshot
+  summary_json JSON NOT NULL DEFAULT '{}'
+    CHECK (json_valid(summary_json)),
+
+  -- bundle validation result snapshot
+  validation_result_json JSON NOT NULL DEFAULT '{}'
+    CHECK (json_valid(validation_result_json)),
+
+  -- run 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- run 상태 최종 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (bundle_id)
+    REFERENCES agentic_project_bundles (bundle_id)
+    ON DELETE CASCADE
+)
+```
+
+</details>
+
+## Columns
+
+| Name                   | Type         | Default           | Nullable | Children                                                  | Parents                                               |
+| ---------------------- | ------------ | ----------------- | -------- | --------------------------------------------------------- | ----------------------------------------------------- |
+| seed_import_run_id     | INTEGER      |                   | true     | [agentic_seed_import_items](agentic_seed_import_items.md) |                                                       |
+| bundle_id              | INTEGER      |                   | false    |                                                           | [agentic_project_bundles](agentic_project_bundles.md) |
+| package_name           | VARCHAR(214) |                   | false    |                                                           |                                                       |
+| package_version        | VARCHAR(64)  |                   | false    |                                                           |                                                       |
+| bundle_code            | VARCHAR(128) |                   | false    |                                                           |                                                       |
+| bundle_version         | VARCHAR(64)  |                   | false    |                                                           |                                                       |
+| methodology_code       | VARCHAR(128) |                   | true     |                                                           |                                                       |
+| import_mode            | VARCHAR(16)  | 'dry_run'         | false    |                                                           |                                                       |
+| import_status          | VARCHAR(32)  | 'planned'         | false    |                                                           |                                                       |
+| summary_json           | JSON         | '{}'              | false    |                                                           |                                                       |
+| validation_result_json | JSON         | '{}'              | false    |                                                           |                                                       |
+| created_at             | DATETIME     | CURRENT_TIMESTAMP | false    |                                                           |                                                       |
+| updated_at             | DATETIME     | CURRENT_TIMESTAMP | false    |                                                           |                                                       |
+
+## Constraints
+
+| Name                  | Type        | Definition                                                                                                              |
+| --------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------- |
+| seed_import_run_id    | PRIMARY KEY | PRIMARY KEY (seed_import_run_id)                                                                                        |
+| - (Foreign key ID: 0) | FOREIGN KEY | FOREIGN KEY (bundle_id) REFERENCES agentic_project_bundles (bundle_id) ON UPDATE NO ACTION ON DELETE CASCADE MATCH NONE |
+| -                     | CHECK       | CHECK (import_mode IN ('dry_run', 'apply'))                                                                             |
+| -                     | CHECK       | CHECK (import_status IN ('planned', 'blocked', 'failed', 'applied'))                                                    |
+| -                     | CHECK       | CHECK (json_valid(summary_json))                                                                                        |
+| -                     | CHECK       | CHECK (json_valid(validation_result_json))                                                                              |
+
+## Indexes
+
+| Name                                   | Definition                                                                                          |
+| -------------------------------------- | --------------------------------------------------------------------------------------------------- |
+| idx_agentic_seed_import_runs_status    | CREATE INDEX idx_agentic_seed_import_runs_status<br />  ON agentic_seed_import_runs (import_status) |
+| idx_agentic_seed_import_runs_bundle_id | CREATE INDEX idx_agentic_seed_import_runs_bundle_id<br />  ON agentic_seed_import_runs (bundle_id)  |
+
+## Relations
+
+![er](agentic_seed_import_runs.svg)
+
+---
+
+> Generated by [tbls](https://github.com/k1LoW/tbls)