agentic-domain-artifact-standard 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 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을 추가한다.

package/README.md

@@ -6,7 +6,7 @@
 
 ## 현재 범위
 
-Iteration 0에서는 패키지 skeleton과 Continuous Publish/Delivery 기반만 제공합니다. DB schema, repository/service/validator, seed, agent contribution은 후속 iteration에서 구체화합니다.
+Iteration 0에서는 패키지 skeleton과 Continuous Publish/Delivery 기반을 제공합니다. 현재는 1차 보강으로 `agentic-domain-document`의 `DocumentImportProfile` contract에 맞춘 산출물 표준 profile fixture를 제공합니다. DB schema, repository/service/validator, seed, agent contribution은 후속 iteration에서 구체화합니다.
 
 | 구분 | 상태 |
 | --- | --- |
@@ -14,6 +14,8 @@ Iteration 0에서는 패키지 skeleton과 Continuous Publish/Delivery 기반만
 | 기본 문서 | 포함 |
 | build/typecheck | 포함 |
 | 최소 public API | 포함 |
+| Architecture Specification DocumentImportProfile fixture | 포함 |
+| Template slot placeholder | 포함 |
 | Artifact Standard DB migration | 후속 iteration |
 | Repository/Service/Validator | 후속 iteration |
 | Seed/Fixture | 후속 iteration |
@@ -51,7 +53,38 @@ agentic-domain-artifact-standard
 ## 기본 API 예시
 
 ```ts
-import { getArtifactStandardPackageInfo } from "agentic-domain-artifact-standard";
+import {
+  getArtifactStandardDocumentProfile,
+  getArtifactStandardPackageInfo
+} from "agentic-domain-artifact-standard";
 
 console.log(getArtifactStandardPackageInfo());
+
+const profile = getArtifactStandardDocumentProfile({
+  artifactStandardPackageCode: "architecture_specification"
+});
+
+console.log(profile.profileCode);
+```
+
+## Document Profile Provider
+
+`agentic-domain-artifact-standard`는 document DB를 직접 조작하지 않습니다. 산출물 표준 관점에서 문서 유형별 profile을 제공하고, consumer 또는 integration layer가 이 profile을 `agentic-domain-document` importer에 전달합니다.
+
+```text
+artifact-standard
+  -> getArtifactStandardDocumentProfile()
+  -> DocumentImportProfile
+  -> document importer
 ```
+
+현재 제공되는 fixture는 `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 |

package/dist/index.d.ts

@@ -1,6 +1,7 @@
+import type { DocumentImportProfile } from "agentic-domain-document";
 export declare const agenticDomainArtifactStandardPackage: {
     readonly name: "agentic-domain-artifact-standard";
-    readonly version: "0.1.0";
+    readonly version: "0.2.0";
     readonly layer: "domain";
     readonly logicalSchema: "artifact_standard";
     readonly sqliteTablePrefix: "artifact_standard_";
@@ -9,12 +10,34 @@ export declare const agenticDomainArtifactStandardPackage: {
 };
 export interface ArtifactStandardPackageInfo {
     readonly name: "agentic-domain-artifact-standard";
-    readonly version: "0.1.0";
+    readonly version: "0.2.0";
     readonly layer: "domain";
     readonly logicalSchema: "artifact_standard";
     readonly sqliteTablePrefix: "artifact_standard_";
     readonly cli: "not-provided";
     readonly adapter: "not-provided";
 }
+export interface ArtifactStandardPackage {
+    readonly packageCode: string;
+    readonly packageVersion: string;
+    readonly name: string;
+    readonly documentTypeCode: string;
+    readonly documentProfileCode: string;
+    readonly templateSlots: readonly ArtifactStandardTemplateSlot[];
+}
+export interface ArtifactStandardTemplateSlot {
+    readonly slotCode: string;
+    readonly name: string;
+    readonly required: boolean;
+    readonly description?: string;
+}
+export interface ArtifactStandardDocumentProfileQuery {
+    readonly artifactStandardPackageCode: string;
+    readonly profileVersion?: string;
+}
+export declare const architectureSpecificationArtifactStandardPackage: ArtifactStandardPackage;
+export declare const ArchitectureSpecificationDocumentProfile: DocumentImportProfile;
 export declare function getArtifactStandardPackageInfo(): ArtifactStandardPackageInfo;
+export declare function getArchitectureSpecificationArtifactStandardPackage(): ArtifactStandardPackage;
+export declare function getArtifactStandardDocumentProfile(query: ArtifactStandardDocumentProfileQuery): DocumentImportProfile;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oCAAoC;;;;;;;;CAQvC,CAAC;AAEX,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,kCAAkC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;IACjD,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAED,wBAAgB,8BAA8B,IAAI,2BAA2B,CAE5E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,eAAO,MAAM,oCAAoC;;;;;;;;CAQvC,CAAC;AAEX,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,kCAAkC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,EAAE,oBAAoB,CAAC;IACjD,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,SAAS,4BAA4B,EAAE,CAAC;CACjE;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,eAAO,MAAM,gDAAgD,EAAE,uBAgC9D,CAAC;AAEF,eAAO,MAAM,wCAAwC,EAAE,qBAgDtD,CAAC;AAEF,wBAAgB,8BAA8B,IAAI,2BAA2B,CAE5E;AAED,wBAAgB,mDAAmD,IAAI,uBAAuB,CAE7F;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,oCAAoC,GAAG,qBAAqB,CAUrH"}

package/dist/index.js

@@ -1,13 +1,107 @@
 export const agenticDomainArtifactStandardPackage = {
     name: "agentic-domain-artifact-standard",
-    version: "0.1.0",
+    version: "0.2.0",
     layer: "domain",
     logicalSchema: "artifact_standard",
     sqliteTablePrefix: "artifact_standard_",
     cli: "not-provided",
     adapter: "not-provided"
 };
+export const architectureSpecificationArtifactStandardPackage = {
+    packageCode: "architecture_specification",
+    packageVersion: "1.0.0",
+    name: "Architecture Specification",
+    documentTypeCode: "architecture_specification",
+    documentProfileCode: "architecture_specification",
+    templateSlots: [
+        {
+            slotCode: "document_overview",
+            name: "문서 개요",
+            required: true,
+            description: "문서의 목적, 범위, 독자, 활용 기준을 설명하는 영역"
+        },
+        {
+            slotCode: "architecture_context",
+            name: "아키텍처 컨텍스트",
+            required: true,
+            description: "비즈니스, 시스템, 통합, 운영 맥락을 설명하는 영역"
+        },
+        {
+            slotCode: "architecture_decisions",
+            name: "아키텍처 결정",
+            required: true,
+            description: "주요 아키텍처 판단, 근거, 대안을 정리하는 영역"
+        },
+        {
+            slotCode: "appendix",
+            name: "부록",
+            required: false,
+            description: "상세 표, 그림, 참조 자료, 보조 설명을 담는 영역"
+        }
+    ]
+};
+export const ArchitectureSpecificationDocumentProfile = {
+    profileCode: "architecture_specification",
+    profileVersion: "1.0.0",
+    documentTypeCode: "architecture_specification",
+    taxonomyCode: "architecture_specification",
+    defaultTocLevelLimit: 4,
+    headingPolicy: {
+        maxHeadingLevel: 6,
+        tocLevelLimit: 4,
+        defaultTaxonomyCode: "architecture_specification"
+    },
+    captionPolicy: {
+        tableCaptionPatterns: ["표 {number}. {title} - {summary}", "Table {number}. {title} - {summary}"],
+        figureCaptionPatterns: ["그림 {number}. {title} - {summary}", "Figure {number}. {title} - {summary}"],
+        bindTableCaptionBeforeTable: true,
+        bindVisibleFigureCaptionAfterImage: true,
+        removeDuplicateVisibleFigureCaption: true
+    },
+    tablePolicy: {
+        requireCaption: true,
+        requireColumns: true,
+        requireRows: true,
+        defaultColumnValueType: "text"
+    },
+    figurePolicy: {
+        requireCaption: true,
+        requireSourcePath: true,
+        visibleCaptionMode: "deduplicate"
+    },
+    diagramPolicy: {
+        allowedNotations: ["mermaid", "plantuml", "drawio", "svg"],
+        requireSourceTextOrPath: true
+    },
+    validationProfile: {
+        enabledRuleIds: [
+            "DOCUMENT.BLOCK.TABLE_COLUMNS",
+            "DOCUMENT.BLOCK.TABLE_ROWS",
+            "DOCUMENT.BLOCK.FIGURE_SOURCE",
+            "DOCUMENT.BLOCK.DIAGRAM_NOTATION",
+            "DOCUMENT.BLOCK.DIAGRAM_SOURCE"
+        ],
+        warningRuleIds: ["DOCUMENT.BLOCK.TABLE_CAPTION", "DOCUMENT.BLOCK.FIGURE_CAPTION"],
+        requiredBlockTypes: ["paragraph"]
+    },
+    metadata: {
+        providerPackage: "agentic-domain-artifact-standard",
+        artifactStandardPackageCode: "architecture_specification"
+    }
+};
 export function getArtifactStandardPackageInfo() {
     return agenticDomainArtifactStandardPackage;
 }
+export function getArchitectureSpecificationArtifactStandardPackage() {
+    return architectureSpecificationArtifactStandardPackage;
+}
+export function getArtifactStandardDocumentProfile(query) {
+    if (query.artifactStandardPackageCode !== "architecture_specification") {
+        throw new Error(`Unsupported artifact standard package code: ${query.artifactStandardPackageCode}`);
+    }
+    if (query.profileVersion !== undefined && query.profileVersion !== ArchitectureSpecificationDocumentProfile.profileVersion) {
+        throw new Error(`Unsupported architecture_specification profile version: ${query.profileVersion}`);
+    }
+    return ArchitectureSpecificationDocumentProfile;
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oCAAoC,GAAG;IAClD,IAAI,EAAE,kCAAkC;IACxC,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,QAAQ;IACf,aAAa,EAAE,mBAAmB;IAClC,iBAAiB,EAAE,oBAAoB;IACvC,GAAG,EAAE,cAAc;IACnB,OAAO,EAAE,cAAc;CACf,CAAC;AAYX,MAAM,UAAU,8BAA8B;IAC5C,OAAO,oCAAoC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/docs/publishing.md

@@ -2,10 +2,22 @@
 
 패키지 내부에는 특정 registry URL을 고정하지 않는다.
 
-운영환경 publish 또는 delivery는 consumer/build 환경의 `.npmrc`, 환경 변수, CI/CD 설정에서 registry와 인증 정보를 제공한다.
+공식 publish/install registry는 `https://registry.npmjs.org/`를 사용한다. consumer/build 환경의 `.npmrc`에는 npmjs 인증 정보를 제공한다.
 
 검증 명령:
 
 ```bash
 npm pack --workspace agentic-domain-artifact-standard --dry-run
 ```
