v1.0.0

Declarative Nix configuration framework for the Pi coding agent, with typed modules, packaged extensions and skills, reusable profiles, and host integrations.

Highlights of the v1.0.0 Architecture

• Unified Multi-Platform Modules: One shared programs.pi schema across standalone packages (makePi), Home Manager (homeModules.default), NixOS (nixosModules.default), and nix-darwin (nixDarwinModules.default).
• Nixvim-Inspired Extensibility: Module factories (mkPiExtensionModule, mkPiSkillModule, mkPiProviderModule), builder evaluation helpers (makePi, evalPi), and passthru.extend.
• First-Class Providers & Resources: Type-checked providers (e.g. Antigravity, OpenAI, Anthropic, Ollama), secret-safe configuration with environment.required, and auto-configured runtime paths.
• Contract & Integration Test Matrix: Cross-platform CI coverage across x86_64 Linux, ARM Linux, Apple Silicon macOS, and Intel macOS.
• Self-Documenting Schema: Live module option documentation built from source (nix build .#docs).

Changelog

🚀 Features

• flake: Export unified multi-platform modules and makePi builders
• flake: Include bundled extension and skill modules in platform outputs
• flake: Wire flake outputs, packages, checks, and formatting
• integrations: Add unified NixOS (nixosModules.default) and nix-darwin (nixDarwinModules.default) modules
• integrations: Add Home Manager module (homeModules.default)
• core: Add escape hatch options and assertion propagation
• core: Add core Pi module system and settings generator
• lib: Expose canonical namespace lib.nixpi and overlay overlays.default
• lib: Add passthru.extend and module factories (mkPiExtensionModule, mkPiSkillModule, mkPiProviderModule)
• lib: Add core packaging and resource helpers (mkPiExtension, mkPiSkill, mkPiPrompt, mkPiProvider)
• runtime: Validate required environment variables before launch
• providers: Add first-class provider objects and Antigravity provider support
• extensions: Add pi-gpt-search extension module and package
• extensions: Add research-tools extension with MCP bridges and isolation guardrails
• skills: Add declarative skill declaration and commit-style skill in 100% Nix
• skills: Add 8 evidence-first legal opportunity research skills
• prompts: Add research-lawyer-opportunities reusable Pi prompt
• templates: Add standalone, home-manager, and devshell templates
• ledger: Add DuckDB schema and management CLI for legal evidence ledger
• profile: Add legal-research profile, package, and verification check

🐛 Bug Fixes & Compatibility

• models: Filter nulls from model lists in generated JSON
• compat: Restore Intel macOS support
• compat: Preserve public 1.x output names and add migration warnings
• skills: Quote and JSON-escape YAML frontmatter descriptions in mkPiSkill

🚜 Refactor

• flake: Separate output families into clean modular files (flake/modules.nix, flake/packages.nix, flake/checks.nix, flake/legacy-packages.nix, flake/templates.nix)
• modules: Establish a reusable base layer
• flake: Decouple downstream deep-comprehension-engine from nixpi

📚 Documentation

• site: Publish complete documentation website built with mdBook and nixosOptionsDoc
• guides: Add Getting Started, Everyday Usage & direnv, and Templates guides
• reference: Add Library API, Flake Outputs, and Generated Option references
• adr: Add ADR-0002 on adopting Nixvim architectural patterns
• project: Add contribution, maintainer, compatibility, and release policies

🧪 Testing & CI

• ci: Add cross-platform quality gates across Ubuntu, ARM Linux, Apple Silicon macOS, and Intel macOS
• docker: Add multi-platform container integration tests for minimal, features, and provider scenarios
• test: Add comprehensive test suites for eval, build, extend, factory, legacyPackages, public-api-contract, nixos, darwin, and home-manager
• style: Format Nix files with nixfmt

Full Changelog: https://github.com/mateusdcc/nixpi/commits/v1.0.0