@yeseh/cortex-cli 0.6.0 → 0.6.3

package/dist/toon.d.ts

@@ -1,197 +0,0 @@
-/**
- * TOON (Token-Oriented Object Notation) encoder.
- *
- * A compact serialization format optimized for LLM context consumption,
- * achieving approximately 40% token reduction compared to JSON while
- * improving parsing accuracy from 70% to 74% in LLM benchmarks.
- *
- * ## Key Features
- *
- * - **Tab delimiters** - Uses tabs between key-value pairs instead of JSON's
- *   commas and braces, maximizing token efficiency
- * - **Key folding** - Collapses nested object paths to dotted notation
- *   (e.g., `user.profile.name` instead of nested objects)
- * - **Tabular arrays** - Uniform object arrays use a compact header+rows format,
- *   dramatically reducing repetition
- *
- * ## Format Specification
- *
- * | JSON Construct | TOON Equivalent |
- * |----------------|-----------------|
- * | `{"key": "value"}` | `key:value` |
- * | `{"a": 1, "b": 2}` | `a:1\tb:2` |
- * | Nested object | `parent.child:value` (with key folding) |
- * | Uniform array | `items[N]{col1\tcol2}:\n\tval1\tval2` |
- *
- * ## Token Efficiency
- *
- * TOON reduces token count through:
- * 1. Eliminating JSON syntax tokens (`{`, `}`, `[`, `]`, `,`, `"`)
- * 2. Using single-character delimiters (tabs, colons)
- * 3. Deduplicating keys in tabular array format
- *
- * Typical savings:
- * - Simple objects: ~30% reduction
- * - Nested objects with key folding: ~40% reduction
- * - Arrays of uniform objects: ~50% reduction
- *
- * @module cli/toon
- *
- * @example Basic object encoding
- * ```ts
- * import { encode } from './toon';
- *
- * encode({ name: 'test', count: 42 });
- * // Output: "name:test\tcount:42"
- * ```
- *
- * @example Key folding for nested objects
- * ```ts
- * encode(
- *   { user: { name: 'Alice', role: 'admin' } },
- *   { keyFolding: 'safe' }
- * );
- * // Output: "user.name:Alice\tuser.role:admin"
- * //
- * // Without key folding:
- * // "user:{name:Alice\trole:admin}"
- * ```
- *
- * @example Tabular arrays (automatic for uniform object arrays)
- * ```ts
- * encode({
- *   items: [
- *     { id: 1, name: 'Widget' },
- *     { id: 2, name: 'Gadget' },
- *   ]
- * });
- * // Output:
- * // "items[2]{id\tname}:
- * //  \t1\tWidget
- * //  \t2\tGadget"
- * //
- * // Equivalent JSON (32 tokens):
- * // {"items":[{"id":1,"name":"Widget"},{"id":2,"name":"Gadget"}]}
- * // TOON version (18 tokens): ~44% reduction
- * ```
- *
- * @see {@link ToonOptions} for configuration options
- * @see {@link encode} for the main encoding function
- */
-/**
- * Configuration options for TOON encoding.
- *
- * @example Using custom delimiter
- * ```ts
- * encode({ a: 1, b: 2 }, { delimiter: '|' });
- * // Output: "a:1|b:2"
- * ```
- *
- * @example Enabling key folding
- * ```ts
- * encode({ config: { debug: true } }, { keyFolding: 'safe' });
- * // Output: "config.debug:true"
- * ```
- */
-export interface ToonOptions {
-    /**
-     * Character used to separate key-value pairs.
-     *
-     * The tab character (`\t`) is used by default as it provides optimal
-     * token efficiency in most LLM tokenizers (single token per delimiter).
-     *
-     * @default '\t'
-     */
-    delimiter?: string;
-    /**
-     * Controls how nested objects are serialized.
-     *
-     * - `'none'` - Nested objects are serialized inline with braces:
-     *   `parent:{child:value}`
-     * - `'safe'` - Nested paths are collapsed to dotted notation:
-     *   `parent.child:value`
-     *
-     * Key folding (`'safe'`) typically produces more compact output and is
-     * easier for LLMs to parse, but may cause key collisions if object
-     * keys contain dots.
-     *
-     * @default 'none'
-     */
-    keyFolding?: 'safe' | 'none';
-}
-/**
- * Encodes a value to TOON format.
- *
- * TOON (Token-Oriented Object Notation) is a compact serialization format
- * designed to minimize token consumption in LLM contexts while remaining
- * human-readable and easily parseable by language models.
- *
- * @param value - The value to encode (must be JSON-serializable)
- * @param options - Encoding options for customizing output format
- * @returns TOON-encoded string representation
- *
- * @example Basic object encoding
- * ```ts
- * const data = { name: 'test', count: 42 };
- * encode(data);
- * // Returns: "name:test\tcount:42"
- * //
- * // Equivalent JSON: {"name":"test","count":42}
- * // Token savings: ~35%
- * ```
- *
- * @example Nested objects with key folding
- * ```ts
- * const nested = {
- *   user: {
- *     profile: { name: 'Alice', email: 'alice@example.com' },
- *     settings: { theme: 'dark' }
- *   }
- * };
- *
- * // Without key folding (default):
- * encode(nested);
- * // Returns: "user:{profile:{name:Alice\temail:alice@example.com}\tsettings:{theme:dark}}"
- *
- * // With key folding:
- * encode(nested, { keyFolding: 'safe' });
- * // Returns: "user.profile.name:Alice\tuser.profile.email:alice@example.com\tuser.settings.theme:dark"
- * ```
- *
- * @example Tabular arrays (automatic for uniform object arrays)
- * ```ts
- * const users = {
- *   users: [
- *     { id: 1, name: 'Alice', role: 'admin' },
- *     { id: 2, name: 'Bob', role: 'user' },
- *     { id: 3, name: 'Charlie', role: 'user' },
- *   ]
- * };
- *
- * encode(users);
- * // Returns:
- * // "users[3]{id\tname\trole}:
- * //  \t1\tAlice\tadmin
- * //  \t2\tBob\tuser
- * //  \t3\tCharlie\tuser"
- * //
- * // Equivalent JSON (87 chars, ~25 tokens):
- * // {"users":[{"id":1,"name":"Alice","role":"admin"},{"id":2,"name":"Bob","role":"user"},{"id":3,"name":"Charlie","role":"user"}]}
- * //
- * // TOON (67 chars, ~15 tokens): ~40% token reduction
- * ```
- *
- * @example Mixed content
- * ```ts
- * encode({
- *   title: 'Report',
- *   metadata: { version: 1 },
- *   tags: ['urgent', 'review']  // Non-uniform arrays use JSON format
- * }, { keyFolding: 'safe' });
- * // Returns: "title:Report\tmetadata.version:1\ttags:[\"urgent\",\"review\"]"
- * ```
- *
- * @see {@link ToonOptions} for available configuration options
- */
-export declare const encode: (value: unknown, options?: ToonOptions) => string;
-//# sourceMappingURL=toon.d.ts.map

