@git.zone/tsdeploy 0.2.0

package/.smartconfig.json

@@ -0,0 +1,44 @@
+{
+  "@git.zone/cli": {
+    "schemaVersion": 2,
+    "projectType": "npm",
+    "module": {
+      "githost": "code.foss.global",
+      "gitscope": "git.zone",
+      "gitrepo": "tsdeploy",
+      "description": "Cloudly and Onebox first deployment orchestration CLI for git.zone TypeScript tooling.",
+      "npmPackagename": "@git.zone/tsdeploy",
+      "license": "MIT",
+      "keywords": [
+        "deployment",
+        "Cloudly",
+        "Onebox",
+        "serve.zone",
+        "TypeScript",
+        "CLI",
+        "git.zone"
+      ]
+    },
+    "release": {
+      "targets": {
+        "git": {
+          "enabled": true,
+          "remote": "origin",
+          "pushBranch": true,
+          "pushTags": true
+        },
+        "npm": {
+          "enabled": true,
+          "registries": [
+            "https://registry.npmjs.org"
+          ],
+          "accessLevel": "public",
+          "alreadyPublished": "success"
+        }
+      }
+    }
+  },
+  "@ship.zone/szci": {
+    "npmGlobalTools": []
+  }
+}

package/cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+process.env.CLI_CALL = 'true';
+const cliTool = await import('./dist_ts/index.js');
+cliTool.runCli();

package/dist_ts/00_commitinfo_data.d.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export declare const commitinfo: {
+    name: string;
+    version: string;
+    description: string;
+};

package/dist_ts/00_commitinfo_data.js

@@ -0,0 +1,9 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+    name: '@git.zone/tsdeploy',
+    version: '0.2.0',
+    description: 'Cloudly and Onebox first deployment orchestration CLI for git.zone TypeScript tooling.'
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxvQkFBb0I7SUFDMUIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHdGQUF3RjtDQUN0RyxDQUFBIn0=

package/dist_ts/classes.tsdeploy.d.ts

@@ -0,0 +1,23 @@
+import type { ITsDeployDoctorResult, ITsDeployLinkOptions, ITsDeployPlan, ITsDeployProfile, ITsDeployProjectLink, ITsDeployPublicProfile, ITsDeploySaveProfileOptions, ITsDeployStatus, ITsDeployUserState } from './types.js';
+export interface ITsDeployOptions {
+    projectDir?: string;
+    profileStorePath?: string;
+    ephemeralProfileStore?: boolean;
+}
+export declare const redactProfile: (profileArg: ITsDeployProfile) => ITsDeployPublicProfile;
+export declare class TsDeploy {
+    readonly projectDir: string;
+    private readonly profileStore;
+    constructor(optionsArg?: ITsDeployOptions);
+    get projectLinkPath(): string;
+    private createProfileStore;
+    readUserState(): Promise<ITsDeployUserState>;
+    saveProfile(optionsArg: ITsDeploySaveProfileOptions): Promise<ITsDeployPublicProfile>;
+    getProfile(profileArg?: string): Promise<ITsDeployProfile | undefined>;
+    readProjectLink(): Promise<ITsDeployProjectLink | undefined>;
+    writeProjectLink(optionsArg: ITsDeployLinkOptions): Promise<ITsDeployProjectLink>;
+    private normalizeProjectLink;
+    getStatus(): Promise<ITsDeployStatus>;
+    buildPlan(): Promise<ITsDeployPlan>;
+    doctor(): Promise<ITsDeployDoctorResult>;
+}

package/dist_ts/classes.tsdeploy.js

