Skip to content

Conversation

@ericelliott
Copy link
Collaborator

@ericelliott ericelliott commented Oct 23, 2025


Note

Enhances agent rules and CLI help, adds GitHub Actions test matrix, splits tests into unit/E2E, fixes CORS header handling, and bumps version to 1.12.0.

  • CI/CD
    • Add /.github/workflows/test.yml running Node 18/20/22 matrix with install and tests.
  • Testing
    • Split tests into unit/E2E (test:unit, test:e2e); move integration to new *-e2e.test.js.
    • New CLI help E2E tests; improve release hook E2E with retry/backoff; remove legacy help test.
    • Husky pre-commit now runs npm run test:unit.
  • CLI/Docs
    • Update bin/aidd.js help: clearer AI assistant command context and Quick Start.
    • README title tweak to SudoLang.ai AIDD; add ToC tooling (doctoc script/devDep).
    • Add archived epics for README/help updates; update activity-log.md.
  • Agent Rules
    • ai/rules/please.mdc: expanded persona and constraints.
    • ai/rules/review.mdc: stricter OWASP checklist, add Constraints, minor naming fixes.
    • ai/rules/task-creator.mdc: simplified epic template/constraints, add /execute, separate executeTask, updated pipelines.
  • Server
    • with-cors: rely on lowercase origin header (Node normalization).
    • Fix example import in src/server/index.js to aidd/lib/asyncPipe.js.
  • Repo hygiene
    • Ignore /.agent-tools/; remove large agent tool artifact.
    • Bump version to 1.12.0; update package-lock.json accordingly.

Written by Cursor Bugbot for commit 8853c90. This will update automatically on new commits. Configure here.

Update the JSDoc example in src/server/index.js to use the correct published package import path 'aidd/lib/asyncPipe.js' instead of 'aidd/lib'. This matches the actual file structure when the package is published and aligns with how the asyncPipe module is imported in create-route.js.

The createWithConfig export was already correctly included in the middleware/index.js exports.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
…claude/fix-import-path-jsdoc-011CUQZ2nqppG3bP13oPE1GA
Node.js automatically normalizes all incoming HTTP headers to lowercase, as documented in the Node.js HTTP module behavior. The defensive checking for both 'origin' and 'Origin' is unnecessary since request.headers will always contain lowercase header names.

This change:
- Removes the redundant || request.headers?.Origin check
- Adds a comment explaining Node.js's header normalization behavior
- Simplifies the code without changing functionality

All CORS tests continue to pass (12/12 tests verified).

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
The "hook integration with stable version" test was flaky due to race conditions in git operations. Git tag creation and verification can have timing issues, especially under load or on slower systems.

Root causes identified:
1. Fixed 100ms delay was insufficient on slower systems
2. Sequential git operations had timing dependencies
3. No retry mechanism for git tag verification
4. Poor error diagnostics in catch block

Fix implemented:
- Added retryGitOperation helper with exponential backoff (50ms, 100ms, 200ms, 400ms, 800ms)
- Applied retry logic to all git rev-parse operations
- Removed fixed delay in favor of retry-based synchronization
- Better error propagation with meaningful failure messages

Test validation:
- Ran 10 consecutive times: 10/10 passed
- Full test suite: 87/87 tests passing

The test is worth keeping because it validates the real integration point between release-it and the hook script, which is not covered by unit tests.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Add a GitHub Actions workflow that runs the test suite on push and pull requests. This ensures code quality and catches issues early in the development process.

Features:
- Runs on push to main and claude/** branches
- Runs on all pull requests to main
- Tests against Node.js 18, 20, and 22 for compatibility
- Uses npm cache for faster builds
- Executes `npm install && npm test`

The workflow will help maintain code quality and provide immediate feedback on test failures.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings October 23, 2025 18:24
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR refines the AIDD agent system with improvements to clarity, testing infrastructure, and documentation. The changes focus on making AI workflow commands more understandable, separating unit and E2E tests, and improving code maintainability through better comments and test organization.

Key changes:

  • Enhanced AI agent system documentation with clearer role descriptions and workflow separation
  • Separated unit tests from E2E tests for faster development feedback
  • Improved code clarity by removing redundant header checks and fixing import examples

Reviewed Changes

Copilot reviewed 15 out of 21 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
tasks/archive/2025-10-20-help-command-clarity-epic.md Documents completed epic for improving help command clarity with AI workflow context
src/server/middleware/with-cors.js Simplified origin header handling by removing redundant uppercase check
src/server/index.js Fixed import path example in documentation
package.json Added test:unit and test:e2e scripts, version bump to 1.12.0
lib/release-process-e2e.test.js Enhanced git operation reliability with retry mechanism
lib/release-helpers.test.js Removed integration tests (moved to separate E2E file)
lib/release-helpers-e2e.test.js New E2E test file with git integration tests
ai/rules/task-creator.mdc Refined task planning format with clearer structure and separation of concerns
ai/rules/review.mdc Enhanced review criteria and added constraints section
ai/rules/please.mdc Updated AI agent role description
ai/.agent-tools/8a9ed9ec-76df-4d82-a0ea-0c1c888d780d.txt Removed large diff file
activity-log.md Added entries for October 20, 2025 changes
README.md Minor title formatting change
.husky/pre-commit Changed to run only unit tests in pre-commit hook
.github/workflows/test.yml Added GitHub Actions CI workflow

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

Comment on lines +60 to +62
1. Gather any additional context or clarification needed
1. Present the task/epic plan to the user for approval
1. Add the plan to the project root .plan.md file, with a reference to the epic plan file
Copy link

Copilot AI Oct 23, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All list items are numbered '1.' instead of sequential numbers (2, 3). This creates ambiguity in the ordering of steps.

Copilot uses AI. Check for mistakes.
@ericelliott ericelliott merged commit 49538ce into main Oct 23, 2025
7 checks passed
@ericelliott ericelliott deleted the claude/github-action-test-011CUQZ2nqppG3bP13oPE1GA branch October 23, 2025 18:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants