@guanlin4924/devflow-pi 0.1.92 → 0.1.93

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guanlin4924/devflow-pi",
-  "version": "0.1.92",
+  "version": "0.1.93",
   "type": "module",
   "description": "Devflow 专项研发 Pi，基于固定版本 OMP Runtime 组装研发状态机、代码智能、设计、实现与质量门禁。",
   "license": "UNLICENSED",

package/plugins/devflow-core/skills/workflow-project-context/scripts/validate_initialization.py

@@ -149,8 +149,13 @@ def validate_code_index(
     mode = manifest.get("mode")
     status = manifest.get("code_index_status")
     if mode == "full":
+        if status == "degraded":
+            reason = str(manifest.get("code_index_skip_reason", ""))
+            if reason != "code_index_publish_failed":
+                errors.append("degraded full mode requires code_index_publish_failed reason")
+            return
         if status != "complete":
-            errors.append("full mode requires code_index_status=complete")
+            errors.append("full mode requires code_index_status=complete or degraded")
         if manifest.get("code_index_skip_reason") != "none":
             errors.append("full mode requires code_index_skip_reason=none")
         for relative_path in CODE_INDEX_FILES:

package/plugins/devflow-intel/agents/project-scout.md

@@ -16,6 +16,8 @@ Act as a bounded read-only evidence collector, not a planner. Use the code index
 
 Before using `read`, `grep`, or `devflow_code_index`, resolve the project root by walking upward from the runtime directory to the nearest `.devflow/project.json`, `.planning/code-index/index.sqlite`, or `.planning/PROJECT.md`. Treat nested directories such as `drama-ad/backend` as codebases, not Devflow project roots; `.planning` must always be resolved from the project root.
 
+If the index is missing, stale, fails validation, or has no useful hit, continue with a bounded `grep`/`rg` or LSP fallback over the registered codebase roots. Return `degraded_index_coverage` and the exact fallback scope; never present fallback relations as index facts.
+
 If the answer needs architecture tradeoffs, requirements interpretation, a cross-module decision, or evidence remains insufficient after the bounded search, stop and return `STATUS: escalate`. Do not guess or continue exploring.
 
 Return exactly:

package/plugins/devflow-intel/skills/code-index-query/SKILL.md

@@ -19,6 +19,8 @@ All index checks and `devflow_code_index` calls must run with that resolved root
 
 The tool returns the resolved `projectRoot` in its details. If the root cannot be resolved, stop and report the exact check command/path instead of probing `<source-dir>/.planning`.
 
+If the index is missing, stale, fails validation, or returns no useful hit, do not block the source question. Record the machine failure and use a bounded `rg`/`grep` or LSP search within the registered codebase roots. Mark the result `degraded_index_coverage` and include the exact fallback scope; do not claim index-derived relations or complete impact coverage.
+
 ## Required Flow
 
 1. Check that `.planning/code-index/index.sqlite` or JSONL sidecars exist.

package/plugins/devflow-quality/skills/code-review/SKILL.md

@@ -136,7 +136,7 @@ seam 标注: "只改 OrderWorkflow.process()"
 
 **对每一个目标文件**，按以下流程执行：
 
-1. **⛔ Gate 前置：先查 code-index** — 在读取任何业务源码之前，必须先用 `code_index outline` 或 `code_index search` 获取目标文件的符号表。code-index 不可用时用 LSP `documentSymbol` 兜底。
+1. **⛔ Gate 前置：先查 code-index** — 在读取任何业务源码之前，必须先用 `code_index outline` 或 `code_index search` 获取目标文件的符号表。若 code-index 缺失、过期、校验失败或无有效命中，使用有界 `rg/grep` 或 LSP `documentSymbol` 兜底，并在报告中标记 `degraded_index_coverage` 和实际搜索范围；不得把 fallback 结果表述为索引关系事实。
 2. **用 code-index relations 查引用/调用/导入/测试覆盖** — 确认每个导出方法是否有调用方；code-index 缺失、过期或无命中时再用 Grep / LSP findReferences 兜底
 3. **回读源码 evidence** — 对用于审查结论的 relation，必须读取 `evidence_path:evidence_line` 附近源码。**此时可声明"基于 code-index 符号 [X] 读取源码"以通过 gate。**
 4. **逐条对照规范检查清单** — 详见 `references/` 目录下各层级的检查清单：

package/src/constants.ts

@@ -1,5 +1,5 @@
 export const PRODUCT_NAME = "Devflow Pi";
-export const PRODUCT_VERSION = "0.1.92";
+export const PRODUCT_VERSION = "0.1.93";
 export const PROJECT_SCHEMA_VERSION = 1;
 export const OMP_RUNTIME_VERSION = "17.2.7";
 

package/src/project-initializer.ts

@@ -225,8 +225,20 @@ async function buildCodeIndex(context: ProjectContext, config: ScanConfigInput):
     "--max-file-size", String(config.maxFileSize ?? 2 * 1024 * 1024),
   ];
   await runProcess(["python3", script, "scan", "--root", context.root, "--output", output, ...scopeArgs, ...codebases], context.root, "code-index scan");
-  await runProcess(["python3", script, "validate", "--index", output, "--level", "publish"], context.root, "code-index validate");
-  await runProcess(["python3", script, "audit", "--root", context.root, "--index", output, "--skill-root", path.resolve(import.meta.dir, "../plugins/devflow-intel/skills"), "--level", "publish"], context.root, "code-index audit");
+  try {
+    await runProcess(["python3", script, "validate", "--index", output, "--level", "publish"], context.root, "code-index validate");
+    await runProcess(["python3", script, "audit", "--root", context.root, "--index", output, "--skill-root", path.resolve(import.meta.dir, "../plugins/devflow-intel/skills"), "--level", "publish"], context.root, "code-index audit");
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+      path: ".planning/code-index",
+      stagingPath: output,
+      status: "degraded",
+      reason: "code_index_publish_failed",
+      fallback: "bounded_source_search",
+      diagnostics: [message],
+    };
+  }
   const snapshotPath = path.join(context.root, output, "SNAPSHOT.json");
   const bytes = await readFile(snapshotPath); const snapshot = JSON.parse(bytes.toString("utf8")) as Record<string, unknown>;
   if (!snapshot.generation || !snapshot.immutablePath) throw new Error("Code index did not publish an immutable generation");
@@ -235,6 +247,7 @@ async function buildCodeIndex(context: ProjectContext, config: ScanConfigInput):
 }
 
 async function promoteCodeIndex(context: ProjectContext, indexRef: Record<string, unknown>): Promise<() => Promise<void>> {
+  if (indexRef.status !== "complete") return async () => {};
   const stagingPath = typeof indexRef.stagingPath === "string" ? path.resolve(context.root, indexRef.stagingPath) : null;
   const target = path.resolve(context.root, ".planning/code-index");
   if (!stagingPath) return async () => {};