@joshski/dust 0.1.62 → 0.1.64

package/dist/dust.js

@@ -3,14 +3,14 @@ import { createRequire } from "node:module";
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // lib/cli/run.ts
-import { existsSync, statSync as statSync2 } from "node:fs";
+import { existsSync, statSync as statSync3 } from "node:fs";
 import {
-  chmod as chmod2,
-  mkdir as mkdir2,
-  readdir as readdir2,
-  readFile as readFile2,
+  chmod as chmod3,
+  mkdir as mkdir3,
+  readdir as readdir3,
+  readFile as readFile3,
   rename,
-  writeFile as writeFile2
+  writeFile as writeFile3
 } from "node:fs/promises";
 
 // lib/git/file-sorter.ts
@@ -274,6 +274,9 @@ async function loadSettings(cwd, fileSystem) {
   }
 }
 
+// lib/version.ts
+var DUST_VERSION = "0.1.64";
+
 // lib/cli/dedent.ts
 function dedent(strings, ...values) {
   const result = strings.reduce((acc, part, index) => acc + part + (values[index] ?? ""), "");
@@ -902,6 +905,16 @@ function loadStockAudits() {
   });
 }
 
+// lib/audits/index.ts
+function transformAuditContent(content) {
+  const titleMatch = content.match(/^#\s+(.+)$/m);
+  if (!titleMatch) {
+    return content;
+  }
+  const originalTitle = titleMatch[1];
+  return content.replace(/^#\s+.+$/m, `# Audit: ${originalTitle}`);
+}
+
 // lib/cli/colors.ts
 var ANSI_COLORS = {
   reset: "\x1B[0m",
@@ -936,14 +949,6 @@ function getColors() {
 }
 
 // lib/cli/commands/audit.ts
-function transformAuditContent(content) {
-  const titleMatch = content.match(/^#\s+(.+)$/m);
-  if (!titleMatch) {
-    return content;
-  }
-  const originalTitle = titleMatch[1];
-  return content.replace(/^#\s+.+$/m, `# Audit: ${originalTitle}`);
-}
 async function addAudit(auditName, dependencies) {
   const { context, fileSystem, settings } = dependencies;
   const dustPath = `${context.cwd}/.dust`;
@@ -1029,12 +1034,10 @@ async function audit(dependencies) {
 }
 
 // lib/cli/commands/bucket.ts
-import { spawn as nodeSpawn3 } from "node:child_process";
+import { spawn as nodeSpawn4 } from "node:child_process";
 import { accessSync, statSync } from "node:fs";
 import { chmod, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
-import { createServer as httpCreateServer } from "node:http";
 import { homedir } from "node:os";
-import { join as join9 } from "node:path";
 
 // lib/bucket/auth.ts
 import { join as join4 } from "node:path";
@@ -1152,6 +1155,40 @@ async function authenticate(authDeps) {
   });
 }
 
+// lib/bucket/auth-server.ts
+import { spawn as nodeSpawn } from "node:child_process";
+import { createServer as httpCreateServer } from "node:http";
+function createLocalServer(handler) {
+  let resolvedPort = 0;
+  const server = httpCreateServer(async (nodeRequest, nodeResponse) => {
+    const url = new URL(nodeRequest.url ?? "/", `http://localhost:${resolvedPort}`);
+    const request = new Request(url.toString(), {
+      method: nodeRequest.method ?? "GET"
+    });
+    const response = handler(request);
+    const body = await response.text();
+    nodeResponse.writeHead(response.status, {
+      "Content-Type": response.headers.get("content-type") ?? "text/plain"
+    });
+    nodeResponse.end(body);
+  });
+  server.listen(0, () => {
+    const addr2 = server.address();
+    if (addr2 && typeof addr2 === "object") {
+      resolvedPort = addr2.port;
+    }
+  });
+  const addr = server.address();
+  if (addr && typeof addr === "object") {
+    resolvedPort = addr.port;
+  }
+  return { port: resolvedPort, stop: () => server.close() };
+}
+function openBrowser(url) {
+  const cmd = process.platform === "darwin" ? "open" : "xdg-open";
+  nodeSpawn(cmd, [url], { stdio: "ignore", detached: true }).unref();
+}
+
 // lib/bucket/events.ts
 var WS_OPEN = 1;
 function formatBucketEvent(event) {
@@ -1202,14 +1239,20 @@ function getLogLines(buffer) {
   return buffer.lines;
 }
 
+// lib/bucket/paths.ts
+import { join as join5 } from "node:path";
+function getReposDir(env, homeDir) {
+  return env.DUST_REPOS_DIR || join5(homeDir, ".dust", "repos");
+}
+
 // lib/bucket/repository.ts
-import { dirname as dirname3, join as join8 } from "node:path";
+import { dirname as dirname2 } from "node:path";
 
 // lib/claude/spawn-claude-code.ts
-import { spawn as nodeSpawn } from "node:child_process";
+import { spawn as nodeSpawn2 } from "node:child_process";
 import { createInterface as nodeCreateInterface } from "node:readline";
 var defaultDependencies = {
-  spawn: nodeSpawn,
+  spawn: nodeSpawn2,
   createInterface: nodeCreateInterface
 };
 async function* spawnClaudeCode(prompt, options = {}, dependencies = defaultDependencies) {
@@ -1622,7 +1665,7 @@ async function run(prompt, options = {}, dependencies = defaultRunnerDependencie
 }
 
 // lib/logging/index.ts
-import { join as join5 } from "node:path";
+import { join as join6 } from "node:path";
 
 // lib/logging/match.ts
 function parsePatterns(debug) {
@@ -1706,8 +1749,8 @@ function createLoggingService() {
   return {
     enableFileLogs(scope, sinkForTesting) {
       const existing = process.env[DUST_LOG_FILE];
-      const logDir = process.env.DUST_LOG_DIR ?? join5(process.cwd(), "log");
-      const path = existing ?? join5(logDir, `${scope}.log`);
+      const logDir = process.env.DUST_LOG_DIR ?? join6(process.cwd(), "log");
+      const path = existing ?? join6(logDir, `${scope}.log`);
       if (!existing) {
         process.env[DUST_LOG_FILE] = path;
       }
@@ -1747,10 +1790,10 @@ var createLogger = defaultService.createLogger.bind(defaultService);
 var isEnabled = defaultService.isEnabled.bind(defaultService);
 
 // lib/bucket/repository-git.ts
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 function getRepoPath(repoName, reposDir) {
   const safeName = repoName.replace(/[^a-zA-Z0-9-_/]/g, "-");
-  return join6(reposDir, safeName);
+  return join7(reposDir, safeName);
 }
 async function cloneRepository(repository, targetPath, spawn, context) {
   return new Promise((resolve) => {
@@ -1817,11 +1860,8 @@ function formatAgentEvent(event) {
 }
 
 // lib/cli/commands/loop.ts
-import { spawn as nodeSpawn2 } from "node:child_process";
-import { readFileSync } from "node:fs";
+import { spawn as nodeSpawn3 } from "node:child_process";
 import os from "node:os";
-import { dirname as dirname2, join as join7 } from "node:path";
-import { fileURLToPath } from "node:url";
 
 // lib/artifacts/workflow-tasks.ts
 var IDEA_TRANSITION_PREFIXES = [
@@ -1970,26 +2010,12 @@ async function next(dependencies) {
 }
 
 // lib/cli/commands/loop.ts
-var __dirname2 = dirname2(fileURLToPath(import.meta.url));
-function getDustVersion() {
-  const candidates = [
-    join7(__dirname2, "../../../package.json"),
-    join7(__dirname2, "../package.json")
-  ];
-  for (const candidate of candidates) {
-    try {
-      const packageJson = JSON.parse(readFileSync(candidate, "utf-8"));
-      return packageJson.version ?? "unknown";
-    } catch {}
-  }
-  return "unknown";
-}
 function getEnvironmentContext(cwd) {
   return {
     machineName: os.hostname(),
     cwd,
     platform: `${os.platform()} ${os.release()}`,
-    dustVersion: getDustVersion(),
+    dustVersion: DUST_VERSION,
     runtimeVersion: process.version
   };
 }
@@ -2018,19 +2044,21 @@ function formatLoopEvent(event) {
       return `\uD83C\uDFC1 Reached max iterations (${event.maxIterations}). Exiting.`;
   }
 }
-async function defaultPostEvent(url, payload) {
-  await fetch(url, {
-    method: "POST",
-    headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(payload)
-  });
+function createPostEvent(fetchFn) {
+  return async (url, payload) => {
+    await fetchFn(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(payload)
+    });
+  };
 }
 function createDefaultDependencies() {
   return {
-    spawn: nodeSpawn2,
+    spawn: nodeSpawn3,
     run,
     sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
-    postEvent: defaultPostEvent
+    postEvent: createPostEvent(fetch)
   };
 }
 function createWireEventSender(eventsUrl, sessionId, postEvent, onError, getAgentSessionId, repository = "") {
@@ -2098,7 +2126,20 @@ async function runOneIteration(dependencies, loopDependencies, onLoopEvent, onAg
   const { context } = dependencies;
   const { spawn, run: run2 } = loopDependencies;
   const agentName = loopDependencies.agentType === "codex" ? "Codex" : "Claude";
-  const { onRawEvent, hooksInstalled = false, signal } = options;
+  const {
+    onRawEvent,
+    hooksInstalled = false,
+    signal,
+    logger = log,
+    repositoryId
+  } = options;
+  const baseEnv = {
+    DUST_UNATTENDED: "1",
+    DUST_SKIP_AGENT: "1"
+  };
+  if (repositoryId) {
+    baseEnv.DUST_REPOSITORY_ID = repositoryId;
+  }
   log("syncing with remote");
   onLoopEvent({ type: "loop.syncing" });
   const pullResult = await gitPull(context.cwd, spawn);
@@ -2133,7 +2174,7 @@ Make sure the repository is in a clean state and synced with remote before finis
         spawnOptions: {
           cwd: context.cwd,
           dangerouslySkipPermissions: true,
-          env: { DUST_UNATTENDED: "1", DUST_SKIP_AGENT: "1" },
+          env: baseEnv,
           signal
         },
         onRawEvent
@@ -2189,7 +2230,7 @@ ${instructions}`;
       spawnOptions: {
         cwd: context.cwd,
         dangerouslySkipPermissions: true,
-        env: { DUST_UNATTENDED: "1", DUST_SKIP_AGENT: "1" },
+        env: baseEnv,
         signal
       },
       onRawEvent
@@ -2199,7 +2240,7 @@ ${instructions}`;
     return "ran_claude";
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
-    log(`${agentName} error on task ${task.title ?? task.path}: ${errorMessage}`);
+    logger(`${agentName} error on task ${task.title ?? task.path}: ${errorMessage}`);
     context.stderr(`${agentName} exited with error: ${errorMessage}`);
     onAgentEvent?.({
       type: "agent-session-ended",
@@ -2286,6 +2327,45 @@ async function loopClaude(dependencies, loopDependencies = createDefaultDependen
 // lib/bucket/repository-loop.ts
 var log2 = createLogger("dust:bucket:repository-loop");
 var FALLBACK_TIMEOUT_MS = 300000;
+function createLogCallbacks(logBuffer) {
+  return {
+    stdout: (msg) => appendLogLine(logBuffer, createLogLine(msg, "stdout")),
+    stderr: (msg) => appendLogLine(logBuffer, createLogLine(msg, "stderr"))
+  };
+}
+function flushAndLogMultiLine(partialLine, text, logBuffer) {
+  if (partialLine) {
+    appendLogLine(logBuffer, createLogLine(partialLine, "stdout"));
+  }
+  for (const segment of text.split(`
+`)) {
+    appendLogLine(logBuffer, createLogLine(segment, "stdout"));
+  }
+  return "";
+}
+function buildEventMessage(parameters) {
+  const msg = {
+    sequence: parameters.sequence,
+    timestamp: new Date().toISOString(),
+    sessionId: parameters.sessionId,
+    repository: parameters.repository,
+    event: parameters.event
+  };
+  if (parameters.agentSessionId) {
+    msg.agentSessionId = parameters.agentSessionId;
+  }
+  return msg;
+}
+function createWakeUpHandler(repoState, resolve) {
+  const handler = () => {
+    if (repoState.wakeUp !== handler) {
+      return;
+    }
+    repoState.wakeUp = undefined;
+    resolve();
+  };
+  return handler;
+}
 function createNoOpGlobScanner() {
   return {
     scan: async function* () {}
@@ -2295,12 +2375,13 @@ async function runRepositoryLoop(repoState, repoDeps, sendEvent, sessionId) {
   const { spawn, run: run2, fileSystem, sleep } = repoDeps;
   const repoName = repoState.repository.name;
   const settings = await loadSettings(repoState.path, fileSystem);
+  const logCallbacks = createLogCallbacks(repoState.logBuffer);
   const commandDeps = {
     arguments: [],
     context: {
       cwd: repoState.path,
-      stdout: (msg) => appendLogLine(repoState.logBuffer, createLogLine(msg, "stdout")),
-      stderr: (msg) => appendLogLine(repoState.logBuffer, createLogLine(msg, "stderr"))
+      stdout: (msg) => logCallbacks.stdout(msg),
+      stderr: (msg) => logCallbacks.stderr(msg)
     },
     fileSystem,
     globScanner: createNoOpGlobScanner(),
@@ -2320,14 +2401,7 @@ async function runRepositoryLoop(repoState, repoDeps, sendEvent, sessionId) {
         partialLine = lines[lines.length - 1];
       },
       line: (text) => {
-        if (partialLine) {
-          appendLogLine(repoState.logBuffer, createLogLine(partialLine, "stdout"));
-          partialLine = "";
-        }
-        for (const segment of text.split(`
-`)) {
-          appendLogLine(repoState.logBuffer, createLogLine(segment, "stdout"));
-        }
+        partialLine = flushAndLogMultiLine(partialLine, text, repoState.logBuffer);
       }
     })
   };
@@ -2358,17 +2432,13 @@ async function runRepositoryLoop(repoState, repoDeps, sendEvent, sessionId) {
     }
     if (sendEvent && sessionId) {
       sequence++;
-      const msg = {
+      sendEvent(buildEventMessage({
         sequence,
-        timestamp: new Date().toISOString(),
         sessionId,
         repository: repoName,
-        event
-      };
-      if (agentSessionId) {
-        msg.agentSessionId = agentSessionId;
-      }
-      sendEvent(msg);
+        event,
+        agentSessionId
+      }));
     }
   };
   const hooksInstalled = await manageGitHooks(commandDeps);
@@ -2386,6 +2456,7 @@ async function runRepositoryLoop(repoState, repoDeps, sendEvent, sessionId) {
       result = await runOneIteration(commandDeps, loopDeps, onLoopEvent, onAgentEvent, {
         hooksInstalled,
         signal: abortController.signal,
+        repositoryId: repoState.repository.id,
         onRawEvent: (rawEvent) => {
           onAgentEvent(rawEventToAgentEvent(rawEvent));
         }
@@ -2411,13 +2482,7 @@ async function runRepositoryLoop(repoState, repoDeps, sendEvent, sessionId) {
       log2(`${repoName}: no tasks available, waiting`);
       logLine("Waiting for tasks...");
       await new Promise((resolve) => {
-        const wakeUpForThisWait = () => {
-          if (repoState.wakeUp !== wakeUpForThisWait) {
-            return;
-          }
-          repoState.wakeUp = undefined;
-          resolve();
-        };
+        const wakeUpForThisWait = createWakeUpHandler(repoState, resolve);
         repoState.wakeUp = wakeUpForThisWait;
         sleep(FALLBACK_TIMEOUT_MS).then(() => {
           if (repoState.wakeUp === wakeUpForThisWait) {
@@ -2463,6 +2528,9 @@ function parseRepository(data) {
       if (typeof repositoryData.url === "string") {
         repo.url = repositoryData.url;
       }
+      if (typeof repositoryData.id === "string") {
+        repo.id = repositoryData.id;
+      }
       return repo;
     }
   }
@@ -2475,7 +2543,7 @@ async function addRepository(repository, manager, repoDeps, context) {
   }
   log3(`adding repository ${repository.name}`);
   const repoPath = getRepoPath(repository.name, repoDeps.getReposDir());
-  await repoDeps.fileSystem.mkdir(dirname3(repoPath), { recursive: true });
+  await repoDeps.fileSystem.mkdir(dirname2(repoPath), { recursive: true });
   if (repoDeps.fileSystem.exists(repoPath)) {
     await removeRepository(repoPath, repoDeps.spawn, context);
   }
@@ -3026,41 +3094,11 @@ function defaultGetTerminalSize() {
 function defaultWriteStdout(data) {
   process.stdout.write(data);
 }
-function defaultCreateServer(handler) {
-  let resolvedPort = 0;
-  const server = httpCreateServer(async (nodeRequest, nodeResponse) => {
-    const url = new URL(nodeRequest.url ?? "/", `http://localhost:${resolvedPort}`);
-    const request = new Request(url.toString(), {
-      method: nodeRequest.method ?? "GET"
-    });
-    const response = handler(request);
-    const body = await response.text();
-    nodeResponse.writeHead(response.status, {
-      "Content-Type": response.headers.get("content-type") ?? "text/plain"
-    });
-    nodeResponse.end(body);
-  });
-  server.listen(0, () => {
-    const addr2 = server.address();
-    if (addr2 && typeof addr2 === "object") {
-      resolvedPort = addr2.port;
-    }
-  });
-  const addr = server.address();
-  if (addr && typeof addr === "object") {
-    resolvedPort = addr.port;
-  }
-  return { port: resolvedPort, stop: () => server.close() };
-}
-function defaultOpenBrowser(url) {
-  const cmd = process.platform === "darwin" ? "open" : "xdg-open";
-  nodeSpawn3(cmd, [url], { stdio: "ignore", detached: true }).unref();
-}
-function createDefaultBucketDependencies() {
-  const authFileSystem = {
+function createAuthFileSystem(dependencies) {
+  return {
     exists: (path) => {
       try {
-        accessSync(path);
+        dependencies.accessSync(path);
         return true;
       } catch {
         return false;
@@ -3068,21 +3106,33 @@ function createDefaultBucketDependencies() {
     },
     isDirectory: (path) => {
       try {
-        return statSync(path).isDirectory();
+        return dependencies.statSync(path).isDirectory();
       } catch {
         return false;
       }
     },
-    getFileCreationTime: (path) => statSync(path).birthtimeMs,
-    readFile: (path) => readFile(path, "utf8"),
-    writeFile: (path, content) => writeFile(path, content, "utf8"),
-    mkdir: (path, options) => mkdir(path, options).then(() => {}),
-    readdir: (path) => readdir(path),
-    chmod: (path, mode) => chmod(path, mode),
-    rename: (oldPath, newPath) => import("node:fs/promises").then((mod) => mod.rename(oldPath, newPath))
+    getFileCreationTime: (path) => dependencies.statSync(path).birthtimeMs,
+    readFile: (path) => dependencies.readFile(path, "utf8"),
+    writeFile: (path, content) => dependencies.writeFile(path, content, "utf8"),
+    mkdir: (path, options) => dependencies.mkdir(path, options).then(() => {}),
+    readdir: (path) => dependencies.readdir(path),
+    chmod: (path, mode) => dependencies.chmod(path, mode),
+    rename: (oldPath, newPath) => dependencies.rename(oldPath, newPath)
   };
+}
+function createDefaultBucketDependencies() {
+  const authFileSystem = createAuthFileSystem({
+    accessSync,
+    statSync,
+    readFile,
+    writeFile,
+    mkdir,
+    readdir,
+    chmod,
+    rename: (oldPath, newPath) => import("node:fs/promises").then((mod) => mod.rename(oldPath, newPath))
+  });
   return {
-    spawn: nodeSpawn3,
+    spawn: nodeSpawn4,
     createWebSocket: defaultCreateWebSocket,
     setupKeypress: defaultSetupKeypress,
     setupSignals: defaultSetupSignals,
@@ -3091,10 +3141,10 @@ function createDefaultBucketDependencies() {
     writeStdout: defaultWriteStdout,
     isTTY: process.stdout.isTTY ?? false,
     sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
-    getReposDir: () => process.env.DUST_REPOS_DIR || join9(homedir(), ".dust", "repos"),
+    getReposDir: () => getReposDir(process.env, homedir()),
     auth: {
-      createServer: defaultCreateServer,
-      openBrowser: defaultOpenBrowser,
+      createServer: createLocalServer,
+      openBrowser,
       getHomeDir: () => homedir(),
       fileSystem: authFileSystem
     }
@@ -3459,6 +3509,176 @@ async function bucket(dependencies, bucketDeps = createDefaultBucketDependencies
   return { exitCode: 0 };
 }
 
+// lib/cli/commands/bucket-asset-upload.ts
+import { accessSync as accessSync2, statSync as statSync2 } from "node:fs";
+import { chmod as chmod2, mkdir as mkdir2, readdir as readdir2, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
+import { homedir as homedir2 } from "node:os";
+import { extname } from "node:path";
+var MAX_FILE_SIZE_BYTES = 10 * 1024 * 1024;
+var ALLOWED_EXTENSIONS = new Set([
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".webp",
+  ".svg",
+  ".pdf",
+  ".txt",
+  ".json",
+  ".csv",
+  ".md",
+  ".html",
+  ".xml"
+]);
+var MIME_TYPES = {
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".svg": "image/svg+xml",
+  ".pdf": "application/pdf",
+  ".txt": "text/plain",
+  ".json": "application/json",
+  ".csv": "text/csv",
+  ".md": "text/markdown",
+  ".html": "text/html",
+  ".xml": "application/xml"
+};
+function createDefaultUploadDependencies() {
+  const authFileSystemDeps = {
+    accessSync: accessSync2,
+    statSync: statSync2,
+    readFile: readFile2,
+    writeFile: writeFile2,
+    mkdir: mkdir2,
+    readdir: readdir2,
+    chmod: chmod2,
+    rename: (oldPath, newPath) => import("node:fs/promises").then((mod) => mod.rename(oldPath, newPath))
+  };
+  const authFileSystem = createAuthFileSystem(authFileSystemDeps);
+  return {
+    auth: {
+      createServer: createLocalServer,
+      openBrowser,
+      getHomeDir: () => homedir2(),
+      fileSystem: authFileSystem
+    },
+    readFileBytes: async (path) => {
+      const buffer = await Bun.file(path).arrayBuffer();
+      return new Uint8Array(buffer);
+    },
+    getFileSize: async (path) => {
+      const file = Bun.file(path);
+      return file.size;
+    },
+    fileExists: async (path) => {
+      const file = Bun.file(path);
+      return file.exists();
+    },
+    uploadFile: async (url, token, fileBytes, contentType) => {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${token}`,
+          "Content-Type": contentType
+        },
+        body: new Blob([fileBytes])
+      });
+      if (!response.ok) {
+        const text = await response.text();
+        throw new Error(`Upload failed (${response.status}): ${text || response.statusText}`);
+      }
+      const body = await response.json();
+      if (typeof body.url !== "string") {
+        throw new Error("Server response missing URL");
+      }
+      return { url: body.url };
+    }
+  };
+}
+async function resolveToken2(authDeps, context) {
+  const envToken = process.env.DUST_BUCKET_TOKEN;
+  if (envToken) {
+    return envToken;
+  }
+  const stored = await loadStoredToken(authDeps.fileSystem, authDeps.getHomeDir());
+  if (stored) {
+    return stored;
+  }
+  context.stdout("Opening browser to authenticate with dustbucket...");
+  try {
+    const token = await authenticate(authDeps);
+    await storeToken(authDeps.fileSystem, authDeps.getHomeDir(), token);
+    context.stdout("Authenticated successfully");
+    return token;
+  } catch (error) {
+    context.stderr(`Authentication failed: ${error.message}`);
+    return null;
+  }
+}
+function getContentType(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  return MIME_TYPES[ext] || "application/octet-stream";
+}
+function isAllowedExtension(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  return ALLOWED_EXTENSIONS.has(ext);
+}
+function formatFileSize(bytes) {
+  if (bytes < 1024)
+    return `${bytes} bytes`;
+  if (bytes < 1048576)
+    return `${(bytes / 1024).toFixed(1)} KB`;
+  return `${(bytes / 1048576).toFixed(1)} MB`;
+}
+async function bucketAssetUpload(dependencies, uploadDeps = createDefaultUploadDependencies(), env = process.env) {
+  const { context } = dependencies;
+  const filePath = dependencies.arguments[0];
+  if (!filePath) {
+    context.stderr("Usage: dust bucket asset upload <file-path>");
+    return { exitCode: 1 };
+  }
+  const repositoryId = env.DUST_REPOSITORY_ID;
+  if (!repositoryId) {
+    context.stderr("Error: DUST_REPOSITORY_ID environment variable is not set.");
+    context.stderr("This command must be run within a repository context (via `dust bucket`).");
+    return { exitCode: 1 };
+  }
+  const exists = await uploadDeps.fileExists(filePath);
+  if (!exists) {
+    context.stderr(`File not found: ${filePath}`);
+    return { exitCode: 1 };
+  }
+  if (!isAllowedExtension(filePath)) {
+    const ext = extname(filePath).toLowerCase() || "(no extension)";
+    const allowed = Array.from(ALLOWED_EXTENSIONS).join(", ");
+    context.stderr(`Unsupported file type: ${ext}`);
+    context.stderr(`Allowed types: ${allowed}`);
+    return { exitCode: 1 };
+  }
+  const fileSize = await uploadDeps.getFileSize(filePath);
+  if (fileSize > MAX_FILE_SIZE_BYTES) {
+    context.stderr(`File too large: ${formatFileSize(fileSize)} (max ${formatFileSize(MAX_FILE_SIZE_BYTES)})`);
+    return { exitCode: 1 };
+  }
+  const token = await resolveToken2(uploadDeps.auth, context);
+  if (!token) {
+    return { exitCode: 1 };
+  }
+  const fileBytes = await uploadDeps.readFileBytes(filePath);
+  const contentType = getContentType(filePath);
+  const uploadUrl = `${getDustbucketHost()}/api/assets?repositoryId=${encodeURIComponent(repositoryId)}`;
+  try {
+    const result = await uploadDeps.uploadFile(uploadUrl, token, fileBytes, contentType);
+    context.stdout(result.url);
+    return { exitCode: 0 };
+  } catch (error) {
+    context.stderr(`Upload failed: ${error.message}`);
+    return { exitCode: 1 };
+  }
+}
+
 // lib/cli/process-runner.ts
 import { spawn } from "node:child_process";
 function createShellRunner(spawnFn) {
@@ -3517,7 +3737,7 @@ function runBufferedProcess(spawnFn, command, commandArguments, cwd, shell, time
 }
 
 // lib/cli/commands/lint-markdown.ts
-import { join as join10 } from "node:path";
+import { join as join8 } from "node:path";
 
 // lib/lint/validators/content-validator.ts
 var REQUIRED_HEADINGS = [
@@ -3807,7 +4027,7 @@ function validateIdeaTransitionTitle(filePath, content, ideasPath, fileSystem) {
 }
 
 // lib/lint/validators/link-validator.ts
-import { dirname as dirname4, resolve } from "node:path";
+import { dirname as dirname3, resolve } from "node:path";
 var SEMANTIC_RULES = [
   {
     section: "## Principles",
@@ -3824,7 +4044,7 @@ function validateLinks(filePath, content, fileSystem) {
   const violations = [];
   const lines = content.split(`
 `);
-  const fileDir = dirname4(filePath);
+  const fileDir = dirname3(filePath);
   for (let i = 0;i < lines.length; i++) {
     const line = lines[i];
     const linkPattern = new RegExp(MARKDOWN_LINK_PATTERN.source, "g");
@@ -3851,7 +4071,7 @@ function validateSemanticLinks(filePath, content) {
   const violations = [];
   const lines = content.split(`
 `);
-  const fileDir = dirname4(filePath);
+  const fileDir = dirname3(filePath);
   let currentSection = null;
   for (let i = 0;i < lines.length; i++) {
     const line = lines[i];
@@ -3902,7 +4122,7 @@ function validatePrincipleHierarchyLinks(filePath, content) {
   const violations = [];
   const lines = content.split(`
 `);
-  const fileDir = dirname4(filePath);
+  const fileDir = dirname3(filePath);
   let currentSection = null;
   for (let i = 0;i < lines.length; i++) {
     const line = lines[i];
@@ -3951,7 +4171,7 @@ function validatePrincipleHierarchyLinks(filePath, content) {
 }
 
 // lib/lint/validators/principle-hierarchy.ts
-import { dirname as dirname5, resolve as resolve2 } from "node:path";
+import { dirname as dirname4, resolve as resolve2 } from "node:path";
 var REQUIRED_PRINCIPLE_HEADINGS = ["## Parent Principle", "## Sub-Principles"];
 function validatePrincipleHierarchySections(filePath, content) {
   const violations = [];
@@ -3968,7 +4188,7 @@ function validatePrincipleHierarchySections(filePath, content) {
 function extractPrincipleRelationships(filePath, content) {
   const lines = content.split(`
 `);
-  const fileDir = dirname5(filePath);
+  const fileDir = dirname4(filePath);
   const parentPrinciples = [];
   const subPrinciples = [];
   let currentSection = null;
@@ -4089,7 +4309,7 @@ async function lintMarkdown(dependencies) {
   const violations = [];
   context.stdout("Validating directory structure...");
   violations.push(...await validateDirectoryStructure(dustPath, fileSystem, dependencies.settings.extraDirectories));
-  const settingsPath = join10(dustPath, "config", "settings.json");
+  const settingsPath = join8(dustPath, "config", "settings.json");
   if (fileSystem.exists(settingsPath)) {
     context.stdout("Validating settings.json...");
     try {
@@ -4419,7 +4639,7 @@ async function check(dependencies, shellRunner = defaultShellRunner) {
 function generateHelpText(settings) {
   const bin = settings.dustCommand;
   return dedent`
-    💨 dust - Flow state for AI coding agents.
+    ✨ dust - Flow state for AI coding agents.
 
     Usage: ${bin} <command> [options]
 
@@ -4705,10 +4925,10 @@ async function list(dependencies) {
 }
 
 // lib/codex/spawn-codex.ts
-import { spawn as nodeSpawn4 } from "node:child_process";
+import { spawn as nodeSpawn5 } from "node:child_process";
 import { createInterface as nodeCreateInterface2 } from "node:readline";
 var defaultDependencies2 = {
-  spawn: nodeSpawn4,
+  spawn: nodeSpawn5,
   createInterface: nodeCreateInterface2
 };
 async function* spawnCodex(prompt, options = {}, dependencies = defaultDependencies2) {
@@ -5227,6 +5447,7 @@ var commandRegistry = {
   agent,
   audit,
   bucket,
+  "bucket asset upload": bucketAssetUpload,
   focus,
   "new task": newTask,
   "new principle": newPrinciple,
@@ -5243,6 +5464,9 @@ var COMMANDS = Object.keys(commandRegistry).filter((cmd) => !cmd.includes(" "));
 function isHelpRequest(command) {
   return !command || command === "help" || command === "--help" || command === "-h";
 }
+function isVersionRequest(command) {
+  return command === "--version" || command === "-v";
+}
 function isValidCommand(command) {
   return command in commandRegistry;
 }
@@ -5262,6 +5486,10 @@ async function main(options) {
   const { commandArguments, context, fileSystem, glob, directoryFileSorter } = options;
   const settings = await loadSettings(context.cwd, fileSystem);
   const helpText = generateHelpText(settings);
+  if (isVersionRequest(commandArguments[0])) {
+    context.stdout(DUST_VERSION);
+    return { exitCode: 0 };
+  }
   if (isHelpRequest(commandArguments[0])) {
     context.stdout(helpText);
     return { exitCode: 0 };
@@ -5308,10 +5536,10 @@ function createFileSystem(primitives) {
     rename: (oldPath, newPath) => primitives.rename(oldPath, newPath)
   };
 }
-function createGlobScanner(readdir2) {
+function createGlobScanner(readdir3) {
   return {
     scan: async function* (dir) {
-      for (const entry of await readdir2(dir, { recursive: true })) {
+      for (const entry of await readdir3(dir, { recursive: true })) {
         if (entry.endsWith(".md"))
           yield entry;
       }
@@ -5338,7 +5566,7 @@ async function wireEntry(fsPrimitives, processPrimitives, consolePrimitives) {
 }
 
 // lib/cli/run.ts
-await wireEntry({ existsSync, statSync: statSync2, readFile: readFile2, writeFile: writeFile2, mkdir: mkdir2, readdir: readdir2, chmod: chmod2, rename }, {
+await wireEntry({ existsSync, statSync: statSync3, readFile: readFile3, writeFile: writeFile3, mkdir: mkdir3, readdir: readdir3, chmod: chmod3, rename }, {
   argv: process.argv,
   cwd: () => process.cwd(),
   exit: (code) => {
@@ -5350,4 +5578,4 @@ await wireEntry({ existsSync, statSync: statSync2, readFile: readFile2, writeFil
     process.stdout.write(message);
   },
   error: console.error
-});
+});