@chude/memory 4.0.0

package/dist/presentation/cli/parsers/date-parser.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Date Parser
+ *
+ * Wrapper around chrono-node for natural language date parsing.
+ * Validates that parsed dates are not in the future (for search filters).
+ */
+/**
+ * Error thrown when date parsing fails.
+ */
+export declare class DateParseError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parse a natural language date string into a Date object.
+ *
+ * Supports formats like:
+ * - "yesterday"
+ * - "2 weeks ago"
+ * - "last Friday"
+ * - "2026-01-15"
+ * - "today"
+ *
+ * @param input Date string to parse
+ * @param referenceDate Reference date for relative calculations (defaults to now)
+ * @returns Parsed Date object
+ * @throws DateParseError if input cannot be parsed or is in the future
+ */
+export declare function parseDate(input: string, referenceDate?: Date): Date;

package/dist/presentation/cli/parsers/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI Parsers Barrel Export
+ *
+ * Date parsing utilities for CLI argument processing.
+ */
+export { parseDate, DateParseError } from "./date-parser.js";

package/dist/presentation/cli/pickers/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * CLI Pickers Barrel Export
+ *
+ * Interactive picker components for CLI commands.
+ */
+export { sessionPicker, canUseInteractivePicker, setTtyOverride, setMocks, type PickerAction, type PickerResult, type SessionPickerOptions, } from "./session-picker.js";

package/dist/presentation/cli/pickers/session-picker.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Session Picker
+ *
+ * Interactive session picker with fzf-style fuzzy search.
+ * Uses @inquirer/search for search interface and @inquirer/select for action menu.
+ */
+import type { ISessionRepository } from "../../../domain/ports/repositories.js";
+/**
+ * Actions available after selecting a session.
+ */
+export type PickerAction = "show" | "search" | "context" | "related" | "cancel";
+/**
+ * Result from the session picker.
+ */
+export interface PickerResult {
+    /** Selected session ID */
+    sessionId: string;
+    /** Action to perform on the session */
+    action: PickerAction;
+}
+/**
+ * Options for the session picker.
+ */
+export interface SessionPickerOptions {
+    /** Repository for loading sessions */
+    sessionRepo: ISessionRepository;
+    /** Maximum sessions to display (default: 100) */
+    limit?: number;
+}
+/**
+ * Set TTY override for testing.
+ *
+ * @param value true/false to override, null to use real value
+ */
+export declare function setTtyOverride(value: boolean | null): void;
+/**
+ * Set mock functions for testing.
+ *
+ * @param searchFn Mock search function
+ * @param selectFn Mock select function
+ */
+export declare function setMocks(searchFn: Function | null, selectFn: Function | null): void;
+/**
+ * Check if interactive mode is available.
+ *
+ * @returns true if running in a TTY
+ */
+export declare function canUseInteractivePicker(): boolean;
+/**
+ * Interactive session picker with fuzzy search.
+ *
+ * Displays a searchable list of sessions with project name and relative time.
+ * After selection, shows an action menu with Show/Search/Context/Related options.
+ *
+ * @param options Picker configuration
+ * @returns PickerResult with sessionId and action, or null if cancelled
+ * @throws Error if not running in TTY mode
+ */
+export declare function sessionPicker(options: SessionPickerOptions): Promise<PickerResult | null>;

