@ai-ecoverse/slicc-agent 3.25.2 → 3.27.0

package/README.md

@@ -30,7 +30,7 @@ await agent.prompt('What is in /home?');
 - `openOpfsSqliteStorage({ directory?, file? })` keeps the session in wasm SQLite ([`@sqlite.org/sqlite-wasm`](https://www.npmjs.com/package/@sqlite.org/sqlite-wasm)) in an `opfs-sahpool` pool, by default `/.slicc/agent/` in OPFS. It needs a dedicated worker. Only one worker holds a pool at a time: the opener takes a Web Lock per directory and waits until every file of the pool can be opened before sqlite-wasm installs it, because a failed install deletes the pool's directory. `openMemorySqliteStorage()` keeps the same database in memory.
 - `hostAgent(agent)` serves the agent with pi's protocol: a pi-server with one session, `agent`, whose Chord services are `slicc.agent.control` (send with `whenBusy` `steer`, `followUp` or `reject`, wait, withdraw, abort, compact) and `slicc.agent.transcript` (the conversation's durable view as replicated state, plus `deliveries`: how each user entry was delivered, `run`, `steer` or `follow-up`, derived by the host from where each send it accepted was placed: after a tool result it steered, queued first it's a follow-up or a late steer per its `whenBusy`, placed at once it started a run). `serveConnections(self, host)` hands it every `MessagePort` the page sends.
 - `@ai-ecoverse/slicc-agent/page` has what the page needs (`startAgent`, `connectAgent`) without the agent's runtime: no pi-durable, pi-ai, providers or SQLite, which load only in the worker. `@ai-ecoverse/slicc-agent/spectrum` is just as light, and a test keeps both that way.
-- `startAgent({ worker })` takes the Web Lock `slicc-agent`, so one tab at a time owns the agent worker, and waits while another tab holds it. `connect()` returns an `AgentConnection` (`control`, `transcript`, `prompt()`), `restart()` replaces the worker (durable resumes from SQLite), and `release()` stops it and lets the next tab take over.
+- `startAgent({ worker })` takes the Web Lock `slicc-agent`, so one tab at a time owns the agent worker, and waits while another tab holds it. `connect()` returns an `AgentConnection` (`control`, `transcript`, `prompt()`), `restart()` replaces the worker (durable resumes from SQLite), and `release()` stops it and lets the next tab take over. `port()` returns a raw `MessagePort` into the worker instead, for another tab: hand it over (through a SharedWorker, say), and that tab calls `connectAgent(port)`. A caller that already holds the lock passes `held: true`. A connection's `closed` resolves when its port ends (with the error, if any), and from then on its states keep their last values.
 
 ### Bash and files on slicc-kernel
 
@@ -209,7 +209,7 @@ The worker watches the roots and reloads on change. A `skills` prompt section, g
 
 **v6 skills.** None of the 29 skills SLICC v6 ships runs here unchanged. They name v6 paths (`/shared`, `/workspace`) or commands this kernel doesn't have. By what they wait for:
 - **Rewritten here:** `delegation` (now the `agent` skill), `automation` (now `licks`), `skill-authoring`, `sprinkles`, `welcome` and `transcript-export` (now `freezer show`).
-- **Memory:** `memory` is rewritten here (below); its `status`, `log`, `curate` and `dream` and the curation ledger are not ported. `gelatiere` is rewritten here (below), without `use-cases` and the www.sliccy.com catalog; `wiki` needs its `wiki` CLI.
+- **Memory:** `memory` is rewritten here (below); its `status`, `log`, `curate` and `dream` and the curation ledger are not ported. `gelatiere` is rewritten here (below), reading v6's www.sliccy.com catalog; `wiki` needs its `wiki` CLI.
 - **The tray hub, upskill or the Install/Update panel:** `upgrade` (`upgrade apply`, bios#70), `handoff`, `slicc`, `ssh`, `cherry`.
 - **A browser and CDP:** `playwright-cli` is rewritten as the `browser` skill (below); `computer` and `v86` don't apply.
 - **v6's JS realm, `.jsh` and `ipk` (slicc-kernel#68):** `jshd`, `mcp`, `workflows`, `package-execution`, `biome`, `ffmpeg`.
@@ -262,9 +262,16 @@ The `memory` section, read before every request, holds the first 200 lines (at m
   - at most 50 open;
   - dismissed and taken ids are never reopened.
 - `gelatiere deliver` sends each cone named in a suggestion's `cones` (or the first cone) one `sprinkle` lick with the action `gelatiere-suggestions`. The built-in `gelatiere` skill answers it with `sprinkle show suggestions`, and looks ids up in the store before installing or trying anything.
-- `gelatiere install <id>` is what a card's Install leads to. It installs [upskill](https://github.com/ai-ecoverse/gh-upskill) if it's missing (`command -v upskill || curl -fsSL …/install.sh | bash`, into `$PNPM_HOME`), runs `upskill <repo> --skill <name> --dest ~/.pi/agent/skills`, checks that the skill is there for the skills loader, and marks the suggestion taken. It refuses a skill that's already installed. In seven, upskill reaches GitHub through the page's fetch, which `raw.githubusercontent.com` and `api.github.com` allow with CORS; `GITHUB_TOKEN` raises GitHub's rate limit. Before anyone clicks, the card shows where the skill comes from: "Installs github from github.com/example/skills".
+- `gelatiere install <id>` is what a card's Install leads to. It installs [upskill](https://github.com/ai-ecoverse/gh-upskill) if it's missing (`command -v upskill || curl -fsSL …/install.sh | bash`, into `$PNPM_HOME`), runs `upskill <repo> [--path <folder>] (--skill <name> | --all) --dest-path ~/.pi/agent/skills`, checks that the skill (or, with `all`, at least one new skill) is there for the skills loader, and marks the suggestion taken. It refuses a single skill that's already installed. A `skill` suggestion may carry `path` (a folder in the repo) and `all: true` instead of `skill`. In seven, upskill reaches GitHub through the page's fetch, which `raw.githubusercontent.com` and `api.github.com` allow with CORS; `GITHUB_TOKEN` raises GitHub's rate limit. Before anyone clicks, the card shows where the skill comes from: "Installs github from github.com/example/skills".
 - `gelatiere run`, `list [--all] [--json]`, `dismiss <id>` and `status` complete the command.
-- The gelatiere doesn't read the www.sliccy.com skill catalog or use-case pages, and doesn't consolidate other agents' memory, which only cones and the user write.
+- `gelatiere catalog [--refresh] [--all] [--json]` reads v6's catalog: `https://www.sliccy.com/skills/catalog.json`, the company's `<slug>.json` and the optional `use-cases.json`. Each is the Edge Delivery sheet shape `{ data: [rows] }` with string fields.
+  - Skill rows have `name`, `displayName`, `description`, `repo`, `path`, `skill`, `installAll`, the affinity lists `apps`, `tasks`, `role` and `purpose`, and `boost`. Use-case rows have `name`, `displayName`, `description`, `prompt`, `skills`, the same affinity lists and `boost`.
+  - It ranks rows as v6 does (apps ×3, tasks ×2, role +1, purpose +1, all times `boost`; rows that score 0 are dropped unless `--all`) against the welcome profile, which the welcome card's `onboarding-complete` writes to `/home/.welcome.json`. Without a profile the ranking is `boost` alone.
+  - The company slug is v6's `slugifyCompany` of the profile's `company`; company rows replace global ones of the same `name`.
+  - Skills the agent has loaded (from any skills root) or that sit in `~/.pi/agent/skills`, and dismissed or taken ids (`catalog-<name>`, `catalog-use-<name>`) are left out. `--json` prints candidates the gelatiere can pass to `gelatiere suggest` as they are.
+  - Each file is cached in `/home/.gelatiere/catalog/` and fetched again after 12 hours or with `--refresh`, through the agent's fetch (the kernel transport). A 404 is cached as empty. Offline or on an error the cached copy is used, and with none the pass goes on without a catalog.
+  - www.sliccy.com must send `Access-Control-Allow-Origin` for `/skills/*.json` for the plain browser transport; the extension, slicc-node and the proxy routes don't need it. `runAgentWorker({ catalog })` changes the base URL.
+- The gelatiere doesn't consolidate other agents' memory, which only cones and the user write.
 
 **The panel.** The transcript service adds `memories` and `memoryScopes`, and `AgentControl` `memorySave` and `memoryRemove`; `createAgentModel()` returns a `MemoryAdapter` for spectrum's `MemoryPort`, with `scopes()` (global, cones, roles) for its picker. `memory show [<scope>]` and `memory scopes` in bash print the same files, and the built-in `memory` skill teaches all of it.
 
@@ -360,14 +367,14 @@ A sprinkle is a small HTML panel next to the chat. pi has nothing for this; it's
 v6's `open`, `reload`, `close`, `send` and `chat` answer with what to do instead.
 
 **Shipped sprinkles.** Only `welcome` and `suggestions`, with slicc-spectrum's reviewed copy.
-- **Welcome.** The worker posts it inline in the first cone's chat once per session. Its `onboarding-complete` send writes `/home/.welcomed`, which the card checks, and the built-in `welcome` skill answers the lick.
+- **Welcome.** The worker posts it inline in the first cone's chat once per session. Its `onboarding-complete` send writes `/home/.welcomed`, which the card checks, and the profile to `/home/.welcome.json` for the gelatiere's catalog ranking, and the built-in `welcome` skill answers the lick.
 - **Suggestions.** It's listed once the gelatiere's store `/home/.gelatiere/suggestions.json` exists, and owned by the active cone. Its `gelatiere-dismiss` send marks the suggestion in the store and never reaches an agent; `gelatiere-install` and `gelatiere-try` mark it taken and go to the owner as licks. Its `exec` for use cases is refused, so it shows its static empty state.
 
 The built-in `sprinkles` skill teaches the files, the bridge and the command.
 
 ## The kernel
 
-`@ai-ecoverse/slicc-kernel` is a peer dependency (`>=1.26.3 <2`; older kernels have an IPv6-to-loopback security bug): the agent only calls `attachKernel`, the client end of the page kernel's port, so it must match the kernel the page runs. Seven chooses that version: slicc-bios pins the certified kernel next to the agent in `src/packages/agent/package.json`, and pnpm fills the peer from that pin. The devDependency is the lowest certified kernel the range allows (1.26.3), and the unit and integration tests run on it. A second CI job reruns the integration tests on the newest certified kernel (`NEWEST_CERTIFIED_KERNEL` in `.github/workflows/ci.yml`). Today the floor is 1.26.3 and the newest certified kernel 1.30.0; the second job moves by hand to each newer certified kernel, so both ends of the range are tested. If the port protocol ever breaks within 1.x, a patch release narrows the upper bound. Renovate opens PRs for the kernel, `wasi-pnpm`, the `wasm-*` packages and `slicc-cdp` but never merges them, because they move only after the homescoop coordinator certifies them.
+`@ai-ecoverse/slicc-kernel` is a peer dependency (`>=1.26.3 <2`; older kernels have an IPv6-to-loopback security bug): the agent only calls `attachKernel`, the client end of the page kernel's port, so it must match the kernel the page runs. Seven chooses that version: slicc-bios pins the certified kernel next to the agent in `src/packages/agent/package.json`, and pnpm fills the peer from that pin. The devDependency is the lowest certified kernel the range allows (1.26.3), and the unit and integration tests run on it. A second CI job reruns the integration tests on the newest certified kernel (`NEWEST_CERTIFIED_KERNEL` in `.github/workflows/ci.yml`). Today the floor is 1.26.3 and the newest certified kernel 1.40.1; the second job moves by hand to each newer certified kernel, so both ends of the range are tested. If the port protocol ever breaks within 1.x, a patch release narrows the upper bound. Renovate opens PRs for the kernel, `wasi-pnpm`, the `wasm-*` packages and `slicc-cdp` but never merges them, because they move only after the homescoop coordinator certifies them.
 
 ## Patched dependencies
 

package/dist/client.js

@@ -90,6 +90,13 @@ async function connectAgent(endpoint, options = {}) {
     held.push(kept);
     return kept.state;
   };
+  const freeze = () => {
+    for (const kept of held) kept.freeze();
+  };
+  const closed = channel.ended.then((reason) => {
+    freeze();
+    return reason;
+  });
   return {
     serverId,
     control,
@@ -104,6 +111,7 @@ async function connectAgent(endpoint, options = {}) {
     frozen: hold(frozen),
     changes: hold(changes),
     settings: lastingSettings(settings, hold),
+    closed,
     async prompt(text, whenBusy = "followUp") {
       const sent = await control.send({ text, whenBusy, requestId: null }, context);
       if (!sent.accepted) throw new Error(`${sent.error.code}: ${sent.error.message}`);
@@ -112,7 +120,7 @@ async function connectAgent(endpoint, options = {}) {
       return settled.text;
     },
     async close() {
-      for (const kept of held) kept.freeze();
+      freeze();
       await server.use(AgentSessions).detach(context);
       await session.dispose(context);
       await server.dispose(context);

package/dist/client.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/client.ts"],
-  "sourcesContent": ["import {\n  type Context,\n  createRemoteServiceBinding,\n  type ReplicatedState,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport { Client, createClientServiceTransport } from '@earendil-works/pi-client';\nimport type { ConversationView } from '@earendil-works/pi-durable';\nimport type { ChangesView } from './changes/git.ts';\nimport type { FrozenCone } from './freezer/index.ts';\nimport type { MemoryEntry, MemoryScope } from './memory/format.ts';\nimport {\n  AGENT_SESSION,\n  AgentControl,\n  AgentSessions,\n  AgentSettings,\n  type AgentsSummary,\n  AgentTranscript,\n  type Command,\n  type Delivered,\n  type SendMode,\n} from './services.ts';\nimport type { Sprinkle } from './sprinkles/kind.ts';\nimport { PortChannel, type PortEndpoint } from './wire.ts';\n\nexport interface AgentConnection {\n  readonly serverId: string;\n  readonly control: AgentControl;\n  readonly transcript: ReplicatedState<ConversationView>;\n  readonly deliveries: ReplicatedState<Record<string, Delivered>>;\n  readonly agents?: ReplicatedState<AgentsSummary>;\n  readonly views?: ReplicatedState<Record<string, ConversationView>>;\n  readonly commands?: ReplicatedState<Command[]>;\n  readonly sprinkles?: ReplicatedState<Sprinkle[]>;\n  readonly memories?: ReplicatedState<MemoryEntry[]>;\n  readonly memoryScopes?: ReplicatedState<MemoryScope[]>;\n  readonly frozen?: ReplicatedState<FrozenCone[]>;\n  readonly changes?: ReplicatedState<ChangesView>;\n  readonly settings: AgentSettings;\n  prompt(text: string, whenBusy?: SendMode): Promise<string>;\n  close(): Promise<void>;\n}\n\nexport interface Lasting<T> {\n  readonly state: ReplicatedState<T>;\n  freeze(): void;\n}\n\nexport function lasting<T>(state: ReplicatedState<T>): Lasting<T> {\n  let last: T | undefined;\n  let frozen = false;\n  const read = () => {\n    if (frozen) return last;\n    try {\n      last = state.value;\n    } catch {}\n    return last;\n  };\n  return {\n    state: {\n      get value() {\n        return read();\n      },\n      subscribe: (listener) => (frozen ? () => undefined : state.subscribe(listener)),\n    },\n    freeze() {\n      read();\n      frozen = true;\n    },\n  };\n}\n\nfunction lastingSettings(\n  settings: AgentSettings,\n  hold: <T>(state: ReplicatedState<T>) => ReplicatedState<T>\n): AgentSettings {\n  return {\n    state: hold(settings.state),\n    connect: (providerId, secret, region, context) =>\n      settings.connect(providerId, secret, region, context),\n    disconnect: (providerId, context) => settings.disconnect(providerId, context),\n    signIn: (providerId, context) => settings.signIn(providerId, context),\n  };\n}\n\nfunction attached(client: Client): Promise<void> {\n  return new Promise((resolve) => {\n    const stop = client.onAttachmentChange(() => {\n      stop();\n      resolve();\n    });\n  });\n}\n\nexport async function connectAgent(\n  endpoint: PortEndpoint,\n  options: { context?: Context } = {}\n): Promise<AgentConnection> {\n  const context = options.context ?? BACKGROUND_CONTEXT;\n  const channel = new PortChannel(endpoint);\n  const serverId = await channel.hello;\n  const client = await Client.connect({ serverId, transportFactory: channel.transport });\n  const server = createRemoteServiceBinding({\n    services: [AgentSessions],\n    transport: createClientServiceTransport(client, () => ({ serverId })),\n    bound: true,\n  });\n  const ready = attached(client);\n  await server.use(AgentSessions).attach(AGENT_SESSION, context);\n  await ready;\n  const session = createRemoteServiceBinding({\n    services: [AgentControl, AgentTranscript, AgentSettings],\n    transport: createClientServiceTransport(client, () => client.attachment),\n    bound: true,\n  });\n  const control = session.use(AgentControl);\n  const {\n    state: transcript,\n    deliveries,\n    agents,\n    views,\n    commands,\n    sprinkles,\n    memories,\n    memoryScopes,\n    frozen,\n    changes,\n  } = session.use(AgentTranscript);\n  const settings = session.use(AgentSettings);\n  await session.ready(context);\n  const held: Lasting<unknown>[] = [];\n  const hold = <T>(state: ReplicatedState<T>): ReplicatedState<T> => {\n    const kept = lasting(state);\n    held.push(kept as Lasting<unknown>);\n    return kept.state;\n  };\n  return {\n    serverId,\n    control,\n    transcript: hold(transcript),\n    deliveries: hold(deliveries),\n    agents: hold(agents),\n    views: hold(views),\n    commands: hold(commands),\n    sprinkles: hold(sprinkles),\n    memories: hold(memories),\n    memoryScopes: hold(memoryScopes),\n    frozen: hold(frozen),\n    changes: hold(changes),\n    settings: lastingSettings(settings, hold),\n    async prompt(text, whenBusy = 'followUp') {\n      const sent = await control.send({ text, whenBusy, requestId: null }, context);\n      if (!sent.accepted) throw new Error(`${sent.error.code}: ${sent.error.message}`);\n      const settled = await control.wait(sent.submissionId, context);\n      if (settled.status !== 'done') throw new Error(`unanswered: ${settled.reason}`);\n      return settled.text;\n    },\n    async close() {\n      for (const kept of held) kept.freeze();\n      await server.use(AgentSessions).detach(context);\n      await session.dispose(context);\n      await server.dispose(context);\n      await client.dispose();\n    },\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  type Context,\n  createRemoteServiceBinding,\n  type ReplicatedState,\n} from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT } from '@earendil-works/chord/context';\nimport { Client, createClientServiceTransport } from '@earendil-works/pi-client';\nimport type { ConversationView } from '@earendil-works/pi-durable';\nimport type { ChangesView } from './changes/git.ts';\nimport type { FrozenCone } from './freezer/index.ts';\nimport type { MemoryEntry, MemoryScope } from './memory/format.ts';\nimport {\n  AGENT_SESSION,\n  AgentControl,\n  AgentSessions,\n  AgentSettings,\n  type AgentsSummary,\n  AgentTranscript,\n  type Command,\n  type Delivered,\n  type SendMode,\n} from './services.ts';\nimport type { Sprinkle } from './sprinkles/kind.ts';\nimport { PortChannel, type PortEndpoint } from './wire.ts';\n\nexport interface AgentConnection {\n  readonly serverId: string;\n  readonly control: AgentControl;\n  readonly transcript: ReplicatedState<ConversationView>;\n  readonly deliveries: ReplicatedState<Record<string, Delivered>>;\n  readonly agents?: ReplicatedState<AgentsSummary>;\n  readonly views?: ReplicatedState<Record<string, ConversationView>>;\n  readonly commands?: ReplicatedState<Command[]>;\n  readonly sprinkles?: ReplicatedState<Sprinkle[]>;\n  readonly memories?: ReplicatedState<MemoryEntry[]>;\n  readonly memoryScopes?: ReplicatedState<MemoryScope[]>;\n  readonly frozen?: ReplicatedState<FrozenCone[]>;\n  readonly changes?: ReplicatedState<ChangesView>;\n  readonly settings: AgentSettings;\n  readonly closed: Promise<Error | undefined>;\n  prompt(text: string, whenBusy?: SendMode): Promise<string>;\n  close(): Promise<void>;\n}\n\nexport interface Lasting<T> {\n  readonly state: ReplicatedState<T>;\n  freeze(): void;\n}\n\nexport function lasting<T>(state: ReplicatedState<T>): Lasting<T> {\n  let last: T | undefined;\n  let frozen = false;\n  const read = () => {\n    if (frozen) return last;\n    try {\n      last = state.value;\n    } catch {}\n    return last;\n  };\n  return {\n    state: {\n      get value() {\n        return read();\n      },\n      subscribe: (listener) => (frozen ? () => undefined : state.subscribe(listener)),\n    },\n    freeze() {\n      read();\n      frozen = true;\n    },\n  };\n}\n\nfunction lastingSettings(\n  settings: AgentSettings,\n  hold: <T>(state: ReplicatedState<T>) => ReplicatedState<T>\n): AgentSettings {\n  return {\n    state: hold(settings.state),\n    connect: (providerId, secret, region, context) =>\n      settings.connect(providerId, secret, region, context),\n    disconnect: (providerId, context) => settings.disconnect(providerId, context),\n    signIn: (providerId, context) => settings.signIn(providerId, context),\n  };\n}\n\nfunction attached(client: Client): Promise<void> {\n  return new Promise((resolve) => {\n    const stop = client.onAttachmentChange(() => {\n      stop();\n      resolve();\n    });\n  });\n}\n\nexport async function connectAgent(\n  endpoint: PortEndpoint,\n  options: { context?: Context } = {}\n): Promise<AgentConnection> {\n  const context = options.context ?? BACKGROUND_CONTEXT;\n  const channel = new PortChannel(endpoint);\n  const serverId = await channel.hello;\n  const client = await Client.connect({ serverId, transportFactory: channel.transport });\n  const server = createRemoteServiceBinding({\n    services: [AgentSessions],\n    transport: createClientServiceTransport(client, () => ({ serverId })),\n    bound: true,\n  });\n  const ready = attached(client);\n  await server.use(AgentSessions).attach(AGENT_SESSION, context);\n  await ready;\n  const session = createRemoteServiceBinding({\n    services: [AgentControl, AgentTranscript, AgentSettings],\n    transport: createClientServiceTransport(client, () => client.attachment),\n    bound: true,\n  });\n  const control = session.use(AgentControl);\n  const {\n    state: transcript,\n    deliveries,\n    agents,\n    views,\n    commands,\n    sprinkles,\n    memories,\n    memoryScopes,\n    frozen,\n    changes,\n  } = session.use(AgentTranscript);\n  const settings = session.use(AgentSettings);\n  await session.ready(context);\n  const held: Lasting<unknown>[] = [];\n  const hold = <T>(state: ReplicatedState<T>): ReplicatedState<T> => {\n    const kept = lasting(state);\n    held.push(kept as Lasting<unknown>);\n    return kept.state;\n  };\n  const freeze = () => {\n    for (const kept of held) kept.freeze();\n  };\n  const closed = channel.ended.then((reason) => {\n    freeze();\n    return reason;\n  });\n  return {\n    serverId,\n    control,\n    transcript: hold(transcript),\n    deliveries: hold(deliveries),\n    agents: hold(agents),\n    views: hold(views),\n    commands: hold(commands),\n    sprinkles: hold(sprinkles),\n    memories: hold(memories),\n    memoryScopes: hold(memoryScopes),\n    frozen: hold(frozen),\n    changes: hold(changes),\n    settings: lastingSettings(settings, hold),\n    closed,\n    async prompt(text, whenBusy = 'followUp') {\n      const sent = await control.send({ text, whenBusy, requestId: null }, context);\n      if (!sent.accepted) throw new Error(`${sent.error.code}: ${sent.error.message}`);\n      const settled = await control.wait(sent.submissionId, context);\n      if (settled.status !== 'done') throw new Error(`unanswered: ${settled.reason}`);\n      return settled.text;\n    },\n    async close() {\n      freeze();\n      await server.use(AgentSessions).detach(context);\n      await session.dispose(context);\n      await server.dispose(context);\n      await client.dispose();\n    },\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/gelatiere/catalog.js

@@ -0,0 +1,192 @@
+import { redactSecrets } from "../memory/format.js";
+import { STORE_DIR } from "./store.js";
+const CATALOG_BASE = "https://www.sliccy.com/skills/";
+const CATALOG_DIR = `${STORE_DIR}/catalog`;
+const PROFILE = ".welcome.json";
+const MAX_AGE = 12 * 60 * 60 * 1e3;
+const MAX_BYTES = 1024 * 1024;
+const WEIGHTS = { apps: 3, tasks: 2, role: 1, purpose: 1 };
+const REPO = /^[A-Za-z0-9][A-Za-z0-9-]{0,38}\/[A-Za-z0-9._-]{1,100}$/;
+const SKILL = /^[A-Za-z0-9][A-Za-z0-9 ._-]{0,79}$/;
+const PATH = /^(?!.*\.\.)[A-Za-z0-9._/-]{1,200}$/;
+const NAME = /^[a-z0-9][a-z0-9-]{0,55}$/;
+function words(value) {
+  if (typeof value !== "string") return [];
+  return value.split(",").map((part) => part.trim()).filter(Boolean);
+}
+function clean(value, limit) {
+  if (typeof value !== "string") return "";
+  return redactSecrets(value.trim()).text.slice(0, limit);
+}
+function boostOf(value) {
+  const parsed = typeof value === "string" && value.trim() ? Number.parseFloat(value) : Number.NaN;
+  return Number.isFinite(parsed) ? parsed : void 0;
+}
+function affinityOf(row) {
+  return {
+    apps: words(row.apps),
+    tasks: words(row.tasks),
+    role: words(row.role),
+    purpose: words(row.purpose)
+  };
+}
+function nameOf(value) {
+  const name = typeof value === "string" ? value.trim().toLowerCase() : "";
+  return NAME.test(name) ? name : void 0;
+}
+function truthy(value) {
+  return typeof value === "string" && ["true", "1", "yes"].includes(value.trim().toLowerCase());
+}
+function parseSkills(rows) {
+  const out = [];
+  for (const row of rows) {
+    const name = nameOf(row.name);
+    const repo = typeof row.repo === "string" ? row.repo.trim() : "";
+    const skill = typeof row.skill === "string" ? row.skill.trim() : "";
+    const path = typeof row.path === "string" ? row.path.trim() : "";
+    const all = truthy(row.installAll);
+    if (!name || !REPO.test(repo)) continue;
+    if (!all && !SKILL.test(skill)) continue;
+    if (path && !PATH.test(path)) continue;
+    const boost = boostOf(row.boost);
+    out.push({
+      name,
+      title: clean(row.displayName, 80) || name,
+      description: clean(row.description, 500),
+      repo,
+      ...all ? {} : { skill },
+      ...path ? { path } : {},
+      all,
+      affinity: affinityOf(row),
+      ...boost === void 0 ? {} : { boost }
+    });
+  }
+  return out;
+}
+function parseUseCases(rows) {
+  const out = [];
+  for (const row of rows) {
+    const name = nameOf(row.name);
+    const prompt = clean(row.prompt, 1e3);
+    if (!name || !prompt) continue;
+    const boost = boostOf(row.boost);
+    out.push({
+      name,
+      title: clean(row.displayName, 80) || name,
+      description: clean(row.description, 500),
+      prompt,
+      skills: words(row.skills),
+      affinity: affinityOf(row),
+      ...boost === void 0 ? {} : { boost }
+    });
+  }
+  return out;
+}
+function merge(base, company) {
+  const names = new Set(company.map((entry) => entry.name));
+  return [...base.filter((entry) => !names.has(entry.name)), ...company];
+}
+function slugifyCompany(company) {
+  if (typeof company !== "string" || !company) return null;
+  const slug = company.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/(^-+|-+$)/g, "");
+  return slug || null;
+}
+function profileOf(value) {
+  if (!value || typeof value !== "object") return void 0;
+  const raw = value;
+  const list = (field) => Array.isArray(field) ? field.filter((item) => typeof item === "string") : [];
+  const text = (field) => typeof field === "string" ? field : "";
+  return {
+    purpose: text(raw.purpose),
+    role: text(raw.role),
+    tasks: list(raw.tasks),
+    apps: list(raw.apps),
+    ...typeof raw.company === "string" && raw.company ? { company: raw.company } : {}
+  };
+}
+function score(entry, profile) {
+  if (!profile) return { score: entry.boost ?? 1, reasons: [] };
+  let total = 0;
+  const reasons = [];
+  const apps = entry.affinity.apps.filter((app) => profile.apps.includes(app));
+  if (apps.length) {
+    total += apps.length * WEIGHTS.apps;
+    reasons.push(`apps(${apps.join(", ")})`);
+  }
+  const tasks = entry.affinity.tasks.filter((task) => profile.tasks.includes(task));
+  if (tasks.length) {
+    total += tasks.length * WEIGHTS.tasks;
+    reasons.push(`tasks(${tasks.join(", ")})`);
+  }
+  if (profile.role && entry.affinity.role.includes(profile.role)) {
+    total += WEIGHTS.role;
+    reasons.push(`role(${profile.role})`);
+  }
+  if (profile.purpose && entry.affinity.purpose.includes(profile.purpose)) {
+    total += WEIGHTS.purpose;
+    reasons.push(`purpose(${profile.purpose})`);
+  }
+  return { score: total * (entry.boost ?? 1), reasons };
+}
+function rowsOf(value) {
+  const data = value?.data;
+  if (!Array.isArray(data)) return void 0;
+  return data.filter((row) => Boolean(row) && typeof row === "object");
+}
+async function download(fetcher, url) {
+  try {
+    const response = await fetcher(url, { headers: { accept: "application/json" } });
+    if (response.status === 404) return "missing";
+    if (response.status !== 200) return void 0;
+    const text = await response.text();
+    if (text.length > MAX_BYTES) return void 0;
+    const rows = rowsOf(JSON.parse(text));
+    return rows ? { rows } : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function cached(env, file, url, context) {
+  const read = await env.readTextFile(file, context);
+  if (!read.ok) return void 0;
+  try {
+    const parsed = JSON.parse(read.value);
+    return parsed.url === url && typeof parsed.fetchedAt === "number" && Array.isArray(parsed.rows) ? parsed : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function sheet(options, url, file, context) {
+  const { env, fetcher, now, refresh } = options;
+  const kept = await cached(env, file, url, context);
+  if (kept && !refresh && now - kept.fetchedAt < MAX_AGE)
+    return {
+      url,
+      rows: kept.rows,
+      state: kept.rows.length ? "fresh" : "missing",
+      fetchedAt: kept.fetchedAt
+    };
+  const got = await download(fetcher, url);
+  if (got === void 0)
+    return kept ? { url, rows: kept.rows, state: "cached", fetchedAt: kept.fetchedAt } : { url, rows: [], state: "unavailable" };
+  const rows = got === "missing" ? [] : got.rows;
+  await env.createDir(CATALOG_DIR, { recursive: true }, context);
+  await env.writeFile(file, `${JSON.stringify({ url, fetchedAt: now, rows })}
+`, context);
+  return { url, rows, state: got === "missing" ? "missing" : "fresh", fetchedAt: now };
+}
+export {
+  CATALOG_BASE,
+  CATALOG_DIR,
+  MAX_AGE,
+  PROFILE,
+  merge,
+  parseSkills,
+  parseUseCases,
+  profileOf,
+  score,
+  sheet,
+  slugifyCompany,
+  truthy
+};
+//# sourceMappingURL=catalog.js.map

package/dist/gelatiere/catalog.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/gelatiere/catalog.ts"],
+  "sourcesContent": ["import type { Context } from '@earendil-works/chord';\nimport type { ExecutionEnv } from '@earendil-works/pi-durable/env';\nimport { redactSecrets } from '../memory/format.ts';\nimport { STORE_DIR } from './store.ts';\n\nexport const CATALOG_BASE = 'https://www.sliccy.com/skills/';\nexport const CATALOG_DIR = `${STORE_DIR}/catalog`;\nexport const PROFILE = '.welcome.json';\nexport const MAX_AGE = 12 * 60 * 60 * 1000;\nconst MAX_BYTES = 1024 * 1024;\nconst WEIGHTS = { apps: 3, tasks: 2, role: 1, purpose: 1 };\nconst REPO = /^[A-Za-z0-9][A-Za-z0-9-]{0,38}\\/[A-Za-z0-9._-]{1,100}$/;\nconst SKILL = /^[A-Za-z0-9][A-Za-z0-9 ._-]{0,79}$/;\nconst PATH = /^(?!.*\\.\\.)[A-Za-z0-9._/-]{1,200}$/;\nconst NAME = /^[a-z0-9][a-z0-9-]{0,55}$/;\n\nexport type Row = Record<string, string>;\n\nexport interface Profile {\n  purpose: string;\n  role: string;\n  tasks: string[];\n  apps: string[];\n  company?: string;\n}\n\nexport interface Affinity {\n  apps: string[];\n  tasks: string[];\n  role: string[];\n  purpose: string[];\n}\n\nexport interface CatalogSkill {\n  name: string;\n  title: string;\n  description: string;\n  repo: string;\n  skill?: string;\n  path?: string;\n  all: boolean;\n  affinity: Affinity;\n  boost?: number;\n}\n\nexport interface CatalogUseCase {\n  name: string;\n  title: string;\n  description: string;\n  prompt: string;\n  skills: string[];\n  affinity: Affinity;\n  boost?: number;\n}\n\nexport type Fetcher = (url: string, init?: RequestInit) => Promise<Response>;\n\nexport type Freshness = 'fresh' | 'cached' | 'missing' | 'unavailable';\n\nexport interface Sheet {\n  url: string;\n  rows: Row[];\n  state: Freshness;\n  fetchedAt?: number;\n}\n\nfunction words(value: unknown): string[] {\n  if (typeof value !== 'string') return [];\n  return value\n    .split(',')\n    .map((part) => part.trim())\n    .filter(Boolean);\n}\n\nfunction clean(value: unknown, limit: number): string {\n  if (typeof value !== 'string') return '';\n  return redactSecrets(value.trim()).text.slice(0, limit);\n}\n\nfunction boostOf(value: unknown): number | undefined {\n  const parsed = typeof value === 'string' && value.trim() ? Number.parseFloat(value) : Number.NaN;\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction affinityOf(row: Row): Affinity {\n  return {\n    apps: words(row.apps),\n    tasks: words(row.tasks),\n    role: words(row.role),\n    purpose: words(row.purpose),\n  };\n}\n\nfunction nameOf(value: unknown): string | undefined {\n  const name = typeof value === 'string' ? value.trim().toLowerCase() : '';\n  return NAME.test(name) ? name : undefined;\n}\n\nexport function truthy(value: unknown): boolean {\n  return typeof value === 'string' && ['true', '1', 'yes'].includes(value.trim().toLowerCase());\n}\n\nexport function parseSkills(rows: readonly Row[]): CatalogSkill[] {\n  const out: CatalogSkill[] = [];\n  for (const row of rows) {\n    const name = nameOf(row.name);\n    const repo = typeof row.repo === 'string' ? row.repo.trim() : '';\n    const skill = typeof row.skill === 'string' ? row.skill.trim() : '';\n    const path = typeof row.path === 'string' ? row.path.trim() : '';\n    const all = truthy(row.installAll);\n    if (!name || !REPO.test(repo)) continue;\n    if (!all && !SKILL.test(skill)) continue;\n    if (path && !PATH.test(path)) continue;\n    const boost = boostOf(row.boost);\n    out.push({\n      name,\n      title: clean(row.displayName, 80) || name,\n      description: clean(row.description, 500),\n      repo,\n      ...(all ? {} : { skill }),\n      ...(path ? { path } : {}),\n      all,\n      affinity: affinityOf(row),\n      ...(boost === undefined ? {} : { boost }),\n    });\n  }\n  return out;\n}\n\nexport function parseUseCases(rows: readonly Row[]): CatalogUseCase[] {\n  const out: CatalogUseCase[] = [];\n  for (const row of rows) {\n    const name = nameOf(row.name);\n    const prompt = clean(row.prompt, 1000);\n    if (!name || !prompt) continue;\n    const boost = boostOf(row.boost);\n    out.push({\n      name,\n      title: clean(row.displayName, 80) || name,\n      description: clean(row.description, 500),\n      prompt,\n      skills: words(row.skills),\n      affinity: affinityOf(row),\n      ...(boost === undefined ? {} : { boost }),\n    });\n  }\n  return out;\n}\n\nexport function merge(base: CatalogSkill[], company: CatalogSkill[]): CatalogSkill[] {\n  const names = new Set(company.map((entry) => entry.name));\n  return [...base.filter((entry) => !names.has(entry.name)), ...company];\n}\n\nexport function slugifyCompany(company: unknown): string | null {\n  if (typeof company !== 'string' || !company) return null;\n  const slug = company\n    .toLowerCase()\n    .trim()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/(^-+|-+$)/g, '');\n  return slug || null;\n}\n\nexport function profileOf(value: unknown): Profile | undefined {\n  if (!value || typeof value !== 'object') return undefined;\n  const raw = value as Record<string, unknown>;\n  const list = (field: unknown) =>\n    Array.isArray(field) ? field.filter((item): item is string => typeof item === 'string') : [];\n  const text = (field: unknown) => (typeof field === 'string' ? field : '');\n  return {\n    purpose: text(raw.purpose),\n    role: text(raw.role),\n    tasks: list(raw.tasks),\n    apps: list(raw.apps),\n    ...(typeof raw.company === 'string' && raw.company ? { company: raw.company } : {}),\n  };\n}\n\nexport interface Scored {\n  score: number;\n  reasons: string[];\n}\n\nexport function score(\n  entry: { affinity: Affinity; boost?: number },\n  profile: Profile | undefined\n): Scored {\n  if (!profile) return { score: entry.boost ?? 1, reasons: [] };\n  let total = 0;\n  const reasons: string[] = [];\n  const apps = entry.affinity.apps.filter((app) => profile.apps.includes(app));\n  if (apps.length) {\n    total += apps.length * WEIGHTS.apps;\n    reasons.push(`apps(${apps.join(', ')})`);\n  }\n  const tasks = entry.affinity.tasks.filter((task) => profile.tasks.includes(task));\n  if (tasks.length) {\n    total += tasks.length * WEIGHTS.tasks;\n    reasons.push(`tasks(${tasks.join(', ')})`);\n  }\n  if (profile.role && entry.affinity.role.includes(profile.role)) {\n    total += WEIGHTS.role;\n    reasons.push(`role(${profile.role})`);\n  }\n  if (profile.purpose && entry.affinity.purpose.includes(profile.purpose)) {\n    total += WEIGHTS.purpose;\n    reasons.push(`purpose(${profile.purpose})`);\n  }\n  return { score: total * (entry.boost ?? 1), reasons };\n}\n\nfunction rowsOf(value: unknown): Row[] | undefined {\n  const data = (value as { data?: unknown } | null)?.data;\n  if (!Array.isArray(data)) return undefined;\n  return data.filter((row): row is Row => Boolean(row) && typeof row === 'object');\n}\n\nasync function download(\n  fetcher: Fetcher,\n  url: string\n): Promise<{ rows: Row[] } | 'missing' | undefined> {\n  try {\n    const response = await fetcher(url, { headers: { accept: 'application/json' } });\n    if (response.status === 404) return 'missing';\n    if (response.status !== 200) return undefined;\n    const text = await response.text();\n    if (text.length > MAX_BYTES) return undefined;\n    const rows = rowsOf(JSON.parse(text));\n    return rows ? { rows } : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\ninterface Cached {\n  url: string;\n  fetchedAt: number;\n  rows: Row[];\n}\n\nasync function cached(\n  env: Pick<ExecutionEnv, 'readTextFile'>,\n  file: string,\n  url: string,\n  context: Context\n): Promise<Cached | undefined> {\n  const read = await env.readTextFile(file, context);\n  if (!read.ok) return undefined;\n  try {\n    const parsed = JSON.parse(read.value) as Cached;\n    return parsed.url === url && typeof parsed.fetchedAt === 'number' && Array.isArray(parsed.rows)\n      ? parsed\n      : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport interface SheetOptions {\n  env: Pick<ExecutionEnv, 'readTextFile' | 'writeFile' | 'createDir'>;\n  fetcher: Fetcher;\n  now: number;\n  refresh: boolean;\n}\n\nexport async function sheet(\n  options: SheetOptions,\n  url: string,\n  file: string,\n  context: Context\n): Promise<Sheet> {\n  const { env, fetcher, now, refresh } = options;\n  const kept = await cached(env, file, url, context);\n  if (kept && !refresh && now - kept.fetchedAt < MAX_AGE)\n    return {\n      url,\n      rows: kept.rows,\n      state: kept.rows.length ? 'fresh' : 'missing',\n      fetchedAt: kept.fetchedAt,\n    };\n  const got = await download(fetcher, url);\n  if (got === undefined)\n    return kept\n      ? { url, rows: kept.rows, state: 'cached', fetchedAt: kept.fetchedAt }\n      : { url, rows: [], state: 'unavailable' };\n  const rows = got === 'missing' ? [] : got.rows;\n  await env.createDir(CATALOG_DIR, { recursive: true }, context);\n  await env.writeFile(file, `${JSON.stringify({ url, fetchedAt: now, rows })}\\n`, context);\n  return { url, rows, state: got === 'missing' ? 'missing' : 'fresh', fetchedAt: now };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/gelatiere/index.js

@@ -1,5 +1,17 @@
 import { live } from "../agents.js";
 import { skillFromText } from "../skills/skills.js";
+import {
+  CATALOG_BASE,
+  CATALOG_DIR,
+  merge,
+  PROFILE,
+  parseSkills,
+  parseUseCases,
+  profileOf,
+  score,
+  sheet,
+  slugifyCompany
+} from "./catalog.js";
 import { fold, open, readStore, STORE, validate, writeStore } from "./store.js";
 const ROLE = "gelatiere";
 const SPRINKLE = "suggestions";
@@ -10,6 +22,8 @@ const USAGE = `usage:
   gelatiere run             ask the gelatiere for a pass now
   gelatiere suggest <file>  fold a JSON array of suggestions into the store
   gelatiere deliver         lick each cone with the suggestions that are new for it
+  gelatiere catalog [--refresh] [--all] [--json]
+                            rank the www.sliccy.com skill and use-case catalog for this user
   gelatiere install <id>    install a suggested skill with upskill into ~/.pi/agent/skills
   gelatiere list [--all] [--json]
   gelatiere dismiss <id>    mark a suggestion as not wanted
@@ -163,48 +177,141 @@ async function deliver(g, context) {
   };
 }
 const INSTALLER = "https://raw.githubusercontent.com/ai-ecoverse/gh-upskill/main/install.sh";
-function upskillScript(repo, skill) {
+function upskillScript(repo, skill, where = {}) {
+  const from = where.path ? ` --path '${where.path}'` : "";
+  const which = where.all ? " --all" : ` --skill '${skill}'`;
   return [
     'bin="${PNPM_HOME:-$HOME/.local/share/pnpm}/bin"',
     `{ command -v upskill >/dev/null 2>&1 || curl -fsSL ${INSTALLER} | bash -s -- --bin-dir "$bin"; }`,
-    `upskill '${repo}' --skill '${skill}' --dest-path "$HOME/.pi/agent/skills"`
+    `upskill '${repo}'${from}${which} --dest-path "$HOME/.pi/agent/skills"`
   ].join(" && ");
 }
-async function installed(env, home, skill, context) {
+async function skillsIn(env, home, context) {
   const root = `${home}/.pi/agent/skills`;
+  const found = /* @__PURE__ */ new Map();
   const listed = await env.listDir(root, context);
   for (const info of listed.ok ? listed.value : []) {
     const path = `${root}/${info.name}/SKILL.md`;
     const read = await env.readTextFile(path, context);
-    if (read.ok && skillFromText(read.value, path, "user").skills[0]?.name === skill) return path;
+    const name = read.ok ? skillFromText(read.value, path, "user").skills[0]?.name : void 0;
+    if (name) found.set(name, path);
   }
-  return void 0;
+  return found;
 }
 async function install(g, id, context) {
   const { env, home } = g.options;
   const item = (await g.load(context)).find((entry) => entry.id === id && entry.kind === "skill");
   const checked = item ? validate(item) : `there is no skill suggestion ${id}`;
   if (typeof checked === "string") return fail(checked);
-  const { skill, repo } = checked;
-  const before = await installed(env, home, skill, context);
-  if (before) return fail(`${skill} is already installed in ${before}`);
+  const { skill, repo, path, all } = checked;
+  const what = all ? `the skills${path ? ` in ${path}` : ""}` : skill;
+  const before = await skillsIn(env, home, context);
+  const existing = skill ? before.get(skill) : void 0;
+  if (!all && existing) return fail(`${skill} is already installed in ${existing}`);
   const lines = [];
   const ran = await env.exec(
-    upskillScript(repo, skill),
+    upskillScript(repo, skill, { ...path ? { path } : {}, ...all ? { all } : {} }),
     { cwd: home, onOutput: (text) => void lines.push(text) },
     context
   );
   const output = lines.join("").trim().split("\n").slice(-8).join("\n");
-  const path = await installed(env, home, skill, context);
-  if (!ran.ok || ran.value.exitCode !== 0 || !path)
+  const after = await skillsIn(env, home, context);
+  const added = all ? [...after].filter(([name, at]) => before.get(name) !== at) : [...after].filter(([name]) => name === skill);
+  if (!ran.ok || ran.value.exitCode !== 0 || !added.length)
     return fail(
-      `upskill couldn't install ${skill} from github.com/${repo}${output ? `:
+      `upskill couldn't install ${what} from github.com/${repo}${output ? `:
 ${output}` : ""}`
     );
   await g.mark(id, "takenAt", context);
+  const names = added.map(([name]) => name).sort();
   return {
     code: 0,
-    out: `installed ${skill} in ${path}; it is /skill:${skill} once the skills reload
+    out: all ? `installed ${names.join(", ")} in ${home}/.pi/agent/skills; ${names.map((name) => `/skill:${name}`).join(", ")} once the skills reload
+` : `installed ${skill} in ${added[0]?.[1]}; it is /skill:${skill} once the skills reload
+`
+  };
+}
+async function profileFor(g, context) {
+  const read = await g.options.env.readTextFile(`${g.options.home}/${PROFILE}`, context);
+  if (!read.ok) return void 0;
+  try {
+    return profileOf(JSON.parse(read.value));
+  } catch {
+    return void 0;
+  }
+}
+function sourceLine(label, found) {
+  const at = found.fetchedAt ? `, fetched ${new Date(found.fetchedAt).toISOString()}` : "";
+  return `${label}: ${found.state} (${found.url}${at})`;
+}
+async function catalog(g, argv, context) {
+  const { env, home } = g.options;
+  const base = g.options.catalog ?? CATALOG_BASE;
+  const fetcher = g.options.fetch ?? ((url, init2) => globalThis.fetch(url, init2));
+  const options = { env, fetcher, now: g.now(), refresh: argv.includes("--refresh") };
+  const profile = await profileFor(g, context);
+  const slug = slugifyCompany(profile?.company);
+  const company = slug && !["catalog", "use-cases"].includes(slug) ? slug : null;
+  const [global, own, cases] = await Promise.all([
+    sheet(options, `${base}catalog.json`, `${CATALOG_DIR}/catalog.json`, context),
+    company ? sheet(options, `${base}${company}.json`, `${CATALOG_DIR}/company-${company}.json`, context) : void 0,
+    sheet(options, `${base}use-cases.json`, `${CATALOG_DIR}/use-cases.json`, context)
+  ]);
+  const store = await g.load(context);
+  const closed = new Set(store.filter((item) => item.dismissedAt || item.takenAt).map((i) => i.id));
+  const have = /* @__PURE__ */ new Set([
+    ...(await skillsIn(env, home, context)).keys(),
+    ...(g.options.skills?.() ?? []).map((entry) => entry.name)
+  ]);
+  const evidence = (reasons) => `www.sliccy.com catalog: ${reasons.length ? reasons.join(", ") : "featured"}`;
+  const skills = merge(parseSkills(global.rows), parseSkills(own?.rows ?? [])).filter((entry) => !entry.skill || !have.has(entry.skill)).map((entry) => {
+    const ranked2 = score(entry, profile);
+    return {
+      id: `catalog-${entry.name}`,
+      kind: "skill",
+      title: entry.title,
+      body: entry.description || entry.title,
+      evidence: evidence(ranked2.reasons),
+      score: ranked2.score,
+      ...entry.skill ? { skill: entry.skill } : {},
+      repo: entry.repo,
+      ...entry.path ? { path: entry.path } : {},
+      ...entry.all ? { all: true } : {}
+    };
+  });
+  const uses = parseUseCases(cases.rows).map((entry) => {
+    const ranked2 = score(entry, profile);
+    return {
+      id: `catalog-use-${entry.name}`,
+      kind: "use-case",
+      title: entry.title,
+      body: entry.description || entry.title,
+      evidence: evidence(ranked2.reasons),
+      score: ranked2.score,
+      prompt: entry.prompt,
+      ...entry.skills.length ? { skills: entry.skills } : {}
+    };
+  });
+  const all = argv.includes("--all");
+  const ranked = [...skills, ...uses].filter((item) => !closed.has(item.id) && (all || item.score > 0)).sort((a, b) => b.score - a.score || a.id.localeCompare(b.id));
+  const sources = [
+    sourceLine("skills", global),
+    ...own ? [sourceLine(`company ${company}`, own)] : [],
+    sourceLine("use cases", cases)
+  ];
+  const who = profile ? `profile: ${home}/${PROFILE} (${[profile.role, profile.purpose].filter(Boolean).join(", ") || "empty"})` : `profile: none (${home}/${PROFILE}); ranked by boost only`;
+  if (argv.includes("--json"))
+    return {
+      code: 0,
+      out: `${JSON.stringify({ sources, profile: Boolean(profile), candidates: ranked }, null, 2)}
+`
+    };
+  const rows = ranked.map(
+    (item) => `${item.score}	${item.id}	${item.kind}	${item.title}	${item.evidence}`
+  );
+  return {
+    code: 0,
+    out: `${[...sources, who, ...rows.length ? rows : ["no catalog entries match"]].join("\n")}
 `
   };
 }
@@ -241,6 +348,7 @@ const VERBS = {
   suggest: (g, argv, context) => g.serial(() => suggest(g, argv[1], context)),
   deliver: (g, _argv, context) => g.serial(() => deliver(g, context)),
   install: (g, argv, context) => install(g, argv[1] ?? "", context),
+  catalog: (g, argv, context) => catalog(g, argv, context),
   list: (g, argv, context) => list(g, argv, context),
   status: (g, _argv, context) => status(g, context),
   dismiss: (g, argv, context) => dismiss(g, argv[1] ?? "", context)