isphere-ai-bridge/docs/source-discovery/capability-source-matrix.md

Capability Source Matrix

Date: 2026-07-10 Stage: C log-backed receive implementation 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

Source priority

1. Existing bridge / API / local service.
2. Local data, log, cache, or database source.
3. UIA helper source through C# WinHelper.
4. Network/protocol source.
5. 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	decrypted Smark.SendReceive transport stanzas; decrypted SaveToDB Chat_OnMessageArrived traces; copied MsgLib.db through a future x86 read-only sidecar/helper	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	C20 supports and validates the current safe receive-message contract args; C26 validates copied MsgLib.db read-only open/schema, but DB-backed message listing is not implemented yet	C27 bounded x86 MsgLib sidecar/helper contract for safe display/schema reads
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	C26 validates read-only DB open/schema with the recovered wrapper password; product code still needs a bounded x86 sidecar/helper before DB-backed display names can be exposed	C27 bounded x86 MsgLib sidecar/helper contract
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; C9 ignored-log scan: PacketReader 86 groupchat/86 conference hits; Smark 24 groupchat/658 conference/631 muc hits	C26 validates read-only DB open/schema with the recovered wrapper password; product code still needs a bounded x86 sidecar/helper before DB-backed group/member names can be exposed	C27 bounded x86 MsgLib sidecar/helper contract
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	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	C22 verifies safe file-list contract args; no log-to-cache/download mapping yet	defer download mapping; precheck contact/group display-name evidence
isphere_send_message	none validated yet	existing bridge/API/local service preferred; UIA write connector only after internal-sandbox action evidence; network/protocol connector only after protocol discovery	docs/source-discovery/2026-07-10-send-message-source-precheck.md	C15 blocked: contract exists, but no committed bridge/API/local service, helper write op, UIA action chain, or protocol connector is validated	do not implement write behavior; harden existing read source configuration
isphere_send_file	none validated yet	depends on send-message connector plus outbound file/upload evidence	docs/source-discovery/2026-07-10-send-message-source-precheck.md	blocked behind isphere_send_message connector selection and file upload/source policy	defer until send-message connector is validated

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:

1. Implement DES/CBC/PKCS7 line decryption for IMPP.Util.Log.LogSecurityPolicy format.
2. Implement a parser for decrypted PacketReader.ProcessPacket XMPP <message> stanzas.
3. Normalize only redacted test fixtures into message structs first.
4. 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. Because the working provider path is x86 .NET, DB-backed production reads should enter through a bounded sidecar/helper contract rather than direct Go SQLite access.