@arcships/morula-runtime 0.1.0-alpha.2 → 0.1.0-alpha.20

package/dist/plugin/skills/morula-working-on-issues/SKILL.md

@@ -0,0 +1,19 @@
+---
+name: morula-working-on-issues
+description: "Superseded by the morula-platform skill — load that instead. This stub only records where the Morula task contracts moved to."
+user-invocable: false
+allowed-tools: Bash(morula *), Bash(git *), Bash(gh *)
+---
+
+# Moved into `morula-platform`
+
+Morula 的任务协作契约已并入 `morula-platform` skill（开篇分工 + Routing + 按域手册）：
+
+```text
+morula-platform  →  SKILL.md（路由表）+ references/{workspace, git-workflow, task-protocols, delivery, observability}.md
+```
+
+契约核心（不变量 + 机器协议命令索引 + 手册路由）随工作区根 `AGENTS.md`「Morula 平台协作契约」段恒定生效。
+旧 brief / 旧插件副本可能仍指名本 skill——按上面的新入口读取即可，不要重复学习两份契约。
+
+> 本副本随 CLI 插件分发；daemon 注入工作区的权威版本结构相同。

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@arcships/morula-runtime",
   "type": "module",
-  "version": "0.1.0-alpha.2",
-  "description": "Device-level CLI for the Morula local agent runtime (daemon/portal/models/auth), distributed via npm",
+  "version": "0.1.0-alpha.20",
+  "description": "Device-level CLI for the Morula local agent runtime (daemon/portal/models/auth) and the Morula business CLI (morula), distributed via npm",
   "bin": {
-    "morula-runtime": "./bin/morula-runtime.js"
+    "morula-runtime": "./bin/morula-runtime.js",
+    "morula": "./bin/morula.js"
   },
   "files": [
     "dist",
-    "bin"
+    "bin",
+    "scripts/postinstall.mjs"
   ],
   "engines": {
     "node": ">=20"
@@ -18,10 +20,13 @@
     "build:env": "node scripts/gen-build-env.mjs",
     "build:dist": "node scripts/build-dist.mjs",
     "gen:plugin-skill": "tsx scripts/gen-plugin-skill.mts",
+    "gen:cli-skill": "tsx scripts/gen-cli-skill.mts",
     "prepublishOnly": "pnpm run gen-build-env && pnpm run build:dist",
+    "postinstall": "node scripts/postinstall.mjs",
     "dev": "tsx src/index.ts",
+    "dev:morula": "pnpm --filter @morula/morula-cli run dev",
     "lint:type": "tsc --noEmit -p tsconfig.json",
-    "test": "tsx --test --test-concurrency=1 test/*.test.ts",
+    "test": "tsx --test --test-concurrency=1 test/*.test.ts src/**/*.spec.ts",
     "smoke": "tsx src/index.ts --help"
   },
   "dependencies": {
@@ -30,6 +35,7 @@
   },
   "devDependencies": {
     "@morula/morula-api-client": "workspace:*",
+    "@morula/morula-cli": "workspace:*",
     "@morula/morula-cli-core": "workspace:*",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.2.0",

package/scripts/postinstall.mjs

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+/**
+ * postinstall：尽力把 Dim 插件目录物化到本机（docs/features/single-package-cli-distribution.md）。
+ *
+ * 为什么放在 postinstall：用户的目标是「装一个包就能用」。skills 与 agent 执行 PATH 上的
+ * `morula` 只能由 Dim 的插件根提供，所以安装时直接注册一次。
+ *
+ * 物化范围（acp-provider-generalization U16 / D-k）：**只服务 dim 插件**——
+ * 本脚本只写 `<DIMCODE_HOME>/plugins/morula-cli`。平台**不代装 AI CLI**（claude / codex 等
+ * 由用户自行安装），也**不为非 dim provider 做任何宿主侧投影**（非 dim provider 的投影只落在
+ * 任务工作区，见 providers/**）。因此「非 dim provider 的 CLI 缺失」不是安装问题，而是运行期
+ * 的可诊断结论：`morula-runtime daemon doctor --probe` 会给出 `<KEY>_CLI_NOT_FOUND` /
+ * `<KEY>_PROBE_FAILED` 与对应的下一步。本脚本**不得**为此新增任何向宿主写 provider 文件的行为。
+ *
+ * 硬约束：**绝不阻断安装**。
+ * - 任何失败（资产缺失、权限、非交互环境、`--ignore-scripts` 之外的意外）只 warn + exit 0；
+ * - 失败后可随时手动补：`morula-runtime setup`；
+ * - 只跑本包的 `setup` 命令（注册逻辑单一来源），不在这里复制一份实现。
+ */
+import { execFileSync } from 'node:child_process'
+import { existsSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = dirname(dirname(fileURLToPath(import.meta.url)))
+const entry = join(root, 'dist', 'index.js')
+
+/** 静默跳过（源码 checkout 未构建 / 无 dist 产物）：不是错误，不给噪音 */
+if (!existsSync(entry)) {
+  process.exit(0)
+}
+
+try {
+  const output = execFileSync(process.execPath, [entry, 'setup'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] })
+  const result = JSON.parse(output)
+  const legacy = result.legacyRoot ? `；检测到旧插件目录 ${result.legacyRoot}，建议删除（Dim 优先命中 ${result.pluginRoot}）` : ''
+  console.error(`[morula-runtime] 插件已注册：${result.pluginRoot}（skills: ${(result.skills ?? []).join(', ')}）${legacy}`)
+  console.error('[morula-runtime] 只物化 Dim 插件：平台不代装 AI CLI（claude / codex 等需自行安装），也不为非 dim provider 做宿主侧投影')
+  console.error('[morula-runtime] Dim 会在**新 session** 加载插件；手动重注册：morula-runtime setup')
+}
+catch (error) {
+  const detail = error instanceof Error ? error.message.split('\n')[0] : String(error)
+  console.error(`[morula-runtime] 插件注册跳过（不影响安装）：${detail}`)
+  console.error('[morula-runtime] 可随时手动重试：morula-runtime setup')
+}
+process.exit(0)