@spacefast/common 0.0.24 → 0.2.1

package/dist/agents/registry/deeplink-probes.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Deeplink probe results, keyed `<agentId>:<methodId>`.
+ *
+ * Deeplinks are volatile vendor behavior, so the registry never asserts they
+ * work — it records what a probe last observed. This module is the ONLY place a
+ * status stronger than `declared` may come from, and it is written by
+ * `scripts/marketplaces/probe-deeplinks.mjs` (scheduled weekly by
+ * `.github/workflows/deeplink-probe.yml`). A `failed` entry demotes its deeplink
+ * out of `interactive-primary` automatically, so the page falls through to the
+ * method's declared fallback.
+ *
+ * Browser-safe by construction: plain data, no filesystem, no network.
+ *
+ * TODO(deeplink-probe): the probe currently only writes this file by hand-run.
+ * Wire the scheduled workflow to open a PR with the regenerated map so a broken
+ * vendor deeplink demotes itself without a human in the loop.
+ */
+export type DeeplinkProbeResult = Readonly<{
+    checkedAt: string;
+    evidence?: string;
+    status: "probed" | "failed";
+}>;
+export declare const DEEPLINK_PROBE_RESULTS: Readonly<Record<string, DeeplinkProbeResult>>;

package/dist/agents/registry/deeplink-probes.js

@@ -0,0 +1,18 @@
+/**
+ * Deeplink probe results, keyed `<agentId>:<methodId>`.
+ *
+ * Deeplinks are volatile vendor behavior, so the registry never asserts they
+ * work — it records what a probe last observed. This module is the ONLY place a
+ * status stronger than `declared` may come from, and it is written by
+ * `scripts/marketplaces/probe-deeplinks.mjs` (scheduled weekly by
+ * `.github/workflows/deeplink-probe.yml`). A `failed` entry demotes its deeplink
+ * out of `interactive-primary` automatically, so the page falls through to the
+ * method's declared fallback.
+ *
+ * Browser-safe by construction: plain data, no filesystem, no network.
+ *
+ * TODO(deeplink-probe): the probe currently only writes this file by hand-run.
+ * Wire the scheduled workflow to open a PR with the regenerated map so a broken
+ * vendor deeplink demotes itself without a human in the loop.
+ */
+export const DEEPLINK_PROBE_RESULTS = {};

package/dist/agents/registry/node.d.ts

@@ -0,0 +1,56 @@
+import { type AgentCapability, type AgentId } from "./core.js";
+export type AgentRegistryEnvironment = Readonly<Record<string, string | undefined>>;
+export type AgentMcpFormat = "codex-toml" | "flat-json" | "mcp-json" | "opencode-json" | "vscode-json" | "zed-json";
+export type AgentMcpMethod = "local" | "remote-proxy" | "remote-oauth";
+export type AgentMcpValue = boolean | null | number | string | readonly AgentMcpValue[] | Readonly<{
+    [key: string]: AgentMcpValue;
+}>;
+export type AgentMcpServerConfig = Readonly<{
+    [key: string]: AgentMcpValue;
+}>;
+export type AgentMcpServerConfigEncoder = Readonly<{
+    format: AgentMcpFormat;
+    rootKey: "context_servers" | "mcp" | "mcpServers" | "servers" | null;
+    schemaUrl?: string;
+    build: (input: {
+        command: string;
+        endpoint: string;
+        method: AgentMcpMethod;
+        resource: string | null;
+    }) => AgentMcpServerConfig;
+}>;
+export type AgentNodeEntry = Readonly<{
+    capabilities: readonly AgentCapability[];
+    detectionPaths: (home: string, cwd: string, env: AgentRegistryEnvironment) => readonly string[];
+    id: AgentId;
+    mcp: Readonly<{
+        configPath: (home: string, cwd: string, env: AgentRegistryEnvironment) => string;
+        format: AgentMcpFormat;
+        serverConfigEncoder: AgentMcpServerConfigEncoder;
+    }> | null;
+    name: string;
+    skillDir: Readonly<{
+        alternativeGlobalPaths: (home: string, cwd: string, env: AgentRegistryEnvironment) => readonly string[];
+        global: (home: string, cwd: string, env: AgentRegistryEnvironment) => string;
+        project: (home: string, cwd: string, env: AgentRegistryEnvironment) => string;
+    }> | null;
+}>;
+export declare const MACHINE_AGENT_IDS: ("amp" | "hermes" | "claude-code" | "claude-app" | "claude-desktop" | "cursor" | "codex" | "chatgpt" | "vscode" | "github-copilot" | "devin-desktop" | "devin-cloud" | "zed" | "gemini-cli" | "opencode" | "warp" | "factory-droid" | "cline" | "continue" | "raycast" | "poke" | "pi" | "indent" | "openclaw")[];
+export declare function agentNodeCatalog(input: {
+    cwd: string;
+    env?: AgentRegistryEnvironment;
+    home: string;
+}): readonly AgentNodeEntry[];
+export declare function getAgentNodeEntry(id: AgentId, input: {
+    cwd: string;
+    env?: AgentRegistryEnvironment;
+    home: string;
+}): AgentNodeEntry | null;
+export declare function buildAgentMcpServerConfig(input: {
+    agentId: AgentId;
+    command: string;
+    endpoint: string;
+    method: AgentMcpMethod;
+    resource: string | null;
+}): AgentMcpServerConfig;
+export declare function agentEnvironmentHint(env: AgentRegistryEnvironment): AgentId | null;

