@yeseh/cortex-cli 0.6.0 → 0.6.4

package/src/utils/resolve-default-store.spec.ts

@@ -0,0 +1,135 @@
+/**
+ * Tests for resolveDefaultStore utility.
+ *
+ * @module cli/utils/resolve-default-store.spec
+ */
+
+import { describe, it, expect } from 'bun:test';
+import { resolveDefaultStore } from './resolve-default-store.ts';
+import type { CortexContext } from '@yeseh/cortex-core';
+
+// Minimal mock context factory
+function makeCtx(
+    overrides: {
+        cwd?: string;
+        stores?: Record<string, { properties?: Record<string, unknown> }>;
+        defaultStore?: string;
+    } = {},
+): CortexContext {
+    return {
+        cwd: overrides.cwd ?? '/home/user/myproject',
+        stores: (overrides.stores ?? {}) as CortexContext['stores'],
+        settings: { defaultStore: overrides.defaultStore },
+        cortex: {} as CortexContext['cortex'],
+        config: {} as CortexContext['config'],
+        now: () => new Date(),
+        stdin: process.stdin,
+        stdout: process.stdout,
+    };
+}
+
+describe('resolveDefaultStore', () => {
+    it('should return explicit store when provided', () => {
+        const ctx = makeCtx({ stores: { mystore: { properties: { path: '/some/path' } } } });
+        expect(resolveDefaultStore(ctx, 'mystore')).toBe('mystore');
+    });
+
+    it('should return explicit store even when a local store exists', () => {
+        const ctx = makeCtx({
+            cwd: '/home/user/myproject',
+            stores: {
+                local: { properties: { path: '/home/user/myproject/.cortex' } },
+            },
+        });
+        expect(resolveDefaultStore(ctx, 'explicit')).toBe('explicit');
+    });
+
+    it('should auto-detect local store whose path matches <cwd>/.cortex', () => {
+        const ctx = makeCtx({
+            cwd: '/home/user/myproject',
+            stores: {
+                global: { properties: { path: '/home/user/.config/cortex/memory' } },
+                myproject: { properties: { path: '/home/user/myproject/.cortex' } },
+            },
+        });
+        expect(resolveDefaultStore(ctx, undefined)).toBe('myproject');
+    });
+
+    it('should auto-detect local store whose path matches <cwd>/.cortex/memory', () => {
+        const ctx = makeCtx({
+            cwd: '/home/user/myproject',
+            stores: {
+                global: { properties: { path: '/home/user/.config/cortex/memory' } },
+                myproject: { properties: { path: '/home/user/myproject/.cortex/memory' } },
+            },
+        });
+        expect(resolveDefaultStore(ctx, undefined)).toBe('myproject');
+    });
+
+    it('should not match a store whose path only starts with cwd (not an exact .cortex path)', () => {
+        // e.g. cwd is /home/user/proj and a store has /home/user/proj-other/.cortex
+        const ctx = makeCtx({
+            cwd: '/home/user/proj',
+            stores: {
+                other: { properties: { path: '/home/user/proj-other/.cortex' } },
+                global: { properties: { path: '/home/user/.config/cortex/memory' } },
+            },
+            defaultStore: 'global',
+        });
+        expect(resolveDefaultStore(ctx, undefined)).toBe('global');
+    });
+
+    it('should fall back to settings.defaultStore when no local store matches', () => {
+        const ctx = makeCtx({
+            cwd: '/home/user/myproject',
+            stores: {
+                custom: { properties: { path: '/data/custom' } },
+            },
+            defaultStore: 'custom',
+        });
+        expect(resolveDefaultStore(ctx, undefined)).toBe('custom');
+    });
+
+    it('should fall back to "global" when no local store and no defaultStore', () => {
+        const ctx = makeCtx({
+            cwd: '/home/user/myproject',
+            stores: {
+                other: { properties: { path: '/data/other' } },
+            },
+        });
+        expect(resolveDefaultStore(ctx, undefined)).toBe('global');
+    });
+
+    it('should fall back to "global" when stores is empty', () => {
+        const ctx = makeCtx({ cwd: '/home/user/myproject', stores: {} });
+        expect(resolveDefaultStore(ctx, undefined)).toBe('global');
+    });
+
+    it('should handle stores with missing properties gracefully', () => {
+        const ctx = makeCtx({
+            cwd: '/home/user/myproject',
+            stores: {
+                broken: {} as { properties?: Record<string, unknown> },
+            },
+        });
+        expect(resolveDefaultStore(ctx, undefined)).toBe('global');
+    });
+
+    it('should use process.cwd() when ctx.cwd is not set', () => {
+        // Build a ctx with no cwd — store path matches process.cwd()
+        const cwd = process.cwd();
+        const ctx = {
+            stores: {
+                local: { properties: { path: `${cwd}/.cortex` } },
+            } as unknown as CortexContext['stores'],
+            settings: {},
+            cortex: {} as CortexContext['cortex'],
+            config: {} as CortexContext['config'],
+            now: () => new Date(),
+            stdin: process.stdin,
+            stdout: process.stdout,
+            // cwd intentionally omitted
+        } as CortexContext;
+        expect(resolveDefaultStore(ctx, undefined)).toBe('local');
+    });
+});

