Force-fix literal Asset none renderer path for SVG Asset Studio - PR 11.158. Fix active shared asset tile renderer for SVG Asset Studio - PR 11.159. and Fix shared shell SVG Asset Studio asset badge compatibility - PR 11.160. Wire SVG direct payload metadata into shared asset badge - PR 11.161. Wire SVG payload asset label into shared shell badge and track dead badge wiring - PR 11.162. Trace SVG badge handoff ownership before further changes - PR 11.163. Create dead-code ledger and revert map for badge-fix churn since 11.159 - PR 11.164. Audit failed SVG tile fix lane from PR 11.154 and create dead code revert map - PR 11.164. Run Codex for PR_11_165 - enforce badge ownership model. Fix hosted SVG badge clear-order so Workspace Manager handoff survives iframe shell init - PR 11.166. Use hosted session context as SVG badge source of truth instead of shared handoff - PR 11.167. Introduce contract-first workspace shell for hosted SVG asset state - PR 11.169. Create independent contract-first workspace shell for hosted SVG asset state - PR 11.169. Wire Workspace Manager SVG tile to workspace shell normalized state - PR 11.170. Add full trace logging for SVG tile write paths to identify overwrite source - PR 11.171. Disable platform badge writer for hosted SVG and update tile from workspace shell state - PR 11.172. Wire SVG hosted entry directly to workspace shell state - PR 11.174. Force SVG hosted entry to bypass platformShell via early-exit execution control - PR 11.175. Remove legacy platformShell badge row for hosted Workspace tools - PR 11.176. Remove shared dependency model; enforce SVG contract-first loading - PR 11.177. Disable assetUsageIntegration in hosted mode to remove global overwrite path - PR 11.178. Write hosted SVG tile state from workspace shell contract only - PR 11.179.

Author: DavidQ

docs/dev/codex_commands.md

@@ -1,67 +1,13 @@
-# CODEX COMMANDS
 
-Model: GPT-5.3-codex
+Model: GPT-5.4
 Reasoning: high
 
-STRICT SCOPE MODE
+Disable assetUsageIntegration in hosted mode.
 
-ALLOWED FILES:
-- tools/workspace-manager/main.js
-- docs/dev/reports/literal_asset_none_renderer_11_158.txt
+Modify:
+tools/shared/assetUsageIntegration.js
 
-TASK:
+- Add hosted guard to ALL read/write functions
+- No fallback logic
 
-1. Open:
-   tools/workspace-manager/main.js
-
-2. Search for every occurrence of:
-   - Asset:
-   - none
-   - textContent
-   - innerHTML
-   - appendChild
-   - assetLabel
-   - assetStatus
-   - assetSummary
-   - svg-asset-studio
-
-3. Identify the exact active branch that creates the visible line:
-   Asset: none
-
-4. Patch that branch so when:
-   workspaceManifest.tools["svg-asset-studio"].vectorAssetDocument.svgText
-   exists, the visible output is:
-   Asset: sample-0901-ship.svg
-   or:
-   Asset: Inline SVG
-
-5. If the active branch cannot be proven statically, add a temporary diagnostic that fires ONLY when:
-   svg-asset-studio renders Asset: none
-
-6. DO NOT:
-   - modify schemas
-   - modify samples
-   - modify SVG Asset Studio
-   - modify runtime host
-   - modify unrelated tools
-   - add fallback/default/demo data
-   - transform/wrap/normalize payload
-
-7. Validate:
-   - node --check tools/workspace-manager/main.js
-   - git diff --name-only contains only ALLOWED FILES
-
-8. Write:
-   docs/dev/reports/literal_asset_none_renderer_11_158.txt
-
-Report MUST include:
-- exact occurrences searched
-- exact old branch
-- exact new branch
-- expected visible output
-- diagnostic status
-- why prior PRs missed it
-- validation result
-
-9. Package Codex output ZIP at:
-   tmp/PR_11_158_FORCE_FIX_LITERAL_ASSET_NONE_RENDERER.zip
+Validate with node --check

docs/dev/commit_comment.txt

@@ -1 +1 @@
-Force-fix literal Asset none renderer path for SVG Asset Studio - PR 11.158
+Disable assetUsageIntegration in hosted mode to remove global overwrite path - PR 11.178

