auditing-workspaces

auditing-workspaces

List a workspace's documents, then use the spatial ones' scene digests to judge which look empty or abandoned. There is no server-side audit endpoint — this skill is a recipe for composing the regular document tools toward that end, nothing more.

For the main drawing workflow, see the drawing-visuals skill in skills/drawing-visuals/SKILL.md.

---

When To Use It

• When a workspace has been in heavy use and you want a sense of what is in it before adding more
• When you want to check for a likely-duplicate path before calling wb_document_create
• When you want to know whether a spatial document is worth opening without rendering it

---

Execution Flow

Step 1: List The Workspace's Documents

wb_document_list({ workspaceId })

Returns { documents: [{ documentId, path, name?, kind?, updatedAt?, shadowed? }] } — placement only, no content. An unknown workspaceId is an error here, not an empty list, so a typo reads as a failure rather than "nothing found."

Step 2: Classify, Then Sample Each Document

Step 1's listing carries no kind, and wb_document_get is the only tool that reports one — so classification comes first, and it costs one wb_document_get per document:

wb_document_get({ workspaceId, documentId })
// markdown -> { kind: "markdown", content: "...", frontmatter: {...} }  (the body, directly)
// spatial  -> { kind: "spatial", content: "..." }                        (full JSON Canvas payload)
// no recorded kind -> throws a "no recorded kind" error — itself a signal worth reporting

Read the kind before reading the content. A spatial read refuses a document it knows to be markdown rather than reporting its containers as empty, so it cannot silently answer "nothing here" about a document full of prose — but it also cannot tell you the kind of a document you have not identified yet. wb_document_get is what establishes that.

Once a document is KNOWN spatial (from wb_document_get's kind, or because this session created it), wb_canvas_snapshot is the cheap re-probe for later passes — node text, geometry and lock state without the untruncated JSON Canvas payload: