refactor(javascript): group domain semantics and contracts (#907)

src/contracts/javascript/javascriptRecoveryToolContracts.ts

@@ -0,0 +1,29 @@
+import {
+  javascriptRecoveryInputSchema,
+  javascriptRecoveryResultSchema,
+} from "../../domain/javascript/javascriptRecovery.js";
+import { toolContractMetadata } from "../toolEffects.js";
+import { evidenceResultOf } from "../toolOutputSchemaPrimitives.js";
+import type { ToolContract } from "../toolContractTypes.js";
+
+/** Derived script artifacts from optional upstream recovery adapters. */
+export const JAVASCRIPT_RECOVERY_TOOL_CONTRACTS = [
+  {
+    name: "recover_javascript_sources",
+    ...toolContractMetadata("recover_javascript_sources"),
+    kind: "application",
+    description:
+      "Recover readable modules from one local UTF-8 JavaScript script/bundle into an absent directory, using caller-supplied Wakaru 1.13.0 on Linux x64. Returns original/derived digests, extraction byte ranges, emitted source maps, warnings and analysis_input inline. Structural splitting may fall back to one module; original names and runtime equivalence remain unknown. No application code execution. Requires util-linux prlimit; one worker, 1 GiB address-space ceiling, 120-second deadline, 64 MiB input, 128 MiB output, 10000 entries and 8 MiB per diagnostic/report stream.",
+    inputSchema: javascriptRecoveryInputSchema,
+    outputSchema: evidenceResultOf(javascriptRecoveryResultSchema),
+    examples: [
+      {
+        title: "Recover a captured production bundle",
+        input: {
+          path: "/tmp/web-scripts/app.js",
+          output_directory: "/tmp/recovered-app",
+        },
+      },
+    ],
+  },
+] as const satisfies readonly ToolContract[];