@soddong/agentic-domain-artifact 0.7.0

package/docs/schema/generated/schema.mmd

@@ -0,0 +1,132 @@
+erDiagram
+
+"artifact_codes" |o--|| "artifact_code_groups" : ""
+"artifact_component_instances" }o--|| "artifact_instances" : ""
+"artifact_resource_links" }o--o| "artifact_component_instances" : ""
+"artifact_resource_links" }o--|| "artifact_instances" : ""
+"artifact_trace_links" }o--o| "artifact_component_instances" : ""
+"artifact_trace_links" }o--|| "artifact_instances" : ""
+"artifact_validation_result_refs" }o--o| "artifact_component_instances" : ""
+"artifact_validation_result_refs" }o--|| "artifact_instances" : ""
+"artifact_review_decision_refs" }o--o| "artifact_component_instances" : ""
+"artifact_review_decision_refs" }o--|| "artifact_instances" : ""
+"artifact_status_events" }o--o| "artifact_review_decision_refs" : ""
+"artifact_status_events" }o--o| "artifact_component_instances" : ""
+"artifact_status_events" }o--|| "artifact_instances" : ""
+
+"artifact_schema_migrations" {
+  VARCHAR_128_ migration_id ""
+  VARCHAR_256_ migration_name ""
+  DATETIME applied_at ""
+}
+"artifact_code_groups" {
+  VARCHAR_64_ code_group_code ""
+  VARCHAR_128_ code_group_name ""
+  TEXT description ""
+  INTEGER sort_order ""
+  INTEGER is_active ""
+  DATETIME created_at ""
+  DATETIME updated_at ""
+}
+"artifact_codes" {
+  VARCHAR_64_ code_group_code ""
+  VARCHAR_128_ code ""
+  VARCHAR_128_ code_name ""
+  TEXT description ""
+  INTEGER sort_order ""
+  INTEGER is_active ""
+  JSON metadata_json ""
+  DATETIME created_at ""
+  DATETIME updated_at ""
+}
+"artifact_instances" {
+  CHAR_36_ artifact_instance_id ""
+  VARCHAR_128_ artifact_code ""
+  VARCHAR_256_ artifact_name ""
+  VARCHAR_64_ artifact_version ""
+  VARCHAR_128_ artifact_standard_code ""
+  VARCHAR_64_ artifact_standard_version ""
+  VARCHAR_64_ artifact_status_code ""
+  CHAR_36_ methodology_activity_id ""
+  VARCHAR_128_ owner_role_code ""
+  DATETIME created_at ""
+  DATETIME updated_at ""
+  JSON metadata_json ""
+}
+"artifact_component_instances" {
+  CHAR_36_ artifact_component_instance_id ""
+  CHAR_36_ artifact_instance_id ""
+  VARCHAR_128_ artifact_component_code ""
+  VARCHAR_64_ artifact_component_role_code ""
+  VARCHAR_256_ component_instance_name ""
+  VARCHAR_64_ component_status_code ""
+  INTEGER sort_order ""
+  DATETIME created_at ""
+  DATETIME updated_at ""
+  JSON metadata_json ""
+}
+"artifact_resource_links" {
+  CHAR_36_ artifact_resource_link_id ""
+  CHAR_36_ artifact_instance_id ""
+  CHAR_36_ artifact_component_instance_id ""
+  VARCHAR_64_ resource_type_code ""
+  VARCHAR_1024_ resource_ref ""
+  VARCHAR_64_ resource_role_code ""
+  INTEGER is_primary ""
+  DATETIME created_at ""
+  DATETIME updated_at ""
+  JSON metadata_json ""
+}
+"artifact_trace_links" {
+  CHAR_36_ artifact_trace_link_id ""
+  CHAR_36_ artifact_instance_id ""
+  CHAR_36_ artifact_component_instance_id ""
+  VARCHAR_128_ source_type_code ""
+  VARCHAR_256_ source_ref_id ""
+  VARCHAR_64_ trace_type_code ""
+  VARCHAR_128_ artifact_standard_code ""
+  VARCHAR_64_ artifact_standard_version ""
+  VARCHAR_128_ artifact_component_code ""
+  DATETIME created_at ""
+  DATETIME updated_at ""
+  JSON metadata_json ""
+}
+"artifact_validation_result_refs" {
+  CHAR_36_ artifact_validation_result_ref_id ""
+  CHAR_36_ artifact_instance_id ""
+  CHAR_36_ artifact_component_instance_id ""
+  VARCHAR_256_ validation_provider_id ""
+  VARCHAR_256_ validation_profile_id ""
+  VARCHAR_1024_ validation_result_ref ""
+  VARCHAR_64_ validation_status_code ""
+  DATETIME created_at ""
+  DATETIME updated_at ""
+  JSON metadata_json ""
+}
+"artifact_review_decision_refs" {
+  CHAR_36_ artifact_review_decision_ref_id ""
+  CHAR_36_ artifact_instance_id ""
+  CHAR_36_ artifact_component_instance_id ""
+  VARCHAR_64_ review_scope_code ""
+  VARCHAR_64_ decision_code ""
+  VARCHAR_256_ reviewer_ref ""
+  TEXT decision_reason ""
+  VARCHAR_1024_ decision_result_ref ""
+  DATETIME decided_at ""
+  DATETIME created_at ""
+  DATETIME updated_at ""
+  JSON metadata_json ""
+}
+"artifact_status_events" {
+  CHAR_36_ artifact_status_event_id ""
+  CHAR_36_ artifact_instance_id ""
+  CHAR_36_ artifact_component_instance_id ""
+  VARCHAR_64_ status_scope_code ""
+  VARCHAR_64_ from_status_code ""
+  VARCHAR_64_ to_status_code ""
+  TEXT transition_reason ""
+  VARCHAR_256_ actor_ref ""
+  CHAR_36_ artifact_review_decision_ref_id ""
+  DATETIME created_at ""
+  JSON metadata_json ""
+}

