@mulmoclaude/core 1.11.0 → 1.13.0

package/assets/helps/error-recovery.md

@@ -461,6 +461,104 @@ Repair pass reports schema violations by record id, but has no
 "malformed file" classification), and the completion/spawn watcher
 reconciles the WHOLE collection per db change (no per-record events).
 
+## A record the user edited came back with the source's value
+
+### Symptoms
+
+Nothing fails — the user reports it. Any of:
+
+- A Google Calendar collection record they edited shows Google's value
+  again after a sync.
+- A feed record lost the column they had added beside it, or the whole
+  record disappeared once the item aged past `ingest.maxItems`.
+- The edit is simply gone, and no conflict was ever reported.
+
+### Cause
+
+Records are written WHOLE (`writeItem`), so anything that mirrors a
+remote source into a collection has to lay its values OVER the stored
+record rather than replace it — and has to refuse when the record holds
+an edit the source has not seen. Four separate places got that wrong:
+
+- `#2683` — a calendar collection without `autoPush` was never in the
+  pull's protected set at all.
+- `#2684` — the protected set was a snapshot taken when the push
+  finished, so an edit made while the window was in flight (minutes of
+  it, on a full re-walk) was invisible to it.
+- `#2688` — a cancellation in Google deleted the record without asking
+  whether it held an unsent edit.
+- `#2696` — the feeds ingest replaced the record whole, and the
+  `maxItems` prune deleted annotated records once they aged out.
+
+### Fix
+
+All four are fixed as of `@mulmoclaude/core` 1.13.0. **Check the host's
+version first** — if it is older, that is the whole answer.
+
+If it happens on 1.13.0 or later, it is a new bug, not one of these:
+capture which collection, whether it declares `googleCalendar` or
+`ingest`, and what the record looked like before and after. Do NOT
+suggest re-editing and hoping — the point of these fixes is that the
+loss is no longer silent.
+
+## A calendar conflict is reported on every Push and will not clear
+
+### Symptoms
+
+Push reports a conflict for a record that already matches Google. It
+comes back on every attempt; nothing the user does in the record clears
+it.
+
+### Cause
+
+The conflict check compares Google against the BASELINE in
+`<workspace>/data/calendar/.push-state.json`, not against the record.
+A baseline older than both sides reports a conflict forever.
+
+Before `#2679` that happened whenever two hosts pointed at the same
+workspace: both read the same snapshot and the later write dropped the
+earlier one's entry. The state files are now serialised across
+processes with a lock file.
+
+**It can still happen when the workspace lives in a sync folder**
+(Dropbox, iCloud, Google Drive). Exclusive file creation gives no
+exclusion there — the file is replicated after the fact, so both hosts
+believe they hold the lock. No mechanism in the app can fix that.
+
+### Fix
+
+Move the workspace onto a real filesystem. A network mount is fine
+(`O_EXCL` is atomic on NFSv3+); a consumer sync folder is not.
+
+Nothing is lost while it persists: the push REFUSES rather than
+overwrites, which is exactly what the conflict report means. If the
+workspace is already on a real filesystem and a conflict still will not
+clear, that is a new bug — report it with the calendar id and the
+record.
+
+## `proceeding without the calendar state lock` in the logs
+
+### Symptoms
+
+A `google` warning naming a `.lock` path, during a calendar sync.
+
+### Cause
+
+The lock guards one read-modify-write of a calendar state file, and it
+fails OPEN: a host that cannot take it does its work anyway, because
+the lock removes a race rather than being a precondition for syncing
+correctly.
+
+A single occurrence is normal — another host held the file for the few
+milliseconds the mutation takes.
+
+### Fix
+
+Nothing, if it is occasional. If it is constant, either another host is
+hammering the same workspace, or the lock file cannot be created at all
+(a read-only mount, a missing `data/calendar` directory, a full disk) —
+check those before treating it as a calendar problem.
+
 ## Fallback
 
 If none of the above matches the failing tool output:

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

@@ -1,3 +1,14 @@
 /** Keep only `fields` (+ `primaryKey`, always) on each record. No `fields`
  *  ⇒ records pass through untouched. */
 export declare function projectRecordFields<T extends Record<string, unknown>>(items: T[], fields: readonly string[] | undefined, primaryKey: string): T[];
