@frontera-sdk/cli 1.49.0 → 1.50.1

package/src/commands/automation/run.ts

@@ -68,7 +68,7 @@ function requireSlug(ctx: CommandContext): string {
   if (!slug) {
     throw new UsageError(
       'missing <slug>',
-      'run `frontera automation list` — then pass the slug of the one you mean',
+      'run `frontera function list` — then pass the slug of the one you mean',
     )
   }
   return slug
@@ -130,7 +130,7 @@ export function parseVersionFlag(ctx: CommandContext): number | undefined {
   if (!Number.isInteger(parsed) || parsed < 1) {
     throw new UsageError(
       `"${raw}" is not a version number`,
-      'versions are whole numbers from 1 — `frontera automation versions <slug>` lists them',
+      'versions are whole numbers from 1 — `frontera function versions <slug>` lists them',
     )
   }
   return parsed
@@ -249,18 +249,18 @@ export function describeRun(run: AutomationRunSummary, steps: AutomationRunStep[
  */
 export const automationRun: Command = {
   meta: {
-    noun: 'automation',
+    noun: 'function',
     verb: 'run',
     args: [{ name: 'slug', required: true, description: 'automation slug' }],
     flags: { 'no-wait': 'boolean', version: 'string', dev: 'boolean', input: 'string' },
     summary: 'Run the live version now — or a named one, or the dev session — and report what it did',
     examples: [
-      'frontera automation run daily-digest',
-      'frontera automation run daily-digest --dev',
-      'frontera automation run daily-digest --version 7',
-      'frontera automation run daily-digest --no-wait',
-      'frontera automation run ktp-extraction --input \'{"file_path":"files/…"}\'',
-      'frontera automation run ktp-extraction --input @input.json',
+      'frontera function run daily-digest',
+      'frontera function run daily-digest --dev',
+      'frontera function run daily-digest --version 7',
+      'frontera function run daily-digest --no-wait',
+      'frontera function run ktp-extraction --input \'{"file_path":"files/…"}\'',
+      'frontera function run ktp-extraction --input @input.json',
     ],
   },
 
@@ -297,7 +297,7 @@ export const automationRun: Command = {
         return {
           data: queued,
           text: `Queued a dev run of ${slug}.\n`
-            + `  frontera automation runs ${slug}   # to see how it went`,
+            + `  frontera function runs ${slug}   # to see how it went`,
         }
       }
       const seen = await waitForRun(client, slug, priorId, 'dev')
@@ -344,7 +344,7 @@ export const automationRun: Command = {
       return {
         data: queued,
         text: `Queued a run of ${slug} v${queued.version}.\n`
-          + `  frontera automation runs ${slug}   # to see how it went`,
+          + `  frontera function runs ${slug}   # to see how it went`,
       }
     }
 
@@ -377,7 +377,7 @@ export const automationRun: Command = {
           + 'so either no runner is polling or it has not picked the event up',
       {
         code: 'REQUEST_FAILED',
-        hint: `frontera automation runs ${slug}`,
+        hint: `frontera function runs ${slug}`,
       },
     )
   },
@@ -386,7 +386,7 @@ export const automationRun: Command = {
 /** Recent runs, newest first — the pull-visibility half of "did it work". */
 export const automationRuns: Command = {
   meta: {
-    noun: 'automation',
+    noun: 'function',
     verb: 'runs',
     args: [
       { name: 'slug', required: true, description: 'automation slug' },
@@ -399,9 +399,9 @@ export const automationRuns: Command = {
     flags: { dev: 'boolean' },
     summary: 'List recent runs, newest first — or open one run and its steps',
     examples: [
-      'frontera automation runs daily-digest',
-      'frontera automation runs daily-digest --dev',
-      'frontera automation runs daily-digest <runId> --json',
+      'frontera function runs daily-digest',
+      'frontera function runs daily-digest --dev',
+      'frontera function runs daily-digest <runId> --json',
     ],
   },
 
@@ -453,9 +453,9 @@ export const automationRuns: Command = {
         data: rows,
         text: dev
           ? `No dev runs recorded for ${slug}.\n`
-            + `  frontera automation dev <entry-file>   # to serve one`
+            + `  frontera function dev <entry-file>   # to serve one`
           : `No runs recorded for ${slug}.\n`
-            + `  frontera automation run ${slug}   # to start one`,
+            + `  frontera function run ${slug}   # to start one`,
       }
     }
 

package/src/commands/registry.ts

@@ -117,9 +117,21 @@ export const COMMANDS: readonly Command[] = [
   ...actionCommands,
 ]
 
+/**
+ * Nouns that still resolve under an old name.
+ *
+ * `frontera function …` is what every runbook, README and installed shell
+ * history says, and a CLI is not something a customer upgrades on our schedule.
+ * The commands carry `noun: 'function'` and `nouns()` lists only that, so help
+ * advertises one name while the other keeps working. Phase 10 of the rename
+ * drops this map.
+ */
+const NOUN_ALIASES: Record<string, string> = { automation: 'function' }
+
 export function findCommand(noun: string, verb: string | undefined): Command | null {
+  const resolved = NOUN_ALIASES[noun] ?? noun
   return (
-    COMMANDS.find((c) => c.meta.noun === noun && c.meta.verb === (verb ?? '')) ?? null
+    COMMANDS.find((c) => c.meta.noun === resolved && c.meta.verb === (verb ?? '')) ?? null
   )
 }
 
@@ -144,7 +156,7 @@ const NOUN_SUMMARY: Readonly<Record<string, string>> = {
   knowledge: 'Knowledge bases and the sources inside them',
   pack: 'Reusable skill bundles — author once, install per workspace',
   secret: 'Workspace secrets — named here, never printed back',
-  automation: 'Automations — TypeScript deployed here, run on a schedule',
+  function: 'Functions — TypeScript deployed here, run on a schedule',
   blueprint: 'The shared model of the organization — what an app can read',
   action: 'Governed Actions — arm the write path a published Action runs',
   capability: 'What an agent may DO — plugin operations granted to it',
@@ -184,7 +196,7 @@ export const UNSUPPORTED: Readonly<Record<string, string>> = {
   key: 'API keys are minted in the Console, never by the CLI — a credential that mints credentials '
     + 'is the escalation that separation exists to prevent',
   sheet: 'sheets have no CLI surface and none is planned',
-  task: 'task and run history is Console-only; `frontera automation runs` covers automation runs',
+  task: 'task and run history is Console-only; `frontera function runs` covers function runs',
   eval: 'the evaluation suite (datasets, scorers, judges, queues) is Console-only',
   usage: 'usage, cost and audit reporting is Console-only',
   site: 'published sites are managed in the Console; `frontera app` covers Frontera Apps',

package/src/heal.ts

@@ -155,7 +155,7 @@ export function healProject(dir: string): HealResult {
         // are.
         //
         // The CLI is genuinely not a build input: it lives on PATH, and an app
-        // never imports it. Anything else here (`@frontera-sdk/automation`) is a
+        // never imports it. Anything else here (`@frontera-sdk/functions`) is a
         // real package that this app may well import, and dropping it trades a
         // failing `bun install` for a failing `bun run build`. Rewriting it to a
         // version range is the actual repair and is not available yet — nothing