hikoutei 0.3.0 → 0.3.1

package/dist/shared/encoding/stableEncode.js

@@ -25,7 +25,8 @@
  */
 import { createHash } from "node:crypto";
 import { JAVASCRIPT_TYPE_NAMES, NORMALIZED_CELL_KINDS, STABLE_ENCODING_ERROR_CODES, } from "./constants.js";
-import { isJavaScriptType } from "./typeGuards.js";
+import { isJavaScriptType, isRecord } from "./typeGuards.js";
+import { isCanonicalUtcIsoDate } from "../validation.js";
 import { StableEncodingError } from "../../domain/errors/stableEncoding.js";
 /**
  * Encodes a stable value to its canonical byte sequence.
@@ -69,7 +70,7 @@ function encodeValue(value, chunks) {
         encodeArray(value, chunks);
         return;
     }
-    if (isJavaScriptType(value, JAVASCRIPT_TYPE_NAMES.OBJECT)) {
+    if (isRecord(value)) {
         encodeObject(value, chunks);
         return;
     }
@@ -92,7 +93,7 @@ function encodeString(value, chunks) {
     chunks.push(lengthPrefix, bytes);
 }
 function encodeDate(iso, chunks) {
-    if (!DATE_REGEX.test(iso) || !isCanonicalDate(iso)) {
+    if (!isCanonicalUtcIsoDate(iso)) {
         throw new StableEncodingError(STABLE_ENCODING_ERROR_CODES.INVALID_DATE_FORMAT, `stable_encode: invalid date format: ${iso}`);
     }
     const bytes = textEncode(iso);
@@ -147,14 +148,11 @@ function shortestRoundTripDecimal(value) {
         return `e${expSign}${digit}`;
     }).replace(/e\+/, "e");
 }
-const DATE_REGEX = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/;
 function isDateValue(value) {
-    return (isJavaScriptType(value, JAVASCRIPT_TYPE_NAMES.OBJECT) &&
-        value !== null &&
-        !Array.isArray(value) &&
+    return (isRecord(value) &&
         Object.keys(value).length === 2 &&
         value.kind === NORMALIZED_CELL_KINDS.DATE &&
-        isJavaScriptType(value.value, JAVASCRIPT_TYPE_NAMES.STRING));
+        typeof value.value === "string");
 }
 /** Rejects unpaired UTF-16 surrogates instead of letting TextEncoder replace them. */
 function normalizeScalarString(value) {
@@ -174,10 +172,6 @@ function normalizeScalarString(value) {
     }
     return value.normalize("NFC");
 }
-function isCanonicalDate(value) {
-    const timestamp = Date.parse(value);
-    return Number.isFinite(timestamp) && new Date(timestamp).toISOString() === value;
-}
 function ascii(s) {
     return textEncode(s);
 }

package/dist/shared/encoding/stableEncode.js.map

