solo-artifacts

Warm Archive fork of work-canvas: produce or publish one self-contained HTML file that renders a Solo task/thread for a human to understand and act on. Prefer the real deliverable over a summary page.

Workflow

1. Publish Existing Deliverable if the current task/run names one.

Trust only explicit current-task evidence, such as:

text Deliverable: ./path/to/result.html

You may also use a file path named in the current task/thread, or a file you personally created for this task now. Do not scan the workspace by newest file, mtime, or vague filename match; old workspace files can be stale. If several files are named, prefer the product/final deliverable over review/report/panel files unless the user explicitly asks for the review page. Do not switch to review-decision just because the task is in_review.

• Existing .html: publish it directly.

bash solo artifact publish --task <task-id> --mode <latest|final> --file <path-to-html>

• Existing .md, .txt, .json, .csv, or other text/data: create a small self-contained HTML viewer that renders the exact source content, labels the source file near the top, then publish that wrapper. Do not summarize or rewrite the content.
• Multiple deliverables or a directory: create a small index artifact with explicit links/file names and a short note about what each file is.

If a real deliverable exists, stop here.

1. Pick the artifact type and read its reference:

| The task needs to... | Type | Read | |---|---|---| | Show where long/messy work stands, what broke, what's next | Progress / status report | references/progress-report.md | | Review analysis or implementation and decide accept/reject/next step | Review / decision memo | references/review-decision.md | | Weigh options head-to-head and pick a winner | Comparison / leaderboard | references/comparison.md |

If blended, lead with the primary type and borrow blocks from the other.

1. Assemble from the template. Copy assets/starter.html, then:

• Replace [[PASTE base.css]] with the full contents of assets/base.css.
• Replace [[PASTE interactions.js]] with only the needed modules from assets/interactions.js; pasting the whole file is fine because modules self-guard.
• Fill the header, What needs your input, and body sections using the component recipes in the chosen reference.

1. Embed everything: inline CSS/JS, embed media as data: URIs, no CDN or external requests.

1. Publish back to Solo:

bash solo artifact publish --task <task-id> --mode <latest|final> --file <path-to-html>

Non-Negotiables

• Keep work-canvas structure and interactions intact; use Solo's default Warm Archive visual skin.
• Real deliverables beat summaries. Never replace an explicit deliverable file with a conversation recap.
• Surface only real human decisions. If nothing needs the user, say so.
• Add a legend wherever color, letters, or symbols encode meaning.
• Never modify Solo/source data from the page. Show paste-ready output with copy buttons.
• Include a provenance footer with task id, thread/channel scope, agent, model, and generation date when available.

Files

• assets/starter.html — the skeleton to copy.
• assets/base.css — class-compatible Solo Warm Archive design system.
• assets/interactions.js — optional vanilla-JS modules: print, tabs, tables, lightbox, copy, scrollspy, persist.
• references/*.md — work-canvas section order, component recipes, and guardrails.