Merge pull request #228 from SenteraLLC/feature/lineage-tracking

Feature/lineage tracking

Author: TrevorBurgoyne

.github/copilot-instructions.md

@@ -0,0 +1,15 @@
+## General Instructions
+- Keep it simple.
+- Work in small, incremental changes.
+- Whenever you run a command in the terminal, pipe the output to a file, output.txt, that you can read from. Make sure to overwrite each time so that it doesn't grow too big. There is a bug in the current version of Copilot that causes it to not read the output of commands correctly. This workaround allows you to read the output from the temporary file instead.
+- Ensure changes pass linting checks by running `npm run lint` and waiting for it to complete. Read the linting errors and resolve them manually.
+- Ensure changes build successfully by running `npm run build`.
+- Do not add new dependencies unless given explicit permission.
+- Do not modify the `package.json` or `package-lock.json` files unless instructed.
+
+
+## Task Tracking
+- Always start each step by referencing and updating your tasks in `.github/tasks.md`.
+- Use checkboxes to track progress.
+- Work on one task at a time.
+- Do not mark tasks as complete until they are fully done. Ask for confirmation if unsure.

.github/tasks.md

@@ -0,0 +1,5 @@
+## Tasks
+- [x] Read the discussion in [#209](https://github.com/SenteraLLC/ulabel/issues/209) and understand the requirements.
+- [x] Implement the fix requested in [#209](https://github.com/SenteraLLC/ulabel/issues/209).
+- [x] Build the fix and ensure the build succeeds by running `npm run build`.
+- [x] Receive confirmation that the fix works as expected.

.gitignore

@@ -1,4 +1,5 @@
 node_modules
 ulabel_local/py-dbapi/dbapi/__pycache__
 build
-build/*
+build/*
+output.txt

CHANGELOG.md

@@ -6,6 +6,19 @@ All notable changes to this project will be documented here.
 
 Nothing yet.
 
+## [0.19.0] - Aug 19th, 2025
+
+- Add minimal lineage tracking via `last_edited_by` and `last_edited_at` annotation fields
+- Prevent creation of zero-length polylines
+- Fixed `process_resume_from` not actually populating missing annotation fields on load
+- Misc bug/QOL fixes
+  - Simplified/fixed non-spatial annotation creation/deletion
+  - Replaced `alert`, `throw`, and `console` calls with `log_message()`
+  - Cleanup of `suggest_edits()` and other functions related to toggling dialogs
+  - Refactor action stream management and undo/redo flow into `actions.ts`
+    - Move a lot of repeated rendering/cleanup steps after actions into general action listeners that trigger on similar actions
+    - Move `annotation_id` out of undo/redo payloads and into the action itself 
+
 ## [0.18.2] - July 28th, 2025
 
 - Fix special characters in submit buttons breaking tool

api_spec.md

@@ -159,15 +159,24 @@ As you can see, each subtask will have a corresponding list of annotation object
 
     // timestamp when annotation was created
     "created_at": "<ISO datetime string>",
+
+    // the username associated with the most recent modification to the annotation
+    "last_edited_by": "<string>",
+
+    // timestamp of the most recent modification to the annotation
+    "last_edited_at": "<ISO datetime string>",
 
     // true if annotation was deleted
-    "deprecated": <bool>, 
+    "deprecated": "<bool>", 
+
+    // indicates what/who deprecated the annotation, eg { human: false }
+    "deprecated_by": "<object>",
 
     // which type of annotation
     "spatial_type": "<string>", 
 
     // (nullable) e.g. [[x1, y1], [x2, y2], ...]
-    "spatial_payload": <array>, 
+    "spatial_payload": "<array>", 
 
     // The class associated with the annotation
     "classification_payloads": [ 
@@ -186,16 +195,16 @@ As you can see, each subtask will have a corresponding list of annotation object
     ],
 
     // size in underlying image pixels
-    "line_size": <number>, 
+    "line_size": "<number>", 
 
     // (nullable) frame ann was created for
-    "frame": <int>, 
+    "frame": "<int>", 
 
     // certain spatial types allow text
     "text_payload": "<string>", 
 
     // as provided to constructor
-    "annotation_meta": <object> 
+    "annotation_meta": "<object>"
 }
 ```
 

demo/multi-class.html

@@ -131,7 +131,7 @@
                 "toggle_brush_mode_keybind": "f",
                 "create_bbox_on_initial_crop": "|",
                 "click_and_drag_poly_annotations": false,
-                "anno_scaling_mode": "match-zoom",
+                "anno_scaling_mode": "fixed",
                 "allow_annotations_outside_image": false,
             });
             // Wait for ULabel instance to finish initialization

demo/resume-from.html

@@ -35,29 +35,29 @@
                     "spatial_type": "point", 
                     "spatial_payload": [[300, 300]], 
                     "classification_payloads": [
-                      {"id": "c72ea9a1-79f9-444c-a01a-7983f0697b4a", "class_id": 12, "confidence": 0.0},
-                      {"id": "c72ea9a1-79f9-444c-a01a-7983f0697b4a", "class_id": 11, "confidence": 1.0},
-                      {"id": "c72ea9a1-79f9-444c-a01a-7983f0697b4a", "class_id": 10, "confidence": 0.0},
+                      {"class_id": 12, "confidence": 0.0},
+                      {"class_id": 11, "confidence": 1.0},
+                      {"class_id": 10, "confidence": 0.0},
                     ],
-                    "line_width": 4
+                    "line_size": 4
                   },
                   {
                     "id": "4a586dc4-0efa-4563-a42b-8eea3dd5b04b", 
                     "spatial_type": "point", 
                     "spatial_payload": [[400, 300]], 
                     "classification_payloads": [
-                      {"id": "c72ea9a1-79f9-444c-a01a-7983f0697b4a", "class_id": 10}
+                      {"class_id": 10, "confidence": 1.0},
                     ],
-                    "line_width": 4
+                    "line_size": 4
                   },
                   {
                     "id": "4a686dc4-0efa-4563-a42b-8eea3dd5b04b", 
                     "spatial_type": "point", 
                     "spatial_payload": [[300, 400]], 
                     "classification_payloads": [
-                      {"id": "c72ea9a1-79f9-444c-a01a-7983f0697b4a", "class_id": 12}
+                      {"class_id": 12, "confidence": 1.0},
                     ],
-                    "line_width": 4
+                    "line_size": 4
                   },
                   {
                     "id": "4a186dc4-0efa-4563-a42b-8eea3dd5b04b",
@@ -105,7 +105,7 @@
                         ]
                     ],
                     "classification_payloads": [
-                        {"id": "c72ea9a1-79f9-444c-a01a-7983f0697b4a", "class_id": 11},
+                        {"class_id": 11, "confidence": 1.0},
                         {"class_id": -1, "confidence": 0.0}
                     ],
                   },

dist/ulabel.js

@@ -68,6 +68,8 @@ object-assign
     and limitations under the License.
     ***************************************************************************** */
 
+/*! For license information please see ulabel.js.LICENSE.txt */
+
 /**
      * splaytree v3.1.2
      * Fast Splay tree for Node and browser