agent-bober 0.1.0

package/dist/utils/git.js

@@ -0,0 +1,84 @@
+import { execa } from "execa";
+// ── Git Helpers ────────────────────────────────────────────────────
+/**
+ * Get the name of the currently checked-out branch.
+ */
+export async function getCurrentBranch(cwd) {
+    const { stdout } = await execa("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
+        cwd,
+    });
+    return stdout.trim();
+}
+/**
+ * Create a new branch and check it out.
+ */
+export async function createBranch(cwd, name) {
+    await execa("git", ["checkout", "-b", name], { cwd });
+}
+/**
+ * Stage all changes and create a commit.
+ *
+ * @returns The short hash of the new commit.
+ */
+export async function commitAll(cwd, message) {
+    await execa("git", ["add", "-A"], { cwd });
+    await execa("git", ["commit", "-m", message], { cwd });
+    const { stdout } = await execa("git", ["rev-parse", "--short", "HEAD"], {
+        cwd,
+    });
+    return stdout.trim();
+}
+/**
+ * Get a list of files changed since a given ref (defaults to HEAD).
+ *
+ * Returns relative paths as reported by git.
+ */
+export async function getChangedFiles(cwd, since) {
+    const ref = since ?? "HEAD";
+    const { stdout } = await execa("git", ["diff", "--name-only", ref], { cwd, reject: false });
+    return stdout
+        .split("\n")
+        .map((l) => l.trim())
+        .filter(Boolean);
+}
+/**
+ * Get the unified diff since a given ref (defaults to HEAD).
+ */
+export async function getDiff(cwd, since) {
+    const ref = since ?? "HEAD";
+    const { stdout } = await execa("git", ["diff", ref], {
+        cwd,
+        reject: false,
+    });
+    return stdout;
+}
+/**
+ * Check whether the working tree has uncommitted changes (staged or unstaged).
+ */
+export async function hasUncommittedChanges(cwd) {
+    const { stdout } = await execa("git", ["status", "--porcelain"], {
+        cwd,
+        reject: false,
+    });
+    return stdout.trim().length > 0;
+}
+/**
+ * Stash any current changes, run the provided function, then restore.
+ *
+ * If the stash is empty (nothing to save) the restore step is skipped.
+ */
+export async function stashAndRestore(cwd, fn) {
+    const dirty = await hasUncommittedChanges(cwd);
+    if (dirty) {
+        await execa("git", ["stash", "push", "-m", "bober-auto-stash"], { cwd });
+    }
+    try {
+        return await fn();
+    }
+    finally {
+        if (dirty) {
+            await execa("git", ["stash", "pop"], { cwd, reject: false });
+        }
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,sEAAsE;AAEtE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE;QAC3E,GAAG;KACJ,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,IAAY;IAC1D,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,OAAe;IAEf,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3C,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAEvD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE;QACtE,GAAG;KACJ,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,KAAc;IAEd,MAAM,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAC5B,KAAK,EACL,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,EAC5B,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CACvB,CAAC;IACF,OAAO,MAAM;SACV,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAW,EACX,KAAc;IAEd,MAAM,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE;QACnD,GAAG;QACH,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAW;IACrD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE;QAC/D,GAAG;QACH,MAAM,EAAE,KAAK;KACd,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAW,EACX,EAAoB;IAEpB,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAE/C,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { Logger, logger, type LogLevel } from "./logger.js";
+export { getCurrentBranch, createBranch, commitAll, getChangedFiles, getDiff, stashAndRestore, hasUncommittedChanges, } from "./git.js";
+export { fileExists, readJson, writeJson, ensureDir, findProjectRoot, } from "./fs.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,OAAO,EACP,eAAe,EACf,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,EACT,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,4 @@
+export { Logger, logger } from "./logger.js";
+export { getCurrentBranch, createBranch, commitAll, getChangedFiles, getDiff, stashAndRestore, hasUncommittedChanges, } from "./git.js";
+export { fileExists, readJson, writeJson, ensureDir, findProjectRoot, } from "./fs.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAiB,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,OAAO,EACP,eAAe,EACf,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,EACT,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,45 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export declare class Logger {
+    verbose: boolean;
+    /** Informational message (cyan prefix). */
+    info(message: string, ...args: unknown[]): void;
+    /** Success message (green prefix + checkmark). */
+    success(message: string, ...args: unknown[]): void;
+    /** Warning message (yellow prefix). */
+    warn(message: string, ...args: unknown[]): void;
+    /** Error message (red prefix). */
+    error(message: string, ...args: unknown[]): void;
+    /** Debug message — only shown when verbose mode is enabled. */
+    debug(message: string, ...args: unknown[]): void;
+    /**
+     * Print a prominent phase transition header.
+     *
+     * Example output:
+     * ```
+     * ═══ PLANNING PHASE ═══
+     * ```
+     */
+    phase(name: string): void;
+    /**
+     * Print a sprint status update.
+     *
+     * @param id     Sprint identifier.
+     * @param status Current status label.
+     */
+    sprint(id: string, status: string): void;
+    /**
+     * Print a simple text-based progress indicator.
+     *
+     * Example: `[████████░░░░░░░░] 4/10 Generating...`
+     *
+     * @param current Completed items.
+     * @param total   Total items.
+     * @param label   Optional description.
+     */
+    progress(current: number, total: number, label?: string): void;
+}
+/**
+ * Singleton logger instance used across the application.
+ */
+export declare const logger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAI3D,qBAAa,MAAM;IACjB,OAAO,UAAS;IAEhB,2CAA2C;IAC3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,kDAAkD;IAClD,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIlD,uCAAuC;IACvC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C,kCAAkC;IAClC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD,+DAA+D;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAKhD;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKxC;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;CAS/D;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,73 @@
+import chalk from "chalk";
+// ── Logger ─────────────────────────────────────────────────────────
+export class Logger {
+    verbose = false;
+    /** Informational message (cyan prefix). */
+    info(message, ...args) {
+        console.log(chalk.cyan("info"), message, ...args);
+    }
+    /** Success message (green prefix + checkmark). */
+    success(message, ...args) {
+        console.log(chalk.green("  ✓"), message, ...args);
+    }
+    /** Warning message (yellow prefix). */
+    warn(message, ...args) {
+        console.warn(chalk.yellow("warn"), message, ...args);
+    }
+    /** Error message (red prefix). */
+    error(message, ...args) {
+        console.error(chalk.red("error"), message, ...args);
+    }
+    /** Debug message — only shown when verbose mode is enabled. */
+    debug(message, ...args) {
+        if (!this.verbose)
+            return;
+        console.log(chalk.gray("debug"), message, ...args);
+    }
+    /**
+     * Print a prominent phase transition header.
+     *
+     * Example output:
+     * ```
+     * ═══ PLANNING PHASE ═══
+     * ```
+     */
+    phase(name) {
+        const banner = `═══ ${name.toUpperCase()} ═══`;
+        console.log();
+        console.log(chalk.bold.magenta(banner));
+        console.log();
+    }
+    /**
+     * Print a sprint status update.
+     *
+     * @param id     Sprint identifier.
+     * @param status Current status label.
+     */
+    sprint(id, status) {
+        const tag = chalk.bold.blue(`[${id}]`);
+        console.log(`${tag} ${status}`);
+    }
+    /**
+     * Print a simple text-based progress indicator.
+     *
+     * Example: `[████████░░░░░░░░] 4/10 Generating...`
+     *
+     * @param current Completed items.
+     * @param total   Total items.
+     * @param label   Optional description.
+     */
+    progress(current, total, label) {
+        const width = 20;
+        const filled = Math.round((current / Math.max(total, 1)) * width);
+        const empty = width - filled;
+        const bar = chalk.green("█".repeat(filled)) + chalk.gray("░".repeat(empty));
+        const suffix = label ? ` ${label}` : "";
+        console.log(`  [${bar}] ${current}/${total}${suffix}`);
+    }
+}
+/**
+ * Singleton logger instance used across the application.
+ */
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,sEAAsE;AAEtE,MAAM,OAAO,MAAM;IACjB,OAAO,GAAG,KAAK,CAAC;IAEhB,2CAA2C;IAC3C,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,kDAAkD;IAClD,OAAO,CAAC,OAAe,EAAE,GAAG,IAAe;QACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,uCAAuC;IACvC,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,kCAAkC;IAClC,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,+DAA+D;IAC/D,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAY;QAChB,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;QAC/C,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,EAAU,EAAE,MAAc;QAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC,CAAC;IAClC,CAAC;IAED;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAe,EAAE,KAAa,EAAE,KAAc;QACrD,MAAM,KAAK,GAAG,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QAClE,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;QAC7B,MAAM,GAAG,GACP,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,OAAO,IAAI,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/hooks/hooks.json

@@ -0,0 +1,10 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "command": "echo 'Files modified \u2014 run /bober:eval to verify'"
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "agent-bober",
+  "version": "0.1.0",
+  "description": "Generator-Evaluator multi-agent harness for building applications autonomously with Claude. Implements planner, sprint, and evaluator patterns.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "agent-bober": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "claude",
+    "agent",
+    "harness",
+    "multi-agent",
+    "autonomous",
+    "generator-evaluator",
+    "claude-code",
+    "plugin"
+  ],
+  "author": "bober4ik",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bober4ik/agent-bober"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/",
+    "skills/",
+    "agents/",
+    "hooks/",
+    "scripts/",
+    "templates/",
+    ".claude-plugin/"
+  ],
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "execa": "^9.5.2",
+    "glob": "^11.0.1",
+    "ora": "^8.1.1",
+    "prompts": "^2.4.2",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.13.0",
+    "@types/prompts": "^2.4.9",
+    "@typescript-eslint/eslint-plugin": "^8.22.0",
+    "@typescript-eslint/parser": "^8.22.0",
+    "eslint": "^9.19.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  }
+}

