newcode 0.1.1__tar.gz

newcode-0.1.1/.gitignore

@@ -0,0 +1,47 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+.coverage
+
+# Session memory
+.puppy_session_memory.json
+
+# Pytest cache
+.pytest_cache/
+
+dummy_path
+
+.idea/
+
+.DS_Store
+.env
+.serena/
+.beads/
+main.dist/
+nuitka-crash-report.xml
+*.backup
+main.bin
+
+# Bundled skills removed — skills are now fetched from remote catalog
+code_puppy/bundled_skills/
+
+# Hook engine runtime artifacts (logs, compiled outputs)
+.claude/activity.jsonl
+.claude/hooks/audit.log
+
+# Compiled hook binaries (built from .go sources in .claude/hooks/go-hooks/)
+.claude/hooks/go-hooks/audit-bash
+.claude/hooks/go-hooks/file-policy
+
+# Compiled TypeScript hook output (built from .ts sources)
+.claude/hooks/ts-hooks/dist/
+
+.json

newcode-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mike Pfaffenberger
+
+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.

newcode-0.1.1/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: newcode
+Version: 0.1.1
+Summary: AI-powered code generation agent - a fedstew fork of code-puppy
+Project-URL: repository, https://github.com/janfeddersen-wq/new_code
+Project-URL: HomePage, https://github.com/janfeddersen-wq/new_code
+Project-URL: Upstream, https://github.com/mpfaffenberger/code_puppy
+Author: Jan Feddersen, Michael Pfaffenberger (original code-puppy author)
+License: MIT
+License-File: LICENSE
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: <3.14,>=3.11
+Requires-Dist: anthropic==0.79.0
+Requires-Dist: dbos>=2.11.0
+Requires-Dist: fastapi>=0.109.0
+Requires-Dist: httpx[http2]>=0.24.1
+Requires-Dist: json-repair>=0.46.2
+Requires-Dist: mcp>=1.9.4
+Requires-Dist: openai>=1.99.1
+Requires-Dist: pillow>=10.0.0
+Requires-Dist: playwright>=1.40.0
+Requires-Dist: prompt-toolkit>=3.0.52
+Requires-Dist: pydantic-ai-slim[anthropic,mcp,openai]==1.56.0
+Requires-Dist: pydantic>=2.4.0
+Requires-Dist: pyfiglet>=0.8.post1
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rapidfuzz>=3.13.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: rich>=13.4.2
+Requires-Dist: ripgrep==14.1.0
+Requires-Dist: tenacity>=8.2.0
+Requires-Dist: termflow-md>=0.1.8
+Requires-Dist: typer>=0.12.0
+Requires-Dist: uvicorn[standard]>=0.27.0
+Requires-Dist: websockets>=12.0
+Description-Content-Type: text/markdown
+
+# NewCode
+
+An AI-powered code generation and modification agent for the terminal.
+
+NewCode is a fork of [code-puppy](https://github.com/mpfaffenberger/code_puppy) by Michael Pfaffenberger, customized for the fedstew workflow. We wanted a clean, professional CLI agent with opinionated defaults, streamlined prompts, and a focus on practical code generation without the playful branding.
+
+## What changed from code-puppy
+
+- Removed all dog/puppy-themed branding and emojis in favor of a clean, professional interface
+- Renamed "Pack" multi-agent system to use functional names (Orchestrator, Tracker, Executor, Reviewer, etc.)
+- Rewrote all agent system prompts for clarity and professionalism
+- Increased output validation retries from 3 to 10 for more robust model interactions
+- Updated configuration keys and display names throughout
+- Published to PyPI as `newcode` instead of `code-puppy`
+
+## Installation
+
+```bash
+pip install newcode
+```
+
+Or with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv pip install newcode
+```
+
+## Quick Start
+
+```bash
+# Run the agent
+newcode
+
+# Or use the short alias
+nc
+```
+
+On first run, you'll be guided through a setup wizard to configure your API keys and preferences.
+
+## Requirements
+
+- Python 3.11 - 3.13
+- An API key for at least one supported provider (OpenAI, Anthropic, Cerebras, Google Gemini, etc.)
+
+## Features
+
+- Multi-model support: OpenAI, Anthropic Claude, Google Gemini, Cerebras, and more
+- Multi-agent workflows with specialized agents (Orchestrator, Tracker, Executor, Reviewer, QA Checker, Workspace Manager, Merger)
+- File operations: read, write, edit, delete with diff previews and permission prompts
+- Shell command execution with safety controls
+- Browser-based terminal via built-in API server
+- Scheduled task execution with a background daemon
+- Plugin system with lifecycle callbacks and event-based hooks
+- Interactive TUI menus for configuration, model selection, and task management
+- Session auto-save and restore
+- MCP (Model Context Protocol) server support
+
+## Configuration
+
+Configuration is stored in `~/.config/code_puppy/puppy.cfg` (XDG-compliant paths). The setup wizard handles initial configuration. You can also use CLI commands:
+
+```bash
+# Inside the agent REPL:
+/config          # Show current configuration
+/model           # Switch models
+/agent           # Switch agents
+/scheduler       # Manage scheduled tasks
+/colors          # Customize terminal colors
+```
+
+## Agents
+
+| Agent | Purpose |
+|-------|---------|
+| Code Agent | General-purpose code generation and modification (default) |
+| Orchestrator | Multi-agent workflow coordination |
+| Tracker | Code search and navigation |
+| Executor | Shell command execution |
+| Reviewer | Code review and quality checks |
+| QA Checker | Testing and validation |
+| Workspace Manager | File system operations |
+| Merger | Result integration |
+| Python Reviewer | Python-specific code review |
+| QA Expert | Testing strategy and quality assurance |
+| Security Auditor | Security analysis |
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/janfeddersen-wq/new_code.git
+cd new_code
+
+# Install with dev dependencies
+uv pip install -e ".[dev]"
+
+# Run tests
+uv run pytest tests/ -v
+
+# Lint
+ruff check .
+ruff format --check .
+```
+
+## Credits
+
+This project is a fork of [code-puppy](https://github.com/mpfaffenberger/code_puppy) by [Michael Pfaffenberger](https://github.com/mpfaffenberger), licensed under the MIT License. We are grateful for the original work and the open-source foundation it provides.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

newcode-0.1.1/README.md

@@ -0,0 +1,111 @@
+# NewCode
+
+An AI-powered code generation and modification agent for the terminal.
+
+NewCode is a fork of [code-puppy](https://github.com/mpfaffenberger/code_puppy) by Michael Pfaffenberger, customized for the fedstew workflow. We wanted a clean, professional CLI agent with opinionated defaults, streamlined prompts, and a focus on practical code generation without the playful branding.
+
+## What changed from code-puppy
+
+- Removed all dog/puppy-themed branding and emojis in favor of a clean, professional interface
+- Renamed "Pack" multi-agent system to use functional names (Orchestrator, Tracker, Executor, Reviewer, etc.)
+- Rewrote all agent system prompts for clarity and professionalism
+- Increased output validation retries from 3 to 10 for more robust model interactions
+- Updated configuration keys and display names throughout
+- Published to PyPI as `newcode` instead of `code-puppy`
+
+## Installation
+
+```bash
+pip install newcode
+```
+
+Or with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv pip install newcode
+```
+
+## Quick Start
+
+```bash
+# Run the agent
+newcode
+
+# Or use the short alias
+nc
+```
+
+On first run, you'll be guided through a setup wizard to configure your API keys and preferences.
+
+## Requirements
+
+- Python 3.11 - 3.13
+- An API key for at least one supported provider (OpenAI, Anthropic, Cerebras, Google Gemini, etc.)
+
+## Features
+
+- Multi-model support: OpenAI, Anthropic Claude, Google Gemini, Cerebras, and more
+- Multi-agent workflows with specialized agents (Orchestrator, Tracker, Executor, Reviewer, QA Checker, Workspace Manager, Merger)
+- File operations: read, write, edit, delete with diff previews and permission prompts
+- Shell command execution with safety controls
+- Browser-based terminal via built-in API server
+- Scheduled task execution with a background daemon
+- Plugin system with lifecycle callbacks and event-based hooks
+- Interactive TUI menus for configuration, model selection, and task management
+- Session auto-save and restore
+- MCP (Model Context Protocol) server support
+
+## Configuration
+
+Configuration is stored in `~/.config/code_puppy/puppy.cfg` (XDG-compliant paths). The setup wizard handles initial configuration. You can also use CLI commands:
+
+```bash
+# Inside the agent REPL:
+/config          # Show current configuration
+/model           # Switch models
+/agent           # Switch agents
+/scheduler       # Manage scheduled tasks
+/colors          # Customize terminal colors
+```
+
+## Agents
+
+| Agent | Purpose |
+|-------|---------|
+| Code Agent | General-purpose code generation and modification (default) |
+| Orchestrator | Multi-agent workflow coordination |
+| Tracker | Code search and navigation |
+| Executor | Shell command execution |
+| Reviewer | Code review and quality checks |
+| QA Checker | Testing and validation |
+| Workspace Manager | File system operations |
+| Merger | Result integration |
+| Python Reviewer | Python-specific code review |
+| QA Expert | Testing strategy and quality assurance |
+| Security Auditor | Security analysis |
+
+## Development
+
+```bash
+# Clone the repo
+git clone https://github.com/janfeddersen-wq/new_code.git
+cd new_code
+
+# Install with dev dependencies
+uv pip install -e ".[dev]"
+
+# Run tests
+uv run pytest tests/ -v
+
+# Lint
+ruff check .
+ruff format --check .
+```
+
+## Credits
+
+This project is a fork of [code-puppy](https://github.com/mpfaffenberger/code_puppy) by [Michael Pfaffenberger](https://github.com/mpfaffenberger), licensed under the MIT License. We are grateful for the original work and the open-source foundation it provides.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

newcode-0.1.1/code_puppy/__init__.py

@@ -0,0 +1,10 @@
+import importlib.metadata
+
+# Version detection
+try:
+    _detected_version = importlib.metadata.version("code-puppy")
+    # Ensure we never end up with None or empty string
+    __version__ = _detected_version if _detected_version else "0.0.0-dev"
+except Exception:
+    # Fallback for dev environments where metadata might not be available
+    __version__ = "0.0.0-dev"

newcode-0.1.1/code_puppy/__main__.py

@@ -0,0 +1,10 @@
+"""
+Entry point for running newcode as a module.
+
+This allows the package to be run with: python -m code_puppy
+"""
+
+from code_puppy.main import main_entry
+
+if __name__ == "__main__":
+    main_entry()

newcode-0.1.1/code_puppy/agents/__init__.py

@@ -0,0 +1,31 @@
+"""Agent management system for code-puppy.
+
+This module provides functionality for switching between different agent
+configurations, each with their own system prompts and tool sets.
+"""
+
+from .agent_manager import (
+    clone_agent,
+    delete_clone_agent,
+    get_agent_descriptions,
+    get_available_agents,
+    get_current_agent,
+    is_clone_agent_name,
+    load_agent,
+    refresh_agents,
+    set_current_agent,
+)
+from .subagent_stream_handler import subagent_stream_handler
+
+__all__ = [
+    "clone_agent",
+    "delete_clone_agent",
+    "get_available_agents",
+    "get_current_agent",
+    "is_clone_agent_name",
+    "set_current_agent",
+    "load_agent",
+    "get_agent_descriptions",
+    "refresh_agents",
+    "subagent_stream_handler",
+]

newcode-0.1.1/code_puppy/agents/agent_c_reviewer.py

@@ -0,0 +1,155 @@
+"""C99/C11 systems code reviewer agent."""
+
+from .base_agent import BaseAgent
+
+
+class CReviewerAgent(BaseAgent):
+    """Low-level C-focused code review agent."""
+
+    @property
+    def name(self) -> str:
+        return "c-reviewer"
+
+    @property
+    def display_name(self) -> str:
+        return "C Reviewer 🧵"
+
+    @property
+    def description(self) -> str:
+        return "Hardcore C systems reviewer obsessed with determinism, perf, and safety"
+
+    def get_available_tools(self) -> list[str]:
+        """Reviewers need read-only inspection helpers plus agent collaboration."""
+        return [
+            "agent_share_your_reasoning",
+            "agent_run_shell_command",
+            "list_files",
+            "read_file",
+            "grep",
+            "invoke_agent",
+            "list_agents",
+        ]
+
+    def get_system_prompt(self) -> str:
+        return """
+You are the C systems reviewer puppy. Think C99/C11 in the trenches: kernels, drivers, embedded firmware, high-performance network stacks. Embrace the sass, but never compromise on correctness.
+
+Mission profile:
+- Review only `.c`/`.h` files with meaningful code diffs. Skip untouched files or mechanical formatting changes.
+- Inspect build scripts (Makefiles, CMakeLists, linker scripts) only when they alter compiler flags, memory layout, sanitizers, or ABI contracts.
+- Assume grim environments: tight memory, real-time deadlines, hostile inputs, mixed architectures. Highlight portability and determinism risks.
+
+Design doctrine:
+- SRP obsessed: one function, one responsibility. Flag multi-purpose monsters instantly.
+- DRY zealot: common logic goes into shared helpers or macros when they reduce duplication responsibly.
+- YAGNI watchdog: punt speculative hooks and future-proof fantasies. Minimal viable change only.
+- Composition > inheritance: prefer structs + function pointers/interfaces for pluggable behaviour.
+
+Style canon (keep it tight):
+```
+/* good: focused helper */
+static int
+validate_vlan_id(uint16_t vlan_id)
+{
+    return vlan_id > 0 && vlan_id < 4095;
+}
+
+/* bad: monolith */
+static int
+process_and_validate_and_swap_vlan(...)
+{
+    /* mixed responsibilities */
+}
+```
+
+Quality gates:
+- Cyclomatic complexity under 10 per function unless justified.
+- Zero warnings under `-Wall -Wextra -Werror`.
+- Valgrind/ASan/MSan clean for relevant paths.
+- No dynamic allocation in the hot path without profiling proof.
+
+Required habits:
+- Validate inputs in every public function and critical static helper.
+- Use `likely`/`unlikely` hints for hot branches when profiling backs it up.
+- Inline packet-processing helpers sparingly to keep the instruction cache happy.
+- Replace magic numbers with `#define` or `enum` constants.
+
+Per C file that matters:
+1. Start with a concise summary of the behavioural or architectural impact.
+2. List findings in severity order (blockers → warnings → nits). Focus on correctness, undefined behaviour, memory lifetime, concurrency, interrupt safety, networking edge cases, and performance.
+3. Award genuine praise when the diff nails it—clean DMA handling, lock-free queues, branchless hot paths, bulletproof error unwinding.
+
+Review heuristics:
+- Memory & lifetime: manual allocation strategy, ownership transfer, alignment, cache friendliness, stack vs heap, DMA constraints.
+- Concurrency & interrupts: atomic discipline, memory barriers, ISR safety, lock ordering, wait-free structures, CPU affinity, NUMA awareness.
+- Performance: branch prediction, cache locality, vectorization (intrinsics), prefetching, zero-copy I/O, batching, syscall amortization.
+- Networking: protocol compliance, endian handling, buffer management, MTU/fragmentation, congestion control hooks, timing windows.
+- OS/driver specifics: register access, MMIO ordering, power management, hotplug resilience, error recovery paths, watchdog expectations.
+- Safety: null derefs, integer overflow, double free, TOCTOU windows, privilege boundaries, sandbox escape surfaces.
+- Tooling: compile flags (`-O3 -march=native`, `-flto`, `-fstack-protector-strong`), sanitizers (`-fsanitize=address,undefined,thread`), static analysis (clang-tidy, cppcheck, coverity), coverage harnesses (gcov, lcov), fuzz targets (libFuzzer, AFL, honggfuzz).
+- Testing: deterministic unit tests, stress/load tests, fuzz plans, HW-in-loop sims, perf counters.
+- Maintainability: SRP enforcement, header hygiene, composable modules, boundary-defined interfaces.
+
+C Code Quality Checklist (verify for each file):
+- [ ] Zero warnings under `-Wall -Wextra -Werror`
+- [ ] Valgrind/ASan/MSan clean for relevant paths
+- [ ] Static analysis passes (clang-tidy, cppcheck)
+- [ ] Memory management: no leaks, proper free/delete pairs
+- [ ] Thread safety: proper locking, no race conditions
+- [ ] Input validation: bounds checking, null pointer checks
+- [ ] Error handling: graceful failure paths, proper error codes
+- [ ] Performance: no O(n²) in hot paths, cache-friendly access
+- [ ] Documentation: function headers, complex algorithm comments
+- [ ] Testing: unit tests, edge cases, memory error tests
+
+Critical Security Checklist:
+- [ ] Buffer overflow protection (strncpy, bounds checking)
+- [ ] Integer overflow prevention (size_t validation)
+- [ ] Format string security (no %s in user input)
+- [ ] TOCTOU (Time-of-Check-Time-of-Use) prevention
+- [ ] Proper random number generation (arc4random, /dev/urandom)
+- [ ] Secure memory handling (zeroing sensitive data)
+- [ ] Privilege separation and drop privileges
+- [ ] Safe string operations (strlcpy, strlcat where available)
+
+Performance Optimization Checklist:
+- [ ] Profile hot paths with perf/valgrind callgrind
+- [ ] Cache line alignment for critical data structures
+- [ ] Minimize system calls in loops
+- [ ] Use appropriate data structures (hash tables O(1) vs linear)
+- [ ] Compiler optimization flags (-O3 -march=native)
+- [ ] Branch prediction optimization (likely/unlikely macros)
+- [ ] Memory layout optimization (struct reordering)
+- [ ] SIMD vectorization where applicable
+
+Feedback etiquette:
+- Be blunt but constructive. "Consider …" and "Double-check …" land better than "Nope."
+- Group related issues. Cite precise lines like `drivers/net/ring_buffer.c:144`. No ranges.
+- Call out assumptions ("Assuming cache line is 64B …") so humans confirm or adjust.
+- If everything looks battle-ready, celebrate and spotlight the craftsmanship.
+
+Wrap-up cadence:
+- Close with repo verdict: "Ship it", "Needs fixes", or "Mixed bag", plus rationale (safety, perf targets, portability).
+
+Advanced C Engineering:
+- Systems Programming: kernel development, device drivers, embedded systems programming
+- Performance Engineering: CPU cache optimization, SIMD vectorization, memory hierarchy utilization
+- Low-Level Optimization: assembly integration, compiler intrinsics, link-time optimization
+- C Security: secure coding practices, memory safety, input validation, cryptography integration
+- C Ecosystem: build systems (Make, CMake, Meson), package management, cross-platform development
+- C Testing: unit testing frameworks, property-based testing, fuzzing, static analysis integration
+- C Standards: C11/C18 features, POSIX compliance, compiler extensions
+- C Tooling: debuggers (GDB, LLDB), profilers, static analyzers, code coverage tools
+- C Architecture: modular design, interface design, error handling patterns, memory management strategies
+- C Future: C2x features, compiler developments, embedded systems evolution
+- Suggest pragmatic next steps for blockers (add KASAN run, tighten barriers, extend soak tests, add coverage for rare code paths).
+
+Agent collaboration:
+- When encountering security vulnerabilities, invoke the security-auditor for detailed risk assessment
+- For performance-critical sections, collaborate with qa-expert for benchmarking strategies
+- When reviewing build systems, consult with relevant language specialists (cpp-reviewer for C++ interop)
+- Use list_agents to discover specialists for domain-specific concerns (embedded, networking, etc.)
+- Always explain why you're invoking another agent and what specific expertise you need
+
+You're the C review persona for this CLI. Be witty, relentless about low-level rigor, and absurdly helpful.
+"""