@soddong/agentic-contract-validation 0.2.0

package/dist/seed-apply.d.ts

@@ -0,0 +1,22 @@
+export interface AgenticSeedApplyInput {
+    readonly projectRoot?: string;
+    readonly databasePath?: string;
+    readonly sourcePackageName: string;
+    readonly sourcePackageVersion: string;
+    readonly bundleCode: string;
+    readonly bundleVersion: string;
+    readonly methodologyCode?: string;
+    readonly sourceSection: string;
+    readonly targetOperation: string;
+    readonly itemKey?: string;
+    readonly itemPayload?: unknown;
+    readonly mode: "apply";
+}
+export interface AgenticSeedApplyResult {
+    readonly status: "applied" | "skipped" | "blocked" | "failed";
+    readonly targetRefs?: readonly string[];
+    readonly message?: string;
+    readonly diagnostics?: readonly unknown[];
+}
+export declare function applyAgenticSeed(input: AgenticSeedApplyInput): Promise<AgenticSeedApplyResult>;
+//# sourceMappingURL=seed-apply.d.ts.map

package/dist/seed-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-apply.d.ts","sourceRoot":"","sources":["../src/seed-apply.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC3C;AAgND,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAuCpG"}

package/dist/seed-apply.js

@@ -0,0 +1,198 @@
+import { openValidationContractDatabase } from "./database.js";
+import { ValidationContractRegistry } from "./registry.js";
+const supportedValidationTypes = new Set([
+    "STRUCTURE",
+    "SCHEMA",
+    "REFERENCE_INTEGRITY",
+    "POLICY",
+    "CONTENT_RULE",
+    "QUALITY_CHECKLIST",
+    "RUBRIC",
+    "EXAMPLE_BASED_REVIEW"
+]);
+const supportedExecutionModes = new Set(["AUTOMATED", "HUMAN_REVIEW", "LLM_EVALUATION", "HYBRID"]);
+const supportedSeverityCodes = new Set(["ERROR", "WARNING", "INFO"]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function asArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter(isRecord);
+}
+function stringValue(value, key) {
+    const raw = value[key];
+    return typeof raw === "string" && raw.length > 0 ? raw : undefined;
+}
+function objectValue(value, key) {
+    const raw = value[key];
+    return isRecord(raw) ? raw : undefined;
+}
+function sourceMetadata(input, payload) {
+    return {
+        seedSourcePackageName: input.sourcePackageName,
+        seedSourcePackageVersion: input.sourcePackageVersion,
+        seedBundleCode: input.bundleCode,
+        seedBundleVersion: input.bundleVersion,
+        seedSourceSection: input.sourceSection,
+        seedTargetOperation: input.targetOperation,
+        seedItemKey: input.itemKey,
+        seedPayload: payload
+    };
+}
+function normalizeValidationTypeCode(value) {
+    if (value === undefined) {
+        return {};
+    }
+    if (supportedValidationTypes.has(value)) {
+        return { value: value };
+    }
+    switch (value) {
+        case "NAMING":
+            return { value: "POLICY", originalValue: value };
+        case "REFERENCE":
+            return { value: "REFERENCE_INTEGRITY", originalValue: value };
+        default:
+            return { originalValue: value };
+    }
+}
+function normalizeExecutionModeCode(value) {
+    return value !== undefined && supportedExecutionModes.has(value) ? value : undefined;
+}
+function normalizeSeverityCode(value) {
+    return value !== undefined && supportedSeverityCodes.has(value) ? value : undefined;
+}
+function mergeMetadata(input, payload, existing, extra) {
+    return {
+        ...existing,
+        ...extra,
+        ...sourceMetadata(input, payload)
+    };
+}
+function normalizeRule(input, profilePayload, rulePayload) {
+    const ruleId = stringValue(rulePayload, "ruleId");
+    const validationType = normalizeValidationTypeCode(stringValue(rulePayload, "validationTypeCode"));
+    const executionModeCode = normalizeExecutionModeCode(stringValue(rulePayload, "executionModeCode"));
+    const severityCode = normalizeSeverityCode(stringValue(rulePayload, "severityCode"));
+    const appliesToTypeCode = stringValue(rulePayload, "appliesToTypeCode");
+    const message = stringValue(rulePayload, "message");
+    const providerModule = stringValue(rulePayload, "providerModule") ?? stringValue(profilePayload, "providerModule");
+    if (ruleId === undefined ||
+        providerModule === undefined ||
+        validationType.value === undefined ||
+        executionModeCode === undefined ||
+        severityCode === undefined ||
+        appliesToTypeCode === undefined ||
+        message === undefined) {
+        throw new Error(`Invalid validation rule seed payload: ${ruleId ?? "(missing ruleId)"}`);
+    }
+    return {
+        ruleId,
+        providerModule,
+        validationTypeCode: validationType.value,
+        executionModeCode,
+        severityCode,
+        appliesToTypeCode,
+        appliesToRef: stringValue(rulePayload, "appliesToRef"),
+        sourceComponentRef: stringValue(rulePayload, "sourceComponentRef"),
+        parameters: objectValue(rulePayload, "parameters"),
+        message,
+        remediation: stringValue(rulePayload, "remediation"),
+        metadata: mergeMetadata(input, rulePayload, objectValue(rulePayload, "metadata"), validationType.originalValue === undefined
+            ? undefined
+            : {
+                originalValidationTypeCode: validationType.originalValue,
+                normalizedValidationTypeCode: validationType.value
+            })
+    };
+}
+function normalizeProfile(input, payload) {
+    const profileId = stringValue(payload, "profileId");
+    const providerModule = stringValue(payload, "providerModule");
+    const targetDomain = stringValue(payload, "targetDomain");
+    const rules = asArray(payload.rules);
+    if (profileId === undefined || providerModule === undefined || targetDomain === undefined || rules.length === 0) {
+        throw new Error(`Invalid validation profile seed payload: ${profileId ?? "(missing profileId)"}`);
+    }
+    return {
+        profileId,
+        providerModule,
+        targetDomain,
+        rules: rules.map((rule) => normalizeRule(input, payload, rule)),
+        metadata: mergeMetadata(input, payload, objectValue(payload, "metadata"))
+    };
+}
+function applied(targetRefs, skippedCount) {
+    if (targetRefs.length === 0 && skippedCount > 0) {
+        return {
+            status: "skipped",
+            message: `All ${skippedCount} validation profile seed item(s) already exist.`
+        };
+    }
+    return {
+        status: "applied",
+        targetRefs,
+        message: skippedCount > 0 ? `${skippedCount} validation profile seed item(s) already existed.` : undefined
+    };
+}
+function applyValidationProfiles(ctx) {
+    const targetRefs = [];
+    let skippedCount = 0;
+    for (const payload of asArray(ctx.input.itemPayload)) {
+        const profile = normalizeProfile(ctx.input, payload);
+        const result = ctx.registry.registerValidationProfile({
+            providerVersion: ctx.input.sourcePackageVersion,
+            profile,
+            metadata: sourceMetadata(ctx.input, payload)
+        });
+        if (result.status === "skipped") {
+            skippedCount += 1;
+        }
+        else {
+            targetRefs.push(`validationProfile:${profile.profileId}`);
+        }
+    }
+    return applied(targetRefs, skippedCount);
+}
+export async function applyAgenticSeed(input) {
+    if (input.mode !== "apply") {
+        return {
+            status: "failed",
+            message: "agentic-contract-validation only supports apply mode."
+        };
+    }
+    const db = openValidationContractDatabase({
+        projectRoot: input.projectRoot,
+        databasePath: input.databasePath
+    });
+    try {
+        const ctx = {
+            input,
+            db,
+            registry: new ValidationContractRegistry(db)
+        };
+        const applyInTransaction = db.transaction(() => {
+            switch (input.sourceSection) {
+                case "validationProfiles":
+                    return applyValidationProfiles(ctx);
+                default:
+                    return {
+                        status: "blocked",
+                        message: `Unsupported validation contract seed section: ${input.sourceSection}`
+                    };
+            }
+        });
+        return applyInTransaction();
+    }
+    catch (error) {
+        return {
+            status: "failed",
+            message: error instanceof Error ? error.message : String(error)
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=seed-apply.js.map

package/dist/seed-apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-apply.js","sourceRoot":"","sources":["../src/seed-apply.ts"],"names":[],"mappings":"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"}

package/docs/build.md

@@ -0,0 +1,25 @@
+# Build
+
+## Build
+
+```bash
+npm run build --workspace @soddong/agentic-contract-validation
+```
+
+## Typecheck
+
+```bash
+npm run typecheck --workspace @soddong/agentic-contract-validation
+```
+
+## Dev Test
+
+```bash
+npm run dev:test:agentic-contract-validation
+```
+
+## Pack Dry Run
+
+```bash
+npm pack --workspace @soddong/agentic-contract-validation --dry-run
+```

package/docs/configuration.md

@@ -0,0 +1,18 @@
+# Configuration
+
+`@soddong/agentic-contract-validation`은 별도 package 전용 configuration을 사용하지 않습니다.
+
+registry DB 경로는 consumer project의 `agentic.config.json` runtime database 설정을 따릅니다.
+
+```json
+{
+  "runtime": {
+    "database": {
+      "type": "sqlite",
+      "path": ".agentic/platform.sqlite"
+    }
+  }
+}
+```
+
+환경별 registry, 인증, delivery 값은 consumer project, `.npmrc`, CI/CD variables에서 제공합니다.

package/docs/delivery.md

@@ -0,0 +1,9 @@
+# Delivery
+
+운영환경 사용자는 npm registry에서 설치합니다.
+
+```bash
+npm install @soddong/agentic-contract-validation
+```
+
+registry 접근이 제한된 환경에서는 구축 담당자가 생성한 tarball을 전달해 설치할 수 있습니다.

package/docs/operations.md

@@ -0,0 +1,7 @@
+# Operations
+
+`@soddong/agentic-contract-validation`은 runtime process, CLI, adapter를 제공하지 않습니다.
+
+`0.2.0`부터 validation provider/profile/rule registry를 SQLite에 저장할 수 있습니다. 기본 DB 경로는 consumer project의 `agentic.config.json` runtime database 설정을 따르며, 설정이 없으면 `.agentic/platform.sqlite`를 사용합니다.
+
+운영 확인 대상은 설치된 package version, public contract API 호환성, `validation_contract_%` table migration 적용 여부입니다.

package/docs/publishing.md

@@ -0,0 +1,11 @@
+# Publishing
+
+`@soddong/agentic-contract-validation`은 package 내부에 registry를 고정하지 않습니다.
+
+공식 registry publish 예시:
+
+```bash
+npm publish --workspace @soddong/agentic-contract-validation --registry=https://registry.npmjs.org/
+```
+
+publish 전에는 build, typecheck, dev-test, consistency check, pack dry-run을 수행합니다.

package/docs/schema/generated/README.md

@@ -0,0 +1,22 @@
+# agentic-contract-validation
+
+## Description
+
+Agentic Platform validation contract registry database.
+
+## Tables
+
+| Name                                                                                | Columns | Comment                                                      | Type  |
+| ----------------------------------------------------------------------------------- | ------- | ------------------------------------------------------------ | ----- |
+| [validation_contract_schema_migrations](validation_contract_schema_migrations.md)   | 3       | validation contract registry migration 적용 이력을 관리한다.          | table |
+| [validation_contract_provider_manifests](validation_contract_provider_manifests.md) | 7       | validation provider manifest를 관리한다.                          | table |
+| [validation_contract_profiles](validation_contract_profiles.md)                     | 8       | provider manifest가 제공하는 validation profile을 관리한다.            | table |
+| [validation_contract_rules](validation_contract_rules.md)                           | 17      | validation profile에 포함된 rule contract를 관리한다.                 | table |
+
+## Relations
+
+![er](schema.svg)
+
+---
+
+> Generated by [tbls](https://github.com/k1LoW/tbls)