package/dist/agents/registry/node.js

@@ -0,0 +1,339 @@
+import path from "node:path";
+import { AGENT_REGISTRY, getAgentEntry, } from "./core.js";
+const commonEncoder = {
+    format: "mcp-json",
+    rootKey: "mcpServers",
+    build: ({ command, endpoint, method, resource }) => {
+        if (method !== "remote-oauth") {
+            return { command, args: method === "remote-proxy" ? ["mcp", "proxy"] : ["mcp"] };
+        }
+        return { type: "http", url: endpoint, oauth_resource: resource };
+    },
+};
+/**
+ * Cursor takes the same `type: "http"` remote entry every other `mcpServers`
+ * client does. The bare `{ url }` this used to write is the shape nobody ships:
+ * it disagreed with the registry's own Cursor config and with the comparable
+ * vendors, and several clients read a bare url as a stdio command.
+ */
+const cursorEncoder = commonEncoder;
+/**
+ * Gemini CLI's own dialect: `httpUrl` plus an explicit `oauth` block, not
+ * `type` + `url` (spec §5.13 dialect table).
+ */
+const geminiEncoder = {
+    ...commonEncoder,
+    build: ({ command, endpoint, method }) => method === "remote-oauth"
+        ? { httpUrl: endpoint, oauth: { enabled: true } }
+        : { command, args: method === "remote-proxy" ? ["mcp", "proxy"] : ["mcp"] },
+};
+const vscodeEncoder = {
+    format: "vscode-json",
+    rootKey: "servers",
+    build: ({ command, endpoint, method }) => method === "remote-oauth"
+        ? { type: "http", url: endpoint }
+        : {
+            type: "stdio",
+            command,
+            args: method === "remote-proxy" ? ["mcp", "proxy"] : ["mcp"],
+        },
+};
+const codexEncoder = {
+    format: "codex-toml",
+    rootKey: null,
+    build: ({ command, endpoint, method, resource }) => method === "remote-oauth"
+        ? { url: endpoint, oauth_resource: resource }
+        : { command, args: method === "remote-proxy" ? ["mcp", "proxy"] : ["mcp"] },
+};
+const opencodeEncoder = {
+    format: "opencode-json",
+    rootKey: "mcp",
+    schemaUrl: "https://opencode.ai/config.json",
+    build: ({ command, endpoint, method }) => method === "remote-oauth"
+        ? { type: "remote", url: endpoint, enabled: true }
+        : {
+            type: "local",
+            command: [command, ...(method === "remote-proxy" ? ["mcp", "proxy"] : ["mcp"])],
+            enabled: true,
+        },
+};
+const copilotEncoder = {
+    ...commonEncoder,
+    build: (input) => ({ ...commonEncoder.build(input), tools: ["*"] }),
+};
+const droidEncoder = {
+    ...commonEncoder,
+    build: (input) => ({
+        ...commonEncoder.build(input),
+        type: input.method === "remote-oauth" ? "http" : "stdio",
+        disabled: false,
+    }),
+};
+const zedEncoder = {
+    format: "zed-json",
+    rootKey: "context_servers",
+    build: ({ command, endpoint, method }) => method === "remote-oauth"
+        ? { source: "custom", url: endpoint, settings: {} }
+        : {
+            source: "custom",
+            command: {
+                path: command,
+                args: method === "remote-proxy" ? ["mcp", "proxy"] : ["mcp"],
+            },
+        },
+};
+const ampEncoder = {
+    format: "flat-json",
+    rootKey: null,
+    build: ({ command, endpoint, method }) => method === "remote-oauth"
+        ? { url: endpoint }
+        : { command, args: method === "remote-proxy" ? ["mcp", "proxy"] : ["mcp"] },
+};
+const clineEncoder = {
+    ...commonEncoder,
+    build: ({ command, endpoint, method }) => method === "remote-oauth"
+        ? { type: "streamableHttp", url: endpoint, disabled: false }
+        : {
+            type: "stdio",
+            command,
+            args: method === "remote-proxy" ? ["mcp", "proxy"] : ["mcp"],
+            disabled: false,
+        },
+};
+const universalSkill = {
+    global: ({ home }) => path.join(home, ".agents", "skills"),
+    project: ({ cwd }) => path.join(cwd, ".agents", "skills"),
+};
+const definitions = [
+    {
+        id: "claude-code",
+        detection: ({ home }) => [path.join(home, ".claude")],
+        skill: {
+            global: ({ home }) => path.join(home, ".claude", "skills"),
+            project: ({ cwd }) => path.join(cwd, ".claude", "skills"),
+            alternatives: ({ home }) => [path.join(home, ".agents", "skills")],
+        },
+        mcp: { config: ({ home }) => path.join(home, ".claude.json"), encoder: commonEncoder },
+    },
+    {
+        id: "cursor",
+        detection: ({ home }) => [path.join(home, ".cursor")],
+        skill: {
+            global: ({ home }) => path.join(home, ".cursor", "skills"),
+            project: universalSkill.project,
+            alternatives: ({ home }) => [
+                path.join(home, ".agents", "skills"),
+                path.join(home, ".claude", "skills"),
+            ],
+        },
+        mcp: { config: ({ home }) => path.join(home, ".cursor", "mcp.json"), encoder: cursorEncoder },
+    },
+    {
+        id: "codex",
+        detection: ({ env, home }) => [codexHome(home, env)],
+        skill: {
+            global: ({ env, home }) => path.join(codexHome(home, env), "skills"),
+            project: universalSkill.project,
+            alternatives: ({ home }) => [path.join(home, ".agents", "skills")],
+        },
+        mcp: {
+            config: ({ env, home }) => path.join(codexHome(home, env), "config.toml"),
+            encoder: codexEncoder,
+        },
+    },
+    {
+        id: "vscode",
+        detection: ({ home }) => [
+            path.join(home, ".vscode"),
+            path.join(home, "Library", "Application Support", "Code"),
+            path.join(home, ".config", "Code"),
+        ],
+        skill: universalSkill,
+        mcp: { config: ({ cwd }) => path.join(cwd, ".vscode", "mcp.json"), encoder: vscodeEncoder },
+    },
+    {
+        id: "github-copilot",
+        detection: ({ home }) => [path.join(home, ".copilot")],
+        skill: {
+            global: ({ home }) => path.join(home, ".copilot", "skills"),
+            project: universalSkill.project,
+            alternatives: ({ home }) => [path.join(home, ".agents", "skills")],
+        },
+        mcp: {
+            config: ({ home }) => path.join(home, ".copilot", "mcp-config.json"),
+            encoder: copilotEncoder,
+        },
+    },
+    {
+        id: "devin-desktop",
+        detection: ({ home }) => [path.join(home, ".devin")],
+        skill: universalSkill,
+        mcp: {
+            config: ({ home }) => path.join(home, ".devin", "mcp_config.json"),
+            encoder: commonEncoder,
+        },
+    },
+    {
+        id: "zed",
+        detection: ({ home }) => [path.join(home, ".config", "zed")],
+        skill: universalSkill,
+        mcp: {
+            config: ({ home }) => path.join(home, ".config", "zed", "settings.json"),
+            encoder: zedEncoder,
+        },
+    },
+    {
+        id: "gemini-cli",
+        detection: ({ home }) => [path.join(home, ".gemini")],
+        skill: {
+            ...universalSkill,
+            alternatives: ({ home }) => [path.join(home, ".gemini", "skills")],
+        },
+        mcp: {
+            config: ({ home }) => path.join(home, ".gemini", "settings.json"),
+            encoder: geminiEncoder,
+        },
+    },
+    {
+        id: "opencode",
+        detection: ({ home }) => [path.join(home, ".config", "opencode")],
+        skill: {
+            global: ({ home }) => path.join(home, ".config", "opencode", "skills"),
+            project: universalSkill.project,
+            alternatives: ({ home }) => [
+                path.join(home, ".agents", "skills"),
+                path.join(home, ".claude", "skills"),
+            ],
+        },
+        mcp: {
+            config: ({ home }) => path.join(home, ".config", "opencode", "opencode.json"),
+            encoder: opencodeEncoder,
+        },
+    },
+    {
+        id: "amp",
+        detection: ({ home }) => [path.join(home, ".config", "amp")],
+        skill: universalSkill,
+        mcp: {
+            config: ({ home }) => path.join(home, ".config", "amp", "mcp.json"),
+            encoder: ampEncoder,
+        },
+    },
+    {
+        id: "warp",
+        detection: ({ home }) => [path.join(home, ".warp")],
+        skill: universalSkill,
+        mcp: { config: ({ home }) => path.join(home, ".warp", "mcp.json"), encoder: commonEncoder },
+    },
+    {
+        id: "factory-droid",
+        detection: ({ home }) => [path.join(home, ".factory")],
+        skill: {
+            global: ({ home }) => path.join(home, ".factory", "skills"),
+            project: ({ cwd }) => path.join(cwd, ".factory", "skills"),
+            alternatives: ({ home }) => [path.join(home, ".agents", "skills")],
+        },
+        mcp: { config: ({ home }) => path.join(home, ".factory", "mcp.json"), encoder: droidEncoder },
+    },
+    {
+        id: "cline",
+        detection: ({ home }) => [path.join(home, ".cline")],
+        skill: {
+            global: ({ home }) => path.join(home, ".cline", "skills"),
+            project: ({ cwd }) => path.join(cwd, ".cline", "skills"),
+            alternatives: ({ home }) => [
+                path.join(home, ".agents", "skills"),
+                path.join(home, ".claude", "skills"),
+            ],
+        },
+        mcp: {
+            config: ({ home }) => path.join(home, ".cline", "data", "settings", "cline_mcp_settings.json"),
+            encoder: clineEncoder,
+        },
+    },
+    {
+        id: "continue",
+        detection: ({ cwd, home }) => [path.join(cwd, ".continue"), path.join(home, ".continue")],
+        skill: {
+            global: ({ home }) => path.join(home, ".continue", "skills"),
+            project: ({ cwd }) => path.join(cwd, ".continue", "skills"),
+            alternatives: ({ home }) => [path.join(home, ".claude", "skills")],
+        },
+    },
+    {
+        id: "pi",
+        detection: ({ home }) => [path.join(home, ".pi")],
+        skill: universalSkill,
+    },
+    {
+        id: "hermes",
+        detection: ({ home }) => [path.join(home, ".hermes")],
+        skill: universalSkill,
+    },
+    {
+        id: "openclaw",
+        detection: ({ home }) => [path.join(home, ".openclaw")],
+        skill: universalSkill,
+    },
+];
+const definitionById = new Map(definitions.map((definition) => [definition.id, definition]));
+export const MACHINE_AGENT_IDS = AGENT_REGISTRY.filter((entry) => entry.machineClient).map((entry) => entry.id);
+export function agentNodeCatalog(input) {
+    const context = { cwd: input.cwd, env: input.env ?? {}, home: input.home };
+    return definitions.map((definition) => materializeNodeEntry(definition, context));
+}
+export function getAgentNodeEntry(id, input) {
+    const definition = definitionById.get(id);
+    if (!definition)
+        return null;
+    return materializeNodeEntry(definition, {
+        cwd: input.cwd,
+        env: input.env ?? {},
+        home: input.home,
+    });
+}
+export function buildAgentMcpServerConfig(input) {
+    const definition = definitionById.get(input.agentId);
+    if (!definition?.mcp) {
+        return commonEncoder.build(input);
+    }
+    return definition.mcp.encoder.build(input);
+}
+export function agentEnvironmentHint(env) {
+    const termProgram = env.TERM_PROGRAM?.toLowerCase() ?? "";
+    if (env.CURSOR_TRACE_ID || termProgram.includes("cursor"))
+        return "cursor";
+    if (env.CLAUDECODE || env.CLAUDE_CODE)
+        return "claude-code";
+    if (env.CODEX_HOME)
+        return "codex";
+    if (env.VSCODE_PID || termProgram.includes("vscode"))
+        return "vscode";
+    return null;
+}
+function materializeNodeEntry(definition, context) {
+    const agent = getAgentEntry(definition.id);
+    return {
+        capabilities: agent.capabilities,
+        detectionPaths: () => definition.detection(context),
+        id: definition.id,
+        mcp: definition.mcp
+            ? {
+                configPath: () => definition.mcp?.config(context) ?? "",
+                format: definition.mcp.encoder.format,
+                serverConfigEncoder: definition.mcp.encoder,
+            }
+            : null,
+        name: agent.name,
+        skillDir: definition.skill
+            ? {
+                alternativeGlobalPaths: () => definition.skill?.alternatives?.(context) ?? [],
+                global: () => definition.skill?.global(context) ?? path.join(context.home, ".agents", "skills"),
+                project: () => definition.skill?.project(context) ?? path.join(context.cwd, ".agents", "skills"),
+            }
+            : null,
+    };
+}
+function codexHome(home, env) {
+    return env.CODEX_HOME?.trim() || path.join(home, ".codex");
+}

