Skip to content
This repository was archived by the owner on May 29, 2026. It is now read-only.

Add appspec/openspec scaffold, dev tooling, and CI-ready test infrastructure#2

Merged
WilcoLouwerse merged 13 commits into
developmentfrom
feature/appspec-openspec-scaffold
Mar 23, 2026
Merged

Add appspec/openspec scaffold, dev tooling, and CI-ready test infrastructure#2
WilcoLouwerse merged 13 commits into
developmentfrom
feature/appspec-openspec-scaffold

Conversation

@WilcoLouwerse

@WilcoLouwerse WilcoLouwerse commented Mar 22, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Adds appspec/ and openspec/ scaffold directories with README, ADR, features, roadmap, and app-config.json as a starting point for spec-driven development
  • Adds committed composer.lock and package-lock.json so CI installs exact dependency versions reproducibly via composer install / npm ci
  • Fixes npm peer dependency conflicts: pins @typescript-eslint/* to ^7 (compatible with @vue/eslint-config-typescript) and explicitly adds ESLint plugin hoisting entries
  • Adds stylelint.config.js, eslint.config.js, and corrected PHPUnit config files (phpunit.xml, phpunit-unit.xml) with bootstrap scripts so all CI checks run cleanly
  • Adds placeholder PHPUnit unit test and Newman/Postman integration test collection to give new apps a baseline to build on
  • Updates README to a full Nextcloud app template guide

Checks

  • ✅ All local checks passed (composer lint, composer phpcs, composer phpmd, composer psalm, composer phpstan, npm run lint, npm run stylelint, composer audit, npm audit --audit-level=critical --omit=dev)

Test plan

  • CI passes (php-quality, vue-quality, security jobs)
  • PHPUnit job runs (placeholder test passes in Nextcloud environment)
  • Tested locally — all checks pass

- 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.
@github-actions

Copy link
Copy Markdown
Contributor

Quality Report

Repository ConductionNL/nextcloud-app-template
Commit 31fb0cb
Branch 2/merge
Event pull_request
Generated 2026-03-22 18:18 UTC
Workflow Run https://github.com/ConductionNL/nextcloud-app-template/actions/runs/23409374718

Summary

Group Result
PHP Quality PASS
Vue Quality PASS
Security PASS
License PASS
PHPUnit PASS
Newman 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 / 2 statements)

Integration Tests (Newman)

Newman integration tests were not enabled for this run.


Generated automatically by the Quality workflow.

Download the full PDF report from the workflow artifacts.

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
@github-actions

Copy link
Copy Markdown
Contributor

Quality Report

Repository ConductionNL/nextcloud-app-template
Commit f369547
Branch 2/merge
Event pull_request
Generated 2026-03-22 18:26 UTC
Workflow Run https://github.com/ConductionNL/nextcloud-app-template/actions/runs/23409522084

Summary

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

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
FAIL

Generated automatically by the Quality workflow.

Download the full PDF report from the workflow artifacts.

…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.
@github-actions

Copy link
Copy Markdown
Contributor

Quality Report

Repository ConductionNL/nextcloud-app-template
Commit 84a300e
Branch 2/merge
Event pull_request
Generated 2026-03-22 18:34 UTC
Workflow Run https://github.com/ConductionNL/nextcloud-app-template/actions/runs/23409663534

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.

@github-actions

Copy link
Copy Markdown
Contributor

Quality Report

Repository ConductionNL/nextcloud-app-template
Commit 6bd9f98
Branch 2/merge
Event pull_request
Generated 2026-03-22 18:51 UTC
Workflow Run https://github.com/ConductionNL/nextcloud-app-template/actions/runs/23409995193

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.

@WilcoLouwerse WilcoLouwerse merged commit a03e07f into development Mar 23, 2026
44 checks passed
@WilcoLouwerse WilcoLouwerse deleted the feature/appspec-openspec-scaffold branch March 23, 2026 09:25
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant