ninjastack 0.1.0__tar.gz

ninjastack-0.1.0/.githooks/pre-commit

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -e
+
+# Get staged .py files
+STAGED=$(git diff --cached --name-only --diff-filter=ACM | grep '\.py$' || true)
+
+if [ -n "$STAGED" ]; then
+    echo "🔧 Running ruff fix + format on staged Python files..."
+    echo "$STAGED" | xargs uv run ruff check --fix --quiet
+    echo "$STAGED" | xargs uv run ruff format --quiet
+    echo "$STAGED" | xargs git add
+fi

ninjastack-0.1.0/.githooks/pre-push

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -e
+
+echo "🧪 Running tests before push..."
+make test
+
+if [ $? -ne 0 ]; then
+    echo "❌ Tests failed. Push blocked."
+    exit 1
+fi
+
+echo "✅ All tests passed."

ninjastack-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,16 @@
+## What
+Closes #
+
+## Changes
+-
+
+## Testing
+- [ ] All existing tests pass (`make test`)
+- [ ] New tests added for new functionality
+- [ ] Coverage maintained above 85%
+
+## Checklist
+- [ ] Branch based on latest `main`
+- [ ] Conventional commit messages
+- [ ] No new linting warnings (`make lint`)
+- [ ] No business logic in `apps/` — all logic in `libs/`

ninjastack-0.1.0/.github/scripts/planning_generate.py

@@ -0,0 +1,102 @@
+"""Planning Agent — generates implementation plans for GitHub issues."""
+
+import json
+import os
+import urllib.request
+
+
+def main():
+    issue_title = os.environ.get("ISSUE_TITLE", "")
+    issue_body = os.environ.get("ISSUE_BODY", "")
+
+    with open("/tmp/repo_files.txt") as f:
+        repo_structure = f.read()
+    with open("/tmp/relevant_code.md") as f:
+        relevant_code = f.read()[:40000]
+    with open("/tmp/triage_comment.txt") as f:
+        triage_analysis = f.read()
+
+    prompt = f"""You are a principal software engineer creating an implementation plan for a GitHub issue in the NinjaStack monorepo — a schema-first agentic backend framework (Python, Google ADK, Pydantic, pytest).
+
+## Issue
+**Title:** {issue_title}
+**Body:** {issue_body}
+
+## Prior Triage Analysis
+{triage_analysis}
+
+## Repo Structure
+{repo_structure}
+
+## Relevant Source Code
+{relevant_code}
+
+## Your Task
+Create a detailed, actionable implementation plan. Be specific about file paths, function signatures, and test cases.
+
+Respond in this exact markdown format:
+
+### 📋 Implementation Plan
+
+#### Objective
+(what this change accomplishes)
+
+#### Approach
+(high-level strategy — 2-3 sentences)
+
+#### Changes
+
+**1. `path/to/file.py`**
+- What to change and why
+- Specific functions/classes affected
+
+**2. `path/to/another.py`**
+- ...
+
+#### New Files (if any)
+- `path/to/new_file.py` — purpose
+
+#### Test Plan
+- [ ] Test case 1 — description
+- [ ] Test case 2 — description
+- Where tests should live: `libs/xxx/tests/test_xxx.py`
+
+#### Acceptance Criteria
+- [ ] Criterion 1
+- [ ] Criterion 2
+- [ ] All existing tests pass
+- [ ] New tests added and passing
+
+#### Risk Assessment
+**Risk:** Low / Medium / High
+**Breaking changes:** Yes / No
+**Migration needed:** Yes / No
+"""
+
+    body = json.dumps({
+        "model": "gpt-5.2",
+        "messages": [{"role": "user", "content": prompt}],
+        "max_completion_tokens": 3000,
+        "temperature": 0.2,
+    }).encode()
+
+    req = urllib.request.Request(
+        "https://api.openai.com/v1/chat/completions",
+        data=body,
+        headers={
+            "Authorization": f"Bearer {os.environ['OPENAI_API_KEY']}",
+            "Content-Type": "application/json",
+        },
+    )
+    resp = urllib.request.urlopen(req)
+    result = json.loads(resp.read())
+    plan = result["choices"][0]["message"]["content"]
+
+    with open("/tmp/plan.md", "w") as f:
+        f.write(plan)
+
+    print("Plan generated.")
+
+
+if __name__ == "__main__":
+    main()

