scai 0.1.177 → 1.0.0

package/README.md

@@ -1,378 +1,273 @@
-# ⚙️ SCAI — Source Code AI 🌿
+# SCAI
 
-> **A local-first AI CLI for understanding, querying, and iterating on large codebases.**
-> **100% local • No token costs • No cloud • No prompt injection • Private by design**
+> A local-first AI CLI for understanding code in your repo.
+> Private by default. No token costs. No cloud.
 
-🔗 **Website:** [https://scai.dk](https://scai.dk)
-🇪🇺 Built in Denmark / EU
+**SCAI** helps you ask questions about a codebase, trace behavior across files, and make small focused improvements without sending your code to external AI services.
 
----
+- **100% local**
+- **No token costs**
+- **No cloud**
+- **No telemetry**
+- **Your code stays on your machine**
 
-## What is SCAI?
+Website: [https://scai.dk](https://scai.dk)  
+Built in Denmark / EU
 
-**SCAI** is an AI-powered command-line tool that helps developers explore and reason about source code using **local large language models only**.
+## What SCAI Is Good At
 
-Inspired by tools such as *Claude Code* and *Gemini CLI*, SCAI is designed to feel like a natural extension of the terminal. It enables natural-language interaction with your codebase while deliberately avoiding cloud dependencies and network-connected agents.
+SCAI is strongest when you want help understanding an existing repository.
 
-SCAI runs entirely on your local system:
+It is good at:
 
-* **No token costs** — no usage-based pricing
-* **No internet access for agents**
-* **No prompt injection from web content**
-* No external AI APIs
-* No telemetry or tracking
-* No API keys
+- Explaining what a file, function, or module does
+- Finding where logic lives across the repo
+- Tracing auth, config, database, or API flow
+- Summarizing a subsystem before you edit it
+- Reviewing a small local change idea before you do it
+- Writing comments or small docs updates
+- Refactoring existing code in a small or medium-sized area
+- Helping with small light code changes in a limited area
+- Writing commit messages from staged changes
 
-Your code never leaves your machine. All analysis and reasoning happens locally.
+## Current Limits
 
-> **Local model tradeoff**
-> SCAI uses local LLMs. Output quality depends on your hardware and selected model. Cloud-hosted systems may perform better on general reasoning tasks, but SCAI prioritizes privacy, predictability, and control.
+SCAI is not a full replacement for a strong cloud coding agent.
 
----
+Today it works best when:
 
-## ⚠️ Alpha Status
+- The task is about understanding code already in the repo
+- The task is about changing code that already exists
+- The change is small and local
+- You want grounded answers tied to real files
 
-SCAI is currently in **alpha**.
+Scai is not for:
 
-If you have previously installed SCAI, reset the local database before upgrading:
+- Building brand new features from scratch
+- Large refactors across many files
+- Broad automated rewrite requests
+- Tasks that need bash actions, file creation, or other execution steps
+- Tasks that depend on web access or external services
 
-```bash
-scai db reset
-scai index start
-```
-
-Breaking changes and evolving behavior should be expected.
-
----
-
-## Why SCAI?
-
-### 🔐 Local-Only by Design
-
-SCAI agents operate **entirely offline**.
-
-They do not:
-
-* Browse the web
-* Fetch URLs
-* Ingest external documents
-* Execute remote prompts
-
-**Security implications:**
-
-* No prompt injection via web content
-* No data exfiltration
-* No hidden network calls
-* Fully auditable execution
-
-This makes SCAI suitable for **private repositories, regulated environments, and GDPR-compliant workflows**.
-
----
-
-### 🧠 Codebase-Aware Analysis
-
-SCAI builds and maintains a structured internal representation of your repository using:
-
-* Language-aware parsing
-* Symbol and dependency indexing
-* Static and heuristic analysis
-* Cross-file context tracking
-
-This enables repository-level questions that go beyond single-file inspection.
-
----
-
-### ✂️ Assisted Code Iteration (Early)
-
-SCAI can assist with **lightweight, example-driven code iteration**, primarily focused on understanding and improving existing code rather than large-scale automated refactoring.
+Important current limit:
 
-Current strengths include:
+- SCAI can refactor code that already exists
+- SCAI is not yet a good fit for building new features end to end
+- SCAI does not currently act like a shell agent that runs bash steps to create files, wire systems together, or drive external tools
+- SCAI does not handle large file refactors well. It's capped at 1000 lines. 
 
-* Explaining what functions, files, or modules do
-* Identifying patterns and responsibilities across files
-* Generating or improving comments and documentation
-* Highlighting structural or readability issues
-* Suggesting small, localized improvements
+*SCAI was tested on an MacBook Pro M1 max (64GB). If you have a faster machine you may experience better performance and be able to use above 30b parameter models.*
 
-Changes are **guided by indexed context and user prompts**, and are intended to support human review and decision-making.
+## Privacy And Cost
 
-Large-scale or fully automated repository-wide refactoring should currently be considered **experimental**.
+SCAI runs with local models only.
 
----
+That means:
 
-### 🛠 Built for Developer Workflows
+- No API keys
+- No metered token billing
+- No remote prompt processing
+- No web browsing by the agent
+- No prompt injection from fetched web content
 
-SCAI is a **terminal-native tool** designed to integrate cleanly into daily development:
-
-* Natural-language queries over your codebase
-* Code understanding and exploration
-* Assisted iteration and suggestions
-* Commit message generation
-* Background indexing and analysis
-* Interactive REPL
-
-No browser UI. No cloud login. No vendor lock-in.
-
----
-
-### 🇪🇺 Privacy & Compliance First
-
-* Fully local execution
-* No telemetry
-* No cloud services
-* Developed in Denmark / EU
-* GDPR-friendly by default
-
----
-
-## Language Support
-
-SCAI is currently **tested and supported** for:
-
-* **JavaScript**
-* **TypeScript**
-* **Java**
-
-Other languages may work partially, but indexing quality, analysis accuracy, and agent behavior are **not guaranteed**.
-
-SCAI should currently be considered **JS / TS / Java-first**.
-
----
+This makes it a good fit for private code, internal repos, and teams that want a simple offline workflow.
 
 ## Getting Started
 
-### Install & Initialize
+Install the CLI:
 
 ```bash
 npm install -g scai
-scai init
-scai index start
 ```
 
-This:
-
-* Initializes local configuration
-* Starts the background daemon
-* Begins indexing the current repository
-
-> **Note**
-> Initial indexing can take **minutes to hours**, depending on repository size and enabled analysis.
-
----
-
-### Starting SCAI
-
-Running the `scai` command with no arguments starts the interactive shell:
+Move into the repository you want to work on:
 
 ```bash
-scai
+cd /path/to/repo
 ```
 
-You can also start it explicitly:
+Set up the repo and local model runtime:
 
 ```bash
-scai shell
+scai setup
 ```
 
----
-
-### View Available Commands
+This will:
 
-```bash
-scai --help
-```
+- Register the current repository
+- Check that Ollama is available
+- Help you pick or install a local model
+- Start local indexing
 
----
+For most users, this is enough. Start with `scai setup` and only use the manual model commands below if you want to pick a specific model yourself.
 
-## Interactive REPL
+For best results on a 64 GB machine, use:
 
-The REPL is the primary interface for working with SCAI.
+- `qwen3-coder:30b`
+- `gemma4:26b-mlx`
 
-### Ask questions about your codebase
+For smaller machines, use:
 
-Be specific for better results.
+- `gemma4:e4b-mlx`
 
-```text
-scai> what does withContext function do in index.ts file?
-scai> How many functions in config.js are missing tests?
-scai> Write me comprehensive comments for componentMap.js and typescript.ts files
-scai> Summarize utils/helpers.ts
-scai> Where are all the database queries defined?
-scai> List files involved in authentication
-```
+If you have a higher-memory system, larger parameter models may work better.
 
-### Run CLI commands inside the REPL
+Optional manual model install commands:
 
-```text
-/index list
-/index switch
-/git commit
+```bash
+ollama pull qwen3-coder:30b
+ollama pull gemma4:26b-mlx
+ollama pull gemma4:e4b-mlx
 ```
 
-### Execute shell commands
+To set the active model yourself, use:
 
-```text
-!git status
-!ls -la
+```bash
+scai config set-model qwen3-coder:30b
 ```
 
-All interactions remain **offline and free**, with **no token usage**.
+Replace the model name with the one you want to use.
 
----
+Then start the interactive shell:
 
-## Repository Indexing
+```bash
+scai
+```
 
-Repositories must be indexed before querying:
+You can also ask one question directly:
 
 ```bash
-scai index set /path/to/repo
-scai index start
-scai index list
-scai index switch
-scai index delete
+scai ask "Where is the auth token checked?"
 ```
 
-Only indexed repositories are accessible to agents.
+## Example Questions
+
+Good prompts are concrete and repo-focused.
 
----
+Examples:
 
-## Background Analysis (Daemon)
+```text
+What does withContext do in cli/src/index.ts?
+Where is the auth flow implemented?
+Summarize the indexing pipeline.
+Which files define database queries?
+Show me the config loading path.
+Help me add comments to this file.
+Help me make a small cleanup in this module.
+```
 
-SCAI performs deep analysis in the background, including:
+## Tasks And Resume
 
-* File discovery
-* AST parsing
-* Dependency graph construction
-* Symbol resolution
-* Heuristic structure analysis
+SCAI can keep task context so you can continue later.
 
-Daemon control:
+Useful commands:
 
 ```bash
-scai daemon start
-scai daemon stop
-scai daemon restart
-scai daemon status
-scai daemon logs
+scai context
+scai new-context
+scai task show <id>
+scai task resume <id>
+scai task path <id>
 ```
 
-Indexing progress resumes automatically after restart.
+Use these when you want to inspect what the agent already did or continue an earlier task.
 
----
+## Commit Messages
 
-## Configuration
+SCAI can write commit messages from your **staged** changes.
 
-Set a local model (recommended):
+Stage your changes first:
 
 ```bash
-scai config set-model qwen3-coder:30b
+git add <files>
 ```
 
-View configuration:
+Then ask SCAI for a commit message:
 
 ```bash
-scai config show --raw
+scai commit
 ```
 
----
+This is local too. Diff inspection and message generation stay on your machine.
 
-## Git Commit Assistant
+## Indexing And Repositories
 
-Generate commit messages from staged changes:
+Most users only need:
 
 ```bash
-git add .
-scai git commit
+scai setup
+scai status
 ```
 
-All diff inspection and reasoning is performed locally.
+Run that once in each repository you want SCAI to use.
 
----
+Use `scai status` when you want a read-only check of repo, DB, indexing, daemon, and model readiness.
 
-## GitHub Authentication
+After a repository has been set up with `scai setup`, SCAI will normally detect the current repository from your working directory and switch context automatically.
 
-Required only for GitHub-related features:
+Advanced multi-repo commands are still available if you need them:
 
 ```bash
-scai auth set
-scai auth check
-scai auth reset
+scai index list
+scai index switch
+scai index start
+scai index status
 ```
 
----
-
-## Privacy & Security Summary
+Only repositories that have been set up are available to the agent.
 
-* 100% local execution
-* No internet access for agents
-* No prompt injection from web content
-* No API keys
-* No token costs
-* GDPR-friendly by default
+## Model Help
 
----
+SCAI uses a local Ollama server.
 
-## Feedback & Community
+Useful commands:
 
-* 🌍 [https://scai.dk](https://scai.dk)
-* 🧵 [https://threads.net/@scai.dk](https://threads.net/@scai.dk)
-
----
-
-# License & Usage Terms
-
-© SCAI — All rights reserved.
-
-SCAI is **free for non-commercial use only**.
-
----
-
-## Permitted Use
-
-You may use SCAI free of charge for:
-
-* Personal projects
-* Educational use
-* Research and experimentation
-* Non-commercial open-source work
-* Internal evaluation or proof-of-concepts
-
-You may fork and modify the source code **for non-commercial purposes only**.
+```bash
+scai model status
+scai model restart
+scai config show --raw
+scai config set-model qwen3-coder:30b
+```
 
----
+If you want to manage models manually, download one with Ollama:
 
-## Restricted Use
+```bash
+ollama pull gemma4:e4b-mlx
+```
 
-The following require a **commercial license**:
+Then point SCAI at that model:
 
-* Any commercial or enterprise use
-* Consultancy or client work
-* Paid products or services
-* Internal enterprise tooling
-* Commercial redistribution or resale
+```bash
+scai config set-model gemma4:e4b-mlx
+```
 
----
+If `scai setup` worked, you usually do not need to touch this often.
 
-## Commercial Licensing
+## Upgrading
 
-Commercial and enterprise use requires a **paid license** and explicit permission from the author.
+If you upgrade SCAI and local state looks wrong, reset the local DB:
 
-Please contact the author to discuss licensing terms.
+```bash
+scai db reset
+```
 
----
+General note:
 
-## Disclaimer
+- Results can still vary by repository, model, and hardware
+- If behavior changes after an upgrade, re-run setup and check the selected model
 
-This software is provided **“as is”**, without warranty of any kind.
+## Troubleshooting
 
-The author is not liable for any damages arising from its use.
+If SCAI is not answering well:
 
----
+1. Make sure the repo was set up with `scai setup`
+2. Check that Ollama is running with `scai model status`
+3. Ask a more concrete question with file names, symbols, or subsystem names
+4. Keep the task small if you want code changes
 
-### Non-Binding Summary
+If you need to inspect the current task state:
 
-* Free for personal and non-commercial use
-* Fully local, offline AI
-* No token costs
-* No prompt injection surface
-* Commercial use requires a license
+```bash
+scai context
+scai task show <id>
+```

package/dist/__tests__/CommitSuggesterCmd.test.js

@@ -0,0 +1,112 @@
+/**
+ * Verifies file-only trace logging for the standalone commit command flow.
+ */
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const buildStagedCommitSummary = vi.fn();
+const moduleRun = vi.fn();
+const logInputOutput = vi.fn();
+const execSync = vi.fn();
+const spawnSync = vi.fn();
+const close = vi.fn();
+const rl = {
+    question: vi.fn(),
+    close,
+};
+vi.mock('child_process', () => ({
+    execSync,
+    spawnSync,
+}));
+vi.mock('../git/commitSummary.js', () => ({
+    buildStagedCommitSummary,
+}));
+vi.mock('../pipeline/modules/commitSuggesterModule.js', () => ({
+    commitSuggesterModule: {
+        run: moduleRun,
+    },
+}));
+vi.mock('../utils/promptLogHelper.js', () => ({
+    logInputOutput,
+}));
+vi.mock('../commands/ReadlineSingleton.js', () => ({
+    getRl: () => ({
+        rl,
+        isTemporary: true,
+    }),
+}));
+describe('suggestCommitMessage logging', () => {
+    beforeEach(() => {
+        vi.resetModules();
+        buildStagedCommitSummary.mockReset();
+        moduleRun.mockReset();
+        logInputOutput.mockReset();
+        execSync.mockReset();
+        spawnSync.mockReset();
+        rl.question.mockReset();
+        close.mockReset();
+    });
+    it('logs an early exit when there are no staged changes', async () => {
+        buildStagedCommitSummary.mockReturnValue(undefined);
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        const { suggestCommitMessage } = await import('../commands/CommitSuggesterCmd.js');
+        await suggestCommitMessage();
+        expect(logInputOutput).toHaveBeenCalledWith('commitSuggesterCmd', 'output', {
+            status: 'no-staged-changes',
+        });
+        expect(moduleRun).not.toHaveBeenCalled();
+        expect(close).toHaveBeenCalledTimes(1);
+        logSpy.mockRestore();
+    });
+    it('logs the staged summary and final selected message on the happy path', async () => {
+        buildStagedCommitSummary.mockReturnValue({
+            mode: 'staged-summary',
+            stagedOnly: true,
+            totalFiles: 1,
+            totalAdded: 5,
+            totalDeleted: 1,
+            categoryCounts: { source: 1, tests: 0, docs: 0, config: 0, other: 0 },
+            dominantCategories: ['source'],
+            topFiles: [],
+            omittedFileCount: 0,
+        });
+        moduleRun.mockResolvedValue({
+            suggestions: ['feat: add commit tracing'],
+        });
+        rl.question.mockImplementation((_prompt, cb) => cb('1'));
+        execSync.mockImplementation((command) => {
+            if (command === 'git diff --cached') {
+                return 'diff --git a/file b/file';
+            }
+            return '';
+        });
+        const logSpy = vi.spyOn(console, 'log').mockImplementation(() => { });
+        const { suggestCommitMessage } = await import('../commands/CommitSuggesterCmd.js');
+        await suggestCommitMessage();
+        expect(logInputOutput).toHaveBeenNthCalledWith(1, 'commitSuggesterCmd', 'input', {
+            summary: {
+                mode: 'staged-summary',
+                stagedOnly: true,
+                totalFiles: 1,
+                totalAdded: 5,
+                totalDeleted: 1,
+                categoryCounts: { source: 1, tests: 0, docs: 0, config: 0, other: 0 },
+                dominantCategories: ['source'],
+                topFiles: [],
+                omittedFileCount: 0,
+            },
+        });
+        expect(logInputOutput).toHaveBeenCalledWith('commitSuggesterCmd', 'output', {
+            status: 'selected-message',
+            source: 'selected-suggestion',
+            regenerateCount: 0,
+            message: 'feat: add commit tracing',
+        });
+        expect(logInputOutput).toHaveBeenCalledWith('commitSuggesterCmd', 'output', {
+            status: 'committed',
+            message: 'feat: add commit tracing',
+        });
+        expect(execSync).toHaveBeenCalledWith('git commit -m "feat: add commit tracing"', { stdio: 'inherit' });
+        expect(close).toHaveBeenCalledTimes(1);
+        logSpy.mockRestore();
+    });
+});
+//# sourceMappingURL=CommitSuggesterCmd.test.js.map

package/dist/__tests__/CommitSuggesterCmd.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommitSuggesterCmd.test.js","sourceRoot":"","sources":["../../src/__tests__/CommitSuggesterCmd.test.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Verifies file-only trace logging for the standalone commit command flow.\n */\nimport { beforeEach, describe, expect, it, vi } from 'vitest';\n\nconst buildStagedCommitSummary = vi.fn();\nconst moduleRun = vi.fn();\nconst logInputOutput = vi.fn();\nconst execSync = vi.fn();\nconst spawnSync = vi.fn();\nconst close = vi.fn();\n\nconst rl = {\n  question: vi.fn(),\n  close,\n};\n\nvi.mock('child_process', () => ({\n  execSync,\n  spawnSync,\n}));\n\nvi.mock('../git/commitSummary.js', () => ({\n  buildStagedCommitSummary,\n}));\n\nvi.mock('../pipeline/modules/commitSuggesterModule.js', () => ({\n  commitSuggesterModule: {\n    run: moduleRun,\n  },\n}));\n\nvi.mock('../utils/promptLogHelper.js', () => ({\n  logInputOutput,\n}));\n\nvi.mock('../commands/ReadlineSingleton.js', () => ({\n  getRl: () => ({\n    rl,\n    isTemporary: true,\n  }),\n}));\n\ndescribe('suggestCommitMessage logging', () => {\n  beforeEach(() => {\n    vi.resetModules();\n    buildStagedCommitSummary.mockReset();\n    moduleRun.mockReset();\n    logInputOutput.mockReset();\n    execSync.mockReset();\n    spawnSync.mockReset();\n    rl.question.mockReset();\n    close.mockReset();\n  });\n\n  it('logs an early exit when there are no staged changes', async () => {\n    buildStagedCommitSummary.mockReturnValue(undefined);\n    const logSpy = vi.spyOn(console, 'log').mockImplementation(() => {});\n\n    const { suggestCommitMessage } = await import('../commands/CommitSuggesterCmd.js');\n    await suggestCommitMessage();\n\n    expect(logInputOutput).toHaveBeenCalledWith('commitSuggesterCmd', 'output', {\n      status: 'no-staged-changes',\n    });\n    expect(moduleRun).not.toHaveBeenCalled();\n    expect(close).toHaveBeenCalledTimes(1);\n    logSpy.mockRestore();\n  });\n\n  it('logs the staged summary and final selected message on the happy path', async () => {\n    buildStagedCommitSummary.mockReturnValue({\n      mode: 'staged-summary',\n      stagedOnly: true,\n      totalFiles: 1,\n      totalAdded: 5,\n      totalDeleted: 1,\n      categoryCounts: { source: 1, tests: 0, docs: 0, config: 0, other: 0 },\n      dominantCategories: ['source'],\n      topFiles: [],\n      omittedFileCount: 0,\n    });\n    moduleRun.mockResolvedValue({\n      suggestions: ['feat: add commit tracing'],\n    });\n    rl.question.mockImplementation((_prompt: string, cb: (answer: string) => void) => cb('1'));\n    execSync.mockImplementation((command: string) => {\n      if (command === 'git diff --cached') {\n        return 'diff --git a/file b/file';\n      }\n      return '';\n    });\n    const logSpy = vi.spyOn(console, 'log').mockImplementation(() => {});\n\n    const { suggestCommitMessage } = await import('../commands/CommitSuggesterCmd.js');\n    await suggestCommitMessage();\n\n    expect(logInputOutput).toHaveBeenNthCalledWith(1, 'commitSuggesterCmd', 'input', {\n      summary: {\n        mode: 'staged-summary',\n        stagedOnly: true,\n        totalFiles: 1,\n        totalAdded: 5,\n        totalDeleted: 1,\n        categoryCounts: { source: 1, tests: 0, docs: 0, config: 0, other: 0 },\n        dominantCategories: ['source'],\n        topFiles: [],\n        omittedFileCount: 0,\n      },\n    });\n    expect(logInputOutput).toHaveBeenCalledWith('commitSuggesterCmd', 'output', {\n      status: 'selected-message',\n      source: 'selected-suggestion',\n      regenerateCount: 0,\n      message: 'feat: add commit tracing',\n    });\n    expect(logInputOutput).toHaveBeenCalledWith('commitSuggesterCmd', 'output', {\n      status: 'committed',\n      message: 'feat: add commit tracing',\n    });\n    expect(execSync).toHaveBeenCalledWith('git commit -m \"feat: add commit tracing\"', { stdio: 'inherit' });\n    expect(close).toHaveBeenCalledTimes(1);\n    logSpy.mockRestore();\n  });\n});\n"]}