@amalgm/live 0.1.1 → 0.2.1

package/PURPOSE.md

@@ -58,6 +58,20 @@ its cutover.
     survive renames and rediscovery; local paths locate it but never become a
     second identity, and every registry change emits both legacy `projects`
     and canonical `workspaces` resource events.
+12. **User ground is portable; coordination state is not.** Everything beneath
+    an authenticated `users/<email>/` home is registrable except the reserved
+    `.amalgm/` directory, transient SQLite journal/lock sidecars, and paths
+    excluded by its tracked `.amalgmignore`; the durable SQLite database itself
+    remains portable ground.
+13. **The graph, not SQLite, travels.** R2 receives canonical entity snapshots
+    and immutable content; a machine derives its SQLite rows, paths, physical
+    identities, observer evidence, and watcher bindings locally.
+14. **Login convergence has one authority.** A first machine conditionally
+    publishes the declared home; every later machine materializes that exact
+    cloud graph, and a simultaneous first-login loser adopts the winning graph.
+15. **Cloud precedes Watch.** Login becomes ready only after local records equal
+    the active cloud snapshot and watcher coverage is established over the
+    resulting user ground.
 
 ## Five surfaces, one behavior
 
@@ -88,6 +102,8 @@ src/entities/    the entity model's rule surface: the six-field record,
 src/detection/   the Detect/Watch pure cores: the adapter contract, the
                  three-channel compare (diff) core, coverage, continuity
                  verdicts, classification, refusals, enrollment policy.
+src/registration/ the login-time user-ground convergence operation and its
+                  injected local/cloud effect ports.
 src/adapters/    the ports a host injects: transport, journal store,
                  content store, clock, crypto, logger.
 tests/           unit tests per module, in the engine wall's style: each

package/README.md

@@ -22,6 +22,7 @@ normative specifications live in [docs/](docs/):
 | [cloud-mutation-discipline.md](docs/cloud-mutation-discipline.md) | the journal-first write discipline and conformance rules |
 | [shared-realtime-wave-3.md](docs/shared-realtime-wave-3.md) | the multi-user cloud-authority design |
 | [extraction-boundary.md](docs/extraction-boundary.md) | what moves here from the engine runtime, and in what order |
+| [user-ground-login.md](docs/user-ground-login.md) | first-login publication, later-device materialization, and Watch readiness |
 
 ## Surfaces
 

package/dist/detection/enrollment.d.ts

@@ -11,6 +11,26 @@
  */
 /** The injected policy shape: relative path in, verdict out. */
 export type EnrollmentPolicy = (relPath: string) => boolean;
+/** The Git-like names at the user-ground boundary. Structural coordination
+ * state is local and cannot be negated by user policy; the ignore file is
+ * portable ground so every machine evaluates the same user rules. */
+export declare const AMALGM_CONTROL_DIRECTORY = ".amalgm";
+export declare const AMALGM_IGNORE_FILE = ".amalgmignore";
+export declare const DEFAULT_AMALGM_IGNORE = "/.amalgm/\n";
 /** The default policy. Both separators are path separators; '' never enrolls. */
 export declare const defaultShouldEnroll: EnrollmentPolicy;
+/** One normalized spelling for enrollment and ignore matching. */
+export declare function normalizedRelativePath(relPath: string): string;
+/** `.amalgm/` is local control state wherever a registered tree is rooted. */
+export declare function isAmalgmControlPath(relPath: string): boolean;
+/** SQLite's WAL, shared-memory, and rollback-journal files coordinate one
+ * local database connection. They are not a portable copy of the database. */
+export declare function isSqliteCoordinationPath(relPath: string): boolean;
+/**
+ * Compile the root `.amalgmignore` for a user ground. Rules are ordered and
+ * `!` negates a prior user rule. Reserved control state and transient SQLite
+ * coordination files are structural exclusions; every other path is ground
+ * unless this tracked file excludes it. The policy file itself always travels.
+ */
+export declare function createUserGroundEnrollmentPolicy(ignoreText?: string): EnrollmentPolicy;
 //# sourceMappingURL=enrollment.d.ts.map

