@proseql/cli 0.2.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Simon W. Jackson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,333 @@
+# @proseql/cli
+
+Command-line interface for ProseQL databases. Query, create, update, and manage your plain text database files from the terminal.
+
+## Install
+
+```sh
+# Run directly with npx
+npx @proseql/cli --help
+
+# Or install globally
+npm install -g @proseql/cli
+```
+
+## Quick Start
+
+```sh
+# Initialize a new project
+proseql init
+
+# Query a collection
+proseql query books --where 'year > 1970' --limit 10
+
+# Create an entity
+proseql create books --data '{"title":"Dune","author":"Frank Herbert","year":1965}'
+
+# Update an entity
+proseql update books abc123 --set 'year=2025,title=New Title'
+
+# Delete an entity
+proseql delete books abc123 --force
+```
+
+## Commands
+
+### `init`
+
+Scaffold a new ProseQL project with config and data files.
+
+```sh
+proseql init
+proseql init --format yaml
+proseql init --format toml
+```
+
+Creates:
+- `proseql.config.ts` with an example `notes` collection
+- `data/notes.{json,yaml,toml}` with sample data
+- Updates `.gitignore` to exclude the data directory (if in a git repo)
+
+| Option | Description |
+|--------|-------------|
+| `--format <fmt>` | Data file format: `json` (default), `yaml`, `toml` |
+
+### `query`
+
+Query a collection with filters, sorting, and pagination.
+
+```sh
+proseql query <collection> [options]
+
+# Examples
+proseql query books
+proseql query books --where 'year > 1970'
+proseql query books --where 'genre = sci-fi' --where 'year < 2000'
+proseql query books --select 'title,author' --sort 'year:desc' --limit 5
+proseql query books --json | jq '.[] | .title'
+```
+
+| Option | Description |
+|--------|-------------|
+| `-w, --where <expr>` | Filter expression (can be repeated) |
+| `-s, --select <fields>` | Comma-separated fields to include |
+| `--sort <field:dir>` | Sort by field (`asc` or `desc`) |
+| `-l, --limit <n>` | Limit number of results |
+
+Filter expressions use the format `field operator value`:
+- `year > 1970`
+- `genre = sci-fi`
+- `title != "Old Title"`
+- `rating >= 4.5`
+
+### `create`
+
+Create a new entity in a collection.
+
+```sh
+proseql create <collection> --data '<json>'
+
+# Examples
+proseql create books --data '{"title":"Neuromancer","author":"William Gibson","year":1984}'
+proseql create notes --data '{"title":"Meeting notes","content":"..."}'
+```
+
+| Option | Description |
+|--------|-------------|
+| `-d, --data <json>` | JSON object containing the entity data (required) |
+
+The created entity is printed to stdout. An ID is auto-generated if not provided.
+
+### `update`
+
+Update an existing entity by ID.
+
+```sh
+proseql update <collection> <id> --set '<assignments>'
+
+# Examples
+proseql update books abc123 --set 'year=2025'
+proseql update books abc123 --set 'year=2025,title=Updated Title'
+proseql update notes xyz --set 'content=New content here'
+```
+
+| Option | Description |
+|--------|-------------|
+| `--set <assignments>` | Comma-separated field assignments (required) |
+
+Values are automatically coerced: numbers become numbers, `true`/`false` become booleans.
+
+### `delete`
+
+Delete an entity by ID.
+
+```sh
+proseql delete <collection> <id> [options]
+
+# Examples
+proseql delete books abc123
+proseql delete books abc123 --force
+```
+
+| Option | Description |
+|--------|-------------|
+| `-f, --force` | Skip confirmation prompt |
+
+Without `--force`, you'll be prompted to confirm the deletion.
+
+### `collections`
+
+List all collections with entity counts and file paths.
+
+```sh
+proseql collections
+
+# Output:
+# name     count  file              format
+# books    42     data/books.yaml   yaml
+# authors  12     data/authors.json json
+```
+
+### `describe`
+
+Show schema details for a collection.
+
+```sh
+proseql describe <collection>
+
+# Examples
+proseql describe books
+proseql describe books --json
+```
+
+Displays:
+- Field names, types, and required/optional status
+- Indexed fields
+- Unique constraints
+- Relationships
+- Search index configuration
+- Schema version (if versioned)
+- Append-only mode (if enabled)
+
+### `stats`
+
+Show statistics for all collections.
+
+```sh
+proseql stats
+
+# Output:
+# name     count  file              format  size
+# books    42     data/books.yaml   yaml    12.5 KB
+# authors  12     data/authors.json json    2.1 KB
+```
+
+Includes entity counts, file paths, formats, and file sizes on disk.
+
+### `migrate`
+
+Run schema migrations.
+
+```sh
+# Show migration status
+proseql migrate status
+
+# Preview what would run (dry run)
+proseql migrate --dry-run
+
+# Execute pending migrations
+proseql migrate
+proseql migrate --force  # skip confirmation
+```
+
+| Option | Description |
+|--------|-------------|
+| `--dry-run` | Show what would be done without executing |
+| `-f, --force` | Skip confirmation prompt |
+
+Migration status shows:
+- Current file version vs target version
+- Collections that need migration
+- Number of migrations to apply
+
+### `convert`
+
+Convert a collection's data file to a different format.
+
+```sh
+proseql convert <collection> --to <format>
+
+# Examples
+proseql convert books --to yaml
+proseql convert notes --to json
+proseql convert config --to toml
+```
+
+| Option | Description |
+|--------|-------------|
+| `--to <format>` | Target format (required) |
+
+Supported formats: `json`, `yaml`, `toml`, `json5`, `jsonc`, `hjson`, `toon`
+
+The command:
+1. Reads the current data file
+2. Re-serializes in the target format
+3. Writes the new file with the correct extension
+4. Removes the old file
+5. Updates the config file to reference the new path
+
+## Global Options
+
+| Option | Description |
+|--------|-------------|
+| `-h, --help` | Show help message |
+| `-v, --version` | Show version |
+| `-c, --config <path>` | Path to config file (default: auto-discover) |
+| `--json` | Output as JSON |
+| `--yaml` | Output as YAML |
+| `--csv` | Output as CSV |
+
+## Output Formats
+
+All commands that return data support multiple output formats:
+
+```sh
+# Default: table format (human-readable)
+proseql query books
+
+# JSON (pipe to jq, etc.)
+proseql query books --json
+
+# YAML
+proseql query books --yaml
+
+# CSV (for spreadsheets)
+proseql query books --csv
+```
+
+Table is the default. JSON is useful for scripting and piping to other tools.
+
+## Config Discovery
+
+The CLI automatically discovers your config file by searching upward from the current directory:
+
+1. `proseql.config.ts`
+2. `proseql.config.js`
+3. `proseql.config.json`
+
+The first file found is used. Override with `--config`:
+
+```sh
+proseql query books --config ./path/to/proseql.config.ts
+```
+
+## Examples
+
+### Querying with filters and piping to jq
+
+```sh
+# Get all sci-fi books as JSON
+proseql query books --where 'genre = sci-fi' --json
+
+# Pipe to jq for further processing
+proseql query books --json | jq '.[] | {title, year}'
+
+# Count results
+proseql query books --where 'year > 2000' --json | jq length
+```
+
+### Batch operations with shell scripts
+
+```sh
+# Export all collections to JSON
+for collection in $(proseql collections --json | jq -r '.[].name'); do
+  proseql query "$collection" --json > "export-$collection.json"
+done
+```
+
+### Migration workflow
+
+```sh
+# Check what needs migrating
+proseql migrate status
+
+# Preview the changes
+proseql migrate --dry-run
+
+# Apply migrations
+proseql migrate --force
+```
+
+### Format conversion
+
+```sh
+# Convert from JSON to YAML for better readability
+proseql convert books --to yaml
+
+# Convert to TOML for config-like data
+proseql convert settings --to toml
+```
+
+## License
+
+MIT