ninjastack-0.1.0/.github/scripts/triage_analyze.py

@@ -0,0 +1,105 @@
+"""Triage Agent — analyzes GitHub issues against the codebase."""
+
+import json
+import os
+import sys
+import urllib.request
+
+
+def main():
+    issue_title = os.environ.get("ISSUE_TITLE", "")
+    issue_body = os.environ.get("ISSUE_BODY", "")
+    labels = os.environ.get("ISSUE_LABELS", "")
+
+    with open("/tmp/context.md") as f:
+        repo_structure = f.read()
+    with open("/tmp/relevant_code.md") as f:
+        relevant_code = f.read()[:30000]
+    with open("/tmp/test_output.txt") as f:
+        test_output = f.read()
+
+    is_bug = "bug" in labels.lower()
+
+    task = (
+        "This is a BUG report. Identify the likely root cause, affected files, and whether existing tests cover this area."
+        if is_bug
+        else "This is a FEATURE/ENHANCEMENT request. Assess feasibility, identify affected components, and flag any architectural conflicts."
+    )
+
+    rc_or_feasibility = "Root Cause" if is_bug else "Feasibility Assessment"
+
+    prompt = f"""You are a senior software engineer triaging a GitHub issue for the NinjaStack monorepo — a schema-first agentic backend framework.
+
+## Issue
+**Title:** {issue_title}
+**Body:** {issue_body}
+**Labels:** {labels}
+
+## Repo Structure
+{repo_structure}
+
+## Relevant Code
+{relevant_code}
+
+## Test Results
+{test_output}
+
+## Your Task
+{task}
+
+Respond in this exact markdown format:
+
+### 🔍 Triage Analysis
+
+**Type:** Bug / Feature / Question / Invalid
+**Confidence:** High / Medium / Low
+**Recommendation:** `planning` or `wontfix`
+
+#### Summary
+(1-2 sentence summary of your findings)
+
+#### {rc_or_feasibility}
+(detailed analysis)
+
+#### Affected Files
+- `path/to/file.py` — reason
+
+#### Test Coverage
+(are there existing tests? what gaps exist?)
+
+#### Suggested Approach
+(brief implementation direction if recommending `planning`)
+"""
+
+    body = json.dumps({
+        "model": "gpt-5.2",
+        "messages": [{"role": "user", "content": prompt}],
+        "max_completion_tokens": 2000,
+        "temperature": 0.2,
+    }).encode()
+
+    req = urllib.request.Request(
+        "https://api.openai.com/v1/chat/completions",
+        data=body,
+        headers={
+            "Authorization": f"Bearer {os.environ['OPENAI_API_KEY']}",
+            "Content-Type": "application/json",
+        },
+    )
+    try:
+        resp = urllib.request.urlopen(req)
+    except urllib.request.HTTPError as e:
+        error_body = e.read().decode()
+        print(f"OpenAI API error {e.code}: {error_body}", file=sys.stderr)
+        sys.exit(1)
+    result = json.loads(resp.read())
+    analysis = result["choices"][0]["message"]["content"]
+
+    with open("/tmp/analysis.md", "w") as f:
+        f.write(analysis)
+
+    print("Analysis complete.")
+
+
+if __name__ == "__main__":
+    main()

ninjastack-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: Install dependencies
+        run: uv sync
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Format check
+        run: uv run ruff format --check .
+
+      - name: Test
+        run: uv run pytest libs/ apps/ -v --tb=short --cov --cov-report=term-missing

