added asset workspace working with packer

This commit is contained in:
2026-03-24 13:42:43 +00:00
parent 1f6df50f09
commit ebbfe311ee
71 changed files with 2800 additions and 711 deletions
@@ -45,8 +45,8 @@ The `Assets` workspace is a Studio view over packer services.
The workspace must assume:
- managed assets are the primary unit of identity and operation;
- orphan declarations may exist and must remain visible;
- registered and unregistered assets may coexist inside `assets/`;
- unregistered assets remain visible but excluded from builds;
- assets may aggregate many internal inputs;
- runtime-facing output contract data exists for each asset;
- diagnostics, activity, progress, and staged mutation responses are available from Studio-facing services.
@@ -62,7 +62,7 @@ The `Assets` workspace is:
The workspace must help the user understand:
- what the managed asset is;
- what the asset registration and build status are;
- where the asset root lives;
- which internal inputs belong to that asset;
- what the asset declares toward the runtime-facing contract;
@@ -93,7 +93,8 @@ Filesystem structure may be visible and actionable as supporting context, but it
- The left navigation surface must be a custom `Asset Tree` / `Asset Navigator`.
- Asset nodes must expose strong visual semantics through icons, badges, and state styling.
- Asset nodes must surface:
- managed/orphan state,
- registration status,
- build participation,
- diagnostics presence,
- preload intent,
- and broad asset family or type where available.
@@ -102,8 +103,8 @@ Filesystem structure may be visible and actionable as supporting context, but it
### Filters and Search
- The baseline filters are:
- `Managed`
- `Orphan`
- `Registered`
- `Unregistered`
- `Diagnostics`
- `Preload`
- The navigator must support textual search.
@@ -112,11 +113,22 @@ Filesystem structure may be visible and actionable as supporting context, but it
- asset root path
- path context
### Workspace Actions
- Workspace-scoped actions must appear above the main asset workspace split, not inside the navigator list region.
- Workspace-scoped actions must not be mixed into the selected-asset details surface.
- Workspace actions should remain visible without requiring a selected asset.
- Global asset-manager actions such as `Add Asset`, `Doctor`, and `Pack` belong to this workspace-level action area.
### Navigator Actions
- Navigator-local controls may include search and filters that are specifically about asset discovery and navigation.
### Selection Rules
- The baseline navigator is single-select.
- Managed asset selection must be preserved by `asset_id`.
- Orphan selection must be preserved by asset root path until the asset becomes managed.
- Registered asset selection must be preserved by `asset_id`.
- Unregistered selection must be preserved by asset root path until the asset becomes registered.
- If an asset changes state while preserving identity, selection must remain attached to it.
- If the selected asset is removed from the navigator, selection must clear explicitly.
- Selection must never silently drift to another asset due to refresh ordering.
@@ -127,8 +139,8 @@ Filesystem structure may be visible and actionable as supporting context, but it
- The navigator must define explicit `no assets` state.
- The navigator must define explicit `no results` state.
- The navigator must define explicit `workspace error` state.
- Orphan assets must appear in the same navigator flow as managed assets.
- Orphan styling must communicate `declared, not managed`, not `broken`.
- Unregistered assets must appear in the same navigator flow as registered assets.
- Unregistered styling must communicate `present but not yet registered`, not `broken`.
### Inputs Expansion
@@ -137,22 +149,22 @@ Filesystem structure may be visible and actionable as supporting context, but it
## Selected Asset Details Rules
The selected asset view must use this fixed section order:
The selected asset view must use this stable composition:
1. `Summary`
1. top row with `Summary` and `Actions` side by side
2. `Runtime Contract`
3. `Inputs / Preview`
4. `Diagnostics`
5. `Actions`
This section order is stable across asset families.
This composition is stable across asset families.
### Summary
- `Summary` must always be present for a selected asset.
- `Summary` must show:
- `asset_name`
- managed/orphan state
- registration status
- build participation
- `asset_id` when available
- family/type
- asset root path
@@ -187,16 +199,21 @@ This section order is stable across asset families.
### Actions
- Actions must be explicit.
- Actions that target the selected asset must appear beside `Summary`, not in the navigator area.
- Safe and routine actions must be visually separated from sensitive mutations.
- Hidden or automatic repair behavior is not allowed in the selected-asset view.
## Action Rules
- Primary actions for managed assets include `Doctor` and `Build`.
- Primary actions for orphan assets include `Adopt`.
- `Register` must remain available when explicit registration is the correct flow.
- Sensitive actions such as `Forget`, `Remove`, and quarantine-like actions must be visually separated from routine actions.
- Registered assets excluded from builds must expose an explicit `Include In Build` action.
- Primary actions for unregistered assets include `Register`.
- `Register` is a direct action in Studio UX. If registration is valid, clicking it must register immediately without an extra acknowledgement step.
- If registration is blocked, Studio may surface the blocking preview inline so the user can inspect why registration cannot proceed.
- Sensitive actions such as `Exclude From Build`, `Remove`, and `Relocate` must be visually separated from routine actions.
- Sensitive actions must not look interchangeable with routine actions.
- `Relocate` must collect an explicit user-chosen destination root before the staged preview is generated.
- Automatic relocation targets are not sufficient Studio UX for `Relocate`.
- `Exclude From Build` and `Remove` must confirm in a modal review surface rather than an inline staged panel.
## Activity, Progress, and Logs Rules
@@ -230,24 +247,25 @@ This section order is stable across asset families.
Sensitive asset mutations are `preview-first`.
The default review surface is an inline staged panel inside the workspace.
The review surface depends on the mutation class.
Modal confirmation is reserved for high-risk final commits such as destructive delete or major relocation.
Inline staged panels are allowed for non-destructive blocked or inspect-only flows.
Modal review and confirmation is required for `Exclude From Build`, `Remove`, and relocation commits.
### Mutations Requiring Preview
- `Adopt`
- `Forget`
- `Exclude From Build`
- `Remove`
- `Quarantine`
- relocational changes such as move or rename of asset roots
- batch operations
`Doctor` and `Build` remain outside this sensitive mutation staging flow.
Navigator-level `Doctor` and `Pack`, plus asset-level `Include In Build` and successful `Register`, remain outside this sensitive mutation staging flow.
### Preview Content
- Preview must show affected assets.
- Relocation preview must show the planned target root chosen by the user.
- Preview must show proposed actions.
- Preview must distinguish registry impact from workspace impact.
- Preview must show blockers, warnings, and safe fixes as separate visual sections.