tapps-agents 3.5.41__py3-none-any.whl → 3.6.1__py3-none-any.whl

tapps_agents/resources/cursor/rules/when-to-use.mdc

@@ -0,0 +1,156 @@
+---
+description: Importance and when to use each TappsCodingAgents capability—workflows, agents, and commands. Use this to choose the right tool and understand what to prioritize.
+alwaysApply: false
+---
+
+# When to Use: Importance and Guidance
+
+This rule helps projects using **TappsCodingAgents with Cursor** understand which capabilities matter most and **when to use each one**. Prioritize higher tiers for better outcomes: orchestrated workflows, quality gates, traceability, and structured tests.
+
+---
+
+## Why This Matters
+
+TappsCodingAgents adds the most value when you use **orchestrated workflows** (multi-step sequences with quality gates and loopbacks) instead of one-off edits. Higher-importance items deliver that. Use **Tier 1–2** by default; use **Tier 3–4** when you need a specific capability; use **Tier 5–6** for niche or meta tasks.
+
+---
+
+## Quick Lookup: "I want to…" → Use this
+
+| I want to… | Use this | Importance |
+|------------|----------|------------|
+| **Build a new feature** | `@simple-mode *build "description"` | Tier 1 |
+| **Fix a bug or error** | `@simple-mode *fix <file> "description"` | Tier 1 |
+| **Run full SDLC** (framework work or enterprise) | `@simple-mode *full "description"` | Tier 1 |
+| **Review code quality** | `@simple-mode *review <file>` or `@reviewer *review <file>` | Tier 1–2 |
+| **Get a quick quality score** | `@reviewer *score <file>` | Tier 1 |
+| **Set up the project** (first time) | `tapps-agents init` | Tier 1 |
+| **Add or improve tests** | `@simple-mode *test <file>` or `@tester *test <file>` | Tier 2 |
+| **Refactor code** | `@simple-mode *refactor <file>` | Tier 3 |
+| **Debug an error** | `@debugger *debug "error" --file <file>` | Tier 2 |
+| **Improve a prompt before building** | `@enhancer *enhance "prompt"` or `@simple-mode *enhance "prompt"` | Tier 2 |
+| **Plan or break down work** | `@planner *plan "description"` or `@simple-mode *breakdown "description"` | Tier 2 |
+| **Run workflows in CI/terminal** | `tapps-agents workflow rapid|full|fix|quality|hotfix` | Tier 2 |
+| **Check environment** | `tapps-agents doctor` | Tier 3 |
+| **Security audit** | `@ops *audit-security` or `@simple-mode *security-review` | Tier 3 |
+| **Execute an Epic** | `@simple-mode *epic <epic-doc.md>` | Tier 3 |
+
+---
+
+## Tier 1: Highest importance — use these first
+
+These give the biggest improvement over ad-hoc work: orchestration, quality gates, traceability, and tests.
+
+| Capability | When to use |
+|------------|-------------|
+| **`tapps-agents init`** | First-time setup or after adding TappsCodingAgents. Run once per project to install Rules, Skills, and config. Without it, Cursor integration does not work. |
+| **`@simple-mode *build "description"`** | **New features, user stories, or greenfield work.** Use for any "add/implement/create" request. Runs: enhance → plan → architect → designer → implement → review → test, with quality gates and loopbacks. Prefer over going straight to code. |
+| **`@simple-mode *fix <file> "description"`** | **Bugs, runtime errors, or "fix this" requests.** Runs: debug → implement → test. Use when the problem is already identified or you have an error message. |
+| **`@simple-mode *full "description"`** | **Framework changes (e.g. `tapps_agents/`), enterprise/critical features, or when you need full traceability.** 9-step SDLC: requirements → plan → architect → designer → implement → review → test → security → docs. Required when modifying TappsCodingAgents itself. |
+| **`@reviewer *review <file>`** | **Pre-commit, PRs, or "how good is this code?"** Full review with 7-category scoring and actionable feedback. Use when you want detailed, structured feedback. |
+| **`@reviewer *score <file>`** | **Quick, objective quality check; CI gates; or "just the numbers."** Fast, no LLM. Use when you need a fast pass or a numeric threshold. |
+
+---
+
+## Tier 2: Strong support — use as part of workflows or for focused tasks
+
+These power the Tier 1 workflows or are the main way to do a specific job well.
+
+| Capability | When to use |
+|------------|-------------|
+| **`@simple-mode *review <file>`** | When you want **review plus improvement suggestions** in one go. Uses @reviewer then @improver if issues are found. |
+| **`@simple-mode *test <file>`** | **After implementing or when asked to "add tests."** Structured test generation. Prefer over ad-hoc test writing when you want coverage and consistency. |
+| **`@tester *test <file>`** / **`generate-tests`** | When you need **only tests** (no full *build/*fix). Use in workflows or when tests are the single goal. |
+| **`@implementer *implement "spec" <file>`** / **`*refactor <file> "instructions"`** | When you need **code generation or refactoring alone** (e.g. inside a custom flow, or after you already have a spec). Usually better to use *build or *fix so review and tests are included. |
+| **`@enhancer *enhance "prompt"`** | When a prompt is **vague or high-level** and you want a richer spec before planning or implementation. Often run as step 1 of *build; use standalone when iterating on a prompt. Also runs in *full (full-sdlc optional), rapid-dev, and *epic via EnhancerHandler. CLI: `auto_enhancement` (CONFIGURATION.md). |
+| **`@debugger *debug "error" --file <file>`** | When you have **an error message or stack trace** and need root-cause analysis. Feeds into *fix; use standalone when you only need diagnosis. |
+| **`@planner *plan "description"`** | When you need **user stories, acceptance criteria, or a plan** without running the full build. Use in *build/*full or when planning is the only goal. |
+| **`@architect *design "description"`** | When you need **system or high-level design** before coding. Use in *build/*full or for design-only work. |
+| **`tapps-agents workflow rapid`** | **CI/terminal: fast feature development** with quality checks. Use when automating in scripts or CI instead of Cursor chat. |
+| **`tapps-agents workflow full`** | **CI/terminal: full SDLC** with requirements, security, and docs. Use for automation of framework or enterprise work. |
+
+---
+
+## Tier 3: Important but more situational
+
+Use when the task clearly matches, or when a Tier 1–2 workflow doesn’t fit.
+
+| Capability | When to use |
+|------------|-------------|
+| **`@designer *design-api`** / **`*design-model`** | When you need **API or data-model design** before or outside of *build. Usually invoked inside *build/*full. |
+| **`@improver *improve <file> "instructions"`** | When you have **review feedback or a clear improvement goal** and want suggested edits. Used inside *review; use standalone for targeted improvements. |
+| **`@ops *audit-security`**, **`*check-compliance`**, **`*audit-dependencies`** | **Security, compliance (e.g. GDPR, HIPAA), or dependency audits.** Use in *full, before release, or when compliance is required. |
+| **`@documenter *document <file>`** / **`*document-api <file>`** | When **documentation** is the main deliverable. *full includes docs; use standalone when you only need to document. |
+| **`@simple-mode *refactor <file>`** | When the goal is **refactoring** with review and tests. Prefer over one-off refactors for larger changes. |
+| **`@simple-mode *epic <epic-doc.md>`** | When you are **implementing an Epic**: runs all stories in dependency order with quality gates. Use for large, multi-story work. |
+| **`@reviewer *lint`**, **`*type-check`** | **Fast style and type checks** for CI or local hygiene. Use for pre-commit or CI quality gates. |
+| **`@reviewer *security-scan`** | When you need **focused security scanning** without a full ops audit. |
+| **`tapps-agents doctor`** | **Environment and integration checks.** Use after setup, when something breaks, or in CI to validate tooling. |
+| **`tapps-agents cursor verify`** | **Check that Cursor Rules and Skills** are installed and valid. Use after init or when @-commands don’t work. |
+| **`tapps-agents workflow fix`**, **`quality`** | **CLI: bug fixes, maintenance, quality sprints, or hotfixes** when not using Cursor chat. (`hotfix` is an alias for `fix`.) |
+
+---
+
+## Tier 4: Useful in specific cases
+
+| Capability | When to use |
+|------------|-------------|
+| **`@simple-mode *test-coverage`** | When you want **coverage-driven test generation** for uncovered paths. |
+| **`@simple-mode *fix-tests`** | When **tests are failing** and you want automated fixes for common patterns (e.g. async, mocks, imports). |
+| **`@simple-mode *enhance`**, **`*breakdown`**, **`*todo`** | **Prompt enhancement, task breakdown, or Beads-backed todo** (e.g. `*todo ready`). Use when those are the explicit goals. |
+| **`@reviewer *docs <library>`** | When you need **library documentation** (Context7). Use for "how do I use X?" or API lookup. |
+| **`@reviewer *report`**, **`*duplication`** | **Project-wide quality or duplication reports.** Use for audits or technical-debt analysis. |
+| **`@analyst *gather-requirements`**, **`*estimate-effort`**, **`*assess-risk`** | **Requirements, estimation, or risk** when you’re not running *full. |
+| **`@architect *detect-patterns`** | When you need to **understand existing architecture** (e.g. Layered, MVC, Microservices) from the project layout. |
+| **`@ops *plan-deployment`**, **`*audit-bundle`** | **Deployment planning** or **frontend bundle analysis** (Node/React/Vue). |
+| **`continuous-bug-fix`** | **Automated test → fix loop** with quality gates. Use in CI or when batch-fixing test failures. |
+| **`@bug-fix-agent *fix-bug`** | **Automated fix with tests, review, and optional commit.** Use when you want full automation; be aware it can commit to main. |
+| **`tapps-agents create "description"`** | **Greenfield: create a full application** from a description. Shortcut for full SDLC on a new project. |
+| **`tapps-agents simple-mode`** (on, off, status, init, configure, full) | **Configure or run Simple Mode** from the CLI (e.g. `simple-mode full --prompt "..." --auto`). |
+
+---
+
+## Tier 5: Meta, low-frequency, or workflow control
+
+| Capability | When to use |
+|------------|-------------|
+| **`@evaluator *evaluate`** | **Evaluate TappsCodingAgents usage and effectiveness** (e.g. adherence, quality over time). Use for process improvement. |
+| **`@orchestrator *orchestrate`**, **`*sequence`** | **Custom YAML workflows or ad-hoc agent sequences** when presets and Simple Mode don’t fit. |
+| **`workflow state`** (list, show, cleanup), **resume**, **continue-from**, **skip-steps** | **Inspect, resume, or trim workflows** (e.g. after a failure or when re-running from a step). |
+| **`workflow recommend`**, **`dry-run`** | **Get a workflow suggestion** or **validate without running** (e.g. before CI). |
+| **`cleanup workflow-docs`** | **Remove or archive old workflow artifacts** to reduce clutter. |
+| **`score`** (top-level) | **Shortcut for `reviewer score`** when you prefer the shorter form. |
+| **`beads`** | **Beads (bd) passthrough** when using bd for task tracking. |
+
+---
+
+## Tier 6: Niche or convenience
+
+| Capability | When to use |
+|------------|-------------|
+| **`@simple-mode *microservice`**, **`*docker-fix`**, **`*integrate-service`** | **Microservice scaffolding, Docker debugging, or service-to-service integration** when those are the explicit goals. |
+| **`@simple-mode *explore`**, **`*plan-analysis`**, **`*pr`** | **Codebase exploration, safe planning (read-only), or PR creation** when you need only that. |
+| **`@planner *create-story`**, **`*list-stories`** | **Story management** when you’re not using *build/*full. |
+| **`workflow brownfield-analysis`** | **CLI: brownfield/legacy analysis** when not in Cursor. (simple-new-feature→rapid-dev, simple-improve-quality→quality, simple-fix-issues→fix.) |
+
+---
+
+## Cursor vs CLI: where to run things
+
+| Context | Prefer | Example |
+|---------|--------|---------|
+| **Interactive work in Cursor** | **@simple-mode** and **@agent** in chat | `@simple-mode *build "Add auth"` |
+| **CI, scripts, or no Cursor** | **CLI** `tapps-agents` | `tapps-agents workflow rapid --prompt "Add auth" --auto` |
+| **Quick, single-step checks** | **@agent** or CLI | `@reviewer *score src/` or `tapps-agents reviewer score src/` |
+
+In Cursor, **avoid** `tapps-agents workflow ...` for interactive development; use `@simple-mode` instead. See `cursor-mode-usage.mdc` for details.
+
+---
+
+## See also
+
+- **`quick-reference.mdc`** — Quick command table and where to run (Cursor vs terminal).
+- **`simple-mode.mdc`** — Workflow interceptor, step-by-step workflows, and Simple Mode commands.
+- **`command-reference.mdc`** — Full command and parameter reference.
+- **`agent-capabilities.mdc`** — What each agent does and when to use it.
+- **`cursor-mode-usage.mdc`** — When to use Cursor Skills vs CLI.

tapps_agents/resources/cursor/rules/workflow-presets.mdc

@@ -0,0 +1,179 @@
+---
+description: Documentation of TappsCodingAgents workflow presets and how to use them in Cursor AI
+alwaysApply: false
+---
+
+# Workflow Presets - Quick Commands
+
+## Overview
+
+TappsCodingAgents provides 5 preset workflows that can be executed with simple one-word commands. These workflows automatically orchestrate multiple agents to complete common SDLC tasks. Presets that include an enhance step (full-sdlc optional, rapid-dev, Epic) run it via EnhancerHandler. CLI auto-enhancement: `auto_enhancement` in docs/CONFIGURATION.md.
+
+## Available Workflow Presets
+
+### 1. Full SDLC Pipeline (`full` / `enterprise`)
+
+**Command:** `python -m tapps_agents.cli workflow full`
+
+**Best for:** Enterprise projects, new applications, compliance-heavy systems
+
+**Agent Sequence:**
+0. Enhancer - Enhance Prompt (optional, before requirements)
+1. Analyst - Requirements gathering
+2. Planner - Story creation
+3. Architect - System design
+4. Designer - API contracts
+5. Implementer - Code generation
+6. Reviewer - Code review with quality gates
+7. Tester - Test generation
+8. Ops - Security scan
+9. Documenter - Documentation
+
+**Quality Gates:**
+- Overall score: ≥70
+- Security: ≥7.0
+- Maintainability: ≥7.0
+
+### 2. Rapid Development (`rapid` / `feature`)
+
+**Command:** `python -m tapps_agents.cli workflow rapid`
+
+**Best for:** Feature development, sprint work, iterative development
+
+**Agent Sequence:**
+1. Enhancer - Prompt enhancement
+2. Planner - Story breakdown
+3. Implementer - Code generation
+4. Reviewer - Quick review
+5. Tester - Test generation
+
+**Quality Gates:**
+- Overall score: ≥65
+- Security: ≥6.5
+
+### 3. Fix (`fix` / `maintenance` / `hotfix` / `urgent` / `refactor` / `quick-fix`)
+
+**Command:** `python -m tapps_agents.cli workflow fix`
+
+**Best for:** Bug fixes, hotfixes, maintenance, refactoring. Replaces legacy maintenance, quick-fix, simple-fix-issues.
+
+**Agent Sequence:**
+1. Enhancer - Enhance Prompt (optional)
+2. Debugger - Error analysis
+3. Implementer - Fix implementation
+4. Reviewer - Code review with quality gate
+5. Tester - Test generation
+6. Orchestrator - Finalize
+
+**Quality Gates:**
+- Overall score: ≥65
+- Security: ≥6.5
+
+### 4. Quality Improvement (`quality` / `improve`)
+
+**Command:** `python -m tapps_agents.cli workflow quality`
+
+**Best for:** Code quality initiatives, refactoring sprints, quality gates
+
+**Agent Sequence:**
+1. Reviewer - Initial analysis
+2. Improver - Refactoring
+3. Reviewer - Re-review validation
+4. Tester - Test verification
+5. Ops - Security audit
+
+**Quality Gates:**
+- Overall score: ≥75
+- Maintainability: ≥8.0
+- Security: ≥7.5
+
+### 5. Brownfield Analysis (`brownfield`)
+
+**Command:** `python -m tapps_agents.cli workflow brownfield`
+
+**Best for:** Analyzing existing codebases, legacy systems, understanding before changes
+
+**Agent Sequence:** Analyst (discovery, architecture, structure, tests/docs, technical debt, modernization, report), Reviewer (quality), Ops (dependencies). See `brownfield-analysis.yaml`.
+
+## Workflow Execution Flags
+
+All workflow commands support these flags for better control:
+
+```bash
+# Pre-flight validation (check before running)
+tapps-agents workflow rapid --dry-run --prompt "Add feature"
+
+# Explicit mode control
+tapps-agents workflow rapid --cli-mode --prompt "Add feature"   # Force CLI/headless
+tapps-agents workflow rapid --cursor-mode --prompt "Add feature" # Force Cursor Skills
+
+# Resume/partial execution
+tapps-agents workflow rapid --continue-from implementation --prompt "Add feature"
+tapps-agents workflow rapid --skip-steps "enhance,plan" --prompt "Add feature"
+
+# Output control
+tapps-agents workflow rapid --print-paths --prompt "Add feature"  # Show artifact paths (default)
+tapps-agents workflow rapid --no-print-paths --prompt "Add feature"
+```
+
+**Flag Reference:**
+- `--dry-run`: Validate workflow without executing (pre-flight check)
+- `--cli-mode`: Force CLI/headless mode (direct LLM calls)
+- `--cursor-mode`: Force Cursor mode (uses Cursor Skills)
+- `--continue-from <step>`: Resume from a specific step
+- `--skip-steps <steps>`: Skip comma-separated list of steps
+- `--print-paths`: Print artifact file paths after each step (default: on)
+- `--no-print-paths`: Disable artifact path printing
+
+## Usage in Cursor AI
+
+When working in Cursor AI, you can:
+
+1. **Run workflows directly:**
+   - Type: "Run rapid development workflow"
+   - Or: "Execute full SDLC pipeline"
+   - Or: "Start quality improvement"
+
+2. **Use voice commands:**
+   - "run rapid dev"
+   - "execute enterprise workflow"
+   - "start quick fix"
+
+3. **Reference in conversations:**
+   - "Use the rapid workflow for this feature"
+   - "This needs the full enterprise workflow"
+   - "Run the quality improvement cycle"
+
+## When to Use Each Workflow
+
+- **New Enterprise Project** → `workflow enterprise`
+- **New Feature** → `workflow rapid` or `workflow feature`
+- **Bug Fix** → `workflow hotfix` or `workflow urgent`
+- **Refactoring** → `workflow fix` or `workflow refactor`
+- **Quality Sprint** → `workflow quality` or `workflow improve`
+
+## Integration
+
+These workflows integrate with:
+- ✅ Expert consultation (domain experts)
+- ✅ Quality gates (scoring thresholds)
+- ✅ Context tiers (token optimization)
+- ✅ Multi-agent orchestration
+- ✅ Git worktree isolation
+
+## List All Presets
+
+```bash
+python -m tapps_agents.cli workflow list
+```
+
+## Customization
+
+Workflow presets are defined in `workflows/presets/`:
+- `full-sdlc.yaml`
+- `rapid-dev.yaml`
+- `fix.yaml`
+- `quality.yaml`
+- `brownfield-analysis.yaml`
+
+You can modify these files or create your own presets.

tapps_agents/resources/customizations/__init__.py

@@ -0,0 +1 @@
+"""Customization resources."""

tapps_agents/resources/customizations/example-custom.yaml

@@ -0,0 +1,83 @@
+# Agent Customization File Template
+# File: .tapps-agents/customizations/{agent-id}-custom.yaml
+#
+# This file allows you to customize agent behaviors without modifying
+# the base agent definitions. Customizations persist through framework updates.
+
+agent_id: example  # Must match filename (e.g., "example-custom.yaml" -> "example")
+
+# Override agent persona
+persona_overrides:
+  # Add additional core principles (appended to base principles)
+  additional_principles:
+    - "Always use type hints in Python"
+    - "Follow PEP 8 strictly"
+    - "Use async/await for I/O operations"
+  
+  # Modify communication style (overrides base values)
+  communication_style:
+    tone: "technical"  # Options: "professional" | "casual" | "friendly" | "technical"
+    formality: "balanced"  # Options: "formal" | "informal"
+    verbosity: "detailed"  # Options: "concise" | "detailed" | "balanced"
+  
+  # Custom expertise areas
+  expertise_areas:
+    # Add new expertise areas (appended to base)
+    add:
+      - "Python"
+      - "FastAPI"
+      - "Async programming"
+    # Emphasize existing areas (prioritized in responses)
+    emphasize:
+      - "Backend development"
+      - "API design"
+  
+  # Custom instructions (appended to base instructions)
+  custom_instructions: |
+    This project uses Python 3.11+ with FastAPI.
+    Always use async/await for database operations.
+    Follow the project's performance patterns document.
+
+# Override commands
+command_overrides:
+  # Add custom commands
+  add:
+    - name: "custom-command"
+      description: "Description of custom command"
+      handler: "task-name"  # References a task file in .tapps-agents/tasks/
+  
+  # Modify existing commands
+  modify:
+    - name: "help"
+      description: "Custom help description"
+
+# Override dependencies
+dependency_overrides:
+  # Add custom tasks
+  tasks:
+    add:
+      - "custom-task.md"
+  
+  # Add custom templates
+  templates:
+    add:
+      - "custom-template.yaml"
+  
+  # Add custom data files
+  data:
+    add:
+      - "custom-data.md"
+
+# Project-specific context
+project_context:
+  # Always load these files for this agent
+  always_load:
+    - "docs/architecture/performance-patterns.md"
+    - "docs/team-guidelines.md"
+  
+  # Project-specific preferences
+  preferences:
+    coding_style: "Pythonic with type hints"
+    architecture_patterns: ["Microservices", "Event-driven"]
+    technology_preferences: ["FastAPI", "SQLAlchemy", "Pydantic"]
+

tapps_agents/resources/hooks/__init__.py

@@ -0,0 +1 @@
+"""Hook resources."""

tapps_agents/resources/hooks/templates/README.md

@@ -0,0 +1,5 @@
+# Hook templates
+
+These YAML files are used by `tapps-agents init --hooks` to generate `.tapps-agents/hooks.yaml`. Each file defines one or more hooks for a single event; all are installed with `enabled: false`. Enable and customize in your project's `.tapps-agents/hooks.yaml`.
+
+Events: UserPromptSubmit, PostToolUse, SessionStart, SessionEnd, WorkflowComplete.

tapps_agents/resources/hooks/templates/__init__.py

@@ -0,0 +1 @@
+"""Hook template definitions."""

tapps_agents/resources/hooks/templates/add-project-context.yaml

@@ -0,0 +1,8 @@
+# Inject project context on UserPromptSubmit (e.g. cat .tapps-agents/context/*).
+# Add files under .tapps-agents/context/ to provide extra context to the prompt.
+hooks:
+  UserPromptSubmit:
+    - name: add-project-context
+      command: "test -d .tapps-agents/context && cat .tapps-agents/context/*.md 2>/dev/null || true"
+      enabled: true
+      fail_on_error: false

tapps_agents/resources/hooks/templates/auto-format-js.yaml

@@ -0,0 +1,10 @@
+# Auto-format JS/TS files after Write/Edit (prettier).
+# Enable and ensure prettier is available: npm install -D prettier
+hooks:
+  PostToolUse:
+    - name: auto-format-js
+      command: "npx prettier --write {{TAPPS_FILE_PATH}}"
+      enabled: true
+      matcher: "Write|Edit"
+      file_patterns: ["*.js", "*.ts", "*.jsx", "*.tsx", "*.json"]
+      fail_on_error: false

tapps_agents/resources/hooks/templates/auto-format-python.yaml

@@ -0,0 +1,10 @@
+# Auto-format Python files after Write/Edit (ruff).
+# Enable and ensure ruff is installed: pip install ruff
+hooks:
+  PostToolUse:
+    - name: auto-format-python
+      command: "ruff format {{TAPPS_FILE_PATH}}"
+      enabled: true
+      matcher: "Write|Edit"
+      file_patterns: ["*.py"]
+      fail_on_error: false

tapps_agents/resources/hooks/templates/git-commit-check.yaml

@@ -0,0 +1,7 @@
+# Run git status check after workflow completes (remind to commit).
+hooks:
+  WorkflowComplete:
+    - name: git-commit-check
+      command: "git status -sb 2>/dev/null || true"
+      enabled: true
+      fail_on_error: false

tapps_agents/resources/hooks/templates/notify-on-complete.yaml

@@ -0,0 +1,8 @@
+# Notify when workflow completes (e.g. desktop notification or webhook).
+# Customize command for your notification channel.
+hooks:
+  WorkflowComplete:
+    - name: notify-on-complete
+      command: "echo 'Workflow {{TAPPS_WORKFLOW_TYPE}} completed with status {{TAPPS_WORKFLOW_STATUS}}'"
+      enabled: true
+      fail_on_error: false

tapps_agents/resources/hooks/templates/quality-gate.yaml

@@ -0,0 +1,8 @@
+# Run quality checks when workflow completes (lint + tests).
+# Customize command for your project (e.g. pytest, npm test).
+hooks:
+  WorkflowComplete:
+    - name: quality-gate
+      command: "echo 'Quality gate: run pytest and ruff' && (ruff check . 2>/dev/null || true) && (pytest -q 2>/dev/null || true)"
+      enabled: true
+      fail_on_error: false

tapps_agents/resources/hooks/templates/security-scan-on-edit.yaml

@@ -0,0 +1,10 @@
+# Run security scan on edited files (e.g. bandit for Python).
+# Enable and ensure bandit is installed: pip install bandit
+hooks:
+  PostToolUse:
+    - name: security-scan-on-edit
+      command: "python -m bandit -q {{TAPPS_FILE_PATH}} 2>/dev/null || true"
+      enabled: true
+      matcher: "Write|Edit"
+      file_patterns: ["*.py"]
+      fail_on_error: false

tapps_agents/resources/hooks/templates/session-end-log.yaml

@@ -0,0 +1,7 @@
+# Log session end (optional debugging).
+hooks:
+  SessionEnd:
+    - name: session-end-log
+      command: "echo 'Session {{TAPPS_SESSION_ID}} ended'"
+      enabled: true
+      fail_on_error: false

tapps_agents/resources/hooks/templates/show-beads-ready.yaml

@@ -0,0 +1,8 @@
+# Show Beads ready tasks at session start (bd ready).
+# Enable when using Beads for task tracking; ensure bd is on PATH.
+hooks:
+  SessionStart:
+    - name: show-beads-ready
+      command: "bd ready 2>/dev/null || true"
+      enabled: true
+      fail_on_error: false

tapps_agents/resources/hooks/templates/test-on-edit.yaml

@@ -0,0 +1,10 @@
+# Run tests for affected file after Edit/Write (e.g. pytest for Python).
+# Customize command for your test runner.
+hooks:
+  PostToolUse:
+    - name: test-on-edit
+      command: "pytest {{TAPPS_FILE_PATH}} -q 2>/dev/null || true"
+      enabled: true
+      matcher: "Write|Edit"
+      file_patterns: ["*.py"]
+      fail_on_error: false

tapps_agents/resources/hooks/templates/update-docs-on-complete.yaml

@@ -0,0 +1,8 @@
+# Update docs when workflow completes (e.g. sync API docs).
+# Customize command for your project.
+hooks:
+  WorkflowComplete:
+    - name: update-docs-on-complete
+      command: "echo 'Update docs: customize for your project (e.g. sphinx-build, mkdocs)'"
+      enabled: true
+      fail_on_error: false

tapps_agents/resources/hooks/templates/user-prompt-log.yaml

@@ -0,0 +1,7 @@
+# Log user prompt submit (optional debugging; avoid logging secrets).
+hooks:
+  UserPromptSubmit:
+    - name: user-prompt-log
+      command: "echo 'Prompt length:' $(echo -n '{{TAPPS_PROMPT}}' | wc -c)"
+      enabled: true
+      fail_on_error: false

tapps_agents/resources/scripts/__init__.py

@@ -0,0 +1 @@
+"""Resource scripts."""

tapps_agents/resources/scripts/set_bd_path.ps1

@@ -0,0 +1,51 @@
+#Requires -Version 5.1
+<#
+.SYNOPSIS
+  Add tools\bd to PATH so the 'bd' command works in this project.
+
+.DESCRIPTION
+  Prepends this project's tools\bd to PATH for the current session.
+  Run before using bd in a terminal, or dot-source: . .\scripts\set_bd_path.ps1
+
+.PARAMETER Persist
+  If set, adds tools\bd to the User PATH permanently (current session only by default).
+
+.EXAMPLE
+  . .\scripts\set_bd_path.ps1
+
+.EXAMPLE
+  .\scripts\set_bd_path.ps1 -Persist
+#>
+param(
+    [switch]$Persist
+)
+
+$ErrorActionPreference = 'Stop'
+$projectRoot = Split-Path $PSScriptRoot -Parent
+$bdDir = Join-Path $projectRoot "tools\bd"
+
+$bdExe = Join-Path $bdDir "bd.exe"
+$bdUnix = Join-Path $bdDir "bd"
+if (-not ((Test-Path $bdExe) -or (Test-Path $bdUnix))) {
+    Write-Error "Beads not found at $bdDir. Ensure tools/bd contains bd.exe (Windows) or bd (Unix). See docs/BEADS_INTEGRATION.md."
+    exit 1
+}
+
+if ($Persist) {
+    $userPath = [System.Environment]::GetEnvironmentVariable('Path', 'User')
+    if ($userPath -notlike "*$bdDir*") {
+        [System.Environment]::SetEnvironmentVariable('Path', "$bdDir;$userPath", 'User')
+        $env:Path = "$bdDir;$env:Path"
+        Write-Host "[OK] Added $bdDir to User PATH. New processes will have 'bd'." -ForegroundColor Green
+    } else {
+        $env:Path = "$bdDir;$env:Path"
+        Write-Host "[OK] $bdDir already in User PATH. Refreshed for this session." -ForegroundColor Green
+    }
+} else {
+    $env:Path = "$bdDir;$env:Path"
+    Write-Host "[OK] Added $bdDir to PATH for this session. Run 'bd' to use Beads." -ForegroundColor Green
+}
+
+Write-Host "  bd ready     - unblocked tasks"
+Write-Host "  bd create ""Title"" -p 0"
+Write-Host "  bd quickstart - intro"

tapps_agents/resources/workflows/__init__.py

@@ -0,0 +1 @@
+"""Workflow resources."""

tapps_agents/resources/workflows/presets/__init__.py

@@ -0,0 +1 @@
+"""Workflow preset configurations."""