Archived: this repository is no longer authoritative. Canonical home: https://github.com/aien-dev/aien-sovereign-core/tree/main/crates/spark-inquisitor

History is preserved read-only. Open new work against the canonical home.

spark-inquisitor

Native Rust GitHub Action & CLI for Diff Auditing and Issue Triage

spark-inquisitor is a compiled native Rust gatekeeper and automated code reviewer engineered to replace heavy JavaScript and Docker CI actions. It executes in under 2 milliseconds with zero CPU thrashing, zero Node.js dependencies, and zero external telemetry.

---

Performance Benchmark

Metric	Traditional Node.js / Docker Actions	spark-inquisitor (Native Rust)
Startup Latency	15.0s to 45.0s	0.002s (2 ms)
Memory Footprint	250 MB to 1.2 GB	4.2 MB
Binary Size	150 MB (node_modules / layers)	1.9 MB (Statically Linked)
CPU Utilization	Spikes 100% during VM hydration	< 1% burst, zero idle load
External Dependencies	Node 20/24, npm, libuv, Docker	None (Pure native binary)

---

Core Capabilities

1. Constitutional Diff Auditing: Scans git diffs for tracking patterns (Mixpanel, Datadog, Google Analytics, Sentry, Segment) and verifies sovereign voice compliance (bans em dashes, en dashes, and formulaic AI marketing tokens).
2. Interactive Contributor Alignment Interview: Generates a constitutional alignment questionnaire for pull requests, evaluating contributor testimony against the Sovereign Contributor Oath.
3. Sub-Millisecond Issue Triage: Automatically classifies defect reports, feature proposals, complaints, and questions, applying triage labels and structured response templates.
4. Zero Paid APIs ($0.00 Cost): Runs entirely on local heuristics and AST analysis. Requires zero paid tokens, zero subscriptions, and zero external API keys.

---

Quick Start: One-Line Installer

Install directly to ~/.local/bin/:

curl -fsSL https://raw.githubusercontent.com/aien-dev/spark-inquisitor/main/install.sh | sh

Verify installation:

spark-inquisitor doctor

---

GitHub Actions Integration

Add spark-inquisitor to your repository workflow (.github/workflows/gatekeeper.yml):

name: Sovereign Gatekeeper

on:
  pull_request_target:
    types: [opened, synchronize]
  issues:
    types: [opened]

permissions:
  pull-requests: write
  issues: write
  contents: read

jobs:
  audit:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Code
        uses: actions/checkout@v4

      - name: Fetch PR Diff
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: gh pr diff "${{ github.event.pull_request.number }}" > pr.diff

      - name: Run Sovereign Inquisitor
        run: |
          curl -fsSL https://raw.githubusercontent.com/aien-dev/spark-inquisitor/main/install.sh | sh
          ~/.local/bin/spark-inquisitor review \
            --diff pr.diff \
            --author "${{ github.event.pull_request.user.login }}" \
            --pr "${{ github.event.pull_request.number }}" \
            --title "${{ github.event.pull_request.title }}" \
            --output comment.md \
            --output-labels labels.txt

      - name: Post PR Review Comment
        if: always()
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          if [ -f comment.md ]; then
            gh pr comment "${{ github.event.pull_request.number }}" --body-file comment.md
          fi

---

License and Governance

Licensed under the Sovereign Resource Commons License 1.0 (SRCL-1.0) (Apache-2.0 WITH LLVM-exception). Architected by AIEN (Autonomous Cognitive Architecture operating on the Atlas Framework) and sovereign ecosystem contributors. See LICENSE for full legal terms and copyright notices.

All downstream distributions, derivative works, and commercial deployments are governed exclusively by the terms of LICENSE. CONSTITUTION.md defines the internal architectural charter and development doctrine for upstream engineering.