promptarch 1.0.1 → 1.0.3

package/README.md

@@ -50,17 +50,19 @@ Store your API key (`pk_…`) in `~/.config/promptarch/config.json` (written wit
 ```bash
 promptarch login                  # paste the key when prompted
 promptarch login --key pk_xxx     # non-interactive (CI)
-promptarch login --url https://promptarch-preview.workers.dev   # target a non-prod deploy
 ```
 
 | Option | Description |
 |--------|-------------|
 | `--key <key>` | Provide the key non-interactively (for CI) |
-| `--url <url>` | Override the API base URL (saved to config) |
+
+> To point the CLI at a non-prod API (local dev / self-hosted), set the `PROMPTARCH_API_URL` env var.
 
 ### `promptarch init`
 
-Scan the current repository (package manifest, scripts, directory tree, README, and any existing agent config), generate a canonical **Context Pack** via the API, and write every supported format (`CLAUDE.md`, `AGENTS.md`, Cursor `.mdc`, Copilot instructions).
+Scan the current repository (stack manifest, build commands, directory tree, README, and any existing agent config), generate a canonical **Context Pack** via the API, and write every supported format (`CLAUDE.md`, `AGENTS.md`, Cursor `.mdc`, Copilot instructions).
+
+Stack detection spans ecosystems, not just Node: `package.json` (JS/TS frameworks), `Package.swift`/`.xcodeproj` (Swift), `pyproject.toml`/`requirements.txt` (Python + FastAPI/Django/Flask), `go.mod` (Go), `Cargo.toml` (Rust), and `Gemfile` (Ruby/Rails). Commands are pulled from npm scripts, `Makefile` targets, and `justfile` recipes.
 
 ```bash
 promptarch init --dry-run          # print the extracted payload, no network call
@@ -72,6 +74,9 @@ promptarch init --out ./generated  # write to a specific directory
 |--------|-------------|
 | `--dry-run` | Print the extracted payload without calling the API (no key needed) |
 | `--out <dir>` | Output directory (default: current directory) |
+| `--force` | Overwrite existing files without prompting |
+
+> If `init` would overwrite existing files (e.g. a hand-maintained `CLAUDE.md`), it lists them and asks for confirmation first. In a non-interactive shell it aborts unless you pass `--force`. Use `--out` to write elsewhere.
 
 > `init` consumes credits. The first generation on a new account is free.
 

package/dist/index.js

@@ -4,7 +4,7 @@
 import { Command } from "commander";
 
 // src/commands/init.ts
-import { mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
+import { access, mkdir as mkdir2, writeFile as writeFile2 } from "fs/promises";
 import { dirname, join as join3, resolve } from "path";
 
 // ../packages/core/context-model/types.ts
@@ -243,17 +243,21 @@ var STACK_HINTS = [
   [/^vitest$|^jest$/, "unit tests"],
   [/^@playwright\/test$|^playwright$/, "Playwright E2E"]
 ];
+var FIELD_MAX = 1900;
+function clampField(s) {
+  return s.length > FIELD_MAX ? `${s.slice(0, FIELD_MAX - 1)}\u2026` : s;
+}
 async function extractRepo(cwd) {
   const pkg = await readJson(join(cwd, "package.json"));
   const name = pkg?.name || basename(cwd);
   const description = pkg?.description || await firstReadmeParagraph(cwd) || "";
   return {
-    name,
-    description,
-    techStack: detectStack(pkg),
-    tree: await buildTree(cwd),
-    commands: formatScripts(pkg?.scripts),
-    conventions: await readExistingConfig(cwd)
+    name: clampField(name),
+    description: clampField(description),
+    techStack: clampField(await detectStack(cwd, pkg)),
+    tree: clampField(await buildTree(cwd)),
+    commands: clampField(await detectCommands(cwd, pkg)),
+    conventions: clampField(await readExistingConfig(cwd))
   };
 }
 async function readJson(path) {
@@ -263,22 +267,96 @@ async function readJson(path) {
     return null;
   }
 }
-function detectStack(pkg) {
-  if (!pkg) return "";
-  const deps = {
-    ...pkg.dependencies ?? {},
-    ...pkg.devDependencies ?? {}
-  };
-  const names = Object.keys(deps);
+async function readFileSafe(path) {
+  try {
+    return await readFile(path, "utf8");
+  } catch {
+    return null;
+  }
+}
+async function dirHasEntry(cwd, match) {
+  try {
+    const entries = await readdir(cwd);
+    return entries.some(match);
+  } catch {
+    return false;
+  }
+}
+async function detectStack(cwd, pkg) {
   const found = /* @__PURE__ */ new Set();
-  for (const [pattern, label] of STACK_HINTS) {
-    if (names.some((n) => pattern.test(n))) found.add(label);
+  if (pkg) {
+    const deps = {
+      ...pkg.dependencies ?? {},
+      ...pkg.devDependencies ?? {}
+    };
+    const names = Object.keys(deps);
+    for (const [pattern, label] of STACK_HINTS) {
+      if (names.some((n) => pattern.test(n))) found.add(label);
+    }
+  }
+  const swiftPkg = await readFileSafe(join(cwd, "Package.swift"));
+  const hasXcode = await dirHasEntry(
+    cwd,
+    (n) => n.endsWith(".xcodeproj") || n.endsWith(".xcworkspace")
+  );
+  if (swiftPkg !== null || hasXcode) {
+    found.add("Swift");
+    if (swiftPkg && /supabase/i.test(swiftPkg)) found.add("Supabase");
+  }
+  const pyproject = await readFileSafe(join(cwd, "pyproject.toml"));
+  const requirements = await readFileSafe(join(cwd, "requirements.txt"));
+  const hasSetupPy = await dirHasEntry(cwd, (n) => n === "setup.py");
+  if (pyproject !== null || requirements !== null || hasSetupPy) {
+    found.add("Python");
+    const py = `${pyproject ?? ""}
+${requirements ?? ""}`;
+    if (/fastapi/i.test(py)) found.add("FastAPI");
+    if (/\bdjango\b/i.test(py)) found.add("Django");
+    if (/\bflask\b/i.test(py)) found.add("Flask");
+    if (/sqlalchemy/i.test(py)) found.add("SQLAlchemy");
+  }
+  const gomod = await readFileSafe(join(cwd, "go.mod"));
+  if (gomod !== null) found.add("Go");
+  const cargo = await readFileSafe(join(cwd, "Cargo.toml"));
+  if (cargo !== null) {
+    found.add("Rust");
+    if (/\baxum\b/i.test(cargo)) found.add("Axum");
+    if (/actix-web/i.test(cargo)) found.add("Actix");
+  }
+  const gemfile = await readFileSafe(join(cwd, "Gemfile"));
+  if (gemfile !== null) {
+    found.add("Ruby");
+    if (/\brails\b/i.test(gemfile)) found.add("Rails");
   }
   return [...found].join(", ");
 }
-function formatScripts(scripts) {
-  if (!scripts || typeof scripts !== "object") return "";
-  return Object.entries(scripts).map(([k, v]) => `npm run ${k}: ${v}`).join("\n");
+async function detectCommands(cwd, pkg) {
+  const parts = [];
+  const scripts = pkg?.scripts;
+  if (scripts && typeof scripts === "object") {
+    parts.push(
+      Object.entries(scripts).map(([k, v]) => `npm run ${k}: ${v}`).join("\n")
+    );
+  }
+  const make = await readFileSafe(join(cwd, "Makefile"));
+  if (make) {
+    const targets = parseTargets(make);
+    if (targets.length) parts.push(targets.map((t) => `make ${t}`).join("\n"));
+  }
+  const just = await readFileSafe(join(cwd, "justfile")) ?? await readFileSafe(join(cwd, "Justfile"));
+  if (just) {
+    const recipes = parseTargets(just);
+    if (recipes.length) parts.push(recipes.map((r) => `just ${r}`).join("\n"));
+  }
+  return parts.filter(Boolean).join("\n");
+}
+function parseTargets(text) {
+  const out = [];
+  for (const line of text.split("\n")) {
+    const m = /^([a-zA-Z][\w-]*)\s*:/.exec(line);
+    if (m && m[1] !== ".PHONY") out.push(m[1]);
+  }
+  return [...new Set(out)].slice(0, 20);
 }
 async function buildTree(cwd) {
   const lines = [];
@@ -348,7 +426,31 @@ function resolveApiKey(cfg) {
   return process.env.PROMPTARCH_API_KEY || cfg.apiKey;
 }
 
+// src/prompt.ts
+import { createInterface } from "readline";
+function prompt(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(
+    (resolve2) => rl.question(question, (answer) => {
+      rl.close();
+      resolve2(answer);
+    })
+  );
+}
+async function confirm(question) {
+  const ans = (await prompt(`${question} `)).trim().toLowerCase();
+  return ans === "y" || ans === "yes";
+}
+
 // src/commands/init.ts
+async function fileExists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function initCmd(opts) {
   const cwd = process.cwd();
   const info = await extractRepo(cwd);
@@ -406,7 +508,10 @@ async function initCmd(opts) {
     return;
   }
   if (!res.ok) {
-    console.error(`Build failed (HTTP ${res.status}).`);
+    const detail = await res.json().catch(() => null);
+    console.error(
+      `Build failed (HTTP ${res.status})${detail?.error ? `: ${detail.error}` : ""}.`
+    );
     process.exitCode = 1;
     return;
   }
@@ -419,6 +524,31 @@ async function initCmd(opts) {
   const pack = parseContextModel(body.prompt);
   const files = exportPack(pack, ALL_EXPORT_FORMATS);
   const outDir = opts.out ? resolve(cwd, opts.out) : cwd;
+  if (!opts.force) {
+    const existing = [];
+    for (const f of files) {
+      if (await fileExists(join3(outDir, f.path))) existing.push(f.path);
+    }
+    if (existing.length > 0) {
+      console.log(
+        `
+These file(s) already exist in ${outDir}:
+  ${existing.join("\n  ")}`
+      );
+      if (!process.stdin.isTTY) {
+        console.error(
+          "\nAborted (non-interactive). Re-run with --force to overwrite, or --out <dir> to write elsewhere."
+        );
+        process.exitCode = 1;
+        return;
+      }
+      const ok = await confirm("\nOverwrite them? [y/N]");
+      if (!ok) {
+        console.log("Aborted. No files written.");
+        return;
+      }
+    }
+  }
   for (const f of files) {
     const dest = join3(outDir, f.path);
     await mkdir2(dirname(dest), { recursive: true });
@@ -914,7 +1044,6 @@ ${file} - grade ${report.grade} (${report.objectiveScore}/100, ${report.format})
 }
 
 // src/commands/login.ts
-import { createInterface } from "readline";
 async function login(opts) {
   let key = opts.key;
   if (!key) {
@@ -927,28 +1056,18 @@ async function login(opts) {
   }
   const cfg = await loadConfig();
   cfg.apiKey = key;
-  if (opts.url) cfg.apiUrl = opts.url;
   await saveConfig(cfg);
   console.log(`Saved credentials to ${CONFIG_PATH}`);
 }
-function prompt(question) {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise(
-    (resolve2) => rl.question(question, (answer) => {
-      rl.close();
-      resolve2(answer);
-    })
-  );
-}
 
 // src/index.ts
 var program = new Command();
 program.name("promptarch").description(
   "Generate and lint AI coding-agent context files (CLAUDE.md, AGENTS.md, Cursor rules) from your repo."
-).version("1.0.1");
-program.command("login").description("Store a PromptArch API key (pk_...) in ~/.config/promptarch").option("--key <key>", "API key (non-interactive; for CI)").option("--url <url>", "Override the API base URL").action(login);
+).version("1.0.3");
+program.command("login").description("Store a PromptArch API key (pk_...) in ~/.config/promptarch").option("--key <key>", "API key (non-interactive; for CI)").action(login);
 program.command("lint").description("Lint agent context files offline (deterministic, free, CI-friendly)").argument("<files...>", "Files to lint (CLAUDE.md, AGENTS.md, *.mdc, ...)").option("--strict", "Fail on warnings too, not just errors").action((files, opts) => lintCmd(files, opts));
-program.command("init").description("Extract repo context and generate CLAUDE.md / AGENTS.md / Cursor / Copilot files").option("--dry-run", "Print the extracted payload without calling the API").option("--out <dir>", "Output directory (default: current directory)").action(initCmd);
+program.command("init").description("Extract repo context and generate CLAUDE.md / AGENTS.md / Cursor / Copilot files").option("--dry-run", "Print the extracted payload without calling the API").option("--out <dir>", "Output directory (default: current directory)").option("--force", "Overwrite existing files without prompting").action(initCmd);
 program.parseAsync().catch((err) => {
   console.error(err instanceof Error ? err.message : String(err));
   process.exitCode = 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "promptarch",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Generate and lint AI coding-agent context files (CLAUDE.md, AGENTS.md, Cursor rules) from your repo.",
   "keywords": [
     "claude",