package/dist/commands/collections.d.ts

@@ -0,0 +1,53 @@
+/**
+ * ProseQL CLI - Collections Command
+ *
+ * Boots the database from config, lists all collection names with entity count,
+ * file path, and serialization format.
+ */
+import { type DatabaseConfig } from "@proseql/node";
+import { Effect } from "effect";
+/**
+ * Options for the collections command.
+ */
+export interface CollectionsOptions {
+    /** The database configuration */
+    readonly config: DatabaseConfig;
+    /** The path to the config file (used for resolving relative file paths) */
+    readonly configPath: string;
+}
+/**
+ * Information about a single collection.
+ */
+export interface CollectionInfo {
+    readonly name: string;
+    readonly count: number;
+    readonly file: string;
+    readonly format: string;
+}
+/**
+ * Result of the collections command.
+ */
+export interface CollectionsResult {
+    readonly success: boolean;
+    readonly message?: string;
+    readonly data?: ReadonlyArray<CollectionInfo>;
+}
+/**
+ * Execute the collections command.
+ *
+ * Boots the database from the config, and lists all collections with
+ * their entity counts, file paths, and serialization formats.
+ *
+ * @param options - Collections command options
+ * @returns Result with collection information or error message
+ */
+export declare function runCollections(options: CollectionsOptions): Effect.Effect<CollectionsResult>;
+/**
+ * Handle the collections command from CLI main.ts.
+ * This is the entry point called by the command dispatcher.
+ *
+ * @param options - Collections command options
+ * @returns Promise that resolves to the collections info or rejects on error
+ */
+export declare function handleCollections(options: CollectionsOptions): Promise<CollectionsResult>;
+//# sourceMappingURL=collections.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/commands/collections.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEN,KAAK,cAAc,EAMnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAS,MAAM,EAAiB,MAAM,QAAQ,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CAC9C;AA4DD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC7B,OAAO,EAAE,kBAAkB,GACzB,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CA0FlC;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,kBAAkB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAG5B"}

