@qelos/aidev 0.7.3 → 0.7.4

package/.env.aidev.example

@@ -1,105 +1,105 @@
-# AIDEV_ENV_EXTEND: path to a shared/global env file loaded as the base for this file.
-# Values in this file override the global one. Useful for sharing API keys across projects.
-# Can also be set as a shell export (e.g. in ~/.zshrc) instead.
-# AIDEV_ENV_EXTEND=~/.aidev.global
-
-# PROVIDER: clickup | jira | linear | local | monday | notion | trello
-PROVIDER=clickup
-
-# ── ClickUp (when PROVIDER=clickup) ──────────────────────────
-CLICKUP_API_KEY=
-CLICKUP_TEAM_ID=
-# Set to * to match all tasks (useful when aidev has its own dedicated user)
-CLICKUP_TAG=
-CLICKUP_PENDING_STATUS=pending
-CLICKUP_IN_REVIEW_STATUS=review
-
-# ── Jira (when PROVIDER=jira) ─────────────────────────────────
-# JIRA_BASE_URL=https://mycompany.atlassian.net
-# JIRA_EMAIL=you@example.com
-# JIRA_API_TOKEN=
-# JIRA_PROJECT=PROJ
-# JIRA_LABEL=          # Set to * to match all issues in the project
-# JIRA_PENDING_STATUS=To Do
-# JIRA_IN_REVIEW_STATUS=In Review
-
-# ── Linear (when PROVIDER=linear) ──────────────────────────────
-# LINEAR_API_KEY=    # Personal API key from Linear Settings → API
-# LINEAR_TEAM_ID=    # Team UUID from workspace
-# Linear calls them "labels" — same concept as CLICKUP_TAG / JIRA_LABEL.
-# Tasks created via aidev.tasks.json with `tags` are mapped to Linear labels;
-# missing labels are created on the team automatically.
-# LINEAR_LABEL=        # Set to * to match all issues in the team
-# Defaults map to Linear's standard workflow state names:
-# Backlog | Todo | In Progress | In Review | Done. If your team renamed
-# these (e.g. "Triage" instead of "Backlog"), aidev will also fall back
-# to matching by Linear's underlying state type.
-# LINEAR_PENDING_STATUS=Backlog
-# LINEAR_IN_REVIEW_STATUS=In Review
-
-# ── Monday.com (when PROVIDER=monday) ──────────────────────────
-# MONDAY_API_TOKEN=
-# MONDAY_BOARD_ID=
-# MONDAY_STATUS_COLUMN_ID=status
-# MONDAY_GROUP_ID=
-# Use CLICKUP_PENDING_STATUS / CLICKUP_IN_REVIEW_STATUS for status labels (e.g. Working on it, Done)
-
-# ── Notion (when PROVIDER=notion) ──────────────────────────────
-# NOTION_API_KEY=       # Integration token from Notion → Settings → My integrations
-# NOTION_DATABASE_ID=  # Database ID from the database URL (32-char hex with optional dashes)
-# NOTION_STATUS_PROPERTY=Status
-# NOTION_PENDING_STATUS=pending
-# NOTION_IN_REVIEW_STATUS=review
-
-# ── Trello (when PROVIDER=trello) ───────────────────────────────
-# Developer API key and token from https://trello.com/power-ups/admin (or trello.com/app-key)
-# TRELLO_API_KEY=
-# TRELLO_TOKEN=
-# TRELLO_BOARD_ID=     # Short board ID from the board URL
-# TRELLO_LABEL=        # Label name on cards to pick up; set * for all cards assigned to the token user
-# List names on the board (must exist): open / pending / in progress / review workflow
-# TRELLO_OPEN_LIST=To Do
-# TRELLO_PENDING_LIST=Blocked
-# TRELLO_IN_PROGRESS_LIST=Doing
-# TRELLO_IN_REVIEW_LIST=In Review
-# TRELLO_OPEN_STATUS=open
-# TRELLO_PENDING_STATUS=pending
-# TRELLO_IN_REVIEW_STATUS=review
-
-ASSIGNEE_TAG=
-
-# THINKING_TAG: tasks with this tag are analyzed and broken into sub-tasks before execution (optional)
-THINKING_TAG=
-GIT_REMOTE=origin
-GITHUB_BASE_BRANCH=main
-GITHUB_REPO=
-
-# Agents to use, in fallback order (comma-separated: antigravity, claude, codex, cursor, windsurf)
-AGENTS=claude,cursor
-
-# DEV_NOTES_MODE: smart (only ask when unclear) | always (ask before every task)
-DEV_NOTES_MODE=smart
-
-# AIDEV_COMMENT_PREFIX: custom prefix for aidev comments in task providers (default: [aidev])
-# AIDEV_COMMENT_PREFIX=[mybot]
-
-# PR_SIGNATURE: custom signature line appended to PR body (default: "Automated PR by aidev.")
-# PR_SIGNATURE=Automated PR by my-team-bot
-
-# AIDEV_HOOKS_PATH: optional path to .ts or .js hooks module (relative to project cwd or absolute).
-# aidev init creates .aidev/aidev.hooks.ts and sets this by default.
-# AIDEV_HOOKS_PATH=.aidev/aidev.hooks.ts
-
-# AIDEV_AUTO_COMPRESS: when the prompt grows past AIDEV_COMPRESS_THRESHOLD chars,
-# summarize older comments and keep only the latest verbatim. Default: true.
-# Set to false / 0 / no to opt out.
-# AIDEV_AUTO_COMPRESS=true
-
-# AIDEV_COMPRESS_THRESHOLD: char-length threshold that triggers compression. Default: 12000.
-# AIDEV_COMPRESS_THRESHOLD=12000
-
-# AIDEV_LOG_PATH: path to the aidev log file. Can be absolute, relative (resolved
-# against the project cwd), or start with ~/. Must include the file name, not
-# just a directory. Missing parent directories are created automatically.
-# Default: aidev.log in the project cwd.
-# AIDEV_LOG_PATH=logs/aidev.log
+# AIDEV_ENV_EXTEND: path to a shared/global env file loaded as the base for this file.
+# Values in this file override the global one. Useful for sharing API keys across projects.
+# Can also be set as a shell export (e.g. in ~/.zshrc) instead.
+# AIDEV_ENV_EXTEND=~/.aidev.global
+
+# PROVIDER: clickup | jira | linear | local | monday | notion | trello
+PROVIDER=clickup
+
+# ── ClickUp (when PROVIDER=clickup) ──────────────────────────
+CLICKUP_API_KEY=
+CLICKUP_TEAM_ID=
+# Set to * to match all tasks (useful when aidev has its own dedicated user)
+CLICKUP_TAG=
+CLICKUP_PENDING_STATUS=pending
+CLICKUP_IN_REVIEW_STATUS=review
+
+# ── Jira (when PROVIDER=jira) ─────────────────────────────────
+# JIRA_BASE_URL=https://mycompany.atlassian.net
+# JIRA_EMAIL=you@example.com
+# JIRA_API_TOKEN=
+# JIRA_PROJECT=PROJ
+# JIRA_LABEL=          # Set to * to match all issues in the project
+# JIRA_PENDING_STATUS=To Do
+# JIRA_IN_REVIEW_STATUS=In Review
+
+# ── Linear (when PROVIDER=linear) ──────────────────────────────
+# LINEAR_API_KEY=    # Personal API key from Linear Settings → API
+# LINEAR_TEAM_ID=    # Team UUID from workspace
+# Linear calls them "labels" — same concept as CLICKUP_TAG / JIRA_LABEL.
+# Tasks created via aidev.tasks.json with `tags` are mapped to Linear labels;
+# missing labels are created on the team automatically.
+# LINEAR_LABEL=        # Set to * to match all issues in the team
+# Defaults map to Linear's standard workflow state names:
+# Backlog | Todo | In Progress | In Review | Done. If your team renamed
+# these (e.g. "Triage" instead of "Backlog"), aidev will also fall back
+# to matching by Linear's underlying state type.
+# LINEAR_PENDING_STATUS=Backlog
+# LINEAR_IN_REVIEW_STATUS=In Review
+
+# ── Monday.com (when PROVIDER=monday) ──────────────────────────
+# MONDAY_API_TOKEN=
+# MONDAY_BOARD_ID=
+# MONDAY_STATUS_COLUMN_ID=status
+# MONDAY_GROUP_ID=
+# Use CLICKUP_PENDING_STATUS / CLICKUP_IN_REVIEW_STATUS for status labels (e.g. Working on it, Done)
+
+# ── Notion (when PROVIDER=notion) ──────────────────────────────
+# NOTION_API_KEY=       # Integration token from Notion → Settings → My integrations
+# NOTION_DATABASE_ID=  # Database ID from the database URL (32-char hex with optional dashes)
+# NOTION_STATUS_PROPERTY=Status
+# NOTION_PENDING_STATUS=pending
+# NOTION_IN_REVIEW_STATUS=review
+
+# ── Trello (when PROVIDER=trello) ───────────────────────────────
+# Developer API key and token from https://trello.com/power-ups/admin (or trello.com/app-key)
+# TRELLO_API_KEY=
+# TRELLO_TOKEN=
+# TRELLO_BOARD_ID=     # Short board ID from the board URL
+# TRELLO_LABEL=        # Label name on cards to pick up; set * for all cards assigned to the token user
+# List names on the board (must exist): open / pending / in progress / review workflow
+# TRELLO_OPEN_LIST=To Do
+# TRELLO_PENDING_LIST=Blocked
+# TRELLO_IN_PROGRESS_LIST=Doing
+# TRELLO_IN_REVIEW_LIST=In Review
+# TRELLO_OPEN_STATUS=open
+# TRELLO_PENDING_STATUS=pending
+# TRELLO_IN_REVIEW_STATUS=review
+
+ASSIGNEE_TAG=
+
+# THINKING_TAG: tasks with this tag are analyzed and broken into sub-tasks before execution (optional)
+THINKING_TAG=
+GIT_REMOTE=origin
+GITHUB_BASE_BRANCH=main
+GITHUB_REPO=
+
+# Agents to use, in fallback order (comma-separated: antigravity, claude, codex, cursor, windsurf)
+AGENTS=claude,cursor
+
+# DEV_NOTES_MODE: smart (only ask when unclear) | always (ask before every task)
+DEV_NOTES_MODE=smart
+
+# AIDEV_COMMENT_PREFIX: custom prefix for aidev comments in task providers (default: [aidev])
+# AIDEV_COMMENT_PREFIX=[mybot]
+
+# PR_SIGNATURE: custom signature line appended to PR body (default: "Automated PR by aidev.")
+# PR_SIGNATURE=Automated PR by my-team-bot
+
+# AIDEV_HOOKS_PATH: optional path to .ts or .js hooks module (relative to project cwd or absolute).
+# aidev init creates .aidev/aidev.hooks.ts and sets this by default.
+# AIDEV_HOOKS_PATH=.aidev/aidev.hooks.ts
+
+# AIDEV_AUTO_COMPRESS: when the prompt grows past AIDEV_COMPRESS_THRESHOLD chars,
+# summarize older comments and keep only the latest verbatim. Default: true.
+# Set to false / 0 / no to opt out.
+# AIDEV_AUTO_COMPRESS=true
+
+# AIDEV_COMPRESS_THRESHOLD: char-length threshold that triggers compression. Default: 12000.
+# AIDEV_COMPRESS_THRESHOLD=12000
+
+# AIDEV_LOG_PATH: path to the aidev log file. Can be absolute, relative (resolved
+# against the project cwd), or start with ~/. Must include the file name, not
+# just a directory. Missing parent directories are created automatically.
+# Default: aidev.log in the project cwd.
+# AIDEV_LOG_PATH=logs/aidev.log

