@somewhere-tech/cli 0.31.2 → 0.31.3

package/dist/lib/promote-handoff.js

@@ -0,0 +1,72 @@
+/**
+ * The promote command the CLI hands back, and the two things it must say after
+ * a promote lands.
+ *
+ * Both come out of the same parity run:
+ *
+ *  - The printed promote command could not be run in the shell that printed it.
+ *    `somewhere preview` and `somewhere status` printed
+ *    `somewhere promote <session> <preview>`; `somewhere promote` then refuses
+ *    that exact command with "Refusing to promote without confirmation in a
+ *    non-interactive shell" — so the one context where the hosted loop is the
+ *    only way to see the app (an agent, a script, a piped terminal) is the one
+ *    context where the CLI's own output does not work.
+ *
+ *  - Promotion moved the app and said nothing about the data. Preview rows stay
+ *    in the preview database; that isolation is the point, but a developer who
+ *    is not told rediscovers it by opening an empty production page and
+ *    repeating the whole acceptance pass.
+ *
+ * Pure so both directions can be fixtured without a network or a terminal.
+ */
+/**
+ * The promote command for a given shell.
+ *
+ * Non-interactive: one line, with `--yes`, because there is nobody to answer a
+ * prompt and a command that cannot run is not a handoff.
+ *
+ * Interactive: the plain command first — a person at a keyboard should get the
+ * confirmation, not be handed an unattended promote they did not ask for — and
+ * the `--yes` form named after it, so the same output is still useful when it
+ * is scrolled back to from a script.
+ */
+export function promoteCommands(args) {
+    const base = `somewhere promote ${args.previewSessionId} ${args.previewId}`;
+    if (!args.interactive)
+        return [`${base} --yes`];
+    return [base, `${base} --yes`];
+}
+/** The single command to print when only one line fits. Always runnable here. */
+export function promoteCommandForShell(args) {
+    const commands = promoteCommands(args);
+    return commands[0];
+}
+/** The label for each printed variant, so two lines are not two mysteries. */
+export function promoteCommandLines(args) {
+    const commands = promoteCommands(args);
+    if (commands.length === 1)
+        return [`promote command: \`${commands[0]}\``];
+    return [
+        `promote command: \`${commands[0]}\``,
+        `without the confirmation (scripts, agents): \`${commands[1]}\``,
+    ];
+}
+/**
+ * What a developer needs to know about their data the moment production
+ * changes.
+ *
+ * The platform is adding a field that says this in its own words; when it
+ * sends one, that wins, so the sentence can be corrected without waiting for a
+ * CLI release. Until then the CLI says it from what it already knows, because
+ * a line that waits on a deploy is a line nobody reads.
+ */
+export function promotedDataNotes(platformNote) {
+    if (typeof platformNote === 'string' && platformNote.trim()) {
+        return [platformNote.trim()];
+    }
+    return [
+        'Only the app was promoted. Rows you created while previewing stayed in the preview database — production is serving the data it already had.',
+        'Open production and check it end to end, and seed anything it needs, before you call this shipped.',
+    ];
+}
+//# sourceMappingURL=promote-handoff.js.map

package/dist/lib/promote-handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote-handoff.js","sourceRoot":"","sources":["../../src/lib/promote-handoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,IAI/B;IACC,MAAM,IAAI,GAAG,qBAAqB,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;IAC5E,IAAI,CAAC,IAAI,CAAC,WAAW;QAAE,OAAO,CAAC,GAAG,IAAI,QAAQ,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,sBAAsB,CAAC,IAItC;IACC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,mBAAmB,CAAC,IAInC;IACC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,sBAAsB,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1E,OAAO;QACL,sBAAsB,QAAQ,CAAC,CAAC,CAAC,IAAI;QACrC,iDAAiD,QAAQ,CAAC,CAAC,CAAC,IAAI;KACjE,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAAsB;IACtD,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5D,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO;QACL,8IAA8I;QAC9I,oGAAoG;KACrG,CAAC;AACJ,CAAC"}

package/dist/lib/surface-counts.js

