Skip to content

Release: promote beta to stable — initial CI pipeline and app scaffold#5

Merged
WilcoLouwerse merged 32 commits intomainfrom
beta
Mar 24, 2026
Merged

Release: promote beta to stable — initial CI pipeline and app scaffold#5
WilcoLouwerse merged 32 commits intomainfrom
beta

Conversation

@WilcoLouwerse
Copy link
Collaborator

@WilcoLouwerse WilcoLouwerse commented Mar 23, 2026

Summary

  • Add complete CI quality pipeline: PHP (lint, phpcs, phpmd, psalm, phpstan,
    phpmetrics), Vue (eslint, stylelint), security audits, PHPUnit, Newman, SBOM
  • Add appspec/ and openspec/ scaffold directories for spec-driven development
    (README templates, feature specs, ADR structure, roadmap)
  • Add composer.lock and package-lock.json for reproducible CI installs;
    resolve npm peer dependency conflicts
  • Add PHPUnit config and test scaffolding (phpunit.xml, phpunit-unit.xml,
    bootstrap files, placeholder unit test)
  • Add Newman integration test collection with health-check; fix variable names
    to match CI workflow expectations (base_url, admin_user, admin_password)
  • Fix critical CVE: upgrade libxmljs2 to 0.37.0 via npm overrides
    (GHSA-78h3-pg4x-j8cv, in @cyclonedx/cyclonedx-npm transitive dep)

Checks

  • ✅ All local checks passed (lint, phpcs, phpmd, psalm, phpstan, phpmetrics,
    eslint, stylelint, composer audit, npm audit, PHPUnit 1/1, Newman 1/1)

Test plan

  • CI passes
  • Tested locally
  • Reviewed for regressions

- Replace @typescript-eslint/eslint-plugin@^8.x with ^7.18.0 to satisfy
  peer dependency chain from @nextcloud/eslint-config via @vue/eslint-config-typescript
- Add @typescript-eslint/parser@^7.18.0 and eslint-plugin-vue@^9.21.1 explicitly
  so transitive peer deps are hoisted to top-level node_modules (required by ESLint v8)
- Add vue-eslint-parser@^9.4.3 explicitly to ensure it is hoisted and discoverable
- Add stylelint.config.js to prevent stylelint picking up parent-directory config
- Regenerate package-lock.json with correct dependency resolution
CI requires phpunit.xml or phpunit-unit.xml when enable-phpunit is true.
Adds both config files, bootstrap files, and a placeholder unit test.
Provides a starting structure for API integration tests.
Enable in CI by setting enable-newman: true in code-quality.yml.
The register() method is part of the IBootstrap interface contract.
Like boot(), its $context parameter is intentionally unused in the
template since it serves as a placeholder for app-specific registrations.
All three can now be tested locally:
- phpmetrics: runs via composer phpmetrics locally
- phpunit: runs via docker exec against the Nextcloud container
  (XDEBUG_MODE=coverage to avoid runner warning / non-zero exit)
- newman: runs via npx newman against http://nextcloud.local
…in_password)

CI workflow passes base_url/admin_user/admin_password but the collection
used baseUrl/username/password. Mismatched names caused Newman to silently
fall back to the collection default of http://localhost (port 80), which
nothing answers in CI — resulting in ECONNREFUSED.

Also updates default base_url to http://localhost:8080 to match the PHP
built-in server CI starts for Newman tests.
…fold

Add appspec/openspec scaffold, dev tooling, and CI-ready test infrastructure
…l CVE

libxmljs2 <= 0.35.0 has a critical type confusion vulnerability (GHSA-78h3-pg4x-j8cv /
CVE-2024-34394). The dependency is pulled in transitively by @cyclonedx/cyclonedx-npm
(the SBOM generator). No patched release of the tool itself is available yet.

Adding an npm overrides entry to force libxmljs2 to 0.37.0 (the patched version) is
the standard npm approach for resolving transitive dependency vulnerabilities while
keeping the consuming package unchanged.
Set up complete CI quality pipeline and app scaffold
@github-actions
Copy link

Quality Report

Repository ConductionNL/nextcloud-app-template
Commit f8a7513
Branch 5/merge
Event pull_request
Generated 2026-03-23 11:44 UTC
Workflow Run https://github.com/ConductionNL/nextcloud-app-template/actions/runs/23435595269

