productkit 1.1.0 → 1.3.0

package/README.md

@@ -94,6 +94,8 @@ These markdown files are your product foundation — share them with your team,
 | Command | Description |
 |---------|-------------|
 | `productkit init <name>` | Scaffold a new project |
+| `productkit init --existing` | Add Product Kit to the current directory |
+| `productkit status` | Show progress — which artifacts exist and what's next |
 | `productkit check` | Verify Claude Code is installed |
 
 ## How It Works

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "productkit",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Slash-command-driven product thinking toolkit for Claude Code",
   "main": "src/cli.js",
   "bin": {

package/src/cli.js

@@ -4,17 +4,19 @@ const { Command } = require('commander');
 const chalk = require('chalk');
 const initCommand = require('./commands/init');
 const checkCommand = require('./commands/check');
+const statusCommand = require('./commands/status');
 
 const program = new Command();
 
 program
   .name('productkit')
   .description(chalk.cyan.bold('Product thinking toolkit for Claude Code'))
-  .version('1.1.0');
+  .version('1.3.0');
 
 program
-  .command('init <projectName>')
+  .command('init [projectName]')
   .description('Initialize a new product research project')
+  .option('--existing', 'Add Product Kit to the current directory')
   .action(initCommand);
 
 program
@@ -22,6 +24,11 @@ program
   .description('Verify Claude Code is installed and available')
   .action(checkCommand);
 
+program
+  .command('status')
+  .description('Show which artifacts exist and what steps remain')
+  .action(statusCommand);
+
 program.parse(process.argv);
 
 if (process.argv.length === 2) {

package/src/commands/init.js

@@ -2,53 +2,94 @@ const fs = require('fs-extra');
 const path = require('path');
 const chalk = require('chalk');
 
-async function init(projectName) {
-  const projectRoot = path.join(process.cwd(), projectName);
+function scaffold(projectRoot, projectName) {
+  const templatesDir = path.join(__dirname, '..', '..', 'templates');
 
-  if (fs.existsSync(projectRoot)) {
-    console.error(chalk.red(`Error: Directory "${projectName}" already exists`));
-    process.exit(1);
-  }
+  // Create directories
+  fs.ensureDirSync(path.join(projectRoot, '.productkit'));
+  fs.ensureDirSync(path.join(projectRoot, '.claude', 'commands'));
 
-  try {
-    const templatesDir = path.join(__dirname, '..', '..', 'templates');
-
-    // Create directories
-    fs.ensureDirSync(path.join(projectRoot, '.productkit'));
-    fs.ensureDirSync(path.join(projectRoot, '.claude', 'commands'));
-
-    // Write config
-    fs.writeJsonSync(path.join(projectRoot, '.productkit', 'config.json'), {
-      version: '1.0.0',
-      created: new Date().toISOString(),
-    }, { spaces: 2 });
-
-    // Copy slash command templates
-    const commandsDir = path.join(templatesDir, 'commands');
-    const commandFiles = fs.readdirSync(commandsDir);
-    for (const file of commandFiles) {
-      fs.copyFileSync(
-        path.join(commandsDir, file),
-        path.join(projectRoot, '.claude', 'commands', file)
-      );
-    }
+  // Write config
+  fs.writeJsonSync(path.join(projectRoot, '.productkit', 'config.json'), {
+    version: '1.0.0',
+    created: new Date().toISOString(),
+  }, { spaces: 2 });
 
-    // Copy CLAUDE.md
+  // Copy slash command templates
+  const commandsDir = path.join(templatesDir, 'commands');
+  const commandFiles = fs.readdirSync(commandsDir);
+  for (const file of commandFiles) {
     fs.copyFileSync(
-      path.join(templatesDir, 'CLAUDE.md'),
-      path.join(projectRoot, 'CLAUDE.md')
+      path.join(commandsDir, file),
+      path.join(projectRoot, '.claude', 'commands', file)
     );
+  }
 
-    // Copy README.md with project name substitution
+  // Copy CLAUDE.md (don't overwrite existing)
+  const claudeMdPath = path.join(projectRoot, 'CLAUDE.md');
+  if (!fs.existsSync(claudeMdPath)) {
+    fs.copyFileSync(path.join(templatesDir, 'CLAUDE.md'), claudeMdPath);
+  } else {
+    const existing = fs.readFileSync(claudeMdPath, 'utf-8');
+    const template = fs.readFileSync(path.join(templatesDir, 'CLAUDE.md'), 'utf-8');
+    fs.writeFileSync(claudeMdPath, existing + '\n' + template);
+  }
+
+  // Copy README.md with project name substitution (only for new projects)
+  if (!fs.existsSync(path.join(projectRoot, 'README.md'))) {
     let readme = fs.readFileSync(path.join(templatesDir, 'README.md'), 'utf-8');
     readme = readme.replace(/\{\{PROJECT_NAME\}\}/g, projectName);
     fs.writeFileSync(path.join(projectRoot, 'README.md'), readme);
+  }
 
-    // Copy .gitignore
+  // Copy .gitignore (only for new projects)
+  if (!fs.existsSync(path.join(projectRoot, '.gitignore'))) {
     fs.copyFileSync(
       path.join(templatesDir, 'gitignore'),
       path.join(projectRoot, '.gitignore')
     );
+  }
+}
+
+async function init(projectName, options) {
+  if (options.existing) {
+    const projectRoot = process.cwd();
+
+    if (fs.existsSync(path.join(projectRoot, '.productkit'))) {
+      console.error(chalk.red('Error: This directory is already a Product Kit project.'));
+      process.exit(1);
+    }
+
+    try {
+      scaffold(projectRoot, path.basename(projectRoot));
+
+      console.log(chalk.green.bold('Product Kit added to existing project!'));
+      console.log();
+      console.log(chalk.cyan('Next steps:'));
+      console.log('  1. claude');
+      console.log('  2. /productkit.constitution');
+      console.log();
+    } catch (error) {
+      console.error(chalk.red('Error initializing:'), error.message);
+      process.exit(1);
+    }
+    return;
+  }
+
+  if (!projectName) {
+    console.error(chalk.red('Error: Project name is required. Use --existing to init in current directory.'));
+    process.exit(1);
+  }
+
+  const projectRoot = path.join(process.cwd(), projectName);
+
+  if (fs.existsSync(projectRoot)) {
+    console.error(chalk.red(`Error: Directory "${projectName}" already exists`));
+    process.exit(1);
+  }
+
+  try {
+    scaffold(projectRoot, projectName);
 
     // Init git repo
     const { execSync } = require('child_process');

package/src/commands/status.js

@@ -0,0 +1,66 @@
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+
+const ARTIFACTS = [
+  { file: 'constitution.md', command: '/productkit.constitution', label: 'Constitution' },
+  { file: 'users.md', command: '/productkit.users', label: 'Users' },
+  { file: 'problem.md', command: '/productkit.problem', label: 'Problem' },
+  { file: 'assumptions.md', command: '/productkit.assumptions', label: 'Assumptions' },
+  { file: 'solution.md', command: '/productkit.solution', label: 'Solution' },
+  { file: 'priorities.md', command: '/productkit.prioritize', label: 'Priorities' },
+  { file: 'spec.md', command: '/productkit.spec', label: 'Spec' },
+];
+
+async function status() {
+  const root = process.cwd();
+  const configPath = path.join(root, '.productkit', 'config.json');
+
+  if (!fs.existsSync(configPath)) {
+    console.error(chalk.red('Not a Product Kit project.'));
+    console.log('Run: productkit init <name>');
+    process.exit(1);
+  }
+
+  const done = [];
+  const remaining = [];
+
+  for (const artifact of ARTIFACTS) {
+    const exists = fs.existsSync(path.join(root, artifact.file));
+    if (exists) {
+      done.push(artifact);
+    } else {
+      remaining.push(artifact);
+    }
+  }
+
+  console.log();
+  console.log(chalk.bold(`Progress: ${done.length}/${ARTIFACTS.length} artifacts`));
+  console.log();
+
+  if (done.length > 0) {
+    console.log(chalk.green.bold('Completed:'));
+    for (const a of done) {
+      console.log(chalk.green(`  done  ${a.label} (${a.file})`));
+    }
+    console.log();
+  }
+
+  if (remaining.length > 0) {
+    console.log(chalk.yellow.bold('Remaining:'));
+    for (const a of remaining) {
+      console.log(chalk.yellow(`  todo  ${a.label} — run ${a.command}`));
+    }
+    console.log();
+  }
+
+  if (remaining.length === 0) {
+    console.log(chalk.green.bold('All artifacts complete!'));
+    console.log();
+  } else {
+    console.log(chalk.cyan(`Next step: ${remaining[0].command}`));
+    console.log();
+  }
+}
+
+module.exports = status;