package/src/utils/resolve-default-store.ts

@@ -0,0 +1,74 @@
+/**
+ * Utility for resolving which store to target when no `--store` flag is given.
+ *
+ * Resolution order (first match wins):
+ * 1. Explicit store name provided by the caller (from `--store` flag)
+ * 2. Local store – a registered store whose path starts with `<cwd>/.cortex`
+ * 3. `settings.defaultStore` from the Cortex config file
+ * 4. Hard-coded fallback: `"global"`
+ *
+ * @module cli/utils/resolve-default-store
+ *
+ * @example
+ * ```typescript
+ * // In a command handler:
+ * const storeName = resolveDefaultStore(ctx, parentOpts?.store);
+ * const storeResult = ctx.cortex.getStore(storeName);
+ * ```
+ */
+
+import { join } from 'node:path';
+import type { CortexContext } from '@yeseh/cortex-core';
+
+/**
+ * Resolves the effective store name for a command invocation.
+ *
+ * When a user runs a command without `--store` in a project directory where
+ * they have run `cortex store init`, the local store registered for that
+ * directory is automatically selected so they don't have to type `--store`
+ * on every command.
+ *
+ * @param ctx - The current Cortex context (provides `stores`, `settings`, `cwd`)
+ * @param explicit - Store name from the `--store` CLI flag (may be undefined)
+ * @returns The resolved store name to use
+ *
+ * @example
+ * ```typescript
+ * // No --store flag, inside /home/user/my-project with a .cortex store:
+ * resolveDefaultStore(ctx, undefined);
+ * // → "my-project"  (the store registered at /home/user/my-project/.cortex)
+ *
+ * // Explicit flag always wins:
+ * resolveDefaultStore(ctx, "global");
+ * // → "global"
+ * ```
+ */
+export function resolveDefaultStore(ctx: CortexContext, explicit: string | undefined): string {
+    // 1. Explicit --store flag wins
+    if (explicit) return explicit;
+
+    const cwd = ctx.cwd ?? process.cwd();
+    const stores = ctx.stores ?? {};
+
+    // 2. Local store – registered store whose path is the `.cortex` dir in cwd
+    //    Both `.cortex` and `.cortex/memory` are accepted to handle both
+    //    naming conventions in use across the project.
+    const localPaths = [
+        join(cwd, '.cortex'), join(cwd, '.cortex', 'memory'),
+    ];
+    for (const [
+        name, store,
+    ] of Object.entries(stores)) {
+        const storePath = store.properties?.path as string | undefined;
+        if (storePath && localPaths.includes(storePath)) {
+            return name;
+        }
+    }
+
+    // 3. settings.defaultStore from config
+    const defaultStore = ctx.settings?.defaultStore;
+    if (defaultStore) return defaultStore;
+
+    // 4. Hard-coded fallback
+    return 'global';
+}

package/dist/category/commands/create.d.ts

