ultimate-pi 0.2.3 → 0.2.5

package/.ckignore

@@ -1,41 +0,0 @@
-# .ckignore
-
-# Build artifacts (not useful for understanding code)
-target/
-dist/
-build/
-*.o
-*.so
-*.dylib
-
-# Dependencies (too large, low signal)
-node_modules/
-vendor/
-venv/
-.venv/
-
-# Media files (not code)
-*.png
-*.jpg
-*.gif
-*.mp4
-*.pdf
-
-<!-- # Large data files
-*.csv
-*.json
-*.xml
-*.log -->
-
-# Test fixtures (unless you search them)
-fixtures/
-__snapshots__/
-*.snap
-
-<!-- # Generated code (if not relevant)
-*_pb2.py
-*.generated.*
-
-# Documentation (include if you want AI to reference docs)
-# docs/
-# *.md -->

package/.env.example

@@ -1,21 +0,0 @@
-POSTHOG_PERSONAL_API_KEY="phx_your_personal_api_key"
-POSTHOG_API_KEY="phc_your_project_key"
-# narrow the tool surface
-POSTHOG_MCP_FEATURES="llm_analytics"
-POSTHOG_PROJECT_NAME="ultimate-pi"
-POSTHOG_PRIVACY_MODE="false"
-# Harness domain events (harness-telemetry.ts); set false to disable harness_* only
-HARNESS_TELEMETRY_ENABLED="true"
-# Optional: require Sentrux stub for npm run harness:verify
-# HARNESS_SENTRUX_REQUIRED="true"
-FIRECRAWL_API_KEY="fc_your_firecrawl_api_key"
-FIRECRAWL_API_URL="http://localhost:3002"
-# FIRECRAWL_NO_TELEMETRY=0
-VAULT_WIKI_PATH="vault/wiki"
-CURSOR_API_KEY=""
-PI_VCC_CONFIG_PATH=".pi/pi-vcc-config.json"
-# VCC config: points to project-level pi-vcc config (overrideDefaultCompaction, debug)
-
-# graphify headless extract
-OPENAI_API_KEY="sk-your_openai_api_key"
-OPENAI_API_BASE="https://opencode.ai/zen/go/v1"

package/.gitattributes

@@ -1 +0,0 @@
-data/books/**/*.pdf filter=lfs diff=lfs merge=lfs -text

package/.github/workflows/lint.yml

@@ -1,33 +0,0 @@
-name: Lint and Format
-
-on:
-  push:
-    branches:
-      - main
-      - master
-  pull_request:
-    branches:
-      - main
-      - master
-
-jobs:
-  lint:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: "npm"
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run Biome check (Lint & Format)
-        run: npm run lint
-
-      - name: Run TypeScript check
-        run: npm run check:ts

package/.github/workflows/publish-github-packages.yml

@@ -1,35 +0,0 @@
-name: Publish to GitHub Packages
-run-name: Publish GitHub package from ${{ github.ref_name }}
-
-on:
-  push:
-    tags:
-      - 'v*'
-  workflow_dispatch:
-
-jobs:
-  publish-github-packages:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      packages: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js for GitHub Packages
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22.14.0'
-          registry-url: 'https://npm.pkg.github.com'
-          scope: '@aryaniyaps'
-
-      - name: Prepare scoped package manifest for GitHub Packages
-        run: |
-          npm pkg set name='@aryaniyaps/ultimate-pi'
-          npm pkg set publishConfig.registry='https://npm.pkg.github.com'
-
-      - name: Publish package to GitHub Packages
-        run: npm publish --ignore-scripts
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/publish-npm.yml

@@ -1,32 +0,0 @@
-name: Publish to npm
-run-name: Publish npm from ${{ github.ref_name }}
-
-on:
-  push:
-    tags:
-      - 'v*'
-  workflow_dispatch:
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22.14.0'
-
-      - name: Ensure npm trusted publishing minimum version
-        run: |
-          npm i -g npm@^11.5.1
-          node -v
-          npm -v
-
-      - name: Publish package
-        run: npm publish --provenance --access public --ignore-scripts

