@artsy/cohesion 4.373.0 → 4.374.0--canary.717.15299.0

package/CHANGELOG.md

@@ -1,39 +1,3 @@
-# v4.373.0 (Fri Jun 26 2026)
-
-#### 🚀  Enhancement
-
-- fix(os): Export MaterialsEditor events correctly from Schema [#719](https://github.com/artsy/cohesion/pull/719) ([@olerichter00](https://github.com/olerichter00))
-
-#### Authors: 1
-
-- Ole ([@olerichter00](https://github.com/olerichter00))
-
----
-
-# v4.372.0 (Fri Jun 26 2026)
-
-#### 🚀  Enhancement
-
-- chore: Remove list from os owner type [#718](https://github.com/artsy/cohesion/pull/718) ([@MrSltun](https://github.com/MrSltun))
-
-#### Authors: 1
-
-- Sultan Al-Maari ([@MrSltun](https://github.com/MrSltun))
-
----
-
-# v4.371.0 (Fri Jun 26 2026)
-
-#### 🚀  Enhancement
-
-- chore: Add AGENTS.md and CLAUDE.md for agent onboarding [#715](https://github.com/artsy/cohesion/pull/715) ([@MounirDhahri](https://github.com/MounirDhahri))
-
-#### Authors: 1
-
-- Mounir Dhahri ([@MounirDhahri](https://github.com/MounirDhahri))
-
----
-
 # v4.370.0 (Thu Jun 25 2026)
 
 #### 🚀  Enhancement

package/dist/Schema/Values/ContextModule.d.ts

@@ -55,6 +55,7 @@ export declare enum ContextModule {
     artworkRecommendationsRail = "artworkRecommendationsRail",
     artworkSidebar = "artworkSidebar",
     artworksTab = "artworksTab",
+    artworkTable = "artworkTable",
     associatedViewingRoom = "associatedViewingRoom",
     auctionCard = "auctionCard",
     auctionHome = "auctionHome",

package/dist/Schema/Values/ContextModule.js

@@ -69,6 +69,7 @@ exports.ContextModule = ContextModule;
   ContextModule["artworkRecommendationsRail"] = "artworkRecommendationsRail";
   ContextModule["artworkSidebar"] = "artworkSidebar";
   ContextModule["artworksTab"] = "artworksTab";
+  ContextModule["artworkTable"] = "artworkTable";
   ContextModule["associatedViewingRoom"] = "associatedViewingRoom";
   ContextModule["auctionCard"] = "auctionCard";
   ContextModule["auctionHome"] = "auctionHome";

package/dist/Schema/index.d.ts

@@ -56,8 +56,8 @@ export * from "./os/Events/Click";
 export * from "./os/Events/ConnectedAppsFlow";
 export * from "./os/Events/InstagramEditor";
 export * from "./os/Events/InventoryTable";
-export * from "./os/Events/MaterialsEditor";
 export * from "./os/Events/MultiAddFlow";
 export * from "./os/Events/Submit";
+export * from "./os/Events/Toggle";
 export * from "./os/Values/OsContextModule";
 export * from "./os/Values/OsOwnerType";

package/dist/Schema/index.js

@@ -592,38 +592,38 @@ Object.keys(_InventoryTable).forEach(function (key) {
   });
 });
 
-var _MaterialsEditor = require("./os/Events/MaterialsEditor");
+var _MultiAddFlow = require("./os/Events/MultiAddFlow");
 
-Object.keys(_MaterialsEditor).forEach(function (key) {
+Object.keys(_MultiAddFlow).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   Object.defineProperty(exports, key, {
     enumerable: true,
     get: function get() {
-      return _MaterialsEditor[key];
+      return _MultiAddFlow[key];
     }
   });
 });
 
-var _MultiAddFlow = require("./os/Events/MultiAddFlow");
+var _Submit = require("./os/Events/Submit");
 
-Object.keys(_MultiAddFlow).forEach(function (key) {
+Object.keys(_Submit).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   Object.defineProperty(exports, key, {
     enumerable: true,
     get: function get() {
-      return _MultiAddFlow[key];
+      return _Submit[key];
     }
   });
 });
 
-var _Submit = require("./os/Events/Submit");
+var _Toggle2 = require("./os/Events/Toggle");
 
-Object.keys(_Submit).forEach(function (key) {
+Object.keys(_Toggle2).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   Object.defineProperty(exports, key, {
     enumerable: true,
     get: function get() {
-      return _Submit[key];
+      return _Toggle2[key];
     }
   });
 });

package/dist/Schema/os/Events/Click.d.ts

@@ -49,6 +49,29 @@ export interface ClickedCancelBulkEdit {
     context_page_owner_type: OsOwnerType;
     artwork_ids: string[];
 }
+/**
+ * The divergence marker appears in a syncable cell when the OS value
+ * diverges from the downstream destination value (e.g. Artsy CMS). Fires as an
+ * impression when the marker first renders for a given artwork/field combination.
+ *
+ * @example
+ * ```
+ * {
+ *   action: "viewedDivergenceMarker",
+ *   context_module: "artworkTable",
+ *   context_page_owner_type: "inventory",
+ *   artwork_id: "abc123",
+ *   field: "availability"
+ * }
+ * ```
+ */
+export interface ViewedDivergenceMarker {
+    action: OsActionType.viewedDivergenceMarker;
+    context_module: OsContextModule.artworkTable;
+    context_page_owner_type: OsOwnerType;
+    artwork_id: string;
+    field: "availability" | "medium" | "price";
+}
 /**
  * A partner opens a list, either from the Lists surface (a `ListCard`) or from
  * the recent-lists shortcut on the Inventory surface. `source` distinguishes the
@@ -74,4 +97,4 @@ export interface ClickedOpenList {
     list_type: string;
     source: string;
 }
-export type OsClickEvent = ClickedActionsDropdown | ClickedCancelBulkEdit | ClickedOpenList;
+export type OsClickEvent = ClickedActionsDropdown | ClickedCancelBulkEdit | ViewedDivergenceMarker | ClickedOpenList;

package/dist/Schema/os/Events/InventoryTable.d.ts

@@ -311,10 +311,41 @@ export interface OsClickedActionsDropdown {
      * Top-bar "More": "Delete"
      * Row/context menu only: "Remove from Artsy" | "Change Collection" | "Remove from Collection" |
      *   "Convert to Edition Set" | "Edit Edition Set" | "Convert to Unique"
+     * Distribution: "Distribute to Artsy"
      */
-    value: "Add to Artsy" | "Add to Collection" | "Change Collection" | "Checklist" | "Convert to Edition Set" | "Convert to Unique" | "Delete" | "Edit Edition Set" | "Instagram Post" | "Mailchimp Campaign" | "Remove from Artsy" | "Remove from Collection" | "Tearsheet";
+    value: "Add to Artsy" | "Add to Collection" | "Change Collection" | "Checklist" | "Convert to Edition Set" | "Convert to Unique" | "Delete" | "Distribute to Artsy" | "Edit Edition Set" | "Instagram Post" | "Mailchimp Campaign" | "Remove from Artsy" | "Remove from Collection" | "Tearsheet";
     /** Which button or trigger the partner used to open this dropdown */
     label: "add to dropdown" | "context menu" | "more dropdown" | "row action" | "studio dropdown";
     artwork_ids: string[];
 }
-export type OsInventoryTable = OsAddedArtist | OsAddedArtworkDocument | OsAddedLocation | OsClickedActionsDropdown | OsClickedArtworkRow | OsClickedEditionSetRow | OsClickedImagesModal | OsEditedArtworkField | OsRemovedArtworkDocument | OsSavedArtworkImages;
+/**
+ * A partner edits an availability, medium, or price cell that is configured to sync
+ * with a downstream destination (e.g. Artsy CMS). Fires on mutation success. Distinct
+ * from {@link OsEditedArtworkField} (general field edits) — this captures only the three
+ * syncable fields and whether a push to the destination actually occurred.
+ *
+ * @example
+ * ```
+ * {
+ *   action: "editedInventoryField",
+ *   context_module: "artworkTable",
+ *   context_page_owner_type: "inventory",
+ *   destination: ["artsy"],
+ *   artwork_id: "abc123",
+ *   field: "availability",
+ *   did_push_to_cms: false
+ * }
+ * ```
+ */
+export interface EditedInventoryField {
+    action: OsActionType.editedInventoryField;
+    context_module: OsContextModule.artworkTable;
+    context_page_owner_type: OsOwnerType;
+    /** Downstream destinations the value was pushed to (e.g. ["artsy"]) */
+    destination: string[];
+    artwork_id: string;
+    field: "availability" | "medium" | "price";
+    /** false e.g. for "Not For Sale" (OS-only value that does not push to the destination) */
+    did_push_to_cms: boolean;
+}
+export type OsInventoryTable = EditedInventoryField | OsAddedArtist | OsAddedArtworkDocument | OsAddedLocation | OsClickedActionsDropdown | OsClickedArtworkRow | OsClickedEditionSetRow | OsClickedImagesModal | OsEditedArtworkField | OsRemovedArtworkDocument | OsSavedArtworkImages;

package/dist/Schema/os/Events/MaterialsEditor.d.ts

@@ -5,6 +5,29 @@ import { OsActionType } from ".";
  * Schemas describing Art OS Materials (Tearsheet / Checklist) events
  * @packageDocumentation
  */
+/**
+ * A partner selects "Tearsheet" or "Checklist" from the inventory actions dropdown
+ * to open the Materials editor. The dropdown is surfaced three ways: the artwork's
+ * actions, bulk actions, and the right-click context menu.
+ *
+ * This schema describes events sent to Segment from [[OsClickedActionsDropdown]]
+ *
+ * @example
+ * ```
+ * {
+ *   action: "clickedActionsDropdown",
+ *   context_module: "actionsDropdown",
+ *   context_page_owner_type: "inventory",
+ *   value: "Tearsheet"
+ * }
+ * ```
+ */
+export interface OsClickedActionsDropdown {
+    action: OsActionType.clickedActionsDropdown;
+    context_module: OsContextModule.actionsDropdown;
+    context_page_owner_type: OsOwnerType;
+    value: "Tearsheet" | "Checklist" | "Instagram Post";
+}
 /**
  * A partner clicks "Exit" in the Materials editor header to leave the editor.
  *
@@ -85,4 +108,4 @@ export interface OsCreatedStudioContent {
     /** Generic catch-all for the artwork detail fields included in the generated material */
     content: Record<string, unknown>;
 }
-export type OsMaterialsEditor = OsClickedBrandKitModal | OsClickedExitEditor | OsCreatedStudioContent;
+export type OsMaterialsEditor = OsClickedActionsDropdown | OsClickedBrandKitModal | OsClickedExitEditor | OsCreatedStudioContent;

package/dist/Schema/os/Events/Submit.d.ts

@@ -78,6 +78,36 @@ export interface DistributedArtworks {
     artwork_ids: string[];
     selected_count: number;
 }
+/**
+ * The websocket-driven distribute job reaches a terminal state (complete or failed).
+ * Driven by `useDistributeWebsocket` (`PartnersChannel`, `metadata_update`).
+ * Fire on the final websocket message to capture success/skip rates.
+ *
+ * @example
+ * ```
+ * {
+ *   action: "completedArtworkDistribution",
+ *   context_module: "artworkTable",
+ *   context_page_owner_type: "inventory",
+ *   destination: ["artsy"],
+ *   total_artworks: 12,
+ *   success_count: 10,
+ *   skipped_count: 2,
+ *   value: "partial"
+ * }
+ * ```
+ */
+export interface CompletedArtworkDistribution {
+    action: OsActionType.completedArtworkDistribution;
+    context_module: OsContextModule.artworkTable;
+    context_page_owner_type: OsOwnerType.inventory;
+    /** Destination marketplaces (currently Artsy only; extensible) */
+    destination: string[];
+    total_artworks: number;
+    success_count: number;
+    skipped_count: number;
+    value: "success" | "partial" | "error";
+}
 /**
  * A partner creates a new list in the Add-to-list modal and bulk-adds the current
  * selection to it. `start_date` / `end_date` are null when unset; `fair_id` is
@@ -259,4 +289,4 @@ export interface DistributedList {
     fair_id?: string;
     partner_show_id: string;
 }
-export type OsSubmitEvent = BulkEditedArtworks | DeletedArtwork | DistributedArtworks | CreatedList | AddedArtworksToList | UpdatedList | DeletedList | RemovedArtworksFromList | MovedArtworksBetweenLists | DistributedList;
+export type OsSubmitEvent = BulkEditedArtworks | CompletedArtworkDistribution | DeletedArtwork | DistributedArtworks | CreatedList | AddedArtworksToList | UpdatedList | DeletedList | RemovedArtworksFromList | MovedArtworksBetweenLists | DistributedList;

package/dist/Schema/os/Events/Toggle.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Schemas describing Art OS toggle events
+ * @packageDocumentation
+ */
+import { OsContextModule } from "../Values/OsContextModule";
+import { OsOwnerType } from "../Values/OsOwnerType";
+import { OsActionType } from "./index";
+/**
+ * A partner toggles account-wide Auto-sync on or off via the InventoryTableActions bar.
+ * Flips `distributionSyncEnabled` for the whole partner account.
+ *
+ * @example
+ * ```
+ * {
+ *   action: "toggledDistributionSync",
+ *   context_module: "tableActions",
+ *   context_page_owner_type: "inventory",
+ *   value: "on"
+ * }
+ * ```
+ */
+export interface ToggledDistributionSync {
+    action: OsActionType.toggledDistributionSync;
+    context_module: OsContextModule.tableActions;
+    context_page_owner_type: OsOwnerType.inventory;
+    value: "on" | "off";
+}
+export type OsToggleEvent = ToggledDistributionSync;

package/dist/Schema/os/Events/Toggle.js

@@ -0,0 +1 @@
+"use strict";

package/dist/Schema/os/Events/__tests__/DistributionSyncFlow.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/Schema/os/Events/index.d.ts

@@ -6,12 +6,13 @@ import { OsInventoryTable } from "./InventoryTable";
 import { OsMaterialsEditor } from "./MaterialsEditor";
 import { OsMultiAddFlow } from "./MultiAddFlow";
 import { OsSubmitEvent } from "./Submit";
+import { OsToggleEvent } from "./Toggle";
 /**
  * List of valid schemas for Art OS analytics actions
  *
  * Each event describes one ActionType
  */
-export type OsEvent = OsMultiAddFlow | ClickedBrandKitColor | ClickedBrandKitFont | ClickedAddBrandKitFile | ClickedSaveBrandKit | OsConnectedAppsFlow | OsClickEvent | OsInstagramEditor | OsInventoryTable | OsMaterialsEditor | OsSubmitEvent;
+export type OsEvent = OsMultiAddFlow | ClickedBrandKitColor | ClickedBrandKitFont | ClickedAddBrandKitFile | ClickedSaveBrandKit | OsConnectedAppsFlow | OsClickEvent | OsInstagramEditor | OsInventoryTable | OsMaterialsEditor | OsSubmitEvent | OsToggleEvent;
 /**
  * List of all Art OS actions
  *
@@ -111,6 +112,10 @@ export declare enum OsActionType {
      * Corresponds to {@link OsInstagramEditor}
      */
     clickedUploadImageBank = "clickedUploadImageBank",
+    /**
+     * Corresponds to {@link CompletedArtworkDistribution}
+     */
+    completedArtworkDistribution = "completedArtworkDistribution",
     /**
      * Corresponds to {@link CompletedArtworkImport}
      */
@@ -147,6 +152,10 @@ export declare enum OsActionType {
      * Corresponds to {@link EditedArtworkField}
      */
     editedArtworkField = "editedArtworkField",
+    /**
+     * Corresponds to {@link EditedInventoryField}
+     */
+    editedInventoryField = "editedInventoryField",
     /**
      * Corresponds to {@link MovedArtworksBetweenLists}
      */
@@ -171,8 +180,16 @@ export declare enum OsActionType {
      * Corresponds to {@link StartedArtworkImport}
      */
     startedArtworkImport = "startedArtworkImport",
+    /**
+     * Corresponds to {@link ToggledDistributionSync}
+     */
+    toggledDistributionSync = "toggledDistributionSync",
     /**
      * Corresponds to {@link UpdatedList}
      */
-    updatedList = "updatedList"
+    updatedList = "updatedList",
+    /**
+     * Corresponds to {@link ViewedDivergenceMarker}
+     */
+    viewedDivergenceMarker = "viewedDivergenceMarker"
 }

package/dist/Schema/os/Events/index.js

@@ -44,6 +44,7 @@ exports.OsActionType = OsActionType;
   OsActionType["clickedOpenList"] = "clickedOpenList";
   OsActionType["clickedPublishConfirmation"] = "clickedPublishConfirmation";
   OsActionType["clickedUploadImageBank"] = "clickedUploadImageBank";
+  OsActionType["completedArtworkDistribution"] = "completedArtworkDistribution";
   OsActionType["completedArtworkImport"] = "completedArtworkImport";
   OsActionType["createdImportedArtworks"] = "createdImportedArtworks";
   OsActionType["createdList"] = "createdList";
@@ -53,11 +54,14 @@ exports.OsActionType = OsActionType;
   OsActionType["distributedArtworks"] = "distributedArtworks";
   OsActionType["distributedList"] = "distributedList";
   OsActionType["editedArtworkField"] = "editedArtworkField";
+  OsActionType["editedInventoryField"] = "editedInventoryField";
   OsActionType["movedArtworksBetweenLists"] = "movedArtworksBetweenLists";
   OsActionType["removedArtworkDocument"] = "removedArtworkDocument";
   OsActionType["removedArtworksFromList"] = "removedArtworksFromList";
   OsActionType["resumedArtworkImport"] = "resumedArtworkImport";
   OsActionType["savedArtworkImages"] = "savedArtworkImages";
   OsActionType["startedArtworkImport"] = "startedArtworkImport";
+  OsActionType["toggledDistributionSync"] = "toggledDistributionSync";
   OsActionType["updatedList"] = "updatedList";
+  OsActionType["viewedDivergenceMarker"] = "viewedDivergenceMarker";
 })(OsActionType || (exports.OsActionType = OsActionType = {}));

package/dist/Schema/os/Values/OsContextModule.d.ts

@@ -28,5 +28,6 @@ export declare enum OsContextModule {
     materialsEditor = "materialsEditor",
     multiAdd = "multiAdd",
     multiAddReview = "multiAddReview",
-    publishConfirmationModal = "publishConfirmationModal"
+    publishConfirmationModal = "publishConfirmationModal",
+    tableActions = "tableActions"
 }

package/dist/Schema/os/Values/OsContextModule.js

@@ -39,4 +39,5 @@ exports.OsContextModule = OsContextModule;
   OsContextModule["multiAdd"] = "multiAdd";
   OsContextModule["multiAddReview"] = "multiAddReview";
   OsContextModule["publishConfirmationModal"] = "publishConfirmationModal";
+  OsContextModule["tableActions"] = "tableActions";
 })(OsContextModule || (exports.OsContextModule = OsContextModule = {}));

package/dist/Schema/os/Values/OsOwnerType.d.ts

@@ -7,6 +7,7 @@ export declare enum OsOwnerType {
     collection = "collection",
     connectedApps = "connectedApps",
     inventory = "inventory",
+    list = "list",
     studio = "studio",
     studioInstagram = "studioInstagram",
     studioMaterials = "studioMaterials"

package/dist/Schema/os/Values/OsOwnerType.js

@@ -17,6 +17,7 @@ exports.OsOwnerType = OsOwnerType;
   OsOwnerType["collection"] = "collection";
   OsOwnerType["connectedApps"] = "connectedApps";
   OsOwnerType["inventory"] = "inventory";
+  OsOwnerType["list"] = "list";
   OsOwnerType["studio"] = "studio";
   OsOwnerType["studioInstagram"] = "studioInstagram";
   OsOwnerType["studioMaterials"] = "studioMaterials";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artsy/cohesion",
-  "version": "4.373.0",
+  "version": "4.374.0--canary.717.15299.0",
   "description": "Analytics schema",
   "main": "dist/index.js",
   "publishConfig": {

package/AGENTS.md

@@ -1,132 +0,0 @@
-# Agent Guidelines
-
-`@artsy/cohesion` is **Artsy's analytics schema** — a published TypeScript package of
-interfaces and enums that describe every analytics event sent to Segment/Redshift.
-There is no runtime logic: each event is a typed shape, and each event name maps to a
-downstream Redshift table. Consuming apps (web + iOS) import these types to fire events.
-
-## Tech Stack
-
-- **TypeScript** (strict) — the entire schema is type definitions; no runtime code
-- **Babel** — compiles `src/**/*.ts` → `dist/` (`@babel/preset-typescript`)
-- **tsc** — type-checking and `.d.ts` emission only (not used for transpiling)
-- **Jest** — tests assert each event interface serializes to its expected JSON shape
-- **ESLint + Prettier** — `simple-import-sort` and `sort-keys-fix` are enforced
-- **TypeDoc** — public docs at https://cohesion.artsy.net are generated from doc comments
-- **Auto / CircleCI** — versioning and npm publish on merge to `main`
-
-## Common Commands
-
-- `yarn test` — run the Jest suite (`<file>` or `-t <name>` to scope)
-- `yarn type-check` — `tsc --noEmit` (also runs on pre-push)
-- `yarn lint` — `eslint . --ext .ts --fix` (import + key sorting)
-- `yarn docs` — regenerate TypeDoc output into `doc/`
-
-## Pre-Commit Verification
-
-Before every commit, verify on pending files:
-
-```sh
-yarn type-check
-yarn test
-yarn lint
-```
-
-`husky` runs `lint-staged` on pre-commit and `yarn type-check` on pre-push. Never commit
-code that fails these checks.
-
-## Code Style & Common Patterns
-
-These are enforced by lint/test or are established conventions — follow them verbatim:
-
-- **One interface per event.** Name it `UpperCamelCase`; its `action` literal and the
-  matching `ActionType`/`OsActionType` enum member are `lowerCamelCase`. The enum member
-  value **is** the Redshift table name, so it must not change casually.
-- **`action` is always a literal type**, e.g. `action: ActionType.commercialFilterParamsChanged`
-  (not the bare `ActionType`).
-- **Sort keys alphabetically.** `sort-keys-fix` lints interface members, enum members, and
-  object literals (including test fixtures) into alphabetical order. Run `yarn lint` to fix.
-- **Sort imports.** `simple-import-sort` orders imports; let `--fix` handle it.
-- **Every event needs a context module and an owner type.** Use `context_module`
-  (`ContextModule`/`OsContextModule`) for the component, and an owner-type field for the
-  page/screen: `context_owner_type` (`OwnerType`), or `context_page_owner_type` /
-  `context_screen_owner_type` for the page/screen-scoped subtypes.
-- **Document every event with a TypeDoc block** containing a prose description and an
-  `@example` code fence showing the emitted JSON. This is the public documentation — see
-  `src/Schema/Events/FilterAndSort.ts` for the canonical style.
-- **Aggregate interfaces into a union** (e.g. `OsSubmitEvent`, `OsEvent`) and re-export
-  every new file from the relevant `index.ts` and `src/Schema/index.ts`.
-- **Prettier:** no semicolons, double quotes, trailing commas, 2-space indent.
-
-To add a CMS or core event, follow the step-by-step guide in [README.md](README.md#schema).
-
-## ArtOS Events (`src/Schema/os/`)
-
-ArtOS events have their **own** schema and conventions — do **not** reuse CMS or core
-events for ArtOS. When adding ArtOS tracking, follow these principles (from the
-[ArtOS tracking guidelines](https://app.notion.com/p/373cab0764a080fca7e7d5a984ec17c7) and
-[Filter/Sort/Search doc](https://app.notion.com/p/37bcab0764a081a2b22dc0f6434e44fa)):
-
-1. **Live under `src/Schema/os/`** with its own `Events/` and `Values/` folders. ArtOS has
-   dedicated `OsActionType`, `OsContextModule`, and `OsOwnerType` — never the shared ones.
-2. **Never reuse CMS events** for ArtOS surfaces, and vice versa.
-3. **Name events `VerbNoun`, past tense** — `ClickedFilterDrawer`, `CreatedStudioContent`,
-   `BulkEditedArtworks`. (The older `NounVerb` names like `ListCreated` were flipped.)
-4. **No generic action events.** Avoid `InventoryClicked` / `Clicked` / `Toggled` /
-   `Impression`; events must name the specific intent (`ClickedActionsDropdown`,
-   not a catch-all click). Events should be **reusable across surfaces** by intent — e.g.
-   `ClickedFilterDrawer` can fire on any page that has a filter component.
-5. **Differentiate surfaces via owner type, not a module field.** Do not add an `OSModule`
-   field; use `context_page_owner_type` (`inventory`, `collection`, `studioInstagram`, …)
-   to distinguish ArtOS surfaces. The URL itself changes (`/catalog` → `/lists` → …).
-6. **Group reusable events by interaction in shared files** (`Click.ts`, `Impression.ts`,
-   `Toggle.ts`). A set of events that is 100% non-reusable and scoped to one surface may get
-   its own file (e.g. `InstagramEditor.ts`, `MultiAddFlow.ts`).
-7. **Backend-tied, flow-completion events go in `Submit.ts`** — events that fire on
-   successful completion of a flow and depend on a backend change (`BulkEditedArtworks`,
-   `DeletedArtwork`, `DistributedArtworks`). These are platform-agnostic (web + future app),
-   so they stay out of the web-only `Click.ts`.
-8. **Avoid name collisions with existing events** — the OS list events drop the "Artwork"
-   qualifier (`CreatedList`, not `CreatedArtworkList`) so they don't clash with the existing
-   CMS saved-artwork-list events.
-
-## File Organization
-
-```
-src/
-├── index.ts              # Top-level package entry (re-exports Schema + DeprecatedHelpers)
-├── Schema/
-│   ├── index.ts          # Re-exports every event + value file (web/iOS, CMS, ArtOS)
-│   ├── Events/           # Core web + iOS events (FilterAndSort, Search, Click, Tap, …)
-│   ├── Values/           # Shared enums: ContextModule, OwnerType, Intent, Tab, …
-│   ├── CMS/              # CMS (gallery partner CMS) schema — Events/ + Values/
-│   └── os/               # ArtOS schema — see "ArtOS Events" above
-│       ├── Events/       # Click, Submit, InstagramEditor, MultiAddFlow, … (+ __tests__/)
-│       └── Values/       # OsContextModule, OsOwnerType
-├── DeprecatedSchema/     # Frozen legacy schema — do not extend
-└── DeprecatedHelpers/    # Frozen legacy helpers — do not extend
-```
-
-## Workflow
-
-- Branch off `main`; open a PR using `pull_request_template.md`.
-- Merging to `main` auto-publishes a new npm version via Auto; **PRs from feature branches
-  publish canary versions** consumers can test before merge.
-- Commit messages follow Conventional Commits (e.g. `chore:`, `feat:`) — used by Auto to
-  decide the version bump.
-
-## Gotchas
-
-- **Adding a file is not enough** — it must be re-exported from `src/Schema/index.ts` (and
-  any folder `index.ts` union) or consumers can't import it.
-- **The enum value is a contract.** An `ActionType`/`OsActionType` value names a Redshift
-  table; renaming it breaks the downstream data pipeline.
-- **`DeprecatedSchema` / `DeprecatedHelpers` are frozen** — add new events to `Schema`.
-- **Doc comments are shipped docs**, not just hints — keep `@example` blocks accurate.
-- The data team owns the core `Schema`; coordinate before changing shared `Values`.
-
-## Further Documentation
-
-- [README.md](README.md) — setup, and the canonical "add a new event" walkthrough
-- ArtOS tracking guidelines: [event list & principles](https://app.notion.com/p/373cab0764a080fca7e7d5a984ec17c7), [Filter/Sort/Search](https://app.notion.com/p/37bcab0764a081a2b22dc0f6434e44fa)
-- Generated API docs: https://cohesion.artsy.net

package/CLAUDE.md

@@ -1,3 +0,0 @@
-# CLAUDE.md
-
-See @AGENTS.md