@elaraai/e3-cloud-claude-plugin 0.0.0-stage → 1.0.90-alpha.0

package/index.json

@@ -0,0 +1,749 @@
+{
+  "version": 2,
+  "stats": {
+    "totalEntries": 27,
+    "totalFiles": 1,
+    "packages": {
+      "e3-cloud-ui": 12,
+      "e3-cloud-cli": 11,
+      "e3-cloud-client": 4
+    }
+  },
+  "entries": [
+    {
+      "id": "e3-cloud-ui:pages.examples.tsx:pageReadsAndWritesAnInput",
+      "skill": "e3-cloud-ui",
+      "package": "e3-cloud-ui",
+      "file": "packages/e3-cloud-ui/test/pages.examples.tsx",
+      "suite": "Reading and writing data",
+      "test": "A page's body that reads an input and writes it back from a slider: what Page('overview', { title: 'Overview' }, () => …) takes",
+      "keywords": [
+        "Page",
+        "body",
+        "Data.bind",
+        "read",
+        "write",
+        "input",
+        "Slider",
+        "Stat",
+        "Reactive"
+      ],
+      "imports": [
+        "import { East, ArrayType, DictType, FloatType, NullType, StringType, StructType, example, variant } from '@elaraai/east';",
+        "import { Button, HStack, Reactive, Slider, Stat, Table, Text, UIComponentType, VStack } from '@elaraai/east-ui';",
+        "import { Data, Func, Record } from '@elaraai/e3-ui';",
+        "import e3, { type Runner } from '@elaraai/e3';",
+        "import { Nav, Page, PageLink } from '@elaraai/e3-cloud-ui';"
+      ],
+      "languages": [
+        "tsx"
+      ],
+      "source": "// A page's body that reads an input and writes it back from a slider: what Page('overview', { title: 'Overview' }, () => …) takes\n// inputs: []\n/** An input people set from a page. */\nconst target = e3.input('target', FloatType, variant('value', 100.0));\n\nEast.function([], UIComponentType, _$ => (\n    <Reactive>{$ => {\n      const t = $.let(Data.bind(target));\n      return (\n        <VStack gap=\"3\" align=\"stretch\">\n          <Stat label=\"Target\" value={East.print(t.read())} />\n          <Slider value={t.read()} min={0} max={200} onChangeEnd={t.write} />\n        </VStack>\n      );\n    }}</Reactive>\n  ))"
+    },
+    {
+      "id": "e3-cloud-ui:pages.examples.tsx:pageWithParams",
+      "skill": "e3-cloud-ui",
+      "package": "e3-cloud-ui",
+      "file": "packages/e3-cloud-ui/test/pages.examples.tsx",
+      "suite": "Params",
+      "test": "A page's body that takes params: its one argument, a struct for several. A link or Nav.go to the page gives them, and the page's URL carries them",
+      "keywords": [
+        "Page",
+        "params",
+        "argument",
+        "struct",
+        "PageDef",
+        "body"
+      ],
+      "imports": [
+        "import { East, ArrayType, DictType, FloatType, NullType, StringType, StructType, example, variant } from '@elaraai/east';",
+        "import { Button, HStack, Reactive, Slider, Stat, Table, Text, UIComponentType, VStack } from '@elaraai/east-ui';",
+        "import { Data, Func, Record } from '@elaraai/e3-ui';",
+        "import e3, { type Runner } from '@elaraai/e3';",
+        "import { Nav, Page, PageLink } from '@elaraai/e3-cloud-ui';"
+      ],
+      "languages": [
+        "tsx"
+      ],
+      "source": "// A page's body that takes params: its one argument, a struct for several. A link or Nav.go to the page gives them, and the page's URL carries them\n// inputs: [{ site: 'Northgate', line: 'L1' }]\nconst LineKey = StructType({ site: StringType, line: StringType });\n\nEast.function([LineKey], UIComponentType, (_$, key) => (\n    <VStack gap=\"2\" align=\"stretch\">\n      <Text>{East.str`Site ${key.site}`}</Text>\n      <Text>{East.str`Line ${key.line}`}</Text>\n    </VStack>\n  ))"
+    },
+    {
+      "id": "e3-cloud-ui:pages.examples.tsx:pageLinksToAPageWithParams",
+      "skill": "e3-cloud-ui",
+      "package": "e3-cloud-ui",
+      "file": "packages/e3-cloud-ui/test/pages.examples.tsx",
+      "suite": "Between pages",
+      "test": "A link to another page of the app for each line, each carrying the line as the target page's params. A page that takes no params is linked without them: <PageLink to={overview}>",
+      "keywords": [
+        "PageLink",
+        "link",
+        "to",
+        "params",
+        "Page",
+        "navigation",
+        "list"
+      ],
+      "imports": [
+        "import { East, ArrayType, DictType, FloatType, NullType, StringType, StructType, example, variant } from '@elaraai/east';",
+        "import { Button, HStack, Reactive, Slider, Stat, Table, Text, UIComponentType, VStack } from '@elaraai/east-ui';",
+        "import { Data, Func, Record } from '@elaraai/e3-ui';",
+        "import e3, { type Runner } from '@elaraai/e3';",
+        "import { Nav, Page, PageLink } from '@elaraai/e3-cloud-ui';"
+      ],
+      "languages": [
+        "tsx"
+      ],
+      "source": "// A link to another page of the app for each line, each carrying the line as the target page's params. A page that takes no params is linked without them: <PageLink to={overview}>\n// inputs: []\nconst LineKey = StructType({ site: StringType, line: StringType });\n\n/** The production lines, each a site and a line. */\nconst lines = e3.input('lines', ArrayType(LineKey), variant('value', []));\n\n/** A page that takes params: one line's, a struct. */\nconst linePage = Page('line', { title: 'Line', icon: 'gears' },\n  () => East.function([LineKey], UIComponentType, (_$, key) => (\n    <Text>{East.str`${key.site} · ${key.line}`}</Text>\n  )));\n\nEast.function([], UIComponentType, _$ => (\n    <Reactive>{$ => {\n      const ls = $.let(Data.bind(lines));\n      return (\n        <VStack gap=\"2\" align=\"flex-start\">\n          {ls.read().map(($, key) => (\n            <PageLink to={linePage} params={key}>{East.str`${key.site} · ${key.line}`}</PageLink>\n          ))}\n        </VStack>\n      );\n    }}</Reactive>\n  ))"
+    },
+    {
+      "id": "e3-cloud-ui:pages.examples.tsx:pageGoesToAPageOnRowClick",
+      "skill": "e3-cloud-ui",
+      "package": "e3-cloud-ui",
+      "file": "packages/e3-cloud-ui/test/pages.examples.tsx",
+      "suite": "Between pages",
+      "test": "Going to another page from an event: Nav.go(page, params) when a table's row is clicked, the row's line as the target's params",
+      "keywords": [
+        "Nav.go",
+        "Nav",
+        "navigate",
+        "Table",
+        "onRowClick",
+        "params",
+        "Page"
+      ],
+      "imports": [
+        "import { East, ArrayType, DictType, FloatType, NullType, StringType, StructType, example, variant } from '@elaraai/east';",
+        "import { Button, HStack, Reactive, Slider, Stat, Table, Text, UIComponentType, VStack } from '@elaraai/east-ui';",
+        "import { Data, Func, Record } from '@elaraai/e3-ui';",
+        "import e3, { type Runner } from '@elaraai/e3';",
+        "import { Nav, Page, PageLink } from '@elaraai/e3-cloud-ui';"
+      ],
+      "languages": [
+        "tsx"
+      ],
+      "source": "// Going to another page from an event: Nav.go(page, params) when a table's row is clicked, the row's line as the target's params\n// inputs: []\nconst LineKey = StructType({ site: StringType, line: StringType });\n\n/** The production lines, each a site and a line. */\nconst lines = e3.input('lines', ArrayType(LineKey), variant('value', []));\n\n/** A page that takes params: one line's, a struct. */\nconst linePage = Page('line', { title: 'Line', icon: 'gears' },\n  () => East.function([LineKey], UIComponentType, (_$, key) => (\n    <Text>{East.str`${key.site} · ${key.line}`}</Text>\n  )));\n\nEast.function([], UIComponentType, _$ => (\n    <Reactive>{$ => {\n      const rows = $.let(Data.bind(lines).read());\n      // Bound once, so a render passes the same handler\n      const open = $.const(East.function([Table.Types.RowClickEvent], NullType, ($, e) => {\n        const r = $.let(rows.get(e.rowIndex));\n        $(Nav.go(linePage, { site: r.site, line: r.line }));\n      }));\n      return <Table data={rows} columns={['site', 'line']} onRowClick={open} />;\n    }}</Reactive>\n  ))"
+    },
+    {
+      "id": "e3-cloud-ui:pages.examples.tsx:pageGoesBack",
+      "skill": "e3-cloud-ui",
+      "package": "e3-cloud-ui",
+      "file": "packages/e3-cloud-ui/test/pages.examples.tsx",
+      "suite": "Between pages",
+      "test": "Going back, as the browser's Back does: Nav.back() from a button",
+      "keywords": [
+        "Nav.back",
+        "Nav",
+        "back",
+        "Button",
+        "history"
+      ],
+      "imports": [
+        "import { East, ArrayType, DictType, FloatType, NullType, StringType, StructType, example, variant } from '@elaraai/east';",
+        "import { Button, HStack, Reactive, Slider, Stat, Table, Text, UIComponentType, VStack } from '@elaraai/east-ui';",
+        "import { Data, Func, Record } from '@elaraai/e3-ui';",
+        "import e3, { type Runner } from '@elaraai/e3';",
+        "import { Nav, Page, PageLink } from '@elaraai/e3-cloud-ui';"
+      ],
+      "languages": [
+        "tsx"
+      ],
+      "source": "// Going back, as the browser's Back does: Nav.back() from a button\n// inputs: [{ site: 'Northgate', line: 'L1' }]\nconst LineKey = StructType({ site: StringType, line: StringType });\n\nEast.function([LineKey], UIComponentType, (_$, key) => (\n    <HStack gap=\"2\">\n      <Text>{East.str`${key.site} · ${key.line}`}</Text>\n      <Button variant=\"ghost\" onClick={East.function([], NullType, $ => { $(Nav.back()); })}>Back</Button>\n    </HStack>\n  ))"
+    },
+    {
+      "id": "e3-cloud-ui:pages.examples.tsx:pageCallsAFunction",
+      "skill": "e3-cloud-ui",
+      "package": "e3-cloud-ui",
+      "file": "packages/e3-cloud-ui/test/pages.examples.tsx",
+      "suite": "Functions and records",
+      "test": "Calling a function of the package from a page: Func.bind(adjust), its call on a click and its pending state while the call runs",
+      "keywords": [
+        "Func.bind",
+        "call",
+        "function",
+        "e3.function",
+        "pending",
+        "Button"
+      ],
+      "imports": [
+        "import { East, ArrayType, DictType, FloatType, NullType, StringType, StructType, example, variant } from '@elaraai/east';",
+        "import { Button, HStack, Reactive, Slider, Stat, Table, Text, UIComponentType, VStack } from '@elaraai/east-ui';",
+        "import { Data, Func, Record } from '@elaraai/e3-ui';",
+        "import e3, { type Runner } from '@elaraai/e3';",
+        "import { Nav, Page, PageLink } from '@elaraai/e3-cloud-ui';"
+      ],
+      "languages": [
+        "tsx"
+      ],
+      "source": "// Calling a function of the package from a page: Func.bind(adjust), its call on a click and its pending state while the call runs\n// inputs: [{ site: 'Northgate', line: 'L1' }]\n/** The runtime the package's functions run on. */\nconst RUNNER: Runner = { runtime: 'east-c', platforms: ['east-c-std'] };\n\nconst LineKey = StructType({ site: StringType, line: StringType });\n\n/** A function a page calls. */\nconst adjust = e3.function('adjust',\n  East.function([LineKey, FloatType], FloatType, (_$, _key, pct) => pct.add(1.0)),\n  { runner: RUNNER });\n\nEast.function([LineKey], UIComponentType, (_$, key) => (\n    <Reactive>{$ => {\n      const run = $.let(Func.bind(adjust));\n      const adjustByFive = $.const(East.function([], NullType, $ => { $(run.call(key, 5.0)); }));\n      return <Button loading={run.pending()} onClick={adjustByFive}>Adjust by 5%</Button>;\n    }}</Reactive>\n  ))"
+    },
+    {
+      "id": "e3-cloud-ui:pages.examples.tsx:pageMutatesARecord",
+      "skill": "e3-cloud-ui",
+      "package": "e3-cloud-ui",
+      "file": "packages/e3-cloud-ui/test/pages.examples.tsx",
+      "suite": "Functions and records",
+      "test": "Changing a record from a page: Record.bind(orders, [approve]) names the mutations the page may run, and o.mutate.approve(id) commits one",
+      "keywords": [
+        "Record.bind",
+        "mutate",
+        "mutation",
+        "record",
+        "e3.record",
+        "Button",
+        "commit"
+      ],
+      "imports": [
+        "import { East, ArrayType, DictType, FloatType, NullType, StringType, StructType, example, variant } from '@elaraai/east';",
+        "import { Button, HStack, Reactive, Slider, Stat, Table, Text, UIComponentType, VStack } from '@elaraai/east-ui';",
+        "import { Data, Func, Record } from '@elaraai/e3-ui';",
+        "import e3, { type Runner } from '@elaraai/e3';",
+        "import { Nav, Page, PageLink } from '@elaraai/e3-cloud-ui';"
+      ],
+      "languages": [
+        "tsx"
+      ],
+      "source": "// Changing a record from a page: Record.bind(orders, [approve]) names the mutations the page may run, and o.mutate.approve(id) commits one\n// inputs: []\n/** The runtime the package's functions run on. */\nconst RUNNER: Runner = { runtime: 'east-c', platforms: ['east-c-std'] };\n\nconst Order = StructType({ line: StringType, qty: FloatType, status: StringType });\n\n/** A record of orders, changed only through its mutations. */\nconst orders = e3.record('orders', DictType(StringType, Order), new Map());\n\n/** Approves an order by its id. */\nconst approve = e3.mutation.reduce('approve', orders,\n  East.function([DictType(StringType, Order), StringType], DictType(StringType, Order), (_$, all, _id) => all),\n  { runner: RUNNER });\n\nEast.function([], UIComponentType, _$ => (\n    <Reactive>{$ => {\n      const o = $.let(Record.bind(orders, [approve]));\n      const approveA17 = $.const(East.function([], NullType, $ => { $(o.mutate.approve('A-17')); }));\n      return <Button onClick={approveA17}>Approve A-17</Button>;\n    }}</Reactive>\n  ))"
+    },
+    {
+      "id": "e3-cloud-ui:pages.examples.tsx:pageReadsARecordThroughAnIndex",
+      "skill": "e3-cloud-ui",
+      "package": "e3-cloud-ui",
+      "file": "packages/e3-cloud-ui/test/pages.examples.tsx",
+      "suite": "Functions and records",
+      "test": "Reading a record through one of its indexes, a page at a time: Data.bindPaged(orders, { index: byLine }) given the index's declaration, its rows the index key and the order's id",
+      "keywords": [
+        "Data.bindPaged",
+        "index",
+        "recordIndex",
+        "record",
+        "paged",
+        "Table",
+        "ik",
+        "key"
+      ],
+      "imports": [
+        "import { East, ArrayType, DictType, FloatType, NullType, StringType, StructType, example, variant } from '@elaraai/east';",
+        "import { Button, HStack, Reactive, Slider, Stat, Table, Text, UIComponentType, VStack } from '@elaraai/east-ui';",
+        "import { Data, Func, Record } from '@elaraai/e3-ui';",
+        "import e3, { type Runner } from '@elaraai/e3';",
+        "import { Nav, Page, PageLink } from '@elaraai/e3-cloud-ui';"
+      ],
+      "languages": [
+        "tsx"
+      ],
+      "source": "// Reading a record through one of its indexes, a page at a time: Data.bindPaged(orders, { index: byLine }) given the index's declaration, its rows the index key and the order's id\n// inputs: []\nconst Order = StructType({ line: StringType, qty: FloatType, status: StringType });\n\n/** A record of orders, changed only through its mutations. */\nconst orders = e3.record('orders', DictType(StringType, Order), new Map());\n\n/** The orders by line. */\nconst byLine = e3.recordIndex('by_line', orders,\n  { key: East.function([StringType, Order], StringType, (_$, _id, o) => o.line) });\n\nEast.function([], UIComponentType, _$ => (\n    <Reactive>{$ => {\n      const mine = $.let(Data.bindPaged(orders, { index: byLine }));\n      return <Table data={mine} columns={['ik', 'key']} />;\n    }}</Reactive>\n  ))"
+    },
+    {
+      "id": "e3-cloud-ui:static:app",
+      "skill": "e3-cloud-ui",
+      "package": "e3-cloud-ui",
+      "file": "static",
+      "suite": "App",
+      "test": "An app: its pages, a ui() task's output as a page, its menu's groups, its home and the package it was built against",
+      "keywords": [
+        "App",
+        "Page",
+        "Page.task",
+        "Menu",
+        "Menu.group",
+        "home",
+        "pages",
+        "menu",
+        "package",
+        "title",
+        "logo",
+        "icon",
+        "parent",
+        "app",
+        "e3-cloud-ui"
+      ],
+      "imports": [
+        "import { East, FloatType, variant } from '@elaraai/east';",
+        "import { Reactive, Slider, Stat, UIComponentType, VStack } from '@elaraai/east-ui';",
+        "import { Data } from '@elaraai/e3-ui';",
+        "import e3 from '@elaraai/e3';",
+        "import { App, Menu, Page, PageLink } from '@elaraai/e3-cloud-ui';"
+      ],
+      "source": "// src/apps/ops.tsx: the package's declarations are imported from the solution's package\nconst target = e3.input('target', FloatType, variant('value', 100.0));\nconst acme = e3.package('acme', '1.5.0', /* its tasks, inputs, functions and records */ target);\n\n// A page: a name (its URL segment), what the sidebar and crumbs show, and its\n// body as a thunk, so pages can link to pages declared after them\nconst overview = Page('overview', { title: 'Overview', icon: 'gauge-high' },\n  () => East.function([], UIComponentType, _$ => (\n    <Reactive>{$ => {\n      const t = $.let(Data.bind(target));\n      return <VStack><Stat label=\"Target\" value={East.print(t.read())} /><Slider value={t.read()} min={0} max={200} onChangeEnd={t.write} /></VStack>;\n    }}</Reactive>\n  )));\n\n// A page under another: its crumbs name the parent, and the sidebar lights the parent's item\nconst settings = Page('settings', { title: 'Settings', icon: 'sliders', parent: overview },\n  () => East.function([], UIComponentType, _$ => <PageLink to={overview}>Back to the overview</PageLink>));\n\n// The app: deployed to one workspace, apart from the package, which must run (or be deployed with) acme@1.5.0\nexport default App('ops', {\n  package: acme,\n  title: 'Acme Operations',\n  home: overview,\n  menu: [Menu.group('Analyse', [overview]), Menu.group([settings])],   // a group with no label shows none\n  pages: [overview, settings],\n});",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-ui:static:page-task",
+      "skill": "e3-cloud-ui",
+      "package": "e3-cloud-ui",
+      "file": "static",
+      "suite": "Page.task",
+      "test": "A ui() task's output as a page: the dataflow computes it, the app shows it",
+      "keywords": [
+        "Page.task",
+        "ui",
+        "task",
+        "output",
+        "UIComponentType",
+        "page"
+      ],
+      "imports": [
+        "import { East, ArrayType } from '@elaraai/east';",
+        "import { Table, UIComponentType } from '@elaraai/east-ui';",
+        "import { ui } from '@elaraai/e3-ui';",
+        "import { Page } from '@elaraai/e3-cloud-ui';"
+      ],
+      "source": "// The task is the package's: a ui() task returning UIComponentType from its inputs\nconst board = ui('board', [forecast.output], East.function([ArrayType(Forecast)], UIComponentType, (_$, rows) => (\n  <Table data={rows} columns={['site', 'line', 'units']} />\n)));\n// The page shows the task's latest output; its app's checks hold the task to being a ui() task of the package\nconst boardPage = Page.task('board', board, { title: 'Board', icon: 'table-columns' });",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-ui:static:build",
+      "skill": "e3-cloud-ui",
+      "package": "e3-cloud-ui",
+      "file": "static",
+      "suite": "buildApp",
+      "test": "Building the bundle an app deploy uploads: the app object and its package's zip, as e3's export writes it; a refusal names what is wrong",
+      "keywords": [
+        "buildApp",
+        "exportApp",
+        "AppBuildError",
+        "bundle",
+        "AppBundle",
+        "build",
+        "app object",
+        "package zip",
+        "e3-cloud app build"
+      ],
+      "imports": [
+        "import { AppBuildError, buildApp, exportApp } from '@elaraai/e3-cloud-ui';"
+      ],
+      "source": "import ops from './apps/ops.js';\n\ntry {\n  const bundle = await buildApp(ops);              // { app, package }: the app object (AppType) and the package's zip\n  console.log(bundle.app.name, bundle.app.pages.length, bundle.app.builtWith);\n  await exportApp(ops, 'dist/ops.app');            // the same bundle, written where `e3-cloud app deploy` reads it\n} catch (err) {\n  if (err instanceof AppBuildError) console.error(err.message);   // a page that does not build, a duplicate name, a menu naming no page…\n  else throw err;\n}",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-ui:static:check",
+      "skill": "e3-cloud-ui",
+      "package": "e3-cloud-ui",
+      "file": "static",
+      "suite": "checkApp",
+      "test": "Checking an app against a package before deploying it: every page's binds against what the package declares, and the e3 it was built with",
+      "keywords": [
+        "checkApp",
+        "check",
+        "problems",
+        "AppProblem",
+        "bundlePackageView",
+        "dry run",
+        "binds",
+        "types"
+      ],
+      "imports": [
+        "import { buildApp, bundlePackageView } from '@elaraai/e3-cloud-ui';",
+        "import { checkApp } from '@elaraai/e3-cloud-ui/check';"
+      ],
+      "source": "const bundle = await buildApp(ops);\n// The package the app was built against, read from the bundle; null: no platform's e3 to hold it to\nconst problems = checkApp(bundle.app, await bundlePackageView(bundle), { e3Version: null });\nfor (const problem of problems) console.log(problem.type);   // dataset_missing, dataset_type, function_missing, record_mutation_missing, task_not_ui, …\n// The server runs the same checks at every deploy: `e3-cloud app deploy … --dry-run` answers them without deploying",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-cli:static:sign-in",
+      "skill": "e3-cloud-cli",
+      "package": "e3-cloud-cli",
+      "file": "static",
+      "suite": "e3-cloud",
+      "test": "Signing in to a deployment, and who you are there: the e3 CLI's sign-in (`e3 auth login`; there is no `e3 login`), whose credentials the e3-cloud CLI shares",
+      "keywords": [
+        "login",
+        "sign in",
+        "e3 auth login",
+        "auth",
+        "whoami",
+        "token",
+        "credentials",
+        "server",
+        "e3-cloud"
+      ],
+      "imports": [],
+      "source": "npm install -g @elaraai/e3-cloud-cli @elaraai/e3-cli\ne3 auth login https://e3.example.com     # the device flow; e3-cloud reads the same credentials\ne3-cloud whoami https://e3.example.com   # your identity there, and whether you are an admin",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-cli:static:app-deploy",
+      "skill": "e3-cloud-cli",
+      "package": "e3-cloud-cli",
+      "file": "static",
+      "suite": "e3-cloud app",
+      "test": "Building and deploying apps: a bundle per app, deployed to a workspace; UI-only when the workspace runs its package, else with it",
+      "keywords": [
+        "app build",
+        "app deploy",
+        "app list",
+        "app versions",
+        "app remove",
+        "bundle",
+        "--from-source",
+        "--dry-run",
+        "with package",
+        "ui only",
+        "deploy",
+        "--force",
+        "protected",
+        "workspace_protected",
+        "develop",
+        "preview",
+        "iterate"
+      ],
+      "imports": [],
+      "source": "# Apps are developed in the cloud, not locally: deploy each change to a workspace of your own (here staging) and open it in the console\ne3-cloud app build src/apps/ops.tsx                          # → dist/ops.app: the app and the package it was built against\ne3-cloud app deploy https://e3.example.com/repos/acme staging dist/ops.app --dry-run   # the checks, nothing deployed\ne3-cloud app deploy https://e3.example.com/repos/acme staging dist/ops.app             # live at once when staging runs its package;\n                                                               # else its package deploys first (people's edited inputs kept) and it goes live as that completes\ne3-cloud app deploy https://e3.example.com/repos/acme staging --from-source src/apps/ops.tsx src/apps/exec.tsx   # several, together\ne3-cloud app list https://e3.example.com/repos/acme staging\ne3-cloud app versions https://e3.example.com/repos/acme staging ops      # kept versions, newest first\ne3-cloud app remove https://e3.example.com/repos/acme staging ops\n# A protected workspace (one with a staging) refuses a deploy and a removal: deploy to its staging and release.\n# An admin alone forces one past it, warned first, its history recording it as forced:\ne3-cloud app deploy https://e3.example.com/repos/acme production dist/ops.app --force",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-cli:static:for-platform",
+      "skill": "e3-cloud-cli",
+      "package": "e3-cloud-cli",
+      "file": "static",
+      "suite": "e3-cloud app --for-platform",
+      "test": "Before a platform upgrade: stage each app's bundle built with the next e3, which the platform deploy switches live",
+      "keywords": [
+        "for-platform",
+        "stage",
+        "platform upgrade",
+        "e3 version",
+        "list-all",
+        "needs rebuild",
+        "builtWith"
+      ],
+      "imports": [],
+      "source": "e3-cloud app list-all https://e3.example.com              # admin: every app, and which needs a bundle built with the platform's e3\n# after upgrading the project's @elaraai packages to the next release (1.0.88, say):\ne3-cloud app deploy https://e3.example.com/repos/acme production dist/ops.app --for-platform 1.0.88\n#   staged beside the live version; the platform deploy that moves to 1.0.88 refuses while an app has none staged",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-cli:static:release",
+      "skill": "e3-cloud-cli",
+      "package": "e3-cloud-cli",
+      "file": "static",
+      "suite": "e3-cloud release",
+      "test": "Staging to production: give production a staging (which protects it), copy production onto it, deploy a candidate there, then release exactly what staging runs; history and rollback",
+      "keywords": [
+        "release",
+        "rollback",
+        "history",
+        "copy",
+        "workspace copy",
+        "--plan",
+        "--carry",
+        "--remove-apps",
+        "staging",
+        "production",
+        "promote",
+        "protected",
+        "not_staging",
+        "nothing_to_release"
+      ],
+      "imports": [],
+      "source": "e3-cloud staging add https://e3.example.com/repos/acme production staging    # once: a copy of production; production is protected from then on\ne3 workspace copy https://e3.example.com/repos/acme production staging      # before each change: rehearse on production's data (the cloud copies the apps too)\ne3-cloud app deploy https://e3.example.com/repos/acme staging dist/ops.app # the candidate\ne3-cloud release https://e3.example.com/repos/acme staging production --plan   # package, apps, next-e3 bundles, records, inputs, carry, checks, forced changes it undoes; changes nothing\ne3-cloud release https://e3.example.com/repos/acme staging production --carry inputs/mappings\n#   only production's staging releases to it; one that would change nothing is refused;\n#   production gets staging's package and app versions by hash (and its bundles staged for the next e3), keeps the inputs people set in it, migrates its records;\n#   --carry copies inputs (and records new in the release) from staging; --remove-apps removes production's apps staging lacks\ne3-cloud history https://e3.example.com/repos/acme production              # each release, deploy, app deploy, copy, rollback, staging added or stopped, forced change, with its id\ne3-cloud rollback https://e3.example.com/repos/acme production --plan      # back to the newest entry that changed it and differs from what it runs (or name an id); open on a protected workspace",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-cli:static:staging",
+      "skill": "e3-cloud-cli",
+      "package": "e3-cloud-cli",
+      "file": "static",
+      "suite": "e3-cloud staging",
+      "test": "A workspace's staging, which protects it as a protected branch: add one (a copy, or a workspace as it stands), list them, stop one (admins alone)",
+      "keywords": [
+        "staging",
+        "staging add",
+        "staging stop",
+        "staging list",
+        "protected",
+        "protect",
+        "protection",
+        "--as-is",
+        "--replace",
+        "--force",
+        "workspace_protected",
+        "staging_conflict",
+        "live"
+      ],
+      "imports": [],
+      "source": "e3-cloud staging add https://e3.example.com/repos/acme production staging --plan   # what it would do; nothing changes\ne3-cloud staging add https://e3.example.com/repos/acme production staging          # a copy of production as it is now, data included\ne3-cloud staging add https://e3.example.com/repos/acme production uat --as-is      # a workspace there, as it stands (--replace copies over it instead; never unasked)\ne3-cloud staging list https://e3.example.com/repos/acme                            # each staging, and the workspace it protects\ne3-cloud staging stop https://e3.example.com/repos/acme production                 # admins alone: unprotects production, deletes nothing\n# One staging to a workspace, none of its own. A protected workspace changes only by a release from its staging, or a rollback:\n# e3's workspace deploy, an app deploy or removal (unless an admin's --force), a copy onto it and its removal are refused, naming its staging.\n# Its data goes on: inputs, records, runs, schedules.",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-cli:static:users",
+      "skill": "e3-cloud-cli",
+      "package": "e3-cloud-cli",
+      "file": "static",
+      "suite": "e3-cloud user",
+      "test": "A repository's people and business roles: owners, and users holding roles that grant apps and pages; the deployment's users for admins",
+      "keywords": [
+        "user",
+        "add",
+        "remove",
+        "list",
+        "role",
+        "roles",
+        "owner",
+        "business role",
+        "grant",
+        "--roles",
+        "--grant",
+        "invitation",
+        "disable",
+        "enable",
+        "list-all"
+      ],
+      "imports": [],
+      "source": "e3-cloud role set https://e3.example.com/repos/acme Rostering --grant production/workforce:shifts,roster   # a role: apps, every page or some\ne3-cloud role list https://e3.example.com/repos/acme\ne3-cloud user list https://e3.example.com/repos/acme\ne3-cloud user add https://e3.example.com/repos/acme ada@example.com --roles 'Rostering,All apps'   # a user: reaches only what the roles' pages bind\ne3-cloud user add https://e3.example.com/repos/acme lee@example.com --role owner\ne3-cloud user remove https://e3.example.com/repos/acme ada@example.com   # or takes back the invitation of someone not signed in yet\n# admins: the deployment's users, invitations, and sign-in\ne3-cloud user list-all https://e3.example.com\ne3-cloud user invitations https://e3.example.com\ne3-cloud user disable https://e3.example.com ada@example.com",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-cli:static:secrets",
+      "skill": "e3-cloud-cli",
+      "package": "e3-cloud-cli",
+      "file": "static",
+      "suite": "e3-cloud secrets",
+      "test": "A repository's secrets: values set write-only, read by task code with Env.get(\"NAME\")",
+      "keywords": [
+        "secrets",
+        "set",
+        "list",
+        "rm",
+        "Env.get",
+        "credentials",
+        "password",
+        "write-only"
+      ],
+      "imports": [],
+      "source": "printf %s \"$PG_PASSWORD\" | e3-cloud secrets set https://e3.example.com/repos/acme PG_PASSWORD   # from stdin, out of the shell's history\ne3-cloud secrets list https://e3.example.com/repos/acme     # names only: a value is never shown\ne3-cloud secrets rm https://e3.example.com/repos/acme PG_PASSWORD\n# task code reads it with Env.get(\"PG_PASSWORD\") (east-node-std); the next run reads a new value",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-cli:static:schedules",
+      "skill": "e3-cloud-cli",
+      "package": "e3-cloud-cli",
+      "file": "static",
+      "suite": "e3-cloud schedule",
+      "test": "A workspace's schedule: when its dataflow runs, and which tasks each run forces",
+      "keywords": [
+        "schedule",
+        "cron",
+        "timezone",
+        "force-tasks",
+        "set",
+        "get",
+        "list",
+        "remove",
+        "dataflow run"
+      ],
+      "imports": [],
+      "source": "e3-cloud schedule set https://e3.example.com/repos/acme/workspaces/production --cron \"0 6 * * 1-5\" --timezone Australia/Sydney \\\n  --force-tasks ingest_sales --description \"Weekday refresh before the stand-up\"\ne3-cloud schedule get https://e3.example.com/repos/acme/workspaces/production\ne3-cloud schedule list https://e3.example.com/repos/acme\ne3-cloud schedule remove https://e3.example.com/repos/acme/workspaces/production",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-cli:static:task-configs",
+      "skill": "e3-cloud-cli",
+      "package": "e3-cloud-cli",
+      "file": "static",
+      "suite": "e3-cloud compute / timeout",
+      "test": "Each task's compute size and timeout in a workspace",
+      "keywords": [
+        "compute",
+        "size",
+        "serverless",
+        "small",
+        "medium",
+        "large",
+        "xlarge",
+        "timeout",
+        "--regex",
+        "task config"
+      ],
+      "imports": [],
+      "source": "e3-cloud compute set https://e3.example.com/repos/acme/workspaces/production train_forecast --size medium   # serverless, small, medium, large, xlarge\ne3-cloud compute set https://e3.example.com/repos/acme/workspaces/production '^score_' --size large --regex\ne3-cloud timeout set https://e3.example.com/repos/acme/workspaces/production train_forecast --timeout 2h\ne3-cloud compute list https://e3.example.com/repos/acme/workspaces/production",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-cli:static:records",
+      "skill": "e3-cloud-cli",
+      "package": "e3-cloud-cli",
+      "file": "static",
+      "suite": "e3-cloud records",
+      "test": "A record's history, a commit's state, rolling back to a commit, and backups",
+      "keywords": [
+        "records",
+        "history",
+        "show",
+        "rollback",
+        "backup",
+        "backups",
+        "restore",
+        "backup-pull",
+        "commit",
+        "audit"
+      ],
+      "imports": [],
+      "source": "e3-cloud records list https://e3.example.com/repos/acme production\ne3-cloud records history https://e3.example.com/repos/acme production orders --limit 50\ne3-cloud records show https://e3.example.com/repos/acme production orders <commit> -o orders.beast2\ne3-cloud records backup https://e3.example.com/repos/acme production orders --note \"before the import\"\ne3-cloud records rollback https://e3.example.com/repos/acme production orders <commit>    # a new commit holding that state",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-cli:static:feedback",
+      "skill": "e3-cloud-cli",
+      "package": "e3-cloud-cli",
+      "file": "static",
+      "suite": "e3-cloud feedback",
+      "test": "Feedback people send from a workspace's pages: turn it on, list it, read a note and its screenshot, close it",
+      "keywords": [
+        "feedback",
+        "enable",
+        "disable",
+        "list",
+        "show",
+        "close",
+        "reopen",
+        "screenshot",
+        "notes"
+      ],
+      "imports": [],
+      "source": "e3-cloud feedback enable https://e3.example.com/repos/acme/workspaces/staging\ne3-cloud feedback list https://e3.example.com/repos/acme/workspaces/staging --status open\ne3-cloud feedback show https://e3.example.com/repos/acme/workspaces/staging 12 --screenshot fb-12.webp\ne3-cloud feedback close https://e3.example.com/repos/acme/workspaces/staging 12",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-client:static:basics",
+      "skill": "e3-cloud-client",
+      "package": "e3-cloud-client",
+      "file": "static",
+      "suite": "@elaraai/e3-cloud-client",
+      "test": "Driving a deployment from code: the server's origin and a token in every call; ApiError names a refusal",
+      "keywords": [
+        "whoami",
+        "addUser",
+        "RequestOptions",
+        "token",
+        "ApiError",
+        "role",
+        "client"
+      ],
+      "imports": [
+        "import { variant, none, some } from '@elaraai/east';",
+        "import { ApiError, addUser, whoami } from '@elaraai/e3-cloud-client';"
+      ],
+      "source": "const url = 'https://e3.example.com';\nconst options = { token: process.env.E3_TOKEN! };\nconst me = await whoami(url, options);\ntry {\n  await addUser(url, 'acme', { email: 'floor@example.com', role: variant('user', { roles: ['All apps'] }) }, options);\n} catch (err) {\n  if (err instanceof ApiError) console.error(err.code, err.message);   // forbidden, not_found, …\n  else throw err;\n}",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-client:static:app-deploy",
+      "skill": "e3-cloud-client",
+      "package": "e3-cloud-client",
+      "file": "static",
+      "suite": "@elaraai/e3-cloud-client apps",
+      "test": "Deploying an app from code: upload its object, deploy it, and wait for the deploy job when its package deploys with it",
+      "keywords": [
+        "appUpload",
+        "appDeploy",
+        "appDeployWait",
+        "encodeAppObject",
+        "deploying",
+        "live",
+        "refused",
+        "apps"
+      ],
+      "imports": [
+        "import { variant, none, some } from '@elaraai/east';",
+        "import { appDeploy, appDeployWait, appProblemsText, appUpload } from '@elaraai/e3-cloud-client';",
+        "import { buildApp, encodeAppObject } from '@elaraai/e3-cloud-ui';"
+      ],
+      "source": "const bundle = await buildApp(ops);\nconst source = await appUpload(url, 'acme', 'staging', 'ops', encodeAppObject(bundle.app), options);\nconst deployed = await appDeploy(url, 'acme', 'staging', 'ops', { source, forPlatform: none, dryRun: false }, options);\nif (deployed.type === 'refused') console.error(appProblemsText('Deploy refused', deployed.value, 'acme@1.5.0'));\nif (deployed.type === 'deploying') await appDeployWait(url, 'acme', 'staging', deployed.value.job, options);   // its package first, then live",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-client:static:release",
+      "skill": "e3-cloud-client",
+      "package": "e3-cloud-client",
+      "file": "static",
+      "suite": "@elaraai/e3-cloud-client releases",
+      "test": "Staging and releasing from code: add a staging (which protects its workspace), the plan first, then the release, its deploy job waited for; a workspace's history and a rollback",
+      "keywords": [
+        "releaseWorkspace",
+        "rollbackWorkspace",
+        "workspaceHistory",
+        "ReleasePlan",
+        "plan",
+        "carry",
+        "removeApps",
+        "releasing",
+        "released",
+        "refused",
+        "addStaging",
+        "stopStaging",
+        "staging",
+        "protected",
+        "undoes",
+        "not_staging",
+        "nothing_to_release"
+      ],
+      "imports": [
+        "import { variant, none, some } from '@elaraai/east';",
+        "import { addStaging, appDeployWait, releasePlanRefusalLines, releaseWorkspace, rollbackWorkspace, stopStaging, workspaceHistory } from '@elaraai/e3-cloud-client';"
+      ],
+      "source": "// Once: production's staging, a copy of it; production is protected from then on (stopStaging: admins alone)\nawait addStaging(url, 'acme', 'production', { name: 'staging', start: variant('copy', null), plan: false }, options);\nconst request = { from: 'staging', carry: ['inputs/mappings'], removeApps: false };   // only production's staging releases to it\nconst planned = await releaseWorkspace(url, 'acme', 'production', { ...request, plan: true }, options);\nconst plan = planned.type === 'releasing' ? planned.value.plan : planned.value;\nif (plan.problems.length > 0 || plan.checks.length > 0) throw new Error(releasePlanRefusalLines(plan).join('\\n'));   // nothing_to_release among them\nfor (const undone of plan.undoes) console.warn(`undoes ${undone.summary}`);   // changes an admin forced onto production\nconst released = await releaseWorkspace(url, 'acme', 'production', { ...request, plan: false }, options);\nif (released.type === 'releasing') await appDeployWait(url, 'acme', 'production', released.value.job, options);\nconst { entries } = await workspaceHistory(url, 'acme', 'production', options);   // newest first\nawait rollbackWorkspace(url, 'acme', 'production', { to: some(entries[1]!.id), plan: true }, options);",
+      "languages": [
+        "typescript"
+      ]
+    },
+    {
+      "id": "e3-cloud-client:static:configure",
+      "skill": "e3-cloud-client",
+      "package": "e3-cloud-client",
+      "file": "static",
+      "suite": "@elaraai/e3-cloud-client configuration",
+      "test": "Configuring a workspace from code: a secret, a schedule, and a task's compute size",
+      "keywords": [
+        "putSecret",
+        "setSchedule",
+        "setCompute",
+        "schedule",
+        "secret",
+        "compute",
+        "cron"
+      ],
+      "imports": [
+        "import { variant, none, some } from '@elaraai/east';",
+        "import { putSecret, setCompute, setSchedule } from '@elaraai/e3-cloud-client';"
+      ],
+      "source": "await putSecret(url, 'acme', 'PG_PASSWORD', process.env.PG_PASSWORD!, options);\nawait setSchedule(url, 'acme', 'production', { cronExpression: '0 6 * * 1-5', timezone: some('Australia/Sydney'), forceTasks: [], enabled: true, description: none }, options);\nawait setCompute(url, 'acme', 'production', 'train_forecast', variant('medium', null), options);",
+      "languages": [
+        "typescript"
+      ]
+    }
+  ]
+}