@tryvitris/website-admin-contracts 1.4.0 → 1.5.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Vitris contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Vitris contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,5 @@
 # Website Admin Contracts
 
 Validated installation manifests, roles, permissions and module contracts for `@tryvitris/website-admin-harness`. Node.js 24+. MIT licensed.
+
+The maintenance contract exports the stable admin package family and typed installed/locked/published-version reports and preparation plans. Its policy is prepare-and-test under existing publication permissions. It does not execute updates or create schedules; use the runtime maintenance CLI and its agent guide.

package/dist/index.d.ts

@@ -214,3 +214,4 @@ export declare const workQueueModule: ModuleDefinition;
 export declare function isLoopback(origin: string): boolean;
 export declare function parseManifest(value: unknown): AdminManifest;
 export declare function validateModules(manifest: AdminManifest, modules: ModuleDefinition[]): void;
+export * from './maintenance.js';

package/dist/index.js

@@ -166,6 +166,7 @@ function validateModules(manifest, modules) {
   }
   for (const enabled of manifest.modules) if (!ids.has(enabled)) throw new Error(`Module ${enabled} is not installed`);
 }
+export * from "./maintenance.js";
 export {
   analyticsBreakdownKeys,
   analyticsMetricKeys,

package/dist/maintenance.d.ts

@@ -0,0 +1,47 @@
+/** Package maintenance is an agent workflow; this contract grants no deployment authority. */
+export declare const maintenanceVersion = 1;
+export declare const adminMaintenancePackages: readonly ["@tryvitris/website-admin-harness", "@tryvitris/website-admin-contracts", "@tryvitris/create-website-admin-harness"];
+export declare const maintenancePackages: readonly ["@tryvitris/website-admin-harness", "@tryvitris/website-admin-contracts", "@tryvitris/create-website-admin-harness", "@tryvitris/website-harness"];
+export type MaintenancePackage = typeof maintenancePackages[number];
+export type MaintenanceStatus = 'not-declared' | 'current' | 'update-available' | 'ahead' | 'unmanaged' | 'drift' | 'unavailable';
+export interface MaintenanceRelease {
+    name: MaintenancePackage;
+    version: string;
+    integrity: string;
+    tarball: string;
+}
+export interface MaintenanceEntry {
+    name: MaintenancePackage;
+    declared: string | null;
+    installed: string | null;
+    locked: string | null;
+    status: MaintenanceStatus;
+    change: 'none' | 'patch' | 'minor' | 'major' | 'unknown';
+    latest: MaintenanceRelease | null;
+}
+export interface MaintenanceReport {
+    schemaVersion: 1;
+    checkedAt: string;
+    policy: 'prepare-and-test';
+    adminRelease: {
+        version: string | null;
+        complete: boolean;
+    };
+    packages: MaintenanceEntry[];
+    baseline: Record<string, string>;
+    deployment: 'not-checked';
+}
+export interface MaintenancePlan {
+    schemaVersion: 1;
+    policy: 'prepare-and-test';
+    baseline: Record<string, string>;
+    ready: boolean;
+    held: MaintenancePackage[];
+    updates: MaintenanceRelease[];
+    install: {
+        command: 'npm';
+        args: string[];
+    } | null;
+    requiredChecks: string[];
+    deployment: 'follow-existing-permissions';
+}

package/dist/maintenance.js

@@ -0,0 +1,9 @@
+// packages/contracts/src/maintenance.ts
+var maintenanceVersion = 1;
+var adminMaintenancePackages = ["@tryvitris/website-admin-harness", "@tryvitris/website-admin-contracts", "@tryvitris/create-website-admin-harness"];
+var maintenancePackages = ["@tryvitris/website-admin-harness", "@tryvitris/website-admin-contracts", "@tryvitris/create-website-admin-harness", "@tryvitris/website-harness"];
+export {
+  adminMaintenancePackages,
+  maintenancePackages,
+  maintenanceVersion
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tryvitris/website-admin-contracts",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "type": "module",
   "license": "MIT",
   "description": "Validated installation and module contracts for Cloudflare business admin apps",
@@ -33,5 +33,14 @@
   "homepage": "https://github.com/jackperrotta/website-admin-harness#readme",
   "bugs": {
     "url": "https://github.com/jackperrotta/website-admin-harness/issues"
+  },
+  "vitris": {
+    "maintenance": {
+      "version": 1,
+      "policy": "prepare-and-test",
+      "stableChannel": "latest",
+      "command": "vitris-admin updates check --dir . --json",
+      "schedule": "reuse-existing-daily-care"
+    }
   }
 }

package/vitris-release.json

@@ -1,15 +1,15 @@
 {
   "schemaVersion": 1,
   "name": "@tryvitris/website-admin-contracts",
-  "version": "1.4.0",
-  "title": "Optional combined connection approval contract",
+  "version": "1.5.0",
+  "title": "Typed agent maintenance reports and plans",
   "notesScope": "package",
   "notes": [
-    "Adds versioned combined-setup capability discovery, optional named-subject intent, owner-selected existing-account approval and explicit sign-on result metadata. Legacy reporting-only requests remain supported."
+    "Adds the shared package-family, status, release identity and prepare-and-test plan contract used by the admin and website daily maintenance tooling."
   ],
   "repository": "https://github.com/jackperrotta/website-admin-harness",
   "readmePath": "packages/contracts/README.md",
-  "ref": "v1.4.0",
-  "documentation": "# Website Admin Contracts\r\n\r\nValidated installation manifests, roles, permissions and module contracts for `@tryvitris/website-admin-harness`. Node.js 24+. MIT licensed.\r\n",
-  "documentationSha256": "dc7fd3ba89b1a0a49046735adc8963115551a0d8cc7a4e64e8fba70c79ca9389"
+  "ref": "v1.5.0",
+  "documentation": "# Website Admin Contracts\r\n\r\nValidated installation manifests, roles, permissions and module contracts for `@tryvitris/website-admin-harness`. Node.js 24+. MIT licensed.\r\n\r\nThe maintenance contract exports the stable admin package family and typed installed/locked/published-version reports and preparation plans. Its policy is prepare-and-test under existing publication permissions. It does not execute updates or create schedules; use the runtime maintenance CLI and its agent guide.\r\n",
+  "documentationSha256": "53077ee5624185df808524801143734e7d9786aab747834e83a8603de06a1ee8"
 }