package/dist/commands/collections.js

@@ -0,0 +1,145 @@
+/**
+ * ProseQL CLI - Collections Command
+ *
+ * Boots the database from config, lists all collection names with entity count,
+ * file path, and serialization format.
+ */
+import * as path from "node:path";
+import { createPersistentEffectDatabase, jsonCodec, makeSerializerLayer, NodeStorageLayer, tomlCodec, yamlCodec, } from "@proseql/node";
+import { Chunk, Effect, Layer, Stream } from "effect";
+/**
+ * Resolve relative file paths in the config to absolute paths
+ * based on the config file's directory.
+ */
+function resolveConfigPaths(config, configPath) {
+    const configDir = path.dirname(configPath);
+    const resolved = {};
+    for (const [collectionName, collectionConfig] of Object.entries(config)) {
+        if (collectionConfig.file && !path.isAbsolute(collectionConfig.file)) {
+            resolved[collectionName] = {
+                ...collectionConfig,
+                file: path.resolve(configDir, collectionConfig.file),
+            };
+        }
+        else {
+            resolved[collectionName] = collectionConfig;
+        }
+    }
+    return resolved;
+}
+/**
+ * Determine the serialization format from a file path.
+ * Returns the format based on the file extension.
+ */
+function getFormatFromFile(filePath) {
+    if (!filePath) {
+        return "(in-memory)";
+    }
+    const ext = path.extname(filePath).toLowerCase();
+    switch (ext) {
+        case ".json":
+            return "json";
+        case ".jsonl":
+            return "jsonl";
+        case ".yaml":
+        case ".yml":
+            return "yaml";
+        case ".toml":
+            return "toml";
+        case ".json5":
+            return "json5";
+        case ".jsonc":
+            return "jsonc";
+        case ".hjson":
+            return "hjson";
+        case ".toon":
+            return "toon";
+        default:
+            return ext ? ext.slice(1) : "unknown";
+    }
+}
+/**
+ * Execute the collections command.
+ *
+ * Boots the database from the config, and lists all collections with
+ * their entity counts, file paths, and serialization formats.
+ *
+ * @param options - Collections command options
+ * @returns Result with collection information or error message
+ */
+export function runCollections(options) {
+    return Effect.gen(function* () {
+        const { config, configPath } = options;
+        const collectionNames = Object.keys(config);
+        if (collectionNames.length === 0) {
+            return {
+                success: true,
+                data: [],
+                message: "No collections configured",
+            };
+        }
+        // Resolve relative file paths in the config
+        const resolvedConfig = resolveConfigPaths(config, configPath);
+        // Build the persistence layer for database operations
+        const PersistenceLayer = Layer.merge(NodeStorageLayer, makeSerializerLayer([jsonCodec(), yamlCodec(), tomlCodec()]));
+        // Boot the database and gather collection info
+        const program = Effect.gen(function* () {
+            const db = yield* createPersistentEffectDatabase(resolvedConfig, {});
+            const results = [];
+            for (const name of collectionNames) {
+                const collectionConfig = resolvedConfig[name];
+                const filePath = collectionConfig?.file;
+                // Get the collection (type assertion needed since we verify existence via config)
+                const coll = db[name];
+                // Count entities by querying all and collecting
+                const stream = coll.query();
+                const chunk = yield* Stream.runCollect(stream);
+                const count = Chunk.size(chunk);
+                // Get format from file extension
+                const format = getFormatFromFile(filePath);
+                // Get relative file path for display (relative to config dir)
+                const configDir = path.dirname(configPath);
+                const displayPath = filePath
+                    ? path.relative(configDir, filePath) || filePath
+                    : "(in-memory)";
+                results.push({
+                    name,
+                    count,
+                    file: displayPath,
+                    format,
+                });
+            }
+            return results;
+        });
+        // Run the program with the persistence layer
+        const result = yield* program.pipe(Effect.provide(PersistenceLayer), Effect.scoped, Effect.catchAll((error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            return Effect.succeed({
+                success: false,
+                message: `Failed to list collections: ${message}`,
+            });
+        }));
+        // Check if we got an error result
+        if ("success" in result && result.success === false) {
+            return result;
+        }
+        // We got data
+        const data = result;
+        return {
+            success: true,
+            data,
+        };
+    });
+}
+/**
+ * Handle the collections command from CLI main.ts.
+ * This is the entry point called by the command dispatcher.
+ *
+ * @param options - Collections command options
+ * @returns Promise that resolves to the collections info or rejects on error
+ */
+export async function handleCollections(options) {
+    const result = await Effect.runPromise(runCollections(options));
+    return result;
+}
+//# sourceMappingURL=collections.js.map