@@ -1 +1 @@
-{"version":3,"file":"stableEncode.js","sourceRoot":"","sources":["../../../src/shared/encoding/stableEncode.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stableEncode.js","sourceRoot":"","sources":["../../../src/shared/encoding/stableEncode.ts"],"names":[],"mappings":"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"}

package/dist/shared/identity/index.d.ts

@@ -0,0 +1,3 @@
+export type { HikouteiBusinessKeyHash, HikouteiCanonicalEntityId, HikouteiClaimToken, HikouteiEffectDedupeKey, HikouteiEffectId, HikouteiEntityId, HikouteiPayloadHash, HikouteiPhysicalSheetId, HikouteiRequestId, HikouteiRevision, HikouteiRowBindingId, HikouteiSnapshotHash, HikouteiStableHash, HikouteiVisibleHash, SemanticRevision, SemanticString, } from "./types.js";
+export { isSemanticRevision, requireHash, requireSemanticRevision, requireSemanticString, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/identity/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/identity/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/shared/identity/index.js

@@ -0,0 +1,2 @@
+export { isSemanticRevision, requireHash, requireSemanticRevision, requireSemanticString, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/shared/identity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/identity/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/shared/identity/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Internal semantic brands for identifiers and evidence values.
+ *
+ * These brands prevent unrelated IDs and hashes from being mixed inside the
+ * sync/storage engine while remaining plain strings at SQLite and JSON
+ * boundaries. They are intentionally not exported from the public root API.
+ */
+declare const semanticStringBrand: unique symbol;
+declare const semanticNumberBrand: unique symbol;
+/** A string carrying a compile-time semantic label. */
+export type SemanticString<Label extends string> = string & {
+    readonly [semanticStringBrand]: Label;
+};
+/** A non-negative safe integer carrying a compile-time semantic label. */
+export type SemanticRevision<Label extends string = "revision"> = number & {
+    readonly [semanticNumberBrand]: Label;
+};
+export type HikouteiEntityId = SemanticString<"entity-id">;
+export type HikouteiCanonicalEntityId = SemanticString<"canonical-entity-id">;
+export type HikouteiRowBindingId = SemanticString<"row-binding-id">;
+export type HikouteiEffectId = SemanticString<"effect-id">;
+export type HikouteiEffectDedupeKey = SemanticString<"effect-dedupe-key">;
+export type HikouteiPhysicalSheetId = SemanticString<"physical-sheet-id">;
+export type HikouteiStableHash = SemanticString<"stable-hash">;
+export type HikouteiBusinessKeyHash = SemanticString<"business-key-hash">;
+export type HikouteiPayloadHash = SemanticString<"payload-hash">;
+export type HikouteiVisibleHash = SemanticString<"visible-hash">;
+export type HikouteiSnapshotHash = SemanticString<"snapshot-hash">;
+export type HikouteiRequestId = SemanticString<"request-id">;
+export type HikouteiClaimToken = SemanticString<"claim-token">;
+export type HikouteiRevision = SemanticRevision;
+/** Promotes a validated non-empty string to one semantic string type. */
+export declare function requireSemanticString<Label extends string>(value: unknown, label: string): SemanticString<Label>;
+/** Promotes a validated non-negative safe integer to a revision type. */
+export declare function requireSemanticRevision<Label extends string = "revision">(value: unknown, label?: string): SemanticRevision<Label>;
+/** Checks whether an unknown value is a non-negative safe integer revision. */
+export declare function isSemanticRevision(value: unknown): value is HikouteiRevision;
+/** Promotes a stable hash after checking the representation used by storage. */
+export declare function requireHash<Label extends string>(value: unknown, label: string): SemanticString<Label>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/identity/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/shared/identity/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,CAAC,MAAM,mBAAmB,EAAE,OAAO,MAAM,CAAC;AACjD,OAAO,CAAC,MAAM,mBAAmB,EAAE,OAAO,MAAM,CAAC;AAEjD,uDAAuD;AACvD,MAAM,MAAM,cAAc,CAAC,KAAK,SAAS,MAAM,IAAI,MAAM,GAAG;IAC1D,QAAQ,CAAC,CAAC,mBAAmB,CAAC,EAAE,KAAK,CAAC;CACvC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,CAAC,KAAK,SAAS,MAAM,GAAG,UAAU,IAAI,MAAM,GAAG;IACzE,QAAQ,CAAC,CAAC,mBAAmB,CAAC,EAAE,KAAK,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;AAC3D,MAAM,MAAM,yBAAyB,GAAG,cAAc,CAAC,qBAAqB,CAAC,CAAC;AAC9E,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,gBAAgB,CAAC,CAAC;AACpE,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;AAC3D,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC,mBAAmB,CAAC,CAAC;AAC1E,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC,mBAAmB,CAAC,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;AAC/D,MAAM,MAAM,uBAAuB,GAAG,cAAc,CAAC,mBAAmB,CAAC,CAAC;AAC1E,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AACjE,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AACjE,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;AACnE,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;AAC/D,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEhD,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,MAAM,EACxD,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,cAAc,CAAC,KAAK,CAAC,CAKvB;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,MAAM,GAAG,UAAU,EACvE,KAAK,EAAE,OAAO,EACd,KAAK,SAAa,GACjB,gBAAgB,CAAC,KAAK,CAAC,CAKzB;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,KAAK,SAAS,MAAM,EAC9C,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,cAAc,CAAC,KAAK,CAAC,CAKvB"}

package/dist/shared/identity/types.js

@@ -0,0 +1,34 @@
+/**
+ * Internal semantic brands for identifiers and evidence values.
+ *
+ * These brands prevent unrelated IDs and hashes from being mixed inside the
+ * sync/storage engine while remaining plain strings at SQLite and JSON
+ * boundaries. They are intentionally not exported from the public root API.
+ */
+import { isNonEmptyString, isNonNegativeSafeInteger, } from "../validation.js";
+/** Promotes a validated non-empty string to one semantic string type. */
+export function requireSemanticString(value, label) {
+    if (!isNonEmptyString(value)) {
+        throw new TypeError(`${label} must be a non-empty string`);
+    }
+    return value;
+}
+/** Promotes a validated non-negative safe integer to a revision type. */
+export function requireSemanticRevision(value, label = "revision") {
+    if (!isNonNegativeSafeInteger(value)) {
+        throw new TypeError(`${label} must be a non-negative safe integer`);
+    }
+    return value;
+}
+/** Checks whether an unknown value is a non-negative safe integer revision. */
+export function isSemanticRevision(value) {
+    return isNonNegativeSafeInteger(value);
+}
+/** Promotes a stable hash after checking the representation used by storage. */
+export function requireHash(value, label) {
+    if (typeof value !== "string" || !/^[0-9a-f]{64}$/i.test(value)) {
+        throw new TypeError(`${label} must be a SHA-256 hexadecimal hash`);
+    }
+    return value;
+}
+//# sourceMappingURL=types.js.map

package/dist/shared/identity/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/shared/identity/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AA8B1B,yEAAyE;AACzE,MAAM,UAAU,qBAAqB,CACnC,KAAc,EACd,KAAa;IAEb,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,6BAA6B,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAA8B,CAAC;AACxC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,uBAAuB,CACrC,KAAc,EACd,KAAK,GAAG,UAAU;IAElB,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,sCAAsC,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,wBAAwB,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,KAAa;IAEb,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,SAAS,CAAC,GAAG,KAAK,qCAAqC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAA8B,CAAC;AACxC,CAAC"}

package/dist/shared/index.d.ts

@@ -1,6 +1,7 @@
 /** Shared kernel contracts used by domain, application, and adapters. */
 export * from "./constants.js";
 export * from "./encoding/index.js";
+export * from "./identity/index.js";
 export * from "./state/index.js";
 export * from "./validation.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/shared/index.js

@@ -1,6 +1,7 @@
 /** Shared kernel contracts used by domain, application, and adapters. */
 export * from "./constants.js";
 export * from "./encoding/index.js";
+export * from "./identity/index.js";
 export * from "./state/index.js";
 export * from "./validation.js";
 //# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/shared/state/constructors.d.ts

@@ -0,0 +1,10 @@
+import type { Applicability, Presence } from "./types.js";
+/** Wraps a value in an explicit present state. */
+export declare function presentValue<T>(value: T): Presence<T>;
+/** Represents a value that is explicitly absent. */
+export declare function absentValue<T>(): Presence<T>;
+/** Wraps a value in an explicit applicable state. */
+export declare function applicableValue<T>(value: T): Applicability<T>;
+/** Represents a value that is not applicable to the current operation. */
+export declare function notApplicableValue<T>(): Applicability<T>;
+//# sourceMappingURL=constructors.d.ts.map

package/dist/shared/state/constructors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructors.d.ts","sourceRoot":"","sources":["../../../src/shared/state/constructors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE1D,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAErD;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAE5C;AAED,qDAAqD;AACrD,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAE7D;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,CAAC,CAExD"}

package/dist/shared/state/constructors.js

@@ -0,0 +1,18 @@
+import { APPLICABILITY_KINDS, PRESENCE_KINDS } from "./constants.js";
+/** Wraps a value in an explicit present state. */
+export function presentValue(value) {
+    return { kind: PRESENCE_KINDS.PRESENT, value };
+}
+/** Represents a value that is explicitly absent. */
+export function absentValue() {
+    return { kind: PRESENCE_KINDS.ABSENT };
+}
+/** Wraps a value in an explicit applicable state. */
+export function applicableValue(value) {
+    return { kind: APPLICABILITY_KINDS.APPLICABLE, value };
+}
+/** Represents a value that is not applicable to the current operation. */
+export function notApplicableValue() {
+    return { kind: APPLICABILITY_KINDS.NOT_APPLICABLE };
+}
+//# sourceMappingURL=constructors.js.map

package/dist/shared/state/constructors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constructors.js","sourceRoot":"","sources":["../../../src/shared/state/constructors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrE,kDAAkD;AAClD,MAAM,UAAU,YAAY,CAAI,KAAQ;IACtC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE,CAAC;AACzC,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,eAAe,CAAI,KAAQ;IACzC,OAAO,EAAE,IAAI,EAAE,mBAAmB,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC;AACzD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB;IAChC,OAAO,EAAE,IAAI,EAAE,mBAAmB,CAAC,cAAc,EAAE,CAAC;AACtD,CAAC"}

package/dist/shared/state/index.d.ts

@@ -1,3 +1,4 @@
+export { applicableValue, absentValue, notApplicableValue, presentValue, } from "./constructors.js";
 export { APPLICABILITY_KINDS, LOOKUP_RESULT_KINDS, PRESENCE_KINDS, } from "./constants.js";
 export type { Applicability, LookupResult, Presence } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/shared/state/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/shared/state/index.js

@@ -1,2 +1,3 @@
+export { applicableValue, absentValue, notApplicableValue, presentValue, } from "./constructors.js";
 export { APPLICABILITY_KINDS, LOOKUP_RESULT_KINDS, PRESENCE_KINDS, } from "./constants.js";
 //# sourceMappingURL=index.js.map

package/dist/shared/state/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,GACf,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,GACf,MAAM,gBAAgB,CAAC"}

package/dist/shared/validation.d.ts

@@ -4,6 +4,8 @@ export declare function isNonEmptyString(value: unknown): value is string;
 export declare function isPositiveSafeInteger(value: unknown): value is number;
 /** Checks whether an unknown value is a non-negative safe integer. */
 export declare function isNonNegativeSafeInteger(value: unknown): value is number;
+/** Checks whether a string is the canonical UTC ISO representation of a date. */
+export declare function isCanonicalUtcIsoDate(value: unknown): value is string;
 /** Checks whether a list contains at least one item. */
 export declare function isNonEmptyList<T>(values: readonly T[]): boolean;
 //# sourceMappingURL=validation.d.ts.map

package/dist/shared/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/shared/validation.ts"],"names":[],"mappings":"AASA,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAKhE;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAMrE;AAED,sEAAsE;AACtE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAMxE;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAE/D"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/shared/validation.ts"],"names":[],"mappings":"AASA,6DAA6D;AAC7D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAKhE;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAMrE;AAED,sEAAsE;AACtE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAMxE;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CASrE;AAED,wDAAwD;AACxD,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAE/D"}

package/dist/shared/validation.js

@@ -18,6 +18,15 @@ export function isNonNegativeSafeInteger(value) {
         Number.isSafeInteger(value) &&
         value >= NON_NEGATIVE_SAFE_INTEGER_MINIMUM);
 }