package/dist/brand-assets-build.js

@@ -5,7 +5,7 @@
  * and render ordinary SVG markup from its constants. Only asset generators,
  * plugin packaging, and other build steps may import this module.
  */
-import { SPACEFAST_BRAND_COLORS, SPACEFAST_ICON_F_OFFSET_X, SPACEFAST_ICON_F_PATH, SPACEFAST_ICON_LETTER_ORIGIN, SPACEFAST_ICON_LETTER_SCALE, SPACEFAST_ICON_S_PATH, SPACEFAST_ICON_SHADOW_OFFSET, SPACEFAST_ICON_VIEW_BOX, SPACEFAST_WORDMARK_PATH, SPACEFAST_WORDMARK_PLATE, SPACEFAST_WORDMARK_SHADOW_OFFSET, SPACEFAST_WORDMARK_VIEW_BOX, } from "./brand-assets.js";
+import { SPACEFAST_BRAND_COLORS, SPACEFAST_ICON_F_OFFSET_X, SPACEFAST_ICON_F_PATH, SPACEFAST_ICON_LETTER_ORIGIN, SPACEFAST_ICON_LETTER_SCALE, SPACEFAST_ICON_S_PATH, SPACEFAST_ICON_SHADOW_OFFSET, SPACEFAST_ICON_VIEW_BOX, SPACEFAST_WORDMARK_PATH, SPACEFAST_WORDMARK_VIEW_BOX, } from "./brand-assets.js";
 function resolvedColors(colors) {
     return { ...SPACEFAST_BRAND_COLORS, ...colors };
 }