package/docs/schema/generated/schema.svg

@@ -0,0 +1,260 @@
+<?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;domain&#45;artifact Pages: 1 -->
+<svg width="2863pt" height="954pt"
+ viewBox="0.00 0.00 2862.51 953.60" 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 949.6)">
+<title>agentic&#45;domain&#45;artifact</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-949.6 2858.51,-949.6 2858.51,4 -4,4"/>
+<!-- artifact_schema_migrations -->
+<g id="node1" class="node">
+<title>artifact_schema_migrations</title>
+<polygon fill="#efefef" stroke="none" points="43.2,-810.2 43.2,-856.2 331.83,-856.2 331.83,-810.2 43.2,-810.2"/>
+<polygon fill="none" stroke="black" points="43.2,-810.2 43.2,-856.2 331.83,-856.2 331.83,-810.2 43.2,-810.2"/>
+<text text-anchor="start" x="52.92" y="-834" font-family="Arial Bold" font-size="18.00">artifact_schema_migrations</text>
+<text text-anchor="start" x="252.85" y="-834" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="283.97" y="-834" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="50.2" y="-819.6" font-family="Arial" font-size="14.00" fill="#333333">artifact 패키지의 migration 적용 이력을 관리한다.</text>
+<polygon fill="none" stroke="black" points="43.2,-779.4 43.2,-810.2 331.83,-810.2 331.83,-779.4 43.2,-779.4"/>
+<text text-anchor="start" x="50.2" y="-791.6" font-family="Arial" font-size="14.00">migration_id </text>
+<text text-anchor="start" x="130.35" y="-791.6" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(128)]</text>
+</g>
+<!-- artifact_code_groups -->
+<g id="node2" class="node">
+<title>artifact_code_groups</title>
+<polygon fill="#efefef" stroke="none" points="433.92,-534 433.92,-580 669.11,-580 669.11,-534 433.92,-534"/>
+<polygon fill="none" stroke="black" points="433.92,-534 433.92,-580 669.11,-580 669.11,-534 433.92,-534"/>
+<text text-anchor="start" x="440.92" y="-557.8" font-family="Arial Bold" font-size="18.00">artifact_code_groups</text>
+<text text-anchor="start" x="592.85" y="-557.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="623.97" y="-557.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="493.17" y="-543.4" font-family="Arial" font-size="14.00" fill="#333333">코드 그룹을 정의한다.</text>
+<polygon fill="none" stroke="black" points="433.92,-503.2 433.92,-534 669.11,-534 669.11,-503.2 433.92,-503.2"/>
+<text text-anchor="start" x="440.92" y="-515.4" font-family="Arial" font-size="14.00">code_group_code </text>
+<text text-anchor="start" x="556.9" y="-515.4" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(64)]</text>
+</g>
+<!-- artifact_codes -->
+<g id="node3" class="node">
+<title>artifact_codes</title>
+<polygon fill="#efefef" stroke="none" points="435.96,-825.6 435.96,-871.6 667.07,-871.6 667.07,-825.6 435.96,-825.6"/>
+<polygon fill="none" stroke="black" points="435.96,-825.6 435.96,-871.6 667.07,-871.6 667.07,-825.6 435.96,-825.6"/>
+<text text-anchor="start" x="466.41" y="-849.4" font-family="Arial Bold" font-size="18.00">artifact_codes</text>
+<text text-anchor="start" x="567.36" y="-849.4" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="598.47" y="-849.4" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="465.94" y="-835" font-family="Arial" font-size="14.00" fill="#333333">코드 그룹별 코드 값을 정의한다.</text>
+<polygon fill="none" stroke="black" points="435.96,-794.8 435.96,-825.6 667.07,-825.6 667.07,-794.8 435.96,-794.8"/>
+<text text-anchor="start" x="442.96" y="-807" font-family="Arial" font-size="14.00">code_group_code </text>
+<text text-anchor="start" x="558.94" y="-807" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(64)]</text>
+<polygon fill="none" stroke="black" points="435.96,-764 435.96,-794.8 667.07,-794.8 667.07,-764 435.96,-764"/>
+<text text-anchor="start" x="442.96" y="-776.2" font-family="Arial" font-size="14.00">code </text>
+<text text-anchor="start" x="477.2" y="-776.2" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(128)]</text>
+</g>
+<!-- artifact_codes&#45;&gt;artifact_code_groups -->
+<g id="edge1" class="edge">
+<title>artifact_codes:code_group_code&#45;&gt;artifact_code_groups:code_group_code</title>
+<path fill="none" stroke="black" d="M676.71,-804.54C707.85,-764.56 734.56,-525.59 712.31,-503.2 661.93,-452.51 551.51,-430.73 551.51,-502.2"/>
+<polygon fill="black" stroke="black" points="676.72,-804.54 665.89,-806.25 672.25,-807.46 668.63,-809.83 668.63,-809.83 668.63,-809.83 672.25,-807.46 670.82,-813.78 676.72,-804.54"/>
+</g>
+<!-- artifact_instances -->
+<g id="node4" class="node">
+<title>artifact_instances</title>
+<polygon fill="#efefef" stroke="none" points="1893.08,-74 1893.08,-120 2103.94,-120 2103.94,-74 1893.08,-74"/>
+<polygon fill="none" stroke="black" points="1893.08,-74 1893.08,-120 2103.94,-120 2103.94,-74 1893.08,-74"/>
+<text text-anchor="start" x="1900.92" y="-97.8" font-family="Arial Bold" font-size="18.00">artifact_instances</text>
+<text text-anchor="start" x="2026.86" y="-97.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="2057.97" y="-97.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="1906.32" y="-83.4" font-family="Arial" font-size="14.00" fill="#333333">실제 산출물 instance를 관리한다.</text>
+<polygon fill="none" stroke="black" points="1893.08,-43.2 1893.08,-74 2103.94,-74 2103.94,-43.2 1893.08,-43.2"/>
+<text text-anchor="start" x="1900.08" y="-55.4" font-family="Arial" font-size="14.00">artifact_instance_id </text>
+<text text-anchor="start" x="2024.6" y="-55.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- artifact_component_instances -->
+<g id="node5" class="node">
+<title>artifact_component_instances</title>
+<polygon fill="#efefef" stroke="none" points="1683.17,-304 1683.17,-350 2055.85,-350 2055.85,-304 1683.17,-304"/>
+<polygon fill="none" stroke="black" points="1683.17,-304 1683.17,-350 2055.85,-350 2055.85,-304 1683.17,-304"/>
+<text text-anchor="start" x="1727.43" y="-327.8" font-family="Arial Bold" font-size="18.00">artifact_component_instances</text>
+<text text-anchor="start" x="1942.35" y="-327.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="1973.46" y="-327.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="1690.17" y="-313.4" font-family="Arial" font-size="14.00" fill="#333333">실제 산출물 안의 본문, 부록 등 component instance를 관리한다.</text>
+<polygon fill="none" stroke="black" points="1683.17,-273.2 1683.17,-304 2055.85,-304 2055.85,-273.2 1683.17,-273.2"/>
+<text text-anchor="start" x="1690.17" y="-285.4" font-family="Arial" font-size="14.00">artifact_component_instance_id </text>
+<text text-anchor="start" x="1891.74" y="-285.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="1683.17,-242.4 1683.17,-273.2 2055.85,-273.2 2055.85,-242.4 1683.17,-242.4"/>
+<text text-anchor="start" x="1690.17" y="-254.6" font-family="Arial" font-size="14.00">artifact_instance_id </text>
+<text text-anchor="start" x="1814.69" y="-254.6" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- artifact_component_instances&#45;&gt;artifact_instances -->
+<g id="edge2" class="edge">
+<title>artifact_component_instances:artifact_instance_id&#45;&gt;artifact_instances:artifact_instance_id</title>
+<path fill="none" stroke="black" d="M2066.85,-254.95C2079.28,-245.68 2069.63,-216.06 2055.85,-199.2 2008.97,-141.83 1939.75,-220.75 1893.08,-163.2 1863.8,-127.09 1845.59,-58.6 1892.08,-58.6"/>
+<polygon fill="black" stroke="black" points="2066.79,-254.96 2055.94,-253.38 2061.66,-256.43 2057.5,-257.62 2057.5,-257.62 2057.5,-257.62 2061.66,-256.43 2058.41,-262.04 2066.79,-254.96"/>
+</g>
+<!-- artifact_resource_links -->
+<g id="node6" class="node">
+<title>artifact_resource_links</title>
+<polygon fill="#efefef" stroke="none" points="773.13,-564.8 773.13,-610.8 1257.9,-610.8 1257.9,-564.8 773.13,-564.8"/>
+<polygon fill="none" stroke="black" points="773.13,-564.8 773.13,-610.8 1257.9,-610.8 1257.9,-564.8 773.13,-564.8"/>
+<text text-anchor="start" x="898.42" y="-588.6" font-family="Arial Bold" font-size="18.00">artifact_resource_links</text>
+<text text-anchor="start" x="1063.35" y="-588.6" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="1094.47" y="-588.6" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="780.13" y="-574.2" font-family="Arial" font-size="14.00" fill="#333333">산출물 instance 또는 component instance와 document/file/resource를 연결한다.</text>
+<polygon fill="none" stroke="black" points="773.13,-534 773.13,-564.8 1257.9,-564.8 1257.9,-534 773.13,-534"/>
+<text text-anchor="start" x="780.13" y="-546.2" font-family="Arial" font-size="14.00">artifact_resource_link_id </text>
+<text text-anchor="start" x="935.76" y="-546.2" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="773.13,-503.2 773.13,-534 1257.9,-534 1257.9,-503.2 773.13,-503.2"/>
+<text text-anchor="start" x="780.13" y="-515.4" font-family="Arial" font-size="14.00">artifact_instance_id </text>
+<text text-anchor="start" x="904.64" y="-515.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="773.13,-472.4 773.13,-503.2 1257.9,-503.2 1257.9,-472.4 773.13,-472.4"/>
+<text text-anchor="start" x="780.13" y="-484.6" font-family="Arial" font-size="14.00">artifact_component_instance_id </text>
+<text text-anchor="start" x="981.7" y="-484.6" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- artifact_resource_links&#45;&gt;artifact_instances -->
+<g id="edge4" class="edge">
+<title>artifact_resource_links:artifact_instance_id&#45;&gt;artifact_instances:artifact_instance_id</title>
+<path fill="none" stroke="black" d="M1269.2,-517.44C1300.76,-509.39 1282.65,-461.14 1309.51,-429.2 1507,-194.32 1585.21,-58.6 1892.08,-58.6"/>
+<polygon fill="black" stroke="black" points="1269.17,-517.44 1258.73,-514.09 1263.87,-518.04 1259.56,-518.53 1259.56,-518.53 1259.56,-518.53 1263.87,-518.04 1259.73,-523.03 1269.17,-517.44"/>
+</g>
+<!-- artifact_resource_links&#45;&gt;artifact_component_instances -->
+<g id="edge3" class="edge">
+<title>artifact_resource_links:artifact_component_instance_id&#45;&gt;artifact_component_instances:artifact_component_instance_id</title>
+<path fill="none" stroke="black" d="M1269.22,-486.29C1291.05,-478.95 1284.6,-446.59 1309.51,-429.2 1454.65,-327.85 1505.15,-288.6 1682.17,-288.6"/>
+<polygon fill="black" stroke="black" points="1269.12,-486.31 1258.58,-483.3 1263.85,-487.08 1259.56,-487.7 1259.56,-487.7 1259.56,-487.7 1263.85,-487.08 1259.88,-492.2 1269.12,-486.31"/>
+</g>
+<!-- artifact_trace_links -->
+<g id="node7" class="node">
+<title>artifact_trace_links</title>
+<polygon fill="#efefef" stroke="none" points="1361.96,-564.8 1361.96,-610.8 1817.07,-610.8 1817.07,-564.8 1361.96,-564.8"/>
+<polygon fill="none" stroke="black" points="1361.96,-564.8 1361.96,-610.8 1817.07,-610.8 1817.07,-564.8 1361.96,-564.8"/>
+<text text-anchor="start" x="1485.42" y="-588.6" font-family="Arial Bold" font-size="18.00">artifact_trace_links</text>
+<text text-anchor="start" x="1624.35" y="-588.6" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="1655.47" y="-588.6" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="1368.96" y="-574.2" font-family="Arial" font-size="14.00" fill="#333333">실제 산출물 instance와 방법론, 산출물 표준, 외부 실행 결과 간 trace를 관리한다.</text>
+<polygon fill="none" stroke="black" points="1361.96,-534 1361.96,-564.8 1817.07,-564.8 1817.07,-534 1361.96,-534"/>
+<text text-anchor="start" x="1368.96" y="-546.2" font-family="Arial" font-size="14.00">artifact_trace_link_id </text>
+<text text-anchor="start" x="1501.24" y="-546.2" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="1361.96,-503.2 1361.96,-534 1817.07,-534 1817.07,-503.2 1361.96,-503.2"/>
+<text text-anchor="start" x="1368.96" y="-515.4" font-family="Arial" font-size="14.00">artifact_instance_id </text>
+<text text-anchor="start" x="1493.47" y="-515.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="1361.96,-472.4 1361.96,-503.2 1817.07,-503.2 1817.07,-472.4 1361.96,-472.4"/>
+<text text-anchor="start" x="1368.96" y="-484.6" font-family="Arial" font-size="14.00">artifact_component_instance_id </text>
+<text text-anchor="start" x="1570.53" y="-484.6" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- artifact_trace_links&#45;&gt;artifact_instances -->
+<g id="edge6" class="edge">
+<title>artifact_trace_links:artifact_instance_id&#45;&gt;artifact_instances:artifact_instance_id</title>
+<path fill="none" stroke="black" d="M1828.18,-517C1854.73,-507.37 1840.05,-456.72 1817.07,-429.2 1762.95,-364.38 1684.27,-458.32 1630.51,-393.2 1575.62,-326.71 1586.27,-273.21 1630.51,-199.2 1698.23,-85.91 1760.1,-58.6 1892.08,-58.6"/>
+<polygon fill="black" stroke="black" points="1828.28,-516.98 1817.7,-514.1 1823.01,-517.82 1818.73,-518.5 1818.73,-518.5 1818.73,-518.5 1823.01,-517.82 1819.11,-522.99 1828.28,-516.98"/>
+</g>
+<!-- artifact_trace_links&#45;&gt;artifact_component_instances -->
+<g id="edge5" class="edge">
+<title>artifact_trace_links:artifact_component_instance_id&#45;&gt;artifact_component_instances:artifact_component_instance_id</title>
+<path fill="none" stroke="black" d="M1828.04,-484.97C1840.37,-475.78 1830.47,-446.37 1817.07,-429.2 1779.16,-380.62 1720.9,-441.93 1683.17,-393.2 1654.71,-356.44 1635.68,-288.6 1682.17,-288.6"/>
+<polygon fill="black" stroke="black" points="1828.01,-484.98 1817.17,-483.38 1822.88,-486.44 1818.72,-487.62 1818.72,-487.62 1818.72,-487.62 1822.88,-486.44 1819.62,-492.04 1828.01,-484.98"/>
+</g>
+<!-- artifact_validation_result_refs -->
+<g id="node8" class="node">
+<title>artifact_validation_result_refs</title>
+<polygon fill="#efefef" stroke="none" points="1959.43,-564.8 1959.43,-610.8 2259.6,-610.8 2259.6,-564.8 1959.43,-564.8"/>
+<polygon fill="none" stroke="black" points="1959.43,-564.8 1959.43,-610.8 2259.6,-610.8 2259.6,-564.8 1959.43,-564.8"/>
+<text text-anchor="start" x="1966.43" y="-588.6" font-family="Arial Bold" font-size="18.00">artifact_validation_result_refs</text>
+<text text-anchor="start" x="2183.34" y="-588.6" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="2214.46" y="-588.6" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="1986.59" y="-574.2" font-family="Arial" font-size="14.00" fill="#333333">validation 실행 결과의 외부 참조를 관리한다.</text>
+<polygon fill="none" stroke="black" points="1959.43,-534 1959.43,-564.8 2259.6,-564.8 2259.6,-534 1959.43,-534"/>
+<text text-anchor="start" x="1966.43" y="-546.2" font-family="Arial" font-size="14.00">artifact_validation_result_ref_id </text>
+<text text-anchor="start" x="2164.1" y="-546.2" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="1959.43,-503.2 1959.43,-534 2259.6,-534 2259.6,-503.2 1959.43,-503.2"/>
+<text text-anchor="start" x="1966.43" y="-515.4" font-family="Arial" font-size="14.00">artifact_instance_id </text>
+<text text-anchor="start" x="2090.95" y="-515.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="1959.43,-472.4 1959.43,-503.2 2259.6,-503.2 2259.6,-472.4 1959.43,-472.4"/>
+<text text-anchor="start" x="1966.43" y="-484.6" font-family="Arial" font-size="14.00">artifact_component_instance_id </text>
+<text text-anchor="start" x="2168" y="-484.6" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- artifact_validation_result_refs&#45;&gt;artifact_instances -->
+<g id="edge8" class="edge">
+<title>artifact_validation_result_refs:artifact_instance_id&#45;&gt;artifact_instances:artifact_instance_id</title>
+<path fill="none" stroke="black" d="M2270.75,-517.02C2357.93,-487.69 2209.17,-58.6 2104.94,-58.6"/>
+<polygon fill="black" stroke="black" points="2270.81,-517.02 2260.24,-514.1 2265.54,-517.83 2261.26,-518.5 2261.26,-518.5 2261.26,-518.5 2265.54,-517.83 2261.62,-523 2270.81,-517.02"/>
+</g>
+<!-- artifact_validation_result_refs&#45;&gt;artifact_component_instances -->
+<g id="edge7" class="edge">
+<title>artifact_validation_result_refs:artifact_component_instance_id&#45;&gt;artifact_component_instances:artifact_component_instance_id</title>
+<path fill="none" stroke="black" d="M1948.53,-485.02C1936.4,-475.98 1946.86,-446.98 1959.43,-429.2 1985.83,-391.84 2029.59,-430.66 2055.85,-393.2 2082.55,-355.13 2103.35,-288.6 2056.85,-288.6"/>
+<polygon fill="black" stroke="black" points="1948.48,-485.01 1956.89,-492.04 1953.61,-486.45 1957.78,-487.62 1957.78,-487.62 1957.78,-487.62 1953.61,-486.45 1959.32,-483.38 1948.48,-485.01"/>
+</g>
+<!-- artifact_review_decision_refs -->
+<g id="node9" class="node">
+<title>artifact_review_decision_refs</title>
+<polygon fill="#efefef" stroke="none" points="2363.83,-564.8 2363.83,-610.8 2783.19,-610.8 2783.19,-564.8 2363.83,-564.8"/>
+<polygon fill="none" stroke="black" points="2363.83,-564.8 2363.83,-610.8 2783.19,-610.8 2783.19,-564.8 2363.83,-564.8"/>
+<text text-anchor="start" x="2431.94" y="-588.6" font-family="Arial Bold" font-size="18.00">artifact_review_decision_refs</text>
+<text text-anchor="start" x="2645.84" y="-588.6" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="2676.95" y="-588.6" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="2370.83" y="-574.2" font-family="Arial" font-size="14.00" fill="#333333">산출물 instance 또는 component에 대한 검토 결정 외부 참조를 관리한다.</text>
+<polygon fill="none" stroke="black" points="2363.83,-534 2363.83,-564.8 2783.19,-564.8 2783.19,-534 2363.83,-534"/>
+<text text-anchor="start" x="2370.83" y="-546.2" font-family="Arial" font-size="14.00">artifact_review_decision_ref_id </text>
+<text text-anchor="start" x="2566.94" y="-546.2" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="2363.83,-503.2 2363.83,-534 2783.19,-534 2783.19,-503.2 2363.83,-503.2"/>
+<text text-anchor="start" x="2370.83" y="-515.4" font-family="Arial" font-size="14.00">artifact_instance_id </text>
+<text text-anchor="start" x="2495.35" y="-515.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="2363.83,-472.4 2363.83,-503.2 2783.19,-503.2 2783.19,-472.4 2363.83,-472.4"/>
+<text text-anchor="start" x="2370.83" y="-484.6" font-family="Arial" font-size="14.00">artifact_component_instance_id </text>
+<text text-anchor="start" x="2572.41" y="-484.6" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- artifact_review_decision_refs&#45;&gt;artifact_instances -->
+<g id="edge10" class="edge">
+<title>artifact_review_decision_refs:artifact_instance_id&#45;&gt;artifact_instances:artifact_instance_id</title>
+<path fill="none" stroke="black" d="M2352.74,-516.81C2291.51,-493.91 2312.56,-258.01 2274.51,-199.2 2221.34,-117 2202.85,-58.6 2104.94,-58.6"/>
+<polygon fill="black" stroke="black" points="2352.66,-516.8 2361.72,-522.97 2357.91,-517.73 2362.18,-518.48 2362.18,-518.48 2362.18,-518.48 2357.91,-517.73 2363.29,-514.11 2352.66,-516.8"/>
+</g>
+<!-- artifact_review_decision_refs&#45;&gt;artifact_component_instances -->
+<g id="edge9" class="edge">
+<title>artifact_review_decision_refs:artifact_component_instance_id&#45;&gt;artifact_component_instances:artifact_component_instance_id</title>
+<path fill="none" stroke="black" d="M2352.68,-486.46C2330.06,-479.64 2335.42,-448.46 2311.51,-429.2 2210.82,-348.11 2186.14,-288.6 2056.85,-288.6"/>
+<polygon fill="black" stroke="black" points="2352.59,-486.44 2361.91,-492.22 2357.88,-487.14 2362.17,-487.71 2362.17,-487.71 2362.17,-487.71 2357.88,-487.14 2363.09,-483.3 2352.59,-486.44"/>
+</g>
+<!-- artifact_status_events -->
+<g id="node10" class="node">
+<title>artifact_status_events</title>
+<polygon fill="#efefef" stroke="none" points="2391.06,-856.4 2391.06,-902.4 2755.96,-902.4 2755.96,-856.4 2391.06,-856.4"/>
+<polygon fill="none" stroke="black" points="2391.06,-856.4 2391.06,-902.4 2755.96,-902.4 2755.96,-856.4 2391.06,-856.4"/>
+<text text-anchor="start" x="2460.91" y="-880.2" font-family="Arial Bold" font-size="18.00">artifact_status_events</text>
+<text text-anchor="start" x="2616.86" y="-880.2" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="2647.98" y="-880.2" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="2398.06" y="-865.8" font-family="Arial" font-size="14.00" fill="#333333">산출물 instance 또는 component의 상태 전이 이력을 관리한다.</text>
+<polygon fill="none" stroke="black" points="2391.06,-825.6 2391.06,-856.4 2755.96,-856.4 2755.96,-825.6 2391.06,-825.6"/>
+<text text-anchor="start" x="2398.06" y="-837.8" font-family="Arial" font-size="14.00">artifact_status_event_id </text>
+<text text-anchor="start" x="2549.82" y="-837.8" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="2391.06,-794.8 2391.06,-825.6 2755.96,-825.6 2755.96,-794.8 2391.06,-794.8"/>
+<text text-anchor="start" x="2398.06" y="-807" font-family="Arial" font-size="14.00">artifact_instance_id </text>
+<text text-anchor="start" x="2522.58" y="-807" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="2391.06,-764 2391.06,-794.8 2755.96,-794.8 2755.96,-764 2391.06,-764"/>
+<text text-anchor="start" x="2398.06" y="-776.2" font-family="Arial" font-size="14.00">artifact_component_instance_id </text>
+<text text-anchor="start" x="2599.63" y="-776.2" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="2391.06,-733.2 2391.06,-764 2755.96,-764 2755.96,-733.2 2391.06,-733.2"/>
+<text text-anchor="start" x="2398.06" y="-745.4" font-family="Arial" font-size="14.00">artifact_review_decision_ref_id </text>
+<text text-anchor="start" x="2594.16" y="-745.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- artifact_status_events&#45;&gt;artifact_instances -->
+<g id="edge13" class="edge">
+<title>artifact_status_events:artifact_instance_id&#45;&gt;artifact_instances:artifact_instance_id</title>
+<path fill="none" stroke="black" d="M2767.29,-809.59C2905.76,-792.78 2838.58,-434.19 2835.51,-429.2 2645,-118.94 2469.03,-58.6 2104.94,-58.6"/>
+<polygon fill="black" stroke="black" points="2767.28,-809.59 2757.03,-805.69 2761.96,-809.91 2757.63,-810.16 2757.63,-810.16 2757.63,-810.16 2761.96,-809.91 2757.56,-814.67 2767.28,-809.59"/>
+</g>
+<!-- artifact_status_events&#45;&gt;artifact_component_instances -->
+<g id="edge12" class="edge">
+<title>artifact_status_events:artifact_component_instance_id&#45;&gt;artifact_component_instances:artifact_component_instance_id</title>
+<path fill="none" stroke="black" d="M2379.84,-779.3C2261.66,-777.14 1973.31,-739.08 1907.51,-654 1876.95,-614.48 1876.63,-468.47 1907.51,-429.2 1949.45,-375.87 2013.66,-446.33 2055.85,-393.2 2084.77,-356.79 2103.35,-288.6 2056.85,-288.6"/>
+<polygon fill="black" stroke="black" points="2379.73,-779.3 2389.68,-783.9 2385.06,-779.35 2389.39,-779.39 2389.39,-779.39 2389.39,-779.39 2385.06,-779.35 2389.77,-774.9 2379.73,-779.3"/>
+</g>
+<!-- artifact_status_events&#45;&gt;artifact_review_decision_refs -->
+<g id="edge11" class="edge">
+<title>artifact_status_events:artifact_review_decision_ref_id&#45;&gt;artifact_review_decision_refs:artifact_review_decision_ref_id</title>
+<path fill="none" stroke="black" d="M2574.13,-721.94C2584.71,-640.11 2728.2,-732.4 2783.19,-654 2809.89,-615.94 2830.68,-549.4 2784.19,-549.4"/>
+<polygon fill="black" stroke="black" points="2574.13,-721.88 2569.04,-731.6 2573.81,-727.21 2573.55,-731.53 2573.55,-731.53 2573.55,-731.53 2573.81,-727.21 2578.03,-732.14 2574.13,-721.88"/>
+</g>
+</g>
+</svg>

