@cardor/agent-harness-kit 1.10.4 → 1.11.0

package/dist/index.d.ts

@@ -5,27 +5,6 @@ interface ProjectConfig {
     docsPath: string;
     agentsMd?: string | null;
 }
-interface AgentConfig {
-    instructionsPath: string | null;
-    context?: string;
-    allowedPaths?: string[];
-    writablePaths?: string[];
-    model?: string;
-}
-interface CustomAgentConfig {
-    name: string;
-    instructionsPath: string;
-}
-interface AgentsConfig {
-    lead: AgentConfig;
-    explorer: AgentConfig;
-    builder: AgentConfig;
-    reviewer: AgentConfig;
-    /** Optional — the consultant agent has no dedicated config entry elsewhere;
-     *  this exists primarily to carry a per-agent `model` override. */
-    consultant?: AgentConfig;
-    custom?: CustomAgentConfig[];
-}
 type TasksAdapter = 'local' | 'jira' | 'linear' | 'mcp';
 interface ActionSections {
     toolsUsed: boolean;
@@ -108,7 +87,6 @@ interface ToolsConfig {
 interface HarnessConfig {
     project: ProjectConfig;
     provider: Provider;
-    agents: AgentsConfig;
     storage: StorageConfig;
     database: DatabaseConfig;
     health: HealthConfig;
@@ -148,4 +126,4 @@ interface TaskSeed {
 
 declare function defineHarness(config: HarnessConfig): HarnessConfig;
 
-export { type ActionRow, type ActionSections, type ActionStatus, type AgentConfig, type AgentName, type AgentsConfig, type CustomAgentConfig, type HarnessConfig, type HealthConfig, type ProjectConfig, type Provider, type StorageConfig, type TaskRow, type TaskSeed, type TaskStatus, type TasksAdapter, type ToolsConfig, defineHarness };
+export { type ActionRow, type ActionSections, type ActionStatus, type AgentName, type HarnessConfig, type HealthConfig, type ProjectConfig, type Provider, type StorageConfig, type TaskRow, type TaskSeed, type TaskStatus, type TasksAdapter, type ToolsConfig, defineHarness };

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   defineHarness
-} from "./chunk-D64KK6UU.js";
+} from "./chunk-U3O77CGE.js";
 export {
   defineHarness
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cardor/agent-harness-kit",
-  "version": "1.10.4",
+  "version": "1.11.0",
   "description": "CLI scaffolding for multi-agent harness systems",
   "publishConfig": {
     "access": "public"

package/dist/chunk-D64KK6UU.js.map

@@ -1 +0,0 @@
-{"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":"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","names":[]}