@ariacode/cli 0.1.0 → 0.2.2

package/README.md

@@ -6,12 +6,11 @@
 
 [![Node.js >=20](https://img.shields.io/node/v/@ariacode/cli.svg)](https://nodejs.org)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
-[![Build](https://img.shields.io/github/actions/workflow/status/ariacodeai/ariacode/ci.yml?branch=main)](https://github.com/ariacodeai/ariacode/actions)
 [![npm](https://img.shields.io/npm/v/@ariacode/cli)](https://www.npmjs.com/package/@ariacode/cli)
 
 A predictable, terminal-native coding agent for Next.js, Nest.js, Prisma and Node.js projects.
 
-Aria reads your repository, generates safe diffs with preview and tracks every mutation in a local SQLite history — no surprises.
+Aria reads your repository, generates safe diffs with preview, understands your Prisma schema, upgrades dependencies with risk analysis, and tracks every mutation in a local SQLite history — no surprises.
 
 ## Requirements
 
@@ -33,6 +32,9 @@ After installation the `aria` binary is available globally.
 # Ask a question about your codebase
 aria ask "How is authentication handled in this project?"
 
+# Use a different provider for a single command
+aria ask "Explain the data model" --provider openrouter --model deepseek/deepseek-chat
+
 # Generate an implementation plan (read-only, no changes)
 aria plan "Add rate limiting to the API routes"
 
@@ -48,6 +50,18 @@ aria review
 # Explore an unfamiliar codebase
 aria explore
 
+# Prisma schema inspection (instant, no LLM)
+aria db schema
+
+# Ask about your database schema
+aria db ask "users with more than 5 orders in the last 30 days"
+
+# Upgrade outdated dependencies
+aria upgrade deps
+
+# Upgrade Prisma with migration guidance
+aria upgrade prisma
+
 # Check your environment
 aria doctor
 ```
@@ -59,7 +73,7 @@ aria doctor
 Ask a read-only question about the repository. The agent uses `read_file`, `list_directory`, and `search_code` to explore the codebase and answer your question.
 
 ```
-aria ask "<question>" [--session <id>] [--max-tokens <n>] [--quiet]
+aria ask "<question>" [--session <id>] [--max-tokens <n>] [--quiet] [--provider <name>] [--model <name>]
 ```
 
 | Flag | Description |
@@ -67,6 +81,8 @@ aria ask "<question>" [--session <id>] [--max-tokens <n>] [--quiet]
 | `--session <id>` | Resume an existing session |
 | `--max-tokens <n>` | Override max tokens for this response |
 | `--quiet` | Suppress non-essential output |
+| `--provider <name>` | Override provider for this command |
+| `--model <name>` | Override LLM model for this command |
 
 ### `aria plan <goal>`
 
@@ -152,12 +168,169 @@ aria config init                   # Create ./.aria.toml with defaults
 
 ### `aria doctor`
 
-Run environment diagnostics: Node.js version, git, ripgrep, config validity, history DB, provider API keys, and project detection.
+Run environment diagnostics: Node.js version, git, ripgrep, config validity, history DB, provider API keys, project detection, and Prisma schema presence.
 
 ```
 aria doctor [--format text|json]
 ```
 
+### `aria db schema`
+
+Parse and render `schema.prisma` content — models, fields, relations, enums, indexes. No LLM call, instant and free.
+
+```
+aria db schema [--json] [--prisma-model <name>]
+```
+
+| Flag | Description |
+|------|-------------|
+| `--json` | Output raw `PrismaSchemaInfo` as JSON |
+| `--prisma-model <name>` | Filter to a single Prisma model |
+
+Example output:
+
+```
+Prisma Schema: prisma/schema.prisma
+Provider: postgresql
+
+Models (3)
+
+  User
+  ┌──────────────┬──────────┬──────────────────┐
+  │ Field        │ Type     │ Modifiers        │
+  ├──────────────┼──────────┼──────────────────┤
+  │ id           │ String   │ @id @default     │
+  │ email        │ String   │ @unique          │
+  │ createdAt    │ DateTime │ @default(now())  │
+  │ orders       │ Order[]  │ relation         │
+  └──────────────┴──────────┴──────────────────┘
+
+Enums (1)
+  Role: ADMIN, USER, GUEST
+```
+
+### `aria db ask <question>`
+
+Q&A over your Prisma schema. Generates runnable Prisma Client code. Warns when queries touch sensitive fields (password, token, secret, apiKey).
+
+```
+aria db ask "<question>" [--session <id>] [--prisma-model <name>] [--provider <name>] [--model <name>]
+```
+
+### `aria db explain <description>`
+
+Analyze Prisma Client usage in your code. Identifies N+1 queries, missing indexes, over-fetching, and cartesian products. Suggests `@@index` additions and query improvements.
+
+```
+aria db explain "<description>" [--file <path>] [--session <id>]
+```
+
+### `aria db migrate <description>`
+
+Propose changes to `schema.prisma` with diff preview and confirmation. Prints manual `prisma migrate` commands — Aria never runs migrations.
+
+```
+aria db migrate "<description>" [--dry-run] [--yes] [--session <id>]
+```
+
+| Flag | Description |
+|------|-------------|
+| `--dry-run` | Preview schema diff without writing |
+| `--yes` | Skip confirmation prompt |
+
+After a successful write:
+
+```
+✓ Schema updated: prisma/schema.prisma
+
+To apply this migration, run:
+
+  Development:
+    pnpm prisma migrate dev --name <migration_name>
+
+  Production:
+    pnpm prisma migrate deploy
+
+Aria does not run migrations automatically.
+Review the generated SQL before applying to production.
+```
+
+### `aria upgrade deps`
+
+Analyze outdated dependencies, classify by semver risk, and propose upgrades to `package.json`. Supports npm, pnpm, yarn, and bun.
+
+```
+aria upgrade deps [--dry-run] [--yes] [--risk patch|minor|major|all] [--dev]
+```
+
+| Flag | Description |
+|------|-------------|
+| `--dry-run` | Preview upgrades without modifying `package.json` |
+| `--yes` | Skip confirmation prompt |
+| `--risk <level>` | Filter by risk: `patch`, `minor` (default — includes patch), `major`, `all` |
+| `--dev` | Include devDependencies |
+
+Behavior:
+1. Detects your package manager from lockfile
+2. Runs `{pm} outdated --json` (read-only)
+3. Classifies each upgrade as patch / minor / major / prerelease
+4. For major upgrades, uses LLM to summarize breaking changes
+5. Shows a grouped table preview
+6. On confirmation, updates `package.json` and prints install command
+
+Aria never runs `npm install` / `pnpm install` / `yarn install` / `bun install`. You run it.
+
+```
+✓ Updated package.json with 12 dependency upgrades
+
+To install the new versions, run:
+  pnpm install
+
+Then verify:
+  pnpm test
+  pnpm run build
+```
+
+### `aria upgrade prisma`
+
+Prisma-specific upgrade with version detection and migration guidance for major upgrades.
+
+```
+aria upgrade prisma [--dry-run] [--yes]
+```
+
+| Flag | Description |
+|------|-------------|
+| `--dry-run` | Preview without modifying `package.json` |
+| `--yes` | Skip confirmation prompt |
+
+For major Prisma upgrades, the LLM analyzes your `schema.prisma` for patterns affected by breaking changes and provides project-specific migration steps.
+
+After a successful upgrade:
+
+```
+✓ Updated Prisma versions in package.json:
+    prisma: 5.22.0 → 6.1.0
+    @prisma/client: 5.22.0 → 6.1.0
+
+Next steps (run in order):
+
+1. Install updated dependencies:
+     pnpm install
+
+2. Regenerate Prisma Client:
+     pnpm prisma generate
+
+3. Review breaking changes:
+     https://github.com/prisma/prisma/releases/tag/6.1.0
+
+4. Run your test suite:
+     pnpm test
+
+Aria has updated package.json only.
+Migration commands must be run manually.
+```
+
 ## Configuration
 
 Aria loads configuration from multiple sources in this precedence order (highest wins):
@@ -176,6 +349,14 @@ default = "anthropic"       # anthropic | openai | ollama | openrouter
 model = "claude-sonnet-4-6"
 max_tokens = 4096
 
+# Per-provider overrides (optional)
+[provider.anthropic]
+model = "claude-sonnet-4-6"       # override model when using Anthropic
+
+[provider.openrouter]
+model = "deepseek/deepseek-chat"  # override model when using OpenRouter
+base_url = "https://openrouter.ai/api/v1"  # custom endpoint (optional)
+
 [agent]
 max_iterations = 25
 mode = "build"              # build | plan
@@ -204,6 +385,7 @@ Run `aria config init` to generate a `.aria.toml` in the current directory.
 | `ANTHROPIC_API_KEY` | API key for Anthropic provider |
 | `OPENAI_API_KEY` | API key for OpenAI provider |
 | `OPENROUTER_API_KEY` | API key for OpenRouter provider |
+| `OPENROUTER_BASE_URL` | Custom base URL for OpenRouter-compatible endpoints |
 | `ARIA_PROVIDER` | Override default provider |
 | `ARIA_MODEL` | Override model name |
 | `ARIA_MAX_TOKENS` | Override max tokens |
@@ -368,7 +550,7 @@ See the full model catalogue at [openrouter.ai/models](https://openrouter.ai/mod
 | `2` | Invalid arguments |
 | `3` | Configuration error |
 | `4` | Provider error (e.g. missing API key) |
-| `5` | Project detection error |
+| `5` | Project detection error / Prisma not found |
 | `130` | User cancelled (Ctrl+C or declined confirmation) |
 
 ## Session History
@@ -394,6 +576,9 @@ Sessions older than `retain_days` (default: 90) are cleaned up automatically.
 - `.env` files and `node_modules` are excluded from directory listings by default
 - API keys are never logged to the history database or terminal output
 - All mutations require confirmation unless `--yes` is passed
+- `aria db migrate` never executes `prisma migrate` — prints commands for user to run
+- `aria upgrade deps` never runs `npm/pnpm/yarn/bun install` — modifies `package.json` only
+- `aria upgrade prisma` never runs `prisma migrate` or install commands
 
 ## Contributing
 

package/dist/actions/db-ask.d.ts

@@ -0,0 +1,16 @@
+/**
+ * aria db ask — Q&A over Prisma schema, generates Prisma Client code.
+ * Forced read-only (plan mode). Never mutates.
+ */
+export interface DbAskOptions {
+    question: string;
+    session?: string;
+    prismaModel?: string;
+    quiet?: boolean;
+    projectRoot?: string;
+    /** Override provider (v0.2.2) */
+    provider?: string;
+    /** Override LLM model (v0.2.2) */
+    model?: string;
+}
+export declare function runDbAsk(options: DbAskOptions): Promise<void>;

package/dist/actions/db-ask.js

@@ -0,0 +1,130 @@
+/**
+ * aria db ask — Q&A over Prisma schema, generates Prisma Client code.
+ * Forced read-only (plan mode). Never mutates.
+ */
+import { randomUUID } from 'node:crypto';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname } from 'node:path';
+import { getConfig } from '../config.js';
+import { parsePrismaSchema } from '../db/schema.js';
+import { renderSchemaSummary } from '../db/summary.js';
+import { detectProjectType } from '../repo.js';
+import { createProvider } from '../provider.js';
+import { initializeDatabase, createSession, updateSessionStatus, logMessage } from '../storage.js';
+import { readFileTool, searchCodeTool, readPrismaSchemaParserTool, findPrismaUsageTool, findModelReferencesTool, } from '../tools.js';
+import { agentLoop, UserCancelledError } from '../agent.js';
+import { initUI, info, error as uiError, yellow } from '../ui.js';
+import { ConfirmCancelledError } from '../ui.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DB_ASK_TOOLS = [
+    readPrismaSchemaParserTool,
+    findPrismaUsageTool,
+    findModelReferencesTool,
+    readFileTool,
+    searchCodeTool,
+];
+const SENSITIVE_PATTERN = /password|token|secret|hash|apiKey|stripeCustomerId|ssn/i;
+export async function runDbAsk(options) {
+    const projectRoot = path.resolve(options.projectRoot ?? process.cwd());
+    const config = getConfig(projectRoot, { quiet: options.quiet, provider: options.provider, model: options.model });
+    initUI(config.ui.color, config.ui.quiet || Boolean(options.quiet));
+    // Validate schema exists
+    const schemaInfo = parsePrismaSchema(projectRoot);
+    if (!schemaInfo) {
+        uiError('No schema.prisma found. aria db ask requires a Prisma project.');
+        process.exit(5);
+    }
+    const project = detectProjectType(projectRoot);
+    const db = initializeDatabase();
+    let sessionId;
+    if (options.session) {
+        // Validate session exists before resuming
+        const { getSession } = await import('../storage.js');
+        const existing = getSession(db, options.session);
+        if (!existing) {
+            uiError(`Session not found: ${options.session}`);
+            process.exit(1);
+        }
+        sessionId = existing.id;
+    }
+    else {
+        sessionId = randomUUID();
+        createSession(db, {
+            id: sessionId,
+            command: 'db ask',
+            projectRoot,
+            provider: config.provider.default,
+            model: config.provider.model,
+        });
+    }
+    let provider;
+    try {
+        provider = createProvider(config.provider.default, config.provider);
+    }
+    catch (err) {
+        uiError(err instanceof Error ? err.message : String(err));
+        updateSessionStatus(db, sessionId, 'failed', String(err));
+        process.exit(4);
+    }
+    const ctx = {
+        projectRoot,
+        sessionId,
+        provider: config.provider.default,
+        model: config.provider.model,
+        mode: 'plan', // always read-only
+        dryRun: false,
+        assumeYes: false,
+        maxIterations: config.agent.maxIterations,
+        timeoutSeconds: config.agent.timeoutSeconds,
+    };
+    const schemaSummary = renderSchemaSummary(schemaInfo, false);
+    const systemPrompt = buildDbAskPrompt({
+        projectType: project.type,
+        schemaPath: schemaInfo.path,
+        datasourceProvider: schemaInfo.datasourceProvider ?? 'unknown',
+        schemaSummary,
+        templateDir: path.join(__dirname, '..', 'prompts'),
+    });
+    logMessage(db, sessionId, 'system', systemPrompt);
+    // Prepend sensitivity warning hint to question if relevant
+    let userRequest = options.question;
+    if (options.prismaModel) {
+        userRequest = `[Focus on model: ${options.prismaModel}]\n\n${userRequest}`;
+    }
+    if (SENSITIVE_PATTERN.test(options.question)) {
+        userRequest = `[NOTE: This question may involve sensitive fields. Add a WARNING above the code.]\n\n${userRequest}`;
+    }
+    try {
+        await agentLoop(ctx, userRequest, DB_ASK_TOOLS, provider, config, 'db ask', db, systemPrompt);
+        updateSessionStatus(db, sessionId, 'completed');
+    }
+    catch (err) {
+        if (err instanceof UserCancelledError || err instanceof ConfirmCancelledError) {
+            info(yellow('Operation cancelled.'));
+            updateSessionStatus(db, sessionId, 'cancelled');
+            process.exit(130);
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        uiError(message);
+        updateSessionStatus(db, sessionId, 'failed', message);
+        process.exit(1);
+    }
+}
+function buildDbAskPrompt(opts) {
+    const templatePath = path.join(opts.templateDir, 'db_ask.md');
+    let template;
+    try {
+        template = fs.readFileSync(templatePath, 'utf-8');
+    }
+    catch {
+        template = 'You are Aria Code\'s Prisma DB Assistant. Schema: {{schemaSummary}}';
+    }
+    return template
+        .replace(/\{\{projectType\}\}/g, opts.projectType)
+        .replace(/\{\{schemaPath\}\}/g, opts.schemaPath)
+        .replace(/\{\{datasourceProvider\}\}/g, opts.datasourceProvider)
+        .replace(/\{\{schemaSummary\}\}/g, () => opts.schemaSummary);
+}
+//# sourceMappingURL=db-ask.js.map

package/dist/actions/db-ask.js.map

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

package/dist/actions/db-explain.d.ts

@@ -0,0 +1,16 @@
+/**
+ * aria db explain — analyze Prisma Client usage, explain performance characteristics.
+ * Forced read-only (plan mode). Never mutates.
+ */
+export interface DbExplainOptions {
+    description: string;
+    file?: string;
+    session?: string;
+    quiet?: boolean;
+    projectRoot?: string;
+    /** Override provider (v0.2.2) */
+    provider?: string;
+    /** Override LLM model (v0.2.2) */
+    model?: string;
+}
+export declare function runDbExplain(options: DbExplainOptions): Promise<void>;

package/dist/actions/db-explain.js

@@ -0,0 +1,123 @@
+/**
+ * aria db explain — analyze Prisma Client usage, explain performance characteristics.
+ * Forced read-only (plan mode). Never mutates.
+ */
+import { randomUUID } from 'node:crypto';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname } from 'node:path';
+import { getConfig } from '../config.js';
+import { parsePrismaSchema } from '../db/schema.js';
+import { renderSchemaSummary } from '../db/summary.js';
+import { detectProjectType } from '../repo.js';
+import { createProvider } from '../provider.js';
+import { initializeDatabase, createSession, updateSessionStatus, logMessage } from '../storage.js';
+import { readFileTool, searchCodeTool, readPrismaSchemaParserTool, findPrismaUsageTool, findModelReferencesTool, } from '../tools.js';
+import { agentLoop, UserCancelledError } from '../agent.js';
+import { initUI, info, error as uiError, yellow } from '../ui.js';
+import { ConfirmCancelledError } from '../ui.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DB_EXPLAIN_TOOLS = [
+    readPrismaSchemaParserTool,
+    findPrismaUsageTool,
+    findModelReferencesTool,
+    readFileTool,
+    searchCodeTool,
+];
+export async function runDbExplain(options) {
+    const projectRoot = path.resolve(options.projectRoot ?? process.cwd());
+    const config = getConfig(projectRoot, { quiet: options.quiet, provider: options.provider, model: options.model });
+    initUI(config.ui.color, config.ui.quiet || Boolean(options.quiet));
+    const schemaInfo = parsePrismaSchema(projectRoot);
+    if (!schemaInfo) {
+        uiError('No schema.prisma found. aria db explain requires a Prisma project.');
+        process.exit(5);
+    }
+    const project = detectProjectType(projectRoot);
+    const db = initializeDatabase();
+    let sessionId;
+    if (options.session) {
+        const { getSession } = await import('../storage.js');
+        const existing = getSession(db, options.session);
+        if (!existing) {
+            uiError(`Session not found: ${options.session}`);
+            process.exit(1);
+        }
+        sessionId = existing.id;
+    }
+    else {
+        sessionId = randomUUID();
+        createSession(db, {
+            id: sessionId,
+            command: 'db explain',
+            projectRoot,
+            provider: config.provider.default,
+            model: config.provider.model,
+        });
+    }
+    let provider;
+    try {
+        provider = createProvider(config.provider.default, config.provider);
+    }
+    catch (err) {
+        uiError(err instanceof Error ? err.message : String(err));
+        updateSessionStatus(db, sessionId, 'failed', String(err));
+        process.exit(4);
+    }
+    const ctx = {
+        projectRoot,
+        sessionId,
+        provider: config.provider.default,
+        model: config.provider.model,
+        mode: 'plan',
+        dryRun: false,
+        assumeYes: false,
+        maxIterations: config.agent.maxIterations,
+        timeoutSeconds: config.agent.timeoutSeconds,
+    };
+    const schemaSummary = renderSchemaSummary(schemaInfo, false);
+    const systemPrompt = buildDbExplainPrompt({
+        projectType: project.type,
+        schemaPath: schemaInfo.path,
+        datasourceProvider: schemaInfo.datasourceProvider ?? 'unknown',
+        schemaSummary,
+        templateDir: path.join(__dirname, '..', 'prompts'),
+    });
+    logMessage(db, sessionId, 'system', systemPrompt);
+    let userRequest = options.description;
+    if (options.file) {
+        userRequest = `[Focus on file: ${options.file}]\n\n${userRequest}`;
+    }
+    try {
+        await agentLoop(ctx, userRequest, DB_EXPLAIN_TOOLS, provider, config, 'db explain', db, systemPrompt);
+        updateSessionStatus(db, sessionId, 'completed');
+    }
+    catch (err) {
+        if (err instanceof UserCancelledError || err instanceof ConfirmCancelledError) {
+            info(yellow('Operation cancelled.'));
+            updateSessionStatus(db, sessionId, 'cancelled');
+            process.exit(130);
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        uiError(message);
+        updateSessionStatus(db, sessionId, 'failed', message);
+        process.exit(1);
+    }
+}
+function buildDbExplainPrompt(opts) {
+    const templatePath = path.join(opts.templateDir, 'db_explain.md');
+    let template;
+    try {
+        template = fs.readFileSync(templatePath, 'utf-8');
+    }
+    catch {
+        template = 'You are Aria Code\'s Prisma query analyzer. Schema: {{schemaSummary}}';
+    }
+    return template
+        .replace(/\{\{projectType\}\}/g, opts.projectType)
+        .replace(/\{\{schemaPath\}\}/g, opts.schemaPath)
+        .replace(/\{\{datasourceProvider\}\}/g, opts.datasourceProvider)
+        .replace(/\{\{schemaSummary\}\}/g, () => opts.schemaSummary);
+}
+//# sourceMappingURL=db-explain.js.map

package/dist/actions/db-explain.js.map

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

package/dist/actions/db-migrate.d.ts

@@ -0,0 +1,17 @@
+/**
+ * aria db migrate — propose changes to schema.prisma only.
+ * NEVER executes prisma migrate commands. User runs those manually.
+ */
+export interface DbMigrateOptions {
+    description: string;
+    dryRun?: boolean;
+    yes?: boolean;
+    session?: string;
+    quiet?: boolean;
+    projectRoot?: string;
+    /** Override provider (v0.2.2) */
+    provider?: string;
+    /** Override LLM model (v0.2.2) */
+    model?: string;
+}
+export declare function runDbMigrate(options: DbMigrateOptions): Promise<void>;