Summary

Group Result
PHP Quality PASS
Vue Quality PASS
Security PASS
License PASS
PHPUnit PASS
Newman PASS

PHP Quality

Tool Result
lint PASS
phpcs PASS
phpmd PASS
psalm PASS
phpstan PASS
phpmetrics PASS

Vue Quality

Tool Result
eslint PASS
stylelint PASS

Security

Ecosystem Result
composer PASS
npm PASS

License Compliance

Ecosystem Result
composer PASS
npm PASS

composer dependencies (100 total)

Metric Count
Approved (allowlist) 100
Approved (override) 0
Denied 0

npm dependencies (215 total)

Metric Count
Approved (allowlist) 215
Approved (override) 0
Denied 0

PHPUnit Tests

PHP Nextcloud Result
Overall PASS

Code coverage: 0% (0 / 2 statements)

Integration Tests (Newman)

Result
PASS

Generated automatically by the Quality workflow.

Download the full PDF report from the workflow artifacts.

rjzondervan
rjzondervan previously approved these changes Mar 23, 2026
… expectations

- Add lib/Controller/SettingsController.php — settings API (index/create/load)
- Add lib/Service/SettingsService.php — settings + OpenRegister integration
- Add lib/Listener/DeepLinkRegistrationListener.php — deep link registration
- Add lib/Repair/InitializeSettings.php — auto-import register on install
- Add lib/Settings/app_template_register.json — OpenAPI 3.0 register schema
- Add src/navigation/MainMenu.vue — extracted navigation sidebar component
- Add src/views/settings/UserSettings.vue — user settings dialog placeholder
- Add l10n/en.json and l10n/nl.json — translation stubs
- Add tests/unit/Controller/SettingsControllerTest.php — 3 unit tests, 100% coverage
- Add openspec/config.yaml — OpenSpec project configuration
- Add project.md — project overview
- Update lib/AppInfo/Application.php — register listener and repair step
- Update src/App.vue — use MainMenu component instead of inline navigation
- Update phpunit.xml and phpunit-unit.xml — include tests/unit/ directory
- Replace appspec/ with openspec/specs/ and openspec/architecture/
- Update openspec/README.md — reflect new specs/ and architecture/ structure
… README

- Add Makefile with dev-link/dev-unlink targets that create a relative symlink
  apps-extra/app-template -> nextcloud-app-template so Nextcloud can find the
  app by its ID when the repo is cloned under its GitHub name
- Update README: replace appspec/ references with openspec/specs/ and
  openspec/architecture/, update directory structure, document make dev-link step
- Add Troubleshooting section covering blank UI (missing build) and
  "Could not download app" (directory name mismatch)
- Clarify OpenRegister is pre-wired but optional for derived apps
- Fix docker-compose path (../openregister/ not openregister/)
- Note openspec/changes/ is created on first change
- Add npm install && npm run build to Enable locally steps with
  explicit note that js/ build output is not committed
- Add OpenRegister conditional note to openspec/README.md
Give the SPA catch-all route a unique name so GET /apps/app-template/ still
matches the index route (duplicate Symfony names replaced the first route).
Correct navigation route id to app-template.dashboard.page.

Add DashboardController::catchAll delegating to page(), register /settings in
the Vue router, and replace the minimal dashboard with KPI placeholders and
activity panels using Conduction components.

Made-with: Cursor
PRs targeting beta did not match pull_request branch filters, so required
checks could stay pending or skip. Include beta alongside main/development.

Made-with: Cursor
Merge development into beta: OpenSpec scaffold, settings stack, and dev docs
@github-actions
Copy link

Quality Report

Repository ConductionNL/nextcloud-app-template
Commit c922b06
Branch 5/merge
Event pull_request
Generated 2026-03-23 16:00 UTC
Workflow Run https://github.com/ConductionNL/nextcloud-app-template/actions/runs/23446832569

Summary

Group Result
PHP Quality PASS
Vue Quality PASS
Security PASS
License PASS
PHPUnit PASS
Newman PASS

PHP Quality

Tool Result
lint PASS
phpcs PASS
phpmd PASS
psalm PASS
phpstan PASS
phpmetrics PASS

Vue Quality

Tool Result
eslint PASS
stylelint PASS

Security

