┌─────────────────────────────────────────────────────────────┐
│ Freeze Node: Research Committee                              │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ⚠️  This will immediately halt all operations              │
│                                                              │
│  Effects:                                                    │
│  • All active proposals paused                              │
│  • Treasury transfers blocked                               │
│  • New proposals cannot be created                          │
│  • Voting on pending items halted                           │
│                                                              │
│  Reason (required):                                          │
│  ┌─────────────────────────────────────────────────────┐   │
│  │ Security concern - investigating unauthorized        │   │
│  │ access to committee admin wallet.                    │   │
│  └─────────────────────────────────────────────────────┘   │
│                                                              │
│  [ Cancel ]                      [ Freeze Node ]            │
│                                                              │
└─────────────────────────────────────────────────────────────┘

Proposal: "Freeze Research Committee Pending Audit"

Description: |
  This proposal freezes the Research Committee while an
  audit of recent grant disbursements is conducted.

  ## Rationale
  Concerns have been raised about several recent grants
  that may not align with the committee charter.

  ## Duration
  Expected freeze: 2 weeks pending audit results

  ## Next Steps
  1. Audit committee reviews transactions
  2. Findings presented to parent DAO
  3. Unfreeze proposal if cleared
  4. Corrective action if issues found

Actions:
  - type: freeze
    childId: 42
    reason: "Audit of grant disbursements"

import { HierarchyClient } from '@lux/dao-sdk';

const hierarchy = new HierarchyClient(signer);

// Freeze a child node
const tx = await hierarchy.freeze(
  childId,
  'Security concern - investigating unauthorized access'
);

await tx.wait();
console.log('Node frozen');

// Check freeze status
const isFrozen = await hierarchy.isFrozen(childId);
console.log(`Frozen: ${isFrozen}`);

interface IHierarchy {
    /// @notice Emitted when a node is frozen
    event NodeFrozen(
        uint256 indexed nodeId,
        address indexed freezer,
        string reason,
        uint256 timestamp
    );

    /// @notice Emitted when a node is unfrozen
    event NodeUnfrozen(
        uint256 indexed nodeId,
        address indexed unfreezer,
        uint256 timestamp
    );

    /// @notice Freezes a child node
    /// @param childId The child node to freeze
    /// @param reason Documented reason for freezing
    function freeze(uint256 childId, string calldata reason) external;

    /// @notice Unfreezes a previously frozen child
    /// @param childId The child node to unfreeze
    function unfreeze(uint256 childId) external;

    /// @notice Returns true if node is frozen
    function isFrozen(uint256 nodeId) external view returns (bool);

    /// @notice Returns freeze info for a node
    function freezeInfo(uint256 nodeId) external view returns (
        bool frozen,
        address frozenBy,
        uint256 frozenAt,
        string memory reason
    );
}

// Freeze node and all children
await hierarchy.freezeCascade(childId, 'Parent freeze - cascade');

Proposal: "Unfreeze Research Committee - Audit Complete"

Description: |
  The audit has been completed with no issues found.
  This proposal unfreezes the Research Committee.

  ## Audit Results
  - All 15 grants reviewed
  - No policy violations found
  - Recommendations for improved documentation

Actions:
  - type: unfreeze
    childId: 42

const tx = await hierarchy.unfreeze(childId);
await tx.wait();
console.log('Node unfrozen');

// Freeze for 7 days
await hierarchy.freezeWithExpiry(
  childId,
  'Temporary pause for review',
  7 * 24 * 60 * 60  // 7 days in seconds
);

┌─────────────────────────────────────────────────────────────┐
│ Organization Hierarchy                                       │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  ▼ Root DAO                                                 │
│    │                                                         │
│    ├── Treasury Committee         ● Active                  │
│    │                                                         │
│    ├── Research Committee         ⏸ Frozen (3 days)        │
│    │   └── Reason: Audit of grant disbursements             │
│    │                                                         │
│    └── Grants Committee           ● Active                  │
│                                                              │
└─────────────────────────────────────────────────────────────┘

// Listen for freeze events
hierarchy.on('NodeFrozen', (nodeId, freezer, reason, timestamp) => {
  console.log(`Node ${nodeId} frozen by ${freezer}`);
  console.log(`Reason: ${reason}`);

  // Alert stakeholders
  notifyAdmin(nodeId, 'frozen', reason);
});

hierarchy.on('NodeUnfrozen', (nodeId, unfreezer, timestamp) => {
  console.log(`Node ${nodeId} unfrozen by ${unfreezer}`);
});