@istuen/openxenon 0.1.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 istuen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,231 @@
+# OpenXenon
+
+> **OpenXenon — 工程师与 AI 协作工作台**
+> 工程师定义意图，AI 执行对齐，OXN 证明结果。
+>
+> **Proof 的结果反馈驱动 Intent 演化，IAP 形成闭环，让 Token 成为有效投入。**
+
+[![npm version](https://img.shields.io/npm/v/@istuen/openxenon)](https://www.npmjs.com/package/@istuen/openxenon)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Node >= 18](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
+
+## Install
+
+```bash
+npm install -g @istuen/openxenon
+# 命令名: oxn
+oxn --version
+```
+
+或临时跑:
+
+```bash
+npx -y @istuen/openxenon --version
+```
+
+> 仓库源码是 dist/cli.js 的**开发基底**，不是 npm install 的目标。普通用户请走 `npm install -g` 路径。
+
+---
+
+## 解决什么问题
+
+当前 AI 模型虽然越来越强，但在**注意力机制做推理**的原理下，其依然是**概率性的输出**。在长上下文、长时间推理后，AI 必然会漂移重点并陷入**自我推理满足**。
+
+由此带来三个核心问题：
+
+1. 如何**验证** AI 的执行结果，而非盲目信任？
+2. 如何让 AI 减少长上下文依赖，保持**高效推理**与对齐？
+3. 如何降低 AI 陷入无效推理引起的 **Token 无用消耗**？
+
+---
+
+## 5 分钟 Quick Start — Proof-First 体验
+
+> **入口即核心**：OpenXenon 的第一次体验是 `oxn proof`，不要求先学 Domain/Blueprint。
+> 这本质是 IAP 范式中 **P 轴（Proof 轴）的独立运作模式**——工程师跳过 Intent/Align 资产化，直接使用 Probe 声明验收标准，由 OXN 产出 `frozen.json`。
+
+### 克隆与构建（开发者）
+
+```bash
+git clone https://github.com/istuen/openxenon.git && cd openxenon
+bun install --frozen-lockfile && bun run build
+# 产物：dist/cli.js（单文件 Node bundle，~2.7MB）
+```
+
+### 初始化工作台
+
+```bash
+# 源码构建版 (./dist/oxn)
+./dist/oxn init
+
+# npm 安装版 (oxn 在 PATH 中)
+oxn init
+
+# 支持 -f 强制初始化
+# 支持指定 AI 助手，自动生成对应 Skill 配置：
+oxn init --ai opencode   # 生成 OpenCode Skill
+oxn init --ai cursor    # 生成 Cursor Skill
+oxn init --ai codex     # 生成 Codex Skill
+```
+
+### 第一次证明
+
+**方式 A：CLI 直接执行**
+
+```bash
+./dist/oxn proof create check-deploy
+./dist/oxn proof probe add fs-exists --target ./dist/index.js
+./dist/oxn proof run check-deploy
+# → Verdict: FAIL / PASS
+# → Proof saved: .openxenon/proofs/check-deploy/frozen.json
+```
+
+**方式 B：AI 助手中用 Skill 执行**
+
+在 Cursor / OpenCode / Codex 中输入：
+
+```
+/oxn-proof 验证 dist/index.js 是否存在并导出 handler
+```
+
+AI 通过 Skill 调用 CLI，结果回流到 `frozen.json`。
+
+---
+
+## 进阶使用 — 升级到完整 IAP 协作
+
+当 Probe 重复到一定程度时，自然涌现出对 Intent 轴（Blueprint / Domain）的需求。
+
+| 进阶步骤 | 模块 | 解决的问题 |
+|---|---|---|
+| 1. 定义业务词典 | **Domain** | 锁定团队统一语言（term）、禁令（ban）与不变式（invariant） |
+| 2. 定义技术图纸 | **Blueprint** | 编排 slot 拓扑、Part 选件、Probe 验收标准 |
+| 3. 驱动 AI 作业 | **Work / Task** | 让 AI 在 Blueprint 边界内对齐执行，产出 Artifact 供 OXN 证明 |
+
+```bash
+# 1. 定义业务 Domain
+./dist/oxn domain create MemberContext
+# 编辑 .openxenon/domains/member-context.oxn
+./dist/oxn domain validate MemberContext
+
+# 2. 定义技术 Blueprint
+./dist/oxn blueprint create onboarding --domain MemberContext
+# 编辑 .openxenon/blueprints/onboarding.oxn
+
+# 3. 驱动 AI 作业
+./dist/oxn work create --name onboarding
+./dist/oxn work add-task --work-name onboarding --task-name register \
+  --blueprint onboarding --domain MemberContext
+./dist/oxn work context --work onboarding --task register --json
+# AI 写代码 → Probe 验证 → frozen.json
+```
+
+---
+
+## IAP 范式与 OXN Engine
+
+> **IAP（Intent-Align-Proof）** 是 OpenXenon 的架构灵魂。**OXN** 是工作台的运转引擎。
+
+### 三轴主导权
+
+| 主导轴 | 主导者 | 职责 | 对抗机制 |
+|---|---|---|---|
+| **Intent 轴** | **工程师** | 定义 Domain / Blueprint，锁定业务语言与技术拓扑 | Domain term 锁定边界 |
+| **Align 轴** | **AI** | 编排 Work / Task / Part，在 Blueprint slot 边界内执行 | Blueprint slot 锁定路径 |
+| **Proof 轴** | **OXN** | 产出不可篡改的 Proof（`frozen.json`） | Daemon 逃逸机制阻止假完成 |
+
+**IAP 第一法则**：**主导权不交叉，证明不可绕过**。无 `--force` 绕过。
+
+### 闭环流转
+
+```
+       Intent轴                    Align轴
+   Domain(.oxn)                 Work(.oxn)
+        │                            │
+        ▼                            ▼
+   Blueprint(.oxn)             Task → Artifact
+        │   Probe标准               │  Artifact事实
+        └────────────┬───────────────┘
+                     │
+                     ▼
+                 Proof轴
+              Proof(Verdict)
+                OXN Engine
+                     │
+                     │  反馈（P → I）
+                     │  Verdict 驱动 Intent 演化
+                     └───▶ Intent 演化
+```
+
+- **I → A → P 正向推导**：工程师定义 Intent，AI 在 Align 中执行，OXN 给出 Proof
+- **P → I 反馈闭环**：Proof 的 Verdict 反馈驱动 Intent 演化（精准化 / 业务化 / 资产化）
+- **A → I 反馈**：Align 偏差反馈修正 Intent 定义（slot 越界、term 漂移）
+
+三轴形成 **I → A → P → I** 闭环，下一轮的 Intent 比上一轮更精准。
+
+### OXN Engine = DSL + Runtime + CLI
+
+| 层 | 作用 |
+|---|---|
+| **DSL** | OXL 领域特定语言（Langium 实现）—— Domain / Blueprint / Work 的语法与解析 |
+| **Runtime** | 执行核心（Kernel / Infra / Daemon）—— 详见下节 |
+| **CLI** | 工程师与 AI 的唯一操作入口（`oxn init / proof / domain / blueprint / work`） |
+
+### OXN Runtime 纯洁性约束
+
+OXN Runtime 由三个模块协同执行证明权，每个模块只做自己的事：
+
+| 模块 | 中文 | 职责 | 约束 |
+|---|---|---|---|
+| **Kernel** | 内核 | 纯逻辑校验，零 IO | 不得执行任何副作用（如 `fs.existsSync`） |
+| **Infra** | 底座 | 副作用 / IO 执行，获取事实 | 只回答事实，不得做出 PASS/FAIL 判定 |
+| **Daemon** | 守护进程 | 生命周期管理 + 逃逸机制 | 不得修改 Kernel 规则；Probe FAIL 时阻止 Work 进入 done |
+
+**纯洁性第一法则**：
+
+- **Infra（底座）不能**绕过 Daemon（守护进程）自我宣布完成
+- **Daemon（守护进程）不能**修改 Kernel（内核）规则
+- **Kernel（内核）不能**直接执行 Task
+
+---
+
+## 文档
+
+- 📖 **[OpenXenon 完整文档](docs/introduction.md)** — 12 章 + 3 附录的 SSOT
+- 📖 **[OXL DSL 语法指南](docs/intent.md#blueprint技术蓝图)** — Domain / Blueprint / Work 完整语法
+- 📖 **[Probe 类型参考](docs/proof.md#内置-probe-类型)** — 内置 11 个 Probe
+- 🟦 **[AI 协作者入口](docs/llm-prompt.md)** — AI 模型专用协议
+
+---
+
+## 开发路线
+
+| 阶段 | 目标 | 状态 |
+|---|---|---|
+| **P0: Proof 轴独立** | Proof 闭环 | ✅ |
+| **P1: Intent 轴技术化** | Program Domain + Blueprint | ✅ |
+| **P2: Intent 轴业务化** | Business Domain + DDD | 🔜 进行中 |
+| **P3: Intent 轴资产化** | 意图涌现 + Hall（研讨厅） | 📋 规划中 |
+
+详见 [docs/roadmap.md](docs/roadmap.md)
+
+---
+
+## 自举验证与测试
+
+OpenXenon 用 OpenXenon 管理自己的开发过程——**自举**（self-bootstrapping）是质量基线。
+
+| 级别 | 定义 | 状态 |
+|---|---|---|
+| L1 编译自举 | `bun run build` → `oxn` 可执行 | ✅ |
+| L2 资产自举 | Domain / Blueprint / Work / Task 全链路跑通 | ✅ |
+| L2+ DSL 自举 | Grammar → Schema → Validator → Generator 联动 | ✅ |
+| L3 质量自举 | OpenXenon 自身开发过程通过 OpenXenon 管理 | 🔜 P2 目标 |
+
+**测试**：运行 `bun test` 查看当前数据；权威源为 `bunfig.toml` + `lefthook.yml`。
+
+---
+
+## License
+
+[MIT](LICENSE)

package/dist/SKILL-5pahrma4.md

@@ -0,0 +1,199 @@
+---
+name: oxn-proof
+description: v0.1.2 Proof-First 入口：5 命令闭环（create / probe add / run / list / show），用 Probe 声明验收标准，OXN 产出不可篡改的 frozen.json
+---
+# /oxn-proof — Proof-First 入口（v0.1.2 catalog 封装）
+
+> **让 OXN 验收，不让人验收。** 这是 IAP 三轴中 **Proof 轴的独立运作**——跳过 Domain/Blueprint 资产化，用 Probe 声明验收标准。
+
+## 目标
+
+让 AI 通过 **语义化白名单** 完成验收：
+1. AI 调 `oxn proof probe list` 知道有哪些 probe 可用
+2. AI 调 `oxn proof probe describe <name>` 知道每个 probe 接受什么输入
+3. AI 调 `oxn proof probe add <proof> <probe> --input-json '{...}'` 追加 probe
+4. AI 让 AI 工作（写代码 / 跑命令）
+5. 调 `oxn proof run` 让 OXN 跑物理观测 → 写 frozen.json
+
+**封装边界**：AI 永远只看到**语义层**（probe 名称 + 描述 + 输入契约），**不**知道 OXN 内部用什么 ref / param / verdict 逻辑。CLI 帮你翻译。
+
+## 何时用
+
+| 场景 | 用 proof 还是 work？ |
+|---|---|
+| 「AI 说做完了？让 OXN 验收才算」 | **用 `oxn proof`** ← 本 skill |
+| 单个验收场景（dist 产物 + 跑测试） | **用 `oxn proof`** |
+| 多 stage 流水线 | 用 `oxn work` + Blueprint |
+| 跨域业务 | 用 `oxn work` + Domain |
+
+## 5 个命令（白名单）
+
+| 子命令 | 用途 | AI 看到什么 |
+|---|---|---|
+| `oxn proof create <name>` | 立 proof 空间 | 文件路径 |
+| `oxn proof probe list` | **列出所有 probe** | `{name, description, requiredInputs[]}[]` |
+| `oxn proof probe describe <name>` | **详述 probe 输入契约** | `{name, description, inputs[], examples[]}` |
+| `oxn proof probe add <proof> <probe> --input-json '{...}'` | 追加 probe | 翻译后的内部存储（不直接显示） |
+| `oxn proof run <name>` | 调 OXN 跑探测 → 写 frozen.json | verdict + 详情 + 签名 |
+| `oxn proof list` | 列所有 proof | 名称 + verdict |
+| `oxn proof show <name>` | 读 frozen.json | 完整 verdict + 签名 |
+
+## 标准 workflow（spec-first）
+
+```
+Step 1: AI 先用 probe list / describe 知道 OXN 能验收什么
+   oxn proof probe list
+   oxn proof probe describe fs-exists
+
+Step 2: AI 创建 proof.oxn（验收规约）
+   oxn proof create check-deploy
+
+Step 3: AI 追加 probe（按 describe 给的契约）
+   oxn proof probe add check-deploy fs-exists --input-json '{"path":"./dist/index.js"}'
+   oxn proof probe add check-deploy shell-exec --input-json '{"command":"bun test","timeout":60000}'
+
+Step 4: AI 工作（写代码 / 跑命令）—— 不调 OXN
+   → 注意：AI 看到的是"验收规约"，不会知道 OXN 怎么判 PASS/FAIL
+
+Step 5: AI 调 proof run 让 OXN 验收
+   oxn proof run check-deploy
+   → Kernel 校验 + Infra 物理观测 + 写 frozen.json
+
+Step 6: AI 读 verdict
+   oxn proof show check-deploy
+   → FAIL → AI 修复 → 再 run → PASS
+```
+
+## 物理边界
+
+```
+.openxenon/proofs/
+└── check-deploy/
+    ├── proof.oxn     ← Probe 声明（OXN 翻译后的内部表示）
+    └── frozen.json   ← 判决书（chmod 0o444 + SHA-256，不可改）
+```
+
+## 不可篡改性
+
+| 层 | 机制 | 绕过成本 |
+|---|---|---|
+| OS 层 | chmod 0o444（覆盖前 owner 自动抬位 0o644 → 写 → try/finally 回锁 0o444） | writer 内部完成，AI / 工程师无感 |
+| 内容层 | `_xenon_meta.content_hash` = SHA-256 | 改内容 hash 对不上 |
+
+**AI 约束**（CLI 白名单）：
+- ✅ 允许：`oxn proof create / list / show / probe list / probe describe / probe add / run`
+- ❌ 禁止：直接 `vim .openxenon/proofs/*/frozen.json` / `echo ... > frozen.json` / 任何直写
+
+## IAP 范式对照
+
+```
+Proof-First 入口 = IAP 中 Proof 轴的独立运作
+├─ Intent 轴被跳过（不写 Domain / Blueprint）
+├─ Align 轴被简化（不写 Work / Task / Part DAG）
+└─ Proof 轴被激活（probe 声明 → 物理观测 → 纯函数判定 → frozen.json）
+```
+
+**核心价值**：让工程师 5 分钟内就感受到 OXN 的核心价值——**AI 假完成，OXN 不会骗自己**。
+
+## 完成标准
+
+- `oxn proof probe list` 返回可用 probe（语义名 + 描述 + 必填输入）
+- `oxn proof probe describe <name>` 返回输入契约 + 示例
+- `oxn proof probe add <proof> <name> --input-json '{...}'` 成功追加
+- `oxn proof run` 返回 verdict + readOnly: true
+- `oxn proof show` 返回完整 frozen.json（含签名）
+
+把 `frozenPath` 给工程师审核。**禁止**改 frozen.json。
+
+---
+
+## AI 错误处理：读 `error.action` 字段
+
+`oxn proof *` 命令出错时，CLI 输出 JSON 包含 `error.action` 字段。**AI 读这个字段决策下一步**，不要解析 `message` 字符串。
+
+### Verdict: FAIL 怎么读？
+
+```bash
+oxn proof show check-deploy
+```
+读 `frozen.json.verdict` 字段：
+- `verdict === 'PASSED'` → 任务通过，AI 可继续
+- `verdict === 'FAILED'` → 任务失败（**正常业务结果，不是异常**），AI 自己改代码重 run
+
+### 业务异常（IAPError）怎么读？
+
+```json
+{
+  "ok": false,
+  "error": {
+    "code": "IAP_PROOF_INFRA_FAIL",
+    "axis": "PROOF",
+    "action": "YIELD_TO_HUMAN",
+    "message": "Probe 无法访问目标资源",
+    "context": { "path": "./dist", "systemError": "EACCES" }
+  }
+}
+```
+
+**AI 决策表**（按 `action` 字段）：
+
+| `action` 值 | AI 下一步动作 |
+|---|---|
+| `AUTONOMOUS_RETRY` | AI 自己改代码/参数重试（不改 proof） |
+| `YIELD_TO_HUMAN` | AI 停止当前任务，让人类修（环境/需求问题 AI 改不了） |
+
+**两个 `action` 值之外的字段**（AI 不需要关心，但要知道存在）：
+- `code` — 错误全名（`IAP_<AXIS>_<CODE>`）
+- `axis` — 哪个 IAP 轴（INTENT/ALIGN/PROOF）
+- `message` — 人类可读描述
+- `context` — 机器可读字段（test/debug 用）
+
+### 引擎崩溃（OXNCrash）AI 看不到
+
+`OXN_CRASH_*` 错误走 stderr 通道，AI Skill 收不到。**如果你的命令莫名其妙 exit 2 没输出，那是引擎崩了，AI 应停止工作，通知工程师**。
+
+### 实战示例
+
+```bash
+# 1. AI 跑 proof
+$ oxn proof run check-deploy
+{
+  "ok": false,
+  "error": {
+    "code": "IAP_PROOF_INFRA_FAIL",
+    "axis": "PROOF",
+    "action": "YIELD_TO_HUMAN",
+    "message": "无法访问 ./dist/index.js",
+    "context": { "path": "./dist/index.js", "systemError": "EACCES" }
+  }
+}
+
+# 2. AI 读 action = YIELD_TO_HUMAN → 知道不能自己改
+# 3. AI 通知用户："dist/index.js 没有读权限，请运行 chmod +r ./dist/index.js"
+# 4. 用户修后 AI 重新跑
+```
+
+```bash
+# 1. AI 跑 proof
+$ oxn proof run check-deploy
+{
+  "ok": false,
+  "error": {
+    "code": "IAP_ALIGN_CHECKLIST_MISSING",
+    "axis": "ALIGN",
+    "action": "YIELD_TO_HUMAN",
+    "message": "task 'scaffold' 的 part 'scaffold' 缺少必填的 intent_checklist 字段",
+    "context": { "taskName": "scaffold", "partName": "scaffold", "missingField": "intent_checklist" }
+  }
+}
+
+# 2. AI 读 action = YIELD_TO_HUMAN → 知道不能自己改
+# 3. AI 通知用户："part.scaffold 缺 intent_checklist，请在 task.oxn 补上开工前的 4 问对齐"
+# 4. 用户补后 AI 重新跑
+```
+
+**不要**：
+- ❌ 用正则解析 `message` 字符串
+- ❌ 看到 `code: 'IAP_*'` 就 assume 是 YIELD_TO_HUMAN
+- ✅ 永远先读 `action` 字段
+