Skip to content

feat: export explicit msinsight-compatible datasets (#202) - #213

Closed
codeasier wants to merge 1 commit into
fix/issue-201-chain-67e26f4from
fix/issue-202-chain-67e26f4
Closed

codeasier wants to merge 1 commit into
fix/issue-201-chain-67e26f4from
fix/issue-202-chain-67e26f4

Conversation

@codeasier

Copy link
Copy Markdown
Owner

📝 Description

Part of the #198–#205 dependency stack, based on fix/issue-201-chain-67e26f4 (stacked on #201). Merge in issue order; after the parent merges, retarget this PR to main.

  • Physical compatibility-v1 exporter producing explicit msinsight-compatible datasets: positional trace/block/dictionary with inline TEXT callstacks, real consecutive IDs from 0, rejection of sparse/nonzero IDs, OOM/unknown actions and empty/static-only selections; separate pt-snap identity and no-replace publication.
  • Dataset-only immutable readonly transport (mode=ro&immutable=1) for valid closed/checkpointed original v1 WAL output; ALL live/dangling sidecars and aliases are rejected before any SQLite open; artifact bytes stay unchanged.
  • Standalone and native transport and the P0 schema are unchanged; borrowed cache generation signatures include fingerprint and immutable transport.

Commits in this PR:

26 files changed, 1259 insertions(+), 94 deletions(-):

README.md
README_zh.md
docs/en/database.md
docs/en/focus-management.md
docs/en/quickstart.md
docs/en/sharded-snapshotdb.md
docs/zh/database.md
docs/zh/focus-management.md
docs/zh/quickstart.md
docs/zh/sharded-snapshotdb.md
src/pt_snap_cli/cli.py
src/pt_snap_cli/context.py
src/pt_snap_cli/core/context_cache.py
src/pt_snap_cli/core/dataset_contract.py
src/pt_snap_cli/core/dataset_files.py
src/pt_snap_cli/core/dataset_resolver.py
src/pt_snap_cli/core/import_metadata.py
src/pt_snap_cli/core/import_service.py
src/pt_snap_cli/core/models.py
src/pt_snap_cli/core/msinsight_export.py
src/pt_snap_cli/core/query_service.py
tests/core/test_dataset_import.py
tests/core/test_msinsight_export.py
tests/test_contract_cli_api.py
tests/test_dataset_focus.py
tests/test_dataset_import_cli.py

🔗 Related Issue

Refs #202 — deliberately no auto-closing keywords; the issue stays open because GUI/C++/installed-wheel acceptance is human-deferred.

Review comment: #202 (comment)

🧪 Testing

  • Tests added/updated
  • Manual testing completed

Real compatibility-v1 export plus immutable readonly consumption of the authentic closed original artifact (8092 real events, 10 boundary rows, 5 closed-WAL shards) verified locally, with all original file hashes unchanged before/after.

  • Owning focused run: 740 passed.
  • Owning full suite: 1799 passed; combined line+branch coverage 92.15% (raw line 93.75%, raw branch 86.76%); critical floors 91.89/90.27/85.45.
  • basedpyright 0 errors (946 informational warnings); staged governance: 27 passed; post-commit regression: 269 passed.
  • Independent parent verification: fixture provenance 7 + dataset contract/focus/exporter/native/failures/CLI-API/governance 313, all passed; original committed consumer run: 8092 real/10 boundary/5 slices with API/CLI/cache-reuse parity and unchanged hashes.

✅ Checklist

  • Code follows project guidelines
  • Documentation updated (if applicable)
  • No new warnings introduced
  • Changes tested locally

"No new warnings" keeps the pre-existing external pytest-asyncio startup deprecation and existing informational type warnings unchanged rather than hidden; ResourceWarning / PytestUnraisableExceptionWarning remain errors.

Snapshot Runtime Provenance

  • Snapshot provenance evaluation completed when snapshot runtime files change
    No snapshot runtime files change in this PR, so no provenance declaration is required.

📸 Screenshots (if applicable)

Not applicable — no user-interface or C++ changes in this PR.

📋 Additional Notes

Head SHA: 047c7f865a3b410c9447c25c1c67272a4be83938; branch fix/issue-202-chain-67e26f4. All checks above were recorded locally on this exact head; the C++/GUI consumer and installed-wheel profile remain untested and unclaimed.

@codeasier

Copy link
Copy Markdown
Owner Author

Superseded by #216 — the complete #198–#205 chain (including this PR’s commits) was merged into main via #216 (rebase merge) after retargeting. This PR stays as the per-issue review record; the linked issue remains open pending the human-deferred GUI acceptance.

@codeasier codeasier closed this Oct 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant