@gyoungwe/research-suite 0.1.2 → 0.1.3

package/README.md

@@ -5,4 +5,6 @@ The suite aggregates the published `@gyoungwe/pi-core`,
 tarball bundles those dependencies so a Pi host can discover the extensions and
 skills without a second network resolution step. `research-workflow` comes
 from `@gyoungwe/pi-research`; `@gyoungwe/pi-knowledge` supplies the Vault and
-Show Me skills, so the suite exposes one copy of each skill.
+Show Me skills, so the suite exposes one copy of each skill. `pi-core` also
+provides the stable `/drone-doctor` and `/drone-example` onboarding commands;
+the latter is read-only unless the user explicitly supplies `--run <question>`.

package/build-manifest.json

@@ -1,11 +1,11 @@
 {
   "version": 1,
   "generator": "packages/research-suite/scripts/build.mjs",
-  "packageVersion": "0.1.2",
+  "packageVersion": "0.1.3",
   "bundled": [
     "@gyoungwe/pi-core",
     "@gyoungwe/pi-knowledge",
     "@gyoungwe/pi-research"
   ],
-  "dependenciesSha256": "226c3c4a28a71df1f571ff6a977d3798d9ccc0914297292772a636f45abf5716"
+  "dependenciesSha256": "b9f96897420917b045d23eab8667a17145c637d2c9784359f8f049e872d1e782"
 }

package/node_modules/@gyoungwe/pi-core/README.md

@@ -3,6 +3,11 @@
 Portable Pi extension for Drone's task ledger and user-facing core tools:
 `ask_user`, `set_status`, `todo`, `deliver_files`, and `memory_save`.
 
+It also exposes `/drone-doctor` (a stable JSON host/package diagnostic) and
+`/drone-example` (a read-only research example preview, with `--run` for an
+explicit user question). The example reports `needs-data`, `blocked`, `ready`,
+or `started`; it never claims a scientific result without source receipts.
+
 The package also registers the `@drone/tasks` runtime. Native Pi uses the
 extension context's `ctx.ui`; Drone Desktop can inject its existing ask gate
 through `registerPiCore(pi, { ask })`. The package has no Electron, backend, or

package/node_modules/@gyoungwe/pi-core/build-manifest.json

@@ -1,8 +1,8 @@
 {
 	"version": 1,
 	"generator": "scripts/build-pi-core.mjs",
-	"inputsSha256": "0a7a9931d9c82a304460a498ea8611a741c5eb9cd74c865831058f357f031f73",
+	"inputsSha256": "de6fabddabb2c24748d325d3484d0c76bfde8ede915da8225d7f4d47927f282c",
 	"outputs": {
-		"dist/index.mjs": "34036b70dd1f62e9ec23d3f4f6c9f2ba1a0e085cac6975860bbb587f91ec3a84"
+		"dist/index.mjs": "df76a92939ab5d6f32c87d6795cafeabe54a90c2bc952c7efdffbfa806996f1b"
 	}
 }

package/node_modules/@gyoungwe/pi-core/dist/index.mjs

