--- id: CAP-PFM-INT-011 title: Inspect calls and resolve operational problems feature: FEAT-PFM-INT-03 product_area: platform module: integrations revision: 1 status: draft product_intent: proposed implementation_evidence: observed supersedes: - CAP-INT-EXE-009 - CAP-INT-EXE-010 - CAP-INT-EXE-011 - CAP-INT-EXE-012 - CAP-INT-EXE-013 - CAP-INT-EXE-014 - CAP-INT-EXE-016 - CAP-INT-LIB-013 - CAP-INT-LIB-014 - CAP-INT-CAT-016 - CAP-INT-SEC-003 source_sha: services-platform: ad3f6a6582843008ed0f5a17b131878d15829af1 react-console: baf6dae382d6f41dce976c7f848667ccc37e076f intent_sources: - 'services-platform:docs/milestones/INTG-M1-find-install-connect.md#D4' - 'services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.md#M2-D5' - 'services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.md#M2-D6' - 'services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.plan.md#INTG-M2-S11' - 'services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.plan.md#INTG-M2-S13' - 'services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.plan.md#INTG-M2-S15' - 'services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.plan.md#INTG-M2-S16' purpose: 'Operators inspect call records and intervene when an operation can safely be retried, cancelled or resolved.' outcomes: - Stored executions and attempts remain inspectable through archive read-through. - Manual settlement records the operator and informs the application. - Rhythm staff can inspect stuck calls across customers and close a circuit. concepts: - CON-PFM-INT-003 actors: - ACT-PFM-017 - ACT-PFM-018 - ACT-PFM-019 surfaces: - console - api preconditions: [] postconditions: [] permissions: - key: platform.integrations.read where_checked: api scope: tenant - key: platform.integration-executions.operate where_checked: api scope: tenant - key: platform.integration-executions.read where_checked: api scope: tenant - key: hq.integrations.operate where_checked: api scope: global rules: - id: BR-CAP-PFM-INT-011-01 proved_by: [ATS-PFM-INT-011-01, TST-PFM-INT-481, TST-PFM-INT-491] statement: >- Integration readers inspect execution lists, attempts and stored answers; the separately declared executions-read permission is not required by a route or screen. kind: permission enforced_at: - api must_prove: true provenance: test source: >- services-platform:modules/integrations/tests/e2e-adapters/gateway-dummy.adapters.spec.js#lets the tenant read the execution, its attempts and its stored response origin: 'services-platform:docs/milestones/INTG-M1-find-install-connect.md#D4' - id: BR-CAP-PFM-INT-011-02 proved_by: [ATS-PFM-INT-011-02, TST-PFM-INT-491] statement: >- Retry, cancel and resolve require executions-operate separately from connection management; unauthorized callers leave the execution unchanged. kind: permission enforced_at: - api must_prove: true provenance: test source: >- services-platform:modules/integrations/tests/e2e/reader-access.e2e.spec.js#is refused every route that changes something (403) origin: none - id: BR-CAP-PFM-INT-011-03 proved_by: [ATS-PFM-INT-009-16, ATS-PFM-INT-011-03, TST-PFM-INT-541] statement: >- Operator retry accepts only retrying or retryable failed executions with the original request unchanged, queues an attempt on that execution and records the operation. kind: validation enforced_at: - service must_prove: true provenance: test source: >- services-platform:modules/integrations/tests/integration/services/executions/execution-operations.integration.spec.js#refuses a request handed back that is not the one recorded origin: 'services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.plan.md#INTG-M2-S16' - id: BR-CAP-PFM-INT-011-04 proved_by: [] statement: >- The Library leaves Retry disabled and directs retries to the calling application because the original request is not retained for resubmission. kind: policy enforced_at: - console must_prove: true provenance: observed source: 'react-console:components/integrations/execution-detail.tsx:RETRY_UNAVAILABLE' origin: 'services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.md#M2-D5' - id: BR-CAP-PFM-INT-011-05 proved_by: [ATS-PFM-INT-009-13, ATS-PFM-INT-011-04, TST-PFM-INT-481, TST-PFM-INT-543] statement: >- Cancellation of an accepted unattempted execution removes dispatch work and releases its key, cancellation of running asynchronous work requests adapter cancellation and settled work refuses cancellation. kind: lifecycle enforced_at: - service must_prove: true provenance: test source: >- services-platform:modules/integrations/tests/integration/services/executions/invoke-capability.integration.spec.js#cancels an accepted execution before its first attempt, releasing its key and its queued dispatch origin: 'services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.plan.md#INTG-M2-S15' - id: BR-CAP-PFM-INT-011-06 proved_by: [ATS-PFM-INT-009-13, ATS-PFM-INT-010-08, ATS-PFM-INT-011-05, ATS-PFM-INT-011-07, TST-PFM-INT-307, TST-PFM-INT-542, TST-PFM-INT-545] statement: >- Manual resolution requires a needs-attention execution, a succeeded or failed outcome and a note, contacts no provider and records settlement with one applicable application notification. kind: lifecycle enforced_at: - service must_prove: true provenance: test source: >- services-platform:modules/integrations/tests/integration/services/executions/reconciler.integration.spec.js#lets an operator resolve a needs_attention execution by hand, audited, with no call to the provider origin: 'services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.plan.md#INTG-M2-S11' - id: BR-CAP-PFM-INT-011-07 proved_by: [] statement: >- Detail reads fall back to the workspace archive when an execution leaves the thirteen-month online store, preserve its shape and mark it archived, while lists include only online executions. kind: policy enforced_at: - service must_prove: false provenance: test source: >- services-platform:modules/integrations/tests/integration/services/persistence/integration-execution-archives.integration.spec.js#answers the detail with archived true once the row is not online, through the read the routes use origin: none - id: BR-CAP-PFM-INT-011-08 proved_by: [ATS-PFM-INT-009-14, ATS-PFM-INT-011-06, TST-PFM-INT-541] statement: >- Rhythm staff can list attention executions across customers and reset a circuit with workspace history; customer callers cannot perform these staff operations. kind: permission enforced_at: - api - service must_prove: true provenance: test source: >- services-platform:modules/integrations/tests/integration/services/executions/execution-operations.integration.spec.js#lists every tenant’s executions that need attention, in no tenant origin: 'services-platform:docs/milestones/INTG-M2-calls-through-the-gateway.plan.md#INTG-M2-S13' scenarios: - id: SC-CAP-PFM-INT-011-01 given: An operator verifies a stuck payment in the provider’s dashboard. when: They record success with an explanatory note. then: Settlement identifies the operator and supplies Accounting one completion event. provenance: test source: >- services-platform:modules/integrations/tests/integration/services/executions/execution-settlement.integration.spec.js#resolve of a needs_attention async execution writes the completion with the stored answer edge_cases: [] constraints: [] depends_on: - CAP-PFM-INT-009 related: - CAP-PFM-INT-010 journeys: - JNY-PFM-INT-004 open_questions: - OQ-PFM-INT-004 evidence: - >- services-platform source inventory: modules/integrations/services/executions/execution-operations.ts, execution-reads.ts, persistence/integration-execution-archives.ts, aws/api/executions.routes.ts; aws/platform.service.ts (INTEGRATION_EXECUTIONS_PERMISSIONS); rule-level automated test references; docs/milestones/INTG-M2-* (M2-D5, M2-D6). - >- react-console source inventory: components/integrations/activity-screen.tsx, execution-detail.tsx; acceptance journey INT-ACC-0297. - >- Operation coverage: listIntegrationExecutions, getIntegrationExecution, listIntegrationExecutionAttempts, retryIntegrationExecution, cancelIntegrationExecution, resolveIntegrationExecution, listIntegrationExecutionsNeedingAttention, resetIntegrationCircuit. - >- Persistent record coverage: integration_executions, integration_execution_attempts, integration_execution_responses, integration_circuit_states. - 'End-to-end definition inventory: gateway-dummy.adapters.spec.js, reader-access.e2e.spec.js.' controls: [TC-AVL-001, TC-AVL-004, TC-AZ-001, TC-AZ-002, TC-AZ-003, TC-AZ-004, TC-AZ-005, TC-DAT-001, TC-DAT-002, TC-DAT-003, TC-IAM-001, TC-IAM-003, TC-IAM-006, TC-LOG-001, TC-LOG-002, TC-LOG-003, TC-LOG-004, TC-LOG-005, TC-MON-001, TC-MON-002, TC-PI-001, TC-PI-002, TC-PI-004, TC-PI-005, TC-PRV-001, TC-PRV-002, TC-TEN-001, TC-TEN-002, TC-TEN-003, TC-VEN-001, TC-VEN-002, TC-VEN-003] exercised_by: [FAS-PFM-INT-03-01, FAS-PFM-INT-03-02, FAS-PFM-INT-03-03, FAS-PFM-INT-03-04] suites: [TST-PFM-INT-307, TST-PFM-INT-481, TST-PFM-INT-491, TST-PFM-INT-541, TST-PFM-INT-542, TST-PFM-INT-543, TST-PFM-INT-545] --- # Inspect calls and resolve operational problems ## Purpose Operators inspect call records and intervene when an operation can safely be retried, cancelled or resolved. ## How It Works An operator opens Activity or an execution detail to inspect what happened. Attempts, summaries and the selected provider choice support that investigation. Older detail can be recovered from the workspace’s archive. The original application remains responsible for supplying a request when retry is appropriate. Cancellation distinguishes work that never started from work already at the adapter. A person can record the result after checking an uncertain operation outside Rhythm. Staff operations support investigation across customers and circuit recovery. The product should make manual settlement accountable without presenting the Library as a source of new business requests. ## Relationships - Requires run provider operations safely through the gateway to supply the prerequisite configuration or operation. - Connects with determine the result of uncertain or overdue calls through shared integration records.