@software-dlc/cli 0.157.2

package/dist/local/environment-switch.js

@@ -0,0 +1,385 @@
+import { lstat, mkdir, rename } from 'node:fs/promises';
+import { join } from 'node:path';
+import { clearEnvironmentSwitchJournal, environmentSidecarDirectory, inactiveProjectionDirectory, readActiveEnvironmentSelector, readEnvironmentMetadata, readEnvironmentSwitchJournal, normalizeEnvironmentProfile, writeActiveEnvironmentSelector, writeEnvironmentSwitchJournal } from './environment-sidecar.js';
+import { projectionDiffHasChanges, projectionHasManagedContent } from './projection.js';
+import { prepareLocalStateDirectory } from './state-directory.js';
+import { LocalSdlcStore } from './store.js';
+import { getManagedProjectionStatus } from './worktree-projection.js';
+import { withWorkspaceOperationLock } from './workspace-lock.js';
+function errorCode(error) {
+    return typeof error === 'object' && error !== null && 'code' in error
+        ? String(error.code)
+        : null;
+}
+async function pathExists(path) {
+    try {
+        await lstat(path);
+        return true;
+    }
+    catch (error) {
+        if (errorCode(error) === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+async function assertDirectoryIfPresent(path) {
+    try {
+        const value = await lstat(path);
+        if (!value.isDirectory() || value.isSymbolicLink()) {
+            throw new Error(`Refusing non-directory or symlinked projection: ${path}`);
+        }
+        return true;
+    }
+    catch (error) {
+        if (errorCode(error) === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+async function openProfileStore(input) {
+    const sidecar_dir = environmentSidecarDirectory({
+        repository_root: input.git.repository_root,
+        profile: input.profile
+    });
+    const metadata = await readEnvironmentMetadata(sidecar_dir);
+    if (metadata.profile !== input.profile) {
+        throw new Error(`SDLC sidecar profile mismatch: expected ${input.profile}, found ${metadata.profile}.`);
+    }
+    const state = await prepareLocalStateDirectory({
+        repository_root: input.git.repository_root,
+        git_dir: input.git.git_dir,
+        sidecar_dir
+    });
+    return { sidecar_dir, store: await LocalSdlcStore.open(state.state_dir) };
+}
+async function assertProfileClean(input) {
+    if (input.store.hasPendingChanges()) {
+        throw new Error('The active environment has pending save/sync work and cannot be switched.');
+    }
+    if (!input.git.ref) {
+        throw new Error('Detached HEAD cannot switch an SDLC environment.');
+    }
+    const binding = input.store.getBranchBinding(input.git.ref);
+    if (!binding) {
+        if (await projectionHasManagedContent(input.projection_dir)) {
+            throw new Error('The environment projection has managed content but the current Git ref is not bound.');
+        }
+        return;
+    }
+    const projection_state = input.store.getProjectionState(binding.worktree_id);
+    if (!projection_state) {
+        if (await projectionHasManagedContent(input.projection_dir)) {
+            throw new Error('The environment projection has managed content without an ownership receipt.');
+        }
+        return;
+    }
+    if (projection_state.projection_dir !== input.projection_dir) {
+        throw new Error('The environment projection receipt does not point to its projection directory.');
+    }
+    const status = await getManagedProjectionStatus({
+        store: input.store,
+        worktree_id: binding.worktree_id
+    });
+    if (status.materialized && status.validation?.is_valid !== true) {
+        throw new Error('The environment projection is invalid and cannot participate in a switch.');
+    }
+    if (status.pending_change_count > 0 ||
+        (status.diff && projectionDiffHasChanges(status.diff))) {
+        throw new Error('The active environment projection is dirty. Save or clean it before switching environments.');
+    }
+}
+function relocateBoundProjection(input) {
+    if (!input.git.ref)
+        return;
+    const binding = input.store.getBranchBinding(input.git.ref);
+    if (!binding)
+        return;
+    const state = input.store.getProjectionState(binding.worktree_id);
+    if (!state)
+        return;
+    if (state.projection_dir === input.projection_dir)
+        return;
+    input.store.relocateProjectionState({
+        worktree_id: binding.worktree_id,
+        expected_projection_dir: input.expected_projection_dir,
+        projection_dir: input.projection_dir
+    });
+}
+async function rollbackSwitch(input) {
+    const projection_dir = join(input.git.repository_root, 'sdlc');
+    const source_cache = inactiveProjectionDirectory({
+        repository_root: input.git.repository_root,
+        profile: input.journal.source_profile
+    });
+    const target_cache = inactiveProjectionDirectory({
+        repository_root: input.git.repository_root,
+        profile: input.journal.target_profile
+    });
+    const stage_order = [
+        'prepared',
+        'source_cached',
+        'target_restored',
+        'stores_relocated',
+        'selector_advanced'
+    ];
+    const stage_index = stage_order.indexOf(input.journal.stage);
+    if (stage_index >= stage_order.indexOf('target_restored') &&
+        input.journal.target_had_projection &&
+        (await pathExists(projection_dir))) {
+        if (await pathExists(target_cache)) {
+            throw new Error('Cannot recover environment switch because both target projection locations exist.');
+        }
+        await rename(projection_dir, target_cache);
+    }
+    if (stage_index >= stage_order.indexOf('source_cached') &&
+        input.journal.source_had_projection &&
+        (await pathExists(source_cache))) {
+        if (await pathExists(projection_dir)) {
+            throw new Error('Cannot recover environment switch because the active projection location is occupied.');
+        }
+        await rename(source_cache, projection_dir);
+    }
+    if (stage_index >= stage_order.indexOf('stores_relocated')) {
+        relocateBoundProjection({
+            git: input.git,
+            store: input.source_store,
+            expected_projection_dir: source_cache,
+            projection_dir
+        });
+        relocateBoundProjection({
+            git: input.git,
+            store: input.target_store,
+            expected_projection_dir: projection_dir,
+            projection_dir: target_cache
+        });
+    }
+    await writeActiveEnvironmentSelector({
+        repository_root: input.git.repository_root,
+        profile: input.journal.source_profile
+    });
+    await clearEnvironmentSwitchJournal(input.git.repository_root);
+}
+export async function recoverEnvironmentSwitch(input) {
+    return withWorkspaceOperationLock({
+        control_dir: join(input.git.repository_root, '.sdlc.transition'),
+        operation: 'environment-switch-recovery',
+        run: async () => {
+            const journal = await readEnvironmentSwitchJournal(input.git.repository_root);
+            const selector = await readActiveEnvironmentSelector(input.git.repository_root);
+            if (!journal) {
+                return {
+                    recovered: false,
+                    active_profile: selector?.profile ?? 'live'
+                };
+            }
+            const source = await openProfileStore({
+                git: input.git,
+                profile: journal.source_profile
+            });
+            const target = await openProfileStore({
+                git: input.git,
+                profile: journal.target_profile
+            });
+            try {
+                if (selector?.profile === journal.target_profile &&
+                    journal.stage === 'selector_advanced') {
+                    await clearEnvironmentSwitchJournal(input.git.repository_root);
+                    return {
+                        recovered: true,
+                        active_profile: journal.target_profile
+                    };
+                }
+                if (selector && selector.profile !== journal.source_profile) {
+                    throw new Error('Environment switch journal does not match the active selector.');
+                }
+                await rollbackSwitch({
+                    git: input.git,
+                    journal,
+                    source_store: source.store,
+                    target_store: target.store
+                });
+                return { recovered: true, active_profile: journal.source_profile };
+            }
+            finally {
+                source.store.close();
+                target.store.close();
+            }
+        }
+    });
+}
+export async function withActiveEnvironmentOperation(input) {
+    return withWorkspaceOperationLock({
+        control_dir: join(input.git.repository_root, '.sdlc.transition'),
+        operation: input.operation,
+        run: async () => {
+            if (await readEnvironmentSwitchJournal(input.git.repository_root)) {
+                throw new Error('An interrupted environment switch requires `sdlc env recover`.');
+            }
+            return input.run();
+        }
+    });
+}
+export async function switchEnvironment(input) {
+    return withWorkspaceOperationLock({
+        control_dir: join(input.git.repository_root, '.sdlc.transition'),
+        operation: 'environment-switch',
+        run: async () => {
+            const target_profile = normalizeEnvironmentProfile(input.target_profile);
+            const pending_journal = await readEnvironmentSwitchJournal(input.git.repository_root);
+            if (pending_journal) {
+                throw new Error('An interrupted environment switch requires `sdlc env recover`.');
+            }
+            const selector = await readActiveEnvironmentSelector(input.git.repository_root);
+            const source_profile = selector?.profile ?? 'live';
+            if (source_profile === target_profile) {
+                return {
+                    switched: false,
+                    source_profile,
+                    active_profile: source_profile,
+                    projection_materialized: await pathExists(join(input.git.repository_root, 'sdlc'))
+                };
+            }
+            const source = await openProfileStore({
+                git: input.git,
+                profile: source_profile
+            });
+            const target = await openProfileStore({
+                git: input.git,
+                profile: target_profile
+            });
+            const projection_dir = join(input.git.repository_root, 'sdlc');
+            const source_cache = inactiveProjectionDirectory({
+                repository_root: input.git.repository_root,
+                profile: source_profile
+            });
+            const target_cache = inactiveProjectionDirectory({
+                repository_root: input.git.repository_root,
+                profile: target_profile
+            });
+            let journal = null;
+            try {
+                await assertProfileClean({
+                    git: input.git,
+                    store: source.store,
+                    projection_dir
+                });
+                if (target.store.hasPendingChanges()) {
+                    throw new Error('The target environment has pending save/sync work and cannot be activated.');
+                }
+                const source_had_projection = await assertDirectoryIfPresent(projection_dir);
+                const target_had_projection = await assertDirectoryIfPresent(target_cache);
+                if (target_had_projection) {
+                    await assertProfileClean({
+                        git: input.git,
+                        store: target.store,
+                        projection_dir: target_cache
+                    });
+                }
+                if (await pathExists(source_cache)) {
+                    throw new Error('The active environment already has an inactive projection cache.');
+                }
+                const now = new Date().toISOString();
+                journal = {
+                    schema_version: 1,
+                    source_profile,
+                    target_profile,
+                    stage: 'prepared',
+                    source_had_projection,
+                    target_had_projection,
+                    created_at: now,
+                    updated_at: now
+                };
+                await writeEnvironmentSwitchJournal({
+                    repository_root: input.git.repository_root,
+                    journal
+                });
+                journal = {
+                    ...journal,
+                    stage: 'source_cached',
+                    updated_at: new Date().toISOString()
+                };
+                await writeEnvironmentSwitchJournal({
+                    repository_root: input.git.repository_root,
+                    journal
+                });
+                if (source_had_projection) {
+                    await mkdir(source.sidecar_dir, { recursive: true, mode: 0o700 });
+                    await rename(projection_dir, source_cache);
+                }
+                journal = {
+                    ...journal,
+                    stage: 'target_restored',
+                    updated_at: new Date().toISOString()
+                };
+                await writeEnvironmentSwitchJournal({
+                    repository_root: input.git.repository_root,
+                    journal
+                });
+                if (target_had_projection) {
+                    await rename(target_cache, projection_dir);
+                }
+                journal = {
+                    ...journal,
+                    stage: 'stores_relocated',
+                    updated_at: new Date().toISOString()
+                };
+                await writeEnvironmentSwitchJournal({
+                    repository_root: input.git.repository_root,
+                    journal
+                });
+                if (source_had_projection) {
+                    relocateBoundProjection({
+                        git: input.git,
+                        store: source.store,
+                        expected_projection_dir: projection_dir,
+                        projection_dir: source_cache
+                    });
+                }
+                if (target_had_projection) {
+                    relocateBoundProjection({
+                        git: input.git,
+                        store: target.store,
+                        expected_projection_dir: target_cache,
+                        projection_dir
+                    });
+                }
+                journal = {
+                    ...journal,
+                    stage: 'selector_advanced',
+                    updated_at: new Date().toISOString()
+                };
+                await writeEnvironmentSwitchJournal({
+                    repository_root: input.git.repository_root,
+                    journal
+                });
+                await writeActiveEnvironmentSelector({
+                    repository_root: input.git.repository_root,
+                    profile: target_profile
+                });
+                await clearEnvironmentSwitchJournal(input.git.repository_root);
+                return {
+                    switched: true,
+                    source_profile,
+                    active_profile: target_profile,
+                    projection_materialized: target_had_projection
+                };
+            }
+            catch (error) {
+                if (journal) {
+                    await rollbackSwitch({
+                        git: input.git,
+                        journal,
+                        source_store: source.store,
+                        target_store: target.store
+                    }).catch(() => undefined);
+                }
+                throw error;
+            }
+            finally {
+                source.store.close();
+                target.store.close();
+            }
+        }
+    });
+}
+//# sourceMappingURL=environment-switch.js.map

package/dist/local/environment-switch.js.map

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

package/dist/local/exact-remote-projection.d.ts

@@ -0,0 +1,17 @@
+import { type GraphClientOptions, type GraphClientRequestOptions } from '@software-dlc/graph/client';
+import type { GraphSyncHash, PortableGraph } from '@software-dlc/graph/types';
+import type { LocalSdlcStore } from './store.js';
+/** Recover source Path versions before acknowledging a published portable read. */
+export declare function ensureExactRemoteProjection(input: {
+    store: LocalSdlcStore;
+    client: GraphClientOptions;
+    worktree_id: string;
+    revision: number;
+    sync_revision: number;
+    sync_root_hash: GraphSyncHash;
+    graph: PortableGraph;
+    preserved_graph?: PortableGraph;
+    check: () => void;
+    request_options?: GraphClientRequestOptions;
+}): Promise<PortableGraph>;
+//# sourceMappingURL=exact-remote-projection.d.ts.map

package/dist/local/exact-remote-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exact-remote-projection.d.ts","sourceRoot":"","sources":["../../src/local/exact-remote-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC/B,MAAM,4BAA4B,CAAC;AAOpC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,mFAAmF;AACnF,wBAAsB,2BAA2B,CAAC,KAAK,EAAE;IACvD,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,aAAa,CAAC;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,eAAe,CAAC,EAAE,aAAa,CAAC;IAChC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,eAAe,CAAC,EAAE,yBAAyB,CAAC;CAC7C,GAAG,OAAO,CAAC,aAAa,CAAC,CA+DzB"}

package/dist/local/exact-remote-projection.js

@@ -0,0 +1,53 @@
+import { negotiateWorktreeSync } from '@software-dlc/graph/client';
+import { GRAPH_SEMANTIC_ANNOTATION_SCHEMA_VERSIONS, GRAPH_VARIANT_SET_SCHEMA_VERSIONS, projectPortableGraphToSync, worktree_sync_response_schema } from '@software-dlc/graph/schema';
+import { cachePortableGraphSyncProjection, reconstructNegotiatedWorktreeGraph } from './graph-sync.js';
+/** Recover source Path versions before acknowledging a published portable read. */
+export async function ensureExactRemoteProjection(input) {
+    const cached = await cachePortableGraphSyncProjection({
+        store: input.store,
+        worktree_id: input.worktree_id,
+        sync_revision: input.sync_revision,
+        expected_root_hash: input.sync_root_hash,
+        graph: input.graph,
+        check: input.check
+    });
+    if (cached.root_verified)
+        return input.graph;
+    input.check();
+    const response = worktree_sync_response_schema.parse(await negotiateWorktreeSync(input.client, input.worktree_id, {
+        supported_manifest_versions: [1],
+        supported_semantic_annotation_schema_versions: [
+            ...GRAPH_SEMANTIC_ANNOTATION_SCHEMA_VERSIONS
+        ],
+        supported_graph_variant_set_schema_versions: [
+            ...GRAPH_VARIANT_SET_SCHEMA_VERSIONS
+        ]
+    }, input.request_options));
+    input.check();
+    if (response.worktree_id !== input.worktree_id ||
+        response.revision !== input.revision ||
+        response.sync_revision !== input.sync_revision ||
+        response.sync_root_hash !== input.sync_root_hash)
+        throw new Error('Worktree publication changed during checkout. Retry without discarding local changes.');
+    if (response.mode !== 'manifest')
+        throw new Error('Exact checkout requires a complete graph sync publication.');
+    const reconstructed = await reconstructNegotiatedWorktreeGraph({
+        store: input.store,
+        base_graph: input.graph,
+        base_manifest: null,
+        response,
+        check: input.check
+    });
+    if (input.preserved_graph) {
+        const preserved = await projectPortableGraphToSync(input.preserved_graph, {
+            preserved_path_object_hashes: Object.fromEntries(reconstructed.manifest.bindings.flatMap((binding) => binding.kind === 'path'
+                ? [[binding.entity_id, binding.object_hash]]
+                : []))
+        });
+        input.check();
+        if (preserved.root_hash === input.sync_root_hash)
+            return input.preserved_graph;
+    }
+    return reconstructed.graph;
+}
+//# sourceMappingURL=exact-remote-projection.js.map

package/dist/local/exact-remote-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exact-remote-projection.js","sourceRoot":"","sources":["../../src/local/exact-remote-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EAGtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,yCAAyC,EACzC,iCAAiC,EACjC,0BAA0B,EAC1B,6BAA6B,EAC9B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,gCAAgC,EAChC,kCAAkC,EACnC,MAAM,iBAAiB,CAAC;AAGzB,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,KAWjD;IACC,MAAM,MAAM,GAAG,MAAM,gCAAgC,CAAC;QACpD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,kBAAkB,EAAE,KAAK,CAAC,cAAc;QACxC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,aAAa;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC;IAC7C,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,MAAM,QAAQ,GAAG,6BAA6B,CAAC,KAAK,CAClD,MAAM,qBAAqB,CACzB,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,WAAW,EACjB;QACE,2BAA2B,EAAE,CAAC,CAAC,CAAC;QAChC,6CAA6C,EAAE;YAC7C,GAAG,yCAAyC;SAC7C;QACD,2CAA2C,EAAE;YAC3C,GAAG,iCAAiC;SACrC;KACF,EACD,KAAK,CAAC,eAAe,CACtB,CACF,CAAC;IACF,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,IACE,QAAQ,CAAC,WAAW,KAAK,KAAK,CAAC,WAAW;QAC1C,QAAQ,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;QACpC,QAAQ,CAAC,aAAa,KAAK,KAAK,CAAC,aAAa;QAC9C,QAAQ,CAAC,cAAc,KAAK,KAAK,CAAC,cAAc;QAEhD,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;IACJ,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU;QAC9B,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;IACJ,MAAM,aAAa,GAAG,MAAM,kCAAkC,CAAC;QAC7D,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,UAAU,EAAE,KAAK,CAAC,KAAK;QACvB,aAAa,EAAE,IAAI;QACnB,QAAQ;QACR,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,MAAM,0BAA0B,CAAC,KAAK,CAAC,eAAe,EAAE;YACxE,4BAA4B,EAAE,MAAM,CAAC,WAAW,CAC9C,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAClD,OAAO,CAAC,IAAI,KAAK,MAAM;gBACrB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAU,CAAC;gBACrD,CAAC,CAAC,EAAE,CACP,CACF;SACF,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,EAAE,CAAC;QACd,IAAI,SAAS,CAAC,SAAS,KAAK,KAAK,CAAC,cAAc;YAC9C,OAAO,KAAK,CAAC,eAAe,CAAC;IACjC,CAAC;IACD,OAAO,aAAa,CAAC,KAAK,CAAC;AAC7B,CAAC"}

package/dist/local/experimental/path-object-store.d.ts

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+declare const supported_versions_schema: z.ZodArray<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>>;
+export type PathObjectVersion = z.infer<typeof supported_versions_schema>[number];
+/**
+ * Caller owns an existing private root. No live-sidecar default is provided.
+ * Capabilities describe format support, not authorization or graph validity.
+ */
+export declare class ExperimentalPathObjectStore {
+    private readonly directory;
+    private readonly supported_versions;
+    constructor(input: {
+        directory: string;
+        supported_versions: readonly PathObjectVersion[];
+    });
+    private objectPath;
+    read(object_hash: string): Promise<{
+        object_hash: string;
+        object: {
+            schema_version: 1;
+            kind: "path";
+            data: {
+                anchors: {
+                    node_id: string;
+                }[];
+                label?: string | undefined;
+                description?: string | undefined;
+                enforce_direction?: boolean | undefined;
+            };
+        } | {
+            schema_version: 2;
+            kind: "path";
+            data: {
+                anchors: {
+                    node_id: string;
+                }[];
+                label?: string | undefined;
+                description?: string | undefined;
+                enforce_direction?: boolean | undefined;
+                parent_id?: string | undefined;
+            };
+        } | {
+            schema_version: 3;
+            kind: "path";
+            data: {
+                route: ({
+                    kind: "node";
+                    node_id: string;
+                } | {
+                    kind: "edge";
+                    edge_id: string;
+                })[];
+                label?: string | undefined;
+                description?: string | undefined;
+                enforce_direction?: boolean | undefined;
+                parent_id?: string | undefined;
+            };
+        };
+        bytes: Uint8Array<ArrayBufferLike>;
+    }>;
+    put(input: {
+        object_hash: string;
+        bytes: Uint8Array;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=path-object-store.d.ts.map

package/dist/local/experimental/path-object-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-object-store.d.ts","sourceRoot":"","sources":["../../../src/local/experimental/path-object-store.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,QAAA,MAAM,yBAAyB,sFAEtB,CAAC;AACV,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CACrC,OAAO,yBAAyB,CACjC,CAAC,MAAM,CAAC,CAAC;AA8CV;;;GAGG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;gBAE7C,KAAK,EAAE;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,kBAAkB,EAAE,SAAS,iBAAiB,EAAE,CAAC;KAClD;IAcD,OAAO,CAAC,UAAU;IAMZ,IAAI,CAAC,WAAW,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+BxB,GAAG,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA8C5E"}