@soddong/agentic-domain-artifact-standard 0.11.0

package/.tbls.yml

@@ -0,0 +1,54 @@
+name: agentic-domain-artifact-standard
+desc: Agentic Platform artifact standard domain database.
+
+dsn: ${AGENTIC_DOMAIN_ARTIFACT_STANDARD_SCHEMA_DSN}
+docPath: ${AGENTIC_DOMAIN_ARTIFACT_STANDARD_SCHEMA_DOC_PATH}
+
+format:
+  adjust: true
+  sort: false
+  number: false
+  hideColumnsWithoutValues: true
+
+er:
+  skip: false
+  format: svg
+  comment: true
+  hideDef: true
+  showColumnTypes:
+    related: true
+    primary: true
+  distance: 1
+
+include:
+  - artifact_standard_*
+
+comments:
+  - table: artifact_standard_schema_migrations
+    tableComment: artifact-standard 패키지의 migration 적용 이력을 관리한다.
+  - table: artifact_standard_code_groups
+    tableComment: 코드 그룹을 정의한다.
+  - table: artifact_standard_codes
+    tableComment: 코드 그룹별 코드 값을 정의한다.
+  - table: artifact_standard_standards
+    tableComment: 산출물 표준의 최상위 versioned definition을 관리한다.
+  - table: artifact_standard_components
+    tableComment: 산출물 표준을 구성하는 개념, 서식, 가이드, 예시, LLM 보충 지침 resource를 관리한다.
+  - table: artifact_standard_document_blueprints
+    tableComment: 산출물 문서 구조 기준을 관리한다.
+  - table: artifact_standard_template_slots
+    tableComment: blueprint 내 section, table, figure, diagram 등이 들어갈 slot을 관리한다.
+  - table: artifact_standard_table_schemas
+    tableComment: 산출물 표 단위 schema를 관리한다.
+  - table: artifact_standard_table_column_schemas
+    tableComment: 산출물 표의 column 단위 schema를 관리한다.
+  - table: artifact_standard_figure_policies
+    tableComment: figure 작성/표현 policy를 관리한다.
+  - table: artifact_standard_diagram_policies
+    tableComment: diagram 작성/표현 policy를 관리한다.
+  - table: artifact_standard_validation_rule_sets
+    tableComment: 산출물 표준에 적용할 validation rule set을 관리한다.
+  - table: artifact_standard_validation_rule_set_rules
+    tableComment: validation rule set에 포함된 contract-compatible rule을 관리한다.
+  - table: artifact_standard_source_mappings
+    tableComment: 설계 근거 및 후속 이행 후보 source mapping을 관리한다.

package/CHANGELOG.md

