nextclaw 0.3.1 → 0.3.3

package/dist/cli/index.js

@@ -17,6 +17,7 @@ import {
   buildReloadPlan,
   diffConfigPaths,
   getWorkspacePath,
+  expandHome,
   MessageBus,
   AgentLoop,
   LiteLLMProvider,
@@ -26,7 +27,9 @@ import {
   CronService,
   HeartbeatService,
   PROVIDERS,
-  APP_NAME
+  APP_NAME,
+  DEFAULT_WORKSPACE_DIR,
+  DEFAULT_WORKSPACE_PATH
 } from "nextclaw-core";
 import { startUiServer } from "nextclaw-server";
 import {
@@ -39,7 +42,7 @@ import {
   rmSync as rmSync2,
   writeFileSync as writeFileSync2
 } from "fs";
-import { join as join2, resolve as resolve2 } from "path";
+import { dirname, join as join2, resolve as resolve2 } from "path";
 import { spawn as spawn2, spawnSync } from "child_process";
 import { createInterface } from "readline";
 import { fileURLToPath as fileURLToPath2 } from "url";
@@ -80,19 +83,7 @@ async function findAvailablePort(port, host, attempts = 20) {
 }
 async function isPortAvailable(port, host) {
   const checkHost = normalizeHostForPortCheck(host);
-  const hostsToCheck = [checkHost];
-  if (checkHost === "127.0.0.1") {
-    hostsToCheck.push("::1");
-  } else if (checkHost === "::1") {
-    hostsToCheck.push("127.0.0.1");
-  }
-  for (const candidate of hostsToCheck) {
-    const ok = await canBindPort(port, candidate);
-    if (ok) {
-      return true;
-    }
-  }
-  return false;
+  return await canBindPort(port, checkHost);
 }
 async function canBindPort(port, host) {
   return await new Promise((resolve3) => {
@@ -306,21 +297,46 @@ var CliRuntime = class {
     return getPackageVersion();
   }
   async onboard() {
+    console.warn(`Warning: ${APP_NAME} onboard is deprecated. Use "${APP_NAME} init" instead.`);
+    await this.init({ source: "onboard" });
+  }
+  async init(options = {}) {
+    const source = options.source ?? "init";
+    const prefix = options.auto ? "Auto init" : "Init";
     const configPath = getConfigPath();
-    if (existsSync2(configPath)) {
-      console.log(`Config already exists at ${configPath}`);
-    }
-    const config = ConfigSchema.parse({});
-    saveConfig(config);
-    console.log(`\u2713 Created config at ${configPath}`);
-    const workspace = getWorkspacePath();
-    console.log(`\u2713 Created workspace at ${workspace}`);
-    this.createWorkspaceTemplates(workspace);
-    console.log(`
-${this.logo} ${APP_NAME} is ready!`);
-    console.log("\nNext steps:");
-    console.log(`  1. Add your API key to ${configPath}`);
-    console.log(`  2. Chat: ${APP_NAME} agent -m "Hello!"`);
+    let createdConfig = false;
+    if (!existsSync2(configPath)) {
+      const config2 = ConfigSchema.parse({});
+      saveConfig(config2);
+      createdConfig = true;
+    }
+    const config = loadConfig();
+    const workspaceSetting = config.agents.defaults.workspace;
+    const workspacePath = !workspaceSetting || workspaceSetting === DEFAULT_WORKSPACE_PATH ? join2(getDataDir2(), DEFAULT_WORKSPACE_DIR) : expandHome(workspaceSetting);
+    const workspaceExisted = existsSync2(workspacePath);
+    mkdirSync2(workspacePath, { recursive: true });
+    const templateResult = this.createWorkspaceTemplates(workspacePath);
+    if (createdConfig) {
+      console.log(`\u2713 ${prefix}: created config at ${configPath}`);
+    }
+    if (!workspaceExisted) {
+      console.log(`\u2713 ${prefix}: created workspace at ${workspacePath}`);
+    }
+    for (const file of templateResult.created) {
+      console.log(`\u2713 ${prefix}: created ${file}`);
+    }
+    if (!createdConfig && workspaceExisted && templateResult.created.length === 0) {
+      console.log(`${prefix}: already initialized.`);
+    }
+    if (!options.auto) {
+      console.log(`
+${this.logo} ${APP_NAME} is ready! (${source})`);
+      console.log("\nNext steps:");
+      console.log(`  1. Add your API key to ${configPath}`);
+      console.log(`  2. Chat: ${APP_NAME} agent -m "Hello!"`);
+    } else {
+      console.log(`Tip: Run "${APP_NAME} init" to re-run initialization if needed.`);
+    }
   }
   async gateway(opts) {
     const uiOverrides = {};
@@ -352,6 +368,7 @@ ${this.logo} ${APP_NAME} is ready!`);
     await this.startGateway({ uiOverrides, allowMissingProvider: true });
   }
   async start(opts) {
+    await this.init({ source: "start", auto: true });
     const uiOverrides = {
       enabled: true,
       open: false
@@ -942,44 +959,55 @@ ${this.logo} ${APP_NAME} is ready!`);
     });
   }
   createWorkspaceTemplates(workspace) {
-    const templates = {
-      "AGENTS.md": "# Agent Instructions\n\nYou are a helpful AI assistant. Be concise, accurate, and friendly.\n\n## Guidelines\n\n- Always explain what you're doing before taking actions\n- Ask for clarification when the request is ambiguous\n- Use tools to help accomplish tasks\n- Remember important information in your memory files\n",
-      "SOUL.md": `# Soul
-
-I am ${APP_NAME}, a lightweight AI assistant.
-
-## Personality
-
-- Helpful and friendly
-- Concise and to the point
-- Curious and eager to learn
-
-## Values
-
-- Accuracy over speed
-- User privacy and safety
-- Transparency in actions
-
-`,
-      "USER.md": "# User\n\nInformation about the user goes here.\n\n## Preferences\n\n- Communication style: (casual/formal)\n- Timezone: (your timezone)\n- Language: (your preferred language)\n"
-    };
-    for (const [filename, content] of Object.entries(templates)) {
-      const filePath = join2(workspace, filename);
-      if (!existsSync2(filePath)) {
-        writeFileSync2(filePath, content);
-      }
+    const created = [];
+    const templateDir = this.resolveTemplateDir();
+    if (!templateDir) {
+      console.warn("Warning: Template directory not found. Skipping workspace templates.");
+      return { created };
     }
-    const memoryDir = join2(workspace, "memory");
-    mkdirSync2(memoryDir, { recursive: true });
-    const memoryFile = join2(memoryDir, "MEMORY.md");
-    if (!existsSync2(memoryFile)) {
-      writeFileSync2(
-        memoryFile,
-        "# Long-term Memory\n\nThis file stores important information that should persist across sessions.\n\n## User Information\n\n(Important facts about the user)\n\n## Preferences\n\n(User preferences learned over time)\n\n## Important Notes\n\n(Things to remember)\n"
-      );
+    const templateFiles = [
+      { source: "AGENTS.md", target: "AGENTS.md" },
+      { source: "SOUL.md", target: "SOUL.md" },
+      { source: "USER.md", target: "USER.md" },
+      { source: join2("memory", "MEMORY.md"), target: join2("memory", "MEMORY.md") }
+    ];
+    for (const entry of templateFiles) {
+      const filePath = join2(workspace, entry.target);
+      if (existsSync2(filePath)) {
+        continue;
+      }
+      const templatePath = join2(templateDir, entry.source);
+      if (!existsSync2(templatePath)) {
+        console.warn(`Warning: Template file missing: ${templatePath}`);
+        continue;
+      }
+      const raw = readFileSync2(templatePath, "utf-8");
+      const content = raw.replace(/\$\{APP_NAME\}/g, APP_NAME);
+      mkdirSync2(dirname(filePath), { recursive: true });
+      writeFileSync2(filePath, content);
+      created.push(entry.target);
     }
     const skillsDir = join2(workspace, "skills");
-    mkdirSync2(skillsDir, { recursive: true });
+    if (!existsSync2(skillsDir)) {
+      mkdirSync2(skillsDir, { recursive: true });
+      created.push(join2("skills", ""));
+    }
+    return { created };
+  }
+  resolveTemplateDir() {
+    const override = process.env.NEXTCLAW_TEMPLATE_DIR?.trim();
+    if (override) {
+      return override;
+    }
+    const cliDir = resolve2(fileURLToPath2(new URL(".", import.meta.url)));
+    const pkgRoot = resolve2(cliDir, "..", "..");
+    const candidates = [join2(pkgRoot, "templates")];
+    for (const candidate of candidates) {
+      if (existsSync2(candidate)) {
+        return candidate;
+      }
+    }
+    return null;
   }
   getBridgeDir() {
     const userBridge = join2(getDataDir2(), "bridge");
@@ -1039,6 +1067,7 @@ var program = new Command();
 var runtime = new CliRuntime({ logo: LOGO });
 program.name(APP_NAME2).description(`${LOGO} ${APP_NAME2} - ${APP_TAGLINE}`).version(getPackageVersion(), "-v, --version", "show version");
 program.command("onboard").description(`Initialize ${APP_NAME2} configuration and workspace`).action(async () => runtime.onboard());
+program.command("init").description(`Initialize ${APP_NAME2} configuration and workspace`).action(async () => runtime.init());
 program.command("gateway").description(`Start the ${APP_NAME2} gateway`).option("-p, --port <port>", "Gateway port", "18790").option("-v, --verbose", "Verbose output", false).option("--ui", "Enable UI server", false).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI port").option("--ui-open", "Open browser when UI starts", false).action(async (opts) => runtime.gateway(opts));
 program.command("ui").description(`Start the ${APP_NAME2} UI with gateway`).option("--host <host>", "UI host").option("--port <port>", "UI port").option("--no-open", "Disable opening browser").action(async (opts) => runtime.ui(opts));
 program.command("start").description(`Start the ${APP_NAME2} gateway + UI in the background`).option("--ui-host <host>", "UI host").option("--ui-port <port>", "UI port").option("--frontend", "Start UI frontend dev server").option("--frontend-port <port>", "UI frontend dev server port").option("--open", "Open browser after start", false).action(async (opts) => runtime.start(opts));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nextclaw",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Lightweight personal AI assistant with CLI, multi-provider routing, and channel integrations.",
   "private": false,
   "type": "module",
@@ -32,7 +32,8 @@
   "files": [
     "dist",
     "bridge",
-    "ui-dist"
+    "ui-dist",
+    "templates"
   ],
   "dependencies": {
     "chokidar": "^3.6.0",

package/templates/AGENTS.md

@@ -0,0 +1,10 @@
+# Agent Instructions
+
+You are a helpful AI assistant. Be concise, accurate, and friendly.
+
+## Guidelines
+
+- Always explain what you're doing before taking actions
+- Ask for clarification when the request is ambiguous
+- Use tools to help accomplish tasks
+- Remember important information in your memory files

package/templates/SOUL.md

@@ -0,0 +1,15 @@
+# Soul
+
+I am ${APP_NAME}, a lightweight AI assistant.
+
+## Personality
+
+- Helpful and friendly
+- Concise and to the point
+- Curious and eager to learn
+
+## Values
+
+- Accuracy over speed
+- User privacy and safety
+- Transparency in actions

package/templates/USER.md

@@ -0,0 +1,9 @@
+# User
+
+Information about the user goes here.
+
+## Preferences
+
+- Communication style: (casual/formal)
+- Timezone: (your timezone)
+- Language: (your preferred language)

package/templates/memory/MEMORY.md

@@ -0,0 +1,15 @@
+# Long-term Memory
+
+This file stores important information that should persist across sessions.
+
+## User Information
+
+(Important facts about the user)
+
+## Preferences
+
+(User preferences learned over time)
+
+## Important Notes
+
+(Things to remember)