Repository navigation
Open
Labels
Description
⚠️ OpenSpec-managed issue — this content is automatically synced
from theopenspec/directory. Manual edits will be overwritten on next sync.
Artifacts
Specs
Tasks
- 1.1 Move
package-lock.jsononto the released@conduction/nextcloud-vuecarryingncDashboard, then verifynpm ls @conduction/nextcloud-vuereports that version andnode_modules/@conduction/nextcloud-vue/src/schemas/app-manifest-v2.schema.jsoncontainsncDashboardunder$defs/widgetEntry. - 1.2 Add a vitest manifest-validation spec running the installed schema over three fixtures, and verify it passes for a valid
ncDashboardand fails for the two invalid ones. - 2.1 Extract
lib/Service/PublishedApplicationProvider.php, moveAppNavigationService's per-request$cachedApplicationsinto it, repoint both callers, and verify a PHPUnit test counting object-service calls across one boot reports exactly one read. - 3.1 Build a widget descriptor from a published Application's production manifest, collecting every
widgets[]entry carryingncDashboard, and verify a PHPUnit test over a fixture manifest returns one descriptor per promoted entry and none for unpromoted entries. - 3.2 Derive the widget id as
buildiq-{applicationUuid}-{widgetEntryId}, normalised deterministically into^[a-z][a-z0-9\-_]*$, and verify a PHPUnit regression test that renames an Application's slug and asserts every id is byte-identical before and after. - 4.1 Add
lib/Dashboard/VirtualAppWidget.phpimplementingIWidgetandIIconWidgetfrom a descriptor, includingload()providing this user's visible descriptors as initial state and callingUtil::addScript, and verify a PHPUnit test asserts the id, title, icon url, order and link. - 4.2 Add
lib/Service/DashboardWidgetRegistrar.phpregistering one container service per descriptor under a synthetic name and callingIManager::lazyRegisterWidget()for each, and verify a PHPUnit test asserts one registration per promoted widget and none for unpromoted ones. - 4.3 Call the registrar from
Application::boot()beside the existingAppNavigationServicecall inside a guard that never throws, and verify a PHPUnit test with a failing object service completes boot, logs a warning and registers nothing. - 4.4 Add the pin test: register a service under a synthetic name,
lazyRegisterWidgetit, and verifyIManager::getWidgets()contains the derived id. - 5.1 Implement
IConditionalWidget::isEnabled()onVirtualAppWidgetreusingPermissionResolverplus the placement'sroles, inAppNavigationService's existing check order, and verify a PHPUnit matrix covering all four branches. - 6.1 Add the
ncDashboardentry towebpackConfig.entryinwebpack.config.jsemittingbuildiq-ncDashboard.js, writesrc/ncDashboard.jslooping the initial-state descriptors intoOCA.Dashboard.register(id, cb), and verify a production build emits the file and the app's dashboard panel renders in a browser. - 6.2 Render each widget through
@conduction/nextcloud-vue'sCnWidgetWrapperwithchrome="nc-dashboard", and verify a vitest spec mounts a widget from a descriptor and a second one asserts an unresolvable widget key shows the unknown-widget state naming the key. - 7.1 Add
lib/Service/Dashboard/WidgetItemProjector.phpwithgetItemsV2(string $userId, ?string $since = null, int $limit = 7): WidgetItems, projecting a declarativedataSourceto oneWidgetItemper row, and verify a PHPUnit test asserting the outbound objects query sends BARE filter keys. - 7.2 Project an aggregating data source to a single
WidgetItemwhose title is the number, and verify a PHPUnit test asserting the outbound aggregations query sends BRACKETEDfilter[...]keys. - 7.3 Return
WidgetItems([], emptyContentMessage: …)pointing at the app page for a rawgraphqldata source and for the chart and gauge types, and verify a PHPUnit test asserting no numeric value appears in the response. - 8.1 Add the per-widget promote control to the v2 widget placement editor delivered by
v2-widget-placement-editor, revealing panel title and panel icon when on, auto-fillingidon promote and keeping it on demote, and verify vitest specs for promote, demote and the untouched-page no-op. - 8.2 Load the hydra
writingskill (.claude/skills/writing/,references/voice.md) and run every new user-facing string and the app docs page for this feature through it, then verify no em-dash and no Title Case remains in the added copy. - 9.1 Add a Playwright spec that promotes a widget in the designer, finds it in the Nextcloud dashboard widget picker, adds it and asserts it renders, and verify the run is green against the live instance.
Design
See design.md for technical design details.
Synced from openspec/changes/publish-widgets-to-nc-dashboard by OpenSpec workflow
App: buildiq
Activity