@soddong/agentic-runtime 0.16.0

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@soddong/agentic-runtime",
+  "version": "0.16.0",
+  "description": "Agentic Platform local execution runtime and CLI",
+  "license": "UNLICENSED",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "agentic": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    ".tbls.yml",
+    "docs",
+    "src/database/migrations"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.11.1",
+    "@soddong/agentic-capability-agent-client": "^0.4.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13"
+  }
+}

package/src/database/migrations/0001_runtime_base.sql

@@ -0,0 +1,231 @@
+PRAGMA foreign_keys = ON;
+
+-- runtime DB 식별과 runtime-level metadata를 관리한다.
+CREATE TABLE IF NOT EXISTS agentic_runtime_metadata (
+  -- metadata 항목 식별자
+  metadata_key VARCHAR(128) PRIMARY KEY,
+
+  -- metadata 값
+  metadata_value TEXT NOT NULL,
+
+  -- metadata 값의 논리 타입
+  value_type VARCHAR(16) NOT NULL DEFAULT 'string'
+    CHECK (value_type IN ('string', 'integer', 'boolean', 'json')),
+
+  -- metadata 항목 설명
+  metadata_description TEXT,
+
+  -- metadata 최종 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+-- runtime 및 각 패키지의 SQLite schema migration 적용 이력을 관리한다.
+CREATE TABLE IF NOT EXISTS agentic_schema_migrations (
+  -- migration을 제공한 패키지명
+  package_name VARCHAR(214) NOT NULL,
+
+  -- migration 식별자
+  migration_id VARCHAR(128) NOT NULL,
+
+  -- migration 파일 내용 검증용 SHA-256 checksum
+  checksum_sha256 CHAR(64)
+    CHECK (checksum_sha256 IS NULL OR length(checksum_sha256) = 64),
+
+  -- migration을 적용한 runtime version
+  applied_by_runtime_version VARCHAR(64),
+
+  -- migration 적용 시각
+  applied_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  PRIMARY KEY (package_name, migration_id)
+);
+
+-- 현재 실행 프로젝트에 등록된 Agentic package 상태를 관리한다.
+CREATE TABLE IF NOT EXISTS agentic_project_modules (
+  -- Agentic package 이름
+  package_name VARCHAR(214) PRIMARY KEY,
+
+  -- 등록된 package version
+  package_version VARCHAR(64) NOT NULL,
+
+  -- runtime, domain, capability, application, support 등 패키지 계층
+  module_layer VARCHAR(32)
+    CHECK (
+      module_layer IS NULL OR
+      module_layer IN ('runtime', 'domain', 'capability', 'application', 'support')
+    ),
+
+  -- package manifest snapshot
+  manifest_json JSON NOT NULL DEFAULT '{}'
+    CHECK (json_valid(manifest_json)),
+
+  -- 프로젝트 내 활성화 여부. 1은 활성, 0은 비활성
+  is_enabled INTEGER NOT NULL DEFAULT 1
+    CHECK (is_enabled IN (0, 1)),
+
+  -- 프로젝트에 등록된 시각
+  registered_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 등록 상태 최종 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 사용자 지시 원문과 접수 정보를 관리한다.
+CREATE TABLE IF NOT EXISTS agentic_user_requests (
+  -- 사용자 지시 식별자
+  request_id CHAR(36) PRIMARY KEY
+    CHECK (length(request_id) = 36),
+
+  -- 사용자 지시 원문
+  request_text TEXT NOT NULL,
+
+  -- 지시 유입 경로. cli, api, test 등
+  request_source VARCHAR(32) NOT NULL DEFAULT 'cli'
+    CHECK (request_source IN ('cli', 'api', 'test', 'system')),
+
+  -- 지시 context snapshot
+  context_json JSON
+    CHECK (context_json IS NULL OR json_valid(context_json)),
+
+  -- 지시 접수 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+
+-- 사용자 지시 또는 runtime command의 실행 단위를 관리한다.
+CREATE TABLE IF NOT EXISTS agentic_execution_runs (
+  -- 실행 식별자
+  run_id CHAR(36) PRIMARY KEY
+    CHECK (length(run_id) = 36),
+
+  -- 사용자 지시 식별자. 명령형 실행은 없을 수 있다.
+  request_id CHAR(36)
+    CHECK (request_id IS NULL OR length(request_id) = 36),
+
+  -- 실행을 담당한 package 이름
+  package_name VARCHAR(214),
+
+  -- 실행된 command 또는 agent 식별자
+  command_name VARCHAR(128),
+
+  -- 실행 종류
+  run_type VARCHAR(32) NOT NULL
+    CHECK (run_type IN ('command', 'agent', 'workflow', 'migration', 'validation')),
+
+  -- 실행 상태
+  run_status VARCHAR(32) NOT NULL DEFAULT 'pending'
+    CHECK (run_status IN ('pending', 'running', 'succeeded', 'failed', 'cancelled')),
+
+  -- 실행 시작 시각
+  started_at DATETIME,
+
+  -- 실행 종료 시각
+  ended_at DATETIME,
+
+  -- 실행 소요 시간
+  duration_ms INTEGER
+    CHECK (duration_ms IS NULL OR duration_ms >= 0),
+
+  -- process exit code
+  exit_code INTEGER,
+
+  -- 실패 또는 취소 사유
+  error_message TEXT,
+
+  -- 실행 option snapshot
+  run_options_json JSON
+    CHECK (run_options_json IS NULL OR json_valid(run_options_json)),
+
+  -- 실행 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (request_id)
+    REFERENCES agentic_user_requests (request_id)
+    ON DELETE SET NULL
+);
+
+-- 실행 중 발생한 로그와 이벤트를 순서대로 관리한다.
+CREATE TABLE IF NOT EXISTS agentic_execution_logs (
+  -- 로그 식별자
+  log_id INTEGER PRIMARY KEY AUTOINCREMENT,
+
+  -- 실행 식별자
+  run_id CHAR(36) NOT NULL
+    CHECK (length(run_id) = 36),
+
+  -- 실행 내 로그 순번
+  sequence_no INTEGER NOT NULL
+    CHECK (sequence_no >= 0),
+
+  -- 로그 레벨
+  log_level VARCHAR(16) NOT NULL
+    CHECK (log_level IN ('trace', 'debug', 'info', 'warn', 'error')),
+
+  -- 로그 종류
+  log_type VARCHAR(32) NOT NULL DEFAULT 'event'
+    CHECK (log_type IN ('event', 'stdout', 'stderr', 'tool', 'system')),
+
+  -- 로그 메시지
+  message TEXT NOT NULL,
+
+  -- 구조화 로그 payload
+  payload_json JSON
+    CHECK (payload_json IS NULL OR json_valid(payload_json)),
+
+  -- 로그 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (run_id)
+    REFERENCES agentic_execution_runs (run_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (run_id, sequence_no)
+);
+
+-- 실행 결과를 구조화하여 관리한다.
+CREATE TABLE IF NOT EXISTS agentic_execution_outputs (
+  -- 실행 결과 식별자
+  output_id INTEGER PRIMARY KEY AUTOINCREMENT,
+
+  -- 실행 식별자
+  run_id CHAR(36) NOT NULL
+    CHECK (length(run_id) = 36),
+
+  -- 결과 종류
+  output_type VARCHAR(32) NOT NULL
+    CHECK (output_type IN ('text', 'json', 'file', 'artifact')),
+
+  -- text 결과
+  content_text TEXT,
+
+  -- JSON 결과
+  content_json JSON
+    CHECK (content_json IS NULL OR json_valid(content_json)),
+
+  -- 파일 결과 경로
+  file_path TEXT,
+
+  -- 결과 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (run_id)
+    REFERENCES agentic_execution_runs (run_id)
+    ON DELETE CASCADE,
+
+  CHECK (
+    content_text IS NOT NULL OR
+    content_json IS NOT NULL OR
+    file_path IS NOT NULL
+  )
+);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_execution_runs_request_id
+  ON agentic_execution_runs (request_id);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_execution_runs_status
+  ON agentic_execution_runs (run_status);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_execution_logs_run_id
+  ON agentic_execution_logs (run_id);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_execution_outputs_run_id
+  ON agentic_execution_outputs (run_id);

package/src/database/migrations/0002_runtime_bundles.sql

@@ -0,0 +1,61 @@
+PRAGMA foreign_keys = ON;
+
+-- 현재 실행 프로젝트에 설치된 methodology/seed bundle 상태를 관리한다.
+CREATE TABLE IF NOT EXISTS agentic_project_bundles (
+  -- bundle 설치 식별자
+  bundle_id INTEGER PRIMARY KEY AUTOINCREMENT,
+
+  -- bundle을 제공한 Agentic package 이름
+  package_name VARCHAR(214) NOT NULL,
+
+  -- bundle 설치 시점의 package version
+  package_version VARCHAR(64) NOT NULL,
+
+  -- package 내부 bundle 식별자
+  bundle_code VARCHAR(128) NOT NULL,
+
+  -- bundle 자체 version
+  bundle_version VARCHAR(64) NOT NULL,
+
+  -- bundle이 제공하는 methodology code
+  methodology_code VARCHAR(128),
+
+  -- 사용자 표시용 bundle 이름
+  display_name VARCHAR(255),
+
+  -- bundle 설명
+  description TEXT,
+
+  -- bundle manifest snapshot
+  bundle_manifest_json JSON NOT NULL
+    CHECK (json_valid(bundle_manifest_json)),
+
+  -- bundle validation result snapshot
+  validation_result_json JSON NOT NULL
+    CHECK (json_valid(validation_result_json)),
+
+  -- 프로젝트 내 활성화 여부. 1은 활성, 0은 비활성
+  is_enabled INTEGER NOT NULL DEFAULT 1
+    CHECK (is_enabled IN (0, 1)),
+
+  -- 프로젝트에 bundle이 설치된 시각
+  installed_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- 설치 상태 최종 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  UNIQUE (package_name, bundle_code),
+
+  FOREIGN KEY (package_name)
+    REFERENCES agentic_project_modules (package_name)
+    ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_project_bundles_package_name
+  ON agentic_project_bundles (package_name);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_project_bundles_bundle_code
+  ON agentic_project_bundles (bundle_code);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_project_bundles_enabled
+  ON agentic_project_bundles (is_enabled);

package/src/database/migrations/0003_runtime_seed_imports.sql

@@ -0,0 +1,121 @@
+PRAGMA foreign_keys = ON;
+
+-- seed bundle import 계획과 dry-run 결과를 run 단위로 관리한다.
+CREATE TABLE IF NOT EXISTS agentic_seed_import_runs (
+  -- seed import run 식별자
+  seed_import_run_id INTEGER PRIMARY KEY AUTOINCREMENT,
+
+  -- import 대상 project bundle 식별자
+  bundle_id INTEGER NOT NULL,
+
+  -- bundle provider package 이름
+  package_name VARCHAR(214) NOT NULL,
+
+  -- bundle provider package version
+  package_version VARCHAR(64) NOT NULL,
+
+  -- package 내부 bundle 식별자
+  bundle_code VARCHAR(128) NOT NULL,
+
+  -- bundle 자체 version
+  bundle_version VARCHAR(64) NOT NULL,
+
+  -- bundle이 제공하는 methodology code
+  methodology_code VARCHAR(128),
+
+  -- import 실행 mode
+  import_mode VARCHAR(16) NOT NULL DEFAULT 'dry_run'
+    CHECK (import_mode IN ('dry_run', 'apply')),
+
+  -- import 계획 상태
+  import_status VARCHAR(32) NOT NULL DEFAULT 'planned'
+    CHECK (import_status IN ('planned', 'blocked', 'failed', 'applied')),
+
+  -- import plan summary snapshot
+  summary_json JSON NOT NULL DEFAULT '{}'
+    CHECK (json_valid(summary_json)),
+
+  -- bundle validation result snapshot
+  validation_result_json JSON NOT NULL DEFAULT '{}'
+    CHECK (json_valid(validation_result_json)),
+
+  -- run 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  -- run 상태 최종 수정 시각
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (bundle_id)
+    REFERENCES agentic_project_bundles (bundle_id)
+    ON DELETE CASCADE
+);
+
+-- seed bundle import 계획을 target package/section 단위 item으로 관리한다.
+CREATE TABLE IF NOT EXISTS agentic_seed_import_items (
+  -- seed import item 식별자
+  seed_import_item_id INTEGER PRIMARY KEY AUTOINCREMENT,
+
+  -- seed import run 식별자
+  seed_import_run_id INTEGER NOT NULL,
+
+  -- run 내 item 순서
+  item_order INTEGER NOT NULL
+    CHECK (item_order >= 0),
+
+  -- bundle 내 source section
+  source_section VARCHAR(64) NOT NULL,
+
+  -- import target package 이름
+  target_package VARCHAR(214) NOT NULL,
+
+  -- import target domain 이름
+  target_domain VARCHAR(64),
+
+  -- seed apply에서 사용할 target operation 이름
+  target_operation VARCHAR(128) NOT NULL,
+
+  -- item 식별 key
+  item_key VARCHAR(255),
+
+  -- section 내 seed item 수
+  item_count INTEGER NOT NULL DEFAULT 0
+    CHECK (item_count >= 0),
+
+  -- item 계획 상태
+  item_status VARCHAR(32) NOT NULL DEFAULT 'planned'
+    CHECK (item_status IN ('planned', 'blocked', 'warning', 'skipped', 'applied')),
+
+  -- blocked/warning/skipped 사유 code
+  reason_code VARCHAR(128),
+
+  -- blocked/warning/skipped 사유 설명
+  reason_message TEXT,
+
+  -- import 대상 seed payload snapshot
+  item_payload_json JSON
+    CHECK (item_payload_json IS NULL OR json_valid(item_payload_json)),
+
+  -- item 생성 시각
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (seed_import_run_id)
+    REFERENCES agentic_seed_import_runs (seed_import_run_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (seed_import_run_id, item_order)
+);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_seed_import_runs_bundle_id
+  ON agentic_seed_import_runs (bundle_id);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_seed_import_runs_status
+  ON agentic_seed_import_runs (import_status);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_seed_import_items_run_id
+  ON agentic_seed_import_items (seed_import_run_id);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_seed_import_items_target_package
+  ON agentic_seed_import_items (target_package);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_seed_import_items_status
+  ON agentic_seed_import_items (item_status);

package/src/database/migrations/0004_runtime_seed_apply_status.sql

@@ -0,0 +1,76 @@
+PRAGMA foreign_keys = ON;
+
+-- seed apply 중 target handler 실패를 item 단위로 추적할 수 있도록 실패 상태를 추가한다.
+CREATE TABLE IF NOT EXISTS agentic_seed_import_items_next (
+  seed_import_item_id INTEGER PRIMARY KEY AUTOINCREMENT,
+  seed_import_run_id INTEGER NOT NULL,
+  item_order INTEGER NOT NULL
+    CHECK (item_order >= 0),
+  source_section VARCHAR(64) NOT NULL,
+  target_package VARCHAR(214) NOT NULL,
+  target_domain VARCHAR(64),
+  target_operation VARCHAR(128) NOT NULL,
+  item_key VARCHAR(255),
+  item_count INTEGER NOT NULL DEFAULT 0
+    CHECK (item_count >= 0),
+  item_status VARCHAR(32) NOT NULL DEFAULT 'planned'
+    CHECK (item_status IN ('planned', 'blocked', 'warning', 'skipped', 'applied', 'failed')),
+  reason_code VARCHAR(128),
+  reason_message TEXT,
+  item_payload_json JSON
+    CHECK (item_payload_json IS NULL OR json_valid(item_payload_json)),
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (seed_import_run_id)
+    REFERENCES agentic_seed_import_runs (seed_import_run_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (seed_import_run_id, item_order)
+);
+
+INSERT INTO agentic_seed_import_items_next
+  (
+    seed_import_item_id,
+    seed_import_run_id,
+    item_order,
+    source_section,
+    target_package,
+    target_domain,
+    target_operation,
+    item_key,
+    item_count,
+    item_status,
+    reason_code,
+    reason_message,
+    item_payload_json,
+    created_at
+  )
+SELECT seed_import_item_id,
+       seed_import_run_id,
+       item_order,
+       source_section,
+       target_package,
+       target_domain,
+       target_operation,
+       item_key,
+       item_count,
+       item_status,
+       reason_code,
+       reason_message,
+       item_payload_json,
+       created_at
+  FROM agentic_seed_import_items;
+
+DROP TABLE agentic_seed_import_items;
+
+ALTER TABLE agentic_seed_import_items_next
+  RENAME TO agentic_seed_import_items;
+
+CREATE INDEX IF NOT EXISTS idx_agentic_seed_import_items_run_id
+  ON agentic_seed_import_items (seed_import_run_id);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_seed_import_items_target_package
+  ON agentic_seed_import_items (target_package);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_seed_import_items_status
+  ON agentic_seed_import_items (item_status);

package/src/database/migrations/0005_runtime_execution_projects.sql

@@ -0,0 +1,92 @@
+PRAGMA foreign_keys = ON;
+
+-- seed bundle을 기반으로 생성한 실행 프로젝트 인스턴스를 관리한다.
+CREATE TABLE IF NOT EXISTS agentic_execution_projects (
+  execution_project_id INTEGER PRIMARY KEY AUTOINCREMENT,
+  project_code VARCHAR(128) NOT NULL UNIQUE,
+  project_name VARCHAR(256) NOT NULL,
+  project_status_code VARCHAR(32) NOT NULL DEFAULT 'planned'
+    CHECK (project_status_code IN ('planned', 'in_progress', 'completed', 'blocked', 'skipped')),
+  bundle_id INTEGER NOT NULL,
+  package_name VARCHAR(214) NOT NULL,
+  package_version VARCHAR(64) NOT NULL,
+  bundle_code VARCHAR(128) NOT NULL,
+  bundle_version VARCHAR(64) NOT NULL,
+  methodology_code VARCHAR(128),
+  lifecycle_code VARCHAR(128),
+  phase_code VARCHAR(128),
+  process_code VARCHAR(128),
+  metadata_json JSON NOT NULL DEFAULT '{}'
+    CHECK (json_valid(metadata_json)),
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (bundle_id)
+    REFERENCES agentic_project_bundles (bundle_id)
+    ON DELETE RESTRICT
+);
+
+-- 실행 프로젝트 안의 Stage 상태 snapshot을 관리한다.
+CREATE TABLE IF NOT EXISTS agentic_execution_project_stages (
+  execution_project_stage_id INTEGER PRIMARY KEY AUTOINCREMENT,
+  execution_project_id INTEGER NOT NULL,
+  stage_code VARCHAR(128) NOT NULL,
+  stage_name VARCHAR(256) NOT NULL,
+  stage_status_code VARCHAR(32) NOT NULL DEFAULT 'planned'
+    CHECK (stage_status_code IN ('planned', 'in_progress', 'completed', 'blocked', 'skipped')),
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  metadata_json JSON NOT NULL DEFAULT '{}'
+    CHECK (json_valid(metadata_json)),
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (execution_project_id)
+    REFERENCES agentic_execution_projects (execution_project_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (execution_project_id, stage_code)
+);
+
+-- 실행 프로젝트 안의 Activity 상태 snapshot을 관리한다.
+CREATE TABLE IF NOT EXISTS agentic_execution_project_activities (
+  execution_project_activity_id INTEGER PRIMARY KEY AUTOINCREMENT,
+  execution_project_id INTEGER NOT NULL,
+  execution_project_stage_id INTEGER NOT NULL,
+  activity_code VARCHAR(128) NOT NULL,
+  activity_name VARCHAR(256) NOT NULL,
+  activity_status_code VARCHAR(32) NOT NULL DEFAULT 'planned'
+    CHECK (activity_status_code IN ('planned', 'in_progress', 'completed', 'blocked', 'skipped')),
+  primary_artifact_standard_code VARCHAR(128),
+  primary_artifact_standard_version VARCHAR(64),
+  artifact_instance_id VARCHAR(64),
+  sort_order INTEGER NOT NULL DEFAULT 0,
+  metadata_json JSON NOT NULL DEFAULT '{}'
+    CHECK (json_valid(metadata_json)),
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+  FOREIGN KEY (execution_project_id)
+    REFERENCES agentic_execution_projects (execution_project_id)
+    ON DELETE CASCADE,
+
+  FOREIGN KEY (execution_project_stage_id)
+    REFERENCES agentic_execution_project_stages (execution_project_stage_id)
+    ON DELETE CASCADE,
+
+  UNIQUE (execution_project_id, activity_code)
+);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_execution_projects_bundle
+  ON agentic_execution_projects (bundle_code, bundle_version);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_execution_projects_status
+  ON agentic_execution_projects (project_status_code);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_execution_project_stages_project
+  ON agentic_execution_project_stages (execution_project_id);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_execution_project_activities_project
+  ON agentic_execution_project_activities (execution_project_id);
+
+CREATE INDEX IF NOT EXISTS idx_agentic_execution_project_activities_stage
+  ON agentic_execution_project_activities (execution_project_stage_id);