@guanlin4924/devflow-pi 0.1.69 → 0.1.70

package/package.json

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

package/plugins/devflow-core/skills/workflow-project-context/SKILL.md

@@ -209,6 +209,8 @@ Run the database validator with identifiers returned by the scan:
 devflow_skill_script(script="project-context-db-validate", args=["--database", "<control.db>", "--project-id", "<project-id>", "--workspace-id", "<workspace-id>", "--run-id", "<run-id>"])
 ```
 
+The `--database` value must come from `devflow_project_context(action="scan").database` or the loaded project context `controlDatabasePath`. Never guess `./control.db`, `.devflow/control.db`, `.planning/code-index/index.sqlite`, an OMP agent database, or any SQLite found by searching user directories. Code-index SQLite is not the initialization control database and does not contain the initialization `schema_meta` table.
+
 Completion requires a stable immutable input, matching context snapshot, accounted required categories, evidence for observed facts, a registered immutable index in full mode, revision-safe pointer publication, and separate document statuses. Workflow `STATE` and other non-initialization authorities must remain unchanged.
 
 Report partial, unsupported, skipped, failed, and unknown coverage honestly. Initialization success does not mean tests passed, services ran, designs were approved, or requirements were delivered.

package/plugins/devflow-intel/skills/workflow-code-index/scripts/adapters/python_ast.py

@@ -116,6 +116,8 @@ class _PythonVisitor(ast.NodeVisitor):
 
     @staticmethod
     def _signature(node):
+        if isinstance(node, ast.ClassDef):
+            return f"{node.name}()"
         arguments = [argument.arg for argument in [*node.args.posonlyargs, *node.args.args, *node.args.kwonlyargs]]
         if node.args.vararg:
             arguments.append(f"*{node.args.vararg.arg}")

package/plugins/devflow-intel/skills/workflow-code-index/scripts/code_index.py

@@ -97,13 +97,15 @@ def _publish_snapshot(staging: Path, output: Path, counts: Dict[str, int], works
         os.close(directory_fd)
 
 
-def _workspace_state(root: Path, files: List[dict], changed: Set[str]) -> Dict[str, object]:
+def _workspace_state(root: Path, files: List[dict], changed: Set[str], discovered_paths: Iterable[str] | None = None) -> Dict[str, object]:
     indexed_paths = sorted(record["path"] for record in files)
+    discovered = sorted(set(discovered_paths or indexed_paths))
     source_manifest_hash = _hash_lines(f"{record['path']}\0{record['content_hash']}" for record in files)
     return {
         "repositoryRevision": _git_output(root, ["rev-parse", "HEAD"]),
         "contentManifestHash": source_manifest_hash,
         "indexedPathsHash": _hash_lines(indexed_paths),
+        "discoveredPathsHash": _hash_lines(discovered),
         "dirtyPathsAtBuild": sorted(changed),
         "extractors": sorted(set(record.get("parser", "unknown") for record in files)),
         "capabilities": {
@@ -210,12 +212,14 @@ def command_scan(args) -> int:
 
         files, symbols, relations, diagnostics = _existing_after_removal(existing, changed)
         indexed_paths = {record["path"] for record in files}
+        discovered_paths: Set[str] = set()
 
         for codebase in codebases:
             if not codebase.root.exists():
                 diagnostics.append(_diagnostic(codebase.name, "", 1, "warning", "skipped_file", f"codebase root does not exist: {codebase.root}", "discovery@1"))
                 continue
             all_files = scan_files(codebase.root, excludes=args.exclude)
+            discovered_paths.update(_workspace_rel(root, path) for path in all_files)
             if changed:
                 all_files = [path for path in all_files if _workspace_rel(root, path) in changed]
             manifests = [path for path in all_files if path.name in {"package.json", "go.mod", "Cargo.toml", "pyproject.toml", "requirements.txt", "composer.json", "pubspec.yaml"}]
@@ -280,7 +284,7 @@ def command_scan(args) -> int:
                     "relations": len(relations),
                     "diagnostics": len(diagnostics),
                 },
-                _workspace_state(root, files, changed),
+                _workspace_state(root, files, changed, discovered_paths),
             )
         finally:
             shutil.rmtree(staging, ignore_errors=True)
@@ -406,7 +410,8 @@ def _query_is_fresh(root: Path, snapshot: Dict[str, object], files: List[dict])
     indexed_paths = sorted(record["path"] for record in files)
     if not any(path.startswith("../") for path in indexed_paths):
         current_paths = sorted(_workspace_rel(root, item) for item in scan_files(root))
-        if _hash_lines(current_paths) != workspace.get("indexedPathsHash"):
+        expected_paths_hash = workspace.get("discoveredPathsHash") or workspace.get("indexedPathsHash")
+        if _hash_lines(current_paths) != expected_paths_hash:
             return False
     return True
 

package/src/constants.ts

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

package/src/project-documents.ts

@@ -629,7 +629,7 @@ function initializationInterfaceContracts(): InterfaceContract[] {
           name: "scan",
           purpose: "执行项目初始化扫描并发布上下文快照。",
           request: { action: "scan", mode: "full|fast", repositories: [{ name: "app", path: ".", role: "frontend|backend|shared|other" }], requiredKinds: FACT_KINDS, documentMode: "template|none", requestId: "stable-id" },
-          response: { runId: "uuid", snapshotId: "uuid", completeness: "complete|partial", diagnostics: [], documents: [{ targetPath: ".context/project/api.md", status: "complete|conflict|failed" }] },
+          response: { runId: "uuid", snapshotId: "uuid", completeness: "complete|partial", database: "<control.db>", projectId: "uuid", workspaceId: "uuid", planningRoot: ".planning", diagnostics: [], documents: [{ targetPath: ".context/project/api.md", status: "complete|conflict|failed" }] },
           reads: ["source tree", ".devflow/project.json"],
           writes: ["control.db", ".planning/code-index/", ".planning/document-index.json", ".planning/knowledge-index.json", ".context/", ".planning/PROJECT.md"],
         },
@@ -932,6 +932,7 @@ function renderKnowledgeDocuments(context: ProjectContext, facts: Fact[], intro:
   const generation = codeIndexGeneration(snapshot);
   const outputs: Array<{ targetPath: string; body: string }> = [];
   outputs.push({ targetPath: ".context/index.md", body: `${frontmatter({ type: "knowledge-index", scope: "project", project: context.manifest.name, status: "draft", source_snapshot: snapshotId, code_index_generation: generation, managed: true })}# ${context.manifest.name} 项目知识库\n\n## 项目级文档\n\n${KNOWLEDGE_DOCUMENT_TYPES.map(type => `- [${documentTitle(type)}](/project/${type}.md)`).join("\n")}\n\n## 需求级文档\n\n- 新需求使用 [.context/requirements/_template/index.md](/requirements/_template/index.md) 作为文档包模板。\n\n## 机器索引\n\n- 文档索引：\`.planning/document-index.json\`\n- 代码索引：\`.planning/code-index/\`\n` });
