opensyn 0.1.0 → 0.1.1

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

@@ -1585,6 +1585,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 +2097,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 +2154,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 +2163,7 @@ export default {
               shell: opts?.shell,
               updated_by: "openclaw_cli",
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         program
@@ -2152,7 +2173,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 +2182,7 @@ export default {
               shell: opts?.shell,
               updated_by: "openclaw_cli",
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         program
@@ -2170,14 +2192,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 +2210,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 +2228,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 +2249,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 +2269,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 +2278,7 @@ export default {
               shell: opts?.shell,
               updated_by: "openclaw_cli",
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         opensyn
@@ -2259,7 +2286,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 +2295,7 @@ export default {
               shell: opts?.shell,
               updated_by: "openclaw_cli",
             });
-            printCliResult(result);
+            printCliResult(result, opts?.json);
           });
 
         opensyn
@@ -2275,14 +2303,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 +2319,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 +2335,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.1",
   "description": "OpenClaw plugin for OpenSyn autonomous local collection, distillation, and host overlay projection.",
   "type": "module",
   "private": false,