noah-code 0.2.1__tar.gz → 0.2.3__tar.gz

{noah_code-0.2.1 → noah_code-0.2.3}/.github/workflows/ci.yml

@@ -9,10 +9,15 @@ on:
 permissions:
   contents: read
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   quality:
     name: Python ${{ matrix.python-version }} quality
     runs-on: ubuntu-latest
+    timeout-minutes: 30
     strategy:
       fail-fast: false
       matrix:
@@ -46,7 +51,17 @@ jobs:
       - name: Lint
         run: uv run ruff check src tests
 
+      - name: Type check
+        run: uv run mypy src/noah_code
+
+      - name: Test with coverage (3.12 only)
+        if: matrix.python-version == '3.12'
+        run: |
+          uv run pytest tests --cov=noah_code --cov-report=term-missing \
+            --cov-fail-under=70 -W error::pytest.PytestUnraisableExceptionWarning
+
       - name: Test
+        if: matrix.python-version != '3.12'
         run: uv run pytest tests -W error::pytest.PytestUnraisableExceptionWarning
 
       - name: Build distributions
@@ -55,6 +70,7 @@ jobs:
   platform:
     name: ${{ matrix.name }} smoke test
     runs-on: ${{ matrix.runner }}
+    timeout-minutes: 40
     strategy:
       fail-fast: false
       matrix:

{noah_code-0.2.1 → noah_code-0.2.3}/.gitignore

@@ -11,3 +11,6 @@ build/
 htmlcov/
 traces/
 .DS_Store
+docs/superpowers/plans/
+docs/superpowers/specs/
+.noah-code/

noah_code-0.2.3/.pre-commit-config.yaml

@@ -0,0 +1,8 @@
+# Pre-commit hooks mirroring the CI lint gate.
+# Install with: uv run pre-commit install  (or `pre-commit install` once installed)
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.16.1
+    hooks:
+      - id: ruff-check
+        args: [--fix]

noah_code-0.2.3/PKG-INFO

