@catalyst-cloud/cli 0.8.0 → 0.9.1

package/skills/catalyst-onboard/scripts/local-sync.mjs

@@ -0,0 +1,216 @@
+#!/usr/bin/env node
+// Optional onboarding step. The replica command starts the event cache with the writer;
+// only a live heartbeat at the cloud head proves that both were started successfully.
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { cliTarget } from "./lib/cli.mjs";
+
+const STATUS_COMMAND = ["replica", "status", "--probe", "--json"];
+const EVENTS_COMMAND = ["events", "status", "--probe", "--json"];
+const START_COMMAND = ["replica", "start", "--detach"];
+const RECOVERY_COMMAND = "catalyst-skills replica start --detach";
+
+function defaultRun(args) {
+  const target = cliTarget();
+  const result = spawnSync(target.command, [...target.prefix, ...args], {
+    encoding: "utf8",
+    timeout: 30_000,
+    maxBuffer: 64 * 1024 * 1024,
+    stdio: ["ignore", "pipe", "pipe"],
+    shell: !target.recorded && process.platform === "win32",
+    env: process.env,
+  });
+  return {
+    code: result.status ?? 1,
+    stdout: result.stdout ?? "",
+    stderr: result.stderr ?? "",
+    error: result.error?.message,
+  };
+}
+
+export function assessLocalSync(status, events) {
+  if (!status || typeof status !== "object")
+    return { verdict: "unknown", current: false, reason: "replica status did not return a document" };
+  if (status.verdict === "not-configured")
+    return { verdict: "unknown", current: false, reason: "this machine is not connected" };
+  if (status.verdict === "absent")
+    return { verdict: "absent", current: false, reason: "local replica is absent" };
+  if (status.verdict === "unknown" || status.verdict === "unverified" || !["fresh", "stale"].includes(status.verdict))
+    return { verdict: "unknown", current: false, reason: `replica freshness is unknown: ${(status.reasons ?? []).join("; ")}` };
+  if (status.verdict !== "fresh")
+    return {
+      verdict: "stale",
+      current: false,
+      reason: `replica ${status.verdict ?? "unknown"}: ${(status.reasons ?? []).join("; ")}`,
+    };
+  if (status.writerAlive !== true)
+    return { verdict: "stale", current: false, reason: "replica writer heartbeat is absent or stale" };
+  if (!Number.isFinite(status.heartbeatAgeMs))
+    return { verdict: "unknown", current: false, reason: "replica heartbeat age was not reported" };
+  if (status.heartbeatAgeMs >= 15_000)
+    return { verdict: "stale", current: false, reason: `replica writer heartbeat is ${status.heartbeatAgeMs}ms old` };
+  if (!Number.isSafeInteger(status.cursor) || !Number.isSafeInteger(status.head) || !Number.isSafeInteger(status.lag))
+    return { verdict: "unknown", current: false, reason: "replica cursor or cloud head was not reported" };
+  if (status.lag !== 0 || status.cursor !== status.head) {
+    return {
+      verdict: "stale",
+      current: false,
+      reason: "cloud head and local cursor have not been proved equal",
+    };
+  }
+  if (!events || !["current", "stale", "absent"].includes(events.verdict)) {
+    return {
+      verdict: "unknown",
+      current: false,
+      reason: `event freshness is unknown: ${(events?.reasons ?? []).join("; ")}`,
+    };
+  }
+  if (events.verdict === "absent") {
+    return { verdict: "absent", current: false, reason: "local event cache is absent" };
+  }
+  if (events.verdict === "stale")
+    return {
+      verdict: "stale",
+      current: false,
+      reason: `event cache is ${events?.verdict ?? "unverified"}: ${(events?.reasons ?? []).join("; ")}`,
+    };
+  if (events.writerAlive !== true)
+    return { verdict: "stale", current: false, reason: "event writer heartbeat is absent or stale" };
+  if (!Number.isFinite(events.heartbeatAgeMs))
+    return { verdict: "unknown", current: false, reason: "event writer heartbeat age was not reported" };
+  if (events.heartbeatAgeMs >= 15_000)
+    return { verdict: "stale", current: false, reason: `event writer heartbeat is ${events.heartbeatAgeMs}ms old` };
+  if (!Number.isSafeInteger(events.cursor) || !Number.isSafeInteger(events.head))
+    return { verdict: "unknown", current: false, reason: "event cursor or cloud head was not reported" };
+  if (events.cursor !== events.head)
+    return { verdict: "stale", current: false, reason: `event cache cursor ${events.cursor} differs from cloud head ${events.head}` };
+  return {
+    verdict: "current",
+    current: true,
+    reason: `replica cursor ${status.cursor} and event cursor ${events.cursor} each match their cloud head; both writer heartbeats are live`,
+  };
+}
+
+function readStatus(run) {
+  const replicaResult = run(STATUS_COMMAND);
+  let status, events;
+  try {
+    status = JSON.parse(replicaResult.stdout);
+  } catch {
+    return {
+      status: null,
+      events: null,
+      assessment: {
+        verdict: "unknown",
+        current: false,
+        reason: `replica status is unknown: ${replicaResult.error || replicaResult.stderr.trim() || "invalid JSON"}`,
+      },
+      recovery: replicaResult.code === 2 ? "catalyst-skills login" : "catalyst-skills replica status --probe --json",
+    };
+  }
+  const eventsResult = run(EVENTS_COMMAND);
+  try {
+    events = JSON.parse(eventsResult.stdout);
+  } catch {
+    return {
+      status,
+      events: null,
+      assessment: {
+        verdict: "unknown",
+        current: false,
+        reason: `event freshness is unknown: ${eventsResult.error || eventsResult.stderr.trim() || "invalid JSON"}`,
+      },
+      recovery: "catalyst-skills events status --probe --json",
+    };
+  }
+  return { status, events, assessment: assessLocalSync(status, events) };
+}
+
+/** A bounded check. Starting the optional writer requires an explicit opt-in. */
+export async function runLocalSync({
+  start = false,
+  waitSeconds = 90,
+  run = defaultRun,
+  now = Date.now,
+  sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+} = {}) {
+  if (!Number.isInteger(waitSeconds) || waitSeconds < 0 || waitSeconds > 300)
+    throw new Error("--wait must be an integer from 0 to 300 seconds");
+  let reading = readStatus(run);
+  if (reading.assessment.current || !start)
+    return { ...reading, started: false, recovery: reading.recovery ?? RECOVERY_COMMAND };
+  if (!reading.status)
+    return { ...reading, started: false, recovery: reading.recovery ?? "catalyst-skills replica status --probe --json" };
+  if (
+    reading.status?.verdict === "not-configured" ||
+    reading.status?.dbPath == null
+  ) {
+    return { ...reading, started: false, recovery: "catalyst-skills login" };
+  }
+  let started = false;
+  if (reading.status.writerAlive !== true && ["absent", "stale"].includes(reading.assessment.verdict)) {
+    const result = run(START_COMMAND);
+    if (result.code !== 0) {
+      return {
+        status: reading.status,
+        events: reading.events,
+        assessment: {
+          verdict: "unknown",
+          current: false,
+          reason: `writer start failed: ${result.error || result.stderr.trim() || result.stdout.trim()}`,
+        },
+        started: false,
+        recovery: RECOVERY_COMMAND,
+      };
+    }
+    started = true;
+  }
+  const deadline = now() + waitSeconds * 1000;
+  do {
+    reading = readStatus(run);
+    if (reading.assessment.current || now() >= deadline) break;
+    await sleep(Math.min(3000, deadline - now()));
+  } while (true);
+  return {
+    ...reading,
+    started,
+    recovery: reading.assessment.verdict === "unknown"
+      ? "node scripts/local-sync.mjs --json"
+      : reading.status?.writerAlive
+        ? "catalyst-skills replica stop && catalyst-skills replica start --detach"
+        : RECOVERY_COMMAND,
+  };
+}
+
+function parseArgs(argv) {
+  const opts = { start: false, waitSeconds: 90, json: false };
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === "--start") opts.start = true;
+    else if (argv[i] === "--json") opts.json = true;
+    else if (argv[i] === "--wait") opts.waitSeconds = Number(argv[++i]);
+    else if (argv[i] === "--help") {
+      console.log(
+        "Usage: node scripts/local-sync.mjs [--start] [--wait 0..300] [--json]\nWithout --start, this only checks status. Local sync is optional.",
+      );
+      process.exit(0);
+    } else throw new Error(`Unknown argument: ${argv[i]}`);
+  }
+  return opts;
+}
+
+if (process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]) {
+  try {
+    const opts = parseArgs(process.argv.slice(2));
+    const result = await runLocalSync(opts);
+    if (opts.json) console.log(JSON.stringify(result));
+    else {
+      const label = result.assessment.verdict === "current" ? "current" : result.assessment.verdict;
+      console.log(`Local sync ${label}: ${result.assessment.reason}`);
+      if (!result.assessment.current) console.log(`Next: ${result.recovery}`);
+    }
+    process.exitCode = result.assessment.verdict === "current" ? 0 : result.assessment.verdict === "stale" ? 1 : result.assessment.verdict === "absent" ? 3 : 2;
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 2;
+  }
+}