@@ -0,0 +1,219 @@
+import * as plugins from './plugins.js';
+const schemaVersion = 1;
+const profileNameRegex = /^[a-zA-Z0-9._-]+$/;
+const normalizeProfileName = (profileArg) => {
+    const profile = profileArg.trim();
+    if (!profile || !profileNameRegex.test(profile)) {
+        throw new Error('Profile names may only contain letters, numbers, dots, dashes, and underscores.');
+    }
+    return profile;
+};
+const normalizeTarget = (targetArg) => {
+    if (targetArg === 'cloudly' || targetArg === 'onebox') {
+        return targetArg;
+    }
+    throw new Error('Target must be either "cloudly" or "onebox".');
+};
+const normalizeOrigin = (originArg) => {
+    const url = new URL(originArg);
+    url.pathname = url.pathname.replace(/\/$/, '');
+    return url.toString().replace(/\/$/, '');
+};
+export const redactProfile = (profileArg) => {
+    const { token, ...publicProfile } = profileArg;
+    return {
+        ...publicProfile,
+        hasToken: Boolean(token),
+    };
+};
+export class TsDeploy {
+    projectDir;
+    profileStore;
+    constructor(optionsArg = {}) {
+        this.projectDir = plugins.path.resolve(optionsArg.projectDir ?? process.cwd());
+        this.profileStore = this.createProfileStore(optionsArg);
+    }
+    get projectLinkPath() {
+        return plugins.path.join(this.projectDir, '.nogit', 'tsdeploy.json');
+    }
+    createProfileStore(optionsArg) {
+        if (optionsArg.profileStorePath) {
+            return new plugins.smartconfig.KeyValueStore({
+                typeArg: 'custom',
+                identityArg: '@git.zone/tsdeploy',
+                customPath: optionsArg.profileStorePath,
+            });
+        }
+        if (optionsArg.ephemeralProfileStore) {
+            return new plugins.smartconfig.KeyValueStore({
+                typeArg: 'ephemeral',
+                identityArg: '@git.zone/tsdeploy',
+            });
+        }
+        plugins.fsSync.mkdirSync(plugins.path.join(plugins.os.homedir(), '.smartconfig', 'kv', '@git.zone'), { recursive: true });
+        return new plugins.smartconfig.KeyValueStore({
+            typeArg: 'userHomeDir',
+            identityArg: '@git.zone/tsdeploy',
+        });
+    }
+    async readUserState() {
+        const state = await this.profileStore.readAll();
+        return {
+            activeProfile: state.activeProfile,
+            profiles: state.profiles ?? {},
+        };
+    }
+    async saveProfile(optionsArg) {
+        const name = normalizeProfileName(optionsArg.name);
+        const target = normalizeTarget(optionsArg.target);
+        const origin = normalizeOrigin(optionsArg.origin);
+        const state = await this.readUserState();
+        const existingProfile = state.profiles?.[name];
+        const now = new Date().toISOString();
+        const profile = {
+            name,
+            target,
+            origin,
+            token: optionsArg.token ?? existingProfile?.token,
+            createdAt: existingProfile?.createdAt ?? now,
+            updatedAt: now,
+        };
+        await this.profileStore.writeAll({
+            activeProfile: name,
+            profiles: {
+                ...(state.profiles ?? {}),
+                [name]: profile,
+            },
+        });
+        return redactProfile(profile);
+    }
+    async getProfile(profileArg) {
+        const state = await this.readUserState();
+        const profileName = profileArg ? normalizeProfileName(profileArg) : state.activeProfile;
+        return profileName ? state.profiles?.[profileName] : undefined;
+    }
+    async readProjectLink() {
+        try {
+            const raw = await plugins.fs.readFile(this.projectLinkPath, 'utf8');
+            const parsed = JSON.parse(raw);
+            return this.normalizeProjectLink(parsed);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return undefined;
+            }
+            throw error;
+        }
+    }
+    async writeProjectLink(optionsArg) {
+        const projectLink = this.normalizeProjectLink({
+            schemaVersion,
+            profile: optionsArg.profile,
+            deploymentId: optionsArg.deploymentId,
+            serviceId: optionsArg.serviceId,
+        });
+        await plugins.fs.mkdir(plugins.path.dirname(this.projectLinkPath), { recursive: true });
+        await plugins.fs.writeFile(this.projectLinkPath, `${JSON.stringify(projectLink, null, 2)}\n`, 'utf8');
+        return projectLink;
+    }
+    normalizeProjectLink(projectLinkArg) {
+        if (projectLinkArg.schemaVersion !== schemaVersion) {
+            throw new Error(`Unsupported tsdeploy project link schemaVersion: ${projectLinkArg.schemaVersion}`);
+        }
+        const projectLink = {
+            schemaVersion,
+            profile: normalizeProfileName(projectLinkArg.profile),
+        };
+        if (projectLinkArg.deploymentId) {
+            projectLink.deploymentId = String(projectLinkArg.deploymentId);
+        }
+        if (projectLinkArg.serviceId) {
+            projectLink.serviceId = String(projectLinkArg.serviceId);
+        }
+        return projectLink;
+    }
+    async getStatus() {
+        const projectLink = await this.readProjectLink();
+        const state = await this.readUserState();
+        const activeProfile = projectLink?.profile ?? state.activeProfile;
+        const profile = activeProfile ? state.profiles?.[activeProfile] : undefined;
+        const warnings = [];
+        if (!projectLink) {
+            warnings.push('No .nogit/tsdeploy.json project link found. Run tsdeploy init or tsdeploy link.');
+        }
+        if (activeProfile && !profile) {
+            warnings.push(`Profile "${activeProfile}" is not configured. Run tsdeploy login --profile ${activeProfile}.`);
+        }
+        if (profile && !profile.token) {
+            warnings.push(`Profile "${profile.name}" has no token. Remote deploy mutations remain unavailable.`);
+        }
+        return {
+            projectDir: this.projectDir,
+            hasProjectLink: Boolean(projectLink),
+            projectLink,
+            activeProfile,
+            profile: profile ? redactProfile(profile) : undefined,
+            warnings,
+        };
+    }
+    async buildPlan() {
+        const status = await this.getStatus();
+        const actions = [];
+        if (status.projectLink && status.profile) {
+            actions.push({
+                type: 'inspect',
+                title: 'Inspect linked deployment',
+                description: 'Resolve the linked Cloudly/Onebox deployment and compare desired app metadata once typed deployment APIs are verified.',
+            });
+        }
+        else {
+            actions.push({
+                type: 'noop',
+                title: 'Complete local setup',
+                description: 'Create a profile and project link before a deployment plan can inspect remote state.',
+            });
+        }
+        actions.push({
+            type: 'noop',
+            title: 'Deployment mutation disabled',
+            description: 'tsdeploy MVP does not install, update, or upgrade apps until Cloudly/Onebox deployment contracts are verified upstream.',
+        });
+        return {
+            schemaVersion,
+            projectDir: this.projectDir,
+            mutationAllowed: false,
+            summary: 'Safe planning only: no remote deployment mutations will be executed.',
+            profile: status.activeProfile,
+            deploymentId: status.projectLink?.deploymentId,
+            serviceId: status.projectLink?.serviceId,
+            actions,
+            warnings: status.warnings,
+        };
+    }
+    async doctor() {
+        const status = await this.getStatus();
+        const checks = [
+            {
+                name: 'project-link',
+                ok: status.hasProjectLink,
+                message: status.hasProjectLink ? 'Project link exists at .nogit/tsdeploy.json.' : 'Project is not linked yet.',
+            },
+            {
+                name: 'profile',
+                ok: Boolean(status.profile),
+                message: status.profile ? `Profile "${status.profile.name}" targets ${status.profile.target}.` : 'No matching profile is configured.',
+            },
+            {
+                name: 'remote-mutations',
+                ok: true,
+                message: 'Remote deployment mutations are intentionally disabled in this MVP.',
+            },
+        ];
+        return {
+            ok: checks.every(check => check.ok),
+            checks,
+            warnings: status.warnings,
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy50c2RlcGxveS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL2NsYXNzZXMudHNkZXBsb3kudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxjQUFjLENBQUM7QUFvQnhDLE1BQU0sYUFBYSxHQUFHLENBQVUsQ0FBQztBQUNqQyxNQUFNLGdCQUFnQixHQUFHLG1CQUFtQixDQUFDO0FBRTdDLE1BQU0sb0JBQW9CLEdBQUcsQ0FBQyxVQUFrQixFQUFVLEVBQUU7SUFDMUQsTUFBTSxPQUFPLEdBQUcsVUFBVSxDQUFDLElBQUksRUFBRSxDQUFDO0lBQ2xDLElBQUksQ0FBQyxPQUFPLElBQUksQ0FBQyxnQkFBZ0IsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztRQUNoRCxNQUFNLElBQUksS0FBSyxDQUFDLGlGQUFpRixDQUFDLENBQUM7SUFDckcsQ0FBQztJQUNELE9BQU8sT0FBTyxDQUFDO0FBQ2pCLENBQUMsQ0FBQztBQUVGLE1BQU0sZUFBZSxHQUFHLENBQUMsU0FBaUIsRUFBbUIsRUFBRTtJQUM3RCxJQUFJLFNBQVMsS0FBSyxTQUFTLElBQUksU0FBUyxLQUFLLFFBQVEsRUFBRSxDQUFDO1FBQ3RELE9BQU8sU0FBUyxDQUFDO0lBQ25CLENBQUM7SUFDRCxNQUFNLElBQUksS0FBSyxDQUFDLDhDQUE4QyxDQUFDLENBQUM7QUFDbEUsQ0FBQyxDQUFDO0FBRUYsTUFBTSxlQUFlLEdBQUcsQ0FBQyxTQUFpQixFQUFVLEVBQUU7SUFDcEQsTUFBTSxHQUFHLEdBQUcsSUFBSSxHQUFHLENBQUMsU0FBUyxDQUFDLENBQUM7SUFDL0IsR0FBRyxDQUFDLFFBQVEsR0FBRyxHQUFHLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxLQUFLLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDL0MsT0FBTyxHQUFHLENBQUMsUUFBUSxFQUFFLENBQUMsT0FBTyxDQUFDLEtBQUssRUFBRSxFQUFFLENB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

package/dist_ts/cli.d.ts

@@ -0,0 +1 @@
+export declare const runCli: () => Promise<void>;

package/dist_ts/cli.js

@@ -0,0 +1,107 @@
+import * as plugins from './plugins.js';
+import { TsDeploy } from './classes.tsdeploy.js';
+const getStringArg = (argvArg, keyArg) => {
+    const value = argvArg[keyArg];
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+};
+const printJson = (valueArg) => {
+    console.log(JSON.stringify(valueArg, null, 2));
+};
+const requireStringArg = (argvArg, keyArg) => {
+    const value = getStringArg(argvArg, keyArg);
+    if (!value) {
+        throw new Error(`Missing required --${keyArg} option.`);
+    }
+    return value;
+};
+const createTsDeploy = () => new TsDeploy({ projectDir: process.cwd() });
+const getSmartcliArgv = () => {
+    if (process.argv.length === 0)
+        return undefined;
+    if (process.argv[0] === process.execPath)
+        return undefined;
+    return [process.execPath, 'tsdeploy', ...process.argv];
+};
+const runLogin = async (argvArg) => {
+    const tsDeploy = createTsDeploy();
+    const profile = await tsDeploy.saveProfile({
+        name: requireStringArg(argvArg, 'profile'),
+        target: requireStringArg(argvArg, 'target'),
+        origin: requireStringArg(argvArg, 'origin'),
+        token: getStringArg(argvArg, 'token') ?? process.env.TSDEPLOY_TOKEN,
+    });
+    printJson({ ok: true, profile });
+};
+const runInit = async (argvArg) => {
+    const tsDeploy = createTsDeploy();
+    const profile = getStringArg(argvArg, 'profile') ?? (await tsDeploy.readUserState()).activeProfile;
+    if (!profile) {
+        throw new Error('No profile specified and no active profile exists. Run tsdeploy login first or pass --profile.');
+    }
+    const projectLink = await tsDeploy.writeProjectLink({
+        profile,
+        deploymentId: getStringArg(argvArg, 'deploymentId'),
+        serviceId: getStringArg(argvArg, 'serviceId'),
+    });
+    printJson({ ok: true, projectLink });
+};
+const runLink = async (argvArg) => {
+    const deploymentId = getStringArg(argvArg, 'deploymentId');
+    const serviceId = getStringArg(argvArg, 'serviceId');
+    if (!deploymentId && !serviceId) {
+        throw new Error('Missing --deploymentId or --serviceId.');
+    }
+    const tsDeploy = createTsDeploy();
+    const profile = getStringArg(argvArg, 'profile') ?? (await tsDeploy.readUserState()).activeProfile;
+    if (!profile) {
+        throw new Error('No profile specified and no active profile exists. Run tsdeploy login first or pass --profile.');
+    }
+    const projectLink = await tsDeploy.writeProjectLink({ profile, deploymentId, serviceId });
+    printJson({ ok: true, projectLink });
+};
+const runStatus = async () => {
+    printJson(await createTsDeploy().getStatus());
+};
+const runPlan = async () => {
+    printJson(await createTsDeploy().buildPlan());
+};
+const runDoctor = async () => {
+    printJson(await createTsDeploy().doctor());
+};
+const printHelp = () => {
+    console.log(`
+Usage: tsdeploy <command> [options]
+
+Commands:
+  login --profile <name> --target <cloudly|onebox> --origin <url> [--token <token>]
+  init [--profile <name>] [--deploymentId <id>] [--serviceId <id>]
+  link [--profile <name>] (--deploymentId <id> | --serviceId <id>)
+  status
+  doctor
+  plan
+
+Notes:
+  tsdeploy stores only the project pointer in .nogit/tsdeploy.json.
+  Remote deployment mutations are disabled until Cloudly/Onebox APIs are verified.
+`);
+};
+export const runCli = async () => {
+    const cli = new plugins.smartcli.Smartcli();
+    cli.standardCommand().subscribe(async (argvArg) => {
+        const positionalCommand = Array.isArray(argvArg._) ? argvArg._[0] : undefined;
+        if (argvArg.help || argvArg.h || positionalCommand === 'help') {
+            printHelp();
+            return;
+        }
+        await runStatus();
+    });
+    cli.addCommand('login').subscribe(runLogin);
+    cli.addCommand('init').subscribe(runInit);
+    cli.addCommand('link').subscribe(runLink);
+    cli.addCommand('status').subscribe(runStatus);
+    cli.addCommand('doctor').subscribe(runDoctor);
+    cli.addCommand('plan').subscribe(runPlan);
+    cli.addCommand('help').subscribe(async () => printHelp());
+    cli.startParse(getSmartcliArgv());
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvY2xpLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUVqRCxNQUFNLFlBQVksR0FBRyxDQUFDLE9BQVksRUFBRSxNQUFjLEVBQXNCLEVBQUU7SUFDeEUsTUFBTSxLQUFLLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQzlCLE9BQU8sT0FBTyxLQUFLLEtBQUssUUFBUSxJQUFJLEtBQUssQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLElBQUksRUFBRSxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUM7QUFDOUUsQ0FBQyxDQUFDO0FBRUYsTUFBTSxTQUFTLEdBQUcsQ0FBQyxRQUFpQixFQUFRLEVBQUU7SUFDNUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLFFBQVEsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztBQUNqRCxDQUFDLENBQUM7QUFFRixNQUFNLGdCQUFnQixHQUFHLENBQUMsT0FBWSxFQUFFLE1BQWMsRUFBVSxFQUFFO0lBQ2hFLE1BQU0sS0FBSyxHQUFHLFlBQVksQ0FBQyxPQUFPLEVBQUUsTUFBTSxDQUFDLENBQUM7SUFDNUMsSUFBSSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ1gsTUFBTSxJQUFJLEtBQUssQ0FBQyxzQkFBc0IsTUFBTSxVQUFVLENBQUMsQ0FBQztJQUMxRCxDQUFDO0lBQ0QsT0FBTyxLQUFLLENBQUM7QUFDZixDQUFDLENBQUM7QUFFRixNQUFNLGNBQWMsR0FBRyxHQUFhLEVBQUUsQ0FBQyxJQUFJLFFBQVEsQ0FBQyxFQUFFLFVBQVUsRUFBRSxPQUFPLENBQUMsR0FBRyxFQUFFLEVBQUUsQ0FBQyxDQUFDO0FBRW5GLE1BQU0sZUFBZSxH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VCxDQUFDO1FBQ0QsTUFBTSxTQUFTLEVBQUUsQ0FBQztJQUNwQixDQUFDLENBQUMsQ0FBQztJQUNILEdBQUcsQ0FBQyxVQUFVLENBQUMsT0FBTyxDQUFDLENBQUMsU0FBUyxDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBQzVDLEdBQUcsQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLENBQUMsU0FBUyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQzFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLENBQUMsU0FBUyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQzFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsUUFBUSxDQUFDLENBQUMsU0FBUyxDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQzlDLEdBQUcsQ0FBQyxVQUFVLENBQUMsUUFBUSxDQUFDLENBQUMsU0FBUyxDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQzlDLEdBQUcsQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLENBQUMsU0FBUyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQzFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLENBQUMsU0FBUyxDQUFDLEtBQUssSUFBSSxFQUFFLENBQUMsU0FBUyxFQUFFLENBQUMsQ0FBQztJQUMxRCxHQUFHLENBQUMsVUFBVSxDQUFDLGVBQWUsRUFBRSxDQUFDLENBQUM7QUFDcEMsQ0FBQyxDQUFDIn0=

package/dist_ts/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './classes.tsdeploy.js';
+export * from './cli.js';

package/dist_ts/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './classes.tsdeploy.js';
+export * from './cli.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLFlBQVksQ0FBQztBQUMzQixjQUFjLHVCQUF1QixDQUFDO0FBQ3RDLGNBQWMsVUFBVSxDQUFDIn0=

package/dist_ts/plugins.d.ts

@@ -0,0 +1,8 @@
+import * as fs from 'node:fs/promises';
+import * as fsSync from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+export { fs, fsSync, os, path };
+import * as smartcli from '@push.rocks/smartcli';
+import * as smartconfig from '@push.rocks/smartconfig';
+export { smartcli, smartconfig };

package/dist_ts/plugins.js

@@ -0,0 +1,11 @@
+// node native scope
+import * as fs from 'node:fs/promises';
+import * as fsSync from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+export { fs, fsSync, os, path };
+// @push.rocks scope
+import * as smartcli from '@push.rocks/smartcli';
+import * as smartconfig from '@push.rocks/smartconfig';
+export { smartcli, smartconfig };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsb0JBQW9CO0FBQ3BCLE9BQU8sS0FBSyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDdkMsT0FBTyxLQUFLLE1BQU0sTUFBTSxTQUFTLENBQUM7QUFDbEMsT0FBTyxLQUFLLEVBQUUsTUFBTSxTQUFTLENBQUM7QUFDOUIsT0FBTyxLQUFLLElBQUksTUFBTSxXQUFXLENBQUM7QUFFbEMsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLEVBQUUsRUFBRSxFQUFFLElBQUksRUFBRSxDQUFDO0FBRWhDLG9CQUFvQjtBQUNwQixPQUFPLEtBQUssUUFBUSxNQUFNLHNCQUFzQixDQUFDO0FBQ2pELE9BQU8sS0FBSyxXQUFXLE1BQU0seUJBQXlCLENBQUM7QUFFdkQsT0FBTyxFQUFFLFFBQVEsRUFBRSxXQUFXLEVBQUUsQ0FBQyJ9

package/dist_ts/types.d.ts

@@ -0,0 +1,67 @@
+export type TTsDeployTarget = 'cloudly' | 'onebox';
+export interface ITsDeployProfile {
+    name: string;
+    target: TTsDeployTarget;
+    origin: string;
+    token?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ITsDeployPublicProfile extends Omit<ITsDeployProfile, 'token'> {
+    hasToken: boolean;
+}
+export interface ITsDeployUserState {
+    activeProfile?: string;
+    profiles?: Record<string, ITsDeployProfile>;
+}
+export interface ITsDeployProjectLink {
+    schemaVersion: 1;
+    profile: string;
+    deploymentId?: string;
+    serviceId?: string;
+}
+export interface ITsDeploySaveProfileOptions {
+    name: string;
+    target: TTsDeployTarget;
+    origin: string;
+    token?: string;
+}
+export interface ITsDeployLinkOptions {
+    profile: string;
+    deploymentId?: string;
+    serviceId?: string;
+}
+export interface ITsDeployStatus {
+    projectDir: string;
+    hasProjectLink: boolean;
+    projectLink?: ITsDeployProjectLink;
+    activeProfile?: string;
+    profile?: ITsDeployPublicProfile;
+    warnings: string[];
+}
+export interface ITsDeployPlanAction {
+    type: 'inspect' | 'noop';
+    title: string;
+    description: string;
+}
+export interface ITsDeployPlan {
+    schemaVersion: 1;
+    projectDir: string;
+    mutationAllowed: false;
+    summary: string;
+    profile?: string;
+    deploymentId?: string;
+    serviceId?: string;
+    actions: ITsDeployPlanAction[];
+    warnings: string[];
+}
+export interface ITsDeployDoctorCheck {
+    name: string;
+    ok: boolean;
+    message: string;
+}
+export interface ITsDeployDoctorResult {
+    ok: boolean;
+    checks: ITsDeployDoctorCheck[];
+    warnings: string[];
+}

package/dist_ts/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy90eXBlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/license.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Task Venture Capital GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@git.zone/tsdeploy",
+  "version": "0.2.0",
+  "private": false,
+  "description": "Cloudly and Onebox first deployment orchestration CLI for git.zone TypeScript tooling.",
+  "main": "dist_ts/index.js",
+  "typings": "dist_ts/index.d.ts",
+  "type": "module",
+  "bin": {
+    "tsdeploy": "./cli.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://code.foss.global/git.zone/tsdeploy.git"
+  },
+  "keywords": [
+    "deployment",
+    "Cloudly",
+    "Onebox",
+    "serve.zone",
+    "TypeScript",
+    "CLI",
+    "git.zone"
+  ],
+  "author": "Task Venture Capital GmbH",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://code.foss.global/git.zone/tsdeploy/issues"
+  },
+  "homepage": "https://code.foss.global/git.zone/tsdeploy#readme",
+  "dependencies": {
+    "@push.rocks/smartcli": "^4.3.0",
+    "@push.rocks/smartconfig": "^6.1.1"
+  },
+  "devDependencies": {
+    "@git.zone/tsbuild": "^4.4.2",
+    "@git.zone/tsrun": "^2.0.4",
+    "@git.zone/tstest": "^3.6.6",
+    "@types/node": "^25.9.3",
+    "typescript": "^6.0.3"
+  },
+  "files": [
+    "ts/**/*",
+    "dist/**/*",
+    "dist_*/**/*",
+    "dist_ts/**/*",
+    "assets/**/*",
+    "cli.js",
+    ".smartconfig.json",
+    "readme.md",
+    "license.md"
+  ],
+  "browserslist": [
+    "last 1 chrome versions"
+  ],
+  "scripts": {
+    "test": "tstest test/ --verbose --logfile --timeout 120",
+    "build": "tsbuild tsfolders",
+    "buildDocs": "tsdoc"
+  }
+}

package/readme.md

@@ -0,0 +1,100 @@
+# @git.zone/tsdeploy
+
+Cloudly and Onebox first deployment orchestration CLI for git.zone TypeScript tooling.
+
+## Issue Reporting and Security
+
+For reporting bugs, issues, or security vulnerabilities, please visit [community.foss.global/](https://community.foss.global/). This is the central community hub for all issue reporting. Developers who sign and comply with our contribution agreement and go through identification can also get a [code.foss.global/](https://code.foss.global/) account to submit Pull Requests directly.
+
+## Install
+
+```bash
+pnpm add -g @git.zone/tsdeploy
+```
+
+## Usage
+
+`tsdeploy` stores deployment intent locally and produces safe, non-mutating plans. Cloudly or Onebox remains the source of truth for actual deployment instances.
+
+Create or update a local profile in the user config store:
+
+```bash
+tsdeploy login --profile prod --target cloudly --origin https://cloudly.example.com
+```
+
+Link a project to a Cloudly or Onebox deployment pointer. Use either `init` for the first pointer write or `link` to replace the current pointer:
+
+```bash
+tsdeploy init --profile prod --deploymentId deployment-123
+# or
+tsdeploy link --profile prod --serviceId service-123
+```
+
+Inspect current local state:
+
+```bash
+tsdeploy status
+tsdeploy doctor
+tsdeploy plan
+```
+
+The project pointer is written to `.nogit/tsdeploy.json` and is intentionally small:
+
+```json
+{
+  "schemaVersion": 1,
+  "profile": "prod",
+  "deploymentId": "deployment-123"
+}
+```
+
+Profiles are stored in the user smartconfig key-value store. Tokens are never printed by `status`, `doctor`, or `plan`.
+
+## Current Scope
+
+This MVP does not install, update, upgrade, or mutate remote deployments. It prepares the local UX and state model for Cloudly/Onebox-backed deployment flows while avoiding duplicate release, Docker, App Store, or remote-authority semantics.
+
+Remote deployment mutations should only be added after the exact Cloudly and Onebox typed APIs for install, update, upgrade, and status are verified upstream.
+
+## Programmatic API
+
+```typescript
+import { TsDeploy } from '@git.zone/tsdeploy';
+
+const tsDeploy = new TsDeploy({ projectDir: process.cwd() });
+
+await tsDeploy.saveProfile({
+  name: 'prod',
+  target: 'cloudly',
+  origin: 'https://cloudly.example.com',
+});
+
+await tsDeploy.writeProjectLink({
+  profile: 'prod',
+  deploymentId: 'deployment-123',
+});
+
+const plan = await tsDeploy.buildPlan();
+console.log(plan.mutationAllowed); // false
+```
+
+## License and Legal Information
+
+This repository contains open-source code licensed under the MIT License. A copy of the license can be found in the [license.md](./license.md) file.
+
+**Please note:** The MIT License does not grant permission to use the trade names, trademarks, service marks, or product names of the project, except as required for reasonable and customary use in describing the origin of the work and reproducing the content of the NOTICE file.
+
+### Trademarks
+
+This project is owned and maintained by Task Venture Capital GmbH. The names and logos associated with Task Venture Capital GmbH and any related products or services are trademarks of Task Venture Capital GmbH or third parties, and are not included within the scope of the MIT license granted herein.
+
+Use of these trademarks must comply with Task Venture Capital GmbH's Trademark Guidelines or the guidelines of the respective third-party owners, and any usage must be approved in writing. Third-party trademarks used herein are the property of their respective owners and used only in a descriptive manner, e.g. for an implementation of an API or similar.
+
+### Company Information
+
+Task Venture Capital GmbH<br>
+Registered at District Court Bremen HRB 35230 HB, Germany
+
+For any legal inquiries or further information, please contact us via email at hello@task.vc.
+
+By using this repository, you acknowledge that you have read this section, agree to comply with its terms, and understand that the licensing of the code does not imply endorsement by Task Venture Capital GmbH of any derivative works.

package/ts/00_commitinfo_data.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+  name: '@git.zone/tsdeploy',
+  version: '0.2.0',
+  description: 'Cloudly and Onebox first deployment orchestration CLI for git.zone TypeScript tooling.'
+}

package/ts/classes.tsdeploy.ts

@@ -0,0 +1,252 @@
+import * as plugins from './plugins.js';
+import type {
+  ITsDeployDoctorResult,
+  ITsDeployLinkOptions,
+  ITsDeployPlan,
+  ITsDeployProfile,
+  ITsDeployProjectLink,
+  ITsDeployPublicProfile,
+  ITsDeploySaveProfileOptions,
+  ITsDeployStatus,
+  ITsDeployUserState,
+  TTsDeployTarget,
+} from './types.js';
+
+export interface ITsDeployOptions {
+  projectDir?: string;
+  profileStorePath?: string;
+  ephemeralProfileStore?: boolean;
+}
+
+const schemaVersion = 1 as const;
+const profileNameRegex = /^[a-zA-Z0-9._-]+$/;
+
+const normalizeProfileName = (profileArg: string): string => {
+  const profile = profileArg.trim();
+  if (!profile || !profileNameRegex.test(profile)) {
+    throw new Error('Profile names may only contain letters, numbers, dots, dashes, and underscores.');
+  }
+  return profile;
+};
+
+const normalizeTarget = (targetArg: string): TTsDeployTarget => {
+  if (targetArg === 'cloudly' || targetArg === 'onebox') {
+    return targetArg;
+  }
+  throw new Error('Target must be either "cloudly" or "onebox".');
+};
+
+const normalizeOrigin = (originArg: string): string => {
+  const url = new URL(originArg);
+  url.pathname = url.pathname.replace(/\/$/, '');
+  return url.toString().replace(/\/$/, '');
+};
+
+export const redactProfile = (profileArg: ITsDeployProfile): ITsDeployPublicProfile => {
+  const { token, ...publicProfile } = profileArg;
+  return {
+    ...publicProfile,
+    hasToken: Boolean(token),
+  };
+};
+
+export class TsDeploy {
+  public readonly projectDir: string;
+  private readonly profileStore: plugins.smartconfig.KeyValueStore<ITsDeployUserState>;
+
+  constructor(optionsArg: ITsDeployOptions = {}) {
+    this.projectDir = plugins.path.resolve(optionsArg.projectDir ?? process.cwd());
+    this.profileStore = this.createProfileStore(optionsArg);
+  }
+
+  public get projectLinkPath(): string {
+    return plugins.path.join(this.projectDir, '.nogit', 'tsdeploy.json');
+  }
+
+  private createProfileStore(optionsArg: ITsDeployOptions): plugins.smartconfig.KeyValueStore<ITsDeployUserState> {
+    if (optionsArg.profileStorePath) {
+      return new plugins.smartconfig.KeyValueStore<ITsDeployUserState>({
+        typeArg: 'custom',
+        identityArg: '@git.zone/tsdeploy',
+        customPath: optionsArg.profileStorePath,
+      });
+    }
+    if (optionsArg.ephemeralProfileStore) {
+      return new plugins.smartconfig.KeyValueStore<ITsDeployUserState>({
+        typeArg: 'ephemeral',
+        identityArg: '@git.zone/tsdeploy',
+      });
+    }
+    plugins.fsSync.mkdirSync(plugins.path.join(plugins.os.homedir(), '.smartconfig', 'kv', '@git.zone'), { recursive: true });
+    return new plugins.smartconfig.KeyValueStore<ITsDeployUserState>({
+      typeArg: 'userHomeDir',
+      identityArg: '@git.zone/tsdeploy',
+    });
+  }
+
+  public async readUserState(): Promise<ITsDeployUserState> {
+    const state = await this.profileStore.readAll();
+    return {
+      activeProfile: state.activeProfile,
+      profiles: state.profiles ?? {},
+    };
+  }
+
+  public async saveProfile(optionsArg: ITsDeploySaveProfileOptions): Promise<ITsDeployPublicProfile> {
+    const name = normalizeProfileName(optionsArg.name);
+    const target = normalizeTarget(optionsArg.target);
+    const origin = normalizeOrigin(optionsArg.origin);
+    const state = await this.readUserState();
+    const existingProfile = state.profiles?.[name];
+    const now = new Date().toISOString();
+    const profile: ITsDeployProfile = {
+      name,
+      target,
+      origin,
+      token: optionsArg.token ?? existingProfile?.token,
+      createdAt: existingProfile?.createdAt ?? now,
+      updatedAt: now,
+    };
+    await this.profileStore.writeAll({
+      activeProfile: name,
+      profiles: {
+        ...(state.profiles ?? {}),
+        [name]: profile,
+      },
+    });
+    return redactProfile(profile);
+  }
+
+  public async getProfile(profileArg?: string): Promise<ITsDeployProfile | undefined> {
+    const state = await this.readUserState();
+    const profileName = profileArg ? normalizeProfileName(profileArg) : state.activeProfile;
+    return profileName ? state.profiles?.[profileName] : undefined;
+  }
+
+  public async readProjectLink(): Promise<ITsDeployProjectLink | undefined> {
+    try {
+      const raw = await plugins.fs.readFile(this.projectLinkPath, 'utf8');
+      const parsed = JSON.parse(raw) as ITsDeployProjectLink;
+      return this.normalizeProjectLink(parsed);
+    } catch (error) {
+      if ((error as { code?: string }).code === 'ENOENT') {
+        return undefined;
+      }
+      throw error;
+    }
+  }
+
+  public async writeProjectLink(optionsArg: ITsDeployLinkOptions): Promise<ITsDeployProjectLink> {
+    const projectLink = this.normalizeProjectLink({
+      schemaVersion,
+      profile: optionsArg.profile,
+      deploymentId: optionsArg.deploymentId,
+      serviceId: optionsArg.serviceId,
+    });
+    await plugins.fs.mkdir(plugins.path.dirname(this.projectLinkPath), { recursive: true });
+    await plugins.fs.writeFile(this.projectLinkPath, `${JSON.stringify(projectLink, null, 2)}\n`, 'utf8');
+    return projectLink;
+  }
+
+  private normalizeProjectLink(projectLinkArg: ITsDeployProjectLink): ITsDeployProjectLink {
+    if (projectLinkArg.schemaVersion !== schemaVersion) {
+      throw new Error(`Unsupported tsdeploy project link schemaVersion: ${projectLinkArg.schemaVersion}`);
+    }
+    const projectLink: ITsDeployProjectLink = {
+      schemaVersion,
+      profile: normalizeProfileName(projectLinkArg.profile),
+    };
+    if (projectLinkArg.deploymentId) {
+      projectLink.deploymentId = String(projectLinkArg.deploymentId);
+    }
+    if (projectLinkArg.serviceId) {
+      projectLink.serviceId = String(projectLinkArg.serviceId);
+    }
+    return projectLink;
+  }
+
+  public async getStatus(): Promise<ITsDeployStatus> {
+    const projectLink = await this.readProjectLink();
+    const state = await this.readUserState();
+    const activeProfile = projectLink?.profile ?? state.activeProfile;
+    const profile = activeProfile ? state.profiles?.[activeProfile] : undefined;
+    const warnings: string[] = [];
+    if (!projectLink) {
+      warnings.push('No .nogit/tsdeploy.json project link found. Run tsdeploy init or tsdeploy link.');
+    }
+    if (activeProfile && !profile) {
+      warnings.push(`Profile "${activeProfile}" is not configured. Run tsdeploy login --profile ${activeProfile}.`);
+    }
+    if (profile && !profile.token) {
+      warnings.push(`Profile "${profile.name}" has no token. Remote deploy mutations remain unavailable.`);
+    }
+    return {
+      projectDir: this.projectDir,
+      hasProjectLink: Boolean(projectLink),
+      projectLink,
+      activeProfile,
+      profile: profile ? redactProfile(profile) : undefined,
+      warnings,
+    };
+  }
+
+  public async buildPlan(): Promise<ITsDeployPlan> {
+    const status = await this.getStatus();
+    const actions: ITsDeployPlan['actions'] = [];
+    if (status.projectLink && status.profile) {
+      actions.push({
+        type: 'inspect',
+        title: 'Inspect linked deployment',
+        description: 'Resolve the linked Cloudly/Onebox deployment and compare desired app metadata once typed deployment APIs are verified.',
+      });
+    } else {
+      actions.push({
+        type: 'noop',
+        title: 'Complete local setup',
+        description: 'Create a profile and project link before a deployment plan can inspect remote state.',
+      });
+    }
+    actions.push({
+      type: 'noop',
+      title: 'Deployment mutation disabled',
+      description: 'tsdeploy MVP does not install, update, or upgrade apps until Cloudly/Onebox deployment contracts are verified upstream.',
+    });
+    return {
+      schemaVersion,
+      projectDir: this.projectDir,
+      mutationAllowed: false,
+      summary: 'Safe planning only: no remote deployment mutations will be executed.',
+      profile: status.activeProfile,
+      deploymentId: status.projectLink?.deploymentId,
+      serviceId: status.projectLink?.serviceId,
+      actions,
+      warnings: status.warnings,
+    };
+  }
+
+  public async doctor(): Promise<ITsDeployDoctorResult> {
+    const status = await this.getStatus();
+    const checks = [
+      {
+        name: 'project-link',
+        ok: status.hasProjectLink,
+        message: status.hasProjectLink ? 'Project link exists at .nogit/tsdeploy.json.' : 'Project is not linked yet.',
+      },
+      {
+        name: 'profile',
+        ok: Boolean(status.profile),
+        message: status.profile ? `Profile "${status.profile.name}" targets ${status.profile.target}.` : 'No matching profile is configured.',
+      },
+      {
+        name: 'remote-mutations',
+        ok: true,
+        message: 'Remote deployment mutations are intentionally disabled in this MVP.',
+      },
+    ];
+    return {
+      ok: checks.every(check => check.ok),
+      checks,
+      warnings: status.warnings,
+    };
+  }
+}

package/ts/cli.ts

@@ -0,0 +1,117 @@
+import * as plugins from './plugins.js';
+import { TsDeploy } from './classes.tsdeploy.js';
+
+const getStringArg = (argvArg: any, keyArg: string): string | undefined => {
+  const value = argvArg[keyArg];
+  return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+};
+
+const printJson = (valueArg: unknown): void => {
+  console.log(JSON.stringify(valueArg, null, 2));
+};
+
+const requireStringArg = (argvArg: any, keyArg: string): string => {
+  const value = getStringArg(argvArg, keyArg);
+  if (!value) {
+    throw new Error(`Missing required --${keyArg} option.`);
+  }
+  return value;
+};
+
+const createTsDeploy = (): TsDeploy => new TsDeploy({ projectDir: process.cwd() });
+
+const getSmartcliArgv = (): string[] | undefined => {
+  if (process.argv.length === 0) return undefined;
+  if (process.argv[0] === process.execPath) return undefined;
+  return [process.execPath, 'tsdeploy', ...process.argv];
+};
+
+const runLogin = async (argvArg: any): Promise<void> => {
+  const tsDeploy = createTsDeploy();
+  const profile = await tsDeploy.saveProfile({
+    name: requireStringArg(argvArg, 'profile'),
+    target: requireStringArg(argvArg, 'target') as any,
+    origin: requireStringArg(argvArg, 'origin'),
+    token: getStringArg(argvArg, 'token') ?? process.env.TSDEPLOY_TOKEN,
+  });
+  printJson({ ok: true, profile });
+};
+
+const runInit = async (argvArg: any): Promise<void> => {
+  const tsDeploy = createTsDeploy();
+  const profile = getStringArg(argvArg, 'profile') ?? (await tsDeploy.readUserState()).activeProfile;
+  if (!profile) {
+    throw new Error('No profile specified and no active profile exists. Run tsdeploy login first or pass --profile.');
+  }
+  const projectLink = await tsDeploy.writeProjectLink({
+    profile,
+    deploymentId: getStringArg(argvArg, 'deploymentId'),
+    serviceId: getStringArg(argvArg, 'serviceId'),
+  });
+  printJson({ ok: true, projectLink });
+};
+
+const runLink = async (argvArg: any): Promise<void> => {
+  const deploymentId = getStringArg(argvArg, 'deploymentId');
+  const serviceId = getStringArg(argvArg, 'serviceId');
+  if (!deploymentId && !serviceId) {
+    throw new Error('Missing --deploymentId or --serviceId.');
+  }
+  const tsDeploy = createTsDeploy();
+  const profile = getStringArg(argvArg, 'profile') ?? (await tsDeploy.readUserState()).activeProfile;
+  if (!profile) {
+    throw new Error('No profile specified and no active profile exists. Run tsdeploy login first or pass --profile.');
+  }
+  const projectLink = await tsDeploy.writeProjectLink({ profile, deploymentId, serviceId });
+  printJson({ ok: true, projectLink });
+};
+
+const runStatus = async (): Promise<void> => {
+  printJson(await createTsDeploy().getStatus());
+};
+
+const runPlan = async (): Promise<void> => {
+  printJson(await createTsDeploy().buildPlan());
+};
+
+const runDoctor = async (): Promise<void> => {
+  printJson(await createTsDeploy().doctor());
+};
+
+const printHelp = (): void => {
+  console.log(`
+Usage: tsdeploy <command> [options]
+
+Commands:
+  login --profile <name> --target <cloudly|onebox> --origin <url> [--token <token>]
+  init [--profile <name>] [--deploymentId <id>] [--serviceId <id>]
+  link [--profile <name>] (--deploymentId <id> | --serviceId <id>)
+  status
+  doctor
+  plan
+
+Notes:
+  tsdeploy stores only the project pointer in .nogit/tsdeploy.json.
+  Remote deployment mutations are disabled until Cloudly/Onebox APIs are verified.
+`);
+};
+
+export const runCli = async (): Promise<void> => {
+  const cli = new plugins.smartcli.Smartcli();
+  cli.standardCommand().subscribe(async (argvArg) => {
+    const positionalCommand = Array.isArray(argvArg._) ? argvArg._[0] : undefined;
+    if (argvArg.help || argvArg.h || positionalCommand === 'help') {
+      printHelp();
+      return;
+    }
+    await runStatus();
+  });
+  cli.addCommand('login').subscribe(runLogin);
+  cli.addCommand('init').subscribe(runInit);
+  cli.addCommand('link').subscribe(runLink);
+  cli.addCommand('status').subscribe(runStatus);
+  cli.addCommand('doctor').subscribe(runDoctor);
+  cli.addCommand('plan').subscribe(runPlan);
+  cli.addCommand('help').subscribe(async () => printHelp());
+  cli.startParse(getSmartcliArgv());
+};

package/ts/index.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './classes.tsdeploy.js';
+export * from './cli.js';

package/ts/plugins.ts

@@ -0,0 +1,13 @@
+// node native scope
+import * as fs from 'node:fs/promises';
+import * as fsSync from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+
+export { fs, fsSync, os, path };
+
+// @push.rocks scope
+import * as smartcli from '@push.rocks/smartcli';
+import * as smartconfig from '@push.rocks/smartconfig';
+
+export { smartcli, smartconfig };

package/ts/types.ts

@@ -0,0 +1,78 @@
+export type TTsDeployTarget = 'cloudly' | 'onebox';
+
+export interface ITsDeployProfile {
+  name: string;
+  target: TTsDeployTarget;
+  origin: string;
+  token?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+export interface ITsDeployPublicProfile extends Omit<ITsDeployProfile, 'token'> {
+  hasToken: boolean;
+}
+
+export interface ITsDeployUserState {
+  activeProfile?: string;
+  profiles?: Record<string, ITsDeployProfile>;
+}
+
+export interface ITsDeployProjectLink {
+  schemaVersion: 1;
+  profile: string;
+  deploymentId?: string;
+  serviceId?: string;
+}
+
+export interface ITsDeploySaveProfileOptions {
+  name: string;
+  target: TTsDeployTarget;
+  origin: string;
+  token?: string;
+}
+
+export interface ITsDeployLinkOptions {
+  profile: string;
+  deploymentId?: string;
+  serviceId?: string;
+}
+
+export interface ITsDeployStatus {
+  projectDir: string;
+  hasProjectLink: boolean;
+  projectLink?: ITsDeployProjectLink;
+  activeProfile?: string;
+  profile?: ITsDeployPublicProfile;
+  warnings: string[];
+}
+
+export interface ITsDeployPlanAction {
+  type: 'inspect' | 'noop';
+  title: string;
+  description: string;
+}
+
+export interface ITsDeployPlan {
+  schemaVersion: 1;
+  projectDir: string;
+  mutationAllowed: false;
+  summary: string;
+  profile?: string;
+  deploymentId?: string;
+  serviceId?: string;
+  actions: ITsDeployPlanAction[];
+  warnings: string[];
+}
+
+export interface ITsDeployDoctorCheck {
+  name: string;
+  ok: boolean;
+  message: string;
+}
+
+export interface ITsDeployDoctorResult {
+  ok: boolean;
+  checks: ITsDeployDoctorCheck[];
+  warnings: string[];
+}