@clawtrail/init 2.4.0 → 2.5.0

package/dist/index.js

@@ -97,6 +97,72 @@ async function downloadSkillFiles(targetDir, staging = false) {
   }
   return { succeeded, failed };
 }
+async function installContextGraph(staging, agentId, apiKey) {
+  const spinner = ora("Installing context-graph packages...").start();
+  try {
+    execSync(
+      "npm install -g @clawtrail/context-graph @clawtrail/context-graph-openclaw",
+      { stdio: "pipe", timeout: 12e4 }
+    );
+  } catch (err) {
+    try {
+      execSync(
+        "npm install @clawtrail/context-graph @clawtrail/context-graph-openclaw",
+        { stdio: "pipe", timeout: 12e4 }
+      );
+    } catch {
+      spinner.warn(
+        chalk.yellow(
+          "Could not install context-graph packages \u2014 install manually:\n  npm install @clawtrail/context-graph @clawtrail/context-graph-openclaw"
+        )
+      );
+      return { installed: false, configPath: null, error: err.message };
+    }
+  }
+  const openclawDir = path.join(os.homedir(), ".openclaw");
+  const pluginDir = path.join(openclawDir, "plugins", "context-graph");
+  await ensureDirectory(pluginDir);
+  const apiUrl = staging ? "https://sapi.clawtrail.ai/ct/api" : "https://api.clawtrail.ai/ct/api";
+  const cgConfig = {
+    submitUrl: `${apiUrl}/context-graph/submit`,
+    agentId: agentId || null,
+    apiKey: apiKey || null,
+    autoSubmit: true,
+    environment: staging ? "staging" : "production"
+  };
+  const configPath = path.join(pluginDir, "config.json");
+  await fs.writeFile(configPath, JSON.stringify(cgConfig, null, 2), "utf-8");
+  const openclawConfigPath = path.join(openclawDir, "openclaw.json");
+  try {
+    let config = {};
+    try {
+      const existing = await fs.readFile(openclawConfigPath, "utf-8");
+      config = JSON5.parse(existing);
+    } catch {
+    }
+    config.plugins ??= {};
+    config.plugins["context-graph"] = {
+      enabled: true,
+      configPath: "~/.openclaw/plugins/context-graph/config.json",
+      autoSubmit: true
+    };
+    await fs.writeFile(
+      openclawConfigPath,
+      JSON.stringify(config, null, 2),
+      "utf-8"
+    );
+  } catch {
+  }
+  spinner.succeed(
+    chalk.green(
+      `Context-graph installed \u2192 auto-submit to ${staging ? "staging" : "production"}`
+    )
+  );
+  return {
+    installed: true,
+    configPath: "~/.openclaw/plugins/context-graph/config.json"
+  };
+}
 async function configureOpenClaw(staging, apiKey) {
   const openClawDir = path.join(os.homedir(), ".openclaw");
   const configPath = path.join(openClawDir, "openclaw.json");
@@ -117,7 +183,7 @@ async function configureOpenClaw(staging, apiKey) {
   config.agents ??= {};
   config.agents.defaults ??= {};
   config.agents.defaults.heartbeat = {
-    every: "5m",
+    every: "30m",
     target: "last"
   };
   config.skills ??= {};
@@ -132,7 +198,7 @@ async function configureOpenClaw(staging, apiKey) {
   await fs.writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
   return {
     configPath: "~/.openclaw/openclaw.json",
-    heartbeat: "every 5m",
+    heartbeat: "every 30m",
     hasApiKey: !!apiKey
   };
 }
@@ -280,6 +346,26 @@ async function handleUninstall(staging) {
   } else {
     spinner1.info(chalk.gray("No skill files found to remove"));
   }
+  const spinner2a = ora("Removing context-graph...").start();
+  let cgRemoved = false;
+  try {
+    const cgPluginDir = path.join(openclawDir, "plugins", "context-graph");
+    await fs.rm(cgPluginDir, { recursive: true, force: true });
+    cgRemoved = true;
+  } catch {
+  }
+  try {
+    execSync(
+      "npm uninstall -g @clawtrail/context-graph @clawtrail/context-graph-openclaw",
+      { stdio: "pipe", timeout: 3e4 }
+    );
+  } catch {
+  }
+  if (cgRemoved) {
+    spinner2a.succeed(chalk.green("Removed context-graph plugin"));
+  } else {
+    spinner2a.info(chalk.gray("No context-graph plugin found"));
+  }
   const spinner2 = ora("Cleaning OpenClaw config...").start();
   const configPath = path.join(openclawDir, "openclaw.json");
   let configCleaned = false;
@@ -288,22 +374,31 @@ async function handleUninstall(staging) {
     const config = JSON5.parse(raw);
     if (config.agents?.defaults?.heartbeat) {
       delete config.agents.defaults.heartbeat;
-      if (Object.keys(config.agents.defaults).length === 0) delete config.agents.defaults;
+      if (Object.keys(config.agents.defaults).length === 0)
+        delete config.agents.defaults;
       if (Object.keys(config.agents).length === 0) delete config.agents;
     }
     if (config.skills?.entries?.clawtrail) {
       delete config.skills.entries.clawtrail;
-      if (Object.keys(config.skills.entries).length === 0) delete config.skills.entries;
+      if (Object.keys(config.skills.entries).length === 0)
+        delete config.skills.entries;
       if (Object.keys(config.skills).length === 0) delete config.skills;
     }
     if (config.skills?.entries?.["clawtrail-staging"]) {
       delete config.skills.entries["clawtrail-staging"];
-      if (Object.keys(config.skills.entries).length === 0) delete config.skills.entries;
+      if (Object.keys(config.skills.entries).length === 0)
+        delete config.skills.entries;
       if (Object.keys(config.skills).length === 0) delete config.skills;
     }
+    if (config.plugins?.["context-graph"]) {
+      delete config.plugins["context-graph"];
+      if (Object.keys(config.plugins).length === 0) delete config.plugins;
+    }
     await fs.writeFile(configPath, JSON.stringify(config, null, 2), "utf-8");
     configCleaned = true;
-    spinner2.succeed(chalk.green("Removed ClawTrail config from openclaw.json"));
+    spinner2.succeed(
+      chalk.green("Removed ClawTrail config from openclaw.json")
+    );
   } catch {
     spinner2.info(chalk.gray("No openclaw.json found or nothing to clean"));
   }
@@ -332,7 +427,9 @@ async function handleUninstall(staging) {
           chalk.green(`Gateway restarted \u2014 ${cleared} cached sessions cleared`)
         );
       } else {
-        spinner3.warn(chalk.yellow("Gateway killed but may not have restarted"));
+        spinner3.warn(
+          chalk.yellow("Gateway killed but may not have restarted")
+        );
       }
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
@@ -345,11 +442,20 @@ async function handleUninstall(staging) {
       console.log(chalk.white("  Removed:  ") + chalk.red(f));
     }
   }