@@ -0,0 +1,94 @@
+# Changelog
+
+## 0.11.0
+
+- Generated Output Link 모델을 추가한다.
+- `artifact_standard_generated_output_links` 테이블을 추가해 산출물 표준 또는 생성 출력물 간 자동 생성 관계를 관리한다.
+- `addGeneratedOutputLink()`, `getGeneratedOutputLinkByCode()`, `listGeneratedOutputLinks()`, `listGeneratedOutputLinksBySource()` Service API를 추가한다.
+- `applyAgenticSeed()` runtime seed apply handler를 추가해 AI-Agent SDLC seed의 `generatedOutputLinks` section을 실제 artifact-standard DB에 적용한다.
+- seed에서 참조하는 source/target artifact standard가 아직 상세 fixture로 제공되지 않은 경우 최소 stub standard를 생성하고 원본 seed payload를 metadata에 보존한다.
+
+## 0.10.1
+
+- `ArtifactStandard` / `artifactStandardCode` 계열 non-breaking alias를 추가한다.
+- `getArtifactStandardInfo()`와 `getArchitectureSpecificationArtifactStandard()`를 제공한다.
+- `getArtifactStandardDocumentProfile()`이 신규 `artifactStandardCode` query와 legacy `artifactStandardPackageCode` query를 모두 지원하게 한다.
+- 문서와 dev-test 예시를 신규 도메인 용어 기준으로 보정한다.
+
+## 0.10.0
+
+- Information Object Definition artifact standard fixture를 추가한다.
+- `seedInformationObjectDefinitionArtifactStandard()`로 `information_object_definition@1.0.0` 표준을 생성할 수 있게 한다.
+- 정보 객체 정의서 main document blueprint, required blueprint nodes, information object table slot, table schema, validation rules를 fixture로 제공한다.
+- 4모듈 통합 검증의 downstream authoring context target profile을 임시 Business Process Definition profile에서 Information Object Definition profile로 교체한다.
+
+## 0.9.0
+
+- Business Process Definition fixture의 `DocumentBlueprint`를 component별로 분리한다.
+- `main_document`, `appendix_l3_process`, `appendix_scenario`, `appendix_l4_detail` component가 각각 별도 blueprint를 참조하게 한다.
+- component별 blueprint 기준으로 `DocumentImportProfile`을 생성하는 dev-test를 보강한다.
+- artifact-standard, methodology, artifact, document 통합 검증에서 L3 appendix document required blueprint node 검증을 추가한다.
+- component별 document structure 기준은 신규 table 없이 `DocumentComponent.blueprintId`를 사용한다.
+
+## 0.8.0
+
+- `ArtifactStandardAggregate` 기반 `DocumentImportProfile` 생성 helper를 추가한다.
+- `createDocumentImportProfileFromArtifactStandardAggregate()`로 blueprint, table schema, validation rule set에서 document profile을 도출할 수 있게 한다.
+- `architecture_specification` 전용 profile provider는 legacy registry fixture로 격하해 하드코딩 분산을 줄인다.
+- artifact-standard, methodology, artifact, document 통합 검증에서 ADoc documentId resource link와 document 구조 검증을 추가한다.
+- Business Process Definition fixture 기준 required blueprint node, required table slot, table schema column 검증을 추가한다.
+
+## 0.7.0
+
+- `DocumentComponent` 모델을 추가해 산출물 본문, 부록, 보조자료 같은 논리 구성 단위를 관리한다.
+- `DocumentComponentRelation` 모델을 추가해 component 간 포함, 상세화, 지원, 참조 관계를 표현한다.
+- `PhysicalStructurePolicy` 모델을 추가해 논리 component 계층과 물리 파일/폴더 구조를 분리한다.
+- Business Process Definition fixture에 본문, L3 부록, 시나리오 부록, L4 상세 부록 예시를 추가한다.
+- validation/component binding target type에 document component, relation, physical policy 대상을 추가한다.
+
+## 0.6.0
+
+- artifact-standard validation target type 후보를 TypeScript type과 SQLite code seed로 추가한다.
+- validation rule 저장 시 artifact-standard validation target type code guard를 적용한다.
+- `ARTIFACT_STANDARD.COMPONENT_BINDING.REQUIRED_ROLE` fixture rule을 추가한다.
+- `TABLE_SCHEMA:l4_processes`에 `PRIMARY_GUIDE` component binding이 있는지 검증하는 대표 rule parameter convention을 추가한다.
+- validation type별 artifact-standard 적용 예시를 결정 문서에 반영한다.
+
+## 0.5.0
+
+- `ArtifactStandardComponentBinding` 모델을 추가한다.
+- `artifact_standard_component_bindings` table을 추가한다.
+- Component와 ArtifactStandard, DocumentBlueprint, BlueprintNode, TemplateSlot, TableSchema 등 target 간 N:M 적용 관계를 표현한다.
+- `ArtifactStandardService`에 `addComponentBinding()`, `listComponentBindings()`, `listComponentBindingsByTarget()` API를 추가한다.
+- Business Process Definition fixture에 전체 산출물 표준 guide binding과 table schema guide binding을 추가한다.
+
+## 0.4.0
+
+- `BlueprintNode` 모델을 추가해 목차/논리 섹션 구조와 `TemplateSlot` 구성요소 요구사항을 분리한다.
+- `artifact_standard_blueprint_nodes` table을 추가한다.
+- `TemplateSlot`이 `blueprint_node_id`로 특정 목차/논리 섹션에 연결될 수 있게 한다.
+- `ArtifactStandardService`에 `addBlueprintNode()`, `listBlueprintNodes()` API를 추가한다.
+- Business Process Definition fixture를 `DocumentBlueprint -> BlueprintNode -> TemplateSlot` 구조로 갱신한다.
+
+## 0.3.0
+
+- SQLite base migration을 추가한다.
+- `artifact_standard_` prefix 기반 table schema를 추가한다.
+- `ArtifactStandardService`와 `ArtifactStandardRepository`를 추가한다.
+- component, blueprint, template slot, table schema, validation rule set, source mapping 생성/조회 API를 추가한다.
+- `getArtifactStandardAggregateByCodeVersion()` aggregate 조회 API를 추가한다.
+- Business Process Definition 축소 fixture helper를 추가한다.
+- `@soddong/agentic-contract-validation`과 정렬되는 validation provider manifest export API를 추가한다.
+- validation rule 저장 시 `@soddong/agentic-contract-validation` code guard를 적용한다.
+
+## 0.2.0
+
+- `DocumentImportProfile` 기반 `getArtifactStandardDocumentProfile()` public API를 추가한다.
+- `architecture_specification@1.0.0` document profile fixture를 추가한다.
+- Architecture Specification template slot placeholder를 추가한다.
+- document profile provider 사용 문서를 추가한다.
+
+## 0.1.0
+
+- Iteration 0 package skeleton을 추가한다.
+- 최소 public package info API를 제공한다.

