mirror of
https://github.com/koala73/worldmonitor.git
synced 2026-04-26 01:24:59 +02:00
* 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)
152 lines
4.7 KiB
JavaScript
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);
|