@@ -26,13 +26,10 @@ function numericAttribute(name, value) {
 }
 export function spacefastWordmarkSvg(options = {}) {
     const colors = resolvedColors(options.colors);
-    const plate = SPACEFAST_WORDMARK_PLATE;
-    const shadow = SPACEFAST_WORDMARK_SHADOW_OFFSET;
     const label = svgAttribute(options.ariaLabel ?? "Spacefast");
+    // The logotype is single-color: `plate` (ink) is its fill.
     return `<svg xmlns="http://www.w3.org/2000/svg"${numericAttribute("width", options.width)}${numericAttribute("height", options.height)} viewBox="${SPACEFAST_WORDMARK_VIEW_BOX}" role="img" aria-label="${label}">
-  <rect x="${plate.x + shadow.x}" y="${plate.y + shadow.y}" width="${plate.width}" height="${plate.height}" fill="${svgAttribute(colors.shadow)}"/>
-  <rect x="${plate.x}" y="${plate.y}" width="${plate.width}" height="${plate.height}" fill="${svgAttribute(colors.plate)}" stroke="${svgAttribute(colors.plate)}" stroke-width="1"/>
-  <path fill="${svgAttribute(colors.paper)}" d="${SPACEFAST_WORDMARK_PATH}"/>
+  <path fill="${svgAttribute(colors.plate)}" d="${SPACEFAST_WORDMARK_PATH}"/>
 </svg>
 `;
 }

