agentic-domain-document 0.6.0

package/dist/validators.js

@@ -0,0 +1,255 @@
+const TEXT_BLOCK_TYPES = new Set(["paragraph", "quote", "code", "callout"]);
+const JSON_BLOCK_TYPES = new Set(["table", "figure", "diagram", "list"]);
+const DIAGRAM_NOTATIONS = new Set(["mermaid", "plantuml", "drawio", "svg"]);
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function issue(input) {
+    return {
+        severity: input.severity ?? "error",
+        ruleId: input.ruleId,
+        targetType: input.targetType,
+        targetId: input.targetId,
+        message: input.message,
+        details: input.details
+    };
+}
+function parseJson(value) {
+    if (typeof value !== "string" || value.length === 0) {
+        return undefined;
+    }
+    return JSON.parse(value);
+}
+function getDocument(db, documentId) {
+    return db.prepare(`SELECT * FROM document_documents WHERE document_id = ?`).get(documentId);
+}
+function listNodes(db, documentId) {
+    return db.prepare(`SELECT * FROM document_nodes WHERE document_id = ? ORDER BY node_level, sort_order`).all(documentId).map((row) => ({
+        nodeId: row.node_id,
+        documentId: row.document_id,
+        parentNodeId: typeof row.parent_node_id === "string" ? row.parent_node_id : undefined,
+        nodeLevel: row.node_level,
+        nodeRoleCode: row.node_role_code,
+        title: row.title,
+        tocVisibility: row.toc_visibility,
+        numberingPolicyCode: row.numbering_policy_code,
+        numberingOverride: typeof row.numbering_override === "string" ? row.numbering_override : undefined,
+        sortOrder: row.sort_order,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        metadata: parseJson(row.metadata_json)
+    }));
+}
+function listBlocks(db, documentId) {
+    return db
+        .prepare(`SELECT b.*
+         FROM document_blocks b
+         JOIN document_contents c ON c.content_id = b.content_id
+        WHERE c.document_id = ?
+        ORDER BY c.node_id, b.sort_order`)
+        .all(documentId).map((row) => ({
+        blockId: row.block_id,
+        contentId: row.content_id,
+        blockTypeCode: row.block_type_code,
+        sortOrder: row.sort_order,
+        contentText: typeof row.content_text === "string" ? row.content_text : undefined,
+        contentJson: parseJson(row.content_json),
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        metadata: parseJson(row.metadata_json)
+    }));
+}
+function hasTaxonomyLevel(db, taxonomyId, level) {
+    const row = db
+        .prepare(`SELECT taxonomy_level_id FROM document_node_taxonomy_levels WHERE taxonomy_id = ? AND node_level = ?`)
+        .get(taxonomyId, level);
+    return row !== undefined;
+}
+function listDepth(value, depth = 1) {
+    if (value === null || typeof value !== "object") {
+        return depth;
+    }
+    const record = value;
+    const children = Array.isArray(record.children) ? record.children : Array.isArray(record.items) ? record.items : [];
+    if (children.length === 0) {
+        return depth;
+    }
+    return Math.max(...children.map((child) => listDepth(child, depth + 1)));
+}
+function validateBlockPayload(block) {
+    const issues = [];
+    if (TEXT_BLOCK_TYPES.has(block.blockTypeCode) && (block.contentText === undefined || block.contentText.trim() === "")) {
+        issues.push(issue({
+            ruleId: "DOCUMENT.BLOCK.TEXT_REQUIRED",
+            targetType: "block",
+            targetId: block.blockId,
+            message: `${block.blockTypeCode} block은 contentText가 필요합니다.`
+        }));
+    }
+    if (JSON_BLOCK_TYPES.has(block.blockTypeCode) && block.contentJson === undefined) {
+        issues.push(issue({
+            ruleId: "DOCUMENT.BLOCK.JSON_REQUIRED",
+            targetType: "block",
+            targetId: block.blockId,
+            message: `${block.blockTypeCode} block은 contentJson이 필요합니다.`
+        }));
+    }
+    if (block.blockTypeCode === "diagram" && block.contentJson !== undefined) {
+        const notation = isRecord(block.contentJson) ? block.contentJson.notation : undefined;
+        if (typeof notation !== "string" || !DIAGRAM_NOTATIONS.has(notation)) {
+            issues.push(issue({
+                ruleId: "DOCUMENT.BLOCK.DIAGRAM_NOTATION",
+                targetType: "block",
+                targetId: block.blockId,
+                message: "diagram block은 mermaid, plantuml, drawio, svg 중 하나의 notation이 필요합니다.",
+                details: { notation }
+            }));
+        }
+        if (isRecord(block.contentJson) && !nonEmptyString(block.contentJson.sourceText) && !nonEmptyString(block.contentJson.sourcePath) && !nonEmptyString(block.contentJson.path)) {
+            issues.push(issue({
+                ruleId: "DOCUMENT.BLOCK.DIAGRAM_SOURCE",
+                targetType: "block",
+                targetId: block.blockId,
+                message: "diagram block은 sourceText, sourcePath, path 중 하나가 필요합니다."
+            }));
+        }
+    }
+    if (block.blockTypeCode === "table" && block.contentJson !== undefined) {
+        const columns = isRecord(block.contentJson) ? block.contentJson.columns : undefined;
+        const rows = isRecord(block.contentJson) ? block.contentJson.rows : undefined;
+        if (!Array.isArray(columns) || columns.length === 0) {
+            issues.push(issue({
+                ruleId: "DOCUMENT.BLOCK.TABLE_COLUMNS",
+                targetType: "block",
+                targetId: block.blockId,
+                message: "table block은 하나 이상의 column이 필요합니다."
+            }));
+        }
+        if (!Array.isArray(rows)) {
+            issues.push(issue({
+                ruleId: "DOCUMENT.BLOCK.TABLE_ROWS",
+                targetType: "block",
+                targetId: block.blockId,
+                message: "table block은 rows 배열이 필요합니다."
+            }));
+        }
+        if (isRecord(block.contentJson) && !nonEmptyString(block.contentJson.caption) && !nonEmptyString(block.contentJson.rawCaption)) {
+            issues.push(issue({
+                ruleId: "DOCUMENT.BLOCK.TABLE_CAPTION",
+                severity: "warning",
+                targetType: "block",
+                targetId: block.blockId,
+                message: "table block에 caption이 없습니다."
+            }));
+        }
+    }
+    if (block.blockTypeCode === "figure" && block.contentJson !== undefined && isRecord(block.contentJson)) {
+        if (!nonEmptyString(block.contentJson.sourcePath) && !nonEmptyString(block.contentJson.path)) {
+            issues.push(issue({
+                ruleId: "DOCUMENT.BLOCK.FIGURE_SOURCE",
+                targetType: "block",
+                targetId: block.blockId,
+                message: "figure block은 sourcePath 또는 path가 필요합니다."
+            }));
+        }
+        if (!nonEmptyString(block.contentJson.caption) && !nonEmptyString(block.contentJson.rawCaption) && !nonEmptyString(block.contentJson.altText)) {
+            issues.push(issue({
+                ruleId: "DOCUMENT.BLOCK.FIGURE_CAPTION",
+                severity: "warning",
+                targetType: "block",
+                targetId: block.blockId,
+                message: "figure block에 caption 또는 altText가 없습니다."
+            }));
+        }
+    }
+    if (block.blockTypeCode === "list" && block.contentJson !== undefined) {
+        const depth = listDepth(block.contentJson);
+        if (depth > 3) {
+            issues.push(issue({
+                ruleId: "DOCUMENT.BLOCK.LIST_DEPTH",
+                targetType: "block",
+                targetId: block.blockId,
+                message: "list block의 중첩 깊이는 3을 넘을 수 없습니다.",
+                details: { depth }
+            }));
+        }
+    }
+    return issues;
+}
+export function validateDocument(db, documentId) {
+    const document = getDocument(db, documentId);
+    if (document === undefined) {
+        return {
+            valid: false,
+            issues: [
+                issue({
+                    ruleId: "DOCUMENT.EXISTS",
+                    targetType: "document",
+                    targetId: documentId,
+                    message: "문서를 찾을 수 없습니다."
+                })
+            ]
+        };
+    }
+    const taxonomyId = document.taxonomy_id;
+    const issues = [];
+    const nodes = listNodes(db, documentId);
+    const nodeById = new Map(nodes.map((node) => [node.nodeId, node]));
+    for (const node of nodes) {
+        if (!hasTaxonomyLevel(db, taxonomyId, node.nodeLevel)) {
+            issues.push(issue({
+                ruleId: "DOCUMENT.NODE.TAXONOMY_LEVEL",
+                targetType: "node",
+                targetId: node.nodeId,
+                message: `taxonomy에 정의되지 않은 node level입니다: ${node.nodeLevel}`,
+                details: { nodeLevel: node.nodeLevel, taxonomyId }
+            }));
+        }
+        if (node.parentNodeId !== undefined) {
+            const parent = nodeById.get(node.parentNodeId);
+            if (parent === undefined) {
+                issues.push(issue({
+                    ruleId: "DOCUMENT.NODE.PARENT_EXISTS",
+                    targetType: "node",
+                    targetId: node.nodeId,
+                    message: "상위 node를 찾을 수 없습니다.",
+                    details: { parentNodeId: node.parentNodeId }
+                }));
+            }
+            else if (node.nodeLevel <= parent.nodeLevel) {
+                issues.push(issue({
+                    ruleId: "DOCUMENT.NODE.PARENT_LEVEL",
+                    targetType: "node",
+                    targetId: node.nodeId,
+                    message: "하위 node level은 상위 node level보다 커야 합니다.",
+                    details: { parentLevel: parent.nodeLevel, nodeLevel: node.nodeLevel }
+                }));
+            }
+            let ancestor = parent;
+            while (ancestor !== undefined) {
+                if (ancestor.tocVisibility === "exclude" && node.tocVisibility === "include") {
+                    issues.push(issue({
+                        ruleId: "DOCUMENT.TOC.EXCLUDED_ANCESTOR",
+                        targetType: "node",
+                        targetId: node.nodeId,
+                        message: "상위 node가 TOC에서 제외된 경우 하위 node만 TOC에 포함할 수 없습니다.",
+                        details: { ancestorNodeId: ancestor.nodeId }
+                    }));
+                    break;
+                }
+                ancestor = ancestor.parentNodeId === undefined ? undefined : nodeById.get(ancestor.parentNodeId);
+            }
+        }
+    }
+    for (const block of listBlocks(db, documentId)) {
+        issues.push(...validateBlockPayload(block));
+    }
+    return {
+        valid: issues.every((validationIssue) => validationIssue.severity !== "error"),
+        issues
+    };
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

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

package/docs/build.md

@@ -0,0 +1,55 @@
+# agentic-domain-document 개발 및 빌드 매뉴얼
+
+## 1. 목적
+
+본 문서는 구축 담당자가 `agentic-domain-document` 패키지를 개발, 빌드, 로컬 검증하기 위해 알아야 하는 내용을 정리합니다.
+
+## 2. 패키지 정보
+
+| 항목 | 값 |
+| --- | --- |
+| package | `agentic-domain-document` |
+| current version | `0.1.0` |
+| layer | Domain |
+| workspace | `packages/agentic-domain-document` |
+
+## 3. 소스 구조
+
+```text
+packages/agentic-domain-document/
+  package.json
+  README.md
+  CHANGELOG.md
+  tsconfig.json
+  src/
+    index.ts
+  docs/
+    usage.md
+    configuration.md
+    build.md
+    publishing.md
+    delivery.md
+    operations.md
+    schema/
+      generated/
+      migrations.md
+```
+
+## 4. 개발 검증
+
+repository root에서 실행합니다.
+
+```bash
+npm run build --workspace agentic-domain-document
+npm run typecheck --workspace agentic-domain-document
+npm pack --workspace agentic-domain-document --dry-run --cache /private/tmp/agentic-npm-cache
+```
+
+## 5. Iteration 1 예정 검증
+
+Document DB migration이 추가되면 다음 검증을 추가합니다.
+
+```bash
+npm run schema:doc:agentic-domain-document
+npm run dev:test:agentic-domain-document
+```

package/docs/configuration.md

@@ -0,0 +1,34 @@
+# agentic-domain-document 설정 원칙
+
+## 1. 목적
+
+본 문서는 `agentic-domain-document`가 직접 소유하는 설정과 consumer project가 소유해야 하는 설정을 구분합니다.
+
+## 2. 원칙
+
+`agentic-domain-document`는 환경별 runtime 값을 직접 소유하지 않습니다.
+
+```text
+agentic-domain-document
+  - document domain schema
+  - migration
+  - repository/service/validator
+  - fixture
+  - docs
+
+consumer project
+  - runtime database path
+  - registry URL
+  - authentication
+  - environment variables
+```
+
+## 3. DB 기준
+
+| 구분 | 기준 |
+| --- | --- |
+| logical schema | `document` |
+| SQLite table prefix | `document_` |
+| PostgreSQL mapping | 향후 별도 프로세스에서 적용 |
+
+SQLite table prefix는 로컬 SQLite에 schema namespace가 없기 때문에 사용합니다.

package/docs/delivery.md

@@ -0,0 +1,50 @@
+# agentic-domain-document Delivery 매뉴얼
+
+## 1. 목적
+
+본 문서는 `agentic-domain-document` 패키지를 구축 환경에서 운영환경으로 전달할 때 필요한 package-specific delivery 기준을 정의합니다.
+
+## 2. Delivery 범위
+
+| 구분 | 포함 여부 | 설명 |
+| --- | --- | --- |
+| npm package publish | 포함 | hosted registry에 배포 |
+| 운영환경 install 검증 | 포함 | group/proxy registry 기준 설치 확인 |
+| source repository 전체 전달 | 제외 | npm package 기준 전달 |
+| 인증 정보 전달 | 제외 | 환경별 `.npmrc` 또는 보안 정책으로 관리 |
+| registry URL 하드코딩 | 제외 | 환경 설정으로 제공 |
+
+## 3. Package에 포함되는 파일
+
+Iteration 0 배포 패키지는 다음 파일을 포함해야 합니다.
+
+```text
+package/
+  package.json
+  README.md
+  CHANGELOG.md
+  dist/
+    index.js
+    index.d.ts
+  docs/
+    usage.md
+    configuration.md
+    build.md
+    publishing.md
+    delivery.md
+    operations.md
+    schema/
+      migrations.md
+```
+
+## 4. 운영환경 전달 기준
+
+운영환경에는 다음 정보만 전달합니다.
+
+```text
+- package name: agentic-domain-document
+- install version: 0.1.0
+- 운영환경 NPM group/proxy registry 설정 방법
+- 설치 및 import 확인 절차
+- 문제 발생 시 확인 항목
+```

package/docs/operations.md

@@ -0,0 +1,50 @@
+# agentic-domain-document 운영환경 매뉴얼
+
+## 1. 목적
+
+본 문서는 운영환경 담당자 또는 사용자가 `agentic-domain-document`를 설치하고 기본 import 상태를 확인하는 절차를 정의합니다.
+
+## 2. 운영환경 전제
+
+| 항목 | 기준 |
+| --- | --- |
+| 네트워크 | Private Network / VDI |
+| 외부 인터넷 | 사용 불가 |
+| NPM Registry | 내부 NPM Registry proxy/group 사용 |
+| package | `agentic-domain-document` |
+
+## 3. Registry 확인
+
+```bash
+npm config get registry
+```
+
+운영환경에서는 내부 group/proxy registry가 출력되어야 합니다.
+
+## 4. 설치
+
+```bash
+npm install agentic-domain-document@0.6.0
+```
+
+## 5. 실행 확인
+
+```bash
+node -e "import('agentic-domain-document').then(m => console.log(m.agenticDomainDocumentPackage.logicalSchema))"
+```
+
+기대 결과:
+
+```text
+document
+```
+
+## 6. 장애 확인
+
+| 증상 | 확인 |
+| --- | --- |
+| package not found | 운영환경 group/proxy registry에 package가 노출되었는지 확인 |
+| authentication required | 사용자 홈 `.npmrc` 인증 정보 확인 |
+| public npm 접근 시도 | `npm config get registry` 결과 확인 |
+| import 실패 | `node_modules/agentic-domain-document/dist/index.js` 존재 여부 확인 |
+| 버전 불일치 | `npm view agentic-domain-document version` 결과 확인 |

package/docs/publishing.md

@@ -0,0 +1,69 @@
+# agentic-domain-document Publishing 매뉴얼
+
+## 1. 목적
+
+본 문서는 `agentic-domain-document` 패키지를 NPM Registry에 publish하는 절차를 정의합니다.
+
+## 2. 전제
+
+| 항목 | 기준 |
+| --- | --- |
+| package | `agentic-domain-document` |
+| current version | `0.1.0` |
+| workspace | `packages/agentic-domain-document` |
+| publish registry | 구축 환경에서 제공 |
+| install registry | 운영환경 또는 검증 환경에서 제공 |
+
+## 3. Publish 전 검증
+
+repository root에서 실행합니다.
+
+```bash
+npm run build --workspace agentic-domain-document
+npm run typecheck --workspace agentic-domain-document
+npm pack --workspace agentic-domain-document --dry-run --cache /private/tmp/agentic-npm-cache
+```
+
+## 4. Publish
+
+`package.json`에는 registry URL을 고정하지 않습니다.
+
+```bash
+npm publish --workspace agentic-domain-document --registry="${NPM_PUBLISH_REGISTRY_URL}"
+```
+
+Windows PowerShell:
+
+```powershell
+npm publish --workspace agentic-domain-document --registry="$env:NPM_PUBLISH_REGISTRY_URL"
+```
+
+## 5. Publish 검증
+
+```bash
+npm view agentic-domain-document version --registry="${NPM_INSTALL_REGISTRY_URL}"
+```
+
+기대 결과:
+
+```text
+0.1.0
+```
+
+## 6. 사용자 프로젝트 설치 검증
+
+```bash
+TEST_DIR=/private/tmp/agentic-domain-document-consumer-test
+rm -rf "$TEST_DIR"
+mkdir -p "$TEST_DIR"
+cd "$TEST_DIR"
+npm init -y
+npm install agentic-domain-document@0.6.0 --registry="${NPM_INSTALL_REGISTRY_URL}" --prefer-online
+node -e "import('agentic-domain-document').then(m => console.log(m.agenticDomainDocumentPackage.logicalSchema))"
+```
+
+기대 결과:
+
+```text
+document
+```

package/docs/schema/generated/README.md

@@ -0,0 +1,30 @@
+# agentic-domain-document
+
+## Description
+
+Agentic Platform document domain database.
+
+## Tables
+
+| Name                                                              | Columns | Comment                                                          | Type  |
+| ----------------------------------------------------------------- | ------- | ---------------------------------------------------------------- | ----- |
+| [document_code_groups](document_code_groups.md)                   | 7       | 코드 그룹을 정의한다.                                                     | table |
+| [document_codes](document_codes.md)                               | 9       | 코드 그룹별 코드 값을 정의한다.                                               | table |
+| [document_node_taxonomies](document_node_taxonomies.md)           | 9       | 문서 유형별 node level 해석 정책을 정의한다.                                   | table |
+| [document_node_taxonomy_levels](document_node_taxonomy_levels.md) | 9       | taxonomy별 node level 라벨, 번호 정책, counter scope를 정의한다.             | table |
+| [document_documents](document_documents.md)                       | 15      | 문서 단위 메타데이터, 작성자, taxonomy, 상태를 관리한다.                            | table |
+| [document_nodes](document_nodes.md)                               | 13      | 문서의 계층 node tree를 관리한다.                                          | table |
+| [document_contents](document_contents.md)                         | 6       | 특정 document node에 붙는 block collection을 관리한다.                     | table |
+| [document_blocks](document_blocks.md)                             | 9       | 문서 본문 표현 block을 관리한다.                                            | table |
+| [document_annotations](document_annotations.md)                   | 14      | 문서 본문 밖의 note annotation을 관리한다.                                  | table |
+| [document_revisions](document_revisions.md)                       | 11      | 하나 이상의 변경 이벤트를 묶는 의미 있는 변경 단위를 관리한다.                             | table |
+| [document_change_events](document_change_events.md)               | 13      | revision에 속하는 로그성 변경 이벤트를 관리한다.                                  | table |
+| [document_versions](document_versions.md)                         | 13      | 검토/승인/배포 기준본 snapshot을 관리한다.                                     | table |
+
+## Relations
+
+![er](schema.svg)
+
+---
+
+> Generated by [tbls](https://github.com/k1LoW/tbls)