@guanlin4924/devflow-pi 0.1.79 → 0.1.81

package/package.json

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

package/plugins/devflow-intel/extensions/devflow-intel.ts

@@ -1,4 +1,5 @@
-import { existsSync } from "node:fs";
+import { existsSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -53,21 +54,32 @@ export default function devflowIntel(pi: ExtensionAPI) {
     label: "Devflow Code Index",
     description: "Scan, validate, audit, or query the deterministic project code index.",
     parameters: z.object({
-      action: z.enum(["scan", "validate", "audit", "query", "relations", "impact"]),
+      action: z.enum(["scan", "validate", "audit", "query", "relations", "impact", "search-content", "resolve-domain", "query-plan", "domain-import"]),
       term: z.string().optional(),
       object: z.string().optional(),
       entity: z.string().optional(),
+      projectId: z.string().default("default"),
+      plan: z.record(z.string(), z.unknown()).optional(),
+      bundle: z.record(z.string(), z.unknown()).optional(),
+      repository: z.string().optional(),
+      pathPrefix: z.string().optional(),
+      language: z.string().optional(),
+      matchKind: z.enum(["literal", "identifier", "phrase", "substring"]).default("literal"),
+      direction: z.enum(["incoming", "outgoing", "both"]).default("outgoing"),
+      expectedRevision: z.string().optional(),
       changeType: z.enum(["remove_field", "rename_field", "change_type", "optional_to_required", "required_to_optional", "change_nullability", "change_enum"]).optional(),
       snapshot: z.string().optional(),
+      mappingRevision: z.string().optional(),
       depth: z.number().int().min(0).max(20).default(3),
       includeHeuristic: z.boolean().default(false),
       limit: z.number().int().min(1).max(100).default(20),
       changedFiles: z.array(z.string()).default([]),
+      validationLevel: z.enum(["fast", "publish", "full"]).default("publish"),
     }),
     approval: (args) => {
       const action = (args as { action?: string }).action;
       // scan 写 .planning/code-index，按 exec 询问；validate/audit/query 只读，免确认。
-      return action === "scan" ? "exec" : "read";
+      return ["scan", "domain-import"].includes(action ?? "") ? "exec" : "read";
     },
     async execute(_id, params, _signal, _onUpdate, ctx) {
       const skillRoot = resolveSkillRoot(ctx.cwd);
@@ -78,9 +90,11 @@ export default function devflowIntel(pi: ExtensionAPI) {
         if (params.changedFiles.length > 0) args.push("--changed-files", ...params.changedFiles);
       } else if (params.action === "validate") {
         args.push("--index", ".planning/code-index");
+        args.push("--level", params.validationLevel);
         if (params.snapshot) args.push("--snapshot", params.snapshot);
       } else if (params.action === "audit") {
         args.push("--root", ctx.cwd, "--index", ".planning/code-index", "--skill-root", skillRoot);
+        args.push("--level", params.validationLevel === "fast" ? "publish" : params.validationLevel);
         if (params.snapshot) args.push("--snapshot", params.snapshot);
       } else if (params.action === "query") {
         if (!params.term) {
@@ -89,6 +103,40 @@ export default function devflowIntel(pi: ExtensionAPI) {
         args.push("--index", ".planning/code-index", "--term", params.term, "--limit", String(params.limit));
         if (params.snapshot) args.push("--snapshot", params.snapshot);
       } else {
+        if (params.action === "search-content") {
+          if (!params.term) return render({ ok: false, exitCode: 2, stdout: "", stderr: "term is required" }, {});
+          args.push("--index", ".planning/code-index", "--term", params.term, "--limit", String(params.limit));
+          args.push("--project-id", params.projectId);
+          args.push("--match-kind", params.matchKind === "phrase" ? "exact_phrase" : params.matchKind);
+          if (params.repository) args.push("--repository", params.repository);
+          if (params.pathPrefix) args.push("--path-prefix", params.pathPrefix);
+          if (params.language) args.push("--language", params.language);
+          return render(await run(args, ctx.cwd), { action: params.action });
+        } else if (params.action === "resolve-domain") {
+          if (!params.term) return render({ ok: false, exitCode: 2, stdout: "", stderr: "term is required" }, {});
+          args.push("--index", ".planning/code-index", "--term", params.term, "--project-id", params.projectId, "--limit", String(params.limit));
+          if (params.mappingRevision) args.push("--mapping-revision", params.mappingRevision);
+          return render(await run(args, ctx.cwd), { action: params.action });
+        } else if (params.action === "query-plan") {
+          if (!params.plan) return render({ ok: false, exitCode: 2, stdout: "", stderr: "plan is required" }, {});
+          const plan = { ...params.plan };
+          if (plan.limit === undefined) plan.limit = params.limit;
+          args.push("--index", ".planning/code-index", "--project-id", params.projectId, "--plan", JSON.stringify(plan));
+          if (params.snapshot) args.push("--snapshot", params.snapshot);
+          return render(await run(args, ctx.cwd), { action: params.action });
+        } else if (params.action === "domain-import") {
+          if (!params.bundle) return render({ ok: false, exitCode: 2, stdout: "", stderr: "bundle is required" }, {});
+          const bundleDir = mkdtempSync(path.join(tmpdir(), "devflow-domain-"));
+          const bundlePath = path.join(bundleDir, "bundle.json");
+          try {
+            writeFileSync(bundlePath, JSON.stringify(params.bundle), { encoding: "utf8", mode: 0o600 });
+            args.push("--index", ".planning/code-index", "--project-id", params.projectId, "--bundle", bundlePath);
+            if (params.expectedRevision) args.push("--expected-revision", params.expectedRevision);
+            return render(await run(args, ctx.cwd), { action: params.action });
+          } finally {
+            rmSync(bundleDir, { recursive: true, force: true });
+          }
+        }
         if (params.action === "impact") {
           if (!params.entity) return render({ ok: false, exitCode: 2, stdout: "", stderr: "entity is required" }, {});
           args.push("--index", ".planning/code-index", "--entity", params.entity, "--depth", String(params.depth), "--limit", String(params.limit));
@@ -98,6 +146,7 @@ export default function devflowIntel(pi: ExtensionAPI) {
         }
         if (!params.object) return render({ ok: false, exitCode: 2, stdout: "", stderr: "object is required" }, {});
         args.push("--index", ".planning/code-index", "--object", params.object, "--depth", String(params.depth), "--limit", String(params.limit));
+        args.push("--direction", params.direction);
         if (params.snapshot) args.push("--snapshot", params.snapshot);
         if (params.includeHeuristic) args.push("--include-heuristic");
       }

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

@@ -47,6 +47,20 @@ devflow_code_index(action="audit")
 devflow_code_index(action="impact", entity="api:orders", changeType="remove_field")
 ```
 
+Validation is staged so large indexes do not block publication on a full
+sidecar audit:
+
+- `validationLevel="fast"` checks the snapshot bundle and generation metadata.
+- `validationLevel="publish"` (the default) adds SQLite quick-checks and
+  SQL-backed symbol/relation referential checks. It is the initialization
+  publish gate and does not load every JSONL sidecar into memory.
+- `validationLevel="full"` additionally validates every JSONL record and the
+  semantic graph. Run it as an explicit audit when complete verification is
+  required.
+
+The same split is available to `audit`: the default publish audit is bounded;
+`validationLevel="full"` performs stale-file and full relation auditing.
+
 For changed-file indexing:
 
 ```text