@yeseh/cortex-cli 0.6.4 → 0.6.6

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

@@ -0,0 +1,41 @@
+/**
+ * Memory remove command implementation using Commander.js.
+ *
+ * Deletes an existing memory at the specified path.
+ *
+ * @example
+ * ```bash
+ * # Remove a memory
+ * cortex memory remove project/tech-stack
+ *
+ * # Remove memory from a specific store
+ * cortex memory --store work remove project/notes
+ * ```
+ */
+import { Command } from '@commander-js/extra-typings';
+import { type CortexContext } from '@yeseh/cortex-core';
+/** Options for the remove command. */
+export interface RemoveCommandOptions {
+    /** Output format (yaml, json, toon) */
+    format?: string;
+}
+/**
+ * Handler for the memory remove 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 path - Memory path to remove (e.g., "project/tech-stack")
+ */
+export declare function handleRemove(ctx: CortexContext, storeName: string | undefined, path: string, options?: RemoveCommandOptions): Promise<void>;
+/**
+ * The `memory remove` subcommand.
+ *
+ * Deletes an existing memory at the specified path.
+ *
+ * The `--store` option is inherited from the parent `memory` command.
+ */
+export declare const removeCommand: Command<[string], {
+    format?: string | undefined;
+}, {}>;
+//# sourceMappingURL=remove.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/remove.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAEtD,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIpE,sCAAsC;AACtC,MAAM,WAAW,oBAAoB;IACjC,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;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,CA0Cf;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;MAYpB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,81 @@
+/**
+ * Memory show command for displaying a memory's content and metadata.
+ *
+ * This command reads a memory from the store and displays it in the
+ * specified format. Expired memories are excluded by default unless
+ * the `--include-expired` flag is provided.
+ *
+ * @example
+ * ```bash
+ * # Show a memory in YAML format (default)
+ * cortex memory show project/notes
+ *
+ * # Show a memory in JSON format
+ * cortex memory show project/notes --format json
+ *
+ * # Include expired memories
+ * cortex memory show project/notes --include-expired
+ *
+ * # Use a specific store
+ * cortex memory --store my-store show project/notes
+ * ```
+ */
+import { Command } from '@commander-js/extra-typings';
+import { type CortexContext } from '@yeseh/cortex-core';
+import { type StoreClient } from '@yeseh/cortex-core/store';
+/**
+ * Options for the show command.
+ */
+export interface ShowCommandOptions {
+    /** Include expired memories in the output */
+    includeExpired?: boolean;
+    /** Output format (yaml, json, toon) */
+    format?: string;
+}
+/**
+ * Dependencies for the show command handler.
+ * Allows injection for testing.
+ */
+export interface ShowHandlerDeps {
+    /** Output stream for writing results (defaults to process.stdout) */
+    stdout?: NodeJS.WritableStream;
+    /** Pre-resolved store client for testing */
+    store?: StoreClient;
+}
+/**
+ * Handles the show command execution.
+ *
+ * This function:
+ * 1. Resolves the store context
+ * 2. Validates the memory path
+ * 3. Reads the memory file from storage
+ * 4. Parses the memory content and frontmatter
+ * 5. Checks expiration status (unless --include-expired)
+ * 6. Serializes and outputs the result
+ *
+ * @param path - The memory path to show (e.g., "project/notes")
+ * @param options - Command options (includeExpired, format)
+ * @param storeName - Optional store name from parent command
+ * @param deps - Optional dependencies for testing
+ * @throws {InvalidArgumentError} When the path is invalid
+ * @throws {CommanderError} When the memory is not found or read fails
+ */
+export declare function handleShow(ctx: CortexContext, storeName: string | undefined, path: string, options: ShowCommandOptions, deps?: ShowHandlerDeps): Promise<void>;
+/**
+ * The `show` subcommand for displaying a memory.
+ *
+ * Reads a memory from the store and displays its content and metadata
+ * in the specified format. By default, expired memories are excluded.
+ *
+ * @example
+ * ```bash
+ * cortex memory show project/notes
+ * cortex memory show project/notes --format json
+ * cortex memory show project/notes --include-expired
+ * ```
+ */
+export declare const showCommand: Command<[string], {
+    includeExpired?: true | undefined;
+    format: string;
+}, {}>;
+//# sourceMappingURL=show.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/show.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAGtD,OAAO,EAAgC,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAI5D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,4CAA4C;IAC5C,KAAK,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,UAAU,CAC5B,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,kBAAkB,EAC3B,IAAI,GAAE,eAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Df;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW;;;MAalB,CAAC"}

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

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

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

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

