File size: 5,461 Bytes
174df9b
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
"""Command-line entry points; no external services are required."""

import argparse
from dataclasses import asdict
from functools import partial
from http.server import SimpleHTTPRequestHandler, ThreadingHTTPServer
import json
from pathlib import Path


def main(argv=None):
    parser = argparse.ArgumentParser(prog='aether', description='SUPERMiX AETHER NeuroWave-X CPU research lab')
    commands = parser.add_subparsers(dest='command', required=True)
    run = commands.add_parser('run', help='train and evaluate a recorded paired study')
    run.add_argument('--config', type=Path, default=Path('configs/pilot.json'))
    run.add_argument('--output', type=Path, required=True, help='new output directory; existing paths are never overwritten')
    run.add_argument('--updates', type=int)
    run.add_argument('--seeds', help='comma-separated independent training seeds')
    replay = commands.add_parser('replay', help='replay recorded held-out actions from a checkpoint')
    replay.add_argument('checkpoint', type=Path)
    verify = commands.add_parser('verify', help='verify artifact hashes in a receipt')
    verify.add_argument('receipt', type=Path)
    serve = commands.add_parser('serve', help='serve a generated observatory on loopback')
    serve.add_argument('directory', type=Path)
    serve.add_argument('--port', type=int, default=8765)
    live = commands.add_parser('live', help='run the live neural execution and adaptation workbench')
    live.add_argument('--study', type=Path, default=Path('reports/pilot-2026-11-07'),
                      help='recorded study containing validated checkpoints')
    live.add_argument('--output-root', type=Path, default=Path('runs/live'),
                      help='separate directory for exploratory adaptation records')
    live.add_argument('--port', type=int, default=8789)
    profile = commands.add_parser('profile', help='profile computational FLOPs, memory, and CPU latency across protocols')
    profile.add_argument('--warmup', type=int, default=5, help='warmup iterations')
    profile.add_argument('--benchmark-steps', type=int, default=25, help='timed benchmark iterations')
    args = parser.parse_args(argv)
    try:
        if args.command == 'run':
            from aether.experiments.study import StudyConfig, run_study
            values = json.loads(args.config.read_text(encoding='utf-8'))
            if args.updates is not None:
                values['updates'] = args.updates
            if args.seeds is not None:
                values['seeds'] = [int(s.strip()) for s in args.seeds.split(',')]
            result = run_study(StudyConfig(**values), args.output, progress=lambda s: print(s, flush=True))
            print(json.dumps({'status': result['status'], 'promotion': result['promotion'],
                              'observatory': str((args.output / 'index.html').resolve())}, indent=2))
        elif args.command == 'replay':
            from aether.experiments.study import replay_checkpoint
            result = replay_checkpoint(args.checkpoint)
            print(json.dumps({'valid': result['valid'], 'state_digest': result['state_digest']}, indent=2))
            return 0 if result['valid'] else 1
        elif args.command == 'verify':
            from aether.evidence.receipts import verify_receipt
            result = verify_receipt(args.receipt)
            print(json.dumps(result, indent=2))
            return 0 if result['valid'] else 1
        elif args.command == 'live':
            if not 1 <= args.port <= 65535:
                raise ValueError('port must be in [1,65535]')
            from aether.live.server import serve_live
            serve_live(args.study, output_root=args.output_root, port=args.port)
        elif args.command == 'profile':
            from aether.config import ModelConfig
            from aether.kernel.runtime import PROTOCOLS, TissueModel
            from aether.kernel.profiler import profile_model, verify_resource_comparability
            config = ModelConfig()
            profiles = {}
            for protocol in PROTOCOLS:
                model = TissueModel(config, protocol=protocol, seed=11)
                profiles[protocol] = profile_model(model, warmup_steps=args.warmup, benchmark_steps=args.benchmark_steps)
            comparability = verify_resource_comparability(profiles['wave'], profiles)
            out = {
                'profiles': {k: v.to_dict() for k, v in profiles.items()},
                'comparability': comparability,
            }
            print(json.dumps(out, indent=2))
            return 0
        else:
            directory = args.directory.resolve(strict=True)
            if not directory.is_dir() or not (directory / 'index.html').is_file():
                raise ValueError('directory must contain a generated index.html')
            if not 1 <= args.port <= 65535:
                raise ValueError('port must be in [1,65535]')
            handler = partial(SimpleHTTPRequestHandler, directory=str(directory))
            server = ThreadingHTTPServer(('127.0.0.1', args.port), handler)
            print(f'Observatory: http://127.0.0.1:{args.port}', flush=True)
            try:
                server.serve_forever()
            except KeyboardInterrupt:
                pass
            finally:
                server.server_close()
    except (ValueError, TypeError, OSError, RuntimeError) as error:
        parser.exit(2, f'aether: {error}\n')
    return 0