@yeseh/cortex-cli 0.6.0

package/README.md

@@ -0,0 +1,144 @@
+# @yeseh/cortex-cli
+
+Command-line interface for the Cortex memory system. Manage memories, categories, and stores from your terminal.
+
+## Installation
+
+```bash
+bun add -g @yeseh/cortex-cli
+```
+
+Or run directly with bun:
+
+```bash
+bunx @yeseh/cortex-cli memory list
+```
+
+## Quick Start
+
+```bash
+# Initialize global configuration
+cortex init
+
+# Add a memory
+cortex memory add project/notes/architecture -c "Use event sourcing for state management"
+
+# List memories in a category
+cortex memory list project/notes
+
+# Show a specific memory
+cortex memory show project/notes/architecture
+
+# Update a memory
+cortex memory update project/notes/architecture -c "Updated content here"
+
+# Remove a memory
+cortex memory remove project/notes/architecture
+```
+
+## Commands
+
+### Global
+
+| Command | Description |
+|---------|-------------|
+| `cortex init` | Initialize global Cortex configuration |
+
+### Memory Commands
+
+| Command | Description |
+|---------|-------------|
+| `cortex memory add <path>` | Create a new memory |
+| `cortex memory show <path>` | Display a memory |
+| `cortex memory update <path>` | Update an existing memory |
+| `cortex memory remove <path>` | Delete a memory |
+| `cortex memory move <from> <to>` | Move or rename a memory |
+| `cortex memory list [category]` | List memories in a category |
+
+### Store Commands
+
+| Command | Description |
+|---------|-------------|
+| `cortex store list` | List all registered stores |
+| `cortex store add <name> <path>` | Register an existing store |
+| `cortex store remove <name>` | Unregister a store |
+| `cortex store init [path]` | Initialize a new store |
+| `cortex store prune` | Remove expired memories |
+| `cortex store reindex` | Rebuild the store index |
+
+## Common Options
+
+Most commands support these flags:
+
+| Flag | Short | Description |
+|------|-------|-------------|
+| `--store` | `-s` | Use a specific named store |
+| `--format` | `-o` | Output format (yaml, json, toon) |
+| `--include-expired` | `-x` | Include expired memories |
+
+## Store Resolution
+
+When you run a command, Cortex resolves which store to use:
+
+1. **Explicit**: `--store <name>` flag specifies a registered store
+2. **Local**: `.cortex/memory` directory in current working directory
+3. **Global**: `~/.config/cortex/memory` (the default store)
+
+This allows project-specific memories when working in a directory with a local `.cortex` folder.
+
+## Examples
+
+### Project-Specific Memory
+
+```bash
+# Initialize a store in your project
+cd my-project
+cortex store init .cortex -n my-project
+
+# Add project memories (uses local store automatically)
+cortex memory add decisions/database -c "PostgreSQL for ACID compliance"
+```
+
+### Organizing with Categories
+
+```bash
+# Create a hierarchy
+cortex memory add project/backend/api/auth -c "JWT with refresh tokens"
+cortex memory add project/backend/api/rate-limiting -c "100 req/min per user"
+
+# List by category
+cortex memory list project/backend/api
+```
+
+### Temporary Memories with Expiration
+
+```bash
+# Create a memory that expires
+cortex memory add temp/meeting-notes -c "Discuss API changes" -e "2024-12-15"
+
+# Clean up expired memories
+cortex store prune
+```
+
+### Output Formats
+
+```bash
+# YAML output (default)
+cortex memory list project
+
+# JSON output
+cortex memory list project -o json
+
+# TOON output (compact)
+cortex memory list project -o toon
+```
+
+## Related Packages
+
+- `@yeseh/cortex-core` - Core types and domain logic
+- `@yeseh/cortex-storage-fs` - Filesystem storage adapter
+- `@yeseh/cortex-server` - MCP server for AI agent integration
+
+## License
+
+MIT

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":""}