package/dist/brand-assets.d.ts

@@ -6,27 +6,17 @@
  * build outputs of these constants, never independent sources of truth.
  */
 export declare const SPACEFAST_BRAND_COLORS: {
-    readonly shadow: "#ff4217";
-    readonly plate: "#141419";
-    readonly paper: "#fbf8f1";
+    readonly shadow: "#d8f24b";
+    readonly plate: "#0c0c0c";
+    readonly paper: "#fcfcfa";
 };
 export type SpacefastBrandColors = {
     shadow: string;
     plate: string;
     paper: string;
 };
-export declare const SPACEFAST_WORDMARK_VIEW_BOX = "0 0 326 62";
-export declare const SPACEFAST_WORDMARK_PLATE: {
-    readonly x: 10;
-    readonly y: 8;
-    readonly width: 306;
-    readonly height: 48;
-};
-export declare const SPACEFAST_WORDMARK_SHADOW_OFFSET: {
-    readonly x: 4;
-    readonly y: 4;
-};
-export declare const SPACEFAST_WORDMARK_PATH = "M20 15h24v7H27v7h17v20H20v-7h17v-7H20V15ZM51 15h24v18H58v16h-7V15Zm7 11h10v-4H58v4ZM83 15h24l9 34h-8l-2-8H84l-2 8h-8l9-34Zm3 19h18l-4-12H90l-4 12ZM145 22h-19v20h19v7h-26V15h26v7ZM152 15h26v7h-19v6h15v7h-15v7h19v7h-26V15ZM185 15h25v7h-18v6h15v7h-15v14h-7V15ZM215 15h24l9 34h-8l-2-8h-22l-2 8h-8l9-34Zm3 19h18l-4-12h-10l-4 12ZM250 15h24v7h-17v7h17v20h-24v-7h17v-7h-17V15ZM279 15h27v7h-10v27h-7V22h-10v-7Z";
+export declare const SPACEFAST_WORDMARK_VIEW_BOX = "0 0 152 28.9062";
+export declare const SPACEFAST_WORDMARK_PATH = "M9.32925 6.99344H20.5187V10.257H12.5929V13.5206H20.5187V22.8452H9.32925V19.5816H17.2551V16.318H9.32925V6.99344ZM23.7824 6.99344H34.9718V15.3856H27.046V22.8452H23.7824V6.99344ZM27.046 12.122H31.7082V10.257H27.046V12.122ZM38.7017 6.99344H49.8912L54.0872 22.8452H50.3574L49.4249 19.1154H39.1679L38.2355 22.8452H34.5056L38.7017 6.99344ZM40.1004 15.8518H48.4925L46.6276 10.257H41.9653L40.1004 15.8518ZM67.6079 10.257H58.7495V19.5816H67.6079V22.8452H55.4859V6.99344H67.6079V10.257ZM70.8715 6.99344H82.9934V10.257H74.1351V13.0544H81.1285V16.318H74.1351V19.5816H82.9934V22.8452H70.8715V6.99344ZM86.257 6.99344H97.9128V10.257H89.5206V13.0544H96.5141V16.318H89.5206V22.8452H86.257V6.99344ZM100.244 6.99344H111.433L115.629 22.8452H111.9L110.967 19.1154H100.71L99.7777 22.8452H96.0479L100.244 6.99344ZM101.643 15.8518H110.035L108.17 10.257H103.508L101.643 15.8518ZM116.562 6.99344H127.751V10.257H119.826V13.5206H127.751V22.8452H116.562V19.5816H124.488V16.318H116.562V6.99344ZM130.083 6.99344H142.671V10.257H138.008V22.8452H134.745V10.257H130.083V6.99344Z";
 export declare const SPACEFAST_ICON_VIEW_BOX = "0 0 160 160";
 export declare const SPACEFAST_ICON_S_PATH = "M0 0h24v7H7v7h17v20H0v-7h17v-7H0V0Z";
 export declare const SPACEFAST_ICON_F_PATH = "M0 0h25v7H7v6h15v7H7v14H0V0Z";