package/scripts/detect-stack.sh

@@ -0,0 +1,287 @@
+#!/usr/bin/env bash
+# ──────────────────────────────────────────────────────────────────────
+# detect-stack.sh — Auto-detect the technology stack of a project.
+#
+# Usage:
+#   bash scripts/detect-stack.sh [project-dir]
+#
+# If no directory is given, uses the current working directory.
+# Outputs a JSON object describing the detected stack.
+# ──────────────────────────────────────────────────────────────────────
+
+set -euo pipefail
+
+PROJECT_DIR="${1:-.}"
+PROJECT_DIR="$(cd "$PROJECT_DIR" && pwd)"
+
+# ── Helpers ─────────────────────────────────────────────────────────
+
+# Check if a file exists in the project
+has_file() {
+  [[ -f "$PROJECT_DIR/$1" ]]
+}
+
+# Check if package.json contains a dependency (dev or prod)
+has_dep() {
+  if has_file "package.json"; then
+    grep -q "\"$1\"" "$PROJECT_DIR/package.json" 2>/dev/null
+  else
+    return 1
+  fi
+}
+
+# ── Language Detection ──────────────────────────────────────────────
+
+LANGUAGES=()
+
+if has_file "package.json"; then
+  LANGUAGES+=("javascript")
+fi
+
+if has_file "tsconfig.json" || has_dep "typescript"; then
+  LANGUAGES+=("typescript")
+fi
+
+if has_file "requirements.txt" || has_file "pyproject.toml" || has_file "Pipfile" || has_file "setup.py"; then
+  LANGUAGES+=("python")
+fi
+
+if has_file "go.mod"; then
+  LANGUAGES+=("go")
+fi
+
+if has_file "Cargo.toml"; then
+  LANGUAGES+=("rust")
+fi
+
+if has_file "pom.xml" || has_file "build.gradle" || has_file "build.gradle.kts"; then
+  LANGUAGES+=("java")
+fi
+
+if has_file "mix.exs"; then
+  LANGUAGES+=("elixir")
+fi
+
+if has_file "Gemfile"; then
+  LANGUAGES+=("ruby")
+fi
+
+# ── Framework Detection ─────────────────────────────────────────────
+
+FRAMEWORKS=()
+
+if has_dep "react"; then
+  FRAMEWORKS+=("react")
+fi
+
+if has_dep "vue"; then
+  FRAMEWORKS+=("vue")
+fi
+
+if has_dep "@angular/core"; then
+  FRAMEWORKS+=("angular")
+fi
+
+if has_dep "svelte"; then
+  FRAMEWORKS+=("svelte")
+fi
+
+if has_dep "next"; then
+  FRAMEWORKS+=("nextjs")
+fi
+
+if has_dep "nuxt"; then
+  FRAMEWORKS+=("nuxt")
+fi
+
+if has_dep "astro"; then
+  FRAMEWORKS+=("astro")
+fi
+
+if has_dep "remix" || has_dep "@remix-run/node"; then
+  FRAMEWORKS+=("remix")
+fi
+
+if has_dep "express"; then
+  FRAMEWORKS+=("express")
+fi
+
+if has_dep "fastify"; then
+  FRAMEWORKS+=("fastify")
+fi
+
+if has_dep "hono"; then
+  FRAMEWORKS+=("hono")
+fi
+
+if has_dep "koa"; then
+  FRAMEWORKS+=("koa")
+fi
+
+if has_dep "nestjs" || has_dep "@nestjs/core"; then
+  FRAMEWORKS+=("nestjs")
+fi
+
+# Python frameworks
+if has_file "requirements.txt" || has_file "pyproject.toml"; then
+  COMBINED=""
+  [[ -f "$PROJECT_DIR/requirements.txt" ]] && COMBINED+="$(cat "$PROJECT_DIR/requirements.txt")"
+  [[ -f "$PROJECT_DIR/pyproject.toml" ]] && COMBINED+="$(cat "$PROJECT_DIR/pyproject.toml")"
+
+  echo "$COMBINED" | grep -qi "django" && FRAMEWORKS+=("django")
+  echo "$COMBINED" | grep -qi "flask" && FRAMEWORKS+=("flask")
+  echo "$COMBINED" | grep -qi "fastapi" && FRAMEWORKS+=("fastapi")
+fi
+
+# ── Test Framework Detection ────────────────────────────────────────
+
+TEST_FRAMEWORKS=()
+
+if has_dep "vitest"; then
+  TEST_FRAMEWORKS+=("vitest")
+fi
+
+if has_dep "jest"; then
+  TEST_FRAMEWORKS+=("jest")
+fi
+
+if has_dep "mocha"; then
+  TEST_FRAMEWORKS+=("mocha")
+fi
+
+if has_dep "@playwright/test"; then
+  TEST_FRAMEWORKS+=("playwright")
+fi
+
+if has_dep "cypress"; then
+  TEST_FRAMEWORKS+=("cypress")
+fi
+
+if has_dep "@testing-library/react" || has_dep "@testing-library/vue"; then
+  TEST_FRAMEWORKS+=("testing-library")
+fi
+
+# Python test frameworks
+if has_file "requirements.txt" || has_file "pyproject.toml" || has_file "setup.cfg"; then
+  for f in requirements.txt pyproject.toml setup.cfg; do
+    if has_file "$f" && grep -qi "pytest" "$PROJECT_DIR/$f" 2>/dev/null; then
+      TEST_FRAMEWORKS+=("pytest")
+      break
+    fi
+  done
+fi
+
+# Go testing is built-in; check for testify
+if has_file "go.mod" && grep -q "testify" "$PROJECT_DIR/go.mod" 2>/dev/null; then
+  TEST_FRAMEWORKS+=("testify")
+fi
+
+# ── Linter Detection ───────────────────────────────────────────────
+
+LINTERS=()
+
+if has_dep "eslint" || has_file ".eslintrc.json" || has_file ".eslintrc.js" || has_file "eslint.config.js" || has_file "eslint.config.mjs"; then
+  LINTERS+=("eslint")
+fi
+
+if has_dep "@biomejs/biome" || has_file "biome.json" || has_file "biome.jsonc"; then
+  LINTERS+=("biome")
+fi
+
+if has_dep "prettier" || has_file ".prettierrc" || has_file ".prettierrc.json" || has_file "prettier.config.js"; then
+  LINTERS+=("prettier")
+fi
+
+if has_file ".pylintrc" || has_file "pyproject.toml"; then
+  if has_file "pyproject.toml" && grep -qi "ruff" "$PROJECT_DIR/pyproject.toml" 2>/dev/null; then
+    LINTERS+=("ruff")
+  fi
+  if has_file ".pylintrc"; then
+    LINTERS+=("pylint")
+  fi
+fi
+
+if has_file ".golangci.yml" || has_file ".golangci.yaml"; then
+  LINTERS+=("golangci-lint")
+fi
+
+# ── Build Tool Detection ───────────────────────────────────────────
+
+BUILD_TOOLS=()
+
+if has_dep "vite" || has_file "vite.config.ts" || has_file "vite.config.js"; then
+  BUILD_TOOLS+=("vite")
+fi
+
+if has_dep "webpack" || has_file "webpack.config.js" || has_file "webpack.config.ts"; then
+  BUILD_TOOLS+=("webpack")
+fi
+
+if has_dep "esbuild"; then
+  BUILD_TOOLS+=("esbuild")
+fi
+
+if has_dep "turbo" || has_file "turbo.json"; then
+  BUILD_TOOLS+=("turborepo")
+fi
+
+if has_dep "rollup" || has_file "rollup.config.js" || has_file "rollup.config.mjs"; then
+  BUILD_TOOLS+=("rollup")
+fi
+
+if has_dep "tsup"; then
+  BUILD_TOOLS+=("tsup")
+fi
+
+if has_file "Makefile"; then
+  BUILD_TOOLS+=("make")
+fi
+
+if has_file "Dockerfile" || has_file "docker-compose.yml" || has_file "docker-compose.yaml"; then
+  BUILD_TOOLS+=("docker")
+fi
+
+# ── Package Manager Detection ──────────────────────────────────────
+
+PACKAGE_MANAGER="unknown"
+
+if has_file "pnpm-lock.yaml"; then
+  PACKAGE_MANAGER="pnpm"
+elif has_file "yarn.lock"; then
+  PACKAGE_MANAGER="yarn"
+elif has_file "bun.lockb" || has_file "bun.lock"; then
+  PACKAGE_MANAGER="bun"
+elif has_file "package-lock.json"; then
+  PACKAGE_MANAGER="npm"
+elif has_file "package.json"; then
+  PACKAGE_MANAGER="npm"
+fi
+
+# ── Output JSON ─────────────────────────────────────────────────────
+
+json_array() {
+  local arr=("$@")
+  if [[ ${#arr[@]} -eq 0 ]]; then
+    echo "[]"
+    return
+  fi
+  local result="["
+  for i in "${!arr[@]}"; do
+    [[ $i -gt 0 ]] && result+=","
+    result+="\"${arr[$i]}\""
+  done
+  result+="]"
+  echo "$result"
+}
+
+cat <<EOF
+{
+  "projectDir": "$PROJECT_DIR",
+  "languages": $(json_array "${LANGUAGES[@]+"${LANGUAGES[@]}"}"),
+  "frameworks": $(json_array "${FRAMEWORKS[@]+"${FRAMEWORKS[@]}"}"),
+  "testFrameworks": $(json_array "${TEST_FRAMEWORKS[@]+"${TEST_FRAMEWORKS[@]}"}"),
+  "linters": $(json_array "${LINTERS[@]+"${LINTERS[@]}"}"),
+  "buildTools": $(json_array "${BUILD_TOOLS[@]+"${BUILD_TOOLS[@]}"}"),
+  "packageManager": "$PACKAGE_MANAGER"
+}
+EOF