aidp 0.21.1 → 0.23.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3fd6b2db707c511e0bc99dedaf4c3f5ec8253eae8d7b93676c9b0dee8ef1f4ed
-  data.tar.gz: 558e0bb69e104ed325b77333d401ebde141eb2b7f969ac8eb473ce253331b244
+  metadata.gz: 1dedfe324bb5255c43e42a4ac3f716bb99f9db453ae436a1e2aa57b68754a28f
+  data.tar.gz: 24b5a225e474c14dabad326455e4d5286e175dc6a929a1bffab4ffb29c1c063c
 SHA512:
-  metadata.gz: 4e1455bf6c12523a5598ec8da183c7bf720512a8edee62e9dd22d32f75774bbb4801c506fd9d45da29486fdd15b9a249a2846f092ce1100cd8b2df84f9ee3c39
-  data.tar.gz: f100cbd42b108e823c0735d1c643cfc4cf3f9f9bc7ea92547466bc33a1001a36ceceedaee45f1e319214503edf804e982478047720be52fcafb23440728b8d55
+  metadata.gz: b842c15a0169d3b3c7361cbdf633b5bb66d0189f40fb16e12099436b3db7eda3e983fb624326b2160dd018d63090feae2b92042f46758990c31cef9172252d36
+  data.tar.gz: 1c614a680d74d56fff4561a62eee471ab1d8f7b8b2cc801786da25a63c12b142948f8e418477a4b479b3b119abe2275b954d9202662f7acbb36cdd82401a68eb

data/README.md

@@ -48,8 +48,8 @@ AIDP provides first-class devcontainer support for sandboxed, secure AI agent ex
 
 - **Network Security**: Strict firewall with allowlisted domains only
 - **Sandboxed Environment**: Isolated from your host system
-- **Elevated Permissions**: AI agents can run with full permissions inside the container
 - **Consistent Setup**: Same environment across all developers
+- **Automatic Management**: AIDP can generate and update your devcontainer configuration
 
 ### For AIDP Development
 
@@ -73,43 +73,54 @@ See [.devcontainer/README.md](.devcontainer/README.md) for complete documentatio
 
 ### Generating Devcontainers for Your Projects
 
-Use `aidp init` to generate a devcontainer for any project:
+AIDP can automatically generate and manage devcontainer configurations through the interactive wizard:
 
 ```bash
-# Initialize project with devcontainer
-aidp init
+# Launch the interactive configuration wizard
+aidp config --interactive
 
-# When prompted:
-# "Generate devcontainer configuration for sandboxed development?" → Yes
+# During the wizard, you'll be asked:
+# - Whether you want AIDP to manage your devcontainer configuration
+# - If you want to add custom ports beyond auto-detected ones
 
-# Or use the flag directly
-aidp init --with-devcontainer
+# The wizard will detect ports based on your project type and generate
+# a complete devcontainer.json configuration
 ```
 
-This creates:
+You can also manage devcontainer configuration manually:
+
+```yaml
+# .aidp/aidp.yml
+devcontainer:
+  manage: true
+  custom_ports:
+    - number: 3000
+      label: "Application Server"
+    - number: 5432
+      label: "PostgreSQL"
+```
 
-- `.devcontainer/Dockerfile` - Customized for your project's language/framework
-- `.devcontainer/devcontainer.json` - VS Code configuration and extensions
-- `.devcontainer/init-firewall.sh` - Network security rules
-- `.devcontainer/README.md` - Setup and usage documentation
+Then apply the configuration:
 
-### Elevated Permissions in Devcontainers
+```bash
+# Preview changes
+aidp devcontainer diff
 
-When running inside a devcontainer, you can enable elevated permissions for AI agents:
+# Apply configuration
+aidp devcontainer apply
 
-```yaml
-# aidp.yml
-devcontainer:
-  enabled: true
-  full_permissions_when_in_devcontainer: true  # Run all providers with full permissions
+# List backups
+aidp devcontainer list-backups
 