+/** Checks whether a string is the canonical UTC ISO representation of a date. */
+export function isCanonicalUtcIsoDate(value) {
+    if (!isJavaScriptType(value, JAVASCRIPT_TYPE_NAMES.STRING) ||
+        !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(value)) {
+        return false;
+    }
+    const timestamp = Date.parse(value);
+    return Number.isFinite(timestamp) && new Date(timestamp).toISOString() === value;
+}
 /** Checks whether a list contains at least one item. */
 export function isNonEmptyList(values) {
     return values.length !== EMPTY_ARRAY_LENGTH_ZERO;

package/dist/shared/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/shared/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,6DAA6D;AAC7D,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC;QACrD,KAAK,CAAC,MAAM,KAAK,wBAAwB,CAC1C,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,CACL,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC;QACrD,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAC3B,KAAK,IAAI,6BAA6B,CACvC,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,CACL,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC;QACrD,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAC3B,KAAK,IAAI,iCAAiC,CAC3C,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,cAAc,CAAI,MAAoB;IACpD,OAAO,MAAM,CAAC,MAAM,KAAK,uBAAuB,CAAC;AACnD,CAAC"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/shared/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,6DAA6D;AAC7D,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC;QACrD,KAAK,CAAC,MAAM,KAAK,wBAAwB,CAC1C,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,CACL,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC;QACrD,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAC3B,KAAK,IAAI,6BAA6B,CACvC,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,CACL,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC;QACrD,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;QAC3B,KAAK,IAAI,iCAAiC,CAC3C,CAAC;AACJ,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,IACE,CAAC,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC;QACtD,CAAC,+CAA+C,CAAC,IAAI,CAAC,KAAK,CAAC,EAC5D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC;AACnF,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,cAAc,CAAI,MAAoB;IACpD,OAAO,MAAM,CAAC,MAAM,KAAK,uBAAuB,CAAC;AACnD,CAAC"}

