11 KiB
Capability Source Matrix
Date: 2026-07-10
Stage: Core business capability roadmap
Evidence index: docs/source-discovery/2026-07-09-n12-pre-zyl-index.md
Schema notes: docs/source-discovery/2026-07-09-n12-pre-zyl-schema-notes.md
Returned live probe: docs/source-discovery/2026-07-10-returned-live-probe-analysis.md
Send connector preflight: docs/source-discovery/2026-07-10-send-connector-preflight.md
Send sandbox gate: docs/source-discovery/2026-07-10-send-sandbox-gate.md
Returned send sandbox analysis: docs/source-discovery/2026-07-10-returned-send-sandbox-analysis.md
Returned send sandbox analysis v2: docs/source-discovery/2026-07-10-returned-send-sandbox-analysis-v2.md
Returned send-sent record diagnostic: docs/source-discovery/2026-07-10-returned-send-sent-record-diagnostic.md
File download mapping v2: docs/source-discovery/2026-07-10-file-download-mapping-v2.md
Send-file sandbox gate: docs/source-discovery/2026-07-10-send-file-sandbox-gate.md
Business goals smoke: docs/reports/2026-07-10-business-goals-smoke.md
R14 release candidate: docs/reports/2026-07-10-r6f-r14-release-candidate.md
Source priority
- Running-client sidecar / in-process connector that reuses the logged-in
IMPlatformClient.exeruntime. - Existing bridge / API / local service.
- Local data, log, cache, or database source.
- UIA helper source through C# WinHelper.
- Network/protocol source.
- Mock source for tests only.
Matrix
| MCP tool | Primary source | Fallback source | Evidence file | Decision status | Next implementation slice |
|---|---|---|---|---|---|
isphere_receive_messages |
decrypted PacketReader.ProcessPacket XMPP <message> stanzas via internal/isphere.EncryptedPacketLogSource; configured by ISPHERE_PACKET_LOG_FILE or ISPHERE_PACKET_LOG_DIR |
copied MsgLib.db message tables through x86 read-only sidecar list_messages selected explicitly by source_preference="msglib_readonly"; decrypted Smark.SendReceive transport stanzas; decrypted SaveToDB Chat_OnMessageArrived traces |
docs/source-discovery/2026-07-09-n12-pre-zyl-schema-notes.md#field-mapping-evidence; docs/source-discovery/2026-07-10-dotnet-wrapper-static-analysis.md; docs/source-discovery/2026-07-10-db-backed-receive-source-design.md; docs/source-discovery/2026-07-10-receive-message-reconciliation-precheck.md; scripts/verify-receive-source-reconciliation.ps1; docs/reports/2026-07-10-business-goals-smoke.md |
C41 wires env-configured explicit MsgLib receive with optional sanitized smoke; R12 adds a pure reconciliation helper with strong/medium match summary while keeping default PacketReader/log-backed routing unchanged; R13/R14 business smoke confirms receive-message basic readiness. | completed for basic digital-employee read; future optional route is switching default auto only after real reconciliation evidence |
isphere_search_contacts |
bare sender/receiver JIDs extracted from normalized log-backed messages loaded from configured PacketReader file or directory source | validated copied MsgLib.db tables: TD_Roster, TD_CustomEffigy, tblRecent, tblChatLevel, tblPersonMsg; decrypted roster/contact stanzas from Smark.SendReceive; UIA helper source if display names are still missing |
docs/source-discovery/2026-07-10-msglib-readonly-schema-extraction.md; internal/isphere/contacts_test.go; internal/tools/isphere_contacts_test.go |
C34 documents optional MsgLib contact display enrichment; R2 adds deterministic exact-match-first ranking, case-insensitive de-duplication across log/MsgLib candidates, and preserves source/raw_ref |
core contact search complete; optional richer fields later |
isphere_search_groups |
decrypted PacketReader.ProcessPacket type="groupchat" stanzas and conference/MUC JIDs loaded from configured PacketReader file or directory source |
validated copied MsgLib.db tables: tblMsgGroupPersonMsg, TD_WorkGroupAuth, tblRecent; UIA helper source if group display names are still missing |
docs/source-discovery/2026-07-10-msglib-readonly-schema-extraction.md; internal/isphere/groups_test.go; internal/tools/isphere_groups_test.go; C9 ignored-log scan: PacketReader 86 groupchat/86 conference hits; Smark 24 groupchat/658 conference/631 muc hits |
C34 documents optional MsgLib group display enrichment; R2 adds deterministic exact-match-first ranking, case-insensitive de-duplication across log/MsgLib candidates, and preserves source/raw_ref |
core group search complete; optional member/owner hierarchy later |
isphere_receive_files |
decrypted PacketReader.ProcessPacket file-transfer message stanzas via internal/isphere.ListFilesFromMessages and isphere_receive_files list mode; configured PacketReader file or directory source; zyl\importal\<hash> cache entries remain unlinked |
MsgLib TD_ReceiveFileRecord safe metadata through explicit copied-DB path; decrypted Smark.SendReceive and SaveToDB traces for file-reference reconciliation; future UIA/client connector for download |
docs/source-discovery/2026-07-09-n12-pre-zyl-schema-notes.md#c12-file-transfer-evidence-precheck; docs/source-discovery/2026-07-10-file-download-mapping-precheck.md; docs/source-discovery/2026-07-10-file-cache-mapping-diagnostic.md; docs/source-discovery/2026-07-10-file-download-mapping-v2.md; docs/reports/2026-07-10-business-goals-smoke.md |
C22 verifies safe file-list contract args; R10 proves resolver scoring with fixture accepted matches; R11 adds structured download preview with blocked/planned status and side-effect flags false; R13/R14 confirms list is ready but real download is still blocked. |
blocked for real download pending accepted real cache mapping and copy gate; list mode is complete |
isphere_send_message |
B-route selected: running-client sidecar / in-process connector, preferring AppContextManager.SendTxtMessageByJid(...) or MessageScheduling.SendChatMessage(...) over the unimplemented SendP2PMessage(...) interface path; current MCP tool exposes preview/dry-run only |
A-route fallback: constrained UI/RPA wrapper only if B cannot pass runtime probe, entrypoint availability, dynamic observation, and idempotent dry-run gates; network/protocol replay remains deferred | docs/source-discovery/2026-07-10-send-message-source-precheck.md; docs/source-discovery/2026-07-10-send-message-connector-selection.md; docs/source-discovery/2026-07-10-send-sidecar-b-first-plan.md; docs/source-discovery/2026-07-10-returned-live-probe-analysis.md; docs/source-discovery/2026-07-10-send-connector-preflight.md; docs/source-discovery/2026-07-10-send-sandbox-gate.md; docs/source-discovery/2026-07-10-returned-send-sandbox-analysis.md; docs/source-discovery/2026-07-10-returned-send-sandbox-analysis-v2.md; docs/source-discovery/2026-07-10-returned-send-sent-record-diagnostic.md; internal/tools/isphere_send_message_test.go; cmd/isphere-capability-smoke/main.go; docs/reports/2026-07-10-business-goals-smoke.md |
R6f-R6l define connector contract, audit/idempotency replay, production gate, B-route shell, strict-v2 package, and explicit production closure. R10a validates two returned sent-record packages as manual-only evidence: operator_observed_success=true, but exact_content_seen_after=false, content_sha256_seen_after=false, after_offline_blocked=true, and production_send_unlock_recommended=false. Preview is complete; production remains blocked. |
blocked until strict machine sent-record/content-hash after evidence passes and a connector is configured |
isphere_send_file |
B-route selected after send-message probe: managed offline-file path through OffLineFileSend.sendFile(), IMPP.Service*.dll IFileTransfer.FileUpload(...), and Chat.sendFileMessage(...); current MCP tool exposes preview/dry-run only |
A-route fallback: constrained UI/RPA upload/send-file flow; native TcpFileTransfer.dll is a later candidate only after managed path is rejected |
docs/source-discovery/2026-07-10-send-message-source-precheck.md; docs/source-discovery/2026-07-10-send-message-connector-selection.md; docs/source-discovery/2026-07-10-send-sidecar-b-first-plan.md; docs/source-discovery/2026-07-10-returned-live-probe-analysis.md; docs/source-discovery/2026-07-10-send-connector-preflight.md; docs/source-discovery/2026-07-10-send-file-sandbox-gate.md; internal/tools/isphere_files_test.go; docs/reports/2026-07-10-business-goals-smoke.md |
R7 registers send-file preview as the tenth MCP tool; R8 adds audit/idempotency duplicate/conflict hardening without raw file paths/content; R9 builds and verifies the online send-file evidence package; R13/R14 confirms preview is ready and production upload remains blocked. | blocked until returned file-send package proves upload/sent evidence and an upload connector is gated |
Stage C entry rule
Open implementation only for the selected row whose evidence maps concrete fields to the MCP output contract. After Stage B2, isphere_receive_messages satisfies the entry rule through decrypted PacketReader.ProcessPacket XML shape.
Stage C first slice recommendation
Start Stage C with a narrow log-backed isphere_receive_messages source abstraction:
- Implement DES/CBC/PKCS7 line decryption for
IMPP.Util.Log.LogSecurityPolicyformat. - Implement a parser for decrypted
PacketReader.ProcessPacketXMPP<message>stanzas. - Normalize only redacted test fixtures into message structs first.
- Add the MCP tool registration after the parser/source abstraction passes tests.
Deferred source work
MsgLib.db has a validated copied read-only open path through the bundled 32-bit System.Data.SQLite.dll and password 123. C27 adds MsgLibReadSidecar as the bounded x86 .NET reader boundary, C28 adds the Go internal/msglib process client, C29 adds bounded display_entities extraction, C30 wires it as optional contact/group MCP enrichment, C31 proves real copied-DB MCP enrichment with sanitized output, C32 reuses it for receive-message display fields, C33 proves that receive display path through a real copied-DB MCP smoke without printing entity values, C34 documents the operator setup/verification path, C35 maps MsgLib message tables to receive-message contract fields without reading row values, C36 adds metadata-only message_sources readiness, C37 defines the bounded DB-backed receive-source design, C38 implements sidecar/Go-wrapper list_messages with sanitized verification, C39 adds a Go adapter from MsgLib list results to the receive-message domain model, C40 adds explicit tool-level msglib_readonly source selection, C41 wires env-configured explicit MsgLib receive with optional sanitized smoke, R1 documents source reconciliation keys, and R2 hardens contact/group search ranking and de-duplication. R6j/R6k confirm the send-message strict-v2 production gate is still not passed; R10a confirms the returned sent-record packages are manual-only evidence and do not unlock production send; R10/R11 define file-download resolver/preview behavior while keeping real copy blocked; R12 adds receive-source reconciliation without changing default routing; R13/R14 publish business-goals smoke and the release-candidate status. The active continuous execution plan docs/superpowers/plans/2026-07-10-r6f-r14-continuous-execution-plan.md is complete through R14; next work is evidence-driven, not local login-dependent.