@thxgg/steward 0.1.24 → 0.1.25

package/.output/server/chunks/nitro/nitro.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"nitro.mjs","sources":["../../../../node_modules/destr/dist/index.mjs","../../../../node_modules/ufo/dist/index.mjs","../../../../node_modules/radix3/dist/index.mjs","../../../../node_modules/defu/dist/defu.mjs","../../../../node_modules/node-mock-http/dist/index.mjs","../../../../node_modules/h3/dist/index.mjs","../../../../node_modules/hookable/dist/index.mjs","../../../../node_modules/node-fetch-native/dist/native.mjs","../../../../node_modules/ofetch/dist/shared/ofetch.CWycOUEr.mjs","../../../../node_modules/ofetch/dist/node.mjs","../../../../node_modules/unstorage/dist/shared/unstorage.zVDD2mZo.mjs","../../../../node_modules/unstorage/dist/index.mjs","../../../../node_modules/unstorage/drivers/utils/index.mjs","../../../../node_modules/unstorage/drivers/utils/node-fs.mjs","../../../../node_modules/unstorage/drivers/fs-lite.mjs","../../../../node_modules/nitropack/dist/runtime/internal/storage.mjs","../../../../node_modules/ohash/dist/shared/ohash.D__AXeF1.mjs","../../../../node_modules/ohash/dist/crypto/node/index.mjs","../../../../node_modules/ohash/dist/index.mjs","../../../../node_modules/nitropack/dist/runtime/internal/hash.mjs","../../../../node_modules/nitropack/dist/runtime/internal/cache.mjs","../../../../node_modules/klona/dist/index.mjs","../../../../node_modules/scule/dist/index.mjs","../../../../node_modules/nitropack/dist/runtime/internal/utils.env.mjs","../../../../node_modules/nitropack/dist/runtime/internal/config.mjs","../../../../node_modules/unctx/dist/index.mjs","../../../../node_modules/nitropack/dist/runtime/internal/context.mjs","../../../../node_modules/nitropack/dist/runtime/internal/route-rules.mjs","../../../../node_modules/nitropack/dist/runtime/internal/utils.mjs","../../../../node_modules/@nuxt/nitro-server/dist/runtime/utils/error.mjs","../../../../node_modules/@nuxt/nitro-server/dist/runtime/handlers/error.mjs","../../../../node_modules/nitropack/dist/runtime/internal/error/utils.mjs","../../../../node_modules/nitropack/dist/runtime/internal/error/prod.mjs","../../../../node_modules/@nuxtjs/color-mode/dist/runtime/nitro-plugin.js","../../../../node_modules/nitropack/dist/runtime/internal/plugin.mjs","../../../../server/utils/db.ts","../../../../server/utils/change-events.ts","../../../../server/utils/git-repo-path.ts","../../../../server/utils/git.ts","../../../../server/utils/repos.ts","../../../../server/utils/state-schema.ts","../../../../server/utils/state-migration.ts","../../../../server/plugins/00-state-migration.ts","../../../../node_modules/pathe/dist/shared/pathe.M-eThtNZ.mjs","../../../../node_modules/nitropack/dist/runtime/internal/static.mjs","../../../../server/middleware/00-security.ts","../../../../node_modules/nitropack/dist/runtime/internal/app.mjs","../../../../node_modules/nitropack/dist/runtime/internal/renderer.mjs","../../../../node_modules/nitropack/dist/runtime/internal/lib/http-graceful-shutdown.mjs","../../../../node_modules/nitropack/dist/runtime/internal/shutdown.mjs","../../../../node_modules/nitropack/dist/presets/node/runtime/node-server.mjs"],"names":["getQuery","createRouter","f","h","c","i","l","createError","mergeHeaders","s","nodeFetch","Headers","Headers$1","AbortController$1","normalizeKey","defineDriver","DRIVER_NAME","dirname","fsPromises","resolve","fsp","serialize","hash","_inlineAppConfig","createRadixRouter","fs","normalizePathSlashes","isAbsolute","isGitRepo","nitroApp","callNodeRequestHandler","fetchNodeRequestHandler","gracefulShutdown","HttpsServer","HttpServer"],"mappings":"","x_google_ignoreList":[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,43,44,46,47,48,49,50]}
+{"version":3,"file":"nitro.mjs","sources":["../../../../node_modules/destr/dist/index.mjs","../../../../node_modules/ufo/dist/index.mjs","../../../../node_modules/radix3/dist/index.mjs","../../../../node_modules/defu/dist/defu.mjs","../../../../node_modules/node-mock-http/dist/index.mjs","../../../../node_modules/h3/dist/index.mjs","../../../../node_modules/hookable/dist/index.mjs","../../../../node_modules/node-fetch-native/dist/native.mjs","../../../../node_modules/ofetch/dist/shared/ofetch.CWycOUEr.mjs","../../../../node_modules/ofetch/dist/node.mjs","../../../../node_modules/unstorage/dist/shared/unstorage.zVDD2mZo.mjs","../../../../node_modules/unstorage/dist/index.mjs","../../../../node_modules/unstorage/drivers/utils/index.mjs","../../../../node_modules/unstorage/drivers/utils/node-fs.mjs","../../../../node_modules/unstorage/drivers/fs-lite.mjs","../../../../node_modules/nitropack/dist/runtime/internal/storage.mjs","../../../../node_modules/ohash/dist/shared/ohash.D__AXeF1.mjs","../../../../node_modules/ohash/dist/crypto/node/index.mjs","../../../../node_modules/ohash/dist/index.mjs","../../../../node_modules/nitropack/dist/runtime/internal/hash.mjs","../../../../node_modules/nitropack/dist/runtime/internal/cache.mjs","../../../../node_modules/klona/dist/index.mjs","../../../../node_modules/scule/dist/index.mjs","../../../../node_modules/nitropack/dist/runtime/internal/utils.env.mjs","../../../../node_modules/nitropack/dist/runtime/internal/config.mjs","../../../../node_modules/unctx/dist/index.mjs","../../../../node_modules/nitropack/dist/runtime/internal/context.mjs","../../../../node_modules/nitropack/dist/runtime/internal/route-rules.mjs","../../../../node_modules/nitropack/dist/runtime/internal/utils.mjs","../../../../node_modules/@nuxt/nitro-server/dist/runtime/utils/error.mjs","../../../../node_modules/@nuxt/nitro-server/dist/runtime/handlers/error.mjs","../../../../node_modules/nitropack/dist/runtime/internal/error/utils.mjs","../../../../node_modules/nitropack/dist/runtime/internal/error/prod.mjs","../../../../node_modules/@nuxtjs/color-mode/dist/runtime/nitro-plugin.js","../../../../node_modules/nitropack/dist/runtime/internal/plugin.mjs","../../../../server/utils/db.ts","../../../../server/utils/change-events.ts","../../../../server/utils/git-repo-path.ts","../../../../server/utils/git.ts","../../../../server/utils/sync-identity.ts","../../../../server/utils/repos.ts","../../../../server/utils/state-schema.ts","../../../../server/utils/state-migration.ts","../../../../server/plugins/00-state-migration.ts","../../../../node_modules/pathe/dist/shared/pathe.M-eThtNZ.mjs","../../../../node_modules/nitropack/dist/runtime/internal/static.mjs","../../../../server/middleware/00-security.ts","../../../../node_modules/nitropack/dist/runtime/internal/app.mjs","../../../../node_modules/nitropack/dist/runtime/internal/renderer.mjs","../../../../node_modules/nitropack/dist/runtime/internal/lib/http-graceful-shutdown.mjs","../../../../node_modules/nitropack/dist/runtime/internal/shutdown.mjs","../../../../node_modules/nitropack/dist/presets/node/runtime/node-server.mjs"],"names":["getQuery","createRouter","f","h","c","i","l","createError","mergeHeaders","s","nodeFetch","Headers","Headers$1","AbortController$1","normalizeKey","defineDriver","DRIVER_NAME","dirname","fsPromises","resolve","fsp","serialize","hash","_inlineAppConfig","createRadixRouter","fs","normalizePathSlashes","isAbsolute","execGit","isGitRepo","nowIso","nitroApp","callNodeRequestHandler","fetchNodeRequestHandler","gracefulShutdown","HttpsServer","HttpServer"],"mappings":"","x_google_ignoreList":[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,44,45,47,48,49,50,51]}

package/.output/server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thxgg/steward-prod",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "type": "module",
   "private": true,
   "dependencies": {

package/README.md

@@ -58,14 +58,55 @@ Note: `execute` runs in a VM sandbox by design, so globals like `process` are in
 prd ui
 prd ui --port 3100 --host 127.0.0.1
 prd mcp
+prd sync export ./steward-sync.json
+prd sync inspect ./steward-sync.json
+prd sync merge ./steward-sync.json
+prd sync merge ./steward-sync.json --apply
+prd sync merge ./steward-sync.json --apply --map rsk_source=/Users/you/Projects/repo
 ```
 
+### Sync Bundles (Cross-Device)
+
+Steward supports local-first state sharing across devices using portable JSON bundles.
+
+- `prd sync export <bundle-path>` writes a versioned bundle of repos/state/archives.
+- `prd sync inspect <bundle-path>` validates and summarizes bundle contents.
+- `prd sync merge <bundle-path>` plans a merge in dry-run mode by default.
+- `prd sync merge <bundle-path> --apply` applies the planned merge transactionally.
+
+Path hint privacy defaults:
+
+- Export defaults to `--path-hints basename` to avoid leaking absolute filesystem paths.
+- Use `--path-hints none` to omit path hints entirely.
+- Use `--path-hints absolute` only when you explicitly want full paths in the bundle.
+
+Representative command output summaries:
+
+- `sync export` prints bundle path, bundle id, and row totals (`repos/states/archives`).
+- `sync inspect` prints bundle metadata (`bundleId`, `sourceDeviceId`, format version), totals, and unknown references.
+- `sync merge` prints mapping totals, state/archive action counts, and conflict counts.
+- `sync merge --apply` also prints backup path and retention cleanup counts.
+
+Safety defaults and retention:
+
+- Merge defaults to dry-run; no writes happen unless `--apply` is provided.
+- Apply creates a SQLite backup before any write and runs an integrity check before commit.
+- Re-applying the same bundle id is idempotent and returns a no-op result.
+- Default retention keeps backups for 30 days (max 20 files) and sync apply logs for 180 days (max 10,000 rows).
+
+Troubleshooting sync:
+
+- Unresolved mapping on apply: run `prd sync inspect <bundle-path>` and pass one or more `--map <incomingRepoSyncKey>=<localPathOrRepoRef>` values.
+- Expected no-op reapply: if bundle id was already applied, merge returns "already applied" and leaves state unchanged.
+- Restore from backup: stop Steward processes, then replace your DB file with a backup in the same directory (files match `state.db.sync-backup.*.db`).
+
 ## Architecture
 
 ```
 ┌─────────────────────────────────────────┐
 │            Steward CLI (Node)           │
 │  - `prd ui` runs prebuilt UI server     │
+│  - `prd sync` manages state bundles     │
 │  - `prd mcp` starts MCP over stdio      │
 └─────────────────────────────────────────┘
                     │

package/bin/prd

@@ -12,7 +12,7 @@ const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..')
 const entryPath = resolve(packageRoot, 'dist', 'host', 'src', 'index.js')
 
 function requiresSqliteRuntime(command) {
-  return command === 'mcp' || command === 'ui'
+  return command === 'mcp' || command === 'ui' || command === 'sync'
 }
 
 function isSqliteRuntimeError(error) {

package/dist/host/src/index.js

@@ -1,14 +1,17 @@
 import { runMcpServer } from './mcp.js';
+import { runSync } from './sync.js';
 import { runUi } from './ui.js';
 function printUsage() {
     console.log(`prd - Steward CLI
 
 Usage:
   prd ui [--preview] [--port <port>] [--host <host>]
+  prd sync <subcommand> [options]
   prd mcp
 
 Commands:
   ui         Launch the prebuilt PRD web UI server
+  sync       Export/inspect/merge sync bundles
   mcp        Start MCP server over stdio (codemode)
 
 Options:
@@ -84,6 +87,13 @@ export async function main(argv = process.argv.slice(2)) {
         }
         return;
     }
+    if (command === 'sync') {
+        const exitCode = await runSync(rest);
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+        }
+        return;
+    }
     throw new Error(`Unknown command: ${command}`);
 }
 if (import.meta.main) {

package/dist/host/src/sync.js

@@ -0,0 +1,201 @@
+import { promises as fs } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { buildSyncBundle, serializeSyncBundle } from '../../server/utils/sync-export.js';
+import { executeSyncMergeJson } from '../../server/utils/sync-apply.js';
+import { inspectSyncBundleJson } from '../../server/utils/sync-inspect.js';
+function printSyncUsage() {
+    console.log(`Sync Usage:
+  prd sync export <bundle-path> [--path-hints basename|none|absolute]
+  prd sync inspect <bundle-path>
+  prd sync merge <bundle-path> [--map <incomingRepoSyncKey>=<localPathOrRepoRef>] [--dry-run] [--apply]
+
+Notes:
+  - merge defaults to --dry-run when --apply is omitted
+  - --map can be provided multiple times
+`);
+}
+function resolveBundlePath(pathInput) {
+    return resolve(process.cwd(), pathInput);
+}
+function parsePathHintsMode(rawValue) {
+    if (rawValue === 'basename' || rawValue === 'none' || rawValue === 'absolute') {
+        return rawValue;
+    }
+    throw new Error(`Invalid --path-hints value: ${rawValue}`);
+}
+function parseMapAssignment(rawValue) {
+    const separatorIndex = rawValue.indexOf('=');
+    if (separatorIndex <= 0 || separatorIndex >= rawValue.length - 1) {
+        throw new Error(`Invalid --map value: ${rawValue}. Expected <incomingRepoSyncKey>=<localPathOrRepoRef>`);
+    }
+    const source = rawValue.slice(0, separatorIndex).trim();
+    const target = rawValue.slice(separatorIndex + 1).trim();
+    if (!source || !target) {
+        throw new Error(`Invalid --map value: ${rawValue}. Expected <incomingRepoSyncKey>=<localPathOrRepoRef>`);
+    }
+    return { source, target };
+}
+export function parseSyncExportArgs(args) {
+    let bundlePath = null;
+    let pathHints = 'basename';
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (!arg) {
+            continue;
+        }
+        if (arg === '--path-hints') {
+            const next = args[index + 1];
+            if (!next) {
+                throw new Error('--path-hints requires a value');
+            }
+            pathHints = parsePathHintsMode(next);
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            throw new Error(`Unknown option for sync export: ${arg}`);
+        }
+        if (bundlePath !== null) {
+            throw new Error(`Unexpected argument for sync export: ${arg}`);
+        }
+        bundlePath = arg;
+    }
+    if (!bundlePath) {
+        throw new Error('sync export requires <bundle-path>');
+    }
+    return {
+        bundlePath: resolveBundlePath(bundlePath),
+        pathHints
+    };
+}
+export function parseSyncInspectArgs(args) {
+    const [bundlePath] = args;
+    if (args.length !== 1 || !bundlePath || bundlePath.startsWith('--')) {
+        throw new Error('sync inspect requires exactly one <bundle-path>');
+    }
+    return {
+        bundlePath: resolveBundlePath(bundlePath)
+    };
+}
+export function parseSyncMergeArgs(args) {
+    let bundlePath = null;
+    let apply = false;
+    let dryRun = false;
+    const repoMap = {};
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (!arg) {
+            continue;
+        }
+        if (arg === '--apply') {
+            apply = true;
+            continue;
+        }
+        if (arg === '--dry-run') {
+            dryRun = true;
+            continue;
+        }
+        if (arg === '--map') {
+            const next = args[index + 1];
+            if (!next) {
+                throw new Error('--map requires a value');
+            }
+            const { source, target } = parseMapAssignment(next);
+            repoMap[source] = target;
+            index += 1;
+            continue;
+        }
+        if (arg.startsWith('--')) {
+            throw new Error(`Unknown option for sync merge: ${arg}`);
+        }
+        if (bundlePath !== null) {
+            throw new Error(`Unexpected argument for sync merge: ${arg}`);
+        }
+        bundlePath = arg;
+    }
+    if (!bundlePath) {
+        throw new Error('sync merge requires <bundle-path>');
+    }
+    if (apply && dryRun) {
+        throw new Error('Cannot use --apply and --dry-run together');
+    }
+    return {
+        bundlePath: resolveBundlePath(bundlePath),
+        apply,
+        repoMap
+    };
+}
+async function runSyncExport(args) {
+    const parsed = parseSyncExportArgs(args);
+    const bundle = await buildSyncBundle({
+        pathHints: parsed.pathHints
+    });
+    await fs.mkdir(dirname(parsed.bundlePath), { recursive: true });
+    await fs.writeFile(parsed.bundlePath, `${serializeSyncBundle(bundle)}\n`, 'utf-8');
+    console.log(`[steward] Exported bundle: ${parsed.bundlePath}`);
+    console.log(`[steward] Bundle ID: ${bundle.bundleId}`);
+    console.log(`[steward] Rows: repos=${bundle.repos.length} states=${bundle.states.length} archives=${bundle.archives.length}`);
+    return 0;
+}
+async function runSyncInspect(args) {
+    const parsed = parseSyncInspectArgs(args);
+    const jsonPayload = await fs.readFile(parsed.bundlePath, 'utf-8');
+    const inspection = inspectSyncBundleJson(jsonPayload);
+    console.log(`[steward] Bundle: ${parsed.bundlePath}`);
+    console.log(`[steward] ID=${inspection.bundleId} sourceDevice=${inspection.sourceDeviceId} format=v${inspection.formatVersion}`);
+    console.log(`[steward] Totals: repos=${inspection.totals.repos} states=${inspection.totals.states} archives=${inspection.totals.archives}`);
+    console.log(`[steward] Unknown references: states=${inspection.totals.unknownRepoStates} archives=${inspection.totals.unknownRepoArchives}`);
+    for (const repo of inspection.repos) {
+        const hint = repo.pathHint ? ` pathHint=${repo.pathHint}` : '';
+        console.log(`[steward] Repo ${repo.repoSyncKey} (${repo.name})${hint} states=${repo.stateCount} archives=${repo.archiveCount}`);
+    }
+    return 0;
+}
+async function runSyncMerge(args) {
+    const parsed = parseSyncMergeArgs(args);
+    const jsonPayload = await fs.readFile(parsed.bundlePath, 'utf-8');
+    const result = await executeSyncMergeJson(jsonPayload, {
+        apply: parsed.apply,
+        repoMap: parsed.repoMap
+    });
+    const mode = result.mode === 'dry_run' ? 'dry-run' : 'apply';
+    console.log(`[steward] Merge mode: ${mode}`);
+    console.log(`[steward] Bundle ID: ${result.bundleId}`);
+    console.log(`[steward] Repo mapping: mapped=${result.plan.summary.repos.mapped} unresolved=${result.plan.summary.repos.unresolved}`);
+    console.log(`[steward] State actions: insert=${result.plan.summary.states.insert} update=${result.plan.summary.states.update} skip=${result.plan.summary.states.skip} unresolved=${result.plan.summary.states.unresolved} conflicts=${result.plan.summary.states.conflicts}`);
+    console.log(`[steward] Archive actions: insert=${result.plan.summary.archives.insert} update=${result.plan.summary.archives.update} skip=${result.plan.summary.archives.skip} unresolved=${result.plan.summary.archives.unresolved}`);
+    if (result.mode === 'apply') {
+        if (result.alreadyApplied) {
+            console.log('[steward] Bundle already applied; no changes were written.');
+        }
+        else {
+            console.log(`[steward] Applied: ${result.applied ? 'yes' : 'no'}`);
+            if (result.backupPath) {
+                console.log(`[steward] Backup: ${result.backupPath}`);
+            }
+            console.log(`[steward] Retention: backupsDeleted=${result.retention.backupsDeleted} logsDeleted=${result.retention.logsDeleted}`);
+        }
+    }
+    else {
+        console.log('[steward] Dry-run only; re-run with --apply to write changes.');
+    }
+    return 0;
+}
+export async function runSync(args) {
+    const [subcommandRaw, ...rest] = args;
+    const subcommand = subcommandRaw || '';
+    if (subcommand === '' || subcommand === '-h' || subcommand === '--help') {
+        printSyncUsage();
+        return 0;
+    }
+    if (subcommand === 'export') {
+        return await runSyncExport(rest);
+    }
+    if (subcommand === 'inspect') {
+        return await runSyncInspect(rest);
+    }
+    if (subcommand === 'merge') {
+        return await runSyncMerge(rest);
+    }
+    throw new Error(`Unknown sync subcommand: ${subcommandRaw}`);
+}

package/dist/server/utils/db.js

@@ -34,6 +34,47 @@ function resolveDbPath() {
     }
     return DEFAULT_DB_PATH;
 }
+function getTableColumnNames(adapter, tableName) {
+    const rows = adapter.all(`PRAGMA table_info(${tableName})`);
+    const names = new Set();
+    for (const row of rows) {
+        if (typeof row.name === 'string' && row.name.length > 0) {
+            names.add(row.name);
+        }
+    }
+    return names;
+}
+function ensurePrdStateFieldClockColumns(adapter) {
+    const columnNames = getTableColumnNames(adapter, 'prd_states');
+    const requiredColumns = ['tasks_updated_at', 'progress_updated_at', 'notes_updated_at'];
+    for (const columnName of requiredColumns) {
+        if (columnNames.has(columnName)) {
+            continue;
+        }
+        adapter.exec(`ALTER TABLE prd_states ADD COLUMN ${columnName} TEXT;`);
+        columnNames.add(columnName);
+    }
+}
+function backfillPrdStateFieldClocks(adapter) {
+    adapter.run(`
+      UPDATE prd_states
+      SET tasks_updated_at = updated_at
+      WHERE tasks_updated_at IS NULL
+        AND tasks_json IS NOT NULL
+    `);
+    adapter.run(`
+      UPDATE prd_states
+      SET progress_updated_at = updated_at
+      WHERE progress_updated_at IS NULL
+        AND progress_json IS NOT NULL
+    `);
+    adapter.run(`
+      UPDATE prd_states
+      SET notes_updated_at = updated_at
+      WHERE notes_updated_at IS NULL
+        AND notes_md IS NOT NULL
+    `);
+}
 function formatNodeRuntimeHint() {
     const nodeOptions = process.env.NODE_OPTIONS || '';
     const hasDisableFlag = process.execArgv.includes(SQLITE_DISABLE_FLAG)
@@ -177,6 +218,9 @@ async function initializeDatabase() {
       tasks_json TEXT,
       progress_json TEXT,
       notes_md TEXT,
+      tasks_updated_at TEXT,
+      progress_updated_at TEXT,
+      notes_updated_at TEXT,
       updated_at TEXT NOT NULL,
       PRIMARY KEY (repo_id, slug),
       FOREIGN KEY (repo_id) REFERENCES repos(id) ON DELETE CASCADE
@@ -196,9 +240,29 @@ async function initializeDatabase() {
       updated_at TEXT NOT NULL
     );
 
+    CREATE TABLE IF NOT EXISTS repo_sync_meta (
+      repo_id TEXT PRIMARY KEY,
+      sync_key TEXT NOT NULL UNIQUE,
+      fingerprint TEXT,
+      fingerprint_kind TEXT,
+      updated_at TEXT NOT NULL,
+      FOREIGN KEY (repo_id) REFERENCES repos(id) ON DELETE CASCADE
+    );
+
+    CREATE TABLE IF NOT EXISTS sync_bundle_log (
+      bundle_id TEXT PRIMARY KEY,
+      source_device_id TEXT,
+      applied_at TEXT NOT NULL,
+      summary_json TEXT NOT NULL
+    );
+
     CREATE INDEX IF NOT EXISTS idx_prd_states_repo_id ON prd_states(repo_id);
     CREATE INDEX IF NOT EXISTS idx_prd_archives_repo_id ON prd_archives(repo_id);
+    CREATE INDEX IF NOT EXISTS idx_repo_sync_meta_sync_key ON repo_sync_meta(sync_key);
+    CREATE INDEX IF NOT EXISTS idx_sync_bundle_log_applied_at ON sync_bundle_log(applied_at);
   `);
+    ensurePrdStateFieldClockColumns(adapter);
+    backfillPrdStateFieldClocks(adapter);
     return adapter;
 }
 async function getAdapter() {

package/dist/server/utils/prd-state.js

@@ -92,13 +92,29 @@ export async function upsertPrdState(repoId, slug, update) {
         ? null
         : update.notes;
     const updatedAt = new Date().toISOString();
+    const tasksUpdatedAt = updateTasks ? updatedAt : null;
+    const progressUpdatedAt = updateProgress ? updatedAt : null;
+    const notesUpdatedAt = updateNotes ? updatedAt : null;
     await dbRun(`
-      INSERT INTO prd_states (repo_id, slug, tasks_json, progress_json, notes_md, updated_at)
-      VALUES (?, ?, ?, ?, ?, ?)
+      INSERT INTO prd_states (
+        repo_id,
+        slug,
+        tasks_json,
+        progress_json,
+        notes_md,
+        tasks_updated_at,
+        progress_updated_at,
+        notes_updated_at,
+        updated_at
+      )
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
       ON CONFLICT(repo_id, slug) DO UPDATE SET
         tasks_json = CASE WHEN ? THEN excluded.tasks_json ELSE prd_states.tasks_json END,
         progress_json = CASE WHEN ? THEN excluded.progress_json ELSE prd_states.progress_json END,
         notes_md = CASE WHEN ? THEN excluded.notes_md ELSE prd_states.notes_md END,
+        tasks_updated_at = CASE WHEN ? THEN excluded.tasks_updated_at ELSE prd_states.tasks_updated_at END,
+        progress_updated_at = CASE WHEN ? THEN excluded.progress_updated_at ELSE prd_states.progress_updated_at END,
+        notes_updated_at = CASE WHEN ? THEN excluded.notes_updated_at ELSE prd_states.notes_updated_at END,
         updated_at = excluded.updated_at
     `, [
         repoId,
@@ -106,9 +122,15 @@ export async function upsertPrdState(repoId, slug, update) {
         tasksJson,
         progressJson,
         notesMd,
+        tasksUpdatedAt,
+        progressUpdatedAt,
+        notesUpdatedAt,
         updatedAt,
         updateTasks ? 1 : 0,
         updateProgress ? 1 : 0,
+        updateNotes ? 1 : 0,
+        updateTasks ? 1 : 0,
+        updateProgress ? 1 : 0,
         updateNotes ? 1 : 0
     ]);
     if (validatedTasks !== undefined) {

package/dist/server/utils/repos.js

@@ -3,6 +3,7 @@ import { join, basename, dirname, resolve, relative, isAbsolute } from 'node:pat
 import { randomUUID } from 'node:crypto';
 import { fileURLToPath } from 'node:url';
 import { dbAll, dbGet, dbRun } from './db.js';
+import { ensureRepoSyncMetaForRepo, ensureRepoSyncMetaForRepos } from './sync-identity.js';
 function findPackageRoot(startDir) {
     let currentDir = startDir;
     while (true) {
@@ -136,7 +137,9 @@ async function importLegacyReposIfNeeded() {
 export async function getRepos() {
     await importLegacyReposIfNeeded();
     const rows = await dbAll('SELECT id, name, path, added_at, git_repos_json FROM repos ORDER BY added_at ASC');
-    return rows.map(rowToRepo);
+    const repos = rows.map(rowToRepo);
+    await ensureRepoSyncMetaForRepos(repos);
+    return repos;
 }
 export async function saveRepos(repos) {
     await importLegacyReposIfNeeded();
@@ -158,6 +161,7 @@ export async function saveRepos(repos) {
     const repoIds = repos.map(repo => repo.id);
     const placeholders = repoIds.map(() => '?').join(', ');
     await dbRun(`DELETE FROM repos WHERE id NOT IN (${placeholders})`, repoIds);
+    await ensureRepoSyncMetaForRepos(repos);
 }
 export async function addRepo(path, name) {
     await importLegacyReposIfNeeded();
@@ -175,6 +179,7 @@ export async function addRepo(path, name) {
         ...(gitRepos.length > 0 && { gitRepos })
     };
     await dbRun('INSERT INTO repos (id, name, path, added_at, git_repos_json) VALUES (?, ?, ?, ?, ?)', [repo.id, repo.name, repo.path, repo.addedAt, serializeGitRepos(repo.gitRepos)]);
+    await ensureRepoSyncMetaForRepo(repo);
     return repo;
 }
 /**
@@ -183,7 +188,12 @@ export async function addRepo(path, name) {
 export async function getRepoById(id) {
     await importLegacyReposIfNeeded();
     const row = await dbGet('SELECT id, name, path, added_at, git_repos_json FROM repos WHERE id = ?', [id]);
-    return row ? rowToRepo(row) : undefined;
+    if (!row) {
+        return undefined;
+    }
+    const repo = rowToRepo(row);
+    await ensureRepoSyncMetaForRepo(repo);
+    return repo;
 }
 export async function updateRepoGitRepos(id, gitRepos) {
     await importLegacyReposIfNeeded();

package/dist/server/utils/state-migration.js

@@ -209,9 +209,9 @@ async function migrateProgressRows() {
                 const updatedAt = nowIso();
                 await dbRun(`
             UPDATE prd_states
-            SET progress_json = ?, updated_at = ?
+            SET progress_json = ?, progress_updated_at = ?, updated_at = ?
             WHERE repo_id = ? AND slug = ?
-          `, [JSON.stringify(normalized), updatedAt, row.repo_id, row.slug]);
+          `, [JSON.stringify(normalized), updatedAt, updatedAt, row.repo_id, row.slug]);
                 status.migratedRows += 1;
                 emitChange({
                     type: 'change',
@@ -362,7 +362,7 @@ async function migrateCommitRepoRefs() {
             const updatedAt = nowIso();
             await dbRun(`
           UPDATE prd_states
-          SET progress_json = ?, updated_at = ?
+          SET progress_json = ?, progress_updated_at = ?, updated_at = ?
           WHERE repo_id = ? AND slug = ?
         `, [
                 JSON.stringify({
@@ -370,6 +370,7 @@ async function migrateCommitRepoRefs() {
                     taskLogs: normalized.taskLogs
                 }),
                 updatedAt,
+                updatedAt,
                 row.repo_id,
                 row.slug
             ]);