◈ ASHLIGHT
TASK COMPOSER
v7.5 · Schema v2 · Built April 2026
A block-based project composition tool with a governed AI import pipeline.
Structure your projects, export an agent bundle, let an AI iterate on it, import the result cleanly.
The Diff v2 engine ensures every agent update is safe, reversible, and traceable.
Every block is a system. Every import is a governed merge.
diff v2 engine
undo / redo
workspace tabs
component instances
agent bundle export
audit trail
per-project T3 modal
dev console
🔐
Identity Spine
Every block, subtask, and project has a stable ID assigned at creation — never changed, never reassigned. The Diff v2 engine uses these IDs to match incoming data against the live registry. No duplicates. No silent overwrites.
⟳
Safe Agent Loop
Export a bundle with your project's stable IDs. Agent reads it, updates blocks by ID, returns Tier 2 JSON. Import — diff runs, only changes applied, rest skipped. Ctrl+Z undoes the entire batch. Loop indefinitely without fear.
⊞
Composable Workspace
Above the board sits a composition layer. Workspace tabs hold component instances — file manager, browser, notes — side by side with your project. The board stays pure. The workspace extends freely around it.
◈
Systems, Not Tasks
Every block carries a brief, extended notes, priority, hours, dependencies, subtasks, and a full named asset library. Blocks represent systems — they travel with all their context in every export and agent bundle.
⊡
Automatic Audit Trail
Every status change, edit, import, and archive action is timestamped automatically. The dev console shows every diff event in real time. Export the log as a .txt file. Your agent always sees the full decision history.
📦
Portable by Design
Export any project as a structured ZIP — workspace.json, per-block JSON, text assets as real files, agent instructions. Import it back anywhere. No cloud dependency. No lock-in. Your work travels with you.
Coming Next
Electron Build — full filesystem, webview browser, terminal lane, native file access
Lane Manager + Builder — slot assignment controls, layout templates, component config panels
Agent Lane — embedded AI panel as a workspace component, structured generation via Diff v2
Component Library — card/list view, usage tracking, search, pin common components
DSL + Registry — formal component registry, DSL verb set, macro composition engine
Full Workspace Mode — active workspace takes full screen, composer hidden, focus mode
© Ashlight Systems — All Rights Reserved
Built by Ashlight Systems in collaboration with Claude (Anthropic).
Protected under Australian Copyright Law as an original software work.
Ashlight Task Composer v7.5 — Undergoing active development. Not licensed for redistribution.
All rights reserved pending formal release. For testing and internal use only.
Block Fields
| Field | Purpose | Notes |
|---|
| title | Block name — shown everywhere | Required |
| brief | One-line system description | Shown on card below title |
| notes | Extended context, markdown supported | Shown in system panel |
| status | pending · planned · in progress · done · archive | Controls lane placement |
| priority | critical · high · medium · low | Colours left border of card |
| hours | Effort estimate | Must be numeric |
| category | Domain label — freeform | e.g. core, ui, audio, docs |
| system | core · new · ui · ux · etc. | Coloured system type tag on card |
| dependencies | Names of prerequisite blocks | Live-validated — dims if not found |
| children | Subtasks — 1 level deep max | Each has title, priority, hours, status |
| assets | Named files per block | MD, HTML, PDF, DOCX, IMG, audio, code |
Status Values
| Status | Where it appears | Notes |
|---|
| pending | Staging strip above board | Default for new blocks — awaiting triage |
| planned (todo) | Planned lane | Ready to work on |
| doing | In Progress lane | Currently active |
| done | Done lane | Completed |
| archive | Archive strip | Retired — requires sign-off reason |
Priority Guide
| Priority | Card border | Use for |
|---|
| critical | coral | Blockers and foundations — nothing else proceeds without this |
| high | amber | Core systems — important, next in line |
| medium | cyan | Normal planned work |
| low | dim | Nice-to-have, backlog items |
File Menu Actions
| Action | What it does |
|---|
| New Project | Creates a new empty project and switches to it |
| Open Project (.zip) | Loads a project ZIP — restores workspace and all assets |
| Import JSON | Paste or drop JSON — string list, block array, or full workspace (Tier 1/2/3) |
| Save Project (.zip) | Exports current project as a ZIP with all blocks, assets, and docs |
| Save Workspace (.zip) | Exports ALL projects as a full ecosystem ZIP |
| Export JSON | Current project as a workspace JSON file |
| Agent Bundle v2 | Full agent handoff ZIP: workspace + template + contract + instructions + summary |
| Load Demo | Loads the built-in demo project — Ashlight Task Composer itself |
JSON Import Tiers
Tier 1 — String list: ["Block A", "Block B"] — fastest seed, creates bare blocks with default fields.
Tier 2 — Block array: Full block objects with all fields. Recommended for agent output. Blocks with status: "pending" land in Staging.
Tier 3 — Full workspace: Object with type: "ashlight.task.workspace" — shows confirmation modal: Add as Projects (safe default) or Replace All.
All tiers accept file drop (.json) as well as paste. Invalid JSON shows a toast error and does nothing destructive.
Drag & Drop
| Action | Result |
|---|
| Drag block top edge → release | Insert before that block |
| Drag block bottom edge → release | Insert after that block |
| Drag block middle → release | Nest as subtask of that block |
| Drag block to empty lane area | Change status to that lane |
| Drag staging pill to lane | Move from Staging → that lane |
| Drag lane block to Staging strip | Move back to Staging (pending) |
| Drag subtask to lane | Promote to root block with that status |
Keyboard Shortcuts
| Key | Action |
|---|
| Escape | Close fullscreen → settings → modal → system panel (priority order) |
| Cmd/Ctrl + Enter | Save the open modal form |