feat: add Space interaction scripts and reorganize contract structure (#4440)

### Description

This PR reorganizes interaction scripts and adds new functionality for Space and SpaceFactory diamonds. It moves the AppRegistry interaction script out of the diamonds directory and introduces new scripts for interacting with Space and SpaceFactory contracts.

### Changes

- Moved `InteractAppRegistry.s.sol` from `diamonds/` directory to the parent folder
- Removed unused import `IAppFactory` from AppRegistry interaction script
- Added new `InteractSpace.s.sol` script that:
  - Deploys a new TippingFacet implementation
  - Replaces the existing TippingFacet on the Space diamond
- Added new `InteractSpaceFactory.s.sol` script that:
  - Sets fee recipient in PlatformRequirementsFacet
  - Deploys a new FeeManagerFacet implementation
  - Adds the FeeManagerFacet to the SpaceFactory diamond with initialization
  - Configures a 0.5% fee for member tipping

### Checklist

- [ ] Tests added where required
- [ ] Documentation updated where applicable
- [ ] Changes adhere to the repository's contribution guidelines

Author: giuseppecrj

packages/contracts/scripts/interactions/diamonds/InteractAppRegistry.s.sol renamed to packages/contracts/scripts/interactions/InteractAppRegistry.s.sol

@@ -2,21 +2,21 @@
 pragma solidity ^0.8.23;
 
 // interfaces
-import {IAppFactory, IAppFactoryBase} from "src/apps/facets/factory/IAppFactory.sol";
+import {IAppFactoryBase} from "src/apps/facets/factory/IAppFactory.sol";
 
 // libraries
 import {console} from "forge-std/console.sol";
 
 // contracts
-import {Interaction} from "../../common/Interaction.s.sol";
-import {AlphaHelper} from "../helpers/AlphaHelper.sol";
-import {DeployAppRegistry} from "../../deployments/diamonds/DeployAppRegistry.s.sol";
-import {DeploySimpleAppBeacon} from "../../deployments/diamonds/DeploySimpleAppBeacon.s.sol";
+import {Interaction} from "../common/Interaction.s.sol";
+import {AlphaHelper} from "./helpers/AlphaHelper.sol";
+import {DeployAppRegistry} from "../deployments/diamonds/DeployAppRegistry.s.sol";
+import {DeploySimpleAppBeacon} from "../deployments/diamonds/DeploySimpleAppBeacon.s.sol";
 
 // facet deployers
-import {DeployAppRegistryFacet} from "../../deployments/facets/DeployAppRegistryFacet.s.sol";
-import {DeployAppInstallerFacet} from "../../deployments/facets/DeployAppInstallerFacet.s.sol";
-import {DeployAppFactoryFacet} from "../../deployments/facets/DeployAppFactoryFacet.s.sol";
+import {DeployAppRegistryFacet} from "../deployments/facets/DeployAppRegistryFacet.s.sol";
+import {DeployAppInstallerFacet} from "../deployments/facets/DeployAppInstallerFacet.s.sol";
+import {DeployAppFactoryFacet} from "../deployments/facets/DeployAppFactoryFacet.s.sol";
 
 contract InteractAppRegistry is Interaction, AlphaHelper {
     DeployAppRegistry private deployHelper = new DeployAppRegistry();

packages/contracts/scripts/interactions/InteractSpace.s.sol

@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.23;
+
+// interfaces
+import {IDiamondCut} from "@towns-protocol/diamond/src/facets/cut/IDiamondCut.sol";
+
+// libraries
+import {console} from "forge-std/console.sol";
+import {DeployTipping} from "../deployments/facets/DeployTipping.s.sol";
+
+// contracts
+import {Interaction} from "../common/Interaction.s.sol";
+import {AlphaHelper} from "./helpers/AlphaHelper.sol";
+
+contract InteractSpace is Interaction, AlphaHelper {
+    function __interact(address deployer) internal override {
+        // Get the deployed Space diamond address
+        address space = getDeployment("space");
+
+        console.log("Space Diamond:", space);
+
+        // Deploy new TippingFacet implementation
+        console.log("\n=== Deploying TippingFacet ===");
+        vm.setEnv("OVERRIDE_DEPLOYMENTS", "1");
+
+        address tippingFacet = DeployTipping.deploy();
+        console.log("TippingFacet deployed at:", tippingFacet);
+
+        // Add the cut for replacing the existing facet implementation
+        addCut(DeployTipping.makeCut(tippingFacet, FacetCutAction.Replace));
+
+        // Execute the diamond cut without initialization
+        console.log("\n=== Executing Diamond Cut to Replace TippingFacet ===");
+        vm.broadcast(deployer);
+        IDiamondCut(space).diamondCut(baseFacets(), address(0), "");
+
+        console.log("\n=== Diamond Cut Complete ===");
+        console.log("TippingFacet successfully updated on Space diamond");
+    }
+}

packages/contracts/scripts/interactions/InteractSpaceFactory.s.sol

@@ -0,0 +1,71 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.23;
+
+// interfaces
+import {IFeeManager} from "src/factory/facets/fee/IFeeManager.sol";
+import {IPlatformRequirements} from "src/factory/facets/platform/requirements/IPlatformRequirements.sol";
+import {IDiamondCut} from "@towns-protocol/diamond/src/facets/cut/IDiamondCut.sol";
+
+// libraries
+import {FeeTypesLib} from "src/factory/facets/fee/FeeTypesLib.sol";
+import {FeeCalculationMethod} from "src/factory/facets/fee/FeeManagerStorage.sol";
+import {console} from "forge-std/console.sol";
+import {DeployFeeManager} from "../deployments/facets/DeployFeeManager.s.sol";
+
+// contracts
+import {Interaction} from "../common/Interaction.s.sol";
+import {AlphaHelper} from "./helpers/AlphaHelper.sol";
+
+contract InteractSpaceFactory is Interaction, AlphaHelper {
+    function __interact(address deployer) internal override {
+        // Get the deployed SpaceFactory diamond address
+        address spaceFactory = getDeployment("spaceFactory");
+
+        console.log("SpaceFactory Diamond:", spaceFactory);
+
+        // Set fee recipient in PlatformRequirementsFacet
+        console.log("\n=== Setting Fee Recipient in PlatformRequirementsFacet ===");
+        vm.broadcast(deployer);
+        IPlatformRequirements(spaceFactory).setFeeRecipient(deployer);
+        console.log("Fee recipient set to:", deployer);
+
+        // Get fee recipient from PlatformRequirementsFacet
+        address protocolFeeRecipient = IPlatformRequirements(spaceFactory).getFeeRecipient();
+        console.log("Protocol Fee Recipient:", protocolFeeRecipient);
+
+        // Deploy new FeeManagerFacet implementation
+        console.log("\n=== Deploying FeeManagerFacet ===");
+        vm.setEnv("OVERRIDE_DEPLOYMENTS", "1");
+
+        address feeManagerFacet = DeployFeeManager.deploy();
+        console.log("FeeManagerFacet deployed at:", feeManagerFacet);
+
+        // Add the cut for the new facet implementation
+        addCut(DeployFeeManager.makeCut(feeManagerFacet, FacetCutAction.Add));
+
+        // Prepare initialization data with the fee recipient from PlatformRequirementsFacet
+        bytes memory initData = DeployFeeManager.makeInitData(protocolFeeRecipient);
+
+        // Execute the diamond cut with initialization
+        console.log("\n=== Executing Diamond Cut with Initialization ===");
+        vm.broadcast(deployer);
+        IDiamondCut(spaceFactory).diamondCut(baseFacets(), feeManagerFacet, initData);
+
+        console.log("\n=== Diamond Cut Complete ===");
+
+        // Set fee config for tipping
+        console.log("\n=== Setting Fee Config for Tipping ===");
+        vm.broadcast(deployer);
+        IFeeManager(spaceFactory).setFeeConfig(
+            FeeTypesLib.TIP_MEMBER,
+            address(0),
+            FeeCalculationMethod.PERCENT,
+            50, // 0.5% (50 basis points)
+            0,
+            true
+        );
+
+        console.log("Fee config set for TIP_MEMBER: 0.5% (50 bps)");
+        console.log("\n=== Interaction Complete ===");
+    }
+}