opensyn 0.1.0 → 0.1.3

package/README.md

@@ -18,6 +18,7 @@ Default workspace behavior:
 - `openclaw enable_opensyn` uses the current OpenClaw workspace if no project path is provided
 - `openclaw enable_opensyn` also bootstraps the managed shell hook, starts the plugin-managed background `watch-linux` collector, and starts the plugin-managed host-model distillation worker
 - `openclaw status_opensyn` returns a compact `next=...` hint so the customer can see the next required action immediately
+- add `--json` only when full diagnostics are needed
 
 Fallback local-dev install:
 

package/README.zh-CN.md

@@ -18,6 +18,7 @@ openclaw status_opensyn
 - `openclaw enable_opensyn` 如果不传项目路径，会直接使用当前 OpenClaw workspace
 - `openclaw enable_opensyn` 还会完成托管 shell hook 自举，并拉起插件托管的后台 `watch-linux` 采集器和 host-model distillation worker
 - `openclaw status_opensyn` 会直接返回统一的 `next=...` 提示，让客户马上知道下一步动作
+- 只有在排障时才需要追加 `--json` 查看完整诊断信息
 
 本地开发联调安装：
 

package/index.ts

@@ -9,6 +9,7 @@ import {
   openSync,
   readFileSync,
   readdirSync,
+  renameSync,
   realpathSync,
   rmSync,
   statSync,
@@ -456,6 +457,23 @@ function defaultProjectionBundleRoot(): string {
   return path.join(home, ".openclaw", "workspace");
 }
 
+function syncRuntimeFile(sourcePath: string, destPath: string): void {
+  const sourceStat = statSync(sourcePath);
+  const needsCopy =
+    !existsSync(destPath) ||
+    statSync(destPath).size !== sourceStat.size ||
+    statSync(destPath).mtimeMs < sourceStat.mtimeMs;
+  if (!needsCopy) {
+    return;
+  }
+
+  mkdirSync(path.dirname(destPath), { recursive: true });
+  const tempPath = `${destPath}.tmp-${process.pid}-${Date.now()}`;
+  copyFileSync(sourcePath, tempPath);
+  chmodSync(tempPath, sourceStat.mode);
+  renameSync(tempPath, destPath);
+}
+
 function syncRuntimeTree(sourceDir: string, destDir: string): void {
   if (!existsSync(sourceDir)) {
     return;
@@ -469,17 +487,7 @@ function syncRuntimeTree(sourceDir: string, destDir: string): void {
       syncRuntimeTree(sourcePath, destPath);
       continue;
     }
-    const sourceStat = statSync(sourcePath);
-    const needsCopy =
-      !existsSync(destPath) ||
-      statSync(destPath).size !== sourceStat.size ||
-      statSync(destPath).mtimeMs < sourceStat.mtimeMs;
-    if (!needsCopy) {
-      continue;
-    }
-    mkdirSync(path.dirname(destPath), { recursive: true });
-    copyFileSync(sourcePath, destPath);
-    chmodSync(destPath, sourceStat.mode);
+    syncRuntimeFile(sourcePath, destPath);
   }
 }
 
@@ -1585,6 +1593,16 @@ function summarizeAssetApprovalResult(result: {
   return `${base} | synced_records=${String(sync.applied_record_count ?? 0)} | host=${sync.host || "unknown"}`;
 }
 
+function extractNextStep(result: unknown): UserNextStep | undefined {
+  if (typeof result !== "object" || result === null) {
+    return undefined;
+  }
+  if ("next_step" in result) {
+    return (result as { next_step?: UserNextStep }).next_step;
+  }
+  return undefined;
+}
+
 function looksLikeContextObject(result: unknown): boolean {
   return (
     typeof result === "object" &&
@@ -2087,11 +2105,21 @@ async function repairAutonomousCollection(
   };
 }
 
-function printCliResult(result: unknown): void {
+function printCliResult(result: unknown, jsonOutput = false): void {
   const summary = summarizeResult(result);
   if (summary) {
     console.log(summary);
   }
+  const nextStep = extractNextStep(result);
+  if (!jsonOutput) {
+    if (nextStep && nextStep.code !== "none") {
+      console.log(`Next: ${nextStep.summary}`);
+      if (nextStep.action) {
+        console.log(`Action: ${nextStep.action}`);
+      }
+    }
+    return;
+  }
   console.log(JSON.stringify(result, null, 2));
 }
 
@@ -2134,7 +2162,8 @@ export default {
           )
           .argument("[project_root]", "Optional project root. Defaults to the current OpenClaw workspace.")
           .option("--shell <shell>", "Shell to manage for command capture.")
-          .action(async (projectRootArg?: string, opts?: { shell?: string }) => {
+          .option("--json", "Print the full JSON result.")
+          .action(async (projectRootArg?: string, opts?: { shell?: string; json?: boolean }) => {
             const projectRoot = resolveCliProjectRoot(projectRootArg);
             const resolved = await resolveCliConfig(projectRoot, true);
             const result = await enableAutonomousCollection(resolved, {
@@ -2142,7 +2171,7 @@ export default {
               shell: opts?.shell,
               updated_by: "openclaw_cli",
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         program
@@ -2152,7 +2181,8 @@ export default {
           )
           .argument("[project_root]", "Optional project root. Defaults to the current OpenClaw workspace.")
           .option("--shell <shell>", "Shell to stop managing for command capture.")
-          .action(async (projectRootArg?: string, opts?: { shell?: string }) => {
+          .option("--json", "Print the full JSON result.")
+          .action(async (projectRootArg?: string, opts?: { shell?: string; json?: boolean }) => {
             const projectRoot = resolveCliProjectRoot(projectRootArg);
             const resolved = await resolveCliConfig(projectRoot, true);
             const result = await disableAutonomousCollection(resolved, {
@@ -2160,7 +2190,7 @@ export default {
               shell: opts?.shell,
               updated_by: "openclaw_cli",
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         program
@@ -2170,14 +2200,15 @@ export default {
           )
           .argument("[project_root]", "Optional project root. Defaults to the current OpenClaw workspace.")
           .option("--shell <shell>", "Shell to inspect for command capture.")
-          .action(async (projectRootArg?: string, opts?: { shell?: string }) => {
+          .option("--json", "Print the full JSON result.")
+          .action(async (projectRootArg?: string, opts?: { shell?: string; json?: boolean }) => {
             const projectRoot = resolveCliProjectRoot(projectRootArg);
             const resolved = await resolveCliConfig(projectRoot);
             const result = await getAutonomousCollectionStatus(resolved, {
               project_root: projectRoot,
               shell: opts?.shell,
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         program
@@ -2187,14 +2218,15 @@ export default {
           )
           .argument("[project_root]", "Optional project root. Defaults to the current OpenClaw workspace.")
           .option("--shell <shell>", "Shell to inspect for command capture.")
-          .action(async (projectRootArg?: string, opts?: { shell?: string }) => {
+          .option("--json", "Print the full JSON result.")
+          .action(async (projectRootArg?: string, opts?: { shell?: string; json?: boolean }) => {
             const projectRoot = resolveCliProjectRoot(projectRootArg);
             const resolved = await resolveCliConfig(projectRoot);
             const result = await getAutonomousCollectionStatus(resolved, {
               project_root: projectRoot,
               shell: opts?.shell,
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         program
@@ -2204,14 +2236,15 @@ export default {
           )
           .argument("[project_root]", "Optional project root. Defaults to the current OpenClaw workspace.")
           .option("--shell <shell>", "Shell to inspect for command capture.")
-          .action(async (projectRootArg?: string, opts?: { shell?: string }) => {
+          .option("--json", "Print the full JSON result.")
+          .action(async (projectRootArg?: string, opts?: { shell?: string; json?: boolean }) => {
             const projectRoot = resolveCliProjectRoot(projectRootArg);
             const resolved = await resolveCliConfig(projectRoot);
             const result = await getAutonomousCollectionStatus(resolved, {
               project_root: projectRoot,
               shell: opts?.shell,
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         program
@@ -2224,14 +2257,15 @@ export default {
             "Optional project root. Defaults to the current OpenClaw workspace.",
           )
           .option("--shell <shell>", "Shell to repair for command capture.")
-          .action(async (projectRootArg?: string, opts?: { shell?: string }) => {
+          .option("--json", "Print the full JSON result.")
+          .action(async (projectRootArg?: string, opts?: { shell?: string; json?: boolean }) => {
             const projectRoot = resolveCliProjectRoot(projectRootArg);
             const resolved = await resolveCliConfig(projectRoot, true);
             const result = await repairAutonomousCollection(resolved, {
               project_root: projectRoot,
               shell: opts?.shell,
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         const opensyn = program
@@ -2243,7 +2277,8 @@ export default {
           .description("Alias for openclaw enable_opensyn.")
           .argument("[project_root]")
           .option("--shell <shell>")
-          .action(async (projectRootArg?: string, opts?: { shell?: string }) => {
+          .option("--json", "Print the full JSON result.")
+          .action(async (projectRootArg?: string, opts?: { shell?: string; json?: boolean }) => {
             const projectRoot = resolveCliProjectRoot(projectRootArg);
             const resolved = await resolveCliConfig(projectRoot, true);
             const result = await enableAutonomousCollection(resolved, {
@@ -2251,7 +2286,7 @@ export default {
               shell: opts?.shell,
               updated_by: "openclaw_cli",
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         opensyn
@@ -2259,7 +2294,8 @@ export default {
           .description("Alias for openclaw disable_opensyn.")
           .argument("[project_root]")
           .option("--shell <shell>")
-          .action(async (projectRootArg?: string, opts?: { shell?: string }) => {
+          .option("--json", "Print the full JSON result.")
+          .action(async (projectRootArg?: string, opts?: { shell?: string; json?: boolean }) => {
             const projectRoot = resolveCliProjectRoot(projectRootArg);
             const resolved = await resolveCliConfig(projectRoot, true);
             const result = await disableAutonomousCollection(resolved, {
@@ -2267,7 +2303,7 @@ export default {
               shell: opts?.shell,
               updated_by: "openclaw_cli",
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         opensyn
@@ -2275,14 +2311,15 @@ export default {
           .description("Alias for openclaw status_opensyn.")
           .argument("[project_root]")
           .option("--shell <shell>")
-          .action(async (projectRootArg?: string, opts?: { shell?: string }) => {
+          .option("--json", "Print the full JSON result.")
+          .action(async (projectRootArg?: string, opts?: { shell?: string; json?: boolean }) => {
             const projectRoot = resolveCliProjectRoot(projectRootArg);
             const resolved = await resolveCliConfig(projectRoot);
             const result = await getAutonomousCollectionStatus(resolved, {
               project_root: projectRoot,
               shell: opts?.shell,
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         opensyn
@@ -2290,14 +2327,15 @@ export default {
           .description("Alias for openclaw doctor_opensyn.")
           .argument("[project_root]")
           .option("--shell <shell>")
-          .action(async (projectRootArg?: string, opts?: { shell?: string }) => {
+          .option("--json", "Print the full JSON result.")
+          .action(async (projectRootArg?: string, opts?: { shell?: string; json?: boolean }) => {
             const projectRoot = resolveCliProjectRoot(projectRootArg);
             const resolved = await resolveCliConfig(projectRoot);
             const result = await getAutonomousCollectionStatus(resolved, {
               project_root: projectRoot,
               shell: opts?.shell,
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         opensyn
@@ -2305,14 +2343,15 @@ export default {
           .description("Repair OpenSyn runtime and refresh the managed shell hook.")
           .argument("[project_root]")
           .option("--shell <shell>")
-          .action(async (projectRootArg?: string, opts?: { shell?: string }) => {
+          .option("--json", "Print the full JSON result.")
+          .action(async (projectRootArg?: string, opts?: { shell?: string; json?: boolean }) => {
             const projectRoot = resolveCliProjectRoot(projectRootArg);
             const resolved = await resolveCliConfig(projectRoot, true);
             const result = await repairAutonomousCollection(resolved, {
               project_root: projectRoot,
               shell: opts?.shell,
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
       },
       {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opensyn",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "OpenClaw plugin for OpenSyn autonomous local collection, distillation, and host overlay projection.",
   "type": "module",
   "private": false,

package/runtime/opensyn-host-distiller.mjs

@@ -148,12 +148,17 @@ async function main() {
       stdout: result.stdout?.trim() || "",
       stderr: result.stderr?.trim() || "",
     };
+    const computedLastError =
+      result.status && result.status !== 0
+        ? payload.error || payload.stderr || ""
+        : payload.error || "";
     updateState(options.statePath, {
       last_started_at: startedAt,
       last_finished_at: finishedAt,
       last_exit_code: result.status,
       last_signal: result.signal,
-      last_error: payload.error || payload.stderr || "",
+      last_error: computedLastError,
+      last_stderr: payload.stderr,
       last_stdout: payload.stdout,
       last_command: payload.command,
       last_command_args: payload.command_args,