@cardor/agent-harness-kit 1.10.2 → 1.10.4

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/README.md CHANGED
@@ -61,6 +61,7 @@ npx ahk init
61
61
  - [Runtime compatibility](#runtime-compatibility)
62
62
  - [Contributing \& local development](#contributing--local-development)
63
63
  - [Testing the local build in another project](#testing-the-local-build-in-another-project)
64
+ - [Security Policy](#security-policy)
64
65
  - [Roadmap](#roadmap)
65
66
 
66
67
  ---
@@ -184,15 +185,7 @@ For Claude Code and Codex CLI (not OpenCode), you'll also be asked whether to pe
184
185
 
185
186
  Regardless of scope, `.harness/storage-state.json` is always written to the project — it records the *actual* current storage state (`scope`, `projectId`, `dbType`, `migratedAt`), separate from the *desired* state declared in the config file.
186
187
 
187
- When `--storage-scope global` is chosen, `ahk init` also synchronizes your provider's agent and skill files into your home directory (in addition to the project-local files it always writes), so subsequent `ahk init --storage-scope global` runs in *other* projects on the same machine can reuse them instead of re-scaffolding:
188
-
189
- | Provider | Global agents dir | Global skills dir |
190
- | ------------- | ---------------------------- | ----------------------------- |
191
- | `claude-code` | `~/.claude/agents/` | `~/.claude/skills/` |
192
- | `codex-cli` | `~/.codex/agents/` | `~/.agents/skills/` (separate namespace from `~/.codex/agents`) |
193
- | `opencode` | `~/.config/opencode/agents/` | `~/.config/opencode/skills/` |
194
-
195
- This sync is idempotent and non-destructive: it only creates files that are missing. If everything is already present, `ahk init` prints a message and skips; if only some files are missing, it creates just those and reports what was added. Files it detects as already customized/outdated are left untouched (same "preserve, don't overwrite" rule used for project-local agent files).
188
+ Agent and skill files always live in the project tree, regardless of storage scope `--storage-scope` only affects where the harness DB lives.
196
189
 
197
190
  ```bash
198
191
  ahk init
@@ -388,7 +381,7 @@ ahk migrate --to opencode
388
381
 
389
382
  #### `ahk migrate storage` — ⚠️ sensitive, reads/writes real harness data
390
383
 
391
- Migrates the harness database between storage backends: **local↔global scope** (moving `.harness/harness.db` in/out of `~/.harness/dbs/<projectId>/`) and **sqlite↔postgres/mysql** (dumping and reloading all 6 tables — tasks, task_acceptance, actions, action_sections, action_files, action_tools — inside a single transaction). It is **not interactive** — `agent-harness-kit.config.ts` (`storage.scope`, `database.type`/`path`/`connectionString`) is the only source of truth for the desired target, compared against the real current state recorded in `.harness/storage-state.json`.
384
+ Migrates the harness database between storage backends: **local↔global scope** (moving `.harness/harness.db` in/out of `~/.harness/dbs/<projectId>/`) and **sqlite↔postgres/mysql** (dumping and reloading all 6 tables — tasks, task_acceptance, actions, action_sections, action_files, action_tools — inside a single transaction). It is **not interactive** — `agent-harness-kit.config.ts` (`storage.scope`, `storage.sqlitePath` (local scope only), `database.type`/`connectionString`) is the only source of truth for the desired target, compared against the real current state recorded in `.harness/storage-state.json`.
392
385
 
393
386
  ```bash
394
387
  ahk migrate storage # migrate to whatever agent-harness-kit.config.ts declares
@@ -543,8 +536,10 @@ const config: HarnessConfig = {
543
536
  },
544
537
 
545
538
  // ── Database ──────────────────────────────────────────────────────────────
546
- // SQLite (default — zero native deps, Node 22+ or Bun)
547
- database: { type: 'sqlite', path: '.harness/harness.db' },
539
+ // SQLite (default — zero native deps, Node 22+ or Bun). Note: `database`
540
+ // never carries a file path — where the .db file physically lives is a
541
+ // `storage` concern (see `storage.sqlitePath` below), not a `database` one.
542
+ database: { type: 'sqlite' },
548
543
 
549
544
  // PostgreSQL — uncomment to use instead:
550
545
  // database: { type: 'postgres', connectionString: process.env.DATABASE_URL },
@@ -552,6 +547,10 @@ const config: HarnessConfig = {
552
547
  // MySQL — uncomment to use instead:
553
548
  // database: { type: 'mysql', connectionString: process.env.DATABASE_URL },
554
549
 
550
+ // ── Storage — scope: 'local' (default) ─────────────────────────────────────
551
+ // DB and current.md live project-relative, in .harness/. `sqlitePath` and
552
+ // `markdownFallback.path` are only valid (and only exist on the type) when
553
+ // `scope: 'local'`.
555
554
  storage: {
556
555
  dir: '.harness',
557
556
  tasks: { adapter: 'local' }, // 'local' | 'jira' | 'linear' | 'mcp'
@@ -563,10 +562,9 @@ const config: HarnessConfig = {
563
562
  nextSteps: false, // optional next steps field
564
563
  },
565
564
  markdownFallback: { enabled: true, path: '.harness/current.md' },
566
- // 'local' (default) — DB lives in .harness/ (project-relative).
567
- // 'global' — DB lives under ~/.harness/dbs/<projectId>/, outside the project.
568
- scope: 'local', // 'local' | 'global'
565
+ scope: 'local',
569
566
  projectId: '5f2c...', // UUID, generated once at init, never regenerated
567
+ // sqlitePath: '.harness/harness.db', // optional — defaults to '.harness/harness.db' when omitted
570
568
  },
571
569
 
572
570
  health: {
@@ -583,6 +581,22 @@ const config: HarnessConfig = {
583
581
  export default config
584
582
  ```
585
583
 
584
+ **`scope: 'global'`** — DB and current.md live under `~/.harness/dbs/<projectId>/`, outside the project tree. Under this scope, `sqlitePath` and `markdownFallback.path` don't exist on the type at all (a type error, not just a no-op) — there's nothing local to declare a path for:
585
+
586
+ ```ts
587
+ storage: {
588
+ dir: '.harness',
589
+ tasks: { adapter: 'local' },
590
+ sections: { toolsUsed: true, filesModified: true, result: true, blockers: true, nextSteps: false },
591
+ markdownFallback: { enabled: true }, // no `path` — auto-managed under ~/.harness/dbs/<projectId>/
592
+ scope: 'global',
593
+ projectId: '5f2c...',
594
+ // sqlitePath is NOT a valid field here — omit it entirely
595
+ },
596
+ ```
597
+
598
+ > `StorageConfig` is a discriminated union on `scope` (`LocalStorageConfig | GlobalStorageConfig`, see `src/types.ts`) — this is what makes declaring `sqlitePath`/`markdownFallback.path` under `scope: 'global'` a compile-time error instead of a silently-ignored field. If you're loading a config file at runtime (via `loadConfig()`, which uses `jiti` and does not type-check), an existing `scope: 'global'` config that still has these fields set gets normalized automatically with a `console.warn` rather than crashing — see `applyDefaults()` in `src/core/config.ts`.
599
+
586
600
  > `defineHarness()` is still exported for anyone who prefers the value-import form (`import { defineHarness } from '@cardor/agent-harness-kit'` + `export default defineHarness({ ... })`) — it's an identity function kept for backward compatibility, and `loadConfig()` supports both shapes.
587
601
 
588
602
  ### `health.sh`
@@ -851,6 +865,12 @@ Types: `feat fix chore refactor docs test perf style build ci revert`
851
865
 
852
866
  ---
853
867
 
868
+ ## Security Policy
869
+
870
+ See [SECURITY.md](./SECURITY.md) for the vulnerability reporting process, supported versions, and coordinated-disclosure policy.
871
+
872
+ ---
873
+
854
874
  ## Roadmap
855
875
 
856
876
  - ✅ **`ahk dashboard`** — local web UI with real-time WebSocket updates. Shows tasks, action timelines, file activity, tool usage, and per-agent breakdowns.
@@ -362,6 +362,8 @@ var TaskRepository = class {
362
362
  var AUTOINCREMENT_TABLES = ["tasks", "task_acceptance", "action_sections", "action_files", "action_tools"];
363
363
  var TABLE_INSERT_ORDER = ["tasks", "task_acceptance", "actions", "action_sections", "action_files", "action_tools"];
364
364
  var TABLE_DELETE_ORDER = [...TABLE_INSERT_ORDER].reverse();
365
+ var DEFAULT_SQLITE_PATH = ".harness/harness.db";
366
+ var DEFAULT_MARKDOWN_PATH = ".harness/current.md";
365
367
  function resolveGlobalStorageDir(config, homeDir = homedir()) {
366
368
  return join(homeDir, ".harness", "dbs", config.storage.projectId);
367
369
  }
@@ -752,6 +754,13 @@ async function importFullExport(destDriver, data, destDbType, opts = { truncateF
752
754
  function resolveSqlitePathForScope(scope, sqlitePath, cwd, config, homeDir) {
753
755
  return scope === "global" ? join(resolveGlobalStorageDir(config, homeDir), "harness.db") : resolve(cwd, sqlitePath);
754
756
  }
757
+ function resolveSqlitePath(config, cwd, homeDir = homedir()) {
758
+ const sqlitePath = config.storage.scope === "local" ? config.storage.sqlitePath ?? DEFAULT_SQLITE_PATH : DEFAULT_SQLITE_PATH;
759
+ return resolveSqlitePathForScope(config.storage.scope, sqlitePath, cwd, config, homeDir);
760
+ }
761
+ function resolveMarkdownFallbackPath(config, cwd, homeDir = homedir()) {
762
+ return config.storage.scope === "global" ? join(resolveGlobalStorageDir(config, homeDir), "current.md") : resolve(cwd, config.storage.markdownFallback.path);
763
+ }
755
764
  function writeStorageStateFile(cwd, storageDir, state) {
756
765
  const path = join(resolve(cwd), storageDir, "storage-state.json");
757
766
  mkdirSync(dirname(path), { recursive: true });
@@ -799,7 +808,7 @@ async function openDB(config, cwd, homeDir = homedir()) {
799
808
  mkdirSync(globalDir, { recursive: true });
800
809
  dbPath = join(globalDir, "harness.db");
801
810
  } else {
802
- dbPath = resolve(cwd, dbConfig.path);
811
+ dbPath = resolve(cwd, config.storage.sqlitePath ?? DEFAULT_SQLITE_PATH);
803
812
  }
804
813
  driver = new SQLiteDriver(dbPath);
805
814
  }
@@ -808,14 +817,18 @@ async function openDB(config, cwd, homeDir = homedir()) {
808
817
  }
809
818
 
810
819
  export {
820
+ DEFAULT_SQLITE_PATH,
821
+ DEFAULT_MARKDOWN_PATH,
811
822
  resolveGlobalStorageDir,
812
823
  HarnessDB,
813
824
  getRowCounts,
814
825
  isEmptyDatabase,
815
826
  importFullExport,
816
827
  resolveSqlitePathForScope,
828
+ resolveSqlitePath,
829
+ resolveMarkdownFallbackPath,
817
830
  writeStorageStateFile,
818
831
  readStorageStateFile,
819
832
  openDB
820
833
  };
821
- //# sourceMappingURL=chunk-DNFFWQWR.js.map
834
+ //# sourceMappingURL=chunk-6PEIJ2D5.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/core/db.ts","../src/core/repositories/ActionRepository.ts","../src/core/repositories/StatsRepository.ts","../src/core/repositories/TaskRepository.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto'\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { dirname, join, resolve } from 'node:path'\n\nimport { ActionRepository } from './repositories/ActionRepository'\nimport { StatsRepository } from './repositories/StatsRepository'\nimport { TaskRepository } from './repositories/TaskRepository'\n\nimport type { DBDriver } from './drivers/types'\nimport type {\n ActionFileRow,\n ActionRow,\n ActionSectionRow,\n ActionToolRow,\n AgentName,\n HarnessConfig,\n StorageState,\n TaskAcceptanceRow,\n TaskRow,\n TaskStatus,\n} from '@/types'\n\n/** Full relational export of every table — used by `ahk migrate storage` and\n * `ahk export --json`. MUST include all 6 tables (tasks, task_acceptance,\n * actions, action_sections, action_files, action_tools); omitting any of\n * them silently drops user data during a migration. */\nexport interface FullExport {\n tasks: TaskRow[]\n taskAcceptance: TaskAcceptanceRow[]\n actions: ActionRow[]\n sections: ActionSectionRow[]\n actionFiles: ActionFileRow[]\n actionTools: ActionToolRow[]\n}\n\n/** Tables with an integer autoincrement/serial primary key, in FK-safe\n * insertion order (parents before children). `actions` is excluded — its id\n * is an application-generated UUID (TEXT), never autoincrement. */\nconst AUTOINCREMENT_TABLES = ['tasks', 'task_acceptance', 'action_sections', 'action_files', 'action_tools'] as const\n\n/** Full insertion order across all 6 tables, respecting FK constraints\n * (parent before child): tasks -> task_acceptance -> actions ->\n * action_sections/action_files/action_tools. */\nconst TABLE_INSERT_ORDER = ['tasks', 'task_acceptance', 'actions', 'action_sections', 'action_files', 'action_tools'] as const\n\n/** Reverse of TABLE_INSERT_ORDER — used to TRUNCATE a non-empty destination\n * safely (children before parents) when `--force` is used. */\nconst TABLE_DELETE_ORDER = [...TABLE_INSERT_ORDER].reverse()\n\n// ─── Global storage path resolution ────────────────────────────────────────\n\n/** Default relative sqlite path used whenever `LocalStorageConfig.sqlitePath`\n * is omitted, and as the fallback filename component for `scope: 'global'`\n * (which never reads a configured path at all — see resolveSqlitePath()).\n * Centralized here (task #56) to stop the literal '.harness/harness.db'\n * from drifting across config.ts/templates.ts/tests. */\nexport const DEFAULT_SQLITE_PATH = '.harness/harness.db'\n\n/** Default relative current.md fallback path, used as the fallback filename\n * component whenever a caller needs \"the local markdown path\" for a scope\n * that ISN'T `config.storage`'s own current scope — `markdownFallback.path`\n * only exists on `LocalStorageConfig`, so there's no field to read it from\n * when `config.storage.scope === 'global'`. See `defaultMarkdownPathForConfig`\n * usage in src/commands/migrate-storage.ts. */\nexport const DEFAULT_MARKDOWN_PATH = '.harness/current.md'\n\n/** Resolves the directory used for 'global' scope storage: ~/.harness/dbs/<projectId>/\n * Uses os.homedir() (not $HOME env var) for portability. Callers are\n * responsible for creating the directory (mkdirSync recursive) before use. */\nexport function resolveGlobalStorageDir(config: HarnessConfig, homeDir: string = homedir()): string {\n return join(homeDir, '.harness', 'dbs', config.storage.projectId)\n}\n\n// ─── DB class ─────────────────────────────────────────────────────────────────\n\nexport class HarnessDB {\n readonly tasks: TaskRepository\n readonly actions: ActionRepository\n readonly stats: StatsRepository\n private driver: DBDriver\n private config: HarnessConfig\n /** Overridable home directory, used to keep 'global' scope tests off the real $HOME. */\n private homeDir: string\n\n constructor(driver: DBDriver, config: HarnessConfig, homeDir: string = homedir()) {\n this.driver = driver\n this.config = config\n this.homeDir = homeDir\n this.tasks = new TaskRepository(driver)\n this.actions = new ActionRepository(driver)\n this.stats = new StatsRepository(driver)\n }\n\n // ─── Tasks (public facade — delegates to TaskRepository) ──────────────────\n\n async addTask(params: {\n slug: string\n title: string\n description?: string\n acceptance?: string[]\n }): Promise<TaskRow> {\n const taskId = await this.tasks.add({\n slug: params.slug,\n title: params.title,\n description: params.description,\n })\n if (params.acceptance?.length) {\n await this.tasks.addAcceptance(taskId, params.acceptance)\n }\n await this.regenerateCurrentMd()\n return (await this.tasks.getById(taskId))!\n }\n\n async getTasks(status?: TaskStatus, includeArchived = false): Promise<TaskRow[]> {\n return this.tasks.getAll(status, includeArchived)\n }\n\n async getTaskById(id: number): Promise<TaskRow | null> {\n return this.tasks.getById(id)\n }\n\n async getTaskBySlug(slug: string): Promise<TaskRow | null> {\n return this.tasks.getBySlug(slug)\n }\n\n async getTaskAcceptance(taskId: number): Promise<TaskAcceptanceRow[]> {\n return this.tasks.getAcceptance(taskId)\n }\n\n async updateTaskStatus(idOrSlug: number | string, status: TaskStatus): Promise<TaskRow> {\n const now = new Date().toISOString()\n const task =\n typeof idOrSlug === 'number'\n ? await this.tasks.getById(idOrSlug)\n : await this.tasks.getBySlug(idOrSlug)\n if (!task) throw new Error(`Task not found: ${idOrSlug}`)\n\n if (status === 'in_progress' && !task.started_at) {\n await this.tasks.setStatus(task.id, status, { started_at: now })\n } else if (status === 'done') {\n await this.tasks.setStatus(task.id, status, { completed_at: now })\n } else {\n await this.tasks.setStatus(task.id, status)\n }\n\n await this.regenerateCurrentMd()\n return (await this.tasks.getById(task.id))!\n }\n\n async claimTask(id: number, agent: string): Promise<TaskRow | null> {\n const now = new Date().toISOString()\n return this.driver.transaction(async (tx) => {\n // need to create a new TaskRepository instance bound to the transaction\n const txTasks = new TaskRepository(tx)\n const changed = await txTasks.claim(id, agent, now)\n if (!changed) return null\n const task = await txTasks.getById(id)\n if (!task || task.status !== 'in_progress' || task.assigned_to !== agent) return null\n await this.regenerateCurrentMd()\n return task\n })\n }\n\n async markAcceptanceMet(criterionId: number): Promise<void> {\n return this.tasks.markAcceptanceMet(criterionId)\n }\n\n async updateTask(id: number, params: { title?: string; description?: string | null; slug?: string }): Promise<TaskRow> {\n await this.tasks.update(id, params)\n await this.regenerateCurrentMd()\n return (await this.tasks.getById(id))!\n }\n\n async updateTaskAcceptance(taskId: number, criteria: string[]): Promise<void> {\n await this.tasks.replaceAcceptance(taskId, criteria)\n await this.regenerateCurrentMd()\n }\n\n async archiveTask(id: number): Promise<TaskRow> {\n await this.tasks.archive(id)\n await this.regenerateCurrentMd()\n return (await this.tasks.getById(id))!\n }\n\n async unarchiveTask(id: number): Promise<TaskRow> {\n await this.tasks.unarchive(id)\n await this.regenerateCurrentMd()\n return (await this.tasks.getById(id))!\n }\n\n async getArchivedTasks(): Promise<TaskRow[]> {\n return this.tasks.getArchived()\n }\n\n async getStatusSummary(): Promise<{ status: string; total: number }[]> {\n return this.tasks.getStatusSummary()\n }\n\n // ─── Actions (public facade — delegates to ActionRepository) ──────────────\n\n async startAction(taskId: number, agent: AgentName): Promise<ActionRow> {\n const id = randomUUID()\n const now = new Date().toISOString()\n await this.actions.create(id, taskId, agent, now)\n await this.regenerateCurrentMd()\n return (await this.actions.getById(id))!\n }\n\n async writeSection(actionId: string, sectionType: string, content: string): Promise<void> {\n const now = new Date().toISOString()\n await this.actions.addSection(actionId, sectionType, content, now)\n await this.regenerateCurrentMd()\n }\n\n async completeAction(actionId: string, summary: string): Promise<ActionRow> {\n const now = new Date().toISOString()\n await this.actions.complete(actionId, summary, now)\n await this.regenerateCurrentMd()\n return (await this.actions.getById(actionId))!\n }\n\n async closeOrphanedActions(taskId: number): Promise<number> {\n const now = new Date().toISOString()\n return this.actions.closeOrphaned(taskId, now)\n }\n\n async getAction(actionId: string): Promise<ActionRow | null> {\n return this.actions.getById(actionId)\n }\n\n async getActionsForTask(taskId: number): Promise<ActionRow[]> {\n return this.actions.getForTask(taskId)\n }\n\n async getActionSections(actionId: string): Promise<ActionSectionRow[]> {\n return this.actions.getSections(actionId)\n }\n\n async recordFile(\n actionId: string,\n filePath: string,\n operation: ActionFileRow['operation'],\n notes?: string,\n ): Promise<void> {\n return this.actions.addFile(actionId, filePath, operation, notes ?? null)\n }\n\n async recordTool(\n actionId: string,\n toolName: string,\n argsJson?: string,\n resultSummary?: string,\n ): Promise<void> {\n const now = new Date().toISOString()\n return this.actions.addTool(actionId, toolName, argsJson ?? null, resultSummary ?? null, now)\n }\n\n async getFilesForTask(taskId: number): Promise<(ActionFileRow & { agent: AgentName })[]> {\n return this.actions.getFilesForTask(taskId)\n }\n\n async getTopTools(limit = 10): Promise<{ tool_name: string; uses: number }[]> {\n return this.actions.getTopTools(limit)\n }\n\n // ─── current.md fallback ──────────────────────────────────────────────────\n\n async regenerateCurrentMd(): Promise<void> {\n if (!this.config.storage.markdownFallback.enabled) return\n\n const mdPath =\n this.config.storage.scope === 'global'\n ? join(resolveGlobalStorageDir(this.config, this.homeDir), 'current.md')\n : resolve(this.config.storage.markdownFallback.path)\n mkdirSync(dirname(mdPath), { recursive: true })\n\n const inProgress = await this.tasks.getAll('in_progress')\n const now = new Date().toISOString()\n\n let md = `<!-- AUTO-GENERATED by agent-harness-kit — DO NOT EDIT MANUALLY -->\\n`\n md += `<!-- Last updated: ${now} -->\\n\\n`\n md += `# Current Session\\n\\n`\n\n if (inProgress.length === 0) {\n md += `## No tasks in progress\\n\\n`\n const pending = await this.tasks.getAll('pending')\n if (pending.length > 0) {\n md += `### Next pending tasks\\n`\n for (const t of pending.slice(0, 5)) {\n md += `- **#${t.id}** ${t.title} (\\`${t.slug}\\`)\\n`\n }\n }\n } else {\n for (const task of inProgress) {\n md += `## Active Task\\n`\n md += `- **ID:** ${task.id}\\n`\n md += `- **Slug:** ${task.slug}\\n`\n md += `- **Status:** ${task.status}\\n`\n md += `- **Started:** ${task.started_at ?? 'unknown'}\\n\\n`\n\n const taskActions = await this.actions.getForTask(task.id)\n if (taskActions.length > 0) {\n md += `## Actions this session\\n`\n md += `| Agent | Status | Summary | Started |\\n`\n md += `|----------|-------------|----------------------------------|-------------|\\n`\n for (const a of taskActions) {\n const started = a.created_at.slice(11, 16)\n const summary = (a.summary ?? '').slice(0, 34).padEnd(34)\n md += `| ${a.agent.padEnd(8)} | ${a.status.padEnd(11)} | ${summary} | ${started} |\\n`\n }\n md += `\\n`\n }\n\n const acceptance = await this.tasks.getAcceptance(task.id)\n if (acceptance.length > 0) {\n md += `## Acceptance Criteria\\n`\n for (const a of acceptance) {\n md += `- [${a.met ? 'x' : ' '}] ${a.criterion}\\n`\n }\n md += `\\n`\n }\n }\n }\n\n writeFileSync(mdPath, md, 'utf8')\n }\n\n // ─── Raw query escape hatch ───────────────────────────────────────────────\n\n async queryRaw<T = Record<string, unknown>>(sql: string, ...params: unknown[]): Promise<T[]> {\n return this.driver.query<T>(sql, params)\n }\n\n // ─── Export helpers ───────────────────────────────────────────────────────\n\n /** Full relational export of ALL 6 tables (tasks, task_acceptance, actions,\n * action_sections, action_files, action_tools). Extended for task #47 —\n * the previous version (tasks/actions/sections only) silently dropped\n * acceptance criteria and file/tool records on export/migrate. */\n async exportJson(): Promise<FullExport> {\n return {\n tasks: await this.tasks.getAll(undefined, true),\n taskAcceptance: await this.tasks.getAllAcceptance(),\n actions: await this.actions.getAll(),\n sections: await this.actions.getAllSections(),\n actionFiles: await this.actions.getAllFiles(),\n actionTools: await this.actions.getAllTools(),\n }\n }\n\n /** Row counts for all 6 tables against THIS db's driver — used to decide\n * whether a destination is \"empty\" (safe to import into directly) before\n * a migration. Counts are queried directly (COUNT(*)), never inferred\n * from storage-state.json. */\n async getRowCounts(): Promise<Record<(typeof TABLE_INSERT_ORDER)[number], number>> {\n return getRowCounts(this.driver)\n }\n\n /** Imports a full export into THIS db's driver — see standalone\n * `importFullExport()` for the transactional/rollback/sequence-reset\n * guarantees. `dbType` must match `this.config.database.type`. */\n async importFullExport(data: FullExport, dbType: 'sqlite' | 'postgres' | 'mysql', opts?: { truncateFirst: boolean }): Promise<void> {\n return importFullExport(this.driver, data, dbType, opts)\n }\n\n async reconnect(): Promise<void> {\n await this.driver.reconnect()\n }\n\n async close(): Promise<void> {\n await this.driver.close()\n }\n\n // ─── feature_list.json sync ───────────────────────────────────────────────\n\n async syncFromFeatureList(\n seeds: { slug: string; title: string; description?: string; acceptance?: string[] }[],\n ): Promise<{ added: number; skipped: number }> {\n let added = 0\n let skipped = 0\n for (const t of seeds) {\n if (await this.tasks.getBySlug(t.slug)) {\n skipped++\n continue\n }\n await this.addTask(t)\n added++\n }\n return { added, skipped }\n }\n\n async writeFeatureList(cwd: string): Promise<void> {\n const allTasks = await this.tasks.getAll(undefined, true)\n const list = await Promise.all(\n allTasks.map(async (t) => ({\n slug: t.slug,\n title: t.title,\n description: t.description ?? undefined,\n acceptance: (await this.tasks.getAcceptance(t.id)).map((a) => a.criterion),\n status: t.status,\n })),\n )\n const path = join(resolve(cwd), this.config.storage.dir, 'feature_list.json')\n mkdirSync(dirname(path), { recursive: true })\n writeFileSync(path, JSON.stringify(list, null, 2) + '\\n', 'utf8')\n }\n\n // ─── storage-state.json (real storage state, for `ahk migrate storage`) ──\n\n /** Writes .harness/storage-state.json, ALWAYS project-local regardless of\n * scope. Reflects the REAL current storage state (scope/projectId/dbType\n * actually in use right now), as opposed to agent-harness-kit.config.ts\n * which reflects the DESIRED state. Format is stable — task #47 (ahk\n * migrate storage) depends on it; do not change field names/shape. */\n async writeStorageState(cwd: string): Promise<void> {\n writeStorageStateFile(cwd, this.config.storage.dir, {\n scope: this.config.storage.scope,\n projectId: this.config.storage.projectId,\n dbType: this.config.database.type,\n migratedAt: new Date().toISOString(),\n })\n }\n}\n\n// ─── Full DB migration helpers (task #47 — `ahk migrate storage`) ─────────\n\n/** Row counts for all 6 tables, queried directly (never inferred). Used to\n * decide whether a destination DB is \"empty\" before an sqlite↔remote\n * migration. */\nexport async function getRowCounts(driver: DBDriver): Promise<Record<(typeof TABLE_INSERT_ORDER)[number], number>> {\n const counts = {} as Record<(typeof TABLE_INSERT_ORDER)[number], number>\n for (const table of TABLE_INSERT_ORDER) {\n const row = await driver.queryOne<{ n: number }>(`SELECT COUNT(*) as n FROM ${table}`)\n counts[table] = Number(row?.n ?? 0)\n }\n return counts\n}\n\n/** True if every table is empty (COUNT(*) = 0 for all 6 tables). */\nexport async function isEmptyDatabase(driver: DBDriver): Promise<boolean> {\n const counts = await getRowCounts(driver)\n return Object.values(counts).every((n) => n === 0)\n}\n\n/** Deletes all rows from all 6 tables, children-before-parents, so FK\n * constraints never block the delete. Only ever called immediately before\n * a `--force` import, inside the same transaction as the import itself —\n * never on its own. */\nasync function truncateAllTables(tx: DBDriver): Promise<void> {\n for (const table of TABLE_DELETE_ORDER) {\n await tx.exec(`DELETE FROM ${table}`)\n }\n}\n\n/** Re-synchronizes the destination's internal autoincrement/serial counter\n * with the highest id actually present, AFTER inserting rows with explicit\n * ids. Required because inserting explicit ids does NOT advance\n * Postgres SERIAL sequences or SQLite's `sqlite_sequence` table — without\n * this, the first unrelated `INSERT ... (no id)` after a migration (e.g.\n * `tasksRepository.add()`) would collide with an imported id.\n * MySQL AUTO_INCREMENT advances automatically on explicit-id inserts\n * greater than the current counter — no action needed there. */\nasync function resetAutoincrementSequences(\n tx: DBDriver,\n dbType: 'sqlite' | 'postgres' | 'mysql',\n): Promise<void> {\n if (dbType === 'mysql') return // AUTO_INCREMENT self-advances on explicit-id insert — verified in tests.\n\n for (const table of AUTOINCREMENT_TABLES) {\n const row = await tx.queryOne<{ max: number | null }>(`SELECT MAX(id) as max FROM ${table}`)\n const max = row?.max\n if (!max) continue // table stayed empty — nothing to advance\n\n if (dbType === 'postgres') {\n await tx.execRaw(`SELECT setval(pg_get_serial_sequence('${table}','id'), ${max}, true)`)\n } else {\n // sqlite: sqlite_sequence only gets a row once a real AUTOINCREMENT\n // insert happens; explicit-id inserts bypass that, so upsert it.\n await tx.execRaw(\n `INSERT INTO sqlite_sequence (name, seq) SELECT '${table}', ${max} WHERE NOT EXISTS (SELECT 1 FROM sqlite_sequence WHERE name = '${table}')`,\n )\n await tx.execRaw(`UPDATE sqlite_sequence SET seq = ${max} WHERE name = '${table}'`)\n }\n }\n}\n\n/** Imports a full export (all 6 tables) into `destDriver`, preserving\n * original ids (required to keep foreign keys intact — see task #47\n * consultant advisory). The ENTIRE import (and, when `truncateFirst` is\n * set, the pre-import wipe) runs inside a single `destDriver.transaction()`\n * call: if anything fails partway, the whole operation rolls back and the\n * destination is left exactly as it was found.\n *\n * Callers MUST only mark the migration successful (e.g. call\n * `db.writeStorageState()`) AFTER this promise resolves without throwing —\n * never inside the transaction callback, never in a `finally`. */\nexport async function importFullExport(\n destDriver: DBDriver,\n data: FullExport,\n destDbType: 'sqlite' | 'postgres' | 'mysql',\n opts: { truncateFirst: boolean } = { truncateFirst: false },\n): Promise<void> {\n await destDriver.transaction(async (tx) => {\n if (opts.truncateFirst) {\n await truncateAllTables(tx)\n }\n\n for (const task of data.tasks) {\n await tx.exec(\n `INSERT INTO tasks (id, slug, title, description, status, assigned_to, created_at, started_at, completed_at, archived_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n [\n task.id,\n task.slug,\n task.title,\n task.description,\n task.status,\n task.assigned_to,\n task.created_at,\n task.started_at,\n task.completed_at,\n task.archived_at,\n task.updated_at,\n ],\n )\n }\n\n for (const ta of data.taskAcceptance) {\n await tx.exec(\n `INSERT INTO task_acceptance (id, task_id, criterion, met) VALUES (?, ?, ?, ?)`,\n [ta.id, ta.task_id, ta.criterion, ta.met],\n )\n }\n\n for (const action of data.actions) {\n await tx.exec(\n `INSERT INTO actions (id, task_id, agent, status, created_at, completed_at, summary) VALUES (?, ?, ?, ?, ?, ?, ?)`,\n [action.id, action.task_id, action.agent, action.status, action.created_at, action.completed_at, action.summary],\n )\n }\n\n for (const section of data.sections) {\n await tx.exec(\n `INSERT INTO action_sections (id, action_id, section_type, content, created_at) VALUES (?, ?, ?, ?, ?)`,\n [section.id, section.action_id, section.section_type, section.content, section.created_at],\n )\n }\n\n for (const file of data.actionFiles) {\n await tx.exec(\n `INSERT INTO action_files (id, action_id, file_path, operation, notes) VALUES (?, ?, ?, ?, ?)`,\n [file.id, file.action_id, file.file_path, file.operation, file.notes],\n )\n }\n\n for (const tool of data.actionTools) {\n await tx.exec(\n `INSERT INTO action_tools (id, action_id, tool_name, args_json, result_summary, called_at) VALUES (?, ?, ?, ?, ?, ?)`,\n [tool.id, tool.action_id, tool.tool_name, tool.args_json, tool.result_summary, tool.called_at],\n )\n }\n\n await resetAutoincrementSequences(tx, destDbType)\n })\n}\n\n/** Resolves the physical sqlite file path for a given scope, sharing the\n * exact convention `openDB()` uses — extracted so `ahk migrate storage` can\n * locate the OLD file (by scope) without duplicating path logic. Does not\n * create any directories or files. */\nexport function resolveSqlitePathForScope(\n scope: 'local' | 'global',\n sqlitePath: string,\n cwd: string,\n config: HarnessConfig,\n homeDir: string,\n): string {\n return scope === 'global'\n ? join(resolveGlobalStorageDir(config, homeDir), 'harness.db')\n : resolve(cwd, sqlitePath)\n}\n\n/** Resolves the physical sqlite file path for `config`'s OWN current scope\n * (as opposed to `resolveSqlitePathForScope`, which resolves an arbitrary\n * scope — used by `ahk migrate storage` to probe both candidates). This is\n * the single mandatory entry point every call site should use instead of\n * reading `config.database`/`config.storage.sqlitePath` directly — routing\n * everything through here is what keeps new call sites from re-introducing\n * the \"reads a local-only field while scope=global\" bug class (task #55/#56). */\nexport function resolveSqlitePath(config: HarnessConfig, cwd: string, homeDir: string = homedir()): string {\n const sqlitePath = config.storage.scope === 'local' ? (config.storage.sqlitePath ?? DEFAULT_SQLITE_PATH) : DEFAULT_SQLITE_PATH\n return resolveSqlitePathForScope(config.storage.scope, sqlitePath, cwd, config, homeDir)\n}\n\n/** Resolves the physical current.md fallback path for `config`'s OWN current\n * scope, sharing the exact convention `HarnessDB.regenerateCurrentMd()`\n * uses. Mirrors `resolveSqlitePath()` — call sites (materializers, reset,\n * health) should use this instead of reading `storage.markdownFallback.path`\n * directly, since that field doesn't exist at all under scope='global'. */\nexport function resolveMarkdownFallbackPath(config: HarnessConfig, cwd: string, homeDir: string = homedir()): string {\n return config.storage.scope === 'global'\n ? join(resolveGlobalStorageDir(config, homeDir), 'current.md')\n : resolve(cwd, config.storage.markdownFallback.path)\n}\n\n/** Writes `<storageDir>/storage-state.json` under `cwd`. Standalone (not tied\n * to a live HarnessDB instance) so it can be called during init before a DB\n * connection exists, and reused by future migration tooling. */\nexport function writeStorageStateFile(cwd: string, storageDir: string, state: StorageState): void {\n const path = join(resolve(cwd), storageDir, 'storage-state.json')\n mkdirSync(dirname(path), { recursive: true })\n writeFileSync(path, JSON.stringify(state, null, 2) + '\\n', 'utf8')\n}\n\n/** Reads `<storageDir>/storage-state.json` under `cwd`. Returns `null` if it\n * doesn't exist or is malformed. Used by future migration tooling (#47) to\n * determine the real current storage state before migrating. */\nexport function readStorageStateFile(cwd: string, storageDir: string): StorageState | null {\n try {\n const path = join(resolve(cwd), storageDir, 'storage-state.json')\n if (!existsSync(path)) return null\n return JSON.parse(readFileSync(path, 'utf8')) as StorageState\n } catch {\n return null\n }\n}\n\n// ─── Factory ─────────────────────────────────────────────────────────────────\n\nexport async function openDB(config: HarnessConfig, cwd: string, homeDir: string = homedir()): Promise<HarnessDB> {\n const dbConfig = config.database\n let driver: DBDriver\n\n if (dbConfig.type === 'postgres') {\n const { PostgresDriver } = await import('./drivers/postgres')\n driver = new PostgresDriver(dbConfig)\n } else if (dbConfig.type === 'mysql') {\n const { MySQLDriver } = await import('./drivers/mysql')\n driver = new MySQLDriver(dbConfig)\n } else {\n const { SQLiteDriver } = await import('./drivers/sqlite')\n if (dbConfig.type !== 'sqlite') {\n throw new Error('Invalid database type')\n }\n\n let dbPath: string\n if (config.storage.scope === 'global') {\n const globalDir = resolveGlobalStorageDir(config, homeDir)\n // Defensive check: a UUID collision is negligible, but if the target\n // dir already exists with a DIFFERENT project's state, don't silently\n // reuse it — surface the conflict instead of assuming it's free.\n const existingStatePath = join(globalDir, 'storage-state.json')\n if (existsSync(existingStatePath)) {\n try {\n const existingState = JSON.parse(readFileSync(existingStatePath, 'utf8')) as StorageState\n if (existingState.projectId !== config.storage.projectId) {\n throw new Error(\n `Global storage dir ${globalDir} already holds a different project (projectId: ${existingState.projectId}). Refusing to reuse it.`,\n )\n }\n } catch (err) {\n if (err instanceof Error && err.message.includes('already holds a different project')) throw err\n // Malformed/unreadable state file — ignore and proceed, mkdirSync below is idempotent.\n }\n }\n mkdirSync(globalDir, { recursive: true })\n dbPath = join(globalDir, 'harness.db')\n } else {\n dbPath = resolve(cwd, config.storage.sqlitePath ?? DEFAULT_SQLITE_PATH)\n }\n\n driver = new SQLiteDriver(dbPath)\n }\n\n await driver.ensureSchema()\n return new HarnessDB(driver, config, homeDir)\n}\n","import type { DBDriver } from '../drivers/types'\nimport type { ActionFileRow, ActionRow, ActionSectionRow, AgentName } from '@/types'\n\nexport interface ActionWithDetails extends ActionRow {\n sections: ActionSectionRow[]\n files: ActionFileRow[]\n tools: ActionToolRow[]\n}\n\nexport interface ActionToolRow {\n id: number\n action_id: string\n tool_name: string\n args_json: string | null\n result_summary: string | null\n called_at: string\n}\n\nexport class ActionRepository {\n constructor(private driver: DBDriver) {}\n\n async create(id: string, taskId: number, agent: AgentName, now: string): Promise<void> {\n await this.driver.exec(\n `INSERT INTO actions (id, task_id, agent, status, created_at) VALUES (?, ?, ?, 'in_progress', ?)`,\n [id, taskId, agent, now],\n )\n }\n\n async complete(actionId: string, summary: string, now: string): Promise<void> {\n await this.driver.exec(\n `UPDATE actions SET status = 'completed', completed_at = ?, summary = ? WHERE id = ?`,\n [now, summary, actionId],\n )\n }\n\n async closeOrphaned(taskId: number, now: string): Promise<number> {\n return this.driver.exec(\n `UPDATE actions SET status = 'completed', completed_at = ?, summary = 'Auto-closed: task marked done' WHERE task_id = ? AND status = 'in_progress'`,\n [now, taskId],\n )\n }\n\n async getById(actionId: string): Promise<ActionRow | null> {\n return this.driver.queryOne<ActionRow>(`SELECT * FROM actions WHERE id = ?`, [actionId])\n }\n\n async getForTask(taskId: number): Promise<ActionRow[]> {\n return this.driver.query<ActionRow>(\n `SELECT * FROM actions WHERE task_id = ? ORDER BY created_at`,\n [taskId],\n )\n }\n\n async getAll(): Promise<ActionRow[]> {\n return this.driver.query<ActionRow>(`SELECT * FROM actions ORDER BY created_at`)\n }\n\n async getWithDetails(taskId: number): Promise<ActionWithDetails[]> {\n const actions = await this.getForTask(taskId)\n return Promise.all(\n actions.map(async (action) => ({\n ...action,\n sections: await this.getSections(action.id),\n files: await this.getFiles(action.id),\n tools: await this.getTools(action.id),\n })),\n )\n }\n\n // ─── Sections ─────────────────────────────────────────────────────────────\n\n async addSection(actionId: string, sectionType: string, content: string, now: string): Promise<void> {\n await this.driver.exec(\n `INSERT INTO action_sections (action_id, section_type, content, created_at) VALUES (?, ?, ?, ?)`,\n [actionId, sectionType, content, now],\n )\n }\n\n async getSections(actionId: string): Promise<ActionSectionRow[]> {\n return this.driver.query<ActionSectionRow>(\n `SELECT * FROM action_sections WHERE action_id = ? ORDER BY created_at`,\n [actionId],\n )\n }\n\n async getAllSections(): Promise<ActionSectionRow[]> {\n return this.driver.query<ActionSectionRow>(`SELECT * FROM action_sections ORDER BY created_at`)\n }\n\n // ─── Files ────────────────────────────────────────────────────────────────\n\n async addFile(\n actionId: string,\n filePath: string,\n operation: ActionFileRow['operation'],\n notes: string | null,\n ): Promise<void> {\n await this.driver.exec(\n `INSERT INTO action_files (action_id, file_path, operation, notes) VALUES (?, ?, ?, ?)`,\n [actionId, filePath, operation, notes],\n )\n }\n\n async getFiles(actionId: string): Promise<ActionFileRow[]> {\n return this.driver.query<ActionFileRow>(\n `SELECT * FROM action_files WHERE action_id = ?`,\n [actionId],\n )\n }\n\n async getFilesForTask(taskId: number): Promise<(ActionFileRow & { agent: AgentName })[]> {\n return this.driver.query<ActionFileRow & { agent: AgentName }>(\n `SELECT af.*, a.agent FROM action_files af JOIN actions a ON af.action_id = a.id WHERE a.task_id = ? ORDER BY a.agent, af.operation`,\n [taskId],\n )\n }\n\n /** Returns ALL action_files rows regardless of action — used by full DB\n * exports (e.g. `ahk migrate storage`) so file-touch records aren't lost. */\n async getAllFiles(): Promise<ActionFileRow[]> {\n return this.driver.query<ActionFileRow>(`SELECT * FROM action_files ORDER BY id`)\n }\n\n // ─── Tools ────────────────────────────────────────────────────────────────\n\n async addTool(\n actionId: string,\n toolName: string,\n argsJson: string | null,\n resultSummary: string | null,\n now: string,\n ): Promise<void> {\n await this.driver.exec(\n `INSERT INTO action_tools (action_id, tool_name, args_json, result_summary, called_at) VALUES (?, ?, ?, ?, ?)`,\n [actionId, toolName, argsJson, resultSummary, now],\n )\n }\n\n async getTools(actionId: string): Promise<ActionToolRow[]> {\n return this.driver.query<ActionToolRow>(\n `SELECT * FROM action_tools WHERE action_id = ? ORDER BY called_at`,\n [actionId],\n )\n }\n\n /** Returns ALL action_tools rows regardless of action — used by full DB\n * exports (e.g. `ahk migrate storage`) so tool-call records aren't lost. */\n async getAllTools(): Promise<ActionToolRow[]> {\n return this.driver.query<ActionToolRow>(`SELECT * FROM action_tools ORDER BY id`)\n }\n\n async getTopTools(limit: number): Promise<{ tool_name: string; uses: number }[]> {\n return this.driver.query<{ tool_name: string; uses: number }>(\n `SELECT tool_name, COUNT(*) as uses FROM action_tools GROUP BY tool_name ORDER BY uses DESC LIMIT ?`,\n [limit],\n )\n }\n}\n","import type { DBDriver } from '../drivers/types'\nimport type {\n AgentStatRow,\n CountRow,\n RecentFileRow,\n RecentToolRow,\n TimelineRow,\n TopFileRow,\n} from '../server-types'\n\nexport interface DBCounts {\n totalActions: number\n totalFiles: number\n uniqueTools: number\n activeAgents: number\n}\n\nexport { AgentStatRow, RecentFileRow, RecentToolRow, TimelineRow, TopFileRow }\n\nconst AGENT_ORDER = ['lead', 'explorer', 'builder', 'reviewer']\n\nexport class StatsRepository {\n constructor(private driver: DBDriver) { }\n\n async getCounts(): Promise<DBCounts> {\n const [{ total: totalActions }] = await this.driver.query<CountRow>(\n `SELECT COUNT(*) as total FROM actions`,\n )\n const [{ total: totalFiles }] = await this.driver.query<CountRow>(\n `SELECT COUNT(*) as total FROM action_files`,\n )\n const [{ total: uniqueTools }] = await this.driver.query<CountRow>(\n `SELECT COUNT(DISTINCT tool_name) as total FROM action_tools`,\n )\n const [{ total: activeAgents }] = await this.driver.query<CountRow>(\n `SELECT COUNT(DISTINCT agent) as total FROM actions WHERE status = 'in_progress'`,\n )\n return { totalActions, totalFiles, uniqueTools, activeAgents }\n }\n\n async getRecentTools(limit: number): Promise<RecentToolRow[]> {\n return this.driver.query<RecentToolRow>(\n `SELECT at.*, t.id as task_id, t.title as task_title, t.slug as task_slug, a.agent\n FROM action_tools at\n JOIN actions a ON at.action_id = a.id\n JOIN tasks t ON a.task_id = t.id\n ORDER BY at.called_at DESC\n LIMIT ?`,\n [limit],\n )\n }\n\n async getTopFiles(limit: number): Promise<TopFileRow[]> {\n return this.driver.query<TopFileRow>(\n `SELECT\n file_path,\n COUNT(*) as total,\n SUM(CASE WHEN operation='read' THEN 1 ELSE 0 END) as read,\n SUM(CASE WHEN operation='created' THEN 1 ELSE 0 END) as created,\n SUM(CASE WHEN operation='modified' THEN 1 ELSE 0 END) as modified,\n SUM(CASE WHEN operation='deleted' THEN 1 ELSE 0 END) as deleted\n FROM action_files\n GROUP BY file_path\n ORDER BY total DESC\n LIMIT ?`,\n [limit],\n )\n }\n\n async getRecentFiles(limit: number): Promise<RecentFileRow[]> {\n return this.driver.query<RecentFileRow>(\n `SELECT af.*, t.id as task_id, t.title as task_title, t.slug as task_slug,\n a.agent, a.created_at as called_at\n FROM action_files af\n JOIN actions a ON af.action_id = a.id\n JOIN tasks t ON a.task_id = t.id\n ORDER BY a.created_at DESC\n LIMIT ?`,\n [limit],\n )\n }\n\n async getAgentStats(): Promise<AgentStatRow[]> {\n const rows = await this.driver.query<AgentStatRow>(\n `SELECT\n a.agent,\n COUNT(*) as actions_total,\n SUM(CASE WHEN a.status='completed' THEN 1 ELSE 0 END) as actions_done,\n SUM(CASE WHEN a.status='blocked' THEN 1 ELSE 0 END) as actions_blocked,\n COUNT(DISTINCT a.task_id) as tasks_worked,\n COUNT(DISTINCT af.file_path) as files_touched\n FROM actions a\n LEFT JOIN action_files af ON af.action_id = a.id\n GROUP BY a.agent\n ORDER BY actions_total DESC`,\n )\n return rows.sort((a, b) => {\n const ai = AGENT_ORDER.indexOf(a.agent)\n const bi = AGENT_ORDER.indexOf(b.agent)\n if (ai === -1 && bi === -1) return 0\n if (ai === -1) return 1\n if (bi === -1) return -1\n return ai - bi\n })\n }\n\n async getTimeline(limit: number): Promise<TimelineRow[]> {\n return this.driver.query<TimelineRow>(\n `SELECT a.*, t.title as task_title, t.slug as task_slug, t.status as task_status\n FROM actions a\n JOIN tasks t ON a.task_id = t.id\n ORDER BY a.created_at DESC\n LIMIT ?`,\n [limit],\n )\n }\n}\n","import type { DBDriver } from '../drivers/types'\nimport type { TaskAcceptanceRow, TaskRow, TaskStatus } from '@/types'\n\nexport interface TaskWithAcceptance extends TaskRow {\n acceptance_total: number\n acceptance_met: number\n}\n\nexport class TaskRepository {\n constructor(private driver: DBDriver) {}\n\n async add(params: {\n slug: string\n title: string\n description?: string | null\n status?: TaskStatus\n }): Promise<number> {\n const now = new Date().toISOString()\n return this.driver.insert(\n `INSERT INTO tasks (slug, title, description, status, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)`,\n [params.slug, params.title, params.description ?? null, params.status ?? 'pending', now, now],\n )\n }\n\n async addAcceptance(taskId: number, criteria: string[]): Promise<void> {\n for (const criterion of criteria) {\n await this.driver.exec(\n `INSERT INTO task_acceptance (task_id, criterion) VALUES (?, ?)`,\n [taskId, criterion],\n )\n }\n }\n\n async getAll(status?: TaskStatus, includeArchived = false): Promise<TaskRow[]> {\n let sql = `SELECT * FROM tasks`\n const params: unknown[] = []\n const conditions: string[] = []\n\n if (!includeArchived) {\n conditions.push(`archived_at IS NULL`)\n }\n if (status) {\n conditions.push(`status = ?`)\n params.push(status)\n }\n if (conditions.length > 0) {\n sql += ` WHERE ${conditions.join(' AND ')}`\n }\n sql += ` ORDER BY CASE status WHEN 'pending' THEN 1 WHEN 'in_progress' THEN 2 WHEN 'blocked' THEN 3 WHEN 'done' THEN 4 ELSE 5 END, updated_at DESC`\n\n return this.driver.query<TaskRow>(sql, params)\n }\n\n async getAllWithAcceptanceCounts(includeArchived = false): Promise<TaskWithAcceptance[]> {\n let sql = `\n SELECT t.*,\n COUNT(ta.id) as acceptance_total,\n COALESCE(SUM(ta.met), 0) as acceptance_met\n FROM tasks t\n LEFT JOIN task_acceptance ta ON ta.task_id = t.id\n `\n if (!includeArchived) {\n sql += ` WHERE t.archived_at IS NULL`\n }\n sql += ` GROUP BY t.id ORDER BY CASE t.status WHEN 'pending' THEN 1 WHEN 'in_progress' THEN 2 WHEN 'blocked' THEN 3 WHEN 'done' THEN 4 ELSE 5 END, t.updated_at DESC`\n return this.driver.query<TaskWithAcceptance>(sql)\n }\n\n async getById(id: number): Promise<TaskRow | null> {\n return this.driver.queryOne<TaskRow>(`SELECT * FROM tasks WHERE id = ?`, [id])\n }\n\n async getBySlug(slug: string): Promise<TaskRow | null> {\n return this.driver.queryOne<TaskRow>(`SELECT * FROM tasks WHERE slug = ?`, [slug])\n }\n\n async getAcceptance(taskId: number): Promise<TaskAcceptanceRow[]> {\n return this.driver.query<TaskAcceptanceRow>(\n `SELECT * FROM task_acceptance WHERE task_id = ?`,\n [taskId],\n )\n }\n\n /** Returns ALL task_acceptance rows regardless of task — used by full DB\n * exports (e.g. `ahk migrate storage`) so criteria aren't silently dropped. */\n async getAllAcceptance(): Promise<TaskAcceptanceRow[]> {\n return this.driver.query<TaskAcceptanceRow>(`SELECT * FROM task_acceptance ORDER BY id`)\n }\n\n async setStatus(id: number, status: TaskStatus, extra?: { started_at?: string; completed_at?: string }): Promise<void> {\n const now = new Date().toISOString()\n if (extra?.started_at) {\n await this.driver.exec(\n `UPDATE tasks SET status = ?, started_at = ?, updated_at = ? WHERE id = ?`,\n [status, extra.started_at, now, id],\n )\n } else if (extra?.completed_at) {\n await this.driver.exec(\n `UPDATE tasks SET status = ?, completed_at = ?, updated_at = ? WHERE id = ?`,\n [status, extra.completed_at, now, id],\n )\n } else {\n await this.driver.exec(`UPDATE tasks SET status = ?, updated_at = ? WHERE id = ?`, [status, now, id])\n }\n }\n\n async update(id: number, params: { title?: string; description?: string | null; slug?: string }): Promise<void> {\n const sets: string[] = []\n const vals: unknown[] = []\n const now = new Date().toISOString()\n if (params.title !== undefined) { sets.push('title = ?'); vals.push(params.title) }\n if (params.description !== undefined) { sets.push('description = ?'); vals.push(params.description) }\n if (params.slug !== undefined) { sets.push('slug = ?'); vals.push(params.slug) }\n if (sets.length === 0) return\n sets.push('updated_at = ?')\n vals.push(now)\n vals.push(id)\n await this.driver.exec(`UPDATE tasks SET ${sets.join(', ')} WHERE id = ?`, vals)\n }\n\n async replaceAcceptance(taskId: number, criteria: string[]): Promise<void> {\n await this.driver.exec(`DELETE FROM task_acceptance WHERE task_id = ?`, [taskId])\n for (const criterion of criteria) {\n await this.driver.exec(\n `INSERT INTO task_acceptance (task_id, criterion) VALUES (?, ?)`,\n [taskId, criterion],\n )\n }\n }\n\n async archive(id: number): Promise<void> {\n const now = new Date().toISOString()\n await this.driver.exec(`UPDATE tasks SET archived_at = ?, updated_at = ? WHERE id = ?`, [now, now, id])\n }\n\n async unarchive(id: number): Promise<void> {\n const now = new Date().toISOString()\n await this.driver.exec(`UPDATE tasks SET archived_at = NULL, updated_at = ? WHERE id = ?`, [now, id])\n }\n\n async getArchived(): Promise<TaskRow[]> {\n return this.driver.query<TaskRow>(\n `SELECT * FROM tasks WHERE archived_at IS NOT NULL ORDER BY archived_at DESC`\n )\n }\n\n async claim(id: number, agent: string, now: string): Promise<number> {\n return this.driver.exec(\n `UPDATE tasks SET status = 'in_progress', assigned_to = ?, started_at = ?, updated_at = ? WHERE id = ? AND status = 'pending'`,\n [agent, now, now, id],\n )\n }\n\n async markAcceptanceMet(criterionId: number): Promise<void> {\n await this.driver.exec(`UPDATE task_acceptance SET met = 1 WHERE id = ?`, [criterionId])\n }\n\n async getStatusSummary(): Promise<{ status: string; total: number }[]> {\n return this.driver.query<{ status: string; total: number }>(\n `SELECT status, COUNT(*) as total FROM tasks WHERE archived_at IS NULL GROUP BY status`,\n )\n }\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,128 @@
1
+ // src/core/config.ts
2
+ import { randomUUID } from "crypto";
3
+ import { existsSync } from "fs";
4
+ import { join } from "path";
5
+ import { createJiti } from "jiti";
6
+ var CONFIG_NAMES = [
7
+ "agent-harness-kit.config.ts",
8
+ "agent-harness-kit.config",
9
+ "agent-harness-kit.config.mjs",
10
+ "agent-harness-kit.config.cjs"
11
+ ];
12
+ function findConfigFile(cwd) {
13
+ for (const name of CONFIG_NAMES) {
14
+ const candidate = join(cwd, name);
15
+ if (existsSync(candidate)) return candidate;
16
+ }
17
+ return null;
18
+ }
19
+ async function loadConfig(cwd) {
20
+ const configPath = findConfigFile(cwd);
21
+ if (!configPath) {
22
+ throw new Error("No agent-harness-kit.config found. Run: ahk init");
23
+ }
24
+ const jiti = createJiti(import.meta.url);
25
+ const mod = await jiti.import(configPath);
26
+ const config = mod.default ?? mod;
27
+ if (!config || typeof config !== "object") {
28
+ throw new Error(`agent-harness-kit.config must export a default HarnessConfig object.`);
29
+ }
30
+ return applyDefaults(config);
31
+ }
32
+ function defineHarness(config) {
33
+ return config;
34
+ }
35
+ function normalizeLegacyStorageShape(raw) {
36
+ const storage = raw.storage;
37
+ const database = raw.database;
38
+ if (!storage || storage.scope !== "global") return raw;
39
+ const offenders = [];
40
+ let normalizedStorage = storage;
41
+ let normalizedDatabase = database;
42
+ const omit = (obj, key) => Object.fromEntries(Object.entries(obj).filter(([k]) => k !== key));
43
+ if (database && typeof database.path === "string" && database.path) {
44
+ offenders.push("database.path");
45
+ normalizedDatabase = omit(database, "path");
46
+ }
47
+ if (typeof storage.sqlitePath === "string" && storage.sqlitePath) {
48
+ offenders.push("storage.sqlitePath");
49
+ normalizedStorage = omit(normalizedStorage, "sqlitePath");
50
+ }
51
+ const markdownFallback = normalizedStorage.markdownFallback;
52
+ if (markdownFallback && typeof markdownFallback.path === "string" && markdownFallback.path) {
53
+ offenders.push("storage.markdownFallback.path");
54
+ normalizedStorage = { ...normalizedStorage, markdownFallback: omit(markdownFallback, "path") };
55
+ }
56
+ if (offenders.length === 0) return raw;
57
+ console.warn(
58
+ `[agent-harness-kit] storage.scope is 'global' but ${offenders.join(", ")} ${offenders.length > 1 ? "are" : "is"} set in agent-harness-kit.config.ts \u2014 ${offenders.length > 1 ? "these are" : "this is"} ignored under global scope and will be removed by a future major version. See docs/architecture.md#storage-scope.`
59
+ );
60
+ return { ...raw, storage: normalizedStorage, database: normalizedDatabase ?? database };
61
+ }
62
+ function applyDefaults(config) {
63
+ const normalized = normalizeLegacyStorageShape(config);
64
+ const c = normalized;
65
+ const scope = c.storage?.scope === "global" ? "global" : "local";
66
+ const projectId = c.storage?.projectId ?? randomUUID();
67
+ const baseStorage = {
68
+ dir: ".harness",
69
+ tasks: { adapter: "local" },
70
+ sections: {
71
+ toolsUsed: true,
72
+ filesModified: true,
73
+ result: true,
74
+ blockers: true,
75
+ nextSteps: false
76
+ }
77
+ };
78
+ const storageOverrides = c.storage ?? {};
79
+ const storage = scope === "global" ? {
80
+ ...baseStorage,
81
+ markdownFallback: { enabled: true },
82
+ ...storageOverrides,
83
+ scope: "global",
84
+ projectId
85
+ } : {
86
+ ...baseStorage,
87
+ markdownFallback: { enabled: true, path: ".harness/current.md" },
88
+ ...storageOverrides,
89
+ scope: "local",
90
+ projectId
91
+ };
92
+ return {
93
+ ...normalized,
94
+ provider: c.provider ?? "claude-code",
95
+ project: {
96
+ docsPath: "./docs",
97
+ agentsMd: "./AGENTS.md",
98
+ ...c.project
99
+ },
100
+ agents: {
101
+ lead: { instructionsPath: null },
102
+ explorer: { instructionsPath: null },
103
+ builder: { instructionsPath: null },
104
+ reviewer: { instructionsPath: null },
105
+ custom: [],
106
+ ...c.agents
107
+ },
108
+ database: c.database ?? { type: "sqlite" },
109
+ storage,
110
+ health: {
111
+ scriptPath: "./health.sh",
112
+ required: true,
113
+ ...c.health
114
+ },
115
+ tools: {
116
+ mcp: { enabled: true, port: 3742 },
117
+ scripts: { enabled: true, outputDir: "./.harness/scripts" },
118
+ ...c.tools
119
+ }
120
+ };
121
+ }
122
+
123
+ export {
124
+ findConfigFile,
125
+ loadConfig,
126
+ defineHarness
127
+ };
128
+ //# sourceMappingURL=chunk-D64KK6UU.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/core/config.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto'\nimport { existsSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { createJiti } from 'jiti'\n\nimport type { HarnessConfig } from '@/types'\n\nconst CONFIG_NAMES = [\n 'agent-harness-kit.config.ts',\n 'agent-harness-kit.config',\n 'agent-harness-kit.config.mjs',\n 'agent-harness-kit.config.cjs',\n]\n\nexport function findConfigFile(cwd: string): string | null {\n for (const name of CONFIG_NAMES) {\n const candidate = join(cwd, name)\n if (existsSync(candidate)) return candidate\n }\n return null\n}\n\nexport async function loadConfig(cwd: string): Promise<HarnessConfig> {\n const configPath = findConfigFile(cwd)\n if (!configPath) {\n throw new Error('No agent-harness-kit.config found. Run: ahk init')\n }\n\n const jiti = createJiti(import.meta.url)\n const mod = await jiti.import(configPath) as { default?: HarnessConfig } | HarnessConfig\n const config = (mod as { default?: HarnessConfig }).default ?? (mod as HarnessConfig)\n\n if (!config || typeof config !== 'object') {\n throw new Error(`agent-harness-kit.config must export a default HarnessConfig object.`)\n }\n\n return applyDefaults(config as HarnessConfig)\n}\n\nexport function defineHarness(config: HarnessConfig): HarnessConfig {\n return config\n}\n\n/** Detects and normalizes the legacy contradictory config shape: `scope:\n * 'global'` declared alongside now-meaningless local-only path fields\n * (`database.path` / `storage.sqlitePath`, `storage.markdownFallback.path`).\n *\n * This is necessary IN ADDITION to the type-level redesign (not instead of\n * it) because `loadConfig()` loads `agent-harness-kit.config.ts` via\n * `jiti.import()` at runtime, which transpiles TS to JS and strips types\n * entirely before the module is ever evaluated — a hard type error on\n * `GlobalStorageConfig` protects authors who type-check their config file\n * (IDE, `tsc --noEmit`), but gives ZERO protection against an existing\n * config on disk that already has both fields set. Operates on the RAW\n * untyped input (may not conform to the new types at all) and returns a\n * normalized (stripped) plain object — never crashes, only warns. */\nfunction normalizeLegacyStorageShape(raw: Record<string, unknown>): Record<string, unknown> {\n const storage = raw.storage as Record<string, unknown> | undefined\n const database = raw.database as Record<string, unknown> | undefined\n if (!storage || storage.scope !== 'global') return raw\n\n const offenders: string[] = []\n let normalizedStorage = storage\n let normalizedDatabase = database\n\n const omit = (obj: Record<string, unknown>, key: string): Record<string, unknown> =>\n Object.fromEntries(Object.entries(obj).filter(([k]) => k !== key))\n\n if (database && typeof database.path === 'string' && database.path) {\n offenders.push('database.path')\n normalizedDatabase = omit(database, 'path')\n }\n if (typeof storage.sqlitePath === 'string' && storage.sqlitePath) {\n offenders.push('storage.sqlitePath')\n normalizedStorage = omit(normalizedStorage, 'sqlitePath')\n }\n const markdownFallback = normalizedStorage.markdownFallback as Record<string, unknown> | undefined\n if (markdownFallback && typeof markdownFallback.path === 'string' && markdownFallback.path) {\n offenders.push('storage.markdownFallback.path')\n normalizedStorage = { ...normalizedStorage, markdownFallback: omit(markdownFallback, 'path') }\n }\n\n if (offenders.length === 0) return raw\n\n console.warn(\n `[agent-harness-kit] storage.scope is 'global' but ${offenders.join(', ')} ${offenders.length > 1 ? 'are' : 'is'} set in ` +\n `agent-harness-kit.config.ts — ${offenders.length > 1 ? 'these are' : 'this is'} ignored under global scope and will be ` +\n `removed by a future major version. See docs/architecture.md#storage-scope.`,\n )\n\n return { ...raw, storage: normalizedStorage, database: normalizedDatabase ?? database }\n}\n\nfunction applyDefaults(config: HarnessConfig): HarnessConfig {\n const normalized = normalizeLegacyStorageShape(config as unknown as Record<string, unknown>)\n const c = normalized as Partial<HarnessConfig>\n\n const scope: 'local' | 'global' = c.storage?.scope === 'global' ? 'global' : 'local'\n const projectId = c.storage?.projectId ?? randomUUID()\n const baseStorage = {\n dir: '.harness',\n tasks: { adapter: 'local' as const },\n sections: {\n toolsUsed: true,\n filesModified: true,\n result: true,\n blockers: true,\n nextSteps: false,\n },\n }\n\n const storageOverrides = (c.storage ?? {}) as Record<string, unknown>\n\n const storage: HarnessConfig['storage'] =\n scope === 'global'\n ? ({\n ...baseStorage,\n markdownFallback: { enabled: true },\n ...storageOverrides,\n scope: 'global',\n projectId,\n } as HarnessConfig['storage'])\n : ({\n ...baseStorage,\n markdownFallback: { enabled: true, path: '.harness/current.md' },\n ...storageOverrides,\n scope: 'local',\n projectId,\n } as HarnessConfig['storage'])\n\n return {\n ...(normalized as unknown as HarnessConfig),\n provider: c.provider ?? 'claude-code',\n project: {\n docsPath: './docs',\n agentsMd: './AGENTS.md',\n ...c.project,\n } as HarnessConfig['project'],\n agents: {\n lead: { instructionsPath: null },\n explorer: { instructionsPath: null },\n builder: { instructionsPath: null },\n reviewer: { instructionsPath: null },\n custom: [],\n ...c.agents,\n } as HarnessConfig['agents'],\n database: c.database ?? { type: 'sqlite' as const },\n storage,\n health: {\n scriptPath: './health.sh',\n required: true,\n ...c.health,\n },\n tools: {\n mcp: { enabled: true, port: 3742 },\n scripts: { enabled: true, outputDir: './.harness/scripts' },\n ...c.tools,\n } as HarnessConfig['tools'],\n }\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AAC3B,SAAS,kBAAkB;AAC3B,SAAS,YAAY;AACrB,SAAS,kBAAkB;AAI3B,IAAM,eAAe;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,SAAS,eAAe,KAA4B;AACzD,aAAW,QAAQ,cAAc;AAC/B,UAAM,YAAY,KAAK,KAAK,IAAI;AAChC,QAAI,WAAW,SAAS,EAAG,QAAO;AAAA,EACpC;AACA,SAAO;AACT;AAEA,eAAsB,WAAW,KAAqC;AACpE,QAAM,aAAa,eAAe,GAAG;AACrC,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AAEA,QAAM,OAAO,WAAW,YAAY,GAAG;AACvC,QAAM,MAAM,MAAM,KAAK,OAAO,UAAU;AACxC,QAAM,SAAU,IAAoC,WAAY;AAEhE,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,UAAM,IAAI,MAAM,sEAAsE;AAAA,EACxF;AAEA,SAAO,cAAc,MAAuB;AAC9C;AAEO,SAAS,cAAc,QAAsC;AAClE,SAAO;AACT;AAeA,SAAS,4BAA4B,KAAuD;AAC1F,QAAM,UAAU,IAAI;AACpB,QAAM,WAAW,IAAI;AACrB,MAAI,CAAC,WAAW,QAAQ,UAAU,SAAU,QAAO;AAEnD,QAAM,YAAsB,CAAC;AAC7B,MAAI,oBAAoB;AACxB,MAAI,qBAAqB;AAEzB,QAAM,OAAO,CAAC,KAA8B,QAC1C,OAAO,YAAY,OAAO,QAAQ,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,MAAM,GAAG,CAAC;AAEnE,MAAI,YAAY,OAAO,SAAS,SAAS,YAAY,SAAS,MAAM;AAClE,cAAU,KAAK,eAAe;AAC9B,yBAAqB,KAAK,UAAU,MAAM;AAAA,EAC5C;AACA,MAAI,OAAO,QAAQ,eAAe,YAAY,QAAQ,YAAY;AAChE,cAAU,KAAK,oBAAoB;AACnC,wBAAoB,KAAK,mBAAmB,YAAY;AAAA,EAC1D;AACA,QAAM,mBAAmB,kBAAkB;AAC3C,MAAI,oBAAoB,OAAO,iBAAiB,SAAS,YAAY,iBAAiB,MAAM;AAC1F,cAAU,KAAK,+BAA+B;AAC9C,wBAAoB,EAAE,GAAG,mBAAmB,kBAAkB,KAAK,kBAAkB,MAAM,EAAE;AAAA,EAC/F;AAEA,MAAI,UAAU,WAAW,EAAG,QAAO;AAEnC,UAAQ;AAAA,IACN,qDAAqD,UAAU,KAAK,IAAI,CAAC,IAAI,UAAU,SAAS,IAAI,QAAQ,IAAI,8CAC7E,UAAU,SAAS,IAAI,cAAc,SAAS;AAAA,EAEnF;AAEA,SAAO,EAAE,GAAG,KAAK,SAAS,mBAAmB,UAAU,sBAAsB,SAAS;AACxF;AAEA,SAAS,cAAc,QAAsC;AAC3D,QAAM,aAAa,4BAA4B,MAA4C;AAC3F,QAAM,IAAI;AAEV,QAAM,QAA4B,EAAE,SAAS,UAAU,WAAW,WAAW;AAC7E,QAAM,YAAY,EAAE,SAAS,aAAa,WAAW;AACrD,QAAM,cAAc;AAAA,IAClB,KAAK;AAAA,IACL,OAAO,EAAE,SAAS,QAAiB;AAAA,IACnC,UAAU;AAAA,MACR,WAAW;AAAA,MACX,eAAe;AAAA,MACf,QAAQ;AAAA,MACR,UAAU;AAAA,MACV,WAAW;AAAA,IACb;AAAA,EACF;AAEA,QAAM,mBAAoB,EAAE,WAAW,CAAC;AAExC,QAAM,UACJ,UAAU,WACL;AAAA,IACC,GAAG;AAAA,IACH,kBAAkB,EAAE,SAAS,KAAK;AAAA,IAClC,GAAG;AAAA,IACH,OAAO;AAAA,IACP;AAAA,EACF,IACC;AAAA,IACC,GAAG;AAAA,IACH,kBAAkB,EAAE,SAAS,MAAM,MAAM,sBAAsB;AAAA,IAC/D,GAAG;AAAA,IACH,OAAO;AAAA,IACP;AAAA,EACF;AAEN,SAAO;AAAA,IACL,GAAI;AAAA,IACJ,UAAU,EAAE,YAAY;AAAA,IACxB,SAAS;AAAA,MACP,UAAU;AAAA,MACV,UAAU;AAAA,MACV,GAAG,EAAE;AAAA,IACP;AAAA,IACA,QAAQ;AAAA,MACN,MAAM,EAAE,kBAAkB,KAAK;AAAA,MAC/B,UAAU,EAAE,kBAAkB,KAAK;AAAA,MACnC,SAAS,EAAE,kBAAkB,KAAK;AAAA,MAClC,UAAU,EAAE,kBAAkB,KAAK;AAAA,MACnC,QAAQ,CAAC;AAAA,MACT,GAAG,EAAE;AAAA,IACP;AAAA,IACA,UAAU,EAAE,YAAY,EAAE,MAAM,SAAkB;AAAA,IAClD;AAAA,IACA,QAAQ;AAAA,MACN,YAAY;AAAA,MACZ,UAAU;AAAA,MACV,GAAG,EAAE;AAAA,IACP;AAAA,IACA,OAAO;AAAA,MACL,KAAK,EAAE,SAAS,MAAM,MAAM,KAAK;AAAA,MACjC,SAAS,EAAE,SAAS,MAAM,WAAW,qBAAqB;AAAA,MAC1D,GAAG,EAAE;AAAA,IACP;AAAA,EACF;AACF;","names":[]}