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

docs: add fleet-drift-deeper.md (composer/package/CI/info.xml/README drift)#60

Merged
rubenvdlinde merged 1 commit into
developmentfrom
docs/deeper-drift-research
May 23, 2026
Merged

docs: add fleet-drift-deeper.md (composer/package/CI/info.xml/README drift)#60
rubenvdlinde merged 1 commit into
developmentfrom
docs/deeper-drift-research

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

Companion to docs/fleet-extras-audit.md. That doc covered root-file presence; this one digs into content drift across the things that aren't byte-for-byte canonical but still want template alignment.

What's in scope

Category Drift highlights
composer.json scripts 25-script common base + 3 outliers (app-versions/opentalk/zaakafhandelapp at sub-canonical sizes)
package.json scripts 18/18 on build/lint/stylelint, but only 9/18 have test or test:e2e — half the fleet has no JS test gate
CI workflows 9 canonical workflows in 13–17 of 22 apps; 4 apps (larpingapp/openconnector/openregister/zaakafhandelapp) missing several canonical workflows; app-versions has 13 workflows including a pile of legacy ones to retire
appinfo/info.xml MASSIVE drift — PHP min-version ranges 8.0 to 8.3 across the fleet (composer unified at ^8.3 tonight, info.xml is incoherent in 17/22 apps), NC version ranges all different, license spelling 4 different ways
README structure ~14 common sections present in 12+ of 22 apps, natural scaffold target

Recommendations (organized by leverage)

Tier A — Script-driven fleet cleanup (high leverage)

  1. info.xml canonicalization — PHP min-version, NC range, license spelling. Write a hydra/scripts/fleet-sync/info-xml.sh subcommand. One run, 22 PRs.
  2. Workflow cleanup on app-versions — collapse 13 workflows to the canonical 9. Single PR.
  3. Missing canonical workflows on larpingapp/openconnector/openregister/zaakafhandelapp — copy from template. Per-app PR.

Tier B — Scaffold-drift sweeps (medium leverage)

  1. package.json scripts — add test, test:e2e, stylelint-fix, check:manifest to template and to apps lacking them.
  2. composer.json scripts — close gaps on zaakafhandelapp, app-versions, opencatalogi to bring them to the 25-script common base.
  3. README structure — opportunistic, low priority.

Tier C — Documentation

  1. Add docs/composer-scripts-template.md and docs/ci-workflows.md listing canonical sets.
  2. Re-run this drift audit quarterly; track convergence over time.

Forward-link

Adds a pointer from docs/canonical-files.md so the entry point doc surfaces the deeper research. The two docs together form the policy + drift baseline for the fleet sync work.

…drift)

Companion to docs/fleet-extras-audit.md. That doc covered root-file
presence; this one digs into content drift across the things that
aren't byte-for-byte canonical but still want template alignment:

- composer.json scripts: 25-script common base + 3 outliers
  (app-versions, opentalk, zaakafhandelapp at sub-canonical sizes)
- package.json scripts: 18/18 on build/lint/stylelint, but only 9/18
  have test or test:e2e — half the fleet has no JS test gate
- CI workflows: 9 canonical workflows in 13-17 of 22 apps; 4 apps
  (larpingapp/openconnector/openregister/zaakafhandelapp) missing
  several canonical ones; app-versions has 13 workflows including a
  pile of legacy ones to retire
- appinfo/info.xml: MASSIVE drift — PHP min-version ranges 8.0 to 8.3
  across the fleet (composer is unified at ^8.3 now, info.xml is
  incoherent with it in 17/22 apps), NC version ranges all different,
  license spelling 4 different ways
- README structure: ~14 common sections present in 12+ of 22 apps,
  natural scaffold target

Each section has explicit recommendations: Tier A (script-driven
fleet cleanup, high leverage) → info.xml canonicalization, missing
canonical workflows. Tier B (scaffold drift sweeps) → close composer/
package.json script gaps. Tier C (documentation) → canonical script
inventory.

Adds a forward-link from canonical-files.md so the entry point doc
points at the deeper research.
@rubenvdlinde rubenvdlinde requested a review from Rem-Dam as a code owner May 23, 2026 07:32
@rubenvdlinde rubenvdlinde merged commit 3acd298 into development May 23, 2026
2 of 15 checks passed
@rubenvdlinde rubenvdlinde deleted the docs/deeper-drift-research branch May 23, 2026 07:32
@github-actions

Copy link
Copy Markdown
Contributor

Quality Report — ConductionNL/nextcloud-app-template @ 6e79f8c

Check PHP Vue Security License Tests
lint
phpcs
phpmd
psalm
phpstan
phpmetrics
eslint
stylelint
composer
npm ❌ 2/684 denied
PHPUnit ⏭️
Newman ⏭️
Playwright ⏭️

❌ Denied npm licenses

Package Version License
pako 1.0.11 (MIT AND Zlib)
sha.js 2.4.12 (MIT AND BSD-3-Clause)

Quality workflow — 2026-05-23 07:34 UTC

Download the full PDF report from the workflow artifacts.

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