package/README.md

@@ -0,0 +1,386 @@
+# @soddong/agentic-domain-artifact-standard
+
+`@soddong/agentic-domain-artifact-standard`는 Agentic Platform의 산출물 표준 도메인 패키지입니다.
+
+이 패키지는 산출물 유형별 `Artifact Standard`, 템플릿, 가이드, 예시, Document Blueprint, Blueprint Node, Template Slot, Component Binding, Block/Table Schema, Validation Rule 같은 재사용 가능한 산출물 작성 기준을 소유합니다.
+
+## 용어 기준
+
+`Artifact Standard`는 특정 산출물 유형을 작성, 검토, 검증하기 위한 복합 표준 단위입니다. 템플릿, 가이드, 예시, 문서 blueprint, blueprint node, template slot, component binding, block/table schema, validation rule, LLM 보충 지침을 하나의 표준으로 묶어 관리합니다.
+
+`Package`라는 용어는 npm 배포 단위 또는 repository package를 의미할 때만 사용합니다. 도메인 개념에는 `Artifact Standard Package` 대신 `Artifact Standard`를 사용합니다.
+
+현재 public API에는 호환성을 위해 `getArtifactStandardPackageInfo()`, `artifactStandardPackageCode` 같은 legacy alias도 남아 있습니다. 신규 사용자는 `getArtifactStandardInfo()`, `artifactStandardCode` 계열을 우선 사용합니다.
+
+## Profile 용어 구분
+
+`artifact-standard`에서 사용하는 profile 관련 용어는 다음처럼 구분합니다.
+
+| 용어 | 소유/위치 | 의미 | 현재 상태 |
+| --- | --- | --- | --- |
+| `ArtifactStandardProfile` | `artifact-standard` 후보 모델 | 하나의 산출물 표준 안에서 복수 작성 모드나 tailoring variant를 별도 모델로 관리하는 개념 | 1차 핵심 모델에서 제외 |
+| `DocumentImportProfile` | `@soddong/agentic-domain-document` contract | document importer가 산출물 표준의 blueprint, TOC, caption, table/figure/diagram 기준을 적용할 수 있게 받는 입력 profile | 제공/연계 |
+| `ValidationProfile` | `@soddong/agentic-contract-validation` contract | validation rule bundle/provider profile | provider manifest로 export |
+
+따라서 `artifact-standard`가 `DocumentImportProfile`과 validation provider profile을 제공한다고 해서 `ArtifactStandardProfile` DB 모델을 도입한 것은 아닙니다.
+
+## 현재 범위
+
+Iteration 0에서는 패키지 skeleton과 Continuous Publish/Delivery 기반을 제공했습니다. 현재는 1차 보강으로 `@soddong/agentic-domain-document`의 `DocumentImportProfile` contract와 정렬되는 profile provider, SQLite 기반 artifact-standard repository/service, Business Process Definition fixture, Information Object Definition fixture, validation provider manifest export, Generated Output Link, runtime seed apply handler를 제공합니다. 0.10.0에서는 후행 산출물 작성 context 검증을 위해 `information_object_definition@1.0.0` 표준 fixture를 추가했고, 0.10.1에서는 `ArtifactStandard` / `artifactStandardCode` 계열 호환 alias를 추가했습니다. 0.11.0에서는 AI-Agent SDLC seed의 `generatedOutputLinks` section을 artifact-standard DB에 적용할 수 있게 했습니다. Validator 실행 engine은 `@soddong/agentic-capability-validation` 책임이며, `artifact-standard`는 검증 기준을 contract-compatible manifest로 제공하는 데 집중합니다.
+
+| 구분 | 상태 |
+| --- | --- |
+| 패키지 skeleton | 포함 |
+| 기본 문서 | 포함 |
+| build/typecheck | 포함 |
+| 최소 public API | 포함 |
+| Architecture Specification DocumentImportProfile fixture | 포함 |
+| Blueprint node model | 포함 |
+| Template slot model | 포함 |
+| Component binding model | 포함 |
+| Document component model | 포함 |
+| Document component relation model | 포함 |
+| Physical structure policy model | 포함 |
+| Artifact Standard DB migration | 포함 |
+| Repository/Service | 포함 |
+| Aggregate 조회 API | 포함 |
+| Business Process Definition fixture helper | 포함 |
+| Information Object Definition fixture helper | 포함 |
+| Aggregate 기반 DocumentImportProfile 생성 helper | 포함 |
+| Generated Output Link model | 포함 |
+| Runtime Seed Apply Handler | `generatedOutputLinks` section 처리 |
+| Validation rule set contract export | 포함 |
+| Validation contract code guard | 포함 |
+| Validator 실행 engine | 제외: `@soddong/agentic-capability-validation` 책임 |
+| Seed/Fixture | 포함 |
+| Agent contribution | 후속 iteration |
+| CLI | 1차 구현 제외 |
+| Adapter | 1차 구현 제외 |
+
+## 도메인 책임
+
+```text
+@soddong/agentic-domain-artifact-standard
+  - Artifact Standard
+  - Artifact Type
+  - Concept Document reference
+  - Template Document reference
+  - Guide Document reference
+  - Example Document reference
+  - Component Binding
+  - Document Component
+  - Document Component Relation
+  - Physical Structure Policy
+  - Document Blueprint
+  - Blueprint Node
+  - Template Slot
+  - Block/Table Schema
+  - Validation Rule reference
+  - Generated Output Link
+  - Input/Output Contract
+  - Handoff Criteria
+```
+
+## 제외 범위
+
+| 제외 항목 | 담당 후보 |
+| --- | --- |
+| 실제 산출물 instance | `@soddong/agentic-domain-artifact` |
+| Document 저장 구조 | `@soddong/agentic-domain-document` |
+| Methodology Activity/Stage 요구 관계 | `@soddong/agentic-domain-methodology` |
+| Validation contract | `@soddong/agentic-contract-validation` |
+| 검증 실행 엔진 | `@soddong/agentic-capability-validation` |
+| Render 실행 | `@soddong/agentic-capability-render` |
+
+## 기본 API 예시
+
+현재 API는 이전 호환성을 유지합니다. 도메인 용어 기준은 `Artifact Standard`이며, 신규 호출은 `artifactStandardCode`를 사용합니다.
+
+```ts
+import {
+  createDocumentImportProfileFromArtifactStandardAggregate,
+  getArtifactStandardDocumentProfile,
+  getArtifactStandardInfo
+} from "@soddong/agentic-domain-artifact-standard";
+
+console.log(getArtifactStandardInfo());
+
+const profile = getArtifactStandardDocumentProfile({
+  artifactStandardCode: "architecture_specification"
+});
+
+console.log(profile.profileCode);
+```
+
+## Document Profile Provider
+
+`@soddong/agentic-domain-artifact-standard`는 document DB를 직접 조작하지 않습니다. 산출물 표준 관점에서 문서 유형별 profile을 제공하고, consumer 또는 integration layer가 이 profile을 `@soddong/agentic-domain-document` importer에 전달합니다.
+
+```text
+artifact-standard
+  -> getArtifactStandardDocumentProfile()
+  -> DocumentImportProfile
+  -> document importer
+```
+
+`getArtifactStandardDocumentProfile()`은 호환성을 위해 유지되는 legacy fixture provider입니다. 신규 산출물 표준은 DB aggregate에서 document profile을 도출하는 방식을 우선 사용합니다.
+
+```ts
+const aggregate = service.getArtifactStandardAggregateByCodeVersion(
+  "business_process_definition",
+  "1.0.0"
+);
+
+if (aggregate !== undefined) {
+  const profile = createDocumentImportProfileFromArtifactStandardAggregate(aggregate);
+  console.log(profile.profileCode);
+}
+```
+
+현재 legacy fixture로 제공되는 profile은 `architecture_specification@1.0.0`입니다.
+
+| 항목 | 값 |
+| --- | --- |
+| profile code | `architecture_specification` |
+| document type | `architecture_specification` |
+| taxonomy code | `architecture_specification` |
+| TOC level limit | `4` |
+| caption policy | `표`, `Table`, `그림`, `Figure` caption binding |
+| table/figure caption | required policy |
+
+## SQLite Repository / Service
+
+`@soddong/agentic-domain-artifact-standard`는 SQLite에서 `artifact_standard_` prefix table을 사용합니다.
+
+```ts
+import {
+  ArtifactStandardService,
+  openArtifactStandardDatabase
+} from "@soddong/agentic-domain-artifact-standard";
+
+const db = openArtifactStandardDatabase();
+const service = new ArtifactStandardService(db);
+
+const standard = service.createArtifactStandard({
+  artifactStandardCode: "business_process_definition",
+  artifactStandardVersion: "1.0.0",
+  artifactStandardName: "Business Process Definition"
+});
+```
+
+Validation rule set은 `@soddong/agentic-contract-validation`과 정렬되는 provider manifest로 export할 수 있습니다.
+
+```ts
+const manifest = service.exportValidationProviderManifest(standard.artifactStandardId);
+console.log(manifest.profiles);
+```
+
+여러 하위 구성을 한 번에 조회해야 하면 aggregate API를 사용합니다.
+
+```ts
+const aggregate = service.getArtifactStandardAggregateByCodeVersion(
+  "business_process_definition",
+  "1.0.0"
+);
+
+console.log(aggregate?.components);
+console.log(aggregate?.componentBindings);
+console.log(aggregate?.blueprints[0]?.blueprintNodes);
+console.log(aggregate?.blueprints[0]?.templateSlots);
+console.log(aggregate?.documentComponents);
+console.log(aggregate?.documentComponentRelations);
+console.log(aggregate?.physicalStructurePolicies);
+console.log(aggregate?.tableSchemas[0]?.columns);
+console.log(aggregate?.validationRuleSets[0]?.rules);
+```
+
+## Generated Output Link
+
+Generated Output Link는 산출물 표준을 기준으로 후속 산출물 또는 코드/파일 같은 생성 출력물을 만들 수 있다는 관계를 정의합니다.
+
+예를 들어 AI-Agent SDLC Build Planning seed에서는 다음 관계를 표현합니다.
+
+```text
+컴포넌트 모듈 구조 정의서
+  -> 컴포넌트 모듈 구조 설계서
+
+컴포넌트 모듈 구조 설계서
+  -> 컴포넌트, 서브컴포넌트, 비즈니스 모듈 생성
+```
+
+첫 번째는 target이 다른 Artifact Standard이고, 두 번째는 target이 산출물 문서가 아니라 생성 출력물입니다.
+
+```ts
+const source = service.createArtifactStandard({
+  artifactStandardCode: "component_module_structure_design",
+  artifactStandardVersion: "1.0.0",
+  artifactStandardName: "컴포넌트 모듈 구조 설계서"
+});
+
+service.addGeneratedOutputLink({
+  linkCode: "gen_module_structure_design_to_modules",
+  sourceArtifactStandardId: source.artifactStandardId,
+  sourceArtifactStandardCode: source.artifactStandardCode,
+  sourceArtifactStandardVersion: source.artifactStandardVersion,
+  targetTypeCode: "GENERATED_OUTPUT",
+  targetOutputName: "컴포넌트, 서브컴포넌트, 비즈니스 모듈 생성",
+  generationModeCode: "AUTOMATIC",
+  sortOrder: 20
+});
+```
+
+`applyAgenticSeed()`는 `@soddong/agentic-runtime seed apply`에서 `generatedOutputLinks` section을 전달받아 이 모델에 저장합니다. seed에 등장한 source 또는 target artifact standard의 상세 구조가 아직 없으면 최소 stub standard를 생성하고, 원본 seed payload는 metadata에 보존합니다.
+
+## Document Component와 Physical Structure Policy
+
+`DocumentComponent`는 산출물 표준에서 본문, 부록, 보조자료 같은 문서 구성 단위를 정의합니다. 이는 guide, format, example 같은 resource component와 다릅니다.
+
+`DocumentComponent.blueprintId`는 해당 component가 따라야 하는 document structure 기준을 가리킵니다. 본문과 부록이 같은 문서 저장 모델을 사용하더라도, 실제 목차와 필수 block 구조는 component별 blueprint로 다르게 정의할 수 있습니다.
+
+예를 들어 Business Process Definition은 다음처럼 논리적으로 계층화할 수 있습니다.
+
+```text
+main_document
+  appendix_l3_process
+    appendix_scenario
+      appendix_l4_detail
+```
+
+Business Process Definition fixture는 다음처럼 component별 blueprint를 분리합니다.
+
+| document component | blueprint |
+| --- | --- |
+| `main_document` | `main_document` |
+| `appendix_l3_process` | `l3_process_appendix` |
+| `appendix_scenario` | `scenario_appendix` |
+| `appendix_l4_detail` | `l4_detail_appendix` |
+
+이 논리 구조는 `parentDocumentComponentId`와 `DocumentComponentRelation`으로 관리합니다. 반면 실제 파일 위치는 `PhysicalStructurePolicy`가 결정합니다.
+
+```ts
+const main = service.addDocumentComponent({
+  artifactStandardId: standard.artifactStandardId,
+  documentComponentCode: "main_document",
+  documentComponentName: "Business Process Definition Main Document",
+  componentRoleCode: "MAIN",
+  componentTypeCode: "MAIN_DOCUMENT",
+  logicalLevel: 0
+});
+
+const appendix = service.addDocumentComponent({
+  artifactStandardId: standard.artifactStandardId,
+  parentDocumentComponentId: main.documentComponentId,
+  documentComponentCode: "appendix_l3_process",
+  documentComponentName: "L3 Process Appendix",
+  componentRoleCode: "APPENDIX",
+  componentTypeCode: "L3_PROCESS_APPENDIX",
+  logicalLevel: 1,
+  isRepeatable: true
+});
+
+service.addDocumentComponentRelation({
+  artifactStandardId: standard.artifactStandardId,
+  sourceDocumentComponentId: main.documentComponentId,
+  targetDocumentComponentId: appendix.documentComponentId,
+  relationTypeCode: "CONTAINS",
+  isRequired: true
+});
+
+service.addPhysicalStructurePolicy({
+  artifactStandardId: standard.artifactStandardId,
+  policyCode: "grouped_by_parent",
+  policyName: "Group Appendix Documents By Parent Component",
+  strategyCode: "GROUPED_BY_PARENT",
+  relationSourceCode: "DB",
+  pathPattern: "business-process-definition/{parentComponentCode}/{documentComponentCode}.md",
+  isDefault: true
+});
+```
+
+이 구조의 목적은 논리 구조는 계층으로 유지하되, 물리 구조는 표준 정의에 따라 계층형 폴더, level별 그룹, parent별 그룹, manifest 기반 단일 폴더 중 선택할 수 있게 하는 것입니다.
+
+## Methodology 연결 기준
+
+`artifact-standard`는 산출물 내부 구조를 정의하고, `methodology`는 어떤 Stage/Activity에서 어떤 산출물 표준과 document component를 입력/출력으로 요구하는지 정의합니다.
+
+비즈니스 프로세스 정의서 예시는 다음 기준으로 해석합니다.
+
+```text
+Planning Phase
+  - 컴포넌트 비즈니스 프로세스 정의 Stage
+    - 비즈니스 프로세스 정의서 본문 작성 Activity
+    - L3 프로세스 부록 작성 Activity
+    - 시나리오 부록 작성 Activity
+    - L4 상세 부록 작성 Activity
+    - 본문/부록 종합 및 정제 Activity
+  - 컴포넌트 정보 객체 정의 Stage
+    - 선행 비즈니스 프로세스 정의서 묶음을 handoff 입력으로 사용
+```
+
+작성 절차의 세부 작업은 `Step`으로 볼 수 있지만, 현재 MVP에서는 Step 실행까지 시스템화하지 않습니다. Stage 안에서 산출물 또는 document component 단위 산출물을 생산해야 하면 Activity output으로 표현하고, 실제 산출물 instance와 ADoc document 연결은 `@soddong/agentic-domain-artifact`와 `@soddong/agentic-domain-document` 조립 책임으로 둡니다.
+
+Component binding은 guide, example, LLM supplement 같은 component를 특정 구조 요소에 연결합니다.
+
+```ts
+const bindings = service.listComponentBindingsByTarget(
+  aggregate.standard.artifactStandardId,
+  "TABLE_SCHEMA",
+  "l4_processes"
+);
+
+console.log(bindings[0]?.bindingRoleCode);
+```
+
+Validation rule set rule의 `validationTypeCode`, `executionModeCode`, `severityCode`는 `@soddong/agentic-contract-validation`의 code guard로 검증됩니다.
+
+`appliesToTypeCode`는 `@soddong/agentic-contract-validation`에서는 domain-neutral string이지만, `artifact-standard`는 자기 domain target type을 별도로 관리합니다.
+
+1차 validation target type 후보:
+
+```text
+ARTIFACT_STANDARD
+DOCUMENT_BLUEPRINT
+BLUEPRINT_NODE
+TEMPLATE_SLOT
+TABLE_SCHEMA
+TABLE_COLUMN_SCHEMA
+FIGURE_POLICY
+DIAGRAM_POLICY
+COMPONENT
+COMPONENT_BINDING
+VALIDATION_RULE_SET
+DOCUMENT_COMPONENT
+DOCUMENT_COMPONENT_RELATION
+PHYSICAL_STRUCTURE_POLICY
+```
+
+대표 parameter convention:
+
+```json
+{
+  "requiredColumns": ["sequence_no", "process_id"],
+  "requiredBindingRoleCodes": ["PRIMARY_GUIDE"]
+}
+```
+
+예를 들어 `TABLE_SCHEMA:l4_processes`에 `PRIMARY_GUIDE` binding이 필요한지는 다음 rule로 표현합니다.
+
+```text
+ruleId: ARTIFACT_STANDARD.COMPONENT_BINDING.REQUIRED_ROLE
+appliesToTypeCode: TABLE_SCHEMA
+appliesToRef: l4_processes
+parameters.requiredBindingRoleCodes: [PRIMARY_GUIDE]
+```
+
+## Fixture Helper
+
+사용성 테스트와 integration test를 위해 축소 fixture helper를 제공합니다.
+
+```ts
+import { seedBusinessProcessDefinitionArtifactStandard } from "@soddong/agentic-domain-artifact-standard";
+
+const fixture = seedBusinessProcessDefinitionArtifactStandard(service);
+console.log(fixture.aggregate.standard.artifactStandardCode);
+```
+
+fixture는 실제 참조 데이터 이행이 아니라 대표 사용 사례 검증용 축소 샘플입니다.