package/dist/memory/commands/test-helpers.spec.d.ts

@@ -0,0 +1,19 @@
+import { PassThrough } from 'node:stream';
+import { Memory, type AdapterFactory, type ConfigStores, type CortexContext, type CortexSettings, type MemoryMetadata, type StorageAdapter } from '@yeseh/cortex-core';
+export declare const createMockMemoryCommandAdapter: (overrides?: Record<string, unknown>) => StorageAdapter;
+export declare const createMemoryCommandContext: (options: {
+    adapter: StorageAdapter;
+    storePath: string;
+    stdout?: PassThrough;
+    stdin?: PassThrough;
+    stores?: ConfigStores;
+    settings?: CortexSettings;
+    now?: () => Date;
+    adapterFactory?: AdapterFactory;
+}) => CortexContext;
+export declare const createCaptureStream: () => {
+    stream: PassThrough;
+    getOutput: () => string;
+};
+export declare const createMemoryFixture: (path: string, overrides?: Partial<MemoryMetadata>, content?: string) => Memory;
+//# sourceMappingURL=test-helpers.spec.d.ts.map

package/dist/memory/commands/test-helpers.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.spec.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/test-helpers.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAEH,MAAM,EAEN,KAAK,cAAc,EAEnB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,cAAc,EACtB,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,8BAA8B,GACvC,YAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,KACxC,cAwBgC,CAAC;AAEpC,eAAO,MAAM,0BAA0B,GAAI,SAAS;IAChD,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,cAAc,CAAC,EAAE,cAAc,CAAC;CACnC,KAAG,aAsCH,CAAC;AAEF,eAAO,MAAM,mBAAmB,QAAO;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,MAAM,CAAA;CAYpF,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC5B,MAAM,MAAM,EACZ,YAAW,OAAO,CAAC,cAAc,CAAM,EACvC,gBAA0B,KAC3B,MAiBF,CAAC"}

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

@@ -0,0 +1,73 @@
+/**
+ * Memory update command implementation using Commander.js.
+ *
+ * Updates an existing memory at the specified path with new content, tags,
+ * or expiration date.
+ *
+ * @example
+ * ```bash
+ * # Update memory content inline
+ * cortex memory update project/tech-stack --content "Updated stack: TypeScript"
+ *
+ * # Update memory content from a file
+ * cortex memory update project/notes --file ./updated-notes.md
+ *
+ * # Update tags
+ * cortex memory update project/tech-stack --tags "typescript,nodejs,updated"
+ *
+ * # Update expiration date
+ * cortex memory update project/temp --expires-at "2026-12-31T00:00:00Z"
+ *
+ * # Clear expiration date
+ * cortex memory update project/temp --no-expires-at
+ *
+ * # Update from a specific store
+ * cortex memory --store work update project/notes --content "New content"
+ * ```
+ */
+import { Command } from '@commander-js/extra-typings';
+import { type CortexContext } from '@yeseh/cortex-core';
+/** Options parsed by Commander for the update command */
+export interface UpdateCommandOptions {
+    content?: string;
+    file?: string;
+    tags?: string[];
+    /**
+     * Expiration date from Commander.js option parsing.
+     * - `string` — ISO 8601 date provided via `--expires-at <date>`
+     * - `false` — expiration cleared via `--no-expires-at` negation flag
+     * - `undefined` (omitted) — keep the existing value unchanged
+     */
+    expiresAt?: string | false;
+    citation?: string[];
+    format?: string;
+}
+/**
+ * Handler for the memory update 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 path - Memory path to update (e.g., "project/tech-stack")
+ * @param options - Command options from Commander
+ */
+export declare function handleUpdate(ctx: CortexContext, storeName: string | undefined, path: string, options: UpdateCommandOptions): Promise<void>;
+/**
+ * The `memory update` subcommand.
+ *
+ * Updates an existing memory at the specified path. Can update:
+ * - Content via `--content` flag for inline text or `--file` to read from a file
+ * - Tags via `--tags` flag (replaces existing tags)
+ * - Expiration via `--expires-at` or `--no-expires-at`
+ *
+ * The `--store` option is inherited from the parent `memory` command.
+ */
+export declare const updateCommand: Command<[string], {
+    content?: string | undefined;
+    file?: string | undefined;
+    tags?: string[] | undefined;
+    expiresAt?: string | false | undefined;
+    citation?: string[] | undefined;
+    format?: string | undefined;
+}, {}>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/memory/commands/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAEtD,OAAO,EAAc,KAAK,aAAa,EAA0B,MAAM,oBAAoB,CAAC;AAM5F,yDAAyD;AACzD,MAAM,WAAW,oBAAoB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AA2ED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAC9B,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA2Df;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa;;;;;;;MAkBpB,CAAC"}

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

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

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

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

