Audit and promote 27 draft interface packages

[koad]

Summary

~/.koad-io/interface/src/packages/ contains 27 draft Meteor packages — dashboard widgets, admin panels, config editors, styling. None are core-quality yet. They need auditing, triage, and selective promotion.

The work

1. Audit each package — classify as: promote (tested, documented, versioned), keep-as-draft, or remove (dead/duplicate)
2. Quality checklist for keepers: proper package.js versioning, README, no hardcoded paths, {connection: null} compatible, works in both production and dev mode
3. Move ~/.koad-io/interface/ to ~/.koad-io/skeletons/interface/ — it's a template, not a running thing
4. Identify daemon dashboard dependencies — which packages does feature 011 need? Those get priority promotion

Package list

io-local-collection              io-meteor-helpers
koad-io-administration           koad-io-administration-templates
koad-io-appinfo                  koad-io-comments
koad-io-config                   koad-io-config-editor
koad-io-dashboard-access-control koad-io-dashboard-access-points
koad-io-dashboard-devices        koad-io-dashboard-discord
koad-io-dashboard-domains        koad-io-dashboard-errors
koad-io-dashboard-events         koad-io-dashboard-example
koad-io-dashboard-exchange-rates koad-io-dashboard-exchange-trades
koad-io-dashboard-services       koad-io-dashboard-sessions
koad-io-dashboard-suppositories  koad-io-dashboard-telephone
koad-io-dashboard-users          koad-io-dashboard-worker-processes
koad-io-style-basic-bitch        koad-io-summernote
koad-io-ui-extras

Notes

• Many are stale copies — some evolved into what now lives in ~/.koad-io/packages/. Diff before promoting.
• The interface skeleton itself is old Astro-era. Treat as archaeological reference.
• io-local-collection is relevant for stateless hub (MONGO_URL=false in-memory pattern)
• koad-io-style-basic-bitch is the base theme — survives regardless
• Daemon candidates: dashboard-errors, dashboard-events, dashboard-services, dashboard-sessions

Ref

Brief: ~/.vulcan/briefs/interface-package-cleanup.md
Related: #22 (daemon worker system)

[koad]

Audit landed — /home/koad/.koad-io/interface/AUDIT-2026-04-14.md

Read-only triage of all 27 draft packages complete.

Summary (counts by recommendation)

Recommendation	Count
Promote	4
Complete-then-promote	9
Defer	10
Abandon	4
Total	27

Top 5 to promote first

• io-local-collection — already v1.3.0, full README, unblocks stateless-hub / MONGO_URL=false
• koad-io-dashboard-devices — most mature (v0.0.4, 4KB README), infra monitoring
• koad-io-style-basic-bitch — base theme, ships as-is
• koad-io-summernote — upstream-adopt WYSIWYG, v0.9.0, low risk
• koad-io-dashboard-worker-processes — aligns with vulcan#22 worker system + Feature 011 dashboard

Full promote checklist (Promote + Complete-then-promote)

Promote (ready now):

• io-local-collection
• koad-io-dashboard-devices
• koad-io-style-basic-bitch
• koad-io-summernote

Complete-then-promote:

• io-meteor-helpers
• koad-io-administration (pair with -templates)
• koad-io-administration-templates
• koad-io-dashboard-access-control (strip ecoincore)
• koad-io-dashboard-domains (deflate vendored files)
• koad-io-dashboard-errors
• koad-io-dashboard-events
• koad-io-dashboard-services
• koad-io-dashboard-sessions
• koad-io-dashboard-users
• koad-io-dashboard-worker-processes

Abandon: koad-io-config, koad-io-dashboard-example, koad-io-dashboard-exchange-rates, koad-io-dashboard-exchange-trades

Defer: koad-io-appinfo, koad-io-comments, koad-io-config-editor, koad-io-dashboard-access-points, koad-io-dashboard-discord, koad-io-dashboard-suppositories, koad-io-dashboard-telephone, koad-io-ui-extras

Note on commit

~/.koad-io/interface/ is .gitignored in koad/io (by design — see memory on fly-by-wire git / storefront-vs-HQ split). The audit file lives at the spec'd path on disk but is untracked. Juno to decide whether to force-add (git add -f) or keep the audit as a local working doc. Report itself is at /home/koad/.koad-io/interface/AUDIT-2026-04-14.md.

Issue intentionally left open with checklist above for follow-up promotions.

— Vulcan

[koad]

Audit rehomed: interface/ is gitignored in koad/io HQ, so the file would have vanished on a working-tree wipe.

Canonical location now: ~/.vulcan/assessments/2026-04-14-interface-package-audit.md — committed and pushed to Vulcan's Keybase HQ remote. A 3-line pointer stub was left at the old ~/.koad-io/interface/AUDIT-2026-04-14.md path so anyone looking in HQ sees the forwarding address.

[koad]

Audit addendum landed + team loop-in

Koad reviewed the audit and reframed the theme work as a branding-system architecture decision, not standalone package triage.

Addendum committed: e9123b1 — three revisions to the top-5:

1. koad-io-summernote — removed from ship-as-is list. Research modern WYSIWYG replacement (TipTap / Lexical / ProseMirror) before promote.
2. koad-io-style-basic-bitch — not a peer package. Rename + either merge into theme-engine/ or refactor to be theme-engine compliant. Years-bloated; modern CSS obsoletes much of it. Nav CSS already lives in packages/navigation — don't re-duplicate.
3. Theme work loops in Iris + Muse. Branding guide is canonical upstream of theme-engine and becomes a user-facing shippable asset.

Product chain

```
Iris's branding guide (canonical)
→ theme-engine (consumes brand tokens)
→ themes (koad:io default + user-built)
→ user apps (drop in, inherit brand)
```

Parallel issues filed

• Canonical branding guide — internal reference + user-facing asset iris#11 — canonical branding guide (internal reference + user-facing asset)
• Theme-engine aesthetic: default koad:io theme + brand-variant patterns muse#12 — theme-engine aesthetic (default theme + brand-variant patterns)

This issue (#74) remains the integration thread — Vulcan builds the pipeline and handles package rehoming.

Revised top-5 promote list

1. io-local-collection — unchanged, pure promote
2. koad-io-dashboard-devices — unchanged, pure promote
3. koad-io-dashboard-worker-processes — promoted up from complete-then-promote
4. (reserved for Summernote replacement pending Sibyl research)
5. (reserved for theme-engine-aligned brand theme pending Iris + Muse)

[koad]

Update 2026-04-16

Audit from 2026-04-14 is complete and committed. The physical move (interface/ → skeletons/) is the only remaining step.

Blocked: The ~/.koad-io/interface/src/packages/ directory contains 27 untracked packages. Per Wonderland Protocol, the physical move requires koad present. Bookmarked for a pairing session.