package/dist/toon.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"toon.d.ts","sourceRoot":"","sources":["../src/toon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+EG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,WAAW;IACxB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAChC;AAkQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyEG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,EAAE,UAAU,WAAW,KAAG,MAO9D,CAAC"}

package/dist/toon.spec.d.ts

@@ -1,9 +0,0 @@
-/**
- * Unit tests for toon.ts
- *
- * TOON (Token-Oriented Object Notation) encoder.
- *
- * @module cli/toon.spec
- */
-export {};
-//# sourceMappingURL=toon.spec.d.ts.map

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

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

package/dist/utils/git.d.ts

@@ -1,20 +0,0 @@
-/**
- * Executes a git command and returns the trimmed stdout.
- */
-export declare const runGitCommand: (args: string[], cwd: string) => Promise<{
-    ok: true;
-    value: string;
-} | {
-    ok: false;
-}>;
-/**
- * Detects the git repository name from the current working directory.
- *
- * Uses `git rev-parse --show-toplevel` to find the repository root,
- * then extracts the directory name as the repository name.
- *
- * @param cwd - The current working directory to check for git repository
- * @returns The repository directory name, or `null` if not in a git repository
- */
-export declare const detectGitRepoName: (cwd: string) => Promise<string | null>;
-//# sourceMappingURL=git.d.ts.map

package/dist/utils/git.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,aAAa,GACtB,MAAM,MAAM,EAAE,EACd,KAAK,MAAM,KACZ,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAoBrD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAU,KAAK,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAQ1E,CAAC"}

package/dist/utils/git.spec.d.ts

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

package/dist/utils/git.spec.d.ts.map

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