@codevector/cli 0.7.0 → 0.8.0

package/README.md

@@ -4,11 +4,13 @@ Wire your AI coding tools through a corporate gateway in one command. One API ke
 
 ```bash
 npm i -g @codevector/cli   # or: pnpm add -g @codevector/cli
-codevector auth login
-codevector configure
+codevector auth login      # once, to store your gateway + API key
+codevector init            # per repo: pin the gateway, name the project, wire your tools
 ```
 
-That's the whole onboarding. Pick a tool, pick a scope, done.
+That's the whole onboarding. `init` is the per-repo entry point - it pins a gateway,
+writes a `.codevector.json`, and offers to run `configure` for you. Add the shell hook
+(below) and your credentials auto-activate as you `cd` between repos.
 
 ---
 
@@ -21,19 +23,20 @@ That's the whole onboarding. Pick a tool, pick a scope, done.
 ## What it does
 
 - **Signs you in** with a per-seat API key issued by your gateway admin.
+- **Initializes a repo** with `codevector init`: pins a gateway, names the project for attribution, and offers to wire your tools in one pass.
 - **Writes the right config file** for each supported coding tool so its model traffic routes through the gateway instead of calling upstream providers directly.
 - **Picks the right scope** (global, project-wide, or per-machine) based on what you want and what the tool supports.
-- **Installs an acceptance-tracking hook** that fires at session end for tools that expose lifecycle events. Feeds the gateway's usage reporting.
+- **Auto-activates credentials on cd** via an optional shell hook, so each repo gets the gateway env vars for its pinned gateway without a per-tool config file.
 - **Stays out of your way.** Idempotent writes. Deep-merges into existing settings files — won't clobber your theme, your other hooks, your existing env vars.
 
 ---
 
 ## Supported tools
 
-| Tool                             | Config path (user scope)                 | Scopes (`configure` writes project/local; `system configure` writes user) | Key storage                                                | Hooks wired           |
-| -------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------- | --------------------- |
-| **Claude Code**                  | `~/.claude/settings.json`                | user / project / local                                                    | literal in JSON (`ANTHROPIC_AUTH_TOKEN`)                   | `Stop` + `SessionEnd` |
-| **opencode** (sst/opencode)      | `~/.config/opencode/opencode.json`       | user / project / local                                                    | literal (user + local); env-var reference in project scope | —                     |
+| Tool                             | Config path (user scope)                 | Scopes (`configure` writes project/local; `system configure` writes user) | Key storage                                                |
+| -------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------- | ---------------------------------------------------------- |
+| **Claude Code**                  | `~/.claude/settings.json`                | user / project / local                                                    | literal in JSON (`ANTHROPIC_AUTH_TOKEN`)                   |
+| **opencode** (sst/opencode)      | `~/.config/opencode/opencode.json`       | user / project / local                                                    | literal (user + local); env-var reference in project scope |
 
 Each writer emits both Anthropic and OpenAI-compatible provider entries where the tool supports both wire formats.
 
@@ -85,9 +88,14 @@ codevector status                             # who am I, where am I pointed, wh
 codevector doctor                             # health checks: creds, network, hook install, settings
 codevector version                            # print CLI version
 codevector update                             # update @codevector/cli from npm (use --with pnpm|yarn if needed)
-codevector init                               # writes .codevector.json (projectName + ticket pattern)
-codevector init --project my-app              # with explicit project name
-codevector init --ticket-pattern "JIRA-\d+"   # with custom ticket extraction regex
+codevector init                               # per-repo: pin gateway, name project, offer to wire tools
+codevector init --project my-app              # explicit project name
+codevector init --gateway https://gw.corp.com # pin a gateway non-interactively
+codevector init --ticket-pattern "JIRA-\d+"   # custom ticket extraction regex
+codevector init --skip-configure              # write .codevector.json, don't wire tools
+codevector init --force                       # overwrite an existing .codevector.json
+codevector hook bash                          # print the shell-hook snippet (bash|zsh|fish)
+codevector env --shell bash                   # print env exports for the current repo (used by the hook)
 ```
 
 Every command supports `--help`. Commands that need input will prompt interactively when flags are missing, but every flag still works for scripting.
@@ -109,10 +117,18 @@ codevector auth login --gateway-url https://gateway.corp.com --api-key "$KEY"  #
 
 ```bash
 codevector auth login              # paste the gateway URL + API key your admin emailed you
