claude-setup 1.0.0 → 1.1.1

package/dist/commands/add.js

@@ -30,17 +30,18 @@ export async function runAdd() {
         return;
     }
     if (isSingleFileOperation(userInput)) {
-        console.log(`
-For single changes, Claude Code is faster:
-  Just tell it: "${userInput}"
-
-Use claude-setup add when the change spans multiple files —
-capabilities that need documentation, MCP servers, skills, and hooks together.
+        console.log(`
+For single changes, Claude Code is faster:
+  Just tell it: "${userInput}"
+
+Use claude-setup add when the change spans multiple files —
+capabilities that need documentation, MCP servers, skills, and hooks together.
     `);
         return;
     }
     const state = await readState();
-    const collected = await collectProjectFiles();
+    // add only needs config files — source files are irrelevant and waste tokens
+    const collected = await collectProjectFiles(process.cwd(), "configOnly");
     const content = buildAddCommand(userInput, collected, state);
     ensureDir(".claude/commands");
     writeFileSync(".claude/commands/stack-add.md", content, "utf8");

package/dist/commands/init.js

@@ -10,7 +10,7 @@ function ensureDir(dir) {
 }
 export async function runInit() {
     const state = await readState();
-    const collected = await collectProjectFiles();
+    const collected = await collectProjectFiles(process.cwd(), "deep");
     ensureDir(".claude/commands");
     if (isEmptyProject(collected)) {
         const content = buildEmptyProjectCommand();

package/dist/commands/remove.js

@@ -24,7 +24,7 @@ export async function runRemove() {
         return;
     }
     const state = await readState();
-    const collected = await collectProjectFiles();
+    const collected = await collectProjectFiles(process.cwd(), "configOnly");
     const content = buildRemoveCommand(userInput, state);
     ensureDir(".claude/commands");
     writeFileSync(".claude/commands/stack-remove.md", content, "utf8");

package/dist/commands/sync.js

@@ -42,7 +42,7 @@ export async function runSync() {
         return;
     }
     const lastRun = manifest.runs.at(-1);
-    const collected = await collectProjectFiles();
+    const collected = await collectProjectFiles(process.cwd(), "normal");
     const diff = computeDiff(lastRun.snapshot, collected);
     if (!diff.added.length && !diff.changed.length && !diff.deleted.length) {
         console.log(`✅ No changes since ${lastRun.at}. Setup is current.`);

package/dist/config.d.ts

@@ -0,0 +1,15 @@
+export interface SetupConfig {
+    maxSourceFiles: number;
+    maxDepth: number;
+    maxFileSizeKB: number;
+    tokenBudget: {
+        init: number;
+        sync: number;
+        add: number;
+        remove: number;
+    };
+    digestMode: boolean;
+    extraBlockedDirs: string[];
+    sourceDirs: string[];
+}
+export declare function loadConfig(cwd?: string): SetupConfig;

package/dist/config.js

@@ -0,0 +1,42 @@
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+const DEFAULTS = {
+    maxSourceFiles: 15,
+    maxDepth: 6,
+    maxFileSizeKB: 80,
+    tokenBudget: {
+        init: 12_000,
+        sync: 6_000,
+        add: 3_000,
+        remove: 2_000,
+    },
+    digestMode: true,
+    extraBlockedDirs: [],
+    sourceDirs: [],
+};
+const CONFIG_FILENAME = ".claude-setup.json";
+export function loadConfig(cwd = process.cwd()) {
+    const configPath = join(cwd, CONFIG_FILENAME);
+    if (!existsSync(configPath))
+        return { ...DEFAULTS };
+    try {
+        const raw = JSON.parse(readFileSync(configPath, "utf8"));
+        return {
+            maxSourceFiles: raw.maxSourceFiles ?? DEFAULTS.maxSourceFiles,
+            maxDepth: raw.maxDepth ?? DEFAULTS.maxDepth,
+            maxFileSizeKB: raw.maxFileSizeKB ?? DEFAULTS.maxFileSizeKB,
+            tokenBudget: {
+                init: raw.tokenBudget?.init ?? DEFAULTS.tokenBudget.init,
+                sync: raw.tokenBudget?.sync ?? DEFAULTS.tokenBudget.sync,
+                add: raw.tokenBudget?.add ?? DEFAULTS.tokenBudget.add,
+                remove: raw.tokenBudget?.remove ?? DEFAULTS.tokenBudget.remove,
+            },
+            digestMode: raw.digestMode ?? DEFAULTS.digestMode,
+            extraBlockedDirs: raw.extraBlockedDirs ?? DEFAULTS.extraBlockedDirs,
+            sourceDirs: raw.sourceDirs ?? DEFAULTS.sourceDirs,
+        };
+    }
+    catch {
+        return { ...DEFAULTS };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-setup",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Setup layer for Claude Code — reads your project, writes command files, Claude Code does the rest",
   "type": "module",
   "bin": {

package/templates/add.md

@@ -1,20 +1,11 @@
-<!-- Generated by claude-setup add — {{DATE}} -->
-<!-- Run /stack-add in Claude Code -->
+<!-- claude-setup add {{DATE}} -->
 
-The developer wants to add this to their Claude Code setup:
-"{{USER_INPUT}}"
-
----
+Add to Claude Code setup: "{{USER_INPUT}}"
 
 ## Project context
+{{PROJECT_CONTEXT}}
 
-{{CONFIG_FILES}}
-
-{{SOURCE_FILES}}
-
----
-
-## Current setup — read before writing anything
+## Current setup
 
 {{#if HAS_CLAUDE_MD}}
 ### CLAUDE.md
@@ -27,38 +18,16 @@ The developer wants to add this to their Claude Code setup:
 {{/if}}
 
 {{#if HAS_SETTINGS}}
-### .claude/settings.json
+### settings.json
 {{SETTINGS_CONTENT}}
 {{/if}}
 
-Skills installed:   {{SKILLS_LIST}}
-Commands installed: {{COMMANDS_LIST}}
-
----
-
-## Your job
-
-Figure out which files need to change to fulfill the request.
-Adding a capability to Claude Code is rarely one file — it usually means touching
-CLAUDE.md, possibly an MCP entry, possibly a skill, possibly a hook.
-
-For every file you touch:
-- Read its current content above first
-- Merge and append only
-- Do not duplicate what already exists
-- Extend existing files rather than creating parallel ones
-
-If the request mentions something not evidenced in the project files: say so and ask
-whether they want to add it generically or need to add the underlying service first.
-
----
-
-## Output format — strict
-
-Updated:
-  ✅ [path] — [what changed and why]
+Skills: {{SKILLS_LIST}} | Commands: {{COMMANDS_LIST}}
 
-Skipped:
-  ⏭  [path] — [why not needed for this request]
+## Rules
+- Read current content before writing. Merge/append only.
+- If request mentions something not in project files: ask first.
 
-One line per file. Nothing else.
+## Output — one line per file
+Updated: ✅ [path] — [what and why]
+Skipped: ⏭ [path] — [why]

package/templates/init.md

@@ -1,132 +1,49 @@
-<!-- Generated by claude-setup {{VERSION}} on {{DATE}} — DO NOT hand-edit -->
-<!-- Run /stack-init in Claude Code -->
+<!-- claude-setup {{VERSION}} {{DATE}} -->
 
-You are setting up this project for Claude Code.
-Read everything below. Understand the project yourself. Then act.
-Do not ask clarifying questions — reason from what you see.
+Set up this project for Claude Code. Reason from what you see. Don't ask questions.
 
----
+## Project
 
-## Project files
+{{PROJECT_CONTEXT}}
 
-### Configuration and manifest files
+{{#if HAS_SOURCE}}
+## Source samples
 
-{{CONFIG_FILES}}
-
-### Source files sampled
-
-{{SOURCE_FILES}}
-
-{{#if HAS_SKIPPED}}
-### Files skipped (too large or filtered)
-
-{{SKIPPED_LIST}}
+{{SOURCE_CONTEXT}}
 {{/if}}
 
----
-
-## Existing Claude Code setup — READ EVERY LINE BEFORE TOUCHING ANYTHING
+## Existing setup — READ BEFORE WRITING
 
 {{#if HAS_CLAUDE_MD}}
-### CLAUDE.md — EXISTS — append only, never rewrite, never remove
+### CLAUDE.md (exists — append only)
 {{CLAUDE_MD_CONTENT}}
 {{else}}
-CLAUDE.md → does not exist (create it)
+CLAUDE.md: does not exist (create it)
 {{/if}}
 
 {{#if HAS_MCP_JSON}}
-### .mcp.json — EXISTS — merge only, never remove existing entries
+### .mcp.json (exists — merge only)
 {{MCP_JSON_CONTENT}}
 {{else}}
-.mcp.json → does not exist (create only if you find evidence of external services)
+.mcp.json: create only if services evidenced above
 {{/if}}
 
 {{#if HAS_SETTINGS}}
-### .claude/settings.json — EXISTS — merge only, never remove existing hooks
+### settings.json (exists — merge only)
 {{SETTINGS_CONTENT}}
 {{else}}
-.claude/settings.json → does not exist (create only if hooks are warranted)
+settings.json: create only if hooks warranted
 {{/if}}
 
-Skills installed:    {{SKILLS_LIST}}
-Commands installed:  {{COMMANDS_LIST}}
-Workflows installed: {{WORKFLOWS_LIST}}
-.github/ exists:     {{HAS_GITHUB_DIR}}
-
----
-
-## Your job
-
-Read the files above. Figure out the project from what you see — language, runtime,
-dependencies, structure, conventions. Do not assume anything not visible in the files.
-
-Then write the Claude Code setup for THIS specific project.
-
-### CLAUDE.md
-
-Always write or update this. It is the most valuable artifact.
-Make it specific: reference actual file paths from the project, actual patterns you saw
-in the source, actual conventions the code follows.
-Generic advice that could apply to any project belongs in documentation, not here.
-
-If it exists: read it fully above first. Add only what is genuinely missing. Never remove.
-
-### .mcp.json
-
-Only if you found evidence of external services in the config files, dependencies,
-or environment template. Evidence means it appears in the files above.
-No evidence = no server. Do not invent services that were not in scope.
-If it exists: add to it. Never remove existing entries. Produce valid JSON.
-
-### .claude/settings.json
-
-Only if hooks genuinely earn their cost for this specific project.
-Every hook adds overhead on every Claude Code action.
-If it exists: add to it. Never remove existing hooks. Never modify existing values.
-
-### .claude/skills/
-
-Only for patterns that recur across this codebase and benefit from automatic loading.
-Use `applies-when` frontmatter so skills load only when relevant — not on every message.
-If a similar skill already exists: extend it. Do not create a parallel one.
-
-### .github/workflows/
-
-Only if `.github/` exists ({{HAS_GITHUB_DIR}}).
-Only workflows warranted by what you found.
-If workflows already exist: do not touch them.
-
----
-
-## Absolute rules
-
-1. You have the full content of every existing Claude config file above.
-   Read it before writing. Never write blind.
-
-2. Append and merge only. Never rewrite a file in full. Never remove existing content.
-
-3. Write only what is evidenced by the project files. No evidence = skip it.
-
-4. Every line in CLAUDE.md must reference something you actually saw.
-   No generic boilerplate. No advice identical for every project.
-
-5. MCP servers, skills, and hooks add cost on every Claude Code session.
-   Only add them if they clearly earn their keep for THIS project.
-
----
-
-## Output format — hard constraint, no exceptions
-
-After completing all work, output ONLY:
-
-Created:
-  ✅ [path] — [one clause: what you saw that justified it]
-
-Updated:
-  ✅ [path] — [one clause: what was added]
+Skills: {{SKILLS_LIST}} | Commands: {{COMMANDS_LIST}} | Workflows: {{WORKFLOWS_LIST}} | .github: {{HAS_GITHUB_DIR}}
 
-Skipped:
-  ⏭  [path] — [one clause: why not needed]
+## Rules
+1. Read existing content above before writing. Never write blind.
+2. Append/merge only. Never rewrite or remove.
+3. Every line must trace to something in the project. No generic boilerplate.
+4. MCP/skills/hooks cost tokens every session. Only add if clearly earned.
 
-No summaries. No file contents. No "here's what I built."
-One line per file. Then stop.
+## Output — one line per file, nothing else
+Created: ✅ [path] — [why]
+Updated: ✅ [path] — [what added]
+Skipped: ⏭ [path] — [why not needed]

package/templates/remove.md

@@ -1,12 +1,8 @@
-<!-- Generated by claude-setup remove — {{DATE}} -->
-<!-- Run /stack-remove in Claude Code -->
+<!-- claude-setup remove {{DATE}} -->
 
-Remove this from the Claude Code setup:
-"{{USER_INPUT}}"
+Remove from setup: "{{USER_INPUT}}"
 
----
-
-## Current setup — read everything before touching any file
+## Current setup
 
 {{#if HAS_CLAUDE_MD}}
 ### CLAUDE.md
@@ -19,35 +15,17 @@ Remove this from the Claude Code setup:
 {{/if}}
 
 {{#if HAS_SETTINGS}}
-### .claude/settings.json
+### settings.json
 {{SETTINGS_CONTENT}}
 {{/if}}
 
-Skills:    {{SKILLS_LIST}}
-Commands:  {{COMMANDS_LIST}}
-Workflows: {{WORKFLOWS_LIST}}
-
----
-
-## Your job
-
-Find everything related to the removal request across all files above.
-Remove surgically — section by section, key by key.
-
-Rules:
-- Never delete an entire file. Remove only the relevant section.
-- Never remove content unrelated to the request.
-- After every edit, the file must remain valid (JSON stays valid JSON, etc.)
-- If not found anywhere: say so and stop.
-
----
-
-## Output format — strict
-
-Removed from:
-  ✅ [path] — [what was removed]
+Skills: {{SKILLS_LIST}} | Commands: {{COMMANDS_LIST}} | Workflows: {{WORKFLOWS_LIST}}
 
-Not found:
-  ⏭  [path] — not referenced
+## Rules
+- Remove only related content. Never delete entire files.
+- Files must remain valid after edit (JSON stays valid, etc.)
+- If not found: say so and stop.
 
-One line per file. Nothing else.
+## Output — one line per file
+Removed: ✅ [path] — [what removed]
+Not found: ⏭ [path] — not referenced

package/templates/sync.md

@@ -1,26 +1,16 @@
-<!-- Generated by claude-setup sync — {{DATE}} -->
-<!-- Last setup: {{LAST_RUN_DATE}} -->
-<!-- Run /stack-sync in Claude Code -->
+<!-- claude-setup sync {{DATE}} | last: {{LAST_RUN_DATE}} -->
 
-The project has changed since Claude Code was last set up.
-Your job: update the setup to reflect what changed. Nothing more.
+Project changed since last setup. Update only what the changes demand.
 
----
-
-## What changed since last setup
-
-### Added files
+## Changes
+### Added
 {{ADDED_FILES}}
-
-### Modified files
+### Modified
 {{MODIFIED_FILES}}
-
-### Deleted files
+### Deleted
 {{DELETED_FILES}}
 
----
-
-## Current setup — read before touching
+## Current setup
 
 {{#if HAS_CLAUDE_MD}}
 ### CLAUDE.md
@@ -33,38 +23,17 @@ Your job: update the setup to reflect what changed. Nothing more.
 {{/if}}
 
 {{#if HAS_SETTINGS}}
-### .claude/settings.json
+### settings.json
 {{SETTINGS_CONTENT}}
 {{/if}}
 
-Skills:   {{SKILLS_LIST}}
-Commands: {{COMMANDS_LIST}}
-
----
-
-## Your job
-
-For each changed file: does this change have any implication for the Claude Code setup?
-
-Reason about the signal: a new dependency, a new directory, a deleted file that was
-referenced somewhere. Update only what the change demands.
-
-Do not update things that did not change.
-Do not rewrite files — surgical edits only.
-If a change has no implication for the setup: skip it and say why.
-If you are unsure: flag it for the developer rather than guessing.
-
----
-
-## Output format — strict
-
-Updated:
-  ✅ [path] — triggered by: [which changed file and why]
-
-Skipped:
-  ⏭  [path] — [why this change has no setup implication]
+Skills: {{SKILLS_LIST}} | Commands: {{COMMANDS_LIST}}
 
-Flagged:
-  ⚠️  [something that needs the developer's decision]
+## Rules
+- Surgical edits only. Don't rewrite files. Don't update unchanged things.
+- If unsure about a change's implication: flag it, don't guess.
 
-One line per file. Nothing else.
+## Output — one line per file
+Updated: ✅ [path] — triggered by: [which change and why]
+Skipped: ⏭ [path] — [why no implication]
+Flagged: ⚠️ [needs developer decision]