@ccslabs/xtend 0.1.0-rc.1 → 0.1.2

package/catalog/epic18-rmt-app-platform-release-handoff.js

@@ -0,0 +1,231 @@
+const {
+  KERNEL_BOUNDARY
+} = require('./epic12-rc0-gate-matrix');
+const {
+  RMT_APP_PLATFORM_FIXTURE_SCHEMA,
+  RMT_APP_PLATFORM_FIXTURE_WORKPACKAGE
+} = require('./epic18-rmt-app-platform-fixture');
+
+const EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_SCHEMA = 'xtend.epic18.rmt-app-platform-release-handoff.v1';
+const EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_REPORT_SCHEMA = 'xtend.epic18.rmt-app-platform-release-handoff-report.v1';
+const EPIC18_RMT_APP_PLATFORM_GATE_MATRIX_SCHEMA = 'xtend.epic18.rmt-app-platform-gate-matrix.v1';
+const EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_WORKPACKAGE = 'WP-E18-13';
+const EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_STATUS = 'accepted-docs-migration-vendor-rebuild-release-handoff';
+const EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_TARGET = 'epic18-rmt-app-platform-release-ready';
+const EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_MODULE = 'catalog/epic18-rmt-app-platform-release-handoff.js';
+const EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_SUITE = 'tests/platform/epic18_rmt_app_platform_release_handoff_suite.js';
+const EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_DOCS = 'docs/epic18-rmt-app-platform-release-handoff.md';
+const EPIC18_RMT_APP_PLATFORM_MIGRATION_GUIDE = 'docs/rmt-app-platform-migration-guide.md';
+const EPIC18_VENDOR_BUGFIX_DOCS = 'docs/epic18-vendor-bugfixes.md';
+const EPIC18_RMT_APP_PLATFORM_WORKPACKAGE_DOC = 'development/WP-E18-13-Docs-Migration-Guide-Vendor-Rebuild-und-Release-Handoff.md';
+const EPIC18_BACKLOG = 'development/BACKLOG-EPIC-18-XTendRMT-App-Platform-und-Media-Manager-Vendor-Upstream.md';
+const EPIC18_DOCUMENT = 'docs/epic18-media-manager-vendor-upstream.md';
+const EPIC18_LOCAL_GATE = 'node scripts/run_xtend_tests.js epic18-rmt-app-platform --json';
+const EPIC18_PACKAGE_SCRIPT = 'npm run test:epic18-rmt-app-platform';
+
+const REQUIRED_DOCS = Object.freeze([
+  EPIC18_DOCUMENT,
+  EPIC18_VENDOR_BUGFIX_DOCS,
+  'docs/rmt-app-platform-authoring.md',
+  'docs/rmt-dom-descriptor-renderer.md',
+  'docs/rmt-component-template-primitives.md',
+  'docs/rmt-state-selector-runtime.md',
+  'docs/rmt-action-effect-runtime.md',
+  'docs/rmt-event-routing-runtime.md',
+  'docs/rmt-surface-resource-graph-runtime.md',
+  'docs/rmt-app-platform-tooling.md',
+  'docs/rmt-app-platform-fixture.md',
+  EPIC18_RMT_APP_PLATFORM_MIGRATION_GUIDE,
+  EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_DOCS,
+  EPIC18_RMT_APP_PLATFORM_WORKPACKAGE_DOC
+]);
+
+const REQUIRED_RELEASE_GATES = Object.freeze([
+  'epic18-vendor-bugfix-smokes',
+  'rmt-app-platform-authoring',
+  'rmt-dom-descriptor-renderer',
+  'rmt-component-template-primitives',
+  'rmt-state-selector-runtime',
+  'rmt-action-effect-runtime',
+  'rmt-event-routing-runtime',
+  'rmt-surface-resource-graph-runtime',
+  'rmt-app-platform-tooling',
+  'rmt-app-platform-fixture',
+  'type-exports-rmt',
+  'type-exports',
+  'epic13-package-export-lock',
+  'epic18-rmt-app-platform'
+]);
+
+const REQUIRED_COMMANDS = Object.freeze([
+  'node scripts/run_xtend_tests.js components surface-controller surface-manager-browser overlay-interaction-ux layout-display-media-ux epic18-vendor-bugfix-smokes browser references --json',
+  'node scripts/run_xtend_tests.js rmt-app-platform-authoring rmt-dom-descriptor-renderer rmt-component-template-primitives rmt-state-selector-runtime rmt-action-effect-runtime rmt-event-routing-runtime rmt-surface-resource-graph-runtime rmt-app-platform-tooling rmt-app-platform-fixture rmt-vnext-compiler rmt-vnext-events rmt-vnext-surfaces rmt-vnext-security rmt-first-demo-app scaffold-rmt-build --json',
+  'node scripts/run_xtend_tests.js type-exports-rmt type-exports epic13-package-export-lock --json',
+  EPIC18_LOCAL_GATE,
+  'npm run test:pr:report',
+  'npm run test:release:full:report',
+  'npm run pack:dry-run'
+]);
+
+const GITHUB_ACTIONS = Object.freeze({
+  workflow: '.github/workflows/xtend-default-gates.yml',
+  nodeVersion: '26.x',
+  prFastCommand: 'npm run test:pr:report',
+  prFastReport: '.xtend-test-results/xtend-pr-gate-report.json',
+  prFastArtifact: 'xtend-pr-gate-report-node-26',
+  fullReleaseCommand: 'npm run test:release:full:report',
+  fullReleaseReport: '.xtend-test-results/xtend-release-gate-report.json',
+  fullReleaseArtifact: 'xtend-release-gate-report-node-26',
+  conditionalNetworkCommand: 'npm run conditional-network:evidence',
+  conditionalNetworkExecuteEnv: 'XTEND_CONDITIONAL_NETWORK_EXECUTE=1'
+});
+
+function createEpic18RmtAppPlatformReleaseHandoffPlan(options = {}) {
+  return {
+    schema: EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_SCHEMA,
+    reportSchema: EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_REPORT_SCHEMA,
+    gateMatrixSchema: EPIC18_RMT_APP_PLATFORM_GATE_MATRIX_SCHEMA,
+    fixtureSchema: RMT_APP_PLATFORM_FIXTURE_SCHEMA,
+    fixtureWorkpackage: RMT_APP_PLATFORM_FIXTURE_WORKPACKAGE,
+    workpackage: EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_WORKPACKAGE,
+    status: EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_STATUS,
+    generatedAt: options.generatedAt || 'static-local',
+    targetReadiness: EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_TARGET,
+    module: EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_MODULE,
+    suite: EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_SUITE,
+    docs: EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_DOCS,
+    migrationGuide: EPIC18_RMT_APP_PLATFORM_MIGRATION_GUIDE,
+    vendorBugfixDocs: EPIC18_VENDOR_BUGFIX_DOCS,
+    workpackageDocument: EPIC18_RMT_APP_PLATFORM_WORKPACKAGE_DOC,
+    epic: EPIC18_DOCUMENT,
+    backlog: EPIC18_BACKLOG,
+    localGate: EPIC18_LOCAL_GATE,
+    packageScript: EPIC18_PACKAGE_SCRIPT,
+    requiredDocs: REQUIRED_DOCS.slice(),
+    releaseGates: REQUIRED_RELEASE_GATES.slice(),
+    requiredCommands: REQUIRED_COMMANDS.slice(),
+    githubActions: { ...GITHUB_ACTIONS },
+    releaseEvidence: {
+      packDryRunCommand: 'npm run pack:dry-run',
+      packageExportLockGate: 'node scripts/run_xtend_tests.js epic13-package-export-lock --json',
+      packageExportLockReport: '.xtend-test-results/xtend-package-export-lock-report.json',
+      packageExportSurfaceLock: '.xtend-test-results/xtend-package-export-surface-lock.json',
+      releaseReportCommand: 'npm run release:report'
+    },
+    completion: {
+      epicStatus: 'completed',
+      completedWorkpackages: Array.from({ length: 13 }, (_, index) => `WP-E18-${String(index + 1).padStart(2, '0')}`),
+      nextWorkpackage: null,
+      publishAllowed: false,
+      publishBoundary: 'private-until-release-owner-acceptance'
+    },
+    model: {
+      componentBugfixDocsComplete: true,
+      rmtAppPlatformGuideComplete: true,
+      migrationAwayFromManualHtmlHostsComplete: true,
+      vendorRebuildReady: true,
+      packageExportLockReady: true,
+      githubActionsReady: true,
+      prFastGateIncludesEpic18: true,
+      fullReleaseRunsEpic18: true
+    },
+    kernelBoundary: KERNEL_BOUNDARY
+  };
+}
+
+function validateEpic18RmtAppPlatformReleaseHandoffPlan(plan = createEpic18RmtAppPlatformReleaseHandoffPlan()) {
+  const errors = [];
+  const model = plan && plan.model ? plan.model : {};
+  const completion = plan && plan.completion ? plan.completion : {};
+
+  if (!plan || plan.schema !== EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_SCHEMA) errors.push(`schema must be ${EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_SCHEMA}`);
+  if (!plan || plan.reportSchema !== EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_REPORT_SCHEMA) errors.push(`reportSchema must be ${EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_REPORT_SCHEMA}`);
+  if (!plan || plan.gateMatrixSchema !== EPIC18_RMT_APP_PLATFORM_GATE_MATRIX_SCHEMA) errors.push(`gateMatrixSchema must be ${EPIC18_RMT_APP_PLATFORM_GATE_MATRIX_SCHEMA}`);
+  if (!plan || plan.fixtureSchema !== RMT_APP_PLATFORM_FIXTURE_SCHEMA) errors.push('WP-E18-13 must build on the WP-E18-12 fixture');
+  if (!plan || plan.fixtureWorkpackage !== RMT_APP_PLATFORM_FIXTURE_WORKPACKAGE) errors.push('fixture workpackage must be WP-E18-12');
+  if (!plan || plan.workpackage !== EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_WORKPACKAGE) errors.push(`workpackage must be ${EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_WORKPACKAGE}`);
+  if (!plan || plan.status !== EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_STATUS) errors.push(`status must be ${EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_STATUS}`);
+  if (!plan || plan.targetReadiness !== EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_TARGET) errors.push(`targetReadiness must be ${EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_TARGET}`);
+  REQUIRED_DOCS.forEach((docPath) => {
+    if (!plan || !plan.requiredDocs.includes(docPath)) errors.push(`required doc missing: ${docPath}`);
+  });
+  REQUIRED_RELEASE_GATES.forEach((gate) => {
+    if (!plan || !plan.releaseGates.includes(gate)) errors.push(`release gate missing: ${gate}`);
+  });
+  REQUIRED_COMMANDS.forEach((command) => {
+    if (!plan || !plan.requiredCommands.includes(command)) errors.push(`required command missing: ${command}`);
+  });
+  if (!plan || !plan.githubActions || plan.githubActions.workflow !== GITHUB_ACTIONS.workflow) errors.push('GitHub Actions workflow path must remain stable');
+  if (!plan || !plan.githubActions || plan.githubActions.prFastCommand !== GITHUB_ACTIONS.prFastCommand) errors.push('GitHub PR fast command must remain stable');
+  if (!plan || !plan.githubActions || plan.githubActions.fullReleaseCommand !== GITHUB_ACTIONS.fullReleaseCommand) errors.push('GitHub full release command must remain stable');
+  if (completion.completedWorkpackages && completion.completedWorkpackages.length !== 13) errors.push('Epic 18 completion must list all 13 workpackages');
+  if (completion.epicStatus !== 'completed') errors.push('Epic 18 completion must be completed');
+  if (completion.nextWorkpackage !== null) errors.push('Epic 18 must not expose another internal next workpackage');
+  if (completion.publishAllowed !== false) errors.push('Epic 18 handoff must not allow publish by itself');
+  if (model.componentBugfixDocsComplete !== true) errors.push('component bugfix docs must be complete');
+  if (model.rmtAppPlatformGuideComplete !== true) errors.push('RMT App Platform guide must be complete');
+  if (model.migrationAwayFromManualHtmlHostsComplete !== true) errors.push('manual HTML host migration guide must be complete');
+  if (model.vendorRebuildReady !== true) errors.push('vendor rebuild must be ready');
+  if (model.packageExportLockReady !== true) errors.push('package export lock must be ready');
+  if (model.githubActionsReady !== true) errors.push('GitHub Actions must be ready');
+  if (model.prFastGateIncludesEpic18 !== true) errors.push('PR fast gate must include Epic 18');
+  if (model.fullReleaseRunsEpic18 !== true) errors.push('full release gate must run Epic 18');
+  if (!plan || plan.kernelBoundary !== KERNEL_BOUNDARY) errors.push(`kernelBoundary must be ${KERNEL_BOUNDARY}`);
+
+  return {
+    schema: EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_REPORT_SCHEMA,
+    ok: errors.length === 0,
+    errors,
+    workpackage: EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_WORKPACKAGE,
+    checkedAt: 'static-local'
+  };
+}
+
+function createEpic18RmtAppPlatformReleaseHandoffReport(options = {}) {
+  const plan = options.plan || createEpic18RmtAppPlatformReleaseHandoffPlan(options);
+  const validation = validateEpic18RmtAppPlatformReleaseHandoffPlan(plan);
+
+  return {
+    schema: EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_REPORT_SCHEMA,
+    ok: validation.ok,
+    errors: validation.errors.slice(),
+    workpackage: plan.workpackage,
+    status: plan.status,
+    targetReadiness: plan.targetReadiness,
+    docsCount: plan.requiredDocs.length,
+    releaseGateCount: plan.releaseGates.length,
+    requiredCommandCount: plan.requiredCommands.length,
+    completedWorkpackageCount: plan.completion.completedWorkpackages.length,
+    githubWorkflow: plan.githubActions.workflow,
+    prFastCommand: plan.githubActions.prFastCommand,
+    fullReleaseCommand: plan.githubActions.fullReleaseCommand,
+    packageDryRunCommand: plan.releaseEvidence.packDryRunCommand,
+    kernelBoundary: plan.kernelBoundary
+  };
+}
+
+module.exports = {
+  EPIC18_BACKLOG,
+  EPIC18_DOCUMENT,
+  EPIC18_LOCAL_GATE,
+  EPIC18_PACKAGE_SCRIPT,
+  EPIC18_RMT_APP_PLATFORM_GATE_MATRIX_SCHEMA,
+  EPIC18_RMT_APP_PLATFORM_MIGRATION_GUIDE,
+  EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_DOCS,
+  EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_MODULE,
+  EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_REPORT_SCHEMA,
+  EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_SCHEMA,
+  EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_STATUS,
+  EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_SUITE,
+  EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_TARGET,
+  EPIC18_RMT_APP_PLATFORM_RELEASE_HANDOFF_WORKPACKAGE,
+  EPIC18_RMT_APP_PLATFORM_WORKPACKAGE_DOC,
+  EPIC18_VENDOR_BUGFIX_DOCS,
+  GITHUB_ACTIONS,
+  REQUIRED_COMMANDS,
+  REQUIRED_DOCS,
+  REQUIRED_RELEASE_GATES,
+  createEpic18RmtAppPlatformReleaseHandoffPlan,
+  createEpic18RmtAppPlatformReleaseHandoffReport,
+  validateEpic18RmtAppPlatformReleaseHandoffPlan
+};