package/CONTRIBUTING.md

@@ -1,166 +0,0 @@
-# Contributing to ultimate-pi
-
-## Local development setup
-
-1. Clone and install dependencies:
-
-   ```bash
-   git clone https://github.com/aryaniyaps/ultimate-pi.git
-   cd ultimate-pi
-   npm install
-   ```
-
-   `npm install` automatically sets up pre-commit hooks via [Lefthook](https://github.com/evilmartians/lefthook).
-
-2. Install the package locally into PI:
-
-   ```bash
-   pi install . -l
-   ```
-
-   Then restart PI or run `/reload`.
-
-## Linting & formatting
-
-Uses [Biome](https://biomejs.dev) for linting, formatting, and import sorting.
-
-```bash
-npm run lint            # check lint + format errors
-npm run lint:fix        # auto-fix lint + format errors
-npm run format          # format all files
-npm run format:check    # check formatting without writing
-npm run check:ts        # typecheck extensions
-```
-
-Pre-commit hooks run `biome check` and `tsc` on staged files automatically.
-
-## Sentrux (architectural quality gate)
-
-[Sentrux](https://github.com/sentrux/sentrux) provides real-time structural quality metrics for AI-agent-written code. It acts as a feedback loop sensor — scanning codebase architecture, detecting degradation, and enforcing rules via MCP.
-
-### Quick start
-
-```bash
-# Install (macOS / Linux / Windows)
-curl -fsSL https://raw.githubusercontent.com/sentrux/sentrux/main/install.sh | sh
-
-# Install all 52 language plugins
-sentrux plugin add-standard
-
-# Run a quality scan
-sentrux check .
-
-# Save baseline before agent session
-sentrux gate --save .
-
-# Compare after — catches degradation
-sentrux gate .
-```
-
-### MCP Integration
-
-The sentrux MCP server is configured in `.pi/mcp.json`. Agents can use tools like `scan`, `session_start`, `session_end`, `check_rules`, `health`, and `evolution` to monitor code quality during development.
-
-### Rules Engine
-
-Create `.sentrux/rules.toml` to define architectural constraints:
-
-```toml
-[constraints]
-max_cycles = 0
-max_coupling = "B"
-max_cc = 25
-no_god_files = true
-```
-
-## Firecrawl (self-hosted web scraping)
-
-The Firecrawl skill depends on a Firecrawl instance. This repo includes a self-hosted setup powered by Docker.
-
-### Quick start
-
-```bash
-cd firecrawl
-cp .env.template .env   # first time only — edit if needed
-docker compose up -d     # pulls pre-built GHCR images automatically
-```
-
-Firecrawl API is now at `http://localhost:3002`. Admin UI at `http://localhost:3002/admin/<BULL_AUTH_KEY>/queues`.
-
-### Services
-
-| Service | Image | Port |
-|---------|-------|------|
-| `api` | `ghcr.io/firecrawl/firecrawl` | 3002 |
-| `playwright-service` | `ghcr.io/firecrawl/playwright-service:latest` | 3000 (internal) |
-| `nuq-postgres` | `ghcr.io/firecrawl/nuq-postgres:latest` | 5432 (internal) |
-| `redis` | `redis:alpine` | 6379 (internal) |
-| `rabbitmq` | `rabbitmq:3-management` | 5672 (internal) |
-| `searxng` | `searxng/searxng:latest` | 8080 |
-
-### Configuration
-
-All options live in `firecrawl/.env`. See `firecrawl/.env.template` for the full reference. Key env vars:
-
-- `PORT` — API port (default: `3002`)
-- `SEARXNG_ENDPOINT` — enables `/search` API (default: `http://searxng:8080`)
-- `OPENAI_API_KEY` — enables AI features (JSON formatting, `/extract` API)
-- `BULL_AUTH_KEY` — admin UI access key (default: `CHANGEME` — change in production)
-
-See `firecrawl/README.md` for detailed docs and SDK usage examples.
-
-## Extensions
-
-### Dotenv loader
-
-`.pi/extensions/dotenv-loader.ts` — loads `.env` files into `process.env` on session start.
-
-Configurable via env vars (set before launching pi):
-
-| Variable | Default | Description |
-|---|---|---|
-| `ENV_LOADER_FILES` | `.env` | Comma-separated list of `.env` file paths (relative to cwd). |
-| `ENV_LOADER_OVERRIDE` | `false` | Set to `true` to overwrite existing env vars. |
-| `ENV_LOADER_SILENT` | `false` | Set to `true` to suppress startup logs. |
-| `ENV_LOADER_ENCODING` | `utf-8` | File encoding for `.env` files. |
-
-- Supports variable expansion (`$VAR` and `${VAR}`).
-- Reloads on `/reload`.
-- Status command: `/env-loader-status`
-
-### Harness governance extensions
-
-These Pi extensions are loaded from `.pi/extensions/` via the root `package.json`
-`pi.extensions` manifest (no extra registration needed):
-
-- `.pi/extensions/policy-gate.ts` — plan-before-mutate + phase enforcement
-- `.pi/extensions/budget-guard.ts` — budget hard-stop and `budget_exhausted` events
-- `.pi/extensions/trace-recorder.ts` — run trace artifacts in `.pi/harness/runs/`
-- `.pi/extensions/review-integrity.ts` — evaluator/adversary session isolation checks
-- `.pi/extensions/test-diff-integrity.ts` — suspicious test diff detection/escalation
-- `.pi/extensions/debate-orchestrator.ts` — headless debate bus + consensus packets
-
-### PostHog analytics
-
-`@posthog/pi` — wraps the upstream [posthog-pi](https://github.com/PostHog/posthog-pi) extension to capture AI generation spans, tool spans, and traces in [PostHog](https://posthog.com). Install via `pi install @posthog/pi`. See the upstream repo for configuration and env vars.
-
-## Skill sources
-
-| Skill | Upstream |
-|---|---|
-| caveman | [juliusbrussee/caveman](https://github.com/juliusbrussee/caveman) |
-| context7-cli | [upstash/context7](https://github.com/upstash/context7) |
-| find-skills | bundled (context7-compatible discovery) |
-| firecrawl (13 skills) | [firecrawl](https://firecrawl.dev) |
-| obsidian/wiki skills (11 skills) | [AgriciDaniel/claude-obsidian](https://github.com/AgriciDaniel/claude-obsidian) |
-| posthog-analyst | bundled (PostHog MCP integration) |
-
-### Firecrawl sub-skills
-
-`firecrawl-search`, `firecrawl-scrape`, `firecrawl-crawl`, `firecrawl-map`, `firecrawl-download`, `firecrawl-parse`, `firecrawl-interact`, `firecrawl-agent`, `firecrawl-build-scrape`, `firecrawl-build-search`, `firecrawl-build-onboarding`, `firecrawl-build-interact`
-
-### Wiki sub-skills
-
-`wiki`, `wiki-save`, `wiki-query`, `wiki-ingest`, `wiki-lint`, `wiki-fold`, `autoresearch`, `canvas`, `obsidian-markdown`, `obsidian-bases`
-
-> `context-mode` is installed as a separate pi package (`npm:context-mode`) — not bundled as a skill.

package/lefthook.yml

@@ -1,9 +0,0 @@
-pre-commit:
-  commands:
-    lint:
-      glob: "*.{ts,js,json}"
-      exclude: "graphify-out/**/*"
-      run: npx @biomejs/biome check --no-errors-on-unmatched --write {staged_files}
-    typecheck:
-      glob: "*.ts"
-      run: npm run check:ts