+
+Publish:
+
+```bash
+npm publish --workspace agentic-domain-artifact-standard --registry=https://registry.npmjs.org/
+```
+
+Publish 검증:
+
+```bash
+npm view agentic-domain-artifact-standard version --registry=https://registry.npmjs.org/
+```

package/docs/usage.md

@@ -1,10 +1,21 @@
 # Usage
 
-Iteration 0에서는 패키지 정보 조회 API만 제공한다.
+이 패키지는 산출물 표준 패키지 정보와 document import profile fixture를 제공한다.
 
 ```ts
-import { getArtifactStandardPackageInfo } from "agentic-domain-artifact-standard";
+import {
+  getArtifactStandardDocumentProfile,
+  getArtifactStandardPackageInfo
+} from "agentic-domain-artifact-standard";
 
 const info = getArtifactStandardPackageInfo();
 console.log(info.name);
+
+const profile = getArtifactStandardDocumentProfile({
+  artifactStandardPackageCode: "architecture_specification"
+});
+
+console.log(profile.documentTypeCode);
 ```
+
+`getArtifactStandardDocumentProfile()`은 document DB를 열거나 document importer를 실행하지 않는다. 호출자는 반환된 `DocumentImportProfile`을 `agentic-domain-document`의 Markdown importer에 전달한다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-domain-artifact-standard",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Agentic Platform artifact standard domain package",
   "license": "UNLICENSED",
   "type": "module",
@@ -16,5 +16,8 @@
     "build": "tsc -p tsconfig.json",
     "clean": "rm -rf dist tsconfig.tsbuildinfo",
     "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "agentic-domain-document": "^0.7.0"
   }
 }