package/dist/brand-assets.js

@@ -5,22 +5,20 @@
  * renderers, and plugin generators all consume it. Generated SVG/PNG files are
  * build outputs of these constants, never independent sources of truth.
  */
+// The 2026-08 "printed matter" palette (DESIGN.md §3). `plate`/`paper` name the
+// icon serializers' layers; the wordmark takes whatever ink its surface supplies.
 export const SPACEFAST_BRAND_COLORS = {
-    shadow: "#ff4217",
-    plate: "#141419",
-    paper: "#fbf8f1",
+    shadow: "#d8f24b",
+    plate: "#0c0c0c",
+    paper: "#fcfcfa",
 };
-export const SPACEFAST_WORDMARK_VIEW_BOX = "0 0 326 62";
-export const SPACEFAST_WORDMARK_PLATE = {
-    x: 10,
-    y: 8,
-    width: 306,
-    height: 48,
-};
-export const SPACEFAST_WORDMARK_SHADOW_OFFSET = { x: 4, y: 4 };
-// Re-kerned and vertically centered on the plate. This is a literal so browser
-// consumers render ordinary SVG markup without assembling path text at runtime.
-export const SPACEFAST_WORDMARK_PATH = "M20 15h24v7H27v7h17v20H20v-7h17v-7H20V15ZM51 15h24v18H58v16h-7V15Zm7 11h10v-4H58v4ZM83 15h24l9 34h-8l-2-8H84l-2 8h-8l9-34Zm3 19h18l-4-12H90l-4 12ZM145 22h-19v20h19v7h-26V15h26v7ZM152 15h26v7h-19v6h15v7h-15v7h19v7h-26V15ZM185 15h25v7h-18v6h15v7h-15v14h-7V15ZM215 15h24l9 34h-8l-2-8h-22l-2 8h-8l9-34Zm3 19h18l-4-12h-10l-4 12ZM250 15h24v7h-17v7h17v20h-24v-7h17v-7h-17V15ZM279 15h27v7h-10v27h-7V22h-10v-7Z";
+// The logotype: bare "SPACEFAST" letterforms, one path, one color. Surfaces set
+// the fill (ink on light grounds, paper on dark). Exported from the Spacefast
+// Figma file via the `www` repo (`public/static/brand/spacefast-wordmark.svg`).
+export const SPACEFAST_WORDMARK_VIEW_BOX = "0 0 152 28.9062";
+// This is a literal so browser consumers render ordinary SVG markup without
+// assembling path text at runtime.
+export const SPACEFAST_WORDMARK_PATH = "M9.32925 6.99344H20.5187V10.257H12.5929V13.5206H20.5187V22.8452H9.32925V19.5816H17.2551V16.318H9.32925V6.99344ZM23.7824 6.99344H34.9718V15.3856H27.046V22.8452H23.7824V6.99344ZM27.046 12.122H31.7082V10.257H27.046V12.122ZM38.7017 6.99344H49.8912L54.0872 22.8452H50.3574L49.4249 19.1154H39.1679L38.2355 22.8452H34.5056L38.7017 6.99344ZM40.1004 15.8518H48.4925L46.6276 10.257H41.9653L40.1004 15.8518ZM67.6079 10.257H58.7495V19.5816H67.6079V22.8452H55.4859V6.99344H67.6079V10.257ZM70.8715 6.99344H82.9934V10.257H74.1351V13.0544H81.1285V16.318H74.1351V19.5816H82.9934V22.8452H70.8715V6.99344ZM86.257 6.99344H97.9128V10.257H89.5206V13.0544H96.5141V16.318H89.5206V22.8452H86.257V6.99344ZM100.244 6.99344H111.433L115.629 22.8452H111.9L110.967 19.1154H100.71L99.7777 22.8452H96.0479L100.244 6.99344ZM101.643 15.8518H110.035L108.17 10.257H103.508L101.643 15.8518ZM116.562 6.99344H127.751V10.257H119.826V13.5206H127.751V22.8452H116.562V19.5816H124.488V16.318H116.562V6.99344ZM130.083 6.99344H142.671V10.257H138.008V22.8452H134.745V10.257H130.083V6.99344Z";
 export const SPACEFAST_ICON_VIEW_BOX = "0 0 160 160";
 export const SPACEFAST_ICON_S_PATH = "M0 0h24v7H7v7h17v20H0v-7h17v-7H0V0Z";
 export const SPACEFAST_ICON_F_PATH = "M0 0h25v7H7v6h15v7H7v14H0V0Z";

