284313f908
Some checks are pending
Bidi Control Character Guard / bidi-control-guard (push) Waiting to run
Circular Dependency Check / Check for new circular dependencies (push) Waiting to run
Citus Migration Smoke / Combined migrations on single-node Citus (push) Waiting to run
E2E Fresh Install Tests / fresh-install-e2e (push) Waiting to run
ext-v2 guardrails / Run ext-v2 guard and ESLint (push) Waiting to run
Integration Tests / Check for relevant changes (push) Waiting to run
Integration Tests / ${{ (github.event_name == 'schedule' || github.event.inputs.suite == 'full') && 'Full integration suite' || 'Tier-1 integration subset' }} (push) Blocked by required conditions
Mobile checks / Mobile lint + typecheck (push) Waiting to run
Mobile checks / Mobile unit tests (push) Waiting to run
Mobile checks / Mobile dependency audit (report) (push) Waiting to run
Mobile checks / Mobile reproducibility checks (push) Waiting to run
Secrets guard (env backups) / Ensure no tracked env backup files (push) Waiting to run
Temporal Readiness / fast-readiness (push) Waiting to run
Temporal Readiness / docker-parity (push) Waiting to run
TypeScript Type Check / Nx affected typecheck (push) Waiting to run
Unit Tests / Skipped-test budget (push) Waiting to run
Unit Tests / Nx affected unit tests (push) Waiting to run
Unit Tests / Server unit coverage (informational) (push) Waiting to run
Validate Tenant Management Schema / Check for relevant changes (push) Waiting to run
Validate Tenant Management Schema / Validate Tenant Management Schema (push) Blocked by required conditions
EE Workflows Build Guard / ee-workflows-build-guard (push) Waiting to run
Excluded: .git, node_modules, secrets/, compose.env, assemblyscript tgz Source: /opt/alga-psa on psa.joliet.tech
362 lines
12 KiB
JSON
362 lines
12 KiB
JSON
[
|
|
{
|
|
"id": "F001",
|
|
"description": "Add getLatestTeamsConversationReferenceImpl({ tenant, microsoftUserId, conversationType? }) in teamsConversationReferences.ts that selects the newest row by last_activity_at DESC, tenant-scoped, with optional conversation_type filter (default 'personal').",
|
|
"implemented": true,
|
|
"commitGroup": "conversation-reader",
|
|
"prdRefs": [
|
|
"Data Model / Integration Notes",
|
|
"Flow B"
|
|
]
|
|
},
|
|
{
|
|
"id": "F002",
|
|
"description": "Reader returns a typed result and is null-safe: returns null (never throws) when no matching conversation reference exists, so callers can map to a 'message the bot first' skip reason.",
|
|
"implemented": true,
|
|
"commitGroup": "conversation-reader",
|
|
"prdRefs": [
|
|
"Flow B"
|
|
]
|
|
},
|
|
{
|
|
"id": "F003",
|
|
"description": "Map PSA user id -> microsoft_user_id by reusing resolveTeamsRecipientLink(tenant, userId).providerAccountId (verified to equal the AAD oid stored as teams_conversation_references.microsoft_user_id). No new mapping helper; export/reuse resolveTeamsRecipientLink and feed its providerAccountId into the F001 reader.",
|
|
"implemented": true,
|
|
"commitGroup": "conversation-reader",
|
|
"prdRefs": [
|
|
"Data Model / Integration Notes"
|
|
]
|
|
},
|
|
{
|
|
"id": "F004",
|
|
"description": "Export the conversation-reference reader, resolver, and their TypeScript record/result types from the microsoft-teams package lib index so server actions can import them.",
|
|
"implemented": true,
|
|
"commitGroup": "conversation-reader",
|
|
"prdRefs": [
|
|
"Data Model / Integration Notes"
|
|
]
|
|
},
|
|
{
|
|
"id": "F005",
|
|
"description": "Add sendTeamsTestMessageImpl(input, ctx) server action behind withAuth, gated on the same permission as saveTeamsIntegrationSettingsImpl, returning a structured TeamsTestMessageResult.",
|
|
"implemented": true,
|
|
"commitGroup": "test-message",
|
|
"prdRefs": [
|
|
"Goals",
|
|
"Flow B"
|
|
]
|
|
},
|
|
{
|
|
"id": "F006",
|
|
"description": "Test message resolves Teams availability; when addon is inactive it returns a skipped result (reason 'addon_inactive') and records a skipped delivery row without attempting send.",
|
|
"implemented": true,
|
|
"commitGroup": "test-message",
|
|
"prdRefs": [
|
|
"Flow B",
|
|
"Non-Goals (Explicit)"
|
|
]
|
|
},
|
|
{
|
|
"id": "F007",
|
|
"description": "Test message returns skipped ('integration_inactive' or 'capability_disabled') when the integration row is not active or the personal_bot capability is disabled.",
|
|
"implemented": true,
|
|
"commitGroup": "test-message",
|
|
"prdRefs": [
|
|
"Flow B"
|
|
]
|
|
},
|
|
{
|
|
"id": "F008",
|
|
"description": "Test message returns skipped ('bot_not_configured') when isBotConnectorConfigured() is false, without attempting a Bot Framework token or send.",
|
|
"implemented": true,
|
|
"commitGroup": "test-message",
|
|
"prdRefs": [
|
|
"Flow B",
|
|
"Risks / Open Questions"
|
|
]
|
|
},
|
|
{
|
|
"id": "F009",
|
|
"description": "Test message resolves the calling admin's Microsoft user linkage; when missing returns skipped ('missing_user_linkage').",
|
|
"implemented": true,
|
|
"commitGroup": "test-message",
|
|
"prdRefs": [
|
|
"Flow B"
|
|
]
|
|
},
|
|
{
|
|
"id": "F010",
|
|
"description": "Test message looks up the latest personal conversation reference via the F001 reader; when missing returns skipped ('missing_conversation_reference') with an actionable hint to message the bot first.",
|
|
"implemented": true,
|
|
"commitGroup": "test-message",
|
|
"prdRefs": [
|
|
"Flow B",
|
|
"UX / UI Notes"
|
|
]
|
|
},
|
|
{
|
|
"id": "F011",
|
|
"description": "Test message builds a synthetic test activity (card + text 'Alga PSA Teams test message') and calls sendBotActivity({ serviceUrl, conversationId, activity }) from the stored conversation reference.",
|
|
"implemented": true,
|
|
"commitGroup": "test-message",
|
|
"prdRefs": [
|
|
"Flow B",
|
|
"Data Model / Integration Notes"
|
|
]
|
|
},
|
|
{
|
|
"id": "F012",
|
|
"description": "Test message records a teams_notification_deliveries row for every outcome (skipped/sent/failed) reusing the existing recorder: category='test', destination_type='bot_test', destination_id=microsoft_user_id, idempotency_key includes an attempt nonce so repeated tests each record.",
|
|
"implemented": true,
|
|
"commitGroup": "test-message",
|
|
"prdRefs": [
|
|
"Data Model / Integration Notes",
|
|
"Risks / Open Questions"
|
|
]
|
|
},
|
|
{
|
|
"id": "F013",
|
|
"description": "Define TeamsDiagnosticsStep and TeamsDiagnosticsReport types (status: 'pass'|'warn'|'fail'|'skip', id, title, detail, durationMs, data?, error?, plus overallStatus and recommendations: string[]), mirroring Microsoft365DiagnosticsReport.",
|
|
"implemented": true,
|
|
"commitGroup": "diagnostics",
|
|
"prdRefs": [
|
|
"Data Model / Integration Notes",
|
|
"Flow A"
|
|
]
|
|
},
|
|
{
|
|
"id": "F014",
|
|
"description": "Add runTeamsDiagnosticsImpl(input, ctx) with a runStep(id, title, fn) helper that captures status/duration/error per step and accumulates recommendations, mirroring runMicrosoft365Diagnostics aggregation.",
|
|
"implemented": true,
|
|
"commitGroup": "diagnostics",
|
|
"prdRefs": [
|
|
"Flow A"
|
|
]
|
|
},
|
|
{
|
|
"id": "F015",
|
|
"description": "Diagnostics check: addon entitlement active via getTeamsAvailability — fail with an actionable recommendation when addon_required/ce_unavailable.",
|
|
"implemented": true,
|
|
"commitGroup": "diagnostics",
|
|
"prdRefs": [
|
|
"Flow A"
|
|
]
|
|
},
|
|
{
|
|
"id": "F016",
|
|
"description": "Diagnostics check: teams_integrations row exists and install_status='active' — fail when missing, warn when present but not active.",
|
|
"implemented": true,
|
|
"commitGroup": "diagnostics",
|
|
"prdRefs": [
|
|
"Flow A"
|
|
]
|
|
},
|
|
{
|
|
"id": "F017",
|
|
"description": "Diagnostics check: enabled_capabilities include personal_bot and activity_notifications — warn (with which are missing) otherwise.",
|
|
"implemented": true,
|
|
"commitGroup": "diagnostics",
|
|
"prdRefs": [
|
|
"Flow A"
|
|
]
|
|
},
|
|
{
|
|
"id": "F018",
|
|
"description": "Diagnostics check: selected Microsoft profile exists, is not archived, and has a client_secret_ref — fail otherwise.",
|
|
"implemented": true,
|
|
"commitGroup": "diagnostics",
|
|
"prdRefs": [
|
|
"Flow A"
|
|
]
|
|
},
|
|
{
|
|
"id": "F019",
|
|
"description": "Diagnostics check: package metadata present and base URL resolvable — fail when no package generated, warn when base URL missing.",
|
|
"implemented": true,
|
|
"commitGroup": "diagnostics",
|
|
"prdRefs": [
|
|
"Flow A"
|
|
]
|
|
},
|
|
{
|
|
"id": "F020",
|
|
"description": "Diagnostics check: bot connector credentials configured (isBotConnectorConfigured) — fail with the TEAMS_BOT_APP_* env recommendation when absent.",
|
|
"implemented": true,
|
|
"commitGroup": "diagnostics",
|
|
"prdRefs": [
|
|
"Flow A",
|
|
"Risks / Open Questions"
|
|
]
|
|
},
|
|
{
|
|
"id": "F021",
|
|
"description": "Diagnostics check: the calling admin's Microsoft user linkage present — warn with 'link your Microsoft account' recommendation when missing.",
|
|
"implemented": true,
|
|
"commitGroup": "diagnostics",
|
|
"prdRefs": [
|
|
"Flow A"
|
|
]
|
|
},
|
|
{
|
|
"id": "F022",
|
|
"description": "Diagnostics check: a conversation reference exists for the calling admin — warn with 'open the bot and message it once' recommendation when missing.",
|
|
"implemented": true,
|
|
"commitGroup": "diagnostics",
|
|
"prdRefs": [
|
|
"Flow A",
|
|
"UX / UI Notes"
|
|
]
|
|
},
|
|
{
|
|
"id": "F023",
|
|
"description": "Diagnostics check: recent delivery health — read most recent success and most recent failure from teams_notification_deliveries (tenant-scoped); warn when the latest attempt failed and surface the error_code/message.",
|
|
"implemented": true,
|
|
"commitGroup": "diagnostics",
|
|
"prdRefs": [
|
|
"Flow A",
|
|
"User Value"
|
|
]
|
|
},
|
|
{
|
|
"id": "F024",
|
|
"description": "Aggregate overallStatus (fail if any fail, else warn if any warn, else pass), dedupe recommendations, and expose runTeamsDiagnostics = withAuth(runTeamsDiagnosticsImpl) gated on the teams settings permission.",
|
|
"implemented": true,
|
|
"commitGroup": "diagnostics",
|
|
"prdRefs": [
|
|
"Flow A",
|
|
"Goals"
|
|
]
|
|
},
|
|
{
|
|
"id": "F025",
|
|
"description": "Add a 'Diagnostics & Test Message' Card section to TeamsIntegrationSettings.tsx below the existing config/package cards.",
|
|
"implemented": true,
|
|
"commitGroup": "settings-ui",
|
|
"prdRefs": [
|
|
"UX / UI Notes"
|
|
]
|
|
},
|
|
{
|
|
"id": "F026",
|
|
"description": "Wire a 'Run diagnostics' button that calls runTeamsDiagnostics with loading and error state handling.",
|
|
"implemented": true,
|
|
"commitGroup": "settings-ui",
|
|
"prdRefs": [
|
|
"UX / UI Notes",
|
|
"Flow A"
|
|
]
|
|
},
|
|
{
|
|
"id": "F027",
|
|
"description": "Render diagnostics steps as a list, each with a status badge (pass=green, warn=amber, fail=red, skip=grey) plus title and detail text.",
|
|
"implemented": true,
|
|
"commitGroup": "settings-ui",
|
|
"prdRefs": [
|
|
"UX / UI Notes"
|
|
]
|
|
},
|
|
{
|
|
"id": "F028",
|
|
"description": "Render the aggregated recommendations as a bullet list when the report includes any.",
|
|
"implemented": true,
|
|
"commitGroup": "settings-ui",
|
|
"prdRefs": [
|
|
"UX / UI Notes"
|
|
]
|
|
},
|
|
{
|
|
"id": "F029",
|
|
"description": "Wire a 'Send test message' button that calls sendTeamsTestMessage with its own loading state.",
|
|
"implemented": true,
|
|
"commitGroup": "settings-ui",
|
|
"prdRefs": [
|
|
"UX / UI Notes",
|
|
"Flow B"
|
|
]
|
|
},
|
|
{
|
|
"id": "F030",
|
|
"description": "Render the test-message result: success confirmation on sent; friendly mapped text for each skip reason (including 'missing_conversation_reference' -> open the bot and message it first) and for failures.",
|
|
"implemented": true,
|
|
"commitGroup": "settings-ui",
|
|
"prdRefs": [
|
|
"UX / UI Notes",
|
|
"Flow B"
|
|
]
|
|
},
|
|
{
|
|
"id": "F031",
|
|
"description": "Surface the recent delivery summary (last success / last failure) from the diagnostics report data in the panel.",
|
|
"implemented": true,
|
|
"commitGroup": "settings-ui",
|
|
"prdRefs": [
|
|
"UX / UI Notes",
|
|
"Flow A"
|
|
]
|
|
},
|
|
{
|
|
"id": "F032",
|
|
"description": "Disable the diagnostics and test-message buttons when the addon is missing or the integration is not active, consistent with the existing canPersist gating.",
|
|
"implemented": true,
|
|
"commitGroup": "settings-ui",
|
|
"prdRefs": [
|
|
"UX / UI Notes",
|
|
"Non-Goals (Explicit)"
|
|
]
|
|
},
|
|
{
|
|
"id": "F033",
|
|
"description": "Add i18n keys for the diagnostics section title/description, the two button labels, and the four status labels, with defaultValue fallbacks.",
|
|
"implemented": true,
|
|
"commitGroup": "i18n",
|
|
"prdRefs": [
|
|
"UX / UI Notes"
|
|
]
|
|
},
|
|
{
|
|
"id": "F034",
|
|
"description": "Add i18n keys for each diagnostics check title, each skip/fail reason, and each recommendation string, with defaultValue fallbacks.",
|
|
"implemented": true,
|
|
"commitGroup": "i18n",
|
|
"prdRefs": [
|
|
"UX / UI Notes"
|
|
]
|
|
},
|
|
{
|
|
"id": "F035",
|
|
"description": "Ensure the new keys exist in every locale file used by integrations settings, mirroring the existing integrations.teams.settings.* key placement.",
|
|
"implemented": true,
|
|
"commitGroup": "i18n",
|
|
"prdRefs": [
|
|
"UX / UI Notes"
|
|
]
|
|
},
|
|
{
|
|
"id": "F036",
|
|
"description": "Export runTeamsDiagnostics and sendTeamsTestMessage from the microsoft-teams package action index, mirroring teamsObservabilityActions.",
|
|
"implemented": true,
|
|
"commitGroup": "wiring",
|
|
"prdRefs": [
|
|
"Data Model / Integration Notes"
|
|
]
|
|
},
|
|
{
|
|
"id": "F037",
|
|
"description": "Re-export/register the two actions where packages/integrations consumes EE Teams actions so TeamsIntegrationSettings can import them through the established boundary.",
|
|
"implemented": true,
|
|
"commitGroup": "wiring",
|
|
"prdRefs": [
|
|
"Data Model / Integration Notes"
|
|
]
|
|
},
|
|
{
|
|
"id": "F038",
|
|
"description": "Rebuild @alga-psa/microsoft-teams (tsup -> dist) so the server resolves the new exports at runtime (per observability-loop F045).",
|
|
"implemented": true,
|
|
"commitGroup": "wiring",
|
|
"prdRefs": [
|
|
"Data Model / Integration Notes"
|
|
]
|
|
}
|
|
]
|