package/dist/commands/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/commands/collections.ts"],"names":[],"mappings":"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"}

package/dist/commands/convert.d.ts

@@ -0,0 +1,72 @@
+/**
+ * ProseQL CLI - Convert Command
+ *
+ * Converts a collection's data file from one format to another.
+ * Reads the current data file, serializes in the target format,
+ * and writes the new file with the correct extension.
+ */
+import { type DatabaseConfig } from "@proseql/node";
+import { Effect } from "effect";
+/**
+ * Supported target formats for conversion.
+ */
+export type TargetFormat = "json" | "yaml" | "toml" | "json5" | "jsonc" | "hjson" | "toon";
+/**
+ * Valid format names for validation.
+ */
+export declare const VALID_FORMATS: readonly TargetFormat[];
+/**
+ * Options for the convert command.
+ */
+export interface ConvertOptions {
+    /** The collection to convert */
+    readonly collection: string;
+    /** The database configuration */
+    readonly config: DatabaseConfig;
+    /** The path to the config file (used for resolving relative file paths) */
+    readonly configPath: string;
+    /** The target format to convert to */
+    readonly targetFormat: TargetFormat;
+}
+/**
+ * Result of the convert command.
+ */
+export interface ConvertResult {
+    readonly success: boolean;
+    readonly message?: string;
+    /** Details about the conversion */
+    readonly data?: {
+        readonly collection: string;
+        readonly oldFile: string;
+        readonly oldFormat: string;
+        readonly newFile: string;
+        readonly newFormat: string;
+        readonly configUpdated: boolean;
+    };
+}
+/**
+ * Validate that the target format is valid.
+ *
+ * @param format - The format string to validate
+ * @returns true if valid
+ */
+export declare function isValidFormat(format: string): format is TargetFormat;
+/**
+ * Execute the convert command.
+ *
+ * Reads the collection's current data file, deserializes it,
+ * and re-serializes it in the target format.
+ *
+ * @param options - Convert command options
+ * @returns Effect that resolves to the convert result
+ */
+export declare function runConvert(options: ConvertOptions): Effect.Effect<ConvertResult, never>;
+/**
+ * Handle the convert command from CLI main.ts.
+ * This is the entry point called by the command dispatcher.
+ *
+ * @param options - Convert command options
+ * @returns Promise that resolves to the convert result
+ */
+export declare function handleConvert(options: ConvertOptions): Promise<ConvertResult>;
+//# sourceMappingURL=convert.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/commands/convert.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACN,KAAK,cAAc,EAanB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAS,MAAM,QAAQ,CAAC;AAEvC;;GAEG;AACH,MAAM,MAAM,YAAY,GACrB,MAAM,GACN,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,OAAO,GACP,MAAM,CAAC;AAeV;;GAEG;AACH,eAAO,MAAM,aAAa,EAErB,SAAS,YAAY,EAAE,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,gCAAgC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE;QACf,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;KAChC,CAAC;CACF;AAsDD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,YAAY,CAEpE;AAiKD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACzB,OAAO,EAAE,cAAc,GACrB,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,CAsKrC;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAClC,OAAO,EAAE,cAAc,GACrB,OAAO,CAAC,aAAa,CAAC,CAExB"}