package/dist/memory/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Memory command group for the CLI.
+ *
+ * This module defines the `memory` command group, which provides operations
+ * for managing memories in the Cortex memory system. The `--store` option
+ * is defined at the group level and inherited by all subcommands.
+ *
+ * @example
+ * ```bash
+ * # Use default store
+ * cortex memory add project/notes --content "Hello"
+ *
+ * # Use specific store
+ * cortex memory --store my-store add project/notes --content "Hello"
+ * cortex memory -s my-store list
+ * ```
+ */
+import { Command } from '@commander-js/extra-typings';
+/**
+ * The `memory` command group.
+ *
+ * Provides memory 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 memoryCommand: Command<[], {
+    store?: string | undefined;
+}, {}>;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/memory/index.spec.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Unit tests for memory command group wiring.
+ *
+ * Verifies that the `memory` command group is correctly configured with
+ * the expected name, description, options, and subcommands.
+ *
+ * @module cli/memory/index.spec
+ */
+export {};
+//# sourceMappingURL=index.spec.d.ts.map

package/dist/memory/index.spec.d.ts.map

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

package/dist/memory/parsing.d.ts

@@ -0,0 +1,3 @@
+export declare const parseTags: (raw?: string[]) => string[];
+export declare const parseExpiresAt: (raw?: string) => Date | undefined;
+//# sourceMappingURL=parsing.d.ts.map

package/dist/memory/parsing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.d.ts","sourceRoot":"","sources":["../../src/memory/parsing.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,KAAG,MAAM,EAMrC,CAAC;AAEb,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,IAAI,GAAG,SAWpD,CAAC"}

package/dist/memory/parsing.spec.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for memory/parsing.ts
+ *
+ * @module cli/memory/parsing.spec
+ */
+export {};
+//# sourceMappingURL=parsing.spec.d.ts.map

package/dist/memory/parsing.spec.d.ts.map

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