-  # Or enable per-provider
-  permissions:
-    skip_permission_checks:
-      - claude  # Adds --dangerously-skip-permissions for Claude Code
+# Restore from backup
+aidp devcontainer restore 0
 ```
 
-AIDP automatically detects when it's running in a devcontainer and adjusts agent permissions accordingly. This is safe because the container is sandboxed from your host system.
+See [docs/DEVELOPMENT_CONTAINER.md](docs/DEVELOPMENT_CONTAINER.md) for complete devcontainer management documentation.
+
+### Devcontainer Detection
+
+AIDP automatically detects when it's running inside a devcontainer and adjusts its behavior accordingly. This detection uses multiple heuristics including environment variables, filesystem markers, and cgroup information. See [DevcontainerDetector](lib/aidp/utils/devcontainer_detector.rb) for implementation details.
 
 ## Core Features
 
@@ -190,6 +201,101 @@ aidp ws rm issue-123-fix-auth --delete-branch
 
 See [Workstreams Guide](docs/WORKSTREAMS.md) for detailed usage.
 
+### Watch Mode (Automated GitHub Integration)
+
+AIDP can automatically monitor GitHub repositories and respond to labeled issues, creating plans and executing implementations autonomously:
+
+```bash
+# Start watch mode for a repository
+aidp watch https://github.com/owner/repo/issues
+
+# Optional: specify polling interval, provider, and verbose output
+aidp watch owner/repo --interval 60 --provider claude --verbose
+
+# Run a single cycle (useful for CI/testing)
+aidp watch owner/repo --once
+```
+
+**Label Workflow:**
+
+AIDP uses a smart label-based workflow to manage the lifecycle of automated issue resolution:
+
+1. **Planning Phase** (`aidp-plan` label):
+   - Add this label to an issue to trigger plan generation
+   - AIDP generates an implementation plan with task breakdown and clarifying questions
+   - Posts the plan as a comment on the issue
+   - Automatically removes the `aidp-plan` label
+
+2. **Review & Clarification**:
+   - **If questions exist**: AIDP adds `aidp-needs-input` label and waits for user response
+     - User responds to questions in a comment
+     - User manually removes `aidp-needs-input` and adds `aidp-build` to proceed
+   - **If no questions**: AIDP adds `aidp-ready` label, indicating it's ready to build
+     - User can review the plan before proceeding
+     - User manually adds `aidp-build` label when ready
+
+3. **Implementation Phase** (`aidp-build` label):
+   - Triggers autonomous implementation via work loops
+   - Creates a feature branch and commits changes
+   - Runs tests and linters with automatic fixes
+   - **If clarification needed during implementation**:
+     - Posts clarification questions as a comment
+     - Automatically removes `aidp-build` label and adds `aidp-needs-input`
+     - Preserves work-in-progress for later resumption
+     - User responds to questions, then manually removes `aidp-needs-input` and re-adds `aidp-build`
+   - **On success**:
+     - Posts completion comment with summary
+     - Automatically removes the `aidp-build` label
+
+**Customizable Labels:**
+
+All label names are configurable to match your repository's existing label scheme. Configure via the interactive wizard or manually in `aidp.yml`:
+
+```yaml
+# .aidp/aidp.yml
+watch:
+  labels:
+    plan_trigger: aidp-plan        # Label to trigger plan generation
+    needs_input: aidp-needs-input  # Label when plan needs user input
+    ready_to_build: aidp-ready     # Label when plan is ready to build
+    build_trigger: aidp-build      # Label to trigger implementation
+```
+
+Run `aidp config --interactive` and enable watch mode to configure labels interactively.
+
+**Safety Features:**
+
+- **Public Repository Protection**: Disabled by default for public repos (require explicit opt-in)
+- **Author Allowlist**: Restrict automation to trusted GitHub users only
+- **Container Requirement**: Optionally require sandboxed environment
+- **Force Override**: `--force` flag to bypass safety checks (dangerous!)
+
+**Safety Configuration:**
+
+```yaml
+# .aidp/aidp.yml
+watch:
+  safety:
+    allow_public_repos: true  # Required for public repositories
+    author_allowlist:          # Only these users can trigger automation
+      - trusted-maintainer
+      - team-member
+    require_container: true    # Require devcontainer/Docker environment
+```
+
+Run `aidp config --interactive` and enable watch mode to configure safety settings interactively.
+
+**Clarification Requests:**
+
+AIDP can automatically request clarification when it needs more information during implementation. This works in both watch mode and interactive mode:
+
+- **Watch Mode**: Posts clarification questions as a GitHub comment, updates labels to `aidp-needs-input`, and waits for user response
+- **Interactive Mode**: Prompts the user directly in the terminal to answer questions before continuing
+
+This ensures AIDP never gets stuck - if it needs more information, it will ask for it rather than making incorrect assumptions or failing silently.
+
+See [Watch Mode Guide](docs/FULLY_AUTOMATIC_MODE.md) and [Watch Mode Safety](docs/WATCH_MODE_SAFETY.md) for complete documentation.
+
 ## Command Reference
 
 ### Copilot Mode
@@ -263,6 +369,20 @@ aidp ws rm <slug> --delete-branch  # Also delete git branch
 aidp ws rm <slug> --force          # Skip confirmation
 ```
 
+### Configuration Commands
+
+```bash
+# Interactive configuration wizard (recommended)
+aidp config --interactive       # Configure all settings including watch mode
+
+# Legacy setup wizard
+aidp --setup-config             # Re-run basic setup wizard
+
+# Help and version
+aidp --help                     # Show all commands
+aidp --version                  # Show version
+```
+
 ### System Commands
 
 ```bash
@@ -275,11 +395,6 @@ aidp providers
 # Harness state management
 aidp harness status
 aidp harness reset
-
-# Configuration
-aidp --setup-config             # Re-run setup wizard
-aidp --help                     # Show all commands
-aidp --version                  # Show version
 ```
 
 ## AI Providers
@@ -291,7 +406,6 @@ AIDP intelligently manages multiple providers with automatic switching:
 - **Cursor CLI** - IDE-integrated provider for code-specific tasks
 - **Gemini CLI** - Google's Gemini command-line interface for general tasks
 - **GitHub Copilot CLI** - GitHub's AI pair programmer command-line interface
-- **macOS UI** - macOS-specific UI automation provider
 - **OpenCode** - Alternative open-source code generation provider
 
 The system automatically switches providers when: