@spacefast/common 0.2.1 → 0.4.1

package/dist/vocabulary.d.ts

@@ -100,6 +100,44 @@ export declare const CONCEPTS: {
         readonly aliases: readonly [];
         readonly description: "The page-enhancement feature. Capital-S as a feature name.";
     };
+    readonly contentModel: {
+        readonly id: "contentModel";
+        readonly canonicalNoun: "content model";
+        readonly aliases: readonly [];
+        readonly deprecated: readonly ["content program", "program collection"];
+        readonly description: string;
+    };
+    readonly ability: {
+        readonly id: "ability";
+        readonly canonicalNoun: "Ability";
+        readonly aliases: readonly [];
+        readonly description: string;
+    };
+    readonly collection: {
+        readonly id: "collection";
+        readonly canonicalNoun: "collection";
+        readonly aliases: readonly [];
+        readonly description: string;
+    };
+    readonly frame: {
+        readonly id: "frame";
+        readonly canonicalNoun: "Frame";
+        readonly aliases: readonly [];
+        readonly description: string;
+    };
+    readonly shareLink: {
+        readonly id: "shareLink";
+        readonly canonicalNoun: "share link";
+        readonly aliases: readonly [];
+        readonly deprecated: readonly ["Anyone with the link"];
+        readonly description: string;
+    };
+    readonly storage: {
+        readonly id: "storage";
+        readonly canonicalNoun: "storage";
+        readonly aliases: readonly [];
+        readonly description: string;
+    };
     readonly infra: {
         readonly id: "infra";
         readonly canonicalNoun: "infra";

package/dist/vocabulary.js

@@ -22,6 +22,11 @@
 //   - `API key`, never "access token".
 //   - `Collab` is the feature; `comment` is the unit.
 //   - `Superpowers` is the page-enhancement feature.
+//   - The content platform's nouns (ADDED 2026-08-30): a `content model` holds
+//     `collection`s and the `Ability`s over them, a `Frame` is an embedded
+//     editing surface, and `storage` is the system name the dashboard labels
+//     Files. "Program" is not a content noun; it only names a compiled Zero
+//     endpoint or run.
 //   - Provider names stay off public surfaces by default: never "E2B" (say
 //     "Spacefast Builds" / "Spacefast CI"), never "code.storage" / "Pierre".
 //     The infra brand is "WP Cloud", never "WP.Cloud"/"wp-cloud" (AMENDED
@@ -102,6 +107,56 @@ export const CONCEPTS = {
         aliases: [],
         description: "The page-enhancement feature. Capital-S as a feature name.",
     },
+    contentModel: {
+        id: "contentModel",
+        canonicalNoun: "content model",
+        aliases: [],
+        deprecated: ["content program", "program collection"],
+        description: "The schema a space's content takes: its collections, their fields, and the " +
+            "Abilities over them. Compiled at publish and bound to the version, so a " +
+            "rollback rolls the model back with it. It was briefly called a 'program'; " +
+            "that word now only means a compiled Zero endpoint or run.",
+    },
+    ability: {
+        id: "ability",
+        canonicalNoun: "Ability",
+        aliases: [],
+        description: "One named, callable operation a space publishes through the WordPress " +
+            "Abilities API. Capital-A as a product noun, and the set is the 'Ability " +
+            "catalog' — American spelling, matching every identifier around it.",
+    },
+    collection: {
+        id: "collection",
+        canonicalNoun: "collection",
+        aliases: [],
+        description: "One resource in a content model: posts, pages, media, or a set the model " +
+            "declares itself. Collections is also the dashboard page that lists them.",
+    },
+    frame: {
+        id: "frame",
+        canonicalNoun: "Frame",
+        aliases: [],
+        description: "An editing surface a space hosts and the dashboard embeds, opened through " +
+            "a one-use session minted from a Frame Link. Capital-F as a product noun.",
+    },
+    shareLink: {
+        id: "shareLink",
+        canonicalNoun: "share link",
+        aliases: [],
+        deprecated: ["Anyone with the link"],
+        description: "A scoped capability link that lets visitors into a space. Lowercase in " +
+            "prose, 'Share link' in labels — a common noun, not a product noun " +
+            "(DECIDED 2026-08-31). 'Anyone with the link' read as if it meant the " +
+            "space's normal URL in access settings, so every surface naming the " +
+            "audience says share link. Plain URLs are never called share links.",
+    },
+    storage: {
+        id: "storage",
+        canonicalNoun: "storage",
+        aliases: [],
+        description: "A space's files. 'Storage' is the system name — contracts, Ability ids, " +
+            "runtime paths — and the dashboard labels the same thing Files.",
+    },
     infra: {
         id: "infra",
         canonicalNoun: "infra",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spacefast/common",
-  "version": "0.2.1",
+  "version": "0.4.1",
   "license": "MIT",
   "description": "Shared TypeScript contracts and utilities for Spacefast packages.",
   "repository": {
@@ -98,6 +98,11 @@
       "types": "./dist/config/index.d.ts",
       "import": "./dist/config/index.js",
       "default": "./dist/config/index.js"
+    },
+    "./visual-review": {
+      "types": "./dist/visual-review.d.ts",
+      "import": "./dist/visual-review.js",
+      "default": "./dist/visual-review.js"
     }
   },
   "dependencies": {
@@ -110,7 +115,7 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@tanstack/react-query": "^5.101.4"
+    "@tanstack/react-query": "^5.102.8"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-query": {

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

@@ -1,23 +0,0 @@
-/**
- * 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

@@ -1,18 +0,0 @@
-/**
- * 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 = {};