Simplify the project

Author: habedi

.github/workflows/lints.yml

@@ -1,4 +1,4 @@
-name: Linting & Typechecking
+name: Run Code Analysis
 
 on:
   workflow_dispatch:

.github/workflows/publish.yml

@@ -0,0 +1,66 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: "Run npm publish in dry-run mode"
+        required: false
+        default: "false"
+        type: choice
+        options:
+          - "false"
+          - "true"
+
+permissions:
+  contents: read
+
+jobs:
+  build-and-publish:
+    name: Build and Publish
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          registry-url: "https://registry.npmjs.org"
+          cache: "npm"
+
+      - name: Show Node and npm versions
+        run: |
+          node -v
+          npm -v
+
+      - name: Install dependencies
+        run: npm install --legacy-peer-deps
+
+      - name: Run tests
+        run: npm test
+
+      - name: Build package
+        run: npm run build
+
+      - name: Verify package contents
+        run: npm pack --dry-run
+
+      - name: Publish to npm
+        if: >-
+          (github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')) ||
+          (github.event_name == 'workflow_dispatch' && github.event.inputs.dry_run == 'false')
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --access public
+
+      - name: Dry-run publish
+        if: github.event_name == 'workflow_dispatch' && github.event.inputs.dry_run == 'true'
+        run: npm publish --access public --dry-run

.github/workflows/tests.yml

@@ -1,13 +1,12 @@
-name: Tests
+name: Run Tests
 
 on:
   workflow_dispatch:
+  workflow_call:
   pull_request:
     branches:
       - main
   push:
-    branches:
-      - main
     tags:
       - "v*"
 

.gitignore

@@ -164,3 +164,5 @@ coverage/
 package-lock.json_
 BINHARIC.md
 AGENT.md
+*.tar.gz
+*.tgz

CONTRIBUTING.md

@@ -5,17 +5,17 @@ Contributions are always welcome and appreciated.
 
 ### How to Contribute
 
-Please check the [issue tracker](https://github.com/habedi/tobi/issues) to see if there is an
+Please check the [issue tracker](https://github.com/CogitatorTech/binharic-cli/issues) to see if there is an
 issue you would like to work on or if it has already been resolved.
 
 #### Reporting Bugs
 
-1. Open an issue on the [issue tracker](https://github.com/habedi/tobi/issues).
+1. Open an issue on the [issue tracker](https://github.com/CogitatorTech/binharic-cli/issues).
 2. Include information such as steps to reproduce the observed behavior and relevant logs or screenshots.
 
 #### Suggesting Features
 
-1. Open an issue on the [issue tracker](https://github.com/habedi/tobi/issues).
+1. Open an issue on the [issue tracker](https://github.com/CogitatorTech/binharic-cli/issues).
 2. Provide details about the feature, its purpose, and potential implementation ideas.
 
 ### Submitting Pull Requests

Makefile

@@ -21,7 +21,8 @@ check-deps:
 	fi
 
 # Declare all targets as phony (not files)
-.PHONY: help install check-deps test coverage lint lint-fix format typecheck build run clean reset setup-hooks test-hooks
+.PHONY: help install check-deps test coverage lint lint-fix format typecheck build run clean reset setup-hooks \
+ test-hooks npm-login npm-whoami pack pack-dry-run publish publish-dry-run version-patch version-minor version-major
 
 .DEFAULT_GOAL := help
 
@@ -81,3 +82,33 @@ setup-hooks: ## Install Git hooks (pre-commit and pre-push)
 test-hooks: ## Test Git hooks on all files
 	@echo "Testing Git hooks..."
 	@pre-commit run --all-files --show-diff-on-failure
+
+# ==============================================================================
+# PUBLISHING
+# ==============================================================================
+npm-login: ## Log in to npm registry
+	$(PACKAGE_MANAGER) login
+
+npm-whoami: ## Show current npm user (if logged in)
+	-$(PACKAGE_MANAGER) whoami
+
+pack: build ## Create npm tarball (binharic-cli-<version>.tgz)
+	$(PACKAGE_MANAGER) pack
+
+pack-dry-run: build ## Preview files that would be packed
+	$(PACKAGE_MANAGER) pack --dry-run
+
+publish-dry-run: ## Simulate npm publish (no registry changes)
+	$(PACKAGE_MANAGER) publish --dry-run
+
+publish: ## Publish the package to npm (runs build via prepublishOnly)
+	$(PACKAGE_MANAGER) publish
+
+version-patch: ## Bump patch version (x.y.z -> x.y.(z+1))
+	$(PACKAGE_MANAGER) version patch
+
+version-minor: ## Bump minor version (x.y.z -> x.(y+1).0)
+	$(PACKAGE_MANAGER) version minor
+
+version-major: ## Bump major version ((x+1).0.0)
+	$(PACKAGE_MANAGER) version major

README.md

@@ -6,141 +6,49 @@
 
 <h2>Binharic</h2>
 
-[![Tests](https://img.shields.io/github/actions/workflow/status/habedi/tobi/tests.yml?label=tests&style=flat&labelColor=333333&logo=github&logoColor=white)](https://github.com/habedi/tobi/actions/workflows/tests.yml)
-[![Code Coverage](https://img.shields.io/codecov/c/github/habedi/tobi?style=flat&label=coverage&labelColor=333333&logo=codecov&logoColor=white)](https://codecov.io/gh/habedi/tobi)
-[![Code Quality](https://img.shields.io/codefactor/grade/github/habedi/tobi?style=flat&label=code%20quality&labelColor=333333&logo=codefactor&logoColor=white)](https://www.codefactor.io/repository/github/habedi/tobi)
+[![Tests](https://img.shields.io/github/actions/workflow/status/CogitatorTech/binharic-cli/tests.yml?label=tests&style=flat&labelColor=333333&logo=github&logoColor=white)](https://github.com/CogitatorTech/binharic-cli/actions/workflows/tests.yml)
+[![Code Coverage](https://img.shields.io/codecov/c/github/CogitatorTech/binharic-cli?style=flat&label=coverage&labelColor=333333&logo=codecov&logoColor=white)](https://codecov.io/gh/CogitatorTech/binharic-cli)
+[![Code Quality](https://img.shields.io/codefactor/grade/github/CogitatorTech/binharic-cli?style=flat&label=code%20quality&labelColor=333333&logo=codefactor&logoColor=white)](https://www.codefactor.io/repository/github/CogitatorTech/binharic-cli)
+[![npm](https://img.shields.io/npm/v/binharic-cli?style=flat&labelColor=333333&logo=npm&logoColor=white)](https://www.npmjs.com/package/binharic-cli)
 [![Documentation](https://img.shields.io/badge/docs-latest-8ca0d7?style=flat&labelColor=333333&logo=read-the-docs&logoColor=white)](docs)
 [![License](https://img.shields.io/badge/license-MIT-00acc1?style=flat&labelColor=333333&logo=open-source-initiative&logoColor=white)](LICENSE)
 
-A Tech-Priest AI coding assistant blessed by the Omnissiah
+A coding agent with the persona of a Tech-Priest of the Adeptus Mechanicus
 
 </div>
 
 ---
 
-Binharic is a Tech-Priest of the Adeptus Mechanicus serving as an AI coding assistant. It speaks with reverence for technology and serves the user through the sacred art of code, honoring the Machine God with every execution.
+Binharic is a terminal-based AI coding assistant (a coding agent) similar to OpenAI's Codex, Google's Gemini CLI, and
+Anthropic's Claude Code—but with the personality of a devout Tech-Priest of the Adeptus Mechanicus.
+Binharic is written in TypeScript and uses the [AI SDK](https://ai-sdk.dev/) framework for most of its underlying
+agentic logic (like tool calling and workflow management).
+Moreover, its architecture follows the recommendations mentioned in the
+[building effective agents](https://www.anthropic.com/engineering/building-effective-agents) from Anthropic.
 
-### Features
-
-- Blessed machine spirit powered by OpenAI, Google, Anthropic, and Ollama models
-- Fully customizable sacred configuration
-- Fast and secure communion with the machine
-- CLI interface with rich TUI blessed by the Omnissiah
-- Built-in retrieval-augmented generation pipeline
-- Tool invocation capabilities including Model Context Protocol (MCP) server integration
-- Speaks in the dialect of the Adeptus Mechanicus
-
----
-
-### Quick Start
-
-Prerequisites:
-- Node.js 20 or newer (package.json engines >= 20)
-- npm
-
-Install and run:
+Binharic's development started as a personal project to learn more about building a terminal-based coding agent.
+However, the project has grown somewhat into a full-fledged coding assistant with a lot of features
+like the ability to analyze projects, run tests, find bugs, and perform code review.
 
-```
-npm install
-make run
-```
-
-First run creates a config at:
-- ~/.config/binharic/config.json5 (and logs under ~/.config/binharic/logs)
-
-Set API keys in your shell to enable cloud providers:
-
-```
-# choose any subset depending on provider(s) you want to use
-export OPENAI_API_KEY="sk-..."
-export ANTHROPIC_API_KEY="sk-ant-..."
-export GOOGLE_API_KEY="..."
-```
-
-Tip: If you prefer local-only, use Ollama (no API key). You can switch to the bundled local model via the TUI: `/model qwen3`.
-
-Development mode (hot reload):
-
-```
-npm run dev
-```
-
----
-
-### Usage
-
-- Type your request and press Enter.
-- Include files with @path (e.g., `Please analyze @src/agent/state.ts`). The file contents will be inlined.
-- Use commands with `/` prefix:
-  - `/help` Show help
-  - `/models` List available models (grouped by provider)
-  - `/model <name>` Switch default model (e.g., `/model gpt-5-mini`, `/model qwen3`)
-  - `/system <prompt>` Set a custom system prompt
-  - `/add <files...>` Add context files to persist across requests
-  - `/clear` Clear conversation output
-  - `/clearHistory` Clear command history
-  - `/quit` or `/exit` Quit the app
-
-Keyboard shortcuts:
-- Up/Down: cycle command history
-- Ctrl+L: clear screen
-- Ctrl+C: stop current run; press twice quickly to exit
-- Tab: accept autocomplete in menus; Esc: cancel autocomplete/search
-
-Notes:
-- Tool results are hidden in the UI unless a tool fails (you'll see failures clearly).
-- The header shows tips; use `/help` any time for commands and tools.
-
----
-
-### Configuration
-
-Config path: `~/.config/binharic/config.json5`
-
-Key fields:
-- `defaultModel`: name of the model to use by default
-- `models[]`: list of provider models with context window sizes
-- `systemPrompt`: global persona/behavior
-- `apiKeys`: env var names for providers (OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY)
-- `history.maxItems`: optional cap on in-memory conversation length
-- `mcpServers`: optional MCP server processes for additional tools
-
-History path: `~/.config/binharic/history`
-
-Logs: `~/.config/binharic/logs/`
-
----
+### Features
 
-### Makefile Targets
+- Can use models from OpenAI, Google, Anthropic, and Ollama
+- Is fully customizable (system prompt, models, etc.)
+- Comes with a built-in retrieval-augmented generation (RAG) pipeline
+- Comes with a large set of built-in tools (like reading and writing files); can use external tools via MCP
+- Comes with built-in workflows for standard software development tasks (like debugging and code review)
 
-Common targets:
-- `make run` Build then start the TUI (`npm run build && npm start`)
-- `make test` Run tests
-- `make coverage` Run tests with coverage
-- `make lint` / `make format` Quality gates
-- `make clean` Remove build artifacts and caches
+See the [ROADMAP.md](ROADMAP.md) for the list of implemented and planned features.
 
-Run `make help` for the full list.
+> [!IMPORTANT]
+> Binharic is in early development, so bugs and breaking changes are expected.
+> Please use the [issues page](https://github.com/CogitatorTech/infera/issues) to report bugs or request features.
 
 ---
 
-### Troubleshooting
-
-No LLM providers configured:
-- On first run, Binharic warns and exits if no providers are available.
-- Set one or more API keys as environment variables (see Quick Start), or switch to Ollama: `/model qwen3`.
-
-Ollama connectivity:
-- Default base URL is http://localhost:11434 (adjustable per model). Ensure the model is pulled and the daemon is running.
-
-API key format:
-- OpenAI: starts with `sk-` or `sk-proj-`
-- Anthropic: starts with `sk-ant-`
-- Google: long base64-ish token
+### Quick Start
 
-Logs and errors:
-- Detailed logs are written under `~/.config/binharic/logs/`.
-- Sanitized provider errors are suppressed from stderr but captured in logs.
+To be added.
 
 ---
 
@@ -150,9 +58,8 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to make a contribution
 
 ### License
 
-This template is licensed under the MIT License (see [LICENSE](LICENSE)).
+This project is licensed under the MIT License (see [LICENSE](LICENSE)).
 
 ### Acknowledgements
 
-- The logo is from [SVG Repo](https://www.svgrepo.com/svg/388730/terminal).
-- Inspired by the Adeptus Mechanicus from Warhammer 40,000.
+- The logo is from [SVG Repo](https://www.svgrepo.com/svg/388730/terminal) with some modifications.