chore: bump nextcloud-vue + router, add axios alias + manifest-first README

package.json:
  - @conduction/nextcloud-vue ^0.1.0-beta.3 → ^1.0.0-beta.12 (the
    published lib version with the Vue.extend frozen-component fix).
  - @nextcloud/router ^2.0.1 → ^3.1.0 — required by @nextcloud/vue
    8.37+ (NcDashboardWidget / NcAvatar import getBaseUrl, missing
    from router 2.x).
  - Add ajv ^8.17.1 + ajv-formats ^3.0.1 devDependencies for the
    manifest validator.
  - Add scripts.check:manifest → node tests/validate-manifest.js
    (satisfies the fleet adoption spec's build-time validation gate).

webpack.config.js:
  - Add @nextcloud/axios$ alias to force the lib's transitive axios
    import to resolve to the app's installed copy (decidesk pattern,
    commit ed34703c). Without the $ exact-match suffix webpack walks
    up to the lib's own node_modules and loads a second axios
    instance, breaking shared interceptors / CSRF tokens.

eslint.config.js:
  - Override no-console / n/no-process-exit / n/shebang for the
    tests/validate-manifest.js Node CLI script.

README.md:
  - Lead with manifest-first messaging in the intro paragraph and
    in the OpenRegister callout.
  - Add an "Adding a page (manifest-first)" section that documents
    the page-type table and tells cloners to edit src/manifest.json
    rather than writing per-page Vue files. Custom Vue components
    are only required for type:"custom" pages.
  - Add a "Renaming the app" section listing the files where the
    app id appears (the manifest itself does NOT carry the id).
  - Update the directory-structure diagram to reflect the new
    layout (manifest.json, customComponents.js, no router/, no
    navigation/).

Author: rubenvdlinde

README.md

@@ -18,7 +18,9 @@
 
 A starting point for building Nextcloud apps following ConductionNL conventions.
 
