feat(ide-gsm-client): add FDM space delete dry-run helper (#1750)

Co-authored-by: codex <codex@example.com>

Author: kubohiroya

docs/fdm-node-spec.md

@@ -346,6 +346,8 @@ Mutations:
 - `cancelTask(taskId)`: cancellation request for a server task.
 - Existing `sim`, `calib`, and `check` command mutations through the owning `idegsm-project` command service, not a second FDM-specific command implementation.
 
+Client-side server-space deletion must use the explicit FDM space lifecycle API. `fdmSpaceDeleteDryRun` is the safe inspection helper and always sends `apply: false`; apply/archive/delete UI remains gated on server authorization and reference-aware semantics. `fdmDirectoryRemove` removes an entry inside a space and must not be used as server-side FDM space delete/archive.
+
 Subscriptions:
 
 - `subscribeFdmCellLog`: bounded live log snapshots for the selected cell.

docs/fdm-seven-layer-contract-audit.md

@@ -94,3 +94,7 @@ Phase B1 now keeps each layer represented by an executable fixture or an explici
 | L6 space | space catalog metadata with explicit unavailable or unscoped capability provenance | covered, pending #1735/#1736 action/view expansion |
 
 Later issues should extend these fixtures instead of creating divergent local terminology. #1732 adds read-only intake for baseline/fork/lineage capability summaries without per-space inference, #1735 owns lifecycle dry-run/safety wiring, and #1736 owns fork/cross-space read-only dashboard views.
+
+## L6 lifecycle safety
+
+`fdmSpaceDeleteDryRun` is the safe client helper for server-side FDM space delete/archive inspection. It always calls `fdmSpaceDelete` with `apply: false` and is tested separately from `fdmDirectoryRemove`. Destructive apply behavior and UI actions remain gated until the server contract provides reference-aware denial, authorization evidence, and explicit apply semantics.

packages/ide-gsm-client/__tests__/IdeGsmClient.test.ts

@@ -617,6 +617,42 @@ describe('directory read contracts', () => {
     });
   });
 
+  it('runs FDM space delete dry-run through the space lifecycle mutation only', async () => {
+    const { GraphQLClient } = await import('graphql-request');
+    const spy = vi.spyOn(GraphQLClient.prototype, 'request').mockResolvedValueOnce({
+      fdmSpaceDelete: {
+        apply: false,
+        archived: true,
+        byteCount: 1024,
+        confirmed: false,
+        deleted: false,
+        fileCount: 3,
+        physicalDelete: false,
+        spaceId: 'working',
+        topLevelEntries: ['runs', 'snapshots'],
+        spaces: null,
+      },
+    });
+    const client = new IdeGsmClient('https://endpoint.example', 'jwt-secret');
+
+    await expect(
+      client.fdmSpaceDeleteDryRun({ spaceId: 'working', deleteFiles: true })
+    ).resolves.toMatchObject({
+      apply: false,
+      deleted: false,
+      physicalDelete: false,
+      spaceId: 'working',
+    });
+
+    expect(String(spy.mock.calls[0]?.[0])).toContain('fdmSpaceDelete');
+    expect(String(spy.mock.calls[0]?.[0])).not.toContain('fdmDirectoryRemove');
+    expect(spy.mock.calls[0]?.[1]).toEqual({
+      spaceId: 'working',
+      apply: false,
+      deleteFiles: true,
+    });
+  });
+
   it.each([
     [
       'project path',

packages/ide-gsm-client/src/IdeGsmClient.ts

@@ -12,6 +12,7 @@ import type {
   IdeGsmFdmSpace,
   IdeGsmFdmSpaceCreateInput,
   IdeGsmFdmSpaceDefaults,
+  IdeGsmFdmSpaceDeleteDryRunInput,
   IdeGsmFdmSpaceDeleteInput,
   IdeGsmFdmSpaceDeleteReport,
   IdeGsmFdmSpacesReport,
@@ -1676,6 +1677,16 @@ export class IdeGsmClient {
     );
   }
 
+  async fdmSpaceDeleteDryRun(
+    input: IdeGsmFdmSpaceDeleteDryRunInput
+  ): Promise<IdeGsmFdmSpaceDeleteReport> {
+    return this.fdmSpaceDelete({
+      spaceId: input.spaceId,
+      apply: false,
+      deleteFiles: input.deleteFiles,
+    });
+  }
+
   async fdmDashboardStatus(input: FdmDashboardStatusInput): Promise<FdmDashboardStatusPayload> {
     return this.requestReport(
       'fdmDashboardStatus',

packages/ide-gsm-client/src/ideGsmDirectoryTypes.ts

@@ -107,6 +107,11 @@ export interface IdeGsmFdmSpaceDeleteInput {
   confirmation?: string;
 }
 
+export interface IdeGsmFdmSpaceDeleteDryRunInput {
+  spaceId: string;
+  deleteFiles?: boolean;
+}
+
 export interface IdeGsmFdmSpaceDeleteReport {
   apply: boolean;
   archived: boolean;

packages/ide-gsm-client/src/index.ts

@@ -10,6 +10,7 @@ export type {
   IdeGsmFdmSpace,
   IdeGsmFdmSpaceCreateInput,
   IdeGsmFdmSpaceDefaults,
+  IdeGsmFdmSpaceDeleteDryRunInput,
   IdeGsmFdmSpaceDeleteInput,
   IdeGsmFdmSpaceDeleteReport,
   IdeGsmFdmSpacesReport,