protovibe 1.0.3 → 1.1.0

package/dist/index.mjs

@@ -121,7 +121,7 @@ function spawnClaude(projectPath) {
 
 // src/scaffold.ts
 import { mkdirSync, writeFileSync, existsSync as existsSync2, readdirSync, statSync } from "fs";
-import { join as join2, dirname } from "path";
+import { join as join2, dirname, resolve } from "path";
 import { homedir as homedir2 } from "os";
 import * as clack from "@clack/prompts";
 
@@ -394,6 +394,44 @@ Rules:
 - After giving the summary, ask: "Would you like to continue where we left off?"
 `;
 
+// src/templates/CLAUDE-analyse.md.ts
+var CLAUDE_ANALYSE_MD = `# CLAUDE.md
+
+IMMEDIATE INSTRUCTION \u2014 execute this before doing anything else, before reading any other file, before responding to the user in any way:
+
+Run /analyse now.
+
+Do not greet the user. Do not ask what they want. Do not wait for input. Do not explain what you are about to do. Just run /analyse immediately and silently.
+`;
+
+// src/templates/analyse.md.ts
+var ANALYSE_MD = `# /analyse \u2014 Project Analysis
+
+When this command is run:
+
+1. Read every source file, configuration file, and documentation file in the current working directory, recursively. Include: all code files, package.json / pyproject.toml / Cargo.toml or equivalent, README files, config files.
+
+2. Build a complete understanding of the codebase. Do not ask the user any questions during this step.
+
+3. Present a structured summary in exactly this format:
+
+---
+**Project:** [inferred project name from package.json, directory name, or equivalent]
+**What it does:** [1\u20132 sentences describing the project's purpose and who it is for]
+**Tech Stack:** [comma-separated list of languages, frameworks, and major libraries]
+**Key Features:**
+[bulleted list \u2014 one sentence per feature]
+**Project Structure:** [2\u20133 sentences on key directories, entry points, and separation of concerns]
+**Current State:** [one sentence: scaffold, early prototype, partially built, or mature codebase \u2014 based on file count, TODOs, and feature completeness]
+---
+
+4. After presenting the summary, say exactly:
+
+> "I've analysed your project. I'm ready to help \u2014 what would you like to work on?"
+
+5. STOP. Do not suggest tasks. Do not ask questions. Wait for the user.
+`;
+
 // src/scaffold.ts
 function getSubdirectories(dirPath) {
   try {
@@ -440,34 +478,103 @@ async function browseForDirectory() {
     }
   }
 }
-async function scaffoldProject() {
-  const projectName = await clack.text({
-    message: "Project name:",
-    placeholder: "my-project",
+function writeProtovibeTemplates(targetDir) {
+  mkdirSync(join2(targetDir, ".claude", "commands"), { recursive: true });
+  writeFileSync(join2(targetDir, "CLAUDE.md"), CLAUDE_MD, "utf-8");
+  writeFileSync(join2(targetDir, ".claude", "commands", "protovibe.md"), PROTOVIBE_MD, "utf-8");
+  writeFileSync(join2(targetDir, ".claude", "commands", "takeover.md"), TAKEOVER_MD, "utf-8");
+  writeFileSync(join2(targetDir, ".claude", "commands", "summarise.md"), SUMMARISE_MD, "utf-8");
+}
+function writeAnalyseTemplates(targetDir) {
+  mkdirSync(join2(targetDir, ".claude", "commands"), { recursive: true });
+  writeFileSync(join2(targetDir, "CLAUDE.md"), CLAUDE_ANALYSE_MD, "utf-8");
+  writeFileSync(join2(targetDir, ".claude", "commands", "analyse.md"), ANALYSE_MD, "utf-8");
+}
+async function handleExistingProject() {
+  const rawPath = await clack.text({
+    message: "Path to your existing project:",
+    placeholder: "/Users/you/my-project",
     validate(value) {
-      if (value.trim() === "/exit") return void 0;
-      if (!value.trim()) return "Project name is required.";
-      if (/[^a-zA-Z0-9\-_]/.test(value)) return "Use only letters, numbers, hyphens, and underscores.";
+      if (!value.trim()) return "Path is required.";
+      const resolved = resolve(value.trim().replace(/^~/, homedir2()));
+      if (!existsSync2(resolved)) return "That path does not exist.";
+      try {
+        if (!statSync(resolved).isDirectory()) return "That path is not a directory.";
+      } catch {
+        return "Could not read that path.";
+      }
     }
   });
-  if (clack.isCancel(projectName) || String(projectName).trim() === "/exit") {
+  if (clack.isCancel(rawPath)) {
     clack.cancel("Exiting ProtoVibe. See you next time.");
     process.exit(0);
   }
-  clack.log.info("Select where to create your project:");
-  const parentDir = await browseForDirectory();
-  const targetDir = join2(parentDir, String(projectName));
-  if (existsSync2(targetDir)) {
-    clack.cancel(`Directory already exists: ${targetDir}`);
-    process.exit(1);
+  const existingPath = resolve(String(rawPath).trim().replace(/^~/, homedir2()));
+  writeAnalyseTemplates(existingPath);
+  clack.outro(`\u2713 Ready to analyse ${existingPath}`);
+  return existingPath;
+}
+async function handleNewProject() {
+  let parentDir = null;
+  while (true) {
+    const nameInput = await clack.text({
+      message: "Project name:",
+      placeholder: "my-project",
+      validate(value) {
+        if (value.trim() === "/exit") return void 0;
+        if (!value.trim()) return "Project name is required.";
+        if (/[^a-zA-Z0-9\-_]/.test(value)) return "Use only letters, numbers, hyphens, and underscores.";
+      }
+    });
+    if (clack.isCancel(nameInput) || String(nameInput).trim() === "/exit") {
+      clack.cancel("Exiting ProtoVibe. See you next time.");
+      process.exit(0);
+    }
+    if (parentDir === null) {
+      clack.log.info("Select where to create your project:");
+      parentDir = await browseForDirectory();
+    }
+    const targetDir = join2(parentDir, String(nameInput).trim());
+    if (!existsSync2(targetDir)) {
+      writeProtovibeTemplates(targetDir);
+      clack.outro(`\u2713 Project created at ${targetDir}`);
+      return targetDir;
+    }
+    clack.log.error(`A project named '${String(nameInput).trim()}' already exists at this location.`);
+    const conflictChoice = await clack.select({
+      message: "What would you like to do?",
+      options: [
+        { value: "rename", label: "Choose a different name for my new project" },
+        { value: "continue", label: "Continue with the existing project" }
+      ]
+    });
+    if (clack.isCancel(conflictChoice)) {
+      clack.cancel("Exiting ProtoVibe. See you next time.");
+      process.exit(0);
+    }
+    if (conflictChoice === "continue") {
+      writeProtovibeTemplates(targetDir);
+      clack.outro(`\u2713 Ready to continue at ${targetDir}`);
+      return targetDir;
+    }
   }
-  mkdirSync(join2(targetDir, ".claude", "commands"), { recursive: true });
-  writeFileSync(join2(targetDir, "CLAUDE.md"), CLAUDE_MD, "utf-8");
-  writeFileSync(join2(targetDir, ".claude", "commands", "protovibe.md"), PROTOVIBE_MD, "utf-8");
-  writeFileSync(join2(targetDir, ".claude", "commands", "takeover.md"), TAKEOVER_MD, "utf-8");
-  writeFileSync(join2(targetDir, ".claude", "commands", "summarise.md"), SUMMARISE_MD, "utf-8");
-  clack.outro(`\u2713 Project created at ${targetDir}`);
-  return targetDir;
+}
+async function scaffoldProject() {
+  const modeChoice = await clack.select({
+    message: "What would you like to do?",
+    options: [
+      { value: "new", label: "Start a new project" },
+      { value: "existing", label: "Continue with an existing project" }
+    ]
+  });
+  if (clack.isCancel(modeChoice)) {
+    clack.cancel("Exiting ProtoVibe. See you next time.");
+    process.exit(0);
+  }
+  if (modeChoice === "existing") {
+    return handleExistingProject();
+  }
+  return handleNewProject();
 }
 
 // src/cli.tsx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "protovibe",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "A branded CLI platform layer on top of Claude Code",
   "author": "razorgojo",
   "license": "MIT",