@apso/cli 0.8.6 → 0.10.2

package/dist/commands/init.js

@@ -0,0 +1,313 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const core_1 = require("@oclif/core");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const shelljs_1 = tslib_1.__importDefault(require("shelljs"));
+const inquirer_1 = tslib_1.__importDefault(require("inquirer"));
+const base_command_1 = tslib_1.__importDefault(require("../lib/base-command"));
+const config_1 = require("../lib/config");
+const services_1 = require("../lib/api/services");
+const template_1 = require("../lib/utils/template");
+class Init extends base_command_1.default {
+    async run() {
+        const { flags } = await this.parse(Init);
+        // Check for git
+        if (!shelljs_1.default.which("git")) {
+            this.error("git is required but not found. Please install git and try again.");
+        }
+        // Detect existing project
+        const cwd = process.cwd();
+        if (fs.existsSync(path.join(cwd, ".apsorc")) ||
+            fs.existsSync(path.join(cwd, ".apso", "link.json"))) {
+            this.error("An Apso project already exists in this directory. Run commands from a different directory or remove .apsorc / .apso/link.json first.");
+        }
+        const isAuthenticated = !flags["skip-platform"] && config_1.credentials.isValid();
+        if (isAuthenticated) {
+            await this.runAuthenticated(flags);
+        }
+        else {
+            await this.runOffline(flags);
+        }
+    }
+    async runAuthenticated(flags) {
+        // Ask: create new or clone existing
+        const { action } = await inquirer_1.default.prompt([
+            {
+                type: "list",
+                name: "action",
+                message: "What would you like to do?",
+                choices: [
+                    { name: "Create a new project", value: "create" },
+                    { name: "Clone an existing project", value: "clone" },
+                ],
+            },
+        ]);
+        if (action === "clone") {
+            await this.cloneExisting();
+        }
+        else {
+            await this.createNew(flags);
+        }
+    }
+    async cloneExisting() {
+        // Select workspace
+        const workspaces = await services_1.workspacesApi.list();
+        if (workspaces.length === 0) {
+            this.error("No workspaces found. Create a workspace at https://app.apso.ai first.");
+        }
+        const { workspace } = await inquirer_1.default.prompt([
+            {
+                type: "list",
+                name: "workspace",
+                message: "Select a workspace:",
+                choices: workspaces.map((ws) => ({
+                    name: `${ws.name} (${ws.slug})`,
+                    value: ws,
+                })),
+            },
+        ]);
+        // Select service
+        const servicesResponse = await services_1.servicesApi.list(workspace.slug);
+        if (servicesResponse.data.length === 0) {
+            this.error(`No services found in workspace "${workspace.name}". Create one first or choose "Create a new project".`);
+        }
+        const { service } = await inquirer_1.default.prompt([
+            {
+                type: "list",
+                name: "service",
+                message: "Select a service to clone:",
+                choices: servicesResponse.data.map((svc) => ({
+                    name: `${svc.name} (${svc.slug})`,
+                    value: svc,
+                })),
+            },
+        ]);
+        const projectPath = path.join(process.cwd(), service.slug);
+        // Validate the resolved path stays within cwd
+        const resolvedPath = path.resolve(projectPath);
+        if (!resolvedPath.startsWith(path.resolve(process.cwd()))) {
+            this.error("Invalid service slug: path traversal detected");
+        }
+        if (service.githubRepo) {
+            // Clone from GitHub
+            this.log(`Cloning from ${service.githubRepo}...`);
+            const branch = service.githubBranch || "main";
+            const cloneResult = shelljs_1.default.exec(`git clone --branch="${branch}" "${service.githubRepo}" "${projectPath}"`, { silent: true });
+            if (cloneResult.code !== 0) {
+                this.error(`Failed to clone repository: ${cloneResult.stderr}`);
+            }
+        }
+        else {
+            // No GitHub repo, clone template instead
+            this.log("No GitHub repository linked to this service. Cloning default template...");
+            (0, template_1.cloneTemplate)(projectPath, "typescript", this.log.bind(this));
+            (0, template_1.initGitRepo)(projectPath);
+        }
+        // Write project link
+        const link = {
+            workspaceId: workspace.id,
+            workspaceSlug: workspace.slug,
+            serviceId: service.id,
+            serviceSlug: service.slug,
+            githubRepo: service.githubRepo,
+            githubBranch: service.githubBranch,
+            linkedAt: new Date().toISOString(),
+        };
+        config_1.projectLink.write(link, projectPath);
+        this.log(`\nProject cloned to ${projectPath}`);
+        this.log(`Linked to workspace "${workspace.name}" / service "${service.name}"`);
+    }
+    async createNew(flags) {
+        // Prompt for name if not provided
+        let projectName = flags.name;
+        if (!projectName) {
+            const response = await inquirer_1.default.prompt([
+                {
+                    type: "input",
+                    name: "projectName",
+                    message: "Enter your project name:",
+                    validate: (input) => {
+                        if (!input.trim()) {
+                            return "Project name is required";
+                        }
+                        if (!template_1.PROJECT_NAME_PATTERN.test(input)) {
+                            return "Project name must start with a letter and contain only letters, numbers, hyphens, and underscores";
+                        }
+                        return true;
+                    },
+                },
+            ]);
+            projectName = response.projectName;
+        }
+        if (!projectName || !template_1.PROJECT_NAME_PATTERN.test(projectName)) {
+            this.error("Project name must start with a letter and contain only letters, numbers, hyphens, and underscores");
+        }
+        // Prompt for language if not provided
+        let language = flags.language;
+        if (!language) {
+            const response = await inquirer_1.default.prompt([
+                {
+                    type: "list",
+                    name: "language",
+                    message: "Select your target language:",
+                    choices: [
+                        { name: "TypeScript", value: "typescript" },
+                        { name: "Python", value: "python" },
+                        { name: "Go", value: "go" },
+                    ],
+                    default: "typescript",
+                },
+            ]);
+            language = response.language;
+        }
+        const projectPath = path.join(process.cwd(), projectName);
+        const resolvedPath = path.resolve(projectPath);
+        if (!resolvedPath.startsWith(path.resolve(process.cwd()))) {
+            this.error("Invalid project name: path traversal detected");
+        }
+        // Select workspace
+        const workspaces = await services_1.workspacesApi.list();
+        if (workspaces.length === 0) {
+            this.error("No workspaces found. Create a workspace at https://app.apso.ai first.");
+        }
+        const { workspace } = await inquirer_1.default.prompt([
+            {
+                type: "list",
+                name: "workspace",
+                message: "Select a workspace:",
+                choices: workspaces.map((ws) => ({
+                    name: `${ws.name} (${ws.slug})`,
+                    value: ws,
+                })),
+            },
+        ]);
+        // Create service on platform
+        this.log(`Creating service "${projectName}" in workspace "${workspace.name}"...`);
+        const service = await services_1.servicesApi.create(workspace.slug, {
+            name: projectName,
+        });
+        // Clone template
+        (0, template_1.cloneTemplate)(projectPath, language, this.log.bind(this));
+        (0, template_1.initGitRepo)(projectPath);
+        // Write project link
+        const link = {
+            workspaceId: workspace.id,
+            workspaceSlug: workspace.slug,
+            serviceId: service.id,
+            serviceSlug: service.slug,
+            linkedAt: new Date().toISOString(),
+        };
+        config_1.projectLink.write(link, projectPath);
+        await this.postSetup(projectPath, language);
+        this.log(`\nProject created at ${projectPath}`);
+        this.log(`Language: ${language}`);
+        this.log(`Linked to workspace "${workspace.name}" / service "${service.name}"`);
+    }
+    async runOffline(flags) {
+        // Prompt for name if not provided
+        let projectName = flags.name;
+        if (!projectName) {
+            const response = await inquirer_1.default.prompt([
+                {
+                    type: "input",
+                    name: "projectName",
+                    message: "Enter your project name:",
+                    validate: (input) => {
+                        if (!input.trim()) {
+                            return "Project name is required";
+                        }
+                        if (!template_1.PROJECT_NAME_PATTERN.test(input)) {
+                            return "Project name must start with a letter and contain only letters, numbers, hyphens, and underscores";
+                        }
+                        return true;
+                    },
+                },
+            ]);
+            projectName = response.projectName;
+        }
+        if (!projectName || !template_1.PROJECT_NAME_PATTERN.test(projectName)) {
+            this.error("Project name must start with a letter and contain only letters, numbers, hyphens, and underscores");
+        }
+        // Prompt for language if not provided
+        let language = flags.language;
+        if (!language) {
+            const response = await inquirer_1.default.prompt([
+                {
+                    type: "list",
+                    name: "language",
+                    message: "Select your target language:",
+                    choices: [
+                        { name: "TypeScript", value: "typescript" },
+                        { name: "Python", value: "python" },
+                        { name: "Go", value: "go" },
+                    ],
+                    default: "typescript",
+                },
+            ]);
+            language = response.language;
+        }
+        const projectPath = path.join(process.cwd(), projectName);
+        const resolvedPath = path.resolve(projectPath);
+        if (!resolvedPath.startsWith(path.resolve(process.cwd()))) {
+            this.error("Invalid project name: path traversal detected");
+        }
+        // Clone template and init git
+        (0, template_1.cloneTemplate)(projectPath, language, this.log.bind(this));
+        (0, template_1.initGitRepo)(projectPath);
+        await this.postSetup(projectPath, language);
+        this.log(`\nProject created at ${projectPath}`);
+        this.log(`Language: ${language}`);
+        this.log('Run "apso login" to link this project to the Apso platform.');
+    }
+    async postSetup(projectPath, language) {
+        switch (language) {
+            case "typescript": {
+                if (shelljs_1.default.which("npm")) {
+                    this.log("Installing modules...");
+                    await this.runNpmCommand([
+                        "install",
+                        "--force",
+                        "--prefix",
+                        projectPath,
+                    ]);
+                }
+                else {
+                    this.log("Warning: npm not found. Skipping module installation.");
+                }
+                break;
+            }
+            case "python": {
+                this.log("Python project created. Run 'pip install -e .[dev]' to install dependencies.");
+                break;
+            }
+            case "go": {
+                this.log("Go project created. Run 'go mod tidy' to install dependencies.");
+                break;
+            }
+        }
+    }
+}
+Init.description = "Create a new Apso project or clone an existing one";
+Init.examples = [
+    `$ apso init`,
+    `$ apso init --name my-app --language typescript`,
+    `$ apso init --name my-app --language python --skip-platform`,
+];
+Init.flags = {
+    name: core_1.Flags.string({
+        char: "n",
+        description: "Project name",
+    }),
+    language: core_1.Flags.string({
+        char: "l",
+        description: "Target language (typescript, python, go)",
+        options: ["typescript", "python", "go"],
+    }),
+    "skip-platform": core_1.Flags.boolean({
+        description: "Skip platform linking (offline mode)",
+        default: false,
+    }),
+};
+exports.default = Init;