package/dist/output.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Output format types and serialization helpers.
+ *
+ * This module provides type definitions for CLI output payloads and a thin
+ * wrapper around the core serialize function. Validation is expected to happen
+ * at object construction time, not during serialization.
+ */
+import { type Result } from '@yeseh/cortex-core';
+import { type OutputFormat } from '@yeseh/cortex-core';
+export type { OutputFormat };
+export interface OutputMemoryMetadata {
+    createdAt: Date;
+    updatedAt?: Date;
+    tags: string[];
+    source?: string;
+    tokenEstimate?: number;
+    expiresAt?: Date;
+}
+export interface OutputMemory {
+    path: string;
+    metadata: OutputMemoryMetadata;
+    content: string;
+}
+export interface OutputCategoryMemory {
+    path: string;
+    tokenEstimate?: number;
+    summary?: string;
+}
+export interface OutputSubcategory {
+    path: string;
+    memoryCount: number;
+}
+export interface OutputCategory {
+    path: string;
+    memories: OutputCategoryMemory[];
+    subcategories: OutputSubcategory[];
+}
+export interface OutputStore {
+    name: string;
+    path: string;
+}
+export interface OutputStoreRegistry {
+    stores: OutputStore[];
+}
+export interface OutputStoreInit {
+    path: string;
+    name: string;
+}
+export interface OutputInit {
+    path: string;
+    categories: string[];
+}
+export type OutputPayload = {
+    kind: 'memory';
+    value: OutputMemory;
+} | {
+    kind: 'category';
+    value: OutputCategory;
+} | {
+    kind: 'store';
+    value: OutputStore;
+} | {
+    kind: 'store-registry';
+    value: OutputStoreRegistry;
+} | {
+    kind: 'store-init';
+    value: OutputStoreInit;
+} | {
+    kind: 'init';
+    value: OutputInit;
+};
+export interface OutputSerializeError {
+    code: 'INVALID_FORMAT' | 'SERIALIZE_FAILED';
+    message: string;
+}
+/**
+ * Serialize an output payload to the specified format.
+ *
+ * This is a thin wrapper around the core serialize function that extracts
+ * the value from the discriminated union and handles errors.
+ *
+ * @param payload - The output payload to serialize
+ * @param format - The output format ('yaml', 'json', or 'toon')
+ * @returns Result with serialized string or error
+ */
+export declare const serializeOutput: (payload: unknown, format: OutputFormat) => Result<string, OutputSerializeError>;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlE,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,aAAa,EAAE,iBAAiB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,MAAM,aAAa,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,cAAc,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAE1C,MAAM,WAAW,oBAAoB;IACjC,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GACxB,SAAS,OAAO,EAChB,QAAQ,YAAY,KACrB,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAWrC,CAAC"}

package/dist/output.spec.d.ts

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

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

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

