@qelos/aidev 0.1.0

package/src/platform.ts

@@ -0,0 +1,33 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+
+export const isWindows = process.platform === 'win32';
+
+/**
+ * Finds the full path of a binary by searching PATH (and PATHEXT on Windows).
+ * Returns the resolved path, or null if not found.
+ * Uses only Node.js fs — no `which` / `where` subprocess.
+ */
+export function findBin(name: string): string | null {
+  const dirs = (process.env.PATH ?? '').split(path.delimiter).filter(Boolean);
+  const exts = isWindows
+    ? (process.env.PATHEXT ?? '.EXE;.CMD;.BAT;.COM').split(';').map((e) => e.toLowerCase())
+    : [''];
+
+  for (const dir of dirs) {
+    for (const ext of exts) {
+      const full = path.join(dir, name + ext);
+      try {
+        fs.accessSync(full, fs.constants.F_OK);
+        return full;
+      } catch {
+        // not here — keep searching
+      }
+    }
+  }
+  return null;
+}
+
+export function commandExists(name: string): boolean {
+  return findBin(name) !== null;
+}

package/src/providers/base.ts

@@ -0,0 +1,8 @@
+import { Task, Comment } from '../types';
+
+export interface TaskProvider {
+  fetchTasks(): Promise<Task[]>;
+  postComment(taskId: string, text: string): Promise<void>;
+  getComments(taskId: string): Promise<Comment[]>;
+  updateStatus(taskId: string, status: string): Promise<void>;
+}

package/src/providers/clickup.ts

@@ -0,0 +1,107 @@
+import { Task, Comment, Config } from '../types';
+import { TaskProvider } from './base';
+import { logger } from '../logger';
+
+export class ClickUpProvider implements TaskProvider {
+  private apiKey: string;
+  private teamId: string;
+  private tag: string;
+  private assigneeTag: string;
+
+  constructor(config: Config) {
+    this.apiKey = config.clickupApiKey;
+    this.teamId = config.clickupTeamId;
+    this.tag = config.clickupTag;
+    this.assigneeTag = config.assigneeTag;
+  }
+
+  private async request<T>(path: string, options: RequestInit = {}): Promise<T> {
+    const url = `https://api.clickup.com/api/v2${path}`;
+    const res = await fetch(url, {
+      ...options,
+      headers: {
+        Authorization: this.apiKey,
+        'Content-Type': 'application/json',
+        ...(options.headers || {}),
+      },
+    });
+
+    if (!res.ok) {
+      const body = await res.text();
+      throw new Error(`ClickUp API error ${res.status}: ${body}`);
+    }
+
+    return res.json() as Promise<T>;
+  }
+
+  async fetchTasks(): Promise<Task[]> {
+    logger.debug(`Fetching tasks with tag "${this.tag}" from team ${this.teamId}`);
+
+    interface RawTask {
+      id: string;
+      name: string;
+      description?: string;
+      status: { status: string };
+      url: string;
+      tags: Array<{ name: string }>;
+    }
+
+    interface TasksResponse {
+      tasks: RawTask[];
+    }
+
+    const data = await this.request<TasksResponse>(
+      `/team/${this.teamId}/task?tags[]=${encodeURIComponent(this.tag)}&subtasks=true&include_closed=false`
+    );
+
+    return data.tasks.map((t) => ({
+      id: t.id,
+      name: t.name,
+      description: t.description || '',
+      status: t.status.status.toLowerCase(),
+      url: t.url,
+      tags: t.tags.map((tag) => tag.name),
+    }));
+  }
+
+  async postComment(taskId: string, text: string): Promise<void> {
+    logger.debug(`Posting comment to task ${taskId}`);
+    await this.request(`/task/${taskId}/comment`, {
+      method: 'POST',
+      body: JSON.stringify({ comment_text: text }),
+    });
+  }
+
+  async getComments(taskId: string): Promise<Comment[]> {
+    logger.debug(`Fetching comments for task ${taskId}`);
+
+    interface RawComment {
+      id: string;
+      comment_text: string;
+      user: { username: string; id: number };
+      date: string;
+    }
+
+    interface CommentsResponse {
+      comments: RawComment[];
+    }
+
+    const data = await this.request<CommentsResponse>(`/task/${taskId}/comment`);
+
+    return data.comments.map((c) => ({
+      id: c.id,
+      text: c.comment_text,
+      author: c.user.username,
+      authorId: String(c.user.id),
+      date: parseInt(c.date, 10),
+    }));
+  }
+
+  async updateStatus(taskId: string, status: string): Promise<void> {
+    logger.debug(`Updating task ${taskId} status to "${status}"`);
+    await this.request(`/task/${taskId}`, {
+      method: 'PUT',
+      body: JSON.stringify({ status }),
+    });
+  }
+}

package/src/providers/index.ts

@@ -0,0 +1,20 @@
+import { Config } from '../types';
+import { TaskProvider } from './base';
+import { ClickUpProvider } from './clickup';
+
+export function createProvider(config: Config): TaskProvider {
+  switch (config.provider.toLowerCase()) {
+    case 'clickup':
+      return new ClickUpProvider(config);
+    case 'jira':
+      throw new Error('Jira provider is not yet implemented. Contributions welcome!');
+    case 'notion':
+      throw new Error('Notion provider is not yet implemented. Contributions welcome!');
+    case 'trello':
+      throw new Error('Trello provider is not yet implemented. Contributions welcome!');
+    default:
+      throw new Error(`Unknown provider: ${config.provider}`);
+  }
+}
+
+export { TaskProvider };

package/src/types.ts

@@ -0,0 +1,33 @@
+export interface Task {
+  id: string;
+  name: string;
+  description: string;
+  status: string;
+  url: string;
+  tags: string[];
+}
+
+export interface Comment {
+  id: string;
+  text: string;
+  author: string;
+  authorId: string;
+  date: number; // epoch ms
+}
+
+export type AgentName = 'claude' | 'cursor';
+
+export interface Config {
+  provider: string;
+  clickupApiKey: string;
+  clickupTeamId: string;
+  clickupTag: string;
+  clickupPendingStatus: string;
+  clickupInReviewStatus: string;
+  assigneeTag: string;
+  gitRemote: string;
+  githubBaseBranch: string;
+  githubRepo: string;
+  agents: AgentName[];
+  devNotesMode: 'smart' | 'always';
+}

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}