npm - @soddong/agentic-contract-validation - Versions diffs - 0.2.0 - Mend

@soddong/agentic-contract-validation 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (38) hide show

package/CHANGELOG.md +17 -0
package/README.md +157 -0
package/dist/database.d.ts +17 -0
package/dist/database.d.ts.map +1 -0
package/dist/database.js +76 -0
package/dist/database.js.map +1 -0
package/dist/index.d.ts +67 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +67 -0
package/dist/index.js.map +1 -0
package/dist/registry.d.ts +21 -0
package/dist/registry.d.ts.map +1 -0
package/dist/registry.js +173 -0
package/dist/registry.js.map +1 -0
package/dist/seed-apply.d.ts +22 -0
package/dist/seed-apply.d.ts.map +1 -0
package/dist/seed-apply.js +198 -0
package/dist/seed-apply.js.map +1 -0
package/docs/build.md +25 -0
package/docs/configuration.md +18 -0
package/docs/delivery.md +9 -0
package/docs/operations.md +7 -0
package/docs/publishing.md +11 -0
package/docs/schema/generated/README.md +22 -0
package/docs/schema/generated/schema.json +563 -0
package/docs/schema/generated/schema.mmd +48 -0
package/docs/schema/generated/schema.svg +83 -0
package/docs/schema/generated/validation_contract_profiles.md +72 -0
package/docs/schema/generated/validation_contract_profiles.svg +71 -0
package/docs/schema/generated/validation_contract_provider_manifests.md +62 -0
package/docs/schema/generated/validation_contract_provider_manifests.svg +49 -0
package/docs/schema/generated/validation_contract_rules.md +91 -0
package/docs/schema/generated/validation_contract_rules.svg +52 -0
package/docs/schema/generated/validation_contract_schema_migrations.md +47 -0
package/docs/schema/generated/validation_contract_schema_migrations.svg +27 -0
package/docs/usage.md +55 -0
package/package.json +27 -0
package/src/database/migrations/0001_validation_contract_registry.sql +78 -0

package/docs/schema/generated/schema.svg ADDED Viewed