package/dist/brand.d.ts

@@ -2,4 +2,21 @@ export declare const BRAND: {
     /** Consumer product name shown on every user surface. */
     readonly productName: "Spacefast";
 };
+/**
+ * What Spacefast is, in one paragraph, for a reader who has never heard of it.
+ *
+ * Every agent-facing surface leads with this: the copied page context, the
+ * `/v1/context` positioning fragment, the skill templates. An agent that
+ * only ever sees "here are three endpoints" cannot tell a user what it is
+ * working with, so the positioning is part of the context, not marketing.
+ *
+ * One constant, one wording. Do not paraphrase it at a call site.
+ */
+export declare const SPACEFAST_POSITIONING: string;
+/**
+ * The one-line positioning for lean agent prompts and handoff documents,
+ * where every word costs attention. The paragraph above stays for surfaces
+ * that can afford it. One constant, one wording — same rule as above.
+ */
+export declare const SPACEFAST_POSITIONING_SHORT = "Spacefast (https://spacefast.com) is Automattic's platform where agents publish and host sites and apps.";
 export declare const GITHUB_CHECK_RUN_NAME: "Spacefast Builds";

package/dist/brand.js

@@ -2,8 +2,28 @@ export const BRAND = {
     /** Consumer product name shown on every user surface. */
     productName: "Spacefast",
 };
