feat(awooop): gate approved ssh execution

apps/api/migrations/awooop_awoooi_mcp_approval_executor_ssh_gateway_2026-05-13.sql

@@ -0,0 +1,164 @@
+-- T9: approved SSH execution MCP Gateway seed
+-- 目的：讓 Telegram/Approval 已批准的 SSH 修復動作通過 AwoooP Gateway 五閘門。
+-- 邊界：只授權 approval_executor；write/admin 仍需 Gate 5 短效 approval key。
+
+SELECT set_config('app.project_id', 'awoooi', FALSE);
+
+WITH agent_body AS (
+    SELECT jsonb_build_object(
+        'schema_version', 'awooop_agent_contract_v1',
+        'agent_id', 'approval_executor',
+        'display_name', 'Approval Executor',
+        'project_id', 'awoooi',
+        'purpose', 'Approved SSH execution through AwoooP MCP Gateway',
+        'allowed_scopes', jsonb_build_array('read', 'write', 'admin'),
+        'requires_gate5_for_scopes', jsonb_build_array('write', 'admin'),
+        'stage', 't9_ssh_approval_gateway'
+    ) AS body_json
+),
+inserted_revision AS (
+    INSERT INTO awooop_contract_revisions (
+        project_id,
+        contract_family,
+        contract_id,
+        version_major,
+        version_minor,
+        lifecycle_status,
+        body_json,
+        body_hash,
+        body_schema_version,
+        publisher_id,
+        published_at
+    )
+    SELECT
+        'awoooi',
+        'agent',
+        'approval_executor',
+        1,
+        0,
+        'active',
+        body_json,
+        encode(digest(body_json::text, 'sha256'), 'hex'),
+        'v1.0',
+        'migration:t9_ssh_approval_gateway',
+        NOW()
+    FROM agent_body
+    ON CONFLICT (project_id, contract_family, contract_id, version_major, version_minor)
+    DO NOTHING
+    RETURNING revision_id, project_id, contract_family, contract_id
+),
+chosen_revision AS (
+    SELECT revision_id, project_id, contract_family, contract_id
+    FROM inserted_revision
+    UNION ALL
+    SELECT revision_id, project_id, contract_family, contract_id
+    FROM awooop_contract_revisions
+    WHERE project_id = 'awoooi'
+      AND contract_family = 'agent'
+      AND contract_id = 'approval_executor'
+      AND version_major = 1
+      AND version_minor = 0
+      AND lifecycle_status = 'active'
+),
+upsert_pointer AS (
+    INSERT INTO awooop_active_revisions (
+        project_id,
+        contract_family,
+        contract_id,
+        active_revision_id,
+        updated_at
+    )
+    SELECT DISTINCT ON (project_id, contract_family, contract_id)
+        project_id,
+        contract_family,
+        contract_id,
+        revision_id,
+        NOW()
+    FROM chosen_revision
+    ORDER BY project_id, contract_family, contract_id, revision_id
+    ON CONFLICT (project_id, contract_family, contract_id)
+    DO UPDATE SET
+        active_revision_id = EXCLUDED.active_revision_id,
+        updated_at = NOW()
+    RETURNING contract_id
+)
+SELECT 'approval_executor_active_contracts', count(*) FROM upsert_pointer;
+
+WITH gateway_tools(tool_name, description, required_scope) AS (
+    VALUES
+        ('ssh_diagnose', 'SSH host diagnosis read', 'read'),
+        ('ssh_docker_restart', 'Approved Docker container restart over SSH', 'write'),
+        ('ssh_docker_compose_restart', 'Approved Docker Compose service restart over SSH', 'write'),
+        ('ssh_systemctl_restart', 'Approved systemd service restart over SSH', 'write'),
+        ('ssh_clear_docker_logs', 'Approved Docker log truncation over SSH', 'write'),
+        ('ssh_renew_ssl', 'Approved certbot renewal over SSH', 'write'),
+        ('ssh_reload_nginx', 'Approved nginx config test and reload over SSH', 'write'),
+        ('ssh_docker_prune', 'Approved Docker prune over SSH with provider disk guard', 'admin')
+),
+upsert_tools AS (
+    INSERT INTO awooop_mcp_tool_registry (
+        project_id,
+        tool_name,
+        tool_type,
+        description,
+        allowed_scopes,
+        environment_tags,
+        is_active,
+        updated_at
+    )
+    SELECT
+        'awoooi',
+        tool_name,
+        'mcp_server',
+        description,
+        jsonb_build_array(required_scope),
+        '{"env": "prod"}'::jsonb,
+        TRUE,
+        NOW()
+    FROM gateway_tools
+    ON CONFLICT (project_id, tool_name)
+    DO UPDATE SET
+        description = EXCLUDED.description,
+        allowed_scopes = EXCLUDED.allowed_scopes,
+        environment_tags = EXCLUDED.environment_tags,
+        is_active = TRUE,
+        updated_at = NOW()
+    RETURNING tool_id, tool_name, allowed_scopes
+),
+upsert_grants AS (
+    INSERT INTO awooop_mcp_grants (
+        project_id,
+        agent_id,
+        tool_id,
+        granted_by,
+        granted_scopes,
+        expires_at,
+        is_revoked,
+        revoked_at,
+        revoked_by
+    )
+    SELECT
+        'awoooi',
+        'approval_executor',
+        tool_id,
+        'migration:t9_ssh_approval_gateway',
+        allowed_scopes,
+        NULL,
+        FALSE,
+        NULL,
+        NULL
+    FROM upsert_tools
+    ON CONFLICT (project_id, agent_id, tool_id)
+    DO UPDATE SET
+        granted_by = EXCLUDED.granted_by,
+        granted_scopes = EXCLUDED.granted_scopes,
+        expires_at = NULL,
+        is_revoked = FALSE,
+        revoked_at = NULL,
+        revoked_by = NULL
+    RETURNING grant_id
+)
+SELECT
+    'approval_executor_ssh_gateway',
+    (SELECT count(*) FROM upsert_tools) AS tool_rows,
+    (SELECT count(*) FROM upsert_grants) AS grant_rows;

