augint-org 0.1.0__tar.gz

augint_org-0.1.0/.claude/settings.json

@@ -0,0 +1,204 @@
+{
+  "env": {
+    "PYTHONDONTWRITEBYTECODE": "1",
+    "PIP_REQUIRE_VIRTUALENV": "true",
+    "DISABLE_TELEMETRY": "1",
+    "CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR": "1",
+    "BASH_MAX_TIMEOUT_MS": "600000"
+  },
+  "permissions": {
+    "allow": [
+      "Bash(npm ci:*)",
+      "Bash(npm install:*)",
+      "Bash(npm run:*)",
+      "Bash(npm test:*)",
+      "Bash(pytest:*)",
+      "Bash(python -m pytest:*)",
+      "Bash(ruff:*)",
+      "Bash(mypy:*)",
+      "Bash(black:*)",
+      "Bash(isort:*)",
+      "Bash(flake8:*)",
+      "Bash(bandit:*)",
+      "Bash(safety:*)",
+      "Bash(pre-commit:*)",
+      "Bash(uv run pre-commit:*)",
+      "Bash(uv run bandit:*)",
+      "Bash(uv run pip-audit:*)",
+      "Bash(uv run pip-licenses:*)",
+      "Bash(uv export:*)",
+      "Bash(uv run:*)",
+      "Bash(uv sync:*)",
+      "Bash(uv build:*)",
+      "Bash(uv add:*)",
+      "Bash(uv remove:*)",
+      "Bash(uv lock:*)",
+      "Bash(uv tree:*)",
+      "Bash(uv --version:*)",
+      "Bash(uv pip list:*)",
+      "Bash(uv pip show:*)",
+      "Bash(git status:*)",
+      "Bash(git diff:*)",
+      "Bash(git log:*)",
+      "Bash(git branch:*)",
+      "Bash(git checkout:*)",
+      "Bash(git fetch:*)",
+      "Bash(git pull:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git stash:*)",
+      "Bash(git rebase:*)",
+      "Bash(git merge:*)",
+      "Bash(git remote:*)",
+      "Bash(git show:*)",
+      "Bash(git tag:*)",
+      "Bash(git describe:*)",
+      "Bash(git rev-parse:*)",
+      "Bash(git rev-list:*)",
+      "Bash(git for-each-ref:*)",
+      "Bash(git merge-base:*)",
+      "Bash(git symbolic-ref:*)",
+      "Bash(git ls-remote:*)",
+      "Bash(git fsck:*)",
+      "Bash(git bundle:*)",
+      "Bash(git reflog:*)",
+      "Bash(git gc:*)",
+      "Bash(git repack:*)",
+      "Bash(git config --get:*)",
+      "Bash(git config --list:*)",
+      "Bash(git config --get-regexp:*)",
+      "Bash(git config --show-origin:*)",
+      "Bash(git show-ref:*)",
+      "Bash(git push origin feat/*)",
+      "Bash(git push origin fix/*)",
+      "Bash(git push origin docs/*)",
+      "Bash(git push origin test/*)",
+      "Bash(git push origin refactor/*)",
+      "Bash(git push origin perf/*)",
+      "Bash(git push origin chore/*)",
+      "Bash(git push origin ci/*)",
+      "Bash(git push origin build/*)",
+      "Bash(git push origin style/*)",
+      "Bash(git push origin revert/*)",
+      "Bash(git push origin dev:*)",
+      "Bash(git push origin develop:*)",
+      "Bash(git push origin staging:*)",
+      "Bash(git push --force-with-lease:*)",
+      "Bash(git push origin --delete:*)",
+      "Bash(git push --set-upstream:*)",
+      "Bash(git push -u:*)",
+      "Bash(python:*)",
+      "Bash(python3:*)",
+      "Bash(aws s3 ls:*)",
+      "Bash(aws logs tail:*)",
+      "Bash(aws logs describe:*)",
+      "Bash(aws lambda list:*)",
+      "Bash(aws lambda get:*)",
+      "Bash(aws apigateway get:*)",
+      "Bash(aws cloudformation describe:*)",
+      "Bash(aws sts get-caller-identity:*)",
+      "Bash(aws iam list-open-id-connect-providers:*)",
+      "Bash(aws iam get-open-id-connect-provider:*)",
+      "Bash(aws iam list-roles:*)",
+      "Bash(aws iam get-role:*)",
+      "Bash(docker ps:*)",
+      "Bash(docker images:*)",
+      "Bash(docker logs:*)",
+      "Bash(docker compose ps:*)",
+      "Bash(docker compose logs:*)",
+      "Bash(ls:*)",
+      "Bash(pwd:*)",
+      "Bash(which:*)",
+      "Bash(whereis:*)",
+      "Bash(find:*)",
+      "Bash(grep:*)",
+      "Bash(rg:*)",
+      "Bash(cat:*)",
+      "Bash(head:*)",
+      "Bash(tail:*)",
+      "Bash(wc:*)",
+      "Bash(echo:*)",
+      "Bash(printf:*)",
+      "Bash(mkdir:*)",
+      "Bash(touch:*)",
+      "Bash(cp:*)",
+      "Bash(mv:*)",
+      "Bash(gh pr list:*)",
+      "Bash(gh pr view:*)",
+      "Bash(gh pr checks:*)",
+      "Bash(gh pr create:*)",
+      "Bash(gh pr merge:*)",
+      "Bash(gh issue list:*)",
+      "Bash(gh issue view:*)",
+      "Bash(gh issue comment:*)",
+      "Bash(gh workflow list:*)",
+      "Bash(gh workflow view:*)",
+      "Bash(gh run list:*)",
+      "Bash(gh run view:*)",
+      "Bash(gh run watch:*)",
+      "Bash(terraform fmt:*)",
+      "Bash(terraform validate:*)",
+      "Bash(terraform plan:*)",
+      "Bash(terraform show:*)",
+      "Bash(terraform output:*)",
+      "Bash(jq:*)",
+      "Bash(yq:*)",
+      "Bash(sed:*)",
+      "Bash(awk:*)",
+      "Bash(node --version:*)",
+      "Bash(npm --version:*)",
+      "Bash(python --version:*)",
+      "Bash(aws --version:*)",
+      "Bash(sam --version:*)",
+      "Bash(terraform --version:*)",
+      "Bash(tree:*)",
+      "Bash(diff:*)",
+      "Bash(sort:*)",
+      "Bash(uniq:*)",
+      "Bash(cut:*)",
+      "Bash(tr:*)",
+      "Bash(basename:*)",
+      "Bash(dirname:*)",
+      "Bash(realpath:*)",
+      "Bash(npm outdated:*)",
+      "Bash(eslint:*)",
+      "Bash(prettier:*)",
+      "Bash(tsc:*)",
+      "Bash(jest:*)",
+      "Bash(vitest:*)"
+    ],
+    "deny": [
+      "Write(poetry.lock)",
+      "Edit(poetry.lock)",
+      "Write(package-lock.json)",
+      "Edit(package-lock.json)",
+      "Write(yarn.lock)",
+      "Edit(yarn.lock)",
+      "Bash(pip install:*)",
+      "Bash(pip uninstall:*)",
+      "Bash(git push:main)",
+      "Bash(git push origin main:*)",
+      "Bash(git push --force origin:*)",
+      "Bash(git push --force -:*)",
+      "Bash(git rebase main:*)",
+      "Bash(git rebase origin/main:*)",
+      "Bash(git pull --rebase:*)",
+      "Bash(rm -rf /*)",
+      "Bash(rm -rf /)",
+      "Bash(terraform apply:*)",
+      "Bash(terraform destroy:*)",
+      "Bash(aws s3 rm:*)",
+      "Bash(aws s3 rb:*)",
+      "Bash(docker rm:*)",
+      "Bash(docker rmi:*)",
+      "Bash(docker system prune:*)",
+      "Bash(npm run dev:*)",
+      "Bash(cat .env:*)",
+      "Read(.env)",
+      "Read(.env.*)",
+      "Bash(sed -i:*)"
+    ]
+  },
+  "enableAllProjectMcpServers": false,
+  "skipDangerousModePermissionPrompt": true
+}

