@pushto/cli 0.2.1 → 0.4.6

package/dist/lib/__tests__/detect-static-framework.test.js

@@ -0,0 +1,146 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { detectStaticFramework } from '../detect-static-framework.js';
+let dir;
+beforeEach(() => { dir = fs.mkdtempSync(path.join(os.tmpdir(), 'pushto-detect-')); });
+afterEach(() => { fs.rmSync(dir, { recursive: true, force: true }); });
+const writePkg = (pkg) => {
+    fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify(pkg));
+};
+describe('detectStaticFramework', () => {
+    it('detects a stock vite scaffold (no start script) as vite, spa', () => {
+        writePkg({ devDependencies: { vite: '^5.0.0' }, scripts: { dev: 'vite', build: 'tsc -b && vite build', preview: 'vite preview' } });
+        const d = detectStaticFramework(dir);
+        expect(d).toEqual({ framework: 'vite', spa: true, outputDirs: ['dist'] });
+    });
+    it('detects vite via config file when the dep is indirect', () => {
+        writePkg({ scripts: { build: 'vite build' } });
+        fs.writeFileSync(path.join(dir, 'vite.config.ts'), 'export default {}');
+        expect(detectStaticFramework(dir)?.framework).toBe('vite');
+    });
+    it('start script wins: vite + start stays dynamic (null)', () => {
+        writePkg({ dependencies: { vite: '^5.0.0', express: '^4.0.0' }, scripts: { build: 'vite build', start: 'node server.js' } });
+        expect(detectStaticFramework(dir)).toBeNull();
+    });
+    it('SSR frameworks are never static-build: next/nuxt/sveltekit/remix/solidstart', () => {
+        for (const deps of [
+            { next: '1' }, { nuxt: '1' }, { '@sveltejs/kit': '1' },
+            { '@remix-run/node': '1' }, { '@remix-run/dev': '1' }, { '@solidjs/start': '1' },
+        ]) {
+            writePkg({ dependencies: { ...deps, vite: '^5.0.0' }, scripts: { build: 'x' } });
+            expect(detectStaticFramework(dir)).toBeNull();
+        }
+    });
+    it('specific frameworks beat the vite catch-all', () => {
+        writePkg({ dependencies: { astro: '^4.0.0' }, scripts: { build: 'astro build' } });
+        expect(detectStaticFramework(dir)).toEqual({ framework: 'astro', spa: false, outputDirs: ['dist'] });
+    });
+    it('detects gatsby (public/), cra (build/), eleventy (_site/)', () => {
+        writePkg({ dependencies: { gatsby: '^5.0.0' }, scripts: { build: 'gatsby build' } });
+        expect(detectStaticFramework(dir)).toEqual({ framework: 'gatsby', spa: false, outputDirs: ['public'] });
+        writePkg({ dependencies: { 'react-scripts': '^5.0.0' }, scripts: { build: 'react-scripts build' } });
+        expect(detectStaticFramework(dir)).toEqual({ framework: 'cra', spa: true, outputDirs: ['build'] });
+        writePkg({ devDependencies: { '@11ty/eleventy': '^2.0.0' }, scripts: { build: 'eleventy' } });
+        expect(detectStaticFramework(dir)).toEqual({ framework: 'eleventy', spa: false, outputDirs: ['_site'] });
+    });
+    it('angular: expands output candidates from angular.json outputPath', () => {
+        writePkg({ dependencies: { '@angular/core': '^17.0.0' }, scripts: { build: 'ng build' } });
+        fs.writeFileSync(path.join(dir, 'angular.json'), JSON.stringify({
+            projects: { 'my-app': { architect: { build: { options: { outputPath: 'dist/my-app' } } } } },
+        }));
+        expect(detectStaticFramework(dir)).toEqual({
+            framework: 'angular', spa: true,
+            outputDirs: ['dist/my-app/browser', 'dist/my-app'],
+        });
+    });
+    it('angular: falls back to dist/<projectName>/browser when outputPath absent', () => {
+        writePkg({ dependencies: { '@angular/core': '^17.0.0' }, scripts: { build: 'ng build' } });
+        fs.writeFileSync(path.join(dir, 'angular.json'), JSON.stringify({
+            projects: { 'my-app': { architect: { build: { options: {} } } } },
+        }));
+        expect(detectStaticFramework(dir)?.outputDirs).toEqual(['dist/my-app/browser', 'dist/my-app']);
+    });
+    it('no package.json → null; malformed package.json → null', () => {
+        expect(detectStaticFramework(dir)).toBeNull();
+        fs.writeFileSync(path.join(dir, 'package.json'), '{nope');
+        expect(detectStaticFramework(dir)).toBeNull();
+    });
+});
+describe('detectStaticFramework — stock dev-server start scripts do not defeat detection', () => {
+    // Stock scaffolds ship a `start` script that runs the framework's OWN
+    // dev server, not an app server: CRA `react-scripts start`, Angular
+    // `ng serve`, Gatsby `gatsby develop`, Eleventy `eleventy --serve`. The
+    // old rule ("any start script means dynamic") routed every one of these
+    // past the static-build path even though none of them run a real server.
+    it('real CRA script block (react-scripts start/build/test/eject) is still detected as cra', () => {
+        writePkg({
+            dependencies: { 'react-scripts': '^5.0.0' },
+            scripts: {
+                start: 'react-scripts start',
+                build: 'react-scripts build',
+                test: 'react-scripts test',
+                eject: 'react-scripts eject',
+            },
+        });
+        expect(detectStaticFramework(dir)).toEqual({ framework: 'cra', spa: true, outputDirs: ['build'] });
+    });
+    it('real Angular script block (ng serve) is still detected as angular', () => {
+        writePkg({
+            dependencies: { '@angular/core': '^17.0.0' },
+            scripts: { ng: 'ng', start: 'ng serve', build: 'ng build' },
+        });
+        expect(detectStaticFramework(dir)?.framework).toBe('angular');
+    });
+    it('real Gatsby script block (gatsby develop) is still detected as gatsby', () => {
+        writePkg({
+            dependencies: { gatsby: '^5.0.0' },
+            scripts: { develop: 'gatsby develop', start: 'gatsby develop', build: 'gatsby build' },
+        });
+        expect(detectStaticFramework(dir)).toEqual({ framework: 'gatsby', spa: false, outputDirs: ['public'] });
+    });
+    it('real Eleventy script block (eleventy --serve) is still detected as eleventy', () => {
+        writePkg({
+            devDependencies: { '@11ty/eleventy': '^2.0.0' },
+            scripts: { build: 'eleventy', start: 'eleventy --serve' },
+        });
+        expect(detectStaticFramework(dir)).toEqual({ framework: 'eleventy', spa: false, outputDirs: ['_site'] });
+    });
+    it('eleventy-base-blog real scaffold: npx-prefixed start script stays static-build', () => {
+        writePkg({
+            devDependencies: { '@11ty/eleventy': '^3.0.0' },
+            scripts: { build: 'npx @11ty/eleventy', start: 'npx @11ty/eleventy --serve --quiet' },
+        });
+        expect(detectStaticFramework(dir)?.framework).toBe('eleventy');
+    });
+    it('cra with a CUSTOM start script stays dynamic (null)', () => {
+        writePkg({
+            dependencies: { 'react-scripts': '^5.0.0' },
+            scripts: { start: 'node server.js', build: 'react-scripts build' },
+        });
+        expect(detectStaticFramework(dir)).toBeNull();
+    });
+    it('vite + start script that is just "vite preview" is still static-build (own dev server)', () => {
+        writePkg({
+            dependencies: { vite: '^5.0.0' },
+            scripts: { build: 'vite build', start: 'vite preview' },
+        });
+        expect(detectStaticFramework(dir)?.framework).toBe('vite');
+    });
+    it('vite + start script with extra flags still counts as the dev server (word-boundary match)', () => {
+        writePkg({
+            dependencies: { vite: '^5.0.0' },
+            scripts: { build: 'vite build', start: 'vite preview --port 4173' },
+        });
+        expect(detectStaticFramework(dir)?.framework).toBe('vite');
+    });
+    it('vite + a lookalike start script that only shares a prefix is NOT a word-boundary match (stays dynamic)', () => {
+        writePkg({
+            dependencies: { vite: '^5.0.0' },
+            scripts: { build: 'vite build', start: 'vite-custom-wrapper.js' },
+        });
+        expect(detectStaticFramework(dir)).toBeNull();
+    });
+});
+//# sourceMappingURL=detect-static-framework.test.js.map

package/dist/lib/__tests__/detect-static-framework.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-static-framework.test.js","sourceRoot":"","sources":["../../../src/lib/__tests__/detect-static-framework.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/__tests__/errors.test.d.ts

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

package/dist/lib/__tests__/errors.test.d.ts.map

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

package/dist/lib/__tests__/errors.test.js

@@ -0,0 +1,56 @@
+import { describe, it, expect } from 'vitest';
+import { CODES, EXIT, exitCodeFor, isRetryable, buildError } from '../errors.js';
+/**
+ * PINs the exit-code contract that makes the CLI machine-consumable.
+ *
+ * Before this existed, 112 of the CLI's 113 process.exit() calls resolved
+ * to 1, so a caller reading $? could not tell "your repo is broken" from
+ * "our server blipped". The registry is closed and the band is DERIVED
+ * from the code precisely so no future call site gets to pick a number.
+ *
+ * The "never 1" assertion is the load-bearing one: 1 is reserved for
+ * genuinely unclassified failures, so any KNOWN code reaching it means
+ * someone added a code without deciding what it means.
+ */
+describe('exit code registry', () => {
+    it('derives a band for every registered code', () => {
+        for (const code of Object.keys(CODES)) {
+            expect(typeof exitCodeFor(code)).toBe('number');
+        }
+    });
+    it('never maps a known code to the unclassified band', () => {
+        for (const code of Object.keys(CODES)) {
+            expect(exitCodeFor(code)).not.toBe(EXIT.UNCLASSIFIED);
+        }
+    });
+    it('marks upstream failures retryable and local failures not', () => {
+        expect(isRetryable('NETWORK')).toBe(true);
+        expect(isRetryable('SERVER_ERROR')).toBe(true);
+        expect(isRetryable('ARTIFACT_TOO_LARGE')).toBe(false);
+        expect(isRetryable('NOT_AUTHENTICATED')).toBe(false);
+    });
+    it('puts auth at 10, local input at 30, quota at 50, upstream at 60', () => {
+        expect(exitCodeFor('NOT_AUTHENTICATED')).toBe(10);
+        expect(exitCodeFor('MISSING_ENTRYPOINT')).toBe(30);
+        expect(exitCodeFor('PAID_FEATURE')).toBe(50);
+        expect(exitCodeFor('NETWORK')).toBe(60);
+    });
+    it('builds an error carrying its own retryable bit', () => {
+        const err = buildError('NETWORK', "couldn't reach pushto.host.", {
+            fix: { label: 'try again', cmd: 'pushto deploy' },
+        });
+        expect(err).toEqual({
+            code: 'NETWORK',
+            human: "couldn't reach pushto.host.",
+            retryable: true,
+            fix: { label: 'try again', cmd: 'pushto deploy' },
+        });
+    });
+    it('omits optional keys it was not given', () => {
+        const err = buildError('NO_PROJECT', 'no project here.');
+        expect(err).toEqual({ code: 'NO_PROJECT', human: 'no project here.', retryable: false });
+        expect('fix' in err).toBe(false);
+        expect('stage' in err).toBe(false);
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/dist/lib/__tests__/errors.test.js.map

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

package/dist/lib/__tests__/interactive.test.d.ts

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

package/dist/lib/__tests__/interactive.test.d.ts.map

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

package/dist/lib/__tests__/interactive.test.js

@@ -0,0 +1,79 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { canPrompt } from '../interactive.js';
+/**
+ * PINs the rule that an agent gets correct behavior with ZERO flags.
+ *
+ * Requiring --yes would not have fixed the deploy hang, because an agent
+ * that has never read our docs does not know the flag exists. So prompting
+ * is RESOLVED from ambient state, and a flag can only ever turn it further
+ * off. Every branch below is a real way a machine invokes us.
+ */
+const orig = {
+    stdin: process.stdin.isTTY,
+    stdout: process.stdout.isTTY,
+    ci: process.env.CI,
+    ni: process.env.PUSHTO_NONINTERACTIVE,
+};
+const setTTY = (stdin, stdout) => {
+    Object.defineProperty(process.stdin, 'isTTY', { value: stdin, configurable: true });
+    Object.defineProperty(process.stdout, 'isTTY', { value: stdout, configurable: true });
+};
+afterEach(() => {
+    setTTY(orig.stdin, orig.stdout);
+    if (orig.ci === undefined)
+        delete process.env.CI;
+    else
+        process.env.CI = orig.ci;
+    if (orig.ni === undefined)
+        delete process.env.PUSHTO_NONINTERACTIVE;
+    else
+        process.env.PUSHTO_NONINTERACTIVE = orig.ni;
+});
+describe('canPrompt', () => {
+    it('allows prompting for a human on a full terminal', () => {
+        setTTY(true, true);
+        delete process.env.CI;
+        delete process.env.PUSHTO_NONINTERACTIVE;
+        expect(canPrompt()).toBe(true);
+    });
+    it('refuses when stdin is not a tty (the agent case)', () => {
+        setTTY(false, true);
+        delete process.env.CI;
+        delete process.env.PUSHTO_NONINTERACTIVE;
+        expect(canPrompt()).toBe(false);
+    });
+    it('refuses when stdout is piped', () => {
+        setTTY(true, false);
+        delete process.env.CI;
+        delete process.env.PUSHTO_NONINTERACTIVE;
+        expect(canPrompt()).toBe(false);
+    });
+    it('refuses under CI', () => {
+        setTTY(true, true);
+        process.env.CI = '1';
+        delete process.env.PUSHTO_NONINTERACTIVE;
+        expect(canPrompt()).toBe(false);
+    });
+    it('refuses under PUSHTO_NONINTERACTIVE', () => {
+        setTTY(true, true);
+        delete process.env.CI;
+        process.env.PUSHTO_NONINTERACTIVE = '1';
+        expect(canPrompt()).toBe(false);
+    });
+    it('refuses when --json or --yes was passed, even on a real terminal', () => {
+        setTTY(true, true);
+        delete process.env.CI;
+        delete process.env.PUSHTO_NONINTERACTIVE;
+        expect(canPrompt({ json: true })).toBe(false);
+        expect(canPrompt({ yes: true })).toBe(false);
+    });
+    it('treats CI="" and CI="false" as not set, matching shell convention', () => {
+        setTTY(true, true);
+        delete process.env.PUSHTO_NONINTERACTIVE;
+        process.env.CI = '';
+        expect(canPrompt()).toBe(true);
+        process.env.CI = 'false';
+        expect(canPrompt()).toBe(true);
+    });
+});
+//# sourceMappingURL=interactive.test.js.map

package/dist/lib/__tests__/interactive.test.js.map

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

package/dist/lib/__tests__/output.test.d.ts

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

package/dist/lib/__tests__/output.test.d.ts.map

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

package/dist/lib/__tests__/output.test.js

@@ -0,0 +1,144 @@
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { emitOk, emitErr, progress, spinnerStream } from '../output.js';
+import { buildError } from '../errors.js';
+/**
+ * PINs stdout purity under --json.
+ *
+ * The contract an agent depends on is `pushto deploy --json | jq` working
+ * with no filtering, which means stdout carries EXACTLY one JSON object and
+ * nothing else. ora writes to stdout by default in every spine command, so
+ * a single un-redirected spinner frame is enough to corrupt the payload —
+ * that is what the spinnerStream assertion guards.
+ */
+const captureStdout = () => {
+    let buf = '';
+    const spy = vi.spyOn(process.stdout, 'write').mockImplementation((chunk) => {
+        buf += String(chunk);
+        return true;
+    });
+    return { text: () => buf, restore: () => spy.mockRestore() };
+};
+const captureStderr = () => {
+    let buf = '';
+    const spy = vi.spyOn(process.stderr, 'write').mockImplementation((chunk) => {
+        buf += String(chunk);
+        return true;
+    });
+    return { text: () => buf, restore: () => spy.mockRestore() };
+};
+afterEach(() => vi.restoreAllMocks());
+describe('json mode', () => {
+    it('writes exactly one parseable object to stdout', () => {
+        const out = captureStdout();
+        emitOk({ url: 'https://x.pushto.host' }, { json: true });
+        const text = out.text();
+        out.restore();
+        expect(() => JSON.parse(text)).not.toThrow();
+        expect(JSON.parse(text)).toEqual({ ok: true, url: 'https://x.pushto.host' });
+    });
+    it('routes progress to stderr, never stdout', () => {
+        const out = captureStdout();
+        const err = captureStderr();
+        progress('zipping project...', { json: true });
+        const stdout = out.text();
+        const stderr = err.text();
+        out.restore();
+        err.restore();
+        expect(stdout).toBe('');
+        expect(stderr).toContain('zipping project');
+    });
+    it('serialises an error with its code, retryable bit and fix', () => {
+        const out = captureStdout();
+        emitErr(buildError('MISSING_ENTRYPOINT', 'no package.json in the repo root.', {
+            stage: 'build',
+            fix: { label: 'point at the subfolder', cmd: 'pushto deploy --root ./app' },
+        }), { json: true });
+        const text = out.text();
+        out.restore();
+        expect(JSON.parse(text)).toEqual({
+            ok: false,
+            stage: 'build',
+            retryable: false,
+            error: {
+                code: 'MISSING_ENTRYPOINT',
+                human: 'no package.json in the repo root.',
+                fix: { label: 'point at the subfolder', cmd: 'pushto deploy --root ./app' },
+            },
+        });
+    });
+    it('points spinners at stderr in json mode and stdout otherwise', () => {
+        expect(spinnerStream({ json: true })).toBe(process.stderr);
+        expect(spinnerStream({})).toBe(process.stdout);
+    });
+});
+describe('human mode', () => {
+    it('prints prose to stdout and never emits json', () => {
+        const out = captureStdout();
+        emitOk({ url: 'https://x.pushto.host', human: 'live at https://x.pushto.host' }, {});
+        const text = out.text();
+        out.restore();
+        expect(text).toContain('live at https://x.pushto.host');
+        expect(text.trim().startsWith('{')).toBe(false);
+    });
+    it('prints the fix command under the error', () => {
+        const err = captureStderr();
+        emitErr(buildError('NO_PROJECT', 'no project here.', {
+            fix: { label: 'get started', cmd: 'pushto init <name>' },
+        }), {});
+        const text = err.text();
+        err.restore();
+        expect(text).toContain('no project here.');
+        expect(text).toContain('pushto init <name>');
+    });
+    /**
+     * `label: cmd` cannot express a sentence with words AFTER the command, so
+     * adopting the structured shape silently rewrote hand-written copy —
+     * "run pushto login first." became "sign in: pushto login". `prose` keeps
+     * the original sentence while agents still read label/cmd.
+     */
+    it('reproduces hand-written prose verbatim, placing the command inline', () => {
+        const err = captureStderr();
+        emitErr(buildError('NOT_AUTHENTICATED', 'not logged in.', {
+            fix: { label: 'sign in', cmd: 'pushto login', prose: 'run {cmd} first.' },
+        }), {});
+        const text = err.text();
+        err.restore();
+        // eslint-disable-next-line no-control-regex -- strip ANSI to compare the sentence itself
+        const plain = text.replace(/\[[0-9;]*m/g, '');
+        expect(plain).toBe('> not logged in.\n  run pushto login first.\n');
+    });
+    it('falls back to "label: cmd" when no prose is supplied', () => {
+        const err = captureStderr();
+        emitErr(buildError('NO_PROJECT', 'no project here.', {
+            fix: { label: 'get started', cmd: 'pushto init <name>' },
+        }), {});
+        const text = err.text();
+        err.restore();
+        // eslint-disable-next-line no-control-regex -- strip ANSI to compare the sentence itself
+        const plain = text.replace(/\[[0-9;]*m/g, '');
+        expect(plain).toBe('> no project here.\n  get started: pushto init <name>\n');
+    });
+});
+describe('prose never reaches machine output', () => {
+    it('strips the {cmd} placeholder field from the json fix object', () => {
+        const out = captureStdout();
+        emitErr(buildError('NOT_AUTHENTICATED', 'not logged in.', {
+            stage: 'auth',
+            fix: { label: 'sign in', cmd: 'pushto login', prose: 'run {cmd} first.' },
+        }), { json: true });
+        const text = out.text();
+        out.restore();
+        expect(text).not.toContain('{cmd}');
+        expect(JSON.parse(text)).toEqual({
+            ok: false,
+            stage: 'auth',
+            retryable: false,
+            error: {
+                code: 'NOT_AUTHENTICATED',
+                human: 'not logged in.',
+                fix: { label: 'sign in', cmd: 'pushto login' },
+            },
+        });
+    });
+});
+//# sourceMappingURL=output.test.js.map

package/dist/lib/__tests__/output.test.js.map

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

package/dist/lib/__tests__/prepare-artifact.test.d.ts

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

package/dist/lib/__tests__/prepare-artifact.test.d.ts.map

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

package/dist/lib/__tests__/prepare-artifact.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { prepareArtifact } from '../prepare-artifact.js';
+import { ARTIFACT_META_NAME } from '../build-runner.js';
+let dir;
+beforeEach(() => { dir = fs.mkdtempSync(path.join(os.tmpdir(), 'pushto-prep-')); });
+afterEach(() => {
+    fs.rmSync(dir, { recursive: true, force: true });
+    // Remove all exit listeners added during this test to avoid leaking listeners
+    // between tests. Vitest runs this in a worker, but exit hooks persist in the
+    // process, so we clean up to avoid interference with later tests.
+    process.removeAllListeners('exit');
+});
+describe('prepareArtifact', () => {
+    it('non-framework project passes through as source', async () => {
+        fs.writeFileSync(path.join(dir, 'index.html'), '<h1>hi</h1>');
+        const r = await prepareArtifact(dir, () => undefined);
+        expect(r).toEqual({ kind: 'source', zipDir: dir });
+    });
+    it('framework project builds and returns the artifact dir with the meta marker present', async () => {
+        fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify({
+            devDependencies: { vite: '^5.0.0' },
+            scripts: { build: 'node -e "require(\'fs\').mkdirSync(\'dist\',{recursive:true});require(\'fs\').writeFileSync(\'dist/index.html\',\'built\')"' },
+        }));
+        fs.mkdirSync(path.join(dir, 'node_modules'), { recursive: true });
+        const beforeListenerCount = process.listenerCount('exit');
+        const r = await prepareArtifact(dir, () => undefined);
+        expect(r.kind).toBe('artifact');
+        if (r.kind === 'artifact') {
+            // Verify exit hook was registered
+            expect(process.listenerCount('exit')).toBe(beforeListenerCount + 1);
+            expect(r.framework).toBe('vite');
+            expect(r.zipDir).toBe(path.join(dir, 'dist'));
+            const meta = JSON.parse(fs.readFileSync(path.join(r.zipDir, ARTIFACT_META_NAME), 'utf-8'));
+            expect(meta).toMatchObject({ framework: 'vite', spa: true });
+            // Verify cleanup is idempotent — calling twice should not throw and marker should stay gone
+            r.cleanup();
+            expect(fs.existsSync(path.join(r.zipDir, ARTIFACT_META_NAME))).toBe(false);
+            r.cleanup(); // Second call should not throw
+            expect(fs.existsSync(path.join(r.zipDir, ARTIFACT_META_NAME))).toBe(false);
+        }
+    });
+    it('framework project with a failing build returns failed and writes no meta', async () => {
+        fs.writeFileSync(path.join(dir, 'package.json'), JSON.stringify({
+            devDependencies: { vite: '^5.0.0' },
+            scripts: { build: 'node -e "process.exit(1)"' },
+        }));
+        fs.mkdirSync(path.join(dir, 'node_modules'), { recursive: true });
+        const r = await prepareArtifact(dir, () => undefined);
+        expect(r.kind).toBe('failed');
+    });
+});
+//# sourceMappingURL=prepare-artifact.test.js.map

package/dist/lib/__tests__/prepare-artifact.test.js.map

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

package/dist/lib/__tests__/preview-args.test.d.ts

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

package/dist/lib/__tests__/preview-args.test.d.ts.map

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

package/dist/lib/__tests__/preview-args.test.js

@@ -0,0 +1,37 @@
+import { describe, it, expect } from 'vitest';
+import { resolvePreviewAction } from '../preview-args.js';
+/**
+ * PINs for the `pushto preview` dispatcher's action grammar.
+ *
+ * docs/cli and the command's own help have taught "(create, ls, rm)" since
+ * the command shipped — but the dispatcher treated ANY unknown action word
+ * as a directory, so the documented `pushto preview create --branch x`
+ * died with "not a directory: create". The verb now exists; a positional
+ * directory still works.
+ */
+describe('resolvePreviewAction', () => {
+    it('bare invocation creates from the current directory', () => {
+        expect(resolvePreviewAction('', [])).toEqual({ kind: 'create', dir: '.' });
+    });
+    it('the documented `create` verb creates from the current directory', () => {
+        expect(resolvePreviewAction('create', [])).toEqual({ kind: 'create', dir: '.' });
+    });
+    it('`create <dir>` targets that directory', () => {
+        expect(resolvePreviewAction('create', ['dist'])).toEqual({ kind: 'create', dir: 'dist' });
+    });
+    it('a bare positional directory still works (pushto preview dist)', () => {
+        expect(resolvePreviewAction('dist', [])).toEqual({ kind: 'create', dir: 'dist' });
+    });
+    it('ls and list both list', () => {
+        expect(resolvePreviewAction('ls', [])).toEqual({ kind: 'ls' });
+        expect(resolvePreviewAction('list', [])).toEqual({ kind: 'ls' });
+    });
+    it('rm and delete both remove, carrying the ref', () => {
+        expect(resolvePreviewAction('rm', ['feature-x'])).toEqual({ kind: 'rm', ref: 'feature-x' });
+        expect(resolvePreviewAction('delete', ['abc123'])).toEqual({ kind: 'rm', ref: 'abc123' });
+    });
+    it('rm without a ref reports the miss instead of guessing', () => {
+        expect(resolvePreviewAction('rm', [])).toEqual({ kind: 'rm', ref: undefined });
+    });
+});
+//# sourceMappingURL=preview-args.test.js.map

package/dist/lib/__tests__/preview-args.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-args.test.js","sourceRoot":"","sources":["../../../src/lib/__tests__/preview-args.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;;;;;GAQG;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,oBAAoB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;QAC5F,MAAM,CAAC,oBAAoB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AA+CA,eAAO,MAAM,GAAG,GAAU,MAAM,MAAM,EAAE,UAAS,WAAgB,KAAG,OAAO,CAAC,QAAQ,CAyBnF,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,YAAY,QAAO,WAAqD,CAAC"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/lib/api.ts"],"names":[],"mappings":"AAgEA,eAAO,MAAM,GAAG,GAAU,MAAM,MAAM,EAAE,UAAS,WAAgB,KAAG,OAAO,CAAC,QAAQ,CA4BnF,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,YAAY,QAAO,WAAqD,CAAC"}