@pulsemcp/air-cli 0.0.1

package/README.md

@@ -0,0 +1,47 @@
+# @pulsemcp/air-cli
+
+CLI for the [AIR](https://github.com/pulsemcp/air) framework. Validates configs, lists artifacts, initializes new setups, and starts agent sessions.
+
+## Installation
+
+```bash
+npm install -g @pulsemcp/air-cli
+```
+
+## Commands
+
+```bash
+# Initialize a new AIR configuration at ~/.air/
+air init
+
+# Validate a JSON file against its AIR schema
+air validate ~/.air/air.json
+air validate ~/.air/mcp/mcp.json
+
+# List available artifacts
+air list skills
+air list mcp
+air list roots
+
+# Start an agent session
+air start claude
+air start claude --root web-app
+air start claude --root web-app --dry-run
+```
+
+## Agent Adapters
+
+`air start <agent>` discovers adapters dynamically. Install the adapter package for your agent:
+
+```bash
+# Claude Code (officially maintained)
+npm install -g @pulsemcp/air-adapter-claude
+```
+
+The CLI looks for `@pulsemcp/air-adapter-<agent>` packages. If the package is installed, the agent is available.
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `AIR_CONFIG` | Override the path to `air.json` (default: `~/.air/air.json`) |

package/dist/adapter-registry.d.ts

@@ -0,0 +1,11 @@
+import type { AgentAdapter } from "@pulsemcp/air-core";
+/**
+ * Find an adapter by agent name.
+ * Returns null if the adapter package isn't installed.
+ */
+export declare function findAdapter(name: string): Promise<AgentAdapter | null>;
+/**
+ * List all available adapter names (installed packages only).
+ */
+export declare function listAvailableAdapters(): Promise<string[]>;
+//# sourceMappingURL=adapter-registry.d.ts.map

package/dist/adapter-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.d.ts","sourceRoot":"","sources":["../src/adapter-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,oBAAoB,CAAC;AAUrE;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAsB9B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAW/D"}

package/dist/adapter-registry.js

@@ -0,0 +1,52 @@
+/**
+ * Known adapter packages. The CLI tries to dynamically import each one.
+ * If the package is installed, its adapter is available. If not, it's skipped.
+ */
+const KNOWN_ADAPTERS = [
+    { name: "claude", packageName: "@pulsemcp/air-adapter-claude" },
+];
+/**
+ * Find an adapter by agent name.
+ * Returns null if the adapter package isn't installed.
+ */
+export async function findAdapter(name) {
+    // Check known adapters first
+    for (const known of KNOWN_ADAPTERS) {
+        if (known.name === name) {
+            try {
+                const mod = await import(known.packageName);
+                const ext = mod.default;
+                return ext?.adapter ?? null;
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    // Try convention-based package name: @pulsemcp/air-adapter-{name}
+    try {
+        const mod = await import(`@pulsemcp/air-adapter-${name}`);
+        const ext = mod.default;
+        return ext?.adapter ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List all available adapter names (installed packages only).
+ */
+export async function listAvailableAdapters() {
+    const available = [];
+    for (const known of KNOWN_ADAPTERS) {
+        try {
+            await import(known.packageName);
+            available.push(known.name);
+        }
+        catch {
+            // Not installed
+        }
+    }
+    return available;
+}
+//# sourceMappingURL=adapter-registry.js.map

package/dist/adapter-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.js","sourceRoot":"","sources":["../src/adapter-registry.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,cAAc,GAA4C;IAC9D,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;CAChE,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY;IAEZ,6BAA6B;IAC7B,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBAC5C,MAAM,GAAG,GAAG,GAAG,CAAC,OAAmC,CAAC;gBACpD,OAAO,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,GAAG,CAAC,OAAmC,CAAC;QACpD,OAAO,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAChC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB;QAClB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function initCommand(): Command;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,WAAW,IAAI,OAAO,CA4DrC"}

package/dist/commands/init.js

@@ -0,0 +1,52 @@
+import { Command } from "commander";
+import { writeFileSync, existsSync, mkdirSync } from "fs";
+import { resolve, dirname } from "path";
+import { getDefaultAirJsonPath } from "@pulsemcp/air-core";
+export function initCommand() {
+    const cmd = new Command("init")
+        .description("Initialize a new AIR configuration at ~/.air/")
+        .action(() => {
+        const airJsonPath = getDefaultAirJsonPath();
+        const airDir = dirname(airJsonPath);
+        if (existsSync(airJsonPath)) {
+            console.error(`Error: ${airJsonPath} already exists.`);
+            process.exit(1);
+        }
+        mkdirSync(airDir, { recursive: true });
+        const airJson = {
+            name: "my-config",
+            description: "",
+            skills: ["./skills/skills.json"],
+            references: ["./references/references.json"],
+            mcp: ["./mcp/mcp.json"],
+            plugins: ["./plugins/plugins.json"],
+            roots: ["./roots/roots.json"],
+            hooks: ["./hooks/hooks.json"],
+        };
+        const emptyIndex = () => "{}\n";
+        writeFileSync(airJsonPath, JSON.stringify(airJson, null, 2) + "\n");
+        const files = [
+            ["skills/skills.json", emptyIndex()],
+            ["references/references.json", emptyIndex()],
+            ["mcp/mcp.json", emptyIndex()],
+            ["plugins/plugins.json", emptyIndex()],
+            ["roots/roots.json", emptyIndex()],
+            ["hooks/hooks.json", emptyIndex()],
+        ];
+        for (const [filename, content] of files) {
+            const filePath = resolve(airDir, filename);
+            mkdirSync(dirname(filePath), { recursive: true });
+            if (!existsSync(filePath)) {
+                writeFileSync(filePath, content);
+            }
+        }
+        console.log(`Initialized AIR configuration at ${airDir}/:`);
+        console.log("  air.json");
+        for (const [filename] of files) {
+            console.log(`  ${filename}`);
+        }
+        console.log("\nEdit air.json to configure your setup. Run 'air validate ~/.air/air.json' to check.");
+    });
+    return cmd;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,UAAU,WAAW;IACzB,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;SAC5B,WAAW,CAAC,+CAA+C,CAAC;SAC5D,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,WAAW,GAAG,qBAAqB,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QAEpC,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,UAAU,WAAW,kBAAkB,CAAC,CAAC;YACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvC,MAAM,OAAO,GAAG;YACd,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,EAAE;YACf,MAAM,EAAE,CAAC,sBAAsB,CAAC;YAChC,UAAU,EAAE,CAAC,8BAA8B,CAAC;YAC5C,GAAG,EAAE,CAAC,gBAAgB,CAAC;YACvB,OAAO,EAAE,CAAC,wBAAwB,CAAC;YACnC,KAAK,EAAE,CAAC,oBAAoB,CAAC;YAC7B,KAAK,EAAE,CAAC,oBAAoB,CAAC;SAC9B,CAAC;QAEF,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC;QAEhC,aAAa,CACX,WAAW,EACX,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CACxC,CAAC;QAEF,MAAM,KAAK,GAAuB;YAChC,CAAC,oBAAoB,EAAE,UAAU,EAAE,CAAC;YACpC,CAAC,4BAA4B,EAAE,UAAU,EAAE,CAAC;YAC5C,CAAC,cAAc,EAAE,UAAU,EAAE,CAAC;YAC9B,CAAC,sBAAsB,EAAE,UAAU,EAAE,CAAC;YACtC,CAAC,kBAAkB,EAAE,UAAU,EAAE,CAAC;YAClC,CAAC,kBAAkB,EAAE,UAAU,EAAE,CAAC;SACnC,CAAC;QAEF,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC;YACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC3C,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,oCAAoC,MAAM,IAAI,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,CAAC,GAAG,CACT,uFAAuF,CACxF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/commands/list.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function listCommand(): Command;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,wBAAgB,WAAW,IAAI,OAAO,CAsJrC"}

package/dist/commands/list.js

@@ -0,0 +1,138 @@
+import { Command } from "commander";
+import { getAirJsonPath, resolveArtifacts, emptyArtifacts, } from "@pulsemcp/air-core";
+const VALID_TYPES = [
+    "skills",
+    "mcp",
+    "plugins",
+    "roots",
+    "hooks",
+    "references",
+];
+export function listCommand() {
+    const cmd = new Command("list")
+        .description("List available artifacts (skills, mcp, plugins, roots, hooks, references)")
+        .argument("<type>", "Artifact type to list: skills, mcp, plugins, roots, hooks, references")
+        .action(async (type) => {
+        if (!VALID_TYPES.includes(type)) {
+            console.error(`Error: Unknown artifact type "${type}". Valid types: ${VALID_TYPES.join(", ")}`);
+            process.exit(1);
+        }
+        const airJsonPath = getAirJsonPath();
+        const artifacts = airJsonPath
+            ? await resolveArtifacts(airJsonPath)
+            : emptyArtifacts();
+        const listType = type;
+        switch (listType) {
+            case "skills": {
+                const entries = Object.entries(artifacts.skills);
+                if (entries.length === 0) {
+                    console.log("No skills found.");
+                    return;
+                }
+                console.log(`Skills (${entries.length}):\n`);
+                for (const [id, skill] of entries) {
+                    const title = skill.title ? ` (${skill.title})` : "";
+                    console.log(`  ${id}${title}`);
+                    console.log(`    ${skill.description}`);
+                    if (skill.references && skill.references.length > 0) {
+                        console.log(`    References: ${skill.references.join(", ")}`);
+                    }
+                    console.log();
+                }
+                break;
+            }
+            case "mcp": {
+                const entries = Object.entries(artifacts.mcp);
+                if (entries.length === 0) {
+                    console.log("No MCP servers found.");
+                    return;
+                }
+                console.log(`MCP Servers (${entries.length}):\n`);
+                for (const [id, server] of entries) {
+                    const title = server.title ? ` (${server.title})` : "";
+                    console.log(`  ${id}${title}`);
+                    if (server.description) {
+                        console.log(`    ${server.description}`);
+                    }
+                    console.log(`    Type: ${server.type}`);
+                    console.log();
+                }
+                break;
+            }
+            case "plugins": {
+                const entries = Object.entries(artifacts.plugins);
+                if (entries.length === 0) {
+                    console.log("No plugins found.");
+                    return;
+                }
+                console.log(`Plugins (${entries.length}):\n`);
+                for (const [id, plugin] of entries) {
+                    const title = plugin.title ? ` (${plugin.title})` : "";
+                    console.log(`  ${id}${title}`);
+                    console.log(`    ${plugin.description}`);
+                    console.log(`    Command: ${plugin.command} ${(plugin.args || []).join(" ")}`);
+                    console.log();
+                }
+                break;
+            }
+            case "roots": {
+                const entries = Object.entries(artifacts.roots);
+                if (entries.length === 0) {
+                    console.log("No roots found.");
+                    return;
+                }
+                console.log(`Roots (${entries.length}):\n`);
+                for (const [id, root] of entries) {
+                    const displayName = root.display_name || id;
+                    console.log(`  ${id} (${displayName})`);
+                    console.log(`    ${root.description}`);
+                    if (root.url) {
+                        console.log(`    URL: ${root.url}`);
+                    }
+                    if (root.default_mcp_servers?.length) {
+                        console.log(`    MCP Servers: ${root.default_mcp_servers.join(", ")}`);
+                    }
+                    if (root.default_skills?.length) {
+                        console.log(`    Skills: ${root.default_skills.join(", ")}`);
+                    }
+                    console.log();
+                }
+                break;
+            }
+            case "hooks": {
+                const entries = Object.entries(artifacts.hooks);
+                if (entries.length === 0) {
+                    console.log("No hooks found.");
+                    return;
+                }
+                console.log(`Hooks (${entries.length}):\n`);
+                for (const [id, hook] of entries) {
+                    const title = hook.title ? ` (${hook.title})` : "";
+                    console.log(`  ${id}${title}`);
+                    console.log(`    ${hook.description}`);
+                    console.log(`    Event: ${hook.event}`);
+                    console.log();
+                }
+                break;
+            }
+            case "references": {
+                const entries = Object.entries(artifacts.references);
+                if (entries.length === 0) {
+                    console.log("No references found.");
+                    return;
+                }
+                console.log(`References (${entries.length}):\n`);
+                for (const [id, ref] of entries) {
+                    const title = ref.title ? ` (${ref.title})` : "";
+                    console.log(`  ${id}${title}`);
+                    console.log(`    ${ref.description}`);
+                    console.log(`    File: ${ref.file}`);
+                    console.log();
+                }
+                break;
+            }
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"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"}

package/dist/commands/start.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function startCommand(): Command;
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,YAAY,IAAI,OAAO,CAkFtC"}

package/dist/commands/start.js

@@ -0,0 +1,112 @@
+import { Command } from "commander";
+import { getAirJsonPath, resolveArtifacts, emptyArtifacts, } from "@pulsemcp/air-core";
+import { findAdapter, listAvailableAdapters } from "../adapter-registry.js";
+export function startCommand() {
+    const cmd = new Command("start")
+        .description("Start an agent session with AIR configs loaded")
+        .argument("<agent>", "Agent to start (e.g., claude)")
+        .option("--root <name>", "Root to start the session in")
+        .option("--dry-run", "Show what would be activated without starting")
+        .option("--skip-confirmation", "Don't prompt for confirmation before starting")
+        .action(async (agent, options) => {
+        // Try to find the adapter
+        const adapter = await findAdapter(agent);
+        if (!adapter) {
+            const available = await listAvailableAdapters();
+            const availableMsg = available.length > 0
+                ? `Available: ${available.join(", ")}`
+                : "No adapters installed";
+            console.error(`Error: No adapter found for "${agent}". ${availableMsg}.\n` +
+                `Install an adapter: npm install @pulsemcp/air-adapter-${agent}`);
+            process.exit(1);
+        }
+        // Load air.json
+        const airJsonPath = getAirJsonPath();
+        const artifacts = airJsonPath
+            ? await resolveArtifacts(airJsonPath)
+            : emptyArtifacts();
+        // Resolve root if specified
+        let root;
+        if (options.root) {
+            root = artifacts.roots[options.root];
+            if (!root) {
+                console.error(`Error: Root "${options.root}" not found. Available roots: ${Object.keys(artifacts.roots).join(", ") || "(none)"}`);
+                process.exit(1);
+            }
+        }
+        // Generate config
+        const sessionConfig = adapter.generateConfig(artifacts, root);
+        // Dry run
+        if (options.dryRun) {
+            printDryRun(agent, artifacts, root);
+            process.exit(0);
+        }
+        // Check if agent is available
+        const available = await adapter.isAvailable();
+        if (!available) {
+            console.error(`Error: ${adapter.displayName} is not installed or not in PATH.`);
+            process.exit(1);
+        }
+        printDryRun(agent, artifacts, root);
+        const startCmd = adapter.buildStartCommand(sessionConfig);
+        console.log(`\nStarting ${adapter.displayName}...`);
+        console.log(`Command: ${startCmd.command} ${startCmd.args.join(" ")}`);
+    });
+    return cmd;
+}
+function printDryRun(agent, artifacts, root) {
+    console.log(`\n=== AIR Session Configuration ===`);
+    console.log(`Agent: ${agent}`);
+    if (root) {
+        console.log(`Root: ${root.name} \u2014 ${root.description}`);
+    }
+    const mcpIds = root?.default_mcp_servers || Object.keys(artifacts.mcp);
+    const skillIds = root?.default_skills || Object.keys(artifacts.skills);
+    const pluginIds = root?.default_plugins || Object.keys(artifacts.plugins);
+    const hookIds = root?.default_hooks || Object.keys(artifacts.hooks);
+    console.log(`\nMCP Servers (${mcpIds.length}):`);
+    for (const id of mcpIds) {
+        const server = artifacts.mcp[id];
+        if (server) {
+            console.log(`  \u2022 ${id} \u2014 ${server.description || server.title || "(no description)"}`);
+        }
+        else {
+            console.log(`  \u2022 ${id} \u2014 (not found)`);
+        }
+    }
+    console.log(`\nSkills (${skillIds.length}):`);
+    for (const id of skillIds) {
+        const skill = artifacts.skills[id];
+        if (skill) {
+            console.log(`  \u2022 ${id} \u2014 ${skill.description}`);
+        }
+        else {
+            console.log(`  \u2022 ${id} \u2014 (not found)`);
+        }
+    }
+    if (pluginIds.length > 0) {
+        console.log(`\nPlugins (${pluginIds.length}):`);
+        for (const id of pluginIds) {
+            const plugin = artifacts.plugins[id];
+            if (plugin) {
+                console.log(`  \u2022 ${id} \u2014 ${plugin.description}`);
+            }
+            else {
+                console.log(`  \u2022 ${id} \u2014 (not found)`);
+            }
+        }
+    }
+    if (hookIds.length > 0) {
+        console.log(`\nHooks (${hookIds.length}):`);
+        for (const id of hookIds) {
+            const hook = artifacts.hooks[id];
+            if (hook) {
+                console.log(`  \u2022 ${id} \u2014 ${hook.description}`);
+            }
+            else {
+                console.log(`  \u2022 ${id} \u2014 (not found)`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"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"}

package/dist/commands/validate.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function validateCommand(): Command;
+//# sourceMappingURL=validate.d.ts.map

package/dist/commands/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,eAAe,IAAI,OAAO,CA2EzC"}

package/dist/commands/validate.js

@@ -0,0 +1,62 @@
+import { Command } from "commander";
+import { readFileSync } from "fs";
+import { resolve } from "path";
+import { detectSchemaType, detectSchemaFromValue, isValidSchemaType, validateJson, } from "@pulsemcp/air-core";
+export function validateCommand() {
+    const cmd = new Command("validate")
+        .description("Validate a JSON file against its AIR schema")
+        .argument("<file>", "Path to the JSON file to validate")
+        .option("--schema <type>", "Override schema detection (air, skills, references, mcp, plugins, roots, hooks)")
+        .action((file, options) => {
+        const filePath = resolve(process.cwd(), file);
+        let data;
+        try {
+            const content = readFileSync(filePath, "utf-8");
+            data = JSON.parse(content);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : "Unknown error";
+            console.error(`Error: Could not read or parse "${file}": ${message}`);
+            process.exit(1);
+        }
+        // Determine schema type: --schema flag > $schema in JSON > filename substring
+        let schemaType = null;
+        if (options.schema) {
+            if (!isValidSchemaType(options.schema)) {
+                console.error(`Error: Unknown schema type "${options.schema}". Valid types: air, skills, references, mcp, plugins, roots, hooks`);
+                process.exit(1);
+            }
+            schemaType = options.schema;
+        }
+        if (!schemaType &&
+            data &&
+            typeof data === "object" &&
+            !Array.isArray(data)) {
+            const schemaValue = data.$schema;
+            if (typeof schemaValue === "string") {
+                schemaType = detectSchemaFromValue(schemaValue);
+            }
+        }
+        if (!schemaType) {
+            schemaType = detectSchemaType(file);
+        }
+        if (!schemaType) {
+            console.error(`Error: Could not detect schema type for "${file}". Use --schema to specify.`);
+            process.exit(1);
+        }
+        const result = validateJson(data, schemaType);
+        if (result.valid) {
+            console.log(`\u2713 ${file} is valid (schema: ${schemaType})`);
+            process.exit(0);
+        }
+        else {
+            console.error(`\u2717 ${file} has validation errors (schema: ${schemaType}):`);
+            for (const error of result.errors) {
+                console.error(`  ${error.path}: ${error.message}`);
+            }
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { validateCommand } from "./commands/validate.js";
+import { startCommand } from "./commands/start.js";
+import { listCommand } from "./commands/list.js";
+import { initCommand } from "./commands/init.js";
+const program = new Command();
+program
+    .name("air")
+    .description("AIR \u2014 Agent Infrastructure Repository CLI")
+    .version("0.0.1");
+program.addCommand(validateCommand());
+program.addCommand(startCommand());
+program.addCommand(listCommand());
+program.addCommand(initCommand());
+program.parseAsync();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,gDAAgD,CAAC;KAC7D,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;AACtC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AAElC,OAAO,CAAC,UAAU,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@pulsemcp/air-cli",
+  "version": "0.0.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pulsemcp/air.git",
+    "directory": "packages/cli"
+  },
+  "description": "CLI for the AIR (Agent Infrastructure Repository) framework",
+  "type": "module",
+  "bin": {
+    "air": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@pulsemcp/air-core": "0.0.1",
+    "@pulsemcp/air-adapter-claude": "0.0.1",
+    "commander": "^12.1.0",
+    "chalk": "^5.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}