@@ -1,44 +0,0 @@
-/**
- * Category create command.
- *
- * Creates a category at the specified path, including any missing ancestors.
- *
- * @example
- * ```bash
- * # Create a category in default store
- * cortex category create standards/typescript
- *
- * # Create a category in a specific store
- * cortex category --store my-store create standards/typescript
- *
- * # Serialize output as JSON
- * cortex category create standards --format json
- * ```
- */
-import { Command } from '@commander-js/extra-typings';
-import { type CortexContext } from '@yeseh/cortex-core';
-/** Options parsed by Commander for the create command */
-export interface CreateCommandOptions {
-    description?: string;
-    format?: string;
-}
-/**
- * Handler for the category create command.
- * Exported for direct testing without Commander parsing.
- *
- * @param ctx - CLI execution context
- * @param storeName - Optional store name from parent command
- * @param path - Category path (e.g., "standards/typescript")
- * @param options - Command options from Commander
- */
-export declare function handleCreate(ctx: CortexContext, storeName: string | undefined, path: string, options?: CreateCommandOptions): Promise<void>;
-/**
- * The `category create` subcommand.
- *
- * Creates a category and any missing ancestors.
- */
-export declare const createCommand: Command<[string], {
-    description?: string | undefined;
-    format?: string | undefined;
-}, {}>;
-//# sourceMappingURL=create.d.ts.map

package/dist/category/commands/create.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/category/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxD,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAC9B,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAyB,GACnC,OAAO,CAAC,IAAI,CAAC,CAuCf;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;MAapB,CAAC"}

package/dist/category/commands/create.spec.d.ts

@@ -1,7 +0,0 @@
-/**
- * Unit tests for the handleCreate command handler.
- *
- * @module cli/category/commands/create.spec
- */
-export {};
-//# sourceMappingURL=create.spec.d.ts.map

package/dist/category/commands/create.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create.spec.d.ts","sourceRoot":"","sources":["../../../src/category/commands/create.spec.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/category/index.d.ts

@@ -1,19 +0,0 @@
-/**
- * Category command group for the CLI.
- *
- * This module defines the `category` command group, which provides operations
- * for managing categories in the Cortex memory system. The `--store` option
- * is defined at the group level and inherited by all subcommands.
- */
-import { Command } from '@commander-js/extra-typings';
-/**
- * The `category` command group.
- *
- * Provides category management operations. The `--store` option allows
- * targeting a specific named store instead of the default store.
- * This option is inherited by all subcommands.
- */
-export declare const categoryCommand: Command<[], {
-    store?: string | undefined;
-}, {}>;
-//# sourceMappingURL=index.d.ts.map

package/dist/category/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/category/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAItD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;MAEmC,CAAC"}

package/dist/commands/init.d.ts

@@ -1,58 +0,0 @@
-/**
- * Init command for initializing the global cortex configuration store.
- *
- * Creates the global config store at ~/.config/cortex/ with:
- * - config.yaml: Global configuration with default settings
- * - stores.yaml: Store registry with a 'default' store pointing to the memory directory
- * - memory/: Default store with 'global' and 'projects' categories
- *
- * @example
- * ```bash
- * # Initialize global cortex configuration
- * cortex init
- *
- * # Reinitialize even if already initialized
- * cortex init --force
- * ```
- */
-import { Command } from '@commander-js/extra-typings';
-import { type CortexContext } from '@yeseh/cortex-core';
-/**
- * Options for the init command.
- */
-export interface InitCommandOptions {
-    /** Reinitialize even if already initialized */
-    force?: boolean;
-    /** Output format (yaml, json, toon) */
-    format?: string;
-}
-/**
- * The `init` command for initializing the global cortex configuration.
- *
- * Creates the global config store at ~/.config/cortex/ with default settings
- * and store registry.
- *
- * @example
- * ```bash
- * cortex init              # Initialize global config
- * cortex init --force      # Reinitialize even if exists
- * ```
- */
-export declare const initCommand: Command<[], {
-    force?: true | undefined;
-    format: string;
-}, {}>;
-/**
- * Handles the init command execution.
- *
- * This function:
- * 1. Initializes the global cortex config store
- * 2. Creates default categories
- * 3. Outputs the result
- *
- * @param options - Command options (force, format)
- * @throws {InvalidArgumentError} When arguments are invalid
- * @throws {CommanderError} When initialization fails
- */
-export declare function handleInit(ctx: CortexContext, options?: InitCommandOptions): Promise<void>;
-//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAStD,OAAO,EAIH,KAAK,aAAa,EAErB,MAAM,oBAAoB,CAAC;AAG5B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW;;;MAalB,CAAC;AAEP;;;;;;;;;;;GAWG;AAIH,wBAAsB,UAAU,CAC5B,GAAG,EAAE,aAAa,EAClB,OAAO,GAAE,kBAAuB,GACjC,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/commands/init.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=init.spec.d.ts.map