-codevector configure claude-code   # default scope is local — safe per-seat, gitignored
+codevector init                    # in the repo: pins the gateway, names the project, wires your tools
 codevector doctor                  # confirm everything's wired
 ```
 
+**Auto-activate credentials as you move between repos:**
+
+```bash
+# add to ~/.zshrc (or ~/.bashrc; fish: codevector hook fish | source)
+eval "$(codevector hook zsh)"
+# then: cd into any repo with a .codevector.json and its gateway env vars load automatically
+```
+
 **Configuring multiple tools in one go:**
 
 ```bash
@@ -155,6 +171,32 @@ codevector models sync --scope local   # refresh model list after admin adds mod
 
 ---
 
+## Shell hook
+
+`codevector init` pins a gateway to a repo in `.codevector.json`. The shell hook reads
+that pin and exports the matching profile's gateway env vars whenever you `cd` into the
+repo, then clears them when you leave. Install it once:
+
+| Shell | rc file                      | Line to add                      |
+| ----- | ---------------------------- | -------------------------------- |
+| bash  | `~/.bashrc`                  | `eval "$(codevector hook bash)"` |
+| zsh   | `~/.zshrc`                   | `eval "$(codevector hook zsh)"`  |
+| fish  | `~/.config/fish/config.fish` | `codevector hook fish \| source` |
+
+On macOS, login shells read `~/.bash_profile` instead of `~/.bashrc`.
+
+After restarting your shell, entering a repo with a pinned gateway exports
+`ANTHROPIC_BASE_URL`, `ANTHROPIC_API_KEY`, `OPENAI_BASE_URL`, `OPENAI_API_KEY`, and
+`ANTHROPIC_CUSTOM_HEADERS` (the `x-project` attribution header). The CLI walks up the
+directory tree, so a subdirectory of the repo resolves the same pin. If no saved profile
+matches the pinned gateway, the hook prints a hint to run `codevector auth login`.
+`codevector doctor` reports whether the hook is installed.
+
+`codevector env --shell <shell>` is the command the hook evaluates on each `cd` — you
+don't run it directly.
+
+---
+
 ## Safe config merging
 
 `codevector configure` adds the gateway settings to your existing config files without overwriting what's already there:
@@ -189,4 +231,4 @@ Override the config root with `CODEVECTOR_CONFIG_DIR`.
 | Claude Code            | `~/.claude/settings.json` / `.claude/settings.local.json` | JSON                   |
 | opencode               | `~/.config/opencode/opencode.json` / `./opencode.json`    | JSON (JSONC tolerated) |
 | codevector credentials | `~/.config/codevector/credentials.json`                   | JSON (chmod 0600)      |
-| codevector hook script | `~/.config/codevector/hooks/acceptance.sh`                | shell                  |
+| codevector project pin | `<repo>/.codevector.json`                                 | JSON (no secrets)      |

package/dist/index.js

@@ -18199,18 +18199,19 @@ var init_project_context = __esm({
 });
 
 // src/lib/shell.ts
-function detectShell() {
+function detectShell(platform = process.platform) {
   const shellPath = process.env.SHELL ?? "";
   if (shellPath.endsWith("/fish")) return "fish";
   if (shellPath.endsWith("/zsh")) return "zsh";
   if (shellPath.endsWith("/bash")) return "bash";
+  if (shellPath === "" && platform === "win32") return "powershell";
   return null;
 }
 var SHELLS;
 var init_shell = __esm({
   "src/lib/shell.ts"() {
     "use strict";
-    SHELLS = ["bash", "zsh", "fish"];
+    SHELLS = ["bash", "zsh", "fish", "powershell"];
   }
 });
 
@@ -18223,7 +18224,7 @@ function shellHookRecipe(shell) {
 }
 function shellHookInstructions(shell = detectShell(), platform = process.platform) {
   if (!shell) {
-    const rows = Object.keys(RECIPES).map((s) => `  ${s.padEnd(5)} ${RECIPES[s].rc.padEnd(26)} ${RECIPES[s].line}`).join("\n");
+    const rows = Object.keys(RECIPES).map((s) => `  ${s.padEnd(10)} ${RECIPES[s].rc.padEnd(26)} ${RECIPES[s].line}`).join("\n");
     return `Add the line for your shell to its rc file, then restart your shell (credentials auto-activate on cd):
 
 ${rows}`;
@@ -18237,6 +18238,9 @@ ${rows}`;
   if (shell === "bash" && platform === "darwin") {
     lines.push("", "On macOS, login shells read ~/.bash_profile instead of ~/.bashrc.");
   }
+  if (shell === "powershell") {
+    lines.push("", "If $PROFILE doesn't exist yet, create it: New-Item -ItemType File -Path $PROFILE -Force.");
+  }
   return lines.join("\n");
 }
 function shellHookOneLiner(shell = detectShell()) {
@@ -18255,6 +18259,13 @@ function rcCandidates(shell, platform = process.platform) {
       return [join7(home, ".zshrc")];
     case "fish":
       return [join7(home, ".config", "fish", "config.fish")];
+    case "powershell": {
+      const docs = join7(home, "Documents");
+      return [
+        join7(docs, "PowerShell", "Microsoft.PowerShell_profile.ps1"),
+        join7(docs, "WindowsPowerShell", "Microsoft.PowerShell_profile.ps1")
+      ];
+    }
   }
 }
 function isHookInstalled(shell, platform = process.platform) {
@@ -18274,7 +18285,8 @@ var init_shell_hook = __esm({
     RECIPES = {
       bash: { rc: "~/.bashrc", line: `eval "$(codevector hook bash)"` },
       zsh: { rc: "~/.zshrc", line: `eval "$(codevector hook zsh)"` },
-      fish: { rc: "~/.config/fish/config.fish", line: "codevector hook fish | source" }
+      fish: { rc: "~/.config/fish/config.fish", line: "codevector hook fish | source" },
+      powershell: { rc: "$PROFILE", line: "codevector hook powershell | Out-String | Invoke-Expression" }
     };
   }
 });
@@ -18472,7 +18484,7 @@ var init_init = __esm({
 // src/commands/configure.ts
 import { homedir as homedir5 } from "os";
 import { existsSync as existsSync7 } from "fs";
-import { join as join9 } from "path";
+import { join as join9, sep } from "path";
 async function resolveTools(args) {
   if (args.all) return [...ALL_TOOLS];
   if (args.tool) {
@@ -18540,11 +18552,11 @@ function pathHint(tools, scope) {
 function relativizeHomeAndCwd(absolutePath) {
   const home = homedir5();
   const cwd = userCwd();
-  if (home && absolutePath.startsWith(`${home}/`)) {
+  if (home && absolutePath.startsWith(`${home}${sep}`)) {
     return `~${absolutePath.slice(home.length)}`;
   }
-  if (absolutePath.startsWith(`${cwd}/`)) {
-    return `./${absolutePath.slice(cwd.length + 1)}`;
+  if (absolutePath.startsWith(`${cwd}${sep}`)) {
+    return `.${absolutePath.slice(cwd.length)}`;
   }
   return absolutePath;
 }
@@ -19233,7 +19245,7 @@ import { join as join11 } from "path";
 // src/lib/install-pref.ts
 init_paths();
 import { existsSync as existsSync8, mkdirSync as mkdirSync4, readFileSync as readFileSync8, realpathSync, renameSync as renameSync3, writeFileSync as writeFileSync6 } from "fs";
-import { join as join10, sep } from "path";
+import { join as join10, sep as sep2 } from "path";
 import { fileURLToPath } from "url";
 var INSTALL_PREF_FILE = join10(CODEVECTOR_CONFIG_DIR, "install.json");
 var PACKAGE_MANAGERS = ["npm", "pnpm", "yarn"];
@@ -19263,11 +19275,11 @@ function writeInstallPref(pref) {
   renameSync3(tmp, INSTALL_PREF_FILE);
 }
 function packageManagerFromPath(installPath) {
-  if (installPath.includes(`${sep}.pnpm${sep}`)) return "pnpm";
-  if (installPath.includes(`${sep}.config${sep}yarn${sep}global${sep}`) || installPath.includes(`${sep}.yarn${sep}`)) {
+  if (installPath.includes(`${sep2}.pnpm${sep2}`)) return "pnpm";
+  if (installPath.includes(`${sep2}.config${sep2}yarn${sep2}global${sep2}`) || installPath.includes(`${sep2}.yarn${sep2}`)) {
     return "yarn";
   }
-  if (installPath.includes(`${sep}lib${sep}node_modules${sep}`)) return "npm";
+  if (installPath.includes(`${sep2}lib${sep2}node_modules${sep2}`)) return "npm";
   return void 0;
 }
 function detectPackageManagerFromInstallPath() {
@@ -19323,13 +19335,15 @@ var doctorCommand = defineCommand({
         label: "credentials",
         detail: `${creds.email} @ ${creds.gatewayUrl} (${maskApiKey(creds.apiKey)})`
       });
-      checks.push(
-        credentialsFileModeOk() ? { level: "ok", label: "credentials permissions", detail: "chmod 600" } : {
-          level: "warn",
-          label: "credentials permissions",
-          detail: `expected 0600 on ${CREDENTIALS_FILE}`
-        }
-      );
+      if (process.platform !== "win32") {
+        checks.push(
+          credentialsFileModeOk() ? { level: "ok", label: "credentials permissions", detail: "chmod 600" } : {
+            level: "warn",
+            label: "credentials permissions",
+            detail: `expected 0600 on ${CREDENTIALS_FILE}`
+          }
+        );
+      }
       const client = gatewayClient(creds.gatewayUrl, creds.apiKey, 1e4);
       try {
         const me2 = await call(parseResponse(client.me.$get()));
@@ -19597,6 +19611,7 @@ init_credentials();
 init_paths();
 init_project_config();
 init_shell();
+import { dirname as dirname5 } from "path";
 var envCommand = defineCommand({
   meta: {
     name: "env",
@@ -19605,8 +19620,8 @@ var envCommand = defineCommand({
   args: {
     shell: {
       type: "string",
-      description: "Output dialect: bash, zsh, or fish.",
-      valueHint: "bash|zsh|fish"
+      description: "Output dialect: bash, zsh, fish, or powershell.",
+      valueHint: "bash|zsh|fish|powershell"
     }
   },
   async run({ args }) {
@@ -19614,7 +19629,7 @@ var envCommand = defineCommand({
     const cwd = userCwd();
     const previousDir = process.env.CODEVECTOR_ACTIVE_DIR ?? null;
     const found = readProjectConfig(cwd);
-    const repoDir = found?.path ? dirOf(found.path) : null;
+    const repoDir = found?.path ? dirname5(found.path) : null;
     const gateway = found?.config.gateway ?? null;
     const projectName = found?.config.projectName ?? null;
     const lines = [];
@@ -19668,22 +19683,30 @@ function resolveShell(raw) {
   return raw;
 }
 function emitExport(lines, shell, name, value) {
-  const quoted = shellQuote(value);
-  if (shell === "fish") {
+  const quoted = quoteForShell(shell, value);
+  if (shell === "powershell") {
+    lines.push(`$env:${name} = ${quoted}`);
+  } else if (shell === "fish") {
     lines.push(`set -gx ${name} ${quoted}`);
   } else {
     lines.push(`export ${name}=${quoted}`);
   }
 }
 function emitUnset(lines, shell, name) {
-  if (shell === "fish") {
+  if (shell === "powershell") {
+    lines.push(`Remove-Item -ErrorAction SilentlyContinue Env:\\${name}`);
+  } else if (shell === "fish") {
     lines.push(`set -e ${name}`);
   } else {
     lines.push(`unset ${name}`);
   }
 }
-function emitEcho(lines, _shell, message) {
-  lines.push(`echo ${shellQuote(message)} 1>&2`);
+function emitEcho(lines, shell, message) {
+  if (shell === "powershell") {
+    lines.push(`[Console]::Error.WriteLine(${quoteForShell(shell, message)})`);
+  } else {
+    lines.push(`echo ${quoteForShell(shell, message)} 1>&2`);
+  }
 }
 function emitDeactivate(lines, shell, previousDir) {
   for (const name of [
@@ -19699,16 +19722,15 @@ function emitDeactivate(lines, shell, previousDir) {
   }
   emitEcho(lines, shell, `codevector: left ${previousDir}, credentials cleared.`);
 }
-function shellQuote(value) {
+function quoteForShell(shell, value) {
+  if (shell === "powershell") {
+    return `'${value.replace(/'/g, "''")}'`;
+  }
   return `'${value.replace(/'/g, `'\\''`)}'`;
 }
 function trimRightSlash5(url2) {
   return url2.endsWith("/") ? url2.slice(0, -1) : url2;
 }
-function dirOf(filePath) {
-  const idx = filePath.lastIndexOf("/");
-  return idx === -1 ? filePath : filePath.slice(0, idx);
-}
 function buildAnthropicCustomHeaders(projectName) {
   if (!projectName) return null;
   const safe = projectName.replace(/[\r\n]/g, "").trim();
@@ -20114,8 +20136,8 @@ var hookCommand = defineCommand({
     shell: {
       type: "positional",
       required: false,
-      description: "Target shell: bash, zsh, or fish.",
-      valueHint: "bash|zsh|fish"
+      description: "Target shell: bash, zsh, fish, or powershell.",
+      valueHint: "bash|zsh|fish|powershell"
     }
   },
   run({ args }) {
@@ -20146,6 +20168,8 @@ function snippetFor(shell) {
       return ZSH_SNIPPET;
     case "fish":
       return FISH_SNIPPET;
+    case "powershell":
+      return POWERSHELL_SNIPPET;
   }
 }
 var BASH_SNIPPET = `# codevector shell hook (bash) \u2014 auto-activates credentials on cd
