@voltade/volty 0.1.29 → 0.1.31

package/README.md

@@ -56,7 +56,7 @@ To edit a workspace's automations, pages, quick paths and inbox settings as file
 volty init my-workspace
 ```
 
-It pulls the workspace into the new folder and adds a `package.json`, a `.gitignore`, and a `tsconfig.json` that references `tsconfig.code.json` and `tsconfig.entry.json`, so your editor and Claude can check the code the way a push does, as the `@voltade/sdk` README explains. Run `npm install` in the folder, then `npx tsc -b` to check it, then open it in your editor. A file the folder already has is kept. `volty pull` brings in later changes from the workspace and `volty push` sends yours back.
+It pulls the workspace into the new folder and adds a `package.json`, a `.gitignore`, a `CLAUDE.md` that imports `AGENTS.md` for Claude Code, and a `tsconfig.json` that references `tsconfig.code.json` and `tsconfig.entry.json`, so your editor and Claude can check the code the way a push does, as the `@voltade/sdk` README explains. Run `bun install` in the folder, then `bunx tsc -b` to check it, then open it in your editor. A file the folder already has is kept. On prod, name the workspace with `--workspace <id>` (`volty org list --env prod` lists yours). Inside the folder, `volty pull` brings in later changes from the workspace and `volty push` sends yours back, both reading the workspace from the folder's `.volty/targets`.
 
 ## Upgrading
 

package/dist/volty.js

@@ -620,7 +620,8 @@ var SCAFFOLD_PATHS = [
   "tsconfig.json",
   "tsconfig.code.json",
   "tsconfig.entry.json",
-  ".gitignore"
+  ".gitignore",
+  "CLAUDE.md"
 ];
 var ENTRY_FILES = "pages/**/entry.tsx";
 function options(name) {
@@ -663,6 +664,8 @@ function scaffoldFiles() {
     }),
     ".gitignore": `${PUSH_EXCLUDES.join(`
 `)}
+`,
+    "CLAUDE.md": `@AGENTS.md
 `
   };
 }
@@ -771,7 +774,7 @@ function initLines(dir, files) {
   return [
     `${dir} is set up for an editor:`,
     ...files.map((f) => f.written ? `  wrote ${f.path}` : `  kept ${f.path}, which the folder already has`),
-    dir === "." ? "Next: run npm install, then npx tsc -b to check the folder, then open it in your editor." : `Next: cd ${dir}, run npm install, then npx tsc -b to check the folder, then open it in your editor.`
+    dir === "." ? "Next: run bun install, then bunx tsc -b to check the folder, then open it in your editor." : `Next: cd ${dir}, run bun install, then bunx tsc -b to check the folder, then open it in your editor.`
   ];
 }
 
@@ -832,6 +835,7 @@ function isProdShaped(env, baseUrl) {
   return host !== "localhost" && host !== "127.0.0.1" && host !== "::1" && host !== "[::1]";
 }
 var PROD_ORG_REFUSAL = "prod needs an explicit org: pass --org <id> or VOLTY_ORG=<id>; run 'volty org list --env prod' to see your orgs";
+var PROD_WORKSPACE_REFUSAL = "prod needs an explicit workspace: pass --workspace <id>; run 'volty org list --env prod' to see yours";
 var STICKY_ORG_REFUSAL = "prod does not honour a sticky org: pass --org <id> or VOLTY_ORG=<id> on each command instead; run 'volty org list --env prod' to see your orgs";
 function resolveTargetOrg({ env, baseUrl, override, sticky, command }) {
   if (!isProdShaped(env, baseUrl))
@@ -840,6 +844,8 @@ function resolveTargetOrg({ env, baseUrl, override, sticky, command }) {
     return { org: override };
   if (isOrgFreeCommand(command))
     return { org: undefined };
+  if (command[0] === "pull" || command[0] === "init")
+    return { refusal: PROD_WORKSPACE_REFUSAL };
   return { refusal: PROD_ORG_REFUSAL };
 }
 
@@ -1368,20 +1374,49 @@ function pullLines(dir, out) {
     "What the project does not hold is listed in .volty/observed."
   ];
 }
-async function handlePull(rest, ctx, env) {
-  const dir = folderArg(rest, "pull");
+async function handlePull(dir, ctx, env) {
   const out = await pull(ctx, { dir, workspaceId: await workspaceOf(ctx), target: env });
   process.stdout.write(`${pullLines(dir, out).join(`
 `)}
 `);
 }
-async function handleInit(rest, ctx, env) {
-  const dir = folderArg(rest, "init");
+async function handleInit(dir, ctx, env) {
   const out = await init(ctx, { dir, workspaceId: await workspaceOf(ctx), target: env });
   process.stdout.write(`${[...pullLines(dir, out.pulled), ...initLines(dir, out.files)].join(`
 `)}
 `);
 }
+async function targetContext(config, name, workspace) {
+  const login = config.contexts[name];
+  if (!login?.apiKey)
+    fail(`not logged in to '${name}', the env target ${name} runs on: run \`volty auth login --env ${name}\``);
+  const selected = await ensureOrgKey(login, workspace, (line) => process.stderr.write(`${line}
+`));
+  if (selected.minted)
+    saveConfig(config);
+  const ctx = { ...login, apiKey: selected.apiKey, organizationId: selected.organizationId };
+  setOrgOverride(selected.organizationId);
+  if (isProdShaped(name, login.baseUrl)) {
+    const res = await whoami(ctx);
+    if ("error" in res)
+      fail(res.error);
+    process.stderr.write(`→ ${name} · ${res.who.organizationName} (${res.who.organizationId}) · ${res.who.role}
+`);
+  }
+  return ctx;
+}
+async function handlePulledPull(dir, targets, config, envFlag, workspaceId) {
+  if (workspaceId)
+    refuseOtherWorkspace(dir, targets, workspaceId);
+  if (envFlag === "all")
+    fail(`${dir} holds one copy of the files, so a pull takes one target: name it with --env (${Object.keys(targets).join(", ")})`);
+  const name = pickTargets(targets, envFlag)[0];
+  const { workspace } = targets[name];
+  const out = await pull(await targetContext(config, name, workspace), { dir, workspaceId: workspace, target: name });
+  process.stdout.write(`${pullLines(dir, out).join(`
+`)}
+`);
+}
 var PUSH_USAGE = "usage: volty push [dir] [--env <target>|all] [--dry-run] [--confirm] [--json]";
 async function handlePush(argv, config, envFlag) {
   const dryRun = takeBool(argv, "--dry-run");
@@ -1395,23 +1430,8 @@ async function handlePush(argv, config, envFlag) {
   const answers = {};
   let exitCode = 0;
   for (const name of names) {
-    const login = config.contexts[name];
-    if (!login?.apiKey)
-      fail(`not logged in to '${name}', the env target ${name} runs on: run \`volty auth login --env ${name}\``);
     const { workspace } = project.targets[name];
-    const selected = await ensureOrgKey(login, workspace, (line) => process.stderr.write(`${line}
-`));
-    if (selected.minted)
-      saveConfig(config);
-    const ctx = { ...login, apiKey: selected.apiKey, organizationId: selected.organizationId };
-    setOrgOverride(selected.organizationId);
-    if (isProdShaped(name, login.baseUrl)) {
-      const res = await whoami(ctx);
-      if ("error" in res)
-        fail(res.error);
-      process.stderr.write(`→ ${name} · ${res.who.organizationName} (${res.who.organizationId}) · ${res.who.role}
-`);
-    }
+    const ctx = await targetContext(config, name, workspace);
     if (names.length > 1 && !json.present)
       process.stdout.write(`Target ${name}, workspace ${workspace}:
 `);
@@ -1474,21 +1494,25 @@ async function main() {
   argv = orgExtract.rest;
   const cacheFlag = takeBool(argv, "--no-cache");
   argv = cacheFlag.rest;
-  const workspaceExtract = argv[0] === "pull" || argv[0] === "init" ? takeValue(argv, "--workspace") : { value: undefined, rest: argv };
+  const folderCmd = argv[0] === "pull" || argv[0] === "init" ? argv[0] : null;
+  const workspaceExtract = folderCmd ? takeValue(argv, "--workspace") : { value: undefined, rest: argv };
   argv = workspaceExtract.rest;
   const config = loadConfig();
-  const pulled = argv[0] === "init" ? readTargets(folderArg(argv.slice(1), "init")) : null;
+  const dir = folderCmd ? folderArg(argv.slice(1), folderCmd) : null;
+  const pulled = dir ? readTargets(dir) : null;
   if (argv[0] === "push" || pulled) {
     if (orgExtract.value)
       fail(`volty ${argv[0]} takes its workspace from .volty/targets: leave out --org`);
-    if (pulled) {
-      const dir = folderArg(argv.slice(1), "init");
+    const envFlag = envExtract.value ?? (process.env.VOLTY_ENV || undefined);
+    if (dir && pulled && folderCmd === "init") {
       process.stdout.write(`${initLines(dir, initPulled(dir, pulled, workspaceExtract.value)).join(`
 `)}
 `);
       return;
     }
-    return handlePush(argv.slice(1), config, envExtract.value ?? (process.env.VOLTY_ENV || undefined));
+    if (dir && pulled)
+      return handlePulledPull(dir, pulled, config, envFlag, workspaceExtract.value);
+    return handlePush(argv.slice(1), config, envFlag);
   }
   const env = activeEnv(config, envExtract.value ?? (process.env.VOLTY_ENV || undefined));
   const peek = config.contexts[env];
@@ -1537,10 +1561,10 @@ async function main() {
     process.stderr.write(`→ ${env} · ${res.who.organizationName} (${res.who.organizationId}) · ${res.who.role}
 `);
   }
-  if (cmd === "pull")
-    return handlePull(rest, ctx, env);
-  if (cmd === "init")
-    return handleInit(rest, ctx, env);
+  if (dir && cmd === "pull")
+    return handlePull(dir, ctx, env);
+  if (dir && cmd === "init")
+    return handleInit(dir, ctx, env);
   if (cmd === "changes" && rest[0] === "decide")
     return handleChanges(rest, ctx);
   if (cmd === "keys")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltade/volty",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "description": "Remote CLI for the Volty platform — run operations, trigger real agent wakes, and inspect LLM I/O over an API key.",
   "license": "UNLICENSED",
   "type": "module",