package/dist/presentation/cli/progress-reporter.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Progress Reporter for CLI Sync Command
+ *
+ * Adapts progress display to TTY/non-TTY/quiet environments.
+ * TTY: Shows animated progress bar with Unicode or ASCII fallback
+ * Non-TTY: Shows plain text output (safe for pipes/CI)
+ * Quiet: Suppresses all progress output
+ */
+/**
+ * Bar character pair for progress bar rendering.
+ */
+interface BarCharacters {
+    readonly complete: string;
+    readonly incomplete: string;
+}
+/**
+ * Detect whether the current terminal supports Unicode output.
+ *
+ * Most modern terminals (including MINGW64/Git Bash) render Unicode
+ * block characters correctly. The only known exceptions are the Linux
+ * kernel console (TERM=linux) and legacy Windows cmd.exe without
+ * Windows Terminal.
+ *
+ * Note: The Bun bundler's --target=node flag double-encodes UTF-8
+ * literals (Bun #25767), which produces garbled output regardless of
+ * terminal capability. The fix for that is --target=bun in the build
+ * command, not a runtime fallback.
+ *
+ * Exported for testing.
+ */
+export declare function isUnicodeSupported(): boolean;
+/**
+ * Get the appropriate bar characters for the current terminal.
+ *
+ * Returns Unicode block characters on capable terminals,
+ * ASCII fallback otherwise.
+ */
+export declare function getBarCharacters(): BarCharacters;
+/**
+ * Interface for reporting sync progress.
+ *
+ * Implementations adapt to different output environments.
+ */
+export interface ProgressReporter {
+    /**
+     * Start progress tracking with total count.
+     */
+    start(total: number): void;
+    /**
+     * Update progress to current value.
+     */
+    update(current: number, sessionId: string): void;
+    /**
+     * Stop progress tracking and finalize output.
+     */
+    stop(): void;
+    /**
+     * Log a message (for verbose mode).
+     */
+    log(message: string): void;
+}
+/**
+ * Progress reporter for TTY environments.
+ *
+ * Displays an animated progress bar that updates in place.
+ */
+export declare class TtyProgressReporter implements ProgressReporter {
+    private bar;
+    private verbose;
+    private total;
+    private currentValue;
+    constructor(verbose?: boolean);
+    start(total: number): void;
+    update(current: number, sessionId: string): void;
+    stop(): void;
+    log(message: string): void;
+}
+/**
+ * Progress reporter for non-TTY environments (pipes, CI).
+ *
+ * Uses plain text output instead of escape codes.
+ */
+export declare class PlainProgressReporter implements ProgressReporter {
+    private verbose;
+    constructor(verbose?: boolean);
+    start(total: number): void;
+    update(current: number, sessionId: string): void;
+    stop(): void;
+    log(message: string): void;
+}
+/**
+ * Progress reporter that suppresses all output.
+ *
+ * Used for --quiet mode (hooks, scripting).
+ */
+export declare class QuietProgressReporter implements ProgressReporter {
+    start(_total: number): void;
+    update(_current: number, _sessionId: string): void;
+    stop(): void;
+    log(_message: string): void;
+}
+/**
+ * Create appropriate progress reporter based on options and environment.
+ *
+ * Priority:
+ * 1. If quiet=true: QuietProgressReporter (no output)
+ * 2. If not TTY: PlainProgressReporter (safe for pipes)
+ * 3. If TTY: TtyProgressReporter (animated bar)
+ *
+ * @param options Configuration options
+ * @returns Appropriate ProgressReporter for the environment
+ */
+export declare function createProgressReporter(options: {
+    quiet?: boolean;
+    verbose?: boolean;
+}): ProgressReporter;
+/**
+ * Interface for reporting embedding progress.
+ *
+ * Separate from ProgressReporter because embedding uses a different
+ * format (no sessionId) and different progress bar text.
+ */
+export interface EmbeddingProgressReporter {
+    /** Start progress tracking with total count. */
+    start(total: number): void;
+    /** Update progress to current value. */
+    update(current: number): void;
+    /** Stop progress tracking and finalize output. */
+    stop(): void;
+}
+/**
+ * Embedding progress reporter for TTY environments.
+ *
+ * Displays an animated progress bar with embedding-specific format.
+ */
+export declare class TtyEmbeddingProgressReporter implements EmbeddingProgressReporter {
+    private bar;
+    constructor();
+    start(total: number): void;
+    update(current: number): void;
+    stop(): void;
+}
+/**
+ * Embedding progress reporter for non-TTY environments (pipes, CI).
+ *
+ * Uses plain text output instead of escape codes.
+ */
+export declare class PlainEmbeddingProgressReporter implements EmbeddingProgressReporter {
+    start(total: number): void;
+    update(_current: number): void;
+    stop(): void;
+}
+/**
+ * Embedding progress reporter that suppresses all output.
+ *
+ * Used for --quiet mode (hooks, scripting).
+ */
+export declare class QuietEmbeddingProgressReporter implements EmbeddingProgressReporter {
+    start(_total: number): void;
+    update(_current: number): void;
+    stop(): void;
+}
+/**
+ * Create appropriate embedding progress reporter based on options and environment.
+ *
+ * @param options Configuration options
+ * @returns Appropriate EmbeddingProgressReporter for the environment
+ */
+export declare function createEmbeddingProgressReporter(options: {
+    quiet?: boolean;
+}): EmbeddingProgressReporter;
+import type { DownloadProgress } from "../../domain/ports/embedding.js";
+/**
+ * Track the largest download total across multiple progress events.
+ *
+ * Transformers.js emits progress events for multiple files (config.json,
+ * tokenizer.json, model.onnx). Small files may report total=0. This
+ * function keeps the largest total seen so the progress bar shows the
+ * model file size, not a config file's size.
+ *
+ * @param currentMax Current largest total in MB
+ * @param newTotalBytes New total from a progress event in bytes
+ * @returns The larger of currentMax or the new total converted to MB
+ */
+export declare function trackDownloadTotal(currentMax: number, newTotalBytes: number): number;
+/**
+ * Create a handler for model download progress events.
+ *
+ * On TTY: shows animated progress bar for download.
+ * On non-TTY: prints a single announcement line.
+ * On quiet: suppresses all output.
+ *
+ * @param options Configuration options
+ * @returns Callback for DownloadProgress events from provider.initialize()
+ */
+export declare function createModelDownloadHandler(options: {
+    quiet?: boolean;
+}): (progress: DownloadProgress) => void;
+export {};

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@chude/memory",
+  "version": "4.0.0",
+  "description": "Cross-project context persistence for Claude Code sessions",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "memory": "dist/presentation/cli/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "clean:dist": "bun run scripts/clean-dist.ts",
+    "build:types": "tsc --project tsconfig.lib.json",
+    "build:lib": "bun build src/index.ts --outdir dist --target bun --packages=external --minify --sourcemap=none",
+    "build:cli": "bun build src/presentation/cli/index.ts --outdir dist/presentation/cli --target bun --packages=external --minify --sourcemap=none",
+    "build": "bun run clean:dist && bun run build:types && bun run build:lib && bun run build:cli",
+    "build:hook": "bun build src/infrastructure/hooks/sync-hook-script.ts --outfile=dist/sync-hook.js --target=bun",
+    "test": "bun test",
+    "test:coverage": "bun run scripts/run-istanbul-bun-coverage.ts --coverage-dir coverage && bun run scripts/check-coverage-thresholds.ts --summary coverage/coverage-summary.json --threshold 95",
+    "quality": "bun run typecheck && bun run build && bun test --timeout 15000 && bun run test:isolation && bun run test:coverage && bun audit",
+    "test:smoke": "bun test tests/smoke",
+    "test:isolation": "bun run scripts/check-test-isolation.ts",
+    "typecheck": "tsc --noEmit && tsc --project tsconfig.scripts.json",
+    "lint": "bun run typecheck",
+    "mutation": "stryker run",
+    "mutation:domain": "stryker run --mutate 'src/domain/**/!(*.test).ts'"
+  },
+  "author": "Chude <chude@emeke.org>",
+  "license": "MIT",
+  "devDependencies": {
+    "@stryker-mutator/core": "9.6.1",
+    "@stryker-mutator/typescript-checker": "9.6.1",
+    "@stryker-mutator/vitest-runner": "9.6.1",
+    "@types/bun": "1.3.14",
+    "@types/cli-progress": "^3.11.6",
+    "@types/istanbul-lib-coverage": "^2.0.6",
+    "@types/istanbul-lib-instrument": "^1.7.8",
+    "@types/istanbul-lib-report": "^3.0.3",
+    "@types/istanbul-reports": "^3.0.4",
+    "istanbul-lib-coverage": "^3.2.2",
+    "istanbul-lib-instrument": "^6.0.3",
+    "istanbul-lib-report": "^3.0.1",
+    "istanbul-reports": "^3.2.0",
+    "typescript": "^5.5.0",
+    "vitest": "4.1.7"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "context",
+    "memory",
+    "session",
+    "search"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/chudeemeke/memory-nexus.git"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-code": "2.1.152",
+    "@anthropic-ai/sdk": "0.98.1",
+    "@huggingface/transformers": "4.2.0",
+    "@inquirer/search": "4.2.0",
+    "@inquirer/select": "5.2.0",
+    "chart.js": "^4.5.1",
+    "chrono-node": "2.9.1",
+    "cli-progress": "^3.12.0",
+    "commander": "14.0.3",
+    "fuzzy": "^0.1.3",
+    "sqlite-vec": "0.1.9",
+    "string-width": "8.2.1"
+  },
+  "overrides": {
+    "@protobufjs/utf8": "1.1.1",
+    "fast-uri": "3.1.2",
+    "picomatch": "4.0.4",
+    "postcss": "8.5.15",
+    "protobufjs": "8.4.2",
+    "qs": "6.15.2",
+    "rollup": "4.60.4",
+    "vite": "8.0.14",
+    "yaml": "2.9.0"
+  },
+  "trustedDependencies": [
+    "onnxruntime-node",
+    "protobufjs"
+  ]
+}