@objectstack/cli 4.0.4 → 4.1.0

package/dist/commands/projects/create.js

@@ -0,0 +1,120 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+import { Command, Flags } from '@oclif/core';
+import { printError } from '../../utils/format.js';
+import { createApiClient, requireAuth } from '../../utils/api-client.js';
+import { formatOutput } from '../../utils/output-formatter.js';
+import { readAuthConfig, writeAuthConfig } from '../../utils/auth-config.js';
+/**
+ * `os projects create` — provision a new project.
+ *
+ * Delegates to `ProjectProvisioningService.provisionProject` on the server.
+ * On success, optionally activates the new project for the current session
+ * and persists `activeProjectId` into `~/.objectstack/credentials.json`
+ * (unless `--no-activate` is passed).
+ */
+export default class ProjectsCreate extends Command {
+    static description = 'Provision a new project';
+    static examples = [
+        '$ os projects create --org 00000000-0000-0000-0000-000000000000 --name Staging',
+        '$ os projects create --org $ORG --name Dev --plan free',
+        '$ os projects create --org $ORG --name "Clone" --clone-from <source-id> --no-activate',
+        '$ os projects create --org $ORG --name CRM --artifact ./examples/app-crm/dist/objectstack.json',
+    ];
+    static flags = {
+        url: Flags.string({ char: 'u', description: 'Server URL', env: 'OS_CLOUD_URL' }),
+        token: Flags.string({ char: 't', description: 'Authentication token', env: 'OS_TOKEN' }),
+        org: Flags.string({ description: 'Organization id', required: true }),
+        name: Flags.string({ description: 'Display name', required: true }),
+        plan: Flags.string({ description: 'Billing plan', default: 'free' }),
+        driver: Flags.string({ description: 'Data-plane driver id' }),
+        template: Flags.string({ description: 'Built-in template id (e.g. crm, todo, blank)' }),
+        artifact: Flags.string({
+            description: 'Path to a locally-compiled objectstack.json artifact to bind into this project',
+        }),
+        'clone-from': Flags.string({ description: 'Clone schema from an existing project id' }),
+        activate: Flags.boolean({
+            description: 'Activate the new project for subsequent CLI calls',
+            default: true,
+            allowNo: true,
+        }),
+        format: Flags.string({
+            char: 'f',
+            description: 'Output format',
+            options: ['json', 'table', 'yaml'],
+            default: 'table',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ProjectsCreate);
+        try {
+            const { client, token } = await createApiClient({ url: flags.url, token: flags.token });
+            requireAuth(token);
+            // Resolve the artifact to an absolute path so the server can read it
+            // regardless of its CWD. Bail early if the file is missing — better
+            // to fail before provisioning than leave a half-bound project.
+            let metadata;
+            if (flags.artifact) {
+                const path = await import('node:path');
+                const fs = await import('node:fs/promises');
+                const abs = path.isAbsolute(flags.artifact)
+                    ? flags.artifact
+                    : path.resolve(process.cwd(), flags.artifact);
+                try {
+                    await fs.access(abs);
+                }
+                catch {
+                    printError(`Artifact not found: ${abs}`);
+                    this.exit(1);
+                }
+                metadata = { artifact_path: abs };
+            }
+            const res = await client.projects.create({
+                organization_id: flags.org,
+                display_name: flags.name,
+                plan: flags.plan,
+                driver: flags.driver,
+                template_id: flags.template,
+                clone_from_project_id: flags['clone-from'],
+                ...(metadata ? { metadata } : {}),
+            });
+            if (flags.activate && res?.project?.id) {
+                try {
+                    await client.projects.activate(res.project.id);
+                    const cfg = await readAuthConfig().catch(() => null);
+                    if (cfg) {
+                        cfg.activeProjectId = res.project.id;
+                        cfg.lastUsedAt = new Date().toISOString();
+                        await writeAuthConfig(cfg);
+                    }
+                }
+                catch (activateError) {
+                    // Creation succeeded — surface activation failure as a warning
+                    console.error(`  ⚠ activation failed: ${activateError.message}`);
+                }
+            }
+            if (flags.format === 'json') {
+                formatOutput(res, 'json');
+            }
+            else if (flags.format === 'yaml') {
+                formatOutput(res, 'yaml');
+            }
+            else {
+                const p = res?.project ?? {};
+                console.log(`\n✓ Project created: ${p.display_name ?? p.id} (${p.id})`);
+                if (flags.activate) {
+                    console.log(`  active project set to ${p.id}`);
+                }
+                console.log('');
+            }
+        }
+        catch (error) {
+            if (flags.format === 'json') {
+                console.log(JSON.stringify({ success: false, error: error.message }, null, 2));
+                this.exit(1);
+            }
+            printError(error.message || String(error));
+            this.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/projects/create.js.map

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

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

@@ -0,0 +1,21 @@
+import { Command } from '@oclif/core';
+/**
+ * `os projects list` — list projects visible to the current session.
+ *
+ * Filters by organization via `--org`. Output format is the same
+ * table/json/yaml shape used by other metadata commands, for a
+ * consistent DX.
+ */
+export default class ProjectsList extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        org: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/projects/list.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAK7C;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,OAAgB,WAAW,SAAkD;IAE7E,OAAgB,QAAQ,WAItB;IAEF,OAAgB,KAAK;;;;;;MAWnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiD3B"}

package/dist/commands/projects/list.js

@@ -0,0 +1,79 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+import { Command, Flags } from '@oclif/core';
+import { printError } from '../../utils/format.js';
+import { createApiClient, requireAuth } from '../../utils/api-client.js';
+import { formatOutput } from '../../utils/output-formatter.js';
+/**
+ * `os projects list` — list projects visible to the current session.
+ *
+ * Filters by organization via `--org`. Output format is the same
+ * table/json/yaml shape used by other metadata commands, for a
+ * consistent DX.
+ */
+export default class ProjectsList extends Command {
+    static description = 'List projects visible to the current session';
+    static examples = [
+        '$ os projects list',
+        '$ os projects list --org 00000000-0000-0000-0000-000000000000',
+        '$ os projects list --format json',
+    ];
+    static flags = {
+        url: Flags.string({ char: 'u', description: 'Server URL', env: 'OS_CLOUD_URL' }),
+        token: Flags.string({ char: 't', description: 'Authentication token', env: 'OS_TOKEN' }),
+        org: Flags.string({ description: 'Filter by organization id' }),
+        status: Flags.string({ description: 'Filter by project status (active|provisioning|failed|…)' }),
+        format: Flags.string({
+            char: 'f',
+            description: 'Output format',
+            options: ['json', 'table', 'yaml'],
+            default: 'table',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(ProjectsList);
+        try {
+            const { client, token, projectId: activeId } = await createApiClient({
+                url: flags.url,
+                token: flags.token,
+            });
+            requireAuth(token);
+            const res = await client.projects.list({
+                organization_id: flags.org,
+                status: flags.status,
+            });
+            const projects = res?.projects ?? [];
+            if (flags.format === 'json') {
+                formatOutput(res, 'json');
+            }
+            else if (flags.format === 'yaml') {
+                formatOutput(res, 'yaml');
+            }
+            else {
+                console.log(`\nProjects (${projects.length}):\n`);
+                if (projects.length === 0) {
+                    console.log('  (no projects)');
+                }
+                else {
+                    for (const p of projects) {
+                        const active = p.id === activeId ? ' ★' : '';
+                        const defaultTag = p.is_default ? ' [default]' : '';
+                        const systemTag = p.is_system ? ' [system]' : '';
+                        console.log(`  • ${p.display_name ?? p.id}${active}${defaultTag}${systemTag}`);
+                        console.log(`      id:   ${p.id}`);
+                        console.log(`      status: ${p.status ?? '—'}  plan: ${p.plan ?? '—'}`);
+                    }
+                }
+                console.log('');
+            }
+        }
+        catch (error) {
+            if (flags.format === 'json') {
+                console.log(JSON.stringify({ success: false, error: error.message }, null, 2));
+                this.exit(1);
+            }
+            printError(error.message || String(error));
+            this.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/projects/list.js.map

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

package/dist/commands/projects/projects.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=projects.test.d.ts.map

package/dist/commands/projects/projects.test.d.ts.map

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

package/dist/commands/projects/projects.test.js

@@ -0,0 +1,56 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+import { describe, it, expect } from 'vitest';
+import ProjectsList from './list.js';
+import ProjectsShow from './show.js';
+import ProjectsCreate from './create.js';
+import ProjectsSwitch from './switch.js';
+/**
+ * Metadata-only smoke tests for the `os projects ...` commands. We do
+ * not run the commands end-to-end (that would require an oclif Config
+ * with hooks wired up); instead we assert that each command is a
+ * well-formed oclif Command class with the flags / args we expect.
+ *
+ * This catches typos and missing-arg regressions without the heavy
+ * lifting of a full oclif harness. Full runtime coverage lives in
+ * `client.project-scoping.test.ts` (which exercises the HTTP surface)
+ * and the Chrome DevTools MCP smoke test in the PR description.
+ */
+describe('os projects commands', () => {
+    describe('list', () => {
+        it('has the expected description and flags', () => {
+            expect(ProjectsList.description).toMatch(/list/i);
+            expect(ProjectsList.flags).toHaveProperty('org');
+            expect(ProjectsList.flags).toHaveProperty('status');
+            expect(ProjectsList.flags).toHaveProperty('format');
+        });
+    });
+    describe('show', () => {
+        it('requires an id arg', () => {
+            expect(ProjectsShow.args).toHaveProperty('id');
+            expect(ProjectsShow.args.id.required).toBe(true);
+        });
+    });
+    describe('create', () => {
+        it('requires --org and --name', () => {
+            expect(ProjectsCreate.flags.org.required).toBe(true);
+            expect(ProjectsCreate.flags.name.required).toBe(true);
+        });
+        it('activates by default with --no-activate opt-out', () => {
+            const flag = ProjectsCreate.flags.activate;
+            expect(flag.default).toBe(true);
+            expect(flag.allowNo).toBe(true);
+        });
+    });
+    describe('switch', () => {
+        it('requires an id arg', () => {
+            expect(ProjectsSwitch.args).toHaveProperty('id');
+            expect(ProjectsSwitch.args.id.required).toBe(true);
+        });
+        it('calls the activate endpoint by default with --no-remote opt-out', () => {
+            const flag = ProjectsSwitch.flags.remote;
+            expect(flag.default).toBe(true);
+            expect(flag.allowNo).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=projects.test.js.map

package/dist/commands/projects/projects.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.test.js","sourceRoot":"","sources":["../../../src/commands/projects/projects.test.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,YAAY,MAAM,WAAW,CAAC;AACrC,OAAO,YAAY,MAAM,WAAW,CAAC;AACrC,OAAO,cAAc,MAAM,aAAa,CAAC;AACzC,OAAO,cAAc,MAAM,aAAa,CAAC;AAEzC;;;;;;;;;;GAUG;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;QACpB,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAClD,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACjD,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YACpD,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;QACpB,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAC/C,MAAM,CAAE,YAAY,CAAC,IAAY,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACnC,MAAM,CAAE,cAAc,CAAC,KAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9D,MAAM,CAAE,cAAc,CAAC,KAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,IAAI,GAAI,cAAc,CAAC,KAAa,CAAC,QAAQ,CAAC;YACpD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,CAAE,cAAc,CAAC,IAAY,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;YACzE,MAAM,IAAI,GAAI,cAAc,CAAC,KAAa,CAAC,MAAM,CAAC;YAClD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/projects/show.d.ts

@@ -0,0 +1,21 @@
+import { Command } from '@oclif/core';
+/**
+ * `os projects show <id>` — show detailed information for a single project.
+ *
+ * Renders the project row plus its database, active credential, and
+ * membership row (same shape as `client.projects.get(id)`).
+ */
+export default class ProjectsShow extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=show.d.ts.map

package/dist/commands/projects/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/projects/show.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAKnD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,OAAO;IAC/C,OAAgB,WAAW,SAA6C;IAExE,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;MASnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAwC3B"}

package/dist/commands/projects/show.js

@@ -0,0 +1,72 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+import { Args, Command, Flags } from '@oclif/core';
+import { printError } from '../../utils/format.js';
+import { createApiClient, requireAuth } from '../../utils/api-client.js';
+import { formatOutput } from '../../utils/output-formatter.js';
+/**
+ * `os projects show <id>` — show detailed information for a single project.
+ *
+ * Renders the project row plus its database, active credential, and
+ * membership row (same shape as `client.projects.get(id)`).
+ */
+export default class ProjectsShow extends Command {
+    static description = 'Show detailed information for a project';
+    static examples = [
+        '$ os projects show 00000000-0000-0000-0000-000000000001',
+        '$ os projects show proj-123 --format json',
+    ];
+    static args = {
+        id: Args.string({ description: 'Project id', required: true }),
+    };
+    static flags = {
+        url: Flags.string({ char: 'u', description: 'Server URL', env: 'OS_CLOUD_URL' }),
+        token: Flags.string({ char: 't', description: 'Authentication token', env: 'OS_TOKEN' }),
+        format: Flags.string({
+            char: 'f',
+            description: 'Output format',
+            options: ['json', 'table', 'yaml'],
+            default: 'table',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ProjectsShow);
+        try {
+            const { client, token } = await createApiClient({ url: flags.url, token: flags.token });
+            requireAuth(token);
+            const res = await client.projects.get(args.id);
+            if (flags.format === 'json') {
+                formatOutput(res, 'json');
+            }
+            else if (flags.format === 'yaml') {
+                formatOutput(res, 'yaml');
+            }
+            else {
+                const p = res?.project ?? {};
+                console.log(`\nProject: ${p.display_name ?? p.id}`);
+                console.log('─'.repeat(60));
+                console.log(`  id:             ${p.id}`);
+                console.log(`  organization:   ${p.organization_id ?? '—'}`);
+                console.log(`  status:         ${p.status ?? '—'}`);
+                console.log(`  plan:           ${p.plan ?? '—'}`);
+                console.log(`  is_default:     ${Boolean(p.is_default)}`);
+                console.log(`  is_system:      ${Boolean(p.is_system)}`);
+                if (res?.database) {
+                    console.log(`  database:       ${res.database.driver ?? '—'} @ ${res.database.database_url ?? '—'}`);
+                }
+                if (res?.membership) {
+                    console.log(`  yourRole:       ${res.membership.role ?? '—'}`);
+                }
+                console.log('');
+            }
+        }
+        catch (error) {
+            if (flags.format === 'json') {
+                console.log(JSON.stringify({ success: false, error: error.message }, null, 2));
+                this.exit(1);
+            }
+            printError(error.message || String(error));
+            this.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/projects/show.js.map

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

package/dist/commands/projects/switch.d.ts

@@ -0,0 +1,24 @@
+import { Command } from '@oclif/core';
+/**
+ * `os projects switch <id>` — set the active project for this CLI session.
+ *
+ * Calls `POST /api/v1/cloud/projects/:id/activate` to update the
+ * server-side session, then persists `activeProjectId` into
+ * `~/.objectstack/credentials.json` so subsequent CLI commands (and any
+ * client they create via `createApiClient`) automatically target this
+ * project.
+ */
+export default class ProjectsSwitch extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        remote: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=switch.d.ts.map

package/dist/commands/projects/switch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../../src/commands/projects/switch.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAKnD;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,OAAO;IACjD,OAAgB,WAAW,SAAiD;IAE5E,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;MAQnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAkC3B"}

package/dist/commands/projects/switch.js

@@ -0,0 +1,64 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+import { Args, Command, Flags } from '@oclif/core';
+import { printError } from '../../utils/format.js';
+import { createApiClient, requireAuth } from '../../utils/api-client.js';
+import { readAuthConfig, writeAuthConfig } from '../../utils/auth-config.js';
+/**
+ * `os projects switch <id>` — set the active project for this CLI session.
+ *
+ * Calls `POST /api/v1/cloud/projects/:id/activate` to update the
+ * server-side session, then persists `activeProjectId` into
+ * `~/.objectstack/credentials.json` so subsequent CLI commands (and any
+ * client they create via `createApiClient`) automatically target this
+ * project.
+ */
+export default class ProjectsSwitch extends Command {
+    static description = 'Activate a project for subsequent CLI calls';
+    static examples = [
+        '$ os projects switch 00000000-0000-0000-0000-000000000001',
+        '$ os projects switch proj-123 --no-remote',
+    ];
+    static args = {
+        id: Args.string({ description: 'Project id to activate', required: true }),
+    };
+    static flags = {
+        url: Flags.string({ char: 'u', description: 'Server URL', env: 'OS_CLOUD_URL' }),
+        token: Flags.string({ char: 't', description: 'Authentication token', env: 'OS_TOKEN' }),
+        remote: Flags.boolean({
+            description: 'Also call /activate on the server (updates the session row)',
+            default: true,
+            allowNo: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ProjectsSwitch);
+        try {
+            const { client, token } = await createApiClient({ url: flags.url, token: flags.token });
+            requireAuth(token);
+            // Sanity-check the id resolves — fail fast before writing the cred file
+            const lookup = await client.projects.get(args.id);
+            const project = lookup?.project;
+            if (!project?.id) {
+                throw new Error(`Project ${args.id} not found`);
+            }
+            if (flags.remote) {
+                await client.projects.activate(project.id);
+            }
+            const cfg = await readAuthConfig();
+            cfg.activeProjectId = project.id;
+            cfg.lastUsedAt = new Date().toISOString();
+            await writeAuthConfig(cfg);
+            console.log(`\n✓ Active project: ${project.display_name ?? project.id}`);
+            console.log(`  id: ${project.id}`);
+            if (!flags.remote) {
+                console.log('  (local only — server session unchanged)');
+            }
+            console.log('');
+        }
+        catch (error) {
+            printError(error.message || String(error));
+            this.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=switch.js.map

package/dist/commands/projects/switch.js.map

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

package/dist/commands/publish.d.ts

@@ -0,0 +1,17 @@
+import { Command } from '@oclif/core';
+export default class Publish extends Command {
+    static description: string;
+    static args: {
+        artifact: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        server: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        timeout: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        note: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        branch: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=publish.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/commands/publish.ts"],"names":[],"mappings":"AAIA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAGnD,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,OAAO;IAC1C,OAAgB,WAAW,SAAsD;IAEjF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;;;;MAiCnB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA2F3B"}