package/dist/database.d.ts

@@ -0,0 +1,8 @@
+import Database from "better-sqlite3";
+import type { ArtifactStandardDatabaseInitResult, ArtifactStandardDatabaseOptions } from "./types.js";
+export declare function resolveArtifactStandardDatabasePath(options?: ArtifactStandardDatabaseOptions): string;
+export declare function listArtifactStandardTables(db: Database.Database): string[];
+export declare function applyArtifactStandardBaseMigration(db: Database.Database): void;
+export declare function openArtifactStandardDatabase(options?: ArtifactStandardDatabaseOptions): Database.Database;
+export declare function initializeArtifactStandardDatabase(options?: ArtifactStandardDatabaseOptions): ArtifactStandardDatabaseInitResult;
+//# sourceMappingURL=database.d.ts.map

package/dist/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,OAAO,KAAK,EAAE,kCAAkC,EAAE,+BAA+B,EAAE,MAAM,YAAY,CAAC;AAuBtG,wBAAgB,mCAAmC,CAAC,OAAO,GAAE,+BAAoC,GAAG,MAAM,CAiBzG;AAOD,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,EAAE,CAY1E;AAED,wBAAgB,kCAAkC,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAE9E;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,+BAAoC,GAC5C,QAAQ,CAAC,QAAQ,CAkBnB;AAED,wBAAgB,kCAAkC,CAChD,OAAO,GAAE,+BAAoC,GAC5C,kCAAkC,CAcpC"}