+  outputs.push({ targetPath: ".context/spec/index.md", body: `${frontmatter({ type: "compat-spec-index", scope: "project", project: context.manifest.name, status: "compat", source_snapshot: snapshotId, code_index_generation: generation, managed: true })}# 兼容 Spec 入口\n\n本文件是项目初始化的兼容入口，用于旧流程查找 \`.context/spec/index.md\`。新的权威入口如下：\n\n- 项目知识库：[../index.md](../index.md)\n- 项目级文档：[../project/index.md](../project/index.md)\n- OpenWiki 风格知识层：[../knowledge/index.md](../knowledge/index.md)\n- 初始化接口目录：[../knowledge/interfaces/index.md](../knowledge/interfaces/index.md)\n- 文档索引：\`.planning/document-index.json\`\n- 知识索引：\`.planning/knowledge-index.json\`\n- 接口索引：\`.planning/interface-index.json\`\n- 代码索引：\`.planning/code-index/\`\n\n此兼容入口不表示需求、设计或 API 已批准；人工确认前所有生成内容保持 draft/compat 状态。\n` });
   outputs.push({ targetPath: ".context/project/index.md", body: `${frontmatter({ type: "project-document-index", scope: "project", project: context.manifest.name, status: "draft", source_snapshot: snapshotId, code_index_generation: generation, managed: true })}# 项目级文档\n\n${KNOWLEDGE_DOCUMENT_TYPES.map(type => `- [${documentTitle(type)}](./${type}.md)`).join("\n")}\n` });
   for (const type of KNOWLEDGE_DOCUMENT_TYPES) outputs.push({ targetPath: `.context/project/${type}.md`, body: projectKnowledgeBody(context, type, facts, intro, snapshotId, knowledge, generation) });
   outputs.push({ targetPath: ".context/requirements/_template/index.md", body: `${frontmatter({ type: "requirement-document-index", scope: "requirement", project: context.manifest.name, requirement_id: "REQ-TEMPLATE", status: "template", source_snapshot: snapshotId, code_index_generation: generation, managed: true })}# 需求级文档模板\n\n${KNOWLEDGE_DOCUMENT_TYPES.map(type => `- [${documentTitle(type)}](./${type === "requirements" ? "requirement" : type}.md)`).join("\n")}\n` });

