@soddong/agentic-runtime 0.16.0

package/docs/schema/generated/agentic_execution_logs.md

@@ -0,0 +1,90 @@
+# agentic_execution_logs
+
+## Description
+
+실행 중 발생한 로그와 이벤트를 순서대로 관리한다.
+
+<details>
+<summary><strong>Table Definition</strong></summary>
+
+```sql
+CREATE TABLE agentic_execution_logs (
+  -- 로그 식별자
+  log_id INTEGER PRIMARY KEY AUTOINCREMENT,
+
+  -- 실행 식별자
+  run_id CHAR(36) NOT NULL
+    CHECK (length(run_id) = 36),
+
+  -- 실행 내 로그 순번
+  sequence_no INTEGER NOT NULL
+    CHECK (sequence_no >= 0),
+
+  -- 로그 레벨
+  log_level VARCHAR(16) NOT NULL
+    CHECK (log_level IN ('trace', 'debug', 'info', 'warn', 'error')),
+
+  -- 로그 종류
+  log_type VARCHAR(32) NOT NULL DEFAULT 'event'
+    CHECK (log_type IN ('event', 'stdout', 'stderr', 'tool', 'system')),
+
+  -- 로그 메시지
+  message TEXT NOT NULL,
+
+  -- 구조화 로그 payload
+  payload_json JSON
+    CHECK (payload_json IS NULL OR json_valid(payload_json)),
+
+  -- 로그 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (run_id)
+    REFERENCES agentic_execution_runs (run_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (run_id, sequence_no)
+)
+```
+
+</details>
+
+## Columns
+
+| Name         | Type        | Default           | Nullable | Parents                                             | Comment             |
+| ------------ | ----------- | ----------------- | -------- | --------------------------------------------------- | ------------------- |
+| log_id       | INTEGER     |                   | true     |                                                     | 로그 식별자              |
+| run_id       | CHAR(36)    |                   | false    | [agentic_execution_runs](agentic_execution_runs.md) | 실행 식별자              |
+| sequence_no  | INTEGER     |                   | false    |                                                     | 실행 내 로그 순번          |
+| log_level    | VARCHAR(16) |                   | false    |                                                     | 로그 레벨               |
+| log_type     | VARCHAR(32) | 'event'           | false    |                                                     | 로그 종류               |
+| message      | TEXT        |                   | false    |                                                     | 로그 메시지              |
+| payload_json | JSON        |                   | true     |                                                     | 구조화 로그 payload      |
+| created_at   | DATETIME    | CURRENT_TIMESTAMP | false    |                                                     | 로그 생성 시각            |
+
+## Constraints
+
+| Name                                      | Type        | Definition                                                                                                       |
+| ----------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------- |
+| log_id                                    | PRIMARY KEY | PRIMARY KEY (log_id)                                                                                             |
+| - (Foreign key ID: 0)                     | FOREIGN KEY | FOREIGN KEY (run_id) REFERENCES agentic_execution_runs (run_id) ON UPDATE NO ACTION ON DELETE CASCADE MATCH NONE |
+| sqlite_autoindex_agentic_execution_logs_1 | UNIQUE      | UNIQUE (run_id, sequence_no)                                                                                     |
+| -                                         | CHECK       | CHECK (length(run_id) = 36)                                                                                      |
+| -                                         | CHECK       | CHECK (sequence_no >= 0)                                                                                         |
+| -                                         | CHECK       | CHECK (log_level IN ('trace', 'debug', 'info', 'warn', 'error'))                                                 |
+| -                                         | CHECK       | CHECK (log_type IN ('event', 'stdout', 'stderr', 'tool', 'system'))                                              |
+| -                                         | CHECK       | CHECK (payload_json IS NULL OR json_valid(payload_json))                                                         |
+
+## Indexes
+
+| Name                                      | Definition                                                                               |
+| ----------------------------------------- | ---------------------------------------------------------------------------------------- |
+| idx_agentic_execution_logs_run_id         | CREATE INDEX idx_agentic_execution_logs_run_id<br />  ON agentic_execution_logs (run_id) |
+| sqlite_autoindex_agentic_execution_logs_1 | UNIQUE (run_id, sequence_no)                                                             |
+
+## Relations
+
+![er](agentic_execution_logs.svg)
+
+---
+
+> Generated by [tbls](https://github.com/k1LoW/tbls)

package/docs/schema/generated/agentic_execution_logs.svg

@@ -0,0 +1,52 @@
+<?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_execution_logs Pages: 1 -->
+<svg width="446pt" height="407pt"
+ viewBox="0.00 0.00 446.04 407.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 403.2)">
+<title>agentic_execution_logs</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-403.2 442.04,-403.2 442.04,4 -4,4"/>
+<!-- agentic_execution_logs -->
+<g id="node1" class="node">
+<title>agentic_execution_logs</title>
+<polygon fill="#efefef" stroke="none" points="75.88,-307 75.88,-353 362.16,-353 362.16,-307 75.88,-307"/>
+<polygon fill="none" stroke="black" points="75.88,-307 75.88,-353 362.16,-353 362.16,-307 75.88,-307"/>
+<text text-anchor="start" x="99.42" y="-330.8" font-family="Arial Bold" font-size="18.00">agentic_execution_logs</text>
+<text text-anchor="start" x="269.37" y="-330.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="300.48" y="-330.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="82.88" y="-316.4" font-family="Arial" font-size="14.00" fill="#333333">실행 중 발생한 로그와 이벤트를 순서대로 관리한다.</text>
+<polygon fill="none" stroke="black" points="75.88,-276.2 75.88,-307 362.16,-307 362.16,-276.2 75.88,-276.2"/>
+<text text-anchor="start" x="82.88" y="-288.4" font-family="Arial" font-size="14.00">run_id </text>
+<text text-anchor="start" x="125.69" y="-288.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<text text-anchor="start" x="198.03" y="-288.4" font-family="Arial" font-size="14.00"> 실행 식별자</text>
+<polygon fill="none" stroke="black" stroke-width="3" points="74.38,-274.7 74.38,-354.5 363.66,-354.5 363.66,-274.7 74.38,-274.7"/>
+</g>
+<!-- agentic_execution_runs -->
+<g id="node2" class="node">
+<title>agentic_execution_runs</title>
+<polygon fill="#efefef" stroke="none" points="43.2,-104.8 43.2,-150.8 394.84,-150.8 394.84,-104.8 43.2,-104.8"/>
+<polygon fill="none" stroke="black" points="43.2,-104.8 43.2,-150.8 394.84,-150.8 394.84,-104.8 43.2,-104.8"/>
+<text text-anchor="start" x="98.92" y="-128.6" font-family="Arial Bold" font-size="18.00">agentic_execution_runs</text>
+<text text-anchor="start" x="269.86" y="-128.6" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="300.98" y="-128.6" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="50.2" y="-114.2" font-family="Arial" font-size="14.00" fill="#333333">사용자 지시 또는 runtime command의 실행 단위를 관리한다.</text>
+<polygon fill="none" stroke="black" points="43.2,-74 43.2,-104.8 394.84,-104.8 394.84,-74 43.2,-74"/>
+<text text-anchor="start" x="50.2" y="-86.2" font-family="Arial" font-size="14.00">run_id </text>
+<text text-anchor="start" x="93.01" y="-86.2" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<text text-anchor="start" x="165.35" y="-86.2" font-family="Arial" font-size="14.00"> 실행 식별자</text>
+<polygon fill="none" stroke="black" points="43.2,-43.2 43.2,-74 394.84,-74 394.84,-43.2 43.2,-43.2"/>
+<text text-anchor="start" x="50.2" y="-55.4" font-family="Arial" font-size="14.00">request_id </text>
+<text text-anchor="start" x="119.47" y="-55.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<text text-anchor="start" x="191.81" y="-55.4" font-family="Arial" font-size="14.00"> 사용자 지시 식별자</text>
+</g>
+<!-- agentic_execution_logs&#45;&gt;agentic_execution_runs -->
+<g id="edge1" class="edge">
+<title>agentic_execution_logs:run_id&#45;&gt;agentic_execution_runs:run_id</title>
+<path fill="none" stroke="black" d="M219.72,-264.98C229.96,-195.48 350.12,-263.18 394.84,-194 420.08,-154.96 442.33,-89.4 395.84,-89.4"/>
+<polygon fill="black" stroke="black" points="219.73,-264.89 214.55,-274.56 219.36,-270.21 219.07,-274.53 219.07,-274.53 219.07,-274.53 219.36,-270.21 223.53,-275.17 219.73,-264.89"/>
+</g>
+</g>
+</svg>

package/docs/schema/generated/agentic_execution_outputs.md

@@ -0,0 +1,85 @@
+# agentic_execution_outputs
+
+## Description
+
+실행 결과를 구조화하여 관리한다.
+
+<details>
+<summary><strong>Table Definition</strong></summary>
+
+```sql
+CREATE TABLE agentic_execution_outputs (
+  -- 실행 결과 식별자
+  output_id INTEGER PRIMARY KEY AUTOINCREMENT,
+
+  -- 실행 식별자
+  run_id CHAR(36) NOT NULL
+    CHECK (length(run_id) = 36),
+
+  -- 결과 종류
+  output_type VARCHAR(32) NOT NULL
+    CHECK (output_type IN ('text', 'json', 'file', 'artifact')),
+
+  -- text 결과
+  content_text TEXT,
+
+  -- JSON 결과
+  content_json JSON
+    CHECK (content_json IS NULL OR json_valid(content_json)),
+
+  -- 파일 결과 경로
+  file_path TEXT,
+
+  -- 결과 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (run_id)
+    REFERENCES agentic_execution_runs (run_id)
+    ON DELETE CASCADE,
+
+  CHECK (
+    content_text IS NOT NULL OR
+    content_json IS NOT NULL OR
+    file_path IS NOT NULL
+  )
+)
+```
+
+</details>
+
+## Columns
+
+| Name         | Type        | Default           | Nullable | Parents                                             | Comment          |
+| ------------ | ----------- | ----------------- | -------- | --------------------------------------------------- | ---------------- |
+| output_id    | INTEGER     |                   | true     |                                                     | 실행 결과 식별자        |
+| run_id       | CHAR(36)    |                   | false    | [agentic_execution_runs](agentic_execution_runs.md) | 실행 식별자           |
+| output_type  | VARCHAR(32) |                   | false    |                                                     | 결과 종류            |
+| content_text | TEXT        |                   | true     |                                                     | text 결과          |
+| content_json | JSON        |                   | true     |                                                     | JSON 결과          |
+| file_path    | TEXT        |                   | true     |                                                     | 파일 결과 경로         |
+| created_at   | DATETIME    | CURRENT_TIMESTAMP | false    |                                                     | 결과 생성 시각         |
+
+## Constraints
+
+| Name                  | Type        | Definition                                                                                                       |
+| --------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------- |
+| output_id             | PRIMARY KEY | PRIMARY KEY (output_id)                                                                                          |
+| - (Foreign key ID: 0) | FOREIGN KEY | FOREIGN KEY (run_id) REFERENCES agentic_execution_runs (run_id) ON UPDATE NO ACTION ON DELETE CASCADE MATCH NONE |
+| -                     | CHECK       | CHECK (length(run_id) = 36)                                                                                      |
+| -                     | CHECK       | CHECK (output_type IN ('text', 'json', 'file', 'artifact'))                                                      |
+| -                     | CHECK       | CHECK (content_json IS NULL OR json_valid(content_json))                                                         |
+| -                     | CHECK       | CHECK ( content_text IS NOT NULL OR content_json IS NOT NULL OR file_path IS NOT NULL )                          |
+
+## Indexes
+
+| Name                                 | Definition                                                                                     |
+| ------------------------------------ | ---------------------------------------------------------------------------------------------- |
+| idx_agentic_execution_outputs_run_id | CREATE INDEX idx_agentic_execution_outputs_run_id<br />  ON agentic_execution_outputs (run_id) |
+
+## Relations
+
+![er](agentic_execution_outputs.svg)
+
+---
+
+> Generated by [tbls](https://github.com/k1LoW/tbls)

package/docs/schema/generated/agentic_execution_outputs.svg

@@ -0,0 +1,52 @@
+<?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_execution_outputs Pages: 1 -->
+<svg width="446pt" height="407pt"
+ viewBox="0.00 0.00 446.04 407.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 403.2)">
+<title>agentic_execution_outputs</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-403.2 442.04,-403.2 442.04,4 -4,4"/>
+<!-- agentic_execution_outputs -->
+<g id="node1" class="node">
+<title>agentic_execution_outputs</title>
+<polygon fill="#efefef" stroke="none" points="80.92,-307 80.92,-353 357.12,-353 357.12,-307 80.92,-307"/>
+<polygon fill="none" stroke="black" points="80.92,-307 80.92,-353 357.12,-353 357.12,-307 80.92,-307"/>
+<text text-anchor="start" x="87.92" y="-330.8" font-family="Arial Bold" font-size="18.00">agentic_execution_outputs</text>
+<text text-anchor="start" x="280.87" y="-330.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="311.98" y="-330.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="129.56" y="-316.4" font-family="Arial" font-size="14.00" fill="#333333">실행 결과를 구조화하여 관리한다.</text>
+<polygon fill="none" stroke="black" points="80.92,-276.2 80.92,-307 357.12,-307 357.12,-276.2 80.92,-276.2"/>
+<text text-anchor="start" x="87.92" y="-288.4" font-family="Arial" font-size="14.00">run_id </text>
+<text text-anchor="start" x="130.73" y="-288.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<text text-anchor="start" x="203.07" y="-288.4" font-family="Arial" font-size="14.00"> 실행 식별자</text>
+<polygon fill="none" stroke="black" stroke-width="3" points="79.42,-274.7 79.42,-354.5 358.62,-354.5 358.62,-274.7 79.42,-274.7"/>
+</g>
+<!-- agentic_execution_runs -->
+<g id="node2" class="node">
+<title>agentic_execution_runs</title>
+<polygon fill="#efefef" stroke="none" points="43.2,-104.8 43.2,-150.8 394.84,-150.8 394.84,-104.8 43.2,-104.8"/>
+<polygon fill="none" stroke="black" points="43.2,-104.8 43.2,-150.8 394.84,-150.8 394.84,-104.8 43.2,-104.8"/>
+<text text-anchor="start" x="98.92" y="-128.6" font-family="Arial Bold" font-size="18.00">agentic_execution_runs</text>
+<text text-anchor="start" x="269.86" y="-128.6" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="300.98" y="-128.6" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="50.2" y="-114.2" font-family="Arial" font-size="14.00" fill="#333333">사용자 지시 또는 runtime command의 실행 단위를 관리한다.</text>
+<polygon fill="none" stroke="black" points="43.2,-74 43.2,-104.8 394.84,-104.8 394.84,-74 43.2,-74"/>
+<text text-anchor="start" x="50.2" y="-86.2" font-family="Arial" font-size="14.00">run_id </text>
+<text text-anchor="start" x="93.01" y="-86.2" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<text text-anchor="start" x="165.35" y="-86.2" font-family="Arial" font-size="14.00"> 실행 식별자</text>
+<polygon fill="none" stroke="black" points="43.2,-43.2 43.2,-74 394.84,-74 394.84,-43.2 43.2,-43.2"/>
+<text text-anchor="start" x="50.2" y="-55.4" font-family="Arial" font-size="14.00">request_id </text>
+<text text-anchor="start" x="119.47" y="-55.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<text text-anchor="start" x="191.81" y="-55.4" font-family="Arial" font-size="14.00"> 사용자 지시 식별자</text>
+</g>
+<!-- agentic_execution_outputs&#45;&gt;agentic_execution_runs -->
+<g id="edge1" class="edge">
+<title>agentic_execution_outputs:run_id&#45;&gt;agentic_execution_runs:run_id</title>
+<path fill="none" stroke="black" d="M219.72,-264.98C229.96,-195.48 350.12,-263.18 394.84,-194 420.08,-154.96 442.33,-89.4 395.84,-89.4"/>
+<polygon fill="black" stroke="black" points="219.73,-264.89 214.55,-274.56 219.36,-270.21 219.07,-274.53 219.07,-274.53 219.07,-274.53 219.36,-270.21 223.53,-275.17 219.73,-264.89"/>
+</g>
+</g>
+</svg>

package/docs/schema/generated/agentic_execution_project_activities.md

@@ -0,0 +1,83 @@
+# agentic_execution_project_activities
+
+## Description
+
+<details>
+<summary><strong>Table Definition</strong></summary>
+
+```sql
+CREATE TABLE agentic_execution_project_activities (
+  execution_project_activity_id INTEGER PRIMARY KEY AUTOINCREMENT,
+  execution_project_id INTEGER NOT NULL,
+  execution_project_stage_id INTEGER NOT NULL,
+  activity_code VARCHAR(128) NOT NULL,
+  activity_name VARCHAR(256) NOT NULL,
+  activity_status_code VARCHAR(32) NOT NULL DEFAULT 'planned'
+    CHECK (activity_status_code IN ('planned', 'in_progress', 'completed', 'blocked', 'skipped')),
+  primary_artifact_standard_code VARCHAR(128),
+  primary_artifact_standard_version VARCHAR(64),
+  artifact_instance_id VARCHAR(64),
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  metadata_json JSON NOT NULL DEFAULT '{}'
+    CHECK (json_valid(metadata_json)),
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (execution_project_id)
+    REFERENCES agentic_execution_projects (execution_project_id)
+    ON DELETE CASCADE,
+
+  FOREIGN KEY (execution_project_stage_id)
+    REFERENCES agentic_execution_project_stages (execution_project_stage_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (execution_project_id, activity_code)
+)
+```
+
+</details>
+
+## Columns
+
+| Name                              | Type         | Default           | Nullable | Parents                                                                 |
+| --------------------------------- | ------------ | ----------------- | -------- | ----------------------------------------------------------------------- |
+| execution_project_activity_id     | INTEGER      |                   | true     |                                                                         |
+| execution_project_id              | INTEGER      |                   | false    | [agentic_execution_projects](agentic_execution_projects.md)             |
+| execution_project_stage_id        | INTEGER      |                   | false    | [agentic_execution_project_stages](agentic_execution_project_stages.md) |
+| activity_code                     | VARCHAR(128) |                   | false    |                                                                         |
+| activity_name                     | VARCHAR(256) |                   | false    |                                                                         |
+| activity_status_code              | VARCHAR(32)  | 'planned'         | false    |                                                                         |
+| primary_artifact_standard_code    | VARCHAR(128) |                   | true     |                                                                         |
+| primary_artifact_standard_version | VARCHAR(64)  |                   | true     |                                                                         |
+| artifact_instance_id              | VARCHAR(64)  |                   | true     |                                                                         |
+| sort_order                        | INTEGER      | 0                 | false    |                                                                         |
+| metadata_json                     | JSON         | '{}'              | false    |                                                                         |
+| created_at                        | DATETIME     | CURRENT_TIMESTAMP | false    |                                                                         |
+| updated_at                        | DATETIME     | CURRENT_TIMESTAMP | false    |                                                                         |
+
+## Constraints
+
+| Name                                                    | Type        | Definition                                                                                                                                                         |
+| ------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| execution_project_activity_id                           | PRIMARY KEY | PRIMARY KEY (execution_project_activity_id)                                                                                                                        |
+| - (Foreign key ID: 0)                                   | FOREIGN KEY | FOREIGN KEY (execution_project_stage_id) REFERENCES agentic_execution_project_stages (execution_project_stage_id) ON UPDATE NO ACTION ON DELETE CASCADE MATCH NONE |
+| - (Foreign key ID: 1)                                   | FOREIGN KEY | FOREIGN KEY (execution_project_id) REFERENCES agentic_execution_projects (execution_project_id) ON UPDATE NO ACTION ON DELETE CASCADE MATCH NONE                   |
+| sqlite_autoindex_agentic_execution_project_activities_1 | UNIQUE      | UNIQUE (execution_project_id, activity_code)                                                                                                                       |
+| -                                                       | CHECK       | CHECK (activity_status_code IN ('planned', 'in_progress', 'completed', 'blocked', 'skipped'))                                                                      |
+| -                                                       | CHECK       | CHECK (json_valid(metadata_json))                                                                                                                                  |
+
+## Indexes
+
+| Name                                                    | Definition                                                                                                                              |
+| ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| idx_agentic_execution_project_activities_stage          | CREATE INDEX idx_agentic_execution_project_activities_stage<br />  ON agentic_execution_project_activities (execution_project_stage_id) |
+| idx_agentic_execution_project_activities_project        | CREATE INDEX idx_agentic_execution_project_activities_project<br />  ON agentic_execution_project_activities (execution_project_id)     |
+| sqlite_autoindex_agentic_execution_project_activities_1 | UNIQUE (execution_project_id, activity_code)                                                                                            |
+
+## Relations
+
+![er](agentic_execution_project_activities.svg)
+
+---
+
+> Generated by [tbls](https://github.com/k1LoW/tbls)

package/docs/schema/generated/agentic_execution_project_activities.svg

@@ -0,0 +1,71 @@
+<?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_execution_project_activities Pages: 1 -->
+<svg width="806pt" height="417pt"
+ viewBox="0.00 0.00 805.57 417.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 413.2)">
+<title>agentic_execution_project_activities</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-413.2 801.57,-413.2 801.57,4 -4,4"/>
+<!-- agentic_execution_project_activities -->
+<g id="node1" class="node">
+<title>agentic_execution_project_activities</title>
+<polygon fill="#efefef" stroke="none" points="213.71,-327.4 213.71,-363 560.86,-363 560.86,-327.4 213.71,-327.4"/>
+<polygon fill="none" stroke="black" points="213.71,-327.4 213.71,-363 560.86,-363 560.86,-327.4 213.71,-327.4"/>
+<text text-anchor="start" x="220.71" y="-340.8" font-family="Arial Bold" font-size="18.00">agentic_execution_project_activities</text>
+<text text-anchor="start" x="484.61" y="-340.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="515.72" y="-340.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="213.71,-296.6 213.71,-327.4 560.86,-327.4 560.86,-296.6 213.71,-296.6"/>
+<text text-anchor="start" x="220.71" y="-308.8" font-family="Arial" font-size="14.00">execution_project_id </text>
+<text text-anchor="start" x="353.02" y="-308.8" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" points="213.71,-265.8 213.71,-296.6 560.86,-296.6 560.86,-265.8 213.71,-265.8"/>
+<text text-anchor="start" x="220.71" y="-278" font-family="Arial" font-size="14.00">execution_project_stage_id </text>
+<text text-anchor="start" x="395.06" y="-278" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" stroke-width="3" points="212.21,-264.3 212.21,-364.5 562.36,-364.5 562.36,-264.3 212.21,-264.3"/>
+</g>
+<!-- agentic_execution_projects -->
+<g id="node2" class="node">
+<title>agentic_execution_projects</title>
+<polygon fill="#efefef" stroke="none" points="43.2,-104.8 43.2,-140.4 323.37,-140.4 323.37,-104.8 43.2,-104.8"/>
+<polygon fill="none" stroke="black" points="43.2,-104.8 43.2,-140.4 323.37,-140.4 323.37,-104.8 43.2,-104.8"/>
+<text text-anchor="start" x="50.2" y="-118.2" font-family="Arial Bold" font-size="18.00">agentic_execution_projects</text>
+<text text-anchor="start" x="247.12" y="-118.2" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="278.24" y="-118.2" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="43.2,-74 43.2,-104.8 323.37,-104.8 323.37,-74 43.2,-74"/>
+<text text-anchor="start" x="50.2" y="-86.2" font-family="Arial" font-size="14.00">execution_project_id </text>
+<text text-anchor="start" x="182.51" y="-86.2" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" points="43.2,-43.2 43.2,-74 323.37,-74 323.37,-43.2 43.2,-43.2"/>
+<text text-anchor="start" x="50.2" y="-55.4" font-family="Arial" font-size="14.00">bundle_id </text>
+<text text-anchor="start" x="114.81" y="-55.4" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+</g>
+<!-- agentic_execution_project_activities&#45;&gt;agentic_execution_projects -->
+<g id="edge1" 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="M202.67,-310.51C175.04,-301.12 191.72,-249.63 213.71,-219.6 244.03,-178.22 293.07,-224.99 323.37,-183.6 348.11,-149.82 366.24,-89.4 324.37,-89.4"/>
+<polygon fill="black" stroke="black" points="202.49,-310.48 211.72,-316.4 207.77,-311.26 212.05,-311.9 212.05,-311.9 212.05,-311.9 207.77,-311.26 213.04,-307.5 202.49,-310.48"/>
+</g>
+<!-- agentic_execution_project_stages -->
+<g id="node3" class="node">
+<title>agentic_execution_project_stages</title>
+<polygon fill="#efefef" stroke="none" points="428.21,-104.8 428.21,-140.4 754.37,-140.4 754.37,-104.8 428.21,-104.8"/>
+<polygon fill="none" stroke="black" points="428.21,-104.8 428.21,-140.4 754.37,-140.4 754.37,-104.8 428.21,-104.8"/>
+<text text-anchor="start" x="435.21" y="-118.2" font-family="Arial Bold" font-size="18.00">agentic_execution_project_stages</text>
+<text text-anchor="start" x="678.11" y="-118.2" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="709.23" y="-118.2" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="428.21,-74 428.21,-104.8 754.37,-104.8 754.37,-74 428.21,-74"/>
+<text text-anchor="start" x="435.21" y="-86.2" font-family="Arial" font-size="14.00">execution_project_stage_id </text>
+<text text-anchor="start" x="609.55" y="-86.2" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" points="428.21,-43.2 428.21,-74 754.37,-74 754.37,-43.2 428.21,-43.2"/>
+<text text-anchor="start" x="435.21" y="-55.4" font-family="Arial" font-size="14.00">execution_project_id </text>
+<text text-anchor="start" x="567.52" y="-55.4" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+</g>
+<!-- agentic_execution_project_activities&#45;&gt;agentic_execution_project_stages -->
+<g id="edge2" 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="M571.59,-278.75C585.69,-269.73 575.17,-238.01 560.86,-219.6 523.36,-171.38 465.58,-231.93 428.21,-183.6 402.6,-150.48 385.34,-89.4 427.21,-89.4"/>
+<polygon fill="black" stroke="black" points="571.88,-278.67 561.08,-276.75 566.71,-279.98 562.51,-281.04 562.51,-281.04 562.51,-281.04 566.71,-279.98 563.28,-285.48 571.88,-278.67"/>
+</g>
+</g>
+</svg>

package/docs/schema/generated/agentic_execution_project_stages.md

@@ -0,0 +1,69 @@
+# agentic_execution_project_stages
+
+## Description
+
+<details>
+<summary><strong>Table Definition</strong></summary>
+
+```sql
+CREATE TABLE agentic_execution_project_stages (
+  execution_project_stage_id INTEGER PRIMARY KEY AUTOINCREMENT,
+  execution_project_id INTEGER NOT NULL,
+  stage_code VARCHAR(128) NOT NULL,
+  stage_name VARCHAR(256) NOT NULL,
+  stage_status_code VARCHAR(32) NOT NULL DEFAULT 'planned'
+    CHECK (stage_status_code IN ('planned', 'in_progress', 'completed', 'blocked', 'skipped')),
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  metadata_json JSON NOT NULL DEFAULT '{}'
+    CHECK (json_valid(metadata_json)),
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (execution_project_id)
+    REFERENCES agentic_execution_projects (execution_project_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (execution_project_id, stage_code)
+)
+```
+
+</details>
+
+## Columns
+
+| Name                       | Type         | Default           | Nullable | Children                                                                        | Parents                                                     |
+| -------------------------- | ------------ | ----------------- | -------- | ------------------------------------------------------------------------------- | ----------------------------------------------------------- |
+| execution_project_stage_id | INTEGER      |                   | true     | [agentic_execution_project_activities](agentic_execution_project_activities.md) |                                                             |
+| execution_project_id       | INTEGER      |                   | false    |                                                                                 | [agentic_execution_projects](agentic_execution_projects.md) |
+| stage_code                 | VARCHAR(128) |                   | false    |                                                                                 |                                                             |
+| stage_name                 | VARCHAR(256) |                   | false    |                                                                                 |                                                             |
+| stage_status_code          | VARCHAR(32)  | 'planned'         | false    |                                                                                 |                                                             |
+| sort_order                 | INTEGER      | 0                 | false    |                                                                                 |                                                             |
+| metadata_json              | JSON         | '{}'              | false    |                                                                                 |                                                             |
+| created_at                 | DATETIME     | CURRENT_TIMESTAMP | false    |                                                                                 |                                                             |
+| updated_at                 | DATETIME     | CURRENT_TIMESTAMP | false    |                                                                                 |                                                             |
+
+## Constraints
+
+| Name                                                | Type        | Definition                                                                                                                                       |
+| --------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| execution_project_stage_id                          | PRIMARY KEY | PRIMARY KEY (execution_project_stage_id)                                                                                                         |
+| - (Foreign key ID: 0)                               | FOREIGN KEY | FOREIGN KEY (execution_project_id) REFERENCES agentic_execution_projects (execution_project_id) ON UPDATE NO ACTION ON DELETE CASCADE MATCH NONE |
+| sqlite_autoindex_agentic_execution_project_stages_1 | UNIQUE      | UNIQUE (execution_project_id, stage_code)                                                                                                        |
+| -                                                   | CHECK       | CHECK (stage_status_code IN ('planned', 'in_progress', 'completed', 'blocked', 'skipped'))                                                       |
+| -                                                   | CHECK       | CHECK (json_valid(metadata_json))                                                                                                                |
+
+## Indexes
+
+| Name                                                | Definition                                                                                                                  |
+| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| idx_agentic_execution_project_stages_project        | CREATE INDEX idx_agentic_execution_project_stages_project<br />  ON agentic_execution_project_stages (execution_project_id) |
+| sqlite_autoindex_agentic_execution_project_stages_1 | UNIQUE (execution_project_id, stage_code)                                                                                   |
+
+## Relations
+
+![er](agentic_execution_project_stages.svg)
+
+---
+
+> Generated by [tbls](https://github.com/k1LoW/tbls)

package/docs/schema/generated/agentic_execution_project_stages.svg

@@ -0,0 +1,71 @@
+<?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_execution_project_stages Pages: 1 -->
+<svg width="442pt" height="637pt"
+ viewBox="0.00 0.00 441.55 636.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 632.8)">
+<title>agentic_execution_project_stages</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-632.8 437.55,-632.8 437.55,4 -4,4"/>
+<!-- agentic_execution_project_stages -->
+<g id="node1" class="node">
+<title>agentic_execution_project_stages</title>
+<polygon fill="#efefef" stroke="none" points="53.69,-327.4 53.69,-363 379.85,-363 379.85,-327.4 53.69,-327.4"/>
+<polygon fill="none" stroke="black" points="53.69,-327.4 53.69,-363 379.85,-363 379.85,-327.4 53.69,-327.4"/>
+<text text-anchor="start" x="60.69" y="-340.8" font-family="Arial Bold" font-size="18.00">agentic_execution_project_stages</text>
+<text text-anchor="start" x="303.6" y="-340.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="334.71" y="-340.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="53.69,-296.6 53.69,-327.4 379.85,-327.4 379.85,-296.6 53.69,-296.6"/>
+<text text-anchor="start" x="60.69" y="-308.8" font-family="Arial" font-size="14.00">execution_project_stage_id </text>
+<text text-anchor="start" x="235.04" y="-308.8" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" points="53.69,-265.8 53.69,-296.6 379.85,-296.6 379.85,-265.8 53.69,-265.8"/>
+<text text-anchor="start" x="60.69" y="-278" font-family="Arial" font-size="14.00">execution_project_id </text>
+<text text-anchor="start" x="193" y="-278" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" stroke-width="3" points="52.19,-264.3 52.19,-364.5 381.35,-364.5 381.35,-264.3 52.19,-264.3"/>
+</g>
+<!-- agentic_execution_projects -->
+<g id="node3" class="node">
+<title>agentic_execution_projects</title>
+<polygon fill="#efefef" stroke="none" points="76.69,-104.8 76.69,-140.4 356.86,-140.4 356.86,-104.8 76.69,-104.8"/>
+<polygon fill="none" stroke="black" points="76.69,-104.8 76.69,-140.4 356.86,-140.4 356.86,-104.8 76.69,-104.8"/>
+<text text-anchor="start" x="83.69" y="-118.2" font-family="Arial Bold" font-size="18.00">agentic_execution_projects</text>
+<text text-anchor="start" x="280.61" y="-118.2" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="311.72" y="-118.2" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="76.69,-74 76.69,-104.8 356.86,-104.8 356.86,-74 76.69,-74"/>
+<text text-anchor="start" x="83.69" y="-86.2" font-family="Arial" font-size="14.00">execution_project_id </text>
+<text text-anchor="start" x="216" y="-86.2" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" points="76.69,-43.2 76.69,-74 356.86,-74 356.86,-43.2 76.69,-43.2"/>
+<text text-anchor="start" x="83.69" y="-55.4" font-family="Arial" font-size="14.00">bundle_id </text>
+<text text-anchor="start" x="148.3" y="-55.4" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+</g>
+<!-- agentic_execution_project_stages&#45;&gt;agentic_execution_projects -->
+<g id="edge2" 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="M217.61,-254.42C227.54,-198.1 322.51,-242.48 356.86,-183.6 377.96,-147.43 399.73,-89.4 357.86,-89.4"/>
+<polygon fill="black" stroke="black" points="217.61,-254.5 212.31,-264.1 217.18,-259.82 216.83,-264.13 216.83,-264.13 216.83,-264.13 217.18,-259.82 221.29,-264.83 217.61,-254.5"/>
+</g>
+<!-- agentic_execution_project_activities -->
+<g id="node2" class="node">
+<title>agentic_execution_project_activities</title>
+<polygon fill="#efefef" stroke="none" points="43.2,-550 43.2,-585.6 390.35,-585.6 390.35,-550 43.2,-550"/>
+<polygon fill="none" stroke="black" points="43.2,-550 43.2,-585.6 390.35,-585.6 390.35,-550 43.2,-550"/>
+<text text-anchor="start" x="50.2" y="-563.4" font-family="Arial Bold" font-size="18.00">agentic_execution_project_activities</text>
+<text text-anchor="start" x="314.09" y="-563.4" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="345.21" y="-563.4" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<polygon fill="none" stroke="black" points="43.2,-519.2 43.2,-550 390.35,-550 390.35,-519.2 43.2,-519.2"/>
+<text text-anchor="start" x="50.2" y="-531.4" font-family="Arial" font-size="14.00">execution_project_id </text>
+<text text-anchor="start" x="182.51" y="-531.4" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+<polygon fill="none" stroke="black" points="43.2,-488.4 43.2,-519.2 390.35,-519.2 390.35,-488.4 43.2,-488.4"/>
+<text text-anchor="start" x="50.2" y="-500.6" font-family="Arial" font-size="14.00">execution_project_stage_id </text>
+<text text-anchor="start" x="224.54" y="-500.6" font-family="Arial" font-size="14.00" fill="#666666">[INTEGER]</text>
+</g>
+<!-- agentic_execution_project_activities&#45;&gt;agentic_execution_project_stages -->
+<g id="edge1" 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="M217.54,-477.06C227.85,-413.28 338.7,-473.83 379.85,-409.2 403.06,-372.76 424.05,-312 380.85,-312"/>
+<polygon fill="black" stroke="black" points="217.54,-477.09 212.31,-486.73 217.14,-482.41 216.82,-486.73 216.82,-486.73 216.82,-486.73 217.14,-482.41 221.29,-487.4 217.54,-477.09"/>
+</g>
+</g>
+</svg>