@getpawl/setup 1.0.1 → 1.1.1

package/dist/index.js

@@ -4,14 +4,145 @@
 // src/index.ts
 var import_node_fs = require("fs");
 var import_node_path = require("path");
-function main() {
-  const encoded = process.argv[2];
-  if (!encoded) {
-    console.error(
-      "Usage: npx @getpawl/setup <PROJECT_KEY>\n\nGet your project key from the Pawl settings page."
-    );
+var import_node_child_process = require("child_process");
+var DEFAULT_API_URL = "https://agentmap-api.onrender.com";
+async function main() {
+  const arg = process.argv[2];
+  if (!arg) {
+    printUsage();
+    process.exit(0);
+  }
+  if (arg === "sync") {
+    pawlSync(process.argv[3]);
+  } else if (arg === "connect") {
+    await pawlConnect();
+  } else if (arg === "init") {
+    const key = process.argv[3];
+    pawlInit(key);
+  } else {
+    legacySetup(arg);
+  }
+}
+function printUsage() {
+  console.log(`
+Usage:
+  pawl init                 Initialize Pawl in this repo
+  pawl connect              Link this repo to a Pawl project (opens browser)
+  pawl sync [--pull]        Sync with Pawl dashboard (push by default)
+  pawl-setup <PROJECT_KEY>  Legacy setup (still supported)
+
+Dashboard: https://pawl.dev
+`);
+}
+function pawlSync(flag) {
+  const cwd = process.cwd();
+  const syncScript = (0, import_node_path.join)(cwd, ".pawl", "sync.sh");
+  if (!(0, import_node_fs.existsSync)(syncScript)) {
+    console.error("Error: .pawl/sync.sh not found \u2014 run `pawl init` first.");
+    process.exit(1);
+  }
+  const envFile = (0, import_node_path.join)(cwd, ".pawl", ".env");
+  if (!(0, import_node_fs.existsSync)(envFile)) {
+    console.error("Error: .pawl/.env not found \u2014 run `pawl connect` to link your project.");
+    process.exit(1);
+  }
+  const mode = flag === "--pull" ? "pull" : "push";
+  (0, import_node_child_process.execSync)(`.pawl/sync.sh ${mode}`, { stdio: "inherit", cwd });
+}
+function generateCode() {
+  const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+  let code = "";
+  for (let i = 0; i < 6; i++) {
+    code += chars[Math.floor(Math.random() * chars.length)];
+  }
+  return code;
+}
+function getRepoName() {
+  try {
+    const remote = (0, import_node_child_process.execSync)("git remote get-url origin", { encoding: "utf-8" }).trim();
+    const match = remote.match(/\/([^/]+?)(?:\.git)?$/);
+    if (match) return match[1];
+  } catch {
+  }
+  return (0, import_node_path.basename)(process.cwd());
+}
+function openBrowser(url) {
+  try {
+    const cmd = process.platform === "darwin" ? `open "${url}"` : process.platform === "win32" ? `start "${url}"` : `xdg-open "${url}"`;
+    (0, import_node_child_process.execSync)(cmd, { stdio: "ignore" });
+  } catch {
+    console.log(`  Open this URL in your browser:
+  ${url}`);
+  }
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function pollForKey(apiUrl, code) {
+  const deadline = Date.now() + 5 * 60 * 1e3;
+  const interval = 2e3;
+  while (Date.now() < deadline) {
+    try {
+      const res = await fetch(`${apiUrl}/api/cli/connect/poll?code=${code}`);
+      if (!res.ok) {
+        await sleep(interval);
+        continue;
+      }
+      const data = await res.json();
+      if (data.status === "ready") {
+        return {
+          apiKey: data.apiKey,
+          projectId: data.projectId,
+          apiUrl: data.apiUrl
+        };
+      }
+      if (data.status === "expired") {
+        return null;
+      }
+    } catch {
+    }
+    await sleep(interval);
+  }
+  return null;
+}
+async function pawlConnect() {
+  const cwd = process.cwd();
+  if (!(0, import_node_fs.existsSync)((0, import_node_path.join)(cwd, ".pawl"))) {
+    console.error("Error: .pawl/ not found \u2014 run `pawl init` first.");
+    process.exit(1);
+  }
+  const apiUrl = DEFAULT_API_URL;
+  const code = generateCode();
+  const repoName = getRepoName();
+  const startRes = await fetch(`${apiUrl}/api/cli/connect/start`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ code, repoName })
+  });
+  if (!startRes.ok) {
+    console.error("Error: Could not start connect session. Is the API reachable?");
     process.exit(1);
   }
+  const frontendUrl = apiUrl.replace("-api", "").replace(":3001", ":3002");
+  const connectUrl = `${frontendUrl}/connect?code=${code}&repo=${encodeURIComponent(repoName)}`;
+  console.log(`
+  Opening browser to link "${repoName}" to a Pawl project...
+`);
+  openBrowser(connectUrl);
+  console.log("  Waiting for you to select a project in the browser...");
+  console.log("  (Press Ctrl+C to cancel)\n");
+  const result = await pollForKey(apiUrl, code);
+  if (!result) {
+    console.error("  Session expired or cancelled. Run `pawl connect` to try again.");
+    process.exit(1);
+  }
+  (0, import_node_fs.mkdirSync)((0, import_node_path.join)(cwd, ".pawl"), { recursive: true });
+  writePawlEnvFile(cwd, result);
+  console.log("  Connected! .pawl/.env written.\n");
+  console.log(`  Project: ${result.apiUrl}/projects/${result.projectId}`);
+  console.log("  Run `pawl sync` to push your first session.\n");
+}
+function legacySetup(encoded) {
   let config;
   try {
     const decoded = Buffer.from(encoded, "base64").toString("utf-8");
@@ -38,6 +169,411 @@ function main() {
   console.log("  Created: .agentmap/.env, .agentmap/sync.sh, .agentmap/parse-cc-session.js");
   console.log("  Updated: .claude/settings.json, CLAUDE.md, .gitignore\n");
 }
+function pawlInit(key) {
+  const cwd = process.cwd();
+  const detected = detectAgents(cwd);
+  migrateIfNeeded(cwd, detected.hasAgentMapDir);
+  (0, import_node_fs.mkdirSync)((0, import_node_path.join)(cwd, ".pawl"), { recursive: true });
+  if (key) {
+    let config;
+    try {
+      const decoded = Buffer.from(key, "base64").toString("utf-8");
+      config = JSON.parse(decoded);
+    } catch {
+      console.error("Error: Invalid project key \u2014 could not decode.");
+      process.exit(1);
+    }
+    writePawlEnvFile(cwd, config);
+  }
+  writePawlSyncScript(cwd);
+  copyParserScript(cwd, ".pawl");
+  if (detected.hasCC) {
+    mergeClaudeSettings(cwd, ".pawl");
+  }
+  if (detected.hasGemini) {
+    mergeGeminiSettings(cwd);
+  }
+  writeGitHook(cwd, detected.hasGitDir);
+  writePawlClaudeMd(cwd);
+  writeAgentsMd(cwd);
+  updateGitignore(cwd);
+  printSummary(detected, !!key);
+}
+function detectAgents(cwd) {
+  return {
+    hasCC: (0, import_node_fs.existsSync)((0, import_node_path.join)(cwd, ".claude")),
+    hasGemini: (0, import_node_fs.existsSync)((0, import_node_path.join)(cwd, ".gemini")),
+    hasAgentMapDir: (0, import_node_fs.existsSync)((0, import_node_path.join)(cwd, ".agentmap")),
+    hasGitDir: (0, import_node_fs.existsSync)((0, import_node_path.join)(cwd, ".git"))
+  };
+}
+function migrateIfNeeded(cwd, hasAgentMapDir) {
+  if (!hasAgentMapDir) return;
+  if ((0, import_node_fs.existsSync)((0, import_node_path.join)(cwd, ".pawl"))) return;
+  console.log("  Migrating .agentmap/ \u2192 .pawl/...");
+  (0, import_node_fs.mkdirSync)((0, import_node_path.join)(cwd, ".pawl"), { recursive: true });
+  const filesToCopy = [".env", "sync.sh", "parse-cc-session.js", "context.md", "progress.md"];
+  for (const file of filesToCopy) {
+    const src = (0, import_node_path.join)(cwd, ".agentmap", file);
+    if ((0, import_node_fs.existsSync)(src)) {
+      (0, import_node_fs.copyFileSync)(src, (0, import_node_path.join)(cwd, ".pawl", file));
+    }
+  }
+  const specsDir = (0, import_node_path.join)(cwd, ".agentmap", "specs");
+  if ((0, import_node_fs.existsSync)(specsDir)) {
+    (0, import_node_fs.cpSync)(specsDir, (0, import_node_path.join)(cwd, ".pawl", "specs"), { recursive: true });
+  }
+  const envPath = (0, import_node_path.join)(cwd, ".pawl", ".env");
+  if ((0, import_node_fs.existsSync)(envPath)) {
+    let envContent = (0, import_node_fs.readFileSync)(envPath, "utf-8");
+    envContent = envContent.replace(/AGENTMAP_/g, "PAWL_");
+    (0, import_node_fs.writeFileSync)(envPath, envContent, "utf-8");
+  }
+  console.log("  .agentmap/ preserved \u2014 safe to delete manually when ready.\n");
+}
+function writePawlEnvFile(cwd, config) {
+  const content = [
+    `PAWL_API_KEY=${config.apiKey}`,
+    `PAWL_PROJECT_ID=${config.projectId}`,
+    `PAWL_API_URL=${config.apiUrl}`,
+    ""
+  ].join("\n");
+  (0, import_node_fs.writeFileSync)((0, import_node_path.join)(cwd, ".pawl", ".env"), content, "utf-8");
+}
+function writePawlSyncScript(cwd) {
+  const script = `#!/usr/bin/env bash
+set -euo pipefail
+
+# Pawl sync script \u2014 generated by pawl init
+# Do not edit manually; re-run pawl init to update.
+
+SCRIPT_DIR="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
+
+# Source env only if it exists (pawl init without key skips .env)
+if [ -f "$SCRIPT_DIR/.env" ]; then
+  source "$SCRIPT_DIR/.env"
+fi
+
+BASE_URL="\${PAWL_API_URL:-}/api/projects/\${PAWL_PROJECT_ID:-}"
+
+# \u2500\u2500 pull mode \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+pull() {
+  if [ -z "\${PAWL_API_KEY:-}" ]; then
+    echo "Warning: PAWL_API_KEY not set \u2014 sync disabled" >&2
+    if [ -f "$SCRIPT_DIR/context.md" ]; then
+      cat "$SCRIPT_DIR/context.md"
+    fi
+    return 0
+  fi
+
+  # Recovery: if tracked-files exist from a previous incomplete session, push first
+  if [ -f "$SCRIPT_DIR/.tracked-files" ]; then
+    push >/dev/null 2>&1
+  fi
+
+  # Ensure specs directory exists
+  mkdir -p "$SCRIPT_DIR/specs"
+
+  # \u2500\u2500 Level 1: New file-based endpoint \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  RESPONSE=$(curl -sf -X GET "$BASE_URL/context/files" \\
+    -H "Authorization: Bearer $PAWL_API_KEY" \\
+    -H "Accept: application/json" 2>/dev/null) || true
+
+  if [ -n "$RESPONSE" ] && echo "$RESPONSE" | jq -e '.files' >/dev/null 2>&1; then
+    echo "$RESPONSE" | jq -r '.files[] | @base64' | while read -r encoded; do
+      FILE_PATH=$(echo "$encoded" | base64 -d | jq -r '.path')
+      FILE_CONTENT=$(echo "$encoded" | base64 -d | jq -r '.content')
+
+      # Ensure parent directory exists
+      mkdir -p "$SCRIPT_DIR/$(dirname "$FILE_PATH")"
+      echo "$FILE_CONTENT" > "$SCRIPT_DIR/$FILE_PATH"
+    done
+
+    # Output context.md to stdout (for SessionStart hook)
+    if [ -f "$SCRIPT_DIR/context.md" ]; then
+      cat "$SCRIPT_DIR/context.md"
+    fi
+    return 0
+  fi
+
+  # \u2500\u2500 Level 2: Legacy monolithic endpoint \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  RESPONSE=$(curl -sf -X GET "$BASE_URL/context" \\
+    -H "Authorization: Bearer $PAWL_API_KEY" \\
+    -H "Accept: application/json" 2>/dev/null) || true
+
+  if [ -n "$RESPONSE" ] && echo "$RESPONSE" | jq -e '.formatted_context' >/dev/null 2>&1; then
+    echo "$RESPONSE" | jq -r '.formatted_context // empty' > "$SCRIPT_DIR/context.md"
+    cat "$SCRIPT_DIR/context.md"
+    return 0
+  fi
+
+  # \u2500\u2500 Level 3: Cached file fallback \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  if [ -f "$SCRIPT_DIR/context.md" ]; then
+    echo "# (cached \u2014 API unreachable)" | cat - "$SCRIPT_DIR/context.md"
+    return 0
+  fi
+
+  echo "Warning: Pawl context unavailable" >&2
+  return 1
+}
+
+# \u2500\u2500 push mode \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+push() {
+  if [ -z "\${PAWL_API_KEY:-}" ]; then
+    return 0
+  fi
+
+  LAST_SHA=""
+  if [ -f "$SCRIPT_DIR/.last-sync-sha" ]; then
+    LAST_SHA=$(cat "$SCRIPT_DIR/.last-sync-sha")
+  fi
+
+  CURRENT_SHA=$(git rev-parse HEAD 2>/dev/null || echo "")
+  BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "unknown")
+
+  # Compute diff
+  if [ -n "$LAST_SHA" ]; then
+    DIFF=$(git diff "$LAST_SHA"..HEAD 2>/dev/null || echo "")
+  else
+    DIFF=$(git diff HEAD~1..HEAD 2>/dev/null || echo "")
+  fi
+
+  # Collect tracked files (dedup)
+  FILES_CHANGED="[]"
+  if [ -f "$SCRIPT_DIR/.tracked-files" ]; then
+    FILES_CHANGED=$(sort -u "$SCRIPT_DIR/.tracked-files" | jq -R . | jq -s .)
+  fi
+
+  # Commit info
+  COMMIT_MSG=$(git log -1 --pretty=format:"%s" 2>/dev/null || echo "")
+
+  # Session ID from Claude Code (if available)
+  SESSION_ID="\${CLAUDE_SESSION_ID:-}"
+
+  # Repo root for CC session lookup
+  REPO_PATH=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
+
+  # Parse CC session data locally (if node + parser available)
+  CC_SESSION="{}"
+  if command -v node &> /dev/null; then
+    PARSER="$SCRIPT_DIR/parse-cc-session.js"
+    if [ -f "$PARSER" ]; then
+      CC_SESSION=$(node "$PARSER" "$REPO_PATH" 2>/dev/null || echo "{}")
+    fi
+  fi
+
+  # Extract cc_tasks from parser output
+  CC_TASKS=$(echo "$CC_SESSION" | jq -c '.tasks // []')
+
+  PAYLOAD=$(jq -n \\
+    --arg diff "$DIFF" \\
+    --arg branch "$BRANCH" \\
+    --arg commit_sha "$CURRENT_SHA" \\
+    --arg commit_message "$COMMIT_MSG" \\
+    --arg session_id "$SESSION_ID" \\
+    --arg last_sync_sha "$LAST_SHA" \\
+    --arg repo_path "$REPO_PATH" \\
+    --argjson files_changed "$FILES_CHANGED" \\
+    --argjson cc_session "$CC_SESSION" \\
+    --argjson cc_tasks "$CC_TASKS" \\
+    '{
+      diff: $diff,
+      branch: $branch,
+      commit_sha: $commit_sha,
+      commit_message: $commit_message,
+      session_id: $session_id,
+      last_sync_sha: $last_sync_sha,
+      repo_path: $repo_path,
+      files_changed: $files_changed,
+      cc_session: $cc_session,
+      cc_tasks: $cc_tasks
+    }')
+
+  RESPONSE=$(curl -sf -X POST "$BASE_URL/sync" \\
+    -H "Authorization: Bearer $PAWL_API_KEY" \\
+    -H "Content-Type: application/json" \\
+    -d "$PAYLOAD")
+
+  echo "$RESPONSE" | jq .
+
+  # Update last sync SHA
+  echo "$CURRENT_SHA" > "$SCRIPT_DIR/.last-sync-sha"
+
+  # Cleanup tracked files
+  rm -f "$SCRIPT_DIR/.tracked-files"
+}
+
+# \u2500\u2500 dispatch \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+case "\${1:-}" in
+  pull) pull ;;
+  push) push ;;
+  *)
+    echo "Usage: sync.sh [pull|push]"
+    exit 1
+    ;;
+esac
+`;
+  const scriptPath = (0, import_node_path.join)(cwd, ".pawl", "sync.sh");
+  (0, import_node_fs.writeFileSync)(scriptPath, script, "utf-8");
+  (0, import_node_fs.chmodSync)(scriptPath, 493);
+}
+function mergeGeminiSettings(cwd) {
+  const geminiDir = (0, import_node_path.join)(cwd, ".gemini");
+  (0, import_node_fs.mkdirSync)(geminiDir, { recursive: true });
+  const settingsPath = (0, import_node_path.join)(geminiDir, "settings.json");
+  let settings = {};
+  if ((0, import_node_fs.existsSync)(settingsPath)) {
+    try {
+      settings = JSON.parse((0, import_node_fs.readFileSync)(settingsPath, "utf-8"));
+    } catch {
+    }
+  }
+  const hooksToInstall = {
+    SessionStart: { command: ".pawl/sync.sh pull" },
+    AfterAgentLoop: { command: ".pawl/sync.sh push" }
+  };
+  const hooksObj = settings.hooks || {};
+  for (const [event, entry] of Object.entries(hooksToInstall)) {
+    const existing = hooksObj[event] || [];
+    const alreadyExists = existing.some((e) => e.command === entry.command);
+    if (!alreadyExists) {
+      existing.push(entry);
+    }
+    hooksObj[event] = existing;
+  }
+  settings.hooks = hooksObj;
+  (0, import_node_fs.writeFileSync)(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+}
+function writeGitHook(cwd, hasGitDir) {
+  if (!hasGitDir) return;
+  const hooksDir = (0, import_node_path.join)(cwd, ".git", "hooks");
+  (0, import_node_fs.mkdirSync)(hooksDir, { recursive: true });
+  const hookPath = (0, import_node_path.join)(hooksDir, "post-commit");
+  const hookBlock = `#!/bin/sh
+# Pawl sync hook \u2014 fires after every commit
+# Provides universal sync fallback for agents without lifecycle hooks (Codex, etc.)
+if [ -f ".pawl/sync.sh" ]; then
+  .pawl/sync.sh push
+fi`;
+  if (!(0, import_node_fs.existsSync)(hookPath)) {
+    (0, import_node_fs.writeFileSync)(hookPath, hookBlock + "\n", "utf-8");
+    (0, import_node_fs.chmodSync)(hookPath, 493);
+    return;
+  }
+  const content = (0, import_node_fs.readFileSync)(hookPath, "utf-8");
+  if (content.includes("Pawl sync hook")) {
+    return;
+  }
+  (0, import_node_fs.writeFileSync)(hookPath, content.trimEnd() + "\n\n" + hookBlock + "\n", "utf-8");
+  (0, import_node_fs.chmodSync)(hookPath, 493);
+}
+function writePawlClaudeMd(cwd) {
+  const claudeMdPath = (0, import_node_path.join)(cwd, "CLAUDE.md");
+  const PAWL_START = "<!-- pawl:start -->";
+  const PAWL_END = "<!-- pawl:end -->";
+  const AGENTMAP_START = "<!-- agentmap:start -->";
+  const AGENTMAP_END = "<!-- agentmap:end -->";
+  const block = [
+    PAWL_START,
+    "# Pawl Context",
+    "",
+    "This project uses Pawl for spec management and AI session tracking.",
+    "",
+    "Context files are in `.pawl/`:",
+    "- `.pawl/context.md` \u2014 project index, spec map, health",
+    "- `.pawl/specs/` \u2014 individual spec files (one per feature area)",
+    "- `.pawl/progress.md` \u2014 last session summary",
+    "",
+    "Read `.pawl/context.md` at session start, then load relevant specs from `.pawl/specs/` based on the task.",
+    PAWL_END
+  ].join("\n");
+  if (!(0, import_node_fs.existsSync)(claudeMdPath)) {
+    (0, import_node_fs.writeFileSync)(claudeMdPath, block + "\n", "utf-8");
+    return;
+  }
+  let content = (0, import_node_fs.readFileSync)(claudeMdPath, "utf-8");
+  let startIdx = content.indexOf(PAWL_START);
+  let endIdx = content.indexOf(PAWL_END);
+  let endMarkerLen = PAWL_END.length;
+  if (startIdx === -1 || endIdx === -1) {
+    startIdx = content.indexOf(AGENTMAP_START);
+    endIdx = content.indexOf(AGENTMAP_END);
+    endMarkerLen = AGENTMAP_END.length;
+  }
+  if (startIdx !== -1 && endIdx !== -1) {
+    content = content.slice(0, startIdx) + block + content.slice(endIdx + endMarkerLen);
+  } else {
+    content = content.trimEnd() + "\n\n" + block + "\n";
+  }
+  (0, import_node_fs.writeFileSync)(claudeMdPath, content, "utf-8");
+}
+function writeAgentsMd(cwd) {
+  const agentsMdPath = (0, import_node_path.join)(cwd, "AGENTS.md");
+  const START_MARKER = "<!-- pawl:start -->";
+  const END_MARKER = "<!-- pawl:end -->";
+  const block = [
+    START_MARKER,
+    "## Pawl Project Context",
+    "",
+    "This project uses Pawl for spec management and AI session tracking.",
+    "Structured context files are available at:",
+    "",
+    "- `.pawl/context.md` \u2014 project index, spec map, health overview",
+    "- `.pawl/specs/` \u2014 individual spec files (one per feature area)",
+    "- `.pawl/progress.md` \u2014 last session summary, recent decisions",
+    "",
+    "**Start here**: Read `.pawl/context.md` first, then load relevant",
+    "spec files from `.pawl/specs/` based on the task at hand.",
+    END_MARKER
+  ].join("\n");
+  if (!(0, import_node_fs.existsSync)(agentsMdPath)) {
+    (0, import_node_fs.writeFileSync)(agentsMdPath, block + "\n", "utf-8");
+    return;
+  }
+  let content = (0, import_node_fs.readFileSync)(agentsMdPath, "utf-8");
+  const startIdx = content.indexOf(START_MARKER);
+  const endIdx = content.indexOf(END_MARKER);
+  if (startIdx !== -1 && endIdx !== -1) {
+    content = content.slice(0, startIdx) + block + content.slice(endIdx + END_MARKER.length);
+  } else {
+    content = content.trimEnd() + "\n\n" + block + "\n";
+  }
+  (0, import_node_fs.writeFileSync)(agentsMdPath, content, "utf-8");
+}
+function printSummary(detected, hasKey) {
+  console.log("\n  Pawl initialized.\n");
+  console.log("  Detected agents:");
+  if (detected.hasCC) {
+    console.log("    Claude Code   \u2713  hooks installed (.claude/settings.json)");
+  }
+  if (detected.hasGemini) {
+    console.log("    Gemini CLI    \u2713  hooks installed (.gemini/settings.json)");
+  }
+  console.log("    Codex / other    no lifecycle hooks \u2014 git post-commit fallback active");
+  console.log("\n  Files written:");
+  console.log("    .pawl/sync.sh");
+  console.log("    .pawl/parse-cc-session.js");
+  console.log("    CLAUDE.md        (pawl context block updated)");
+  console.log("    AGENTS.md        (pawl context block \u2014 readable by Codex, Kiro, and others)");
+  if (detected.hasGitDir) {
+    console.log("    .git/hooks/post-commit  (universal sync fallback)");
+  }
+  console.log("    .gitignore       (updated)");
+  if (detected.hasGitDir) {
+    console.log("\n  Note: .git/hooks/post-commit is per-machine \u2014 not committed to the repo.");
+    console.log("        Each team member should run: pawl init");
+  } else {
+    console.log("\n  Note: git repo not detected \u2014 post-commit hook skipped.");
+  }
+  if (!hasKey) {
+    console.log("\n  Sync is not yet connected to the Pawl dashboard.");
+    console.log("  To enable: pawl init <YOUR_PROJECT_KEY>");
+    console.log("  Get your key at: https://pawl.dev/settings");
+  } else {
+    console.log("\n  .pawl/.env written \u2014 sync is connected.");
+  }
+  console.log("");
+}
 function writeEnvFile(cwd, config) {
   const dir = (0, import_node_path.join)(cwd, ".agentmap");
   (0, import_node_fs.mkdirSync)(dir, { recursive: true });
@@ -212,14 +748,14 @@ esac
   (0, import_node_fs.writeFileSync)(scriptPath, script, "utf-8");
   (0, import_node_fs.chmodSync)(scriptPath, 493);
 }
-function copyParserScript(cwd) {
+function copyParserScript(cwd, destDir = ".agentmap") {
   const src = (0, import_node_path.join)(__dirname, "parse-cc-session.js");
-  const dest = (0, import_node_path.join)(cwd, ".agentmap", "parse-cc-session.js");
+  const dest = (0, import_node_path.join)(cwd, destDir, "parse-cc-session.js");
   if ((0, import_node_fs.existsSync)(src)) {
     (0, import_node_fs.copyFileSync)(src, dest);
   }
 }
-function mergeClaudeSettings(cwd) {
+function mergeClaudeSettings(cwd, basePath = ".agentmap") {
   const claudeDir = (0, import_node_path.join)(cwd, ".claude");
   (0, import_node_fs.mkdirSync)(claudeDir, { recursive: true });
   const settingsPath = (0, import_node_path.join)(claudeDir, "settings.json");
@@ -234,7 +770,7 @@ function mergeClaudeSettings(cwd) {
     SessionStart: [
       {
         hooks: [
-          { type: "command", command: ".agentmap/sync.sh pull" }
+          { type: "command", command: `${basePath}/sync.sh pull` }
         ]
       }
     ],
@@ -244,7 +780,7 @@ function mergeClaudeSettings(cwd) {
         hooks: [
           {
             type: "command",
-            command: "jq -r '.tool_input.file_path' >> .agentmap/.tracked-files"
+            command: `jq -r '.tool_input.file_path' >> ${basePath}/.tracked-files`
           }
         ]
       }
@@ -252,7 +788,7 @@ function mergeClaudeSettings(cwd) {
     Stop: [
       {
         hooks: [
-          { type: "command", command: ".agentmap/sync.sh push" }
+          { type: "command", command: `${basePath}/sync.sh push` }
         ]
       }
     ]
@@ -320,7 +856,13 @@ function updateGitignore(cwd) {
     ".agentmap/.last-sync-sha",
     ".agentmap/context.md",
     ".agentmap/specs/",
-    ".agentmap/progress.md"
+    ".agentmap/progress.md",
+    ".pawl/.env",
+    ".pawl/.tracked-files",
+    ".pawl/.last-sync-sha",
+    ".pawl/context.md",
+    ".pawl/specs/",
+    ".pawl/progress.md"
   ];
   const missing = toAdd.filter((line) => !lines.includes(line));
   if (missing.length > 0) {
@@ -333,4 +875,7 @@ function updateGitignore(cwd) {
     (0, import_node_fs.writeFileSync)(gitignorePath, newContent, "utf-8");
   }
 }
-main();
+main().catch((err) => {
+  console.error(err.message || err);
+  process.exit(1);
+});

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@getpawl/setup",
-  "version": "1.0.1",
+  "version": "1.1.1",
   "type": "commonjs",
   "description": "One-shot setup for Pawl + Claude Code hooks",
   "bin": {
-    "pawl-setup": "./dist/index.js"
+    "pawl": "dist/index.js",
+    "pawl-setup": "dist/index.js"
   },
   "scripts": {
     "build": "tsup",
+    "test": "node --test test/e2e.test.mjs",
     "lint": "tsc --noEmit",
     "prepublishOnly": "pnpm build"
   },
@@ -20,7 +22,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/0xfishbone/agentMap.git",
+    "url": "git+https://github.com/0xfishbone/agentMap.git",
     "directory": "packages/setup"
   },
   "devDependencies": {