package/docs/architecture.md

@@ -1,148 +1,153 @@
 # Hikoutei Architecture
 
 Hikoutei owns a local SQLite entity store and exposes Google Sheets as an
-asynchronous human-facing projection. The public API belongs to Hikoutei;
-MikroORM is the current replaceable execution engine behind that API.
+asynchronous human-facing projection. SQLite is the authority; Sheets is an
+internal service-side projection and human input surface.
 
-> Current status: the scalar entity lifecycle, SQLite transaction boundary,
-> outbox, outbound worker, gateway path, and the first provider-side User_Input
-> polling path are implemented. The global Conflict decision loop is still a
-> target design foundation, not a complete end-to-end public runtime yet. The
-> root public API is provider-neutral; MikroORM is only the current adapter and
-> Prisma is a future provider target.
+> The root package API is ORM-only. Sheet synchronization is implemented inside
+> `src`, but its bootstrap, gateway, worker, and storage contracts are not root
+> exports.
 
 ## System shape
 
 ```text
-Application server
-  └─ Hikoutei scalar entity API
-       ├─ entity descriptors and Sheet routes
-       └─ Hikoutei Unit of Work / EntityManager
-            └─ provider-neutral persistence contract
-                 └─ MikroORM + SQLite (current provider)
-                      ├─ business entity tables
-                      ├─ SQLite sync state and conflict ledger
-                      └─ durable Sheet effect outbox
-                           └─ separate sync worker
-                                └─ signed Apps Script gateway
-                                     └─ Google Sheets projections
+Application code
+  └─ hikoutei root API
+       └─ EntityManager
+            └─ SQLite entity tables
+                 └─ [internal sync service in the same process]
+                      ├─ canonical sync state
+                      ├─ durable Sheet effect outbox
+                      ├─ outbound effect worker
+                      ├─ User_Input polling
+                      └─ Apps Script gateway
+                           └─ Google Sheets projections
 ```
 
