@soddong/agentic-contract-validation 0.2.0

package/docs/usage.md

@@ -0,0 +1,55 @@
+# Usage
+
+`@soddong/agentic-contract-validation`은 validation rule과 profile을 정의하는 패키지에서 사용합니다.
+또한 seed bundle의 `validationProfiles` section을 project registry에 적용할 수 있습니다.
+
+```ts
+import { defineValidationRule } from "@soddong/agentic-contract-validation";
+
+const rule = defineValidationRule({
+  ruleId: "DOCUMENT.TABLE.CAPTION_REQUIRED",
+  providerModule: "@soddong/agentic-domain-document",
+  validationTypeCode: "POLICY",
+  executionModeCode: "AUTOMATED",
+  severityCode: "WARNING",
+  appliesToTypeCode: "TABLE_BLOCK",
+  message: "Table caption이 필요합니다."
+});
+```
+
+실제 rule 실행은 `@soddong/agentic-capability-validation` 책임입니다.
+
+## Seed Apply
+
+```ts
+import { applyAgenticSeed } from "@soddong/agentic-contract-validation";
+
+await applyAgenticSeed({
+  sourcePackageName: "@soddong/agentic-methodology-ai-agent-sdlc",
+  sourcePackageVersion: "0.2.0",
+  bundleCode: "ai-agent-sdlc-build-planning",
+  bundleVersion: "0.2.0",
+  sourceSection: "validationProfiles",
+  targetOperation: "register_validation_profiles",
+  mode: "apply",
+  itemPayload: [
+    {
+      profileId: "ai_agent_sdlc.build_planning_seed_structure",
+      providerModule: "@soddong/agentic-methodology-ai-agent-sdlc",
+      targetDomain: "methodology",
+      rules: [
+        {
+          ruleId: "AI_AGENT_SDLC.BUILD_PLANNING.FOUR_STAGES_REQUIRED",
+          validationTypeCode: "STRUCTURE",
+          executionModeCode: "AUTOMATED",
+          severityCode: "ERROR",
+          appliesToTypeCode: "stage_seed",
+          message: "Build Planning seed must contain required stages."
+        }
+      ]
+    }
+  ]
+});
+```
+
+`NAMING`, `REFERENCE` 같은 seed 입력값은 각각 `POLICY`, `REFERENCE_INTEGRITY`로 정규화됩니다.

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@soddong/agentic-contract-validation",
+  "version": "0.2.0",
+  "description": "Agentic Platform shared validation contract package",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src/database/migrations",
+    "README.md",
+    "CHANGELOG.md",
+    "docs"
+  ],
+  "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"
+  }
+}

package/src/database/migrations/0001_validation_contract_registry.sql

@@ -0,0 +1,78 @@
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE IF NOT EXISTS validation_contract_schema_migrations (
+  migration_id VARCHAR(128) PRIMARY KEY,
+  migration_name VARCHAR(256) NOT NULL,
+  applied_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+CREATE TABLE IF NOT EXISTS 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)
+);
+
+CREATE TABLE IF NOT EXISTS 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)
+);
+
+CREATE TABLE IF NOT EXISTS 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)
+);
+
+CREATE INDEX IF NOT EXISTS idx_validation_contract_profiles_provider
+  ON validation_contract_profiles (provider_manifest_id);
+
+CREATE INDEX IF NOT EXISTS idx_validation_contract_profiles_target
+  ON validation_contract_profiles (target_domain);
+
+CREATE INDEX IF NOT EXISTS idx_validation_contract_rules_profile
+  ON validation_contract_rules (validation_profile_id);
+
+INSERT OR IGNORE INTO validation_contract_schema_migrations (migration_id, migration_name)
+VALUES ('0001_validation_contract_registry', 'validation contract registry schema');