@angelmsger/fx 0.0.0-stage → 0.10.1

package/dist/application/workspace/discover.js

@@ -0,0 +1,62 @@
+// Discovery reads every registration without requiring any workspace to be healthy.
+import path from 'node:path';
+import { asDevkitError, toEnvelope } from '../../domain/errors.js';
+import { isAtOrInside } from '../../domain/path.js';
+import { workspaceReadiness } from './health.js';
+import { resolveWorkspace } from './resolve.js';
+export const WORKSPACE_COLUMNS = [
+    'name',
+    'root',
+    'source',
+    'default',
+    'cwd_match',
+    'selected',
+    'selection',
+    'registration_status',
+];
+export async function discoverWorkspaces(input) {
+    const config = await input.config.read();
+    let selected;
+    let selectionError = null;
+    try {
+        selected = await resolveWorkspace(input);
+    }
+    catch (error) {
+        selectionError = toEnvelope(asDevkitError(error)).error;
+    }
+    const cwd = await input.fs.realpath(path.resolve(input.cwd));
+    const items = [];
+    for (const [name, entry] of Object.entries(config.workspaces ?? {}).sort(([a], [b]) => a.localeCompare(b))) {
+        const root = await input.fs.realpath(path.resolve(entry.root));
+        const located = {
+            name,
+            root,
+            manifestDir: input.manifestDirFor(name),
+            selection: selected?.selection ?? 'explicit',
+        };
+        items.push({
+            name,
+            root,
+            source: entry.source ?? null,
+            manifest: located.manifestDir,
+            default: config.default_workspace === name,
+            cwd_match: isAtOrInside(cwd, root),
+            selected: selected?.name === name,
+            selection: selected?.name === name ? selected.selection : null,
+            ...(await workspaceReadiness(input, located)),
+        });
+    }
+    return {
+        items,
+        has_more: false,
+        default_workspace: config.default_workspace ?? null,
+        selection_error: selectionError,
+    };
+}
+export async function showWorkspace(input) {
+    const located = await resolveWorkspace(input);
+    const result = await discoverWorkspaces({ ...input, name: located.name });
+    const record = result.items.find((item) => item.name === located.name);
+    return { ...record, selection: located.selection };
+}
+//# sourceMappingURL=discover.js.map

package/dist/application/workspace/discover.js.map

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

package/dist/application/workspace/guidance.js

@@ -0,0 +1,24 @@
+// Workspace recovery commands retain the resolved identity instead of resolving cwd or defaults again.
+import { DevkitError } from '../../domain/errors.js';
+import { nearest } from '../../domain/fuzzy.js';
+import { shellLine } from '../../domain/shell.js';
+export function recoveryCommand(context, ...args) {
+    const scope = context.workspace === undefined ? [] : ['--workspace', context.workspace];
+    return shellLine(['fx', ...args, ...scope], context.commandShell);
+}
+export function workspaceCommand(context, ...args) {
+    return recoveryCommand({ workspace: context.ctx.name, commandShell: context.commandShell }, ...args);
+}
+export function workspaceItemNotFound(context, input) {
+    const suggestion = nearest(input.name, input.known);
+    const subject = input.kind === 'repo' ? 'repository' : 'environment';
+    const qualifier = input.shared ? 'shared ' : '';
+    const article = input.kind === 'env' ? 'an' : 'a';
+    return new DevkitError('not_found', input.kind === 'repo' ? 'REPO_NOT_FOUND' : 'ENV_NOT_FOUND', `"${input.name}" is not ${article} ${qualifier}${subject} of workspace "${context.ctx.name}"`, {
+        hint: suggestion === undefined
+            ? `Known: ${input.known.join(', ') || '(none)'}.`
+            : `Did you mean "${suggestion}"?`,
+        nextSteps: [workspaceCommand(context, input.kind, 'list')],
+    });
+}
+//# sourceMappingURL=guidance.js.map

package/dist/application/workspace/guidance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance.js","sourceRoot":"","sources":["../../../src/application/workspace/guidance.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAsB,MAAM,uBAAuB,CAAC;AAYtE,MAAM,UAAU,eAAe,CAAC,OAAwB,EAAE,GAAG,IAAuB;IAClF,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACxF,OAAO,SAAS,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAA0B,EAAE,GAAG,IAAuB;IACrF,OAAO,eAAe,CACpB,EAAE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,EACnE,GAAG,IAAI,CACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAA0B,EAC1B,KAKC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC;IACrE,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IAClD,OAAO,IAAI,WAAW,CACpB,WAAW,EACX,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,EAC1D,IAAI,KAAK,CAAC,IAAI,YAAY,OAAO,IAAI,SAAS,GAAG,OAAO,kBAAkB,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,EAC7F;QACE,IAAI,EACF,UAAU,KAAK,SAAS;YACtB,CAAC,CAAC,UAAU,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,GAAG;YACjD,CAAC,CAAC,iBAAiB,UAAU,IAAI;QACrC,SAAS,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;KAC3D,CACF,CAAC;AACJ,CAAC"}

package/dist/application/workspace/health.js

@@ -0,0 +1,75 @@
+// Readiness diagnostics preserve the registered identity and exact recovery target.
+import path from 'node:path';
+import { asDevkitError, DevkitError, toEnvelope } from '../../domain/errors.js';
+import { MANIFEST_FILES } from '../../domain/manifest/files.js';
+import { shellLine } from '../../domain/shell.js';
+import { LoadManifest } from '../manifest/load.js';
+export async function workspaceReadiness(input, located) {
+    try {
+        await assertWorkspacePrepared(input, located);
+        await new LoadManifest(input.fs, input.bundledTools).execute({
+            dir: located.manifestDir,
+            cliVersion: input.cliVersion,
+            providers: input.providers,
+        });
+        return { registration_status: 'available', error: null };
+    }
+    catch (error) {
+        const failure = contextualWorkspaceError(input, located, error);
+        const statuses = {
+            WORKSPACE_ROOT_MISSING: 'root_missing',
+            MANIFEST_UNPREPARED: 'unprepared',
+            MANIFEST_MISSING: 'missing',
+        };
+        const status = statuses[failure.code] ?? 'invalid';
+        return { registration_status: status, error: toEnvelope(failure).error };
+    }
+}
+export async function assertWorkspacePrepared(input, located, allowMissingRoot = false) {
+    await assertNoWorkspaceOperation(input, located);
+    const command = (...args) => shellLine(['fx', ...args], input.commandShell);
+    if (!allowMissingRoot && !(await input.fs.isDirectory(located.root)))
+        throw new DevkitError('not_found', 'WORKSPACE_ROOT_MISSING', `Workspace "${located.name}" root is missing: ${located.root}`, {
+            hint: 'Restore the directory, or point this registration at its moved directory. Repository synchronization will not recreate a missing workspace root.',
+            nextSteps: [
+                command('workspace', 'show', located.name),
+                command('workspace', 'relocate', located.name, '<existing-directory>'),
+            ],
+        });
+    if (await input.fs.exists(path.join(located.manifestDir, MANIFEST_FILES.workspace)))
+        return;
+    const prepared = await input.fs.isDirectory(located.manifestDir);
+    const source = (await input.config.read()).workspaces?.[located.name]?.source;
+    throw new DevkitError('config', prepared ? 'MANIFEST_MISSING' : 'MANIFEST_UNPREPARED', `Workspace "${located.name}" ${prepared ? 'is missing manifest/workspace.yaml' : 'manifest has not been prepared'}`, {
+        hint: 'Recover the manifest from the registered source; existing business checkouts and personal selections are preserved.',
+        nextSteps: [
+            command('init', located.root, '--name', located.name, '--from', source ?? '<source>'),
+            command('workspace', 'show', located.name),
+        ],
+    });
+}
+export function contextualWorkspaceError(input, located, error) {
+    const failure = asDevkitError(error);
+    if (!failure.code.startsWith('MANIFEST_') ||
+        ['MANIFEST_MISSING', 'MANIFEST_UNPREPARED'].includes(failure.code))
+        return failure;
+    return new DevkitError(failure.category, failure.code, failure.message, {
+        hint: failure.hint,
+        cause: failure,
+        diagnostics: failure.diagnostics,
+        nextSteps: [
+            shellLine(['fx', 'manifest', 'validate', '--workspace', located.name], input.commandShell),
+            shellLine(['fx', 'workspace', 'show', located.name], input.commandShell),
+        ],
+    });
+}
+export async function assertNoWorkspaceOperation(input, located) {
+    const file = path.join(path.dirname(located.manifestDir), 'workspace-operation.json');
+    if (!(await input.fs.exists(file)))
+        return;
+    throw new DevkitError('conflict', 'WORKSPACE_OPERATION_PENDING', `Workspace "${located.name}" has an unfinished identity operation`, {
+        hint: `Inspect ${file}; retry the original workspace unregister, relocate or rebind command before other workspace operations.`,
+        nextSteps: [shellLine(['fx', 'workspace', 'show', located.name], input.commandShell)],
+    });
+}
+//# sourceMappingURL=health.js.map