package/catalog/epic18-rmt-app-platform-tooling.d.ts

@@ -0,0 +1,38 @@
+import type {
+  XtendCatalogConstant,
+  XtendCatalogOptions,
+  XtendCatalogPlan,
+  XtendCatalogReport
+} from './catalog-public-types';
+
+export declare const NEXT_DECISION: string;
+export declare const NEXT_WORKPACKAGE: string;
+export declare const REQUIRED_ARTIFACTS: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_BOUNDARIES: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_COMPLETION_CONTEXTS: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_DIAGNOSTIC_CODES: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_DOCS: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_TOOLING_CAPABILITIES: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const RMT_APP_PLATFORM_SCAFFOLD_SCHEMA: string;
+export declare const RMT_APP_PLATFORM_SOURCE_MAP_SCHEMA: string;
+export declare const RMT_APP_PLATFORM_TOOLING_BACKLOG: string;
+export declare const RMT_APP_PLATFORM_TOOLING_DOCS: string;
+export declare const RMT_APP_PLATFORM_TOOLING_EPIC: string;
+export declare const RMT_APP_PLATFORM_TOOLING_FIXTURE: string;
+export declare const RMT_APP_PLATFORM_TOOLING_FIXTURE_SCHEMA: string;
+export declare const RMT_APP_PLATFORM_TOOLING_GENERATOR: string;
+export declare const RMT_APP_PLATFORM_TOOLING_LOCAL_GATE: string;
+export declare const RMT_APP_PLATFORM_TOOLING_MODULE: string;
+export declare const RMT_APP_PLATFORM_TOOLING_PACKAGE_SCRIPT: string;
+export declare const RMT_APP_PLATFORM_TOOLING_REPORT_SCHEMA: string;
+export declare const RMT_APP_PLATFORM_TOOLING_RUNTIME: string;
+export declare const RMT_APP_PLATFORM_TOOLING_SCHEMA: string;
+export declare const RMT_APP_PLATFORM_TOOLING_STATUS: string;
+export declare const RMT_APP_PLATFORM_TOOLING_SUITE: string;
+export declare const RMT_APP_PLATFORM_TOOLING_TARGET: string;
+export declare const RMT_APP_PLATFORM_TOOLING_TYPES: string;
+export declare const RMT_APP_PLATFORM_TOOLING_WORKPACKAGE: string;
+export declare const RMT_APP_PLATFORM_TOOLING_WORKPACKAGE_DOC: string;
+export declare function createRmtAppPlatformToolingPlan(options?: XtendCatalogOptions): XtendCatalogPlan;
+export declare function createRmtAppPlatformToolingReport(options?: XtendCatalogOptions): XtendCatalogReport;
+export declare function validateRmtAppPlatformToolingPlan(plan?: unknown): XtendCatalogReport;

