Skip to content

feat(wikibrowser): show workflow titles and fold management metadata - #152

Merged
humandebri merged 3 commits into
mainfrom
feat/workflow-folder-labels
Oct 16, 2026
Merged

humandebri merged 3 commits into
mainfrom
feat/workflow-folder-labels

Conversation

@humandebri

@humandebri humandebri commented Oct 16, 2026 •

Copy link
Copy Markdown
Collaborator

Changes

Kinic Superpowers workflows previously exposed UUID folder names and raw management JSON in the Web Wiki. Folders containing only a manifest provided no convenient route to their documents.

For workflows with validated project registration and v1/v2 manifests, the tree and breadcrumbs now display workflow titles. Workflow folders show their current state and links to canonical documents. Management JSON is collapsed in directory listings and search results, and formatted when opened directly. Users can switch to actual filenames or refresh the display. Document reference links do not expose move or delete actions.

Storage paths, UUIDs, manifests, the CLI, and canister APIs remain unchanged. Additional reads fetch management metadata only, with at most four concurrent requests per reader. Caches are isolated by canister, database, and principal. Saving management metadata invalidates only the affected path, while explicit refreshes retain the same request queue. Invalid metadata or failed reads fall back to the ordinary file view.

Validation

  • Web: 35 test files / 261 tests, existing validation scripts, type checking, lint, and production build passed.
  • Superpowers: 161 Python regression tests passed, including workflow isolation, recovery, and synchronization conflicts.
  • Fixed four independent review findings: invalid artifact roles, stale caches, unnecessary reads, and incorrect labels for external documents. Added regression coverage.
  • Tested a Chromium fixture at 1280px and 375px using 28 nodes retrieved read-only from the live database. Verified keyboard expansion, display switching, canonical links, and no horizontal overflow.
  • All 28 live database etags matched before and after the display checks.
  • vlmkit integrity: zero failures; one existing contrast warning for breadcrumb separators.

Limitations

Browser validation used a local fixture populated with real data. Authenticated browsing in the production Web UI and deployment were not performed. iOS presentation is outside this change. Existing storage layouts are preserved.

Follow-up review fixes

Fixed an issue where navigation recreated the reader, allowing old and new requests to exceed the four-request limit in aggregate. The reader and request queue now persist within the connection/principal scope, and saves invalidate only the affected metadata. Responses from before invalidation cannot update the display, and invalidated requests that have not started are skipped. Regression tests cover repeated navigation and refreshes, targeted refetching, and delayed stale responses.

Display language

All added UI labels are English, including Workflows, Design, Plan, Progress, Review, Results, Management metadata, and the display controls. User-authored workflow titles and state text remain unchanged. After this copy update, 26 focused tests, type checking, and lint passed.

@humandebri
humandebri merged commit ddf55c5 into main Oct 16, 2026
15 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant