@soddong/agentic-domain-configuration

@soddong/agentic-domain-configuration는 Agentic Platform에서 형상관리 대상(Configuration Item) 기준정보를 표현하기 위한 domain package다.

이 패키지의 configuration은 runtime 설정값이 아니라 시스템 구성요소와 형상관리 대상 기준정보를 의미한다.

현재 범위

| 구분 | 상태 | | --- | --- | | package skeleton | 제공 | | TypeScript type model | 제공 | | logical model document | 제공 | | DB schema/migration | 제공 | | repository/service | 제공 | | seed apply handler | 제공: Definition Layer, Instance Layer | | Workbench UI | 후속 |

책임

| 책임 | 설명 | | --- | --- | | 코드 그룹/코드 | viewpoint, status, relation type 같은 동적 기준 코드 구조 | | Configuration Item 유형 | Domain, Component, Business, Function 같은 형상관리 대상 유형 구조 | | Configuration Item Type 표시명 | 한글명, 영문명, 약어 | | Configuration Item 식별 | UUID itemId 기본키와 사람이 추적 가능한 managedCode 분리 | | Configuration Item 표시명 | 한글명, 영문명, 약어 | | Configuration Item 계층 | Type 계층과 Item 계층 | | Configuration Item 관계 | 계층과 분리된 의존, 실현, 구현, 노출, 검증 관계 | | Configuration Baseline | 특정 시점에 기준선화된 형상관리 대상 묶음 | | Configuration Version 관리 | Viewpoint 구조 버전, instance data version, item version, baseline version의 의미 분리 |

비책임

| 제외 항목 | 담당 | | --- | --- | | Lifecycle, Phase, Stage, Activity, Task 정의 | @soddong/agentic-domain-methodology | | 산출물 표준 서식 | @soddong/agentic-domain-artifact-standard | | 실제 산출물 인스턴스 | @soddong/agentic-domain-artifact | | 문서 본문 구조 | @soddong/agentic-domain-document | | runtime 설정값 | @soddong/agentic-runtime | | Activity/Task 대상 지정 | 후속 methodology 연계 설계 | | 산출물/산출물 구성요소 대상 지정 | 후속 artifact-standard/artifact 연계 설계 |

기본 API

import {
  ConfigurationService,
  getConfigurationPackageInfo,
  initializeConfigurationDatabase
} from "@soddong/agentic-domain-configuration";

console.log(getConfigurationPackageInfo());

const db = initializeConfigurationDatabase({ projectRoot: process.cwd() });
console.log(db.tables);

Service Layer

ConfigurationService는 definition layer와 instance layer를 분리한다.

| Service | 책임 | | --- | --- | | service.definition | code group, code, identity rule, item type 관리 | | service.instance | item, item relation, baseline 관리 |

Seed Scope

이 패키지는 seed 데이터를 소유하지 않는다. Definition Layer와 Instance Layer를 적용하는 seed apply handler만 제공한다. SSF 같은 실제 기준정보 인스턴스는 특정 방법론 bundle, 예를 들어 @soddong/agentic-methodology-ai-agent-sdlc seed가 소유한다.

| Section | 지원 | | --- | --- | | configuration_code_groups | 지원 | | configuration_codes | 지원 | | configuration_identity_rules | 지원 | | configuration_item_types | 지원 | | configuration_items | 지원 | | configuration_item_relations | 지원 | | configuration_baselines | 지원 |

Version Management

Configuration 기준정보는 구조 버전과 데이터 버전을 분리한다.

| 버전 축 | 의미 | 예시 | | --- | --- | --- | | Viewpoint Version | SSF 같은 관점의 계층 구조 버전 | ssf:v1, ssf:v2 | | Instance Data Version | 특정 Viewpoint Version 기준 최종 기준정보 인스턴스 묶음 | [email protected] | | Item Version | 개별 Configuration Item 변경 버전 | 1.0.0 | | Baseline Version | 특정 item version 집합의 기준선 버전 | 2026.07.09 |

SSF v1은 L1~L5 구조이고, SSF v2는 L2와 L3 사이에 L2.5 Sub Component를 추가한 구조다. SSF v2는 SSF v1을 덮어쓰지 않고 별도 Viewpoint Version과 Baseline으로 관리한다.

검토 과정별 중간본은 Instance Data Version으로 등록하지 않는다. 기준정보로 적재할 최종본만 Baseline으로 등록하며, 인스턴스 버전의 타이틀, 변경 요약, 변경내역 상세 Markdown 참조를 함께 관리한다.

자세한 기준은 docs/version-management.md를 참고한다.