@usefillo/cli 0.19.0 → 0.20.0

package/dist/index.js

@@ -815,6 +815,7 @@ async function provisionWorkspace(flags, usageHint, apiBase = API) {
     }
   }
   const workspaceName = flagString(flags, "workspace-name") ?? defaultWorkspaceName();
+  const promptCopyId = flagString(flags, "pc")?.trim();
   const res = await api(
     "/workspaces/provision",
     {
@@ -823,7 +824,8 @@ async function provisionWorkspace(flags, usageHint, apiBase = API) {
         email: email3,
         source: "cli",
         ...name ? { name } : {},
-        ...workspaceName ? { workspaceName } : {}
+        ...workspaceName ? { workspaceName } : {},
+        ...promptCopyId ? { promptCopyId } : {}
       })
     },
     apiBase
@@ -958,7 +960,7 @@ async function init(flags) {
 }
 var initCommand = {
   name: "init",
-  flags: ["email", "name", "workspace-name"],
+  flags: ["email", "name", "workspace-name", "pc"],
   run: (_args, flags) => init(flags)
 };
 
@@ -1210,7 +1212,7 @@ var skillCommand = {
 };
 
 // src/commands/agent.ts
-var BOOTSTRAP_USAGE = 'To set up a workspace I need an email for your recovery link. Re-run: npx @usefillo/cli@latest agent bootstrap --email you@company.com [--name "Your Name"]. (Already have an account? `fillo login`.)';
+var BOOTSTRAP_USAGE = 'To set up a workspace I need the human\'s real work email for the recovery link. Ask the human for their work email once \u2014 never invent an address or use a documentation placeholder \u2014 then re-run: npx @usefillo/cli@latest agent bootstrap --email <work-email> [--name "Your Name"]. (Already have an account? `fillo login`.)';
 async function bootstrapStandalone(flags, apiBase) {
   if (flags.account === true) {
     die(
@@ -1403,9 +1405,10 @@ function agentHelp() {
 
   ${boldRaw("Commands")}
     agent bootstrap     Set up a workspace and install the Build with Fillo skill
-                       ${dimRaw("--email you@company.com   provision a fresh workspace (a TTY confirms your git identity)")}
+                       ${dimRaw("--email <work-email>   provision a fresh workspace (ask the human first; a TTY confirms git identity)")}
                        ${dimRaw('--name "Your Name"        optional display name')}
                        ${dimRaw("--workspace-name <name>   name the new workspace (default: this repo/directory)")}
+                       ${dimRaw("--pc <uuid>               optional marketing stitch id from /agents?pc=")}
                        ${dimRaw("--api <url>               target a different Fillo deployment (default: FILLO_API or https://fillo.so)")}
                        ${dimRaw("--run <id> --token <token>   instead: attach to an open browser modal")}
                        ${dimRaw("--account   with --run/--token: approve an existing workspace in the browser")}
@@ -1432,6 +1435,7 @@ var agentCommand = {
     "email",
     "name",
     "workspace-name",
+    "pc",
     "run",
     "token",
     "api",
@@ -2075,10 +2079,30 @@ function printDestination(body) {
   console.log(
     `  ${dim("Role grant:")}    ${grant ? `${terminalText(grant.roleId)} in ${terminalText(grant.guildId)}${grant.autoJoin ? " (auto-join)" : ""}` : "off"}`
   );
-  if (!body.webhookMatches) {
+  if (!body.webhookMatches && body.connectionLabel) {
     console.log(
       `
-  ${bold("This form points at a different webhook than the project does.")} It keeps failing until you re-run \`fillo discord enable <form>\`.`
+  ${dim(
+        `This form posts to its own channel; the project default is ${terminalText(body.connectionLabel)}. Re-point it with \`fillo discord enable <form> --channel <channelId>\`.`
+      )}`
+    );
+  }
+  const servers = body.servers ?? [];
+  if (servers.length > 0) {
+    console.log("");
+    printTable(
+      ["SERVER", "ID"],
+      servers.map((server) => [terminalText(server.name ?? "(name unavailable)"), server.guildId])
+    );
+    console.log(`
+  ${dim("Aim a form: fillo discord enable <form> --channel <channelId>")}`);
+  }
+  const channels = body.channels ?? [];
+  if (servers.length === 0 && channels.length > 1) {
+    console.log("");
+    printTable(
+      ["CHANNEL", "WEBHOOK ID"],
+      channels.map((channel) => [terminalText(channel.label), channel.webhookId])
     );
   }
 }
@@ -2105,18 +2129,35 @@ function parseRole(raw) {
 async function enable(form, flags) {
   const json = jsonMode(flags);
   if (!form)
-    die("Usage: fillo discord enable <form> [--fields a,b,c] [--early-signal 5|10|25|off]");
+    die(
+      "Usage: fillo discord enable <form> [--channel <webhookId>] [--fields a,b,c] [--early-signal 5|10|25|off]"
+    );
   const token = requireToken();
   const current = await fetchDestination(token, form);
-  if (!current.connected || !current.connectionWebhookId) {
+  const channels = current.channels ?? [];
+  if ((!current.connected || !current.connectionWebhookId) && channels.length === 0) {
     die(
       "Discord isn't connected to this project. Run `fillo discord connect`, or `fillo discord webhook` to paste a channel URL."
     );
   }
+  const rawChannel = flagString(flags, "channel");
+  if (rawChannel !== void 0 && !SNOWFLAKE.test(rawChannel.trim())) {
+    die("--channel must be a Discord channel id (right-click the channel \u2192 Copy Channel ID).");
+  }
+  const targetChannelId = rawChannel?.trim() ?? null;
+  const fallbackWebhookId = current.connectionWebhookId ?? (channels.length === 1 ? channels[0]?.webhookId ?? null : null);
+  if (!current.enabled && !targetChannelId && !fallbackWebhookId) {
+    die(
+      "Pass --channel <channelId> to pick where this form posts. `fillo discord status <form>` lists the connected servers."
+    );
+  }
   const patch = {};
-  if (!current.enabled || !current.webhookMatches) {
+  if (targetChannelId) {
+    patch.enabled = true;
+    patch.channelId = targetChannelId;
+  } else if (!current.enabled && fallbackWebhookId) {
     patch.enabled = true;
-    patch.webhookId = current.connectionWebhookId;
+    patch.webhookId = fallbackWebhookId;
   }
   const rawFields = flagString(flags, "fields");
   if (rawFields !== void 0) patch.includeFieldIds = parseFields(rawFields);
@@ -2244,6 +2285,7 @@ function discordHelp() {
                        ${dimRaw(`reads the URL from a hidden prompt, or ${WEBHOOK_URL_ENV}`)}
     discord status <form>    What this form sends, to where, with which extras
     discord enable <form>    Start sending \u2014 and set any of the options below
+                       ${dimRaw("--channel <channelId>     which channel this form posts to (bot lane)")}
                        ${dimRaw("--fields a,b,c            up to three field ids (none = link only)")}
                        ${dimRaw("--early-signal 5|10|25    first N responses arrive in full (off to stop)")}
                        ${dimRaw("--role <guildId>/<roleId> grant that role on an accepted response")}
@@ -2263,7 +2305,7 @@ function discordHelp() {
 }
 var discordCommand = {
   name: "discord",
-  flags: ["label", "fields", "early-signal", "role", "auto-join"],
+  flags: ["label", "channel", "fields", "early-signal", "role", "auto-join"],
   run: (args, flags) => discord(args[0], args.slice(1), flags),
   help: discordHelp
 };
@@ -3774,7 +3816,7 @@ var schemaShape = object({
 });
 var MAX_SCHEMA_VERSION = 1;
 var FILLO_SCHEMA_VERSION = 1;
-var FILLO_SDK_VERSION = true ? "0.19.0" : "0.0.0-dev";
+var FILLO_SDK_VERSION = true ? "0.20.0" : "0.0.0-dev";
 function str(value, max, fallback = "") {
   return typeof value === "string" ? value.trim().slice(0, max) : fallback;
 }

package/dist/skill/build-with-fillo/SKILL.md

@@ -20,8 +20,12 @@ Never require a provider-specific agent command.
    with a three-line plan before running anything, for example: "1) I install
    Fillo's SDK and skill. 2) I build the form inside your app. 3) You get an
    email to claim your workspace, where responses live." Add that a few
-   permission prompts may need approving along the way. Skip the recap when
-   Fillo is already set up in the repo.
+   permission prompts may need approving along the way. Then, if their work
+   email is not already in this task, ask them for it once. Do not invent an
+   address, infer or scrape it, or use a documentation placeholder as the
+   address. Run `npx @usefillo/cli@latest agent bootstrap --email <their email>`
+   with the address they give you. Skip the recap and the email ask when Fillo
+   is already set up in the repo or a handoff already supplied a workspace.
 2. Inspect the task environment and any host repository. For an embed, identify
    its framework, package manager, target route, existing Fillo packages, theme
    provider/switch, light and dark selectors, CSS `color-scheme`, design tokens,

package/dist/skill/build-with-fillo/references/auth-and-lifecycle.md

@@ -37,12 +37,16 @@
 - Older existing-account handoff: run its exact
   `login --api … --run … --token …` command, wait for approval, then run the
   supplied `agent connect --account` command.
-- New workspace outside a browser handoff: set it up from the terminal. Run
-  `npx @usefillo/cli@latest init --email <address>` to provision a capped
-  preview workspace, email its link, and store the `pk_` you build against. Only
-  pass `--email` when the user explicitly supplies the address; never infer or
-  scrape it. `https://fillo.so/start` stays available when the user prefers the
-  dashboard.
+- New workspace outside a browser handoff: ask the human once for their real
+  work email if it is not already in the task. Never invent an address, never
+  infer or scrape one, and never use a documentation placeholder as the
+  address. Then run
+  `npx @usefillo/cli@latest agent bootstrap --email <their email>` to provision
+  a capped preview workspace, email its link, store the `pk_` you build
+  against, and install the skill. Use
+  `npx @usefillo/cli@latest init --email <their email>` only when you need the
+  workspace without the skill. `https://fillo.so/start` stays available when
+  the user prefers the dashboard.
 
 Never inspect `~/.fillo/config.json`, expose the account token, or call
 `provisionWorkspace()` during component render.
@@ -78,7 +82,7 @@ workspace:
 
 ```bash
 npx @usefillo/cli@latest claim
-#  Sent a claim link to you@company.com. Approval code: 4KT2-9QF1
+#  Sent a claim link to alex@acme.dev. Approval code: 4KT2-9QF1
 #  Open the link in that inbox — it shows this code — and approve this terminal.
 ```
 

package/dist/skill/build-with-fillo/references/operations.md

@@ -180,10 +180,13 @@ downstream writes duplicate-safe.
 With a CLI login, connect Discord and manage its per-form settings — plus
 mint a connector token for n8n or Zapier — without a dashboard trip.
 
-Connect a channel one of two ways. On a deployment where Fillo's Discord app
-is configured, `discord connect` opens Discord's own consent screen — it
-includes the channel picker. Print the URL and let the user approve it; do
-not loop, the same as `storage connect drive`/`box`:
+Connect one of two ways. On a deployment where Fillo's Discord app is
+configured, `discord connect` opens Discord's consent screen: ONE approval
+adds Fillo's bot to the chosen server (Manage Webhooks only — it can't read
+messages) and connects the first channel. After that, channels are picked
+per form with `enable --channel` — no further approvals. Print the URL and
+let the user approve it; do not loop, the same as `storage connect
+drive`/`box`:
 
 ```bash
 npx @usefillo/cli@latest discord connect
@@ -209,8 +212,13 @@ standing message (default: link only):
 npx @usefillo/cli@latest discord enable customer-intake --fields email,plan
 ```
 
-`enable` takes three more flags beyond field selection:
+`enable` takes more flags beyond field selection:
 
+- `--channel <channelId>` aims this form at any channel of a connected
+  server (right-click the channel in Discord → Copy Channel ID); Fillo
+  resolves the channel through its bot and creates or reuses the channel's
+  webhook. Each form pins its own channel, so two forms can post to two
+  rooms. `discord status <form>` lists the connected servers.
 - `--early-signal 5|10|25` sends every answered field — not only the picked
   three — for that many responses, then reverts to the standing message on
   its own; `--early-signal off` turns it back off early.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usefillo/cli",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Create and publish Fillo forms, and install the Fillo Agent Skill.",
   "license": "MIT",
   "keywords": [
@@ -34,7 +34,7 @@
     "@types/node": "^22.10.0",
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
-    "@usefillo/core": "0.19.0"
+    "@usefillo/core": "0.20.0"
   },
   "scripts": {
     "build": "tsup && node scripts/copy-skill.mjs",