ninjastack-0.1.0/.github/workflows/pages.yml

@@ -0,0 +1,46 @@
+name: Deploy Site & Docs
+
+on:
+  push:
+    branches: [main]
+    paths: ['site/**', 'docs/**', 'mkdocs.yml']
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Install dependencies
+        run: uv sync --frozen
+
+      - name: Build docs
+        run: uv run mkdocs build
+
+      - uses: actions/configure-pages@v5
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+      - id: deployment
+        uses: actions/deploy-pages@v4

ninjastack-0.1.0/.github/workflows/planning-agent.yml

@@ -0,0 +1,72 @@
+name: Planning Agent
+
+on:
+  issues:
+    types: [labeled]
+
+jobs:
+  plan:
+    if: github.event.label.name == 'planning'
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Gather context
+        env:
+          ISSUE_TITLE: ${{ github.event.issue.title }}
+          ISSUE_BODY: ${{ github.event.issue.body }}
+        run: |
+          find libs apps -type f -name "*.py" | head -200 > /tmp/repo_files.txt
+          echo "" > /tmp/relevant_code.md
+          keywords=$(echo "$ISSUE_TITLE $ISSUE_BODY" | tr '[:upper:]' '[:lower:]' | grep -oE '[a-z_]{4,}' | sort -u | head -15)
+          for kw in $keywords; do
+            matches=$(grep -rl --include="*.py" "$kw" libs/ apps/ 2>/dev/null | head -3)
+            for f in $matches; do
+              echo "" >> /tmp/relevant_code.md
+              echo "### $f" >> /tmp/relevant_code.md
+              cat "$f" >> /tmp/relevant_code.md
+            done
+          done
+          head -c 40000 /tmp/relevant_code.md > /tmp/rc_trimmed.md
+          mv /tmp/rc_trimmed.md /tmp/relevant_code.md
+          echo "" > /tmp/triage_comment.txt
+
+      - name: Fetch triage analysis comment
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const comments = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number
+            });
+            const triageComment = comments.data.find(c => c.body.includes('Triage Agent'));
+            if (triageComment) {
+              fs.writeFileSync('/tmp/triage_comment.txt', triageComment.body);
+            }
+
+      - name: Generate plan with GPT 5.2
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          ISSUE_TITLE: ${{ github.event.issue.title }}
+          ISSUE_BODY: ${{ github.event.issue.body }}
+        run: python .github/scripts/planning_generate.py
+
+      - name: Post plan comment
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const plan = fs.readFileSync('/tmp/plan.md', 'utf8');
+            const body = `## 🤖 Planning Agent\n\n${plan}\n\n---\n_React with 👍 to approve, or comment \`/approve\` to move to \`todo\`._`;
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body
+            });

ninjastack-0.1.0/.github/workflows/planning-approve.yml

@@ -0,0 +1,51 @@
+name: Planning Approval
+
+on:
+  issue_comment:
+    types: [created]
+
+jobs:
+  check-reaction:
+    # Only trigger on reactions to planning agent comments
+    # We use a polling approach since GitHub doesn't have a native reaction event for issue comments
+    if: false  # Disabled — using workflow_dispatch polling instead
+    runs-on: ubuntu-latest
+    steps: []
+
+  # Alternative: maintainer comments /approve
+  approve:
+    if: >-
+      github.event.comment.body == '/approve' &&
+      (github.event.comment.author_association == 'OWNER' || github.event.comment.author_association == 'MEMBER')
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+      - name: Move to todo
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const issue = context.issue.number;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+
+            // Remove planning label
+            try {
+              await github.rest.issues.removeLabel({ owner, repo, issue_number: issue, name: 'planning' });
+            } catch (e) {}
+
+            // Add todo label
+            await github.rest.issues.addLabels({ owner, repo, issue_number: issue, labels: ['todo'] });
+
+            // Acknowledge
+            await github.rest.reactions.createForIssueComment({
+              owner, repo,
+              comment_id: context.payload.comment.id,
+              content: '+1'
+            });
+
+            await github.rest.issues.createComment({
+              owner, repo,
+              issue_number: issue,
+              body: '✅ Plan approved. Issue moved to `todo` — ready for implementation.'
+            });

