@gyoungwe/research-suite 0.1.3 → 0.1.5

package/build-manifest.json

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

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

@@ -4,9 +4,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.
+`/drone-example` (a read-only example preview). The example accepts
+`knowledge`, `research`, `analysis`, or `evidence` profiles, with `research`
+as the default; add `--run <question>` only when an explicit read-only run is
+wanted. Reports distinguish `unconfigured`, `needs-data`, `blocked`, `ready`,
+and `started`, and never claim 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

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

@@ -3,6 +3,6 @@
 	"generator": "scripts/build-pi-core.mjs",
 	"inputsSha256": "de6fabddabb2c24748d325d3484d0c76bfde8ede915da8225d7f4d47927f282c",
 	"outputs": {
-		"dist/index.mjs": "df76a92939ab5d6f32c87d6795cafeabe54a90c2bc952c7efdffbfa806996f1b"
+		"dist/index.mjs": "6c3bdc2006cf6e329f10492c943a32fb50f1ddc8d32175fbcd99605df5fde1bb"
 	}
 }

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

@@ -101,7 +101,8 @@ function createStandaloneRuntime(log = {}) {
   return runtime;
 }
 function currentRuntime() {
-  if (contexts.getStore()) return contexts.getStore();
+  const scoped = contexts.getStore();
+  if (scoped) return scoped;
   if (installedRuntime) return installedRuntime;
   if (!standaloneRuntime) standaloneRuntime = createStandaloneRuntime();
   return standaloneRuntime;
@@ -144,10 +145,7 @@ function runtimeSlot(domain, slot, create) {
       }
     }
   );
-  return (
-    /** @type {T} */
-    proxy
-  );
+  return proxy;
 }
 
 // ../tasks/src/runtime-compiled/acceptance.mjs
@@ -2818,6 +2816,228 @@ Use task_status for operational delivery. Verify unknown outcomes before repeati
   return journal;
 }
 
