@soddong/agentic-domain-artifact 0.7.0

package/dist/service.js

@@ -0,0 +1,282 @@
+import { randomUUID } from "node:crypto";
+import { ArtifactRepository } from "./repositories.js";
+const ALLOWED_ARTIFACT_STATUS_TRANSITIONS = {
+    draft: ["in_review", "deprecated"],
+    in_review: ["approved", "draft", "deprecated"],
+    approved: ["published", "deprecated"],
+    published: ["archived", "deprecated"],
+    archived: ["deprecated"],
+    deprecated: []
+};
+export class ArtifactService {
+    repository;
+    constructor(db) {
+        this.repository = new ArtifactRepository(db);
+    }
+    createArtifactInstance(input) {
+        return this.repository.createArtifactInstance(randomUUID(), input);
+    }
+    createArtifactInstanceFromActivityOutputs(input) {
+        const artifact = this.createArtifactInstance(input.artifact);
+        const components = [];
+        const resourceLinks = [];
+        const traceLinks = [];
+        for (const output of input.activityOutputs) {
+            const component = this.createComponentFromActivityOutput(artifact, output);
+            components.push(component);
+            traceLinks.push(this.addArtifactTraceLink({
+                artifactInstanceId: artifact.artifactInstanceId,
+                artifactComponentInstanceId: component.artifactComponentInstanceId,
+                sourceTypeCode: output.sourceTypeCode ?? "methodology_activity_artifact_requirement",
+                sourceRefId: output.sourceRefId,
+                traceTypeCode: output.traceTypeCode ?? "produced_by",
+                artifactStandardCode: artifact.artifactStandardCode,
+                artifactStandardVersion: artifact.artifactStandardVersion,
+                artifactComponentCode: component.artifactComponentCode,
+                metadata: output.metadata
+            }));
+            if (output.resource !== undefined) {
+                resourceLinks.push(this.addArtifactResourceLink({
+                    artifactInstanceId: artifact.artifactInstanceId,
+                    artifactComponentInstanceId: component.artifactComponentInstanceId,
+                    resourceTypeCode: output.resource.resourceTypeCode,
+                    resourceRef: output.resource.resourceRef,
+                    resourceRoleCode: output.resource.resourceRoleCode,
+                    isPrimary: output.resource.isPrimary,
+                    metadata: output.resource.metadata
+                }));
+            }
+        }
+        return {
+            artifact,
+            components,
+            resourceLinks,
+            traceLinks,
+            aggregate: this.getArtifactAggregate(artifact.artifactInstanceId)
+        };
+    }
+    getArtifactInstance(artifactInstanceId) {
+        return this.repository.getArtifactInstance(artifactInstanceId);
+    }
+    getArtifactInstanceByCodeVersion(artifactCode, artifactVersion) {
+        return this.repository.getArtifactInstanceByCodeVersion(artifactCode, artifactVersion);
+    }
+    findLatestArtifactInstanceByStandard(artifactStandardCode, artifactStandardVersion) {
+        return this.repository.findLatestArtifactInstanceByStandard(artifactStandardCode, artifactStandardVersion);
+    }
+    getArtifactAggregate(artifactInstanceId) {
+        return this.repository.getArtifactAggregate(artifactInstanceId);
+    }
+    resolveArtifactHandoff(input) {
+        const artifactInstance = this.findArtifactInstanceForHandoff(input);
+        const missing = [];
+        if (artifactInstance === undefined) {
+            return {
+                resolved: false,
+                components: [],
+                validationResultRefs: [],
+                reviewDecisionRefs: [],
+                missing: [
+                    {
+                        type: "artifact_instance",
+                        severity: "error",
+                        code: `${input.artifactStandardCode}@${input.artifactStandardVersion}`,
+                        message: "Artifact instance was not found for the requested handoff."
+                    }
+                ]
+            };
+        }
+        const aggregate = this.getArtifactAggregate(artifactInstance.artifactInstanceId);
+        if (aggregate.artifact.artifactStandardCode !== input.artifactStandardCode ||
+            aggregate.artifact.artifactStandardVersion !== input.artifactStandardVersion) {
+            missing.push({
+                type: "artifact_instance",
+                severity: "error",
+                code: aggregate.artifact.artifactInstanceId,
+                message: "Artifact instance standard does not match the requested handoff standard."
+            });
+        }
+        const requiredComponentCodes = [...(input.requiredComponentCodes ?? [])];
+        const componentByCode = new Map(aggregate.components.map((component) => [component.artifactComponentCode, component]));
+        const resourceTypeCode = input.requiredResourceTypeCode;
+        const components = requiredComponentCodes.map((componentCode) => {
+            const component = componentByCode.get(componentCode);
+            if (component === undefined) {
+                missing.push({
+                    type: "component",
+                    severity: "error",
+                    code: componentCode,
+                    artifactComponentCode: componentCode,
+                    message: `Required artifact component was not found: ${componentCode}`
+                });
+                return {
+                    artifactComponentCode: componentCode,
+                    resources: []
+                };
+            }
+            const resources = aggregate.resourceLinks.filter((resourceLink) => {
+                const componentMatches = resourceLink.artifactComponentInstanceId === component.artifactComponentInstanceId;
+                const resourceTypeMatches = resourceTypeCode === undefined || resourceLink.resourceTypeCode === resourceTypeCode;
+                return componentMatches && resourceTypeMatches;
+            });
+            const primaryResource = resources.find((resourceLink) => resourceLink.isPrimary === 1);
+            if (primaryResource === undefined) {
+                missing.push({
+                    type: "resource",
+                    severity: "error",
+                    code: resourceTypeCode ?? "primary_resource",
+                    artifactComponentCode: componentCode,
+                    resourceTypeCode,
+                    message: resourceTypeCode === undefined
+                        ? `Primary resource was not found for artifact component: ${componentCode}`
+                        : `Required primary resource was not found for artifact component: ${componentCode}`
+                });
+            }
+            return {
+                artifactComponentCode: componentCode,
+                component,
+                resources,
+                primaryResource
+            };
+        });
+        for (const resultRefCode of input.requiredResultRefs ?? []) {
+            const hasResultRef = this.hasRequiredResultRef(aggregate.validationResultRefs, aggregate.reviewDecisionRefs, resultRefCode);
+            if (hasResultRef) {
+                continue;
+            }
+            missing.push({
+                type: "result_ref",
+                severity: "error",
+                code: resultRefCode,
+                message: `Required handoff result reference was not found: ${resultRefCode}`
+            });
+        }
+        return {
+            resolved: missing.filter((item) => item.severity === "error").length === 0,
+            artifactInstance: aggregate.artifact,
+            components,
+            validationResultRefs: aggregate.validationResultRefs,
+            reviewDecisionRefs: aggregate.reviewDecisionRefs,
+            missing
+        };
+    }
+    addArtifactComponentInstance(input) {
+        return this.repository.addArtifactComponentInstance(randomUUID(), input);
+    }
+    listArtifactComponentInstances(artifactInstanceId) {
+        return this.repository.listArtifactComponentInstances(artifactInstanceId);
+    }
+    addArtifactResourceLink(input) {
+        return this.repository.addArtifactResourceLink(randomUUID(), input);
+    }
+    bindDocumentToArtifactComponent(input) {
+        return this.addArtifactResourceLink({
+            artifactInstanceId: input.artifactInstanceId,
+            artifactComponentInstanceId: input.artifactComponentInstanceId,
+            resourceTypeCode: "DOCUMENT_ID",
+            resourceRef: input.documentId,
+            resourceRoleCode: input.resourceRoleCode ?? "CONTENT",
+            isPrimary: input.isPrimary ?? true,
+            metadata: input.metadata
+        });
+    }
+    listArtifactResourceLinks(artifactInstanceId) {
+        return this.repository.listArtifactResourceLinks(artifactInstanceId);
+    }
+    addArtifactTraceLink(input) {
+        return this.repository.addArtifactTraceLink(randomUUID(), input);
+    }
+    listArtifactTraceLinks(artifactInstanceId) {
+        return this.repository.listArtifactTraceLinks(artifactInstanceId);
+    }
+    addArtifactValidationResultRef(input) {
+        return this.repository.addArtifactValidationResultRef(randomUUID(), input);
+    }
+    listArtifactValidationResultRefs(artifactInstanceId) {
+        return this.repository.listArtifactValidationResultRefs(artifactInstanceId);
+    }
+    addArtifactReviewDecisionRef(input) {
+        return this.repository.addArtifactReviewDecisionRef(randomUUID(), input);
+    }
+    listArtifactReviewDecisionRefs(artifactInstanceId) {
+        return this.repository.listArtifactReviewDecisionRefs(artifactInstanceId);
+    }
+    transitionArtifactStatus(input) {
+        const artifact = this.getArtifactInstance(input.artifactInstanceId);
+        this.assertAllowedArtifactStatusTransition(artifact.artifactStatusCode, input.toStatusCode);
+        this.assertReviewDecisionForStatusTransition(artifact.artifactStatusCode, input);
+        const statusEvent = this.repository.addArtifactStatusEvent(randomUUID(), {
+            ...input,
+            fromStatusCode: artifact.artifactStatusCode
+        });
+        const updatedArtifact = this.repository.updateArtifactStatus(input.artifactInstanceId, input.toStatusCode);
+        return {
+            artifact: updatedArtifact,
+            statusEvent
+        };
+    }
+    listArtifactStatusEvents(artifactInstanceId) {
+        return this.repository.listArtifactStatusEvents(artifactInstanceId);
+    }
+    findArtifactInstanceForHandoff(input) {
+        if (input.artifactInstanceId !== undefined) {
+            return this.getArtifactInstance(input.artifactInstanceId);
+        }
+        if (input.artifactCode !== undefined && input.artifactVersion !== undefined) {
+            return this.getArtifactInstanceByCodeVersion(input.artifactCode, input.artifactVersion);
+        }
+        return this.findLatestArtifactInstanceByStandard(input.artifactStandardCode, input.artifactStandardVersion);
+    }
+    createComponentFromActivityOutput(artifact, output) {
+        return this.addArtifactComponentInstance({
+            artifactInstanceId: artifact.artifactInstanceId,
+            artifactComponentCode: output.artifactComponentCode,
+            artifactComponentRoleCode: output.artifactComponentRoleCode,
+            componentInstanceName: output.componentInstanceName,
+            componentStatusCode: output.componentStatusCode,
+            sortOrder: output.sortOrder,
+            metadata: output.metadata
+        });
+    }
+    hasRequiredResultRef(validationResultRefs, reviewDecisionRefs, resultRefCode) {
+        if (resultRefCode === "validation_result") {
+            return validationResultRefs.length > 0;
+        }
+        if (resultRefCode === "review_decision") {
+            return reviewDecisionRefs.some((reviewDecisionRef) => reviewDecisionRef.decisionCode === "approved");
+        }
+        return validationResultRefs.some((validationResultRef) => {
+            const metadata = validationResultRef.metadata;
+            return (typeof metadata === "object" &&
+                metadata !== null &&
+                "resultRefCode" in metadata &&
+                metadata.resultRefCode === resultRefCode);
+        });
+    }
+    assertAllowedArtifactStatusTransition(fromStatusCode, toStatusCode) {
+        if (fromStatusCode === toStatusCode) {
+            throw new Error(`Artifact status is already ${toStatusCode}.`);
+        }
+        if (ALLOWED_ARTIFACT_STATUS_TRANSITIONS[fromStatusCode].includes(toStatusCode)) {
+            return;
+        }
+        throw new Error(`Artifact status transition is not allowed: ${fromStatusCode} -> ${toStatusCode}`);
+    }
+    assertReviewDecisionForStatusTransition(fromStatusCode, input) {
+        if (fromStatusCode !== "in_review" || (input.toStatusCode !== "approved" && input.toStatusCode !== "draft")) {
+            return;
+        }
+        if (input.artifactReviewDecisionRefId === undefined) {
+            throw new Error(`Artifact status transition requires a review decision ref: ${fromStatusCode} -> ${input.toStatusCode}`);
+        }
+        const reviewDecisionRef = this.repository.getArtifactReviewDecisionRef(input.artifactReviewDecisionRefId);
+        if (reviewDecisionRef.artifactInstanceId !== input.artifactInstanceId) {
+            throw new Error("Artifact review decision ref does not belong to the target artifact instance.");
+        }
+        const expectedDecisionCode = input.toStatusCode === "approved" ? "approved" : "changes_requested";
+        if (reviewDecisionRef.decisionCode !== expectedDecisionCode) {
+            throw new Error(`Artifact status transition requires ${expectedDecisionCode} review decision, got ${reviewDecisionRef.decisionCode}.`);
+        }
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,264 @@
+export interface ArtifactDatabaseOptions {
+    readonly projectRoot?: string;
+    readonly databasePath?: string;
+    readonly applyMigration?: boolean;
+}
+export interface ArtifactDatabaseInitResult {
+    readonly databasePath: string;
+    readonly created: boolean;
+    readonly tables: string[];
+}
+export type ArtifactStatusCode = "draft" | "in_review" | "approved" | "published" | "archived" | "deprecated";
+export type ArtifactComponentStatusCode = ArtifactStatusCode;
+export type ArtifactResourceTypeCode = "DOCUMENT_ID" | "FILE_PATH" | "URL" | "AGENT_RESOURCE_REF";
+export type ArtifactResourceRoleCode = "CONTENT" | "RENDERED_OUTPUT" | "SOURCE" | "REFERENCE" | "ATTACHMENT";
+export type ArtifactTraceTypeCode = "produced_by" | "refined_by" | "reviewed_by" | "consolidated_by" | "derived_from" | "references";
+export type ArtifactValidationStatusCode = "valid" | "invalid" | "warning" | "not_run";
+export type ArtifactReviewScopeCode = "artifact_instance" | "artifact_component" | "stage" | "activity";
+export type ArtifactReviewDecisionCode = "approved" | "changes_requested" | "rejected" | "deferred";
+export type ArtifactStatusScopeCode = "artifact_instance" | "artifact_component";
+export interface ArtifactInstanceRecord {
+    readonly artifactInstanceId: string;
+    readonly artifactCode: string;
+    readonly artifactName: string;
+    readonly artifactVersion: string;
+    readonly artifactStandardCode: string;
+    readonly artifactStandardVersion: string;
+    readonly artifactStatusCode: ArtifactStatusCode;
+    readonly methodologyActivityId?: string;
+    readonly ownerRoleCode?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly metadata?: unknown;
+}
+export interface ArtifactComponentInstanceRecord {
+    readonly artifactComponentInstanceId: string;
+    readonly artifactInstanceId: string;
+    readonly artifactComponentCode: string;
+    readonly artifactComponentRoleCode?: string;
+    readonly componentInstanceName: string;
+    readonly componentStatusCode: ArtifactComponentStatusCode;
+    readonly sortOrder: number;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly metadata?: unknown;
+}
+export interface ArtifactResourceLinkRecord {
+    readonly artifactResourceLinkId: string;
+    readonly artifactInstanceId: string;
+    readonly artifactComponentInstanceId?: string;
+    readonly resourceTypeCode: ArtifactResourceTypeCode;
+    readonly resourceRef: string;
+    readonly resourceRoleCode: ArtifactResourceRoleCode;
+    readonly isPrimary: number;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly metadata?: unknown;
+}
+export interface ArtifactTraceLinkRecord {
+    readonly artifactTraceLinkId: string;
+    readonly artifactInstanceId: string;
+    readonly artifactComponentInstanceId?: string;
+    readonly sourceTypeCode: string;
+    readonly sourceRefId: string;
+    readonly traceTypeCode: ArtifactTraceTypeCode;
+    readonly artifactStandardCode?: string;
+    readonly artifactStandardVersion?: string;
+    readonly artifactComponentCode?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly metadata?: unknown;
+}
+export interface ArtifactValidationResultRefRecord {
+    readonly artifactValidationResultRefId: string;
+    readonly artifactInstanceId: string;
+    readonly artifactComponentInstanceId?: string;
+    readonly validationProviderId: string;
+    readonly validationProfileId: string;
+    readonly validationResultRef: string;
+    readonly validationStatusCode: ArtifactValidationStatusCode;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly metadata?: unknown;
+}
+export interface ArtifactReviewDecisionRefRecord {
+    readonly artifactReviewDecisionRefId: string;
+    readonly artifactInstanceId: string;
+    readonly artifactComponentInstanceId?: string;
+    readonly reviewScopeCode: ArtifactReviewScopeCode;
+    readonly decisionCode: ArtifactReviewDecisionCode;
+    readonly reviewerRef?: string;
+    readonly decisionReason?: string;
+    readonly decisionResultRef: string;
+    readonly decidedAt: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly metadata?: unknown;
+}
+export interface ArtifactStatusEventRecord {
+    readonly artifactStatusEventId: string;
+    readonly artifactInstanceId: string;
+    readonly artifactComponentInstanceId?: string;
+    readonly statusScopeCode: ArtifactStatusScopeCode;
+    readonly fromStatusCode: ArtifactStatusCode;
+    readonly toStatusCode: ArtifactStatusCode;
+    readonly transitionReason?: string;
+    readonly actorRef?: string;
+    readonly artifactReviewDecisionRefId?: string;
+    readonly createdAt: string;
+    readonly metadata?: unknown;
+}
+export interface ArtifactAggregate {
+    readonly artifact: ArtifactInstanceRecord;
+    readonly components: readonly ArtifactComponentInstanceRecord[];
+    readonly resourceLinks: readonly ArtifactResourceLinkRecord[];
+    readonly traceLinks: readonly ArtifactTraceLinkRecord[];
+    readonly validationResultRefs: readonly ArtifactValidationResultRefRecord[];
+    readonly reviewDecisionRefs: readonly ArtifactReviewDecisionRefRecord[];
+    readonly statusEvents: readonly ArtifactStatusEventRecord[];
+}
+export type ArtifactHandoffMissingType = "artifact_instance" | "component" | "resource" | "result_ref";
+export type ArtifactHandoffMissingSeverity = "error" | "warning";
+export interface ResolveArtifactHandoffInput {
+    readonly artifactInstanceId?: string;
+    readonly artifactCode?: string;
+    readonly artifactVersion?: string;
+    readonly artifactStandardCode: string;
+    readonly artifactStandardVersion: string;
+    readonly requiredComponentCodes?: readonly string[];
+    readonly requiredResultRefs?: readonly string[];
+    readonly requiredResourceTypeCode?: ArtifactResourceTypeCode;
+}
+export interface ArtifactHandoffResolvedComponent {
+    readonly artifactComponentCode: string;
+    readonly component?: ArtifactComponentInstanceRecord;
+    readonly resources: readonly ArtifactResourceLinkRecord[];
+    readonly primaryResource?: ArtifactResourceLinkRecord;
+}
+export interface ArtifactHandoffMissingItem {
+    readonly type: ArtifactHandoffMissingType;
+    readonly severity: ArtifactHandoffMissingSeverity;
+    readonly code: string;
+    readonly artifactComponentCode?: string;
+    readonly resourceTypeCode?: ArtifactResourceTypeCode;
+    readonly message: string;
+}
+export interface ResolveArtifactHandoffResult {
+    readonly resolved: boolean;
+    readonly artifactInstance?: ArtifactInstanceRecord;
+    readonly components: readonly ArtifactHandoffResolvedComponent[];
+    readonly validationResultRefs: readonly ArtifactValidationResultRefRecord[];
+    readonly reviewDecisionRefs: readonly ArtifactReviewDecisionRefRecord[];
+    readonly missing: readonly ArtifactHandoffMissingItem[];
+}
+export interface CreateArtifactInstanceInput {
+    readonly artifactCode: string;
+    readonly artifactName: string;
+    readonly artifactVersion?: string;
+    readonly artifactStandardCode: string;
+    readonly artifactStandardVersion: string;
+    readonly artifactStatusCode?: ArtifactStatusCode;
+    readonly methodologyActivityId?: string;
+    readonly ownerRoleCode?: string;
+    readonly metadata?: unknown;
+}
+export interface AddArtifactComponentInstanceInput {
+    readonly artifactInstanceId: string;
+    readonly artifactComponentCode: string;
+    readonly artifactComponentRoleCode?: string;
+    readonly componentInstanceName: string;
+    readonly componentStatusCode?: ArtifactComponentStatusCode;
+    readonly sortOrder?: number;
+    readonly metadata?: unknown;
+}
+export interface AddArtifactResourceLinkInput {
+    readonly artifactInstanceId: string;
+    readonly artifactComponentInstanceId?: string;
+    readonly resourceTypeCode: ArtifactResourceTypeCode;
+    readonly resourceRef: string;
+    readonly resourceRoleCode?: ArtifactResourceRoleCode;
+    readonly isPrimary?: boolean;
+    readonly metadata?: unknown;
+}
+export interface ArtifactActivityOutputResourceInput {
+    readonly resourceTypeCode: ArtifactResourceTypeCode;
+    readonly resourceRef: string;
+    readonly resourceRoleCode?: ArtifactResourceRoleCode;
+    readonly isPrimary?: boolean;
+    readonly metadata?: unknown;
+}
+export interface ArtifactActivityOutputInput {
+    readonly sourceRefId: string;
+    readonly sourceTypeCode?: string;
+    readonly artifactComponentCode: string;
+    readonly artifactComponentRoleCode?: string;
+    readonly componentInstanceName: string;
+    readonly componentStatusCode?: ArtifactComponentStatusCode;
+    readonly sortOrder?: number;
+    readonly traceTypeCode?: ArtifactTraceTypeCode;
+    readonly resource?: ArtifactActivityOutputResourceInput;
+    readonly metadata?: unknown;
+}
+export interface CreateArtifactInstanceFromActivityOutputsInput {
+    readonly artifact: CreateArtifactInstanceInput;
+    readonly activityOutputs: readonly ArtifactActivityOutputInput[];
+}
+export interface CreateArtifactInstanceFromActivityOutputsResult {
+    readonly artifact: ArtifactInstanceRecord;
+    readonly components: readonly ArtifactComponentInstanceRecord[];
+    readonly resourceLinks: readonly ArtifactResourceLinkRecord[];
+    readonly traceLinks: readonly ArtifactTraceLinkRecord[];
+    readonly aggregate: ArtifactAggregate;
+}
+export interface BindDocumentToArtifactComponentInput {
+    readonly artifactInstanceId: string;
+    readonly artifactComponentInstanceId: string;
+    readonly documentId: string;
+    readonly resourceRoleCode?: ArtifactResourceRoleCode;
+    readonly isPrimary?: boolean;
+    readonly metadata?: unknown;
+}
+export interface AddArtifactTraceLinkInput {
+    readonly artifactInstanceId: string;
+    readonly artifactComponentInstanceId?: string;
+    readonly sourceTypeCode: string;
+    readonly sourceRefId: string;
+    readonly traceTypeCode: ArtifactTraceTypeCode;
+    readonly artifactStandardCode?: string;
+    readonly artifactStandardVersion?: string;
+    readonly artifactComponentCode?: string;
+    readonly metadata?: unknown;
+}
+export interface AddArtifactValidationResultRefInput {
+    readonly artifactInstanceId: string;
+    readonly artifactComponentInstanceId?: string;
+    readonly validationProviderId: string;
+    readonly validationProfileId: string;
+    readonly validationResultRef: string;
+    readonly validationStatusCode: ArtifactValidationStatusCode;
+    readonly metadata?: unknown;
+}
+export interface AddArtifactReviewDecisionRefInput {
+    readonly artifactInstanceId: string;
+    readonly artifactComponentInstanceId?: string;
+    readonly reviewScopeCode?: ArtifactReviewScopeCode;
+    readonly decisionCode: ArtifactReviewDecisionCode;
+    readonly reviewerRef?: string;
+    readonly decisionReason?: string;
+    readonly decisionResultRef: string;
+    readonly decidedAt?: string;
+    readonly metadata?: unknown;
+}
+export interface TransitionArtifactStatusInput {
+    readonly artifactInstanceId: string;
+    readonly toStatusCode: ArtifactStatusCode;
+    readonly actorRef?: string;
+    readonly transitionReason?: string;
+    readonly artifactReviewDecisionRefId?: string;
+    readonly metadata?: unknown;
+}
+export interface TransitionArtifactStatusResult {
+    readonly artifact: ArtifactInstanceRecord;
+    readonly statusEvent: ArtifactStatusEventRecord;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/docs/build.md

@@ -0,0 +1,19 @@
+# Build
+
+| 항목 | 값 |
+| --- | --- |
+| package | `@soddong/agentic-domain-artifact` |
+| current version | `0.7.0` |
+| workspace | `packages/agentic-domain-artifact` |
+
+개발 검증 명령은 다음과 같다.
+
+```bash
+npm run build --workspace @soddong/agentic-domain-artifact
+npm run typecheck --workspace @soddong/agentic-domain-artifact
+npm run schema:doc:agentic-domain-artifact
+npm run dev:test:agentic-domain-artifact
+npm run dev:test:artifact-methodology-standard-document-integration
+npm run consistency:check
+npm pack --workspace @soddong/agentic-domain-artifact --dry-run --cache /private/tmp/agentic-npm-cache
+```

package/docs/configuration.md

@@ -0,0 +1,27 @@
+# Configuration
+
+기본 DB 경로는 consumer project의 `.agentic/platform.sqlite`다.
+
+`agentic.config.json`에 runtime database path가 있으면 해당 값을 따른다.
+
+```json
+{
+  "runtime": {
+    "database": {
+      "type": "sqlite",
+      "path": ".agentic/platform.sqlite"
+    }
+  }
+}
+```
+
+명시 경로를 사용하려면 API option을 전달한다.
+
+```ts
+openArtifactDatabase({
+  projectRoot: process.cwd(),
+  databasePath: ".agentic/platform.sqlite"
+});
+```
+
+패키지 내부에는 registry URL, 절대 DB 경로, consumer별 환경 값을 고정하지 않는다.

package/docs/delivery.md

@@ -0,0 +1,22 @@
+# Delivery
+
+현재 delivery 대상은 npm package와 artifact instance SQLite schema다.
+
+| 항목 | 값 |
+| --- | --- |
+| package | `@soddong/agentic-domain-artifact` |
+| install version | `0.7.0` |
+| install registry | `https://registry.npmjs.org/` |
+
+포함 대상:
+
+```text
+dist
+README.md
+CHANGELOG.md
+.tbls.yml
+docs
+src/database/migrations
+```
+
+DB migration, generated schema docs, fixture helper, Activity output 기반 조립 helper, document binding helper, sampleExecution seed apply handler는 package에 포함한다. 실제 document 저장, validation 실행, render 실행은 각각 관련 domain/capability 책임이다.