package/CONTRIBUTING.md

@@ -1,78 +1,78 @@
-# Contributing to aidev
-
-Thank you for your interest in contributing!
-
-## Getting Started
-
-1. Fork the repository
-2. Create a feature branch: `git checkout -b feature/my-feature`
-3. Make your changes
-4. Build and test: `npm install && npm run build`
-5. Open a pull request
-
-## Development Setup
-
-```bash
-git clone https://github.com/qelos-io/aidev
-cd aidev
-npm install
-npm run dev -- init        # uses tsx, no build needed
-npm run dev -- run --help
-```
-
-## Adding a New Provider
-
-1. Create `src/providers/<name>.ts` implementing the `TaskProvider` interface:
-
-```typescript
-import { TaskProvider } from './base';
-import { Task, Comment, Config } from '../types';
-
-export class MyProvider implements TaskProvider {
-  constructor(config: Config) { ... }
-  async fetchTasks(): Promise<Task[]> { ... }
-  async postComment(taskId: string, text: string): Promise<void> { ... }
-  async getComments(taskId: string): Promise<Comment[]> { ... }
-  async updateStatus(taskId: string, status: string): Promise<void> { ... }
-}
-```
-
-2. Register it in `src/providers/index.ts`:
-
-```typescript
-case 'myprovider':
-  return new MyProvider(config);
-```
-
-3. Add any new config keys to `src/types.ts` (`Config` interface) and `src/config.ts`.
-
-4. Document the new env vars in `.env.aidev.example` and `README.md`.
-
-## Adding a New AI Runner
-
-1. Create `src/ai/<name>.ts` implementing the `AIRunner` interface:
-
-```typescript
-import { AIRunner, AIRunResult } from './base';
-
-export class MyRunner implements AIRunner {
-  readonly name = 'myrunner';
-  isAvailable(): boolean { ... }
-  async run(prompt: string, notes?: string): Promise<AIRunResult> { ... }
-}
-```
-
-2. Register it in `src/ai/index.ts` and update the `AI_TOOL` logic.
-
-## Code Style
-
-- TypeScript strict mode
-- No shell string concatenation for subprocess calls — always use array args with `spawnSync`
-- Native `fetch` only — no HTTP library dependencies
-- Keep dependencies minimal
-
-## Pull Request Guidelines
-
-- One feature/fix per PR
-- Update README.md if you add new config vars or commands
-- Ensure `npm run build` passes before submitting
+# Contributing to aidev
+
+Thank you for your interest in contributing!
+
+## Getting Started
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/my-feature`
+3. Make your changes
+4. Build and test: `npm install && npm run build`
+5. Open a pull request
+
+## Development Setup
+
+```bash
+git clone https://github.com/qelos-io/aidev
+cd aidev
+npm install
+npm run dev -- init        # uses tsx, no build needed
+npm run dev -- run --help
+```
+
+## Adding a New Provider
+
+1. Create `src/providers/<name>.ts` implementing the `TaskProvider` interface:
+
+```typescript
+import { TaskProvider } from './base';
+import { Task, Comment, Config } from '../types';
+
+export class MyProvider implements TaskProvider {
+  constructor(config: Config) { ... }
+  async fetchTasks(): Promise<Task[]> { ... }
+  async postComment(taskId: string, text: string): Promise<void> { ... }
+  async getComments(taskId: string): Promise<Comment[]> { ... }
+  async updateStatus(taskId: string, status: string): Promise<void> { ... }
+}
+```
+
+2. Register it in `src/providers/index.ts`:
+
+```typescript
+case 'myprovider':
+  return new MyProvider(config);
+```
+
+3. Add any new config keys to `src/types.ts` (`Config` interface) and `src/config.ts`.
+
+4. Document the new env vars in `.env.aidev.example` and `README.md`.
+
+## Adding a New AI Runner
+
+1. Create `src/ai/<name>.ts` implementing the `AIRunner` interface:
+
+```typescript
+import { AIRunner, AIRunResult } from './base';
+
+export class MyRunner implements AIRunner {
+  readonly name = 'myrunner';
+  isAvailable(): boolean { ... }
+  async run(prompt: string, notes?: string): Promise<AIRunResult> { ... }
+}
+```
+
+2. Register it in `src/ai/index.ts` and update the `AI_TOOL` logic.
+
+## Code Style
+
+- TypeScript strict mode
+- No shell string concatenation for subprocess calls — always use array args with `spawnSync`
+- Native `fetch` only — no HTTP library dependencies
+- Keep dependencies minimal
+
+## Pull Request Guidelines
+
+- One feature/fix per PR
+- Update README.md if you add new config vars or commands
+- Ensure `npm run build` passes before submitting

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2025 aidev contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 aidev contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.