+/** Retrieved values laid over whatever the record already holds.
+ *
+ *  A record file is written whole (`writeItem`), so writing the retrieved item
+ *  alone would drop every column the retrieval does not produce — a collection
+ *  could not then carry a local note beside a mirrored item, because the next
+ *  refresh that touched it would silently delete the note. The retrieved values
+ *  still win on the fields they cover: those belong to the source.
+ *
+ *  Shared by the Google Calendar pull (#2620) and the feeds ingest (#2696),
+ *  which had the same bug and only one of the fixes. */
+export declare function mergeIntoExisting(existing: Record<string, unknown> | null, retrieved: Record<string, unknown>): Record<string, unknown>;

package/dist/collection/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dist = require("../dist-pWpC-b04.cjs");
+const require_dist = require("../dist-21pMsI1a.cjs");
 const require_calendarGrid = require("../calendarGrid-CaS9er8i.cjs");
-const require_project = require("../project-BWI5w_BT.cjs");
+const require_project = require("../project-CCtT_fQr.cjs");
 const require_promptSafety = require("../promptSafety-FD8cQn3e.cjs");
 //#region src/collection/core/presentCollection.ts
 var TOOL_NAME = "presentCollection";
@@ -658,6 +658,7 @@ exports.itemLabelOf = itemLabelOf;
 exports.itemMatchesQuery = itemMatchesQuery;
 exports.labelFieldFor = labelFieldFor;
 exports.matchesWhere = require_promptSafety.matchesWhere;
+exports.mergeIntoExisting = require_project.mergeIntoExisting;
 exports.monthAnchorDate = require_calendarGrid.monthAnchorDate;
 exports.nextSortDirection = nextSortDirection;
 exports.nextUniqueItemId = require_calendarGrid.nextUniqueItemId;

package/dist/collection/index.js

@@ -1,6 +1,6 @@
-import { t as errorMessage } from "../dist-Cwk0e12G.js";
+import { t as errorMessage } from "../dist-DP1FTGnO.js";
 import { A as fieldTextOrNull, C as FEED_SCHEDULES, D as isReadOnlySchema, E as isFieldDrivenEvery, O as storageKindFor, S as COMPUTED_TYPES, T as embedTargetId, _ as generateUniqueId, a as compareYmd, b as nextUniqueItemId, c as monthAnchorDate, d as parseTimeRange, f as recordSpan, g as SAFE_SLUG_PATTERN, h as SAFE_RECORD_ID_PATTERN, i as buildMonthGrid, k as fieldText, l as parseIsoDate, m as ymdKey, n as assignLanes, o as dateOf, p as spanCoversDay, r as bucketRecords, s as daySlice, t as MINUTES_PER_DAY, u as parseIsoDateTime, v as isSafeRecordId, w as INGEST_KINDS, x as AGENT_INGEST_KIND, y as isSafeSlug } from "../calendarGrid-CrGxeCOG.js";
-import { t as projectRecordFields } from "../project-bU98ycsy.js";
+import { n as projectRecordFields, t as mergeIntoExisting } from "../project-B9NSyr6L.js";
 import { C as actionVisible, E as whenMatches, S as viaMatches, T as fieldVisible, _ as uniqueRefTargets, a as evaluateDerived, b as projectBacklinkRow, c as selectDynamicRecord, d as flagFieldValue, f as itemIsDone, g as uniqueEmbedTargets, h as uniqueBacklinkSources, l as chipMatches, m as matchesWhere, n as deriveAll, o as firstDateField, p as toggleChecked, r as resolveRowRefs, s as resolveIcon, t as defangForPrompt, u as completionCoveredByFieldChip, v as backlinkRows, w as agentActionRunKey, x as rollupValue, y as coerceNumeric } from "../promptSafety-C--op_6a.js";
 //#region src/collection/core/presentCollection.ts
 var TOOL_NAME = "presentCollection";
@@ -596,6 +596,6 @@ var buildOntologyGraph = (entries) => {
 	};
 };
 //#endregion