package/dist/detection/enrollment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enrollment.d.ts","sourceRoot":"","sources":["../../src/detection/enrollment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;AAgD5D,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,EAAE,gBAMjC,CAAC"}
+{"version":3,"file":"enrollment.d.ts","sourceRoot":"","sources":["../../src/detection/enrollment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,gEAAgE;AAChE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;AAE5D;;qEAEqE;AACrE,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAClD,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,eAAO,MAAM,qBAAqB,gBAAoC,CAAC;AAgDvE,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,EAAE,gBAMjC,CAAC;AAEF,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;8EAC8E;AAC9E,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGjE;AAsDD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,UAAU,SAAK,GAAG,gBAAgB,CAalF"}

package/dist/detection/enrollment.js

@@ -9,6 +9,12 @@
  * Pure string policy: a host may inject its own `EnrollmentPolicy`
  * everywhere this default is accepted.
  */
+/** The Git-like names at the user-ground boundary. Structural coordination
+ * state is local and cannot be negated by user policy; the ignore file is
+ * portable ground so every machine evaluates the same user rules. */
+export const AMALGM_CONTROL_DIRECTORY = '.amalgm';
+export const AMALGM_IGNORE_FILE = '.amalgmignore';
+export const DEFAULT_AMALGM_IGNORE = `/${AMALGM_CONTROL_DIRECTORY}/\n`;
 const EXCLUDED_DIRECTORIES = new Set([
     '.amalgm',
     '.aws',
@@ -59,7 +65,7 @@ function isPrivateFile(name) {
 }
 /** The default policy. Both separators are path separators; '' never enrolls. */
 export const defaultShouldEnroll = (relPath) => {
-    const parts = relPath.split(/[\\/]/).filter(Boolean);
+    const parts = normalizedRelativePath(relPath).split('/').filter(Boolean);
     const name = parts.at(-1);
     if (name === undefined || parts.some((part) => EXCLUDED_DIRECTORIES.has(part)))
         return false;
@@ -67,4 +73,99 @@ export const defaultShouldEnroll = (relPath) => {
         return false;
     return !name.startsWith('.#') && !name.endsWith('~') && !/\.(?:swp|swo)$/i.test(name);
 };
+/** One normalized spelling for enrollment and ignore matching. */
+export function normalizedRelativePath(relPath) {
+    return String(relPath || '')
+        .replace(/\\/g, '/')
+        .replace(/^\.\//, '')
+        .replace(/^\/+|\/+$/g, '')
+        .replace(/\/{2,}/g, '/');
+}
+/** `.amalgm/` is local control state wherever a registered tree is rooted. */
+export function isAmalgmControlPath(relPath) {
+    return normalizedRelativePath(relPath).split('/').includes(AMALGM_CONTROL_DIRECTORY);
+}
+/** SQLite's WAL, shared-memory, and rollback-journal files coordinate one
+ * local database connection. They are not a portable copy of the database. */
+export function isSqliteCoordinationPath(relPath) {
+    const name = normalizedRelativePath(relPath).split('/').at(-1) ?? '';
+    return /\.(?:db|sqlite|sqlite3)-(?:wal|shm|journal)$/i.test(name);
+}
+function escapeRegex(character) {
+    return /[\\^$.*+?()[\]{}|]/.test(character) ? `\\${character}` : character;
+}
+function globExpression(pattern) {
+    let expression = '';
+    for (let index = 0; index < pattern.length; index += 1) {
+        const character = pattern[index];
+        if (character === '*') {
+            if (pattern[index + 1] === '*') {
+                while (pattern[index + 1] === '*')
+                    index += 1;
+                if (pattern[index + 1] === '/') {
+                    index += 1;
+                    expression += '(?:.*/)?';
+                }
+                else {
+                    expression += '.*';
+                }
+            }
+            else {
+                expression += '[^/]*';
+            }
+        }
+        else if (character === '?') {
+            expression += '[^/]';
+        }
+        else {
+            expression += escapeRegex(character);
+        }
+    }
+    return expression;
+}
+function ignoreRule(line) {
+    let value = line.trim();
+    if (!value || value.startsWith('#'))
+        return null;
+    let negated = false;
+    if (value.startsWith('!')) {
+        negated = true;
+        value = value.slice(1);
+    }
+    if (!value)
+        return null;
+    const anchored = value.startsWith('/');
+    if (anchored)
+        value = value.slice(1);
+    if (value.endsWith('/'))
+        value = value.slice(0, -1);
+    if (!value)
+        return null;
+    const body = globExpression(value);
+    const prefix = anchored || value.includes('/') ? '^' : '(?:^|/)';
+    return { negated, expression: new RegExp(`${prefix}${body}(?:$|/)`) };
+}
+/**
+ * Compile the root `.amalgmignore` for a user ground. Rules are ordered and
+ * `!` negates a prior user rule. Reserved control state and transient SQLite
+ * coordination files are structural exclusions; every other path is ground
+ * unless this tracked file excludes it. The policy file itself always travels.
+ */
+export function createUserGroundEnrollmentPolicy(ignoreText = '') {
+    const rules = String(ignoreText).split(/\r?\n/).map(ignoreRule)
+        .filter((rule) => rule !== null);
+    return (input) => {
+        const relPath = normalizedRelativePath(input);
+        if (!relPath || isAmalgmControlPath(relPath) || isSqliteCoordinationPath(relPath))
+            return false;
+        if (relPath === AMALGM_IGNORE_FILE)
+            return true;
+        let excluded = false;
+        for (const rule of rules) {
+            if (rule.expression.test(relPath))
+                excluded = !rule.negated;
+        }
+        return !excluded;
+    };
+}
 //# sourceMappingURL=enrollment.js.map

package/dist/detection/enrollment.js.map

@@ -1 +1 @@
-{"version":3,"file":"enrollment.js","sourceRoot":"","sources":["../../src/detection/enrollment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,SAAS;IACT,MAAM;IACN,QAAQ;IACR,SAAS;IACT,MAAM;IACN,QAAQ;IACR,SAAS;IACT,KAAK;IACL,OAAO;IACP,aAAa;IACb,OAAO;IACP,aAAa;IACb,eAAe;IACf,eAAe;IACf,aAAa;IACb,MAAM;IACN,MAAM;IACN,aAAa;IACb,QAAQ;IACR,OAAO;IACP,OAAO;IACP,aAAa;IACb,UAAU;IACV,cAAc;CACf,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,WAAW;IACX,WAAW;IACX,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;CACjB,CAAC,CAAC;AAEH,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,IAAI,4DAA4D,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzF,IAAI,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,IAAI,yEAAyE,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtG,IAAI,0DAA0D,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACvF,OAAO,gEAAgE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrF,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,MAAM,mBAAmB,GAAqB,CAAC,OAAO,EAAE,EAAE;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7F,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxF,CAAC,CAAC"}
+{"version":3,"file":"enrollment.js","sourceRoot":"","sources":["../../src/detection/enrollment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;qEAEqE;AACrE,MAAM,CAAC,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAClD,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,wBAAwB,KAAK,CAAC;AAEvE,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,SAAS;IACT,MAAM;IACN,QAAQ;IACR,SAAS;IACT,MAAM;IACN,QAAQ;IACR,SAAS;IACT,KAAK;IACL,OAAO;IACP,aAAa;IACb,OAAO;IACP,aAAa;IACb,eAAe;IACf,eAAe;IACf,aAAa;IACb,MAAM;IACN,MAAM;IACN,aAAa;IACb,QAAQ;IACR,OAAO;IACP,OAAO;IACP,aAAa;IACb,UAAU;IACV,cAAc;CACf,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,WAAW;IACX,WAAW;IACX,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;CACjB,CAAC,CAAC;AAEH,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,IAAI,4DAA4D,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzF,IAAI,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,IAAI,yEAAyE,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtG,IAAI,0DAA0D,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACvF,OAAO,gEAAgE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrF,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,MAAM,mBAAmB,GAAqB,CAAC,OAAO,EAAE,EAAE;IAC/D,MAAM,KAAK,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7F,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxF,CAAC,CAAC;AAEF,kEAAkE;AAClE,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,OAAO,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;SACzB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;SACzB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC,CAAC;AACvF,CAAC;AAED;8EAC8E;AAC9E,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,MAAM,IAAI,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrE,OAAO,+CAA+C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC;AAOD,SAAS,WAAW,CAAC,SAAiB;IACpC,OAAO,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAW,CAAC;QAC3C,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC/B,OAAO,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;oBAAE,KAAK,IAAI,CAAC,CAAC;gBAC9C,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC/B,KAAK,IAAI,CAAC,CAAC;oBACX,UAAU,IAAI,UAAU,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBACN,UAAU,IAAI,IAAI,CAAC;gBACrB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,UAAU,IAAI,OAAO,CAAC;YACxB,CAAC;QACH,CAAC;aAAM,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YAC7B,UAAU,IAAI,MAAM,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,UAAU,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACxB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,GAAG,IAAI,CAAC;QACf,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,QAAQ;QAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAAC,UAAU,GAAG,EAAE;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;SAC5D,MAAM,CAAC,CAAC,IAAI,EAAsB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,CAAC,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,IAAI,wBAAwB,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAChG,IAAI,OAAO,KAAK,kBAAkB;YAAE,OAAO,IAAI,CAAC;QAChD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAE,QAAQ,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;QAC9D,CAAC;QACD,OAAO,CAAC,QAAQ,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -13,6 +13,7 @@ export * from './contracts/index.js';
 export * from './machines/index.js';
 export * from './entities/index.js';
 export * from './detection/index.js';
+export * from './registration/index.js';
 export * from './merge/index.js';
 export * from './workspace/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -13,6 +13,7 @@ export * from './contracts/index.js';
 export * from './machines/index.js';
 export * from './entities/index.js';
 export * from './detection/index.js';
+export * from './registration/index.js';
 export * from './merge/index.js';
 export * from './workspace/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/registration/index.d.ts

@@ -0,0 +1,3 @@
+/** Login-time Register/Add convergence over injected local and cloud effects. */
+export * from './user-ground.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registration/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,cAAc,kBAAkB,CAAC"}

package/dist/registration/index.js

@@ -0,0 +1,3 @@
+/** Login-time Register/Add convergence over injected local and cloud effects. */
+export * from './user-ground.js';
+//# sourceMappingURL=index.js.map

package/dist/registration/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registration/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,cAAc,kBAAkB,CAAC"}

package/dist/registration/user-ground.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Login-time user-ground convergence.
+ *
+ * Core owns when this operation runs. Live owns what it means: either create
+ * one initial cloud graph or install the active graph, prove the local
+ * materialization carries the same portable records, then start Watch. Every
+ * filesystem, SQLite, content, and R2 effect is injected by the host.
+ */
+import { type CloudEntityRecord, type CloudSnapshot, type Sha256Hex } from '../entities/index.js';
+export interface UserGroundIdentity {
+    readonly userId: string;
+    readonly userEmail: string;
+    readonly deviceId: string;
+}
+/** The active immutable R2 snapshot selected by the cloud authority. */
+export interface CloudUserGround {
+    readonly resourceId: string;
+    readonly version: number;
+    readonly checksum: string;
+    readonly snapshot: CloudSnapshot;
+}
+/** The local projection: portable records plus machine-only placement. */
+export interface LocalUserGround {
+    readonly userId: string;
+    readonly userEmail: string;
+    readonly deviceId: string;
+    readonly localRoot: string;
+    readonly sqlitePath: string;
+    readonly records: readonly CloudEntityRecord[];
+}
+export interface UserGroundWatchEvidence {
+    readonly active: true;
+    readonly roots: number;
+}
+export interface UserGroundCloudPort {
+    /** Resolve the active immutable snapshot, or null when this user has none. */
+    lookup(resourceId: string): Promise<unknown>;
+    /** Compare-and-create. A racing loser receives created=false + the winner. */
+    publishInitial(input: {
+        readonly resourceId: string;
+        readonly checksum: string;
+        readonly snapshot: CloudSnapshot;
+    }): Promise<{
+        readonly created: boolean;
+        readonly current: unknown;
+    }>;
+}
+export interface UserGroundLocalPort {
+    /** Inspect an existing local projection without creating or binding it. */
+    inspect(identity: UserGroundIdentity): Promise<unknown>;
+    /** Create the declared new-user home and register its complete graph. */
+    initialize(identity: UserGroundIdentity): Promise<unknown>;
+    /** Materialize/install the supplied cloud graph and immutable content. */
+    install(identity: UserGroundIdentity, cloud: CloudUserGround): Promise<unknown>;
+    /** Begin or prove coverage only after cloud/local identity agrees. */
+    watch(identity: UserGroundIdentity, cloud: CloudUserGround): Promise<unknown>;
+}
+export interface UserGroundConvergencePorts {
+    readonly sha256Hex: Sha256Hex;
+    readonly cloud: UserGroundCloudPort;
+    readonly local: UserGroundLocalPort;
+}
+export interface UserGroundConvergence {
+    readonly userId: string;
+    readonly userEmail: string;
+    readonly deviceId: string;
+    readonly localRoot: string;
+    readonly sqlitePath: string;
+    readonly cloudResourceId: string;
+    readonly cloudVersion: number;
+    readonly cloudHead: string;
+    readonly mode: 'initialized' | 'materialized' | 'current';
+    readonly entityCount: number;
+    readonly watcherRoots: number;
+    readonly watching: true;
+}
+/**
+ * Converge one login. No caller selects "new" versus "existing": the active
+ * cloud head decides. Initial publication is conditional, so two first
+ * machines cannot create two authorities.
+ */
+export declare function convergeUserGround(input: UserGroundIdentity, ports: UserGroundConvergencePorts): Promise<UserGroundConvergence>;
+//# sourceMappingURL=user-ground.d.ts.map

package/dist/registration/user-ground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-ground.d.ts","sourceRoot":"","sources":["../../src/registration/user-ground.ts"],"names":[],"mappings":"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"}

package/dist/registration/user-ground.js

@@ -0,0 +1,143 @@
+/**
+ * Login-time user-ground convergence.
+ *
+ * Core owns when this operation runs. Live owns what it means: either create
+ * one initial cloud graph or install the active graph, prove the local
+ * materialization carries the same portable records, then start Watch. Every
+ * filesystem, SQLite, content, and R2 effect is injected by the host.
+ */
+import { privateEntityResourceId, sameRecords, snapshotFromRecords, stableJson, } from '../entities/index.js';
+const HASH = /^[0-9a-f]{64}$/;
+function required(value, name) {
+    const text = typeof value === 'string' ? value.trim() : '';
+    if (!text)
+        throw new Error(`user-ground ${name} is required`);
+    return text;
+}
+function normalizeIdentity(input) {
+    return {
+        userId: required(input?.userId, 'user id'),
+        userEmail: required(input?.userEmail, 'user email').toLowerCase(),
+        deviceId: required(input?.deviceId, 'device id'),
+    };
+}
+function assertCloud(value, resourceId, sha256Hex) {
+    const cloud = value;
+    if (!cloud || cloud.resourceId !== resourceId
+        || !Number.isSafeInteger(cloud.version) || Number(cloud.version) < 0
+        || typeof cloud.checksum !== 'string' || !HASH.test(cloud.checksum)) {
+        throw new Error('cloud user-ground head is invalid');
+    }
+    const snapshot = snapshotFromRecords(cloud.snapshot?.records || []);
+    if (snapshot.records.length === 0)
+        throw new Error('cloud user-ground graph is empty');
+    const checksum = sha256Hex(stableJson(snapshot));
+    if (checksum !== cloud.checksum)
+        throw new Error('cloud user-ground snapshot checksum mismatch');
+    return {
+        resourceId,
+        version: Number(cloud.version),
+        checksum,
+        snapshot,
+    };
+}
+function controlPath(path) {
+    return path.replace(/\\/g, '/').split('/').includes('.amalgm');
+}
+function assertLocal(value, identity) {
+    const local = value;
+    if (!local
+        || local.userId !== identity.userId
+        || String(local.userEmail || '').toLowerCase() !== identity.userEmail
+        || local.deviceId !== identity.deviceId) {
+        throw new Error('local user-ground identity does not match login');
+    }
+    const localRoot = required(local.localRoot, 'local root');
+    const sqlitePath = required(local.sqlitePath, 'SQLite path');
+    if (!controlPath(sqlitePath)) {
+        throw new Error('local user-ground SQLite must live inside the reserved .amalgm control directory');
+    }
+    const snapshot = snapshotFromRecords(local.records || []);
+    if (snapshot.records.length === 0)
+        throw new Error('local user-ground graph is empty');
+    return { ...identity, localRoot, sqlitePath, records: snapshot.records };
+}
+function assertSameGraph(local, cloud) {
+    if (!sameRecords(local.records, cloud.snapshot.records)) {
+        throw new Error('local user-ground graph does not match the active cloud snapshot');
+    }
+}
+function assertWatch(value) {
+    const watch = value;
+    if (!watch || watch.active !== true || !Number.isSafeInteger(watch.roots) || Number(watch.roots) < 1) {
+        throw new Error('user-ground watcher coverage is not active');
+    }
+    return { active: true, roots: Number(watch.roots) };
+}
+/**
+ * Converge one login. No caller selects "new" versus "existing": the active
+ * cloud head decides. Initial publication is conditional, so two first
+ * machines cannot create two authorities.
+ */
+export async function convergeUserGround(input, ports) {
+    const identity = normalizeIdentity(input);
+    const resourceId = privateEntityResourceId(identity.userId, ports.sha256Hex);
+    const found = await ports.cloud.lookup(resourceId);
+    let cloud;
+    let local;
+    let mode;
+    if (found === null || found === undefined) {
+        const initialized = assertLocal(await ports.local.initialize(identity), identity);
+        const snapshot = snapshotFromRecords(initialized.records);
+        const checksum = ports.sha256Hex(stableJson(snapshot));
+        const published = await ports.cloud.publishInitial({ resourceId, checksum, snapshot });
+        cloud = assertCloud(published.current, resourceId, ports.sha256Hex);
+        if (published.created) {
+            assertSameGraph(initialized, cloud);
+            local = initialized;
+            mode = 'initialized';
+        }
+        else {
+            local = assertLocal(await ports.local.install(identity, cloud), identity);
+            assertSameGraph(local, cloud);
+            mode = 'materialized';
+        }
+    }
+    else {
+        cloud = assertCloud(found, resourceId, ports.sha256Hex);
+        const currentValue = await ports.local.inspect(identity);
+        if (currentValue !== null && currentValue !== undefined) {
+            const current = assertLocal(currentValue, identity);
+            if (sameRecords(current.records, cloud.snapshot.records)) {
+                local = current;
+                mode = 'current';
+            }
+            else {
+                local = assertLocal(await ports.local.install(identity, cloud), identity);
+                assertSameGraph(local, cloud);
+                mode = 'materialized';
+            }
+        }
+        else {
+            local = assertLocal(await ports.local.install(identity, cloud), identity);
+            assertSameGraph(local, cloud);
+            mode = 'materialized';
+        }
+    }
+    const watch = assertWatch(await ports.local.watch(identity, cloud));
+    const finalLocal = assertLocal(await ports.local.inspect(identity), identity);
+    assertSameGraph(finalLocal, cloud);
+    return {
+        ...identity,
+        localRoot: finalLocal.localRoot,
+        sqlitePath: finalLocal.sqlitePath,
+        cloudResourceId: cloud.resourceId,
+        cloudVersion: cloud.version,
+        cloudHead: cloud.checksum,
+        mode,
+        entityCount: cloud.snapshot.records.length,
+        watcherRoots: watch.roots,
+        watching: true,
+    };
+}
+//# sourceMappingURL=user-ground.js.map

package/dist/registration/user-ground.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amalgm/live",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Portable realtime SDK for Amalgm — wire contracts, mutation discipline, and delivery state machines behind host-injected adapters.",
   "type": "module",
   "license": "UNLICENSED",
@@ -31,6 +31,10 @@
     "./workspace": {
       "types": "./dist/workspace/index.d.ts",
       "default": "./dist/workspace/index.js"
+    },
+    "./registration": {
+      "types": "./dist/registration/index.d.ts",
+      "default": "./dist/registration/index.js"
     }
   },
   "files": [