-## Ownership boundaries
+The internal service reuses the same MikroORM SQLite adapter and transaction
+boundary as the entity manager. A future deployment can extract the worker
+process without changing the root entity lifecycle contract.
 
-### TypedSheets public API
+## Source boundaries
 
-Applications define entities with `defineTypedSheetsEntity()` and use the
-typed-sheets EntityManager for `fork()`, `create()`, `find()`, `persist()`,
-`remove()`, `flush()`, and `transactional()`.
+```text
+src/domain/                         pure normalization/evaluation/conflict rules
+src/application/orm/                public ORM facade and mapped flush planning
+src/application/sync/               internal sync engine and service bootstrap
+src/adapter/persistence/            SQLite/MikroORM implementation
+src/adapter/sheets/                 Apps Script transport and operation adapter
+src/infrastructure/storage/         canonical, observation, resolution, outbox state
+src/api/                            root-facing entity and EntityManager facade
+src/index.ts                        root public barrel only
+apps-script/gateway/                deployable Apps Script code
+```
 
-Applications import only `defineTypedSheetsEntity()` and
-`createTypedSheets()` from the root package. They do not import `defineEntity`,
-`p`, `MikroORM`, Prisma, or provider-specific SQL types. The public Unit of Work
-owns identity maps, snapshots, dirty diffs, and flush semantics; the current
-MikroORM adapter materializes those plans and a future Prisma adapter must use
-the same provider contract.
+`src` does not mean public. The only application-facing package entrypoint is
+`src/index.ts`; package subpaths for providers, gateway operations, polling,
+and sync state are not part of the contract.
 