-export { AGENT_INGEST_KIND, COMPUTED_TYPES, ENUM_ALERT, ENUM_NEUTRAL, ENUM_NUDGE, FEED_SCHEDULES, INGEST_KINDS, MINUTES_PER_DAY, SAFE_RECORD_ID_PATTERN, SAFE_SLUG_PATTERN, TOOL_DEFINITION, TOOL_NAME, actionVisible, agentActionRunKey, assignLanes, backlinkRows, boolSortValue, bucketRecords, buildMonthGrid, buildOntologyGraph, buildUpdatedRecord, cellKey, chipMatches, coerceInlineValue, coerceNumeric, compareSortValues, compareYmd, completionCoveredByFieldChip, dateOf, dateSortValue, daySlice, defangForPrompt, deriveAll, derivedSortValue, draftToRecord, embedTargetId, emptyRow, enumColorClasses, enumSortValue, enumValueIndex, errorMessage, evaluateDerived, executePresentCollection, fieldText, fieldTextOrNull, fieldVisible, firstDateField, firstMissingRequiredField, flagFieldValue, generateUniqueId, isFieldDrivenEvery, isReadOnlySchema, isSafeRecordId, isSafeSlug, isSortableField, itemIdOf, itemIsDone, itemLabelOf, itemMatchesQuery, labelFieldFor, matchesWhere, monthAnchorDate, nextSortDirection, nextUniqueItemId, numericSortValue, parseIsoDate, parseIsoDateTime, parseTimeRange, projectBacklinkRow, projectRecordFields, recordSpan, resolveEnumColor, resolveIcon, resolveRowRefs, rollupValue, rowFromItem, rowIdOf, scalarSortValue, selectDynamicRecord, shortHexId, skillCommandSeed, snapshotEmptyEnums, sortItems, sortValueOf, spanCoversDay, storageKindFor, stringSortValue, toggleChecked, uniqueBacklinkSources, uniqueEmbedTargets, uniqueRefTargets, viaMatches, whenMatches, ymdKey };
+export { AGENT_INGEST_KIND, COMPUTED_TYPES, ENUM_ALERT, ENUM_NEUTRAL, ENUM_NUDGE, FEED_SCHEDULES, INGEST_KINDS, MINUTES_PER_DAY, SAFE_RECORD_ID_PATTERN, SAFE_SLUG_PATTERN, TOOL_DEFINITION, TOOL_NAME, actionVisible, agentActionRunKey, assignLanes, backlinkRows, boolSortValue, bucketRecords, buildMonthGrid, buildOntologyGraph, buildUpdatedRecord, cellKey, chipMatches, coerceInlineValue, coerceNumeric, compareSortValues, compareYmd, completionCoveredByFieldChip, dateOf, dateSortValue, daySlice, defangForPrompt, deriveAll, derivedSortValue, draftToRecord, embedTargetId, emptyRow, enumColorClasses, enumSortValue, enumValueIndex, errorMessage, evaluateDerived, executePresentCollection, fieldText, fieldTextOrNull, fieldVisible, firstDateField, firstMissingRequiredField, flagFieldValue, generateUniqueId, isFieldDrivenEvery, isReadOnlySchema, isSafeRecordId, isSafeSlug, isSortableField, itemIdOf, itemIsDone, itemLabelOf, itemMatchesQuery, labelFieldFor, matchesWhere, mergeIntoExisting, monthAnchorDate, nextSortDirection, nextUniqueItemId, numericSortValue, parseIsoDate, parseIsoDateTime, parseTimeRange, projectBacklinkRow, projectRecordFields, recordSpan, resolveEnumColor, resolveIcon, resolveRowRefs, rollupValue, rowFromItem, rowIdOf, scalarSortValue, selectDynamicRecord, shortHexId, skillCommandSeed, snapshotEmptyEnums, sortItems, sortValueOf, spanCoversDay, storageKindFor, stringSortValue, toggleChecked, uniqueBacklinkSources, uniqueEmbedTargets, uniqueRefTargets, viaMatches, whenMatches, ymdKey };
 
 //# sourceMappingURL=index.js.map

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

