Release v0.3.0

.github/workflows/ci.yml

@@ -2,16 +2,15 @@ name: CI
 
 on:
   push:
-    branches: [main]
+    branches: [main, dev, "**"]
   pull_request:
-    branches: [main]
+    branches: [main, dev, "**"]
 
 permissions:
   contents: read
 
 env:
   CARGO_TERM_COLOR: always
-  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
 
 jobs:
   check:
@@ -25,10 +24,10 @@ jobs:
 
       - uses: Swatinem/rust-cache@v2
 
-      - name: Install OpenSSL
+      - name: Install system dependencies
         run: |
           sudo apt-get update
-          sudo apt-get install -y libssl-dev pkg-config
+          sudo apt-get install -y libssl-dev pkg-config ripgrep
 
       - name: Check formatting
         run: cargo fmt --check --all

.github/workflows/release.yml

@@ -4,17 +4,74 @@ on:
   push:
     branches: [main]
     tags: ["v*"]
+  pull_request:
+    branches: [main]
 
+# Only run release jobs when:
+# - A PR is merged to main (from dev or any branch)
+# - A version tag is pushed (v*)
 permissions:
   contents: write
 
 env:
   CARGO_TERM_COLOR: always
-  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
   BINARY_NAME: nca
 
 jobs:
+  # Determine if this is a release-worthy push
+  should-release:
+    runs-on: ubuntu-latest
+    outputs:
+      value: ${{ steps.check.outputs.should_release }}
+    steps:
+      - name: Check release conditions
+        id: check
+        run: |
+          # Release on PR merge to main
+          if [[ "${{ github.event.pull_request.merged }}" == "true" ]]; then
+            echo "should_release=true" >> "$GITHUB_OUTPUT"
+            echo "trigger=PR merge to main" >> "$GITHUB_OUTPUT"
+          # Release on tag push
+          elif [[ "${{ startsWith(github.ref, 'refs/tags/v') }}" == "true" ]]; then
+            echo "should_release=true" >> "$GITHUB_OUTPUT"
+            echo "trigger=Tag push" >> "$GITHUB_OUTPUT"
+          else
+            echo "should_release=false" >> "$GITHUB_OUTPUT"
+            echo "trigger=Non-release push" >> "$GITHUB_OUTPUT"
+          fi
+
+  # CI check (required before release)
+  ci-check:
+    needs: should-release
+    if: needs.should-release.outputs.value == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - uses: Swatinem/rust-cache@v2
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libssl-dev pkg-config ripgrep
+
+      - name: Check formatting
+        run: cargo fmt --check --all
+
+      - name: Clippy
+        run: cargo clippy --workspace -- -D warnings
+
+      - name: Test
+        run: cargo test --workspace
+
+  # Multi-platform build
   build:
+    needs: [should-release, ci-check]
+    if: needs.should-release.outputs.value == 'true'
     strategy:
       matrix:
         include:
@@ -63,10 +120,11 @@ jobs:
           name: ${{ env.BINARY_NAME }}-${{ matrix.target }}
           path: ${{ env.BINARY_NAME }}-${{ matrix.target }}.${{ matrix.archive }}
 
+  # Create GitHub Release (only on tags)
   release:
-    needs: build
+    needs: [should-release, build]
+    if: needs.should-release.outputs.value == 'true' && startsWith(github.ref, 'refs/tags/')
     runs-on: ubuntu-latest
-    if: startsWith(github.ref, 'refs/tags/v')
     steps:
       - uses: actions/checkout@v4
 
@@ -83,10 +141,11 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
+  # Update install script (only on tags)
   update-install-script:
-    needs: release
+    needs: [should-release, release]
+    if: needs.should-release.outputs.value == 'true' && startsWith(github.ref, 'refs/tags/')
     runs-on: ubuntu-latest
-    if: startsWith(github.ref, 'refs/tags/v')
     steps:
       - uses: actions/checkout@v4
 

Cargo.toml

@@ -9,7 +9,7 @@ members = [
 ]
 
 [workspace.package]
-version = "0.2.0"
+version = "0.3.0"
 edition = "2024"
 license = "MIT"
 repository = "https://github.com/madebyaris/native-cli-ai"

README.md

@@ -76,9 +76,7 @@ Pre-built binaries for every release are available on the [Releases](https://git
 |---|---|
 | macOS (Apple Silicon) | `aarch64-apple-darwin` |
 | macOS (Intel) | `x86_64-apple-darwin` |
-| Linux (x86_64, glibc) | `x86_64-unknown-linux-gnu` |
-| Linux (x86_64, static) | `x86_64-unknown-linux-musl` |
-| Linux (ARM64) | `aarch64-unknown-linux-gnu` |
+| Linux (x86_64) | `x86_64-unknown-linux-gnu` |
 
 ### Build from source
 
@@ -273,6 +271,17 @@ The system prompt is layered in this order:
 
 The built-in tool surface includes filesystem editing, search, diffing, patching, shell execution, web access, `ask_question`, and `spawn_subagent`. MCP tools are loaded dynamically when configured, so the available tool set can grow with your environment.
 
+### Search And Edit Tools
+
+Recent search/edit improvements are aimed at making agent file work less brittle:
+
+- `search_code` now returns structured JSON match objects instead of raw `rg` text.
+- `search_code` treats ripgrep exit code `1` as a successful empty result, not a failure.
+- `search_code` supports `path`, `glob`, `fixed_strings`, `case_sensitive`, `word`, `context_before`, `context_after`, and `max_results`.
+- `query_symbols` is a literal Rust symbol lookup, not an implicit regex expansion of user input.
+- `edit_file` and `apply_patch` now fail loudly on ambiguous single-match edits instead of silently changing the first occurrence.
+- `replace_match` can edit a specific search result by exact `path`, `line`, and `column`, which makes search -> edit flows much safer.
+
 ## Crate Layout
 
 | Crate | Responsibility |
@@ -295,7 +304,22 @@ In practice, that means you can start small, branch out when a task gets bigger,
 
 ## Documentation
 
-The root README is the quick-start guide. Use the docs folder for deeper detail:
+Full user-facing documentation lives in [`docs/documentation/`](docs/documentation/index.md):
+
+| Page | Description |
+|---|---|
+| [Getting Started](docs/documentation/getting-started.md) | Installation, first run, and initial configuration |
+| [Commands](docs/documentation/commands.md) | Complete CLI command and flag reference |
+| [Interactive Mode](docs/documentation/interactive-mode.md) | TUI, REPL, slash commands, keyboard shortcuts |
+| [Configuration](docs/documentation/configuration.md) | Config files, TOML format, and environment variables |
+| [Providers](docs/documentation/providers.md) | LLM provider setup — MiniMax, Anthropic, OpenAI, OpenRouter |
+| [Tools](docs/documentation/tools.md) | All agent tools — file ops, search, shell, web, and more |
+| [Sessions](docs/documentation/sessions.md) | Session lifecycle, persistence, resume, and management |
+| [Permissions](docs/documentation/permissions.md) | Approval system, permission modes, and safe mode |
+| [Skills](docs/documentation/skills.md) | Skill discovery, installation, and authoring |
+| [Advanced](docs/documentation/advanced.md) | Sub-agents, MCP servers, hooks, orchestration, and IPC |
+
+Internal design docs:
 
 - [Product Requirements](docs/prd.md)
 - [Tech Stack](docs/tech-stack.md)