@codemcp/ade-cli 0.0.2

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @codemcp/ade-cli@0.0.2 typecheck /home/runner/work/ade/ade/packages/cli
+> tsc
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Luke Baker
+
+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.

package/dist/commands/install.d.ts

@@ -0,0 +1 @@
+export declare function runInstall(projectRoot: string, harnessIds?: string[]): Promise<void>;

package/dist/commands/install.js

@@ -0,0 +1,33 @@
+import * as clack from "@clack/prompts";
+import { readLockFile } from "@codemcp/ade-core";
+import { getHarnessWriter, getHarnessIds, installSkills } from "@codemcp/ade-harnesses";
+export async function runInstall(projectRoot, harnessIds) {
+    clack.intro("ade install");
+    const lockFile = await readLockFile(projectRoot);
+    if (!lockFile) {
+        throw new Error("config.lock.yaml not found. Run `ade setup` first.");
+    }
+    // Determine which harnesses to install for:
+    // 1. --harness flag (comma-separated)
+    // 2. harnesses saved in the lock file
+    // 3. default: universal
+    const ids = harnessIds ?? lockFile.harnesses ?? ["universal"];
+    const validIds = getHarnessIds();
+    for (const id of ids) {
+        if (!validIds.includes(id)) {
+            throw new Error(`Unknown harness "${id}". Available: ${validIds.join(", ")}`);
+        }
+    }
+    const logicalConfig = lockFile.logical_config;
+    for (const id of ids) {
+        const writer = getHarnessWriter(id);
+        if (writer) {
+            await writer.install(logicalConfig, projectRoot);
+        }
+    }
+    await installSkills(logicalConfig.skills, projectRoot);
+    if (logicalConfig.knowledge_sources.length > 0) {
+        clack.log.info("Knowledge sources configured. Initialize them separately:\n  npx @codemcp/knowledge init");
+    }
+    clack.outro("Install complete!");
+}

package/dist/commands/setup.d.ts

@@ -0,0 +1,2 @@
+import { type Catalog } from "@codemcp/ade-core";
+export declare function runSetup(projectRoot: string, catalog: Catalog): Promise<void>;

package/dist/commands/setup.js

