runshift 0.0.3 → 0.0.5

package/src/index.ts

@@ -1,20 +1,27 @@
 #!/usr/bin/env node
 
 import { init } from "./commands/init.js";
+import { remove } from "./commands/remove.js";
 
 const args = process.argv.slice(2);
 const command = args[0] ?? "init";
 
 switch (command) {
   case "init":
-    init().catch((err) => {
+    init(args.slice(1)).catch((err) => {
+      console.error(err.message ?? err);
+      process.exit(1);
+    });
+    break;
+  case "remove":
+    remove().catch((err) => {
       console.error(err.message ?? err);
       process.exit(1);
     });
     break;
   case "--version":
   case "-v":
-    console.log("runshift 0.0.2");
+    console.log("runshift 0.0.3");
     break;
   case "--help":
   case "-h":
@@ -22,11 +29,16 @@ switch (command) {
   runshift — the control plane for agents, wherever they run.
 
   Usage:
-    npx runshift init    Read your repo, generate governance rules
+    npx runshift init [options]   Read your repo, generate governance rules
+    npx runshift remove           Revert the runshift install commit
 
   Options:
-    --version, -v        Show version
-    --help, -h           Show this help
+    --version, -v                 Show version
+    --help, -h                    Show this help
+
+  Init options:
+    --dry-run                     Preview changes without writing files
+    --branch <name>               Run on a new branch (default: relay-init)
 `);
     break;
   default:

package/src/types.ts

@@ -17,6 +17,7 @@ export interface RepoContext {
   migrationCount: number;
   migrationNames: string[];
   rootConfigs: string[];
+  protectedPaths: string[];
   gitState: {
     branch: string;
     isDirty: boolean;
@@ -41,4 +42,5 @@ export interface InitResponse {
   files: GeneratedFile[];
   findings: Findings;
   summary: string;
+  previewId?: string;
 }

package/src/ui/display.ts

@@ -13,8 +13,9 @@ export function showBanner(): void {
     horizontalLayout: "default",
   });
   console.log(amber(banner));
-  console.log(muted("  v0.0.2"));
-  console.log(muted("  the control plane for agents, wherever they run.\n"));
+  console.log(muted("  v0.0.3"));
+  console.log(muted("  the control plane for agents, wherever they run."));
+  console.log(dim("  usage: npx runshift init [--dry-run] [--branch <name>]\n"));
   console.log(divider + "\n");
 }
 
@@ -62,13 +63,17 @@ export function showScanResults(context: RepoContext): void {
   }
 
   const existingRuleKeys = Object.keys(context.existingRules);
+  const protectedSet = new Set(context.protectedPaths);
   const cursorRules = existingRuleKeys.filter((k) => k.startsWith(".cursor/rules/"));
   if (cursorRules.length > 0) {
-    detections.push(`.cursor/rules/ — ${cursorRules.length} existing file${cursorRules.length === 1 ? "" : "s"} detected`);
+    const protectedCount = cursorRules.filter((k) => protectedSet.has(k)).length;
+    const suffix = protectedCount > 0 ? ` (${protectedCount} protected)` : "";
+    detections.push(`.cursor/rules/ — ${cursorRules.length} existing file${cursorRules.length === 1 ? "" : "s"} detected${suffix}`);
   }
 
   if (existingRuleKeys.includes("CLAUDE.md")) {
-    detections.push("existing CLAUDE.md detected");
+    const claudeProtected = protectedSet.has("CLAUDE.md") ? " (protected — human-written)" : "";
+    detections.push(`existing CLAUDE.md detected${claudeProtected}`);
   }
 
   if (context.tsconfig) {
@@ -120,6 +125,19 @@ export function showFileList(files: GeneratedFile[]): void {
   console.log(dim("\n  + = create, ~ = update existing file\n"));
 }
 
+export function showSelectedFiles(allFiles: GeneratedFile[], selectedPaths: string[]): void {
+  const selected = new Set(selectedPaths);
+  console.log(amber("  relay understood:\n"));
+  for (const file of allFiles) {
+    if (selected.has(file.path)) {
+      console.log(dim("  ✓ ") + file.path + dim(" (included)"));
+    } else {
+      console.log(dim("  ✗ ") + muted(file.path) + dim(" (excluded)"));
+    }
+  }
+  console.log();
+}
+
 export function showWriting(filePath: string): void {
   console.log(dim("  ✓ ") + filePath);
 }
@@ -128,6 +146,16 @@ export function showCommit(): void {
   console.log(dim("  ✓ ") + "committed");
 }
 
+export function showProtectedFiles(protectedPaths: string[]): void {
+  if (protectedPaths.length === 0) return;
+  console.log();
+  console.log(amber("  relay preserved your existing files:"));
+  for (const p of protectedPaths) {
+    console.log(dim(`  ~ ${p} — human-written, not overwritten`));
+  }
+  console.log(dim("  run npx runshift update to review suggested changes.\n"));
+}
+
 export function showSummary(summary: string): void {
   console.log(muted(`  ${summary.replace(/\n/g, "\n  ")}\n`));
 }
@@ -142,6 +170,33 @@ export function showSuccess(): void {
   console.log("\n" + divider + "\n");
 }
 
+export function showDataPolicy(): void {
+  console.log(amber("  relay will send to runshift.ai:\n"));
+  console.log(dim("  ✓ package.json (dependencies and scripts only)"));
+  console.log(dim("  ✓ directory structure (top 2 levels, folder names only)"));
+  console.log(dim("  ✓ .env.example (key names only — values are never read)"));
+  console.log(dim("  ✓ existing CLAUDE.md (if present)"));
+  console.log(dim("  ✓ existing .cursor/rules/ (if present)"));
+  console.log(dim("  ✓ migration file names (no file contents)"));
+  console.log(dim("\n  no source code is sent."));
+  console.log(dim("  no secret values are ever read.\n"));
+}
+
+export function showDryRunComplete(): void {
+  console.log("\n" + divider + "\n");
+  console.log(amber("  dry run complete — no files written."));
+  console.log(dim("  run npx runshift init to install.\n"));
+  console.log(divider + "\n");
+}
+
+export function showCancelled(): void {
+  console.log();
+  console.log(amber("  no changes made."));
+  console.log(dim("  run npx runshift init when you're ready."));
+  console.log();
+  console.log(divider + "\n");
+}
+
 export function showError(type: "network" | "rate-limit" | "validation" | "server", message?: string): void {
   console.log();
   switch (type) {

package/src/ui/prompt.ts

@@ -31,3 +31,45 @@ export async function promptChoice(question: string): Promise<"y" | "a" | "n"> {
 export async function promptFilePath(question: string): Promise<string> {
   return ask(question);
 }
+
+export async function promptFileSelection(question: string): Promise<"a" | "s" | "n"> {
+  const answer = await ask(question);
+  const normalized = answer.toLowerCase();
+  if (normalized === "a" || normalized === "accept") return "a";
+  if (normalized === "s" || normalized === "select") return "s";
+  return "n";
+}
+
+export function promptPreview(message: string): Promise<boolean> {
+  return new Promise((resolve) => {
+    process.stdout.write(message);
+
+    const wasRaw = process.stdin.isRaw;
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+
+    const onData = (key: Buffer) => {
+      process.stdin.setRawMode(wasRaw ?? false);
+      process.stdin.pause();
+      process.stdin.removeListener("data", onData);
+
+      const ch = key.toString();
+
+      // ctrl-c
+      if (ch === "\x03") {
+        console.log();
+        process.exit(0);
+      }
+
+      if (ch.toLowerCase() === "o") {
+        console.log("o\n");
+        resolve(true);
+      } else {
+        console.log("\n");
+        resolve(false);
+      }
+    };
+
+    process.stdin.on("data", onData);
+  });
+}