@@ -0,0 +1,87 @@
+/**
+ * How many files, said the same way everywhere.
+ *
+ * One project used to get three different answers out of one CLI: `somewhere
+ * deploy` said "2 static file(s) + 1 function(s)", `somewhere preview` said
+ * "Synced 3 files" with the function invisible inside the number, and
+ * `somewhere promote` said "3 files + functions" with the count of functions
+ * replaced by the word. A developer reading all three cannot tell whether the
+ * app grew, whether the function shipped, or which number to trust — which is
+ * exactly what happened in the parity run that produced this module.
+ *
+ * The shape, everywhere: `3 static files + 1 function`. Two nouns, two
+ * numbers, no parenthesised plurals.
+ *
+ * The counting rule, everywhere: static = the pages, scripts, styles and
+ * assets that make up the site; functions = the api/ handlers, counted
+ * separately because they are the half a boolean used to hide. It is the same
+ * split the project itself reports, so the CLI's number and the project's
+ * number are the same number.
+ *
+ * Pure and dependency-free so both directions can be fixtured without a
+ * network.
+ */
+/** A count with its noun, singular or plural — never `file(s)`. */
+function plural(count, one, many) {
+    return `${count} ${count === 1 ? one : many}`;
+}
+/**
+ * The one phrase. Renders as many of the two halves as are actually known:
+ *
+ *   { staticFiles: 3, functions: 1 }      → `3 static files + 1 function`
+ *   { staticFiles: 3, functions: 0 }      → `3 static files`
+ *   { staticFiles: 1, functions: 2 }      → `1 static file + 2 functions`
+ *   { staticFiles: 3, functions: 'some' } → `3 static files + functions`
+ *   { staticFiles: null, functions: 1 }   → `1 function`
+ *   { staticFiles: null, functions: null} → `Files`
+ *
+ * A zero function count prints nothing rather than "+ 0 functions": a static
+ * site saying it has no backend on every line is noise, and the absence is
+ * already the answer.
+ */
+export function formatPublishSurface(counts) {
+    const parts = [];
+    if (counts.staticFiles !== null) {
+        parts.push(plural(counts.staticFiles, 'static file', 'static files'));
+    }
+    if (counts.functions === 'some') {
+        parts.push('functions');
+    }
+    else if (typeof counts.functions === 'number') {
+        // Zero is suppressed only as a TAIL: "3 static files + 0 functions" is
+        // noise on a static site, but a functions-only deploy that moved nothing
+        // still has to say so rather than fall through to a bare noun.
+        if (counts.functions > 0 || parts.length === 0) {
+            parts.push(plural(counts.functions, 'function', 'functions'));
+        }
+    }
+    if (parts.length === 0)
+        return 'Files';
+    return parts.join(' + ');
+}
+/**
+ * Count a collected publish surface the way the project does.
+ *
+ * Binary assets are static files — an image is as much part of the site as the
+ * page that shows it, and splitting them out is an implementation detail of how
+ * the CLI reads them off disk, not something a developer asked about.
+ */
+export function countPublishSurface(collected) {
+    return {
+        staticFiles: Object.keys(collected.files).length + Object.keys(collected.binaryFiles ?? {}).length,
+        functions: Object.keys(collected.functions ?? {}).length,
+    };
+}
+/**
+ * A count the platform sent, when it sent one. Anything that is not a finite
+ * number is not a count — `null` (unknown) is honest and renders as an absence,
+ * where `0` would be a claim.
+ */
+export function countFromResponse(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (Array.isArray(value))
+        return value.length;
+    return null;
+}
+//# sourceMappingURL=surface-counts.js.map

package/dist/lib/surface-counts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-counts.js","sourceRoot":"","sources":["../../src/lib/surface-counts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAYH,mEAAmE;AACnE,SAAS,MAAM,CAAC,KAAa,EAAE,GAAW,EAAE,IAAY;IACtD,OAAO,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAChD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA4B;IAC/D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC1B,CAAC;SAAM,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAChD,uEAAuE;QACvE,yEAAyE;QACzE,+DAA+D;QAC/D,IAAI,MAAM,CAAC,SAAS,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAInC;IACC,OAAO;QACL,WAAW,EACT,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM;QACvF,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM;KACzD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC9C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@somewhere-tech/cli",
-  "version": "0.31.2",
+  "version": "0.31.3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@somewhere-tech/cli",
-      "version": "0.31.2",
+      "version": "0.31.3",
       "bundleDependencies": [
         "@modelcontextprotocol/sdk",
         "chokidar",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@somewhere-tech/cli",
-  "version": "0.31.2",
+  "version": "0.31.3",
   "description": "CLI for somewhere.tech — auth, projects, deploy, pull, promote, db, logs, env, MCP bridge.",
   "keywords": [
     "somewhere",