@listen-fire/handbook 0.13.0 → 0.13.1

package/dist/chapters/anatomy.js

@@ -9,11 +9,8 @@ exports.anatomy = {
 Write a file (extension \`.mvt\`) in four passes, top to bottom: imports, constructions, declarations, entry points.
 
 \`\`\`
-import { \`@lf/email\` as email, \`@lf/attio\` as attio } from adapters
-import { acme_main } from credentials
-
-inbox = connect email
-crm   = connect attio using acme_main
+inbox = connect \`@lf/email\`
+crm   = connect \`@lf/attio\` using acme_main
 
 function \`Inbound Intake\`(msg: <inbox-[:Emails]->>) {
   write crm-[:Companies]-> {
@@ -25,21 +22,17 @@ function \`Inbound Intake\`(msg: <inbox-[:Emails]->>) {
 listen to inbox-[e:Emails WHERE e.Key == "intake"]-> fire \`Inbound Intake\`
 \`\`\`
 
-Imports name every external thing the file touches; constructions turn adapter types into the concrete systems ("instances") you read and write; declarations hold the automations, record structures, and file-scope values; \`listen\` lines wire an automation to what fires it (see the listeners chapter). Comments start with \`#\`.
+Imports name the plugins and the other files' declarations the file uses; \`connect\` turns a system, named by its adapter, into the concrete graph ("instance") you read and write; declarations hold the automations, record structures, and file-scope values; \`listen\` lines wire an automation to what fires it (see the listeners chapter). Comments start with \`#\`.
 
 ### imports
 
-Import from four sources, one mechanism:
+Import from two sources, one mechanism:
 
 \`\`\`
-import { \`@lf/attio\` as attio, \`@lf/email\` as email } from adapters
-import { acme_main } from credentials
 import { fetchUrl } from plugins
 import { \`Log Lead\`, Lead as \`Inbound Lead\` } from "lib/intake-routines"
 \`\`\`
 
-- \`adapters\` — adapter *types*, the kinds of system you can construct.
-- \`credentials\` — your workspace's stored connections, by name, named only after \`using\` in a \`connect\`.
 - \`plugins\` — functions the platform ships, called as a function is, by position, with any other inputs in one settings record last: \`page = fetchUrl(c.website)\`, \`deck = fetchUrl(o.deck_url, { email: @user_email })\`.
 - A quoted path — automations and record structures from another saved file. Only declarations it marks \`export\` are importable, and \`as\` renames locally.
 
@@ -47,11 +40,11 @@ The quoted path is the other file's saved name, matched exactly — no folders,
 
 ### constructions
 
-\`connect\` an adapter type to get an instance — the graph you actually read and write:
+\`connect\` an adapter to get an instance — the graph you actually read and write. Name the adapter and your workspace's stored connection (its credential) right there; neither is imported:
 
 \`\`\`
-crm   = connect attio using acme_main
-inbox = connect email
+crm   = connect \`@lf/attio\` using acme_main
+inbox = connect \`@lf/email\`
 \`\`\`
 
 A credential is only ever named after \`using\`; the host resolves it when the instance is used. It is never a value: read anywhere else (bound to a name, in a string, compared, passed on) it is refused. A credential is typed: an Attio credential cannot connect a Slack instance. Some sources need no credential and connect without \`using\`. Which record types and fields an instance offers depends on the workspace behind the credentials, so the schema is only known once it is connected. A connection is made at file scope only. A \`node\` you declare needs no connection: it names a structure, not a system.
@@ -59,7 +52,7 @@ A credential is only ever named after \`using\`; the host resolves it when the i
 Every connection takes \`dryRun\` as well:
 
 \`\`\`
-crm = connect attio using acme_main { dryRun: true }
+crm = connect \`@lf/attio\` using acme_main { dryRun: true }
 \`\`\`
 
 Writes to a dry-run instance are rehearsed — captured and reported instead of committed. Three traps:
@@ -335,11 +328,8 @@ function team_size(name: <text>, people: <{ name: text, manager: text }[]>): <nu
             construct: 'recursion: a function calling itself from inside a map, with a declared return type',
             status: 'runs',
             probe: `
-import { \`@lf/email\` as email, \`@lf/attio\` as attio } from adapters
-import { acme } from credentials
-
-inbox = connect email
-crm   = connect attio using acme
+inbox = connect \`@lf/email\`
+crm   = connect \`@lf/attio\` using acme
 
 function team_size(name: <text>, people: <{ name: text, manager: text }[]>): <number> {
   reports = filter(people, (p) => p.manager == name)
@@ -365,11 +355,8 @@ function \`Intake\`(m: <inbox-[:Emails]->>) {
             construct: 'function calls (composition) with a graph<Shape> argument built in place',
             status: 'runs',
             probe: `
-import { \`@lf/email\` as email, \`@lf/attio\` as attio } from adapters
-import { acme } from credentials
-
-inbox = connect email
-crm   = connect attio using acme
+inbox = connect \`@lf/email\`
+crm   = connect \`@lf/attio\` using acme
 
 node Lead {
   Name: <text>
@@ -391,11 +378,8 @@ function \`Intake\`(m: <inbox-[:Emails]->>) {
             construct: "everything a run wrote, collected by returning each write's handle from map, then acted on member by member",
             status: 'runs',
             probe: `
-import { \`@lf/email\` as email, \`@lf/slack\` as slack } from adapters
-import { team_workspace } from credentials
-
-inbox = connect email
-chat  = connect slack using team_workspace
+inbox = connect \`@lf/email\`
+chat  = connect \`@lf/slack\` using team_workspace
 
 function \`Post And Confirm\`(msg: <inbox-[:Emails]->>) {
   deals = only(chat-[ch:Channels WHERE ch.Name == "deals"]->)
@@ -416,11 +400,8 @@ listen to inbox-[e:Emails WHERE e.Key == "intake"]-> fire \`Post And Confirm\`
             construct: "a call's value — what the callee returned, bound and passed on",
             status: 'runs',
             probe: `
-import { \`@lf/email\` as email, \`@lf/attio\` as attio } from adapters
-import { acme } from credentials
-
-inbox = connect email
-crm   = connect attio using acme
+inbox = connect \`@lf/email\`
+crm   = connect \`@lf/attio\` using acme
 
 node Lead {
   Name: <text>
@@ -448,11 +429,8 @@ function \`Intake\`(m: <inbox-[:Emails]->>) {
             construct: 'a returned graph carrying several results — one entry read by dot, one walked as an edge',
             status: 'runs',
             probe: `
-import { \`@lf/email\` as email, \`@lf/attio\` as attio } from adapters
-import { acme } from credentials
-
-inbox = connect email
-crm   = connect attio using acme
+inbox = connect \`@lf/email\`
+crm   = connect \`@lf/attio\` using acme
 
 node Doc {
   title: <text>
@@ -482,11 +460,8 @@ function \`Intake\`(msg: <inbox-[:Emails]->>) {
             construct: 'multi-parameter library functions (any arity by call; entries stay arity-1)',
             status: 'runs',
             probe: `
-import { \`@lf/email\` as email, \`@lf/attio\` as attio } from adapters
-import { acme } from credentials
-
-inbox = connect email
-crm   = connect attio using acme
+inbox = connect \`@lf/email\`
+crm   = connect \`@lf/attio\` using acme
 
 node Lead {
   Name: <text>
@@ -513,11 +488,8 @@ function \`Intake\`(m: <inbox-[:Emails]->>) {
             construct: 'a graph literal TREE — a single synthesised edge, traversed by the callee',
             status: 'runs',
             probe: `
-import { \`@lf/email\` as email, \`@lf/attio\` as attio } from adapters
-import { acme } from credentials
-
-inbox = connect email
-crm   = connect attio using acme
+inbox = connect \`@lf/email\`
+crm   = connect \`@lf/attio\` using acme
 
 node Deal {
   Title: <text>
@@ -545,11 +517,8 @@ function \`Intake\`(m: <inbox-[:Emails]->>) {
             construct: 'a graph literal child built per record on a path (renamed landings)',
             status: 'runs',
             probe: `
-import { \`@lf/email\` as email, \`@lf/attio\` as attio } from adapters
-import { acme } from credentials
-
-inbox = connect email
-crm   = connect attio using acme
+inbox = connect \`@lf/email\`
+crm   = connect \`@lf/attio\` using acme
 
 node Doc {
   Title: <text>
@@ -577,9 +546,6 @@ function \`Intake\`(m: <inbox-[:Emails]->>) {
             construct: 'a write into a nested node of a typed empty graph the run built',
             status: 'runs',
             probe: `
-import { \`@lf/manual\` as manual } from adapters
-
-runs = connect manual
 
 node Company: "each company named in the supplied text" {
   name:    <text> "the company's name"
@@ -593,7 +559,7 @@ node Found {
   }
 }
 
-function \`Dedupe\`(go: <runs-[:Invocation]->>) {
+function \`Dedupe\`(go: <manual-[:Invocation]->>) {
   deduped = graph<Found> {}
 
   map(extract([go.Text], Company), (c) => {
@@ -614,10 +580,9 @@ function \`Dedupe\`(go: <runs-[:Invocation]->>) {
             construct: 'file imports (shared movement libraries)',
             status: 'runs',
             probe: `
-import { \`@lf/email\` as email } from adapters
 import { \`Log Lead\` } from "lib/intake-routines"
 
-inbox = connect email
+inbox = connect \`@lf/email\`
 
 function \`Intake\`(m: <inbox-[:Emails]->>) {
   \`Log Lead\`(m)
@@ -628,11 +593,8 @@ function \`Intake\`(m: <inbox-[:Emails]->>) {
             construct: 'graph literals — graph<Shape> with path-with-field-body children, a bare-path reference, and a spread of a map',
             status: 'runs',
             probe: `
-import { \`@lf/email\` as email, \`@lf/attio\` as attio } from adapters
-import { acme } from credentials
-
-inbox = connect email
-crm   = connect attio using acme
+inbox = connect \`@lf/email\`
+crm   = connect \`@lf/attio\` using acme
 
 node Message {
   Body: <text>
@@ -674,11 +636,8 @@ function \`Snapshot\`(m: <inbox-[:Emails]->>) {
             construct: 'function convention — positional calls, value and record parameters, exact-case names',
             status: 'runs',
             probe: `
-import { \`@lf/email\` as email, \`@lf/attio\` as attio } from adapters
-import { acme } from credentials
-
-inbox = connect email
-crm   = connect attio using acme
+inbox = connect \`@lf/email\`
+crm   = connect \`@lf/attio\` using acme
 
 function \`Label\`(name: <text>, tags: <text[]>, cfg: <{ prefix: text, suffix?: text }>) {
   return "\${cfg.prefix}\${name} (\${Text.join(tags, ", ")})"