@kolisachint/hoocode 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2025 Mario Zechner (original "pi-mono" project — https://github.com/badlogic/pi-mono and https://github.com/earendil-works/pi-mono)
+Copyright (c) 2026 Sachin Koli (HooCode fork — https://github.com/kolisachint/cortexcode)
+
+This project ("cortexcode") is a Rust migration of the HooCode / pi-mono project by
+Mario Zechner. All upstream copyright and authorship is preserved. Modifications
+and additions made in this fork are released under the same MIT terms below.
+
+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

@@ -1,3 +1,184 @@
-# Temporary Holding Version
+# cortexcode
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Rust migration of the [HooCode](https://github.com/kolisachint/hoocode-ts) TypeScript coding-agent framework.
+
+This is a multi-crate workspace that mirrors the structure of the [pycortex](https://github.com/kolisachint/pycortex) Python migration. Each namespace (`ai`, `agent`, `code`, `tui`) is split into focused, version-locked crates published to crates.io.
+
+## Workspace structure
+
+```
+crates/
+  cortexcode/              # Top-level umbrella crate
+  cortexcode-ai/           # AI namespace umbrella
+  cortexcode-ai-types/
+  cortexcode-ai-models/
+  ...
+  cortexcode-agent/        # Agent namespace umbrella
+  cortexcode-agent-core/
+  ...
+  cortexcode-code/         # Code namespace umbrella
+  ...
+  cortexcode-tui/          # TUI namespace umbrella
+  ...
+```
+
+All crates share a single lockstep version defined in the workspace `Cargo.toml`.
+
+## Installation
+
+**macOS / Linux** (no root, no Node):
+
+```bash
+curl -fsSL https://kolisachint.github.io/hoocode/install.sh | sh
+```
+
+It installs `~/.hoocode/bin/hoocode` (and `hoo`), checks the download against the
+release's `SHA256SUMS`, and adds `~/.hoocode/bin` to `PATH`. `--help` lists the
+options (`--version`, `--dir`, `--no-modify-path`).
+
+**npm / bun:**
+
+```bash
+npm install -g @kolisachint/hoocode     # or: bun add -g @kolisachint/hoocode
+```
+
+The package pulls in only the binary for your platform (macOS or Linux, x64 or
+arm64). There is no Windows build; on Windows use the TypeScript build,
+[hoocode-ts](https://github.com/kolisachint/hoocode-ts).
+
+### From source
+
+### Command names: `hoocode` and `hoocode-ts`
+
+This Rust build is installed as **`hoocode`**. The TypeScript original is reached as
+**`hoocode-ts`**, a small shim (`scripts/shims/hoocode-ts`) that runs the npm package
+`@kolisachint/hoocode-agent` (a global npm install if present, otherwise `npx`; set
+`HOOCODE_TS_BIN` to point it anywhere else). Only the installed names changed: the crates,
+the cargo binary (`cortex`), the config directory and the in-app name are unchanged. If you
+also have the TS one installed globally from npm, put the Rust `hoocode` earlier on `PATH`
+(npm's `hoo` alias still runs the TS one).
+
+```bash
+git clone https://github.com/kolisachint/cortexcode
+cd cortexcode
+scripts/install.sh                     # → ~/.local/bin/hoocode and hoocode-ts
+scripts/install.sh --prefix /usr/local/bin --also-cortex   # also keep a `cortex` link
+```
+
+Plain cargo still works and installs the binary as `cortex`:
+`cargo install --path crates/cortexcode-code-main --bin cortex`.
+
+### Pre-built binaries
+
+Download `hoocode-<target>.tar.gz` from the
+[GitHub Releases](https://github.com/kolisachint/hoocode/releases) page and check it
+against `SHA256SUMS`. It holds the `hoocode` binary and the `hoocode-ts` shim; put both
+on your `PATH`. Linux builds are static (musl) and run on any distro.
+
+## Usage
+
+```bash
+# Single-shot print mode (text or JSON)
+cortex -p "Explain this codebase"
+cortex -p --mode json "Explain this codebase"
+
+# Interactive TUI mode
+cortex
+
+# JSON-RPC server mode
+cortex --mode rpc
+
+# Subagent mode (used internally by the Task tool)
+cortex --mode subagent --task-id <id>
+```
+
+## Development
+
+```bash
+# Build the entire workspace
+cargo build
+
+# Run checks for all crates
+cargo check --workspace
+
+# Run all tests (CI uses nextest; `cargo test --workspace` works too)
+scripts/ci/fetch_hoocode_fixtures.sh   # pinned hoocode fixtures a few tests read
+cargo nextest run --workspace
+```
+
+### Releases
+
+Label a PR `rust:patch`, `rust:minor` or `rust:major`; merging it runs the release:
+CI gates (parallel) → version bump, tag and GitHub release → binaries for 4 targets in
+parallel, each uploaded as soon as it is built. Optional labels: `release:skip-gates`
+(skip the gates, the PR's CI already passed) and `release:crates` (also publish to
+crates.io, off by default). Manual runs: Actions → Release.
+
+## Migration status (paused 2026-10-01, ready to use)
+
+The port of hoocode **v0.5.89** (commit `a6cd96e7`) is paused, and `cortex` is usable as a
+daily coding agent. Phases 7, 8 and 11 are complete. Phase 10 is complete apart from the
+deferred items listed below. Every remaining task is **deferred** by user decision; none is
+in progress. Status per task: `python3 migration/ledger.py status`.
+
+What works (the pinned hoocode behavior, checked against hoocode itself):
+
+- **Modes:** interactive TUI, print mode (`-p`, text and `--mode json`), and `--mode rpc`
+  (with a Rust `RpcClient`).
+- **Providers:** every catalog provider, plus OAuth logins (`/login`) and `models.json`.
+- **Sessions:** AgentSession with compaction, `/new`, `/resume`, `/fork`, `/tree`,
+  `--continue`, `--session`, and `/export <file>.jsonl`.
+- **Tools:** read, bash, edit, write, lexical SearchCodebase, TodoWrite, ask_options, and the
+  Yes/No/Always permission prompt.
+- **Agent modes:** ask/plan/build/debug (`/mode`, `/plan`, `/grill`, `/approve`, alt+a).
+- **Subagents:** the Task/TaskOutput tools, the task panel, and the subagent roster.
+- **Resources:** skills, prompt templates and slash commands, AGENTS.md/CLAUDE.md context
+  files, themes, settings (`/settings`) and keybindings.
+
+Deferred (not available yet, even though `--help` still lists some of them):
+
+| Area | Ledger task |
+|---|---|
+| MCP servers (`mcp.json`, stdio/HTTP/SSE, OAuth) | 9.1, 10.11 |
+| `webfetch` / `websearch` (`--enable-webtools`) | 10.2e |
+| Plugins and marketplace (`--enable-plugintools`) | 12.1 |
+| `cortex install/remove/update/list` package manager | 12.2 |
+| Code extensions (`-e`, extension flags) | 12.3 |
+| Semantic and hybrid search (`embsearch`). Search is lexical-only. | 12.4 |
+| `/loop`, `/goal` autonomous loop, cron/scheduler | 12.5 |
+| Warm subagent pool (`--warm-subagents`) | 12.6 |
+| HTML export and `/share`, `/learn`, canvas, `--team`, voice, telemetry, version check | 12.7 |
+
+Known parity gaps: tasks 10.2a/b/c/d/f/g, 10.4c and 10.5 pass Level 1 but not Level 2. The
+default-bundle system prompt in hoocode also advertises the SearchHooCode self-knowledge tool
+from 12.4, so model requests differ in that one block.
+
+The plan and its rationale are in
+[`docs/design/hoocode-to-cortexcode-migration.md`](docs/design/hoocode-to-cortexcode-migration.md)
+(§0 status, §9 phases), and the handoff log is in `migration/PROGRESS.md`. To resume, take a
+deferred task out of `deferred` and say "continue migration" (see `CLAUDE.md`).
+
+## Quick start
+
+```bash
+cargo install --path crates/cortexcode-code-main --bin cortex   # puts `cortex` on PATH
+export ANTHROPIC_API_KEY=...        # or any provider key from `cortex --help`, or /login
+cortex                              # interactive TUI
+cortex -p "Summarize this repo"     # one-shot
+```
+
+- Config, auth, sessions and settings live in `~/.cortexcode/agent` (override with
+  `CORTEX_CODING_AGENT_DIR`). Project overrides go in `./.cortexcode/`.
+- The settings, `models.json`, `auth.json`, session JSONL and `hoo-config.json` formats match
+  hoocode's, so an existing hoocode setup can be copied over.
+
+## Publishing
+
+Publishing is driven from GitHub Actions:
+
+- `Reserve crates.io names` — one-off workflow that publishes `0.0.1` placeholder crates.
+- `Release` — bump, build, publish, and create a GitHub release.
+- `Merge Release` — auto-releases PRs labeled `rust:patch`, `rust:minor`, or `rust:major`.
+- `Build binaries` — cross-compiles the `cortex` binary for Linux, macOS (Intel/Apple Silicon), and Windows.
+
+Crates marked with `[package.metadata.cortex] publish = true` are included in automated releases.

package/bin/hoocode.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+// Runs the native hoocode binary from the platform package npm/bun installed
+// alongside this one (an optionalDependency picked by os/cpu). No postinstall.
+
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+
+const PLATFORMS = {
+	"darwin-arm64": "@kolisachint/hoocode-darwin-arm64",
+	"darwin-x64": "@kolisachint/hoocode-darwin-x64",
+	"linux-arm64": "@kolisachint/hoocode-linux-arm64",
+	"linux-x64": "@kolisachint/hoocode-linux-x64",
+};
+
+const key = `${process.platform}-${process.arch}`;
+const pkg = PLATFORMS[key];
+if (!pkg) {
+	console.error(`hoocode: no prebuilt binary for ${key}.`);
+	console.error("Supported: macOS and Linux on x64 and arm64.");
+	process.exit(1);
+}
+
+let bin;
+try {
+	bin = require.resolve(`${pkg}/bin/hoocode`);
+} catch {
+	console.error(`hoocode: the platform package ${pkg} is not installed.`);
+	console.error("It is an optional dependency; reinstall without --no-optional / --omit=optional:");
+	console.error("  npm install -g @kolisachint/hoocode");
+	process.exit(1);
+}
+
+const result = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+if (result.error) {
+	console.error(`hoocode: could not start ${bin}: ${result.error.message}`);
+	process.exit(1);
+}
+if (result.signal) {
+	process.kill(process.pid, result.signal);
+}
+process.exit(result.status ?? 1);

package/package.json

@@ -1,6 +1,27 @@
 {
   "name": "@kolisachint/hoocode",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "HooCode, the terminal coding agent (Rust build)",
+  "bin": {
+    "hoocode": "bin/hoocode.js",
+    "hoo": "bin/hoocode.js"
+  },
+  "files": [
+    "bin/hoocode.js"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@kolisachint/hoocode-darwin-arm64": "0.1.0",
+    "@kolisachint/hoocode-darwin-x64": "0.1.0",
+    "@kolisachint/hoocode-linux-arm64": "0.1.0",
+    "@kolisachint/hoocode-linux-x64": "0.1.0"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kolisachint/hoocode.git"
+  },
+  "homepage": "https://kolisachint.github.io/hoocode/"
+}