package/skills/catalyst-onboard/scripts/where-am-i.mjs

@@ -6,6 +6,7 @@
 //
 // Every count and every name below is read off what a verb printed. Nothing here is written down.
 import { cliTarget, CONNECT_LINE, parseFlags, printHelp, runCli, tryJson, tryLoadConfig } from "./lib/cli.mjs";
+import { runLocalSync } from "./local-sync.mjs";
 
 const SPEC = {
   next: { help: "print only the single next step" },
@@ -13,7 +14,8 @@ const SPEC = {
 };
 const NOTES = [
   "Reads, in this order: `status` (machine), `ready --json` (machine checks and project checks, kept apart),",
-  "`me --json` (person), `contract --path …` for the account, the projects and the repositories,",
+  "`replica status --probe --json` and `events status --probe --json` (optional local freshness),",
+  "`me --json` and personal connection statuses (person), `contract --path …` for the account, the projects and the repositories,",
   "`contract --path codingAccounts` (coding accounts; `accounts --json` on an older cloud), and each",
   "project's hosts_current check with its fixedWhere (host).",
   "Writes nothing and changes nothing. Runs before this machine is connected — that is one of the states it reports.",
@@ -31,6 +33,13 @@ if (positionals.length > 0) {
 
 const via = cliTarget().via;
 const parts = [];
+const personalConnections = {};
+let personalGrantIncomplete = false;
+let personalLinearIncomplete = false;
+let personalGithubIncomplete = false;
+let personalNext = null;
+let workspaceResolved = false;
+let repositoryRegistered = false;
 // `blocking` is false for a finding that is real and reportable but does not stop the next step —
 // an unmatched Linear identity is the one that matters: it must be said, and it must not become the
 // thing the person is told to go and do before they can map a project.
@@ -64,6 +73,7 @@ let machineVerdict = connected ? "ok" : "unfinished";
 // whose id begins with "team:" belongs to a project and cannot be moved from this machine.
 let projectChecks = [];
 let machineFix = null;
+let localSync;
 if (connected) {
   const ready = runCli(["ready", "--json"]);
   const report = tryJson(ready.stdout);
@@ -81,6 +91,17 @@ if (connected) {
       machineFix = failed.find((c) => typeof c.fix === "string")?.fix ?? null;
     }
   }
+  // Supplemental only: local caches are optional and do not change setup completion or --next.
+  localSync = await runLocalSync({ waitSeconds: 0 });
+  machineLines.push(
+    `note optional local sync ${localSync.assessment.verdict}: ${localSync.assessment.reason}; check with 'node scripts/local-sync.mjs', and start only with the person's opt-in via 'node scripts/local-sync.mjs --start'`,
+  );
+} else {
+  localSync = {
+    assessment: { verdict: "unknown", current: false, reason: "connect this machine before local freshness can be checked" },
+    started: false,
+    recovery: "catalyst-skills login",
+  };
 }
 add(
   "machine",
@@ -111,13 +132,35 @@ if (!connected) {
     );
   } else {
     const matched = typeof user.linearUserId === "string" && user.linearUserId !== "";
+    const grantLines = [];
+    for (const provider of ["linear", "github"]) {
+      const read = runCli(["connections", "personal", provider, "status", "--json"]);
+      const result = tryJson(read.stdout);
+      const outcome = typeof result?.outcome === "string" ? result.outcome : "unreadable";
+      personalConnections[provider] = outcome;
+      if (outcome === "connected") {
+        grantLines.push(`personal ${provider}: connected`);
+      } else if (outcome === "absent" || outcome === "lapsed") {
+        personalGrantIncomplete = true;
+        if (provider === "linear") personalLinearIncomplete = true;
+        else personalGithubIncomplete = true;
+        grantLines.push(`personal ${provider}: ${outcome === "absent" ? "not connected" : "expired"}`);
+        if (provider === "linear") personalNext ??= "connect your personal linear account";
+      } else {
+        personalGrantIncomplete = true;
+        if (provider === "linear") personalLinearIncomplete = true;
+        else personalGithubIncomplete = true;
+        grantLines.push(`personal ${provider}: ${outcome === "unavailable" ? "temporarily unavailable; grant state unknown" : "could not be checked; update the catalyst-skills CLI or inspect its status output"}`);
+        if (provider === "linear") personalNext ??= "re-check your personal linear connection";
+      }
+    }
     add(
       "person",
-      "catalyst-skills me",
-      matched ? "ok" : "unfinished",
-      [`${user.label ?? "(unnamed)"} (${user.role ?? "role unknown"})`, matched ? "Linear identity matched" : "Linear identity NOT matched — asks assigned to you cannot be told apart from everyone else's. It blocks nothing below; get it fixed when convenient."],
-      matched ? null : "a tenant owner or admin",
-      matched ? null : link("/settings/account"),
+      "catalyst-skills me, and catalyst-skills connections personal <provider> status --json",
+      matched && !personalGrantIncomplete ? "ok" : "unfinished",
+      [`${user.label ?? "(unnamed)"} (${user.role ?? "role unknown"})`, matched ? "Linear identity matched" : "Linear identity NOT matched — asks assigned to you cannot be told apart from everyone else's. It blocks nothing below. Run catalyst-skills identity linear options for self-service recovery; personal Linear consent normally binds its viewer automatically.", ...grantLines],
+      personalGrantIncomplete ? "you" : matched ? null : "a tenant owner or admin",
+      personalGrantIncomplete ? "catalyst-skills connections personal <provider> start or status" : matched ? null : link("/settings/account"),
       false,
     );
   }
@@ -133,6 +176,7 @@ if (!connected) {
     add("account", "catalyst-skills contract --path account", "unreadable", ["the account block could not be read — try: catalyst-skills contract --refresh"], null, null);
   } else {
     const workspace = typeof doc.linearWorkspaceSlug === "string" && doc.linearWorkspaceSlug !== "" ? doc.linearWorkspaceSlug : typeof doc.linearWorkspaceId === "string" && doc.linearWorkspaceId !== "" ? doc.linearWorkspaceId : null;
+    workspaceResolved = workspace !== null;
     // The declaration is the one part of the account a key can also READ — and it is the one part a
     // key can WRITE, so it is reported here rather than left to the settings page like the rest.
     const envLines = [];
@@ -212,6 +256,7 @@ if (!connected) {
     add("repositories", "catalyst-skills contract --path merge.repositories", "unreadable", ["the repository list could not be read — try: catalyst-skills contract --refresh"], null, null);
   } else {
     const lines = [`${rows.length} registered`, ...rows.map((r) => `${r.owner ?? "?"}/${r.name ?? "?"}`)];
+    repositoryRegistered = rows.length > 0;
     lines.push("⛔ REGISTRATION only. This carries no status and no project attachment, so it never proves a repository can be dispatched into.");
     add("repositories", "catalyst-skills contract --path merge.repositories", rows.length > 0 ? "ok" : "unfinished", lines, "a tenant owner or admin", link("/settings/repositories"));
   }
@@ -309,13 +354,28 @@ const machineNext = connected
   : "connect this machine";
 const NEXT = {
   machine: machineNext,
-  person: "get this person's seat and Linear identity sorted",
+  person: personalLinearIncomplete
+    ? personalNext
+    : personalGithubIncomplete && repositoryRegistered
+      ? "connect your personal github account"
+      : personalGithubIncomplete
+        ? "install the tenant GitHub App and register its repository before connecting your personal GitHub account"
+        : "get this person's seat and Linear identity sorted",
   account: "connect Linear, and install the GitHub App",
   projects: "pick ONE project and map its stages (or adopt the Catalyst workflow)",
   repositories: "register the repository, attaching it to the project you mapped",
   "coding accounts": accountsNext,
   host: "connect a Catalyst host",
 };
+// A personal Linear grant cannot start until the tenant's Linear workspace exists. Once that account
+// connection is present, a missing personal grant becomes the next member step before project setup.
+const personPart = parts.find((p) => p.part === "person");
+// A personal Linear grant is the next provider step once the tenant workspace exists. A personal
+// GitHub grant is sequenced after the tenant GitHub App: successful repository registration is the
+// onboarding path's existing proof that the App installation is usable.
+if (personPart && personalGrantIncomplete && workspaceResolved) {
+  personPart.blocking = personalLinearIncomplete || (personalGithubIncomplete && repositoryRegistered);
+}
 const blocked = parts.filter((p) => p.verdict !== "ok" && p.blocking);
 const stuck = blocked[0] ?? parts.find((p) => p.verdict !== "ok") ?? null;
 const next =
@@ -325,7 +385,7 @@ const next =
 const finished = parts.every((p) => p.verdict === "ok");
 
 if (flags.json) {
-  console.log(JSON.stringify({ cli: via, connected, cloud, parts, next, finished }));
+  console.log(JSON.stringify({ cli: via, connected, cloud, personalConnections, parts, localSync, next, finished }));
 } else if (flags.next) {
   if (next === null) console.log("nothing left: every part is finished, a coding account is enrolled and the host check passes. Move one card into the project's dispatch stage.");
   else console.log(`${next.part}: ${next.action}${next.blocking ? "" : " (does not block the steps below)"}${next.owner ? ` — who: ${next.owner}` : ""}${next.where ? ` — ${next.where.startsWith("http") ? "where" : "do"}: ${next.where}` : ""}`);

package/skills/catalyst-setup/SKILL.md

@@ -4,7 +4,7 @@ description: >-
   Am I set up? Machine readiness (Node, the tenant connection, the cached contract, the CLI path, the skills, the SDK, the optional replica) plus tenant readiness from the contract's per-team checks, in one verdict: what passes, what is blocked, what is merely waiting, and who can click what. Use when someone asks "am I set up", "what is missing", "why does nothing happen", "is the replica running", or right after connecting a new machine. Reports; never repairs.
 allowed-tools: Bash(catalyst-skills:*) Bash(npx @catalyst-cloud/catalyst-skills:*)
 ---
-<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.8.0 — written in this repository for customer tenants -->
+<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.9.1 — written in this repository for customer tenants -->
 
 # Am I set up?
 

package/skills/catalyst-setup/references/what-each-check-means.md

@@ -22,7 +22,7 @@ The contract's `readinessChecks[]` is the list of record. A check that appears t
 | `writes_land` | Catalyst has written to this team successfully | "no write observed" is waiting, not failing: it clears the first time Catalyst moves a ticket. "Write refused" means Linear rejected the last write: check the connection and the team's permissions | owner or admin when refused; otherwise nobody |
 | `webhook_covers_team` | events for this team are arriving | confirmed once a repository is registered and events flow; "no delivery observed" is waiting | owner or admin, by registering the repository |
 | `hosts_current` | no connected host runs an older mapping revision | a host that is behind re-loads the mapping on its next connect; a host that did not report its revision is flagged rather than assumed current; "no host connected" is waiting | whoever runs that host |
-| `environment_declared` | a committed environment declaration for the team's default repository is in effect (`catalyst.env.json` at the repository root was ingested, is valid, and its latest proposal is approved) | `no_team_repo_default`: register a repository and make it the team's default; `no_environment_declaration`: commit the declaration file to that repository; `declaration_invalid` / `declaration_read_failed`: fix the file (the ingest names the error); `declaration_awaiting_approval`: an owner or admin approves the proposal in Settings → Environment | owner or admin, except committing the file, which is whoever can push to the repository |
+| `environment_declared` | a committed environment declaration for the team's default repository is in effect (`.catalyst/catalyst.toml` on the default branch was ingested, is valid, and its latest proposal is approved) | `no_team_repo_default`: register a repository and make it the team's default; `no_environment_declaration`: commit `.catalyst/catalyst.toml` with its `[environment]` names to that repository's default branch; `declaration_invalid` / `declaration_read_failed`: fix the file (the ingest names the error); `declaration_awaiting_approval`: an owner or admin opens Settings → Repositories → the repository → Environment → Setup declaration and clicks Approve this revision | owner or admin, except committing the file, which is whoever can push to the repository |
 | `tools_resolvable` | every MCP server and CLI the team's approved environment declaration names can be resolved for that team's repository | `tool_reference_unresolved`: the declaration names a vault secret that does not exist — add it at the right scope or correct the declaration; `toolchain_cli_missing`: a declared CLI is not in the runner image, which is not self-service; `tool_declarations_unread` reads as `unknown` and clears itself | owner or admin, in the declaration or Settings → Environment |
 | `reviewer_required` | this team's repository can merge under its own merge policy with the reviewers configured | it fails only under a strict merge policy with no reviewer — configure one at Settings → Repositories → Code reviews, or change the repository's merge policy; work still runs, only the merge waits | owner or admin, in settings |
 | `reviewer_configured` | a code reviewer is configured for this team's repository at all, whatever the current policy requires | a *failing* `reviewer_configured` never blocks or degrades a team — with no reviewer, pull requests merge on green checks and resolved threads alone; configure one at Settings → Repositories → Code reviews. An `unknown` one (`merge_reviewer_unread`: the reviewer registry could not be read) still degrades the team, like any unknown | owner or admin, in settings; nobody is required when it fails |

package/skills/connect-me/SKILL.md

@@ -5,7 +5,7 @@ description: >-
 disable-model-invocation: true
 allowed-tools: Bash(catalyst-skills:*) Bash(npx @catalyst-cloud/catalyst-skills:*)
 ---
-<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.8.0 — written in this repository for customer tenants -->
+<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.9.1 — written in this repository for customer tenants -->
 
 # Connect me
 

package/skills/how-catalyst-works/SKILL.md

@@ -4,7 +4,7 @@ description: >-
   How Catalyst Cloud runs a ticket on the customer's own tenant, as facts an agent loads on demand: the eight-phase ladder and what each phase produces, the eleven board slots and this team's live stage map, what happens when a phase fails (retry, backoff, Remediate, park), how the queue is ordered and routed and every reason a ticket is excluded, and the coding-account model. Use when a person asks "how does this work?", "why did it do that?", "why is this stuck?", "what runs next?" or "how does it prioritise?". Read-only; its scripts explain one ticket's eligibility in plain English, show what is running and queued, and print the tenant's stage map and thresholds straight from the contract.
 allowed-tools: Bash(catalyst-skills:*) Bash(npx @catalyst-cloud/catalyst-skills:*)
 ---
-<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.8.0 — written in this repository for customer tenants -->
+<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.9.1 — written in this repository for customer tenants -->
 
 # How Catalyst works
 

package/skills/how-catalyst-works/references/stages-and-mapping.md

@@ -30,7 +30,7 @@ The contract's `teams[].workflowMode` reports which one a team is in:
 
 `teams[].gitAutomation` is a stored consent for a feature that is not built yet (Catalyst managing a team's Linear git automations); nothing reads it, so `off` never stops work and turning it on would start none. What decides whether a team's tickets start is the mapping above: until dispatch, pr, done and canceled each point at a live stage, Catalyst starts nothing in that team, and `explain` says so by name.
 
-Stage mappings live in the app, at Settings → Linear teams. The cloud does not read `.catalyst/catalyst.toml` yet, so a mapping written there changes nothing today. An older `.catalyst/config.json` is not imported.
+Stage mappings live in the app, at Settings → Linear teams. The cloud reads each repository's `.catalyst/catalyst.toml`, but that file has no stage-mapping section, so a mapping written there changes nothing. An older `.catalyst/config.json` is not imported.
 
 ## The state id is the authority; names are display
 

package/skills/run-this-project/SKILL.md

@@ -5,7 +5,7 @@ description: >-
 disable-model-invocation: true
 allowed-tools: Bash(catalyst-skills:*) Bash(npx @catalyst-cloud/catalyst-skills:*)
 ---
-<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.8.0 — written in this repository for customer tenants -->
+<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.9.1 — written in this repository for customer tenants -->
 
 # Run this project
 

package/skills/unstick/SKILL.md

@@ -5,7 +5,7 @@ description: >-
 disable-model-invocation: true
 allowed-tools: Bash(catalyst-skills:*) Bash(npx @catalyst-cloud/catalyst-skills:*)
 ---
-<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.8.0 — written in this repository for customer tenants -->
+<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.9.1 — written in this repository for customer tenants -->
 
 # Unstick
 

package/skills/what-needs-me/SKILL.md

@@ -5,7 +5,7 @@ description: >-
 disable-model-invocation: true
 allowed-tools: Bash(catalyst-skills:*) Bash(npx @catalyst-cloud/catalyst-skills:*)
 ---
-<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.8.0 — written in this repository for customer tenants -->
+<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.9.1 — written in this repository for customer tenants -->
 
 # What needs me
 

package/skills/whats-happening/SKILL.md

@@ -4,7 +4,7 @@ description: >-
   The desk for a Catalyst Cloud tenant. Use when the person asks "what's happening?", "where are we?", "why is that stuck?", "what closed?", "what's next?", or asks for something to be done rather than known. Reads the tenant contract, what is running and queued, the eligibility explainer and the open asks through the catalyst-skills CLI, and answers in one reply with ticket ids. Routes work to a project owner and decisions to what-needs-me. Never composes a URL, never polls, never answers as the human.
 allowed-tools: Bash(catalyst-skills:*) Bash(npx @catalyst-cloud/catalyst-skills:*)
 ---
-<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.8.0 — written in this repository for customer tenants -->
+<!-- vendored-from: @catalyst-cloud/catalyst-skills@0.9.1 — written in this repository for customer tenants -->
 
 # What's happening