package/dist/application/workspace/health.js.map

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

package/dist/application/workspace/inspect.js

@@ -0,0 +1,119 @@
+// Inspect repository state and resolve code-host coordinates for workspace commands.
+import path from 'node:path';
+import { DevkitError } from '../../domain/errors.js';
+import { resolveSharedRepo } from '../../domain/manifest/local.js';
+import { samePath } from '../../domain/path.js';
+import { repoRef } from '../../domain/workspace/ref.js';
+import { workspaceCommand, workspaceItemNotFound } from './guidance.js';
+export function checkoutDir(deps, repo) {
+    return path.resolve(deps.ctx.root, repo.path);
+}
+export async function inspectDisk(deps, repo) {
+    const dir = checkoutDir(deps, repo);
+    if (!(await deps.fs.exists(dir)))
+        return { kind: 'absent' };
+    const top = await deps.git.toplevel(dir);
+    // git reports resolved paths; a workspace under /tmp or /var is reached through a symlink.
+    if (top === undefined || !samePath(await deps.fs.realpath(top), await deps.fs.realpath(dir)))
+        return { kind: 'not_git' };
+    const compareTo = repo.branch === undefined ? undefined : `upstream/${repo.branch}`;
+    const [state, remotes] = await Promise.all([
+        deps.git.status(dir, compareTo),
+        deps.git.remotes(dir),
+    ]);
+    return { kind: 'checkout', state, remotes };
+}
+export function urlsFor(deps, repo, user) {
+    const ref = repoRef(repo);
+    const host = ref === undefined ? undefined : tryCodeHost(deps);
+    const upstream = repo.upstream ?? (host === undefined || ref === undefined ? undefined : host.upstreamUrl(ref));
+    const origin = host === undefined || ref === undefined || user === undefined
+        ? undefined
+        : host.forkUrl(user, ref);
+    return { upstream, ...(origin === undefined ? {} : { origin }) };
+}
+export function webUrlFor(deps, repo) {
+    const ref = repoRef(repo);
+    const host = ref === undefined ? undefined : tryCodeHost(deps);
+    return host === undefined || ref === undefined ? repo.upstream : host.webUrl(ref);
+}
+export async function readabilityOf(deps, repo) {
+    const ref = repoRef(repo);
+    if (ref === undefined)
+        return 'unknown';
+    const host = tryCodeHost(deps);
+    if (host === undefined)
+        return 'unknown';
+    try {
+        return await host.canRead(ref);
+    }
+    catch (err) {
+        // API prerequisites are optional for Git transport; explicit access denials
+        // returned by the provider remain authoritative. Programming errors still fail.
+        if (!(err instanceof DevkitError) ||
+            !['TOOL_MISSING', 'LOGIN_REQUIRED', 'VECTOR_UNTRUSTED', 'PROCESS_TIMEOUT'].includes(err.code))
+            throw err;
+        return 'unknown';
+    }
+}
+// config.user first: a token-authenticated host may not know who is asking.
+export async function resolveUser(deps) {
+    if (deps.user !== undefined)
+        return deps.user;
+    return (await deps.codeHost().whoami()).user;
+}
+export function contactFor(deps, repo) {
+    return repo.project === undefined
+        ? undefined
+        : deps.ctx.manifest.workspace.result.doc.projects?.[repo.project]?.contact;
+}
+export function findRepo(deps, name) {
+    const repo = deps.ctx.workspace.repos.find((r) => r.name === name);
+    if (repo !== undefined)
+        return repo;
+    const known = [...deps.ctx.workspace.repos.map((r) => r.name), ...deps.ctx.workspace.available];
+    throw workspaceItemNotFound(deps, { kind: 'repo', name, known });
+}
+// Discovery can inspect unpicked shared entries without widening the
+// selection used by commands that operate on tracked checkouts.
+export function findKnownRepo(deps, name) {
+    const picked = deps.ctx.workspace.repos.find((repo) => repo.name === name);
+    if (picked !== undefined)
+        return picked;
+    const workspace = deps.ctx.manifest.workspace.result.doc;
+    const repo = workspace.repos.find((entry) => entry.name === name);
+    if (repo !== undefined)
+        return resolveSharedRepo({ workspace, local: deps.ctx.local, repo });
+    const all = [
+        ...deps.ctx.workspace.repos,
+        ...workspace.repos
+            .filter((entry) => deps.ctx.workspace.available.includes(entry.name))
+            .map((entry) => resolveSharedRepo({ workspace, local: deps.ctx.local, repo: entry })),
+    ];
+    const matches = all.filter((entry) => entry.aka?.includes(name));
+    if (matches.length === 1)
+        return matches[0];
+    if (matches.length > 1) {
+        throw new DevkitError('conflict', 'REPO_ALIAS_AMBIGUOUS', `Repository alias "${name}" matches ${matches.map((entry) => entry.name).join(', ')}`, {
+            hint: 'Use a canonical repository name to choose one.',
+            nextSteps: matches.map((entry) => workspaceCommand(deps, 'repo', 'show', entry.name)),
+        });
+    }
+    throw workspaceItemNotFound(deps, {
+        kind: 'repo',
+        name,
+        known: all.flatMap((entry) => [entry.name, ...(entry.aka ?? [])]),
+    });
+}
+function tryCodeHost(deps) {
+    try {
+        return deps.codeHost();
+    }
+    catch (error) {
+        if (!(error instanceof DevkitError) ||
+            !['PROVIDER_UNBOUND', 'PROVIDER_UNKNOWN', 'PROVIDER_VAR_MISSING'].includes(error.code))
+            throw error;
+        return undefined;
+    }
+}
+//# sourceMappingURL=inspect.js.map