Ecosystem Result
composer PASS
npm PASS

License Compliance

Ecosystem Result
composer PASS
npm PASS

composer dependencies (100 total)

Metric Count
Approved (allowlist) 100
Approved (override) 0
Denied 0

npm dependencies (215 total)

Metric Count
Approved (allowlist) 215
Approved (override) 0
Denied 0

PHPUnit Tests

PHP Nextcloud Result
Overall PASS

Code coverage: 0% (0 / 3 statements)

Integration Tests (Newman)

Result
PASS

Generated automatically by the Quality workflow.

Download the full PDF report from the workflow artifacts.

rubenvdlinde
rubenvdlinde previously approved these changes Mar 23, 2026
The org-level ruleset requires a status check named 'check-branch'.
The previous reusable workflow call produced 'protect / check-branch',
which never satisfied the requirement. Inlining the logic with the job
named 'check-branch' produces the exact name the ruleset expects.
rjzondervan
rjzondervan previously approved these changes Mar 24, 2026
…ated

The org ruleset requires context 'check-branch' but the reusable workflow
reports 'protect / check-branch', blocking all beta → main PRs. Removing
main from the workflow trigger as a workaround until the ruleset is fixed.
Release: merge development into beta
@WilcoLouwerse WilcoLouwerse dismissed stale reviews from rjzondervan and rubenvdlinde via 66045ae March 24, 2026 11:53
@github-actions
Copy link

Quality Report

Repository ConductionNL/nextcloud-app-template
Commit f05038f
Branch 5/merge
Event pull_request
Generated 2026-03-24 11:55 UTC
Workflow Run https://github.com/ConductionNL/nextcloud-app-template/actions/runs/23488055577

Summary

Group Result
PHP Quality PASS
Vue Quality PASS
Security PASS
License PASS
PHPUnit PASS
Newman PASS
Playwright SKIP

PHP Quality

Tool Result
lint PASS
phpcs PASS
phpmd PASS
psalm PASS
phpstan PASS
phpmetrics PASS

Vue Quality

Tool Result
eslint PASS
stylelint PASS

Security

Ecosystem Result
composer PASS
npm PASS

License Compliance

Ecosystem Result
composer PASS
npm PASS

composer dependencies (100 total)

Metric Count
Approved (allowlist) 100
Approved (override) 0
Denied 0

npm dependencies (215 total)

Metric Count
Approved (allowlist) 215
Approved (override) 0
Denied 0

PHPUnit Tests

PHP Nextcloud Result
Overall PASS

Code coverage: 0% (0 / 3 statements)

Integration Tests (Newman)

Result
PASS

E2E Tests (Playwright)

Playwright E2E tests were not enabled for this run.


Generated automatically by the Quality workflow.

Download the full PDF report from the workflow artifacts.

@github-actions
Copy link

Quality Report

Repository ConductionNL/nextcloud-app-template
Commit a7b38ce
Branch 5/merge
Event pull_request
Generated 2026-03-24 13:20 UTC
Workflow Run https://github.com/ConductionNL/nextcloud-app-template/actions/runs/23491503006

Summary

Group Result
PHP Quality PASS
Vue Quality PASS
Security PASS
License PASS
PHPUnit PASS
Newman PASS
Playwright SKIP

PHP Quality

Tool Result
lint PASS
phpcs PASS
phpmd PASS
psalm PASS
phpstan PASS
phpmetrics PASS

Vue Quality

Tool Result
eslint PASS
stylelint PASS

Security

Ecosystem Result
composer PASS
npm PASS

License Compliance

Ecosystem Result
composer PASS
npm PASS

composer dependencies (100 total)

Metric Count
Approved (allowlist) 100
Approved (override) 0
Denied 0

npm dependencies (215 total)

Metric Count
Approved (allowlist) 215
Approved (override) 0
Denied 0

PHPUnit Tests

PHP Nextcloud Result
Overall PASS

Code coverage: 0% (0 / 3 statements)

Integration Tests (Newman)

Result
PASS

E2E Tests (Playwright)

Playwright E2E tests were not enabled for this run.


Generated automatically by the Quality workflow.

Download the full PDF report from the workflow artifacts.

@WilcoLouwerse WilcoLouwerse merged commit 4dafab6 into main Mar 24, 2026
25 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.

4 participants