@codemcp/ade 0.2.0

package/packages/cli/src/index.ts

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+
+import { version } from "./version.js";
+import { runSetup } from "./commands/setup.js";
+import { runInstall } from "./commands/install.js";
+import { getDefaultCatalog } from "@codemcp/ade-core";
+import { getHarnessIds } from "@codemcp/ade-harnesses";
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+if (command === "setup") {
+  const projectRoot = args[1] ?? process.cwd();
+  const catalog = getDefaultCatalog();
+  await runSetup(projectRoot, catalog);
+} else if (command === "install") {
+  const projectRoot = args[1] ?? process.cwd();
+
+  let harnessIds: string[] | undefined;
+
+  // Support --harness flag (comma-separated)
+  if (args.includes("--harness")) {
+    const val = args[args.indexOf("--harness") + 1];
+    if (val) {
+      harnessIds = val.split(",").map((s) => s.trim());
+    }
+  }
+
+  await runInstall(projectRoot, harnessIds);
+} else if (command === "--version" || command === "-v") {
+  console.log(version);
+} else {
+  const allIds = getHarnessIds();
+  console.log(`ade v${version}`);
+  console.log();
+  console.log("Usage: ade <command> [options]");
+  console.log();
+  console.log("Commands:");
+  console.log(
+    "  setup [dir]      Interactive setup wizard (re-run to change selections)"
+  );
+  console.log(
+    "  install [dir]    Apply lock file to generate agent files (idempotent)"
+  );
+  console.log();
+  console.log("Options:");
+  console.log(
+    `  --harness <ids>  Comma-separated harnesses (${allIds.join(", ")})`
+  );
+  console.log("  -v, --version    Show version");
+  process.exitCode = command ? 1 : 0;
+}

package/packages/cli/src/knowledge-installer.spec.ts

@@ -0,0 +1,111 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import type { KnowledgeSource } from "@codemcp/ade-core";
+
+vi.mock("@codemcp/knowledge/packages/cli/dist/exports.js", () => ({
+  createDocset: vi.fn().mockResolvedValue({
+    docset: {},
+    configPath: ".knowledge/config.yaml",
+    configCreated: false
+  }),
+  initDocset: vi.fn().mockResolvedValue({ alreadyInitialized: false })
+}));
+
+import {
+  createDocset,
+  initDocset
+} from "@codemcp/knowledge/packages/cli/dist/exports.js";
+import { installKnowledge } from "./knowledge-installer.js";
+
+describe("installKnowledge", () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  it("does nothing when knowledge_sources is empty", async () => {
+    await installKnowledge([], "/tmp/project");
+
+    expect(createDocset).not.toHaveBeenCalled();
+    expect(initDocset).not.toHaveBeenCalled();
+  });
+
+  it("calls createDocset for each knowledge source", async () => {
+    const sources: KnowledgeSource[] = [
+      {
+        name: "react-docs",
+        origin: "https://github.com/facebook/react.git",
+        description: "React documentation"
+      },
+      {
+        name: "tanstack-query-docs",
+        origin: "https://github.com/TanStack/query.git",
+        description: "TanStack Query docs"
+      }
+    ];
+
+    await installKnowledge(sources, "/tmp/project");
+
+    expect(createDocset).toHaveBeenCalledTimes(2);
+    expect(createDocset).toHaveBeenCalledWith(
+      expect.objectContaining({
+        id: "react-docs",
+        name: "React documentation",
+        preset: "git-repo",
+        url: "https://github.com/facebook/react.git"
+      }),
+      expect.objectContaining({ cwd: "/tmp/project" })
+    );
+  });
+
+  it("calls initDocset for each knowledge source after creation", async () => {
+    const sources: KnowledgeSource[] = [
+      {
+        name: "react-docs",
+        origin: "https://github.com/facebook/react.git",
+        description: "React documentation"
+      }
+    ];
+
+    await installKnowledge(sources, "/tmp/project");
+
+    expect(initDocset).toHaveBeenCalledTimes(1);
+    expect(initDocset).toHaveBeenCalledWith(
+      expect.objectContaining({
+        docsetId: "react-docs",
+        cwd: "/tmp/project"
+      })
+    );
+  });
+
+  it("continues with remaining sources when one fails", async () => {
+    vi.mocked(createDocset)
+      .mockRejectedValueOnce(new Error("already exists"))
+      .mockResolvedValueOnce({
+        docset: {},
+        configPath: ".knowledge/config.yaml",
+        configCreated: false
+      });
+
+    const sources: KnowledgeSource[] = [
+      {
+        name: "failing",
+        origin: "https://github.com/fail/fail.git",
+        description: "Will fail"
+      },
+      {
+        name: "succeeding",
+        origin: "https://github.com/ok/ok.git",
+        description: "Will succeed"
+      }
+    ];
+
+    await installKnowledge(sources, "/tmp/project");
+
+    // Should have attempted both
+    expect(createDocset).toHaveBeenCalledTimes(2);
+    // initDocset only called for the successful one
+    expect(initDocset).toHaveBeenCalledTimes(1);
+    expect(initDocset).toHaveBeenCalledWith(
+      expect.objectContaining({ docsetId: "succeeding" })
+    );
+  });
+});