package/catalog/epic18-rmt-app-platform-tooling.js

@@ -0,0 +1,242 @@
+const {
+  KERNEL_BOUNDARY
+} = require('./epic12-rc0-gate-matrix');
+const {
+  RMT_SURFACE_RESOURCE_GRAPH_RUNTIME_SCHEMA,
+  RMT_SURFACE_RESOURCE_GRAPH_RUNTIME_WORKPACKAGE
+} = require('./epic18-rmt-surface-resource-graph-runtime');
+
+const RMT_APP_PLATFORM_TOOLING_SCHEMA = 'xtend.epic18.rmt-app-platform-tooling.v1';
+const RMT_APP_PLATFORM_TOOLING_REPORT_SCHEMA = 'xtend.epic18.rmt-app-platform-tooling-report.v1';
+const RMT_APP_PLATFORM_TOOLING_FIXTURE_SCHEMA = 'xtend.epic18.rmt-app-platform-tooling-fixture.v1';
+const RMT_APP_PLATFORM_SCAFFOLD_SCHEMA = 'xtend.epic18.rmt-app-platform-scaffold.v1';
+const RMT_APP_PLATFORM_SOURCE_MAP_SCHEMA = 'xtend.epic18.rmt-app-platform-source-map.v1';
+const RMT_APP_PLATFORM_TOOLING_WORKPACKAGE = 'WP-E18-11';
+const RMT_APP_PLATFORM_TOOLING_STATUS = 'accepted-rmt-app-platform-scaffold-linter-lsp-diagnostics';
+const RMT_APP_PLATFORM_TOOLING_TARGET = 'rmt-app-platform-authoring-tooling-ready';
+const RMT_APP_PLATFORM_TOOLING_MODULE = 'catalog/epic18-rmt-app-platform-tooling.js';
+const RMT_APP_PLATFORM_TOOLING_RUNTIME = 'tools/rmt-language/app-platform-tooling.js';
+const RMT_APP_PLATFORM_TOOLING_TYPES = 'tools/rmt-language/app-platform-tooling.d.ts';
+const RMT_APP_PLATFORM_TOOLING_GENERATOR = 'xtend-builder/generators/rmt-app-platform.js';
+const RMT_APP_PLATFORM_TOOLING_SUITE = 'tests/rmt-language/rmt_app_platform_tooling_suite.js';
+const RMT_APP_PLATFORM_TOOLING_FIXTURE = 'tests/fixtures/rmt-app-platform-tooling.rmt';
+const RMT_APP_PLATFORM_TOOLING_DOCS = 'docs/rmt-app-platform-tooling.md';
+const RMT_APP_PLATFORM_TOOLING_WORKPACKAGE_DOC = 'development/WP-E18-11-Scaffold-Linter-LSP-und-Diagnostics-fuer-RMT-Apps-erweitern.md';
+const RMT_APP_PLATFORM_TOOLING_BACKLOG = 'development/BACKLOG-EPIC-18-XTendRMT-App-Platform-und-Media-Manager-Vendor-Upstream.md';
+const RMT_APP_PLATFORM_TOOLING_EPIC = 'docs/epic18-media-manager-vendor-upstream.md';
+const RMT_APP_PLATFORM_TOOLING_LOCAL_GATE = 'node scripts/run_xtend_tests.js rmt-app-platform-tooling --json';
+const RMT_APP_PLATFORM_TOOLING_PACKAGE_SCRIPT = 'npm run test:rmt-app-platform-tooling';
+const NEXT_WORKPACKAGE = 'WP-E18-12';
+const NEXT_DECISION = 'generic-rmt-app-platform-fixture';
+
+const REQUIRED_TOOLING_CAPABILITIES = Object.freeze([
+  'scaffold-pipeline-for-rmt-app-sources',
+  'no-manual-shell-html-sink-diagnostics',
+  'unsafe-html-boundary-diagnostics',
+  'unkeyed-repeat-diagnostics',
+  'untyped-event-diagnostics',
+  'resource-ownership-diagnostics',
+  'portal-resource-reference-diagnostics',
+  'app-platform-completions',
+  'app-platform-hover',
+  'source-map-build-report'
+]);
+
+const REQUIRED_DIAGNOSTIC_CODES = Object.freeze([
+  'rmt.app.no-manual-shell.html-sink',
+  'rmt.app.unsafe-html.boundary-missing',
+  'rmt.app.repeat.key.missing',
+  'rmt.app.event.payload-contract.missing',
+  'rmt.app.resource.ownership.missing',
+  'rmt.app.resource.unresolved',
+  'rmt.app.portal.unresolved',
+  'rmt.app.surface.source.unresolved'
+]);
+
+const REQUIRED_COMPLETION_CONTEXTS = Object.freeze([
+  'portal-ids',
+  'portal-policies',
+  'overlay-kinds',
+  'resource-kinds',
+  'resource-ids',
+  'event-kinds',
+  'surface-states'
+]);
+
+const REQUIRED_BOUNDARIES = Object.freeze([
+  'no-rmt-kernel-import-of-xtend-types',
+  'diagnostics-before-runtime',
+  'scaffold-output-owned-by-write-plan',
+  'no-product-bound-surface-list',
+  'normal-ui-no-html-string-renderer',
+  'lsp-surface-is-tooling-only'
+]);
+
+const REQUIRED_ARTIFACTS = Object.freeze([
+  RMT_APP_PLATFORM_TOOLING_MODULE,
+  RMT_APP_PLATFORM_TOOLING_RUNTIME,
+  RMT_APP_PLATFORM_TOOLING_TYPES,
+  RMT_APP_PLATFORM_TOOLING_GENERATOR,
+  RMT_APP_PLATFORM_TOOLING_SUITE,
+  RMT_APP_PLATFORM_TOOLING_FIXTURE,
+  RMT_APP_PLATFORM_TOOLING_DOCS,
+  RMT_APP_PLATFORM_TOOLING_WORKPACKAGE_DOC
+]);
+
+const REQUIRED_DOCS = Object.freeze([
+  RMT_APP_PLATFORM_TOOLING_DOCS,
+  RMT_APP_PLATFORM_TOOLING_WORKPACKAGE_DOC,
+  RMT_APP_PLATFORM_TOOLING_BACKLOG,
+  RMT_APP_PLATFORM_TOOLING_EPIC
+]);
+
+function createRmtAppPlatformToolingPlan(options = {}) {
+  return {
+    schema: RMT_APP_PLATFORM_TOOLING_SCHEMA,
+    reportSchema: RMT_APP_PLATFORM_TOOLING_REPORT_SCHEMA,
+    fixtureSchema: RMT_APP_PLATFORM_TOOLING_FIXTURE_SCHEMA,
+    scaffoldSchema: RMT_APP_PLATFORM_SCAFFOLD_SCHEMA,
+    sourceMapSchema: RMT_APP_PLATFORM_SOURCE_MAP_SCHEMA,
+    surfaceResourceGraphRuntimeSchema: RMT_SURFACE_RESOURCE_GRAPH_RUNTIME_SCHEMA,
+    surfaceResourceGraphRuntimeWorkpackage: RMT_SURFACE_RESOURCE_GRAPH_RUNTIME_WORKPACKAGE,
+    workpackage: RMT_APP_PLATFORM_TOOLING_WORKPACKAGE,
+    status: RMT_APP_PLATFORM_TOOLING_STATUS,
+    generatedAt: options.generatedAt || 'static-local',
+    targetReadiness: RMT_APP_PLATFORM_TOOLING_TARGET,
+    module: RMT_APP_PLATFORM_TOOLING_MODULE,
+    runtime: RMT_APP_PLATFORM_TOOLING_RUNTIME,
+    types: RMT_APP_PLATFORM_TOOLING_TYPES,
+    generator: RMT_APP_PLATFORM_TOOLING_GENERATOR,
+    suite: RMT_APP_PLATFORM_TOOLING_SUITE,
+    fixture: RMT_APP_PLATFORM_TOOLING_FIXTURE,
+    docs: RMT_APP_PLATFORM_TOOLING_DOCS,
+    workpackageDocument: RMT_APP_PLATFORM_TOOLING_WORKPACKAGE_DOC,
+    localGate: RMT_APP_PLATFORM_TOOLING_LOCAL_GATE,
+    packageScript: RMT_APP_PLATFORM_TOOLING_PACKAGE_SCRIPT,
+    capabilities: REQUIRED_TOOLING_CAPABILITIES.slice(),
+    diagnosticCodes: REQUIRED_DIAGNOSTIC_CODES.slice(),
+    completionContexts: REQUIRED_COMPLETION_CONTEXTS.slice(),
+    boundaries: REQUIRED_BOUNDARIES.slice(),
+    artifactPaths: REQUIRED_ARTIFACTS.slice(),
+    requiredDocs: REQUIRED_DOCS.slice(),
+    model: {
+      scaffoldBuildsDiagnosticsAndSourceMaps: true,
+      linterBlocksUnsafeAppShells: true,
+      lspExposesAppPlatformPrimitives: true,
+      sourceMapLinksSurfaceOverlayResourceEvents: true,
+      productSurfaceTaxonomyAllowed: false,
+      productRegistryRepaintRequired: false,
+      htmlStringRendererRequired: false
+    },
+    kernelBoundary: KERNEL_BOUNDARY,
+    nextWorkpackage: NEXT_WORKPACKAGE,
+    nextDecision: NEXT_DECISION
+  };
+}
+
+function validateRmtAppPlatformToolingPlan(plan = createRmtAppPlatformToolingPlan()) {
+  const errors = [];
+  const model = plan && plan.model ? plan.model : {};
+
+  if (!plan || plan.schema !== RMT_APP_PLATFORM_TOOLING_SCHEMA) errors.push(`schema must be ${RMT_APP_PLATFORM_TOOLING_SCHEMA}`);
+  if (!plan || plan.reportSchema !== RMT_APP_PLATFORM_TOOLING_REPORT_SCHEMA) errors.push(`reportSchema must be ${RMT_APP_PLATFORM_TOOLING_REPORT_SCHEMA}`);
+  if (!plan || plan.fixtureSchema !== RMT_APP_PLATFORM_TOOLING_FIXTURE_SCHEMA) errors.push(`fixtureSchema must be ${RMT_APP_PLATFORM_TOOLING_FIXTURE_SCHEMA}`);
+  if (!plan || plan.scaffoldSchema !== RMT_APP_PLATFORM_SCAFFOLD_SCHEMA) errors.push(`scaffoldSchema must be ${RMT_APP_PLATFORM_SCAFFOLD_SCHEMA}`);
+  if (!plan || plan.sourceMapSchema !== RMT_APP_PLATFORM_SOURCE_MAP_SCHEMA) errors.push(`sourceMapSchema must be ${RMT_APP_PLATFORM_SOURCE_MAP_SCHEMA}`);
+  if (!plan || plan.surfaceResourceGraphRuntimeSchema !== RMT_SURFACE_RESOURCE_GRAPH_RUNTIME_SCHEMA) errors.push('WP-E18-11 must build on WP-E18-10');
+  if (!plan || plan.surfaceResourceGraphRuntimeWorkpackage !== RMT_SURFACE_RESOURCE_GRAPH_RUNTIME_WORKPACKAGE) errors.push('surface graph runtime workpackage must be WP-E18-10');
+  if (!plan || plan.workpackage !== RMT_APP_PLATFORM_TOOLING_WORKPACKAGE) errors.push(`workpackage must be ${RMT_APP_PLATFORM_TOOLING_WORKPACKAGE}`);
+  if (!plan || plan.status !== RMT_APP_PLATFORM_TOOLING_STATUS) errors.push(`status must be ${RMT_APP_PLATFORM_TOOLING_STATUS}`);
+  if (!plan || plan.targetReadiness !== RMT_APP_PLATFORM_TOOLING_TARGET) errors.push(`targetReadiness must be ${RMT_APP_PLATFORM_TOOLING_TARGET}`);
+  REQUIRED_TOOLING_CAPABILITIES.forEach((capability) => {
+    if (!plan || !plan.capabilities.includes(capability)) errors.push(`capability missing: ${capability}`);
+  });
+  REQUIRED_DIAGNOSTIC_CODES.forEach((code) => {
+    if (!plan || !plan.diagnosticCodes.includes(code)) errors.push(`diagnostic code missing: ${code}`);
+  });
+  REQUIRED_COMPLETION_CONTEXTS.forEach((context) => {
+    if (!plan || !plan.completionContexts.includes(context)) errors.push(`completion context missing: ${context}`);
+  });
+  REQUIRED_BOUNDARIES.forEach((boundary) => {
+    if (!plan || !plan.boundaries.includes(boundary)) errors.push(`boundary missing: ${boundary}`);
+  });
+  REQUIRED_ARTIFACTS.forEach((artifact) => {
+    if (!plan || !plan.artifactPaths.includes(artifact)) errors.push(`artifact missing: ${artifact}`);
+  });
+  REQUIRED_DOCS.forEach((doc) => {
+    if (!plan || !plan.requiredDocs.includes(doc)) errors.push(`doc missing: ${doc}`);
+  });
+  if (model.scaffoldBuildsDiagnosticsAndSourceMaps !== true) errors.push('scaffold must build diagnostics and source maps');
+  if (model.linterBlocksUnsafeAppShells !== true) errors.push('linter must block unsafe app shells');
+  if (model.lspExposesAppPlatformPrimitives !== true) errors.push('LSP must expose App Platform primitives');
+  if (model.sourceMapLinksSurfaceOverlayResourceEvents !== true) errors.push('source map must link surface, overlay, resource and event records');
+  if (model.productSurfaceTaxonomyAllowed !== false) errors.push('product surface taxonomy must stay disallowed');
+  if (model.productRegistryRepaintRequired !== false) errors.push('product registry repaint must not be required');
+  if (model.htmlStringRendererRequired !== false) errors.push('html string renderer must not be required');
+  if (!plan || plan.kernelBoundary !== KERNEL_BOUNDARY) errors.push(`kernelBoundary must be ${KERNEL_BOUNDARY}`);
+  if (!plan || plan.nextWorkpackage !== NEXT_WORKPACKAGE) errors.push(`nextWorkpackage must be ${NEXT_WORKPACKAGE}`);
+  if (!plan || plan.nextDecision !== NEXT_DECISION) errors.push(`nextDecision must be ${NEXT_DECISION}`);
+
+  return {
+    schema: RMT_APP_PLATFORM_TOOLING_REPORT_SCHEMA,
+    ok: errors.length === 0,
+    errors,
+    workpackage: RMT_APP_PLATFORM_TOOLING_WORKPACKAGE,
+    checkedAt: 'static-local'
+  };
+}
+
+function createRmtAppPlatformToolingReport(options = {}) {
+  const plan = options.plan || createRmtAppPlatformToolingPlan(options);
+  const validation = validateRmtAppPlatformToolingPlan(plan);
+
+  return {
+    schema: RMT_APP_PLATFORM_TOOLING_REPORT_SCHEMA,
+    ok: validation.ok,
+    errors: validation.errors.slice(),
+    workpackage: plan.workpackage,
+    status: plan.status,
+    targetReadiness: plan.targetReadiness,
+    capabilityCount: plan.capabilities.length,
+    diagnosticCodeCount: plan.diagnosticCodes.length,
+    completionContextCount: plan.completionContexts.length,
+    boundaryCount: plan.boundaries.length,
+    nextWorkpackage: plan.nextWorkpackage,
+    nextDecision: plan.nextDecision,
+    kernelBoundary: plan.kernelBoundary
+  };
+}
+
+module.exports = {
+  NEXT_DECISION,
+  NEXT_WORKPACKAGE,
+  REQUIRED_ARTIFACTS,
+  REQUIRED_BOUNDARIES,
+  REQUIRED_COMPLETION_CONTEXTS,
+  REQUIRED_DIAGNOSTIC_CODES,
+  REQUIRED_DOCS,
+  REQUIRED_TOOLING_CAPABILITIES,
+  RMT_APP_PLATFORM_SCAFFOLD_SCHEMA,
+  RMT_APP_PLATFORM_SOURCE_MAP_SCHEMA,
+  RMT_APP_PLATFORM_TOOLING_BACKLOG,
+  RMT_APP_PLATFORM_TOOLING_DOCS,
+  RMT_APP_PLATFORM_TOOLING_EPIC,
+  RMT_APP_PLATFORM_TOOLING_FIXTURE,
+  RMT_APP_PLATFORM_TOOLING_FIXTURE_SCHEMA,
+  RMT_APP_PLATFORM_TOOLING_GENERATOR,
+  RMT_APP_PLATFORM_TOOLING_LOCAL_GATE,
+  RMT_APP_PLATFORM_TOOLING_MODULE,
+  RMT_APP_PLATFORM_TOOLING_PACKAGE_SCRIPT,
+  RMT_APP_PLATFORM_TOOLING_REPORT_SCHEMA,
+  RMT_APP_PLATFORM_TOOLING_RUNTIME,
+  RMT_APP_PLATFORM_TOOLING_SCHEMA,
+  RMT_APP_PLATFORM_TOOLING_STATUS,
+  RMT_APP_PLATFORM_TOOLING_SUITE,
+  RMT_APP_PLATFORM_TOOLING_TARGET,
+  RMT_APP_PLATFORM_TOOLING_TYPES,
+  RMT_APP_PLATFORM_TOOLING_WORKPACKAGE,
+  RMT_APP_PLATFORM_TOOLING_WORKPACKAGE_DOC,
+  createRmtAppPlatformToolingPlan,
+  createRmtAppPlatformToolingReport,
+  validateRmtAppPlatformToolingPlan
+};

package/catalog/epic18-rmt-component-template-primitives.d.ts

@@ -0,0 +1,33 @@
+import type {
+  XtendCatalogConstant,
+  XtendCatalogOptions,
+  XtendCatalogPlan,
+  XtendCatalogReport
+} from './catalog-public-types';
+
+export declare const NEXT_DECISION: string;
+export declare const NEXT_WORKPACKAGE: string;
+export declare const REQUIRED_ARTIFACTS: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_BOUNDARIES: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_COMPONENT_FAMILIES: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_DOCS: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_RENDERER_CAPABILITIES: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_TEMPLATE_PRIMITIVES: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_DOCS: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_FIXTURE: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_FIXTURE_SCHEMA: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_LOCAL_GATE: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_MODULE: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_PACKAGE_SCRIPT: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_REPORT_SCHEMA: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_RUNTIME: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_SCHEMA: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_STATUS: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_SUITE: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_TARGET: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_TYPES: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_WORKPACKAGE: string;
+export declare const RMT_COMPONENT_TEMPLATE_PRIMITIVES_WORKPACKAGE_DOC: string;
+export declare function createRmtComponentTemplatePrimitivesPlan(options?: XtendCatalogOptions): XtendCatalogPlan;
+export declare function createRmtComponentTemplatePrimitivesReport(options?: XtendCatalogOptions): XtendCatalogReport;
+export declare function validateRmtComponentTemplatePrimitivesPlan(plan?: unknown): XtendCatalogReport;