feat(deploy): add Contabo release workflow and portal payload gate

www/tools/deploy-portal-resources.mjs

@@ -0,0 +1,92 @@
+/** Prepare and optionally transfer already-approved employee resources. */
+import { createHash } from 'node:crypto';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+import { rsyncArguments, sshTarget } from './deploy.mjs';
+
+const toolRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const repositoryRoot = path.resolve(toolRoot, '..');
+const root = '/srv/www/azinstitute4autism.com';
+const hash = (bytes) => createHash('sha256').update(bytes).digest('hex');
+const fullSha = /^[0-9a-f]{40}$/;
+function fail(message) { throw new Error(message); }
+function run(command, args, { quiet = false } = {}) {
+  const result = spawnSync(command, args, { cwd: toolRoot, encoding: 'utf8' });
+  if (result.error || result.status !== 0) fail(`${command} failed${result.stderr ? `: ${result.stderr.trim()}` : ''}`);
+  if (!quiet && result.stdout) process.stdout.write(result.stdout);
+  return result.stdout.trim();
+}
+function safeName(value) { return typeof value === 'string' && /^[A-Za-z0-9][A-Za-z0-9._-]{0,240}$/.test(value) && value !== '.' && value !== '..'; }
+function roleAndName(record) {
+  if (!['STAFF-INTERNAL', 'MANAGEMENT-INTERNAL'].includes(record.classification)) fail('Every installed resource must have an approved internal classification');
+  const role = record.classification === 'STAFF-INTERNAL' ? 'staff' : 'management';
+  const prefix = `/${role}-resources/`;
+  if (!record.destinationImplemented || !record.destinationVerified || !record.destinationAccessControlled || !record.rewriteApproved || typeof record.deliveryPath !== 'string' || !record.deliveryPath.startsWith(prefix)) fail('Resource destination is not deployment-approved');
+  const name = record.deliveryPath.slice(prefix.length);
+  if (!safeName(name) || record.deliveryPath !== `${prefix}${name}`) fail('Resource destination path is unsafe');
+  return { role, name };
+}
+export async function prepareResourcePlan(privateRoot, staging, sourceCommit) {
+  if (!fullSha.test(sourceCommit)) fail('Full source Git SHA required');
+  const manifestPath = path.join(privateRoot, 'manifest.json');
+  const manifestStat = await fs.lstat(manifestPath).catch(() => null);
+  if (!manifestStat?.isFile() || manifestStat.isSymbolicLink() || manifestStat.size > 4_000_000) fail('Private employee resource manifest is unavailable or unsafe');
+  const manifest = JSON.parse(await fs.readFile(manifestPath, 'utf8'));
+  if (!Array.isArray(manifest.resources)) fail('Private resource manifest has no resource list');
+  const seen = new Set(), files = [];
+  for (const record of manifest.resources) {
+    if (!['STAFF-INTERNAL','MANAGEMENT-INTERNAL'].includes(record.classification)) continue;
+    const { role, name } = roleAndName(record);
+    if (!safeName(record.localFile) || !/^[0-9a-f]{64}$/.test(record.sha256 ?? '') || !Number.isInteger(record.size) || record.size <= 0 || record.size > 50 * 1024 * 1024) fail('Approved resource lacks bounded verified local metadata');
+    if (seen.has(`${role}/${name}`)) fail('Two resources map to the same protected destination');
+    seen.add(`${role}/${name}`);
+    const source = path.join(privateRoot, 'hubfs', record.localFile);
+    const stat = await fs.lstat(source).catch(() => null);
+    if (!stat?.isFile() || stat.isSymbolicLink() || stat.nlink !== 1) fail(`Approved resource is missing or unsafe: ${role}/${name}`);
+    const bytes = await fs.readFile(source);
+    if (bytes.length !== record.size || hash(bytes) !== record.sha256) fail(`Approved resource hash mismatch: ${role}/${name}`);
+    const destination = path.join(staging, role);
+    await fs.mkdir(destination, { recursive: true, mode: 0o700 });
+    await fs.copyFile(source, path.join(destination, record.localFile), fs.constants.COPYFILE_EXCL);
+    files.push({ role, name, stageName: record.localFile, sha256: record.sha256, size: record.size });
+  }
+  if (!files.length) fail('No deployment-approved internal resources are present; reconcile the private manifest first');
+  return { schema: 1, sourceCommit, files: files.sort((a, b) => `${a.role}/${a.name}`.localeCompare(`${b.role}/${b.name}`)) };
+}
+function parse(argv) {
+  const valid = new Set(['--dry-run','--confirm']);
+  if (!argv.length || argv.some((arg) => !valid.has(arg)) || (argv.includes('--dry-run') && argv.includes('--confirm'))) fail('Usage: npm run deploy:portal-resources -- --dry-run | npm run deploy:portal-resources -- --confirm');
+  return { dryRun: argv.includes('--dry-run'), confirm: argv.includes('--confirm') };
+}
+async function main() {
+  const options = parse(process.argv.slice(2));
+  const sha = run('git', ['-C', repositoryRoot, 'rev-parse', 'HEAD'], { quiet: true });
+  if (!fullSha.test(sha) || run('git', ['-C', repositoryRoot, 'status', '--porcelain=v1', '--untracked-files=all'], { quiet: true })) fail('Resource installation requires a clean committed worktree');
+  const privateRoot = process.env.AIA_PORTAL_PRIVATE_ROOT || path.join(toolRoot, 'private', 'employee-portal');
+  const temporary = await fs.mkdtemp(path.join(os.tmpdir(), 'aia-portal-resources-'));
+  try {
+    const staging = path.join(temporary, `portal-resources-${sha}`);
+    const plan = await prepareResourcePlan(privateRoot, staging, sha);
+    const planFile = path.join(temporary, `aia-portal-resources-${sha}.json`);
+    await fs.writeFile(planFile, JSON.stringify(plan, null, 2) + '\n', { mode: 0o600 });
+    if (options.dryRun) { console.log(JSON.stringify({ dryRun: true, sourceCommit: sha, resources: plan.files.map(({ role, name, sha256, size }) => ({ role, name, sha256, size })) }, null, 2)); return; }
+    if (!options.confirm) fail('Refusing employee-file transfer without --confirm');
+    const host = process.env.AIA_DEPLOY_HOST, identity = process.env.AIA_DEPLOY_SSH_IDENTITY;
+    const [ssh, ...sshOptions] = sshTarget(host, identity);
+    const remoteStage = `${root}/staging/portal-resources-${sha}`, remotePlan = `/root/aia-portal-resources-${sha}.json`;
+    const transport = `${ssh} ${sshOptions.map((item) => `'${item.replaceAll("'", "'\\''")}'`).join(' ')}`;
+    run(ssh, [...sshOptions, host, `install -d -m 0700 ${remoteStage}/staff ${remoteStage}/management`]);
+    for (const role of ['staff','management']) {
+      const args = rsyncArguments(path.join(staging, role), `${host}:${remoteStage}/${role}`, { remove: false });
+      args.splice(-2, 0, '-e', transport);
+      run('rsync', args);
+    }
+    run('rsync', ['-rlt', '--chown=root:root', '--chmod=Fu=rw,Fgo=', '-e', transport, planFile, `${host}:${remotePlan}`]);
+    run(ssh, [...sshOptions, host, `node ${root}/www/tools/portal-resource-install.mjs ${remoteStage} ${remotePlan}`]);
+    console.log(JSON.stringify({ installed: true, sourceCommit: sha, resources: plan.files.length }, null, 2));
+  } finally { await fs.rm(temporary, { recursive: true, force: true }); }
+}
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) main().catch((error) => { console.error(`Employee resource installation stopped: ${error.message}`); process.exitCode = 1; });