-### Business entity tables
+## Root public API
 
-The ORM entity tables are the authoritative application data. A successful
-SQLite transaction commits the entity mutation together with the sync work
-needed to project it to Sheets.
+Applications define scalar entities and open a local SQLite runtime:
 
-Primary keys are explicit, string-valued, and immutable in the scalar release.
-The primary `id` is also the visible business key by default. Relations,
-provider-specific query operators, lazy loading, and cascade persistence are
-out of scope for this release.
+```ts
+import { createTypedSheets, defineTypedSheetsEntity } from "hikoutei";
 
-### SQLite sync state
+const User = defineTypedSheetsEntity({
+  name: "User",
+  tableName: "users",
+  properties: {
+    id: { type: "string", primary: true },
+    name: { type: "string" },
+  },
+});
 
-SQLite sync tables record bindings, revisions, visible Sheet state, event
-evidence, conflicts, resolution commands, leases, and outbox effects. They are not
-additional business tables such as `Users_System` or `Users_Input`.
+const hikoutei = await createTypedSheets({
+  dbName: "./hikoutei.sqlite",
+  entities: [User],
+});
+
+const em = hikoutei.em.fork();
+const user = em.create(User, { id: "u1", name: "Ada" });
+em.persist(user);
+await em.flush();
+```
 
-The sync layer must not become a second source of application field values.
-Where it needs a value for hashing or conflict evidence, it stores the minimum
-required normalized snapshot or audit evidence and the entity table remains the
-application authority.
+The public surface contains entity definition, runtime creation, and the
+request-local `EntityManager` lifecycle: `fork()`, `create()`, `find()`,
+`findOne()`, `persist()`, `remove()`, `flush()`, and `transactional()`.
+MikroORM, raw SQL, gateway clients, Sheet routes, provisioning, polling, and
+outbox controls are internal.
 
-### Google Sheets projections
+## SQLite authority
 
-Each mapped entity can have a protected `System_State` projection and an
-editable `User_Input` projection. The application never reads normal entity
-data from Sheets. It reads SQLite; the worker observes User_Input only to
-evaluate intentional human changes.
+Business entity tables are the authoritative application data. Normal reads
+always come from SQLite and never from a Sheet. The public local runtime opens
+entity tables only and does not contact Google Sheets or create sync tables.
 
-The target design has one global `sync_conflicts` projection, conventionally
-represented by a `Sync_Conflicts` tab. A conflict row contains one field-level
-decision and two mutually exclusive controls:
+When the internal sync service is active, its mapped flush coordinator extends
+the same SQLite transaction with:
 
 ```text
-conflict_id | entity_name | entity_id | field_name |
-system_value | user_value | use_system | use_user
+entity mutation
+canonical sync state
+projection registry/state
+Sheet effect outbox
 ```
 
-No checked control is a pending decision. Exactly one control creates a
-compare-and-set resolution command. Both checked controls are invalid and are
-reset. A stale command is reset and leaves the conflict visible for rebase.
-After a successful resolution, SQLite records the result first and a durable
-outbox effect removes the resolved row from the Conflict projection. The
-projection contract is designed now; global registration and end-to-end
-checkbox consumption are still pending implementation.
+The service-side configuration supplies projection routes, spreadsheet identity,
+and user-owned fields. Those values are not entity metadata or public ORM
+options.
 