@@ -0,0 +1,171 @@
+import * as clack from "@clack/prompts";
+import { readUserConfig, writeUserConfig, writeLockFile, resolve, collectDocsets, createDefaultRegistry, getFacet, getOption, sortFacets, getVisibleOptions } from "@codemcp/ade-core";
+import { allHarnessWriters, getHarnessWriter, installSkills } from "@codemcp/ade-harnesses";
+export async function runSetup(projectRoot, catalog) {
+    clack.intro("ade setup");
+    const existingConfig = await readUserConfig(projectRoot);
+    const existingChoices = existingConfig?.choices ?? {};
+    // Warn about stale choices that reference options no longer in the catalog
+    for (const [facetId, value] of Object.entries(existingChoices)) {
+        const facet = getFacet(catalog, facetId);
+        if (!facet)
+            continue;
+        const ids = Array.isArray(value) ? value : [value];
+        for (const optionId of ids) {
+            if (!getOption(facet, optionId)) {
+                clack.log.warn(`Previously selected option "${optionId}" is no longer available in facet "${facet.label}".`);
+            }
+        }
+    }
+    const choices = {};
+    const sortedFacets = sortFacets(catalog);
+    for (const facet of sortedFacets) {
+        const visibleOptions = getVisibleOptions(facet, choices, catalog);
+        if (visibleOptions.length === 0)
+            continue;
+        const visibleFacet = { ...facet, options: visibleOptions };
+        if (facet.multiSelect) {
+            const selected = await promptMultiSelect(visibleFacet, existingChoices);
+            if (typeof selected === "symbol") {
+                clack.cancel("Setup cancelled.");
+                return;
+            }
+            if (selected.length > 0) {
+                choices[facet.id] = selected;
+            }
+        }
+        else {
+            const selected = await promptSelect(visibleFacet, existingChoices);
+            if (typeof selected === "symbol") {
+                clack.cancel("Setup cancelled.");
+                return;
+            }
+            if (selected !== "__skip__") {
+                choices[facet.id] = selected;
+            }
+        }
+    }
+    // Docset confirmation step: collect implied docsets, let user deselect
+    const impliedDocsets = collectDocsets(choices, catalog);
+    let excludedDocsets;
+    if (impliedDocsets.length > 0) {
+        const selected = await clack.multiselect({
+            message: "Documentation — deselect any you don't need",
+            options: impliedDocsets.map((d) => ({
+                value: d.id,
+                label: d.label,
+                hint: d.description
+            })),
+            initialValues: impliedDocsets.map((d) => d.id),
+            required: false
+        });
+        if (typeof selected === "symbol") {
+            clack.cancel("Setup cancelled.");
+            return;
+        }
+        const selectedSet = new Set(selected);
+        const excluded = impliedDocsets
+            .filter((d) => !selectedSet.has(d.id))
+            .map((d) => d.id);
+        if (excluded.length > 0) {
+            excludedDocsets = excluded;
+        }
+    }
+    // Harness selection — multi-select from all available harnesses
+    const existingHarnesses = existingConfig?.harnesses;
+    const harnessOptions = allHarnessWriters.map((w) => ({
+        value: w.id,
+        label: w.label,
+        hint: w.description
+    }));
+    const validExistingHarnesses = existingHarnesses?.filter((h) => allHarnessWriters.some((w) => w.id === h));
+    const selectedHarnesses = await clack.multiselect({
+        message: "Harnesses — which coding agents should receive config?",
+        options: harnessOptions,
+        initialValues: validExistingHarnesses && validExistingHarnesses.length > 0
+            ? validExistingHarnesses
+            : ["universal"],
+        required: false
+    });
+    if (typeof selectedHarnesses === "symbol") {
+        clack.cancel("Setup cancelled.");
+        return;
+    }
+    const harnesses = selectedHarnesses;
+    const userConfig = {
+        choices,
+        ...(excludedDocsets && { excluded_docsets: excludedDocsets }),
+        ...(harnesses.length > 0 && { harnesses })
+    };
+    const registry = createDefaultRegistry();
+    const logicalConfig = await resolve(userConfig, catalog, registry);
+    await writeUserConfig(projectRoot, userConfig);
+    const lockFile = {
+        version: 1,
+        generated_at: new Date().toISOString(),
+        choices: userConfig.choices,
+        ...(harnesses.length > 0 && { harnesses }),
+        logical_config: logicalConfig
+    };
+    await writeLockFile(projectRoot, lockFile);
+    // Install to all selected harnesses
+    for (const harnessId of harnesses) {
+        const writer = getHarnessWriter(harnessId);
+        if (writer) {
+            await writer.install(logicalConfig, projectRoot);
+        }
+    }
+    await installSkills(logicalConfig.skills, projectRoot);
+    if (logicalConfig.knowledge_sources.length > 0) {
+        clack.log.info("Knowledge sources selected. Initialize them separately:\n  npx @codemcp/knowledge init");
+    }
+    for (const note of logicalConfig.setup_notes) {
+        clack.log.info(note);
+    }
+    clack.outro("Setup complete!");
+}
+function getValidInitialValue(facet, existingChoices) {
+    const value = existingChoices[facet.id];
+    if (typeof value !== "string")
+        return undefined;
+    // Only set initialValue if the option still exists in the catalog
+    return facet.options.some((o) => o.id === value) ? value : undefined;
+}
+function getValidInitialValues(facet, existingChoices) {
+    const value = existingChoices[facet.id];
+    if (!Array.isArray(value))
+        return undefined;
+    // Only include options that still exist in the catalog
+    const valid = value.filter((v) => facet.options.some((o) => o.id === v));
+    return valid.length > 0 ? valid : undefined;
+}
+function promptSelect(facet, existingChoices) {
+    const options = facet.options.map((o) => ({
+        value: o.id,
+        label: o.label,
+        hint: o.description
+    }));
+    if (!facet.required) {
+        options.push({ value: "__skip__", label: "Skip", hint: "" });
+    }
+    const initialValue = getValidInitialValue(facet, existingChoices);
+    return clack.select({
+        message: facet.label,
+        options,
+        ...(initialValue !== undefined && { initialValue })
+    });
+}
+function promptMultiSelect(facet, existingChoices) {
+    const options = facet.options.map((o) => ({
+        value: o.id,
+        label: o.label,
+        hint: o.description
+    }));
+    const initialValues = getValidInitialValues(facet, existingChoices);
+    return clack.multiselect({
+        message: facet.label,
+        options,
+        required: false,
+        ...(initialValues !== undefined && { initialValues })
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,43 @@
+#!/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;
+    // 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/dist/knowledge-installer.d.ts

@@ -0,0 +1,12 @@
+import type { KnowledgeSource } from "@codemcp/ade-core";
+/**
+ * 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 declare function installKnowledge(sources: KnowledgeSource[], projectRoot: string): Promise<void>;

package/dist/knowledge-installer.js

@@ -0,0 +1,38 @@
+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, projectRoot) {
+    if (sources.length === 0)
+        return;
+    for (const source of sources) {
+        try {
+            await createDocset({
+                id: source.name,
+                name: source.description,
+                preset: "git-repo",
+                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/dist/version.d.ts

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

package/dist/version.js

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

package/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/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/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@codemcp/ade-cli",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "ade": "dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.1.0",
+    "@codemcp/ade-core": "0.0.2",
+    "@codemcp/ade-harnesses": "0.0.2"
+  },
+  "devDependencies": {
+    "@codemcp/knowledge": "2.1.0",
+    "@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"
+  },
+  "version": "0.0.2",
+  "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"
+  }
+}