@@ -20183,6 +20207,22 @@ end
 # Run once for the current directory at shell startup.
 _codevector_on_pwd
 `;
+var POWERSHELL_SNIPPET = `# codevector shell hook (powershell) \u2014 auto-activates credentials on cd
+function global:_codevector_on_prompt {
+    if ($PWD.Path -eq $global:_CODEVECTOR_LAST_PWD) { return }
+    $global:_CODEVECTOR_LAST_PWD = $PWD.Path
+    $out = (& codevector env --shell powershell 2>$null | Out-String)
+    if ($out.Trim().Length -gt 0) { Invoke-Expression $out }
+}
+if (-not $global:_CODEVECTOR_PROMPT_WRAPPED) {
+    $global:_CODEVECTOR_PROMPT_WRAPPED = $true
+    $global:_CODEVECTOR_ORIG_PROMPT = $function:prompt
+    function global:prompt {
+        _codevector_on_prompt
+        if ($global:_CODEVECTOR_ORIG_PROMPT) { & $global:_CODEVECTOR_ORIG_PROMPT } else { "PS $($PWD.Path)> " }
+    }
+}
+`;
 
 // src/index.ts
 init_init();
@@ -20824,7 +20864,7 @@ import {
   readdirSync,
   statSync as statSync4
 } from "fs";
-import { basename, dirname as dirname5, join as join13 } from "path";
+import { basename, dirname as dirname6, join as join13 } from "path";
 import { homedir as homedir6 } from "os";
 var BACKUP_ROOT = process.env.CODEVECTOR_BACKUP_ROOT ?? join13(homedir6(), ".codevector", "backups");
 function backupTimestamp(d = /* @__PURE__ */ new Date()) {
@@ -20867,7 +20907,7 @@ function restoreBackup(backupPath, originalPath) {
   if (!existsSync11(backupPath)) {
     throw new Error(`Backup file missing: ${backupPath}`);
   }
-  mkdirSync6(dirname5(originalPath), { recursive: true });
+  mkdirSync6(dirname6(originalPath), { recursive: true });
   copyFileSync(backupPath, originalPath);
 }
 function backupRunMtime(dir) {
@@ -21118,7 +21158,7 @@ import { spawnSync } from "child_process";
 // package.json
 var package_default = {
   name: "@codevector/cli",
-  version: "0.7.0",
+  version: "0.8.0",
   description: "CodeVector CLI \u2014 installs and configures first-party coding-tool integrations.",
   license: "UNLICENSED",
   bin: {
@@ -21273,7 +21313,10 @@ var updateCommand = defineCommand({
     const manager = await resolvePackageManager(args.with);
     const command = installCommand(manager);
     R2.info(`Using ${manager}: ${command.cmd} ${command.args.join(" ")}`);
-    const result = spawnSync(command.cmd, command.args, { stdio: "inherit" });
+    const result = spawnSync(command.cmd, command.args, {
+      stdio: "inherit",
+      shell: process.platform === "win32"
+    });
     if (result.error) {
       throw new Error(
         `Failed to invoke ${command.cmd}: ${result.error.message}. Is ${command.cmd} on your PATH?`
@@ -21308,7 +21351,10 @@ function verifyOnPathVersion(previousVersion, manager) {
   R2.success(`Already on the latest version (${previousVersion}).`);
 }
 function readOnPathVersion() {
-  const probe = spawnSync("codevector", ["version"], { encoding: "utf8" });
+  const probe = spawnSync("codevector", ["version"], {
+    encoding: "utf8",
+    shell: process.platform === "win32"
+  });
   if (probe.error || probe.status !== 0) return void 0;
   const out = probe.stdout?.trim();
   return out && /^\d+\.\d+\.\d+/.test(out) ? out : void 0;