openfeel 1.3.3 → 1.3.5

package/dsh/lib/adapters/host-state.js

@@ -0,0 +1,111 @@
+/**
+ * 宿主已加载适配器标记（v1.3.4）
+ *
+ * 目的：让 `openfeel setup --check` 能区分
+ * - 「磁盘适配器旧」→ mismatch（应重跑 setup）
+ * - 「磁盘已新，但运行中的宿主仍加载旧模块」→ restart-required（应完全重启宿主）
+ *
+ * 本文件在 DSH 宿主 `apply()`（启动）时由适配器调用 `writeHostMarker()` 写入；
+ * 指纹算法必须与 CLI 侧 `src/core/adapter-hash.ts` **逐字节一致**（见该文件注释）：
+ * `lib/**` 全部文件按相对 POSIX 路径排序 → 逐文件 CRLF→LF 后 sha256 → 拼接 `${rel}\n${hex}\n` → 再 sha256。
+ *
+ * 零依赖、只读/写一个 JSON；任何异常都吞掉（标记缺失时 CLI 会落到 restart-required，
+ * 属可操作提示，不应让宿主挂载失败）。
+ *
+ * @module openfeel-dsh/host-state
+ */
+import { createHash } from 'node:crypto';
+import { mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, relative, sep } from 'node:path';
+
+/**
+ * 默认标记路径：`~/.openfeel/adapter-host-dsh.json`。
+ * `OPENFEEL_ADAPTER_HOST_PATH` 可覆盖（测试隔离用）。
+ * @returns {string}
+ */
+export function defaultMarkerPath() {
+  const override = process.env.OPENFEEL_ADAPTER_HOST_PATH;
+  if (typeof override === 'string' && override.trim() !== '') return override;
+  return join(homedir(), '.openfeel', 'adapter-host-dsh.json');
+}
+
+/** CRLF / CR → LF */
+function normalizeEol(content) {
+  return content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+}
+
+/**
+ * 递归收集普通文件（不跟随符号链接目录）。
+ * @param {string} dir
+ * @param {string[]} out
+ */
+function collectFiles(dir, out) {
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) collectFiles(full, out);
+    else if (entry.isFile()) out.push(full);
+  }
+}
+
+/**
+ * 计算适配器 `lib/` 目录指纹（与 CLI 侧 `hashAdapterFiles` 同算法）。
+ * @param {string} adapterRoot 适配器根目录（含 `lib/`）
+ * @returns {string} 64 位 hex；不可读时返回空串
+ */
+export function hashLoadedAdapter(adapterRoot) {
+  try {
+    const libDir = join(adapterRoot, 'lib');
+    const files = [];
+    collectFiles(libDir, files);
+    if (files.length === 0) return '';
+    const entries = files
+      .map((file) => ({ rel: relative(adapterRoot, file).split(sep).join('/'), abs: file }))
+      .sort((a, b) => (a.rel < b.rel ? -1 : a.rel > b.rel ? 1 : 0));
+    const sha = createHash('sha256');
+    for (const entry of entries) {
+      const content = normalizeEol(readFileSync(entry.abs, 'utf-8'));
+      const fileHash = createHash('sha256').update(content, 'utf-8').digest('hex');
+      sha.update(`${entry.rel}\n${fileHash}\n`, 'utf-8');
+    }
+    return sha.digest('hex');
+  } catch {
+    return '';
+  }
+}
+
+/**
+ * 写入宿主已加载标记（best-effort）。
+ * @param {{ adapterRoot: string, version: string, markerPath?: string }} options
+ * @returns {{ adapter: string, version: string, loaded_hash: string, started_at: string } | null}
+ */
+export function writeHostMarker(options) {
+  try {
+    const markerPath = options.markerPath ?? defaultMarkerPath();
+    const marker = {
+      adapter: 'dsh',
+      version: options.version,
+      loaded_hash: hashLoadedAdapter(options.adapterRoot),
+      started_at: new Date().toISOString(),
+    };
+    mkdirSync(dirname(markerPath), { recursive: true });
+    writeFileSync(markerPath, JSON.stringify(marker, null, 2) + '\n', 'utf-8');
+    return marker;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 读取宿主已加载标记（只读；缺失/损坏 → null）。
+ * @param {string} [markerPath]
+ * @returns {{ adapter?: string, version?: string, loaded_hash?: string, started_at?: string } | null}
+ */
+export function readHostMarker(markerPath) {
+  try {
+    const raw = JSON.parse(readFileSync(markerPath ?? defaultMarkerPath(), 'utf-8'));
+    return typeof raw === 'object' && raw !== null ? raw : null;
+  } catch {
+    return null;
+  }
+}

package/dsh/lib/index.js

@@ -22,8 +22,13 @@
  * @module openfeel-dsh
  */
 
+import { readFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
 import { FeelCli } from './adapters/cli.js';
 import { resolveWorkspace } from './adapters/workspace.js';
+import { writeHostMarker } from './adapters/host-state.js';
 import { createOpenFeelGuard } from './guard.js';
 import { createFeelCommandHandler } from './surface/command.js';
 import { FEEL_PROMPT_NAME, FEEL_PROMPT_ORDER, renderBootstrapPrompt, renderFeelPrompt } from './surface/prompt.js';
@@ -110,6 +115,22 @@ function currentAgent(ctx) {
  */
 export function apply(ctx, rawConfig) {
   const config = normalizeConfig(rawConfig);
+
+  // v1.3.4：记录「本宿主实际加载的适配器指纹」，供 `openfeel setup --check` 区分
+  // 「文件旧」与「文件已新但宿主未重启」。best-effort：失败不影响挂载。
+  try {
+    const adapterRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+    let adapterVersion = '0.0.0';
+    try {
+      const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf-8'));
+      if (typeof pkg.version === 'string' && pkg.version !== '') adapterVersion = pkg.version;
+    } catch {
+      /* package.json 不可读时保持占位版本 */
+    }
+    writeHostMarker({ adapterRoot, version: adapterVersion });
+  } catch {
+    /* 标记写入失败 → CLI check 会提示 restart-required，可操作，不阻塞 */
+  }
   const log = typeof ctx.logger === 'function'
     ? ctx.logger('openfeel-dsh')
     : {

package/dsh/lib/surface/prompt.js

@@ -146,6 +146,11 @@ Feel（你）只做编排、决策与门禁判断。
 - \`fast\`：跳过 \`scheme_*\` 与 \`test_*\`；**计划审查与代码审查各保留一轮**（fast 不等于免审）。
 - \`general\`：无流水线（空转移表），按需直接调度通用工作者；**仅需求级合法**，阶段级/部署级会拒绝。
 
+## 命令执行
+- **Windows：优先 \`bash\`（Git Bash），其次 \`pwsh\`（PowerShell 7）**；默认不用 \`cmd.exe\`。
+- macOS / Linux：\`bash\`。
+- 同一任务内保持同一 shell；路径与转义按所选 shell 书写。
+
 ## 需求分发
 需求是排期层（\`REQ-NNN\`，7 状态：draft/scheduled/in_progress/done/blocked/cancelled/rejected）。
 接取流程：\`feel_req action=next\` → \`claim\` → \`link\` 到阶段 → 阶段推进驱动聚合 → 全部关联阶段 done 时需求自动收口。
@@ -196,6 +201,11 @@ planner / schemer / executor / reviewer / feel-tester / archiver. **The authorit
 - \`fast\`: skips \`scheme_*\` and \`test_*\`; **plan review and code review each keep one round** (fast is not review-free).
 - \`general\`: no pipeline (empty transition table), dispatch general workers on demand; requirement-level only.
 
+## Command execution
+- **Windows: prefer \`bash\` (Git Bash), then \`pwsh\` (PowerShell 7)**; do not default to \`cmd.exe\`.
+- macOS / Linux: \`bash\`.
+- Keep one shell per task; write paths/escaping for that shell.
+
 ## Requirement distribution
 Requirements are the scheduling layer (\`REQ-NNN\`, 7 statuses: draft/scheduled/in_progress/done/blocked/cancelled/rejected).
 Flow: \`feel_req action=next\` → \`claim\` → \`link\` to a stage → stage advancement drives aggregation → auto-close when every linked stage is done.

package/dsh/lib/tools/index.js

@@ -207,9 +207,9 @@ export function createTools(context) {
         '操作。',
         { required: true },
       ),
-      stage: string('阶段 ID（advance/retry 必需；phases/mode 可选用于按阶段派生模式）。'),
+      stage: string('阶段 ID（advance/retry 必需；review_add 与 op 二选一；phases/mode 可选用于按阶段派生模式）。'),
       to: stringEnum(PHASES, 'advance 的目标相位。'),
-      op: string('操作 ID（如 v1.2.1-stage-93.op-001）。'),
+      op: string('操作 ID（如 v1.2.1-stage-93.op-001）；review_add 与 stage 二选一。'),
       force: boolean('advance 时跳过相位合法性与跳跃检查（不能绕过 blocking REV 门）。'),
       dry_run: boolean('仅校验/预览，不写盘。'),
       review_tier: stringEnum(TIERS, '审查档位：full=零裁剪 / lean=裁 scheme_review / skip=再裁 plan_review。缺省不裁剪（=full）。'),
@@ -294,7 +294,12 @@ export function createTools(context) {
         }
         case 'review_add': {
           const argv = ['flow', 'review', 'add'];
-          pushOption(argv, '--op', args.op);
+          // v1.3.4：op / stage 二选一透传（fast 无 op 场景必须能挂阶段级 REV）
+          if (!args.op && !args.stage) {
+            throw new FeelError('review_add 需要 op 或 stage 之一', { kind: 'usage', code: 'FEEL_BAD_USAGE' });
+          }
+          if (args.op) pushOption(argv, '--op', args.op);
+          else pushOption(argv, '--stage', args.stage);
           pushOption(argv, '--title', requireArg(args, 'title', action));
           pushOption(argv, '--auto-fix', args.auto_fix);
           if (args.blocking !== undefined) argv.push('--blocking', args.blocking === true ? 'true' : 'false');

package/dsh/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openfeel-dsh",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "OpenFeel × DSH — Feel 模式适配器：把 OpenFeel 的流水线、需求分发、版本归档与知识库接入 DeepSeek Harness",
   "type": "module",
   "private": true,
@@ -32,7 +32,7 @@
   },
   "openfeel": {
     "adapter": "dsh",
-    "requiresCli": ">=1.3.3"
+    "requiresCli": ">=1.3.5"
   },
   "keywords": [
     "openfeel",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openfeel",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "description": "AI Agent 开发流程治理 CLI 工具",
   "type": "module",
   "private": false,