@soddong/agentic-runtime 0.16.0

package/.tbls.yml

@@ -0,0 +1,103 @@
+name: agentic-runtime
+desc: Agentic Platform local execution runtime database.
+
+dsn: ${AGENTIC_RUNTIME_SCHEMA_DSN}
+docPath: ${AGENTIC_RUNTIME_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:
+  - agentic_*
+
+comments:
+  - table: agentic_runtime_metadata
+    tableComment: 런타임 DB 식별과 runtime-level metadata를 관리한다.
+    columnComments:
+      metadata_key: metadata 항목 식별자
+      metadata_value: metadata 값
+      value_type: metadata 값의 논리 타입
+      metadata_description: metadata 항목 설명
+      updated_at: metadata 최종 수정 시각
+
+  - table: agentic_schema_migrations
+    tableComment: runtime 및 각 패키지의 SQLite schema migration 적용 이력을 관리한다.
+    columnComments:
+      package_name: migration을 제공한 패키지명
+      migration_id: migration 식별자
+      checksum_sha256: migration 파일 내용 검증용 SHA-256 checksum
+      applied_by_runtime_version: migration을 적용한 runtime version
+      applied_at: migration 적용 시각
+
+  - table: agentic_project_modules
+    tableComment: 현재 실행 프로젝트에 등록된 Agentic package 상태를 관리한다.
+    columnComments:
+      package_name: Agentic package 이름
+      package_version: 등록된 package version
+      module_layer: runtime, domain, capability, application, support 등 패키지 계층
+      manifest_json: package manifest snapshot
+      is_enabled: 프로젝트 내 활성화 여부
+      registered_at: 프로젝트에 등록된 시각
+      updated_at: 등록 상태 최종 수정 시각
+
+  - table: agentic_user_requests
+    tableComment: 사용자 지시 원문과 접수 정보를 관리한다.
+    columnComments:
+      request_id: 사용자 지시 식별자
+      request_text: 사용자 지시 원문
+      request_source: 지시 유입 경로
+      context_json: 지시 context snapshot
+      created_at: 지시 접수 시각
+
+  - table: agentic_execution_runs
+    tableComment: 사용자 지시 또는 runtime command의 실행 단위를 관리한다.
+    columnComments:
+      run_id: 실행 식별자
+      request_id: 사용자 지시 식별자
+      package_name: 실행을 담당한 package 이름
+      command_name: 실행된 command 또는 agent 식별자
+      run_type: 실행 종류
+      run_status: 실행 상태
+      started_at: 실행 시작 시각
+      ended_at: 실행 종료 시각
+      duration_ms: 실행 소요 시간
+      exit_code: process exit code
+      error_message: 실패 또는 취소 사유
+      run_options_json: 실행 option snapshot
+      created_at: 실행 생성 시각
+
+  - table: agentic_execution_logs
+    tableComment: 실행 중 발생한 로그와 이벤트를 순서대로 관리한다.
+    columnComments:
+      log_id: 로그 식별자
+      run_id: 실행 식별자
+      sequence_no: 실행 내 로그 순번
+      log_level: 로그 레벨
+      log_type: 로그 종류
+      message: 로그 메시지
+      payload_json: 구조화 로그 payload
+      created_at: 로그 생성 시각
+
+  - table: agentic_execution_outputs
+    tableComment: 실행 결과를 구조화하여 관리한다.
+    columnComments:
+      output_id: 실행 결과 식별자
+      run_id: 실행 식별자
+      output_type: 결과 종류
+      content_text: text 결과
+      content_json: JSON 결과
+      file_path: 파일 결과 경로
+      created_at: 결과 생성 시각

package/CHANGELOG.md

@@ -0,0 +1,229 @@
+# Changelog
+
+## 0.16.0
+
+- npm public publish 기준 package name을 `@soddong/` scoped package 체계로 정렬
+- `agentic project create --bundle <bundle-code> --code <project-code> --name <project-name>` CLI를 추가해 적용 완료된 bundle 기준 execution project stage/activity snapshot을 생성
+- `agentic project status --code <project-code>` CLI를 추가해 execution project의 stage/activity 진행 상태와 예상 산출물 생성 현황을 조회
+- `agentic_execution_projects`, `agentic_execution_project_stages`, `agentic_execution_project_activities` runtime DB table을 추가
+- runtime README, usage, publishing, operations, delivery 문서를 scoped package 및 execution project lifecycle 기준으로 갱신
+
+## 0.15.2
+
+- seed target package readiness와 version 확인을 project top-level `node_modules/<package>/package.json` 기준으로 보정해 nested dependency가 required package로 오인되는 문제를 방지
+- `agentic seed apply`와 `agentic bundle apply`가 `blocked` 상태를 성공 exit code로 반환하지 않도록 `applied` 상태에서만 exit code 0을 반환하게 변경
+
+## 0.15.1
+
+- `bundle apply --install-required` 실제 consumer 경로에서 seed target package handler를 호출할 때 runtime DB connection을 열어둔 채 같은 SQLite DB를 재진입하지 않도록 보정
+- target package handler 실행 전후로 runtime seed apply 상태 DB connection을 짧게 열고 닫도록 변경해 `database disk image is malformed` 재현 위험을 낮춤
+- `@soddong/agentic-methodology-ai-agent-sdlc` seed bundle 적용 문서 기준을 `@soddong/agentic-runtime@0.15.1` 이상으로 갱신
+
+## 0.15.0
+
+- `agentic bundle apply <package-name> --install-required` 옵션을 추가해 bundle provider package와 `requires.packages` target packages를 npm으로 자동 설치할 수 있게 함
+- `--install-required` 실행 시 package.json이 없는 execution project에는 최소 npm project package.json을 생성하도록 보강
+- `bundle apply` 결과에 npm package install summary를 표시하도록 개선
+- runtime dev-test에 mock npm 기반 `bundle apply --install-required` 검증 추가
+
+## 0.14.0
+
+- `agentic bundle apply <package-name> --bundle <bundle-code>` CLI를 추가해 project init, bundle install, required package 자동 등록, seed import, seed apply를 한 번에 수행할 수 있게 함
+- bundle manifest의 `requires.packages`를 읽어 consumer project에 설치된 target packages를 `agentic_project_modules`에 자동 등록
+- `bundle apply` 1차 범위는 npm package 자동 설치를 수행하지 않고, 이미 설치된 packages의 자동 등록과 seed 적용으로 제한
+- `bundle apply --strict-required` 옵션을 추가해 required package 누락 또는 단순 version range 불일치 시 seed 적용 전에 차단할 수 있게 함
+- runtime dev-test에 `bundle apply` 단일 명령으로 seed apply가 완료되는 사용성 검증 추가
+
+## Unreleased
+
+- `agentic seed apply` CLI를 추가해 seed import plan을 target package `applyAgenticSeed` handler로 적용할 수 있게 함
+- `applySeedImportPlan` runtime API와 `AgenticSeedApplyInput`/`AgenticSeedApplyResult` contract를 추가
+- seed apply 1차 범위는 target package 자동 설치와 global rollback 없이 item별 applied/blocked/failed 상태 기록으로 제한
+- `agentic_seed_import_items.item_status`에 `failed`를 추가하는 `0004_runtime_seed_apply_status` migration을 추가
+- `agentic seed import/status` CLI를 추가해 installed bundle 기준 dry-run import plan을 생성하고 조회할 수 있게 함
+- `agentic_seed_import_runs`, `agentic_seed_import_items` runtime DB table을 추가해 seed import plan과 blocked target package를 추적
+- seed import 1차 범위는 domain DB write 없이 target package 준비 상태와 import item plan을 기록하는 방식으로 제한
+- `agentic bundle install/list/status` CLI와 project bundle registry를 추가
+- `agentic_project_bundles` runtime DB table을 추가해 consumer 프로젝트의 installed seed/methodology bundle 상태를 관리
+- bundle install 시 installed package의 bundle loader와 validator를 호출하고, package module registry와 bundle registry를 함께 갱신
+- Codex adapter 표준 전역 bridge selector를 `agentic-runtime-codex@agentic-runtime`으로 정리
+- Codex adapter hook command를 optional project hook 방식으로 변경해 `.agentic/bin/agentic-hook.mjs`가 없는 프로젝트에서는 성공 no-op 처리
+- 전역 Codex plugin 등록이 남아 있더라도 @soddong/agentic-runtime 미초기화 프로젝트에서 `UserPromptSubmit`/`Stop` hook이 `MODULE_NOT_FOUND`로 실패하지 않도록 보완
+- 다른 marketplace에 설치된 `agentic-runtime-codex@*` 중복 bridge를 감지해 정리 필요성을 안내
+- npm registry 기준을 공식 npm registry 기본값으로 문서화하고, token 실값 미기재 원칙과 `npm publish --dry-run --access public` 검증 절차를 README/usage/publishing/operations 문서에 반영
+- 공식 npm registry 기준 전체 workspace package publish 상태와 최신 consumer 설치 검증 결과를 문서에 반영
+
+## 0.10.6
+
+- execution 이력 조회 명령이 runtime DB migration/metadata 갱신 경로를 타지 않도록 조회 전용 read-only DB open으로 변경
+- Codex 등 read-only sandbox 환경에서 `execution list/latest/show/summary` 조회 안정성을 개선
+- 쓰기 작업인 `db init`, `hook record`, `run`, migration, module register 경로는 기존 writable DB open을 유지
+
+## 0.10.5
+
+- legacy generated `.agentic/AGENTS.md` 앞부분과 새 managed block이 섞인 consumer 파일을 자동 정리하도록 보완
+- 기존 consumer upgrade 시 legacy prefix가 남아 중복 지침처럼 보이는 문제 방지
+- mixed legacy instructions migration dev-test 추가
+
+## 0.10.4
+
+- marker 없는 legacy `.agentic/AGENTS.md` generated template을 새 managed block 형식으로 교체하도록 보완
+- 기존 consumer의 오래된 @soddong/agentic-runtime 지침 템플릿에 새 managed block이 중복 append되는 문제 방지
+- legacy generated instructions migration dev-test 추가
+
+## 0.10.3
+
+- `.agentic/AGENTS.md` managed block에 이전 완료 이력 조회 시 `--status succeeded`를 우선 사용하도록 기준 추가
+- Codex plugin `agentic-runtime-usage` skill에 현재 실행 중인 자기 run과 이전 완료 run을 구분하는 조회 기준 추가
+- README와 usage 문서에 `--status succeeded`, `--status running`, `--status failed` 사용 기준 보강
+
+## 0.10.2
+
+- execution range 계산을 프로젝트 시간 처리 기준에 맞게 보완
+- `today`, `yesterday`, `this-week`, `last-week`, `this-month`, `last-month`를 KST calendar boundary로 계산한 뒤 UTC SQL boundary로 변환
+- `7d`, `30d`를 calendar day가 아닌 현재 시각 기준 rolling range로 정정
+- 날짜형 `--from`, `--to` 입력은 KST 날짜 boundary로 해석하도록 보완
+
+## 0.10.1
+
+- `.agentic/AGENTS.md`를 versioned managed block으로 생성/갱신하도록 변경
+- `adapter install` 실행 시 기존 consumer 프로젝트의 `.agentic/AGENTS.md` managed block version을 확인하고 낮은 버전이면 block만 갱신
+- 기존 consumer 지침 갱신 시 사용자 작성 영역을 보존하는 dev-test 추가
+- execution timestamp 저장은 UTC, calendar range 해석은 기본 KST 기준이라는 문서 기준 추가
+
+## 0.10.0
+
+- `@soddong/agentic-capability-agent-client@0.4.0` resource selection 계약 반영
+- 등록된 agent contribution 기준 `selectRegisteredAgentResources` API 추가
+- 등록된 agent contribution과 package root 기준 `assembleRegisteredAgentContext` API 추가
+- `agentic agent register <package-name>` CLI 명령 추가
+- `agentic agent context "<user request>" [--format text|json]` CLI 명령 추가
+- Codex, Kiro, Claude Code adapter 생성 지침에 Agent Resource Context 사용 기준 추가
+- runtime agent contribution shape 검증에서 `resourceSelection` 지원
+- runtime router dev-test에 resource bundle 선택 검증 추가
+
+## 0.9.0
+
+- `@soddong/agentic-capability-agent-client@0.3.0` resource index 계약 반영
+- Agent contribution의 instruction set 참조를 resource index 참조로 변경
+- runtime agent contribution shape 검증에서 instructions, guides, examples, validationRules, sources 리소스 그룹 지원
+- runtime router dev-test fixture에 `resourceGroups.order` 계약 반영
+- runtime router dev-test를 `resourceIndex` 기준으로 갱신
+
+## 0.8.0
+
+- `@soddong/agentic-capability-agent-client` contract 패키지 의존성 추가
+- runtime agent 실행 타입을 Agent Client contract와 정렬
+- 등록된 module manifest 기반 `registerAgentManifest`, `listRegisteredAgentManifests`, `routeRegisteredAgents` API 추가
+- Agent contribution 기반 `registerAgentContribution`, `listRegisteredAgentContributions` API 추가
+- route decision에서 선택된 contribution의 instruction set 참조 지원 추가
+- runtime dev-test에 agent manifest 등록 및 rule-based route decision 검증 추가
+
+## 0.7.5
+
+- Kiro default agent 지정 시 `kiro` 런처가 아니라 `kiro-cli agent set-default kiro_with_hooks`만 사용하도록 수정
+- `kiro` 명령이 IDE 탭을 여는 경우를 피하기 위해 Kiro CLI 감지도 `kiro-cli --version` 기준으로 변경
+- README와 usage 문서에 `kiro-cli` 및 `kiro_with_hooks` 확인 절차 추가
+
+## 0.7.4
+
+- Codex/Kiro/Claude Code adapter hook command를 `npx agentic hook record`에서 project-local wrapper `node .agentic/bin/agentic-hook.mjs`로 변경
+- `agentic init`과 `adapter install` 자동 초기화 경로에서 `.agentic/bin/agentic-hook.mjs` 생성 추가
+- hook wrapper 직접 실행 dev-test 추가
+- README와 usage 문서에 hook wrapper 기반 실행 방식을 반영
+
+## 0.7.3
+
+- `agentic adapter install <adapter>` 실행 시 프로젝트가 초기화되지 않았으면 `init`과 `db init`을 자동 수행하도록 변경
+- setup 없이 adapter install만 실행하는 consumer 최초 설치 시나리오를 dev-test에 추가
+- README와 usage 문서에 `setup`과 `adapter install`의 실행 관계를 명시
+
+## 0.7.2
+
+- Kiro CLI V2 hook agent 이름을 `kiro_default`에서 `kiro_with_hooks`로 변경
+- `agentic adapter install kiro --set-default` 옵션 추가
+- Kiro CLI V2 사용 시 `kiro-cli --agent kiro_with_hooks` 또는 `kiro-cli agent set-default kiro_with_hooks`가 필요함을 문서화
+
+## 0.7.1
+
+- Kiro adapter를 Kiro CLI V2, Kiro CLI V3 Early Access, Kiro IDE 호환 구조로 보완
+- Kiro CLI V3 standalone hook 파일 `.kiro/hooks/agentic-runtime.json` 생성/병합 추가
+- Kiro CLI V2 agent config `.kiro/agents/kiro_default.json` embedded hook 생성/병합 추가
+- Kiro adapter status 출력에서 V2/V3/IDE hook 상태를 분리해 표시
+- README와 usage 문서의 Kiro adapter 설명을 V2/V3/IDE 병행 지원 기준으로 갱신
+
+## 0.7.0
+
+- Claude Code adapter 추가
+- `agentic adapter install/status claude-code` 명령 추가
+- `.claude/settings.json`에 `UserPromptSubmit`, `Stop` command hook 자동 병합 지원
+- `agentic hook record --source claude-code --event UserPromptSubmit|Stop` 지원 추가
+
+## 0.6.1
+
+- Kiro UI Hook 수동 등록 절차를 README, usage, 생성 hook guide에 보강
+
+## 0.6.0
+
+- Kiro adapter 준비 기능 추가
+- `agentic adapter install/status kiro` 명령 추가
+- `agentic hook record --source kiro --event PromptSubmit|AgentStop` 지원 추가
+- Kiro steering 및 Hook UI 설정 가이드 생성 추가
+
+## 0.5.1
+
+- Codex plugin manifest version을 `@soddong/agentic-runtime` package version과 동기화
+
+## 0.5.0
+
+- execution 이력 조회 wrapper/API 추가
+- `agentic execution list/latest/show/summary` CLI 명령 추가
+- Codex skill과 `.agentic/AGENTS.md` 템플릿에 execution 이력 조회 정책 반영
+- 구축 중 로컬 dev-test에 execution 조회 검증 추가
+
+## 0.4.2
+
+- Codex Stop hook payload의 `last_assistant_message` 계열 필드를 실행 결과 text로 저장하도록 보완
+
+## 0.4.1
+
+- Codex plugin 설치 명령을 현재 Codex CLI 기준인 `codex plugin add agentic-runtime-codex@local-agentic`로 수정
+- Codex adapter prepare-only 메시지를 `plugin add` 기준으로 정리
+- README와 usage 문서의 설치 예시 버전을 `0.4.1`로 갱신
+
+## 0.1.3
+
+- `better-sqlite3` 기반 로컬 SQLite 초기화 기능 추가
+- `agentic db init` 명령 추가
+- `agentic db status` 명령 추가
+- runtime metadata, schema migration, installed module 추적용 기본 테이블 추가
+- 사용자 지시, 실행 단위, 실행 로그, 실행 결과 테이블 추가
+- `runRuntimeExecution()`, `runAgentRuntimeClient()` 실행 기록 API 추가
+- `agentic run "<user request>"` 명령 추가
+- `agentic init` 실행 시 `.agentic/AGENTS.md` 지침 템플릿 생성
+- `agentic setup --adapter codex` 명령 추가
+- `agentic hook record --source codex --event UserPromptSubmit|Stop` 명령 추가
+- `agentic adapter install/status codex` 명령 추가
+- Codex plugin, hook, skill, marketplace 생성 기능 추가
+- `agentic module register`, `agentic module list` 명령 추가
+- `registerProjectModule()`, `listProjectModules()` module registry API 추가
+
+## 0.1.2
+
+- `agentic init` 명령 추가
+- `agentic docs` 명령 추가
+- `agentic config` 명령 추가
+- CLI 버전을 `package.json`에서 읽도록 변경
+
+## 0.1.1
+
+- 패키지 문서를 npm 관례에 맞춰 `docs/` 하위로 재구성
+- `CHANGELOG.md` 추가
+- `bin.agentic` 경로를 npm publish 정규화 형식으로 정리
+
+## 0.1.0
+
+- `@soddong/agentic-runtime` npm 패키지 초기 구성
+- `agentic` CLI 명령 제공
+- `agentic --version`, `agentic --help` 지원
+- 구축 환경 publish 및 운영환경 install 검증 문서 제공