@joshski/dust 0.1.4 → 0.1.6

package/dist/dust.js

@@ -27,22 +27,22 @@ var AGENT_SUBCOMMANDS = [
   "help"
 ];
 function generateAgentGreeting(settings) {
-  return loadTemplate("agent-greeting", { bin: settings.binaryPath });
+  return loadTemplate("agent-greeting", { bin: settings.dustCommand });
 }
 function generateWorkInstructions(settings) {
-  return loadTemplate("agent-work", { bin: settings.binaryPath });
+  return loadTemplate("agent-work", { bin: settings.dustCommand });
 }
 function generateTasksInstructions(settings) {
-  return loadTemplate("agent-tasks", { bin: settings.binaryPath });
+  return loadTemplate("agent-tasks", { bin: settings.dustCommand });
 }
 function generateGoalsInstructions(settings) {
-  return loadTemplate("agent-goals", { bin: settings.binaryPath });
+  return loadTemplate("agent-goals", { bin: settings.dustCommand });
 }
 function generateIdeasInstructions(settings) {
-  return loadTemplate("agent-ideas", { bin: settings.binaryPath });
+  return loadTemplate("agent-ideas", { bin: settings.dustCommand });
 }
 function generateAgentHelp(settings) {
-  return loadTemplate("agent-help", { bin: settings.binaryPath });
+  return loadTemplate("agent-help", { bin: settings.dustCommand });
 }
 async function agent(ctx, args, settings) {
   const subcommand = args[0];
@@ -278,6 +278,54 @@ async function check(ctx, fs, _args, runner = defaultProcessRunner, glob) {
   return { exitCode };
 }
 
+// lib/cli/settings.ts
+import { join as join2 } from "node:path";
+var DEFAULT_SETTINGS = {
+  dustCommand: "npx dust"
+};
+function detectDustCommand(cwd, fs) {
+  if (fs.exists(join2(cwd, "bun.lockb"))) {
+    return "bunx dust";
+  }
+  if (fs.exists(join2(cwd, "pnpm-lock.yaml"))) {
+    return "pnpx dust";
+  }
+  if (fs.exists(join2(cwd, "package-lock.json"))) {
+    return "npx dust";
+  }
+  if (process.env.BUN_INSTALL) {
+    return "bunx dust";
+  }
+  return "npx dust";
+}
+async function loadSettings(cwd, fs) {
+  const settingsPath = join2(cwd, ".dust", "config", "settings.json");
+  if (!fs.exists(settingsPath)) {
+    return {
+      dustCommand: detectDustCommand(cwd, fs)
+    };
+  }
+  try {
+    const content = await fs.readFile(settingsPath);
+    const parsed = JSON.parse(content);
+    if (!parsed.dustCommand) {
+      return {
+        ...DEFAULT_SETTINGS,
+        ...parsed,
+        dustCommand: detectDustCommand(cwd, fs)
+      };
+    }
+    return {
+      ...DEFAULT_SETTINGS,
+      ...parsed
+    };
+  } catch {
+    return {
+      dustCommand: detectDustCommand(cwd, fs)
+    };
+  }
+}
+
 // lib/cli/init.ts
 var DUST_DIRECTORIES = ["goals", "ideas", "tasks", "facts"];
 var DEFAULT_GOAL = `# Project Goal
@@ -286,18 +334,36 @@ Describe the high-level mission of this project.
 `;
 async function init(ctx, fs, _args) {
   const dustPath = `${ctx.cwd}/.dust`;
+  const dustCommand = detectDustCommand(ctx.cwd, fs);
+  const agentInstruction = `Always immediately run \`${dustCommand} agent\` when you start working in this repository.`;
   if (fs.exists(dustPath)) {
-    ctx.stderr("Error: .dust directory already exists");
-    return { exitCode: 1 };
-  }
-  await fs.mkdir(dustPath, { recursive: true });
-  for (const dir of DUST_DIRECTORIES) {
-    await fs.mkdir(`${dustPath}/${dir}`, { recursive: true });
+    ctx.stdout("Note: .dust directory already exists, skipping creation");
+  } else {
+    await fs.mkdir(dustPath, { recursive: true });
+    for (const dir of DUST_DIRECTORIES) {
+      await fs.mkdir(`${dustPath}/${dir}`, { recursive: true });
+    }
+    await fs.writeFile(`${dustPath}/goals/project-goal.md`, DEFAULT_GOAL);
+    ctx.stdout("Initialized Dust repository in .dust/");
+    ctx.stdout(`Created directories: ${DUST_DIRECTORIES.join(", ")}`);
+    ctx.stdout("Created initial goal: .dust/goals/project-goal.md");
+  }
+  const claudeMdPath = `${ctx.cwd}/CLAUDE.md`;
+  if (fs.exists(claudeMdPath)) {
+    ctx.stdout(`Warning: CLAUDE.md already exists. Consider adding: "${agentInstruction}"`);
+  } else {
+    const claudeContent = loadTemplate("claude-md", { dustCommand });
+    await fs.writeFile(claudeMdPath, claudeContent);
+    ctx.stdout("Created CLAUDE.md with agent instructions");
+  }
+  const agentsMdPath = `${ctx.cwd}/AGENTS.md`;
+  if (fs.exists(agentsMdPath)) {
+    ctx.stdout(`Warning: AGENTS.md already exists. Consider adding: "${agentInstruction}"`);
+  } else {
+    const agentsContent = loadTemplate("agents-md", { dustCommand });
+    await fs.writeFile(agentsMdPath, agentsContent);
+    ctx.stdout("Created AGENTS.md with agent instructions");
   }
-  await fs.writeFile(`${dustPath}/goals/project-goal.md`, DEFAULT_GOAL);
-  ctx.stdout("Initialized Dust repository in .dust/");
-  ctx.stdout(`Created directories: ${DUST_DIRECTORIES.join(", ")}`);
-  ctx.stdout("Created initial goal: .dust/goals/project-goal.md");
   return { exitCode: 0 };
 }
 
@@ -442,28 +508,6 @@ async function prompt(ctx, fs, args) {
   return { exitCode: 0 };
 }
 
-// lib/cli/settings.ts
-import { join as join2 } from "node:path";
-var DEFAULT_SETTINGS = {
-  binaryPath: "dust"
-};
-async function loadSettings(cwd, fs) {
-  const settingsPath = join2(cwd, ".dust", "config", "settings.json");
-  if (!fs.exists(settingsPath)) {
-    return DEFAULT_SETTINGS;
-  }
-  try {
-    const content = await fs.readFile(settingsPath);
-    const parsed = JSON.parse(content);
-    return {
-      ...DEFAULT_SETTINGS,
-      ...parsed
-    };
-  } catch {
-    return DEFAULT_SETTINGS;
-  }
-}
-
 // lib/cli/main.ts
 var COMMANDS = [
   "init",
@@ -476,9 +520,9 @@ var COMMANDS = [
   "help"
 ];
 function generateHelpText(settings) {
-  return loadTemplate("help", { bin: settings.binaryPath });
+  return loadTemplate("help", { bin: settings.dustCommand });
 }
-var HELP_TEXT = generateHelpText({ binaryPath: "dust" });
+var HELP_TEXT = generateHelpText({ dustCommand: "dust" });
 function isHelpRequest(command) {
   return !command || command === "help" || command === "--help" || command === "-h";
 }
@@ -518,7 +562,7 @@ async function main(options) {
   }
   if (!isValidCommand(command)) {
     ctx.stderr(`Unknown command: ${command}`);
-    ctx.stderr(`Run '${settings.binaryPath} help' for available commands`);
+    ctx.stderr(`Run '${settings.dustCommand} help' for available commands`);
     return { exitCode: 1 };
   }
   return runCommand(command, commandArgs, ctx, fs, glob, settings);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joshski/dust",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "A lightweight planning system for human-AI collaboration",
   "type": "module",
   "bin": {

package/templates/agents-md.txt

@@ -0,0 +1,5 @@
+# Agent Instructions
+
+This project uses [dust](https://github.com/joshski/dust) for planning and documentation.
+
+Always immediately run `{{dustCommand}} agent` when you start working in this repository.

package/templates/claude-md.txt

@@ -0,0 +1,5 @@
+# Claude Code Instructions
+
+This project uses [dust](https://github.com/joshski/dust) for planning and documentation.
+
+Always immediately run `{{dustCommand}} agent` when you start working in this repository.