<?xml version="1.0" encoding="UTF-8"?><database name="cleanrhythm" schema="public" type="PostgreSQL - 18.4 (Ubuntu 18.4-1.pgdg24.04+1)">
   <tables>
      <table name="classification_log" remarks="{&quot;what&quot;:&quot;Log of each file classification event with category and confidence.&quot;,&quot;why&quot;:&quot;Without it, no audit trail of classification decisions or ability to reprocess.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:32.274134753+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="true" defaultValue="null" digits="0" id="0" name="id" nullable="false" remarks="{&quot;what&quot;:&quot;Unique numeric identifier for each log entry.&quot;,&quot;why&quot;:&quot;Without it, entries cannot be referenced or updated individually.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:32.392673912+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="path" nullable="false" remarks="{&quot;what&quot;:&quot;Filesystem path of the classified file.&quot;,&quot;why&quot;:&quot;Without it, cannot know which file was classified or group by path.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:32.433910720+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="device" nullable="false" remarks="{&quot;what&quot;:&quot;Device identifier where the file resides.&quot;,&quot;why&quot;:&quot;Without it, same path on different devices becomes ambiguous.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:32.476463560+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="primary_category" nullable="false" remarks="{&quot;what&quot;:&quot;Assigned category label for the file.&quot;,&quot;why&quot;:&quot;Without it, classification result is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:32.674224479+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="17" id="4" name="confidence" nullable="false" remarks="{&quot;what&quot;:&quot;Confidence score between 0 and 1 for the category.&quot;,&quot;why&quot;:&quot;Without it, cannot filter low-confidence classifications or assess reliability.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:32.826661369+00:00&quot;}" size="17" type="float8" typeCode="8"/>
         <column autoUpdated="false" defaultValue="0" digits="0" id="5" name="symlinks_created" nullable="false" remarks="{&quot;what&quot;:&quot;Number of symlinks created during classification.&quot;,&quot;why&quot;:&quot;Without it, cannot track side effects or cleanup needs.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:33.660677099+00:00&quot;}" size="10" type="int4" typeCode="4"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="6" name="classified_at" nullable="false" remarks="{&quot;what&quot;:&quot;UTC timestamp when classification occurred.&quot;,&quot;why&quot;:&quot;Without it, cannot order events or audit time-based changes.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:33.696776805+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <primaryKey column="id" sequenceNumberInPK="1"/>
         <index name="classification_log_pkey" unique="true">
            <column ascending="true" name="id"/>
         </index>
         <index name="idx_classlog_path" unique="false">
            <column ascending="true" name="path"/>
            <column ascending="true" name="device"/>
         </index>
      </table>
      <table name="cleanup_log" remarks="{&quot;what&quot;:&quot;One row per cleanup run, with timing, trigger, and byte counts.&quot;,&quot;why&quot;:&quot;Needed to audit cleanup activity and track disk-space recovery over time.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:36.802235434+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="true" defaultValue="null" digits="0" id="0" name="id" nullable="false" remarks="{&quot;what&quot;:&quot;Unique numeric identifier for each cleanup run.&quot;,&quot;why&quot;:&quot;Ensures each log row can be uniquely addressed; without it, updates or deletes would be ambiguous.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:36.940230005+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="session_uuid" nullable="false" remarks="{&quot;what&quot;:&quot;UUID of the session that triggered the cleanup, as a text string.&quot;,&quot;why&quot;:&quot;Ties each cleanup to the originating session for audit and debugging.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:37.181216287+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="agent_name" nullable="true" remarks="{&quot;what&quot;:&quot;Name of the cleanup agent or component that performed the run.&quot;,&quot;why&quot;:&quot;Allows filtering by agent to compare behavior; without it, runs from different agents are indistinguishable.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:37.239104077+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="files_deleted" nullable="false" remarks="{&quot;what&quot;:&quot;Count of files removed during the cleanup run.&quot;,&quot;why&quot;:&quot;Quantifies the cleanup impact; without it, the number of deleted files is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:37.277926160+00:00&quot;}" size="10" type="int4" typeCode="4"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="4" name="tmp_bytes_freed" nullable="false" remarks="{&quot;what&quot;:&quot;Bytes freed from temporary storage, in bytes.&quot;,&quot;why&quot;:&quot;Measures temporary space reclaimed; without it, tmp capacity planning is impossible.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:37.304752332+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="5" name="mirror_bytes_kept" nullable="false" remarks="{&quot;what&quot;:&quot;Bytes retained in mirror storage after cleanup, in bytes.&quot;,&quot;why&quot;:&quot;Shows remaining mirror usage; without it, mirror growth cannot be tracked.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:37.343621635+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="6" name="cleaned_at" nullable="false" remarks="{&quot;what&quot;:&quot;Timestamp (with time zone) when the cleanup completed, defaulting to current time.&quot;,&quot;why&quot;:&quot;Provides chronological ordering and time-based analysis; without it, run timing is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:37.405570409+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="7" name="trigger" nullable="false" remarks="{&quot;what&quot;:&quot;Reason or event that initiated the cleanup, e.g., 'manual' or 'scheduled'.&quot;,&quot;why&quot;:&quot;Distinguishes cleanup sources; without it, the cause of each run is ambiguous.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:37.599416102+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <primaryKey column="id" sequenceNumberInPK="1"/>
         <index name="cleanup_log_pkey" unique="true">
            <column ascending="true" name="id"/>
         </index>
      </table>
      <table name="deletability_scores" remarks="{&quot;what&quot;:&quot;Per-file scores and metadata used to rank files for deletion.&quot;,&quot;why&quot;:&quot;Without it, there is no persistent record of which files are safe to delete and in what order.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:11.258608116+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="false" defaultValue="null" digits="0" id="0" name="file_id" nullable="false" remarks="{&quot;what&quot;:&quot;Identifier of the scored file; matches the file's primary key.&quot;,&quot;why&quot;:&quot;Without it, scores cannot be linked back to the actual file to act on.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:11.286660937+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="device" nullable="false" remarks="{&quot;what&quot;:&quot;Name or identifier of the device or volume containing the file.&quot;,&quot;why&quot;:&quot;Without it, scores from different devices are indistinguishable and deletion actions cannot target the right storage.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:11.298825854+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="file_path" nullable="false" remarks="{&quot;what&quot;:&quot;Absolute path of the file on the device, including directories.&quot;,&quot;why&quot;:&quot;Without it, the file cannot be located for deletion or inspection.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:11.317790840+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="file_name" nullable="false" remarks="{&quot;what&quot;:&quot;Base name of the file, without directory components.&quot;,&quot;why&quot;:&quot;Without it, display and filtering by filename is impossible; path alone is unwieldy.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:11.382598979+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="4" name="size_bytes" nullable="false" remarks="{&quot;what&quot;:&quot;File size in bytes, as reported by the filesystem.&quot;,&quot;why&quot;:&quot;Without it, deletion impact (freed space) cannot be estimated.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:11.409395626+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="5" name="content_type" nullable="false" remarks="{&quot;what&quot;:&quot;MIME type or file extension category, e.g. 'image/png'.&quot;,&quot;why&quot;:&quot;Without it, deletion policies cannot exclude or prioritize by file type.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:11.547493608+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="17" id="6" name="score" nullable="false" remarks="{&quot;what&quot;:&quot;Computed deletability score; higher means more likely to be deleted.&quot;,&quot;why&quot;:&quot;Without it, there is no ranking to decide which files to delete first.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:11.560061414+00:00&quot;}" size="17" type="float8" typeCode="8"/>
         <column autoUpdated="false" defaultValue="null" digits="17" id="7" name="cleanup_priority" nullable="false" remarks="{&quot;what&quot;:&quot;Numeric priority for cleanup order; lower values are deleted earlier.&quot;,&quot;why&quot;:&quot;Without it, the order of deletion within same score is undefined.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:11.594689686+00:00&quot;}" size="17" type="float8" typeCode="8"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="8" name="category" nullable="false" remarks="{&quot;what&quot;:&quot;Bucket such as 'temp', 'cache', 'user' that groups files by purpose.&quot;,&quot;why&quot;:&quot;Without it, deletion rules cannot be applied per category.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:11.660641919+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="'[]'::text" digits="0" id="9" name="signals" nullable="false" remarks="{&quot;what&quot;:&quot;JSON array of signal names that contributed to the score, e.g. '[\&quot;old\&quot;,\&quot;large\&quot;]'.&quot;,&quot;why&quot;:&quot;Without it, the reason behind a score is opaque and cannot be audited.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:11.671057438+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="10" name="scored_at" nullable="false" remarks="{&quot;what&quot;:&quot;Timestamp when the score was computed, in ISO 8601 format.&quot;,&quot;why&quot;:&quot;Without it, stale scores cannot be detected and refreshed.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:11.684146048+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
      </table>
      <table name="dir_observed" remarks="{&quot;what&quot;:&quot;Snapshot of a directory's contents on a device at a point in time.&quot;,&quot;why&quot;:&quot;Without it, no record of directory state for historical comparison or drift detection.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:22:21.112245220+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="false" defaultValue="null" digits="0" id="0" name="device" nullable="false" remarks="{&quot;what&quot;:&quot;Identifier of the host device, e.g., hostname or UUID.&quot;,&quot;why&quot;:&quot;Without it, observations from different devices are indistinguishable.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:22:21.156760935+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="dir_path" nullable="false" remarks="{&quot;what&quot;:&quot;Absolute path of the directory on the device.&quot;,&quot;why&quot;:&quot;Without it, cannot know which directory the metrics refer to.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:22:21.363195539+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="file_count" nullable="true" remarks="{&quot;what&quot;:&quot;Total number of files directly inside the directory (not recursive).&quot;,&quot;why&quot;:&quot;Without it, cannot track growth or compare directory sizes.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:22:21.391408560+00:00&quot;}" size="10" type="int4" typeCode="4"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="subdir_count" nullable="true" remarks="{&quot;what&quot;:&quot;Number of immediate subdirectories within the directory.&quot;,&quot;why&quot;:&quot;Without it, cannot assess directory structure complexity or changes.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:22:21.412237767+00:00&quot;}" size="10" type="int4" typeCode="4"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="4" name="loose_file_count" nullable="true" remarks="{&quot;what&quot;:&quot;Number of files not inside any subdirectory (i.e., directly in the directory).&quot;,&quot;why&quot;:&quot;Without it, cannot distinguish files from subdirectory contents.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:22:21.632106610+00:00&quot;}" size="10" type="int4" typeCode="4"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="5" name="ext_profile" nullable="true" remarks="{&quot;what&quot;:&quot;JSON object mapping file extensions to counts or frequencies.&quot;,&quot;why&quot;:&quot;Without it, cannot analyze extension distribution or detect unexpected file types.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:22:21.732053413+00:00&quot;}" size="2147483647" type="jsonb" typeCode="1111"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="6" name="dominant_ext" nullable="true" remarks="{&quot;what&quot;:&quot;File extension with the highest count in the directory.&quot;,&quot;why&quot;:&quot;Without it, cannot quickly identify the primary file type without parsing ext_profile.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:22:21.916720834+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="8" id="7" name="dominant_frac" nullable="true" remarks="{&quot;what&quot;:&quot;Fraction (0-1) of files having the dominant extension.&quot;,&quot;why&quot;:&quot;Without it, cannot gauge how dominant the dominant extension is.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:22:21.963449268+00:00&quot;}" size="8" type="float4" typeCode="7"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="8" name="sampled_at" nullable="true" remarks="{&quot;what&quot;:&quot;UTC timestamp when the observation was taken.&quot;,&quot;why&quot;:&quot;Without it, cannot order observations or detect changes over time.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:22:22.132899354+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <primaryKey column="device" sequenceNumberInPK="1"/>
         <primaryKey column="dir_path" sequenceNumberInPK="2"/>
         <index name="dir_observed_pkey" unique="true">
            <column ascending="true" name="device"/>
            <column ascending="true" name="dir_path"/>
         </index>
      </table>
      <table name="dir_schema" remarks="" schema="public" type="TABLE">
         <column autoUpdated="false" defaultValue="null" digits="0" id="0" name="device" nullable="false" remarks="{&quot;what&quot;:&quot;Device identifier (hostname or ID) that owns the directory.&quot;,&quot;why&quot;:&quot;Uniquely identifies which machine's directory schema this row describes; without it, rows from different devices collide.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:51.688815505+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="dir_path" nullable="false" remarks="{&quot;what&quot;:&quot;Absolute or relative path of the directory on the device.&quot;,&quot;why&quot;:&quot;Together with device, uniquely identifies the directory; without it, multiple schemas for same path on same device would be ambiguous.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:51.707699010+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="purpose" nullable="true" remarks="{&quot;what&quot;:&quot;Intended use of the directory, e.g., logs, cache, data.&quot;,&quot;why&quot;:&quot;Documents why the directory exists; without it, future maintainers cannot infer the directory's role.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:51.732979778+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="allowed_kinds" nullable="true" remarks="{&quot;what&quot;:&quot;List of allowed file kinds or extensions, e.g., {'log','txt'}.&quot;,&quot;why&quot;:&quot;Enforces which file types may reside here; without it, any file type could be placed, breaking validation.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:51.751976281+00:00&quot;}" size="2147483647" type="_text" typeCode="2003"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="4" name="subdir_convention" nullable="true" remarks="{&quot;what&quot;:&quot;Naming rule for subdirectories, e.g., date-based YYYY/MM/DD.&quot;,&quot;why&quot;:&quot;Defines expected subdirectory structure; without it, subdirectory names become inconsistent and hard to predict.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:51.769303766+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="5" name="naming_pattern" nullable="true" remarks="{&quot;what&quot;:&quot;File naming pattern, e.g., 'prefix_*.log'.&quot;,&quot;why&quot;:&quot;Specifies expected file name format; without it, files cannot be matched to the schema.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:51.802169383+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="6" name="max_loose_files" nullable="true" remarks="{&quot;what&quot;:&quot;Maximum number of files allowed directly in the directory (not in subdirs).&quot;,&quot;why&quot;:&quot;Prevents clutter; without it, loose files could accumulate unboundedly, degrading performance.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:51.830554544+00:00&quot;}" size="10" type="int4" typeCode="4"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="7" name="owner_kind" nullable="true" remarks="{&quot;what&quot;:&quot;Type of owner, e.g., 'user', 'service', 'team'.&quot;,&quot;why&quot;:&quot;Identifies who is responsible; without it, ownership is unclear and accountability is lost.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:51.848267644+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="8" name="owner_id" nullable="true" remarks="{&quot;what&quot;:&quot;Identifier of the owner (username, service name, team ID).&quot;,&quot;why&quot;:&quot;Points to the specific owner; without it, owner_kind alone is insufficient to contact or assign permissions.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:51.875671247+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="'user'::text" digits="0" id="9" name="source" nullable="false" remarks="{&quot;what&quot;:&quot;Origin of this schema definition: 'user' or 'system'.&quot;,&quot;why&quot;:&quot;Distinguishes manually defined schemas from auto-generated ones; without it, trust in the schema's accuracy is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:51.892809282+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="1.0" digits="8" id="10" name="confidence" nullable="true" remarks="{&quot;what&quot;:&quot;Confidence score (0-1) that the schema is correct.&quot;,&quot;why&quot;:&quot;Indicates reliability; without it, low-confidence schemas could be mistaken for verified ones.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:51.913317502+00:00&quot;}" size="8" type="float4" typeCode="7"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="11" name="notes" nullable="true" remarks="{&quot;what&quot;:&quot;Free-form notes about the schema.&quot;,&quot;why&quot;:&quot;Captures context not covered by other fields; without it, rationale and exceptions are lost.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:51.925839049+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="12" name="updated_at" nullable="true" remarks="{&quot;what&quot;:&quot;Timestamp of last modification, timezone-aware.&quot;,&quot;why&quot;:&quot;Tracks freshness; without it, stale schemas cannot be detected.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:51.943065137+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <primaryKey column="device" sequenceNumberInPK="1"/>
         <primaryKey column="dir_path" sequenceNumberInPK="2"/>
         <index name="dir_schema_pkey" unique="true">
            <column ascending="true" name="device"/>
            <column ascending="true" name="dir_path"/>
         </index>
      </table>
      <table name="execution_log" remarks="{&quot;what&quot;:&quot;One row per proposal execution attempt with outcome and rollback data.&quot;,&quot;why&quot;:&quot;Without it, there is no audit trail for proposal executions or data to undo partial changes.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:58.114868740+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="true" defaultValue="null" digits="0" id="0" name="id" nullable="false" remarks="{&quot;what&quot;:&quot;Surrogate primary key; unique identifier for each log entry.&quot;,&quot;why&quot;:&quot;Without it, rows cannot be uniquely referenced for updates or deletes.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:58.130489455+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="proposal_id" nullable="false" remarks="{&quot;what&quot;:&quot;Identifier of the proposal that this execution belongs to.&quot;,&quot;why&quot;:&quot;Without it, executions cannot be linked to their originating proposal.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:58.161047348+00:00&quot;}" size="19" type="int8" typeCode="-5">
            <parent column="id" foreignKey="execution_log_proposal_id_fkey" implied="false" onDeleteCascade="false" schema="public" table="proposals"/>
         </column>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="2" name="executed_at" nullable="false" remarks="{&quot;what&quot;:&quot;Timestamp (with time zone) when the execution was attempted; defaults to current time.&quot;,&quot;why&quot;:&quot;Without it, the order and timing of executions is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:58.181243511+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="success" nullable="false" remarks="{&quot;what&quot;:&quot;Boolean flag indicating whether the execution completed successfully (true) or failed (false).&quot;,&quot;why&quot;:&quot;Without it, failed executions cannot be distinguished from successful ones for alerting or retry.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:58.208090254+00:00&quot;}" size="1" type="bool" typeCode="-7"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="4" name="error_message" nullable="true" remarks="{&quot;what&quot;:&quot;Free-text error message from the execution failure; null when success is true.&quot;,&quot;why&quot;:&quot;Without it, the cause of a failure is unavailable for debugging.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:58.224416114+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="5" name="rollback_data" nullable="true" remarks="{&quot;what&quot;:&quot;Serialized data needed to undo the execution's changes; null when no rollback is possible.&quot;,&quot;why&quot;:&quot;Without it, partial changes cannot be reverted after a failure.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:12:58.256611098+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <primaryKey column="id" sequenceNumberInPK="1"/>
         <index name="execution_log_pkey" unique="true">
            <column ascending="true" name="id"/>
         </index>
      </table>
      <table name="overrides" remarks="" schema="public" type="TABLE">
         <column autoUpdated="true" defaultValue="null" digits="0" id="0" name="id" nullable="false" remarks="{&quot;what&quot;:&quot;Unique numeric ID for each override row.&quot;,&quot;why&quot;:&quot;Needed to reference individual overrides for updates, deletes, or joins.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:03.275825387+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="path" nullable="false" remarks="{&quot;what&quot;:&quot;Configuration key path (e.g., 'settings.timeout') that the override applies to.&quot;,&quot;why&quot;:&quot;Identifies which setting is being overridden; without it, the target is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:03.306650155+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="device" nullable="false" remarks="{&quot;what&quot;:&quot;Device identifier (e.g., hostname or serial) for which this override is active.&quot;,&quot;why&quot;:&quot;Scopes the override to a specific device; without it, overrides would apply globally.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:03.354650112+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="category" nullable="false" remarks="{&quot;what&quot;:&quot;Classification of the override (e.g., 'bugfix', 'temporary', 'customer').&quot;,&quot;why&quot;:&quot;Groups overrides for reporting or filtering; without it, override types are indistinguishable.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:03.380025294+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="''::text" digits="0" id="4" name="reason" nullable="false" remarks="{&quot;what&quot;:&quot;Free-text explanation for why the override exists.&quot;,&quot;why&quot;:&quot;Provides audit trail for future maintainers; without it, the rationale is lost.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:03.397690943+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="5" name="created_at" nullable="false" remarks="{&quot;what&quot;:&quot;Timestamp when the override was inserted, in UTC.&quot;,&quot;why&quot;:&quot;Tracks when the override was added for auditing and cleanup; without it, override age is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:03.410989108+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <primaryKey column="id" sequenceNumberInPK="1"/>
         <index name="overrides_pkey" unique="true">
            <column ascending="true" name="id"/>
         </index>
         <index name="overrides_path_device_key" unique="true">
            <column ascending="true" name="path"/>
            <column ascending="true" name="device"/>
         </index>
      </table>
      <table name="placement_flags" remarks="{&quot;what&quot;:&quot;A proposed category change for an item identified by source_path and device, with confidence and resolution status.&quot;,&quot;why&quot;:&quot;Tracks proposed category moves so they can be reviewed, approved, and applied; without it, proposed changes are unknown and cannot be acted on.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:13.089123565+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="true" defaultValue="null" digits="0" id="0" name="id" nullable="false" remarks="{&quot;what&quot;:&quot;Unique numeric ID for this flag; primary key.&quot;,&quot;why&quot;:&quot;Without it, rows cannot be uniquely referenced for updates or joins.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:13.119872641+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="source_path" nullable="false" remarks="{&quot;what&quot;:&quot;Full path of the item being flagged, e.g., /data/file.txt.&quot;,&quot;why&quot;:&quot;Identifies which item the flag applies to; without it, the flag cannot be associated with a specific file or object.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:13.132758038+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="device" nullable="false" remarks="{&quot;what&quot;:&quot;Device or host name where the source_path resides.&quot;,&quot;why&quot;:&quot;Disambiguates items with the same path on different devices; without it, the source is ambiguous.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:13.149386866+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="current_category" nullable="false" remarks="{&quot;what&quot;:&quot;Category the item currently belongs to, e.g., 'documents'.&quot;,&quot;why&quot;:&quot;Provides the baseline for the proposed change; without it, the change cannot be evaluated.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:13.160762240+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="4" name="proposed_category" nullable="false" remarks="{&quot;what&quot;:&quot;Category the item is proposed to move to.&quot;,&quot;why&quot;:&quot;Defines the target category; without it, the intended change is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:13.170270929+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="5" name="proposed_destination" nullable="false" remarks="{&quot;what&quot;:&quot;Full path or location where the item would be moved to.&quot;,&quot;why&quot;:&quot;Specifies the concrete move target; without it, the move cannot be executed.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:13.182839400+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="17" id="6" name="confidence" nullable="false" remarks="{&quot;what&quot;:&quot;Probability (0-1) that the proposed category is correct.&quot;,&quot;why&quot;:&quot;Used to prioritize or filter flags; without it, all flags are equally weighted and low-confidence moves cannot be identified.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:13.194035777+00:00&quot;}" size="17" type="float8" typeCode="8"/>
         <column autoUpdated="false" defaultValue="''::text" digits="0" id="7" name="reason" nullable="false" remarks="{&quot;what&quot;:&quot;Free-text explanation for the proposed change, empty if none.&quot;,&quot;why&quot;:&quot;Provides context for reviewers; without it, the rationale for the flag is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:13.209738604+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="'pending'::text" digits="0" id="8" name="status" nullable="false" remarks="{&quot;what&quot;:&quot;Workflow state, e.g., 'pending', 'approved', 'rejected'.&quot;,&quot;why&quot;:&quot;Tracks whether the flag is awaiting action or resolved; without it, unresolved flags cannot be distinguished from processed ones.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:13.221782701+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="9" name="created_at" nullable="false" remarks="{&quot;what&quot;:&quot;Timestamp with time zone when the flag was created.&quot;,&quot;why&quot;:&quot;Records when the proposal was made; without it, the age of flags cannot be determined for prioritization.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:13.245266285+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <column autoUpdated="false" defaultValue="null" digits="6" id="10" name="resolved_at" nullable="true" remarks="{&quot;what&quot;:&quot;Timestamp with time zone when the flag was resolved, null if pending.&quot;,&quot;why&quot;:&quot;Indicates when the flag was processed; without it, resolution time and pending duration are unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:13.265140158+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <primaryKey column="id" sequenceNumberInPK="1"/>
         <index name="placement_flags_pkey" unique="true">
            <column ascending="true" name="id"/>
         </index>
         <index name="idx_flags_device" unique="false">
            <column ascending="true" name="device"/>
         </index>
         <index name="idx_flags_status" unique="false">
            <column ascending="true" name="status"/>
         </index>
         <index name="placement_flags_source_path_device_key" unique="true">
            <column ascending="true" name="source_path"/>
            <column ascending="true" name="device"/>
         </index>
      </table>
      <table name="proposal_impacts" remarks="{&quot;what&quot;:&quot;One row per proposal, holding the outcome of an automated impact scan.&quot;,&quot;why&quot;:&quot;Without it, there is no record of what a proposal touches, so approval cannot be based on risk.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:38.216823016+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="false" defaultValue="null" digits="0" id="0" name="proposal_id" nullable="false" remarks="{&quot;what&quot;:&quot;Identifier of the proposal this impact analysis belongs to.&quot;,&quot;why&quot;:&quot;Without it, the analysis cannot be linked to a specific proposal, making it useless.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:38.507193533+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="risk" nullable="true" remarks="{&quot;what&quot;:&quot;Risk level assigned to the proposal, e.g., low, medium, high.&quot;,&quot;why&quot;:&quot;Without it, reviewers cannot quickly triage which proposals need deeper inspection.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:38.644093702+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="open_handles" nullable="true" remarks="{&quot;what&quot;:&quot;Number of open file handles the proposal would affect.&quot;,&quot;why&quot;:&quot;Without it, the potential for resource leaks or lock conflicts is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:38.698229028+00:00&quot;}" size="10" type="int4" typeCode="4"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="code_refs" nullable="true" remarks="{&quot;what&quot;:&quot;Count of code references (e.g., function calls) impacted by the proposal.&quot;,&quot;why&quot;:&quot;Without it, the blast radius of the change on the codebase is not quantified.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:38.915613659+00:00&quot;}" size="10" type="int4" typeCode="4"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="4" name="service_configs" nullable="true" remarks="{&quot;what&quot;:&quot;Number of service configuration files that would be modified.&quot;,&quot;why&quot;:&quot;Without it, the impact on runtime behavior across services is not assessed.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:40.057123878+00:00&quot;}" size="10" type="int4" typeCode="4"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="5" name="manifest_refs" nullable="true" remarks="{&quot;what&quot;:&quot;Count of manifest file entries (e.g., dependencies) that reference the proposal's changes.&quot;,&quot;why&quot;:&quot;Without it, dependency consistency after the change cannot be verified.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:40.259291345+00:00&quot;}" size="10" type="int4" typeCode="4"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="6" name="dependent_symlinks" nullable="true" remarks="{&quot;what&quot;:&quot;Number of symbolic links that depend on the proposal's target paths.&quot;,&quot;why&quot;:&quot;Without it, broken symlinks or path resolution failures may go unnoticed.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:40.850590036+00:00&quot;}" size="10" type="int4" typeCode="4"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="7" name="dest_conflict" nullable="true" remarks="{&quot;what&quot;:&quot;Description of any conflict at the destination path, or null if none.&quot;,&quot;why&quot;:&quot;Without it, a proposal that overwrites existing files could be approved unknowingly.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:40.963542643+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="8" name="required_changes" nullable="true" remarks="{&quot;what&quot;:&quot;Human-readable list of changes required to apply the proposal.&quot;,&quot;why&quot;:&quot;Without it, the effort and steps needed to implement the proposal are not documented.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:41.006804999+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="9" name="summary" nullable="true" remarks="{&quot;what&quot;:&quot;Free-text summary of the impact analysis findings.&quot;,&quot;why&quot;:&quot;Without it, the key takeaways of the scan are not available for quick review.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:41.450913745+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="10" name="checked_at" nullable="true" remarks="{&quot;what&quot;:&quot;UTC timestamp when the impact analysis was last run.&quot;,&quot;why&quot;:&quot;Without it, the freshness of the analysis is unknown, so stale results could be used for decisions.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:42.188974569+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <primaryKey column="proposal_id" sequenceNumberInPK="1"/>
         <index name="proposal_impacts_pkey" unique="true">
            <column ascending="true" name="proposal_id"/>
         </index>
      </table>
      <table name="proposals" remarks="{&quot;what&quot;:&quot;Code change proposals with analysis and review metadata.&quot;,&quot;why&quot;:&quot;Without it, proposed changes and their review status cannot be tracked.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:47.820662566+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="true" defaultValue="null" digits="0" id="0" name="id" nullable="false" remarks="{&quot;what&quot;:&quot;Unique numeric identifier for each proposal row.&quot;,&quot;why&quot;:&quot;Without it, proposals cannot be referenced or updated individually.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:47.881552649+00:00&quot;}" size="19" type="int8" typeCode="-5">
            <child column="proposal_id" foreignKey="execution_log_proposal_id_fkey" implied="false" onDeleteCascade="false" schema="public" table="execution_log"/>
         </column>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="action" nullable="false" remarks="{&quot;what&quot;:&quot;Operation to apply, e.g., 'edit' or 'delete'.&quot;,&quot;why&quot;:&quot;Without it, the intended change is unknown and cannot be executed.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:47.948997515+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="file_path" nullable="false" remarks="{&quot;what&quot;:&quot;Path to the file under version control.&quot;,&quot;why&quot;:&quot;Without it, the target file cannot be located for the change.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:48.020561841+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="line_number" nullable="true" remarks="{&quot;what&quot;:&quot;Line number in the file; null if file-level.&quot;,&quot;why&quot;:&quot;Without it, the exact location of the change is ambiguous.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:48.090755281+00:00&quot;}" size="10" type="int4" typeCode="4"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="4" name="current_state" nullable="false" remarks="{&quot;what&quot;:&quot;Existing code snippet or state at the target location.&quot;,&quot;why&quot;:&quot;Without it, the baseline for the change is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:48.420851199+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="5" name="proposed_state" nullable="true" remarks="{&quot;what&quot;:&quot;Replacement code or state; null if deletion.&quot;,&quot;why&quot;:&quot;Without it, the desired outcome is unknown, so change cannot be applied.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:48.523400550+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="6" name="rationale" nullable="false" remarks="{&quot;what&quot;:&quot;Human-readable justification for the change.&quot;,&quot;why&quot;:&quot;Without it, reviewers cannot assess the reasoning behind the proposal.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:48.603217814+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="'[]'::text" digits="0" id="7" name="intent_signals" nullable="false" remarks="{&quot;what&quot;:&quot;JSON array of signals that triggered the proposal.&quot;,&quot;why&quot;:&quot;Without it, the context leading to the proposal is lost.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:48.835464982+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="'Low'::text" digits="0" id="8" name="confidence" nullable="false" remarks="{&quot;what&quot;:&quot;Confidence level: Low, Medium, or High.&quot;,&quot;why&quot;:&quot;Without it, the reliability of the proposal is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:48.965689115+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="'Medium'::text" digits="0" id="9" name="risk" nullable="false" remarks="{&quot;what&quot;:&quot;Risk level: Low, Medium, or High.&quot;,&quot;why&quot;:&quot;Without it, the potential impact of the change is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:49.192672065+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="'Pending'::text" digits="0" id="10" name="status" nullable="false" remarks="{&quot;what&quot;:&quot;Workflow status: Pending, Approved, Rejected, etc.&quot;,&quot;why&quot;:&quot;Without it, the proposal's lifecycle state is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:49.279050514+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="'[]'::text" digits="0" id="11" name="analyzed_by" nullable="false" remarks="{&quot;what&quot;:&quot;JSON array of analyzer names that produced this proposal.&quot;,&quot;why&quot;:&quot;Without it, the source of the proposal is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:49.331071328+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="12" name="repo" nullable="false" remarks="{&quot;what&quot;:&quot;Repository name or identifier the proposal applies to.&quot;,&quot;why&quot;:&quot;Without it, the proposal cannot be scoped to a codebase.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:49.504461110+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="13" name="created_at" nullable="false" remarks="{&quot;what&quot;:&quot;Timestamp when the proposal was created.&quot;,&quot;why&quot;:&quot;Without it, the age of the proposal is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:49.668503226+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="14" name="updated_at" nullable="false" remarks="{&quot;what&quot;:&quot;Timestamp of the last update to the proposal.&quot;,&quot;why&quot;:&quot;Without it, it's impossible to know if the proposal changed.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:50.012271411+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="15" name="reviewer" nullable="true" remarks="{&quot;what&quot;:&quot;Username or identifier of the reviewer.&quot;,&quot;why&quot;:&quot;Without it, there is no accountability for review decisions.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:50.046619652+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="16" name="review_note" nullable="true" remarks="{&quot;what&quot;:&quot;Free-text comment left by the reviewer.&quot;,&quot;why&quot;:&quot;Without it, the reasoning behind a review decision is lost.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:50.066525456+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <primaryKey column="id" sequenceNumberInPK="1"/>
         <index name="proposals_pkey" unique="true">
            <column ascending="true" name="id"/>
         </index>
         <index name="idx_proposals_confidence" unique="false">
            <column ascending="true" name="confidence"/>
         </index>
         <index name="idx_proposals_file" unique="false">
            <column ascending="true" name="file_path"/>
         </index>
         <index name="idx_proposals_repo" unique="false">
            <column ascending="true" name="repo"/>
         </index>
         <index name="idx_proposals_status" unique="false">
            <column ascending="true" name="status"/>
         </index>
      </table>
      <table name="repo_descriptions" remarks="{&quot;what&quot;:&quot;Per-device repository metadata: description, category, model, and generation time.&quot;,&quot;why&quot;:&quot;Without it, no record of what each device knows about a repo.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:34.489870394+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="false" defaultValue="null" digits="0" id="0" name="device" nullable="false" remarks="{&quot;what&quot;:&quot;Device identifier that fetched the repo description; part of composite key.&quot;,&quot;why&quot;:&quot;Separates entries from different devices for the same repo.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:34.503381466+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="repo" nullable="false" remarks="{&quot;what&quot;:&quot;Repository identifier (e.g., owner/name) that the description refers to.&quot;,&quot;why&quot;:&quot;Identifies which repo the row describes; with device forms unique key.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:34.540176864+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="description" nullable="true" remarks="{&quot;what&quot;:&quot;Free-text summary of the repository's purpose or content.&quot;,&quot;why&quot;:&quot;Provides human-readable context not available from code.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:34.551585884+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="category" nullable="true" remarks="{&quot;what&quot;:&quot;Optional classification label such as 'library' or 'tool'.&quot;,&quot;why&quot;:&quot;Enables grouping or filtering repos by type.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:34.650826287+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="4" name="model" nullable="true" remarks="{&quot;what&quot;:&quot;Name or version of the model that generated the description.&quot;,&quot;why&quot;:&quot;Tracks which model produced the text for reproducibility.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:34.673810963+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="5" name="generated_at" nullable="true" remarks="{&quot;what&quot;:&quot;Timestamp (with time zone) when the description was generated; defaults to now.&quot;,&quot;why&quot;:&quot;Shows data freshness and allows ordering by generation time.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:34.708446400+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <primaryKey column="device" sequenceNumberInPK="1"/>
         <primaryKey column="repo" sequenceNumberInPK="2"/>
         <index name="repo_descriptions_pkey" unique="true">
            <column ascending="true" name="device"/>
            <column ascending="true" name="repo"/>
         </index>
      </table>
      <table name="scan_findings" remarks="{&quot;what&quot;:&quot;A single issue detected by a scan, with location and metadata.&quot;,&quot;why&quot;:&quot;Without it, scan results would be lost and cannot be tracked or resolved.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:20.761969823+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="false" defaultValue="null" digits="0" id="0" name="id" nullable="false" remarks="{&quot;what&quot;:&quot;Unique numeric identifier for each finding.&quot;,&quot;why&quot;:&quot;Needed to reference a specific finding in updates or joins.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:20.772003430+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="path" nullable="true" remarks="{&quot;what&quot;:&quot;File path or resource location where the issue was found.&quot;,&quot;why&quot;:&quot;Identifies the affected file; without it, the finding cannot be located.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:20.795214035+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="kind" nullable="true" remarks="{&quot;what&quot;:&quot;Category or type of the finding, e.g., 'bug' or 'vulnerability'.&quot;,&quot;why&quot;:&quot;Groups findings by type for triage and prioritization.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:20.828547917+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="suggestion" nullable="true" remarks="{&quot;what&quot;:&quot;Suggested fix or remediation text provided by the scan.&quot;,&quot;why&quot;:&quot;Gives developers actionable guidance; without it, remediation steps are unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:20.858722165+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="4" name="severity" nullable="true" remarks="{&quot;what&quot;:&quot;Severity level such as 'low', 'medium', 'high'.&quot;,&quot;why&quot;:&quot;Prioritizes which findings to address first.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:20.878563038+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="5" name="size" nullable="true" remarks="{&quot;what&quot;:&quot;Size of the affected resource in bytes.&quot;,&quot;why&quot;:&quot;Helps assess impact or correlate with resource limits.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:20.900113547+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="6" name="scanned_at" nullable="true" remarks="{&quot;what&quot;:&quot;Unix timestamp (seconds) when the scan ran.&quot;,&quot;why&quot;:&quot;Tracks when the finding was discovered; needed for time-based analysis.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:20.919646416+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="0" digits="0" id="7" name="resolved" nullable="true" remarks="{&quot;what&quot;:&quot;Unix timestamp when resolved, or 0 if not resolved.&quot;,&quot;why&quot;:&quot;Distinguishes open from closed findings; without it, resolution status is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:20.934155971+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <primaryKey column="id" sequenceNumberInPK="1"/>
         <index name="scan_findings_pkey" unique="true">
            <column ascending="true" name="id"/>
         </index>
      </table>
      <table name="session_descriptions" remarks="{&quot;what&quot;:&quot;One row per session description, linking a session to its summary and agent.&quot;,&quot;why&quot;:&quot;Without it, session summaries and their generating agent are not recorded, losing provenance.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:55.509136365+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="false" defaultValue="null" digits="0" id="0" name="session_uuid" nullable="false" remarks="{&quot;what&quot;:&quot;UUID of the session this description refers to.&quot;,&quot;why&quot;:&quot;Uniquely identifies the session; without it, descriptions cannot be matched to sessions.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:55.802154581+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="agent" nullable="true" remarks="{&quot;what&quot;:&quot;Name or identifier of the agent that generated the description.&quot;,&quot;why&quot;:&quot;Distinguishes which agent produced the summary; without it, provenance is unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:55.841746694+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="summary" nullable="true" remarks="{&quot;what&quot;:&quot;Concise textual overview of the session's content.&quot;,&quot;why&quot;:&quot;Provides a human-readable summary; without it, session content is not summarized.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:55.888551639+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="3" name="generated_at" nullable="true" remarks="{&quot;what&quot;:&quot;Timestamp with time zone when the description was created.&quot;,&quot;why&quot;:&quot;Records when the summary was made; without it, freshness and ordering are unknown.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T04:21:56.030923679+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <primaryKey column="session_uuid" sequenceNumberInPK="1"/>
         <index name="session_descriptions_pkey" unique="true">
            <column ascending="true" name="session_uuid"/>
         </index>
      </table>
      <table name="session_names" remarks="{&quot;what&quot;:&quot;Maps each session UUID to its agent name and directory slug.&quot;,&quot;why&quot;:&quot;Without it, session context (agent and directory) is unknown; cannot route or debug.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:48.187886591+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="false" defaultValue="null" digits="0" id="0" name="session_uuid" nullable="false" remarks="{&quot;what&quot;:&quot;Unique session identifier in UUID format; primary key.&quot;,&quot;why&quot;:&quot;Without it, sessions cannot be uniquely referenced; duplicates or ambiguity.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:48.201740818+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="agent_name" nullable="false" remarks="{&quot;what&quot;:&quot;Agent name as a text string; identifies the responsible agent.&quot;,&quot;why&quot;:&quot;Without it, we cannot attribute session actions to a specific agent.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:48.217210750+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="dir_slug" nullable="false" remarks="{&quot;what&quot;:&quot;URL-friendly slug for the working directory, e.g., 'my-project'.&quot;,&quot;why&quot;:&quot;Without it, the associated directory is unknown; file operations become ambiguous.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:48.232113420+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="3" name="resolved_at" nullable="false" remarks="{&quot;what&quot;:&quot;Timestamp with time zone of resolution; defaults to current time.&quot;,&quot;why&quot;:&quot;Without it, we cannot know when the session was assigned to this agent/directory; audit or expiry impossible.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:48.247845592+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <primaryKey column="session_uuid" sequenceNumberInPK="1"/>
         <index name="session_names_pkey" unique="true">
            <column ascending="true" name="session_uuid"/>
         </index>
      </table>
      <table name="symlink_registry" remarks="{&quot;what&quot;:&quot;Central registry of symlink entries with source/target paths, categories, and status.&quot;,&quot;why&quot;:&quot;Without it, symlink mappings and their validation state would be unknown, breaking link management.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:46.662701772+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="true" defaultValue="null" digits="0" id="0" name="id" nullable="false" remarks="{&quot;what&quot;:&quot;Unique bigint identifier for each symlink entry.&quot;,&quot;why&quot;:&quot;Without it, rows cannot be uniquely referenced for updates or deletion.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:46.687106833+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="source_path" nullable="false" remarks="{&quot;what&quot;:&quot;Path string of the symlink's source location.&quot;,&quot;why&quot;:&quot;Without it, the symlink's origin is unknown, so the mapping cannot be created or verified.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:46.710555183+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="target_path" nullable="false" remarks="{&quot;what&quot;:&quot;Path string that the symlink points to.&quot;,&quot;why&quot;:&quot;Without it, the destination is unknown, making the mapping incomplete.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:46.733131362+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="primary_category" nullable="false" remarks="{&quot;what&quot;:&quot;High-level classification label for the symlink's purpose.&quot;,&quot;why&quot;:&quot;Without it, symlinks cannot be grouped or filtered by main function.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:46.746694383+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="4" name="link_category" nullable="false" remarks="{&quot;what&quot;:&quot;Secondary classification refining the primary category.&quot;,&quot;why&quot;:&quot;Without it, distinctions between symlink types within a primary category are lost.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:46.762351820+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="17" id="5" name="score" nullable="false" remarks="{&quot;what&quot;:&quot;Floating-point rating of link reliability or usage priority.&quot;,&quot;why&quot;:&quot;Without it, ranking or prioritizing symlinks for validation or cleanup is impossible.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:46.781958240+00:00&quot;}" size="17" type="float8" typeCode="8"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="6" name="created_at" nullable="false" remarks="{&quot;what&quot;:&quot;Timestamp when the symlink entry was inserted.&quot;,&quot;why&quot;:&quot;Without it, the age of the entry is unknown, hindering audit or cleanup decisions.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:46.796148272+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <column autoUpdated="false" defaultValue="null" digits="6" id="7" name="last_validated" nullable="true" remarks="{&quot;what&quot;:&quot;Timestamp of the most recent successful validation of the symlink.&quot;,&quot;why&quot;:&quot;Without it, it's unknown whether the symlink has ever been checked, so stale links cannot be identified.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:46.823562527+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <column autoUpdated="false" defaultValue="'active'::text" digits="0" id="8" name="status" nullable="false" remarks="{&quot;what&quot;:&quot;Lifecycle state of the entry, defaulting to 'active'.&quot;,&quot;why&quot;:&quot;Without it, broken or deprecated symlinks cannot be distinguished from valid ones.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:46.848945937+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="'source-pointer'::text" digits="0" id="9" name="kind" nullable="false" remarks="{&quot;what&quot;:&quot;Categorization of the link direction or usage, defaulting to 'source-pointer'.&quot;,&quot;why&quot;:&quot;Without it, the role of the symlink in the system is ambiguous, affecting validation logic.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:46.859746648+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <primaryKey column="id" sequenceNumberInPK="1"/>
         <index name="symlink_registry_pkey" unique="true">
            <column ascending="true" name="id"/>
         </index>
         <index name="idx_symlink_category" unique="false">
            <column ascending="true" name="link_category"/>
         </index>
         <index name="idx_symlink_kind" unique="false">
            <column ascending="true" name="kind"/>
         </index>
         <index name="idx_symlink_status" unique="false">
            <column ascending="true" name="status"/>
         </index>
         <index name="idx_symlink_target" unique="false">
            <column ascending="true" name="target_path"/>
         </index>
         <index name="symlink_registry_source_path_key" unique="true">
            <column ascending="true" name="source_path"/>
         </index>
      </table>
      <table name="tracked_files" remarks="{&quot;what&quot;:&quot;A file that was detected and processed; each row is one file.&quot;,&quot;why&quot;:&quot;Without it, there is no record of which files were handled and their outcomes.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:57.868369581+00:00&quot;}" schema="public" type="TABLE">
         <column autoUpdated="true" defaultValue="null" digits="0" id="0" name="id" nullable="false" remarks="{&quot;what&quot;:&quot;Unique numeric identifier for each tracked file.&quot;,&quot;why&quot;:&quot;Without it, rows cannot be uniquely referenced or updated.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:57.884686276+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="1" name="session_uuid" nullable="false" remarks="{&quot;what&quot;:&quot;UUID of the session that discovered the file.&quot;,&quot;why&quot;:&quot;Without it, files from different runs cannot be separated or grouped.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:57.905657323+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="2" name="agent_name" nullable="true" remarks="{&quot;what&quot;:&quot;Name of the agent that processed the file, if any.&quot;,&quot;why&quot;:&quot;Without it, it's unknown which agent handled the file, making attribution impossible.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:57.917602333+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="3" name="source_path" nullable="false" remarks="{&quot;what&quot;:&quot;Original file path on the source system.&quot;,&quot;why&quot;:&quot;Without it, the origin of the file is unknown, so mirroring or cleaning cannot be traced.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:57.931123264+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="4" name="mirror_path" nullable="false" remarks="{&quot;what&quot;:&quot;Path where the file was mirrored or copied to.&quot;,&quot;why&quot;:&quot;Without it, the mirrored location is unknown, so retrieval or verification fails.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:57.945335292+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="5" name="archive_path" nullable="false" remarks="{&quot;what&quot;:&quot;Path where the file is stored in the archive.&quot;,&quot;why&quot;:&quot;Without it, the archived copy cannot be located for restoration.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:57.958251574+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="6" name="content_hash" nullable="false" remarks="{&quot;what&quot;:&quot;Hash of file content, e.g., SHA-256.&quot;,&quot;why&quot;:&quot;Without it, duplicate detection or integrity verification is impossible.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:57.971305369+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="7" name="size_bytes" nullable="false" remarks="{&quot;what&quot;:&quot;File size in bytes.&quot;,&quot;why&quot;:&quot;Without it, storage usage and transfer progress cannot be estimated.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:57.986140381+00:00&quot;}" size="19" type="int8" typeCode="-5"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="8" name="detected_by" nullable="false" remarks="{&quot;what&quot;:&quot;Method or rule that detected the file.&quot;,&quot;why&quot;:&quot;Without it, the detection source is unknown, so false positives cannot be traced.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:58.025434616+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="9" name="tool_name" nullable="true" remarks="{&quot;what&quot;:&quot;Name of the tool that processed the file.&quot;,&quot;why&quot;:&quot;Without it, the processing tool is unknown, making debugging or auditing difficult.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:58.039667908+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="null" digits="0" id="10" name="bash_command" nullable="true" remarks="{&quot;what&quot;:&quot;Shell command used to process the file.&quot;,&quot;why&quot;:&quot;Without it, the exact operation performed cannot be reproduced.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:58.062776957+00:00&quot;}" size="2147483647" type="text" typeCode="12"/>
         <column autoUpdated="false" defaultValue="now()" digits="6" id="11" name="mirrored_at" nullable="false" remarks="{&quot;what&quot;:&quot;Timestamp when the file was mirrored, in UTC.&quot;,&quot;why&quot;:&quot;Without it, the mirroring time is unknown, so freshness or scheduling cannot be assessed.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:58.084445018+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <column autoUpdated="false" defaultValue="null" digits="6" id="12" name="cleaned_at" nullable="true" remarks="{&quot;what&quot;:&quot;Timestamp when the file was cleaned, if cleaned.&quot;,&quot;why&quot;:&quot;Without it, it's unknown whether and when cleanup occurred, leaving retention ambiguous.&quot;,&quot;by&quot;:&quot;fleet-annotator-worker&quot;,&quot;at&quot;:&quot;2026-09-23T00:13:58.110191820+00:00&quot;}" size="35" type="timestamptz" typeCode="93"/>
         <primaryKey column="id" sequenceNumberInPK="1"/>
         <index name="tracked_files_pkey" unique="true">
            <column ascending="true" name="id"/>
         </index>
         <index name="idx_tf_session" unique="false">
            <column ascending="true" name="session_uuid"/>
         </index>
         <index name="idx_tf_source" unique="false">
            <column ascending="true" name="source_path"/>
         </index>
         <index name="tracked_files_session_uuid_source_path_content_hash_key" unique="true">
            <column ascending="true" name="session_uuid"/>
            <column ascending="true" name="source_path"/>
            <column ascending="true" name="content_hash"/>
         </index>
      </table>
   </tables>
</database>