@@ -0,0 +1,83 @@
+<?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;contract&#45;validation Pages: 1 -->
+<svg width="924pt" height="631pt"
+ viewBox="0.00 0.00 924.14 631.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 627.2)">
+<title>agentic&#45;contract&#45;validation</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-627.2 920.14,-627.2 920.14,4 -4,4"/>
+<!-- validation_contract_schema_migrations -->
+<g id="node1" class="node">
+<title>validation_contract_schema_migrations</title>
+<polygon fill="#efefef" stroke="none" points="43.2,-518.6 43.2,-564.6 414.37,-564.6 414.37,-518.6 43.2,-518.6"/>
+<polygon fill="none" stroke="black" points="43.2,-518.6 43.2,-564.6 414.37,-564.6 414.37,-518.6 43.2,-518.6"/>
+<text text-anchor="start" x="50.2" y="-542.4" font-family="Arial Bold" font-size="18.00">validation_contract_schema_migrations</text>
+<text text-anchor="start" x="338.11" y="-542.4" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="369.23" y="-542.4" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="56.45" y="-528" font-family="Arial" font-size="14.00" fill="#333333">validation contract registry migration 적용 이력을 관리한다.</text>
+<polygon fill="none" stroke="black" points="43.2,-487.8 43.2,-518.6 414.37,-518.6 414.37,-487.8 43.2,-487.8"/>
+<text text-anchor="start" x="50.2" y="-500" font-family="Arial" font-size="14.00">migration_id </text>
+<text text-anchor="start" x="130.35" y="-500" font-family="Arial" font-size="14.00" fill="#666666">[VARCHAR(128)]</text>
+</g>
+<!-- validation_contract_provider_manifests -->
+<g id="node2" class="node">
+<title>validation_contract_provider_manifests</title>
+<polygon fill="#efefef" stroke="none" points="489.7,-74 489.7,-120 859.87,-120 859.87,-74 489.7,-74"/>
+<polygon fill="none" stroke="black" points="489.7,-74 489.7,-120 859.87,-120 859.87,-74 489.7,-74"/>
+<text text-anchor="start" x="496.7" y="-97.8" font-family="Arial Bold" font-size="18.00">validation_contract_provider_manifests</text>
+<text text-anchor="start" x="783.61" y="-97.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="814.73" y="-97.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="556.51" y="-83.4" font-family="Arial" font-size="14.00" fill="#333333">validation provider manifest를 관리한다.</text>
+<polygon fill="none" stroke="black" points="489.7,-43.2 489.7,-74 859.87,-74 859.87,-43.2 489.7,-43.2"/>
+<text text-anchor="start" x="496.7" y="-55.4" font-family="Arial" font-size="14.00">provider_manifest_id </text>
+<text text-anchor="start" x="630.55" y="-55.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- validation_contract_profiles -->
+<g id="node3" class="node">
+<title>validation_contract_profiles</title>
+<polygon fill="#efefef" stroke="none" points="497.38,-304 497.38,-350 852.18,-350 852.18,-304 497.38,-304"/>
+<polygon fill="none" stroke="black" points="497.38,-304 497.38,-350 852.18,-350 852.18,-304 497.38,-304"/>
+<text text-anchor="start" x="538.69" y="-327.8" font-family="Arial Bold" font-size="18.00">validation_contract_profiles</text>
+<text text-anchor="start" x="741.62" y="-327.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="772.74" y="-327.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="504.38" y="-313.4" font-family="Arial" font-size="14.00" fill="#333333">provider manifest가 제공하는 validation profile을 관리한다.</text>
+<polygon fill="none" stroke="black" points="497.38,-273.2 497.38,-304 852.18,-304 852.18,-273.2 497.38,-273.2"/>
+<text text-anchor="start" x="504.38" y="-285.4" font-family="Arial" font-size="14.00">validation_profile_id </text>
+<text text-anchor="start" x="632.02" y="-285.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="497.38,-242.4 497.38,-273.2 852.18,-273.2 852.18,-242.4 497.38,-242.4"/>
+<text text-anchor="start" x="504.38" y="-254.6" font-family="Arial" font-size="14.00">provider_manifest_id </text>
+<text text-anchor="start" x="638.23" y="-254.6" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- validation_contract_profiles&#45;&gt;validation_contract_provider_manifests -->
+<g id="edge1" class="edge">
+<title>validation_contract_profiles:provider_manifest_id&#45;&gt;validation_contract_provider_manifests:provider_manifest_id</title>
+<path fill="none" stroke="black" d="M675.35,-231.17C686.01,-141.87 842.85,-247.48 903.07,-163.2 918.57,-141.5 921.88,-62.1 903.07,-43.2 867.27,-7.25 674.78,8.53 674.78,-42.2"/>
+<polygon fill="black" stroke="black" points="675.36,-231.08 670.31,-240.82 675.06,-236.41 674.82,-240.73 674.82,-240.73 674.82,-240.73 675.06,-236.41 679.3,-241.32 675.36,-231.08"/>
+</g>
+<!-- validation_contract_rules -->
+<g id="node4" class="node">
+<title>validation_contract_rules</title>
+<polygon fill="#efefef" stroke="none" points="518.39,-534 518.39,-580 831.18,-580 831.18,-534 518.39,-534"/>
+<polygon fill="none" stroke="black" points="518.39,-534 518.39,-580 831.18,-580 831.18,-534 518.39,-534"/>
+<text text-anchor="start" x="548.69" y="-557.8" font-family="Arial Bold" font-size="18.00">validation_contract_rules</text>
+<text text-anchor="start" x="731.62" y="-557.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="762.74" y="-557.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="525.39" y="-543.4" font-family="Arial" font-size="14.00" fill="#333333">validation profile에 포함된 rule contract를 관리한다.</text>
+<polygon fill="none" stroke="black" points="518.39,-503.2 518.39,-534 831.18,-534 831.18,-503.2 518.39,-503.2"/>
+<text text-anchor="start" x="525.39" y="-515.4" font-family="Arial" font-size="14.00">validation_rule_id </text>
+<text text-anchor="start" x="638.25" y="-515.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="518.39,-472.4 518.39,-503.2 831.18,-503.2 831.18,-472.4 518.39,-472.4"/>
+<text text-anchor="start" x="525.39" y="-484.6" font-family="Arial" font-size="14.00">validation_profile_id </text>
+<text text-anchor="start" x="653.03" y="-484.6" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- validation_contract_rules&#45;&gt;validation_contract_profiles -->
+<g id="edge2" class="edge">
+<title>validation_contract_rules:validation_profile_id&#45;&gt;validation_contract_profiles:validation_profile_id</title>
+<path fill="none" stroke="black" d="M675.49,-461.19C685.8,-391.82 806.81,-462.06 852.18,-393.2 877.76,-354.38 899.67,-288.6 853.18,-288.6"/>
+<polygon fill="black" stroke="black" points="675.49,-461.09 670.32,-470.76 675.13,-466.41 674.83,-470.73 674.83,-470.73 674.83,-470.73 675.13,-466.41 679.3,-471.38 675.49,-461.09"/>
+</g>
+</g>
+</svg>

package/docs/schema/generated/validation_contract_profiles.md ADDED Viewed

