npm - @undefineds.co/xpod - Versions diffs - 0.3.58 → 0.3.61 - Mend

@undefineds.co/xpod 0.3.58 → 0.3.61

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (776) hide show

package/dist/solidfs/SolidFsMetaNotes.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"SolidFsMetaNotes.js","sourceRoot":"","sources":["../../src/solidfs/SolidFsMetaNotes.ts"],"names":[],"mappings":"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","sourcesContent":["export type SolidFsMaterializationClass = 'byline-local' | 'placeholder-r2' | 'hydrated-r2';\nexport type SolidFsReaderCoverageStatus = 'none' | 'partial' | 'complete' | 'stale' | 'failed';\n\nexport interface FileMetadataNoteInput {\n subject: string;\n about: string;\n title: string;\n description: string;\n mediaType?: string;\n byteSize?: number;\n contentHash?: string;\n materializationClass: SolidFsMaterializationClass;\n}\n\nexport interface ReaderCoverageNoteInput {\n subject: string;\n about: string;\n readerKind: string;\n readerVersion: string;\n coverageUnit: 'page' | 'line' | 'byte' | 'section' | 'symbol' | 'rdf-resource';\n coveredRange: string;\n readUnits: number;\n totalUnits?: number;\n status: SolidFsReaderCoverageStatus;\n}\n\nconst PREFIXES = '@prefix dct: <http://purl.org/dc/terms/> .\\n@prefix sioc: <http://rdfs.org/sioc/ns#> .\\n@prefix udfs: <https://vocab.undefineds.co/udfs#> .\\n\\n';\nconst BLANK_NODE_LABEL = /^_:[A-Za-z][A-Za-z0-9_-]*$/;\nconst ABSOLUTE_IRI = /^[A-Za-z][A-Za-z0-9+.-]*:/;\nconst IRIREF_REQUIRES_ENCODING = /[\\u0000-\\u0020<>\"{}|^`\\\\]/;\nconst IRIREF_UNSAFE_CHARS = /[<>\"{}|^`\\\\]/g;\nconst INVALID_PERCENT_ESCAPE = /%(?![0-9A-Fa-f]{2})/;\n\nexport function buildFileMetadataNote(input: FileMetadataNoteInput): string {\n const lines = [\n `${term(input.subject)} a udfs:Note ;`,\n ` sioc:about ${term(input.about)} ;`,\n ` dct:title ${literal(input.title)} ;`,\n ` dct:description ${literal(input.description)} ;`,\n ' udfs:noteKind \"file-metadata\" ;',\n ];\n if (input.mediaType) {\n lines.push(` udfs:mediaType ${literal(input.mediaType)} ;`);\n }\n if (input.byteSize !== undefined) {\n lines.push(` udfs:byteSize ${nonNegativeIntegerLiteral('byteSize', input.byteSize)} ;`);\n }\n if (input.contentHash) {\n lines.push(` udfs:contentHash ${literal(input.contentHash)} ;`);\n }\n lines.push(` udfs:materializationClass ${literal(input.materializationClass)} .`);\n return `${PREFIXES}${lines.join('\\n')}\\n`;\n}\n\nexport function buildReaderCoverageNote(input: ReaderCoverageNoteInput): string {\n const lines = [\n `${term(input.subject)} a udfs:Note ;`,\n ` sioc:about ${term(input.about)} ;`,\n ' dct:title \"Reader coverage\" ;',\n ` dct:description ${literal(`Read ${input.coveredRange}.`)} ;`,\n ' udfs:noteKind \"reader-coverage\" ;',\n ` udfs:readerKind ${literal(input.readerKind)} ;`,\n ` udfs:readerVersion ${literal(input.readerVersion)} ;`,\n ` udfs:coverageUnit ${literal(input.coverageUnit)} ;`,\n ` udfs:coveredRange ${literal(input.coveredRange)} ;`,\n ` udfs:readUnits ${nonNegativeIntegerLiteral('readUnits', input.readUnits)} ;`,\n ];\n if (input.totalUnits !== undefined) {\n lines.push(` udfs:totalUnits ${nonNegativeIntegerLiteral('totalUnits', input.totalUnits)} ;`);\n }\n lines.push(` udfs:status ${literal(input.status)} .`);\n return `${PREFIXES}${lines.join('\\n')}\\n`;\n}\n\nfunction term(value: string): string {\n if (value.startsWith('<')) {\n if (!value.endsWith('>')) {\n throw new Error(`Invalid Turtle IRI term: ${value}`);\n }\n const innerValue = value.slice(1, -1);\n if (!isLegalIriRef(innerValue)) {\n throw new Error(`Invalid Turtle IRI term: ${value}`);\n }\n return `<${innerValue}>`;\n }\n\n if (value.startsWith('_:')) {\n if (!BLANK_NODE_LABEL.test(value)) {\n throw new Error(`Invalid Turtle blank node label: ${value}`);\n }\n return value;\n }\n\n if (ABSOLUTE_IRI.test(value) && isLegalIriRef(value)) {\n return `<${value}>`;\n }\n\n return `<${encodeIriRef(value)}>`;\n}\n\nfunction literal(value: string): string {\n return JSON.stringify(value) ?? '\"\"';\n}\n\nfunction nonNegativeIntegerLiteral(field: string, value: number): string {\n if (!Number.isSafeInteger(value) || value < 0) {\n throw new RangeError(`${field} must be a non-negative safe integer`);\n }\n return String(value);\n}\n\nfunction encodeIriRef(value: string): string {\n if (value.includes('>')) {\n throw new Error(`Invalid Turtle IRI term: ${value}`);\n }\n\n let encoded: string;\n try {\n encoded = encodeURI(value).replace(IRIREF_UNSAFE_CHARS, encodeAsciiChar);\n } catch {\n throw new Error(`Invalid Turtle IRI term: ${value}`);\n }\n\n if (encoded.includes('>')) {\n throw new Error(`Invalid Turtle IRI term: ${value}`);\n }\n return encoded;\n}\n\nfunction isLegalIriRef(value: string): boolean {\n return !IRIREF_REQUIRES_ENCODING.test(value) && !INVALID_PERCENT_ESCAPE.test(value);\n}\n\nfunction encodeAsciiChar(char: string): string {\n return `%${char.charCodeAt(0).toString(16).toUpperCase().padStart(2, '0')}`;\n}\n"]}

package/dist/solidfs/SolidFsSyncJournal.d.ts CHANGED Viewed

