Skip to content

feat: EXPKITS-1532 clarify track observations and timed history - #269

Merged
zmolnar merged 1 commit into
feature/EXPKITS-1531-embedding-spacesfrom
feature/EXPKITS-1532-tracking-semantics
Nov 16, 2026
Merged

zmolnar merged 1 commit into
feature/EXPKITS-1531-embedding-spacesfrom
feature/EXPKITS-1532-tracking-semantics

Conversation

@zmolnar

@zmolnar zmolnar commented Nov 9, 2026 •

Copy link
Copy Markdown
Contributor

Goal

EXPKITS-1532: Separate track identity, observations, historical sources and timed traces.

Change

Before

Track numbers could alias across trackers/restarts. Prediction tags and display strings carried semantics; traces lacked timing and could retain the wrong history. Comparisons could ignore trace suffixes or accept derived outcomes swapped between coincident tracks.

After

  • Separate packet observation IDs from tracker/session/local-track identity. Publish observed/predicted samples, elapsed timing and explicit current/historical source references.
  • Keep original labels; reconstruct familiar display suffixes from typed association diagnostics. Diagnostic kind is not the matching strategy.
  • Retain traces by elapsed age, validate chronology/identity and restart segments on reacquisition. Correct faulty retention cases while preserving valid matching costs and presentation.
  • Publish successful empty tracks and enabled traces; disabled trace output remains absent.
  • Share cross-run identity matching across tracks, traces and derived subjects. Session UUIDs and observation IDs may change between runs; coincident geometry cannot substitute for track identity.

Testing

Coverage and historical validation

Native, bridge, browser and Plumber regressions cover restart, prediction, reacquisition, ambiguity, timing and empty output. Serialized cases reject swapped gaze, classification, contact, presence and embedding outcomes while accepting reordered equivalent records. Physical GPU execution is unverified. Related subject-matching finding: EXPKITS-1561.

Post-rebase evidence

The 2026-11-16 assembled-stack build, native/WebUI/Plumber tests, SDK/bundle checks
and documentation validation are recorded in the Testing section of #276
at aad8a7f218a2. These results supplement the earlier coverage above; they are not
standalone local reruns at every lower PR head.

Reproduction commands

From the repository root inside the supported OPK development container, with
the pinned submodules initialized and the normal model/media setup available:

NINJAFLAGS=-j2 ./scripts/build.sh debug true
meson test -C development/build-active --print-errorlogs --num-processes 2
./scripts/perception-sdk.sh check
./scripts/opksink-web.sh test
./scripts/opksink-web.sh check
PYTHONPATH=tools/plumber:generated/open_perception_kit/python/src python3 -m unittest discover -s tools/plumber/tests

From the host checkout, run ./scripts/gen-doc.sh to generate and validate the
documentation and diagrams in build output.

Links

Part of the breaking, unreleased SDK/product 1.0.0 refactor. Producers and consumers
must use compatible regenerated snapshots. Stable release packaging/publication is separate.

@zmolnar
zmolnar requested review from a team as code owners November 9, 2026 14:49
@zmolnar
zmolnar added this pull request to stack #248 November 9, 2026 14:49
@zmolnar
zmolnar force-pushed the feature/EXPKITS-1532-tracking-semantics branch from a56c881 to 90488d4 Compare November 9, 2026 15:14
@zmolnar
zmolnar force-pushed the feature/EXPKITS-1532-tracking-semantics branch from 90488d4 to 64d1008 Compare November 11, 2026 10:31
@zmolnar
zmolnar force-pushed the feature/EXPKITS-1532-tracking-semantics branch from 64d1008 to bc31273 Compare November 11, 2026 11:08
@zmolnar
zmolnar force-pushed the feature/EXPKITS-1532-tracking-semantics branch from bc31273 to 0803235 Compare November 11, 2026 12:40
@zmolnar
zmolnar force-pushed the feature/EXPKITS-1532-tracking-semantics branch from 0803235 to c3213e9 Compare November 11, 2026 13:43
@zmolnar
zmolnar force-pushed the feature/EXPKITS-1532-tracking-semantics branch from c3213e9 to 7975790 Compare November 11, 2026 15:56
@zmolnar
zmolnar force-pushed the feature/EXPKITS-1532-tracking-semantics branch from 7975790 to 22a66c0 Compare November 12, 2026 07:08

@Szendvics Szendvics left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

opktracker.cpp:676

Nit: Trace retention now uses elapsed tracker time, independently of forced Kalman fallback. Could we update this help text to match?

Comment thread development/web/README.md Resolved
Comment thread development/web/src/frame-results.js Resolved
@zmolnar
zmolnar force-pushed the feature/EXPKITS-1532-tracking-semantics branch from 22a66c0 to 94eaa74 Compare November 13, 2026 11:29
@zmolnar

zmolnar commented Nov 13, 2026

Copy link
Copy Markdown
Contributor Author

Addressed the review-summary help-text finding in 94eaa74: trace-history-seconds now describes elapsed tracker time independently of forced Kalman fallback, matching the runtime and the strengthened trace-retention regression.

@Szendvics

Copy link
Copy Markdown
Contributor

The trace-retention help-text Nit from the earlier review is fixed in 94eaa741. The property now describes elapsed tracker time independently of forced Kalman fallback.

Szendvics
Szendvics previously approved these changes Nov 16, 2026
Task: EXPKITS-1532

Scope persistent identities by tracker session, publish explicit observation
state and historical source references, and retain typed association data.
Keep source labels separate from rendered ID diagnostics. Add ordered trace
samples and elapsed-time retention, migrate consumers and strict comparison,
and regenerate the SDKs with regression coverage for identity and history.

Signed-off-by: Zoltan Molnar <zoltan.molnar@arm.com>
@zmolnar
zmolnar force-pushed the feature/EXPKITS-1532-tracking-semantics branch from 94eaa74 to ddd2e5a Compare November 16, 2026 12:50

@Szendvics Szendvics left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved as is.

@zmolnar
zmolnar enabled stacked auto-merge (squash) November 16, 2026 14:03
@zmolnar
zmolnar merged commit c93aa4a into main Nov 16, 2026
31 of 36 checks passed
@zmolnar
zmolnar deleted the feature/EXPKITS-1532-tracking-semantics branch November 16, 2026 14:30
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.

2 participants