+// src/drone-commands.ts
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { join } from "node:path";
+var DRONE_COMMAND_SCHEMA_VERSION = 1;
+var PI_CORE_PACKAGE_VERSION = "0.1.3";
+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_PROFILES = {
+  knowledge: {
+    title: "Knowledge Vault example",
+    steps: ["check the local Vault", "search local knowledge", "cite the retrieved note paths"],
+    requiredTools: ["knowledge_status", "knowledge_search"],
+    missingToolsNext: "\u5B89\u88C5\u5E76\u542F\u7528 pi-knowledge \u540E\u91CD\u8BD5 /drone-example knowledge",
+    missingDataNext: "\u63D0\u4F9B\u4E00\u4E2A\u77E5\u8BC6\u95EE\u9898\uFF1A/drone-example knowledge --run <\u95EE\u9898>"
+  },
+  research: {
+    title: "Evidence-gated local research example",
+    steps: ["inspect local knowledge", "read at least two sources", "answer with source receipts"],
+    requiredTools: ["research_search_sources", "research_read_source", "research_answer_sources"],
+    missingToolsNext: "\u5B89\u88C5\u5E76\u542F\u7528 pi-research \u540E\u91CD\u8BD5 /drone-example research",
+    missingDataNext: "\u63D0\u4F9B\u4E00\u4E2A\u7814\u7A76\u95EE\u9898\uFF1A/drone-example research --run <\u7814\u7A76\u95EE\u9898>"
+  },
+  analysis: {
+    title: "Analysis readiness example",
+    requiresContainer: true,
+    steps: [
+      "list compatible analysis adapters",
+      "assess input readiness",
+      "report missing data before execution"
+    ],
+    requiredTools: ["analysis_list_adapters", "analysis_assess_readiness"],
+    missingToolsNext: "\u5B89\u88C5\u5E76\u542F\u7528 pi-analysis \u540E\u91CD\u8BD5 /drone-example analysis",
+    missingDataNext: "\u63D0\u4F9B\u8F93\u5165\u4E0E\u5206\u6790\u95EE\u9898\uFF1A/drone-example analysis --run <\u5206\u6790\u95EE\u9898>"
+  },
+  evidence: {
+    title: "Evidence validation example",
+    steps: ["validate an artifact manifest", "validate an evidence capsule", "verify replay metadata"],
+    requiredTools: ["evidence_validate_manifest", "evidence_validate_capsule", "evidence_verify_replay"],
+    missingToolsNext: "\u5B89\u88C5\u5E76\u542F\u7528 pi-evidence \u540E\u91CD\u8BD5 /drone-example evidence",
+    missingDataNext: "\u63D0\u4F9B\u5F85\u6838\u9A8C\u7684\u8BC1\u636E\u5BF9\u8C61\uFF1A/drone-example evidence --run <\u5BF9\u8C61>"
+  }
+};
+var EXAMPLE_KINDS = new Set(Object.keys(EXAMPLE_PROFILES));
+function packageVersion() {
+  const configured = process.env.PI_VERSION?.trim();
+  if (configured) return { version: configured, source: "PI_VERSION" };
+  try {
+    const require2 = createRequire(import.meta.url);
+    for (const base of require2.resolve.paths("@earendil-works/pi-coding-agent") ?? []) {
+      const packagePath = join(base, "@earendil-works/pi-coding-agent", "package.json");
+      try {
+        const metadata = JSON.parse(readFileSync(packagePath, "utf8"));
+        if (typeof metadata.version === "string" && metadata.version.length > 0)
+          return { version: metadata.version, source: "resolved-package" };
+      } catch {
+      }
+    }
+  } 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 isSupportedPiHost(version) {
+  const match = /^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(version.trim());
+  if (!match) return false;
+  const major = Number(match[1]);
+  const minor = Number(match[2]);
+  const patch = Number(match[3]);
+  return major === 1 && (minor > 1 || minor === 1 && patch >= 0);
+}
+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 hostCompatible = resolved.version ? isSupportedPiHost(resolved.version) : null;
+  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 ? hostCompatible ? "pass" : "incompatible" : "unknown",
+      detail: resolved.version ? hostCompatible ? `resolved Pi host ${resolved.version}` : `Pi host ${resolved.version} is outside ${PI_HOST_RANGE}` : "Pi host version is not exposed by this host"
+    }
+  ];
+  const blocked = checks.some((check) => check.status === "blocked");
+  const incompatible = checks.some((check) => check.status === "incompatible");
+  return {
+    schemaVersion: DRONE_COMMAND_SCHEMA_VERSION,
+    command: "drone-doctor",
+    status: blocked ? "blocked" : incompatible ? "incompatible" : 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" : incompatible ? `\u5347\u7EA7 Pi \u5230 ${PI_HOST_RANGE} \u540E\u91CD\u8BD5 /drone-doctor` : null
+  };
+}
+function buildExampleReport(pi, mode = "preview", question, options = {}) {
+  const example = options.example ?? "research";
+  const profile = EXAMPLE_PROFILES[example];
+  const current = snapshot(pi);
+  const missingTools = profile.requiredTools.filter((name) => !current.tools.includes(name));
+  const hasQuestion = Boolean(question?.trim());
+  const knowledgeStatus = example === "knowledge" ? options.knowledgeStatus ?? (process.env.DRONE_KNOWLEDGE_DIR?.trim() ? "unknown" : "unconfigured") : void 0;
+  const containerAvailable = options.containerAvailable ?? Boolean(process.env.DRONE_CONTAINER_RUNTIME?.trim());
+  const missingContainer = Boolean(profile.requiresContainer && !containerAvailable);
+  const status2 = missingTools.length ? "blocked" : knowledgeStatus === "unconfigured" ? "unconfigured" : knowledgeStatus === "unknown" ? "needs-data" : missingContainer ? "needs-container" : mode === "run" && hasQuestion ? "started" : hasQuestion ? "ready" : "needs-data";
+  return {
+    schemaVersion: DRONE_COMMAND_SCHEMA_VERSION,
+    command: "drone-example",
+    example,
+    status: status2,
+    mode,
+    title: profile.title,
+    steps: [...profile.steps],
+    requiredTools: [...profile.requiredTools],
+    missingTools: [...missingTools],
+    next: missingTools.length ? profile.missingToolsNext : missingContainer ? "\u767B\u8BB0\u5E76\u542F\u7528\u4E00\u4E2A\u5BB9\u5668\u8FD0\u884C\u65F6\u540E\u91CD\u8BD5 /drone-example analysis" : knowledgeStatus === "unconfigured" ? "\u5148\u8FD0\u884C /drone-init \u7ED1\u5B9A\u672C\u5730 Vault\uFF0C\u518D\u91CD\u8BD5 /drone-example knowledge" : knowledgeStatus === "unknown" ? "\u65E0\u6CD5\u786E\u8BA4\u672C\u5730 Vault \u72B6\u6001\uFF1B\u5148\u8FD0\u884C /drone-init \u6216\u68C0\u67E5\u77E5\u8BC6\u5E93\u63D2\u4EF6\u540E\u91CD\u8BD5" : hasQuestion ? mode === "run" ? `${profile.title} \u5DF2\u6392\u961F\uFF1B\u7B49\u5F85\u771F\u5B9E\u56DE\u6267` : `\u8FD0\u884C /drone-example ${example} --run <\u95EE\u9898> \u5F00\u59CB\u53EA\u8BFB\u793A\u4F8B` : profile.missingDataNext,
+    ...hasQuestion ? { question: question?.trim() } : {}
+  };
+}
+function parseExampleArgs(args) {
+  const tokens = args.trim().split(/\s+/).filter(Boolean);
+  let mode = "preview";
+  const remaining = tokens.filter((token) => {
+    if (token === "--run") {
+      mode = "run";
+      return false;
+    }
+    return true;
+  });
+  const candidate = remaining[0]?.toLowerCase();
+  const example = candidate && EXAMPLE_KINDS.has(candidate) ? candidate : "research";
+  if (candidate && EXAMPLE_KINDS.has(candidate)) remaining.shift();
+  const question = remaining.join(" ").trim();
+  return { mode, example, ...question ? { question } : {} };
+}
+async function resolveKnowledgeStatus(pi, ctx) {
+  if (!process.env.DRONE_KNOWLEDGE_DIR?.trim()) return "unconfigured";
+  const tool = typeof pi?.getAllTools === "function" ? pi.getAllTools().find((candidate) => candidate?.name === "knowledge_status") : void 0;
+  if (typeof tool?.execute !== "function") return "unknown";
+  try {
+    const result = await tool.execute(
+      "drone-example:knowledge-status",
+      {},
+      new AbortController().signal,
+      () => void 0,
+      ctx
+    );
+    const status2 = result?.details?.status ?? result?.status;
+    if (status2 === "unconfigured") return "unconfigured";
+    if (status2 === "configured") return "configured";
+  } catch {
+  }
+  return "unknown";
+}
+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" || report.status === "unconfigured" || report.status === "needs-container" || report.status === "incompatible" ? "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 Drone knowledge, research, analysis or evidence example",
+    handler: async (args, ctx) => {
+      const parsed = parseExampleArgs(args);
+      const knowledgeStatus = parsed.example === "knowledge" ? await resolveKnowledgeStatus(pi, ctx) : void 0;
+      const report = buildExampleReport(pi, parsed.mode, parsed.question, {
+        example: parsed.example,
+        knowledgeStatus
+      });
+      if (parsed.mode === "run" && report.status === "started" && typeof pi.sendUserMessage === "function") {
+        await pi.sendUserMessage(
+          `Run a read-only Drone ${report.example} example for this question: ${parsed.question}
+Use local evidence first, preserve source URIs and hashes, and report blocked/unknown states instead of guessing.`,
+          { deliverAs: "followUp", expandPromptTemplates: true }
+        );
+      }
+      emitReport(report, ctx);
+    }
+  });
+}
+
 // ../shared/src/analysis-orchestration.ts
 var ANALYSIS_STAGES = Object.freeze([
   "intake",
@@ -16954,12 +17174,12 @@ import { stat as stat2 } from "node:fs/promises";
 
 // src/path.ts
 import { homedir as homedir2 } from "node:os";
-import { isAbsolute as isAbsolute5, join, resolve as resolve6 } from "node:path";
+import { isAbsolute as isAbsolute5, join as join2, resolve as resolve6 } from "node:path";
 var UNICODE_SPACES = /[\u00A0\u1680\u2000-\u200A\u202F\u205F\u3000\uFEFF]/g;
 function resolveToolPath(rawPath, cwd, home = homedir2()) {
   let path = rawPath.replace(UNICODE_SPACES, " ");
   if (path === "~") path = home;
-  else if (path.startsWith("~/")) path = join(home, path.slice(2));
+  else if (path.startsWith("~/")) path = join2(home, path.slice(2));
   return isAbsolute5(path) ? path : resolve6(cwd, path);
 }
 
@@ -17020,13 +17240,13 @@ function makeDeliverFilesTool() {
 }
 
 // src/memory.ts
-import { mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { join as join2 } from "node:path";
+import { mkdirSync, readdirSync, readFileSync as readFileSync2, renameSync, rmSync, writeFileSync } from "node:fs";
+import { join as join3 } from "node:path";
 var MEMORY_TYPES = ["user", "feedback", "project", "reference"];
 var MEMORY_INDEX = "MEMORY.md";
 var MAX_INDEX_LINES = 200;
 function memoryDir(cwd) {
-  return join2(cwd, ".pi", "memory");
+  return join3(cwd, ".pi", "memory");
 }
 function memorySlug(name) {
   const slug = name.trim().toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "").slice(0, 64);
@@ -17079,7 +17299,7 @@ function listMemories(cwd) {
   }
   const out = [];
   for (const file of files) {
-    const entry = parseMemory(readFileSync(join2(dir, file), "utf8"));
+    const entry = parseMemory(readFileSync2(join3(dir, file), "utf8"));
     if (entry) out.push({ ...entry, file });
   }
   return out;
@@ -17088,14 +17308,14 @@ function writeMemory(cwd, entry) {
   const dir = memoryDir(cwd);
   mkdirSync(dir, { recursive: true });
   const file = `${entry.type}_${memorySlug(entry.name)}.md`;
-  atomicWrite(join2(dir, file), serializeMemory(entry));
-  atomicWrite(join2(dir, MEMORY_INDEX), renderMemoryIndex(listMemories(cwd)));
+  atomicWrite(join3(dir, file), serializeMemory(entry));
+  atomicWrite(join3(dir, MEMORY_INDEX), renderMemoryIndex(listMemories(cwd)));
   return file;
 }
 function memoryIndexPrompt(cwd) {
   let index;
   try {
-    index = readFileSync(join2(memoryDir(cwd), MEMORY_INDEX), "utf8");
+    index = readFileSync2(join3(memoryDir(cwd), MEMORY_INDEX), "utf8");
   } catch {
     return [];
   }
@@ -17111,8 +17331,8 @@ ${shown.join("\n")}${lines.length > shown.length ? `
 function forgetMemory(cwd, file) {
   if (!/^[^\\/]+\.md$/.test(file) || file === MEMORY_INDEX) return false;
   if (!listMemories(cwd).some((e) => e.file === file)) return false;
-  rmSync(join2(memoryDir(cwd), file));
-  atomicWrite(join2(memoryDir(cwd), MEMORY_INDEX), renderMemoryIndex(listMemories(cwd)));
+  rmSync(join3(memoryDir(cwd), file));
+  atomicWrite(join3(memoryDir(cwd), MEMORY_INDEX), renderMemoryIndex(listMemories(cwd)));
   return true;
 }
 
@@ -17309,136 +17529,6 @@ ${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) {
@@ -17511,7 +17601,9 @@ function registerPiCore(pi, options = {}) {
     activeContext = void 0;
   });
   registerTaskRuntime(pi);
-  registerDroneCommands(pi, { hostKind: options.host?.host === "drone-desktop" ? "drone-desktop" : "native-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());
@@ -17543,6 +17635,7 @@ export {
   makeTodoTool,
   memoryIndexPrompt,
   normalizeTodos,
+  parseExampleArgs,
   registerDroneCommands,
   registerPiCore,
   writeMemory

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

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

package/package.json

@@ -1,46 +1,60 @@
 {
-  "name": "@gyoungwe/research-suite",
-  "version": "0.1.3",
-  "description": "Bundled Drone native Pi research suite",
-  "keywords": ["pi-package", "research", "evidence"],
-  "license": "MIT",
-  "publishConfig": {"access": "public"},
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Gyoungwe/drone-plugins.git",
-    "directory": "packages/research-suite"
-  },
-  "type": "module",
-  "files": ["package.json", "plugin.manifest.json", "README.md", "build-manifest.json", "prompts"],
-  "scripts": {
-    "build": "node scripts/build.mjs",
-    "build:check": "node scripts/build.mjs --check",
-    "typecheck": "node -e \"process.exit(0)\""
-  },
-  "pi": {
-    "extensions": [
-      "./node_modules/@gyoungwe/pi-core/dist/index.mjs",
-      "./node_modules/@gyoungwe/pi-knowledge/dist/index.mjs",
-      "./node_modules/@gyoungwe/pi-research/dist/index.mjs"
-    ],
-    "skills": [
-      "./node_modules/@gyoungwe/pi-core/skills/*",
-      "./node_modules/@gyoungwe/pi-knowledge/skills/*",
-      "./node_modules/@gyoungwe/pi-research/skills/*"
-    ],
-    "prompts": ["./prompts/*.md"]
-  },
-  "dependencies": {
-    "@gyoungwe/pi-core": "0.1.1",
-    "@gyoungwe/pi-knowledge": "0.1.1",
-    "@gyoungwe/pi-research": "0.1.0"
-  },
-  "bundleDependencies": [
-    "@gyoungwe/pi-core",
-    "@gyoungwe/pi-knowledge",
-    "@gyoungwe/pi-research"
-  ],
-  "peerDependencies": {
-    "@earendil-works/pi-coding-agent": ">=1.1.0 <2.0.0"
-  }
+	"name": "@gyoungwe/research-suite",
+	"version": "0.1.5",
+	"description": "Bundled Drone native Pi research suite",
+	"keywords": [
+		"pi-package",
+		"research",
+		"evidence"
+	],
+	"license": "MIT",
+	"publishConfig": {
+		"access": "public"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Gyoungwe/drone-plugins.git",
+		"directory": "packages/research-suite"
+	},
+	"type": "module",
+	"files": [
+		"package.json",
+		"plugin.manifest.json",
+		"README.md",
+		"build-manifest.json",
+		"prompts"
+	],
+	"scripts": {
+		"build": "node scripts/build.mjs",
+		"build:check": "node scripts/build.mjs --check",
+		"typecheck": "node -e \"process.exit(0)\""
+	},
+	"pi": {
+		"extensions": [
+			"./node_modules/@gyoungwe/pi-core/dist/index.mjs",
+			"./node_modules/@gyoungwe/pi-knowledge/dist/index.mjs",
+			"./node_modules/@gyoungwe/pi-research/dist/index.mjs"
+		],
+		"skills": [
+			"./node_modules/@gyoungwe/pi-core/skills/*",
+			"./node_modules/@gyoungwe/pi-knowledge/skills/*",
+			"./node_modules/@gyoungwe/pi-research/skills/*"
+		],
+		"prompts": [
+			"./prompts/*.md"
+		]
+	},
+	"dependencies": {
+		"@gyoungwe/pi-core": "0.1.3",
+		"@gyoungwe/pi-knowledge": "0.1.1",
+		"@gyoungwe/pi-research": "0.1.0"
+	},
+	"bundleDependencies": [
+		"@gyoungwe/pi-core",
+		"@gyoungwe/pi-knowledge",
+		"@gyoungwe/pi-research"
+	],
+	"peerDependencies": {
+		"@earendil-works/pi-coding-agent": ">=1.1.0 <2.0.0"
+	}
 }

package/plugin.manifest.json

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