@yeseh/cortex-cli 0.6.4 → 0.6.6

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

@@ -0,0 +1,44 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,7 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,19 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,58 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

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

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

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

package/dist/context.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

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

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

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

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

@@ -0,0 +1,23 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,10 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,57 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

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

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

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

package/dist/input.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

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

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

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

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

@@ -0,0 +1,62 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,7 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,10 @@
+/**
+ * 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

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

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

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

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

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

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

@@ -0,0 +1,119 @@
+/**
+ * Memory list command for browsing memories with optional filtering.
+ *
+ * Lists all memories in a category, or all memories across all categories
+ * if no category is specified. Expired memories are excluded by default
+ * unless the `--include-expired` flag is provided.
+ *
+ * When no category is specified, the command dynamically discovers all
+ * root categories from the store's index rather than using a hardcoded list.
+ *
+ * @example
+ * ```bash
+ * # List all memories
+ * cortex memory list
+ *
+ * # List memories in a specific category
+ * cortex memory list project/cortex
+ *
+ * # Include expired memories
+ * cortex memory list --include-expired
+ *
+ * # Output in JSON format
+ * cortex memory list --format json
+ *
+ * # Use a specific store (either placement works)
+ * cortex memory list -s my-store
+ * cortex memory -s my-store list
+ * ```
+ */
+import { Command } from '@commander-js/extra-typings';
+import { type CortexContext } from '@yeseh/cortex-core';
+/**
+ * Options for the list command.
+ */
+export interface ListCommandOptions {
+    /** Include expired memories in the output */
+    includeExpired?: boolean;
+    /** Output format (yaml, json, toon) */
+    format?: string;
+    /** Store name (can be specified on subcommand or parent) */
+    store?: string;
+}
+/**
+ * Dependencies for the list command handler.
+ * Allows injection for testing.
+ */
+export interface ListHandlerDeps {
+    /** Output stream for writing results (defaults to process.stdout) */
+    stdout?: NodeJS.WritableStream;
+    /** Current time for expiration checks */
+    now?: Date;
+}
+/**
+ * Entry representing a memory in the list output.
+ */
+export interface ListMemoryEntry {
+    path: string;
+    tokenEstimate: number;
+    summary?: string;
+    expiresAt?: Date;
+    isExpired: boolean;
+}
+/**
+ * Entry representing a subcategory in the list output.
+ */
+export interface ListSubcategoryEntry {
+    path: string;
+    memoryCount: number;
+    description?: string;
+}
+/**
+ * Result of the list command containing memories and subcategories.
+ */
+export interface ListResult {
+    memories: ListMemoryEntry[];
+    subcategories: ListSubcategoryEntry[];
+}
+/**
+ * Handles the list command execution.
+ *
+ * This function:
+ * 1. Resolves the store context
+ * 2. Loads category index (or all categories if none specified)
+ * 3. Collects memories and subcategories, filtering expired if needed
+ * 4. Formats and outputs the result
+ *
+ * @param category - Optional category path to list (lists all if omitted)
+ * @param options - Command options (includeExpired, format)
+ * @param storeName - Optional store name from parent command
+ * @param deps - Optional dependencies for testing
+ * @throws {InvalidArgumentError} When arguments are invalid
+ * @throws {CommanderError} When read or parse fails
+ */
+export declare function handleList(ctx: CortexContext, storeName: string | undefined, category: string | undefined, options: ListCommandOptions, deps?: ListHandlerDeps): Promise<void>;
+/**
+ * The `list` subcommand for browsing memories.
+ *
+ * Lists memories in a category, or all memories across all root categories
+ * if no category is specified. By default, expired memories are excluded.
+ *
+ * The `--store` option can be specified either on this command or on the
+ * parent `memory` command for flexibility.
+ *
+ * @example
+ * ```bash
+ * cortex memory list
+ * cortex memory list project/cortex
+ * cortex memory list --include-expired
+ * cortex memory list --format json
+ * cortex memory list -s my-store
+ * cortex memory -s my-store list
+ * ```
+ */
+export declare const listCommand: Command<[string | undefined], {
+    store?: string | undefined;
+    includeExpired?: true | undefined;
+    format: string;
+}, {}>;
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAItD,OAAO,EAAa,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,yCAAyC;IACzC,GAAG,CAAC,EAAE,IAAI,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,aAAa,EAAE,oBAAoB,EAAE,CAAC;CACzC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAC5B,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,kBAAkB,EAC3B,IAAI,GAAE,eAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAsHf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW;;;;MAgBlB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * Memory move command implementation using Commander.js.
+ *
+ * Moves a memory from one path to another within the same store.
+ *
+ * @example
+ * ```bash
+ * # Move a memory to a new location
+ * cortex memory move project/old-name project/new-name
+ *
+ * # Move with explicit store
+ * cortex memory --store my-store move project/old project/new
+ * ```\n */
+import { Command } from '@commander-js/extra-typings';
+import { type CortexContext } from '@yeseh/cortex-core';
+/** Options for the move command. */
+export interface MoveCommandOptions {
+    /** Output format (yaml, json, toon) */
+    format?: string;
+}
+/**
+ * Handler for the memory move command.
+ * Exported for direct testing without Commander parsing.
+ *
+ * @param ctx - CLI context containing Cortex client and streams
+ * @param storeName - Optional store name from parent command
+ * @param from - Source memory path
+ * @param to - Destination memory path
+ */
+export declare function handleMove(ctx: CortexContext, storeName: string | undefined, from: string, to: string, options?: MoveCommandOptions): Promise<void>;
+/**
+ * The `memory move` subcommand.
+ *
+ * Moves a memory from one path to another within the store.
+ * Both paths must be valid memory slug paths.
+ *
+ * The `--store` option is inherited from the parent `memory` command.
+ */
+export declare const moveCommand: Command<[string, string], {
+    format?: string | undefined;
+}, {}>;
+//# sourceMappingURL=move.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"move.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/move.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;WAYW;AAEX,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAEtD,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIpE,oCAAoC;AACpC,MAAM,WAAW,kBAAkB;IAC/B,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC5B,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,kBAAuB,GACjC,OAAO,CAAC,IAAI,CAAC,CAkDf;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;MAalB,CAAC"}

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

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

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

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