@pshch/gary-the-gardener 1.2.0 → 1.3.0

package/_gs-gardener/VERSION

@@ -1 +1 @@
-1.2.0
+1.3.0

package/_gs-gardener/core/config.yaml

@@ -1,5 +1,5 @@
 # Garden System Configuration
-# Version: 1.2.0
+# Version: 1.3.0
 
 project_name: ai-bootstrap
 user_name: User
@@ -22,4 +22,4 @@ references_directory: "{project-root}/docs/references"
 agents_max_lines: 150
 
 # Garden System Version
-version: "1.2.0"
+version: "1.3.0"

package/bin/cli.js

@@ -18,15 +18,10 @@ const dim = (s) => `\x1b[2m${s}\x1b[0m`;
 const { values, positionals } = parseArgs({
   args: process.argv.slice(2),
   options: {
-    claude:  { type: 'boolean', default: false },
-    copilot: { type: 'boolean', default: false },
-    codex:   { type: 'boolean', default: false },
-    cursor:  { type: 'boolean', default: false },
-    junie:   { type: 'boolean', default: false },
-    all:     { type: 'boolean', default: false },
-    force:   { type: 'boolean', short: 'f', default: false },
-    help:    { type: 'boolean', short: 'h', default: false },
-    version: { type: 'boolean', short: 'v', default: false },
+    force:     { type: 'boolean', short: 'f', default: false },
+    'dry-run': { type: 'boolean', short: 'n', default: false },
+    help:      { type: 'boolean', short: 'h', default: false },
+    version:   { type: 'boolean', short: 'v', default: false },
   },
   allowPositionals: true,
   strict: false,
@@ -41,45 +36,34 @@ if (values.version) {
 }
 
 // ── Help ────────────────────────────────────────────────────────────
-if (values.help || !command) {
-  console.log(`
-${bold('gary-the-gardener')} v${VERSION} — Garden System installer
-
-${bold('USAGE')}
-  npx @pshch/gary-the-gardener ${green('install')} [options]
-
-${bold('COMMANDS')}
-  ${green('install')}    Install Garden System into the current project
-
-${bold('TOOL OPTIONS')}  ${dim('(pick which AI tools to set up)')}
-  --claude   Claude Code — skills, commands, CLAUDE.md wrapper
-  --copilot  GitHub Copilot — .github/copilot-instructions.md wrapper
-  --cursor   Cursor — .cursor/rules/agents.mdc wrapper
-  --codex    OpenAI Codex — codex.md wrapper
-  --junie    JetBrains Junie — .junie/guidelines.md wrapper
-  --all      All of the above
-
-  ${dim('If no tool flags given, defaults to --claude only.')}
+if (values.help) {
+  printHelp();
+  process.exit(0);
+}
 
-${bold('OTHER OPTIONS')}
-  -f, --force    Overwrite existing files
-  -v, --version  Show version
-  -h, --help     Show this help
+// ── Route commands ──────────────────────────────────────────────────
+const dryRun = values['dry-run'];
 
-${bold('EXAMPLES')}
-  npx @pshch/gary-the-gardener install
-  npx @pshch/gary-the-gardener install --all
-  npx @pshch/gary-the-gardener install --claude --cursor
-  npx @pshch/gary-the-gardener install --copilot --force
-`);
-  process.exit(0);
+if (command === 'status') {
+  runStatus();
+} else if (command === 'install' || !command) {
+  runInstall(values.force, dryRun);
+} else {
+  console.error(red(`Unknown command: ${command}`));
+  console.error('Run "npx @pshch/gary-the-gardener --help" for usage.');
+  process.exit(1);
 }
 
-// ── Install command ─────────────────────────────────────────────────
-if (command === 'install') {
+// ═══════════════════════════════════════════════════════════════════
+// ── Core functions ────────────────────────────────────────────────
+// ═══════════════════════════════════════════════════════════════════
+
+function runInstall(force, dryRun) {
   const dest = process.cwd();
 
-  console.log(`\n🪴 ${bold('Gary the Gardener')} v${VERSION}\n`);
+  console.log(`\n🪴 ${bold('Gary the Gardener')} v${VERSION}`);
+  if (dryRun) console.log(yellow(`   (dry run — no files will be written)`));
+  console.log('');
 
   // Sanity check: don't install into the package itself
   if (existsSync(join(dest, 'bin', 'cli.js')) && existsSync(join(dest, '_gs-gardener', 'core'))) {
@@ -90,117 +74,76 @@ if (command === 'install') {
     }
   }
 
-  // Determine which tools to install
-  const tools = new Set();
-  if (values.all) {
-    tools.add('claude').add('copilot').add('cursor').add('codex').add('junie');
-  } else {
-    if (values.claude)  tools.add('claude');
-    if (values.copilot) tools.add('copilot');
-    if (values.cursor)  tools.add('cursor');
-    if (values.codex)   tools.add('codex');
-    if (values.junie)   tools.add('junie');
-  }
-
-  // Default to claude if nothing specified
-  if (tools.size === 0) tools.add('claude');
-
-  // ── 1. Copy core Garden System ──────────────────────────────────
+  // ── Detect existing installation ──────────────────────────────────
   const coreSrc = join(PKG_ROOT, '_gs-gardener');
   const coreDest = join(dest, '_gs-gardener');
+  const configPath = join(coreDest, 'core', 'config.yaml');
 
-  if (existsSync(coreDest) && !values.force) {
-    console.log(yellow('  ⚠ _gs-gardener/ already exists — skipping (use --force to overwrite)'));
-  } else {
-    console.log(`  ${green('✓')} Installing core system → ${dim('_gs-gardener/')}`);
-    cpSync(coreSrc, coreDest, { recursive: true, force: values.force });
+  const installedVersion = readInstalledVersion(coreDest);
+  const isUpgrade = installedVersion && installedVersion !== VERSION;
+  const isCurrent = installedVersion === VERSION;
 
-    // Reset config.yaml to defaults for the target project
-    const projectName = basename(dest);
-    const configPath = join(coreDest, 'core', 'config.yaml');
-    const defaultConfig = `# Garden System Configuration
-# Version: ${VERSION}
-
-project_name: ${projectName}
-user_name: User
-communication_language: English
-output_folder: "{project-root}/docs"
-
-# Coverage tracking
-agents_file: "{project-root}/AGENTS.md"
-wrapper_files:
-  - "{project-root}/CLAUDE.md"
-  - "{project-root}/.github/copilot-instructions.md"
-  - "{project-root}/.cursor/rules/agents.mdc"
-  - "{project-root}/.junie/guidelines.md"
-
-# Content layers
-docs_directory: "{project-root}/docs"
-references_directory: "{project-root}/docs/references"
-
-# Constraints
-agents_max_lines: 150
-
-# Garden System Version
-version: "${VERSION}"
-`;
-    writeFileSync(configPath, defaultConfig);
+  if (isUpgrade) {
+    console.log(`  Upgrading ${dim(`v${installedVersion}`)} → ${green(`v${VERSION}`)}\n`);
+  } else if (isCurrent && !force) {
+    console.log(`  Already up to date ${dim(`(v${VERSION})`)}\n`);
   }
 
-  // ── 2. Install Claude Code commands ─────────────────────────────
-  if (tools.has('claude')) {
-    const cmdSrc = join(PKG_ROOT, '.claude', 'commands');
-    const cmdDest = join(dest, '.claude', 'commands');
-    mkdirSync(cmdDest, { recursive: true });
-
-    const gardenCmds = readdirSync(cmdSrc).filter(f => f.startsWith('garden-') && f.endsWith('.md'));
-    let copied = 0;
-    for (const file of gardenCmds) {
-      const destFile = join(cmdDest, file);
-      if (existsSync(destFile) && !values.force) continue;
-      cpSync(join(cmdSrc, file), destFile, { force: values.force });
-      copied++;
+  // ── 1. Core Garden System ─────────────────────────────────────────
+  if (isCurrent && !force) {
+    console.log(`  ${green('✓')} Core system → ${dim('_gs-gardener/ (unchanged)')}`);
+  } else {
+    // Save user config before overwriting
+    const savedConfig = isUpgrade ? safeReadFile(configPath) : null;
+
+    if (!dryRun) {
+      cpSync(coreSrc, coreDest, { recursive: true, force: true });
+
+      if (savedConfig) {
+        // Restore user config, only bump the version line
+        const updated = savedConfig
+          .replace(/^# Version: .+$/m, `# Version: ${VERSION}`)
+          .replace(/^version: .+$/m, `version: "${VERSION}"`);
+        writeFileSync(configPath, updated);
+        console.log(`  ${green('✓')} Core system → ${dim('_gs-gardener/ (upgraded, config preserved)')}`);
+      } else {
+        // Fresh install — write default config
+        const projectName = basename(dest);
+        writeFileSync(configPath, defaultConfig(projectName));
+        console.log(`  ${green('✓')} Core system → ${dim('_gs-gardener/')}`);
+      }
+    } else {
+      const label = isUpgrade ? '(would upgrade, config preserved)' : '';
+      console.log(`  ${green('✓')} Core system → ${dim(`_gs-gardener/ ${label}`)}`);
     }
-    console.log(`  ${green('✓')} Claude Code — ${copied} skill commands → ${dim('.claude/commands/')}`);
-
-    // Create CLAUDE.md wrapper
-    installWrapper(dest, 'CLAUDE.md',
-      `# CLAUDE.md\n\nFollow all instructions in the root AGENTS.md file as the primary context for this repository.\n`,
-      values.force);
   }
 
-  // ── 3. Install Copilot wrapper ──────────────────────────────────
-  if (tools.has('copilot')) {
-    mkdirSync(join(dest, '.github'), { recursive: true });
-    installWrapper(dest, '.github/copilot-instructions.md',
-      `# Copilot Instructions\n\nFollow all instructions in the root AGENTS.md file as the primary context for this repository.\n`,
-      values.force);
+  // ── 2. Claude Code skill commands ─────────────────────────────────
+  const cmdSrc = join(PKG_ROOT, '.claude', 'commands');
+  const cmdDest = join(dest, '.claude', 'commands');
+  if (!dryRun) mkdirSync(cmdDest, { recursive: true });
+
+  const gardenCmds = readdirSync(cmdSrc).filter(f => f.startsWith('garden-') && f.endsWith('.md'));
+  const shouldUpdateCmds = isUpgrade || force || !installedVersion;
+  let copied = 0;
+  for (const file of gardenCmds) {
+    const destFile = join(cmdDest, file);
+    if (existsSync(destFile) && !shouldUpdateCmds) continue;
+    if (!dryRun) cpSync(join(cmdSrc, file), destFile, { force: true });
+    copied++;
   }
-
-  // ── 4. Install Cursor wrapper ───────────────────────────────────
-  if (tools.has('cursor')) {
-    mkdirSync(join(dest, '.cursor', 'rules'), { recursive: true });
-    installWrapper(dest, '.cursor/rules/agents.mdc',
-      `---\ndescription: Primary repository context sourced from AGENTS.md\nglobs:\nalwaysApply: true\n---\n\nFollow all instructions in the root AGENTS.md file as the primary context for this repository.\n`,
-      values.force);
+  if (isCurrent && !force) {
+    console.log(`  ${green('✓')} ${gardenCmds.length} skill commands → ${dim('.claude/commands/ (unchanged)')}`);
+  } else {
+    console.log(`  ${green('✓')} ${copied} skill commands → ${dim('.claude/commands/')}`);
   }
 
-  // ── 5. Install Codex wrapper ────────────────────────────────────
-  if (tools.has('codex')) {
-    installWrapper(dest, 'codex.md',
-      `# Codex Instructions\n\nFollow all instructions in the root AGENTS.md file as the primary context for this repository.\n`,
-      values.force);
-  }
+  // ── 3. CLAUDE.md ──────────────────────────────────────────────────
+  installWrapper(dest, 'CLAUDE.md',
+    `# CLAUDE.md\n\nFollow all instructions in the root AGENTS.md file as the primary context for this repository.\n`,
+    force, dryRun);
 
-  // ── 6. Install Junie wrapper ────────────────────────────────────
-  if (tools.has('junie')) {
-    mkdirSync(join(dest, '.junie'), { recursive: true });
-    installWrapper(dest, '.junie/guidelines.md',
-      `# Junie Guidelines\n\nFollow all instructions in the root AGENTS.md file as the primary context for this repository.\n`,
-      values.force);
-  }
-
-  // ── 7. Create .aiignore if missing ──────────────────────────────
+  // ── 4. .aiignore ──────────────────────────────────────────────────
   installWrapper(dest, '.aiignore',
     `# AI Agent Ignore File
 # Prevents AI tools from reading sensitive or irrelevant files
@@ -230,44 +173,148 @@ __pycache__/
 .vscode/launch.json
 .DS_Store
 `,
-    values.force);
-
-  // ── Summary ─────────────────────────────────────────────────────
-  console.log(`\n🌱 ${bold('Installation complete!')}\n`);
-  console.log(`${bold('Installed for:')} ${[...tools].join(', ')}`);
-
-  if (!existsSync(join(dest, 'AGENTS.md'))) {
-    console.log(`\n${bold('Next steps:')}`);
-    console.log(`  1. Run ${green('claude /garden-bootstrap')} to generate AGENTS.md`);
-    console.log(`  2. Run ${green('claude /garden-audit')} to verify accuracy`);
-    console.log(`  3. Run ${green('claude /garden-extend')} to add guardrails & principles`);
+    force, dryRun);
+
+  // ── Summary ───────────────────────────────────────────────────────
+  if (dryRun) {
+    console.log(`\n${yellow(bold('Dry run complete'))} — nothing was written.\n`);
+    console.log(`Run without ${dim('--dry-run')} to install.\n`);
+  } else if (isUpgrade) {
+    console.log(`\n🌱 ${bold(`Upgrade complete!`)} ${dim(`(v${installedVersion} → v${VERSION})`)}\n`);
   } else {
-    console.log(`\n${bold('Next steps:')}`);
-    console.log(`  1. Run ${green('claude /garden-agent-gardener')} for interactive maintenance`);
-    console.log(`  2. Run ${green('claude /garden-audit')} to check for drift`);
+    console.log(`\n🌱 ${bold('Installation complete!')}\n`);
   }
 
+  console.log(`${bold('Installed:')}`);
+  console.log(`  Core system, ${gardenCmds.length} skill commands, CLAUDE.md, .aiignore\n`);
+
+  console.log(`${bold('Next steps:')}`);
+  console.log(`  1. Run ${green('claude /garden-bootstrap')} to set up AI-ready documentation`);
+  console.log(`     ${dim('Creates AGENTS.md + wrappers for your AI tools (Copilot, Cursor, etc.)')}`);
+  console.log(`  2. Run ${green('claude /garden-audit')} to verify accuracy`);
+  console.log(`  3. Run ${green('claude /garden-extend')} to add guardrails & principles`);
+
+  console.log(`\n${dim('Gary currently runs on Claude Code. Wrappers for other tools are')}`);
+  console.log(`${dim('created by the agent during bootstrap — run /garden-bootstrap to start.')}`);
+
   console.log(`\n🪴 Happy gardening!\n`);
+}
 
-} else {
-  console.error(red(`Unknown command: ${command}`));
-  console.error('Run "npx @pshch/gary-the-gardener --help" for usage.');
-  process.exit(1);
+function runStatus() {
+  const dest = process.cwd();
+
+  console.log(`\n🪴 ${bold('Garden System — Status')}\n`);
+
+  // Core system
+  const coreInstalled = existsSync(join(dest, '_gs-gardener', 'core'));
+  let coreVersion = '';
+  if (coreInstalled) {
+    try {
+      coreVersion = readFileSync(join(dest, '_gs-gardener', 'VERSION'), 'utf8').trim();
+    } catch { /* ignore */ }
+  }
+  statusLine('Core system', coreInstalled, coreInstalled ? `v${coreVersion}` : null);
+
+  // Claude Code
+  const claudeMd = existsSync(join(dest, 'CLAUDE.md'));
+  const cmdDir = join(dest, '.claude', 'commands');
+  let cmdCount = 0;
+  if (existsSync(cmdDir)) {
+    cmdCount = readdirSync(cmdDir).filter(f => f.startsWith('garden-') && f.endsWith('.md')).length;
+  }
+  statusLine('Claude Code', claudeMd || cmdCount > 0,
+    (claudeMd || cmdCount > 0) ? `CLAUDE.md + ${cmdCount} commands` : null);
+
+  // AGENTS.md
+  const agentsExists = existsSync(join(dest, 'AGENTS.md'));
+  console.log(`  ${agentsExists ? green('✓') : '○'} ${('AGENTS.md').padEnd(15)} ${agentsExists ? green('present') : yellow('not yet created (run /garden-bootstrap)')}`);
+
+  // .aiignore
+  statusLine('.aiignore', existsSync(join(dest, '.aiignore')), 'present');
+
+  // Wrappers (produced by the agent, not the CLI)
+  console.log(`\n  ${dim('Wrappers (created by /garden-bootstrap):')}`);
+  wrapperLine('Copilot', join(dest, '.github', 'copilot-instructions.md'));
+  wrapperLine('Cursor', join(dest, '.cursor', 'rules', 'agents.mdc'));
+  wrapperLine('Codex', join(dest, 'codex.md'));
+  wrapperLine('Junie', join(dest, '.junie', 'guidelines.md'));
+
+  console.log('');
+}
+
+// ═══════════════════════════════════════════════════════════════════
+// ── Helpers ──────────────────────────────────────────────────────
+// ═══════════════════════════════════════════════════════════════════
+
+function readInstalledVersion(coreDest) {
+  try {
+    return readFileSync(join(coreDest, 'VERSION'), 'utf8').trim();
+  } catch {
+    return null;
+  }
+}
+
+function safeReadFile(filePath) {
+  try {
+    return readFileSync(filePath, 'utf8');
+  } catch {
+    return null;
+  }
 }
 
-// ── Helpers ─────────────────────────────────────────────────────────
+function defaultConfig(projectName) {
+  return `# Garden System Configuration
+# Version: ${VERSION}
+
+project_name: ${projectName}
+user_name: User
+communication_language: English
+output_folder: "{project-root}/docs"
+
+# Coverage tracking
+agents_file: "{project-root}/AGENTS.md"
+wrapper_files:
+  - "{project-root}/CLAUDE.md"
+  - "{project-root}/.github/copilot-instructions.md"
+  - "{project-root}/.cursor/rules/agents.mdc"
+  - "{project-root}/.junie/guidelines.md"
+
+# Content layers
+docs_directory: "{project-root}/docs"
+references_directory: "{project-root}/docs/references"
 
-function installWrapper(dest, relPath, content, force) {
+# Constraints
+agents_max_lines: 150
+
+# Garden System Version
+version: "${VERSION}"
+`;
+}
+
+function installWrapper(dest, relPath, content, force, dryRun) {
   const fullPath = join(dest, relPath);
   if (existsSync(fullPath) && !force) {
     console.log(`  ${yellow('⚠')} ${relPath} already exists — skipping`);
     return false;
   }
-  writeFileSync(fullPath, content);
+  if (!dryRun) writeFileSync(fullPath, content);
   console.log(`  ${green('✓')} ${relPath}`);
   return true;
 }
 
+function statusLine(label, installed, detail) {
+  const icon = installed ? green('✓') : '✗';
+  const text = installed ? green(detail || 'installed') : dim('not installed');
+  console.log(`  ${icon} ${label.padEnd(15)} ${text}`);
+}
+
+function wrapperLine(label, filePath) {
+  const exists = existsSync(filePath);
+  const icon = exists ? green('✓') : dim('·');
+  const text = exists ? green('present') : dim('—');
+  console.log(`    ${icon} ${label.padEnd(13)} ${text}`);
+}
+
 function safeReadJson(path) {
   try {
     return JSON.parse(readFileSync(path, 'utf8'));
@@ -275,3 +322,38 @@ function safeReadJson(path) {
     return null;
   }
 }
+
+function printHelp() {
+  console.log(`
+${bold('gary-the-gardener')} v${VERSION} — Garden System installer
+
+${bold('USAGE')}
+  npx @pshch/gary-the-gardener [command] [options]
+
+${bold('COMMANDS')}
+  ${green('install')}    Install Gary the Gardener ${dim('(default if no command given)')}
+  ${green('status')}     Show what's currently installed
+
+${bold('WHAT GETS INSTALLED')}
+  The installer sets up Gary the Gardener agent for Claude Code:
+    • Core system        ${dim('(_gs-gardener/)')}
+    • Skill commands     ${dim('(.claude/commands/garden-*.md)')}
+    • CLAUDE.md          ${dim('(points Claude to AGENTS.md)')}
+    • .aiignore          ${dim('(keeps secrets out of AI context)')}
+
+  After installing, run ${green('claude /garden-bootstrap')} to generate
+  AGENTS.md and wrappers for your other AI tools (Copilot, Cursor, etc.).
+
+${bold('OPTIONS')}
+  -n, --dry-run  Show what would be installed, without writing files
+  -f, --force    Overwrite existing files
+  -v, --version  Show version
+  -h, --help     Show this help
+
+${bold('EXAMPLES')}
+  npx @pshch/gary-the-gardener             ${dim('# install the agent')}
+  npx @pshch/gary-the-gardener install     ${dim('# same as above')}
+  npx @pshch/gary-the-gardener status      ${dim('# check install state')}
+  npx @pshch/gary-the-gardener -f          ${dim('# reinstall / upgrade')}
+`);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pshch/gary-the-gardener",
-  "version": "1.2.0",
-  "description": "Garden System installer — AI agent configuration maintenance for any repository",
+  "version": "1.3.0",
+  "description": "Gary the Gardener — AI agent that maintains documentation and config for Claude, Copilot, Cursor, Codex, and Junie",
   "type": "module",
   "bin": {
     "gary-the-gardener": "./bin/cli.js",