package/dist/commands/init.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"init.spec.d.ts","sourceRoot":"","sources":["../../src/commands/init.spec.ts"],"names":[],"mappings":""}

package/dist/context.d.ts

@@ -1,18 +0,0 @@
-/**
- * Store resolution utilities for CLI commands.
- *
- * This module provides functions to resolve the store context (root directory)
- * based on command-line options, current working directory, and the global
- * store configuration.
- */
-/**
- * Default path to the global store.
- */
-export declare const getDefaultGlobalStorePath: () => string;
-/**
- * Default path to the store configuration file.
- * Respects CORTEX_CONFIG (config file path) and CORTEX_CONFIG_DIR (config directory)
- * environment variables when set.
- */
-export declare const getDefaultConfigPath: () => string;
-//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;GAEG;AACH,eAAO,MAAM,yBAAyB,QAAO,MACQ,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAO,MAWvC,CAAC"}

package/dist/context.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=context.spec.d.ts.map

package/dist/context.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context.spec.d.ts","sourceRoot":"","sources":["../src/context.spec.ts"],"names":[],"mappings":""}

package/dist/create-cli-command.d.ts

@@ -1,23 +0,0 @@
-import { getDefaultSettings, type ConfigValidationError, type CortexContext, type Result } from '@yeseh/cortex-core';
-import { FilesystemStorageAdapter, FilesystemConfigAdapter } from '@yeseh/cortex-storage-fs';
-export declare const validateStorePath: (storePath: string, storeName: string) => Result<void, ConfigValidationError>;
-export interface ConfigLoadOptions {
-    cwd?: string;
-    globalConfigPath?: string;
-    localConfigPath?: string;
-}
-export interface CliContextOptions {
-    configDir?: string;
-    configCwd?: string;
-}
-export interface CliConfigContext {
-    configAdapter: FilesystemConfigAdapter;
-    stores: Record<string, any>;
-    settings: ReturnType<typeof getDefaultSettings>;
-    effectiveCwd: string;
-}
-export declare const createCliConfigAdapter: (configPath: string) => FilesystemConfigAdapter;
-export declare const createCliAdapterFactory: (configAdapter: FilesystemConfigAdapter) => (storeName: string) => FilesystemStorageAdapter;
-export declare const createCliConfigContext: (options?: CliContextOptions) => Promise<Result<CliConfigContext, any>>;
-export declare const createCliCommandContext: (configDir?: string) => Promise<Result<CortexContext, any>>;
-//# sourceMappingURL=create-cli-command.d.ts.map

package/dist/create-cli-command.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-cli-command.d.ts","sourceRoot":"","sources":["../src/create-cli-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,kBAAkB,EAElB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,MAAM,EACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAY7F,eAAO,MAAM,iBAAiB,GAC1B,WAAW,MAAM,EACjB,WAAW,MAAM,KAClB,MAAM,CAAC,IAAI,EAAE,qBAAqB,CAWpC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC7B,aAAa,EAAE,uBAAuB,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,QAAQ,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;IAChD,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,sBAAsB,GAAI,YAAY,MAAM,KAAG,uBAE3D,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,eAAe,uBAAuB,MAClE,WAAW,MAAM,6BAkB5B,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAC/B,UAAS,iBAAsB,KAChC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,GAAG,CAAC,CA0CvC,CAAC;AAKF,eAAO,MAAM,uBAAuB,GAChC,YAAY,MAAM,KACnB,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAoCpC,CAAC"}

package/dist/create-cli-command.spec.d.ts

@@ -1,10 +0,0 @@
-/**
- * Unit tests for create-cli-command.ts — validateStorePath.
- *
- * Verifies that absolute paths pass validation and relative paths
- * produce a typed INVALID_STORE_PATH error result.
- *
- * @module cli/create-cli-command.spec
- */
-export {};
-//# sourceMappingURL=create-cli-command.spec.d.ts.map