package/docs/usage.md

@@ -0,0 +1,190 @@
+# Usage
+
+`@soddong/agentic-domain-artifact`는 실제 산출물 instance와 component instance, document/file/resource link, trace, validation result reference, review decision reference를 관리한다.
+
+```ts
+import {
+  ArtifactService,
+  openArtifactDatabase,
+  seedBusinessProcessDefinitionArtifact
+} from "@soddong/agentic-domain-artifact";
+
+const db = openArtifactDatabase({ projectRoot: process.cwd() });
+const service = new ArtifactService(db);
+
+const fixture = seedBusinessProcessDefinitionArtifact(service);
+console.log(fixture.aggregate.artifact.artifactCode);
+console.log(fixture.aggregate.components.map((component) => component.artifactComponentCode));
+
+db.close();
+```
+
+## 직접 생성 예시
+
+```ts
+const artifact = service.createArtifactInstance({
+  artifactCode: "component-a-business-process-definition",
+  artifactName: "A컴포넌트 비즈니스 프로세스 정의서",
+  artifactStandardCode: "business_process_definition",
+  artifactStandardVersion: "1.0.0"
+});
+
+const component = service.addArtifactComponentInstance({
+  artifactInstanceId: artifact.artifactInstanceId,
+  artifactComponentCode: "appendix_l3_process",
+  artifactComponentRoleCode: "APPENDIX",
+  componentInstanceName: "A컴포넌트 L3 프로세스 부록"
+});
+
+service.addArtifactTraceLink({
+  artifactInstanceId: artifact.artifactInstanceId,
+  artifactComponentInstanceId: component.artifactComponentInstanceId,
+  sourceTypeCode: "methodology_activity_artifact_requirement",
+  sourceRefId: "<activity_artifact_requirement_id>",
+  traceTypeCode: "produced_by",
+  artifactStandardCode: "business_process_definition",
+  artifactStandardVersion: "1.0.0",
+  artifactComponentCode: "appendix_l3_process"
+});
+
+service.addArtifactReviewDecisionRef({
+  artifactInstanceId: artifact.artifactInstanceId,
+  reviewScopeCode: "artifact_instance",
+  decisionCode: "approved",
+  reviewerRef: "user://reviewer",
+  decisionReason: "후행 Stage 전달을 승인한다.",
+  decisionResultRef: "execution://review/component-a-business-process-definition/0.1.0"
+});
+```
+
+## Activity output 기반 생성 예시
+
+`artifact`는 `methodology` 객체를 직접 받지 않는다. application/integration layer가 Activity output을 중립 DTO로 변환해 전달하면, artifact instance와 component/resource/trace link를 한 번에 생성할 수 있다.
+
+```ts
+const created = service.createArtifactInstanceFromActivityOutputs({
+  artifact: {
+    artifactCode: "component-a-business-process-definition",
+    artifactName: "A컴포넌트 비즈니스 프로세스 정의서",
+    artifactStandardCode: "business_process_definition",
+    artifactStandardVersion: "1.0.0"
+  },
+  activityOutputs: [
+    {
+      sourceRefId: "<activity_artifact_requirement_id:main>",
+      artifactComponentCode: "main_document",
+      artifactComponentRoleCode: "MAIN",
+      componentInstanceName: "본문",
+      resource: {
+        resourceTypeCode: "DOCUMENT_ID",
+        resourceRef: "<adoc_document_id:main>",
+        isPrimary: true
+      }
+    },
+    {
+      sourceRefId: "<activity_artifact_requirement_id:appendix>",
+      artifactComponentCode: "appendix_l3_process",
+      artifactComponentRoleCode: "APPENDIX",
+      componentInstanceName: "L3 프로세스 부록",
+      resource: {
+        resourceTypeCode: "DOCUMENT_ID",
+        resourceRef: "<adoc_document_id:l3>",
+        isPrimary: true
+      }
+    }
+  ]
+});
+
+console.log(created.components.length);
+console.log(created.traceLinks.length);
+```
+
+기존 component에 ADoc document를 사후 연결할 때는 다음 helper를 사용한다.
+
+```ts
+service.bindDocumentToArtifactComponent({
+  artifactInstanceId: created.artifact.artifactInstanceId,
+  artifactComponentInstanceId: created.components[0].artifactComponentInstanceId,
+  documentId: "<adoc_document_id>"
+});
+```
+
+## Lifecycle transition 예시
+
+```ts
+service.transitionArtifactStatus({
+  artifactInstanceId: artifact.artifactInstanceId,
+  toStatusCode: "in_review",
+  actorRef: "agent://authoring-agent",
+  transitionReason: "작성 완료 후 검토를 요청한다."
+});
+
+const reviewDecisionRef = service.addArtifactReviewDecisionRef({
+  artifactInstanceId: artifact.artifactInstanceId,
+  reviewScopeCode: "artifact_instance",
+  decisionCode: "approved",
+  reviewerRef: "user://reviewer",
+  decisionReason: "후행 Stage 전달을 승인한다.",
+  decisionResultRef: "execution://review/component-a-business-process-definition/0.1.0"
+});
+
+service.transitionArtifactStatus({
+  artifactInstanceId: artifact.artifactInstanceId,
+  toStatusCode: "approved",
+  actorRef: "user://reviewer",
+  transitionReason: "검토 승인에 따라 산출물 상태를 승인으로 변경한다.",
+  artifactReviewDecisionRefId: reviewDecisionRef.artifactReviewDecisionRefId
+});
+
+console.log(service.listArtifactStatusEvents(artifact.artifactInstanceId));
+```
+
+## Sample execution seed apply 예시
+
+```ts
+import { applyAgenticSeed } from "@soddong/agentic-domain-artifact";
+
+await applyAgenticSeed({
+  sourcePackageName: "@soddong/agentic-methodology-ai-agent-sdlc",
+  sourcePackageVersion: "0.2.0",
+  bundleCode: "ai-agent-sdlc-build-planning",
+  bundleVersion: "0.2.0",
+  methodologyCode: "ai_agent_sdlc",
+  sourceSection: "sampleExecution",
+  targetOperation: "prepare_sample_execution",
+  itemKey: "ai_agent_sdlc_build_planning_minimal_sample",
+  itemPayload: {
+    sampleCode: "ai_agent_sdlc_build_planning_minimal_sample",
+    methodologyCode: "ai_agent_sdlc",
+    lifecycleCode: "incremental_build_lifecycle",
+    phaseCode: "build_planning_phase",
+    processCode: "build_planning_process",
+    projectCode: "sample-ai-agent-sdlc-build-planning-project"
+  },
+  mode: "apply"
+});
+```
+
+## Handoff resolve 예시
+
+```ts
+const handoff = service.resolveArtifactHandoff({
+  artifactStandardCode: "business_process_definition",
+  artifactStandardVersion: "1.0.0",
+  requiredComponentCodes: [
+    "main_document",
+    "appendix_l3_process",
+    "appendix_scenario"
+  ],
+  requiredResultRefs: [
+    "validation_result",
+    "review_decision"
+  ],
+  requiredResourceTypeCode: "DOCUMENT_ID"
+});
+
+console.log(handoff.resolved);
+console.log(handoff.components.map((component) => component.primaryResource?.resourceRef));
+console.log(handoff.reviewDecisionRefs.map((decisionRef) => decisionRef.decisionCode));
+console.log(handoff.missing);
+```

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@soddong/agentic-domain-artifact",
+  "version": "0.7.0",
+  "description": "Agentic Platform artifact instance domain package",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    ".tbls.yml",
+    "docs",
+    "src/database/migrations"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.11.1"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13"
+  }
+}