augint_org-0.1.0/.claude/skills/ai-create-cmd/SKILL.md

@@ -0,0 +1,157 @@
+---
+name: ai-create-cmd
+description: Create a new Claude skill for augint-shell repositories. Use when building new automation commands or skills.
+argument-hint: "[skill-name and description]"
+---
+
+Create a new Claude skill for trinity repositories: $ARGUMENTS
+
+Follow these steps to create a well-structured skill:
+
+1. **Parse the skill request**:
+   ```
+   Extract from user input:
+   - Skill name (kebab-case)
+   - Skill purpose
+   - Key functionality needed
+   - Target repos (default: all trinity)
+   ```
+
+2. **Determine skill scope**:
+   - **Trinity skill**: For augint-library, augint-api, augint-web
+   - **Meta skill**: Only if it makes sense for augint-project management
+
+   Ask: "Should this skill also have a meta version for the augint-project repo?"
+   (Only if the skill relates to project management, vision docs, or cross-repo operations)
+
+3. **Create the skill directory and file**:
+   ```bash
+   # Create in templates first
+   mkdir -p src/ai_shell/templates/claude/skills/{skill-name}
+   touch src/ai_shell/templates/claude/skills/{skill-name}/SKILL.md
+   ```
+
+4. **Generate SKILL.md** with this structure:
+   ```markdown
+   ---
+   name: {skill-name}
+   description: {One-line description of what it does and when to use it. Max 250 chars.}
+   argument-hint: "[expected arguments]"
+   ---
+
+   {Command description in active voice}: $ARGUMENTS
+
+   {Brief overview of what this skill does.}
+
+   ## Usage Examples
+   - `/{skill-name}` - Default behavior
+   - `/{skill-name} specific args` - With arguments
+
+   ## 1. {First Major Step}
+   - {Specific action}
+   - {Validation check}
+   ```bash
+   # Example command
+   ```
+
+   ## 2. {Second Major Step}
+   - {Specific action}
+   - {Error handling}
+
+   ## 3. {Output/Report}
+   ```
+   === {Skill Name} Results ===
+
+   {Structured output format}
+
+   Status: {success/warnings/failures}
+   ```
+
+   ## Error Handling
+   - {Error condition}: {Recovery action}
+   ```
+
+5. **Choose appropriate frontmatter options**:
+   - `argument-hint` to show expected arguments in the skill menu
+   - Keep description under 250 characters, front-load key use case
+
+6. **Validate the skill**:
+   ```bash
+   # Check SKILL.md exists and has frontmatter
+   head -10 src/ai_shell/templates/claude/skills/{skill-name}/SKILL.md
+
+   # Verify frontmatter has required fields
+   grep -E "^(name|description):" src/ai_shell/templates/claude/skills/{skill-name}/SKILL.md
+   ```
+
+7. **Register in scaffold.py**:
+   Add the skill name to `CLAUDE_SKILL_DIRS` in `src/ai_shell/scaffold.py`:
+   ```python
+   CLAUDE_SKILL_DIRS = [
+       # ... existing skills ...
+       "{skill-name}",
+   ]
+   ```
+
+8. **Best practices**:
+   - Keep skills focused on one primary task
+   - Use active voice ("Create PR" not "PR should be created")
+   - Include usage examples
+   - Make steps explicit and numbered
+   - Include error handling section
+   - Reference related skills (e.g., "Next: `/ai-submit-work`")
+   - Keep SKILL.md under 500 lines
+   - Be directive, not conversational
+
+9. **Copy to trinity repositories**:
+   ```bash
+   # Deploy via scaffold
+   for repo in augint-library augint-api augint-web; do
+     python -c "
+   from ai_shell.scaffold import scaffold_claude
+   from pathlib import Path
+   scaffold_claude(Path('../$repo'), overwrite=True)
+   "
+   done
+   ```
+
+10. **Verify deployment**:
+    ```bash
+    # Check all trinity repos have the skill
+    ls -la ../augint-*/.claude/skills/{skill-name}/SKILL.md
+    ```
+
+## Skill Patterns
+
+### For Git Workflow Skills:
+```markdown
+{Action} for {purpose}: $ARGUMENTS
+
+## 1. Check current state
+## 2. Perform action
+## 3. Verify success
+## 4. Report results with next step
+```
+
+### For Analysis Skills:
+```markdown
+Analyze {target} for {criteria}: $ARGUMENTS
+
+## 1. Gather data
+## 2. Process and categorize
+## 3. Generate insights
+## 4. Provide recommendations
+```
+
+### For Automation Skills:
+```markdown
+Automate {task} across {scope}: $ARGUMENTS
+
+## 1. Validate prerequisites
+## 2. Execute automation
+## 3. Handle errors
+## 4. Confirm completion
+```
+
+## Why This Matters
+Consistent skill creation ensures all repositories have access to the same automation capabilities with predictable behavior and quality.

