hikoutei 0.5.3 → 0.5.4

package/dist/adapter/sheets/providers/google-sheets-api/model/preflightRows.js

@@ -2,15 +2,18 @@
  * Preflight row normalization, indexes, and sheet/grid lookup.
  *
  * Nonblank target rows are normalized into typed `PreflightRow` values with
- * their anchor evidence and visible identity; the anchor/identity indexes
- * fail closed on duplicates and derive the next append row. Sheet and grid
- * lookup helpers resolve titles to validated grids for the preflight data
- * read and the observation/provisioning readers.
+ * their anchor evidence and visible identity; the identity index fails closed
+ * on duplicates while the anchor index keeps only the FIRST row per anchor
+ * value (duplicated anchors are evidence, never rewritten), and both derive
+ * the next append row. Sheet and grid lookup helpers resolve titles to
+ * validated grids for the preflight data read and the observation/
+ * provisioning readers.
  */
 import { presentValue, absentValue } from "../../../../../shared/state/index.js";
-import { GOOGLE_SHEETS_API_ANCHOR_KEY } from "../constants.js";
+import { SYNC_PROJECTIONS } from "../../../../../application/sync/sheetsContract/constants.js";
 import { invalidProviderState } from "../errors.js";
-import { identityFromNormalizedCell, isBlankApiCell, normalizedCellFromApiValue, } from "./valueNormalization.js";
+import { apiStringValue } from "./preflightParsing.js";
+import { identityFromNormalizedCell, isBlankApiCell, normalizedCellFromApiValue, parseRegisteredRange, } from "./valueNormalization.js";
 export function requireSheetByTitle(sheets, title) {
     const sheet = findSheetByTitle(sheets, title);
     if (sheet === undefined) {
@@ -41,8 +44,11 @@ export function requireGridDataByTitle(document, sheets, title) {
     return { sheet, grid };
 }
 /** Normalizes nonblank grid rows into typed preflight rows. */
-export function readRows(data, range, headers, identityField) {
-    const anchorsByRow = readAnchorIndex(data);
+export function readRows(data, range, headers, identityField, anchorColumn) {
+    const anchorsByRow = readAnchorIndex(data, anchorColumn);
+    const userFieldCount = anchorColumn === undefined
+        ? range.columnCount
+        : range.columnCount - 1;
     const rows = [];
     for (let rowIndex = 0; rowIndex < data.rowData.length; rowIndex += 1) {
         const rowNumber = data.startRow + 1 + rowIndex;
@@ -52,7 +58,10 @@ export function readRows(data, range, headers, identityField) {
         if (rawRow === undefined)
             continue;
         const values = gridRowCells(data, rowNumber, range.startColumn, range.columnCount);
-        if (values.every((value) => isBlankApiCell(value)))
+        // The system row-id column is invisible to the blank-row rule: a row
+        // whose user fields are all blank stays blank even when the anchor cell
+        // still holds its UUID (same semantics as metadata anchors).
+        if (values.slice(0, userFieldCount).every((value) => isBlankApiCell(value)))
             continue;
         const cells = {};
         headers.forEach((header, columnIndex) => {
@@ -84,34 +93,67 @@ export function readRows(data, range, headers, identityField) {
     return rows;
 }
 /**
- * Builds the row -> anchor-list index from one grid's row metadata.
+ * Builds the row -> anchor-list index from the system row-id column.
  *
- * Row metadata is index-aligned with rowData; only the shared anchor key
- * counts, and a row may legitimately carry several metadata entries (the
- * caller decides whether multiple anchors are an error).
+ * The anchor is the LAST column cell value of the user_input registered
+ * range: any non-empty string value counts as the row's anchor (the column
+ * position is the identity proof; the `sync-anchor:` prefix is the format of
+ * observation- and append-assigned anchors, but flush-derived anchors keep
+ * the mapping's deterministic format such as `entity:<id>`). The header row
+ * is skipped so the `__hikoutei_row_id` header cell never becomes a
+ * pseudo-anchor. Blank cells, whitespace-only cells, empty strings, and
+ * non-string values are not anchors and are treated as missing by the
+ * caller. `anchorColumn` is 1-based; projections without a system column
+ * pass `undefined` and yield no anchors.
  */
-export function readAnchorIndex(data) {
+export function readAnchorIndex(data, anchorColumn) {
     const byRow = new Map();
-    data.rowMetadata.forEach((metadata, index) => {
-        const rowNumber = data.startRow + 1 + index;
-        const anchors = metadata.developerMetadata
-            .filter((item) => item.metadataKey === GOOGLE_SHEETS_API_ANCHOR_KEY)
-            .map((item) => item.metadataValue);
-        if (anchors.length > 0)
-            byRow.set(rowNumber, anchors);
-    });
+    if (anchorColumn === undefined)
+        return byRow;
+    for (let rowIndex = 0; rowIndex < data.rowData.length; rowIndex += 1) {
+        const rowNumber = data.startRow + 1 + rowIndex;
+        if (rowNumber < 2)
+            continue;
+        const [value] = gridRowCells(data, rowNumber, anchorColumn, 1);
+        const anchor = anchorFromColumnValue(value);
+        if (anchor !== undefined)
+            byRow.set(rowNumber, [anchor]);
+    }
     return byRow;
 }
-export function indexRows(rows, data) {
+/** Extracts one anchor value from a system-column cell, if any. */
+function anchorFromColumnValue(value) {
+    const raw = apiStringValue(value);
+    // Whitespace-only cells count as missing (re-anchored), mirroring the
+    // header validation's trim rule for the system column.
+    if (raw === undefined || raw.trim().length === 0)
+        return undefined;
+    return raw;
+}
+/**
+ * Returns the 1-based system row-id column of one registered range, or
+ * `undefined` for projections without a system column (only user_input tabs
+ * carry one, always as the LAST column of the registered range).
+ */
+export function anchorColumnFor(registeredRange, projection) {
+    if (projection !== SYNC_PROJECTIONS.USER_INPUT)
+        return undefined;
+    const range = parseRegisteredRange(registeredRange);
+    return range.startColumn + range.columnCount - 1;
+}
+export function indexRows(rows) {
     const byAnchor = new Map();
     const byIdentity = new Map();
     for (const row of rows) {
         if (row.physicalAnchor.kind === "present") {
-            const existing = byAnchor.get(row.physicalAnchor.value);
-            if (existing !== undefined) {
-                invalidProviderState(`sync anchor is duplicated: ${row.physicalAnchor.value} at rows ${existing.rowNumber} and ${row.rowNumber}`);
+            // Duplicated anchors are evidence, never rewritten: a human copy-paste
+            // copies the UUID cell, so only the FIRST row carrying each anchor
+            // value enters the index and later rows fall back to identity/targetId
+            // lookup in findWorkingRow. The duplicate itself is still reported by
+            // the observation/anchor-ensure evidence path.
+            if (!byAnchor.has(row.physicalAnchor.value)) {
+                byAnchor.set(row.physicalAnchor.value, row);
             }
-            byAnchor.set(row.physicalAnchor.value, row);
         }
         if (row.identity.kind === "present") {
             const existing = byIdentity.get(row.identity.value);
@@ -121,10 +163,14 @@ export function indexRows(rows, data) {
             byIdentity.set(row.identity.value, row);
         }
     }
-    // The API omits trailing empty rows from grid data, so the last data row is
-    // the sheet's last content row; appends start one row below it (min row 2,
-    // matching the Apps Script nextAppendRow = max(lastRow + 1, 2)).
-    const lastContentRow = data.startRow + data.rowData.length;
+    // The API omits trailing empty rows from grid data, so the last nonblank
+    // row is the sheet's last content row; appends start one row below it
+    // (min row 2, matching the Apps Script nextAppendRow = max(lastRow + 1, 2)).
+    // Computed from the normalized rows (not grid rowData) so a row whose only
+    // remaining content is the system anchor cell does not extend the append
+    // position, exactly like the metadata-anchor era.
+    const lastRow = rows.length === 0 ? undefined : rows[rows.length - 1]?.rowNumber;
+    const lastContentRow = lastRow === undefined ? 0 : lastRow;
     return {
         byAnchor,
         byIdentity,

package/dist/adapter/sheets/providers/google-sheets-api/model/preflightRows.js.map

@@ -1 +1 @@
-{"version":3,"file":"preflightRows.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/model/preflightRows.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"preflightRows.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/model/preflightRows.ts"],"names":[],"mappings":"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"}

package/dist/adapter/sheets/providers/google-sheets-api/model/tableRead.d.ts

@@ -16,11 +16,14 @@ export interface TableReadTarget {
     readonly registeredRange: string;
     readonly headers: readonly string[];
     readonly checkboxHeaders: readonly string[];
+    /** 1-based system row-id column; undefined for projections without one. */
+    readonly anchorColumn: number | undefined;
 }
 /**
  * Builds the nonblank rows of one validated grid as normalized table rows.
- * Header validation is strict (exact match, non-empty, no duplicates) and
- * blank rows are skipped with the checkbox-false rule.
+ * Header validation is strict (exact match, non-empty, no duplicates; the
+ * system row-id column must close a user_input range) and blank rows are
+ * skipped with the checkbox-false rule, ignoring the system column.
  */
 export declare function buildTableRowsFromGrid(grid: ParsedGridData, target: TableReadTarget): readonly SyncTableRow[];
 //# sourceMappingURL=tableRead.d.ts.map

package/dist/adapter/sheets/providers/google-sheets-api/model/tableRead.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tableRead.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/model/tableRead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AAEjG,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAOxB,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,eAAe,GACtB,SAAS,YAAY,EAAE,CAwBzB"}
+{"version":3,"file":"tableRead.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/model/tableRead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AAKjG,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAOxB,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,eAAe,GACtB,SAAS,YAAY,EAAE,CAgCzB"}

package/dist/adapter/sheets/providers/google-sheets-api/model/tableRead.js

@@ -9,25 +9,30 @@
  * checkbox rule. Unsupported cell shapes fail closed, exactly like the Apps
  * Script source throws.
  */
+import { GOOGLE_SHEETS_API_ROW_ID_HEADER, } from "../constants.js";
 import { invalidProviderState } from "../errors.js";
 import { apiCellNumberFormat, gridRowCells, readRegisteredHeaders, } from "./preflight.js";
 import { computedValueFromApiCell, isComputedBlankCell, parseRegisteredRange, } from "./valueNormalization.js";
 /**
  * Builds the nonblank rows of one validated grid as normalized table rows.
- * Header validation is strict (exact match, non-empty, no duplicates) and
- * blank rows are skipped with the checkbox-false rule.
+ * Header validation is strict (exact match, non-empty, no duplicates; the
+ * system row-id column must close a user_input range) and blank rows are
+ * skipped with the checkbox-false rule, ignoring the system column.
  */
 export function buildTableRowsFromGrid(grid, target) {
     const range = parseRegisteredRange(target.registeredRange);
-    const headers = readRegisteredHeaders(grid, range, target.headers);
+    const headers = readRegisteredHeaders(grid, range, target.headers, target.anchorColumn === undefined ? undefined : GOOGLE_SHEETS_API_ROW_ID_HEADER);
     const checkboxIndexes = checkboxColumnIndexes(headers, target.checkboxHeaders);
+    const userFieldCount = target.anchorColumn === undefined
+        ? range.columnCount
+        : range.columnCount - 1;
     const rows = [];
     for (let rowIndex = 0; rowIndex < grid.rowData.length; rowIndex += 1) {
         const rowNumber = grid.startRow + 1 + rowIndex;
         if (rowNumber < 2)
             continue;
         const values = gridRowCells(grid, rowNumber, range.startColumn, range.columnCount);
-        if (values.every((value, index) => isComputedBlankCell(value, checkboxIndexes.has(index)))) {
+        if (values.slice(0, userFieldCount).every((value, index) => isComputedBlankCell(value, checkboxIndexes.has(index)))) {
             continue;
         }
         const fields = {};

package/dist/adapter/sheets/providers/google-sheets-api/model/tableRead.js.map

@@ -1 +1 @@
-{"version":3,"file":"tableRead.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/model/tableRead.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,GAEtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AASjC;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAoB,EACpB,MAAuB;IAEvB,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACnE,MAAM,eAAe,GAAG,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IAC/E,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,KAAK,IAAI,QAAQ,GAAG,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,IAAI,CAAC,EAAE,CAAC;QACrE,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC;QAC/C,IAAI,SAAS,GAAG,CAAC;YAAE,SAAS;QAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;QACnF,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAChC,mBAAmB,CAAC,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAmC,EAAE,CAAC;QAClD,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;YACtC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,GAAG,wBAAwB,CACvC,KAAK,EACL,mBAAmB,CAAC,KAAK,CAAC,CAC3B,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAChF,SAAS,qBAAqB,CAC5B,OAA0B,EAC1B,eAA8C;IAE9C,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO,IAAI,GAAG,EAAU,CAAC;IAC3B,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,oBAAoB,CAAC,sCAAsC,MAAM,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"tableRead.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/model/tableRead.ts"],"names":[],"mappings":"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"}

package/dist/adapter/sheets/providers/google-sheets-api/operations/anchors.d.ts

@@ -1,21 +1,24 @@
 /**
  * Row-anchor assignment for the Google Sheets API sync provider.
  *
- * Ensures every nonblank row of one registered tab carries a
- * developer-metadata anchor, writing all planned anchors in ONE atomic
- * batchUpdate. Rows with more than one anchor fail closed; duplicate anchors
- * across rows are reported as evidence. No re-read is performed.
+ * Ensures every nonblank row of one registered tab carries an anchor in the
+ * tab's LAST system column (a `sync-anchor:<uuid>` cell value), writing all
+ * planned anchors in ONE atomic batchUpdate. Rows with more than one anchor
+ * fail closed; duplicate anchors across rows are reported as evidence. A
+ * user_input tab without the system column fails closed (legacy format); a
+ * user-edited system cell is simply reassigned a fresh anchor. No re-read is
+ * performed.
  */
 import type { EnsureSyncRowAnchorsRequest, EnsureSyncRowAnchorsResult } from "../../../../../application/sync/sheetsContract/syncSheets.js";
 import { type AnchorPlanResult, type ObservedTab } from "../model/observation.js";
 import { type GoogleSheetsApiProviderDeps } from "./shared.js";
 /**
- * Ensures every nonblank row of one registered tab carries a
- * developer-metadata anchor, writing all planned anchors in ONE atomic
- * batchUpdate. Rows with more than one anchor fail closed; duplicate
- * anchors across rows are reported as evidence. No re-read is performed.
+ * Ensures every nonblank row of one registered tab carries a system-column
+ * anchor, writing all planned anchors in ONE atomic batchUpdate. Rows with
+ * more than one anchor fail closed; duplicate anchors across rows are
+ * reported as evidence. No re-read is performed.
  */
 export declare function ensureRowAnchors(deps: GoogleSheetsApiProviderDeps, request: EnsureSyncRowAnchorsRequest): Promise<EnsureSyncRowAnchorsResult>;
 /** Writes every planned anchor of one tab in one atomic batch. */
-export declare function writeAnchors(deps: GoogleSheetsApiProviderDeps, tab: ObservedTab, plan: AnchorPlanResult): Promise<void>;
+export declare function writeAnchors(deps: GoogleSheetsApiProviderDeps, tab: ObservedTab, plan: AnchorPlanResult, anchorColumn: number | undefined): Promise<void>;
 //# sourceMappingURL=anchors.d.ts.map

package/dist/adapter/sheets/providers/google-sheets-api/operations/anchors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,8DAA8D,CAAC;AAItE,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAKL,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAGrB;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAqBrC;AAED,kEAAkE;AAClE,wBAAsB,YAAY,CAChC,IAAI,EAAE,2BAA2B,EACjC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAcf"}
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,8DAA8D,CAAC;AAGtE,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAKL,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAGrB;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAuBrC;AAED,kEAAkE;AAClE,wBAAsB,YAAY,CAChC,IAAI,EAAE,2BAA2B,EACjC,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,gBAAgB,EACtB,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/adapter/sheets/providers/google-sheets-api/operations/anchors.js

@@ -1,21 +1,24 @@
 /**
  * Row-anchor assignment for the Google Sheets API sync provider.
  *
- * Ensures every nonblank row of one registered tab carries a
- * developer-metadata anchor, writing all planned anchors in ONE atomic
- * batchUpdate. Rows with more than one anchor fail closed; duplicate anchors
- * across rows are reported as evidence. No re-read is performed.
+ * Ensures every nonblank row of one registered tab carries an anchor in the
+ * tab's LAST system column (a `sync-anchor:<uuid>` cell value), writing all
+ * planned anchors in ONE atomic batchUpdate. Rows with more than one anchor
+ * fail closed; duplicate anchors across rows are reported as evidence. A
+ * user_input tab without the system column fails closed (legacy format); a
+ * user-edited system cell is simply reassigned a fresh anchor. No re-read is
+ * performed.
  */
-import { GOOGLE_SHEETS_API_ANCHOR_KEY } from "../constants.js";
 import { invalidProviderState } from "../errors.js";
 import { planRowAnchors, } from "../model/observation.js";
+import { anchorColumnFor } from "../model/preflightRows.js";
 import { definitionForPhysicalSheet, requireValidBatchUpdateReply, runWrite, validateRoute, } from "./shared.js";
 import { readObservedTabs } from "./readRows.js";
 /**
- * Ensures every nonblank row of one registered tab carries a
- * developer-metadata anchor, writing all planned anchors in ONE atomic
- * batchUpdate. Rows with more than one anchor fail closed; duplicate
- * anchors across rows are reported as evidence. No re-read is performed.
+ * Ensures every nonblank row of one registered tab carries a system-column
+ * anchor, writing all planned anchors in ONE atomic batchUpdate. Rows with
+ * more than one anchor fail closed; duplicate anchors across rows are
+ * reported as evidence. No re-read is performed.
  */
 export async function ensureRowAnchors(deps, request) {
     const definition = definitionForPhysicalSheet(deps, request.physicalSheetId);
@@ -25,13 +28,15 @@ export async function ensureRowAnchors(deps, request) {
     if (tab === undefined) {
         invalidProviderState(`Registered sync sheet does not exist: ${request.sheetName}`);
     }
+    const anchorColumn = anchorColumnFor(request.registeredRange, request.projection);
     const plan = planRowAnchors(tab, {
         registeredRange: request.registeredRange,
         headers: definition.headers,
         checkboxHeaders: definition.checkboxHeaders ?? [],
+        anchorColumn,
     });
     if (plan.planned.length > 0) {
-        await writeAnchors(deps, tab, plan);
+        await writeAnchors(deps, tab, plan, anchorColumn);
     }
     return {
         assigned: plan.assigned,
@@ -40,13 +45,16 @@ export async function ensureRowAnchors(deps, request) {
     };
 }
 /** Writes every planned anchor of one tab in one atomic batch. */
-export async function writeAnchors(deps, tab, plan) {
+export async function writeAnchors(deps, tab, plan, anchorColumn) {
+    if (anchorColumn === undefined)
+        return;
     const requests = plan.planned.map((planned) => ({
-        kind: "createDeveloperMetadata",
+        kind: "updateCells",
         sheetId: tab.sheetId,
-        rowIndex: planned.rowIndex,
-        key: GOOGLE_SHEETS_API_ANCHOR_KEY,
-        value: planned.anchor,
+        startRowIndex: planned.rowIndex,
+        startColumnIndex: anchorColumn - 1,
+        rows: [[{ userEnteredValue: { stringValue: planned.anchor } }]],
+        fields: "userEnteredValue",
     }));
     const response = await runWrite(deps, () => deps.transport.batchUpdate({
         spreadsheetId: deps.spreadsheetId,

package/dist/adapter/sheets/providers/google-sheets-api/operations/anchors.js.map

@@ -1 +1 @@
-{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EACL,cAAc,GAGf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,QAAQ,EACR,aAAa,GAEd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAiC,EACjC,OAAoC;IAEpC,MAAM,UAAU,GAAG,0BAA0B,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7E,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,oBAAoB,CAAC,yCAAyC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE;QAC/B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,eAAe,EAAE,UAAU,CAAC,eAAe,IAAI,EAAE;KAClD,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;KACxC,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAiC,EACjC,GAAgB,EAChB,IAAsB;IAEtB,MAAM,QAAQ,GAAkC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC7E,IAAI,EAAE,yBAAyB;QAC/B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EAAE,4BAA4B;QACjC,KAAK,EAAE,OAAO,CAAC,MAAM;KACtB,CAAC,CAAC,CAAC;IACJ,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CACzC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,QAAQ;KACT,CAAC,CAAC,CAAC;IACN,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EACL,cAAc,GAGf,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,QAAQ,EACR,aAAa,GAEd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAiC,EACjC,OAAoC;IAEpC,MAAM,UAAU,GAAG,0BAA0B,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7E,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,oBAAoB,CAAC,yCAAyC,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE;QAC/B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,eAAe,EAAE,UAAU,CAAC,eAAe,IAAI,EAAE;QACjD,YAAY;KACb,CAAC,CAAC;IACH,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;IACpD,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;KACxC,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAiC,EACjC,GAAgB,EAChB,IAAsB,EACtB,YAAgC;IAEhC,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO;IACvC,MAAM,QAAQ,GAAkC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC7E,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,aAAa,EAAE,OAAO,CAAC,QAAQ;QAC/B,gBAAgB,EAAE,YAAY,GAAG,CAAC;QAClC,IAAI,EAAE,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,EAAE,kBAAkB;KAC3B,CAAC,CAAC,CAAC;IACJ,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CACzC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,QAAQ;KACT,CAAC,CAAC,CAAC;IACN,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC1D,CAAC"}

package/dist/adapter/sheets/providers/google-sheets-api/operations/preflightOp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preflightOp.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/preflightOp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8DAA8D,CAAC;AAO5G,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,sEAAsE,CAAC;AAC/H,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAErE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAIL,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAErB,6EAA6E;AAC7E,wBAAsB,aAAa,CACjC,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE;IACP,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC,EACD,UAAU,EAAE,kCAAkC,EAC9C,YAAY,EAAE;IACZ,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C,GACA,OAAO,CAAC,gBAAgB,CAAC,CAc3B;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE,uBAAuB,GAC/B,mBAAmB,CA8BrB"}
+{"version":3,"file":"preflightOp.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/preflightOp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8DAA8D,CAAC;AAO5G,OAAO,KAAK,EAAE,kCAAkC,EAAE,MAAM,sEAAsE,CAAC;AAC/H,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAErE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAIL,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAErB,6EAA6E;AAC7E,wBAAsB,aAAa,CACjC,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE;IACP,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC,EACD,UAAU,EAAE,kCAAkC,EAC9C,YAAY,EAAE;IACZ,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C,GACA,OAAO,CAAC,gBAAgB,CAAC,CAe3B;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE,uBAAuB,GAC/B,mBAAmB,CA+BrB"}

package/dist/adapter/sheets/providers/google-sheets-api/operations/preflightOp.js

@@ -13,6 +13,7 @@ import { SYNC_SNAPSHOT_READ_MODES, SYNC_PROJECTIONS, } from "../../../../../appl
 import { SYNC_SHEETS_ERROR_CODES } from "../../../../../application/sync/sheetsContract/errors.js";
 import { invalidProviderRequest } from "../errors.js";
 import { enumerateSheetProperties, readPreflightData, } from "../model/preflight.js";
+import { anchorColumnFor } from "../model/preflightRows.js";
 import { definitionForPhysicalSheet, runRead, validateRoute, } from "./shared.js";
 /** Reads the target and receipt tabs for one route through the read lane. */
 export async function readPreflight(deps, request, definition, routeOptions) {
@@ -26,6 +27,7 @@ export async function readPreflight(deps, request, definition, routeOptions) {
         headers: definition.headers,
         identityField: routeOptions.identityField,
         checkboxHeaders: routeOptions.checkboxHeaders,
+        projection: definition.sheet.projection,
     }, sheets, deps.readTimeoutMs));
 }
 /** Validates one observation request and derives its snapshot target. */
@@ -49,6 +51,7 @@ export function observationTargetFor(deps, request) {
         headers: definition.headers,
         checkboxHeaders: definition.checkboxHeaders ?? [],
         readMode,
+        anchorColumn: anchorColumnFor(request.registeredRange, request.projection),
     };
 }
 //# sourceMappingURL=preflightOp.js.map

package/dist/adapter/sheets/providers/google-sheets-api/operations/preflightOp.js.map

@@ -1 +1 @@
-{"version":3,"file":"preflightOp.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/preflightOp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAC3G,OAAO,EACL,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0DAA0D,CAAC;AAGnG,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,0BAA0B,EAC1B,OAAO,EACP,aAAa,GAEd,MAAM,aAAa,CAAC;AAErB,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAiC,EACjC,OAGC,EACD,UAA8C,EAC9C,YAGC;IAED,wEAAwE;IACxE,wEAAwE;IACxE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CACtC,wBAAwB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACpF,OAAO,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CACxB,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE;QAChC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,aAAa,EAAE,YAAY,CAAC,aAAa;QACzC,eAAe,EAAE,YAAY,CAAC,eAAe;KAC9C,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,oBAAoB,CAClC,IAAiC,EACjC,OAAgC;IAEhC,MAAM,UAAU,GAAG,0BAA0B,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7E,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnC,yEAAyE;IACzE,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,SAAS;QAC7C,CAAC,CAAC,wBAAwB,CAAC,IAAI;QAC/B,CAAC,CAAC,2BAA2B,CAC3B,OAAO,CAAC,QAAQ,EAChB,wCAAwC,EACxC,uBAAuB,CAAC,sBAAsB,CAC/C,CAAC;IACJ,IACE,QAAQ,KAAK,wBAAwB,CAAC,UAAU;QAChD,OAAO,CAAC,UAAU,KAAK,gBAAgB,CAAC,UAAU,EAClD,CAAC;QACD,sBAAsB,CACpB,aAAa,EACb,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,eAAe,EAAE,UAAU,CAAC,eAAe,IAAI,EAAE;QACjD,QAAQ;KACT,CAAC;AACJ,CAAC"}
+{"version":3,"file":"preflightOp.js","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/preflightOp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,2BAA2B,EAAE,MAAM,8DAA8D,CAAC;AAC3G,OAAO,EACL,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,6DAA6D,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0DAA0D,CAAC;AAGnG,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EACL,wBAAwB,EACxB,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EACL,0BAA0B,EAC1B,OAAO,EACP,aAAa,GAEd,MAAM,aAAa,CAAC;AAErB,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAiC,EACjC,OAGC,EACD,UAA8C,EAC9C,YAGC;IAED,wEAAwE;IACxE,wEAAwE;IACxE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CACtC,wBAAwB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IACpF,OAAO,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,CACxB,iBAAiB,CAAC,IAAI,CAAC,SAAS,EAAE;QAChC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,aAAa,EAAE,YAAY,CAAC,aAAa;QACzC,eAAe,EAAE,YAAY,CAAC,eAAe;QAC7C,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,UAAU;KACxC,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,oBAAoB,CAClC,IAAiC,EACjC,OAAgC;IAEhC,MAAM,UAAU,GAAG,0BAA0B,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7E,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnC,yEAAyE;IACzE,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,KAAK,SAAS;QAC7C,CAAC,CAAC,wBAAwB,CAAC,IAAI;QAC/B,CAAC,CAAC,2BAA2B,CAC3B,OAAO,CAAC,QAAQ,EAChB,wCAAwC,EACxC,uBAAuB,CAAC,sBAAsB,CAC/C,CAAC;IACJ,IACE,QAAQ,KAAK,wBAAwB,CAAC,UAAU;QAChD,OAAO,CAAC,UAAU,KAAK,gBAAgB,CAAC,UAAU,EAClD,CAAC;QACD,sBAAsB,CACpB,aAAa,EACb,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,eAAe,EAAE,UAAU,CAAC,eAAe,IAAI,EAAE;QACjD,QAAQ;QACR,YAAY,EAAE,eAAe,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,UAAU,CAAC;KAC3E,CAAC;AACJ,CAAC"}

package/dist/adapter/sheets/providers/google-sheets-api/operations/provisioning.d.ts

@@ -15,10 +15,12 @@ import { type GoogleSheetsApiProviderDeps } from "./shared.js";
  * Creates missing tabs and their header rows, or verifies existing tabs,
  * in ONE atomic batchUpdate. An existing tab with no content anywhere in
  * its used grid gets its headers initialized; an existing tab with content
- * must match the registered headers exactly (order, duplicates, width),
- * otherwise provisioning fails closed BEFORE any mutation. The operation
- * is idempotent: a retry after a lost response re-enumerates, sees the
- * exact headers, and succeeds without rewriting anything.
+ * must match the registered headers exactly (order, duplicates, width;
+ * user_input tabs additionally require the `__hikoutei_row_id` system
+ * column as the last header), otherwise provisioning fails closed BEFORE
+ * any mutation. The operation is idempotent: a retry after a lost response
+ * re-enumerates, sees the exact headers, and succeeds without rewriting
+ * anything.
  */
 export declare function provisionRegistry(deps: GoogleSheetsApiProviderDeps, registrations: readonly SyncSheetsProvisionRoute[]): Promise<{
     readonly registrations: readonly Omit<SyncSheetsProvisionRoute, "headers">[];

package/dist/adapter/sheets/providers/google-sheets-api/operations/provisioning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provisioning.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/provisioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sEAAsE,CAAC;AAgBrH,OAAO,EAIL,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAErB;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,2BAA2B,EACjC,aAAa,EAAE,SAAS,wBAAwB,EAAE,GACjD,OAAO,CAAC;IACT,QAAQ,CAAC,aAAa,EAAE,SAAS,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7E,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD,CAAC,CAkHD"}
+{"version":3,"file":"provisioning.d.ts","sourceRoot":"","sources":["../../../../../../src/adapter/sheets/providers/google-sheets-api/operations/provisioning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sEAAsE,CAAC;AAmBrH,OAAO,EAIL,KAAK,2BAA2B,EACjC,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,2BAA2B,EACjC,aAAa,EAAE,SAAS,wBAAwB,EAAE,GACjD,OAAO,CAAC;IACT,QAAQ,CAAC,aAAa,EAAE,SAAS,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7E,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;CAChD,CAAC,CAgHD"}

package/dist/adapter/sheets/providers/google-sheets-api/operations/provisioning.js

@@ -9,7 +9,10 @@
  * a retry after a lost response re-enumerates, sees the exact headers, and
  * succeeds without rewriting anything.
  */
+import { SYNC_PROJECTIONS } from "../../../../../application/sync/sheetsContract/constants.js";
 import { GOOGLE_SHEETS_API_PROVISION_ENUMERATION_FIELDS, GOOGLE_SHEETS_API_PROVISION_FIELDS, gridHeaderCells, parseSpreadsheetDocument, } from "../model/preflight.js";
+import { SYSTEM_COLUMN_REPROVISION_MESSAGE } from "../model/preflightHeaders.js";
+import { GOOGLE_SHEETS_API_ROW_ID_HEADER } from "../constants.js";
 import { invalidProviderRequest, invalidProviderState } from "../errors.js";
 import { allocateSheetId } from "../model/sheetIdAllocator.js";
 import { columnLetters, parseRegisteredRange, quoteA1SheetName, } from "../model/valueNormalization.js";
@@ -18,10 +21,12 @@ import { requireValidBatchUpdateReply, runRead, runWrite, } from "./shared.js";
  * Creates missing tabs and their header rows, or verifies existing tabs,
  * in ONE atomic batchUpdate. An existing tab with no content anywhere in
  * its used grid gets its headers initialized; an existing tab with content
- * must match the registered headers exactly (order, duplicates, width),
- * otherwise provisioning fails closed BEFORE any mutation. The operation
- * is idempotent: a retry after a lost response re-enumerates, sees the
- * exact headers, and succeeds without rewriting anything.
+ * must match the registered headers exactly (order, duplicates, width;
+ * user_input tabs additionally require the `__hikoutei_row_id` system
+ * column as the last header), otherwise provisioning fails closed BEFORE
+ * any mutation. The operation is idempotent: a retry after a lost response
+ * re-enumerates, sees the exact headers, and succeeds without rewriting
+ * anything.
  */
 export async function provisionRegistry(deps, registrations) {
     validateProvisionRegistrations(registrations);
@@ -75,9 +80,7 @@ export async function provisionRegistry(deps, registrations) {
     for (const registration of registrations) {
         const range = parseRegisteredRange(registration.registeredRange);
         const existing = existingByTitle.get(registration.sheetName);
-        const headerCells = registration.headers.map((header) => ({
-            userEnteredValue: { stringValue: header },
-        }));
+        const headerCells = provisionHeaderCells(registration);
         if (existing === undefined) {
             const sheetId = allocateSheetId(usedSheetIds);
             usedSheetIds.add(sheetId);
@@ -142,7 +145,9 @@ function validateProvisionRegistrations(registrations) {
         }
         tabNames.add(registration.sheetName);
         const range = parseRegisteredRange(registration.registeredRange);
-        if (range.columnCount !== registration.headers.length) {
+        const expectedColumnCount = registration.headers.length +
+            (registration.projection === SYNC_PROJECTIONS.USER_INPUT ? 1 : 0);
+        if (range.columnCount !== expectedColumnCount) {
             invalidProviderRequest("provisioning", `headers do not match registeredRange for ${registration.sheetName}`);
         }
         if (registration.headers.length === 0 ||
@@ -152,8 +157,24 @@ function validateProvisionRegistrations(registrations) {
         if (new Set(registration.headers).size !== registration.headers.length) {
             invalidProviderRequest("provisioning", `headers must not contain duplicates for ${registration.sheetName}`);
         }
+        if (registration.projection === SYNC_PROJECTIONS.USER_INPUT &&
+            registration.headers.includes(GOOGLE_SHEETS_API_ROW_ID_HEADER)) {
+            invalidProviderRequest("provisioning", `header ${GOOGLE_SHEETS_API_ROW_ID_HEADER} collides with the system row-id column for ${registration.sheetName}`);
+        }
     }
 }
+/**
+ * Builds the header cells written for one registration, appending the
+ * reserved system row-id header on user_input tabs.
+ */
+function provisionHeaderCells(registration) {
+    const headers = registration.projection === SYNC_PROJECTIONS.USER_INPUT
+        ? [...registration.headers, GOOGLE_SHEETS_API_ROW_ID_HEADER]
+        : registration.headers;
+    return headers.map((header) => ({
+        userEnteredValue: { stringValue: header },
+    }));
+}
 /**
  * Builds the provisioning data-read end column: the sheet's actual grid
  * width when the enumeration supplied it (so content anywhere in the tab
@@ -203,27 +224,48 @@ function cellHasEnteredValue(value) {
 /**
  * Verifies one content tab's header row against the registered schema:
  * exact order, non-empty strings, no duplicates, and full registered-range
- * coverage. Any drift fails closed BEFORE any mutation, mirroring the Apps
- * Script "operational provisioning header mismatch" behavior (including a
- * blank header row on a tab whose content lives outside the registered
- * range).
+ * coverage. user_input tabs additionally require the system row-id header
+ * as the last column; a legacy tab (provisioned without it) fails closed
+ * with a re-provision message. Any drift fails closed BEFORE any mutation,
+ * mirroring the Apps Script "operational provisioning header mismatch"
+ * behavior (including a blank header row on a tab whose content lives
+ * outside the registered range).
  */
 function assertProvisioningHeaders(grid, registration) {
     const range = parseRegisteredRange(registration.registeredRange);
     const headerValues = gridHeaderCells(grid, range);
-    const actual = headerValues.map((value, index) => {
-        const raw = provisioningHeaderString(value);
+    const systemColumn = registration.projection === SYNC_PROJECTIONS.USER_INPUT
+        ? GOOGLE_SHEETS_API_ROW_ID_HEADER
+        : undefined;
+    const expectedCount = registration.headers.length + (systemColumn === undefined ? 0 : 1);
+    const actual = [];
+    for (let index = 0; index < headerValues.length; index += 1) {
+        const isSystemPosition = systemColumn !== undefined &&
+            index === registration.headers.length;
+        const raw = provisioningHeaderString(headerValues[index]);
         if (raw === null) {
+            if (isSystemPosition) {
+                invalidProviderState(`operational provisioning header mismatch: ${registration.sheetName}` +
+                    ` (${SYSTEM_COLUMN_REPROVISION_MESSAGE})`);
+            }
             invalidProviderState(`operational provisioning header mismatch: ${registration.sheetName}` +
                 ` (header is missing at column ${index + 1})`);
         }
-        return raw;
-    });
-    if (new Set(actual).size !== actual.length) {
+        actual.push(raw);
+    }
+    const userHeaders = actual.slice(0, registration.headers.length);
+    if (new Set(userHeaders).size !== userHeaders.length) {
         invalidProviderState(`operational provisioning header mismatch: ${registration.sheetName} (duplicate header)`);
     }
-    if (actual.length !== registration.headers.length ||
-        actual.some((header, index) => header !== registration.headers[index])) {
+    if (actual.length !== expectedCount ||
+        userHeaders.some((header, index) => header !== registration.headers[index]) ||
+        (systemColumn !== undefined && actual[registration.headers.length] !== systemColumn)) {
+        if (systemColumn !== undefined &&
+            (actual.length !== expectedCount ||
+                actual[registration.headers.length] !== systemColumn)) {
+            invalidProviderState(`operational provisioning header mismatch: ${registration.sheetName}` +
+                ` (${SYSTEM_COLUMN_REPROVISION_MESSAGE})`);
+        }
         invalidProviderState(`operational provisioning header mismatch: ${registration.sheetName}`);
     }
 }