@soddong/agentic-domain-artifact-standard 0.11.1 → 0.11.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +12 -0
- package/README.md +44 -1
- package/dist/database.d.ts.map +1 -1
- package/dist/database.js +0 -1
- package/dist/database.js.map +1 -1
- package/dist/sqlite.d.ts.map +1 -1
- package/dist/sqlite.js +7 -0
- package/dist/sqlite.js.map +1 -1
- package/docs/build.md +2 -2
- package/docs/delivery.md +1 -1
- package/docs/usage.md +30 -0
- package/package.json +3 -3
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.11.3
|
|
4
|
+
|
|
5
|
+
- Windows + Node `node:sqlite` 조합에서 `PRAGMA foreign_keys = ON` 중복 호출로 crash가 발생할 수 있는 문제를 방지
|
|
6
|
+
- SQLite connection open 시 `enableForeignKeyConstraints: true`에 의존하고 artifact-standard DB open 경로의 FK pragma 중복 호출 제거
|
|
7
|
+
|
|
8
|
+
## 0.11.2
|
|
9
|
+
|
|
10
|
+
- ArtifactStandardComponent 5종 세트(`CONCEPT`, `FORMAT`, `GUIDE`, `EXAMPLE`, `LLM_SUPPLEMENT`)의 개념과 책임을 README/usage에 명확히 문서화
|
|
11
|
+
- 문서형 ArtifactStandardComponent의 MVP 기본 presentation을 Markdown projection으로 정의
|
|
12
|
+
- seed/package 검토용 projection 위치와 consumer execution project projection 위치 기준을 문서화
|
|
13
|
+
- 공식 npm registry publish와 `@soddong/agentic-methodology-ai-agent-sdlc@0.2.8` consumer project create 경로에서 `>=0.11.2` 설치/등록을 검증
|
|
14
|
+
|
|
3
15
|
## 0.11.1
|
|
4
16
|
|
|
5
17
|
- SQLite driver를 native addon 기반 `better-sqlite3`에서 Node 내장 `node:sqlite`로 전환
|
package/README.md
CHANGED
|
@@ -12,6 +12,49 @@
|
|
|
12
12
|
|
|
13
13
|
현재 public API에는 호환성을 위해 `getArtifactStandardPackageInfo()`, `artifactStandardPackageCode` 같은 legacy alias도 남아 있습니다. 신규 사용자는 `getArtifactStandardInfo()`, `artifactStandardCode` 계열을 우선 사용합니다.
|
|
14
14
|
|
|
15
|
+
## Artifact Standard Component 세트
|
|
16
|
+
|
|
17
|
+
산출물 표준은 산출물 유형 하나를 작성하기 위한 기준 단위입니다. 예를 들어 `컴포넌트 모듈 구조 정의서`라는 산출물이 있으면, 이에 대응하는 `컴포넌트 모듈 구조 정의서 표준`이 하나 존재하고, 이 표준은 기본적으로 다음 `ArtifactStandardComponent` 세트를 가진다.
|
|
18
|
+
|
|
19
|
+
| Component Type | 한글명 | 책임 |
|
|
20
|
+
| --- | --- | --- |
|
|
21
|
+
| `CONCEPT` | 개념서 | 산출물의 목적, 배경, 범위, 핵심 용어, 원칙을 설명한다. 작성 기법은 포함하지 않고 `GUIDE`로 분리한다. |
|
|
22
|
+
| `FORMAT` | 서식 | 사람이 이해할 수 있는 산출물 템플릿 또는 서식 문서의 기준 원천이다. 실제 구조 검증은 `DocumentBlueprint`, `TemplateSlot`, `TableSchema`, `Policy`가 담당한다. |
|
|
23
|
+
| `GUIDE` | 가이드 및 기법 | 작성 입력, 절차, 기법, 판단 기준, 체크포인트, 완료 기준, tailoring 기준을 설명한다. 사람과 LLM이 함께 참고하는 공통 작성 기준이다. |
|
|
24
|
+
| `EXAMPLE` | 예시 | 좋은 예, 나쁜 예, before/after, compact/full 예시를 제공한다. 필요한 경우 target blueprint, slot, schema와 연결한다. |
|
|
25
|
+
| `LLM_SUPPLEMENT` | LLM 지침 | LLM이 공통 작성 기준을 실제 산출물 작성에 적용하도록 돕는 보조 지시문이다. guide를 대체하지 않는다. |
|
|
26
|
+
|
|
27
|
+
따라서 산출물 표준의 기본 구조는 다음처럼 해석한다.
|
|
28
|
+
|
|
29
|
+
```text
|
|
30
|
+
ArtifactStandard: 컴포넌트 모듈 구조 정의서 표준
|
|
31
|
+
- ArtifactStandardComponent(CONCEPT): 컴포넌트 모듈 구조 정의서 개념서
|
|
32
|
+
- ArtifactStandardComponent(FORMAT): 컴포넌트 모듈 구조 정의서 서식
|
|
33
|
+
- ArtifactStandardComponent(GUIDE): 컴포넌트 모듈 구조 정의서 가이드 및 기법
|
|
34
|
+
- ArtifactStandardComponent(EXAMPLE): 컴포넌트 모듈 구조 정의서 예시
|
|
35
|
+
- ArtifactStandardComponent(LLM_SUPPLEMENT): 컴포넌트 모듈 구조 정의서 LLM 지침
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
`ArtifactStandardComponent`는 전문을 직접 저장하지 않고 `document_id`, file path, URL, agent resource ref 같은 외부 resource 참조를 관리한다. Component와 실제 적용 대상의 관계는 `ArtifactStandardComponentBinding`으로 표현한다.
|
|
39
|
+
|
|
40
|
+
`ArtifactStandardComponent`와 `DocumentComponent`는 다른 개념이다. `ArtifactStandardComponent`는 산출물 표준을 설명하고 정의하는 개념서, 서식, 가이드, 예시, LLM 지침 resource이고, `DocumentComponent`는 그 표준으로 작성될 산출물 자체의 본문, 부록, 보조자료, 통제정보 같은 논리 구성 단위다.
|
|
41
|
+
|
|
42
|
+
### Markdown Projection 기준
|
|
43
|
+
|
|
44
|
+
MVP에서 모든 문서형 `ArtifactStandardComponent`는 최소한 Markdown projection으로 확인 가능해야 한다. 여기서 Markdown projection은 원천이 아니라 `@soddong/agentic-domain-document`가 canonical document에서 제공하는 기본 presentation view다. HTML, PDF, DOCX, PPTX 같은 고급 presentation은 현재 범위에서 제외하고 후속 render capability 책임으로 둔다.
|
|
45
|
+
|
|
46
|
+
Projection 위치는 실행 맥락에 따라 구분한다.
|
|
47
|
+
|
|
48
|
+
| 맥락 | 위치 | 의미 |
|
|
49
|
+
| --- | --- | --- |
|
|
50
|
+
| seed/package 개발 중 검토 | `docs/generated/{bundleCode}/...` | package에 포함될 수 있는 검토용 generated document |
|
|
51
|
+
| consumer execution project | `.agentic/projections/...` | 후속 runtime 기능에서 consumer local에 생성할 실행 project projection 목표 위치 |
|
|
52
|
+
| HTML report | `.agentic/reports/...` | projection이 아니라 별도 report/view |
|
|
53
|
+
|
|
54
|
+
현재 publish된 `@soddong/agentic-runtime@0.17.6`은 `.agentic/reports/...` HTML report를 생성한다. `.agentic/projections/...` 자동 생성은 후속 runtime patch 범위다.
|
|
55
|
+
|
|
56
|
+
`FORMAT` component의 Markdown projection은 산출물 서식의 사람이 읽는 기준 원천이 될 수 있고, 후속 parser/extractor가 이를 읽어 `DocumentBlueprint`, `TemplateSlot`, `TableSchema`, `DiagramPolicy`, `PhysicalStructurePolicy` 같은 구조화 asset을 도출할 수 있다. `CONCEPT`, `GUIDE`, `EXAMPLE`, `LLM_SUPPLEMENT`는 Markdown projection과 최소 outline 검증을 기본으로 본다.
|
|
57
|
+
|
|
15
58
|
## Profile 용어 구분
|
|
16
59
|
|
|
17
60
|
`artifact-standard`에서 사용하는 profile 관련 용어는 다음처럼 구분합니다.
|
|
@@ -26,7 +69,7 @@
|
|
|
26
69
|
|
|
27
70
|
## 현재 범위
|
|
28
71
|
|
|
29
|
-
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에 적용할 수 있게 했고, 0.11.1에서는 SQLite driver를 Node 내장 `node:sqlite`로 전환했습니다. Validator 실행 engine은 `@soddong/agentic-capability-validation` 책임이며, `artifact-standard`는 검증 기준을 contract-compatible manifest로 제공하는 데 집중합니다.
|
|
72
|
+
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에 적용할 수 있게 했고, 0.11.1에서는 SQLite driver를 Node 내장 `node:sqlite`로 전환했습니다. 0.11.2에서는 ArtifactStandardComponent 세트와 Markdown projection 기준을 문서화했습니다. Validator 실행 engine은 `@soddong/agentic-capability-validation` 책임이며, `artifact-standard`는 검증 기준을 contract-compatible manifest로 제공하는 데 집중합니다.
|
|
30
73
|
|
|
31
74
|
| 구분 | 상태 |
|
|
32
75
|
| --- | --- |
|
package/dist/database.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAGtE,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,cAAc,GAAG,MAAM,EAAE,CAYvE;AAED,wBAAgB,kCAAkC,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAE3E;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,+BAAoC,GAC5C,cAAc,
|
|
1
|
+
{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAGtE,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,cAAc,GAAG,MAAM,EAAE,CAYvE;AAED,wBAAgB,kCAAkC,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI,CAE3E;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,+BAAoC,GAC5C,cAAc,CAiBhB;AAED,wBAAgB,kCAAkC,CAChD,OAAO,GAAE,+BAAoC,GAC5C,kCAAkC,CAcpC"}
|
package/dist/database.js
CHANGED
|
@@ -47,7 +47,6 @@ export function openArtifactStandardDatabase(options = {}) {
|
|
|
47
47
|
const db = openSqliteDatabase(databasePath);
|
|
48
48
|
try {
|
|
49
49
|
db.pragma("journal_mode = WAL");
|
|
50
|
-
db.pragma("foreign_keys = ON");
|
|
51
50
|
if (options.applyMigration !== false) {
|
|
52
51
|
applyArtifactStandardBaseMigration(db);
|
|
53
52
|
}
|
package/dist/database.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"database.js","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAuB,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAYtD,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAEzD,SAAS,iBAAiB,CAAC,WAAmB;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAC;IAE5D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAkB,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,mCAAmC,CAAC,UAA2C,EAAE;IAC/F,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC;YACrC,CAAC,CAAC,OAAO,CAAC,YAAY;YACtB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzD,MAAM,MAAM,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC;IAE1C,IAAI,QAAQ,EAAE,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,gDAAgD,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,cAAc,GAAG,QAAQ,EAAE,IAAI,IAAI,qBAAqB,CAAC;IAC/D,OAAO,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,iCAAiC;IACxC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,4DAA4D,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5G,OAAO,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,EAAkB;IAC3D,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;;;;sBAIgB,CACjB;SACA,GAAG,EAA6B,CAAC;IAEpC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,EAAkB;IACnE,EAAE,CAAC,IAAI,CAAC,iCAAiC,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,UAA2C,EAAE;IAE7C,MAAM,YAAY,GAAG,mCAAmC,CAAC,OAAO,CAAC,CAAC;IAClE,SAAS,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtD,MAAM,EAAE,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"database.js","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"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"}
|
package/dist/sqlite.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC;IAC3C,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACnC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IACrC,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;
|
|
1
|
+
{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,eAAe,CAAC;IAC3C,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IACnC,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAC;IACtC,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;IACrC,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AA8FD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAUpG"}
|
package/dist/sqlite.js
CHANGED
|
@@ -21,12 +21,19 @@ function loadDatabaseSync() {
|
|
|
21
21
|
process.emitWarning = originalEmitWarning;
|
|
22
22
|
}
|
|
23
23
|
}
|
|
24
|
+
function isForeignKeysEnablePragma(statement) {
|
|
25
|
+
const normalized = statement.trim().replace(/;$/, "").replace(/\s+/g, " ").toLowerCase();
|
|
26
|
+
return normalized === "foreign_keys = on" || normalized === "foreign_keys=on";
|
|
27
|
+
}
|
|
24
28
|
function applyCompatibility(db) {
|
|
25
29
|
const compat = db;
|
|
26
30
|
if (compat.__agenticCompatApplied === true) {
|
|
27
31
|
return compat;
|
|
28
32
|
}
|
|
29
33
|
compat.pragma = (statement) => {
|
|
34
|
+
if (isForeignKeysEnablePragma(statement)) {
|
|
35
|
+
return [];
|
|
36
|
+
}
|
|
30
37
|
const sql = `PRAGMA ${statement}`;
|
|
31
38
|
try {
|
|
32
39
|
return compat.prepare(sql).all();
|
package/dist/sqlite.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../src/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AA2C5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,SAAS,gBAAgB;IACvB,MAAM,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IAChD,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC,OAAuB,EAAE,GAAG,IAAe,EAAE,EAAE;QACrE,MAAM,WAAW,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ;YAC7C,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACT,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC;gBACpE,CAAC,CAAC,MAAM,CAAE,IAAI,CAAC,CAAC,CAAiC,CAAC,IAAI,CAAC;gBACvD,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,WAAW,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;QAE5E,IAAI,WAAW,KAAK,qBAAqB,IAAI,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5E,OAAO;QACT,CAAC;QAED,OAAQ,mBAAwD,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACnG,CAAC,CAA+B,CAAC;IAEjC,IAAI,CAAC;QACH,OAAQ,OAAO,CAAC,aAAa,CAAwD,CAAC,YAAY,CAAC;IACrG,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,WAAW,GAAG,mBAAmB,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAAC,SAAiB;IAClD,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACzF,OAAO,UAAU,KAAK,mBAAmB,IAAI,UAAU,KAAK,iBAAiB,CAAC;AAChF,CAAC;AAED,SAAS,kBAAkB,CAAC,EAAkB;IAC5C,MAAM,MAAM,GAAG,EAA0B,CAAC;IAC1C,IAAI,MAAM,CAAC,sBAAsB,KAAK,IAAI,EAAE,CAAC;QAC3C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,MAAM,GAAG,CAAC,SAAiB,EAAa,EAAE;QAC/C,IAAI,yBAAyB,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,GAAG,GAAG,UAAU,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,CAAC,WAAW,GAAG,CAA0C,EAAK,EAAK,EAAE;QACzE,OAAO,CAAC,CAAC,GAAG,IAAmB,EAAiB,EAAE;YAChD,IAAI,MAAM,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;gBAClC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAkB,CAAC;YACtC,CAAC;YAED,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,IAAI,CAAkB,CAAC;gBAC5C,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACtB,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC;oBACH,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,kEAAkE;gBACpE,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAM,CAAC;IACV,CAAC,CAAC;IAEF,MAAM,CAAC,sBAAsB,GAAG,IAAI,CAAC;IACrC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,UAA6B,EAAE;IAClF,MAAM,YAAY,GAAG,gBAAgB,EAAE,CAAC;IACxC,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,QAAQ,EAAE;QACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ;QAC9C,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,2BAA2B,EAAE,IAAI;QACjC,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IACH,OAAO,kBAAkB,CAAC,EAAE,CAAC,CAAC;AAChC,CAAC"}
|
package/docs/build.md
CHANGED
|
@@ -5,8 +5,8 @@
|
|
|
5
5
|
| 항목 | 값 |
|
|
6
6
|
| --- | --- |
|
|
7
7
|
| package | `@soddong/agentic-domain-artifact-standard` |
|
|
8
|
-
| current version | `0.11.
|
|
9
|
-
| dependency | `@soddong/agentic-contract-validation@^0.2.
|
|
8
|
+
| current version | `0.11.3` |
|
|
9
|
+
| dependency | `@soddong/agentic-contract-validation@^0.2.2`, `@soddong/agentic-domain-document@^0.7.2` |
|
|
10
10
|
|
|
11
11
|
개발 검증 명령은 다음과 같다.
|
|
12
12
|
|
package/docs/delivery.md
CHANGED
package/docs/usage.md
CHANGED
|
@@ -6,6 +6,36 @@
|
|
|
6
6
|
|
|
7
7
|
현재 API에는 호환성을 위해 `getArtifactStandardPackageInfo()`, `artifactStandardPackageCode` 명명이 남아 있다. 신규 호출은 `getArtifactStandardInfo()`, `artifactStandardCode` 계열을 우선 사용한다.
|
|
8
8
|
|
|
9
|
+
## Artifact Standard Component 세트
|
|
10
|
+
|
|
11
|
+
산출물 표준 하나는 산출물 유형 하나를 작성하기 위한 표준 단위다. 예를 들어 `컴포넌트 모듈 구조 정의서` 산출물이 있으면 `컴포넌트 모듈 구조 정의서 표준`이 하나 있고, 이 표준은 기본적으로 다음 구성 문서/리소스 세트를 가진다.
|
|
12
|
+
|
|
13
|
+
| Component Type | 한글명 | 사용 목적 |
|
|
14
|
+
| --- | --- | --- |
|
|
15
|
+
| `CONCEPT` | 개념서 | 산출물의 목적, 배경, 범위, 핵심 용어, 원칙을 이해한다. |
|
|
16
|
+
| `FORMAT` | 서식 | 산출물 템플릿, 목차, 표, 도해, 작성 슬롯의 기준 원천을 확인한다. |
|
|
17
|
+
| `GUIDE` | 가이드 및 기법 | 작성 절차, 기법, 판단 기준, 체크포인트, 완료 기준을 확인한다. |
|
|
18
|
+
| `EXAMPLE` | 예시 | 좋은 예, 나쁜 예, before/after, compact/full 예시를 확인한다. |
|
|
19
|
+
| `LLM_SUPPLEMENT` | LLM 지침 | LLM이 guide와 format을 산출물 작성에 적용할 때의 보조 지시문을 확인한다. |
|
|
20
|
+
|
|
21
|
+
이 구성요소들은 전문을 직접 저장하지 않고 `document_id`, file path, URL, agent resource ref 같은 참조로 연결한다. 특정 `BlueprintNode`, `TemplateSlot`, `TableSchema`에 어떤 guide나 example이 적용되는지는 component binding으로 표현한다.
|
|
22
|
+
|
|
23
|
+
`ArtifactStandardComponent`와 `DocumentComponent`는 분리한다. 전자는 산출물 표준을 정의하는 개념서, 서식, 가이드, 예시, LLM 지침이고, 후자는 해당 표준으로 작성될 실제 산출물의 본문, 부록, 보조자료 같은 논리 구성 단위다.
|
|
24
|
+
|
|
25
|
+
### Markdown Projection 위치
|
|
26
|
+
|
|
27
|
+
MVP에서는 문서형 component의 기본 presentation을 Markdown projection으로 본다. Markdown projection은 원천 문서가 아니라 `@soddong/agentic-domain-document`가 canonical document에서 생성하는 읽기용 view다.
|
|
28
|
+
|
|
29
|
+
| 맥락 | 위치 |
|
|
30
|
+
| --- | --- |
|
|
31
|
+
| seed package 검토용 generated 문서 | `docs/generated/{bundleCode}/...` |
|
|
32
|
+
| consumer execution project generated projection | `.agentic/projections/...` |
|
|
33
|
+
| HTML report | `.agentic/reports/...` |
|
|
34
|
+
|
|
35
|
+
`docs/generated/{bundleCode}/...`는 현재 seed package에서 생성/배포되는 검토용 projection 위치다. `.agentic/projections/...`는 후속 runtime 기능에서 consumer project에 생성할 목표 위치이며, 현재 `@soddong/agentic-runtime@0.17.6`은 `.agentic/reports/...` HTML report 생성을 지원한다.
|
|
36
|
+
|
|
37
|
+
HTML/PDF/DOCX/PPTX rendering은 이 기준에 포함하지 않는다. `FORMAT` component는 Markdown projection을 기준 원천으로 하여 blueprint, template slot, table schema, diagram policy 같은 구조화 asset을 도출할 수 있다. 나머지 component는 Markdown projection과 component type별 최소 목차 기준을 우선한다.
|
|
38
|
+
|
|
9
39
|
## Profile 용어 구분
|
|
10
40
|
|
|
11
41
|
`ArtifactStandardProfile`은 산출물 표준 자체의 복수 작성 모드 후보 모델이며, 1차 DB 모델에서는 제외되어 있다.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@soddong/agentic-domain-artifact-standard",
|
|
3
|
-
"version": "0.11.
|
|
3
|
+
"version": "0.11.3",
|
|
4
4
|
"description": "Agentic Platform artifact standard domain package",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"type": "module",
|
|
@@ -20,7 +20,7 @@
|
|
|
20
20
|
"typecheck": "tsc -p tsconfig.json --noEmit"
|
|
21
21
|
},
|
|
22
22
|
"dependencies": {
|
|
23
|
-
"@soddong/agentic-contract-validation": "^0.2.
|
|
24
|
-
"@soddong/agentic-domain-document": "^0.7.
|
|
23
|
+
"@soddong/agentic-contract-validation": "^0.2.2",
|
|
24
|
+
"@soddong/agentic-domain-document": "^0.7.2"
|
|
25
25
|
}
|
|
26
26
|
}
|