code-ai-installer 1.0.1

package/dist/platforms/adapters.js

@@ -0,0 +1,180 @@
+import path from "node:path";
+const targetLayouts = {
+    "vscode-copilot": {
+        instructionFile: ".github/copilot-instructions.md",
+        orchestratorMirrorFile: "AGENTS.md",
+        agentsDir: ".github/agents",
+        skillsDir: ".github/skills",
+        notes: "Uses copilot-instructions.md and stores role/skill docs in .github.",
+    },
+    claude: {
+        instructionFile: "CLAUDE.md",
+        orchestratorMirrorFile: "AGENTS.md",
+        agentsDir: ".claude/agents",
+        skillsDir: ".claude/skills",
+        notes: "Uses CLAUDE.md and local .claude folder for role/skill docs.",
+    },
+    "qwen-3.5": {
+        instructionFile: "QWEN.md",
+        orchestratorMirrorFile: "AGENTS.md",
+        agentsDir: ".qwen/agents",
+        skillsDir: ".qwen/skills",
+        notes: "Uses QWEN.md convention and .qwen folder for role/skill docs.",
+    },
+    "google-antugravity": {
+        instructionFile: "GEMINI.md",
+        orchestratorMirrorFile: "AGENTS.md",
+        agentsDir: ".gemini/agents",
+        skillsDir: ".gemini/skills",
+        notes: "Uses GEMINI.md convention and .gemini folder for role/skill docs.",
+    },
+    "gpt-codex": {
+        instructionFile: "CODEX.md",
+        orchestratorMirrorFile: "AGENTS.md",
+        agentsDir: ".codex/agents",
+        skillsDir: ".codex/skills",
+        notes: "Uses CODEX.md and .codex folder for role/skill docs.",
+    },
+};
+/**
+ * Returns all supported platform adapters.
+ * @returns Array of platform adapters.
+ */
+export function getPlatformAdapters() {
+    return [
+        buildAdapter("vscode-copilot", "VS Code Copilot"),
+        buildAdapter("claude", "Claude AI"),
+        buildAdapter("qwen-3.5", "Qwen 3.5"),
+        buildAdapter("google-antugravity", "Google Antugravity"),
+        buildAdapter("gpt-codex", "GPT Codex"),
+    ];
+}
+/**
+ * Returns a single platform adapter by identifier.
+ * @param target Target id.
+ * @returns Platform adapter.
+ */
+export function getPlatformAdapter(target) {
+    const found = getPlatformAdapters().find((adapter) => adapter.id === target);
+    if (!found) {
+        throw new Error(`Unsupported target: ${target}`);
+    }
+    return found;
+}
+/**
+ * Builds one adapter from target layout metadata.
+ * @param id Target id.
+ * @param label Human-readable label.
+ * @returns Configured platform adapter.
+ */
+function buildAdapter(id, label) {
+    const layout = targetLayouts[id];
+    return {
+        id,
+        label,
+        description: layout.notes,
+        defaultDestination(projectDir) {
+            return projectDir;
+        },
+        validateDestination(destinationDir) {
+            const warnings = [];
+            const normalized = path.resolve(destinationDir);
+            if (normalized.length < 3) {
+                warnings.push("Destination path looks suspiciously short.");
+            }
+            return warnings;
+        },
+        planOperations(args) {
+            return planForLayout(layout, args.catalog, args.destinationDir, args.selectedAgents, args.selectedSkills, id);
+        },
+    };
+}
+/**
+ * Plans copy and generated instruction operations for one platform layout.
+ * @param layout Platform layout.
+ * @param catalog Source catalog.
+ * @param destinationDir Destination root.
+ * @param selectedAgents Selected agent names.
+ * @param selectedSkills Selected skill names.
+ * @param target Target id.
+ * @returns Planned operations list.
+ */
+function planForLayout(layout, catalog, destinationDir, selectedAgents, selectedSkills, target) {
+    const operations = [];
+    operations.push({
+        sourcePath: catalog.orchestratorPath,
+        destinationPath: path.join(destinationDir, layout.orchestratorMirrorFile),
+        generated: false,
+        transform: {
+            target,
+            assetType: "orchestrator",
+        },
+    });
+    const instructionContent = renderInstructionFile(target, selectedAgents, selectedSkills);
+    operations.push({
+        sourcePath: "<generated>",
+        destinationPath: path.join(destinationDir, layout.instructionFile),
+        generated: true,
+        content: instructionContent,
+    });
+    for (const agentName of selectedAgents) {
+        const sourcePath = catalog.agentFiles[agentName];
+        if (!sourcePath) {
+            continue;
+        }
+        operations.push({
+            sourcePath,
+            destinationPath: path.join(destinationDir, layout.agentsDir, `${agentName}.md`),
+            generated: false,
+            transform: {
+                target,
+                assetType: "agent",
+            },
+        });
+    }
+    for (const skillName of selectedSkills) {
+        const sourcePath = catalog.skillFiles[skillName];
+        if (!sourcePath) {
+            continue;
+        }
+        operations.push({
+            sourcePath,
+            destinationPath: path.join(destinationDir, layout.skillsDir, skillName, "SKILL.md"),
+            generated: false,
+            transform: {
+                target,
+                assetType: "skill",
+            },
+        });
+    }
+    return operations;
+}
+/**
+ * Renders a platform-level instruction file with selected assets.
+ * @param target Target id.
+ * @param selectedAgents Selected agent list.
+ * @param selectedSkills Selected skill list.
+ * @returns Instruction markdown.
+ */
+function renderInstructionFile(target, selectedAgents, selectedSkills) {
+    const lines = [];
+    lines.push(`# ${target} Instructions`);
+    lines.push("");
+    lines.push("This file was generated by code-ai installer.");
+    lines.push("Use AGENTS.md as orchestration baseline.");
+    lines.push("");
+    lines.push("## Enabled Agents");
+    for (const agentName of selectedAgents) {
+        lines.push(`- ${agentName}`);
+    }
+    lines.push("");
+    lines.push("## Enabled Skills");
+    for (const skillName of selectedSkills) {
+        lines.push(`- ${skillName}`);
+    }
+    lines.push("");
+    lines.push("## Local Paths");
+    lines.push("- Agents: see platform-specific agents directory.");
+    lines.push("- Skills: see platform-specific skills directory.");
+    return `${lines.join("\n")}\n`;
+}

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Supported AI target identifiers.
+ */
+export type TargetId = "vscode-copilot" | "claude" | "qwen-3.5" | "google-antugravity" | "gpt-codex";
+/**
+ * Defines one source file and destination path copy action.
+ */
+export interface InstallOperation {
+    sourcePath: string;
+    destinationPath: string;
+    generated: boolean;
+    content?: string;
+    transform?: {
+        target: TargetId;
+        assetType: "orchestrator" | "agent" | "skill";
+    };
+}
+/**
+ * Represents discovered local assets that can be installed.
+ */
+export interface SourceCatalog {
+    rootDir: string;
+    orchestratorPath: string;
+    agentFiles: Record<string, string>;
+    skillFiles: Record<string, string>;
+}
+/**
+ * Contains runtime options for install command.
+ */
+export interface InstallOptions {
+    target: TargetId;
+    projectDir: string;
+    destinationDir: string;
+    selectedAgents: string[];
+    selectedSkills: string[];
+    dryRun: boolean;
+    overwriteMode: "skip" | "overwrite";
+    strictHints: boolean;
+}
+/**
+ * Stores install output metadata for uninstall and audit.
+ */
+export interface InstallState {
+    target: TargetId;
+    installedAt: string;
+    destinationDir: string;
+    projectDir: string;
+    files: string[];
+    selectedAgents: string[];
+    selectedSkills: string[];
+}
+/**
+ * Represents platform-specific destination layout and generated instruction files.
+ */
+export interface PlatformAdapter {
+    id: TargetId;
+    label: string;
+    description: string;
+    defaultDestination(projectDir: string): string;
+    validateDestination(destinationDir: string): string[];
+    planOperations(args: {
+        catalog: SourceCatalog;
+        destinationDir: string;
+        selectedAgents: string[];
+        selectedSkills: string[];
+    }): InstallOperation[];
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "code-ai-installer",
+  "version": "1.0.1",
+  "description": "Production-ready CLI to install code-ai agents and skills for multiple AI coding assistants.",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "bin": {
+    "code-ai": "dist/index.js"
+  },
+  "scripts": {
+    "clean": "node -e \"const fs=require('fs'); if (fs.existsSync('dist')) fs.rmSync('dist',{recursive:true,force:true});\"",
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.ts",
+    "lint": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "prepack": "npm run clean && npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "cli",
+    "agents",
+    "ai",
+    "codex",
+    "claude",
+    "qwen",
+    "copilot",
+    "gemini"
+  ],
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.2.0",
+    "prompts": "^2.4.2",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.10.2",
+    "@types/prompts": "^2.4.9",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}