docs/dev/reports/active_asset_tile_renderer_11_159.txt

@@ -0,0 +1,61 @@
+Task: active_asset_tile_renderer_11_159
+Date: 2026-04-30
+
+Files searched (inspect-only set):
+- tools/Workspace Manager/main.js (searched)
+- tools/workspace-manager/main.js (no match)
+- tools/shared/platformShell.js (searched)
+- tools/shared/toolRegistry.js (no match)
+- tools/shared/toolLaunchState.js (no match)
+- tools/shared/toolCard*.js (no match)
+- tools/shared/*card*.js (no match)
+- tools/shared/*tile*.js (no match)
+- tools/index*.js (no match)
+- tools/index.html (inspected target context)
+
+Active renderer file/function:
+- File: tools/shared/platformShell.js
+- Function: renderToolAssetBadge(toolId)
+- Render line source:
+  `<span ...>${escapeHtml(`Asset: ${assetLabel}`)}</span>`
+
+Exact old value source (causing visible `Asset: none`):
+- In renderToolAssetBadge:
+  - `const missingAssetLabel = normalizedToolId === "skin-editor" ? "select skin in Asset Browser" : "none";`
+  - `const assetLabelBasis = embeddedPayloadSummary || missingAssetLabel;`
+  - `const assetLabel = compatibleAsset?.displayName || assetLabelBasis;`
+- For svg-asset-studio, when shared handoff and embedded summary were both unavailable, branch fell through to `missingAssetLabel` => `none`.
+
+Exact new value source (patched):
+- Added helper in same renderer file:
+  - `readSvgAssetLabelFromManifestPayload(manifestPayload)`
+  - Reads direct data path:
+    `manifestPayload.tools["svg-asset-studio"].vectorAssetDocument.sourceName`
+  - If sourceName missing but svgText exists:
+    `Inline SVG`
+- Updated renderToolAssetBadge (svg-only):
+  - `const manifestSvgLabel = normalizedToolId === "svg-asset-studio" ? readSvgAssetLabelFromManifestPayload(getManifest()) : "";`
+  - `const assetLabelBasis = embeddedPayloadSummary || manifestSvgLabel || missingAssetLabel;`
+
+Why PR 11.158 missed it:
+- PR 11.158 patched Workspace Manager-side status plumbing.
+- The literal visible text `Asset: ...` is actually rendered in shared renderer `tools/shared/platformShell.js`.
+- Without patching this renderer fallback chain, it could still select `missingAssetLabel` (`none`) even when direct SVG manifest data existed.
+
+Expected visible text:
+- `Asset: sample-0901-ship.svg` when sourceName exists.
+- `Asset: Inline SVG` when svgText exists but sourceName is missing.
+
+Diagnostic status:
+- Temporary diagnostic not added.
+- Active renderer branch was proven statically and patched directly.
+
+Validation result:
+- node --check tools/shared/platformShell.js -> PASS
+- Static trace confirms active renderer maps direct manifest SVG fields into asset label -> PASS
+- Sample 1902 static payload projection -> PASS
+  - has svgText: true
+  - sourceName: sample-0901-ship.svg
+  - projected visible line: Asset: sample-0901-ship.svg
+- git diff --name-only -- tools/shared/platformShell.js docs/dev/reports/active_asset_tile_renderer_11_159.txt -> PASS
+- Note: repo has unrelated pre-existing dirty files outside this task scope.

docs/dev/reports/pr_11_162_dead_wiring_report.txt

@@ -0,0 +1,46 @@
+PR 11.162 Dead Wiring Report
+
+Scope
+- File inspected/updated: tools/shared/platformShell.js
+- Path focus: shared shell asset badge derivation for svg-asset-studio (`renderToolAssetBadge`)
+
+Dead/Unused Branches Found In Touched Path
+1) Branch: SVG badge label from workspace manifest payload (`readSvgAssetLabelFromManifestPayload` + `manifestSvgLabel` usage)
+- Status: Removed
+- Reason: Badge derivation is constrained to launch-time SVG payload fields, not legacy manifest-fallback wiring.
+
+2) Branch: SVG badge fallback to generic embedded summary text (`embeddedPayloadSummary` for svg-asset-studio)
+- Status: Removed for svg-asset-studio path, retained for non-SVG tools
+- Reason: Produced summary-form labels instead of direct SVG payload-derived labels.
+
+3) Branch: SVG badge title source "Resolved from workspace manifest payload" (legacy branch)
+- Status: Removed
+- Reason: Depended on removed legacy manifest label wiring.
+
+Retained Branches In Touched Path
+1) Branch: Hosted shared-context SVG derivation
+- Status: Left in place
+- Reason: Uses real launch payload fields (`sharedContext.payloadJson.vectorAssetDocument.sourceName` / `svgText`).
+
+2) Branch: Workspace-scoped preset SVG derivation
+- Status: Left in place
+- Reason: Covers scoped preset payload flow when `workspaceScopedToolPresetForStatus` is available.
+
+3) Branch: Direct workspace manifest preset SVG derivation (`tools["svg-asset-studio"].vectorAssetDocument`)
+- Status: Left in place
+- Reason: Required for Sample 1902 shape where the tool entry does not carry a `tool` wrapper field and would otherwise be rejected by scoped-preset selection.
+
+4) Branch: Missing asset label fallback (`none`)
+- Status: Left in place
+- Reason: Required missing-data behavior for generic badge rendering.
+
+Implementation Summary
+- SVG badge derivation now resolves in this order:
+  1) compatible shared asset handoff label (existing behavior)
+  2) hosted shared-context SVG payload label
+  3) workspace-scoped preset SVG payload label
+  4) direct workspace manifest preset SVG payload label
+  5) `none`
+- Source field used for expected result: `vectorAssetDocument.sourceName`.
+- If `sourceName` is absent but `svgText` exists, label resolves to `Inline SVG`.
+- No schema/sample/payload-contract changes were made.

docs/dev/reports/pr_11_162_evidence_template.txt

@@ -0,0 +1,15 @@
+# PR 11.162 Evidence Template
+
+Codex must replace this template with execution evidence.
+
+Required results:
+- node --check tools/shared/platformShell.js: PASS/FAIL
+- sample 1902 Workspace Manager launch: PASS/FAIL
+- SVG Asset Studio badge text: expected `Asset: sample-0901-ship.svg`
+- schema files changed: expected NO
+- sample JSON changed: expected NO
+- dead/unused badge wiring tracked: expected YES
+
+Full samples smoke test:
+- skipped unless shared loader behavior changed beyond asset badge derivation
+- reason required

docs/dev/reports/pr_11_163_delivery_manifest.md

@@ -0,0 +1,10 @@
+# PR 11.163 Delivery Manifest
+
+## Files
+- docs/pr/PR_11_163_FREEZE_BADGE_CHURN_AND_TRACE_HANDOFF.md
+- docs/dev/codex_commands.md
+- docs/dev/commit_comment.txt
+- docs/dev/reports/pr_11_163_delivery_manifest.md
+
+## Full Samples Smoke
+Skipped. This PR is a trace/freeze bundle and must use targeted inspection only.

docs/dev/reports/pr_11_163_handoff_trace_report.md

@@ -0,0 +1,93 @@
+# PR 11.163 Handoff Trace Report
+
+## Scope And Freeze Outcome
+- Freeze mode respected.
+- No implementation behavior changed in this pass.
+- No schema/sample/SVG Asset Studio/fallback-path edits were made for PR 11.163.
+
+## Validation Commands Run
+- `git status --short`
+- `git diff --name-only HEAD`
+- targeted `rg` on: `Asset: none`, `Asset:`, `sourceName`, `vectorAssetDocument`, badge renderers
+
+## Changed Files Since Last Commit
+From `git diff --name-only HEAD` (tracked changes):
+- `docs/dev/codex_commands.md`
+- `docs/dev/commit_comment.txt`
+- `docs/dev/reports/active_asset_tile_renderer_11_159.txt`
+- `docs/dev/reports/pr_11_162_dead_wiring_report.txt`
+- `docs/dev/reports/pr_11_162_evidence_template.txt`
+- `docs/dev/reports/shared_shell_svg_asset_badge_11_160.txt`
+- `docs/dev/reports/svg_payload_to_shared_asset_badge_11_161.txt`
+- `docs/pr/BUILD_PR_LEVEL_11_159_FIX_ACTIVE_SHARED_ASSET_TILE_RENDERER.md`
+- `docs/pr/BUILD_PR_LEVEL_11_160_FIX_SHARED_SHELL_SVG_ASSET_BADGE_COMPATIBILITY.md`
+- `docs/pr/BUILD_PR_LEVEL_11_161_WIRE_SVG_PAYLOAD_TO_SHARED_ASSET_BADGE.md`
+- `docs/pr/PR_11_162.md`
+- `tools/shared/platformShell.js`
+
+Additional untracked files from `git status --short`:
+- `docs/dev/reports/pr_11_163_delivery_manifest.md`
+- `docs/pr/PR_11_163_FREEZE_BADGE_CHURN_AND_TRACE_HANDOFF.md`
+
+## Exact Renderer Emitting Visible `Asset: none`
+Primary owner path is shared shell (not SVG tool UI, not Workspace Manager tile component):
+- File: `tools/shared/platformShell.js`
+- Function: `renderToolAssetBadge(toolId)`
+- Template emission:
+  - Non-asset tools branch: ``Asset: ${nonAssetLabel}`` (line region ~1449)
+  - Main branch: ``Asset: ${assetLabel}`` (line region ~1483)
+- Call site used in visible tool rows/tiles:
+  - `renderToolLinks(currentToolId)` maps tool rows and calls `renderToolAssetBadge(tool.id)` (line regions ~1581-1584 and ~1644-1646)
+
+Conclusion: the displayed `Asset: none` text is emitted by shared shell tool-row markup in `platformShell.js`.
+
+## Input Contract Read By That Renderer
+`renderToolAssetBadge(toolId)` reads these contracts, in order:
+1. Shared asset handoff from storage:
+- API: `readSharedAssetHandoff()` from `tools/shared/assetUsageIntegration.js`
+- Storage key: `toolboxaid.shared.assetHandoff`
+- Normalized required fields: `assetId`, `sourcePath`
+- Normalized optional fields used by badge logic: `assetType`, `displayName`, `selectedAt`
+- Compatibility check fields in shell: `asset.assetType || asset.kind || asset.type`
+
+2. SVG-specific hosted payload label path:
+- `readToolHostSharedContextFromLocation(window.location)`
+- `hostContext.sharedContext.payloadJson.vectorAssetDocument.sourceName` (or `svgText` => `Inline SVG`)
+
+3. SVG-specific workspace preset label paths currently present in shell:
+- `workspaceScopedToolPresetForStatus.payload.vectorAssetDocument.sourceName` (or `svgText`)
+- direct manifest preset read: `rawPreset.tools["svg-asset-studio"].vectorAssetDocument.sourceName` (or `svgText`)
+
+## Ownership Finding (Who Actually Owns The Badge)
+- Badge/tile text owner: `tools/shared/platformShell.js` shared shell renderer.
+- Workspace Manager role: writes shared handoff (`writeSharedAssetHandoff`) when launching/mounting payloads.
+- SVG Asset Studio role: consumes payload and renders editor/status internally; it does not render the shared shell `Asset:` tile text.
+
+## Why Churn Happened (Observed Contract Mismatch)
+The visible row/tile badge is rendered for many tools via `renderToolLinks(...tool.id...)`, but SVG fallback label sources in shell are page-context globals (`workspaceScopedToolPresetForStatus`, hosted context on current URL), not guaranteed per-row/per-tool inputs.
+
+Net effect:
+- Tool content can load correctly in SVG Asset Studio.
+- Shared shell row badge can still resolve to `none` when row-level renderer does not have a matching per-tool contract instance at render time.
+
+## Smallest Next Recommendation
+Recommended smallest next PR (fix, not rollback):
+1. Keep owner in shared shell.
+2. In `renderToolAssetBadge(toolId)`, for `toolId === "svg-asset-studio"` when shared handoff is absent/incompatible, derive the label from the active workspace manifest per-tool node (row-scoped):
+- `getManifest()?.tools?.[toolId]?.vectorAssetDocument?.sourceName`
+- fallback only to `Inline SVG` when that same node has `svgText`.
+3. Do not alter schemas/samples/SVG tool behavior.
+
+Why this is smallest:
+- Single-file, owner-correct wiring in `tools/shared/platformShell.js`.
+- No contract shape changes.
+- Aligns row renderer input with the same per-tool manifest object already present in workspace state.
+
+## Smallest Rollback Alternative (If Fix Is Deferred)
+If immediate fix is deferred, rollback only the SVG-specific badge derivation additions in `tools/shared/platformShell.js` introduced across PR 11.160-11.162 attempts, while keeping baseline shared handoff behavior intact. Do not perform a broad reset.
+
+## Targeted Validation For Next PR
+- `node --check tools/shared/platformShell.js`
+- launch Sample 1902 -> Workspace Manager path
+- verify `renderToolAssetBadge("svg-asset-studio")` displays `Asset: sample-0901-ship.svg`
+- no full samples smoke

docs/dev/reports/pr_11_164_badge_ownership_map.md

@@ -0,0 +1,51 @@
+# PR 11.164 Badge Ownership Map
+
+## Question
+Who owns the visible `Asset: none` text: Workspace Manager tile state, shared shell badge rendering, or SVG Asset Studio state export?
+
+## Ownership Verdict
+- Primary owner: `tools/shared/platformShell.js`
+- Owner function: `renderToolAssetBadge(toolId)`
+- Owner call sites: `renderToolLinks(currentToolId)` row templates that call `renderToolAssetBadge(tool.id)`
+
+## Exact Emit Path
+1. `renderToolLinks(...)` builds visible tool rows/cards.
+2. Each row calls `renderToolAssetBadge(tool.id)`.
+3. `renderToolAssetBadge` emits template text:
+- `Asset: ${nonAssetLabel}` for non-asset branch.
+- `Asset: ${assetLabel}` for main branch.
+4. When no compatible label resolves, branch fallback becomes `none`, producing visible `Asset: none`.
+
+## Input Contract Consumed By Emitter
+### Contract A: shared handoff storage
+- Reader: `readSharedAssetHandoff()` from `tools/shared/assetUsageIntegration.js`
+- Backing key: `toolboxaid.shared.assetHandoff`
+- Normalized mandatory fields: `assetId`, `sourcePath`
+- Label fields considered by shell: `displayName`, `sourceName`, `name`, `label`, `path`, `sourcePath`
+- Compatibility fields considered: `assetType`, `kind`, `type`
+
+### Contract B: hosted context payload (SVG-specific)
+- Reader: `readToolHostSharedContextFromLocation(window.location)`
+- Path: `sharedContext.payloadJson.vectorAssetDocument.sourceName`
+- Fallback within same payload path: `vectorAssetDocument.svgText -> Inline SVG`
+
+### Contract C: workspace preset-derived SVG label caches (shell-local)
+- Scoped preset path (when available): `workspaceScopedToolPresetForStatus[...].vectorAssetDocument.sourceName`
+- Manifest preset path (shell-local cache): `tools["svg-asset-studio"].vectorAssetDocument.sourceName`
+
+## Responsibility Split
+- Workspace Manager responsibility: write handoff payloads and launch hosted tool context.
+- SVG Asset Studio responsibility: consume SVG payload and render tool UI/status.
+- Shared shell responsibility: render visible tool-row `Asset:` badge text.
+
+## Practical Conclusion
+- The visible `Asset: none` symptom is owned at the shared-shell renderer boundary.
+- Workspace Manager and SVG Asset Studio can both succeed while badge text remains `none` if shared-shell row resolution does not map the active label contract at render time.
+
+## Smallest Next Fix Candidate
+- Restrict next change to `tools/shared/platformShell.js`.
+- For `toolId === "svg-asset-studio"`, resolve label from the active workspace manifest node (`getManifest()?.tools?.[toolId]?.vectorAssetDocument.sourceName`) before generic `none` fallback.
+- Keep contracts unchanged; no schema/sample/SVG payload rewrites.
+
+## Smallest Rollback Candidate
+- If fixing is deferred, rollback only SVG-specific shell label branches added after PR 11.158 while preserving baseline handoff rendering path.

docs/dev/reports/pr_11_164_build_notes.md

@@ -0,0 +1,5 @@
+# PR 11.164 Build Notes
+
+This corrected bundle changes the audit baseline from PR 11.159 to PR 11.154.
+
+No implementation code is included. Codex must generate the actual ledger from the local repository history and working tree.