package/dist/database.js

@@ -0,0 +1,76 @@
+import Database from "better-sqlite3";
+import { existsSync, mkdirSync, readFileSync } from "node:fs";
+import { dirname, isAbsolute, join } from "node:path";
+const DEFAULT_DATABASE_PATH = ".agentic/platform.sqlite";
+function readProjectConfig(projectRoot) {
+    const configPath = join(projectRoot, "agentic.config.json");
+    if (!existsSync(configPath)) {
+        return {};
+    }
+    return JSON.parse(readFileSync(configPath, "utf8"));
+}
+export function resolveArtifactStandardDatabasePath(options = {}) {
+    if (options.databasePath !== undefined) {
+        return isAbsolute(options.databasePath)
+            ? options.databasePath
+            : join(options.projectRoot ?? process.cwd(), options.databasePath);
+    }
+    const projectRoot = options.projectRoot ?? process.cwd();
+    const config = readProjectConfig(projectRoot);
+    const database = config.runtime?.database;
+    if (database?.type !== undefined && database.type !== "sqlite") {
+        throw new Error(`Unsupported artifact-standard database type: ${database.type}`);
+    }
+    const configuredPath = database?.path ?? DEFAULT_DATABASE_PATH;
+    return isAbsolute(configuredPath) ? configuredPath : join(projectRoot, configuredPath);
+}
+function readArtifactStandardBaseMigration() {
+    const migrationUrl = new URL("../src/database/migrations/0001_artifact_standard_base.sql", import.meta.url);
+    return readFileSync(migrationUrl, "utf8");
+}
+export function listArtifactStandardTables(db) {
+    const rows = db
+        .prepare(`SELECT name
+         FROM sqlite_master
+        WHERE type = 'table'
+          AND name LIKE 'artifact_standard_%'
+        ORDER BY name`)
+        .all();
+    return rows.map((row) => row.name);
+}
+export function applyArtifactStandardBaseMigration(db) {
+    db.exec(readArtifactStandardBaseMigration());
+}
+export function openArtifactStandardDatabase(options = {}) {
+    const databasePath = resolveArtifactStandardDatabasePath(options);
+    mkdirSync(dirname(databasePath), { recursive: true });
+    const db = new Database(databasePath);
+    try {
+        db.pragma("journal_mode = WAL");
+        db.pragma("foreign_keys = ON");
+        if (options.applyMigration !== false) {
+            applyArtifactStandardBaseMigration(db);
+        }
+        return db;
+    }
+    catch (error) {
+        db.close();
+        throw error;
+    }
+}
+export function initializeArtifactStandardDatabase(options = {}) {
+    const databasePath = resolveArtifactStandardDatabasePath(options);
+    const created = !existsSync(databasePath);
+    const db = openArtifactStandardDatabase(options);
+    try {
+        return {
+            databasePath,
+            created,
+            tables: listArtifactStandardTables(db)
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=database.js.map

package/dist/database.js.map

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

package/dist/fixtures.d.ts

@@ -0,0 +1,11 @@
+import type { ArtifactStandardService } from "./service.js";
+import type { ArtifactStandardAggregate } from "./types.js";
+export interface BusinessProcessDefinitionFixtureResult {
+    readonly aggregate: ArtifactStandardAggregate;
+}
+export interface InformationObjectDefinitionFixtureResult {
+    readonly aggregate: ArtifactStandardAggregate;
+}
+export declare function seedBusinessProcessDefinitionArtifactStandard(service: ArtifactStandardService): BusinessProcessDefinitionFixtureResult;
+export declare function seedInformationObjectDefinitionArtifactStandard(service: ArtifactStandardService): InformationObjectDefinitionFixtureResult;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE5D,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;CAC/C;AAED,MAAM,WAAW,wCAAwC;IACvD,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;CAC/C;AAED,wBAAgB,6CAA6C,CAC3D,OAAO,EAAE,uBAAuB,GAC/B,sCAAsC,CAkZxC;AAED,wBAAgB,+CAA+C,CAC7D,OAAO,EAAE,uBAAuB,GAC/B,wCAAwC,CAsM1C"}