package/dist/create-cli-command.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-cli-command.spec.d.ts","sourceRoot":"","sources":["../src/create-cli-command.spec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/errors.d.ts

@@ -1,57 +0,0 @@
-/**
- * Error mapping utilities for CLI commands.
- *
- * This module provides utilities to map core Result errors to Commander.js
- * exceptions. Commander.js uses specific exception types to control error
- * output and exit codes:
- *
- * - `InvalidArgumentError` - For user input validation errors (shows usage help)
- * - `CommanderError` - For other errors (shows error message only)
- *
- * @example
- * ```ts
- * const result = await runAddCommand(options);
- * if (!result.ok()) {
- *     mapCoreError(result.error);
- * }
- * ```
- */
-/**
- * Represents a core error with a code and message.
- *
- * This interface matches the error shape used throughout the CLI commands,
- * allowing consistent error handling across all command implementations.
- */
-export interface CoreError {
-    code: string;
-    message: string;
-    cause?: unknown;
-}
-/**
- * Maps a core error to a Commander.js exception and throws it.
- *
- * This function examines the error code to determine the appropriate
- * Commander.js exception type:
- *
- * - **Argument errors** (`InvalidArgumentError`): For errors caused by invalid
- *   user input. Commander.js displays usage help for these errors.
- *
- * - **Other errors** (`CommanderError`): For system errors, missing resources,
- *   or internal failures. Commander.js displays only the error message.
- *
- * @param error - The core error to map
- * @throws {InvalidArgumentError} When the error code indicates invalid input
- * @throws {CommanderError} For all other error codes
- *
- * @example
- * ```ts
- * // In a command action handler
- * const result = await runShowCommand(options);
- * if (!result.ok()) {
- *     mapCoreError(result.error);
- *     // Never reaches here - mapCoreError always throws
- * }
- * ```
- */
-export declare function throwCliError(error: CoreError): never;
-//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAyCD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,CAMrD"}

package/dist/errors.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=errors.spec.d.ts.map

package/dist/errors.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.spec.d.ts","sourceRoot":"","sources":["../src/errors.spec.ts"],"names":[],"mappings":""}

package/dist/input.d.ts

@@ -1,42 +0,0 @@
-/**
- * CLI helpers for resolving memory content input.
- */
-import { type Result } from '@yeseh/cortex-core';
-export type MemoryContentSource = 'flag' | 'file' | 'stdin' | 'none';
-export type InputSource = {
-    content?: string;
-    filePath?: string;
-    /**
-     * stdin stream to read from.
-     *
-     * NOTE: Passing a stream does not necessarily mean stdin is intended as an input
-     * source. Use `stdinRequested: true` when a command semantics include reading from
-     * stdin by default (e.g. `memory add`), typically when piping.
-     */
-    stream?: NodeJS.ReadableStream;
-    /**
-     * Explicitly indicates stdin should be considered as an input source.
-     *
-     * This is `false` by default so that inheriting a non-TTY stdin in test harnesses
-     * or subprocess environments does not accidentally count as providing `--stdin`.
-     */
-    stdinRequested?: boolean;
-};
-export interface InputContent {
-    content: string | null;
-    source: MemoryContentSource;
-}
-export type InputErrorCode = 'MULTIPLE_CONTENT_SOURCES' | 'FILE_READ_FAILED' | 'MISSING_CONTENT' | 'INVALID_FILE_PATH';
-export interface InputError {
-    code: InputErrorCode;
-    message: string;
-    path?: string;
-    cause?: unknown;
-}
-type InputResult = Result<InputContent, InputError>;
-type OptionalContentResult = Result<InputContent | null, InputError>;
-export declare const readContentFromFile: (filePath: string | undefined) => Promise<OptionalContentResult>;
-export declare const readContentFromStream: (stream: NodeJS.ReadableStream) => Promise<OptionalContentResult>;
-export declare const resolveInput: (source: InputSource) => Promise<InputResult>;
-export {};
-//# sourceMappingURL=input.d.ts.map