package/packages/cli/src/knowledge-installer.ts

@@ -0,0 +1,54 @@
+import type { KnowledgeSource } from "@codemcp/ade-core";
+import {
+  createDocset,
+  initDocset
+} from "@codemcp/knowledge/packages/cli/dist/exports.js";
+
+/**
+ * Install knowledge sources using the @codemcp/knowledge programmatic API.
+ *
+ * For each knowledge source:
+ * 1. Creates a docset config entry via `createDocset`
+ * 2. Initializes (downloads) the docset via `initDocset`
+ *
+ * Errors on individual sources are logged and skipped so that one failure
+ * doesn't block the rest.
+ */
+export async function installKnowledge(
+  sources: KnowledgeSource[],
+  projectRoot: string
+): Promise<void> {
+  if (sources.length === 0) return;
+
+  for (const source of sources) {
+    try {
+      await createDocset(
+        {
+          id: source.name,
+          name: source.description,
+          preset: "git-repo" as const,
+          url: source.origin
+        },
+        { cwd: projectRoot }
+      );
+    } catch (err) {
+      console.warn(
+        `Warning: failed to create docset "${source.name}":`,
+        err instanceof Error ? err.message : err
+      );
+      continue;
+    }
+
+    try {
+      await initDocset({
+        docsetId: source.name,
+        cwd: projectRoot
+      });
+    } catch (err) {
+      console.warn(
+        `Warning: failed to initialize docset "${source.name}":`,
+        err instanceof Error ? err.message : err
+      );
+    }
+  }
+}

package/packages/cli/src/version.ts

@@ -0,0 +1 @@
+export const version = "0.0.0-development";

package/packages/cli/tsconfig.build.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.build.json",
+  "compilerOptions": {
+    "outDir": "dist"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["**/*.spec.ts"]
+}

package/packages/cli/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@codemcp/ade-core": ["../core/src/index.ts"]
+    }
+  },
+  "include": ["src/**/*"]
+}

package/packages/cli/tsconfig.vitest.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "moduleResolution": "bundler"
+  },
+  "include": ["vitest.config.ts"]
+}

package/packages/cli/vitest.config.ts

@@ -0,0 +1,5 @@
+// @ts-check
+/** @type {import("vitest/config").defineConfig} */
+
+const baseConfig = await import("../../vitest.config.js");
+export default baseConfig.default;

package/packages/core/.prettierignore

@@ -0,0 +1 @@
+dist

package/packages/core/eslint.config.mjs

@@ -0,0 +1,40 @@
+import js from "@eslint/js";
+import { parser, configs } from "typescript-eslint";
+import prettier from "eslint-config-prettier";
+
+export default [
+  js.configs.recommended,
+  ...configs.recommended,
+  prettier,
+  {
+    // Config for TypeScript files
+    files: ["**/*.{ts,tsx}"],
+    languageOptions: {
+      parser,
+      parserOptions: {
+        project: ["./tsconfig.json", "./tsconfig.vitest.json"]
+      }
+    }
+  },
+  {
+    // Config for JavaScript files - no TypeScript parsing
+    files: ["**/*.{js,jsx}"],
+    ...js.configs.recommended
+  },
+  {
+    // Relaxed rules for test files
+    files: ["**/*.test.ts", "**/*.spec.ts"],
+    rules: {
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/no-unused-vars": "off"
+    }
+  },
+  {
+    ignores: [
+      "**/node_modules/**",
+      "**/dist/**",
+      ".pnpm-store/**",
+      "pnpm-lock.yaml"
+    ]
+  }
+];

package/packages/core/nodemon.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "https://json.schemastore.org/nodemon.json",
+  "watch": ["./src/**", "./node_modules/@mme/**/dist/**"],
+  "ignoreRoot": [],
+  "ext": "ts,js",
+  "exec": "pnpm typecheck && pnpm build"
+}

package/packages/core/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@codemcp/ade-core",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean:build": "rimraf ./dist",
+    "dev": "nodemon",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix .",
+    "format": "prettier --check .",
+    "format:fix": "prettier --write .",
+    "test": "vitest --run",
+    "test:watch": "vitest",
+    "typecheck": "tsc"
+  },
+  "devDependencies": {
+    "@typescript-eslint/eslint-plugin": "^8.21.0",
+    "@typescript-eslint/parser": "^8.21.0",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "prettier": "^3.4.2",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.7.3"
+  },
+  "dependencies": {
+    "yaml": "^2.8.2"
+  },
+  "version": "0.2.0"
+}