@@ -0,0 +1,72 @@
+# validation_contract_profiles
+## Description
+provider manifest가 제공하는 validation profile을 관리한다.
+<details>
+<summary><strong>Table Definition</strong></summary>
+```sql
+CREATE TABLE validation_contract_profiles (
+  validation_profile_id CHAR(36) PRIMARY KEY
+    CHECK (length(validation_profile_id) = 36),
+  provider_manifest_id CHAR(36) NOT NULL
+    CHECK (length(provider_manifest_id) = 36),
+  profile_id VARCHAR(256) NOT NULL,
+  provider_module VARCHAR(256) NOT NULL,
+  target_domain VARCHAR(128) NOT NULL,
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  metadata_json JSON
+    CHECK (metadata_json IS NULL OR json_valid(metadata_json)),
+  FOREIGN KEY (provider_manifest_id)
+    REFERENCES validation_contract_provider_manifests (provider_manifest_id)
+    ON DELETE CASCADE,
+  UNIQUE (provider_manifest_id, profile_id)
+)
+```
+</details>
+## Columns
+| Name                  | Type         | Default           | Nullable | Children                                                  | Parents                                                                             |
+| --------------------- | ------------ | ----------------- | -------- | --------------------------------------------------------- | ----------------------------------------------------------------------------------- |
+| validation_profile_id | CHAR(36)     |                   | true     | [validation_contract_rules](validation_contract_rules.md) |                                                                                     |
+| provider_manifest_id  | CHAR(36)     |                   | false    |                                                           | [validation_contract_provider_manifests](validation_contract_provider_manifests.md) |
+| profile_id            | VARCHAR(256) |                   | false    |                                                           |                                                                                     |
+| provider_module       | VARCHAR(256) |                   | false    |                                                           |                                                                                     |
+| target_domain         | VARCHAR(128) |                   | false    |                                                           |                                                                                     |
+| created_at            | DATETIME     | CURRENT_TIMESTAMP | false    |                                                           |                                                                                     |
+| updated_at            | DATETIME     | CURRENT_TIMESTAMP | false    |                                                           |                                                                                     |
+| metadata_json         | JSON         |                   | true     |                                                           |                                                                                     |
+## Constraints
+| Name                                            | Type        | Definition                                                                                                                                                   |
+| ----------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| validation_profile_id                           | PRIMARY KEY | PRIMARY KEY (validation_profile_id)                                                                                                                          |
+| - (Foreign key ID: 0)                           | FOREIGN KEY | FOREIGN KEY (provider_manifest_id) REFERENCES validation_contract_provider_manifests (provider_manifest_id) ON UPDATE NO ACTION ON DELETE CASCADE MATCH NONE |
+| sqlite_autoindex_validation_contract_profiles_2 | UNIQUE      | UNIQUE (provider_manifest_id, profile_id)                                                                                                                    |
+| sqlite_autoindex_validation_contract_profiles_1 | PRIMARY KEY | PRIMARY KEY (validation_profile_id)                                                                                                                          |
+| -                                               | CHECK       | CHECK (length(validation_profile_id) = 36)                                                                                                                   |
+| -                                               | CHECK       | CHECK (length(provider_manifest_id) = 36)                                                                                                                    |
+| -                                               | CHECK       | CHECK (metadata_json IS NULL OR json_valid(metadata_json))                                                                                                   |
+## Indexes
+| Name                                            | Definition                                                                                                           |
+| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| idx_validation_contract_profiles_target         | CREATE INDEX idx_validation_contract_profiles_target<br />  ON validation_contract_profiles (target_domain)          |
+| idx_validation_contract_profiles_provider       | CREATE INDEX idx_validation_contract_profiles_provider<br />  ON validation_contract_profiles (provider_manifest_id) |
+| sqlite_autoindex_validation_contract_profiles_2 | UNIQUE (provider_manifest_id, profile_id)                                                                            |
+| sqlite_autoindex_validation_contract_profiles_1 | PRIMARY KEY (validation_profile_id)                                                                                  |
+## Relations
+![er](validation_contract_profiles.svg)
+---
+> Generated by [tbls](https://github.com/k1LoW/tbls)

package/docs/schema/generated/validation_contract_profiles.svg ADDED Viewed

@@ -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: validation_contract_profiles Pages: 1 -->
+<svg width="490pt" height="637pt"
+ viewBox="0.00 0.00 490.42 637.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 633.2)">
+<title>validation_contract_profiles</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-633.2 486.42,-633.2 486.42,4 -4,4"/>
+<!-- validation_contract_profiles -->
+<g id="node1" class="node">
+<title>validation_contract_profiles</title>
+<polygon fill="#efefef" stroke="none" points="50.88,-307 50.88,-353 405.68,-353 405.68,-307 50.88,-307"/>
+<polygon fill="none" stroke="black" points="50.88,-307 50.88,-353 405.68,-353 405.68,-307 50.88,-307"/>
+<text text-anchor="start" x="92.19" y="-330.8" font-family="Arial Bold" font-size="18.00">validation_contract_profiles</text>
+<text text-anchor="start" x="295.12" y="-330.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="326.24" y="-330.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="57.88" y="-316.4" font-family="Arial" font-size="14.00" fill="#333333">provider manifest가 제공하는 validation profile을 관리한다.</text>
+<polygon fill="none" stroke="black" points="50.88,-276.2 50.88,-307 405.68,-307 405.68,-276.2 50.88,-276.2"/>
+<text text-anchor="start" x="57.88" y="-288.4" font-family="Arial" font-size="14.00">validation_profile_id </text>
+<text text-anchor="start" x="185.52" y="-288.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="50.88,-245.4 50.88,-276.2 405.68,-276.2 405.68,-245.4 50.88,-245.4"/>
+<text text-anchor="start" x="57.88" y="-257.6" font-family="Arial" font-size="14.00">provider_manifest_id </text>
+<text text-anchor="start" x="191.73" y="-257.6" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" stroke-width="3" points="49.38,-243.9 49.38,-354.5 407.18,-354.5 407.18,-243.9 49.38,-243.9"/>
+</g>
+<!-- validation_contract_provider_manifests -->
+<g id="node3" class="node">
+<title>validation_contract_provider_manifests</title>
+<polygon fill="#efefef" stroke="none" points="43.2,-74 43.2,-120 413.37,-120 413.37,-74 43.2,-74"/>
+<polygon fill="none" stroke="black" points="43.2,-74 43.2,-120 413.37,-120 413.37,-74 43.2,-74"/>
+<text text-anchor="start" x="50.2" y="-97.8" font-family="Arial Bold" font-size="18.00">validation_contract_provider_manifests</text>
+<text text-anchor="start" x="337.11" y="-97.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="368.23" y="-97.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="110.01" y="-83.4" font-family="Arial" font-size="14.00" fill="#333333">validation provider manifest를 관리한다.</text>
+<polygon fill="none" stroke="black" points="43.2,-43.2 43.2,-74 413.37,-74 413.37,-43.2 43.2,-43.2"/>
+<text text-anchor="start" x="50.2" y="-55.4" font-family="Arial" font-size="14.00">provider_manifest_id </text>
+<text text-anchor="start" x="184.05" y="-55.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- validation_contract_profiles&#45;&gt;validation_contract_provider_manifests -->
+<g id="edge2" class="edge">
+<title>validation_contract_profiles:provider_manifest_id&#45;&gt;validation_contract_provider_manifests:provider_manifest_id</title>
+<path fill="none" stroke="black" d="M228.85,-234.12C239.52,-144.3 396.6,-248.18 456.57,-163.2 487.32,-119.62 494.19,-80.99 456.57,-43.2 420.77,-7.25 228.28,8.53 228.28,-42.2"/>
+<polygon fill="black" stroke="black" points="228.86,-234.08 223.81,-243.82 228.56,-239.41 228.32,-243.73 228.32,-243.73 228.32,-243.73 228.56,-239.41 232.79,-244.32 228.86,-234.08"/>
+</g>
+<!-- validation_contract_rules -->
+<g id="node2" class="node">
+<title>validation_contract_rules</title>
+<polygon fill="#efefef" stroke="none" points="71.89,-540 71.89,-586 384.68,-586 384.68,-540 71.89,-540"/>
+<polygon fill="none" stroke="black" points="71.89,-540 71.89,-586 384.68,-586 384.68,-540 71.89,-540"/>
+<text text-anchor="start" x="102.19" y="-563.8" font-family="Arial Bold" font-size="18.00">validation_contract_rules</text>
+<text text-anchor="start" x="285.12" y="-563.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="316.24" y="-563.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="78.89" y="-549.4" font-family="Arial" font-size="14.00" fill="#333333">validation profile에 포함된 rule contract를 관리한다.</text>
+<polygon fill="none" stroke="black" points="71.89,-509.2 71.89,-540 384.68,-540 384.68,-509.2 71.89,-509.2"/>
+<text text-anchor="start" x="78.89" y="-521.4" font-family="Arial" font-size="14.00">validation_rule_id </text>
+<text text-anchor="start" x="191.74" y="-521.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="71.89,-478.4 71.89,-509.2 384.68,-509.2 384.68,-478.4 71.89,-478.4"/>
+<text text-anchor="start" x="78.89" y="-490.6" font-family="Arial" font-size="14.00">validation_profile_id </text>
+<text text-anchor="start" x="206.53" y="-490.6" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- validation_contract_rules&#45;&gt;validation_contract_profiles -->
+<g id="edge1" class="edge">
+<title>validation_contract_rules:validation_profile_id&#45;&gt;validation_contract_profiles:validation_profile_id</title>
+<path fill="none" stroke="black" d="M228.99,-467.19C239.3,-397.82 360.32,-468.07 405.68,-399.2 431.99,-359.26 454.51,-291.6 406.68,-291.6"/>
+<polygon fill="black" stroke="black" points="228.99,-467.09 223.82,-476.76 228.63,-472.41 228.33,-476.73 228.33,-476.73 228.33,-476.73 228.63,-472.41 232.79,-477.38 228.99,-467.09"/>
+</g>
+</g>
+</svg>

package/docs/schema/generated/validation_contract_provider_manifests.md ADDED Viewed

@@ -0,0 +1,62 @@
+# validation_contract_provider_manifests
+## Description
+validation provider manifest를 관리한다.
+<details>
+<summary><strong>Table Definition</strong></summary>
+```sql
+CREATE TABLE validation_contract_provider_manifests (
+  provider_manifest_id CHAR(36) PRIMARY KEY
+    CHECK (length(provider_manifest_id) = 36),
+  provider_id VARCHAR(256) NOT NULL,
+  provider_module VARCHAR(256) NOT NULL,
+  provider_version VARCHAR(64) NOT NULL,
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  metadata_json JSON
+    CHECK (metadata_json IS NULL OR json_valid(metadata_json)),
+  UNIQUE (provider_id, provider_version)
+)
+```
+</details>
+## Columns
+| Name                 | Type         | Default           | Nullable | Children                                                        |
+| -------------------- | ------------ | ----------------- | -------- | --------------------------------------------------------------- |
+| provider_manifest_id | CHAR(36)     |                   | true     | [validation_contract_profiles](validation_contract_profiles.md) |
+| provider_id          | VARCHAR(256) |                   | false    |                                                                 |
+| provider_module      | VARCHAR(256) |                   | false    |                                                                 |
+| provider_version     | VARCHAR(64)  |                   | false    |                                                                 |
+| created_at           | DATETIME     | CURRENT_TIMESTAMP | false    |                                                                 |
+| updated_at           | DATETIME     | CURRENT_TIMESTAMP | false    |                                                                 |
+| metadata_json        | JSON         |                   | true     |                                                                 |
+## Constraints
+| Name                                                      | Type        | Definition                                                 |
+| --------------------------------------------------------- | ----------- | ---------------------------------------------------------- |
+| provider_manifest_id                                      | PRIMARY KEY | PRIMARY KEY (provider_manifest_id)                         |
+| sqlite_autoindex_validation_contract_provider_manifests_2 | UNIQUE      | UNIQUE (provider_id, provider_version)                     |
+| sqlite_autoindex_validation_contract_provider_manifests_1 | PRIMARY KEY | PRIMARY KEY (provider_manifest_id)                         |
+| -                                                         | CHECK       | CHECK (length(provider_manifest_id) = 36)                  |
+| -                                                         | CHECK       | CHECK (metadata_json IS NULL OR json_valid(metadata_json)) |
+## Indexes
+| Name                                                      | Definition                             |
+| --------------------------------------------------------- | -------------------------------------- |
+| sqlite_autoindex_validation_contract_provider_manifests_2 | UNIQUE (provider_id, provider_version) |
+| sqlite_autoindex_validation_contract_provider_manifests_1 | PRIMARY KEY (provider_manifest_id)     |
+## Relations
+![er](validation_contract_provider_manifests.svg)
+---
+> Generated by [tbls](https://github.com/k1LoW/tbls)

package/docs/schema/generated/validation_contract_provider_manifests.svg ADDED Viewed

@@ -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: validation_contract_provider_manifests Pages: 1 -->
+<svg width="484pt" height="407pt"
+ viewBox="0.00 0.00 483.98 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>validation_contract_provider_manifests</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-403.2 479.98,-403.2 479.98,4 -4,4"/>
+<!-- validation_contract_provider_manifests -->
+<g id="node1" class="node">
+<title>validation_contract_provider_manifests</title>
+<polygon fill="#efefef" stroke="none" points="46.2,-77 46.2,-123 416.37,-123 416.37,-77 46.2,-77"/>
+<polygon fill="none" stroke="black" points="46.2,-77 46.2,-123 416.37,-123 416.37,-77 46.2,-77"/>
+<text text-anchor="start" x="53.2" y="-100.8" font-family="Arial Bold" font-size="18.00">validation_contract_provider_manifests</text>
+<text text-anchor="start" x="340.11" y="-100.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="371.23" y="-100.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="113.01" y="-86.4" font-family="Arial" font-size="14.00" fill="#333333">validation provider manifest를 관리한다.</text>
+<polygon fill="none" stroke="black" points="46.2,-46.2 46.2,-77 416.37,-77 416.37,-46.2 46.2,-46.2"/>
+<text text-anchor="start" x="53.2" y="-58.4" font-family="Arial" font-size="14.00">provider_manifest_id </text>
+<text text-anchor="start" x="187.05" y="-58.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" stroke-width="3" points="44.7,-44.7 44.7,-124.5 417.87,-124.5 417.87,-44.7 44.7,-44.7"/>
+</g>
+<!-- validation_contract_profiles -->
+<g id="node2" class="node">
+<title>validation_contract_profiles</title>
+<polygon fill="#efefef" stroke="none" points="53.88,-310 53.88,-356 408.68,-356 408.68,-310 53.88,-310"/>
+<polygon fill="none" stroke="black" points="53.88,-310 53.88,-356 408.68,-356 408.68,-310 53.88,-310"/>
+<text text-anchor="start" x="95.19" y="-333.8" font-family="Arial Bold" font-size="18.00">validation_contract_profiles</text>
+<text text-anchor="start" x="298.12" y="-333.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="329.24" y="-333.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="60.88" y="-319.4" font-family="Arial" font-size="14.00" fill="#333333">provider manifest가 제공하는 validation profile을 관리한다.</text>
+<polygon fill="none" stroke="black" points="53.88,-279.2 53.88,-310 408.68,-310 408.68,-279.2 53.88,-279.2"/>
+<text text-anchor="start" x="60.88" y="-291.4" font-family="Arial" font-size="14.00">validation_profile_id </text>
+<text text-anchor="start" x="188.52" y="-291.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="53.88,-248.4 53.88,-279.2 408.68,-279.2 408.68,-248.4 53.88,-248.4"/>
+<text text-anchor="start" x="60.88" y="-260.6" font-family="Arial" font-size="14.00">provider_manifest_id </text>
+<text text-anchor="start" x="194.73" y="-260.6" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- validation_contract_profiles&#45;&gt;validation_contract_provider_manifests -->
+<g id="edge1" class="edge">
+<title>validation_contract_profiles:provider_manifest_id&#45;&gt;validation_contract_provider_manifests:provider_manifest_id</title>
+<path fill="none" stroke="black" d="M231.86,-237.05C242.65,-146.75 401.47,-254.35 462.57,-169.2 478.5,-146.99 481.85,-65.57 462.57,-46.2 426.3,-9.78 231.28,6.2 231.28,-45.2"/>
+<polygon fill="black" stroke="black" points="231.86,-237.08 226.81,-246.82 231.56,-242.41 231.32,-246.73 231.32,-246.73 231.32,-246.73 231.56,-242.41 235.79,-247.32 231.86,-237.08"/>
+</g>
+</g>
+</svg>

package/docs/schema/generated/validation_contract_rules.md ADDED Viewed

@@ -0,0 +1,91 @@
+# validation_contract_rules
+## Description
+validation profile에 포함된 rule contract를 관리한다.
+<details>
+<summary><strong>Table Definition</strong></summary>
+```sql
+CREATE TABLE validation_contract_rules (
+  validation_rule_id CHAR(36) PRIMARY KEY
+    CHECK (length(validation_rule_id) = 36),
+  validation_profile_id CHAR(36) NOT NULL
+    CHECK (length(validation_profile_id) = 36),
+  rule_id VARCHAR(256) NOT NULL,
+  provider_module VARCHAR(256) NOT NULL,
+  validation_type_code VARCHAR(64) NOT NULL,
+  execution_mode_code VARCHAR(64) NOT NULL,
+  severity_code VARCHAR(64) NOT NULL,
+  applies_to_type_code VARCHAR(128) NOT NULL,
+  applies_to_ref VARCHAR(256),
+  source_component_ref VARCHAR(256),
+  parameters_json JSON
+    CHECK (parameters_json IS NULL OR json_valid(parameters_json)),
+  message TEXT NOT NULL,
+  remediation TEXT,
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  metadata_json JSON
+    CHECK (metadata_json IS NULL OR json_valid(metadata_json)),
+  FOREIGN KEY (validation_profile_id)
+    REFERENCES validation_contract_profiles (validation_profile_id)
+    ON DELETE CASCADE,
+  UNIQUE (validation_profile_id, rule_id)
+)
+```
+</details>
+## Columns
+| Name                  | Type         | Default           | Nullable | Parents                                                         |
+| --------------------- | ------------ | ----------------- | -------- | --------------------------------------------------------------- |
+| validation_rule_id    | CHAR(36)     |                   | true     |                                                                 |
+| validation_profile_id | CHAR(36)     |                   | false    | [validation_contract_profiles](validation_contract_profiles.md) |
+| rule_id               | VARCHAR(256) |                   | false    |                                                                 |
+| provider_module       | VARCHAR(256) |                   | false    |                                                                 |
+| validation_type_code  | VARCHAR(64)  |                   | false    |                                                                 |
+| execution_mode_code   | VARCHAR(64)  |                   | false    |                                                                 |
+| severity_code         | VARCHAR(64)  |                   | false    |                                                                 |
+| applies_to_type_code  | VARCHAR(128) |                   | false    |                                                                 |
+| applies_to_ref        | VARCHAR(256) |                   | true     |                                                                 |
+| source_component_ref  | VARCHAR(256) |                   | true     |                                                                 |
+| parameters_json       | JSON         |                   | true     |                                                                 |
+| message               | TEXT         |                   | false    |                                                                 |
+| remediation           | TEXT         |                   | true     |                                                                 |
+| sort_order            | INTEGER      | 0                 | false    |                                                                 |
+| created_at            | DATETIME     | CURRENT_TIMESTAMP | false    |                                                                 |
+| updated_at            | DATETIME     | CURRENT_TIMESTAMP | false    |                                                                 |
+| metadata_json         | JSON         |                   | true     |                                                                 |
+## Constraints
+| Name                                         | Type        | Definition                                                                                                                                           |
+| -------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| validation_rule_id                           | PRIMARY KEY | PRIMARY KEY (validation_rule_id)                                                                                                                     |
+| - (Foreign key ID: 0)                        | FOREIGN KEY | FOREIGN KEY (validation_profile_id) REFERENCES validation_contract_profiles (validation_profile_id) ON UPDATE NO ACTION ON DELETE CASCADE MATCH NONE |
+| sqlite_autoindex_validation_contract_rules_2 | UNIQUE      | UNIQUE (validation_profile_id, rule_id)                                                                                                              |
+| sqlite_autoindex_validation_contract_rules_1 | PRIMARY KEY | PRIMARY KEY (validation_rule_id)                                                                                                                     |
+| -                                            | CHECK       | CHECK (length(validation_rule_id) = 36)                                                                                                              |
+| -                                            | CHECK       | CHECK (length(validation_profile_id) = 36)                                                                                                           |
+| -                                            | CHECK       | CHECK (parameters_json IS NULL OR json_valid(parameters_json))                                                                                       |
+| -                                            | CHECK       | CHECK (metadata_json IS NULL OR json_valid(metadata_json))                                                                                           |
+## Indexes
+| Name                                         | Definition                                                                                                     |
+| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| idx_validation_contract_rules_profile        | CREATE INDEX idx_validation_contract_rules_profile<br />  ON validation_contract_rules (validation_profile_id) |
+| sqlite_autoindex_validation_contract_rules_2 | UNIQUE (validation_profile_id, rule_id)                                                                        |
+| sqlite_autoindex_validation_contract_rules_1 | PRIMARY KEY (validation_rule_id)                                                                               |
+## Relations
+![er](validation_contract_rules.svg)
+---
+> Generated by [tbls](https://github.com/k1LoW/tbls)

package/docs/schema/generated/validation_contract_rules.svg ADDED Viewed

@@ -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: validation_contract_rules Pages: 1 -->
+<svg width="449pt" height="438pt"
+ viewBox="0.00 0.00 449.20 438.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 434)">
+<title>validation_contract_rules</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-434 445.2,-434 445.2,4 -4,4"/>
+<!-- validation_contract_rules -->
+<g id="node1" class="node">
+<title>validation_contract_rules</title>
+<polygon fill="#efefef" stroke="none" points="64.21,-337.8 64.21,-383.8 376.99,-383.8 376.99,-337.8 64.21,-337.8"/>
+<polygon fill="none" stroke="black" points="64.21,-337.8 64.21,-383.8 376.99,-383.8 376.99,-337.8 64.21,-337.8"/>
+<text text-anchor="start" x="94.5" y="-361.6" font-family="Arial Bold" font-size="18.00">validation_contract_rules</text>
+<text text-anchor="start" x="277.44" y="-361.6" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="308.56" y="-361.6" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="71.21" y="-347.2" font-family="Arial" font-size="14.00" fill="#333333">validation profile에 포함된 rule contract를 관리한다.</text>
+<polygon fill="none" stroke="black" points="64.21,-307 64.21,-337.8 376.99,-337.8 376.99,-307 64.21,-307"/>
+<text text-anchor="start" x="71.21" y="-319.2" font-family="Arial" font-size="14.00">validation_rule_id </text>
+<text text-anchor="start" x="184.06" y="-319.2" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="64.21,-276.2 64.21,-307 376.99,-307 376.99,-276.2 64.21,-276.2"/>
+<text text-anchor="start" x="71.21" y="-288.4" font-family="Arial" font-size="14.00">validation_profile_id </text>
+<text text-anchor="start" x="198.85" y="-288.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" stroke-width="3" points="62.71,-274.7 62.71,-385.3 378.49,-385.3 378.49,-274.7 62.71,-274.7"/>
+</g>
+<!-- validation_contract_profiles -->
+<g id="node2" class="node">
+<title>validation_contract_profiles</title>
+<polygon fill="#efefef" stroke="none" points="43.2,-104.8 43.2,-150.8 398,-150.8 398,-104.8 43.2,-104.8"/>
+<polygon fill="none" stroke="black" points="43.2,-104.8 43.2,-150.8 398,-150.8 398,-104.8 43.2,-104.8"/>
+<text text-anchor="start" x="84.51" y="-128.6" font-family="Arial Bold" font-size="18.00">validation_contract_profiles</text>
+<text text-anchor="start" x="287.44" y="-128.6" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="318.55" 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">provider manifest가 제공하는 validation profile을 관리한다.</text>
+<polygon fill="none" stroke="black" points="43.2,-74 43.2,-104.8 398,-104.8 398,-74 43.2,-74"/>
+<text text-anchor="start" x="50.2" y="-86.2" font-family="Arial" font-size="14.00">validation_profile_id </text>
+<text text-anchor="start" x="177.84" y="-86.2" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+<polygon fill="none" stroke="black" points="43.2,-43.2 43.2,-74 398,-74 398,-43.2 43.2,-43.2"/>
+<text text-anchor="start" x="50.2" y="-55.4" font-family="Arial" font-size="14.00">provider_manifest_id </text>
+<text text-anchor="start" x="184.05" y="-55.4" font-family="Arial" font-size="14.00" fill="#666666">[CHAR(36)]</text>
+</g>
+<!-- validation_contract_rules&#45;&gt;validation_contract_profiles -->
+<g id="edge1" class="edge">
+<title>validation_contract_rules:validation_profile_id&#45;&gt;validation_contract_profiles:validation_profile_id</title>
+<path fill="none" stroke="black" d="M221.3,-264.91C231.64,-194.93 352.83,-263.62 398,-194 423.3,-155 445.49,-89.4 399,-89.4"/>
+<polygon fill="black" stroke="black" points="221.31,-264.89 216.13,-274.56 220.94,-270.21 220.65,-274.53 220.65,-274.53 220.65,-274.53 220.94,-270.21 225.11,-275.17 221.31,-264.89"/>
+</g>
+</g>
+</svg>

package/docs/schema/generated/validation_contract_schema_migrations.md ADDED Viewed

@@ -0,0 +1,47 @@
+# validation_contract_schema_migrations
+## Description
+validation contract registry migration 적용 이력을 관리한다.
+<details>
+<summary><strong>Table Definition</strong></summary>
+```sql
+CREATE TABLE validation_contract_schema_migrations (
+  migration_id VARCHAR(128) PRIMARY KEY,
+  migration_name VARCHAR(256) NOT NULL,
+  applied_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+)
+```
+</details>
+## Columns
+| Name           | Type         | Default           | Nullable |
+| -------------- | ------------ | ----------------- | -------- |
+| migration_id   | VARCHAR(128) |                   | true     |
+| migration_name | VARCHAR(256) |                   | false    |
+| applied_at     | DATETIME     | CURRENT_TIMESTAMP | false    |
+## Constraints
+| Name                                                     | Type        | Definition                 |
+| -------------------------------------------------------- | ----------- | -------------------------- |
+| migration_id                                             | PRIMARY KEY | PRIMARY KEY (migration_id) |
+| sqlite_autoindex_validation_contract_schema_migrations_1 | PRIMARY KEY | PRIMARY KEY (migration_id) |
+## Indexes
+| Name                                                     | Definition                 |
+| -------------------------------------------------------- | -------------------------- |
+| sqlite_autoindex_validation_contract_schema_migrations_1 | PRIMARY KEY (migration_id) |
+## Relations
+![er](validation_contract_schema_migrations.svg)
+---
+> Generated by [tbls](https://github.com/k1LoW/tbls)

package/docs/schema/generated/validation_contract_schema_migrations.svg ADDED Viewed

@@ -0,0 +1,27 @@
+<?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: validation_contract_schema_migrations Pages: 1 -->
+<svg width="472pt" height="177pt"
+ viewBox="0.00 0.00 471.57 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>validation_contract_schema_migrations</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-173.2 467.57,-173.2 467.57,4 -4,4"/>
+<!-- validation_contract_schema_migrations -->
+<g id="node1" class="node">
+<title>validation_contract_schema_migrations</title>
+<polygon fill="#efefef" stroke="none" points="46.2,-77 46.2,-123 417.37,-123 417.37,-77 46.2,-77"/>
+<polygon fill="none" stroke="black" points="46.2,-77 46.2,-123 417.37,-123 417.37,-77 46.2,-77"/>
+<text text-anchor="start" x="53.2" y="-100.8" font-family="Arial Bold" font-size="18.00">validation_contract_schema_migrations</text>
+<text text-anchor="start" x="341.11" y="-100.8" font-family="Arial" font-size="14.00">    </text>
+<text text-anchor="start" x="372.23" y="-100.8" font-family="Arial" font-size="14.00" fill="#666666">[table]</text>
+<text text-anchor="start" x="59.45" y="-86.4" font-family="Arial" font-size="14.00" fill="#333333">validation contract registry migration 적용 이력을 관리한다.</text>
+<polygon fill="none" stroke="black" points="46.2,-46.2 46.2,-77 417.37,-77 417.37,-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>
+<polygon fill="none" stroke="black" stroke-width="3" points="44.7,-44.7 44.7,-124.5 418.87,-124.5 418.87,-44.7 44.7,-44.7"/>
+</g>
+</g>
+</svg>