ninjastack-0.1.0/.github/workflows/static.yml

@@ -0,0 +1,43 @@
+# Simple workflow for deploying static content to GitHub Pages
+name: Deploy static content to Pages
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["main"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Single deploy job since we're just deploying
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          # Upload entire repository
+          path: './site'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

ninjastack-0.1.0/.github/workflows/triage-agent.yml

@@ -0,0 +1,78 @@
+name: Triage Agent
+
+on:
+  issues:
+    types: [labeled]
+
+jobs:
+  analyze:
+    if: github.event.label.name == 'triage'
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          pip install uv
+          uv sync
+
+      - name: Generate repo structure
+        run: |
+          find libs apps -type f -name "*.py" | head -200 > /tmp/repo_files.txt
+          echo "## Repo Structure" > /tmp/context.md
+          cat /tmp/repo_files.txt >> /tmp/context.md
+
+      - name: Search codebase for relevant files
+        env:
+          ISSUE_TITLE: ${{ github.event.issue.title }}
+          ISSUE_BODY: ${{ github.event.issue.body }}
+        run: |
+          echo "## Relevant Code Snippets" > /tmp/relevant_code.md
+          keywords=$(echo "$ISSUE_TITLE $ISSUE_BODY" | tr '[:upper:]' '[:lower:]' | grep -oE '[a-z_]{4,}' | sort -u | head -15)
+          for kw in $keywords; do
+            matches=$(grep -rl --include="*.py" "$kw" libs/ apps/ 2>/dev/null | head -5)
+            for f in $matches; do
+              echo "" >> /tmp/relevant_code.md
+              echo "### $f" >> /tmp/relevant_code.md
+              head -100 "$f" >> /tmp/relevant_code.md
+            done
+          done
+          head -c 30000 /tmp/relevant_code.md > /tmp/rc_trimmed.md
+          mv /tmp/rc_trimmed.md /tmp/relevant_code.md
+
+      - name: Run tests
+        continue-on-error: true
+        run: |
+          source .venv/bin/activate
+          python -m pytest --tb=short 2>&1 | tail -50 > /tmp/test_output.txt
+
+      - name: Analyze with GPT 5.2
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+          ISSUE_TITLE: ${{ github.event.issue.title }}
+          ISSUE_BODY: ${{ github.event.issue.body }}
+          ISSUE_LABELS: ${{ join(github.event.issue.labels.*.name, ', ') }}
+        run: python .github/scripts/triage_analyze.py
+
+      - name: Post analysis comment
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const fs = require('fs');
+            const analysis = fs.readFileSync('/tmp/analysis.md', 'utf8');
+            const body = `## 🤖 Triage Agent\n\n${analysis}\n\n---\n_Automated analysis by NinjaStack Triage Agent. A maintainer will review and label accordingly._`;
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body
+            });

ninjastack-0.1.0/.github/workflows/triage.yml

@@ -0,0 +1,23 @@
+name: Issue Triage
+
+on:
+  issues:
+    types: [opened]
+
+jobs:
+  triage:
+    if: github.actor != 'codeninja'
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+      - name: Add triage label
+        uses: actions/github-script@v7
+        with:
+          script: |
+            await github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              labels: ['triage']
+            });

ninjastack-0.1.0/.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+dist/
+build/
+.venv/
+.eggs/
+
+# Testing / Coverage
+.coverage
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+
+# Node
+node_modules/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Ninja Stack (secrets in state)
+.ninjastack/connections.json
+.ninjastack/auth.json
+
+# Build artifacts
+*.whl
+site/docs/

ninjastack-0.1.0/.nvmrc

@@ -0,0 +1 @@
+v22

ninjastack-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12