@@ -2030,7 +2030,7 @@ function registerWorkbench(pi, options = {}) {
   };
   const journal = createTaskWorkbench({
     requireAuthorization: true,
-    persist: (snapshot) => pi.appendEntry(WORKBENCH_ENTRY, snapshot),
+    persist: (snapshot2) => pi.appendEntry(WORKBENCH_ENTRY, snapshot2),
     onCheckpoint: () => send(),
     // 里程碑验收器（zotero_item / wiki_review / …）由各自的扩展 registerAcceptanceVerifier 登记（挂钩 2）
     inspect
@@ -2309,12 +2309,12 @@ ${hostLanguage() === "zh" ? "\uFF08\u4EE5\u4E0B\u4E3A\u5BBF\u4E3B\u7EA6\u675F\uF
         continueAuthorized(turnContext);
         return;
       }
-      const snapshot = journal.snapshot();
-      if (last?.stopReason !== "error" && !ctx?.signal?.aborted && shouldAskToContinue(snapshot ? journal.view().tasks.find((t) => t.id === snapshot.id) : null)) {
+      const snapshot2 = journal.snapshot();
+      if (last?.stopReason !== "error" && !ctx?.signal?.aborted && shouldAskToContinue(snapshot2 ? journal.view().tasks.find((t) => t.id === snapshot2.id) : null)) {
         send();
         try {
           if (activeSessionId !== turnSessionId || context !== turnContext) return;
-          await progressTask({ taskId: snapshot.id, revision: journal.view().revision }, turnContext);
+          await progressTask({ taskId: snapshot2.id, revision: journal.view().revision }, turnContext);
         } catch {
         }
         return;
@@ -2748,7 +2748,7 @@ function createTaskJournal({ persist = () => {
 }
 function registerTaskRuntime(pi, options = {}) {
   if (process.env.DRONE_TASK_WORKBENCH !== "off") return registerWorkbench(pi, options);
-  const journal = createTaskJournal({ persist: (snapshot) => pi.appendEntry?.(TASK_ENTRY, snapshot) });
+  const journal = createTaskJournal({ persist: (snapshot2) => pi.appendEntry?.(TASK_ENTRY, snapshot2) });
   const attach = (ctx, force = false) => {
     const id = ctx.sessionManager?.getSessionId?.() || ctx.sessionId || "isolated";
     const scope = createHash4("sha256").update(`${id}\0${resolve5(ctx.cwd)}`).digest("hex");
@@ -17309,6 +17309,136 @@ ${formatTodoList(todos)}`;
   };
 }
 
+// src/drone-commands.ts
+import { readFileSync as readFileSync2 } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join as join3 } from "node:path";
+var DRONE_COMMAND_SCHEMA_VERSION = 1;
+var PI_CORE_PACKAGE_VERSION = "0.1.1";
+var PI_HOST_RANGE = ">=1.1.0 <2.0.0";
+var CORE_TOOLS = [
+  "ask_user",
+  "set_status",
+  "todo",
+  "deliver_files",
+  "memory_save",
+  "task_plan",
+  "task_status",
+  "task_wait",
+  "task_reconcile",
+  "task_evidence_restore"
+];
+var EXAMPLE_TOOLS = [
+  "knowledge_status",
+  "knowledge_search",
+  "research_search_sources",
+  "research_read_source",
+  "research_answer_sources"
+];
+function packageVersion() {
+  const configured = process.env.PI_VERSION?.trim();
+  if (configured) return { version: configured, source: "PI_VERSION" };
+  try {
+    const require2 = createRequire(import.meta.url);
+    const entry = require2.resolve("@earendil-works/pi-coding-agent");
+    const packagePath = join3(dirname(entry), "..", "package.json");
+    const metadata = JSON.parse(readFileSync2(packagePath, "utf8"));
+    if (typeof metadata.version === "string" && metadata.version.length > 0)
+      return { version: metadata.version, source: "resolved-package" };
+  } catch {
+  }
+  return { version: null, source: "unavailable" };
+}
+function snapshot(pi) {
+  const tools = typeof pi?.getAllTools === "function" ? pi.getAllTools().map((tool) => String(tool?.name || "")).filter(Boolean) : typeof pi?.getActiveTools === "function" ? pi.getActiveTools().map((name) => String(name)).filter(Boolean) : [];
+  const commands = typeof pi?.getCommands === "function" ? pi.getCommands().map((command) => String(command?.name || "")).filter(Boolean) : [];
+  return { tools: [...new Set(tools)].sort(), commands: [...new Set(commands)].sort() };
+}
+function buildDoctorReport(pi, options = {}) {
+  const current = snapshot(pi);
+  const missingTools = CORE_TOOLS.filter((name) => !current.tools.includes(name));
+  const missingCommands = ["drone-doctor", "drone-example"].filter((name) => !current.commands.includes(name));
+  const resolved = options.hostVersion === void 0 ? packageVersion() : { version: options.hostVersion, source: "host-contract" };
+  const hostKind = options.hostKind || "native-pi";
+  const checks = [
+    {
+      id: "core-tools",
+      status: missingTools.length ? "blocked" : "pass",
+      detail: missingTools.length ? "pi-core tools are missing" : "all pi-core tools are registered",
+      ...missingTools.length ? { missing: missingTools } : {}
+    },
+    {
+      id: "drone-commands",
+      status: missingCommands.length ? "blocked" : "pass",
+      detail: missingCommands.length ? "Drone onboarding commands are missing" : "doctor and example commands are registered",
+      ...missingCommands.length ? { missing: missingCommands } : {}
+    },
+    {
+      id: "pi-host-version",
+      status: resolved.version ? "pass" : "unknown",
+      detail: resolved.version ? `resolved Pi host ${resolved.version}` : "Pi host version is not exposed by this host"
+    }
+  ];
+  const blocked = checks.some((check) => check.status === "blocked");
+  return {
+    schemaVersion: DRONE_COMMAND_SCHEMA_VERSION,
+    command: "drone-doctor",
+    status: blocked ? "blocked" : resolved.version ? "pass" : "unknown",
+    plugin: { name: "@gyoungwe/pi-core", version: PI_CORE_PACKAGE_VERSION, piRange: PI_HOST_RANGE },
+    host: { kind: hostKind, version: resolved.version || null, source: resolved.source },
+    checks,
+    commands: current.commands,
+    tools: current.tools,
+    next: blocked ? "\u5B89\u88C5\u6216\u91CD\u65B0\u52A0\u8F7D\u7F3A\u5931\u7684 Drone \u63D2\u4EF6\u540E\u91CD\u8BD5 /drone-doctor" : null
+  };
+}
+function buildExampleReport(pi, mode = "preview", question) {
+  const current = snapshot(pi);
+  const missingTools = EXAMPLE_TOOLS.filter((name) => !current.tools.includes(name));
+  const hasQuestion = Boolean(question?.trim());
+  const status2 = missingTools.length ? "blocked" : mode === "run" && hasQuestion ? "started" : hasQuestion ? "ready" : "needs-data";
+  return {
+    schemaVersion: DRONE_COMMAND_SCHEMA_VERSION,
+    command: "drone-example",
+    status: status2,
+    mode,
+    title: "Evidence-gated local research example",
+    steps: ["inspect local knowledge", "read at least two sources", "answer with source receipts"],
+    requiredTools: [...EXAMPLE_TOOLS],
+    missingTools: [...missingTools],
+    next: missingTools.length ? "\u5B89\u88C5\u5E76\u542F\u7528 pi-knowledge \u4E0E pi-research \u540E\u91CD\u8BD5 /drone-example" : hasQuestion ? mode === "run" ? "\u7814\u7A76\u56DE\u5408\u5DF2\u6392\u961F\uFF1B\u7B49\u5F85\u771F\u5B9E\u6765\u6E90\u56DE\u6267" : "\u8FD0\u884C /drone-example --run <\u7814\u7A76\u95EE\u9898> \u5F00\u59CB\u53EA\u8BFB\u793A\u4F8B" : "\u63D0\u4F9B\u4E00\u4E2A\u7814\u7A76\u95EE\u9898\uFF1A/drone-example --run <\u7814\u7A76\u95EE\u9898>",
+    ...hasQuestion ? { question: question?.trim() } : {}
+  };
+}
+function emitReport(report, ctx) {
+  const message = JSON.stringify(report);
+  if (ctx.mode === "print" || ctx.mode === "json") console.log(message);
+  else ctx.ui.notify(message, report.status === "blocked" ? "warning" : "info");
+}
+function registerDroneCommands(pi, options = {}) {
+  pi.registerCommand("drone-doctor", {
+    description: "Check the resolved Pi host, core tools and Drone command contract",
+    handler: async (_args, ctx) => emitReport(buildDoctorReport(pi, options), ctx)
+  });
+  pi.registerCommand("drone-example", {
+    description: "Preview or start a read-only evidence-gated research example",
+    handler: async (args, ctx) => {
+      const trimmed = args.trim();
+      const run = trimmed.startsWith("--run");
+      const question = run ? trimmed.slice("--run".length).trim() : trimmed;
+      const report = buildExampleReport(pi, run ? "run" : "preview", question || void 0);
+      if (run && report.status === "started" && typeof pi.sendUserMessage === "function") {
+        await pi.sendUserMessage(
+          `Run a read-only Drone research example for this question: ${question}
+Use local evidence first, read at least two sources, preserve source URIs and hashes, and report blocked/unknown states instead of guessing.`,
+          { deliverAs: "followUp", expandPromptTemplates: true }
+        );
+      }
+      emitReport(report, ctx);
+    }
+  });
+}
+
 // src/index.ts
 var DEFAULT_HOST_VERSION = "1.1.0";
 function createNativePiHostPort(ctx, hostVersion = DEFAULT_HOST_VERSION) {
@@ -17381,6 +17511,7 @@ function registerPiCore(pi, options = {}) {
     activeContext = void 0;
   });
   registerTaskRuntime(pi);
+  registerDroneCommands(pi, { hostKind: options.host?.host === "drone-desktop" ? "drone-desktop" : "native-pi" });
   const ask = options.ask || ((request, signal, context) => askWithNativeUi(request, signal, context || activeContext));
   pi.registerTool(makeAskUserTool({ ask }));
   pi.registerTool(makeStatusTool());
@@ -17394,7 +17525,12 @@ function registerPiCore(pi, options = {}) {
 }
 var index_default = registerPiCore;
 export {
+  DRONE_COMMAND_SCHEMA_VERSION,
   MEMORY_SAVE_TOOL,
+  PI_CORE_PACKAGE_VERSION,
+  PI_HOST_RANGE,
+  buildDoctorReport,
+  buildExampleReport,
   createNativePiHostPort,
   index_default as default,
   deliverFilesParams,
@@ -17407,6 +17543,7 @@ export {
   makeTodoTool,
   memoryIndexPrompt,
   normalizeTodos,
+  registerDroneCommands,
   registerPiCore,
   writeMemory
 };

package/node_modules/@gyoungwe/pi-core/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@gyoungwe/pi-core",
-	"version": "0.1.0",
+	"version": "0.1.1",
 	"description": "Portable task, authorization, status, delivery and memory tools for native Pi",
 	"keywords": [
 		"pi-package"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gyoungwe/research-suite",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Bundled Drone native Pi research suite",
   "keywords": ["pi-package", "research", "evidence"],
   "license": "MIT",
@@ -31,7 +31,7 @@
     "prompts": ["./prompts/*.md"]
   },
   "dependencies": {
-    "@gyoungwe/pi-core": "0.1.0",
+    "@gyoungwe/pi-core": "0.1.1",
     "@gyoungwe/pi-knowledge": "0.1.1",
     "@gyoungwe/pi-research": "0.1.0"
   },

package/plugin.manifest.json

@@ -1,7 +1,7 @@
 {
 	"schemaVersion": 1,
 	"id": "drone-research-suite",
-	"version": "0.1.2",
+	"version": "0.1.3",
 	"pi": {
 		"apiVersion": 1,
 		"minHostVersion": "1.1.0",