package/dist/input.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAErE,MAAM,MAAM,WAAW,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,mBAAmB,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc,GACpB,0BAA0B,GAC1B,kBAAkB,GAClB,iBAAiB,GACjB,mBAAmB,CAAC;AAE1B,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,KAAK,WAAW,GAAG,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;AACpD,KAAK,qBAAqB,GAAG,MAAM,CAAC,YAAY,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC;AAErE,eAAO,MAAM,mBAAmB,GAC5B,UAAU,MAAM,GAAG,SAAS,KAC7B,OAAO,CAAC,qBAAqB,CAsB/B,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAC9B,QAAQ,MAAM,CAAC,cAAc,KAC9B,OAAO,CAAC,qBAAqB,CAgB/B,CAAC;AAKF,eAAO,MAAM,YAAY,GAAU,QAAQ,WAAW,KAAG,OAAO,CAAC,WAAW,CA6C3E,CAAC"}

package/dist/input.spec.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=input.spec.d.ts.map

package/dist/input.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"input.spec.d.ts","sourceRoot":"","sources":["../src/input.spec.ts"],"names":[],"mappings":""}

package/dist/memory/commands/add.d.ts

@@ -1,62 +0,0 @@
-/**
- * Memory add command implementation using Commander.js.
- *
- * Creates a new memory at the specified path with content from inline text,
- * a file, or stdin.
- *
- * @example
- * ```bash
- * # Add memory with inline content
- * cortex memory add project/tech-stack --content "Using TypeScript and Node.js"
- *
- * # Add memory from a file
- * cortex memory add project/notes --file ./notes.md
- *
- * # Add memory from stdin
- * echo "My notes" | cortex memory add project/notes
- *
- * # Add memory with tags and expiration
- * cortex memory add project/temp --content "Temporary note" \
- *   --tags "temp,cleanup" --expires-at "2025-12-31T00:00:00Z"
- * ```
- */
-import { Command } from '@commander-js/extra-typings';
-import { type CortexContext } from '@yeseh/cortex-core';
-/** Options parsed by Commander for the add command */
-export interface AddCommandOptions {
-    content?: string;
-    file?: string;
-    tags?: string[];
-    expiresAt?: string;
-    citations?: string[];
-    format?: string;
-}
-/**
- * Handler for the memory add command.
- * Exported for direct testing without Commander parsing.
- *
- * @param path - Memory path (e.g., "project/tech-stack")
- * @param options - Command options from Commander
- * @param storeName - Optional store name from parent command
- * @param deps - Injectable dependencies for testing
- */
-export declare function handleAdd(ctx: CortexContext, storeName: string | undefined, path: string, options: AddCommandOptions): Promise<void>;
-/**
- * The `memory add` subcommand.
- *
- * Creates a new memory at the specified path. Content can be provided via:
- * - `--content` flag for inline text
- * - `--file` flag to read from a file
- * - stdin when piped
- *
- * The `--store` option is inherited from the parent `memory` command.
- */
-export declare const addCommand: Command<[string], {
-    content?: string | undefined;
-    file?: string | undefined;
-    tags?: string[] | undefined;
-    expiresAt?: string | undefined;
-    citation?: string[] | undefined;
-    format?: string | undefined;
-}, {}>;
-//# sourceMappingURL=add.d.ts.map

package/dist/memory/commands/add.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/add.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAEtD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxD,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AACD;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC3B,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAyEf;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU;;;;;;;MAiBjB,CAAC"}

package/dist/memory/commands/add.spec.d.ts

@@ -1,7 +0,0 @@
-/**
- * Unit tests for the handleAdd command handler.
- *
- * @module cli/memory/commands/add.spec
- */
-export {};
-//# sourceMappingURL=add.spec.d.ts.map

package/dist/memory/commands/add.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"add.spec.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/add.spec.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/memory/commands/definitions.spec.d.ts

@@ -1,10 +0,0 @@
-/**
- * Unit tests for memory command definitions.
- *
- * Verifies that memory subcommands expose the expected names,
- * arguments, and options.
- *
- * @module cli/memory/commands/definitions.spec
- */
-export {};
-//# sourceMappingURL=definitions.spec.d.ts.map

package/dist/memory/commands/definitions.spec.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"definitions.spec.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/definitions.spec.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}