@cardor/agent-harness-kit 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,141 @@
+export type Provider = 'claude-code' | 'opencode';
+export interface ProjectConfig {
+    name: string;
+    description: string;
+    docsPath: string;
+    agentsMd?: string | null;
+}
+export interface AgentConfig {
+    instructionsPath: string | null;
+    context?: string;
+    allowedPaths?: string[];
+    writablePaths?: string[];
+}
+export interface CustomAgentConfig {
+    name: string;
+    instructionsPath: string;
+}
+export interface AgentsConfig {
+    lead: AgentConfig;
+    explorer: AgentConfig;
+    builder: AgentConfig;
+    reviewer: AgentConfig;
+    custom?: CustomAgentConfig[];
+}
+export type TasksAdapter = 'local' | 'jira' | 'linear' | 'mcp';
+export interface ActionSections {
+    toolsUsed: boolean;
+    filesModified: boolean;
+    result: boolean;
+    blockers: boolean;
+    nextSteps: boolean;
+}
+export interface StorageConfig {
+    dir: string;
+    dbPath: string;
+    tasks: {
+        adapter: TasksAdapter;
+        [key: string]: unknown;
+    };
+    sections: ActionSections;
+    markdownFallback: {
+        enabled: boolean;
+        path: string;
+    };
+}
+export interface HealthConfig {
+    scriptPath: string;
+    required: boolean;
+}
+export interface ToolsConfig {
+    mcp: {
+        enabled: boolean;
+        port: number;
+    };
+    scripts: {
+        enabled: boolean;
+        outputDir: string;
+    };
+}
+export interface HarnessConfig {
+    project: ProjectConfig;
+    provider: Provider;
+    agents: AgentsConfig;
+    storage: StorageConfig;
+    health: HealthConfig;
+    tools: ToolsConfig;
+}
+export type TaskStatus = 'pending' | 'in_progress' | 'done' | 'blocked';
+export interface TaskRow {
+    id: number;
+    slug: string;
+    title: string;
+    description: string | null;
+    status: TaskStatus;
+    assigned_to: string | null;
+    created_at: string;
+    started_at: string | null;
+    completed_at: string | null;
+}
+export interface TaskAcceptanceRow {
+    id: number;
+    task_id: number;
+    criterion: string;
+    met: number;
+}
+export type AgentName = 'lead' | 'explorer' | 'builder' | 'reviewer' | `custom:${string}`;
+export type ActionStatus = 'in_progress' | 'completed' | 'blocked';
+export interface ActionRow {
+    id: string;
+    task_id: number;
+    agent: AgentName;
+    status: ActionStatus;
+    created_at: string;
+    completed_at: string | null;
+    summary: string | null;
+}
+export interface ActionSectionRow {
+    id: number;
+    action_id: string;
+    section_type: string;
+    content: string;
+    created_at: string;
+}
+export interface ActionFileRow {
+    id: number;
+    action_id: string;
+    file_path: string;
+    operation: 'read' | 'created' | 'modified' | 'deleted';
+    notes: string | null;
+}
+export interface ActionToolRow {
+    id: number;
+    action_id: string;
+    tool_name: string;
+    args_json: string | null;
+    result_summary: string | null;
+    called_at: string;
+}
+export interface TaskSeed {
+    slug: string;
+    title: string;
+    description?: string;
+    acceptance?: string[];
+}
+export interface McpContent {
+    type: 'text';
+    text: string;
+}
+export interface McpToolResult {
+    content: McpContent[];
+    isError?: boolean;
+}
+export interface ScaffoldOptions {
+    cwd: string;
+    firstTask?: {
+        title: string;
+        description: string;
+        acceptance: string[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@cardor/agent-harness-kit",
+  "version": "0.1.0",
+  "description": "CLI scaffolding for multi-agent harness systems",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "ahk": "./bin/ahk.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "node --test dist/tests/*.test.js",
+    "prepublishOnly": "npm run build && npm test",
+    "prepare": "husky"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "keywords": [
+    "agents",
+    "ai",
+    "harness",
+    "claude",
+    "mcp",
+    "scaffolding"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@clack/prompts": "^0.9.0",
+    "@modelcontextprotocol/sdk": "^1.10.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^12.1.0",
+    "jiti": "^2.4.2",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.5.3",
+    "@commitlint/config-conventional": "^20.5.3",
+    "@types/node": "^22.19.17",
+    "husky": "^9.1.7",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}