helixmind 0.5.4

package/dist/types.d.ts

@@ -0,0 +1,94 @@
+export type ContextType = 'code' | 'decision' | 'error' | 'pattern' | 'architecture' | 'module' | 'summary';
+export type RelationType = 'depends_on' | 'related_to' | 'caused_by' | 'fixes' | 'supersedes' | 'part_of' | 'imports' | 'calls' | 'belongs_to' | 'implements' | 'similar_to' | 'summarizes';
+export type SpiralLevel = 1 | 2 | 3 | 4 | 5;
+/** Level semantics: 1=Focus, 2=Active, 3=Reference, 4=Archive, 5=Deep Archive */
+export declare const LEVEL_NAMES: Record<SpiralLevel, string>;
+export type EmbeddingStatus = 'loaded' | 'loading' | 'fallback';
+export interface NodeMetadata {
+    file?: string;
+    function?: string;
+    language?: string;
+    tags?: string[];
+    error_type?: string;
+    project?: string;
+    [key: string]: unknown;
+}
+export interface ContextNode {
+    id: string;
+    type: ContextType;
+    content: string;
+    summary: string | null;
+    level: SpiralLevel;
+    relevance_score: number;
+    token_count: number;
+    metadata: NodeMetadata;
+    created_at: number;
+    updated_at: number;
+    accessed_at: number;
+}
+export interface Edge {
+    id: string;
+    source_id: string;
+    target_id: string;
+    relation_type: RelationType;
+    weight: number;
+    metadata: Record<string, unknown>;
+    created_at: number;
+}
+export interface SpiralQueryResult {
+    level_1: SpiralResultNode[];
+    level_2: SpiralResultNode[];
+    level_3: SpiralResultNode[];
+    level_4: SpiralResultNode[];
+    level_5: SpiralResultNode[];
+    total_tokens: number;
+    node_count: number;
+}
+export interface SpiralResultNode {
+    id: string;
+    type: ContextType;
+    content: string;
+    relevance: number;
+}
+export interface SpiralStoreResult {
+    node_id: string;
+    level: SpiralLevel;
+    connections: number;
+    token_count: number;
+    /** True if this content already existed and was refreshed instead of duplicated */
+    deduplicated?: boolean;
+}
+export interface SpiralStatusResult {
+    total_nodes: number;
+    per_level: Record<SpiralLevel, number>;
+    total_edges: number;
+    storage_size_bytes: number;
+    oldest_node: string | null;
+    newest_node: string | null;
+    embedding_status: EmbeddingStatus;
+}
+export interface SpiralCompactResult {
+    compacted_nodes: number;
+    freed_tokens: number;
+    nodes_deleted: number;
+}
+export interface SpiralConfig {
+    dataDir: string;
+    maxTokens: number;
+    model: string;
+    logLevel: 'debug' | 'info' | 'warn' | 'error';
+    embeddingDimensions: number;
+    levelThresholds: {
+        l1Min: number;
+        l2Min: number;
+        l3Min: number;
+        l4Min: number;
+    };
+    decayRate: number;
+    decayIntervalHours: number;
+}
+export interface VectorSearchResult {
+    node_id: string;
+    distance: number;
+}
+//# 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,9 @@
+/** Level semantics: 1=Focus, 2=Active, 3=Reference, 4=Archive, 5=Deep Archive */
+export const LEVEL_NAMES = {
+    1: 'Focus',
+    2: 'Active',
+    3: 'Reference',
+    4: 'Archive',
+    5: 'Deep Archive',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAkBA,iFAAiF;AACjF,MAAM,CAAC,MAAM,WAAW,GAAgC;IACtD,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,cAAc;CAClB,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,14 @@
+import type { SpiralConfig } from '../types.js';
+export type BrainScope = 'project' | 'global';
+/**
+ * Determine the default brain scope for a project directory.
+ * If `.helixmind/` exists in the project root → project-local.
+ * Otherwise → global.
+ */
+export declare function detectBrainScope(projectRoot: string): BrainScope;
+/**
+ * Resolve the data directory for a given scope.
+ */
+export declare function resolveDataDir(scope: BrainScope, projectRoot: string): string;
+export declare function loadConfig(overrideDataDir?: string): SpiralConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAa9C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAEhE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,wBAAgB,UAAU,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,YAAY,CAgBjE"}

package/dist/utils/config.js

@@ -0,0 +1,44 @@
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { existsSync } from 'node:fs';
+function globalDataDir() {
+    if (process.env.SPIRAL_DATA_DIR) {
+        return process.env.SPIRAL_DATA_DIR;
+    }
+    return join(homedir(), '.spiral-context');
+}
+function projectDataDir(projectRoot) {
+    return join(projectRoot, '.helixmind');
+}
+/**
+ * Determine the default brain scope for a project directory.
+ * If `.helixmind/` exists in the project root → project-local.
+ * Otherwise → global.
+ */
+export function detectBrainScope(projectRoot) {
+    return existsSync(projectDataDir(projectRoot)) ? 'project' : 'global';
+}
+/**
+ * Resolve the data directory for a given scope.
+ */
+export function resolveDataDir(scope, projectRoot) {
+    return scope === 'project' ? projectDataDir(projectRoot) : globalDataDir();
+}
+export function loadConfig(overrideDataDir) {
+    return {
+        dataDir: overrideDataDir ?? globalDataDir(),
+        maxTokens: parseInt(process.env.SPIRAL_MAX_TOKENS ?? '4000', 10),
+        model: process.env.SPIRAL_MODEL ?? 'Xenova/all-MiniLM-L6-v2',
+        logLevel: process.env.SPIRAL_LOG_LEVEL ?? 'info',
+        embeddingDimensions: 384,
+        levelThresholds: {
+            l1Min: 0.7,
+            l2Min: 0.5,
+            l3Min: 0.3,
+            l4Min: 0.1,
+        },
+        decayRate: 0.05,
+        decayIntervalHours: 1,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAKrC,SAAS,aAAa;IACpB,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IACrC,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,cAAc,CAAC,WAAmB;IACzC,OAAO,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IAClD,OAAO,UAAU,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAiB,EAAE,WAAmB;IACnE,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,eAAwB;IACjD,OAAO;QACL,OAAO,EAAE,eAAe,IAAI,aAAa,EAAE;QAC3C,SAAS,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM,EAAE,EAAE,CAAC;QAChE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,yBAAyB;QAC5D,QAAQ,EAAG,OAAO,CAAC,GAAG,CAAC,gBAA6C,IAAI,MAAM;QAC9E,mBAAmB,EAAE,GAAG;QACxB,eAAe,EAAE;YACf,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,GAAG;SACX;QACD,SAAS,EAAE,IAAI;QACf,kBAAkB,EAAE,CAAC;KACtB,CAAC;AACJ,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,10 @@
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export declare function setLogLevel(level: LogLevel): void;
+export declare const logger: {
+    debug(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+};
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAWpD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAWD,eAAO,MAAM,MAAM;mBACF,MAAM,GAAG,IAAI;kBAMd,MAAM,GAAG,IAAI;kBAMb,MAAM,GAAG,IAAI;mBAMZ,MAAM,GAAG,IAAI;CAK7B,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,40 @@
+const LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+let currentLevel = 'info';
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+function shouldLog(level) {
+    return LEVEL_PRIORITY[level] >= LEVEL_PRIORITY[currentLevel];
+}
+function formatMessage(level, message) {
+    const timestamp = new Date().toISOString();
+    return `[${timestamp}] [${level.toUpperCase()}] ${message}`;
+}
+export const logger = {
+    debug(message) {
+        if (shouldLog('debug')) {
+            process.stderr.write(formatMessage('debug', message) + '\n');
+        }
+    },
+    info(message) {
+        if (shouldLog('info')) {
+            process.stderr.write(formatMessage('info', message) + '\n');
+        }
+    },
+    warn(message) {
+        if (shouldLog('warn')) {
+            process.stderr.write(formatMessage('warn', message) + '\n');
+        }
+    },
+    error(message) {
+        if (shouldLog('error')) {
+            process.stderr.write(formatMessage('error', message) + '\n');
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAA6B;IAC/C,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,IAAI,YAAY,GAAa,MAAM,CAAC;AAEpC,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,YAAY,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,aAAa,CAAC,KAAe,EAAE,OAAe;IACrD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,OAAO,IAAI,SAAS,MAAM,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,CAAC,OAAe;QACnB,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe;QAClB,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe;QAClB,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe;QACnB,IAAI,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/utils/tokens.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Estimates token count for a string using a simple heuristic.
+ * Average ratio: ~4 characters per token for English text/code.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Base token budget percentages per spiral level.
+ * L1 Focus: 25%, L2 Active: 20%, L3 Reference: 10%, L4 Archive: 3%, L5 Deep Archive: 2%, Reserved: 40%
+ */
+export declare function allocateTokenBudget(totalTokens: number): {
+    level1: number;
+    level2: number;
+    level3: number;
+    level4: number;
+    level5: number;
+};
+/**
+ * Truncates text to fit within a token budget, appending "..." if truncated.
+ */
+export declare function truncateToTokens(text: string, maxTokens: number): string;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/utils/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAQA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMxE"}

package/dist/utils/tokens.js

@@ -0,0 +1,33 @@
+/**
+ * Estimates token count for a string using a simple heuristic.
+ * Average ratio: ~4 characters per token for English text/code.
+ */
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Base token budget percentages per spiral level.
+ * L1 Focus: 25%, L2 Active: 20%, L3 Reference: 10%, L4 Archive: 3%, L5 Deep Archive: 2%, Reserved: 40%
+ */
+export function allocateTokenBudget(totalTokens) {
+    return {
+        level1: Math.floor(totalTokens * 0.25),
+        level2: Math.floor(totalTokens * 0.20),
+        level3: Math.floor(totalTokens * 0.10),
+        level4: Math.floor(totalTokens * 0.03),
+        level5: Math.floor(totalTokens * 0.02),
+    };
+}
+/**
+ * Truncates text to fit within a token budget, appending "..." if truncated.
+ */
+export function truncateToTokens(text, maxTokens) {
+    const currentTokens = estimateTokens(text);
+    if (currentTokens <= maxTokens)
+        return text;
+    const maxChars = maxTokens * 4 - 3; // reserve space for "..."
+    return text.slice(0, Math.max(0, maxChars)) + '...';
+}
+//# sourceMappingURL=tokens.js.map

package/dist/utils/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAmB;IAOrD,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QACtC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QACtC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QACtC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;QACtC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC;KACvC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,SAAiB;IAC9D,MAAM,aAAa,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,aAAa,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5C,MAAM,QAAQ,GAAG,SAAS,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,0BAA0B;IAC9D,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAC;AACtD,CAAC"}

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "helixmind",
+  "version": "0.5.4",
+  "description": "HelixMind – AI Coding CLI with Persistent Spiral Memory",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "helixmind": "dist/cli/index.js",
+    "helix": "dist/cli/index.js",
+    "hx": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli/index.ts",
+    "start": "node dist/cli/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "setup": "tsx scripts/setup.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "coding",
+    "cli",
+    "assistant",
+    "memory",
+    "context",
+    "spiral",
+    "claude",
+    "openai",
+    "ollama",
+    "embeddings",
+    "developer-tools",
+    "code-generation",
+    "helixmind"
+  ],
+  "author": "DancingTedDanson",
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DancingTedDanson011/HelixMind.git"
+  },
+  "bugs": {
+    "url": "https://github.com/DancingTedDanson011/HelixMind/issues"
+  },
+  "homepage": "https://github.com/DancingTedDanson011/HelixMind#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.78.0",
+    "@huggingface/transformers": "^3.8.1",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "adm-zip": "^0.5.16",
+    "better-sqlite3": "^11.0.0",
+    "chalk": "^5.4.0",
+    "cli-highlight": "^2.1.0",
+    "commander": "^13.0.0",
+    "fast-glob": "^3.3.0",
+    "figlet": "^1.8.0",
+    "gradient-string": "^3.0.0",
+    "ignore": "^7.0.0",
+    "marked": "^15.0.0",
+    "marked-terminal": "^7.3.0",
+    "nanospinner": "^1.2.0",
+    "openai": "^5.23.2",
+    "sqlite-vec": "^0.1.7-alpha.2",
+    "ws": "^8.19.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.7",
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/figlet": "^1.7.0",
+    "@types/gradient-string": "^1.1.0",
+    "@types/node": "^20.0.0",
+    "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^2.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "optionalDependencies": {
+    "puppeteer-core": "^24.37.5"
+  }
+}