apps/api/migrations/awooop_awoooi_mcp_approval_executor_ssh_gateway_2026-05-13_down.sql

@@ -0,0 +1,43 @@
+-- Rollback for T9 approved SSH execution MCP Gateway seed.
+-- Contract revisions are append-only; rollback revokes approval_executor grants
+-- and deactivates only the write/admin tools introduced here.
+
+SELECT set_config('app.project_id', 'awoooi', FALSE);
+
+UPDATE awooop_mcp_grants
+SET
+    is_revoked = TRUE,
+    revoked_at = NOW(),
+    revoked_by = 'rollback:t9_ssh_approval_gateway'
+WHERE project_id = 'awoooi'
+  AND agent_id = 'approval_executor'
+  AND granted_by = 'migration:t9_ssh_approval_gateway'
+  AND is_revoked = FALSE;
+
+UPDATE awooop_mcp_tool_registry
+SET
+    is_active = FALSE,
+    updated_at = NOW()
+WHERE project_id = 'awoooi'
+  AND tool_name IN (
+      'ssh_docker_restart',
+      'ssh_docker_compose_restart',
+      'ssh_systemctl_restart',
+      'ssh_clear_docker_logs',
+      'ssh_renew_ssl',
+      'ssh_reload_nginx',
+      'ssh_docker_prune'
+  );
+
+DELETE FROM awooop_active_revisions
+WHERE project_id = 'awoooi'
+  AND contract_family = 'agent'
+  AND contract_id = 'approval_executor';
+
+UPDATE awooop_contract_revisions
+SET lifecycle_status = 'revoked'
+WHERE project_id = 'awoooi'
+  AND contract_family = 'agent'
+  AND contract_id = 'approval_executor'
+  AND publisher_id = 'migration:t9_ssh_approval_gateway'
+  AND lifecycle_status = 'active';