@buffbirb/unclaude 1.0.1 → 1.0.3

package/README.md

@@ -13,13 +13,13 @@ I also added a few broadly useful tools to cut tokens and leverage SDD, which I
 Recommended for local installs, launch the TUI:
 
 ```sh
-npx unclaude
+npx @buffbirb/unclaude
 ```
 
 Recommended for cloud pre-session installs, run in CLI mode:
 
 ```sh
-npx unclaude install --git-user "Your Name" --git-email "you@example.com"
+npx @buffbirb/unclaude install --git-user "Your Name" --git-email "you@example.com"
 ```
 
 If the cloud agent doesn't support pre-session scripts, run locally with `.gitignore` disabled and commit to the repo.

package/dist/cli.js

@@ -5,6 +5,8 @@ import { Command } from 'commander';
 import { App } from './install.js';
 import { runInstall } from './install.js';
 import { runUninstall } from './uninstall.js';
+import { writeFileSync, appendFileSync } from 'fs';
+import { resolve } from 'path';
 import { FEATURE_ORDER, DEFAULT_FEATURES, addGitignoreEntries, removeGitignoreEntries } from './common.js';
 const AGENTS = ['claudeCode', 'openCode'];
 const SCOPES = ['global', 'project'];
@@ -39,6 +41,20 @@ function consoleUpdateStep(id, update) {
         console.log(`  ${update.line}`);
     }
 }
+function makeUpdateStep(logPath) {
+    if (logPath)
+        writeFileSync(logPath, '');
+    return (id, update) => {
+        consoleUpdateStep(id, update);
+        if (!logPath)
+            return;
+        const ts = new Date().toISOString();
+        if (update.status)
+            appendFileSync(logPath, `${ts} [${id}] ${update.status}\n`);
+        if (update.line)
+            appendFileSync(logPath, `${ts} [${id}]   ${update.line}\n`);
+    };
+}
 const program = new Command();
 program
     .command('install')
@@ -50,6 +66,7 @@ program
     .option('--git-user <name>', 'git user.name to embed in hooks and agent md files')
     .option('--git-email <email>', 'git user.email to embed in hooks and agent md files')
     .option('--branch-prefix <prefix>', 'prefix for renamed claude/* branches')
+    .option('--debug', 'write timestamped log to unclaude-debug.log')
     .action((opts, cmd) => {
     let selection;
     try {
@@ -58,16 +75,22 @@ program
     catch (e) {
         cmd.error(String(e instanceof Error ? e.message : e));
     }
+    const logPath = opts.debug ? resolve('unclaude-debug.log') : false;
     const personalize = !!(opts.gitUser || opts.gitEmail || opts.branchPrefix);
     const formState = { personalize, gitUser: opts.gitUser ?? '', gitEmail: opts.gitEmail ?? '', branchPrefix: opts.branchPrefix ?? '' };
-    runInstall(selection, formState, consoleUpdateStep)
+    runInstall(selection, formState, makeUpdateStep(logPath))
         .then(() => {
         if (opts.gitignore)
             addGitignoreEntries(selection.features);
         console.log('Install complete.');
-        process.exit(0);
+        process.exitCode = 0;
     })
-        .catch((e) => { console.error(e); process.exit(1); });
+        .catch((e) => {
+        if (logPath)
+            appendFileSync(logPath, `${new Date().toISOString()} ERROR: ${e}\n`);
+        console.error(e);
+        process.exitCode = 1;
+    });
 });
 program
     .command('uninstall')
@@ -76,6 +99,7 @@ program
     .option('--scopes <list>', `comma-separated scopes (default: all) — ${SCOPES.join(', ')}`)
     .option('--features <list>', `comma-separated features (default: all) — ${FEATURES.join(', ')}`)
     .option('--no-gitignore', 'skip removing generated project-scope files from .gitignore')
+    .option('--debug', 'write timestamped log to unclaude-debug.log')
     .action((opts, cmd) => {
     let selection;
     try {
@@ -84,14 +108,20 @@ program
     catch (e) {
         cmd.error(String(e instanceof Error ? e.message : e));
     }
-    runUninstall(selection, consoleUpdateStep)
+    const logPath = opts.debug ? resolve('unclaude-debug.log') : false;
+    runUninstall(selection, makeUpdateStep(logPath))
         .then(() => {
         if (opts.gitignore)
             removeGitignoreEntries();
         console.log('Uninstall complete.');
-        process.exit(0);
+        process.exitCode = 0;
     })
-        .catch((e) => { console.error(e); process.exit(1); });
+        .catch((e) => {
+        if (logPath)
+            appendFileSync(logPath, `${new Date().toISOString()} ERROR: ${e}\n`);
+        console.error(e);
+        process.exitCode = 1;
+    });
 });
 if (process.argv.length <= 2) {
     render(_jsx(App, {}));

package/dist/install.js

@@ -246,9 +246,12 @@ export async function runInstall(selection, formState, updateStep) {
         }
         else {
             scopes.delete('project');
+            if (scopes.size === 0) {
+                throw new Error('Project scope requested but no git repo found in cwd or any subdirectory with a .git dir touched in the last 120s.');
+            }
         }
     }
-    const scopeOk = (feat) => scopes.size === 0 || FEATURE_SCOPES[feat].some(s => scopes.has(s));
+    const scopeOk = (feat) => FEATURE_SCOPES[feat].some(s => scopes.has(s));
     const tasks = [];
     if (features.has('headroom') && scopeOk('headroom'))
         tasks.push(['headroom', () => installHeadroom(l => updateStep('headroom', { line: l }))]);

package/dist/uninstall.js

@@ -286,7 +286,7 @@ async function uninstallOpenspec(scopes, onLine) {
 // ── Orchestrator ──────────────────────────────────────────────────────────────
 export async function runUninstall(selection, updateStep) {
     const { features, scopes, agents, lspLanguages } = selection;
-    const scopeOk = (feat) => scopes.size === 0 || FEATURE_SCOPES[feat].some(s => scopes.has(s));
+    const scopeOk = (feat) => FEATURE_SCOPES[feat].some(s => scopes.has(s));
     const tasks = [];
     if (features.has('headroom') && scopeOk('headroom'))
         tasks.push(['headroom', () => uninstallHeadroom(l => updateStep('headroom', { line: l }))]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buffbirb/unclaude",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "An opinionated AI dev tool setup script with a terminal UI. Configure privacy, code intelligence, and tool wrappers for Claude Code and OpenCode.",
   "type": "module",
   "keywords": [