augint_org-0.1.0/.claude/skills/ai-monitor-pipeline/SKILL.md

@@ -0,0 +1,318 @@
+---
+name: ai-monitor-pipeline
+description: Monitor CI pipeline after push, diagnose failures, auto-fix and re-push. Use after submitting work, or asking 'check the build' or 'how's the pipeline'.
+argument-hint: "[run-id or branch-name]"
+---
+
+Monitor CI pipeline, diagnose failures, and auto-fix when possible: $ARGUMENTS
+
+> **Workflow automation:** This skill is part of an automated workflow. Auto-push trivial formatting/whitespace fixes without asking. Only ask for approval when fixes involve substantive code changes. Report what was fixed but do not gate on user confirmation for mechanical fixes.
+
+Watches the pipeline run, parses failures, attempts auto-fixes for common issues, and re-pushes automatically for trivial fixes.
+
+## Usage Examples
+- `/ai-monitor-pipeline` - Monitor latest run on current branch
+- `/ai-monitor-pipeline feat/issue-42-auth` - Monitor specific branch
+- `/ai-monitor-pipeline 12345678` - Monitor specific run ID
+
+## 1. Find the Pipeline Run
+
+```bash
+# Determine target
+if [ -n "$ARGUMENTS" ]; then
+    # If numeric, treat as run ID
+    if echo "$ARGUMENTS" | grep -qP '^\d+$'; then
+        RUN_ID=$ARGUMENTS
+    else
+        # Treat as branch name
+        BRANCH=$ARGUMENTS
+    fi
+else
+    BRANCH=$(git branch --show-current)
+fi
+
+# If we have a branch, find the latest run
+if [ -n "$BRANCH" ]; then
+    gh run list --branch "$BRANCH" --limit 5 \
+        --json databaseId,status,conclusion,event,headSha,name,createdAt
+    # Pick the most recent run
+    RUN_ID=$(gh run list --branch "$BRANCH" --limit 1 --json databaseId -q '.[0].databaseId')
+fi
+
+if [ -z "$RUN_ID" ]; then
+    echo "No pipeline runs found. Push your changes first."
+    exit 1
+fi
+```
+
+Show the run details:
+```
+Pipeline: CI/CD Pipeline
+Run: #12345678
+Branch: feat/issue-42-auth
+Status: in_progress
+Started: 2 minutes ago
+```
+
+## 2. Wait for Completion
+
+```bash
+# Watch the run in real-time
+gh run watch $RUN_ID --exit-status
+```
+
+If `gh run watch` is not available, poll:
+```bash
+while true; do
+    STATUS=$(gh run view $RUN_ID --json status,conclusion -q '.status')
+    if [ "$STATUS" = "completed" ]; then
+        CONCLUSION=$(gh run view $RUN_ID --json conclusion -q '.conclusion')
+        break
+    fi
+    sleep 30
+done
+```
+
+## 3. On Success
+
+```
+Pipeline PASSED
+
+Jobs:
+  - Pre-commit checks: passed
+  - Security scanning: passed
+  - License compliance: passed
+  - Unit tests: passed
+
+PR status: ready to merge (automerge enabled)
+```
+
+### Post-Merge Cleanup
+
+After pipeline passes, check if the PR has been merged (automerge may complete quickly):
+
+```bash
+PR_STATE=$(gh pr view --json state -q .state 2>/dev/null)
+```
+
+If `PR_STATE` is `MERGED`:
+
+1. **Check for dirty working directory:**
+   ```bash
+   if [ -n "$(git status --porcelain)" ]; then
+       echo "You have uncommitted changes. Skipping cleanup."
+       # Report success but do NOT switch branches
+   fi
+   ```
+
+2. **If clean, auto-cleanup:**
+   ```bash
+   BASE=$TARGET  # detected via branch detection algorithm from CLAUDE.md
+   CURRENT=$(git branch --show-current)
+   git checkout $BASE && git pull origin $BASE && git branch -d $CURRENT
+   ```
+
+3. **Report:**
+   ```
+   Pipeline PASSED. PR merged.
+   Cleaned up: deleted local branch feat/issue-42-auth
+   Now on: main (up to date)
+
+   Suggested next step: /ai-pick-issue
+   ```
+
+If PR has NOT merged yet (waiting for automerge or review): just report pipeline success and stop.
+
+Skip cleanup if `--no-cleanup` was passed as an argument.
+
+## 4. On Failure - Diagnose
+
+```bash
+# Get job details
+gh run view $RUN_ID --json jobs
+
+# Identify failed job(s)
+FAILED_JOBS=$(gh run view $RUN_ID --json jobs -q '.jobs[] | select(.conclusion == "failure") | .name')
+
+# Get failed logs
+gh run view $RUN_ID --log-failed
+```
+
+### Categorize the Failure
+
+**Auto-fixable failures** (skill will attempt to fix):
+- **Pre-commit failures**: formatting (ruff-format), whitespace (trailing-whitespace, end-of-file-fixer), import ordering (ruff check --fix)
+- **Lint errors with auto-fix**: ruff, eslint with --fix
+- **MyPy errors**: fix actual types (NEVER use `# type: ignore` or `Any` as escape hatches). If only escape-hatch fix is available, reclassify as NOT auto-fixable.
+- **uv-lock-check failures**: run `uv lock` to regenerate
+
+**NOT auto-fixable** (skill reports and stops):
+- **Test failures**: require understanding business logic
+- **Security vulnerabilities**: bandit findings, pip-audit CVEs require judgment
+- **License compliance**: dependency decisions needed
+- **Build/compilation errors**: syntax errors, broken imports in non-trivial code
+- **Release job failures**: should never be triggered from feature branches
+
+### Failure Report
+
+```
+Pipeline FAILED
+
+Failed jobs:
+  1. Pre-commit checks (auto-fixable)
+     - ruff-format: 3 files need formatting
+     - trailing-whitespace: 1 file
+
+  2. Unit tests (manual fix required)
+     - test_auth.py::test_login_timeout FAILED
+     - AssertionError: expected 200, got 401
+```
+
+## 5. Auto-fix Attempt
+
+**Circuit breakers (checked before every fix attempt):**
+- Maximum 2 fix attempts total
+- If same failure type repeats after a fix: stop immediately
+- Never modify the same file more than twice across all attempts
+- Auto-push trivial fixes (formatting/whitespace); require approval only for substantive changes
+
+**Track state:**
+```python
+attempt_count = 0
+max_attempts = 2
+previous_failures = set()
+modified_files = {}  # file -> modification count
+```
+
+### Fix Process
+
+For each auto-fixable failure:
+
+1. **Apply the fix locally:**
+   ```bash
+   # For pre-commit failures
+   uv run pre-commit run --all-files
+   # This auto-fixes formatting, whitespace, imports
+
+   # For specific ruff issues
+   uv run ruff check --fix src/ tests/
+   uv run ruff format src/ tests/
+   ```
+
+2. **Verify the fix locally:**
+   ```bash
+   # Re-run the failing check
+   uv run pre-commit run --all-files
+   # Must pass now
+   ```
+
+3. **Categorize the fix and decide whether to auto-push:**
+
+   **Trivial fixes (auto-push without asking):** formatting (ruff-format, black, prettier), whitespace (trailing-whitespace, end-of-file-fixer), import sorting (isort, ruff I-rules). These are mechanical and deterministic.
+
+   ```
+   Fix attempt #1 (auto-pushed):
+   Files modified:
+     - src/auth.py (formatting)
+     - src/utils.py (trailing whitespace)
+   ```
+
+   For trivial fixes: commit and push immediately. Do NOT show the diff or ask for approval.
+
+   **Substantive fixes (ask before pushing):** any fix that changes logic, adds/removes code beyond whitespace, or modifies behavior. Show the diff and ask:
+   ```
+   Fix attempt #1 (requires approval):
+   Files modified:
+     - src/auth.py (logic change)
+
+   Diff:
+   [show git diff]
+
+   Push these fixes? [y/n]
+   ```
+
+4. **Local smoke test before pushing:**
+
+   - **Trivial fixes** (formatting/whitespace only): run pre-commit locally as a smoke test (fast, 5-30 seconds):
+     ```bash
+     uv run pre-commit run --all-files
+     ```
+   - **Substantive fixes** (mypy, logic changes): run pre-commit + tests:
+     ```bash
+     uv run pre-commit run --all-files && uv run pytest --cov=src --cov-fail-under=80 -q
+     ```
+
+   If the local smoke test fails, report the issue to the user instead of pushing a known-broken state. This counts as one of the 2 fix attempts.
+
+5. **Commit and push:**
+   ```bash
+   git add -u
+   git commit -m "fix: resolve pre-commit formatting issues"
+   git push origin $(git branch --show-current)
+   ```
+
+6. **Watch the new run:**
+   ```bash
+   # Wait a moment for the new run to start
+   sleep 5
+   NEW_RUN_ID=$(gh run list --branch "$(git branch --show-current)" --limit 1 --json databaseId -q '.[0].databaseId')
+   gh run watch $NEW_RUN_ID --exit-status
+   ```
+
+7. **Check result:**
+   - If passed: report success
+   - If same failure: stop immediately ("Same failure after fix. Manual intervention needed.")
+   - If different failure: attempt one more fix (if under max attempts)
+
+### When NOT to Auto-fix
+
+If ALL failed jobs are non-auto-fixable:
+```
+Pipeline FAILED - Manual fixes needed
+
+Failed: Unit tests
+  - test_auth.py::test_login_timeout FAILED
+  - test_api.py::test_rate_limiting FAILED
+
+These failures require manual intervention.
+Logs: gh run view 12345678 --log-failed
+
+Suggested actions:
+  1. Fix the failing tests
+  2. Run locally: uv run pytest tests/test_auth.py -v
+  3. Push fixes and re-run: /ai-monitor-pipeline
+```
+
+## 6. Final Output
+
+### After successful fix:
+```
+Pipeline PASSED (after 1 fix attempt)
+
+Fix applied:
+  - Commit: abc1234 "fix: resolve pre-commit formatting issues"
+  - Files: src/auth.py, src/utils.py
+
+All jobs green. PR ready to merge.
+```
+
+### After giving up:
+```
+Pipeline FAILED (2 fix attempts exhausted)
+
+Attempt 1: Fixed formatting -> new failure in tests
+Attempt 2: Cannot auto-fix test failures
+
+Remaining failures:
+  - Unit tests: test_auth.py::test_login_timeout
+
+Manual fix required. Run locally:
+  uv run pytest tests/test_auth.py::test_login_timeout -v
+```
+
+## Error Handling
+- **No runs found**: Suggest pushing changes first
+- **gh CLI not authenticated**: Remind to run `gh auth login`
+- **Run cancelled**: Report cancellation, suggest re-triggering
+- **Network timeout during watch**: Resume polling with last known run ID
+- **Fix creates new issues**: Circuit breaker stops after 2 attempts