Files
worldmonitor/scripts/desktop-package.mjs
Elie Habib fe67111dc9 feat: harness engineering P0 - linting, testing, architecture docs (#1587)
* feat: harness engineering P0 - linting, testing, architecture docs

Add foundational infrastructure for agent-first development:

- AGENTS.md: agent entry point with progressive disclosure to deeper docs
- ARCHITECTURE.md: 12-section system reference with source-file refs and ownership rule
- Biome 2.4.7 linter with project-tuned rules, CI workflow (lint-code.yml)
- Architectural boundary lint enforcing forward-only dependency direction (lint-boundaries.mjs)
- Unit test CI workflow (test.yml), all 1083 tests passing
- Fixed 9 pre-existing test failures (bootstrap sync, deploy-config headers, globe parity, redis mocks, geometry URL, import.meta.env null safety)
- Fixed 12 architectural boundary violations (types moved to proper layers)
- Added 3 missing cache tier entries in gateway.ts
- Synced cache-keys.ts with bootstrap.js
- Renamed docs/architecture.mdx to "Design Philosophy" with cross-references
- Deprecated legacy docs/Docs_To_Review/ARCHITECTURE.md
- Harness engineering roadmap tracking doc

* fix: address PR review feedback on harness-engineering-p0

- countries-geojson.test.mjs: skip gracefully when CDN unreachable
  instead of failing CI on network issues
- country-geometry-overrides.test.mts: relax timing assertion
  (250ms -> 2000ms) for constrained CI environments
- lint-boundaries.mjs: implement the documented api/ boundary check
  (was documented but missing, causing false green)

* fix(lint): scan api/ .ts files in boundary check

The api/ boundary check only scanned .js/.mjs files, missing the 25
sebuf RPC .ts edge functions. Now scans .ts files with correct rules:
- Legacy .js: fully self-contained (no server/ or src/ imports)
- RPC .ts: may import server/ and src/generated/ (bundled at deploy),
  but blocks imports from src/ application code

* fix(lint): detect import() type expressions in boundary lint

- Move AppContext back to app/app-context.ts (aggregate type that
  references components/services/utils belongs at the top, not types/)
- Move HappyContentCategory and TechHQ to types/ (simple enums/interfaces)
- Boundary lint now catches import('@/layer') expressions, not just
  from '@/layer' imports
- correlation-engine imports of AppContext marked boundary-ignore
  (type-only imports of top-level aggregate)
2026-03-14 21:29:21 +04:00

152 lines
4.7 KiB
JavaScript

#!/usr/bin/env node
import { spawnSync } from 'node:child_process';
import { existsSync } from 'node:fs';
import path from 'node:path';
const args = process.argv.slice(2);
const getArg = (name) => {
const index = args.indexOf(`--${name}`);
if (index === -1) return undefined;
return args[index + 1];
};
const hasFlag = (name) => args.includes(`--${name}`);
const os = getArg('os');
const variant = getArg('variant') ?? 'full';
const sign = hasFlag('sign');
const skipNodeRuntime = hasFlag('skip-node-runtime');
const showHelp = hasFlag('help') || hasFlag('h');
const validOs = new Set(['macos', 'windows', 'linux']);
const validVariants = new Set(['full', 'tech']);
if (showHelp) {
console.log('Usage: npm run desktop:package -- --os <macos|windows|linux> --variant <full|tech> [--sign] [--skip-node-runtime]');
process.exit(0);
}
if (!validOs.has(os)) {
console.error('Usage: npm run desktop:package -- --os <macos|windows|linux> --variant <full|tech> [--sign] [--skip-node-runtime]');
process.exit(1);
}
if (!validVariants.has(variant)) {
console.error('Invalid variant. Use --variant full or --variant tech.');
process.exit(1);
}
const syncVersionsResult = spawnSync(process.execPath, ['scripts/sync-desktop-version.mjs'], {
stdio: 'inherit'
});
if (syncVersionsResult.error) {
console.error(syncVersionsResult.error.message);
process.exit(1);
}
if ((syncVersionsResult.status ?? 1) !== 0) {
process.exit(syncVersionsResult.status ?? 1);
}
const bundles = os === 'macos' ? 'app,dmg' : os === 'linux' ? 'appimage' : 'nsis,msi';
const env = {
...process.env,
VITE_VARIANT: variant,
VITE_DESKTOP_RUNTIME: '1',
};
const cliArgs = ['build', '--bundles', bundles];
const tauriBin = path.join('node_modules', '.bin', process.platform === 'win32' ? 'tauri.cmd' : 'tauri');
if (!existsSync(tauriBin)) {
console.error(
`Local Tauri CLI not found at ${tauriBin}. Run "npm ci" to install dependencies before desktop packaging.`
);
process.exit(1);
}
if (variant === 'tech') {
cliArgs.push('--config', 'src-tauri/tauri.tech.conf.json');
}
const resolveNodeTarget = () => {
if (env.NODE_TARGET) return env.NODE_TARGET;
if (os === 'windows') return 'x86_64-pc-windows-msvc';
if (os === 'linux') {
if (process.arch === 'arm64') return 'aarch64-unknown-linux-gnu';
if (process.arch === 'x64') return 'x86_64-unknown-linux-gnu';
return '';
}
if (os === 'macos') {
if (process.arch === 'arm64') return 'aarch64-apple-darwin';
if (process.arch === 'x64') return 'x86_64-apple-darwin';
}
return '';
};
if (sign) {
if (os === 'macos') {
const hasIdentity = Boolean(env.TAURI_BUNDLE_MACOS_SIGNING_IDENTITY || env.APPLE_SIGNING_IDENTITY);
const hasProvider = Boolean(env.TAURI_BUNDLE_MACOS_PROVIDER_SHORT_NAME);
if (!hasIdentity || !hasProvider) {
console.error(
'Signing requested (--sign) but missing macOS signing env vars. Set TAURI_BUNDLE_MACOS_SIGNING_IDENTITY (or APPLE_SIGNING_IDENTITY) and TAURI_BUNDLE_MACOS_PROVIDER_SHORT_NAME.'
);
process.exit(1);
}
}
if (os === 'windows') {
const hasThumbprint = Boolean(env.TAURI_BUNDLE_WINDOWS_CERTIFICATE_THUMBPRINT);
const hasPfx = Boolean(env.TAURI_BUNDLE_WINDOWS_CERTIFICATE && env.TAURI_BUNDLE_WINDOWS_CERTIFICATE_PASSWORD);
if (!hasThumbprint && !hasPfx) {
console.error(
'Signing requested (--sign) but missing Windows signing env vars. Set TAURI_BUNDLE_WINDOWS_CERTIFICATE_THUMBPRINT or TAURI_BUNDLE_WINDOWS_CERTIFICATE + TAURI_BUNDLE_WINDOWS_CERTIFICATE_PASSWORD.'
);
process.exit(1);
}
}
}
if (!skipNodeRuntime) {
const nodeTarget = resolveNodeTarget();
if (!nodeTarget) {
console.error(
`Unable to infer Node runtime target for OS=${os} ARCH=${process.arch}. Set NODE_TARGET explicitly or pass --skip-node-runtime.`
);
process.exit(1);
}
console.log(
`[desktop-package] Bundling Node runtime TARGET=${nodeTarget} VERSION=${env.NODE_VERSION ?? '22.14.0'}`
);
const downloadResult = spawnSync('bash', ['scripts/download-node.sh', '--target', nodeTarget], {
env: {
...env,
NODE_TARGET: nodeTarget
},
stdio: 'inherit',
shell: process.platform === 'win32'
});
if (downloadResult.error) {
console.error(downloadResult.error.message);
process.exit(1);
}
if ((downloadResult.status ?? 1) !== 0) {
process.exit(downloadResult.status ?? 1);
}
}
console.log(`[desktop-package] OS=${os} VARIANT=${variant} BUNDLES=${bundles} SIGN=${sign ? 'on' : 'off'}`);
const result = spawnSync(tauriBin, cliArgs, {
env,
stdio: 'inherit',
shell: process.platform === 'win32'
});
if (result.error) {
console.error(result.error.message);
process.exit(1);
}
process.exit(result.status ?? 1);