package/src/project-initializer.ts

@@ -10,7 +10,17 @@ const TEXT_EXTENSIONS = new Set([".ts", ".tsx", ".js", ".jsx", ".py", ".rb", ".g
 
 type SourceFile = { repository: string; path: string; absolute: string; contentHash: string; size: number; text?: string };
 type ScanDiagnostic = { repository: string; path: string; reason: "symlink" | "excluded" | "too_large" | "unreadable"; message?: string };
-export type InitializationProgress = { runId: string; snapshotId?: string; completeness?: "complete" | "partial"; diagnostics: string[]; documents?: Array<{ targetPath: string; status: string; outputPath?: string; error?: string }> };
+export type InitializationProgress = {
+  runId: string;
+  snapshotId?: string;
+  completeness?: "complete" | "partial";
+  diagnostics: string[];
+  documents?: Array<{ targetPath: string; status: string; outputPath?: string; error?: string }>;
+  database: string;
+  projectId: string;
+  workspaceId: string;
+  planningRoot: string;
+};
 
 function digest(value: string | Uint8Array): string { return `sha256:${createHash("sha256").update(value).digest("hex")}`; }
 function extension(file: string): string { return path.extname(file).toLowerCase(); }
@@ -189,7 +199,15 @@ export async function runProjectInitialization(context: ProjectContext, input: {
     const inputSnapshot = store.createInputSnapshot(workspace.id, storedConfig.id, manifest, false);
     const run = store.startRun({ workspaceId: workspace.id, configId: storedConfig.id, inputSnapshotId: inputSnapshot.id, requestId: input.requestId });
     activeRun = run;
-    if (run.reused) return { runId: run.id, snapshotId: store.getRun(run.id)?.publishedSnapshotId as string | undefined, diagnostics };
+    if (run.reused) return {
+      runId: run.id,
+      snapshotId: store.getRun(run.id)?.publishedSnapshotId as string | undefined,
+      diagnostics,
+      database: context.controlDatabasePath,
+      projectId: context.manifest.projectId,
+      workspaceId: context.workspaceId,
+      planningRoot: context.planningRoot,
+    };
     const grouped = collect(files, context, config); const required = new Set(config.requiredKinds ?? FACT_KINDS);
     for (const repository of config.repositories) for (const kind of FACT_KINDS) {
       const repositoryFacts = grouped.get(kind)!.filter(fact => fact.repository === repository.name);
@@ -241,7 +259,17 @@ export async function runProjectInitialization(context: ProjectContext, input: {
         documents = [{ targetPath: ".planning/initialization/report.md", status: "failed", error: message }];
       }
     }
-    return { runId: run.id, snapshotId: published.snapshotId, completeness: result.snapshot.completeness, diagnostics, documents };
+    return {
+      runId: run.id,
+      snapshotId: published.snapshotId,
+      completeness: result.snapshot.completeness,
+      diagnostics,
+      documents,
+      database: context.controlDatabasePath,
+      projectId: context.manifest.projectId,
+      workspaceId: context.workspaceId,
+      planningRoot: context.planningRoot,
+    };
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     diagnostics.push(message);