package/dist/paths.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Path resolution utilities for CLI commands.
+ *
+ * Provides cross-platform path handling including:
+ * - Home directory (~) expansion
+ * - Absolute path detection (Unix, Windows drive, UNC)
+ * - Relative path resolution
+ */
+/**
+ * Checks if a path is absolute.
+ * Handles Unix paths, Windows drive paths (C:\), and UNC paths (\\server).
+ */
+export declare function isAbsolutePath(inputPath: string): boolean;
+/**
+ * Resolves a user-provided path to an absolute path.
+ *
+ * Handles:
+ * - Home directory expansion (~)
+ * - Absolute paths (returned as-is, normalized)
+ * - Relative paths (resolved against cwd)
+ *
+ * @param inputPath - The path to resolve
+ * @param cwd - Current working directory for relative path resolution
+ * @returns Normalized absolute path
+ */
+export declare function resolveUserPath(inputPath: string, cwd: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAQzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAYtE"}

package/dist/paths.spec.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for CLI path resolution utilities.
+ *
+ * @module cli/paths.spec
+ */
+export {};
+//# sourceMappingURL=paths.spec.d.ts.map

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

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

package/dist/program.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Commander.js program setup for Cortex CLI.
+ *
+ * This module sets up the main Commander program and wires together
+ * all command groups. It serves as the entry point for the CLI.
+ *
+ * @module cli/program
+ */
+import { Command } from '@commander-js/extra-typings';
+/**
+ * The main Commander program instance for Cortex CLI.
+ *
+ * Configured with:
+ * - Name: cortex
+ * - Description: Memory system for AI agents
+ * - Version: 0.1.0
+ *
+ * @example
+ * ```ts
+ * import { program } from './program.ts';
+ * await program.parseAsync(process.argv);
+ * ```
+ */
+declare const program: Command<[], {}, {}>;
+export { program };
+/**
+ * Runs the CLI program by parsing command-line arguments.
+ *
+ * This function handles errors gracefully and sets the appropriate
+ * exit code on failure.
+ *
+ * @returns A promise that resolves when the program completes
+ *
+ * @example
+ * ```ts
+ * import { runProgram } from './program.ts';
+ * await runProgram();
+ * ```
+ */
+export declare const runProgram: () => Promise<void>;
+//# sourceMappingURL=program.d.ts.map

package/dist/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAOtD;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,OAAO,qBAGQ,CAAC;AAOtB,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,QAAa,OAAO,CAAC,IAAI,CAe/C,CAAC"}

package/dist/program.spec.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Unit tests for the Commander.js program setup and runProgram entrypoint.
+ *
+ * Verifies that the program is correctly wired with the expected name,
+ * version, and top-level subcommands, and that `runProgram` is exported
+ * as a callable function.
+ *
+ * @module cli/program.spec
+ */
+export {};
+//# sourceMappingURL=program.spec.d.ts.map

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

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

package/dist/run.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env bun
+/**
+ * CLI runner script for integration testing.
+ * This script is spawned as a subprocess by the integration tests.
+ */
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

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

package/dist/run.spec.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Unit tests for the run.ts CLI entrypoint.
+ *
+ * `run.ts` is a side-effect-only module that calls `runProgram()` on import.
+ * Because importing it would immediately parse `process.argv`, we do NOT
+ * import it directly in tests. Instead we verify that the function it
+ * delegates to (`runProgram`) is correctly exported from `program.ts`.
+ *
+ * @module cli/run.spec
+ */
+export {};
+//# sourceMappingURL=run.spec.d.ts.map

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

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

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

@@ -0,0 +1,73 @@
+/**
+ * Store add command for registering a new store.
+ *
+ * This command registers a new store in the global registry with a given
+ * name and filesystem path. Paths are resolved relative to the current
+ * working directory, with support for tilde expansion.
+ *
+ * @example
+ * ```bash
+ * # Register a store with an absolute path
+ * cortex store add work /path/to/work/memories
+ *
+ * # Register a store with a relative path
+ * cortex store add project ./cortex
+ *
+ * # Register a store with tilde expansion
+ * cortex store add personal ~/memories
+ * ```
+ */
+import { Command } from '@commander-js/extra-typings';
+import { type CortexContext } from '@yeseh/cortex-core';
+/**
+ * Options for the add command.
+ */
+export interface AddCommandOptions {
+    /** Output format (yaml, json, toon) */
+    format?: string;
+}
+/**
+ * Dependencies for the add command handler.
+ * Allows injection for testing.
+ */
+export interface AddHandlerDeps {
+    /** Output stream for writing results (defaults to process.stdout) */
+    stdout?: NodeJS.WritableStream;
+}
+/**
+ * Handles the add command execution.
+ *
+ * This function:
+ * 1. Validates the store name format
+ * 2. Validates and resolves the store path
+ * 3. Checks if store already exists in context
+ * 4. Reads current config file
+ * 5. Adds the store to the config and saves
+ * 6. Outputs the result
+ *
+ * @param ctx - The CortexContext with loaded configuration
+ * @param name - The store name to register
+ * @param storePath - The filesystem path to the store
+ * @param options - Command options (format)
+ * @param deps - Optional dependencies for testing
+ * @throws {InvalidArgumentError} When the store name or path is invalid
+ * @throws {CommanderError} When the store already exists or config operations fail
+ */
+export declare function handleAdd(ctx: CortexContext, name: string, storePath: string, options?: AddCommandOptions, deps?: AddHandlerDeps): Promise<void>;
+/**
+ * The `add` subcommand for registering a new store.
+ *
+ * Registers a store with the given name and filesystem path. The path is
+ * resolved relative to the current working directory, with support for
+ * tilde expansion.
+ *
+ * @example
+ * ```bash
+ * cortex store add work /path/to/work/memories
+ * cortex store add project ./cortex --format json
+ * ```
+ */
+export declare const addCommand: Command<[string, string], {
+    format: string;
+}, {}>;
+//# sourceMappingURL=add.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/store/commands/add.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAKtD,OAAO,EAAqB,KAAK,aAAa,EAAoB,MAAM,oBAAoB,CAAC;AAG7F;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CAClC;AAwDD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAC3B,GAAG,EAAE,aAAa,EAClB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,iBAAsB,EAC/B,IAAI,GAAE,cAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA8Ef;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU;;MAWjB,CAAC"}