@@ -1,12 +1,12 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_rolldown_runtime = require("../../../rolldown-runtime-D6vf50IK.cjs");
-const require_dist = require("../../../dist-pWpC-b04.cjs");
+const require_dist = require("../../../dist-21pMsI1a.cjs");
 const require_atomic = require("../../../atomic-C_7YpMiM.cjs");
 const require_relPath = require("../../../relPath-CgGi4-Nv.cjs");
 const require_utils_fetch = require("../../../utils/fetch.cjs");
-const require_discovery = require("../../../discovery-NRy3tyUA.cjs");
+const require_discovery = require("../../../discovery-DAoMnBYM.cjs");
 const require_templatePath = require("../../../templatePath-27vUZowm.cjs");
-const require_server = require("../../../server-7U-3DE2e.cjs");
+const require_server = require("../../../server-B_b0bLSW.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

@@ -1,10 +1,10 @@
-import { t as errorMessage } from "../../../dist-Cwk0e12G.js";
+import { t as errorMessage } from "../../../dist-DP1FTGnO.js";
 import { t as writeFileAtomic } from "../../../atomic-DPpdrJzO.js";
 import { n as toPosixRelPath } from "../../../relPath-DW8MC8VO.js";
 import { fetchWithTimeout } from "../../../utils/fetch.js";
-import { K as collectionsRegistriesConfigPath, U as safeRecordId, X as log, r as loadCollection, s as CollectionSchemaZ, t as acceptParsedSchema } from "../../../discovery-B4CZvrXR.js";
+import { K as collectionsRegistriesConfigPath, U as safeRecordId, X as log, r as loadCollection, s as CollectionSchemaZ, t as acceptParsedSchema } from "../../../discovery-D-ZJ6a6z.js";
 import { t as isSafeActionTemplatePath } from "../../../templatePath-k_WNbL_Q.js";
-import { g as ONE_SECOND_MS } from "../../../server-DdyIvFhz.js";
+import { g as ONE_SECOND_MS } from "../../../server-Ci_A3chZ.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,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_calendarGrid = require("../../calendarGrid-CaS9er8i.cjs");
-const require_discovery = require("../../discovery-NRy3tyUA.cjs");
+const require_discovery = require("../../discovery-DAoMnBYM.cjs");
 const require_templatePath = require("../../templatePath-27vUZowm.cjs");
-const require_server = require("../../server-7U-3DE2e.cjs");
+const require_server = require("../../server-B_b0bLSW.cjs");
 exports.BackendUnavailableError = require_discovery.BackendUnavailableError;
 exports.COMPUTED_TYPES = require_calendarGrid.COMPUTED_TYPES;
 exports.CollectionQueryZ = require_discovery.CollectionQueryZ;

package/dist/collection/server/index.js

@@ -1,5 +1,5 @@
 import { S as COMPUTED_TYPES } from "../../calendarGrid-CrGxeCOG.js";
-import { A as deleteItem, B as itemFilePath, C as compileCsvQuery, D as MAX_QUERY_ROWS, E as DEFAULT_QUERY_ROWS, F as resolveCreateItemId, H as resolveTemplatePath, I as writeItem, J as getWorkspaceRoot, L as SCHEMA_FILE, M as isRegularFile, N as listItems, O as BackendUnavailableError, P as readItem, Q as setCollectionChangePublisher, R as isContainedInRoot, T as CollectionQueryZ, U as safeRecordId, V as resolveDataDir, W as safeSlugName, X as log, Z as publishCollectionChange, _ as csvRowToItem, a as toDetail, b as encodeCsvRecordId, d as storeFor, h as MAX_CSV_ROWS, i as resolvePrimaryField, j as generateItemId, k as isBackendUnavailable, l as collectionWritable, m as projectItemFields, n as discoverCollections, o as toSummary, p as pageFromFullRead, q as configureCollectionHost, r as loadCollection, s as CollectionSchemaZ, t as acceptParsedSchema, u as readOnlyRefusal, v as decodeCsvRecordId, w as compileJsonlQuery, x as normalizeCsvValue, y as dedupeByRecordId, z as isContainedInWorkspace } from "../../discovery-B4CZvrXR.js";
+import { A as deleteItem, B as itemFilePath, C as compileCsvQuery, D as MAX_QUERY_ROWS, E as DEFAULT_QUERY_ROWS, F as resolveCreateItemId, H as resolveTemplatePath, I as writeItem, J as getWorkspaceRoot, L as SCHEMA_FILE, M as isRegularFile, N as listItems, O as BackendUnavailableError, P as readItem, Q as setCollectionChangePublisher, R as isContainedInRoot, T as CollectionQueryZ, U as safeRecordId, V as resolveDataDir, W as safeSlugName, X as log, Z as publishCollectionChange, _ as csvRowToItem, a as toDetail, b as encodeCsvRecordId, d as storeFor, h as MAX_CSV_ROWS, i as resolvePrimaryField, j as generateItemId, k as isBackendUnavailable, l as collectionWritable, m as projectItemFields, n as discoverCollections, o as toSummary, p as pageFromFullRead, q as configureCollectionHost, r as loadCollection, s as CollectionSchemaZ, t as acceptParsedSchema, u as readOnlyRefusal, v as decodeCsvRecordId, w as compileJsonlQuery, x as normalizeCsvValue, y as dedupeByRecordId, z as isContainedInWorkspace } from "../../discovery-D-ZJ6a6z.js";
 import { i as isSafeTemplatePath, n as isSafeCustomViewI18nPath, r as isSafeCustomViewPath, t as isSafeActionTemplatePath } from "../../templatePath-k_WNbL_Q.js";
-import { A as buildCollectionActionSeedPrompt, C as validateRecordObject, D as enrichItems, E as runCollectionQuery, M as readCustomViewHtml, N as readCustomViewI18n, O as runQueryOverRows, P as readSkillTemplate, S as validateCollectionRecords, T as recordFieldProblem, _ as computeCollectionIcon, a as deleteCollection, b as applyMutateAction, c as computeSuccessor, d as isTriggerDue, f as maybeSpawnSuccessor, h as successorId, i as deleteCustomView, j as promptPathsFor, k as buildActionSeedPrompt, l as daysInMonth, m as resolveEvery, n as MAX_UNSELECTIVE_ITEMS, o as deleteCollectionRefusalMessage, p as parseCivil, r as makeManageCollectionTool, s as advanceTriggerDate, t as MAX_SCHEMA_ISSUES, u as formatCivil, v as buildWorkspaceOntology, w as compileRecordZ, x as firstMutateParamProblem, y as schemaRelations } from "../../server-DdyIvFhz.js";
+import { A as buildCollectionActionSeedPrompt, C as validateRecordObject, D as enrichItems, E as runCollectionQuery, M as readCustomViewHtml, N as readCustomViewI18n, O as runQueryOverRows, P as readSkillTemplate, S as validateCollectionRecords, T as recordFieldProblem, _ as computeCollectionIcon, a as deleteCollection, b as applyMutateAction, c as computeSuccessor, d as isTriggerDue, f as maybeSpawnSuccessor, h as successorId, i as deleteCustomView, j as promptPathsFor, k as buildActionSeedPrompt, l as daysInMonth, m as resolveEvery, n as MAX_UNSELECTIVE_ITEMS, o as deleteCollectionRefusalMessage, p as parseCivil, r as makeManageCollectionTool, s as advanceTriggerDate, t as MAX_SCHEMA_ISSUES, u as formatCivil, v as buildWorkspaceOntology, w as compileRecordZ, x as firstMutateParamProblem, y as schemaRelations } from "../../server-Ci_A3chZ.js";
 export { BackendUnavailableError, COMPUTED_TYPES, CollectionQueryZ, CollectionSchemaZ, DEFAULT_QUERY_ROWS, MAX_CSV_ROWS, MAX_QUERY_ROWS, MAX_SCHEMA_ISSUES, MAX_UNSELECTIVE_ITEMS, SCHEMA_FILE, acceptParsedSchema, advanceTriggerDate, applyMutateAction, buildActionSeedPrompt, buildCollectionActionSeedPrompt, buildWorkspaceOntology, collectionWritable, compileCsvQuery, compileJsonlQuery, compileRecordZ, computeCollectionIcon, computeSuccessor, configureCollectionHost, csvRowToItem, daysInMonth, decodeCsvRecordId, dedupeByRecordId, deleteCollection, deleteCollectionRefusalMessage, deleteCustomView, deleteItem, discoverCollections, encodeCsvRecordId, enrichItems, firstMutateParamProblem, formatCivil, generateItemId, getWorkspaceRoot, isBackendUnavailable, isContainedInRoot, isContainedInWorkspace, isRegularFile, isSafeActionTemplatePath, isSafeCustomViewI18nPath, isSafeCustomViewPath, isSafeTemplatePath, isTriggerDue, itemFilePath, listItems, loadCollection, log, makeManageCollectionTool, maybeSpawnSuccessor, normalizeCsvValue, pageFromFullRead, parseCivil, projectItemFields, promptPathsFor, publishCollectionChange, readCustomViewHtml, readCustomViewI18n, readItem, readOnlyRefusal, readSkillTemplate, recordFieldProblem, resolveCreateItemId, resolveDataDir, resolveEvery, resolvePrimaryField, resolveTemplatePath, runCollectionQuery, runQueryOverRows, safeRecordId, safeSlugName, schemaRelations, setCollectionChangePublisher, storeFor, successorId, toDetail, toSummary, validateCollectionRecords, validateRecordObject, writeItem };

package/dist/collection-watchers/index.cjs

@@ -2,9 +2,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_calendarGrid = require("../calendarGrid-CaS9er8i.cjs");
 const require_promptSafety = require("../promptSafety-FD8cQn3e.cjs");
 require("../collection/index.cjs");
-const require_discovery = require("../discovery-NRy3tyUA.cjs");
-const require_server = require("../server-7U-3DE2e.cjs");
-const require_notifier = require("../notifier-tMsAXyXp.cjs");
+const require_discovery = require("../discovery-DAoMnBYM.cjs");
+const require_server = require("../server-B_b0bLSW.cjs");
+const require_notifier = require("../notifier-C3IhYxqh.cjs");
 let node_fs_promises = require("node:fs/promises");
 //#region src/collection-watchers/config.ts
 var NOOP_LOG = {

package/dist/collection-watchers/index.js

@@ -1,9 +1,9 @@
 import { k as fieldText } from "../calendarGrid-CrGxeCOG.js";
 import { E as whenMatches, f as itemIsDone } from "../promptSafety-C--op_6a.js";
 import "../collection/index.js";
-import { B as itemFilePath, Z as publishCollectionChange, d as storeFor, n as discoverCollections, r as loadCollection } from "../discovery-B4CZvrXR.js";
-import { d as isTriggerDue, f as maybeSpawnSuccessor } from "../server-DdyIvFhz.js";
-import { d as publish, m as updateForPlugin, n as clear, s as listAll } from "../notifier-BdA5qzhe.js";
+import { B as itemFilePath, Z as publishCollectionChange, d as storeFor, n as discoverCollections, r as loadCollection } from "../discovery-D-ZJ6a6z.js";
+import { d as isTriggerDue, f as maybeSpawnSuccessor } from "../server-Ci_A3chZ.js";
+import { d as publish, m as updateForPlugin, n as clear, s as listAll } from "../notifier-CMFlw74b.js";
 import { access } from "node:fs/promises";
 //#region src/collection-watchers/config.ts
 var NOOP_LOG = {

package/dist/{discovery-B4CZvrXR.js → discovery-D-ZJ6a6z.js}

@@ -1,6 +1,7 @@
+import { a as isErrorWithCode, o as isRecord, r as hasNumberProp } from "./dist-DP1FTGnO.js";
 import { t as writeFileAtomic } from "./atomic-DPpdrJzO.js";
 import { A as fieldTextOrNull, C as FEED_SCHEDULES, D as isReadOnlySchema, O as storageKindFor, S as COMPUTED_TYPES, g as SAFE_SLUG_PATTERN, h as SAFE_RECORD_ID_PATTERN, k as fieldText, v as isSafeRecordId, w as INGEST_KINDS, x as AGENT_INGEST_KIND, y as isSafeSlug } from "./calendarGrid-CrGxeCOG.js";
-import { t as projectRecordFields } from "./project-bU98ycsy.js";
+import { n as projectRecordFields } from "./project-B9NSyr6L.js";
 import { n as isSafeCustomViewI18nPath, r as isSafeCustomViewPath, t as isSafeActionTemplatePath } from "./templatePath-k_WNbL_Q.js";
 import { realpathSync, watch } from "node:fs";
 import path from "node:path";
@@ -1054,14 +1055,23 @@ function pageFromFullRead(items, opts, primaryKey, truncated) {
 }
 //#endregion
 //#region src/collection/server/sqliteStore.ts
+/** A constructor's parameter and return types are not observable at runtime,
+*  so the check stops at "DatabaseSync is constructible" — the only member of
+*  the module this store ever touches. */
+function isSqliteModule(mod) {
+	return isRecord(mod) && typeof mod.DatabaseSync === "function";
+}
 var sqliteModule = null;
+/** Drops the memo first so a later call can retry (e.g. tests stubbing the
+*  runtime), then reports why the backend is unusable. */
+function sqliteUnavailable(reason) {
+	sqliteModule = null;
+	throw new BackendUnavailableError(`sqlite storage needs the node:sqlite module (Node.js >= 22.5) — this runtime cannot load it: ${reason}`);
+}
 /** Lazy-load node:sqlite once. A runtime without it (Node < 22.5) throws a
 *  clearly-worded error the caller surfaces — never a bare MODULE_NOT_FOUND. */
 function loadSqlite() {
-	sqliteModule ??= import("node:sqlite").then((mod) => mod, (err) => {
-		sqliteModule = null;
-		throw new BackendUnavailableError(`sqlite storage needs the node:sqlite module (Node.js >= 22.5) — this runtime cannot load it: ${String(err)}`);
-	});
+	sqliteModule ??= import("node:sqlite").then((mod) => isSqliteModule(mod) ? mod : sqliteUnavailable("the module exposes no DatabaseSync constructor"), (err) => sqliteUnavailable(String(err)));
 	return sqliteModule;
 }
 /** The db file's on-disk state. A symlink or non-regular file is refused
@@ -1073,7 +1083,7 @@ async function dbFileState(absPath) {
 	try {
 		return (await lstat(absPath)).isFile() ? "file" : "refused";
 	} catch (err) {
-		if (err.code === "ENOENT") return "missing";
+		if (isErrorWithCode(err) && err.code === "ENOENT") return "missing";
 		throw err;
 	}
 }
@@ -1125,27 +1135,39 @@ async function withDb(absPath, workspaceRoot, mode, onUnavailable, operation) {
 		handle.database.close();
 	}
 }
+var SQLITE_CONSTRAINT_PRIMARYKEY = 1555;
+var SQLITE_CONSTRAINT_UNIQUE = 2067;
 /** node:sqlite throws ERR_SQLITE_ERROR with the SQLite extended result
-*  code on `errcode`. Our INSERT's duplicate-id failure is
-*  SQLITE_CONSTRAINT_PRIMARYKEY (1555); SQLITE_CONSTRAINT_UNIQUE (2067)
-*  covers a plain UNIQUE index. Checked structurally (message text kept
-*  only as a fallback for runtimes that don't expose `errcode`). */
+*  code on `errcode`. Checked structurally (message text kept only as a
+*  fallback for runtimes that don't expose `errcode`). */
 function isUniqueConstraintError(err) {
-	const { errcode } = err;
-	if (errcode !== void 0) return errcode === 1555 || errcode === 2067;
+	if (hasNumberProp(err, "errcode")) return err.errcode === SQLITE_CONSTRAINT_PRIMARYKEY || err.errcode === SQLITE_CONSTRAINT_UNIQUE;
 	return String(err).includes("UNIQUE constraint");
 }
 function parseRow(raw) {
 	if (typeof raw !== "string") return null;
 	try {
 		const parsed = JSON.parse(raw);
-		return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : null;
+		return isRecord(parsed) ? parsed : null;
 	} catch {
 		return null;
 	}
 }
+/** One column of a result row. node:sqlite types rows as `unknown`, so a
+*  value that is not a row object yields no column at all. */
+function readColumn(row, column) {
+	return isRecord(row) ? row[column] : void 0;
+}
 function rowsToItems(rows) {
-	return rows.map((row) => parseRow(row.record)).filter((item) => item !== null);
+	return rows.map((row) => parseRow(readColumn(row, "record"))).filter((item) => item !== null);
+}
+/** node:sqlite hands back an integer column as `number`, or as `bigint` once
+*  it leaves the safe-integer range — COUNT(*) can be either. */
+function countRecords(database) {
+	const count = readColumn(database.prepare("SELECT COUNT(*) AS n FROM records").get(), "n");
+	if (typeof count === "number") return count;
+	if (typeof count === "bigint") return Number(count);
+	throw new Error(`sqlite COUNT(*) returned no numeric row count (got ${typeof count})`);
 }
 async function sqliteList(absPath, workspaceRoot) {
 	return withDb(absPath, workspaceRoot, "read", () => [], (database) => rowsToItems(database.prepare("SELECT record FROM records ORDER BY id").all()));
@@ -1157,7 +1179,7 @@ async function sqlitePage(absPath, primaryKey, opts, workspaceRoot) {
 		truncated: false
 	};
 	return withDb(absPath, workspaceRoot, "read", () => emptyPage, (database) => {
-		const total = Number(database.prepare("SELECT COUNT(*) AS n FROM records").get().n);
+		const total = countRecords(database);
 		const offset = Math.max(0, opts.offset ?? 0);
 		const limit = opts.limit === void 0 ? -1 : Math.max(0, opts.limit);
 		return {
@@ -1171,8 +1193,7 @@ async function sqliteRead(absPath, itemId, workspaceRoot) {
 	const safeId = safeRecordId(itemId);
 	if (safeId === null) return null;
 	return withDb(absPath, workspaceRoot, "read", () => null, (database) => {
-		const row = database.prepare("SELECT record FROM records WHERE id = ?").get(safeId);
-		return row === void 0 ? null : parseRow(row.record);
+		return parseRow(readColumn(database.prepare("SELECT record FROM records WHERE id = ?").get(safeId), "record"));
 	});
 }
 async function sqliteWrite(absPath, itemId, item, opts) {
@@ -2674,4 +2695,4 @@ function toDetail(collection) {
 //#endregion
 export { skillsStagingDir as $, deleteItem as A, itemFilePath as B, compileCsvQuery as C, MAX_QUERY_ROWS as D, DEFAULT_QUERY_ROWS as E, resolveCreateItemId as F, archiveDir as G, resolveTemplatePath as H, writeItem as I, getWorkspaceRoot as J, collectionsRegistriesConfigPath as K, SCHEMA_FILE as L, isRegularFile as M, listItems as N, BackendUnavailableError as O, readItem as P, setCollectionChangePublisher as Q, isContainedInRoot as R, queryCsv as S, CollectionQueryZ as T, safeRecordId as U, resolveDataDir as V, safeSlugName as W, log as X, isPresetSlug as Y, publishCollectionChange as Z, csvRowToItem as _, toDetail as a, encodeCsvRecordId as b, resolveMutateSet as c, storeFor as d, createForwardingLogger as et, checkpointSqliteDatabase as f, cacheDir as g, MAX_CSV_ROWS as h, resolvePrimaryField as i, generateItemId as j, isBackendUnavailable as k, collectionWritable as l, projectItemFields as m, discoverCollections as n, toSummary as o, pageFromFullRead as p, configureCollectionHost as q, loadCollection as r, CollectionSchemaZ as s, acceptParsedSchema as t, createHostSlot as tt, readOnlyRefusal as u, decodeCsvRecordId as v, compileJsonlQuery as w, normalizeCsvValue as x, dedupeByRecordId as y, isContainedInWorkspace as z };
 
-//# sourceMappingURL=discovery-B4CZvrXR.js.map
+//# sourceMappingURL=discovery-D-ZJ6a6z.js.map