@twinsearth/au4a 1.0.10

package/README.md

@@ -0,0 +1,35 @@
+# @twinsearth/au4a — AU4A (Agents-UniverseForAgent)
+
+> **一切为智能体服务。人类用户兼任观察者，只展示进度、结果与收益。**
+
+本包是 AU4A 的 **中版本 v1.0.10** 分发：
+版本区间 `v1.0.1 → v1.9.9` ｜ 10 个中版本 × 99 个小版本 ｜ 仓库 <https://github.com/TwinsEarth/AU4A>
+
+## 用法
+
+```bash
+npx @twinsearth/au4a@1.0.10 version   # 版本与元数据
+npx @twinsearth/au4a@1.0.10 meta      # 机器可读元数据（轨道 / 证据分级 / 实测断言数）
+npx @twinsearth/au4a@1.0.10 docs      # 设计文档与开发文档路径
+npx @twinsearth/au4a@1.0.10 verify    # 聚合 10 条轨道自检（需本机有源码树或已装 au4a-node）
+```
+
+launcher 不假装实现了内核：真正的实现在 Rust crate 里。它会依次尝试
+① 已安装的 `au4a-node`，② 当前目录若为 AU4A 源码树则用 `cargo run --release -p au4a-node`，
+③ 都没有时打印安装指引（退出码 127）。
+
+## 包含的文档
+
+| 文件 | 内容 |
+|---|---|
+| `docs/DESIGN.md` | 设计文档：10 个中版本 + 99 个小版本逐项 |
+| `docs/DEV.md` | 开发文档：10 条轨道并行、轨道内串行、部署验证矩阵 |
+| `docs/VERIFICATION.md` | 实测记录：10 个中版本分步部署（构建 / 自检 / 端到端 / 只读面板 405 探针） |
+| `docs/PRINCIPLES.md` | 十条设计原则 |
+| `docs/OBSERVER.md` | 人类观察层：只读性如何被结构强制 |
+
+## 人类只做三件事
+
+进度 / 结果 / 收益 —— 三个只读面板，非 GET 一律 405（`crates/au4a-node/src/observer.rs` 有结构性测试证明）。
+
+MIT © TwinsEarth

package/bin/au4a.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// AU4A launcher：把「跑 Agent 网络 / 看只读面板 / 校验 10 条轨道」带到一个命令上。
+// 它不假装自己实现了内核：真正的实现在 Rust crate 里，这里只负责找到它并交棒。
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const meta = JSON.parse(readFileSync(join(here, '..', 'meta.json'), 'utf8'));
+const args = process.argv.slice(2);
+
+if (args[0] === '--version' || args[0] === '-v' || args[0] === 'version') {
+  console.log(`au4a ${meta.package_version} (${meta.full_name})`);
+  process.exit(0);
+}
+if (args[0] === 'meta' || args[0] === 'info') {
+  console.log(JSON.stringify(meta, null, 2));
+  process.exit(0);
+}
+if (args[0] === 'docs') {
+  console.log('设计文档: ' + join(here, '..', 'docs', 'DESIGN.md'));
+  console.log('开发文档: ' + join(here, '..', 'docs', 'DEV.md'));
+  console.log('仓库: ' + meta.repository);
+  process.exit(0);
+}
+
+const passthrough = ['run', 'observe', 'verify', 'tracks'];
+const rest = args.length ? args : ['verify'];
+
+// 1) 已安装的 au4a-node
+const direct = spawnSync('au4a-node', rest, { stdio: 'inherit' });
+if (!direct.error) process.exit(direct.status ?? 0);
+
+// 2) 当前目录是一个 AU4A 源码树 -> 用 cargo 跑
+if (existsSync(join(process.cwd(), 'Cargo.toml'))) {
+  const cargo = spawnSync('cargo', ['run', '--release', '-p', 'au4a-node', '--', ...rest], { stdio: 'inherit' });
+  if (!cargo.error) process.exit(cargo.status ?? 0);
+}
+
+console.error(
+  [
+    'au4a: 没有找到 au4a-node（也没有在源码树里找到 Cargo.toml）。',
+    '',
+    '二选一：',
+    '  1) 在 AU4A 源码树里运行： cargo run --release -p au4a-node -- ' + rest.join(' '),
+    '  2) 安装平台二进制：      cargo install --path crates/au4a-node',
+    '',
+    '只读观察面板： au4a-node run --agents 8 --observe 127.0.0.1:8787',
+    '仓库：' + meta.repository,
+  ].join('\n'),
+);
+process.exit(127);