agentic-capability-validation

agentic-capability-validation은 Agentic Platform의 공통 검증 capability 패키지입니다.

이 패키지는 Agentic Platform 패키지들이 검증 결과를 같은 형식으로 반환하도록 공통 validation result model과 helper를 제공합니다.

현재 범위

현재는 패키지 skeleton, Continuous Publish/Delivery 기반, 공통 validation result model, 최소 helper, agentic-contract-validation 기반 manifest registry와 rule handler runner를 제공합니다. DB 저장, report rendering, CLI 연동은 후속 iteration에서 구체화합니다.

| 구분 | 상태 | | --- | --- | | 패키지 skeleton | 포함 | | 기본 문서 | 포함 | | build/typecheck | 포함 | | 최소 public API | 포함 | | Result model | 포함 | | Result helper | 포함 | | Validation engine | 포함 | | Rule handler registry | 포함 | | Provider manifest registry | 포함 | | Rule/Profile schema | agentic-contract-validation 사용 | | Domain 연동 | provider manifest 기준 포함 | | Result persistence | 후속 iteration | | Report rendering | 후속 iteration | | CLI | 1차 구현 제외 | | Adapter | 1차 구현 제외 |

책임

agentic-capability-validation
  - validation profile execution
  - methodology requirement validation
  - artifact standard rule validation
  - project state validation
  - validation issue/result formatting
  - validation provider manifest registration
  - validation rule handler execution

비책임

| 제외 항목 | 담당 후보 | | --- | --- | | 방법론 seed data | agentic-domain-sdlc | | 방법론 메타모델 | agentic-domain-methodology | | 산출물 표준 본문 | agentic-domain-artifact-standard | | 실제 산출물 instance | agentic-domain-artifact | | validation contract | agentic-contract-validation | | Render 실행 | agentic-capability-render |

기본 API 예시

import {
  createValidationIssue,
  createValidationResult,
  getValidationCapabilityPackageInfo,
  summarizeValidationResult
} from "agentic-capability-validation";

console.log(getValidationCapabilityPackageInfo());

const result = createValidationResult([
  createValidationIssue({
    severity: "error",
    ruleId: "METHODOLOGY.STAGE_ACTIVITY.SAME_PROCESS",
    targetType: "stage_activity",
    message: "Stage와 Activity는 같은 Process에 속해야 합니다."
  })
]);

console.log(summarizeValidationResult(result));

Manifest 실행 예시

import { ValidationEngine } from "agentic-capability-validation";

const engine = new ValidationEngine();

engine.registerValidationProviderManifest(manifest);
engine.registerRuleHandler({
  ruleId: "ARTIFACT_STANDARD.TABLE.REQUIRED_COLUMNS",
  handler: ({ rule, context }) => {
    // rule.parameters와 context.target을 사용해 검증하고 issue 배열을 반환한다.
    return [];
  }
});

const result = engine.runValidationProfile("business_process_definition.default", {
  target: ["sequence_no", "process_id", "process_name", "purpose"]
});

console.log(result.valid);