package/dist/application/workspace/inspect.js.map

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

package/dist/application/workspace/manage.js

@@ -0,0 +1,326 @@
+// Workspace identity changes retire owned resources and retain recovery copies before committing registration.
+import { randomUUID } from 'node:crypto';
+import path from 'node:path';
+import { asDevkitError, busyError, DevkitError, withPartialResult } from '../../domain/errors.js';
+import { samePath } from '../../domain/path.js';
+import { shellLine } from '../../domain/shell.js';
+import { assertWritable } from '../safety/posture.js';
+import { withWorkspaceOperation } from './operation.js';
+import { assertDistinctWorkspaceRoot } from './registry.js';
+import { inspectRebindSource, materializeRebindSource } from './source-preview.js';
+export class ManageWorkspace {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    async execute(input) {
+        const preview = await this.plan(input);
+        if (await this.isNoop(preview))
+            return this.output({ ...preview, after: preview.before }, [], false);
+        if (input.dryRun)
+            return this.run(input);
+        assertWritable(input.posture, `workspace ${input.action}`);
+        return withWorkspaceOperation(this.deps.lock, input.name, false, () => this.run(input));
+    }
+    async run(input) {
+        const preview = await this.plan(input);
+        if (await this.isNoop(preview))
+            return this.output({ ...preview, after: preview.before }, [], false);
+        const validation = input.source && preview.phase === 'planned'
+            ? await inspectRebindSource(input.source, { ...this.deps, workspace: input.name })
+            : null;
+        const resources = await this.cleanup(preview, input, true);
+        const result = {
+            ...(await this.output(preview, resources, false)),
+            source_validation: validation,
+        };
+        if (input.dryRun)
+            return result;
+        assertWritable(input.posture, `workspace ${input.action}`);
+        const lease = await this.deps.lock.acquire({ key: `workspace:${input.name}`, waitMs: 2000 });
+        if (!lease)
+            throw busyError('LOCK_BUSY', 'The workspace', {
+                nextSteps: ['Retry the same workspace command shortly.'],
+            });
+        const progress = { written: false, phase: null };
+        try {
+            const current = await this.plan(input, preview.id);
+            if (JSON.stringify(current) !== JSON.stringify(preview))
+                throw changedRegistry();
+            return await this.apply(current, input, progress);
+        }
+        catch (error) {
+            throw withPartialResult(error, {
+                ...result,
+                ...asDevkitError(error).partialResult,
+                backup: await this.retainedBackup(preview),
+                written: progress.written,
+                phase: progress.phase,
+                recovery: this.journalPath(input.name),
+                next_steps: ['Retry the same workspace command to resume the retained operation.'],
+            });
+        }
+        finally {
+            await lease.release();
+        }
+    }
+    async isNoop(journal) {
+        return (journal.action === 'relocate' &&
+            journal.phase === 'planned' &&
+            samePath(await this.deps.fs.realpath(journal.before.root), journal.root));
+    }
+    async plan(input, id = randomUUID()) {
+        const pending = await this.readJournal(input.name);
+        if (pending) {
+            await this.assertPending(input, pending);
+            await this.assertCurrentIdentity(pending);
+            return pending;
+        }
+        const config = await this.deps.config.read();
+        const before = config.workspaces?.[input.name];
+        if (!before)
+            throw new DevkitError('not_found', 'WORKSPACE_UNKNOWN', `No workspace named "${input.name}" is registered`, { nextSteps: ['fx workspace list'] });
+        const root = await this.deps.fs.realpath(path.resolve(input.root ?? before.root));
+        let after = before;
+        if (input.action === 'relocate') {
+            await this.validateRelocation(input, before, root);
+            await assertDistinctWorkspaceRoot(config, input.name, root, this.deps.fs);
+            after = { ...before, root };
+        }
+        if (input.action === 'rebind') {
+            if (!input.source)
+                throw new DevkitError('usage', 'INPUT_REQUIRED', 'Rebind requires --from', {
+                    nextSteps: [
+                        shellLine(['fx', 'workspace', 'rebind', input.name, '--from', '<manifest-source>']),
+                    ],
+                });
+            if (!(await this.deps.fs.isDirectory(root)))
+                throw new DevkitError('not_found', 'WORKSPACE_ROOT_MISSING', 'Restore or relocate the workspace root before rebinding its source', {
+                    nextSteps: [
+                        shellLine(['fx', 'workspace', 'relocate', input.name, '<existing-directory>']),
+                    ],
+                });
+            await assertDistinctWorkspaceRoot(config, input.name, root, this.deps.fs);
+            after = { ...before, source: input.source.description };
+        }
+        if (input.action === 'unregister')
+            after = null;
+        return {
+            id,
+            name: input.name,
+            action: input.action,
+            before,
+            after,
+            root,
+            phase: 'planned',
+        };
+    }
+    async assertPending(input, pending) {
+        if (pending.action !== input.action ||
+            (input.root !== undefined &&
+                !samePath(await this.deps.fs.realpath(path.resolve(input.root)), pending.root)) ||
+            (input.source !== undefined && pending.after?.source !== input.source.description))
+            throw new DevkitError('conflict', 'WORKSPACE_OPERATION_PENDING', 'A different workspace operation requires recovery first', {
+                nextSteps: [
+                    `Retry workspace ${pending.action} for ${input.name} with its original arguments.`,
+                    `Inspect ${this.journalPath(input.name)}.`,
+                ],
+            });
+    }
+    async validateRelocation(input, before, root) {
+        if (!input.root || !(await this.deps.fs.isDirectory(root)))
+            throw new DevkitError('not_found', 'WORKSPACE_ROOT_MISSING', 'Relocate requires an existing destination directory', {
+                hint: 'Move the workspace directory with your file manager, then relocate its registration.',
+                nextSteps: ['fx workspace relocate --help'],
+            });
+        if (!samePath(await this.deps.fs.realpath(before.root), root) &&
+            (await this.deps.fs.isDirectory(before.root)))
+            throw new DevkitError('conflict', 'WORKSPACE_ROOT_EXISTS', 'The registered root still exists', {
+                nextSteps: [
+                    shellLine(['fx', 'workspace', 'show', input.name]),
+                    `Move ${before.root} to the destination before relocating the identity.`,
+                ],
+            });
+    }
+    async apply(initial, input, progress) {
+        let journal = initial;
+        const save = async (phase) => {
+            const next = { ...journal, phase };
+            await this.deps.fs.writeText(this.journalPath(input.name), JSON.stringify(next));
+            journal = next;
+            progress.written = true;
+            progress.phase = phase;
+        };
+        await save(journal.phase);
+        const sourceDir = this.deps.manifestDirFor(input.name);
+        const staging = `${sourceDir}.rebind-${journal.id}`;
+        const backup = this.backup(journal);
+        if (journal.action === 'rebind' && journal.phase === 'planned') {
+            await this.deps.fs.remove(staging);
+            await materializeRebindSource(input.source, { ...this.deps, workspace: input.name }, staging);
+            await save('source_ready');
+        }
+        let resources = [];
+        if (journal.phase === 'planned' || journal.phase === 'source_ready') {
+            resources = await this.cleanup(journal, input, false);
+            await save('resources_cleaned');
+        }
+        if (journal.action === 'rebind' && journal.phase === 'resources_cleaned') {
+            if (await this.deps.fs.exists(sourceDir))
+                await this.preserveDirectory(sourceDir, backup);
+            await this.deps.fs.replaceDir(staging, sourceDir);
+            await save('source_replaced');
+        }
+        if (journal.action === 'unregister')
+            await this.preserveDirectory(path.dirname(sourceDir), backup);
+        if (journal.phase !== 'registered') {
+            await this.deps.config.update(async (current) => {
+                const observed = current.workspaces?.[input.name] ?? null;
+                if (JSON.stringify(observed) !== JSON.stringify(journal.before) &&
+                    JSON.stringify(observed) !== JSON.stringify(journal.after))
+                    throw changedRegistry();
+                const workspaces = { ...current.workspaces };
+                if (journal.after) {
+                    await assertDistinctWorkspaceRoot(current, input.name, journal.after.root, this.deps.fs);
+                    workspaces[input.name] = journal.after;
+                }
+                else
+                    delete workspaces[input.name];
+                const next = { ...current, workspaces };
+                if (!journal.after && next.default_workspace === input.name)
+                    delete next.default_workspace;
+                return next;
+            });
+            await save('registered');
+        }
+        if (journal.action === 'rebind')
+            await this.deps.fs.remove(staging);
+        if (journal.action === 'unregister' && !(await this.sharedRoots(journal)).length)
+            await this.deps.fs.remove(path.dirname(sourceDir));
+        else
+            await this.deps.fs.remove(this.journalPath(input.name));
+        return this.output(journal, resources, true);
+    }
+    async assertCurrentIdentity(journal) {
+        const observed = (await this.deps.config.read()).workspaces?.[journal.name] ?? null;
+        const before = JSON.stringify(observed) === JSON.stringify(journal.before);
+        const after = JSON.stringify(observed) === JSON.stringify(journal.after);
+        if (journal.phase === 'registered'
+            ? !after
+            : !before && !(after && ['resources_cleaned', 'source_replaced'].includes(journal.phase)))
+            throw changedRegistry();
+    }
+    async preserveDirectory(source, backup) {
+        if (await this.deps.fs.exists(backup))
+            return;
+        const staged = `${backup}.pending`;
+        await this.deps.fs.remove(staged);
+        await this.deps.fs.copyDir(source, staged);
+        await this.deps.fs.replaceDir(staged, backup);
+        await this.deps.fs.remove(staged);
+    }
+    async cleanup(journal, input, dryRun) {
+        if (journal.phase === 'registered' ||
+            journal.phase === 'source_replaced' ||
+            journal.phase === 'resources_cleaned')
+            return Promise.resolve([]);
+        await this.assertCurrentIdentity(journal);
+        return this.deps.resources.cleanup({
+            name: input.name,
+            root: journal.root,
+            ownershipRoot: await this.deps.fs.realpath(journal.before.root),
+            manifestDir: this.deps.manifestDirFor(input.name),
+            shared: await this.sharedRoots(journal),
+            dryRun,
+            posture: input.posture,
+        });
+    }
+    async sharedRoots(journal) {
+        const shared = [];
+        for (const [name, entry] of Object.entries((await this.deps.config.read()).workspaces ?? {}))
+            if (name !== journal.name && samePath(await this.deps.fs.realpath(entry.root), journal.root))
+                shared.push({ name, manifestDir: this.deps.manifestDirFor(name) });
+        return shared;
+    }
+    async output(journal, resources, written) {
+        const backup = await this.retainedBackup(journal);
+        const source = this.deps.manifestDirFor(journal.name);
+        const prior = journal.action === 'unregister' ? path.dirname(source) : source;
+        const planned = !written &&
+            !backup &&
+            journal.action !== 'relocate' &&
+            journal.phase === 'planned' &&
+            (await this.deps.fs.exists(prior));
+        return {
+            operation: journal.action,
+            name: journal.name,
+            before: journal.before,
+            after: journal.after,
+            checkouts: 'preserved',
+            personal_scope: 'preserved',
+            global_tools_and_skills: 'preserved',
+            resources,
+            backup,
+            planned_backup: planned ? this.backup(journal) : null,
+            source_validation: journal.action === 'rebind' && !written ? 'pending_apply' : null,
+            next_steps: journal.after
+                ? [
+                    shellLine(['fx', 'sync', '--workspace', journal.name]),
+                    shellLine(['fx', 'workspace', 'show', journal.name]),
+                ]
+                : ['fx workspace list'],
+            written,
+        };
+    }
+    async retainedBackup(journal) {
+        if (journal.action === 'relocate')
+            return null;
+        const backup = this.backup(journal);
+        return (await this.deps.fs.isDirectory(backup)) ? backup : null;
+    }
+    backup(journal) {
+        const source = this.deps.manifestDirFor(journal.name);
+        return journal.action === 'unregister'
+            ? `${path.dirname(source)}.retired-${journal.id}`
+            : `${source}.backup-${journal.id}`;
+    }
+    journalPath(name) {
+        return path.join(path.dirname(this.deps.manifestDirFor(name)), 'workspace-operation.json');
+    }
+    async readJournal(name) {
+        const text = await this.deps.fs.readText(this.journalPath(name));
+        if (text === undefined)
+            return null;
+        let value;
+        try {
+            value = JSON.parse(text);
+        }
+        catch {
+            throw changedRegistry();
+        }
+        if (!value ||
+            typeof value !== 'object' ||
+            value.name !== name ||
+            !/^[a-f0-9-]{36}$/.test(value.id) ||
+            !['unregister', 'relocate', 'rebind'].includes(value.action) ||
+            typeof value.before?.root !== 'string' ||
+            typeof value.root !== 'string' ||
+            !validTransition(value) ||
+            !['planned', 'source_ready', 'resources_cleaned', 'source_replaced', 'registered'].includes(value.phase))
+            throw changedRegistry();
+        return value;
+    }
+}
+function changedRegistry() {
+    return new DevkitError('conflict', 'WORKSPACE_PLAN_CHANGED', 'Workspace registration or recovery state changed', { nextSteps: ['fx workspace list', 'Re-run the same command against the current state.'] });
+}
+function validTransition(journal) {
+    if (journal.action === 'unregister')
+        return journal.after === null;
+    if (typeof journal.after?.root !== 'string')
+        return false;
+    if (journal.action === 'relocate')
+        return journal.after.root === journal.root && journal.after.source === journal.before.source;
+    return journal.after.root === journal.before.root && typeof journal.after.source === 'string';
+}
+//# sourceMappingURL=manage.js.map