package/dist/commands/link.d.ts

@@ -0,0 +1,11 @@
+import BaseCommand from "../lib/base-command";
+export default class Link extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        workspace: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        service: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/link.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const core_1 = require("@oclif/core");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const inquirer_1 = tslib_1.__importDefault(require("inquirer"));
+const base_command_1 = tslib_1.__importDefault(require("../lib/base-command"));
+const config_1 = require("../lib/config");
+const services_1 = require("../lib/api/services");
+class Link extends base_command_1.default {
+    async run() {
+        const { flags } = await this.parse(Link);
+        // Auth guard
+        if (!config_1.credentials.isValid()) {
+            this.error("Not logged in. Run 'apso login' first.");
+        }
+        // Check .apsorc exists
+        const apsorcPath = path.join(process.cwd(), ".apsorc");
+        if (!fs.existsSync(apsorcPath)) {
+            this.error("No .apsorc found in current directory. Run 'apso init' first or navigate to an Apso project.");
+        }
+        // Check if already linked
+        if (config_1.projectLink.exists() && !flags.force) {
+            const existing = config_1.projectLink.read();
+            const { confirm } = await inquirer_1.default.prompt([
+                {
+                    type: "confirm",
+                    name: "confirm",
+                    message: `Already linked to ${existing === null || existing === void 0 ? void 0 : existing.workspaceSlug}/${existing === null || existing === void 0 ? void 0 : existing.serviceSlug}. Overwrite?`,
+                    default: false,
+                },
+            ]);
+            if (!confirm) {
+                this.log("Link unchanged.");
+                return;
+            }
+        }
+        // Determine workspace
+        let workspace;
+        if (flags.workspace) {
+            workspace = await services_1.workspacesApi.get(flags.workspace);
+        }
+        else {
+            const workspaces = await services_1.workspacesApi.list();
+            if (workspaces.length === 0) {
+                this.error("No workspaces found. Create a workspace at https://app.apso.ai first.");
+            }
+            const response = await inquirer_1.default.prompt([
+                {
+                    type: "list",
+                    name: "workspace",
+                    message: "Select a workspace:",
+                    choices: workspaces.map((ws) => ({
+                        name: `${ws.name} (${ws.slug})`,
+                        value: ws,
+                    })),
+                },
+            ]);
+            workspace = response.workspace;
+        }
+        // Determine service
+        let service;
+        if (flags.service) {
+            service = await services_1.servicesApi.get(workspace.slug, flags.service);
+        }
+        else {
+            const servicesResponse = await services_1.servicesApi.list(workspace.slug);
+            const services = servicesResponse.data;
+            const choices = [
+                ...services.map((svc) => ({
+                    name: `${svc.name} (${svc.slug})`,
+                    value: svc,
+                })),
+                { name: "+ Create new service", value: null },
+            ];
+            const { selectedService } = await inquirer_1.default.prompt([
+                {
+                    type: "list",
+                    name: "selectedService",
+                    message: "Select a service:",
+                    choices,
+                },
+            ]);
+            if (selectedService) {
+                service = selectedService;
+            }
+            else {
+                // Create new service
+                const { serviceName } = await inquirer_1.default.prompt([
+                    {
+                        type: "input",
+                        name: "serviceName",
+                        message: "Enter a name for the new service:",
+                        validate: (input) => input.trim() ? true : "Service name is required",
+                    },
+                ]);
+                this.log(`Creating service "${serviceName}"...`);
+                service = await services_1.servicesApi.create(workspace.slug, {
+                    name: serviceName,
+                });
+            }
+        }
+        // Write link
+        const link = {
+            workspaceId: workspace.id,
+            workspaceSlug: workspace.slug,
+            serviceId: service.id,
+            serviceSlug: service.slug,
+            githubRepo: service.githubRepo,
+            githubBranch: service.githubBranch,
+            linkedAt: new Date().toISOString(),
+        };
+        config_1.projectLink.write(link);
+        this.log(`Linked to workspace "${workspace.name}" / service "${service.name}"`);
+    }
+}
+Link.description = "Link this project to a platform service";
+Link.examples = [
+    `$ apso link`,
+    `$ apso link --workspace my-team --service my-api`,
+    `$ apso link --force`,
+];
+Link.flags = {
+    workspace: core_1.Flags.string({
+        char: "w",
+        description: "Workspace slug",
+    }),
+    service: core_1.Flags.string({
+        char: "s",
+        description: "Service slug",
+    }),
+    force: core_1.Flags.boolean({
+        char: "f",
+        description: "Overwrite existing link without confirmation",
+        default: false,
+    }),
+};
+exports.default = Link;

package/dist/commands/login.d.ts

@@ -0,0 +1,22 @@
+import BaseCommand from "../lib/base-command";
+export default class Login extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+        token: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    run(): Promise<void>;
+    /**
+     * Login using a direct API token (for CI/CD)
+     */
+    private loginWithToken;
+    /**
+     * Login using browser-based OAuth flow
+     */
+    private loginWithBrowser;
+    /**
+     * Find an available port for the callback server
+     */
+    private findAvailablePort;
+}