-## Transaction boundary
+## Google Sheets projection
 
-The transaction boundary ends at SQLite commit:
+The internal service provisions and validates registered projection tabs before
+starting delivery. It owns the signed Apps Script client, effect worker,
+response-loss recovery, reconciliation, and User_Input polling.
+
+The application does not call Sheet operations. A successful public `flush()`
+means that the local SQLite transaction committed. It does not mean that a
+remote Sheet write has completed.
+
+`System_State` is materialized from canonical SQLite state. `User_Input` is
+observed by the internal polling loop, evaluated with ownership and field-level
+compare-and-set rules, and then committed back to SQLite. Stale, conflicting,
+and malformed input is recorded in SQLite rather than silently overwriting the
+entity table.
+
+## Transaction and lifecycle boundary
 
 ```text
 em.persist(entity) / em.remove(entity)
           │
           ▼
-SQLite transaction
-  ├─ business entity table
-  ├─ SQLite sync state and conflict state
+SQLite transaction (internal sync service mode)
+  ├─ entity table
+  ├─ canonical state and conflict evidence
   └─ durable Sheet effect outbox
           │
           ▼
-separate worker process
-  ├─ drain outbound effects
-  ├─ poll User_Input
-  ├─ evaluate accepted fields and persist them through SQLite
-  └─ [planned] poll and apply Conflict decisions
+internal outbound effect supervisor
+  ├─ claim leases and send signed operations
+  ├─ retry recoverable failures
+  └─ reconcile remote drift
           │
           ▼
-Google Sheets projection
+Apps Script gateway ──▶ Google Sheets
+
+internal User_Input polling
+  ├─ read registered projections
+  ├─ evaluate ownership/revisions/CAS
+  └─ persist accepted observations and entity mutations in SQLite
 ```
 
-`flush()` returning successfully means that SQLite accepted the local entity
-change, canonical sync mutation, and durable outbox effect in one transaction.
-It does not mean that a Sheet write has completed. Remote provisioning is also
-separate: `createTypedSheets()` is local-only and `setupSheets()` is the
-explicit external setup call.
-
-## Worker responsibilities
-
-The initial inbound source is polling. The current MikroORM provider exposes a
-worker-side one-pass polling entrypoint that observes `User_Input`, validates
-row identity and cells, evaluates field revisions, and persists accepted rows
-through the observation writer and mapped entity mutation transaction.
-Every remote projection is addressed through its registered visible business-key
-column (normally `id`), which must be required and unique in SQLite. Snapshot
-reads never assign or scan Developer Metadata. An unknown or duplicated business
-key is quarantined as invalid rather than being matched to a different entity.
-The Sheet owner should treat this identity column as immutable/protected: a
-polling-only runtime cannot prove which old row a manually changed key came from
-when the key is changed to another existing entity.
-`onEdit` can be added later as an optional lower-latency observation source, but
-it must enter the same evaluator and SQLite writer boundary. Long-running loop
-ownership and Conflict checkbox consumption remain worker follow-up work.
-
-The worker claims leases, sends signed gateway operations, retries recoverable
-failures, and reconciles remote drift. The Apps Script gateway performs only
-the signed, range-constrained Sheet operation; it does not choose conflict
-winners or own canonical state.
+The service bootstrap starts provisioning, outbound delivery, and inbound polling
+as one internal runtime. Shutdown stops polling first, waits for remote calls,
+stops the outbound supervisor, and only then closes SQLite.
 
 ## Design limits
 
 Hikoutei targets one local SQLite writer process and low-traffic MVP or internal
 workflows. It is not a distributed transaction coordinator, a general-purpose
-database, or a Google Sheets API replacement.
+database, or a Google Sheets API replacement. Live Google integration remains
+opt-in; normal tests use fake gateways and SQLite fixtures.