mindforge-sdk 10.7.0

package/dist/types.d.ts

@@ -0,0 +1,125 @@
+/**
+ * MindForge SDK — Type Definitions
+ */
+export interface MindForgeConfig {
+    /** Path to the project root (default: cwd) */
+    projectRoot?: string;
+    /** Claude API key (default: ANTHROPIC_API_KEY env var) */
+    apiKey?: string;
+    /** CI mode — disables interactive features */
+    ciMode?: boolean;
+    /** Output format for events */
+    outputFormat?: 'json' | 'text' | 'github-annotations';
+    /** Timeout per task in milliseconds (default: 600000 — 10 minutes) */
+    taskTimeoutMs?: number;
+}
+export interface PhaseResult {
+    phase: number;
+    status: 'success' | 'failure' | 'warning' | 'skipped';
+    tasksCompleted: number;
+    tasksTotal: number;
+    commits: string[];
+    securityFindings: SecurityFinding[];
+    qualityGateResults: GateResult[];
+    durationMs: number;
+    errorMessage?: string;
+}
+export interface TaskResult {
+    planId: string;
+    taskName: string;
+    status: 'completed' | 'failed' | 'skipped';
+    commitSha?: string;
+    verifyOutput?: string;
+    durationMs: number;
+    errorMessage?: string;
+}
+export interface SecurityFinding {
+    severity: 'CRITICAL' | 'HIGH' | 'MEDIUM' | 'LOW';
+    owaspCategory: string;
+    file: string;
+    line: number;
+    description: string;
+    remediation: string;
+    remediated: boolean;
+}
+export interface GateResult {
+    gate: string;
+    status: 'passed' | 'failed' | 'warning' | 'skipped';
+    detail?: string;
+}
+export interface HealthReport {
+    overallStatus: 'healthy' | 'warning' | 'error';
+    errors: HealthIssue[];
+    warnings: HealthIssue[];
+    informational: HealthIssue[];
+    timestamp: string;
+}
+export interface HealthIssue {
+    category: string;
+    message: string;
+    autoRepairable: boolean;
+    fixCommand?: string;
+}
+export type MindForgeEvent = {
+    type: 'task_started';
+    phase: number;
+    plan: string;
+    taskName: string;
+} | {
+    type: 'task_completed';
+    phase: number;
+    plan: string;
+    commitSha: string;
+} | {
+    type: 'task_failed';
+    phase: number;
+    plan: string;
+    error: string;
+} | {
+    type: 'wave_started';
+    phase: number;
+    wave: number;
+    taskCount: number;
+} | {
+    type: 'wave_completed';
+    phase: number;
+    wave: number;
+} | {
+    type: 'phase_completed';
+    phase: number;
+    result: PhaseResult;
+} | {
+    type: 'security_finding';
+    finding: SecurityFinding;
+} | {
+    type: 'gate_result';
+    gate: GateResult;
+} | {
+    type: 'log';
+    level: 'info' | 'warn' | 'error';
+    message: string;
+};
+export interface AuditLogEntry {
+    timestamp: string;
+    event: string;
+    phase?: number;
+    [key: string]: unknown;
+}
+/** v9 Pillar XXIV: Result from a wave execution cycle */
+export interface WaveExecutionResult {
+    phase: number;
+    waveIndex: number;
+    tasksCompleted: number;
+    tasksTotal: number;
+    tasksFailed: string[];
+    durationMs: number;
+    status: 'completed' | 'partial' | 'failed' | 'escalated';
+}
+/** v9 Pillar XXVII: Result from a schema migration run */
+export interface MigrationResult {
+    status: 'migrated' | 'no-migration-needed' | 'no-planning-dir' | 'no-files' | 'no-migrations';
+    from?: string;
+    to?: string;
+    migrationsApplied?: string[];
+    backupDir?: string;
+}

package/dist/types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * MindForge SDK — Type Definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "mindforge-sdk",
+  "version": "10.7.0",
+  "description": "MindForge SDK \u2014 Programmatic API for embedding MindForge in tools",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node tests/sdk.test.js",
+    "lint": "eslint .",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "mindforge",
+    "agentic-framework",
+    "claude",
+    "sdk"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^20.0.0",
+    "eslint": "^9.0.0",
+    "globals": "^15.0.0",
+    "typescript": "^5.4.0",
+    "typescript-eslint": "^8.0.0"
+  }
+}