@mulmoclaude/core 4.10.0 → 5.0.0

package/assets/helps/collection-skills.md

@@ -782,8 +782,11 @@ This is the answer whenever the user asks for a collection that syncs with
 Google Calendar — **not** an `ingest.kind: "agent"` worker and **not** the
 `google` MCP calendar tools, both of which spend an LLM turn on every refresh to
 produce what the host produces for free. `map` reads _your_ field name → the
-Google event field (`summary`, `start`, `end`, `htmlLink`, `colorId`, `status`);
-at least one entry is required. Never map the `primaryKey` — it always holds the
+Google event field — `summary`, `start`, `end`, `description`, `location` and
+`colorId` sync BOTH ways; `htmlLink`, `status`, `updated`, `transparency`,
+`eventType`, `hangoutLink`, `recurringEventId` and `originalStartTime` are
+pull-only, so the pull fills them and the push leaves them alone. At least one
+entry is required. Never map the `primaryKey` — it always holds the
 Google event id, which is what makes a re-sync update a record instead of
 duplicating it.
 

package/assets/helps/google-calendar-collection.md

@@ -67,8 +67,26 @@ it isn't, sync silently does nothing until they link it in settings.
 - `autoPush` — push local edits on the sync schedule, just before each pull.
   Omit it (the default) and the push stays a button. See "Both directions".
 
-Mappable event fields: `summary`, `start`, `end`, `description`, `location`,
-`htmlLink`, `colorId`, `status`.
+Mappable event fields, two-way first: `summary`, `start`, `end`, `description`,
+`location`, `colorId`.
+
+Pull-only in this sync — the pull fills them, the push never sends them, so
+Google always wins. Some of these Google would accept a write for
+(`transparency`, and `eventType` at creation); this sync deliberately does not
+send any of them: `htmlLink`, `status`, `updated` (Google's own last-modified
+time),
+`transparency` (`"transparent"` when the event does not consume the attendee's
+time; `""` means opaque), `eventType` (all six Google returns: `default` / `birthday` / `focusTime` /
+`fromGmail` / `outOfOffice` / `workingLocation`), `hangoutLink` (the Meet URL),
+`recurringEventId` and `originalStartTime`.
+
+The last two are how a recurring series stays legible. The sync asks Google to
+expand recurrences, so a weekly meeting arrives as one event per occurrence;
+`recurringEventId` names the series each occurrence came from (`""` for a
+one-off), and `originalStartTime` is the slot the occurrence held before anyone
+dragged it — so a moved occurrence reads as a move rather than as a deletion
+plus a new event. Map them when the user asks why one calendar edit produced a
+large batch of record changes.
 
 `description` is the event body, and Google stores limited **HTML** in it. It is
 kept verbatim — mirroring it through a plain-text field and pushing it back would
@@ -149,8 +167,9 @@ What the button does and deliberately does not do:
   destroyed while it waits — the cost is that the record stays behind Google
   until someone resolves it, and the host logs which records those are.
 - Pushes `summary`, `start`, `end`, `description`, `location` and `colorId` —
-  everything the pull can read except `htmlLink` and `status`, which are
-  read-only in Google, so a column mapped to either is ignored.
+  the two-way half of the list above. A column mapped to one of the pull-only
+  fields is ignored by the push rather than rejected, so it keeps mirroring
+  Google in one direction.
 
 Reasons a record can be reported as skipped:
 

package/dist/collection/core/schemaZ.d.ts

@@ -505,8 +505,16 @@ export declare const AgentIngestZ: z.ZodObject<{
 }, z.core.$strip>;
 /** The Google event fields a collection may pull from. `id` is absent on
  *  purpose — it always lands in the primary field, since upsert-by-event-id
- *  is what makes the sync idempotent. */
-export declare const GOOGLE_CALENDAR_SOURCE_FIELDS: readonly ["summary", "start", "end", "htmlLink", "colorId", "status", "description", "location"];
+ *  is what makes the sync idempotent.
+ *
+ *  A superset of `PUSHABLE_SOURCE_FIELDS` (`google/pushPlan.ts`), listed with
+ *  the pushable ones first. Mapping one of the rest gives a PULL-ONLY column
+ *  that the push filters out — a choice of this sync, not only a Google
+ *  limitation: `transparency` is writable and `eventType` is writable at
+ *  creation, yet neither is sent. That is also why
+ *  widening this enum needs no `.push-state.json` migration: the push baseline
+ *  (`ShadowEvent`) is keyed off the pushable list, not off this one. */
+export declare const GOOGLE_CALENDAR_SOURCE_FIELDS: readonly ["summary", "start", "end", "description", "location", "colorId", "htmlLink", "status", "recurringEventId", "originalStartTime", "updated", "transparency", "eventType", "hangoutLink"];
 /** Marks a collection as the destination of the LLM-free Google Calendar
  *  sync (#2095). `map` is collectionField → Google event field, so the user's
  *  collection keeps whatever field names it already uses. */
@@ -516,11 +524,17 @@ export declare const GoogleCalendarSyncZ: z.ZodObject<{
         summary: "summary";
         start: "start";
         end: "end";
-        htmlLink: "htmlLink";
-        colorId: "colorId";
-        status: "status";
         description: "description";
         location: "location";
+        colorId: "colorId";
+        htmlLink: "htmlLink";
+        status: "status";
+        recurringEventId: "recurringEventId";
+        originalStartTime: "originalStartTime";
+        updated: "updated";
+        transparency: "transparency";
+        eventType: "eventType";
+        hangoutLink: "hangoutLink";
     }>>;
     autoPush: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -1123,11 +1137,17 @@ declare const CollectionObjectZ: z.ZodObject<{
             summary: "summary";
             start: "start";
             end: "end";
-            htmlLink: "htmlLink";
-            colorId: "colorId";
-            status: "status";
             description: "description";
             location: "location";
+            colorId: "colorId";
+            htmlLink: "htmlLink";
+            status: "status";
+            recurringEventId: "recurringEventId";
+            originalStartTime: "originalStartTime";
+            updated: "updated";
+            transparency: "transparency";
+            eventType: "eventType";
+            hangoutLink: "hangoutLink";
         }>>;
         autoPush: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
@@ -1615,11 +1635,17 @@ export declare const CollectionSchemaZ: z.ZodPreprocess<z.ZodObject<{
             summary: "summary";
             start: "start";
             end: "end";
-            htmlLink: "htmlLink";
-            colorId: "colorId";
-            status: "status";
             description: "description";
             location: "location";
+            colorId: "colorId";
+            htmlLink: "htmlLink";
+            status: "status";
+            recurringEventId: "recurringEventId";
+            originalStartTime: "originalStartTime";
+            updated: "updated";
+            transparency: "transparency";
+            eventType: "eventType";
+            hangoutLink: "hangoutLink";
         }>>;
         autoPush: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;

package/dist/collection/registry/server/index.cjs

@@ -4,9 +4,9 @@ const require_dist = require("../../../dist-Gj7ygaW2.cjs");
 const require_root = require("../../../root-BvwBUcol.cjs");
 const require_relPath = require("../../../relPath-CTAjGdCL.cjs");
 const require_utils_fetch = require("../../../utils/fetch.cjs");
-const require_discovery = require("../../../discovery-DhS4JWzq.cjs");
+const require_discovery = require("../../../discovery-DCMW05Bp.cjs");
 const require_templatePath = require("../../../templatePath-27vUZowm.cjs");
-const require_server = require("../../../server-B__-VpRz.cjs");
+const require_server = require("../../../server-rA9FSkl2.cjs");
 const require_skill_bridge_index = require("../../../skill-bridge/index.cjs");
 const require_types = require("../../../types-CNqkLT4M.cjs");
 let node_fs = require("node:fs");

package/dist/collection/registry/server/index.js

@@ -2,9 +2,9 @@ import { l as isUnknownArray, t as errorMessage } from "../../../dist-BzoA9pDR.j
 import { n as writeFileAtomic } from "../../../root-BcS4-Kge.js";
 import { n as toPosixRelPath } from "../../../relPath-DW8MC8VO.js";
 import { fetchWithTimeout } from "../../../utils/fetch.js";
-import { K as safeRecordId, et as collectionsRegistriesConfigPath, ht as skillsStagingDir, lt as projectSkillsDir, r as loadCollection, rt as getWorkspaceRoot, s as CollectionSchemaZ, st as log, t as acceptParsedSchema } from "../../../discovery-BR8gifOX.js";
+import { K as safeRecordId, et as collectionsRegistriesConfigPath, ht as skillsStagingDir, lt as projectSkillsDir, r as loadCollection, rt as getWorkspaceRoot, s as CollectionSchemaZ, st as log, t as acceptParsedSchema } from "../../../discovery-CBjI1lx9.js";
 import { t as isSafeActionTemplatePath } from "../../../templatePath-k_WNbL_Q.js";
-import { y as ONE_SECOND_MS } from "../../../server-BgPlo-HZ.js";
+import { y as ONE_SECOND_MS } from "../../../server-BMZ_BcPH.js";
 import { claudeSkillDir, dataSkillDir, mirrorSkillWrite } from "../../../skill-bridge/index.js";
 import { n as parseRegistryIndex, r as isRecord, t as OFFICIAL_REGISTRY_NAME } from "../../../types-BKVZrtyc.js";
 import { readFileSync } from "node:fs";

package/dist/collection/server/index.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_root = require("../../root-BvwBUcol.cjs");
 const require_itemId = require("../../itemId-CGT2J7YK.cjs");
-const require_discovery = require("../../discovery-DhS4JWzq.cjs");
+const require_discovery = require("../../discovery-DCMW05Bp.cjs");
 const require_templatePath = require("../../templatePath-27vUZowm.cjs");
-const require_server = require("../../server-B__-VpRz.cjs");
+const require_server = require("../../server-rA9FSkl2.cjs");
 exports.APP_MANIFEST_FILE = require_discovery.APP_MANIFEST_FILE;
 exports.BackendUnavailableError = require_discovery.BackendUnavailableError;
 exports.COLLECTION_ROOT_REQUIRED = require_discovery.COLLECTION_ROOT_REQUIRED;

package/dist/collection/server/index.js

@@ -1,6 +1,6 @@
 import { t as canonicalRoot } from "../../root-BcS4-Kge.js";
 import { U as COMPUTED_TYPES } from "../../itemId-4P9S_ehz.js";
-import { $ as collectionChangePayload, A as readItem, B as SCHEMA_FILE, C as CollectionQueryZ, D as generateItemId, E as deleteItem, F as loadAppManifest, G as resolveTemplatePath, H as isUnderRealRoot, I as parseAppManifest, J as BackendUnavailableError, K as safeRecordId, L as sharedItemsPath, M as writeItem, N as APP_MANIFEST_FILE, O as isRegularFile, P as appManifestReason, Q as collectionChangeKey, R as pageFromFullRead, S as compileJsonlQuery, T as MAX_QUERY_ROWS, U as itemFilePath, V as isContainedInRoot, W as resolveDataDir, X as COLLECTION_ROOT_REQUIRED, Y as isBackendUnavailable, _ as dedupeByRecordId, a as toDetail, ct as peekWorkspaceRoot, d as storeFor, dt as setCollectionChangePublisher, ft as setFirestoreAccessor, g as decodeCsvRecordId, h as csvRowToItem, i as resolvePrimaryField, it as hostSupportsSharedCollections, j as resolveCreateItemId, k as listItems, l as collectionWritable, mt as sharedCollectionChangePayload, n as discoverCollections, nt as firestoreHandle, o as toSummary, ot as localCollectionKey, p as MAX_CSV_ROWS, pt as setSharedCollectionsSupport, q as safeSlugName, r as loadCollection, rt as getWorkspaceRoot, s as CollectionSchemaZ, st as log, t as acceptParsedSchema, tt as configureCollectionHost, u as readOnlyRefusal, ut as publishCollectionChange, v as encodeCsvRecordId, w as DEFAULT_QUERY_ROWS, x as compileCsvQuery, y as normalizeCsvValue, z as projectItemFields } from "../../discovery-BR8gifOX.js";
+import { $ as collectionChangePayload, A as readItem, B as SCHEMA_FILE, C as CollectionQueryZ, D as generateItemId, E as deleteItem, F as loadAppManifest, G as resolveTemplatePath, H as isUnderRealRoot, I as parseAppManifest, J as BackendUnavailableError, K as safeRecordId, L as sharedItemsPath, M as writeItem, N as APP_MANIFEST_FILE, O as isRegularFile, P as appManifestReason, Q as collectionChangeKey, R as pageFromFullRead, S as compileJsonlQuery, T as MAX_QUERY_ROWS, U as itemFilePath, V as isContainedInRoot, W as resolveDataDir, X as COLLECTION_ROOT_REQUIRED, Y as isBackendUnavailable, _ as dedupeByRecordId, a as toDetail, ct as peekWorkspaceRoot, d as storeFor, dt as setCollectionChangePublisher, ft as setFirestoreAccessor, g as decodeCsvRecordId, h as csvRowToItem, i as resolvePrimaryField, it as hostSupportsSharedCollections, j as resolveCreateItemId, k as listItems, l as collectionWritable, mt as sharedCollectionChangePayload, n as discoverCollections, nt as firestoreHandle, o as toSummary, ot as localCollectionKey, p as MAX_CSV_ROWS, pt as setSharedCollectionsSupport, q as safeSlugName, r as loadCollection, rt as getWorkspaceRoot, s as CollectionSchemaZ, st as log, t as acceptParsedSchema, tt as configureCollectionHost, u as readOnlyRefusal, ut as publishCollectionChange, v as encodeCsvRecordId, w as DEFAULT_QUERY_ROWS, x as compileCsvQuery, y as normalizeCsvValue, z as projectItemFields } from "../../discovery-CBjI1lx9.js";
 import { i as isSafeTemplatePath, n as isSafeCustomViewI18nPath, r as isSafeCustomViewPath, t as isSafeActionTemplatePath } from "../../templatePath-k_WNbL_Q.js";
-import { A as recordFieldProblem, B as stagedSkillDir, C as applyMutateAction, D as validateCollectionRecords, E as STORE_UNREADABLE, F as buildCollectionActionSeedPrompt, I as promptPathsFor, L as readCustomViewHtml, M as enrichItems, N as runQueryOverRows, O as validateRecordObject, P as buildActionSeedPrompt, R as readCustomViewI18n, S as schemaRelations, T as MAX_RECORD_ISSUES, _ as resolveEvery, a as MAX_UNSELECTIVE_ITEMS, b as computeCollectionIcon, c as deleteCollection, d as computeSuccessor, f as daysInMonth, g as parseCivil, h as maybeSpawnSuccessor, i as MAX_SCHEMA_ISSUES, j as runCollectionQuery, k as compileRecordZ, l as deleteCollectionRefusalMessage, m as isTriggerDue, n as MAX_PUT_ITEMS, o as makeManageCollectionTool, p as formatCivil, r as MAX_PUT_LINT, s as deleteCustomView, t as MAX_ITEMS_FILE_BYTES, u as advanceTriggerDate, v as successorId, w as firstMutateParamProblem, x as buildWorkspaceOntology, z as readSkillTemplate } from "../../server-BgPlo-HZ.js";
+import { A as recordFieldProblem, B as stagedSkillDir, C as applyMutateAction, D as validateCollectionRecords, E as STORE_UNREADABLE, F as buildCollectionActionSeedPrompt, I as promptPathsFor, L as readCustomViewHtml, M as enrichItems, N as runQueryOverRows, O as validateRecordObject, P as buildActionSeedPrompt, R as readCustomViewI18n, S as schemaRelations, T as MAX_RECORD_ISSUES, _ as resolveEvery, a as MAX_UNSELECTIVE_ITEMS, b as computeCollectionIcon, c as deleteCollection, d as computeSuccessor, f as daysInMonth, g as parseCivil, h as maybeSpawnSuccessor, i as MAX_SCHEMA_ISSUES, j as runCollectionQuery, k as compileRecordZ, l as deleteCollectionRefusalMessage, m as isTriggerDue, n as MAX_PUT_ITEMS, o as makeManageCollectionTool, p as formatCivil, r as MAX_PUT_LINT, s as deleteCustomView, t as MAX_ITEMS_FILE_BYTES, u as advanceTriggerDate, v as successorId, w as firstMutateParamProblem, x as buildWorkspaceOntology, z as readSkillTemplate } from "../../server-BMZ_BcPH.js";
 export { APP_MANIFEST_FILE, BackendUnavailableError, COLLECTION_ROOT_REQUIRED, COMPUTED_TYPES, CollectionQueryZ, CollectionSchemaZ, DEFAULT_QUERY_ROWS, MAX_CSV_ROWS, MAX_ITEMS_FILE_BYTES, MAX_PUT_ITEMS, MAX_PUT_LINT, MAX_QUERY_ROWS, MAX_RECORD_ISSUES, MAX_SCHEMA_ISSUES, MAX_UNSELECTIVE_ITEMS, SCHEMA_FILE, STORE_UNREADABLE, acceptParsedSchema, advanceTriggerDate, appManifestReason, applyMutateAction, buildActionSeedPrompt, buildCollectionActionSeedPrompt, buildWorkspaceOntology, canonicalRoot, collectionChangeKey, collectionChangePayload, collectionWritable, compileCsvQuery, compileJsonlQuery, compileRecordZ, computeCollectionIcon, computeSuccessor, configureCollectionHost, csvRowToItem, daysInMonth, decodeCsvRecordId, dedupeByRecordId, deleteCollection, deleteCollectionRefusalMessage, deleteCustomView, deleteItem, discoverCollections, encodeCsvRecordId, enrichItems, firestoreHandle, firstMutateParamProblem, formatCivil, generateItemId, getWorkspaceRoot, hostSupportsSharedCollections, isBackendUnavailable, isContainedInRoot, isRegularFile, isSafeActionTemplatePath, isSafeCustomViewI18nPath, isSafeCustomViewPath, isSafeTemplatePath, isTriggerDue, isUnderRealRoot, itemFilePath, listItems, loadAppManifest, loadCollection, localCollectionKey, log, makeManageCollectionTool, maybeSpawnSuccessor, normalizeCsvValue, pageFromFullRead, parseAppManifest, parseCivil, peekWorkspaceRoot, projectItemFields, promptPathsFor, publishCollectionChange, readCustomViewHtml, readCustomViewI18n, readItem, readOnlyRefusal, readSkillTemplate, recordFieldProblem, resolveCreateItemId, resolveDataDir, resolveEvery, resolvePrimaryField, resolveTemplatePath, runCollectionQuery, runQueryOverRows, safeRecordId, safeSlugName, schemaRelations, setCollectionChangePublisher, setFirestoreAccessor, setSharedCollectionsSupport, sharedCollectionChangePayload, sharedItemsPath, stagedSkillDir, storeFor, successorId, toDetail, toSummary, validateCollectionRecords, validateRecordObject, writeItem };

package/dist/collection-watchers/index.cjs

@@ -3,8 +3,8 @@ const require_root = require("../root-BvwBUcol.cjs");
 const require_itemId = require("../itemId-CGT2J7YK.cjs");
 const require_promptSafety = require("../promptSafety-caJWd1ZQ.cjs");
 require("../collection/index.cjs");
-const require_discovery = require("../discovery-DhS4JWzq.cjs");
-const require_server = require("../server-B__-VpRz.cjs");
+const require_discovery = require("../discovery-DCMW05Bp.cjs");
+const require_server = require("../server-rA9FSkl2.cjs");
 const require_notifier = require("../notifier-B65Mvngb.cjs");
 let node_fs_promises = require("node:fs/promises");
 //#region src/collection-watchers/config.ts

package/dist/collection-watchers/index.js

@@ -2,8 +2,8 @@ import { t as canonicalRoot } from "../root-BcS4-Kge.js";
 import { X as fieldText, j as isValidCollectionName } from "../itemId-4P9S_ehz.js";
 import { E as whenMatches, f as itemIsDone } from "../promptSafety-BpBTh5xO.js";
 import "../collection/index.js";
