helixmind 0.1.0

package/dist/tools/spiral-query.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export const spiralQuerySchema = {
+    query: z.string().describe('What context to search for'),
+    max_tokens: z.number().optional().describe('Maximum tokens to return (default: 4000)'),
+    levels: z.array(z.number().min(1).max(5)).optional().describe('Which levels to include (default: [1,2,3,4,5])'),
+};
+export async function handleSpiralQuery(engine, args) {
+    const result = await engine.query(args.query, args.max_tokens, args.levels);
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=spiral-query.js.map

package/dist/tools/spiral-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-query.js","sourceRoot":"","sources":["../../src/tools/spiral-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACxD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IACtF,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CAChH,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAoB,EACpB,IAA+D;IAE/D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAE5E,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/spiral-relate.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import type { SpiralEngine } from '../spiral/engine.js';
+import type { RelationType } from '../types.js';
+export declare const spiralRelateSchema: {
+    source_id: z.ZodString;
+    target_id: z.ZodString;
+    type: z.ZodEnum<["depends_on", "related_to", "caused_by", "fixes", "supersedes", "part_of"]>;
+    weight: z.ZodOptional<z.ZodNumber>;
+};
+export declare function handleSpiralRelate(engine: SpiralEngine, args: {
+    source_id: string;
+    target_id: string;
+    type: RelationType;
+    weight?: number;
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=spiral-relate.d.ts.map

package/dist/tools/spiral-relate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-relate.d.ts","sourceRoot":"","sources":["../../src/tools/spiral-relate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,eAAO,MAAM,kBAAkB;;;;;CAK9B,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE;IACJ,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;;;;;GAcF"}

package/dist/tools/spiral-relate.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export const spiralRelateSchema = {
+    source_id: z.string().describe('Source node ID'),
+    target_id: z.string().describe('Target node ID'),
+    type: z.enum(['depends_on', 'related_to', 'caused_by', 'fixes', 'supersedes', 'part_of']).describe('Relation type'),
+    weight: z.number().min(0).max(1).optional().describe('Relation strength (0.0–1.0, default: 1.0)'),
+};
+export async function handleSpiralRelate(engine, args) {
+    const edge = engine.relate(args.source_id, args.target_id, args.type, args.weight);
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    edge_id: edge.id,
+                    source_id: edge.source_id,
+                    target_id: edge.target_id,
+                }, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=spiral-relate.js.map

package/dist/tools/spiral-relate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-relate.js","sourceRoot":"","sources":["../../src/tools/spiral-relate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;IACnH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CAClG,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAoB,EACpB,IAKC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAEnF,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,OAAO,EAAE,IAAI,CAAC,EAAE;oBAChB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC1B,EAAE,IAAI,EAAE,CAAC,CAAC;aACZ,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/spiral-status.d.ts

@@ -0,0 +1,8 @@
+import type { SpiralEngine } from '../spiral/engine.js';
+export declare function handleSpiralStatus(engine: SpiralEngine): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=spiral-status.d.ts.map

package/dist/tools/spiral-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-status.d.ts","sourceRoot":"","sources":["../../src/tools/spiral-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,YAAY;;;;;GAS5D"}

package/dist/tools/spiral-status.js

@@ -0,0 +1,10 @@
+export async function handleSpiralStatus(engine) {
+    const result = engine.status();
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=spiral-status.js.map

package/dist/tools/spiral-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-status.js","sourceRoot":"","sources":["../../src/tools/spiral-status.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAoB;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;IAE/B,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/tools/spiral-store.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import type { SpiralEngine } from '../spiral/engine.js';
+import type { ContextType } from '../types.js';
+export declare const spiralStoreSchema: {
+    content: z.ZodString;
+    type: z.ZodEnum<["code", "decision", "error", "pattern", "architecture"]>;
+    metadata: z.ZodOptional<z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        function: z.ZodOptional<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        function?: string | undefined;
+        file?: string | undefined;
+        language?: string | undefined;
+        tags?: string[] | undefined;
+    }, {
+        function?: string | undefined;
+        file?: string | undefined;
+        language?: string | undefined;
+        tags?: string[] | undefined;
+    }>>;
+    relations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+export declare function handleSpiralStore(engine: SpiralEngine, args: {
+    content: string;
+    type: ContextType;
+    metadata?: {
+        file?: string;
+        function?: string;
+        language?: string;
+        tags?: string[];
+    };
+    relations?: string[];
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=spiral-store.d.ts.map

package/dist/tools/spiral-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-store.d.ts","sourceRoot":"","sources":["../../src/tools/spiral-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;CAU7B,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACpF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;;;;;GAUF"}

package/dist/tools/spiral-store.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export const spiralStoreSchema = {
+    content: z.string().describe('The context content to store'),
+    type: z.enum(['code', 'decision', 'error', 'pattern', 'architecture']).describe('Type of context'),
+    metadata: z.object({
+        file: z.string().optional(),
+        function: z.string().optional(),
+        language: z.string().optional(),
+        tags: z.array(z.string()).optional(),
+    }).optional().describe('Optional metadata'),
+    relations: z.array(z.string()).optional().describe('IDs of related context nodes'),
+};
+export async function handleSpiralStore(engine, args) {
+    const result = await engine.store(args.content, args.type, args.metadata, args.relations);
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify(result, null, 2),
+            }],
+    };
+}
+//# sourceMappingURL=spiral-store.js.map

package/dist/tools/spiral-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spiral-store.js","sourceRoot":"","sources":["../../src/tools/spiral-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC5D,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAClG,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KACrC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CACnF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAoB,EACpB,IAKC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAE1F,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;aACtC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,92 @@
+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;
+}
+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;
+/**
+ * Allocates token budget across 5 spiral levels.
+ * 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);
+}
+/**
+ * Allocates token budget across 5 spiral levels.
+ * 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,90 @@
+{
+  "name": "helixmind",
+  "version": "0.1.0",
+  "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": "^4.73.0",
+    "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"
+  }
+}