-// The GitHub check-run name every build reports under. One constant because the
-// create and update paths live in different modules and drifted once
-// ("Stattic" vs "Spacefast") — GitHub keys check runs by name, so a mismatch
-// shows two orphaned checks per commit.
+/**
+ * What Spacefast is, in one paragraph, for a reader who has never heard of it.
+ *
+ * Every agent-facing surface leads with this: the copied page context, the
+ * `/v1/context` positioning fragment, the skill templates. An agent that
+ * only ever sees "here are three endpoints" cannot tell a user what it is
+ * working with, so the positioning is part of the context, not marketing.
+ *
+ * One constant, one wording. Do not paraphrase it at a call site.
+ */
+export const SPACEFAST_POSITIONING = "Spacefast is a batteries-included platform by Automattic to deploy any agentic artifacts, " +
+    "websites, generated static sites, full-stack TypeScript projects, PHP functions and Spacefast " +
+    "Zero capsules. Every space comes with database, storage, transactional emails, built-in auth " +
+    "for small or internal apps. Pages deployed to Spacefast are private by default but can be made " +
+    "public. Spacefast is built on the same infrastructure as WordPress.com, Tumblr, WordPress VIP " +
+    "and WP Cloud.";
+/**
+ * The one-line positioning for lean agent prompts and handoff documents,
+ * where every word costs attention. The paragraph above stays for surfaces
+ * that can afford it. One constant, one wording — same rule as above.
+ */
+export const SPACEFAST_POSITIONING_SHORT = "Spacefast (https://spacefast.com) is Automattic's platform where agents publish and host sites and apps.";
+// GitHub keys check runs by name, so the create and update paths (separate
+// modules) must both use this constant or a commit grows two orphaned checks.
 export const GITHUB_CHECK_RUN_NAME = `${BRAND.productName} Builds`;