-import { $ as collectionChangePayload, U as itemFilePath, ct as peekWorkspaceRoot, d as storeFor, mt as sharedCollectionChangePayload, n as discoverCollections, nt as firestoreHandle, r as loadCollection, ut as publishCollectionChange } from "../discovery-BR8gifOX.js";
-import { h as maybeSpawnSuccessor, m as isTriggerDue } from "../server-BgPlo-HZ.js";
+import { $ as collectionChangePayload, U as itemFilePath, ct as peekWorkspaceRoot, d as storeFor, mt as sharedCollectionChangePayload, n as discoverCollections, nt as firestoreHandle, r as loadCollection, ut as publishCollectionChange } from "../discovery-CBjI1lx9.js";
+import { h as maybeSpawnSuccessor, m as isTriggerDue } from "../server-BMZ_BcPH.js";
 import { d as publish, m as updateForPlugin, n as clear, s as listAll } from "../notifier-vAp5t6wL.js";
 import { access } from "node:fs/promises";
 //#region src/collection-watchers/config.ts

package/dist/{discovery-BR8gifOX.js → discovery-CBjI1lx9.js}

@@ -2784,11 +2784,17 @@ var GoogleCalendarSyncZ = z.object({
 		"summary",
 		"start",
 		"end",
-		"htmlLink",
+		"description",
+		"location",
 		"colorId",
+		"htmlLink",
 		"status",
-		"description",
-		"location"
+		"recurringEventId",
+		"originalStartTime",
+		"updated",
+		"transparency",
+		"eventType",
+		"hangoutLink"
 	])).refine((map) => Object.keys(map).length > 0, { message: "map at least one field — a `googleCalendar` sync with an empty map writes records that carry only the event id" }),
 	/** Run the push on the sync schedule too, immediately before each pull, so
 	*  local edits reach Google without anyone pressing a button (#2620).
@@ -3348,4 +3354,4 @@ function toDetail(collection) {
 //#endregion
 export { collectionChangePayload as $, readItem as A, SCHEMA_FILE as B, CollectionQueryZ as C, generateItemId as D, deleteItem as E, loadAppManifest as F, resolveTemplatePath as G, isUnderRealRoot as H, parseAppManifest as I, BackendUnavailableError as J, safeRecordId as K, sharedItemsPath as L, writeItem as M, APP_MANIFEST_FILE as N, isRegularFile as O, appManifestReason as P, collectionChangeKey as Q, pageFromFullRead as R, compileJsonlQuery as S, MAX_QUERY_ROWS as T, itemFilePath as U, isContainedInRoot as V, resolveDataDir as W, COLLECTION_ROOT_REQUIRED as X, isBackendUnavailable as Y, archiveDir as Z, dedupeByRecordId as _, createForwardingLogger as _t, toDetail as a, isPresetSlug as at, queryCsv as b, resolveMutateSet as c, peekWorkspaceRoot as ct, storeFor as d, setCollectionChangePublisher as dt, collectionsRegistriesConfigPath as et, checkpointSqliteDatabase as f, setFirestoreAccessor as ft, decodeCsvRecordId as g, stagingSkillDir as gt, csvRowToItem as h, skillsStagingDir as ht, resolvePrimaryField as i, hostSupportsSharedCollections as it, resolveCreateItemId as j, listItems as k, collectionWritable as l, projectSkillsDir as lt, cacheDir as m, sharedCollectionChangePayload as mt, discoverCollections as n, firestoreHandle as nt, toSummary as o, localCollectionKey as ot, MAX_CSV_ROWS as p, setSharedCollectionsSupport as pt, safeSlugName as q, loadCollection as r, getWorkspaceRoot as rt, CollectionSchemaZ as s, log as st, acceptParsedSchema as t, configureCollectionHost as tt, readOnlyRefusal as u, publishCollectionChange as ut, encodeCsvRecordId as v, createHostSlot as vt, DEFAULT_QUERY_ROWS as w, compileCsvQuery as x, normalizeCsvValue as y, projectItemFields as z };
 
-//# sourceMappingURL=discovery-BR8gifOX.js.map
+//# sourceMappingURL=discovery-CBjI1lx9.js.map