@@ -92,7 +92,7 @@ export declare class JournaledSolidFsSyncer implements SolidFsSyncer {
     constructor(options: JournaledSolidFsSyncerOptions);
     shouldTrack(input: SolidFsPrepareInput): boolean;
     shouldTrackPath(relativePath: string): boolean;
-    sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown): Promise<void>;
+    sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown, txId?: string): Promise<void>;
     replayPending(context?: unknown): Promise<SolidFsJournalReplayResult>;
     compact(): Promise<SolidFsJournalCompactResult>;
     bootstrapWorkspace(input: Omit<SolidFsJournalBootstrapInput, 'shouldTrackPath'> & {
@@ -107,7 +107,7 @@ export declare class WorkspaceJournaledSolidFsSyncer implements SolidFsSyncer {
     shouldTrack(input: SolidFsPrepareInput): boolean;
     shouldTrackPath(relativePath: string): boolean;
     initializeWorkspace(workspace: SolidFsManifest, context?: unknown): Promise<void>;
-    sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown): Promise<void>;
+    sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown, txId?: string): Promise<void>;
     replayPending(workspace: SolidFsManifest, context?: unknown): Promise<SolidFsJournalReplayResult>;
     compact(workspace: SolidFsManifest): Promise<SolidFsJournalCompactResult>;
     journalPathFor(workspace: SolidFsManifest): string;

package/dist/solidfs/SolidFsSyncJournal.js CHANGED Viewed

@@ -382,8 +382,8 @@ class JournaledSolidFsSyncer {
     shouldTrackPath(relativePath) {
         return this.syncer.shouldTrackPath?.(relativePath) ?? (0, RdfContentTypes_1.isLineAddressableRdfPath)(relativePath);
     }
-    async sync(change, workspace, context) {
-        const op = await this.journal.recordLocalCommitted(change, workspace);
+    async sync(change, workspace, context, txId) {
+        const op = await this.journal.recordLocalCommitted(change, workspace, txId);
         if (op.stage === 'done') {
             return;
         }
@@ -434,9 +434,9 @@ class WorkspaceJournaledSolidFsSyncer {
         await journal.replayPending(this.syncer, context);
         await journal.compact();
     }
-    async sync(change, workspace, context) {
+    async sync(change, workspace, context, txId) {
         const journal = this.journalFor(workspace);
-        const op = await journal.recordLocalCommitted(change, workspace);
+        const op = await journal.recordLocalCommitted(change, workspace, txId);
         if (op.stage === 'done') {
             return;
         }
@@ -521,6 +521,7 @@ function normalizeChange(change) {
     return {
         ...change,
         path: change.path.split(/[\\/]+/u).join(node_path_1.default.sep),
+        previousPath: change.previousPath?.split(/[\\/]+/u).join(node_path_1.default.sep),
     };
 }
 function operationId(workspace, change, afterHash) {
@@ -528,8 +529,12 @@ function operationId(workspace, change, afterHash) {
         .update(JSON.stringify({
         workspace,
         path: change.path,
+        previousPath: change.previousPath,
+        prefix: change.prefix,
+        previousPrefix: change.previousPrefix,
         type: change.type,
         resource: change.resource,
+        previousResource: change.previousResource,
         source: change.source,
         sourcePath: change.sourcePath,
         projection: change.projection,

package/dist/solidfs/SolidFsSyncJournal.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"SolidFsSyncJournal.js","sourceRoot":"","sources":["../../src/solidfs/SolidFsSyncJournal.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from 'node:crypto';\nimport path from 'node:path';\n\nimport { getSqliteRuntime, type SqliteDatabase } from '../storage/SqliteRuntime';\nimport type {\n SolidFsChange,\n SolidFsEntrySource,\n SolidFsManifest,\n SolidFsPrepareInput,\n SolidFsProjection,\n SolidFsSyncer,\n} from './types';\nimport {\n isLineAddressableRdfPath,\n} from '../storage/rdf/RdfContentTypes';\nimport {\n contentTypeForPath,\n maybeFileVersion,\n resolveWorkspaceResource,\n snapshotDirectory,\n sourceForProjection,\n} from './SolidFsPathUtils';\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\nconst DEFAULT_DONE_RETENTION_MS = 7 * DAY_MS;\nconst DEFAULT_TOMBSTONE_RETENTION_MS = 30 * DAY_MS;\nconst DEFAULT_FAILED_PERMANENT_RETENTION_MS = 30 * DAY_MS;\n\nexport type SolidFsSyncJournalStage =\n \| 'local_committed'\n \| 'failed_retryable'\n \| 'failed_permanent'\n \| 'reconcile_required'\n \| 'done';\n\nexport interface SolidFsSyncJournalOptions {\n path: string;\n now?: () => number;\n doneRetentionMs?: number;\n tombstoneRetentionMs?: number;\n failedPermanentRetentionMs?: number;\n}\n\nexport interface SolidFsSyncJournalOperation {\n id: string;\n txId?: string;\n workspace: SolidFsManifest;\n change: SolidFsChange;\n stage: SolidFsSyncJournalStage;\n afterHash?: string;\n retryCount: number;\n lastError?: string;\n createdAt: number;\n updatedAt: number;\n doneAt?: number;\n}\n\nexport interface SolidFsJournalBootstrapInput {\n workspace: string;\n cwd: string;\n projection?: SolidFsProjection;\n source?: SolidFsEntrySource;\n shouldTrackPath?: (relativePath: string) => boolean;\n}\n\nexport interface SolidFsJournalBootstrapResult {\n scanned: number;\n enqueued: number;\n skipped: number;\n}\n\nexport interface SolidFsJournalReplayResult {\n attempted: number;\n completed: number;\n failed: number;\n reconcileRequired: number;\n}\n\nexport interface SolidFsJournalCompactResult {\n deletedOps: number;\n}\n\ninterface SyncOpRow {\n id: string;\n tx_id: string \| null;\n workspace_json: string;\n change_json: string;\n stage: SolidFsSyncJournalStage;\n after_hash: string \| null;\n retry_count: number;\n last_error: string \| null;\n created_at: number;\n updated_at: number;\n done_at: number \| null;\n}\n\ninterface CheckpointRow {\n source_version: string \| null;\n deleted_at: number \| null;\n}\n\n/*\n Per-Pod SolidFS recovery journal.\n \n This is an outbox for derived work after the authority file is already\n * committed. It stores enough metadata to replay index/remote refreshes, but\n * never stores file bodies.\n */\nexport class SqliteSolidFsSyncJournal {\n private readonly db: SqliteDatabase;\n private readonly now: () => number;\n private readonly doneRetentionMs: number;\n private readonly tombstoneRetentionMs: number;\n private readonly failedPermanentRetentionMs: number;\n\n public constructor(options: SolidFsSyncJournalOptions) {\n this.now = options.now ?? Date.now;\n this.doneRetentionMs = options.doneRetentionMs ?? DEFAULT_DONE_RETENTION_MS;\n this.tombstoneRetentionMs = options.tombstoneRetentionMs ?? DEFAULT_TOMBSTONE_RETENTION_MS;\n this.failedPermanentRetentionMs = options.failedPermanentRetentionMs ?? DEFAULT_FAILED_PERMANENT_RETENTION_MS;\n this.db = getSqliteRuntime().openDatabase(options.path);\n this.db.pragma('journal_mode = WAL');\n this.db.pragma('busy_timeout = 5000');\n this.initializeSchema();\n }\n\n public close(): void {\n this.db.close();\n }\n\n public async recordLocalCommitted(\n change: SolidFsChange,\n workspace: SolidFsManifest,\n txId?: string,\n ): Promise<SolidFsSyncJournalOperation> {\n const normalizedChange = normalizeChange(change);\n const afterHash = normalizedChange.type === 'deleted'\n ? undefined\n : await maybeFileVersion(normalizedChange.sourcePath);\n const opId = operationId(workspace.workspace, normalizedChange, afterHash);\n const now = this.now();\n\n const existing = this.getOperation(opId);\n if (existing) {\n return existing;\n }\n\n const journalWorkspace = journalWorkspaceSnapshot(workspace);\n this.db.prepare(`\n INSERT INTO sync_ops (\n id,\n tx_id,\n workspace,\n path,\n op_type,\n stage,\n source_path,\n resource,\n content_type,\n source,\n projection,\n source_version,\n after_hash,\n workspace_json,\n change_json,\n retry_count,\n created_at,\n updated_at\n )\n VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0, ?, ?)\n `).run(\n opId,\n txId ?? null,\n workspace.workspace,\n normalizedChange.path,\n normalizedChange.type,\n 'local_committed',\n normalizedChange.sourcePath,\n normalizedChange.resource ?? null,\n normalizedChange.contentType ?? null,\n normalizedChange.source,\n normalizedChange.projection,\n normalizedChange.sourceVersion ?? null,\n afterHash ?? null,\n JSON.stringify(journalWorkspace),\n JSON.stringify(normalizedChange),\n now,\n now,\n );\n\n return this.getOperation(opId)!;\n }\n\n public getOperation(id: string): SolidFsSyncJournalOperation \| undefined {\n const row = this.db.prepare<SyncOpRow>(`\n SELECT id, tx_id, workspace_json, change_json, stage, after_hash, retry_count,\n last_error, created_at, updated_at, done_at\n FROM sync_ops\n WHERE id = ?\n `).get(id);\n return row ? rowToOperation(row) : undefined;\n }\n\n public listOperations(stages?: SolidFsSyncJournalStage[]): SolidFsSyncJournalOperation[] {\n const rows = stages && stages.length > 0\n ? this.db.prepare<SyncOpRow>(`\n SELECT id, tx_id, workspace_json, change_json, stage, after_hash, retry_count,\n last_error, created_at, updated_at, done_at\n FROM sync_ops\n WHERE stage IN (${stages.map(() => '?').join(', ')})\n ORDER BY created_at ASC, id ASC\n `).all(...stages)\n : this.db.prepare<SyncOpRow>(`\n SELECT id, tx_id, workspace_json, change_json, stage, after_hash, retry_count,\n last_error, created_at, updated_at, done_at\n FROM sync_ops\n ORDER BY created_at ASC, id ASC\n `).all();\n return rows.map(rowToOperation);\n }\n\n public listPending(): SolidFsSyncJournalOperation[] {\n return this.listOperations(['local_committed', 'failed_retryable']);\n }\n\n public async markDone(id: string): Promise<void> {\n const op = this.getOperation(id);\n if (!op) {\n return;\n }\n\n const now = this.now();\n this.db.transaction(() => {\n this.db.prepare(`\n UPDATE sync_ops\n SET stage = 'done',\n last_error = NULL,\n done_at = ?,\n updated_at = ?,\n tombstone_confirmed_at = CASE WHEN op_type = 'deleted' THEN ? ELSE tombstone_confirmed_at END\n WHERE id = ?\n `).run(now, now, now, id);\n\n this.upsertCheckpoint(op, now);\n })();\n }\n\n public async markRetryableFailure(id: string, error: unknown): Promise<void> {\n const now = this.now();\n this.db.prepare(`\n UPDATE sync_ops\n SET stage = 'failed_retryable',\n retry_count = retry_count + 1,\n last_error = ?,\n updated_at = ?\n WHERE id = ?\n `).run(errorMessage(error), now, id);\n }\n\n public async markReconcileRequired(id: string, reason: string): Promise<void> {\n const now = this.now();\n this.db.prepare(`\n UPDATE sync_ops\n SET stage = 'reconcile_required',\n last_error = ?,\n updated_at = ?\n WHERE id = ?\n `).run(reason, now, id);\n }\n\n public async markFailedPermanent(id: string, error: unknown): Promise<void> {\n const now = this.now();\n this.db.prepare(`\n UPDATE sync_ops\n SET stage = 'failed_permanent',\n last_error = ?,\n updated_at = ?\n WHERE id = ?\n `).run(errorMessage(error), now, id);\n }\n\n public async replayPending(syncer: SolidFsSyncer, context?: unknown): Promise<SolidFsJournalReplayResult> {\n const result: SolidFsJournalReplayResult = {\n attempted: 0,\n completed: 0,\n failed: 0,\n reconcileRequired: 0,\n };\n\n for (const op of this.listPending()) {\n result.attempted += 1;\n const validation = await this.validateOperationForReplay(op);\n if (validation) {\n await this.markReconcileRequired(op.id, validation);\n result.reconcileRequired += 1;\n continue;\n }\n\n try {\n await syncer.sync(op.change, op.workspace, context);\n await this.markDone(op.id);\n result.completed += 1;\n } catch (error) {\n await this.markRetryableFailure(op.id, error);\n result.failed += 1;\n }\n }\n\n return result;\n }\n\n public async bootstrapWorkspace(input: SolidFsJournalBootstrapInput): Promise<SolidFsJournalBootstrapResult> {\n const projection = input.projection ?? 'direct';\n const source = input.source ?? sourceForProjection(projection, input.workspace);\n const manifest: SolidFsManifest = {\n workspace: input.workspace,\n cwd: input.cwd,\n projection,\n entries: [],\n };\n\n const snapshots = await snapshotDirectory(input.cwd, input.shouldTrackPath);\n const currentPaths = new Set(snapshots.map((snapshot) => snapshot.relativePath));\n const result: SolidFsJournalBootstrapResult = {\n scanned: snapshots.length,\n enqueued: 0,\n skipped: 0,\n };\n\n for (const snapshot of snapshots) {\n const checkpoint = this.getCheckpoint(input.workspace, snapshot.relativePath);\n if (checkpoint?.source_version === snapshot.version && !checkpoint.deleted_at) {\n result.skipped += 1;\n continue;\n }\n\n const op = await this.recordLocalCommitted({\n path: snapshot.relativePath,\n resource: resolveWorkspaceResource(input.workspace, snapshot.relativePath),\n source,\n sourcePath: snapshot.absolutePath,\n contentType: contentTypeForPath(snapshot.relativePath),\n projection,\n type: 'created',\n }, manifest);\n result.enqueued += op.stage === 'done' ? 0 : 1;\n }\n\n const checkpoints = this.listCheckpoints(input.workspace);\n for (const checkpoint of checkpoints) {\n if (currentPaths.has(checkpoint.path) \|\| checkpoint.deleted_at) {\n continue;\n }\n const op = await this.recordLocalCommitted({\n path: checkpoint.path,\n resource: resolveWorkspaceResource(input.workspace, checkpoint.path),\n source,\n sourcePath: path.join(input.cwd, checkpoint.path),\n contentType: contentTypeForPath(checkpoint.path),\n projection,\n type: 'deleted',\n sourceVersion: checkpoint.source_version ?? undefined,\n }, manifest);\n result.enqueued += op.stage === 'done' ? 0 : 1;\n }\n\n return result;\n }\n\n public async compact(): Promise<SolidFsJournalCompactResult> {\n const now = this.now();\n const rows = this.db.prepare<{\n id: string;\n workspace: string;\n path: string;\n op_type: SolidFsChange['type'];\n after_hash: string \| null;\n stage: SolidFsSyncJournalStage;\n done_at: number \| null;\n updated_at: number;\n tombstone_confirmed_at: number \| null;\n }>(`\n SELECT id, workspace, path, op_type, after_hash, stage, done_at, updated_at, tombstone_confirmed_at\n FROM sync_ops\n WHERE stage IN ('done', 'failed_permanent')\n ORDER BY created_at ASC\n `).all();\n\n const deletable: string[] = [];\n for (const row of rows) {\n if (row.stage === 'failed_permanent') {\n if (row.updated_at <= now - this.failedPermanentRetentionMs) {\n deletable.push(row.id);\n }\n continue;\n }\n\n if (!row.done_at) {\n continue;\n }\n const checkpoint = this.getCheckpoint(row.workspace, row.path);\n if (!checkpoint) {\n continue;\n }\n if (row.op_type === 'deleted') {\n if (\n row.done_at <= now - this.tombstoneRetentionMs &&\n row.tombstone_confirmed_at &&\n checkpoint.deleted_at\n ) {\n deletable.push(row.id);\n }\n continue;\n }\n\n if (row.done_at <= now - this.doneRetentionMs && checkpoint.source_version === row.after_hash) {\n deletable.push(row.id);\n }\n }\n\n if (deletable.length === 0) {\n return { deletedOps: 0 };\n }\n\n this.db.transaction(() => {\n const deleteStatement = this.db.prepare('DELETE FROM sync_ops WHERE id = ?');\n for (const id of deletable) {\n deleteStatement.run(id);\n }\n })();\n\n return { deletedOps: deletable.length };\n }\n\n private async validateOperationForReplay(op: SolidFsSyncJournalOperation): Promise<string \| undefined> {\n if (op.change.type === 'deleted') {\n return undefined;\n }\n\n const currentHash = await maybeFileVersion(op.change.sourcePath);\n if (!currentHash) {\n return `SolidFS journal source is missing: ${op.change.sourcePath}`;\n }\n if (op.afterHash && currentHash !== op.afterHash) {\n return `SolidFS journal source changed before replay: ${op.change.path}`;\n }\n return undefined;\n }\n\n private getCheckpoint(workspace: string, relativePath: string): CheckpointRow \| undefined {\n return this.db.prepare<CheckpointRow>(`\n SELECT source_version, deleted_at\n FROM sync_checkpoints\n WHERE workspace = ? AND path = ?\n `).get(workspace, relativePath);\n }\n\n private listCheckpoints(workspace: string): Array<CheckpointRow & { path: string }> {\n return this.db.prepare<CheckpointRow & { path: string }>(`\n SELECT path, source_version, deleted_at\n FROM sync_checkpoints\n WHERE workspace = ?\n ORDER BY path ASC\n `).all(workspace);\n }\n\n private upsertCheckpoint(op: SolidFsSyncJournalOperation, now: number): void {\n if (op.change.type === 'deleted') {\n this.db.prepare(`\n INSERT INTO sync_checkpoints (workspace, path, source_version, deleted_at, updated_at, last_op_id)\n VALUES (?, ?, NULL, ?, ?, ?)\n ON CONFLICT(workspace, path) DO UPDATE SET\n source_version = NULL,\n deleted_at = excluded.deleted_at,\n updated_at = excluded.updated_at,\n last_op_id = excluded.last_op_id\n `).run(op.workspace.workspace, op.change.path, now, now, op.id);\n return;\n }\n\n this.db.prepare(`\n INSERT INTO sync_checkpoints (workspace, path, source_version, deleted_at, updated_at, last_op_id)\n VALUES (?, ?, ?, NULL, ?, ?)\n ON CONFLICT(workspace, path) DO UPDATE SET\n source_version = excluded.source_version,\n deleted_at = NULL,\n updated_at = excluded.updated_at,\n last_op_id = excluded.last_op_id\n `).run(op.workspace.workspace, op.change.path, op.afterHash ?? null, now, op.id);\n }\n\n private initializeSchema(): void {\n this.db.exec(`\n CREATE TABLE IF NOT EXISTS sync_ops (\n id TEXT PRIMARY KEY,\n tx_id TEXT,\n workspace TEXT NOT NULL,\n path TEXT NOT NULL,\n op_type TEXT NOT NULL,\n stage TEXT NOT NULL,\n source_path TEXT NOT NULL,\n resource TEXT,\n content_type TEXT,\n source TEXT NOT NULL,\n projection TEXT NOT NULL,\n source_version TEXT,\n after_hash TEXT,\n workspace_json TEXT NOT NULL,\n change_json TEXT NOT NULL,\n retry_count INTEGER NOT NULL DEFAULT 0,\n last_error TEXT,\n created_at INTEGER NOT NULL,\n updated_at INTEGER NOT NULL,\n done_at INTEGER,\n tombstone_confirmed_at INTEGER\n );\n\n CREATE INDEX IF NOT EXISTS sync_ops_stage_created_idx\n ON sync_ops(stage, created_at);\n CREATE INDEX IF NOT EXISTS sync_ops_workspace_path_idx\n ON sync_ops(workspace, path);\n\n CREATE TABLE IF NOT EXISTS sync_checkpoints (\n workspace TEXT NOT NULL,\n path TEXT NOT NULL,\n source_version TEXT,\n deleted_at INTEGER,\n updated_at INTEGER NOT NULL,\n last_op_id TEXT,\n PRIMARY KEY (workspace, path)\n );\n `);\n }\n}\n\nexport interface JournaledSolidFsSyncerOptions {\n syncer: SolidFsSyncer;\n journal: SqliteSolidFsSyncJournal;\n}\n\nexport interface WorkspaceJournaledSolidFsSyncerOptions {\n syncer: SolidFsSyncer;\n journalRoot?: string;\n resolveJournalPath?: (workspace: SolidFsManifest) => string;\n now?: () => number;\n doneRetentionMs?: number;\n tombstoneRetentionMs?: number;\n failedPermanentRetentionMs?: number;\n}\n\nexport class JournaledSolidFsSyncer implements SolidFsSyncer {\n private readonly syncer: SolidFsSyncer;\n private readonly journal: SqliteSolidFsSyncJournal;\n\n public constructor(options: JournaledSolidFsSyncerOptions) {\n this.syncer = options.syncer;\n this.journal = options.journal;\n }\n\n public shouldTrack(input: SolidFsPrepareInput): boolean {\n return this.syncer.shouldTrack?.(input) ?? true;\n }\n\n public shouldTrackPath(relativePath: string): boolean {\n return this.syncer.shouldTrackPath?.(relativePath) ?? isLineAddressableRdfPath(relativePath);\n }\n\n public async sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown): Promise<void> {\n const op = await this.journal.recordLocalCommitted(change, workspace);\n if (op.stage === 'done') {\n return;\n }\n\n try {\n await this.syncer.sync(change, workspace, context);\n await this.journal.markDone(op.id);\n } catch (error) {\n await this.journal.markRetryableFailure(op.id, error);\n throw error;\n }\n }\n\n public async replayPending(context?: unknown): Promise<SolidFsJournalReplayResult> {\n return this.journal.replayPending(this.syncer, context);\n }\n\n public async compact(): Promise<SolidFsJournalCompactResult> {\n return this.journal.compact();\n }\n\n public async bootstrapWorkspace(\n input: Omit<SolidFsJournalBootstrapInput, 'shouldTrackPath'> & {\n shouldTrackPath?: (relativePath: string) => boolean;\n },\n ): Promise<SolidFsJournalBootstrapResult> {\n return this.journal.bootstrapWorkspace({\n ...input,\n shouldTrackPath: input.shouldTrackPath ?? this.shouldTrackPath.bind(this),\n });\n }\n}\n\nexport class WorkspaceJournaledSolidFsSyncer implements SolidFsSyncer {\n private readonly syncer: SolidFsSyncer;\n private readonly journals = new Map<string, SqliteSolidFsSyncJournal>();\n\n public constructor(private readonly options: WorkspaceJournaledSolidFsSyncerOptions) {\n this.syncer = options.syncer;\n }\n\n public shouldTrack(input: SolidFsPrepareInput): boolean {\n return this.syncer.shouldTrack?.(input) ?? true;\n }\n\n public shouldTrackPath(relativePath: string): boolean {\n return this.syncer.shouldTrackPath?.(relativePath) ?? isLineAddressableRdfPath(relativePath);\n }\n\n public async initializeWorkspace(workspace: SolidFsManifest, context?: unknown): Promise<void> {\n const journal = this.journalFor(workspace);\n await journal.bootstrapWorkspace({\n workspace: workspace.workspace,\n cwd: workspace.cwd,\n projection: workspace.projection,\n source: sourceForProjection(workspace.projection, workspace.workspace),\n shouldTrackPath: this.shouldTrackPath.bind(this),\n });\n await journal.replayPending(this.syncer, context);\n await journal.compact();\n }\n\n public async sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown): Promise<void> {\n const journal = this.journalFor(workspace);\n const op = await journal.recordLocalCommitted(change, workspace);\n if (op.stage === 'done') {\n return;\n }\n\n try {\n await this.syncer.sync(change, workspace, context);\n await journal.markDone(op.id);\n } catch (error) {\n await journal.markRetryableFailure(op.id, error);\n throw error;\n }\n }\n\n public async replayPending(workspace: SolidFsManifest, context?: unknown): Promise<SolidFsJournalReplayResult> {\n return this.journalFor(workspace).replayPending(this.syncer, context);\n }\n\n public async compact(workspace: SolidFsManifest): Promise<SolidFsJournalCompactResult> {\n return this.journalFor(workspace).compact();\n }\n\n public journalPathFor(workspace: SolidFsManifest): string {\n return this.options.resolveJournalPath?.(workspace)\n ?? resolveSolidFsJournalPath(workspace, this.options.journalRoot ?? process.env.XPOD_SOLIDFS_JOURNAL_ROOT);\n }\n\n public close(): void {\n for (const journal of this.journals.values()) {\n journal.close();\n }\n this.journals.clear();\n }\n\n private journalFor(workspace: SolidFsManifest): SqliteSolidFsSyncJournal {\n const journalPath = this.journalPathFor(workspace);\n const existing = this.journals.get(journalPath);\n if (existing) {\n return existing;\n }\n\n const journal = new SqliteSolidFsSyncJournal({\n path: journalPath,\n now: this.options.now,\n doneRetentionMs: this.options.doneRetentionMs,\n tombstoneRetentionMs: this.options.tombstoneRetentionMs,\n failedPermanentRetentionMs: this.options.failedPermanentRetentionMs,\n });\n this.journals.set(journalPath, journal);\n return journal;\n }\n}\n\nexport function resolveSolidFsJournalPath(workspace: SolidFsManifest, journalRoot?: string): string {\n const root = journalRoot\n ? path.resolve(journalRoot)\n : path.join(path.dirname(path.resolve(workspace.cwd)), '.xpod-control', 'solidfs-journals');\n const basename = safeJournalSegment(path.basename(workspace.cwd) \|\| 'workspace');\n const key = createHash('sha256')\n .update(workspace.workspace)\n .digest('hex')\n .slice(0, 16);\n return path.join(root, `${basename}-${key}`, 'sync-journal.sqlite');\n}\n\nfunction rowToOperation(row: SyncOpRow): SolidFsSyncJournalOperation {\n return {\n id: row.id,\n txId: row.tx_id ?? undefined,\n workspace: JSON.parse(row.workspace_json) as SolidFsManifest,\n change: JSON.parse(row.change_json) as SolidFsChange,\n stage: row.stage,\n afterHash: row.after_hash ?? undefined,\n retryCount: row.retry_count,\n lastError: row.last_error ?? undefined,\n createdAt: row.created_at,\n updatedAt: row.updated_at,\n doneAt: row.done_at ?? undefined,\n };\n}\n\nfunction journalWorkspaceSnapshot(workspace: SolidFsManifest): SolidFsManifest {\n return {\n workspace: workspace.workspace,\n cwd: workspace.cwd,\n projection: workspace.projection,\n entries: [],\n };\n}\n\nfunction normalizeChange(change: SolidFsChange): SolidFsChange {\n return {\n ...change,\n path: change.path.split(/[\\\\/]+/u).join(path.sep),\n };\n}\n\nfunction operationId(workspace: string, change: SolidFsChange, afterHash?: string): string {\n const digest = createHash('sha256')\n .update(JSON.stringify({\n workspace,\n path: change.path,\n type: change.type,\n resource: change.resource,\n source: change.source,\n sourcePath: change.sourcePath,\n projection: change.projection,\n sourceVersion: change.sourceVersion,\n afterHash,\n }))\n .digest('hex')\n .slice(0, 32);\n return `sync_${digest}`;\n}\n\nfunction safeJournalSegment(value: string): string {\n const safe = value.replace(/[^a-zA-Z0-9._-]+/gu, '_').slice(0, 64);\n return safe \|\| 'workspace';\n}\n\nfunction errorMessage(error: unknown): string {\n if (error instanceof Error) {\n return error.message;\n }\n return String(error);\n}\n"]}
1	+ {"version":3,"file":"SolidFsSyncJournal.js","sourceRoot":"","sources":["../../src/solidfs/SolidFsSyncJournal.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from 'node:crypto';\nimport path from 'node:path';\n\nimport { getSqliteRuntime, type SqliteDatabase } from '../storage/SqliteRuntime';\nimport type {\n SolidFsChange,\n SolidFsEntrySource,\n SolidFsManifest,\n SolidFsPrepareInput,\n SolidFsProjection,\n SolidFsSyncer,\n} from './types';\nimport {\n isLineAddressableRdfPath,\n} from '../storage/rdf/RdfContentTypes';\nimport {\n contentTypeForPath,\n maybeFileVersion,\n resolveWorkspaceResource,\n snapshotDirectory,\n sourceForProjection,\n} from './SolidFsPathUtils';\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\nconst DEFAULT_DONE_RETENTION_MS = 7 * DAY_MS;\nconst DEFAULT_TOMBSTONE_RETENTION_MS = 30 * DAY_MS;\nconst DEFAULT_FAILED_PERMANENT_RETENTION_MS = 30 * DAY_MS;\n\nexport type SolidFsSyncJournalStage =\n \| 'local_committed'\n \| 'failed_retryable'\n \| 'failed_permanent'\n \| 'reconcile_required'\n \| 'done';\n\nexport interface SolidFsSyncJournalOptions {\n path: string;\n now?: () => number;\n doneRetentionMs?: number;\n tombstoneRetentionMs?: number;\n failedPermanentRetentionMs?: number;\n}\n\nexport interface SolidFsSyncJournalOperation {\n id: string;\n txId?: string;\n workspace: SolidFsManifest;\n change: SolidFsChange;\n stage: SolidFsSyncJournalStage;\n afterHash?: string;\n retryCount: number;\n lastError?: string;\n createdAt: number;\n updatedAt: number;\n doneAt?: number;\n}\n\nexport interface SolidFsJournalBootstrapInput {\n workspace: string;\n cwd: string;\n projection?: SolidFsProjection;\n source?: SolidFsEntrySource;\n shouldTrackPath?: (relativePath: string) => boolean;\n}\n\nexport interface SolidFsJournalBootstrapResult {\n scanned: number;\n enqueued: number;\n skipped: number;\n}\n\nexport interface SolidFsJournalReplayResult {\n attempted: number;\n completed: number;\n failed: number;\n reconcileRequired: number;\n}\n\nexport interface SolidFsJournalCompactResult {\n deletedOps: number;\n}\n\ninterface SyncOpRow {\n id: string;\n tx_id: string \| null;\n workspace_json: string;\n change_json: string;\n stage: SolidFsSyncJournalStage;\n after_hash: string \| null;\n retry_count: number;\n last_error: string \| null;\n created_at: number;\n updated_at: number;\n done_at: number \| null;\n}\n\ninterface CheckpointRow {\n source_version: string \| null;\n deleted_at: number \| null;\n}\n\n/*\n Per-Pod SolidFS recovery journal.\n \n This is an outbox for derived work after the authority file is already\n * committed. It stores enough metadata to replay index/remote refreshes, but\n * never stores file bodies.\n */\nexport class SqliteSolidFsSyncJournal {\n private readonly db: SqliteDatabase;\n private readonly now: () => number;\n private readonly doneRetentionMs: number;\n private readonly tombstoneRetentionMs: number;\n private readonly failedPermanentRetentionMs: number;\n\n public constructor(options: SolidFsSyncJournalOptions) {\n this.now = options.now ?? Date.now;\n this.doneRetentionMs = options.doneRetentionMs ?? DEFAULT_DONE_RETENTION_MS;\n this.tombstoneRetentionMs = options.tombstoneRetentionMs ?? DEFAULT_TOMBSTONE_RETENTION_MS;\n this.failedPermanentRetentionMs = options.failedPermanentRetentionMs ?? DEFAULT_FAILED_PERMANENT_RETENTION_MS;\n this.db = getSqliteRuntime().openDatabase(options.path);\n this.db.pragma('journal_mode = WAL');\n this.db.pragma('busy_timeout = 5000');\n this.initializeSchema();\n }\n\n public close(): void {\n this.db.close();\n }\n\n public async recordLocalCommitted(\n change: SolidFsChange,\n workspace: SolidFsManifest,\n txId?: string,\n ): Promise<SolidFsSyncJournalOperation> {\n const normalizedChange = normalizeChange(change);\n const afterHash = normalizedChange.type === 'deleted'\n ? undefined\n : await maybeFileVersion(normalizedChange.sourcePath);\n const opId = operationId(workspace.workspace, normalizedChange, afterHash);\n const now = this.now();\n\n const existing = this.getOperation(opId);\n if (existing) {\n return existing;\n }\n\n const journalWorkspace = journalWorkspaceSnapshot(workspace);\n this.db.prepare(`\n INSERT INTO sync_ops (\n id,\n tx_id,\n workspace,\n path,\n op_type,\n stage,\n source_path,\n resource,\n content_type,\n source,\n projection,\n source_version,\n after_hash,\n workspace_json,\n change_json,\n retry_count,\n created_at,\n updated_at\n )\n VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0, ?, ?)\n `).run(\n opId,\n txId ?? null,\n workspace.workspace,\n normalizedChange.path,\n normalizedChange.type,\n 'local_committed',\n normalizedChange.sourcePath,\n normalizedChange.resource ?? null,\n normalizedChange.contentType ?? null,\n normalizedChange.source,\n normalizedChange.projection,\n normalizedChange.sourceVersion ?? null,\n afterHash ?? null,\n JSON.stringify(journalWorkspace),\n JSON.stringify(normalizedChange),\n now,\n now,\n );\n\n return this.getOperation(opId)!;\n }\n\n public getOperation(id: string): SolidFsSyncJournalOperation \| undefined {\n const row = this.db.prepare<SyncOpRow>(`\n SELECT id, tx_id, workspace_json, change_json, stage, after_hash, retry_count,\n last_error, created_at, updated_at, done_at\n FROM sync_ops\n WHERE id = ?\n `).get(id);\n return row ? rowToOperation(row) : undefined;\n }\n\n public listOperations(stages?: SolidFsSyncJournalStage[]): SolidFsSyncJournalOperation[] {\n const rows = stages && stages.length > 0\n ? this.db.prepare<SyncOpRow>(`\n SELECT id, tx_id, workspace_json, change_json, stage, after_hash, retry_count,\n last_error, created_at, updated_at, done_at\n FROM sync_ops\n WHERE stage IN (${stages.map(() => '?').join(', ')})\n ORDER BY created_at ASC, id ASC\n `).all(...stages)\n : this.db.prepare<SyncOpRow>(`\n SELECT id, tx_id, workspace_json, change_json, stage, after_hash, retry_count,\n last_error, created_at, updated_at, done_at\n FROM sync_ops\n ORDER BY created_at ASC, id ASC\n `).all();\n return rows.map(rowToOperation);\n }\n\n public listPending(): SolidFsSyncJournalOperation[] {\n return this.listOperations(['local_committed', 'failed_retryable']);\n }\n\n public async markDone(id: string): Promise<void> {\n const op = this.getOperation(id);\n if (!op) {\n return;\n }\n\n const now = this.now();\n this.db.transaction(() => {\n this.db.prepare(`\n UPDATE sync_ops\n SET stage = 'done',\n last_error = NULL,\n done_at = ?,\n updated_at = ?,\n tombstone_confirmed_at = CASE WHEN op_type = 'deleted' THEN ? ELSE tombstone_confirmed_at END\n WHERE id = ?\n `).run(now, now, now, id);\n\n this.upsertCheckpoint(op, now);\n })();\n }\n\n public async markRetryableFailure(id: string, error: unknown): Promise<void> {\n const now = this.now();\n this.db.prepare(`\n UPDATE sync_ops\n SET stage = 'failed_retryable',\n retry_count = retry_count + 1,\n last_error = ?,\n updated_at = ?\n WHERE id = ?\n `).run(errorMessage(error), now, id);\n }\n\n public async markReconcileRequired(id: string, reason: string): Promise<void> {\n const now = this.now();\n this.db.prepare(`\n UPDATE sync_ops\n SET stage = 'reconcile_required',\n last_error = ?,\n updated_at = ?\n WHERE id = ?\n `).run(reason, now, id);\n }\n\n public async markFailedPermanent(id: string, error: unknown): Promise<void> {\n const now = this.now();\n this.db.prepare(`\n UPDATE sync_ops\n SET stage = 'failed_permanent',\n last_error = ?,\n updated_at = ?\n WHERE id = ?\n `).run(errorMessage(error), now, id);\n }\n\n public async replayPending(syncer: SolidFsSyncer, context?: unknown): Promise<SolidFsJournalReplayResult> {\n const result: SolidFsJournalReplayResult = {\n attempted: 0,\n completed: 0,\n failed: 0,\n reconcileRequired: 0,\n };\n\n for (const op of this.listPending()) {\n result.attempted += 1;\n const validation = await this.validateOperationForReplay(op);\n if (validation) {\n await this.markReconcileRequired(op.id, validation);\n result.reconcileRequired += 1;\n continue;\n }\n\n try {\n await syncer.sync(op.change, op.workspace, context);\n await this.markDone(op.id);\n result.completed += 1;\n } catch (error) {\n await this.markRetryableFailure(op.id, error);\n result.failed += 1;\n }\n }\n\n return result;\n }\n\n public async bootstrapWorkspace(input: SolidFsJournalBootstrapInput): Promise<SolidFsJournalBootstrapResult> {\n const projection = input.projection ?? 'direct';\n const source = input.source ?? sourceForProjection(projection, input.workspace);\n const manifest: SolidFsManifest = {\n workspace: input.workspace,\n cwd: input.cwd,\n projection,\n entries: [],\n };\n\n const snapshots = await snapshotDirectory(input.cwd, input.shouldTrackPath);\n const currentPaths = new Set(snapshots.map((snapshot) => snapshot.relativePath));\n const result: SolidFsJournalBootstrapResult = {\n scanned: snapshots.length,\n enqueued: 0,\n skipped: 0,\n };\n\n for (const snapshot of snapshots) {\n const checkpoint = this.getCheckpoint(input.workspace, snapshot.relativePath);\n if (checkpoint?.source_version === snapshot.version && !checkpoint.deleted_at) {\n result.skipped += 1;\n continue;\n }\n\n const op = await this.recordLocalCommitted({\n path: snapshot.relativePath,\n resource: resolveWorkspaceResource(input.workspace, snapshot.relativePath),\n source,\n sourcePath: snapshot.absolutePath,\n contentType: contentTypeForPath(snapshot.relativePath),\n projection,\n type: 'created',\n }, manifest);\n result.enqueued += op.stage === 'done' ? 0 : 1;\n }\n\n const checkpoints = this.listCheckpoints(input.workspace);\n for (const checkpoint of checkpoints) {\n if (currentPaths.has(checkpoint.path) \|\| checkpoint.deleted_at) {\n continue;\n }\n const op = await this.recordLocalCommitted({\n path: checkpoint.path,\n resource: resolveWorkspaceResource(input.workspace, checkpoint.path),\n source,\n sourcePath: path.join(input.cwd, checkpoint.path),\n contentType: contentTypeForPath(checkpoint.path),\n projection,\n type: 'deleted',\n sourceVersion: checkpoint.source_version ?? undefined,\n }, manifest);\n result.enqueued += op.stage === 'done' ? 0 : 1;\n }\n\n return result;\n }\n\n public async compact(): Promise<SolidFsJournalCompactResult> {\n const now = this.now();\n const rows = this.db.prepare<{\n id: string;\n workspace: string;\n path: string;\n op_type: SolidFsChange['type'];\n after_hash: string \| null;\n stage: SolidFsSyncJournalStage;\n done_at: number \| null;\n updated_at: number;\n tombstone_confirmed_at: number \| null;\n }>(`\n SELECT id, workspace, path, op_type, after_hash, stage, done_at, updated_at, tombstone_confirmed_at\n FROM sync_ops\n WHERE stage IN ('done', 'failed_permanent')\n ORDER BY created_at ASC\n `).all();\n\n const deletable: string[] = [];\n for (const row of rows) {\n if (row.stage === 'failed_permanent') {\n if (row.updated_at <= now - this.failedPermanentRetentionMs) {\n deletable.push(row.id);\n }\n continue;\n }\n\n if (!row.done_at) {\n continue;\n }\n const checkpoint = this.getCheckpoint(row.workspace, row.path);\n if (!checkpoint) {\n continue;\n }\n if (row.op_type === 'deleted') {\n if (\n row.done_at <= now - this.tombstoneRetentionMs &&\n row.tombstone_confirmed_at &&\n checkpoint.deleted_at\n ) {\n deletable.push(row.id);\n }\n continue;\n }\n\n if (row.done_at <= now - this.doneRetentionMs && checkpoint.source_version === row.after_hash) {\n deletable.push(row.id);\n }\n }\n\n if (deletable.length === 0) {\n return { deletedOps: 0 };\n }\n\n this.db.transaction(() => {\n const deleteStatement = this.db.prepare('DELETE FROM sync_ops WHERE id = ?');\n for (const id of deletable) {\n deleteStatement.run(id);\n }\n })();\n\n return { deletedOps: deletable.length };\n }\n\n private async validateOperationForReplay(op: SolidFsSyncJournalOperation): Promise<string \| undefined> {\n if (op.change.type === 'deleted') {\n return undefined;\n }\n\n const currentHash = await maybeFileVersion(op.change.sourcePath);\n if (!currentHash) {\n return `SolidFS journal source is missing: ${op.change.sourcePath}`;\n }\n if (op.afterHash && currentHash !== op.afterHash) {\n return `SolidFS journal source changed before replay: ${op.change.path}`;\n }\n return undefined;\n }\n\n private getCheckpoint(workspace: string, relativePath: string): CheckpointRow \| undefined {\n return this.db.prepare<CheckpointRow>(`\n SELECT source_version, deleted_at\n FROM sync_checkpoints\n WHERE workspace = ? AND path = ?\n `).get(workspace, relativePath);\n }\n\n private listCheckpoints(workspace: string): Array<CheckpointRow & { path: string }> {\n return this.db.prepare<CheckpointRow & { path: string }>(`\n SELECT path, source_version, deleted_at\n FROM sync_checkpoints\n WHERE workspace = ?\n ORDER BY path ASC\n `).all(workspace);\n }\n\n private upsertCheckpoint(op: SolidFsSyncJournalOperation, now: number): void {\n if (op.change.type === 'deleted') {\n this.db.prepare(`\n INSERT INTO sync_checkpoints (workspace, path, source_version, deleted_at, updated_at, last_op_id)\n VALUES (?, ?, NULL, ?, ?, ?)\n ON CONFLICT(workspace, path) DO UPDATE SET\n source_version = NULL,\n deleted_at = excluded.deleted_at,\n updated_at = excluded.updated_at,\n last_op_id = excluded.last_op_id\n `).run(op.workspace.workspace, op.change.path, now, now, op.id);\n return;\n }\n\n this.db.prepare(`\n INSERT INTO sync_checkpoints (workspace, path, source_version, deleted_at, updated_at, last_op_id)\n VALUES (?, ?, ?, NULL, ?, ?)\n ON CONFLICT(workspace, path) DO UPDATE SET\n source_version = excluded.source_version,\n deleted_at = NULL,\n updated_at = excluded.updated_at,\n last_op_id = excluded.last_op_id\n `).run(op.workspace.workspace, op.change.path, op.afterHash ?? null, now, op.id);\n }\n\n private initializeSchema(): void {\n this.db.exec(`\n CREATE TABLE IF NOT EXISTS sync_ops (\n id TEXT PRIMARY KEY,\n tx_id TEXT,\n workspace TEXT NOT NULL,\n path TEXT NOT NULL,\n op_type TEXT NOT NULL,\n stage TEXT NOT NULL,\n source_path TEXT NOT NULL,\n resource TEXT,\n content_type TEXT,\n source TEXT NOT NULL,\n projection TEXT NOT NULL,\n source_version TEXT,\n after_hash TEXT,\n workspace_json TEXT NOT NULL,\n change_json TEXT NOT NULL,\n retry_count INTEGER NOT NULL DEFAULT 0,\n last_error TEXT,\n created_at INTEGER NOT NULL,\n updated_at INTEGER NOT NULL,\n done_at INTEGER,\n tombstone_confirmed_at INTEGER\n );\n\n CREATE INDEX IF NOT EXISTS sync_ops_stage_created_idx\n ON sync_ops(stage, created_at);\n CREATE INDEX IF NOT EXISTS sync_ops_workspace_path_idx\n ON sync_ops(workspace, path);\n\n CREATE TABLE IF NOT EXISTS sync_checkpoints (\n workspace TEXT NOT NULL,\n path TEXT NOT NULL,\n source_version TEXT,\n deleted_at INTEGER,\n updated_at INTEGER NOT NULL,\n last_op_id TEXT,\n PRIMARY KEY (workspace, path)\n );\n `);\n }\n}\n\nexport interface JournaledSolidFsSyncerOptions {\n syncer: SolidFsSyncer;\n journal: SqliteSolidFsSyncJournal;\n}\n\nexport interface WorkspaceJournaledSolidFsSyncerOptions {\n syncer: SolidFsSyncer;\n journalRoot?: string;\n resolveJournalPath?: (workspace: SolidFsManifest) => string;\n now?: () => number;\n doneRetentionMs?: number;\n tombstoneRetentionMs?: number;\n failedPermanentRetentionMs?: number;\n}\n\nexport class JournaledSolidFsSyncer implements SolidFsSyncer {\n private readonly syncer: SolidFsSyncer;\n private readonly journal: SqliteSolidFsSyncJournal;\n\n public constructor(options: JournaledSolidFsSyncerOptions) {\n this.syncer = options.syncer;\n this.journal = options.journal;\n }\n\n public shouldTrack(input: SolidFsPrepareInput): boolean {\n return this.syncer.shouldTrack?.(input) ?? true;\n }\n\n public shouldTrackPath(relativePath: string): boolean {\n return this.syncer.shouldTrackPath?.(relativePath) ?? isLineAddressableRdfPath(relativePath);\n }\n\n public async sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown, txId?: string): Promise<void> {\n const op = await this.journal.recordLocalCommitted(change, workspace, txId);\n if (op.stage === 'done') {\n return;\n }\n\n try {\n await this.syncer.sync(change, workspace, context);\n await this.journal.markDone(op.id);\n } catch (error) {\n await this.journal.markRetryableFailure(op.id, error);\n throw error;\n }\n }\n\n public async replayPending(context?: unknown): Promise<SolidFsJournalReplayResult> {\n return this.journal.replayPending(this.syncer, context);\n }\n\n public async compact(): Promise<SolidFsJournalCompactResult> {\n return this.journal.compact();\n }\n\n public async bootstrapWorkspace(\n input: Omit<SolidFsJournalBootstrapInput, 'shouldTrackPath'> & {\n shouldTrackPath?: (relativePath: string) => boolean;\n },\n ): Promise<SolidFsJournalBootstrapResult> {\n return this.journal.bootstrapWorkspace({\n ...input,\n shouldTrackPath: input.shouldTrackPath ?? this.shouldTrackPath.bind(this),\n });\n }\n}\n\nexport class WorkspaceJournaledSolidFsSyncer implements SolidFsSyncer {\n private readonly syncer: SolidFsSyncer;\n private readonly journals = new Map<string, SqliteSolidFsSyncJournal>();\n\n public constructor(private readonly options: WorkspaceJournaledSolidFsSyncerOptions) {\n this.syncer = options.syncer;\n }\n\n public shouldTrack(input: SolidFsPrepareInput): boolean {\n return this.syncer.shouldTrack?.(input) ?? true;\n }\n\n public shouldTrackPath(relativePath: string): boolean {\n return this.syncer.shouldTrackPath?.(relativePath) ?? isLineAddressableRdfPath(relativePath);\n }\n\n public async initializeWorkspace(workspace: SolidFsManifest, context?: unknown): Promise<void> {\n const journal = this.journalFor(workspace);\n await journal.bootstrapWorkspace({\n workspace: workspace.workspace,\n cwd: workspace.cwd,\n projection: workspace.projection,\n source: sourceForProjection(workspace.projection, workspace.workspace),\n shouldTrackPath: this.shouldTrackPath.bind(this),\n });\n await journal.replayPending(this.syncer, context);\n await journal.compact();\n }\n\n public async sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown, txId?: string): Promise<void> {\n const journal = this.journalFor(workspace);\n const op = await journal.recordLocalCommitted(change, workspace, txId);\n if (op.stage === 'done') {\n return;\n }\n\n try {\n await this.syncer.sync(change, workspace, context);\n await journal.markDone(op.id);\n } catch (error) {\n await journal.markRetryableFailure(op.id, error);\n throw error;\n }\n }\n\n public async replayPending(workspace: SolidFsManifest, context?: unknown): Promise<SolidFsJournalReplayResult> {\n return this.journalFor(workspace).replayPending(this.syncer, context);\n }\n\n public async compact(workspace: SolidFsManifest): Promise<SolidFsJournalCompactResult> {\n return this.journalFor(workspace).compact();\n }\n\n public journalPathFor(workspace: SolidFsManifest): string {\n return this.options.resolveJournalPath?.(workspace)\n ?? resolveSolidFsJournalPath(workspace, this.options.journalRoot ?? process.env.XPOD_SOLIDFS_JOURNAL_ROOT);\n }\n\n public close(): void {\n for (const journal of this.journals.values()) {\n journal.close();\n }\n this.journals.clear();\n }\n\n private journalFor(workspace: SolidFsManifest): SqliteSolidFsSyncJournal {\n const journalPath = this.journalPathFor(workspace);\n const existing = this.journals.get(journalPath);\n if (existing) {\n return existing;\n }\n\n const journal = new SqliteSolidFsSyncJournal({\n path: journalPath,\n now: this.options.now,\n doneRetentionMs: this.options.doneRetentionMs,\n tombstoneRetentionMs: this.options.tombstoneRetentionMs,\n failedPermanentRetentionMs: this.options.failedPermanentRetentionMs,\n });\n this.journals.set(journalPath, journal);\n return journal;\n }\n}\n\nexport function resolveSolidFsJournalPath(workspace: SolidFsManifest, journalRoot?: string): string {\n const root = journalRoot\n ? path.resolve(journalRoot)\n : path.join(path.dirname(path.resolve(workspace.cwd)), '.xpod-control', 'solidfs-journals');\n const basename = safeJournalSegment(path.basename(workspace.cwd) \|\| 'workspace');\n const key = createHash('sha256')\n .update(workspace.workspace)\n .digest('hex')\n .slice(0, 16);\n return path.join(root, `${basename}-${key}`, 'sync-journal.sqlite');\n}\n\nfunction rowToOperation(row: SyncOpRow): SolidFsSyncJournalOperation {\n return {\n id: row.id,\n txId: row.tx_id ?? undefined,\n workspace: JSON.parse(row.workspace_json) as SolidFsManifest,\n change: JSON.parse(row.change_json) as SolidFsChange,\n stage: row.stage,\n afterHash: row.after_hash ?? undefined,\n retryCount: row.retry_count,\n lastError: row.last_error ?? undefined,\n createdAt: row.created_at,\n updatedAt: row.updated_at,\n doneAt: row.done_at ?? undefined,\n };\n}\n\nfunction journalWorkspaceSnapshot(workspace: SolidFsManifest): SolidFsManifest {\n return {\n workspace: workspace.workspace,\n cwd: workspace.cwd,\n projection: workspace.projection,\n entries: [],\n };\n}\n\nfunction normalizeChange(change: SolidFsChange): SolidFsChange {\n return {\n ...change,\n path: change.path.split(/[\\\\/]+/u).join(path.sep),\n previousPath: change.previousPath?.split(/[\\\\/]+/u).join(path.sep),\n };\n}\n\nfunction operationId(workspace: string, change: SolidFsChange, afterHash?: string): string {\n const digest = createHash('sha256')\n .update(JSON.stringify({\n workspace,\n path: change.path,\n previousPath: change.previousPath,\n prefix: change.prefix,\n previousPrefix: change.previousPrefix,\n type: change.type,\n resource: change.resource,\n previousResource: change.previousResource,\n source: change.source,\n sourcePath: change.sourcePath,\n projection: change.projection,\n sourceVersion: change.sourceVersion,\n afterHash,\n }))\n .digest('hex')\n .slice(0, 32);\n return `sync_${digest}`;\n}\n\nfunction safeJournalSegment(value: string): string {\n const safe = value.replace(/[^a-zA-Z0-9._-]+/gu, '_').slice(0, 64);\n return safe \|\| 'workspace';\n}\n\nfunction errorMessage(error: unknown): string {\n if (error instanceof Error) {\n return error.message;\n }\n return String(error);\n}\n"]}

package/dist/solidfs/SolidFsSyncJournal.jsonld ADDED Viewed

@@ -0,0 +1,119 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal",
+      "@type": "Class",
+      "requireElement": "SqliteSolidFsSyncJournal",
+      "comment": "Per-Pod SolidFS recovery journal.  This is an outbox for derived work after the authority file is already committed. It stores enough metadata to replay index/remote refreshes, but never stores file bodies.",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal_options",
+          "range": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SolidFsSyncJournalOptions"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_db",
+          "memberFieldName": "db"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_now",
+          "memberFieldName": "now"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_doneRetentionMs",
+          "memberFieldName": "doneRetentionMs"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_tombstoneRetentionMs",
+          "memberFieldName": "tombstoneRetentionMs"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_failedPermanentRetentionMs",
+          "memberFieldName": "failedPermanentRetentionMs"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_close",
+          "memberFieldName": "close"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_recordLocalCommitted",
+          "memberFieldName": "recordLocalCommitted"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_getOperation",
+          "memberFieldName": "getOperation"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_listOperations",
+          "memberFieldName": "listOperations"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_listPending",
+          "memberFieldName": "listPending"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_markDone",
+          "memberFieldName": "markDone"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_markRetryableFailure",
+          "memberFieldName": "markRetryableFailure"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_markReconcileRequired",
+          "memberFieldName": "markReconcileRequired"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_markFailedPermanent",
+          "memberFieldName": "markFailedPermanent"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_replayPending",
+          "memberFieldName": "replayPending"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_bootstrapWorkspace",
+          "memberFieldName": "bootstrapWorkspace"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_compact",
+          "memberFieldName": "compact"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_validateOperationForReplay",
+          "memberFieldName": "validateOperationForReplay"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_getCheckpoint",
+          "memberFieldName": "getCheckpoint"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_listCheckpoints",
+          "memberFieldName": "listCheckpoints"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_upsertCheckpoint",
+          "memberFieldName": "upsertCheckpoint"
+        },
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal__member_initializeSchema",
+          "memberFieldName": "initializeSchema"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/solidfs/SolidFsSyncJournal.jsonld#SqliteSolidFsSyncJournal_options"
+        }
+      ]
+    }
+  ]
+}

package/dist/solidfs/WorkspacePrompt.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+export interface WorkspaceSummaryPromptInput {
+    root: string;
+    authority: 'local-filesystem' | 'cloud-object-store';
+    files: number;
+    bylineLocalFiles: number;
+    remotePlaceholders: number;
+    hydratedRemoteObjects: number;
+    freeLocalCacheBytes?: number;
+    maxHydrateBytesWithoutConfirmation?: number;
+    tools: string[];
+}
+export declare function buildWorkspaceSemanticsPrompt(): string;
+export declare function buildWorkspaceSummaryPrompt(input: WorkspaceSummaryPromptInput): string;

package/dist/solidfs/WorkspacePrompt.js ADDED Viewed

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildWorkspaceSemanticsPrompt = buildWorkspaceSemanticsPrompt;
+exports.buildWorkspaceSummaryPrompt = buildWorkspaceSummaryPrompt;
+function buildWorkspaceSemanticsPrompt() {
+    return `## Workspace Semantics
+You are operating inside an Xpod SolidFS materialized workspace.
+- Directory entries are complete: \`ls\` and \`find\` show the workspace tree.
+- Text/by-line files are materialized locally and can be read with normal tools.
+- Large binary/media/remote-object files may appear as placeholders.
+- Placeholder metadata is available through \`.meta\` and workspace tools.
+- Do not assume placeholder bytes are the real content.
+- Hydration has cost; inspect metadata before choosing metadata, thumbnail, range-read, or full hydration.
+- Writes are tracked by the SolidFS journal and must be committed or rolled back by runtime.
+- Search/vector/index artifacts are internal; use search/reader tools rather than looking for index files.
+`;
+}
+function buildWorkspaceSummaryPrompt(input) {
+    return [
+        '## Current Workspace',
+        '',
+        `Root: ${promptValue(input.root)}`,
+        `Authority: ${input.authority}`,
+        `Files: ${input.files}`,
+        `Text/by-line local files: ${input.bylineLocalFiles}`,
+        `Remote placeholders: ${input.remotePlaceholders}`,
+        `Hydrated remote objects: ${input.hydratedRemoteObjects}`,
+        input.freeLocalCacheBytes === undefined ? undefined : `Free local cache bytes: ${input.freeLocalCacheBytes}`,
+        input.maxHydrateBytesWithoutConfirmation === undefined ? undefined : `Max hydrate bytes without confirmation: ${input.maxHydrateBytesWithoutConfirmation}`,
+        `Available tools: ${input.tools.map(promptValue).join(', ')}`,
+        '',
+    ].filter((line) => line !== undefined).join('\n');
+}
+function promptValue(value) {
+    return (JSON.stringify(value) ?? '""').replace(/[\u0085\u2028\u2029]/g, escapeLogicalLineSeparator);
+}
+function escapeLogicalLineSeparator(char) {
+    return `\\u${char.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0')}`;
+}
+//# sourceMappingURL=WorkspacePrompt.js.map

package/dist/solidfs/WorkspacePrompt.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"WorkspacePrompt.js","sourceRoot":"","sources":["../../src/solidfs/WorkspacePrompt.ts"],"names":[],"mappings":";;AAYA,sEAcC;AAED,kEAeC;AA/BD,SAAgB,6BAA6B;IAC3C,OAAO;;;;;;;;;;;;CAYR,CAAC;AACF,CAAC;AAED,SAAgB,2BAA2B,CAAC,KAAkC;IAC5E,OAAO;QACL,sBAAsB;QACtB,EAAE;QACF,SAAS,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;QAClC,cAAc,KAAK,CAAC,SAAS,EAAE;QAC/B,UAAU,KAAK,CAAC,KAAK,EAAE;QACvB,6BAA6B,KAAK,CAAC,gBAAgB,EAAE;QACrD,wBAAwB,KAAK,CAAC,kBAAkB,EAAE;QAClD,4BAA4B,KAAK,CAAC,qBAAqB,EAAE;QACzD,KAAK,CAAC,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,2BAA2B,KAAK,CAAC,mBAAmB,EAAE;QAC5G,KAAK,CAAC,kCAAkC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,2CAA2C,KAAK,CAAC,kCAAkC,EAAE;QAC1J,oBAAoB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC7D,EAAE;KACH,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,uBAAuB,EAAE,0BAA0B,CAAC,CAAC;AACtG,CAAC;AAED,SAAS,0BAA0B,CAAC,IAAY;IAC9C,OAAO,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAChF,CAAC","sourcesContent":["export interface WorkspaceSummaryPromptInput {\n root: string;\n authority: 'local-filesystem' | 'cloud-object-store';\n files: number;\n bylineLocalFiles: number;\n remotePlaceholders: number;\n hydratedRemoteObjects: number;\n freeLocalCacheBytes?: number;\n maxHydrateBytesWithoutConfirmation?: number;\n tools: string[];\n}\n\nexport function buildWorkspaceSemanticsPrompt(): string {\n return `## Workspace Semantics\n\nYou are operating inside an Xpod SolidFS materialized workspace.\n\n- Directory entries are complete: \\`ls\\` and \\`find\\` show the workspace tree.\n- Text/by-line files are materialized locally and can be read with normal tools.\n- Large binary/media/remote-object files may appear as placeholders.\n- Placeholder metadata is available through \\`.meta\\` and workspace tools.\n- Do not assume placeholder bytes are the real content.\n- Hydration has cost; inspect metadata before choosing metadata, thumbnail, range-read, or full hydration.\n- Writes are tracked by the SolidFS journal and must be committed or rolled back by runtime.\n- Search/vector/index artifacts are internal; use search/reader tools rather than looking for index files.\n`;\n}\n\nexport function buildWorkspaceSummaryPrompt(input: WorkspaceSummaryPromptInput): string {\n return [\n '## Current Workspace',\n '',\n `Root: ${promptValue(input.root)}`,\n `Authority: ${input.authority}`,\n `Files: ${input.files}`,\n `Text/by-line local files: ${input.bylineLocalFiles}`,\n `Remote placeholders: ${input.remotePlaceholders}`,\n `Hydrated remote objects: ${input.hydratedRemoteObjects}`,\n input.freeLocalCacheBytes === undefined ? undefined : `Free local cache bytes: ${input.freeLocalCacheBytes}`,\n input.maxHydrateBytesWithoutConfirmation === undefined ? undefined : `Max hydrate bytes without confirmation: ${input.maxHydrateBytesWithoutConfirmation}`,\n `Available tools: ${input.tools.map(promptValue).join(', ')}`,\n '',\n ].filter((line): line is string => line !== undefined).join('\\n');\n}\n\nfunction promptValue(value: string): string {\n return (JSON.stringify(value) ?? '\"\"').replace(/[\\u0085\\u2028\\u2029]/g, escapeLogicalLineSeparator);\n}\n\nfunction escapeLogicalLineSeparator(char: string): string {\n return `\\\\u${char.charCodeAt(0).toString(16).toUpperCase().padStart(4, '0')}`;\n}\n"]}

package/dist/solidfs/index.d.ts CHANGED Viewed

@@ -4,5 +4,8 @@ export * from './PodSolidFsHttpClient';
 export * from './PodSolidFsHydrator';
 export * from './RdfIndexSolidFsSyncer';
 export * from './PodSolidFsSyncer';
+export * from './CompositeSolidFsSyncer';
 export * from './LocalFirstRdfRepresentationResolver';
 export * from './SolidFsSyncJournal';
+export * from './SolidFsMetaNotes';
+export * from './WorkspacePrompt';

package/dist/solidfs/index.js CHANGED Viewed

@@ -20,6 +20,9 @@ __exportStar(require("./PodSolidFsHttpClient"), exports);
 __exportStar(require("./PodSolidFsHydrator"), exports);
 __exportStar(require("./RdfIndexSolidFsSyncer"), exports);
 __exportStar(require("./PodSolidFsSyncer"), exports);
+__exportStar(require("./CompositeSolidFsSyncer"), exports);
 __exportStar(require("./LocalFirstRdfRepresentationResolver"), exports);
 __exportStar(require("./SolidFsSyncJournal"), exports);
+__exportStar(require("./SolidFsMetaNotes"), exports);
+__exportStar(require("./WorkspacePrompt"), exports);
 //# sourceMappingURL=index.js.map

package/dist/solidfs/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/solidfs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,iDAA+B;AAC/B,yDAAuC;AACvC,uDAAqC;AACrC,0DAAwC;AACxC,qDAAmC;AACnC,wEAAsD;AACtD,uDAAqC","sourcesContent":["export * from './types';\nexport * from './LocalSolidFS';\nexport * from './PodSolidFsHttpClient';\nexport * from './PodSolidFsHydrator';\nexport * from './RdfIndexSolidFsSyncer';\nexport * from './PodSolidFsSyncer';\nexport * from './LocalFirstRdfRepresentationResolver';\nexport * from './SolidFsSyncJournal';\n"]}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/solidfs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,iDAA+B;AAC/B,yDAAuC;AACvC,uDAAqC;AACrC,0DAAwC;AACxC,qDAAmC;AACnC,2DAAyC;AACzC,wEAAsD;AACtD,uDAAqC;AACrC,qDAAmC;AACnC,oDAAkC","sourcesContent":["export * from './types';\nexport * from './LocalSolidFS';\nexport * from './PodSolidFsHttpClient';\nexport * from './PodSolidFsHydrator';\nexport * from './RdfIndexSolidFsSyncer';\nexport * from './PodSolidFsSyncer';\nexport * from './CompositeSolidFsSyncer';\nexport * from './LocalFirstRdfRepresentationResolver';\nexport * from './SolidFsSyncJournal';\nexport * from './SolidFsMetaNotes';\nexport * from './WorkspacePrompt';\n"]}

package/dist/solidfs/types.d.ts CHANGED Viewed

@@ -1,7 +1,7 @@
 export type SolidFsProjection = 'direct' | 'copy' | 'hydrated-object';
 export type SolidFsEntrySource = 'filesystem' | 'pod-http' | 'object';
 export type SolidFsEntryState = 'clean' | 'dirty' | 'committed' | 'conflict';
-export type SolidFsChangeType = 'created' | 'updated' | 'deleted';
+export type SolidFsChangeType = 'created' | 'updated' | 'deleted' | 'moved' | 'moved_prefix';
 export interface SolidFsRunRef {
     id?: string;
     workspace?: string;
@@ -46,12 +46,22 @@ export interface SolidFsManifestEntry {
 export interface SolidFsChange {
     path: string;
     resource?: string;
+    /** Previous local path for move operations. */
+    previousPath?: string;
+    /** Previous Solid resource URI for move operations. */
+    previousResource?: string;
+    /** Prefix source for moved_prefix operations. P1 only; P0 writers should not emit it. */
+    previousPrefix?: string;
+    /** Prefix target for moved_prefix operations. P1 only; P0 writers should not emit it. */
+    prefix?: string;
     source: SolidFsEntrySource;
     sourcePath: string;
     contentType?: string;
     projection: SolidFsProjection;
     type: SolidFsChangeType;
     sourceVersion?: string;
+    contentHash?: string;
+    projectionHints?: Record<string, unknown>;
 }
 export interface SolidFsManifest {
     workspace: string;
@@ -97,7 +107,7 @@ export interface SolidFsSyncer {
     shouldTrack?(input: SolidFsPrepareInput): boolean;
     shouldTrackPath?(relativePath: string): boolean;
     initializeWorkspace?(workspace: SolidFsManifest, context?: unknown): Promise<void>;
-    sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown): Promise<void>;
+    sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown, txId?: string): Promise<void>;
 }
 export interface SolidFsHydrateInput {
     path: string;

package/dist/solidfs/types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/solidfs/types.ts"],"names":[],"mappings":";;;~~AA6EA~~,MAAa,oBAAqB,SAAQ,KAAK;IAG7C,YAAmB,SAA4B;QAC7C,KAAK,CAAC,4BAA4B,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AARD,oDAQC;AAED,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AALD,oDAKC","sourcesContent":["export type SolidFsProjection = 'direct' \| 'copy' \| 'hydrated-object';\nexport type SolidFsEntrySource = 'filesystem' \| 'pod-http' \| 'object';\n\nexport type SolidFsEntryState = 'clean' \| 'dirty' \| 'committed' \| 'conflict';\nexport type SolidFsChangeType = 'created' \| 'updated' \| 'deleted';\n\nexport interface SolidFsRunRef {\n id?: string;\n workspace?: string;\n}\n\nexport interface SolidFsPrepareInput {\n run?: SolidFsRunRef;\n workspace: string;\n /*\n Adapter-provided local source path for workspaces that are resolved by\n * the runner before SolidFS materializes them, such as Pod HTTPS containers.\n /\n sourcePath?: string;\n projection?: SolidFsProjection;\n /\n Opaque request/runtime context used by adapter syncers. SolidFS itself must\n * not inspect or persist this value because it can contain credentials.\n /\n context?: unknown;\n}\n\nexport interface SolidFsManifestEntry {\n path: string;\n resource?: string;\n source: SolidFsEntrySource;\n sourcePath: string;\n contentType?: string;\n projection: SolidFsProjection;\n /\n Opaque authority-side version token, such as an ETag, object version, RDF\n * revision, or filesystem hash. For local filesystem projections this can be\n * the same value used for dirty detection.\n /\n sourceVersion?: string;\n /\n Local working-copy version captured when the entry was materialized. This\n * lets hydrated objects keep an authority ETag in sourceVersion while still\n * detecting local edits by hashing the working file.\n /\n workingVersion?: string;\n lastAccessedAt?: number;\n state: SolidFsEntryState;\n}\n\nexport interface SolidFsChange {\n path: string;\n resource?: string;\n source: SolidFsEntrySource;\n sourcePath: string;\n contentType?: string;\n projection: SolidFsProjection;\n type: SolidFsChangeType;\n sourceVersion?: string;\n}\n\nexport interface SolidFsManifest {\n workspace: string;\n cwd: string;\n projection: SolidFsProjection;\n entries: SolidFsManifestEntry[];\n changes?: SolidFsChange[];\n}\n\nexport interface SolidFsConflict {\n path: string;\n sourcePath: string;\n expectedVersion?: string;\n actualVersion?: string;\n message: string;\n}\n\nexport class SolidFsConflictError extends Error {\n public readonly conflicts: SolidFsConflict[];\n\n public constructor(conflicts: SolidFsConflict[]) {\n super(`SolidFS commit conflict: ${conflicts.map((conflict) => conflict.path).join(', ')}`);\n this.name = 'SolidFsConflictError';\n this.conflicts = conflicts;\n }\n}\n\nexport class SolidFsNotFoundError extends Error {\n public constructor(message: string) {\n super(message);\n this.name = 'SolidFsNotFoundError';\n }\n}\n\nexport interface MaterializedWorkspace {\n cwd: string;\n manifest: SolidFsManifest;\n /\n Materialize one object-backed resource into the real cwd. Implementations\n * without object hydration support can leave this undefined.\n /\n hydrate?(relativePath: string): Promise<SolidFsManifestEntry>;\n /\n Remove clean hydrated working copies that are no longer needed. Dirty files\n * must never be pruned.\n /\n prune?(options?: SolidFsPruneOptions): Promise<SolidFsManifest>;\n commit(): Promise<SolidFsManifest>;\n rollback(): Promise<void>;\n}\n\nexport interface SolidFS {\n prepare(input: SolidFsPrepareInput): Promise<MaterializedWorkspace>;\n}\n\nexport interface SolidFsSyncer {\n shouldTrack?(input: SolidFsPrepareInput): boolean;\n shouldTrackPath?(relativePath: string): boolean;\n initializeWorkspace?(workspace: SolidFsManifest, context?: unknown): Promise<void>;\n sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown): Promise<void>;\n}\n\nexport interface SolidFsHydrateInput {\n path: string;\n targetPath: string;\n workspace: SolidFsManifest;\n context?: unknown;\n}\n\nexport interface SolidFsHydrateResult {\n contentType?: string;\n sourceVersion?: string;\n}\n\nexport interface SolidFsCommitHydratedInput {\n change: SolidFsChange;\n workspace: SolidFsManifest;\n context?: unknown;\n}\n\nexport interface SolidFsCommitHydratedResult {\n sourceVersion?: string;\n}\n\nexport interface SolidFsHydrator {\n hydrate(input: SolidFsHydrateInput): Promise<SolidFsHydrateResult \| void>;\n commit(input: SolidFsCommitHydratedInput): Promise<SolidFsCommitHydratedResult \| void>;\n delete?(input: SolidFsCommitHydratedInput): Promise<void>;\n}\n\nexport interface SolidFsPruneOptions {\n /\n Prune clean hydrated files not accessed for at least this many ms.\n * Defaults to 0, meaning any clean hydrated file is eligible.\n */\n olderThanMs?: number;\n now?: number;\n}\n"]}
1	+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/solidfs/types.ts"],"names":[],"mappings":";;;AAuFA,MAAa,oBAAqB,SAAQ,KAAK;IAG7C,YAAmB,SAA4B;QAC7C,KAAK,CAAC,4BAA4B,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AARD,oDAQC;AAED,MAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAmB,OAAe;QAChC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AALD,oDAKC","sourcesContent":["export type SolidFsProjection = 'direct' \| 'copy' \| 'hydrated-object';\nexport type SolidFsEntrySource = 'filesystem' \| 'pod-http' \| 'object';\n\nexport type SolidFsEntryState = 'clean' \| 'dirty' \| 'committed' \| 'conflict';\nexport type SolidFsChangeType = 'created' \| 'updated' \| 'deleted' \| 'moved' \| 'moved_prefix';\n\nexport interface SolidFsRunRef {\n id?: string;\n workspace?: string;\n}\n\nexport interface SolidFsPrepareInput {\n run?: SolidFsRunRef;\n workspace: string;\n /*\n Adapter-provided local source path for workspaces that are resolved by\n * the runner before SolidFS materializes them, such as Pod HTTPS containers.\n /\n sourcePath?: string;\n projection?: SolidFsProjection;\n /\n Opaque request/runtime context used by adapter syncers. SolidFS itself must\n * not inspect or persist this value because it can contain credentials.\n /\n context?: unknown;\n}\n\nexport interface SolidFsManifestEntry {\n path: string;\n resource?: string;\n source: SolidFsEntrySource;\n sourcePath: string;\n contentType?: string;\n projection: SolidFsProjection;\n /\n Opaque authority-side version token, such as an ETag, object version, RDF\n * revision, or filesystem hash. For local filesystem projections this can be\n * the same value used for dirty detection.\n /\n sourceVersion?: string;\n /\n Local working-copy version captured when the entry was materialized. This\n * lets hydrated objects keep an authority ETag in sourceVersion while still\n * detecting local edits by hashing the working file.\n /\n workingVersion?: string;\n lastAccessedAt?: number;\n state: SolidFsEntryState;\n}\n\nexport interface SolidFsChange {\n path: string;\n resource?: string;\n /* Previous local path for move operations. /\n previousPath?: string;\n /* Previous Solid resource URI for move operations. /\n previousResource?: string;\n /* Prefix source for moved_prefix operations. P1 only; P0 writers should not emit it. /\n previousPrefix?: string;\n /* Prefix target for moved_prefix operations. P1 only; P0 writers should not emit it. /\n prefix?: string;\n source: SolidFsEntrySource;\n sourcePath: string;\n contentType?: string;\n projection: SolidFsProjection;\n type: SolidFsChangeType;\n sourceVersion?: string;\n contentHash?: string;\n projectionHints?: Record<string, unknown>;\n}\n\nexport interface SolidFsManifest {\n workspace: string;\n cwd: string;\n projection: SolidFsProjection;\n entries: SolidFsManifestEntry[];\n changes?: SolidFsChange[];\n}\n\nexport interface SolidFsConflict {\n path: string;\n sourcePath: string;\n expectedVersion?: string;\n actualVersion?: string;\n message: string;\n}\n\nexport class SolidFsConflictError extends Error {\n public readonly conflicts: SolidFsConflict[];\n\n public constructor(conflicts: SolidFsConflict[]) {\n super(`SolidFS commit conflict: ${conflicts.map((conflict) => conflict.path).join(', ')}`);\n this.name = 'SolidFsConflictError';\n this.conflicts = conflicts;\n }\n}\n\nexport class SolidFsNotFoundError extends Error {\n public constructor(message: string) {\n super(message);\n this.name = 'SolidFsNotFoundError';\n }\n}\n\nexport interface MaterializedWorkspace {\n cwd: string;\n manifest: SolidFsManifest;\n /\n Materialize one object-backed resource into the real cwd. Implementations\n * without object hydration support can leave this undefined.\n /\n hydrate?(relativePath: string): Promise<SolidFsManifestEntry>;\n /\n Remove clean hydrated working copies that are no longer needed. Dirty files\n * must never be pruned.\n /\n prune?(options?: SolidFsPruneOptions): Promise<SolidFsManifest>;\n commit(): Promise<SolidFsManifest>;\n rollback(): Promise<void>;\n}\n\nexport interface SolidFS {\n prepare(input: SolidFsPrepareInput): Promise<MaterializedWorkspace>;\n}\n\nexport interface SolidFsSyncer {\n shouldTrack?(input: SolidFsPrepareInput): boolean;\n shouldTrackPath?(relativePath: string): boolean;\n initializeWorkspace?(workspace: SolidFsManifest, context?: unknown): Promise<void>;\n sync(change: SolidFsChange, workspace: SolidFsManifest, context?: unknown, txId?: string): Promise<void>;\n}\n\nexport interface SolidFsHydrateInput {\n path: string;\n targetPath: string;\n workspace: SolidFsManifest;\n context?: unknown;\n}\n\nexport interface SolidFsHydrateResult {\n contentType?: string;\n sourceVersion?: string;\n}\n\nexport interface SolidFsCommitHydratedInput {\n change: SolidFsChange;\n workspace: SolidFsManifest;\n context?: unknown;\n}\n\nexport interface SolidFsCommitHydratedResult {\n sourceVersion?: string;\n}\n\nexport interface SolidFsHydrator {\n hydrate(input: SolidFsHydrateInput): Promise<SolidFsHydrateResult \| void>;\n commit(input: SolidFsCommitHydratedInput): Promise<SolidFsCommitHydratedResult \| void>;\n delete?(input: SolidFsCommitHydratedInput): Promise<void>;\n}\n\nexport interface SolidFsPruneOptions {\n /\n Prune clean hydrated files not accessed for at least this many ms.\n * Defaults to 0, meaning any clean hydrated file is eligible.\n */\n olderThanMs?: number;\n now?: number;\n}\n"]}