diff --git a/docs/README.md b/docs/README.md index 0449598..668f4ee 100644 --- a/docs/README.md +++ b/docs/README.md @@ -14,7 +14,7 @@ | Agent skills | [en/skills.md](en/skills.md) | | Database Schema | [en/database.md](en/database.md) | | Sharded protocols, native/compatible imports and dataset queries | [en/sharded-snapshotdb.md](en/sharded-snapshotdb.md) | -| Interoperability acceptance, performance and pending GUI checklist | [en/interop-acceptance.md](en/interop-acceptance.md) | +| Interoperability acceptance, performance and recorded GUI results | [en/interop-acceptance.md](en/interop-acceptance.md) | | Import metadata | [en/database.md](en/database.md) | | SnapshotAnalyzer API | [en/snapshot-analyzer-api.md](en/snapshot-analyzer-api.md) | | ResultMapper API | [en/result-mapper-api.md](en/result-mapper-api.md) | @@ -33,7 +33,7 @@ | Agent skill | [zh/skills.md](zh/skills.md) | | 数据库格式 | [zh/database.md](zh/database.md) | | 分片协议、原生/兼容导入与数据集查询 | [zh/sharded-snapshotdb.md](zh/sharded-snapshotdb.md) | -| 双向互操作验收、性能与待验收 GUI 清单 | [zh/interop-acceptance.md](zh/interop-acceptance.md) | +| 双向互操作验收、性能与真实 GUI 记录 | [zh/interop-acceptance.md](zh/interop-acceptance.md) | | 导入 metadata | [zh/database.md](zh/database.md) | | SnapshotAnalyzer API | [zh/snapshot-analyzer-api.md](zh/snapshot-analyzer-api.md) | | ResultMapper API | [zh/result-mapper-api.md](zh/result-mapper-api.md) | diff --git a/docs/en/interop-acceptance.md b/docs/en/interop-acceptance.md index 2725d49..82749c3 100644 --- a/docs/en/interop-acceptance.md +++ b/docs/en/interop-acceptance.md @@ -7,9 +7,11 @@ The ONLY upstream target is **Ascend/msinsight@101f65b877a267ffd5f66ea3834706057ba243e5**. Protocol/schema validation, isolated source-function checks, synthetic CI, reading an actual original-producer artifact, and actual GUI/C++ consumption are -DIFFERENT evidence layers. None implies the next. **GUI is human-deferred, -pending/not-run**; the issue stays open. The existing pending note is -[#205](https://github.com/codeasier/pt-snap-cli/issues/205#issuecomment-5987264017). +DIFFERENT evidence layers. None implies the next. **The bounded real GUI/C++ and +original-producer reverse acceptance passed on 2026-10-11**, as recorded below. +The earlier [#205 pending note](https://github.com/codeasier/pt-snap-cli/issues/205#issuecomment-5987264017) +records the historical human-deferred stage; it is not the current run status. +This evidence does not itself close an issue or approve a release. The acceptance tools are original interface-facts/reference code, not vendor copies. Fixed [producer schema](https://api.github.com/repos/Ascend/msinsight/git/blobs/1fe50a5136f85365db55f4632d58f3cf7090431e), @@ -21,12 +23,12 @@ are separately CC BY 4.0, not automatically covered by this project's MIT lineag A port needs snapshot provenance/PR decisions and retained notices. Executable pickle trust is a SEPARATE fixture review; no new committed pickle is added here. -## Forward chain: trusted source → physical export → FUTURE GUI +## Forward chain: trusted source → physical export → real GUI 1. Review/trust the source separately: pickle is executable input, not a sandbox. Record exact source SHA256, size, selected device and capacity. Default import stays single-db; native and compatible outputs are explicit distinct modes. -2. Use an ABSENT destination. For the future original-source GUI entrance, the +2. Use an ABSENT destination. For the original-source GUI entrance, the compatible artifact must be adjacent to the SAME original pickle: ```bash @@ -48,9 +50,10 @@ pickle trust is a SEPARATE fixture review; no new committed pickle is added here preserving multiplicity; validate each artifact's own token stability. This does not prove cross-producer negative object identity. Never deduplicate by address, rewrite IDs, or patch the fixed producer to force equality. -4. **Later, after explicit human authorization**, open the same original pickle - using the exact recorded real GUI build. Complete the checklist below. Physical - equality and salted-hash equality are NOT GUI cache-reuse acceptance. +4. With explicit authorization for a real acceptance run, open the same original + pickle using the exact recorded real GUI build. Record the evidence below. + Physical equality and salted-hash equality alone are NOT GUI cache-reuse + acceptance. The 2026-10-11 run separately observed the real consumer. ## Reverse chain: existing original artifact → complete focus → canonical reference @@ -96,7 +99,7 @@ be NEW, canonical, non-symlink and disjoint from inputs. It contains a new physi canonical-reference DB, report and isolated test project focus, never modifies external focus/cache and never automatically downloads/executes a producer. -The small independent oracle materializes bounded rows in memory (32 MiB files, +The independent physical SQL reference materializes bounded rows in memory (32 MiB files, 256 entries, 64 slices, 20000 physical trace rows INCLUDING boundaries, 20000 block rows, 256 dictionary rows/shard, 1 MiB JSON, optional 2 MiB source). These are reference-tool limits, NOT a product RSS contract. It compares all real columns, @@ -104,6 +107,9 @@ full completed-free/allocation source identity, canonical lifetimes/latest state terminal candidates, global earliest-tie peaks/full and shard ranges, selected active sets/bytes, all-action stack statistics and global sort/page/exact totals. The canonical standalone reference is NOT another original producer run. +Active-attribution comparisons reuse the product's standalone query implementation +on that reference DB; they are a differential check, not a wholly independent +second oracle for active attribution. The console chain verifies identical interpreter/API source across its isolated CWD, then actual focus/query/report and normalized CLI/API scope/coverage. Selected points/ranges are recorded, NOT an exhaustive all-event active-set proof. @@ -180,21 +186,96 @@ compatible inline text. Query hashing/scans may dominate. No unmeasured speed/RS disk-saving promise. The existing original run's single cold wall0.160545s has NO RSS/phase measurements and is not a controlled comparative performance baseline. -## FUTURE GUI checklist — every row PENDING / NOT-RUN - -- [ ] Exact real version/build/commit/package SHA, interpreter/server provenance, - environment and exact startup/open command; don't invent executable syntax. -- [ ] SAME original pickle path/hash/size and adjacent complete artifact; all - manifest/member/checksum inventories BEFORE and AFTER opening, source unchanged. -- [ ] UP_TO_DATE/cache-reuse logs AND absence of producer/parser script invocation, - with process/log observation that could detect rebuilding; hash alone is not proof. -- [ ] Curves/counters/ranges/real IDs excluding boundaries at recorded points; - blocks/sizes/states and cross-shard allocation/free_completed source/details. -- [ ] Ordered-frame claims only where actual recognized coverage exists; original - text-only artifacts remain text-only. Record unavailable views honestly. -- [ ] Inspect derived allocation-cache mutation separately: it may change DB bytes - without producer rerun and invalidate ptSnap ownership attestation. Preserve both - inventories, never repair/overwrite an original cache just to make reuse pass. - -Synthetic/schema/original-artifact checks and static skill grades cannot tick -these rows. No GUI/C++ execution/compile occurred in this acceptance package. +## Recorded real acceptance — 2026-10-11 + +The [sanitized machine-readable receipt](../interop-acceptance-2026-10-11.json) +records exact identities, dependency pins, inventories and bounded results. It is +an observation summary, not a distributable original artifact or a replacement +for reviewing receipt authenticity. No screenshots, raw protocol call stacks, +private paths, accounts or full logs are included. + +### Build and input identity + +- Fixed upstream: `101f65b877a267ffd5f66ea3834706057ba243e5`; clean tracked source. + Linux x86_64, GCC 14.2.0, CMake 3.31.6, Ninja 1.11.1.4, Node 24.19.0. + Only the production framework and Leaks bundles plus `profiler_server` were + built. Frontend installation used pnpm 11.25.0, the frozen lockfile, original + hoist patterns, strict SSL and disabled lifecycle scripts. No source/lock edits. +- Server SHA256: `7b1c2325d88d709ad111faad458422099fd34b7f574ba557f9e0643a0108b64f`. + The staged server ran as `./profiler_server --wsPort=9000 --wsHost=127.0.0.1` + with its directory on `LD_LIBRARY_PATH` and process tracing enabled. + Shared-library hashes and libuv/uSockets/uWebSockets/RapidJSON/SQLite pins are + in the receipt. RapidJSON's recorded local commit is not an upstream historical + dependency pin; this is not byte-identical vendor-release reproduction. +- Noneditable wheel: `0.0.post1.dev1`, SHA256 + `884a13f08f65e866cd106c0a80f218d289269da10e9f623f1b0779cafdc67f9a`; + all 110 installed package members matched. Its source tree corresponds to + `cd1aac689f653e2701334d26ae1f25489f7f5af9`, not a claim that later main commits + or a published PyPI release were exercised. +- Reviewed `snapshot_expandable.pkl`: 581140 bytes, SHA256 + `3afc9d1c5ef4ca4b417e58c0830e9eb8a913eb9459f4088b8c66c22325c68c40`; + device 0, 2000 events per slice. Fixture provenance tests passed 7/7 before + deserialization. Pickle execution still requires independent trust review. + +### Forward GUI/C++ results and preservation + +- [x] The real framework/Leaks GUI opened the original pickle with its adjacent + complete five-shard pt-snap export. Window transitions 1 → 2 → 1 → 4, lifetime + curves, reserved line and five-window overview rendered. Window 4 displayed the + allocated/active peak at event 7430 (597642080 bytes = 569.956 MiB; the GUI + label reads `569.956 MB`). +- [x] The server logged `UP_TO_DATE` (state 4). Full launch-to-termination process + tracing recorded one executable launch, the server itself, and no parser/Python + producer execution. The separate reverse-producer run is outside this trace. +- [x] Block 1669 (37632 bytes) resolved allocation 1669 in Window 1 from Window 2, + and completed-free 2605 in Window 2 from Window 1. The block-details automatic + association of free-requested event 2604 queried only the current shard: absent + from Window 1 detail, present in Window 2. This does not imply that direct lookup + by event ID cannot cross shards; that separate path was not additionally queried + for 2604 in this run. The observed block-details limitation was not patched. +- [x] The same loaded real C++ server passed 16 query cases / 167 typed assertions, + with zero failures/query errors. Protocol samples covered the first two slices, + curve/reserved endpoints, events 1999/2000, clipped block ranges and cross-shard + details. At 1999/2000 the state had 801/802 blocks and 419457080/419465784 allocated + bytes. `maxSize` is the reserved display scale, not an allocated peak. +- [x] Original table schemas and every original row were preserved in all five + runtime shards; both source copies and the runtime manifest were unchanged. + **Runtime DB bytes changed:** the consumer added `memory_allocation_cache_v1_0` + to each shard, invalidating the unchanged manifest's ptSnap member attestation. + The separate pre-GUI export stayed byte-identical. No repair/reimport was used + to hide the mutation. Cache reuse does not mean the opened artifact is immutable. +- [x] Actual call stacks remained text-only; no ordered frames were reconstructed. + GUI/server/private HTTP services were stopped after the run. + +### Reverse results and limits + +A separate unmodified fixed producer invocation finalized five shards with 8092 +real events. The installed wheel passed all eleven built-in templates, physical +SQL/reference comparisons and actual isolated CLI/API focus/query/report checks. +Counts: 10 excluded boundaries, 6412 physical block rows, 3219 canonical lifecycles, +3193 repeated rows, 325 terminal candidates and 60 all-action stack groups. +Twelve recorded event points and six ranges were selected; active sets were not +exhaustively checked at every event. Active attribution reuses standalone product +queries on the canonical DB, so it is not a fully independent second oracle. + +Forward/pre-GUI versus original-producer physical comparison passed all nine +real-event columns, schemas/dictionaries, exact real IDs and negative-token +six-field/state multisets. Negative identity does not transfer between producers. +Original-producer metadata correctly returned `unavailable` / `metadata_missing`; +frames remained text-only. The reverse original artifact, forward comparison copy, +source bytes and producer sources remained unchanged under read-only analysis. + +The runner in [benchmarks/interop_acceptance.py](../../benchmarks/interop_acceptance.py) +only reads existing artifacts; its `GUI=human-deferred/pending/not-run` and +`original_producer=not-run by this runner` fields describe that tool's own scope. +They are retained, not rewritten as if the runner executed the GUI or producer. +The dated receipt combines the separately observed stages. Use the commands above +and [fixture review](../../tests/fixtures/AGENTS.md) to repeat the bounded read-only +comparison with a separately reviewed receipt; hashes alone cannot recreate its +original manifest paths or authenticate execution. + +This run does not cover all plugins, a shipped desktop package, GPU/NPU execution, +multiple devices, exhaustive GUI interactions, fault injection or performance +improvements. Broader failure/rollback scenarios still require the owning tests +listed above. Historical synthetic checks and performance observations remain +separate evidence; this docs-only record introduces no runtime behavior change. diff --git a/docs/en/sharded-snapshotdb.md b/docs/en/sharded-snapshotdb.md index 4bcb719..53bf44a 100644 --- a/docs/en/sharded-snapshotdb.md +++ b/docs/en/sharded-snapshotdb.md @@ -480,11 +480,14 @@ one copy per distinct stack. Existing native interning remains available. Conver temporarily holds both layouts and can leave free SQLite pages; capacity is not an RSS/registry/block/disk bound. No optional frame enhancement is emitted. -**GUI remains pending/not run.** Fixed-source parser checks complete manifest, +**The artifact-only runner still reports its own GUI stage as pending/not-run.** +The separate fixed-version real GUI/C++ acceptance on 2026-10-11 is recorded in +[interoperability acceptance](interop-acceptance.md); the runner does not mark +GUI acceptance passed automatically. Fixed-source parser checks complete manifest, nonempty identical hash, every ready/resolved/existing member, read-only DB/device validation and allocation-cache existence **or buildability** before UP_TO_DATE. Derived allocation caches may modify DBs without invoking the producer: mtime or -new derived tables alone are not rerun evidence. Later GUI acceptance must retain +new derived tables alone are not rerun evidence. A real GUI acceptance must retain UP_TO_DATE/no-script-invocation logs and compare curves, blocks and cross-slice presentation. Source checks and original-artifact production reads are not GUI, C++ server/compile or full differential/performance acceptance. @@ -502,7 +505,8 @@ license/provenance history. [Acceptance and bounded performance](interop-acceptance.md) provides deterministic CI, an optional hash-first existing-original consumer/physical-forward comparison, -the same-source three-mode local baseline and an explicitly pending GUI checklist. +the same-source three-mode local baseline, the runner's pending GUI status, +and the separately recorded fixed-version real GUI acceptance. These evidence layers stay separate; a raw negative token is only dataset-local, never a cross-producer object-identity promise or permission to rewrite real IDs. diff --git a/docs/interop-acceptance-2026-10-11.json b/docs/interop-acceptance-2026-10-11.json new file mode 100644 index 0000000..9b58156 --- /dev/null +++ b/docs/interop-acceptance-2026-10-11.json @@ -0,0 +1,297 @@ +{ + "schemaVersion": 1, + "observedDate": "2026-10-11", + "status": "passed_bounded_fixed_source_acceptance", + "summaryOnly": true, + "receiptAuthority": "Reviewed clean fixed-checkout execution and separate GUI/process/protocol observations; hashes alone do not authenticate execution.", + "upstream": { + "repository": "https://github.com/Ascend/msinsight", + "revision": "101f65b877a267ffd5f66ea3834706057ba243e5", + "trackedSourceClean": true, + "builtComponents": [ + "framework", + "Leaks", + "profiler_server" + ] + }, + "ptSnap": { + "version": "0.0.post1.dev1", + "install": "noneditable_wheel", + "wheelSHA256": "884a13f08f65e866cd106c0a80f218d289269da10e9f623f1b0779cafdc67f9a", + "verifiedInstalledPackageMembers": 110, + "sourceMainCommit": "cd1aac689f653e2701334d26ae1f25489f7f5af9", + "sourceTree": "71e00c3f529b654ad200d13ca998063cc6d79490", + "laterMainOrPublishedReleaseTested": false + }, + "build": { + "platform": "Linux x86_64", + "python": "3.12", + "gcc": "14.2.0", + "cmake": "3.31.6", + "ninja": "1.11.1.4", + "node": "v24.19.0", + "pnpm": "11.25.0", + "frontendInstall": { + "frozenLockfile": true, + "originalHoistPatterns": true, + "strictSSL": true, + "lifecycleScripts": false, + "registry": "https://registry.npmjs.org" + }, + "sourceOrLockfileModified": false, + "binarySHA256": { + "profiler_server": "7b1c2325d88d709ad111faad458422099fd34b7f574ba557f9e0643a0108b64f", + "libmsinsight.so": "e9a0646e2af06e550266226b246bcc2c7092159a5be0f522cc903fb327c0cf19", + "libsqlite.so": "c41d72ece05af157e28a289b31d569bf57c0d3b36654acce75f1d28fd09de914" + }, + "dependencies": { + "sqlite": { + "version": "3.46.1", + "url": "https://www.sqlite.org/2024/sqlite-autoconf-3460100.tar.gz", + "sha256": "67d3fe6d268e6eaddcae3727fce58fcc8e9c53869bdd07a0c61e38ddf2965071" + }, + "libuv": { + "commit": "0c1fa696aa502eb749c2c4735005f41ba00a27b8", + "url": "https://github.com/libuv/libuv.git" + }, + "uSockets": { + "commit": "8cd4cb66eb061b2594ca114b9ea1ead64613ad4b", + "url": "https://github.com/uNetworking/uSockets.git" + }, + "uWebSockets": { + "commit": "bc2815d95b6ff4cad0973226d0058eadaaec99ad", + "url": "https://github.com/uNetworking/uWebSockets.git" + }, + "rapidjson": { + "commit": "24b5e7a8b27f42fa16b96fc70aade9106cf7102f", + "url": "https://github.com/Tencent/rapidjson.git" + } + }, + "rapidjsonCaveat": "Recorded local resolved commit; upstream did not pin a historical dependency commit.", + "serverInvocation": [ + "./profiler_server", + "--wsPort=9000", + "--wsHost=127.0.0.1" + ], + "serverInvocationContext": "Isolated staged server directory; LD_LIBRARY_PATH points to that directory; process trace enabled from launch to termination." + }, + "fixture": { + "repositoryPath": "tests/fixtures/snapshots/snapshot_expandable.pkl", + "sha256": "3afc9d1c5ef4ca4b417e58c0830e9eb8a913eb9459f4088b8c66c22325c68c40", + "bytes": 581140, + "device": 0, + "eventsPerSlice": 2000, + "saltedCacheHash": "c36b291e25b4a0ac8a33c50113132b634e97e6521e6f911b53beb4bc7aeff3e5", + "provenanceTestsPassed": 7 + }, + "forward": { + "status": "passed", + "guiWindowsVisited": [ + 1, + 2, + 1, + 4 + ], + "shards": 5, + "cacheState": "UP_TO_DATE", + "cacheStateNumber": 4, + "launchToTerminationTrace": { + "executableLaunchCount": 1, + "onlyExecutable": "profiler_server", + "producerOrParserExecutionCount": 0, + "serverExitObserved": true + }, + "protocol": { + "queryCases": 16, + "typedAssertions": 167, + "failures": 0, + "queryErrors": 0, + "sampledSliceIndices": [ + 0, + 1 + ], + "allSlicesProtocolExhaustivelyChecked": false, + "maxSizeMeaning": "reserved_memory_display_scale" + }, + "crossShardBlock": { + "id": 1669, + "bytes": 37632, + "allocationEvent": 1669, + "allocationSliceIndex": 0, + "completedFreeEvent": 2605, + "completedFreeSliceIndex": 1, + "freeRequestedEvent": 2604, + "freeRequestedBlockDetailsAssociation": "current_shard_only; absent in Window 1 block details and present in Window 2", + "directEvent2604Lookup": "not_additionally_queried; no_claim_of_cross_shard_direct_lookup_failure" + }, + "stateSamples": [ + { + "event": 1999, + "blocks": 801, + "allocatedBytes": 419457080 + }, + { + "event": 2000, + "blocks": 802, + "allocatedBytes": 419465784 + } + ], + "peakSample": { + "metric": "allocated_and_active", + "event": 7430, + "bytes": 597642080, + "displayMiB": 569.956, + "guiDisplayLabel": "569.956 MB" + }, + "preservation": { + "sourceCopiesUnchanged": true, + "preGUIExportUnchanged": true, + "runtimeManifestUnchanged": true, + "allOriginalTableSchemasAndRowsUnchanged": true, + "runtimeDatabaseBytesChanged": true, + "derivedTableAddedToEveryShard": "memory_allocation_cache_v1_0", + "ptSnapMemberAttestationValidAfterGUI": false, + "repairOrReimportAttempted": false + }, + "preGUIArtifactSHA256": { + "manifest.json": "5472709cca57daeeacbf3d8af6e5cb800fa7d1c3dd223350a75c6a36038682dd", + "device_0/slice_00001.db": "4682003df56fdc0c15649fc4cb90357da64bb55906ecadfe4c6e209af393cfc8", + "device_0/slice_00003.db": "f09456144ff1078c4b75f90efa0ba4860b577f820b0a58ae878776a8c435a7c0", + "device_0/slice_00002.db": "de7062b2d82cb5b7588ea305325763ab3d5042837df723334158cdf367cbdcf4", + "device_0/slice_00004.db": "7b9714e3520c0e19b740418baff4fffb3a320625ee67868c2be1a9fefbdf3b68", + "device_0/slice_00000.db": "89c017fe04c6c6811bd3dccc6e304b649031c9313a58bf2b55bcac8340851218" + }, + "postGUIArtifactSHA256": { + "device_0/slice_00000.db": "3cc3e3f473e0928ace7edd2475ff5dcc428c8d2bde5b157a5c5f4cd8ad90a23b", + "device_0/slice_00001.db": "1629d8f5ea6fc69cef7e3bc5f3e318af9f653fc86368fd56fdd518db70b019b6", + "device_0/slice_00002.db": "b564a9208e5f801af56647ab39f7778553296f5054086c61964fc2dcbecb424b", + "device_0/slice_00003.db": "81845d9a986ada8e81b7db6ad9232d72f893f23a31a487e6e27168d15e5d33b6", + "device_0/slice_00004.db": "77d537ee859f4e87e6f5c5bb4178d5111f2a0e082c9f10ffdee2de847d847023", + "manifest.json": "5472709cca57daeeacbf3d8af6e5cb800fa7d1c3dd223350a75c6a36038682dd" + }, + "runtimeServicesStopped": true + }, + "reverse": { + "status": "passed", + "originalProducerExecutions": 1, + "producerEntry": "dump2db.py (fixed upstream producer; identified by SHA256)", + "producerEntrySHA256": "cc8259a39ec7c89c3f33b081306db6e74a434e934930da0f57631d4e2ff30fe6", + "producerModified": false, + "shards": 5, + "templates": [ + "event", + "allocation", + "memory_peak", + "allocator_gap", + "block", + "leak_detection", + "freed_block_lifetime", + "callstack_analysis", + "active_blocks_at_event", + "active_memory_callstack_at_event", + "preexisting_live" + ], + "real_events": 8092, + "boundaries_excluded": 10, + "raw_block_rows": 6412, + "canonical_lifecycles": 3219, + "repeated_block_rows": 3193, + "terminal_candidates": 325, + "all_action_stack_groups": 60, + "points": [ + 0, + 1999, + 2000, + 3999, + 4000, + 5999, + 6000, + 7388, + 7430, + 7999, + 8000, + 8091 + ], + "ranges": [ + [ + 0, + 8091 + ], + [ + 0, + 1999 + ], + [ + 2000, + 3999 + ], + [ + 4000, + 5999 + ], + [ + 6000, + 7999 + ], + [ + 8000, + 8091 + ] + ], + "activeSetCoverage": "selected_points_not_exhaustive", + "oracleScope": { + "physicalSQL": "independent_bounded_reference", + "activeAttribution": "standalone_product_queries_on_canonical_reference_DB; differential_not_fully_independent_second_oracle" + }, + "actualCLIAPI": "passed_isolated_focus_query_report", + "forwardPhysicalComparison": "passed_all_nine_real_event_columns_schemas_dictionaries_real_IDs_negative_six_field_state_multisets", + "negativeTokenIdentityAcrossProducers": "unproved", + "metadata": { + "status": "unavailable", + "reason": "metadata_missing" + }, + "structuredFrames": false, + "originalArtifactSourceAndProducerFilesUnchanged": true, + "forwardComparisonCopyUnchanged": true, + "originalArtifactSHA256": { + "device_0/slice_00000.db": "79c447f8b00b42feba7681c04a65c11c932f05b3b57762c7fed38e60ae67a74e", + "device_0/slice_00001.db": "92a2f19df8b1a8cda61c95d1105567ec8664a4acb871a9e30cfdbc8f2dfe082c", + "device_0/slice_00002.db": "c46a175548d982cd43fddf11811c0b977a78251193c9fef210f920645410583e", + "device_0/slice_00003.db": "32a6f7f8e90c3632ededdeea3419c62669936e81965ab74b1cdf1376300a4738", + "device_0/slice_00004.db": "4bbe751134202def81d3b5e58b284333db31bfc6c67aa71a374927fa802bf971", + "manifest.json": "0e86da4f14a3c4e67182fb66b3283634f47ee0ae099f2caeb31af22f8636cd89" + }, + "runnerSHA256": "0382e7c75817a710e9f608bdc6d52a25b6ac5cab1e8adf6245f78127f503dc6b", + "runnerOwnScope": { + "GUI": "human-deferred/pending/not-run", + "original_producer": "not-run by this runner" + } + }, + "notEstablished": [ + "all_plugins", + "shipped_vendor_desktop_package", + "GPU_or_NPU_execution", + "multiple_devices", + "exhaustive_GUI_interactions", + "every_event_active_set", + "fully_independent_active_attribution_second_oracle", + "performance_improvements", + "fault_injection_by_this_real_run", + "cross_producer_negative_token_identity", + "structured_ordered_frames" + ], + "reproductionReferences": [ + "docs/en/interop-acceptance.md", + "docs/zh/interop-acceptance.md", + "benchmarks/interop_acceptance.py", + "tests/test_fixture_provenance.py", + "tests/test_interop_acceptance.py" + ], + "publicationSafety": { + "rawLogsIncluded": false, + "protocolCallStacksIncluded": false, + "screenshotsIncluded": false, + "privateAbsolutePathsIncluded": false, + "accountDataIncluded": false + } +} diff --git a/docs/zh/interop-acceptance.md b/docs/zh/interop-acceptance.md index a528cc5..affab7e 100644 --- a/docs/zh/interop-acceptance.md +++ b/docs/zh/interop-acceptance.md @@ -6,8 +6,9 @@ 唯一上游目标是 **Ascend/msinsight@101f65b877a267ffd5f66ea3834706057ba243e5**。 协议/schema、隔离源函数、合成 CI、真实原版生产端产物的读取差分、GUI/C++ 实测是 -不同证据层,不能互相替代。**GUI 已由人明确延期,待验收/not-run**;issue 保持开放。 -已有说明见 [#205](https://github.com/codeasier/pt-snap-cli/issues/205#issuecomment-5987264017),不重复发布。 +不同证据层,不能互相替代。**2026-10-11 的有界真实 GUI/C++ 与原版生产端反向验收已通过**, +详见下方记录。[#205 待验收说明](https://github.com/codeasier/pt-snap-cli/issues/205#issuecomment-5987264017) +保留此前人工延期阶段的历史,不代表本次当前状态。本证据本身不关闭 issue,也不批准发行。 验收工具是本地原创接口事实/独立参考实现,没有复制 vendor 实现。 固定 [生产 schema](https://api.github.com/repos/Ascend/msinsight/git/blobs/1fe50a5136f85365db55f4632d58f3cf7090431e)、 @@ -18,11 +19,11 @@ 本项目 MIT lineage。真正移植须走 snapshot provenance/PR 声明并保留 notices。 可执行 pickle 的信任是独立 fixture 审核;本验收不新增已提交 pickle。 -## 正向:可信源 → 物理兼容导出 → 未来 GUI +## 正向:可信源 → 物理兼容导出 → 真实 GUI 1. 先独立审核/信任源:pickle 可执行,不是沙箱。记录 SHA256、大小、设备与容量。 默认 import 仍单库,原生/兼容模式显式区分。 -2. 目标必须不存在。未来 GUI 支持入口要求产物邻接**同一原始 pickle**: +2. 目标必须不存在。GUI 支持入口要求产物邻接**同一原始 pickle**: ```bash pt-snap import /capture/snapshot.pkl --format msinsight --events-per-slice 2000 --device 0 --no-focus --json @@ -38,8 +39,8 @@ 必须完全相等。负 block ID 是生产端局部 token:全局及逐片比较其余六字段**包括 state** 的 MULTISET,保留重复数量,并独立验证每份产物的 token 跨片稳定性。这不证明跨生产端 的负对象身份。不能按地址去重、改写 ID 或修补固定原版源码来制造等价。 -4. **将来另经人明确授权后**,使用记录的真实 GUI build 打开同一原始 pickle,补下方清单。 - 物理或 salted hash 相等都不等于 GUI 缓存复用通过。 +4. 获得真实验收的明确授权后,使用记录的真实 GUI build 打开同一原始 pickle,记录下方证据。 + 仅物理或 salted hash 相等不等于 GUI 缓存复用通过;2026-10-11 已另行实测真实消费端。 ## 反向:已有原版产物 → 完整 focus → canonical 参考 @@ -78,11 +79,12 @@ receipt 真实性依赖调用者审核,hash 本身不能证明生产端身份 输出必须全新、规范、无符号链接且不与输入重叠;只在其中创建物理 canonical-reference DB、 报告和隔离测试项目 focus,不改外部 focus/cache,不下载/执行生产端。 -小型独立 oracle 显式物化有限数据(文件总32 MiB、256目录项、64片、含边界的20000条 +独立物理 SQL 参考显式物化有限数据(文件总32 MiB、256目录项、64片、含边界的20000条 物理 trace、20000条 block、逐片256 dictionary 行、1 MiB JSON、可选2 MiB源)。这些是 参考工具界限,不是产品 RSS 承诺。它比较全部真实列、完整 alloc/free_completed 来源、 canonical 生命周期/最新状态、终片候选、最早 tie 的全局及逐片峰值、指定点活跃集合/字节、 全部 action 栈统计与全局排序/分页/精确总数。canonical 单库不是又一次原版生产端执行。 +活跃归因比较在该参考库上复用产品单库查询实现,是差分检查,不是活跃归因的完全独立第二 oracle。 控制台链在切换隔离 CWD 前后验证同一解释器/相同 API 源路径,再运行真实 focus/query/report 并规范化 CLI/API scope/覆盖。报告记录实际选择的点/区间,不宣称枚举每个 event 的活跃集合。 @@ -144,14 +146,73 @@ Python/platform 和全部11查询延迟。[机器可读本地观测](../dataset- 和兼容内联栈会重复,query hash/scan可能占主导。不承诺未测速度/RSS/磁盘收益。 已有原版唯一冷wall0.160545s没有RSS/phase测量,不是受控比较性能基线。 -## 未来 GUI 清单——全部待验收 / NOT-RUN - -- [ ] 精确真实version/build/commit/package SHA、解释器/server来源、环境、启动/open命令;不猜可执行语法。 -- [ ] 同一原始pickle路径/hash/size、邻接complete产物;打开前后全部manifest/member/hash清单,源不变。 -- [ ] UP_TO_DATE/cache-reuse日志、没有producer/parser脚本调用,并有足以发现重建的process/log观察;hash不足以证明。 -- [ ] 指定点的曲线/counter/range/真实ID(排除边界),block/size/state及跨片alloc/free_completed来源详情。 -- [ ] 仅实际recognized覆盖允许ordered frame声明,原版文本产物保持text-only;不可用展示如实记录。 -- [ ] 派生allocation cache修改单独检查:可能不运行生产端就改DB并使ptSnap证明失效;保留前后清单, - 不能修复/覆盖原版缓存来让reuse通过。 - -schema/合成/原版产物读取和静态skill评分不能勾选GUI项;本验收包不执行/编译GUI或C++。 +## 真实验收记录——2026-10-11 + +[去敏机器可读 receipt](../interop-acceptance-2026-10-11.json) 记录精确身份、依赖 pin、 +成员清单和有界结果。它是实测摘要,不是可分发的原始产物,也不能替代 receipt 真实性审核。 +不包含截图、协议原始调用栈、私有路径、账户或完整日志。 + +### 构建与输入身份 + +- 固定上游 `101f65b877a267ffd5f66ea3834706057ba243e5`,tracked source 干净。 + Linux x86_64、GCC 14.2.0、CMake 3.31.6、Ninja 1.11.1.4、Node 24.19.0。 + 仅构建 production framework、Leaks 和 `profiler_server`。前端使用 pnpm 11.25.0、 + frozen lockfile、原有 hoist 规则、strict SSL、禁用 lifecycle scripts;未修改源码/锁文件。 +- Server SHA256:`7b1c2325d88d709ad111faad458422099fd34b7f574ba557f9e0643a0108b64f`。 + 在隔离 server 目录运行 `./profiler_server --wsPort=9000 --wsHost=127.0.0.1`, + `LD_LIBRARY_PATH` 指向该目录,并启用完整进程跟踪。 + 动态库 hash 和 libuv/uSockets/uWebSockets/RapidJSON/SQLite pin 见 receipt。 + RapidJSON 记录的是本次本地依赖 commit,不是上游历史依赖 pin;不宣称逐字节复现发行包。 +- 非 editable wheel:`0.0.post1.dev1`,SHA256 + `884a13f08f65e866cd106c0a80f218d289269da10e9f623f1b0779cafdc67f9a`; + 全部110个已安装 package 成员匹配。其源码 tree 对应 + `cd1aac689f653e2701334d26ae1f25489f7f5af9`,不代表后续 main commit 或已发布 PyPI 版本验过。 +- 已审 `snapshot_expandable.pkl`:581140字节,SHA256 + `3afc9d1c5ef4ca4b417e58c0830e9eb8a913eb9459f4088b8c66c22325c68c40`; + device 0,每片2000 events。反序列化前 fixture provenance 测试7/7通过。 + pickle 执行仍需独立信任审核。 + +### 正向 GUI/C++ 结果与保留情况 + +- [x] 真实 framework/Leaks GUI 打开原始 pickle 及邻接完整五片 pt-snap 导出。 + Window 1 → 2 → 1 → 4 切换、生命周期曲线、reserved 线及五窗总览正常展示。 + Window 4 展示 event 7430 的 allocated/active 峰值(597642080字节 = 569.956 MiB; + GUI 标签实际为 `569.956 MB`)。 +- [x] Server 记录 `UP_TO_DATE`(state 4)。从启动到终止的完整进程跟踪只有一次 server + 可执行文件启动,无 parser/Python producer 执行。另行反向 producer 运行不属于这份 trace。 +- [x] Block 1669(37632字节)从 Window 2 定位 Window 1 的 allocation 1669, + 从 Window 1 定位 Window 2 的 completed-free 2605。Block 详情自动关联 free-requested + event 2604 时只查询当前片:Window 1 详情缺失,Window 2 存在。这不表示按 event ID + 直接定位不能跨片;本次没有额外从该独立路径查询2604。如实记录 block 详情限制,未修补它。 +- [x] 同一已加载的真实 C++ server 通过16个 query cases / 167条 typed assertions, + 零失败/query error。协议采样覆盖前两片的 curve/reserved 端点、events 1999/2000、 + 裁剪 block 区间及跨片详情。1999/2000 状态分别为801/802 blocks、 + 419457080/419465784 allocated字节。`maxSize` 是 reserved 展示尺度,不是 allocated 峰值。 +- [x] 五个 runtime shard 的原表 schema 与全部原行保持一致;两份源和 runtime manifest 不变。 + **Runtime DB 字节已变化**:消费端逐片新增 `memory_allocation_cache_v1_0`,导致未变 + manifest 内的 ptSnap 成员证明失效。另存的 pre-GUI 导出仍逐字节不变。未修复/重新导入 + 来隐藏此修改;缓存复用并不表示打开后的产物不可变。 +- [x] 实际调用栈仍为 text-only,未重建 ordered frames;运行后 GUI/server/私有 HTTP 服务均已停止。 + +### 反向结果与限制 + +另行执行一次未改动的固定原版 producer,最终生成五片、8092真实 events。已安装 wheel +通过全部11内建模板、物理 SQL/参考比较及真实隔离 CLI/API focus/query/report 检查。 +数量为10条排除边界、6412物理 block 行、3219 canonical 生命周期、3193重复行、 +325终片候选、60个全 action 栈组。选择12个记录点和6个区间,没有穷举每个 event 的活跃集合。 +活跃归因在 canonical DB 上复用产品单库查询,因此不是完全独立第二 oracle。 + +正向 pre-GUI 与原版产物的物理比较通过:全部九列真实 event、schema/dictionary、 +精确真实 ID 和负 token 六字段/state multiset。负对象身份不跨生产端成立。 +原版 metadata 正确返回 `unavailable` / `metadata_missing`,frames 仍 text-only。 +反向原版产物、正向比较副本、源字节及 producer 源码在只读分析后均未变。 + +[benchmarks/interop_acceptance.py](../../benchmarks/interop_acceptance.py) 只读取已有产物; +其中 `GUI=human-deferred/pending/not-run` 和 `original_producer=not-run by this runner` +说明该工具自身范围,保留原值,不伪装成 runner 执行过 GUI 或 producer。带日期 receipt +汇总分别实测的阶段。复现有界只读比较请使用上面的命令、[fixture 审核](../../tests/fixtures/AGENTS.md) +及另行审核的 receipt;hash 本身不能重建原 manifest 路径,也不能认证执行。 + +本次不覆盖全部插件、已发行桌面包、GPU/NPU 执行、多设备、穷举 GUI 交互、故障注入或性能改善。 +广泛失败/rollback 场景仍依赖上方 owning tests。历史合成检查与性能观测继续作为独立证据; +本次 docs-only 记录不改变运行时行为。 diff --git a/docs/zh/sharded-snapshotdb.md b/docs/zh/sharded-snapshotdb.md index 760825f..f89cfad 100644 --- a/docs/zh/sharded-snapshotdb.md +++ b/docs/zh/sharded-snapshotdb.md @@ -382,10 +382,12 @@ force 不绕过该规则。源路径/内容、选项/合同变化、成员损坏 转换暂时并存两种布局,可能留下 SQLite free pages;容量不是 RSS/registry/block/磁盘 上限。不生成可选 frame 增强。 -**GUI 待验收/未运行。** 固定源码 parser 在 UP_TO_DATE 前检查 complete manifest、 +**仅检查已有产物的 runner 仍将自身 GUI 阶段标为待验收/not-run。** +2026-10-11 独立固定版本真实 GUI/C++ 实测见[互操作验收](interop-acceptance.md), +不表示 runner 自动判定 GUI 通过。固定源码 parser 在 UP_TO_DATE 前检查 complete manifest、 非空相同 hash、每个 ready/可解析/存在成员、只读 DB/设备校验,以及 allocation cache 存在**或可构建**。派生 allocation cache 可在不运行生产者时修改 DB,mtime 或新派生表 -不能单独证明重跑。后续 GUI 验收须保留 UP_TO_DATE/无 script 调用日志并对照曲线、block、 +不能单独证明重跑。真实 GUI 验收须保留 UP_TO_DATE/无 script 调用日志并对照曲线、block、 跨片展示。源码检查及原版产物的生产 reader 读取不是 GUI、C++ server/编译或完整差分/ 性能验收。 @@ -400,7 +402,8 @@ Ascend 源码为 Mulan PSL v2,docs 单独为 CC BY 4.0;此最小转换器是 ## 可重复验收与实测限制 [验收与有界性能](interop-acceptance.md) 提供确定性 CI、hash-first 的已有原版消费者/ -正向物理对照、同源三模式本地基线及明确待验收 GUI 清单。证据层彼此独立;负 token +正向物理对照、同源三模式本地基线、runner 的 GUI 待验收状态及另行记录的固定版本 +真实 GUI 验收。证据层彼此独立;负 token 仅在数据集内标识对象,不承诺跨生产端对象身份,也不允许重写真实 ID。 ## 来源证据与限制