+  if (cgRemoved) {
+    console.log(
+      chalk.white("  Removed:  ") + chalk.red("~/.openclaw/plugins/context-graph/")
+    );
+  }
   if (configCleaned) {
-    console.log(chalk.white("  Config:   ") + chalk.green("cleaned ~/.openclaw/openclaw.json"));
+    console.log(
+      chalk.white("  Config:   ") + chalk.green("cleaned ~/.openclaw/openclaw.json")
+    );
   }
   if (gatewayRestarted) {
-    console.log(chalk.white("  Gateway:  ") + chalk.green("restarted (ClawTrail skill removed)"));
+    console.log(
+      chalk.white("  Gateway:  ") + chalk.green("restarted (ClawTrail skill removed)")
+    );
   }
   console.log(chalk.yellow("\n  ClawTrail has been uninstalled.\n"));
   console.log(
@@ -361,7 +467,7 @@ async function main() {
   const program = new Command();
   program.name("clawtrail-init").description(
     "Install ClawTrail skill files, configure heartbeat, and optionally register an agent"
-  ).version("2.4.0").option(
+  ).version("2.5.0").option(
     "-d, --dir <path>",
     "Download directory for skill files",
     "./clawtrail-skills"
@@ -378,7 +484,13 @@ async function main() {
   ).option(
     "--api-key <key>",
     "Existing API key (skip registration, just configure)"
-  ).option("--no-restart", "Skip gateway restart after updating files").option("--uninstall", "Remove ClawTrail skill files, config, and restart gateway").action(async (options) => {
+  ).option("--no-restart", "Skip gateway restart after updating files").option(
+    "--no-context-graph",
+    "Skip context-graph provenance tracking installation"
+  ).option(
+    "--uninstall",
+    "Remove ClawTrail skill files, config, and restart gateway"
+  ).action(async (options) => {
     if (options.uninstall) {
       await handleUninstall(options.staging);
       return;
@@ -418,7 +530,9 @@ async function main() {
       const failedFiles = downloads.filter((_, i) => results[i]?.status === "rejected").map((d) => path.basename(d.dest));
       if (placedFiles.length === 0) {
         spinner.fail(
-          chalk.red("Failed to download skill files \u2014 check your internet connection")
+          chalk.red(
+            "Failed to download skill files \u2014 check your internet connection"
+          )
         );
         throw new Error("All downloads failed");
       } else if (failedFiles.length > 0) {
@@ -429,7 +543,9 @@ async function main() {
         );
       } else {
         spinner.succeed(
-          chalk.green(`Downloaded ${placedFiles.length} skill files directly to OpenClaw (${env})`)
+          chalk.green(
+            `Downloaded ${placedFiles.length} skill files directly to OpenClaw (${env})`
+          )
         );
       }
       targetDir = path.join(openclawDir, "skills", skillFolder);
@@ -472,12 +588,24 @@ async function main() {
       try {
         ocConfig = await configureOpenClaw(staging, apiKey);
         spinner.succeed(
-          chalk.green(`Heartbeat configured: ${chalk.cyan("every 5m")}`)
+          chalk.green(`Heartbeat configured: ${chalk.cyan("every 30m")}`)
         );
       } catch (err) {
         spinner.warn(chalk.yellow(`Config failed: ${err.message}`));
       }
     }
+    let cgResult;
+    if (options.contextGraph !== false) {
+      try {
+        cgResult = await installContextGraph(staging, agentId, apiKey);
+      } catch (err) {
+        console.log(
+          chalk.yellow(
+            `  Context-graph setup skipped: ${err.message}`
+          )
+        );
+      }
+    }
     let gatewayRestarted = false;
     if (hasOpenClaw && options.restart !== false) {
       const newHeartbeatVersion = getHeartbeatVersion(heartbeatPath);
@@ -541,6 +669,20 @@ CLAWTRAIL_API_KEY=${apiKey}
         chalk.gray("                (save this \u2014 shown only once)")
       );
     }
+    if (cgResult?.installed) {
+      console.log(
+        chalk.white("  Provenance:   ") + chalk.green("context-graph installed (auto-submit enabled)")
+      );
+      if (cgResult.configPath) {
+        console.log(
+          chalk.white("  CG config:   ") + chalk.cyan(cgResult.configPath)
+        );
+      }
+    } else if (options.contextGraph === false) {
+      console.log(
+        chalk.white("  Provenance:   ") + chalk.gray("skipped (--no-context-graph)")
+      );
+    }
     if (gatewayRestarted) {
       console.log(
         chalk.white("  Gateway:      ") + chalk.green("restarted (sessions cleared, new heartbeat active)")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clawtrail/init",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "CLI installer for ClawTrail AI agent skill files",
   "main": "dist/index.js",
   "bin": {