admin/isphere-ai-bridge
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
89d7f65b45c84406717cb3560cdaa82a92ad5500
isphere-ai-bridge/docs/source-discovery/capability-source-matrix.md
zhaoyilun 89d7f65b45 chore: package send recording and capability tests
2026-07-10 14:36:15 +08:00

9.9 KiB
Raw Blame History

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

Source priority

  1. Running-client sidecar / in-process connector that reuses the logged-in IMPlatformClient.exe runtime.
  2. Existing bridge / API / local service.
  3. Local data, log, cache, or database source.
  4. UIA helper source through C# WinHelper.
  5. Network/protocol source.
  6. 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 C20 supports and validates the current safe receive-message contract args; C32 wires optional MsgLib display metadata into receive-message sender_name and conversation.display_name; C33 proves this path through a real copied-DB MCP smoke; C35 maps MsgLib message tables; C36 adds metadata-only message_sources; C37 defines bounded list_messages design; C38 implements sidecar/Go-wrapper list_messages with sanitized copied-DB verification; C39 adds a Go adapter from ListMessages to the receive-message domain model; C40 adds tool-level explicit msglib_readonly source selection; C41 wires env-configured MsgLib receive source and optional copied-DB smoke; R1 precheck keeps auto PacketReader/log-backed until a future reconciliation helper is implemented future receive reconciliation helper after R2/R3
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 C22 verifies safe file-list contract args; R3 confirms list metadata is available; R3b diagnostic finds 0 current cache/archive matches, so R4 remains blocked blocked pending better cache evidence or UI/client download connector
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; internal/tools/isphere_send_message_test.go; cmd/isphere-capability-smoke/main.go R6c prepares the online sandbox evidence package because local login is unavailable. runs/send-sandbox-gate-package.zip now contains a consolidated recording suite for one manual sandbox send; runs/send-capability-test-package.zip separately verifies the offline-safe 9-tool surface, fixture-backed receive/search/file-list behavior, send preview, and production_send_enabled=false. No returned online send evidence has been analyzed yet. Production remains blocked. next: R6d returned sandbox evidence intake after user returns the package
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(...) 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-sandbox-gate.md R6a/C31 metadata confirms FileTransfer.FileUpload, FileTransfer.AsynFileUpload, OffLineFileSend.sendFile, and Chat.sendFileMessage candidates. File-send remains blocked behind returned message-send sandbox evidence plus later upload/file-message dry-run evidence. next: wait for R6d, then file-send upload preflight

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. 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. R6c now has both the consolidated online recording package and the offline capability-test package. The active roadmap is docs/superpowers/plans/2026-07-10-core-business-capabilities-roadmap.md; next step is R6d returned sandbox evidence intake after the online package is returned.

Reference in New Issue View Git Blame Copy Permalink