omnius 1.0.866 → 1.0.867

package/docs/DISCOVERY.json

@@ -10367,7 +10367,7 @@
       "id": "api.v1-media-file",
       "kind": "api",
       "title": "/v1/media/file",
-      "summary": "Stream one generated media file — query {kind, name}",
+      "summary": "Stream an exact owned gallery file — query {kind,name}; Validate an exact gallery identity and MIME before acquisition; Delete only a selected saved gallery file and matching metadata",
       "aliases": [
         "/v1/media/file"
       ],
@@ -10375,6 +10375,8 @@
         "rest",
         "openapi",
         "GET",
+        "HEAD",
+        "DELETE",
         "Media",
         "v1",
         "media",
@@ -10392,6 +10394,14 @@
           "type": "rest",
           "target": "GET /v1/media/file"
         },
+        {
+          "type": "rest",
+          "target": "HEAD /v1/media/file"
+        },
+        {
+          "type": "rest",
+          "target": "DELETE /v1/media/file"
+        },
         {
           "type": "openapi",
           "target": "/openapi.json"
@@ -10410,14 +10420,16 @@
         }
       ],
       "methods": [
-        "GET"
+        "GET",
+        "HEAD",
+        "DELETE"
       ],
       "tags": [
         "Media"
       ],
       "operations": {
         "get": {
-          "summary": "Stream one generated media file — query {kind, name}",
+          "summary": "Stream an exact owned gallery file — query {kind,name}",
           "tags": [
             "Media"
           ],
@@ -10443,10 +10455,93 @@
             "200": {
               "description": "Media bytes"
             },
+            "400": {
+              "description": "Unsafe kind, basename or link"
+            },
             "404": {
               "description": "Not found"
             }
           }
+        },
+        "head": {
+          "summary": "Validate an exact gallery identity and MIME before acquisition",
+          "tags": [
+            "Media"
+          ],
+          "parameters": [
+            {
+              "name": "kind",
+              "in": "query",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            },
+            {
+              "name": "name",
+              "in": "query",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            }
+          ],
+          "responses": {
+            "200": {
+              "description": "Metadata headers without body"
+            },
+            "404": {
+              "description": "Not found"
+            }
+          }
+        },
+        "delete": {
+          "summary": "Delete only a selected saved gallery file and matching metadata",
+          "tags": [
+            "Media"
+          ],
+          "parameters": [
+            {
+              "name": "kind",
+              "in": "query",
+              "required": true,
+              "schema": {
+                "type": "string",
+                "enum": [
+                  "image",
+                  "video",
+                  "audio",
+                  "music"
+                ]
+              }
+            },
+            {
+              "name": "name",
+              "in": "query",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Run/admin scope; exact basename, no traversal/symlinks. Receipt scope gallery-only; source/work copies, other previews and weights remain.",
+          "responses": {
+            "200": {
+              "description": "Deletion scope, bytes and metadata receipt"
+            },
+            "400": {
+              "description": "Unsafe identity or metadata"
+            },
+            "403": {
+              "description": "Insufficient scope"
+            },
+            "404": {
+              "description": "Not found"
+            },
+            "409": {
+              "description": "Busy store or reader"
+            }
+          }
         }
       },
       "source_of_truth": [
@@ -10983,20 +11078,391 @@
         }
       ],
       "methods": [
-        "GET"
+        "GET"
+      ],
+      "tags": [
+        "Media"
+      ],
+      "operations": {
+        "get": {
+          "summary": "Status of the in-flight (or last) media-store relocation job",
+          "tags": [
+            "Media"
+          ],
+          "responses": {
+            "200": {
+              "description": "Relocation job status + progress"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-media-store",
+      "kind": "api",
+      "title": "/v1/media/store",
+      "summary": "Resolved media/model/gallery roots and disk information",
+      "aliases": [
+        "/v1/media/store"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "GET",
+        "Media",
+        "v1",
+        "media",
+        "store"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "GET /v1/media/store"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "GET"
+      ],
+      "tags": [
+        "Media"
+      ],
+      "operations": {
+        "get": {
+          "summary": "Resolved media/model/gallery roots and disk information",
+          "tags": [
+            "Media"
+          ],
+          "parameters": [
+            {
+              "name": "scanLegacy",
+              "in": "query",
+              "schema": {
+                "type": "string",
+                "enum": [
+                  "1"
+                ]
+              },
+              "description": "Explicit legacy-cache scan; omitted counts are unknown, not zero."
+            }
+          ],
+          "responses": {
+            "200": {
+              "description": "Store + disk information; optional legacy-cache report"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-media-video",
+      "kind": "api",
+      "title": "/v1/media/video",
+      "summary": "Generate a video — body {prompt, model?, backend?, num_frames?, fps?, width?, height?, steps?, guidance?, seed?}",
+      "aliases": [
+        "/v1/media/video"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "POST",
+        "Media",
+        "v1",
+        "media",
+        "video"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "POST /v1/media/video"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "POST"
+      ],
+      "tags": [
+        "Media"
+      ],
+      "operations": {
+        "post": {
+          "summary": "Generate a video — body {prompt, model?, backend?, num_frames?, fps?, width?, height?, steps?, guidance?, seed?}",
+          "tags": [
+            "Media"
+          ],
+          "responses": {
+            "200": {
+              "description": "Generated video path + gallery URL"
+            },
+            "400": {
+              "description": "Missing prompt"
+            },
+            "403": {
+              "description": "Insufficient scope"
+            },
+            "502": {
+              "description": "Generation failed"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-media-weights",
+      "kind": "api",
+      "title": "/v1/media/weights",
+      "summary": "Inspect an exact media model's actual cache paths, physical bytes, known dependencies, sharing and supported actions; Delete an exact cached dependency while retaining its catalog entry",
+      "aliases": [
+        "/v1/media/weights"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "GET",
+        "DELETE",
+        "Media",
+        "v1",
+        "media",
+        "weights"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "GET /v1/media/weights"
+        },
+        {
+          "type": "rest",
+          "target": "DELETE /v1/media/weights"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "GET",
+        "DELETE"
+      ],
+      "tags": [
+        "Media"
+      ],
+      "operations": {
+        "get": {
+          "summary": "Inspect an exact media model's actual cache paths, physical bytes, known dependencies, sharing and supported actions",
+          "tags": [
+            "Media"
+          ],
+          "parameters": [
+            {
+              "name": "kind",
+              "in": "query",
+              "required": true,
+              "schema": {
+                "type": "string",
+                "enum": [
+                  "image",
+                  "video",
+                  "audio",
+                  "music"
+                ]
+              }
+            },
+            {
+              "name": "model",
+              "in": "query",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Existing bytes are cached, not proof of installation. Ready means a previously checksum-verified pinned snapshot remains size-complete; no runtime is loaded.",
+          "responses": {
+            "200": {
+              "description": "Weight inventory and most recent job"
+            },
+            "404": {
+              "description": "Unknown catalog model"
+            }
+          }
+        },
+        "delete": {
+          "summary": "Delete an exact cached dependency while retaining its catalog entry",
+          "tags": [
+            "Media"
+          ],
+          "description": "Run/admin scope. JSON {kind,model,repository,allowShared?}. Shared dependencies require explicit allowShared:true. Media operations/readers block deletion. Only owned HF cache directories are removed.",
+          "responses": {
+            "200": {
+              "description": "Cached-weight deletion receipt with paths and bytes"
+            },
+            "400": {
+              "description": "Invalid dependency identity"
+            },
+            "403": {
+              "description": "Insufficient scope"
+            },
+            "409": {
+              "description": "Busy or unconfirmed shared dependency"
+            },
+            "422": {
+              "description": "Unsupported provider"
+            }
+          }
+        }
+      },
+      "source_of_truth": [
+        "GET /openapi.json",
+        "packages/cli/src/api/openapi.ts"
+      ]
+    },
+    {
+      "id": "api.v1-media-weights-download",
+      "kind": "api",
+      "title": "/v1/media/weights/download",
+      "summary": "Start or reattach a durable network/disk-only weight download",
+      "aliases": [
+        "/v1/media/weights/download"
+      ],
+      "keywords": [
+        "rest",
+        "openapi",
+        "POST",
+        "Media",
+        "v1",
+        "media",
+        "weights",
+        "download"
+      ],
+      "maturity": "stable",
+      "layer": "interface",
+      "audiences": [
+        "integrator",
+        "service-agent",
+        "coding-agent"
+      ],
+      "interfaces": [
+        {
+          "type": "rest",
+          "target": "POST /v1/media/weights/download"
+        },
+        {
+          "type": "openapi",
+          "target": "/openapi.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "source",
+          "target": "packages/cli/src/api/openapi.ts",
+          "relation": "openapi-source"
+        },
+        {
+          "type": "documentation",
+          "target": "docs/reference/rest-api.md",
+          "relation": "endpoint-inventory"
+        }
+      ],
+      "methods": [
+        "POST"
       ],
       "tags": [
         "Media"
       ],
       "operations": {
-        "get": {
-          "summary": "Status of the in-flight (or last) media-store relocation job",
+        "post": {
+          "summary": "Start or reattach a durable network/disk-only weight download",
           "tags": [
             "Media"
           ],
+          "description": "Run/admin scope. JSON {kind,model}. Complete pinned HF snapshots (including variants), file checksums and active-job deduplication. No prewarm, Python, CUDA, inference or automatic eviction.",
           "responses": {
-            "200": {
-              "description": "Relocation job status + progress"
+            "202": {
+              "description": "Job ID/state and known byte progress"
+            },
+            "403": {
+              "description": "Insufficient scope"
+            },
+            "409": {
+              "description": "Busy store"
+            },
+            "422": {
+              "description": "Unsupported provider"
             }
           }
         }
@@ -11007,12 +11473,12 @@
       ]
     },
     {
-      "id": "api.v1-media-store",
+      "id": "api.v1-media-weights-jobs-id",
       "kind": "api",
-      "title": "/v1/media/store",
-      "summary": "Media-store root + disk usage plus any legacy per-group caches still reclaimable",
+      "title": "/v1/media/weights/jobs/{id}",
+      "summary": "Read durable download state and restart interruption status",
       "aliases": [
-        "/v1/media/store"
+        "/v1/media/weights/jobs/{id}"
       ],
       "keywords": [
         "rest",
@@ -11021,7 +11487,9 @@
         "Media",
         "v1",
         "media",
-        "store"
+        "weights",
+        "jobs",
+        "{id}"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -11033,7 +11501,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "GET /v1/media/store"
+          "target": "GET /v1/media/weights/jobs/{id}"
         },
         {
           "type": "openapi",
@@ -11060,13 +11528,26 @@
       ],
       "operations": {
         "get": {
-          "summary": "Media-store root + disk usage plus any legacy per-group caches still reclaimable",
+          "summary": "Read durable download state and restart interruption status",
           "tags": [
             "Media"
           ],
+          "parameters": [
+            {
+              "name": "id",
+              "in": "path",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            }
+          ],
           "responses": {
             "200": {
-              "description": "Store + disk + legacy-cache report"
+              "description": "Queued/running/done/error/interrupted/cancelled state, byte progress and errors"
+            },
+            "404": {
+              "description": "Job not found for this store"
             }
           }
         }
@@ -11077,12 +11558,12 @@
       ]
     },
     {
-      "id": "api.v1-media-video",
+      "id": "api.v1-media-weights-jobs-id-cancel",
       "kind": "api",
-      "title": "/v1/media/video",
-      "summary": "Generate a video — body {prompt, model?, backend?, num_frames?, fps?, width?, height?, steps?, guidance?, seed?}",
+      "title": "/v1/media/weights/jobs/{id}/cancel",
+      "summary": "Cancel a local daemon-owned weight download",
       "aliases": [
-        "/v1/media/video"
+        "/v1/media/weights/jobs/{id}/cancel"
       ],
       "keywords": [
         "rest",
@@ -11091,7 +11572,10 @@
         "Media",
         "v1",
         "media",
-        "video"
+        "weights",
+        "jobs",
+        "{id}",
+        "cancel"
       ],
       "maturity": "stable",
       "layer": "interface",
@@ -11103,7 +11587,7 @@
       "interfaces": [
         {
           "type": "rest",
-          "target": "POST /v1/media/video"
+          "target": "POST /v1/media/weights/jobs/{id}/cancel"
         },
         {
           "type": "openapi",
@@ -11130,22 +11614,30 @@
       ],
       "operations": {
         "post": {
-          "summary": "Generate a video — body {prompt, model?, backend?, num_frames?, fps?, width?, height?, steps?, guidance?, seed?}",
+          "summary": "Cancel a local daemon-owned weight download",
           "tags": [
             "Media"
           ],
+          "parameters": [
+            {
+              "name": "id",
+              "in": "path",
+              "required": true,
+              "schema": {
+                "type": "string"
+              }
+            }
+          ],
+          "description": "Run/admin scope. Poll until cancellation settles; complete verified files can be reused.",
           "responses": {
-            "200": {
-              "description": "Generated video path + gallery URL"
-            },
-            "400": {
-              "description": "Missing prompt"
+            "202": {
+              "description": "Cancellation requested"
             },
             "403": {
               "description": "Insufficient scope"
             },
-            "502": {
-              "description": "Generation failed"
+            "409": {
+              "description": "Owned by another process"
             }
           }
         }
@@ -29431,6 +29923,136 @@
         }
       ]
     },
+    {
+      "id": "guide.design-dashboard-reconstruction-plan",
+      "kind": "guide",
+      "title": "Dashboard reconstruction plan",
+      "summary": "2026-10-16 · source implementation only; publishing remains with the user.",
+      "keywords": [
+        "design",
+        "dashboard",
+        "reconstruction",
+        "plan",
+        "md"
+      ],
+      "maturity": "stable",
+      "audiences": [
+        "user",
+        "integrator",
+        "coding-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/design/dashboard-reconstruction-plan.md"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/design/dashboard-reconstruction-plan.md",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
+    {
+      "id": "guide.design-dashboard-styleguide",
+      "kind": "guide",
+      "title": "Omnius browser instrument design system",
+      "summary": "Version 1 · 2026-10-16 · implementation contract",
+      "keywords": [
+        "design",
+        "dashboard",
+        "styleguide",
+        "md"
+      ],
+      "maturity": "stable",
+      "audiences": [
+        "user",
+        "integrator",
+        "coding-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/design/dashboard-styleguide.md"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/design/dashboard-styleguide.md",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
+    {
+      "id": "guide.design-dashboard-todo-uppercase",
+      "kind": "guide",
+      "title": "Dashboard reconstruction — durable TODO",
+      "summary": "Updated: 2026-10-16. Contract: styleguide. Scope and sequence: plan.",
+      "keywords": [
+        "design",
+        "dashboard",
+        "TODO",
+        "md"
+      ],
+      "maturity": "stable",
+      "audiences": [
+        "user",
+        "integrator",
+        "coding-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/design/dashboard-TODO.md"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/design/dashboard-TODO.md",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
+    {
+      "id": "guide.design-media-unification-todo-uppercase",
+      "kind": "guide",
+      "title": "Next phase: media storage and generation interface unification",
+      "summary": "Requested 2026-10-16. Queued after the current browser dashboard reconstruction; do not divert the current delivery into this work. These items are not implemented or verified by the dashboard reconstruction receipt.",
+      "keywords": [
+        "design",
+        "media",
+        "unification",
+        "TODO",
+        "md"
+      ],
+      "maturity": "stable",
+      "audiences": [
+        "user",
+        "integrator",
+        "coding-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/design/media-unification-TODO.md"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/design/media-unification-TODO.md",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
     {
       "id": "guide.discovery-agent-map",
       "kind": "guide",
@@ -33198,6 +33820,76 @@
         }
       ]
     },
+    {
+      "id": "guide.work-orders-evidence-dashboard-browser-reconstruction-20261016",
+      "kind": "guide",
+      "title": "Dashboard Browser Reconstruction 20261016",
+      "summary": "Bundled Omnius documentation artifact: docs/work-orders/evidence/dashboard-browser-reconstruction-20261016.json.",
+      "keywords": [
+        "work",
+        "orders",
+        "evidence",
+        "dashboard",
+        "browser",
+        "reconstruction",
+        "20261016",
+        "json"
+      ],
+      "maturity": "internal",
+      "audiences": [
+        "maintainer",
+        "large-context-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/work-orders/evidence/dashboard-browser-reconstruction-20261016.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/work-orders/evidence/dashboard-browser-reconstruction-20261016.json",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
+    {
+      "id": "guide.work-orders-evidence-dashboard-media-management-20261016",
+      "kind": "guide",
+      "title": "Dashboard Media Management 20261016",
+      "summary": "Bundled Omnius documentation artifact: docs/work-orders/evidence/dashboard-media-management-20261016.json.",
+      "keywords": [
+        "work",
+        "orders",
+        "evidence",
+        "dashboard",
+        "media",
+        "management",
+        "20261016",
+        "json"
+      ],
+      "maturity": "internal",
+      "audiences": [
+        "maintainer",
+        "large-context-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/work-orders/evidence/dashboard-media-management-20261016.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/work-orders/evidence/dashboard-media-management-20261016.json",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
     {
       "id": "guide.work-orders-evidence-desktop-indicator-registration-20261016",
       "kind": "guide",
@@ -35342,6 +36034,42 @@
         }
       ]
     },
+    {
+      "id": "guide.work-orders-evidence-native-straight-boundaries-verification-20261016",
+      "kind": "guide",
+      "title": "Native Straight Boundaries Verification 20261016",
+      "summary": "Bundled Omnius documentation artifact: docs/work-orders/evidence/native-straight-boundaries-verification-20261016.json.",
+      "keywords": [
+        "work",
+        "orders",
+        "evidence",
+        "native",
+        "straight",
+        "boundaries",
+        "verification",
+        "20261016",
+        "json"
+      ],
+      "maturity": "internal",
+      "audiences": [
+        "maintainer",
+        "large-context-agent"
+      ],
+      "layer": "documentation",
+      "interfaces": [
+        {
+          "type": "file",
+          "target": "docs/work-orders/evidence/native-straight-boundaries-verification-20261016.json"
+        }
+      ],
+      "references": [
+        {
+          "type": "documentation",
+          "target": "docs/work-orders/evidence/native-straight-boundaries-verification-20261016.json",
+          "relation": "canonical-artifact"
+        }
+      ]
+    },
     {
       "id": "guide.work-orders-evidence-native-tui-committed-scope-20261015",
       "kind": "guide",