@skalfa/skalfa-cli 1.0.7 → 1.0.8

package/dist/bin/skalfa.js

@@ -13,10 +13,11 @@ const create_api_1 = require("../commands/create-api");
 const create_app_1 = require("../commands/create-app");
 const pick_1 = require("../commands/pick");
 const update_1 = require("../commands/update");
+const agent_1 = require("../commands/agent");
 const fs_1 = require("../utils/fs");
 // Dynamic routing / forwarding logic
 const args = process.argv.slice(2);
-const knownCommands = ["create-api", "create-app", "add", "pick", "update"];
+const knownCommands = ["create:api", "create:app", "add", "pick", "update", "agent:install", "agent:update"];
 if (args.length > 0 && !knownCommands.includes(args[0]) && !["-h", "--help", "-v", "--version", "help"].includes(args[0])) {
     const projectRoot = (0, fs_1.findProjectRoot)(process.cwd());
     if (projectRoot) {
@@ -58,14 +59,14 @@ program
     .version(version)
     .addHelpText("before", banner);
 program
-    .command("create-api")
+    .command("create:api")
     .description("Create a new Skalfa API project.")
     .argument("<name>", "project folder and package name")
     .action(async (name) => {
     await runCommand(() => (0, create_api_1.createApi)(name));
 });
 program
-    .command("create-app")
+    .command("create:app")
     .description("Create a new Skalfa App Next.js project.")
     .argument("<name>", "project folder and package name")
     .action(async (name) => {
@@ -91,6 +92,19 @@ program
     .action(async () => {
     await runCommand(() => (0, update_1.updateCli)());
 });
+program
+    .command("agent:install")
+    .description("Install the corresponding AI coding agent (agent-api or agent-app) into the current project.")
+    .option("-t, --type <type>", "Override project type detection: api or app")
+    .action(async (options) => {
+    await runCommand(() => (0, agent_1.installAgent)(options.type));
+});
+program
+    .command("agent:update")
+    .description("Update the installed AI coding agent to the latest version.")
+    .action(async () => {
+    await runCommand(() => (0, agent_1.updateAgent)());
+});
 program.parse(process.argv);
 async function runCommand(command) {
     try {

package/dist/commands/agent.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installAgent = installAgent;
+exports.updateAgent = updateAgent;
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = __importDefault(require("node:path"));
+const node_fs_1 = __importDefault(require("node:fs"));
+async function installAgent(overrideType) {
+    let type = overrideType;
+    // 1. Auto-detect project type if not overridden
+    if (!type) {
+        const pkgPath = node_path_1.default.join(process.cwd(), "package.json");
+        if (!node_fs_1.default.existsSync(pkgPath)) {
+            throw new Error("package.json not found. Please run this command in your project root.");
+        }
+        try {
+            const pkg = JSON.parse(node_fs_1.default.readFileSync(pkgPath, "utf8"));
+            const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+            const isApi = !!(deps["elysia"] || deps["knex"] || deps["@skalfa/skalfa-api-core"]);
+            const isApp = !!(deps["react"] || deps["next"] || deps["vite"] || deps["skalfa-app-core"]);
+            if (isApi) {
+                type = "api";
+            }
+            else if (isApp) {
+                type = "app";
+            }
+            else {
+                throw new Error("Could not auto-detect project type. Please specify using --type api or --type app.");
+            }
+        }
+        catch (e) {
+            throw new Error(`Failed to auto-detect project type: ${e.message}`);
+        }
+    }
+    if (type !== "api" && type !== "app") {
+        throw new Error("Invalid agent type. Must be 'api' or 'app'.");
+    }
+    const targetDir = node_path_1.default.join(process.cwd(), ".agents");
+    if (node_fs_1.default.existsSync(targetDir)) {
+        throw new Error(".agents folder already exists. Run 'skalfa agent:update' to pull the latest changes.");
+    }
+    const repoUrl = `https://github.com/skalfa-framework/agent-${type}.git`;
+    console.log(`Cloning agent-${type} from ${repoUrl}...`);
+    try {
+        // Clone repo directly into .agents/
+        (0, node_child_process_1.execSync)(`git clone ${repoUrl} "${targetDir}"`, { stdio: "inherit" });
+    }
+    catch (e) {
+        throw new Error(`Failed to clone agent repository: ${e.message}`);
+    }
+    // 2. Copy template files to records/
+    const templatesDir = node_path_1.default.join(targetDir, "templates");
+    const recordsDir = node_path_1.default.join(targetDir, "records");
+    if (node_fs_1.default.existsSync(templatesDir)) {
+        if (!node_fs_1.default.existsSync(recordsDir)) {
+            node_fs_1.default.mkdirSync(recordsDir, { recursive: true });
+        }
+        const files = node_fs_1.default.readdirSync(templatesDir);
+        for (const file of files) {
+            const srcFile = node_path_1.default.join(templatesDir, file);
+            const destFile = node_path_1.default.join(recordsDir, file);
+            if (!node_fs_1.default.existsSync(destFile)) {
+                node_fs_1.default.copyFileSync(srcFile, destFile);
+                console.log(`Created initial record: ${file}`);
+            }
+        }
+    }
+    // 3. Add /.agents/ to project's .gitignore
+    const gitignorePath = node_path_1.default.join(process.cwd(), ".gitignore");
+    let gitignoreContent = "";
+    if (node_fs_1.default.existsSync(gitignorePath)) {
+        gitignoreContent = node_fs_1.default.readFileSync(gitignorePath, "utf8");
+    }
+    if (!gitignoreContent.includes("/.agents/")) {
+        const separator = gitignoreContent.endsWith("\n") || gitignoreContent === "" ? "" : "\n";
+        node_fs_1.default.appendFileSync(gitignorePath, `${separator}/.agents/\n`);
+        console.log("Added /.agents/ to .gitignore");
+    }
+    console.log(`\nSuccessfully installed agent-${type}!`);
+}
+async function updateAgent() {
+    const targetDir = node_path_1.default.join(process.cwd(), ".agents");
+    if (!node_fs_1.default.existsSync(targetDir)) {
+        throw new Error("No agent installed in this project. Run 'skalfa agent:install' first.");
+    }
+    const gitDir = node_path_1.default.join(targetDir, ".git");
+    if (!node_fs_1.default.existsSync(gitDir)) {
+        throw new Error(".agents folder is not a Git repository.");
+    }
+    console.log("Updating agent to the latest version...");
+    try {
+        (0, node_child_process_1.execSync)("git pull", { cwd: targetDir, stdio: "inherit" });
+        console.log("Agent updated successfully!");
+    }
+    catch (e) {
+        throw new Error(`Failed to update agent: ${e.message}`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skalfa/skalfa-cli",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Command Line Interface tool for scaffolding Skalfa projects, managing extensions, and ejecting core utilities.",
   "main": "dist/bin/skalfa.js",
   "bin": {