@@ -0,0 +1,246 @@
+Metadata-Version: 2.5
+Name: noah-code
+Version: 0.2.3
+Summary: Noah Code terminal coding agent, built on NVIDIA OO Agents (NOOA)
+Project-URL: Homepage, https://github.com/skundu42/noah-code
+Project-URL: Documentation, https://github.com/skundu42/noah-code#readme
+Project-URL: Repository, https://github.com/skundu42/noah-code.git
+Project-URL: Issues, https://github.com/skundu42/noah-code/issues
+Project-URL: Releases, https://github.com/skundu42/noah-code/releases
+Author: noah-code contributors
+License: Apache-2.0
+Keywords: agents,coding,nooa,terminal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Requires-Python: <3.14,>=3.12
+Requires-Dist: click>=8.1.0
+Requires-Dist: litellm<1.92.0,>=1.84.0
+Requires-Dist: nooa-cli==0.0.9
+Requires-Dist: nooa==0.0.9
+Requires-Dist: packaging>=24.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: textual>=1.0.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: nooa[mcp]==0.0.9; extra == 'mcp'
+Provides-Extra: tracing
+Requires-Dist: nooa[tracing]==0.0.9; extra == 'tracing'
+Provides-Extra: tui
+Requires-Dist: textual>=1.0.0; extra == 'tui'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# Noah Code
+
+**A terminal coding agent built on NVIDIA's NOAA framework**
+
+[![PyPI](https://img.shields.io/pypi/v/noah-code.svg)](https://pypi.org/project/noah-code/)
+[![CI](https://github.com/skundu42/noah-code/actions/workflows/ci.yml/badge.svg)](https://github.com/skundu42/noah-code/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/pypi/pyversions/noah-code.svg)](https://pypi.org/project/noah-code/)
+
+</div>
+
+![Noah Code handling a repository change in its terminal interface](docs/assets/noah-in-action.svg)
+
+<p align="center"><sub>The real Textual interface, captured from a deterministic Noah Code session.</sub></p>
+
+Noah keeps the conversation central while the context rail tracks live work, Git changes, session,
+model usage, and the current plan. Tool execution stays visible, completed work compacts into
+readable records, and every session remains scoped to its repository.
+
+Built on the [NVIDIA OO Agents (NOOA)](https://github.com/NVIDIA-NeMo/labs-OO-Agents) runtime.
+
+## Install
+
+Install Noah Code and its managed Python runtime with one command:
+
+```bash
+curl -LsSf https://raw.githubusercontent.com/skundu42/noah-code/main/install.sh | sh
+```
+
+Open a new terminal, move into a repository, and start Noah:
+
+```bash
+cd your-project
+noah .
+```
+
+Noah is compatible with macOS on Apple Silicon and Intel, plus Linux on arm64 and x86_64.
+
+On the first launch, the TUI walks through provider, API key, model, and reasoning setup. Keys are
+stored in Noah's private auth file with owner-only permissions; they are never written to project
+configuration or session history.
+
+## Why Noah
+
+- **Repository-aware exploration.** Search with ripgrep, inspect Git history and diffs, navigate
+  symbols through language servers, and use an mtime-cached repository map.
+- **Controlled edits.** Apply anchored replacements or atomic multi-file patches with exact
+  preimages, concurrent-change detection, immediate diagnostics, and rollback.
+- **Visible execution.** Stream bounded shell output while commands run, keep servers and watchers
+  as managed background jobs, and revisit activity details with `F2`.
+- **Recoverable work.** Review staged and unstaged changes in `/diff`, then undo or redo journaled
+  file edits even after restarting Noah.
+- **Persistent sessions.** Resume repository-scoped conversations, todos, model choices, and
+  automatically compacted context without losing the full underlying tool results.
+- **Token-efficient by construction.** Lean tool-output bounds with disk-backed recall, condensed
+  subagent results, cache-stable request prefixes (volatile status arrives as appended events),
+  and pointer-eviction compaction — measured live with `/tokens`.
+- **Explicit control.** Switch between implementation-focused **build** mode and read-only
+  **plan** mode, with ordered `allow`, `ask`, and `deny` permission rules.
+- **Extensible workflows.** Add slash commands, opt-in skills, MCP servers, or markdown subagents;
+  attach `@files` and images when the task needs more context.
+
+Noah follows repository instructions from `AGENTS.md`, `CLAUDE.md`, and
+`.noah-code/instructions.md`.
+
+## Quick start
+
+Describe the outcome you want rather than prescribing every edit:
+
+```text
+Find the cause of the failing parser tests, implement the smallest safe fix, and run the
+focused test file.
+```
+
+Useful launch modes:
+
+```bash
+# Open another workspace
+noah /path/to/repository
+
+# Inspect and plan without editing
+noah --mode plan .
+
+# Run one task and exit
+noah run "Explain how authentication is wired" .
+
+# Allow actions that would normally ask; explicit deny rules still apply
+noah run --auto "Fix the failing unit test" .
+
+# Resume previous work
+noah --continue .
+noah --session SESSION_ID .
+
+# Use the line-oriented interface
+noah --console .
+```
+
+Check the installation and resolved configuration with:
+
+```bash
+noah --version
+noah doctor .
+noah config show .
+noah update --check
+```
+
+The package also installs `noah-code` and `nc` as equivalent entry points. Because `nc` commonly
+means netcat, `noah` or `noah-code` is recommended.
+
+## Inside the TUI
+
+Type `/` to search the full command and configuration reference. The most common controls are:
+
+| Control | Action |
+| --- | --- |
+| `Enter` | Send the current prompt or accept a selected suggestion |
+| `Shift+Enter` | Insert a newline |
+| `Tab` | Switch between build and plan mode |
+| `F2` | Open execution activity |
+| `F3` | Open paginated conversation history |
+| `/model` | Configure a provider or switch the session model |
+| `/theme` | Choose Atom One Dark, Noah Ocean, Graphite, or High Contrast |
+| `/diff` | Review staged and unstaged changes |
+| `/undo` / `/redo` | Traverse the persistent edit journal |
+| `/tokens` | Inspect tokens, cache usage, prefix stability, model wait, and tool output |
+| `/efficiency` | Switch between `fast`, `balanced`, and `deep` budgets |
+
+On wide terminals, the side rail prioritizes the active operation, Git branch and change counts,
+session, model usage, update state, and plan. Git status is refreshed in the background at turn
+boundaries, so the animated working state stays responsive. The main pane remains centered on the
+Noah mark until the first prompt, then becomes the conversation and execution timeline.
+
+## Models and providers
+
+Noah supports OpenAI, Anthropic, OpenRouter, NVIDIA, and custom OpenAI-compatible providers. It
+also works with vLLM, LM Studio, Ollama, Azure OpenAI, Bedrock, Gemini, Groq, Mistral, xAI,
+DeepSeek, Together AI, and Perplexity.
+
+The guided `/model` flow is the easiest way to configure a provider. Environment variables and
+the CLI remain available for scripts and headless environments:
+
+```bash
+export OPENAI_API_KEY="..."  # or ANTHROPIC_API_KEY / OPENROUTER_API_KEY
+noah providers list
+noah providers add openai --model MODEL_NAME
+noah .
+```
+
+`/model MODEL` changes only the current session and remembers that choice when resumed. Use
+`/model --global MODEL` to set the default for future sessions in every repository.
+
+For compatible reasoning models, choose `default`, `none`, `minimal`, `low`, `medium`, `high`, or
+`xhigh`. `default` omits the provider parameter:
+
+```bash
+noah --model openai/MODEL --reasoning-effort high .
+```
+
+See the [provider configuration guide](docs/configuration.md#bring-your-own-api-provider) for
+gateway-specific setup.
+
+## Updates
+
+Noah checks PyPI for new versions at most once every 24 hours. New TUI sessions show a temporary
+banner when an update is available and keep the version visible in the context rail. Installation
+remains explicit by default:
+
+```bash
+noah update --check
+noah update
+```
+
+## Documentation
+
+- [Interactive interface and sessions](docs/interactive-reference.md)
+- [Configuration, modes, permissions, and updates](docs/configuration.md)
+- [Generated-code security](docs/security.md)
+- [Custom commands, skills, MCP, and tracing](docs/extensions.md)
+- [Development, CI, and releases](docs/development.md)
+- [Release notes](docs/releases/)
+
+## Development
+
+```bash
+uv sync --extra dev --extra mcp --extra tracing
+uv run ruff check src tests
+uv run pytest tests
+uv build
+```
+
+See the [development guide](docs/development.md) for platform checks and the release process.
+
+## License
+
+Apache-2.0. NOOA remains separately licensed by its upstream
+project.
+
+## Credits
+
+Built on [NVIDIA OO Agents (NOOA)](https://github.com/NVIDIA-NeMo/labs-OO-Agents). Thanks to the
+NVIDIA NeMo team and NOOA contributors for the agent runtime that powers Noah Code.

noah_code-0.2.3/README.md

@@ -0,0 +1,202 @@
+<div align="center">
+
+# Noah Code
+
+**A terminal coding agent built on NVIDIA's NOAA framework**
+
+[![PyPI](https://img.shields.io/pypi/v/noah-code.svg)](https://pypi.org/project/noah-code/)
+[![CI](https://github.com/skundu42/noah-code/actions/workflows/ci.yml/badge.svg)](https://github.com/skundu42/noah-code/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/pypi/pyversions/noah-code.svg)](https://pypi.org/project/noah-code/)
+
+</div>
+
+![Noah Code handling a repository change in its terminal interface](docs/assets/noah-in-action.svg)
+
+<p align="center"><sub>The real Textual interface, captured from a deterministic Noah Code session.</sub></p>
+
+Noah keeps the conversation central while the context rail tracks live work, Git changes, session,
+model usage, and the current plan. Tool execution stays visible, completed work compacts into
+readable records, and every session remains scoped to its repository.
+
+Built on the [NVIDIA OO Agents (NOOA)](https://github.com/NVIDIA-NeMo/labs-OO-Agents) runtime.
+
+## Install
+
+Install Noah Code and its managed Python runtime with one command:
+
+```bash
+curl -LsSf https://raw.githubusercontent.com/skundu42/noah-code/main/install.sh | sh
+```
+
+Open a new terminal, move into a repository, and start Noah:
+
+```bash
+cd your-project
+noah .
+```
+
+Noah is compatible with macOS on Apple Silicon and Intel, plus Linux on arm64 and x86_64.
+
+On the first launch, the TUI walks through provider, API key, model, and reasoning setup. Keys are
+stored in Noah's private auth file with owner-only permissions; they are never written to project
+configuration or session history.
+
+## Why Noah
+
+- **Repository-aware exploration.** Search with ripgrep, inspect Git history and diffs, navigate
+  symbols through language servers, and use an mtime-cached repository map.
+- **Controlled edits.** Apply anchored replacements or atomic multi-file patches with exact
+  preimages, concurrent-change detection, immediate diagnostics, and rollback.
+- **Visible execution.** Stream bounded shell output while commands run, keep servers and watchers
+  as managed background jobs, and revisit activity details with `F2`.
+- **Recoverable work.** Review staged and unstaged changes in `/diff`, then undo or redo journaled
+  file edits even after restarting Noah.
+- **Persistent sessions.** Resume repository-scoped conversations, todos, model choices, and
+  automatically compacted context without losing the full underlying tool results.
+- **Token-efficient by construction.** Lean tool-output bounds with disk-backed recall, condensed
+  subagent results, cache-stable request prefixes (volatile status arrives as appended events),
+  and pointer-eviction compaction — measured live with `/tokens`.
+- **Explicit control.** Switch between implementation-focused **build** mode and read-only
+  **plan** mode, with ordered `allow`, `ask`, and `deny` permission rules.
+- **Extensible workflows.** Add slash commands, opt-in skills, MCP servers, or markdown subagents;
+  attach `@files` and images when the task needs more context.
+
+Noah follows repository instructions from `AGENTS.md`, `CLAUDE.md`, and
+`.noah-code/instructions.md`.
+
+## Quick start
+
+Describe the outcome you want rather than prescribing every edit:
+
+```text
+Find the cause of the failing parser tests, implement the smallest safe fix, and run the
+focused test file.
+```
+
+Useful launch modes:
+
+```bash
+# Open another workspace
+noah /path/to/repository
+
+# Inspect and plan without editing
+noah --mode plan .
+
+# Run one task and exit
+noah run "Explain how authentication is wired" .
+
+# Allow actions that would normally ask; explicit deny rules still apply
+noah run --auto "Fix the failing unit test" .
+
+# Resume previous work
+noah --continue .
+noah --session SESSION_ID .
+
+# Use the line-oriented interface
+noah --console .
+```
+
+Check the installation and resolved configuration with:
+
+```bash
+noah --version
+noah doctor .
+noah config show .
+noah update --check
+```
+
+The package also installs `noah-code` and `nc` as equivalent entry points. Because `nc` commonly
+means netcat, `noah` or `noah-code` is recommended.
+
+## Inside the TUI
+
+Type `/` to search the full command and configuration reference. The most common controls are:
+
+| Control | Action |
+| --- | --- |
+| `Enter` | Send the current prompt or accept a selected suggestion |
+| `Shift+Enter` | Insert a newline |
+| `Tab` | Switch between build and plan mode |
+| `F2` | Open execution activity |
+| `F3` | Open paginated conversation history |
+| `/model` | Configure a provider or switch the session model |
+| `/theme` | Choose Atom One Dark, Noah Ocean, Graphite, or High Contrast |
+| `/diff` | Review staged and unstaged changes |
+| `/undo` / `/redo` | Traverse the persistent edit journal |
+| `/tokens` | Inspect tokens, cache usage, prefix stability, model wait, and tool output |
+| `/efficiency` | Switch between `fast`, `balanced`, and `deep` budgets |
+
+On wide terminals, the side rail prioritizes the active operation, Git branch and change counts,
+session, model usage, update state, and plan. Git status is refreshed in the background at turn
+boundaries, so the animated working state stays responsive. The main pane remains centered on the
+Noah mark until the first prompt, then becomes the conversation and execution timeline.
+
+## Models and providers
+
+Noah supports OpenAI, Anthropic, OpenRouter, NVIDIA, and custom OpenAI-compatible providers. It
+also works with vLLM, LM Studio, Ollama, Azure OpenAI, Bedrock, Gemini, Groq, Mistral, xAI,
+DeepSeek, Together AI, and Perplexity.
+
+The guided `/model` flow is the easiest way to configure a provider. Environment variables and
+the CLI remain available for scripts and headless environments:
+
+```bash
+export OPENAI_API_KEY="..."  # or ANTHROPIC_API_KEY / OPENROUTER_API_KEY
+noah providers list
+noah providers add openai --model MODEL_NAME
+noah .
+```
+
+`/model MODEL` changes only the current session and remembers that choice when resumed. Use
+`/model --global MODEL` to set the default for future sessions in every repository.
+
+For compatible reasoning models, choose `default`, `none`, `minimal`, `low`, `medium`, `high`, or
+`xhigh`. `default` omits the provider parameter:
+
+```bash
+noah --model openai/MODEL --reasoning-effort high .
+```
+
+See the [provider configuration guide](docs/configuration.md#bring-your-own-api-provider) for
+gateway-specific setup.
+
+## Updates
+
+Noah checks PyPI for new versions at most once every 24 hours. New TUI sessions show a temporary
+banner when an update is available and keep the version visible in the context rail. Installation
+remains explicit by default:
+
+```bash
+noah update --check
+noah update
+```
+
+## Documentation
+
+- [Interactive interface and sessions](docs/interactive-reference.md)
+- [Configuration, modes, permissions, and updates](docs/configuration.md)
+- [Generated-code security](docs/security.md)
+- [Custom commands, skills, MCP, and tracing](docs/extensions.md)
+- [Development, CI, and releases](docs/development.md)
+- [Release notes](docs/releases/)
+
+## Development
+
+```bash
+uv sync --extra dev --extra mcp --extra tracing
+uv run ruff check src tests
+uv run pytest tests
+uv build
+```
+
+See the [development guide](docs/development.md) for platform checks and the release process.
+
+## License
+
+Apache-2.0. NOOA remains separately licensed by its upstream
+project.
+
+## Credits
+
+Built on [NVIDIA OO Agents (NOOA)](https://github.com/NVIDIA-NeMo/labs-OO-Agents). Thanks to the
+NVIDIA NeMo team and NOOA contributors for the agent runtime that powers Noah Code.