-> **Pre-wired for [OpenRegister](https://github.com/ConductionNL/openregister)** — all data is stored as OpenRegister objects. If your app needs OpenRegister, install it first. If not, remove the dependency from `appinfo/info.xml` and `openspec/app-config.json`.
+> **Manifest-first** — pages, navigation, and dependencies are declared in `src/manifest.json`. The shell (CnAppRoot) reads the manifest at boot and renders index / detail / dashboard / settings pages without per-page Vue files. Reach for a custom Vue component only when the page is `type: "custom"`. See `openspec/architecture/` and hydra ADR-024 for the architectural rationale.
+
+> **Pre-wired for [OpenRegister](https://github.com/ConductionNL/openregister)** — `manifest.dependencies` lists `openregister`, so CnAppRoot's dependency-check phase ensures the OR app is installed and enabled before the UI mounts. If your app does not need OpenRegister, remove the entry from `src/manifest.json`, `appinfo/info.xml`, and `openspec/app-config.json`.
 
 ## Screenshots
 
@@ -71,13 +73,14 @@ app-template/
 │   └── Settings/               # AdminSettings, app_template_register.json
 ├── templates/                  # PHP templates (SPA shells)
 ├── src/                        # Vue 2 frontend
-│   ├── main.js                 # App entry point
+│   ├── manifest.json           # Pages + menu + dependencies (the source of truth)
+│   ├── main.js                 # App entry — bootstraps CnAppRoot from manifest
+│   ├── App.vue                 # Mounts CnAppRoot + #sidebar slot
+│   ├── customComponents.js     # Registry for `type: "custom"` pages (escape hatch)
 │   ├── exampleWidget.js        # Sample Nextcloud Dashboard widget entry-point
-│   ├── App.vue                 # Root component
-│   ├── navigation/MainMenu.vue # App navigation sidebar
-│   ├── router/                 # Vue Router
-│   ├── store/                  # Pinia stores
-│   ├── views/                  # Route-level views + UserSettings.vue
+│   ├── settings.js             # Nextcloud admin settings webpack entry-point
+│   ├── store/                  # Pinia stores (used by AdminSettings)
+│   ├── views/CustomExample.vue # Example custom component (registry demo)
 │   └── views/widgets/          # Dashboard widget Vue components (ExampleWidget.vue)
 ├── openspec/                   # Specifications, decisions, and roadmap
 │   ├── app-config.json         # Canonical app config (id, goal, dependencies, CI)
@@ -87,7 +90,8 @@ app-template/
 │   ├── ROADMAP.md              # Product roadmap
 │   └── changes/                # OpenSpec change directories (created on first change)
 ├── tests/                      # Unit and integration tests
-├── l10n/                       # Translations (en, nl)
+│   └── validate-manifest.js    # Ajv schema validator for src/manifest.json
+├── l10n/                       # Translations (en, en_US, nl)
 ├── .github/workflows/          # CI/CD pipelines
 ├── Makefile                    # Dev helpers (make dev-link)
 └── img/                        # App icons and screenshots
@@ -134,10 +138,49 @@ docker compose -f ../openregister/docker-compose.yml up -d
 
 ```bash
 npm install
-npm run dev        # Watch mode
-npm run build      # Production build
+npm run dev              # Watch mode
+npm run build            # Production build
+npm run check:manifest   # Validate src/manifest.json against the schema
 ```
 
+### Adding a page (manifest-first)
+
+Pages live in [`src/manifest.json`](src/manifest.json) — NOT in
+`src/views/`. To add a page, edit the manifest:
+
+1. **Add a menu entry** in `manifest.menu` (id, label, icon, route).
+2. **Add a page** in `manifest.pages` (id matches the menu's `route`).
+   Pick the `type`:
+
+   | Type        | Use when                                                    |
+   |-------------|-------------------------------------------------------------|
+   | `dashboard` | Home / overview with KPI widgets                            |
+   | `index`     | Schema-backed list view (CnDataTable + sidebar)             |
+   | `detail`    | Single-object view at `/things/:id`                         |
+   | `settings`  | Admin/user settings with `version-info` / `register-mapping`|
+   | `logs`      | Tail-style audit log view                                   |
+   | `chat`      | Conversation thread page                                    |
+   | `files`     | Folder browser                                              |
+   | `custom`    | Bespoke Vue component (last resort)                         |
+
+3. **Run `npm run check:manifest`** to verify the manifest validates.
+
+You only write a Vue file when the page is `type: "custom"`. In that
+case, drop the component into `src/views/`, register it in
+[`src/customComponents.js`](src/customComponents.js), and reference
+its registry name in the manifest entry's `component` field. See
+[`src/views/CustomExample.vue`](src/views/CustomExample.vue) for the
+canonical example.
+
+### Renaming the app
+
+Search-and-replace `app-template` (the `<id>` from `appinfo/info.xml`)
+in: `appinfo/info.xml`, `package.json`, `openspec/app-config.json`,
+`src/main.js` (the `app-id` prop, the `loadTranslations` arg, and the
+`generateUrl` base path), `src/App.vue` (the `app-id` prop and
+`translateForApp` argument), and `webpack.config.js` (the `appId`
+constant). The manifest itself does not carry the app id.
+
 ### Adding a dashboard widget
 
 The template ships with a working `ExampleWidget` you can copy. Each widget is

eslint.config.js

@@ -42,4 +42,13 @@ module.exports = defineConfig([{
 		'import/no-named-as-default': 'off', // disable named-as-default checking to avoid parser requirement
 		'import/no-named-as-default-member': 'off', // disable named-as-default-member checking to avoid parser requirement
 	},
+}, {
+	// Node-side CLI tools (build / validate scripts) legitimately use
+	// console + process.exit and ship as plain JS (no shebang).
+	files: ['tests/validate-manifest.js'],
+	rules: {
+		'no-console': 'off',
+		'n/no-process-exit': 'off',
+		'n/shebang': 'off',
+	},
 }])