@codemcp/ade-cli 0.2.0 → 0.2.2

package/.turbo/turbo-typecheck.log

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

package/dist/commands/install.d.ts

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

package/dist/commands/install.js

@@ -1,39 +0,0 @@
-import * as clack from "@clack/prompts";
-import { readLockFile } from "@codemcp/ade-core";
-import { getHarnessWriter, getHarnessIds, installSkills, writeInlineSkills } 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);
-        }
-    }
-    const modifiedSkills = await writeInlineSkills(logicalConfig, projectRoot);
-    if (modifiedSkills.length > 0) {
-        clack.log.warn(`The following skills have been locally modified and will NOT be updated:\n` +
-            modifiedSkills.map((s) => `  - ${s}`).join("\n") +
-            `\n\nTo use the latest defaults, remove .ade/skills/ and re-run install.`);
-    }
-    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

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

package/dist/commands/setup.js

@@ -1,177 +0,0 @@
-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, writeInlineSkills } 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 (typeof selected === "string" && 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);
-        }
-    }
-    const modifiedSkills = await writeInlineSkills(logicalConfig, projectRoot);
-    if (modifiedSkills.length > 0) {
-        clack.log.warn(`The following skills have been locally modified and will NOT be updated:\n` +
-            modifiedSkills.map((s) => `  - ${s}`).join("\n") +
-            `\n\nTo use the latest defaults, remove .ade/skills/ and re-run setup.`);
-    }
-    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/knowledge-installer.d.ts

@@ -1,12 +0,0 @@
-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

@@ -1,38 +0,0 @@
-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

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

package/dist/version.js

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

package/eslint.config.mjs

@@ -1,40 +0,0 @@
-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

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

package/src/commands/conventions.integration.spec.ts

@@ -1,267 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
-import { mkdtemp, rm, readFile, access } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-
-vi.mock("@clack/prompts", () => ({
-  intro: vi.fn(),
-  outro: vi.fn(),
-  select: vi.fn(),
-  multiselect: vi.fn(),
-  confirm: vi.fn(),
-  isCancel: vi.fn().mockReturnValue(false),
-  cancel: vi.fn(),
-  spinner: vi.fn().mockReturnValue({ start: vi.fn(), stop: vi.fn() })
-}));
-
-import * as clack from "@clack/prompts";
-import { runSetup } from "./setup.js";
-import { readUserConfig, readLockFile } from "@codemcp/ade-core";
-import { getDefaultCatalog } from "../../../core/src/catalog/index.js";
-
-describe("architecture and practices facets integration", () => {
-  let dir: string;
-
-  beforeEach(async () => {
-    vi.clearAllMocks();
-    dir = await mkdtemp(join(tmpdir(), "ade-conventions-"));
-  });
-
-  afterEach(async () => {
-    await rm(dir, { recursive: true, force: true });
-  });
-
-  it(
-    "writes SKILL.md files and installs inline skills for tanstack architecture",
-    { timeout: 60_000 },
-    async () => {
-      const catalog = getDefaultCatalog();
-
-      // Facet order: process (select), architecture (select), practices (multiselect)
-      vi.mocked(clack.select)
-        .mockResolvedValueOnce("codemcp-workflows") // process
-        .mockResolvedValueOnce("tanstack"); // architecture
-      vi.mocked(clack.multiselect)
-        .mockResolvedValueOnce([]) // practices: none
-        .mockResolvedValueOnce([]) // backpressure: none
-        .mockResolvedValueOnce([]) // docsets: deselect all
-        .mockResolvedValueOnce(["claude-code"]); // harnesses
-
-      await runSetup(dir, catalog);
-
-      // Inline skills should have SKILL.md in .ade/skills/ (staging area)
-      for (const skill of [
-        "tanstack-architecture",
-        "tanstack-design",
-        "tanstack-code",
-        "tanstack-testing"
-      ]) {
-        const skillMd = await readFile(
-          join(dir, ".ade", "skills", skill, "SKILL.md"),
-          "utf-8"
-        );
-        expect(skillMd).toContain(`name: ${skill}`);
-        expect(skillMd).toContain("---");
-      }
-
-      // Inline skills should also be installed to .agentskills/skills/ by runAdd
-      for (const skill of [
-        "tanstack-architecture",
-        "tanstack-design",
-        "tanstack-code",
-        "tanstack-testing"
-      ]) {
-        const installed = await readFile(
-          join(dir, ".agentskills", "skills", skill, "SKILL.md"),
-          "utf-8"
-        );
-        expect(installed).toContain(`name: ${skill}`);
-      }
-
-      // skills-lock.json should be created by runAdd
-      const lockRaw = await readFile(join(dir, "skills-lock.json"), "utf-8");
-      const skillsLock = JSON.parse(lockRaw);
-      expect(skillsLock.skills).toBeDefined();
-
-      // skills-server MCP server should be in .mcp.json
-      const mcpJson = JSON.parse(
-        await readFile(join(dir, ".mcp.json"), "utf-8")
-      );
-      expect(mcpJson.mcpServers["agentskills"]).toMatchObject({
-        command: "npx",
-        args: ["-y", "@codemcp/skills-server"]
-      });
-    }
-  );
-
-  it("writes skills for multiple selected practices", async () => {
-    const catalog = getDefaultCatalog();
-
-    // Facet order: process (select), architecture (select), practices (multiselect)
-    vi.mocked(clack.select)
-      .mockResolvedValueOnce("native-agents-md") // process
-      .mockResolvedValueOnce("__skip__"); // architecture: skip
-    vi.mocked(clack.multiselect)
-      .mockResolvedValueOnce(["conventional-commits", "tdd-london"]) // practices
-      .mockResolvedValueOnce([]) // docsets: deselect all (conventional-commits has docset)
-      .mockResolvedValueOnce(["claude-code"]); // harnesses
-
-    await runSetup(dir, catalog);
-
-    // Both inline skills should exist in .ade/skills/ (staging)
-    const commits = await readFile(
-      join(dir, ".ade", "skills", "conventional-commits", "SKILL.md"),
-      "utf-8"
-    );
-    expect(commits).toContain("name: conventional-commits");
-    expect(commits).toContain("Conventional Commits");
-
-    const tdd = await readFile(
-      join(dir, ".ade", "skills", "tdd-london", "SKILL.md"),
-      "utf-8"
-    );
-    expect(tdd).toContain("name: tdd-london");
-    expect(tdd).toContain("London");
-
-    // Both should be installed to .agentskills/skills/
-    await expect(
-      access(join(dir, ".agentskills", "skills", "conventional-commits"))
-    ).resolves.toBeUndefined();
-    await expect(
-      access(join(dir, ".agentskills", "skills", "tdd-london"))
-    ).resolves.toBeUndefined();
-
-    // config.yaml should have array of choices under practices
-    const config = await readUserConfig(dir);
-    expect(config!.choices.practices).toEqual([
-      "conventional-commits",
-      "tdd-london"
-    ]);
-
-    // Lock file should reflect both
-    const lock = await readLockFile(dir);
-    expect(lock!.logical_config.skills.length).toBeGreaterThanOrEqual(2);
-  });
-
-  it("writes ADR skill with template content", async () => {
-    const catalog = getDefaultCatalog();
-
-    // Facet order: process (select), architecture (select), practices (multiselect)
-    vi.mocked(clack.select)
-      .mockResolvedValueOnce("native-agents-md") // process
-      .mockResolvedValueOnce("__skip__"); // architecture: skip
-    vi.mocked(clack.multiselect)
-      .mockResolvedValueOnce(["adr-nygard"])
-      .mockResolvedValueOnce(["claude-code"]); // harnesses
-
-    await runSetup(dir, catalog);
-
-    const adr = await readFile(
-      join(dir, ".ade", "skills", "adr-nygard", "SKILL.md"),
-      "utf-8"
-    );
-    expect(adr).toContain("name: adr-nygard");
-    expect(adr).toContain("## Context");
-    expect(adr).toContain("## Decision");
-    expect(adr).toContain("## Consequences");
-  });
-
-  it("skips both architecture and practices when none selected", async () => {
-    const catalog = getDefaultCatalog();
-
-    // Facet order: process (select), architecture (select), practices (multiselect)
-    vi.mocked(clack.select)
-      .mockResolvedValueOnce("native-agents-md") // process
-      .mockResolvedValueOnce("__skip__"); // architecture: skip
-    vi.mocked(clack.multiselect)
-      .mockResolvedValueOnce([]) // practices: none
-      .mockResolvedValueOnce(["claude-code"]); // harnesses
-
-    await runSetup(dir, catalog);
-
-    // No .ade directory should exist
-    await expect(access(join(dir, ".ade"))).rejects.toThrow();
-
-    // config.yaml should not have architecture or practices keys
-    const config = await readUserConfig(dir);
-    expect(config!.choices).not.toHaveProperty("architecture");
-    expect(config!.choices).not.toHaveProperty("practices");
-  });
-
-  it("exposes practices as skills, not instructions", async () => {
-    const catalog = getDefaultCatalog();
-
-    // Facet order: process (select), architecture (select), practices (multiselect)
-    vi.mocked(clack.select)
-      .mockResolvedValueOnce("native-agents-md") // process
-      .mockResolvedValueOnce("__skip__"); // architecture: skip
-    vi.mocked(clack.multiselect)
-      .mockResolvedValueOnce(["tdd-london"])
-      .mockResolvedValueOnce(["claude-code"]); // harnesses
-
-    await runSetup(dir, catalog);
-
-    // Practice produces a skill, not an instruction
-    const skillMd = await readFile(
-      join(dir, ".ade", "skills", "tdd-london", "SKILL.md"),
-      "utf-8"
-    );
-    expect(skillMd).toContain("name: tdd-london");
-
-    // Lock file should have skill but no practice-specific instructions
-    const lock = await readLockFile(dir);
-    expect(lock!.logical_config.skills.length).toBeGreaterThanOrEqual(1);
-    // Only process-facet instructions should be present (from native-agents-md)
-    for (const instruction of lock!.logical_config.instructions) {
-      expect(instruction).not.toContain("tdd-london");
-    }
-  });
-
-  it(
-    "combines architecture and practices selections",
-    { timeout: 60_000 },
-    async () => {
-      const catalog = getDefaultCatalog();
-
-      // Facet order: process (select), architecture (select), practices (multiselect)
-      vi.mocked(clack.select)
-        .mockResolvedValueOnce("codemcp-workflows") // process
-        .mockResolvedValueOnce("tanstack"); // architecture
-      vi.mocked(clack.multiselect)
-        .mockResolvedValueOnce(["tdd-london", "conventional-commits"]) // practices
-        .mockResolvedValueOnce([]) // backpressure: none
-        .mockResolvedValueOnce([]) // docsets: deselect all
-        .mockResolvedValueOnce(["claude-code"]); // harnesses
-
-      await runSetup(dir, catalog);
-
-      // Architecture skills should exist
-      const archSkill = await readFile(
-        join(dir, ".ade", "skills", "tanstack-architecture", "SKILL.md"),
-        "utf-8"
-      );
-      expect(archSkill).toContain("name: tanstack-architecture");
-
-      // Practice skills should exist
-      const tddSkill = await readFile(
-        join(dir, ".ade", "skills", "tdd-london", "SKILL.md"),
-        "utf-8"
-      );
-      expect(tddSkill).toContain("name: tdd-london");
-
-      const commitsSkill = await readFile(
-        join(dir, ".ade", "skills", "conventional-commits", "SKILL.md"),
-        "utf-8"
-      );
-      expect(commitsSkill).toContain("name: conventional-commits");
-
-      // config.yaml should have both architecture and practices
-      const config = await readUserConfig(dir);
-      expect(config!.choices.architecture).toBe("tanstack");
-      expect(config!.choices.practices).toEqual([
-        "tdd-london",
-        "conventional-commits"
-      ]);
-    }
-  );
-});