attacca-forge 0.5.2 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "attacca-forge",
-  "version": "0.5.2",
+  "version": "0.6.0",
   "description": "Spec-driven AI development toolkit — design, evaluate, stress-test, and certify autonomous agents from your terminal",
   "keywords": [
     "ai",
@@ -32,7 +32,7 @@
   "files": [
     "bin/",
     "src/",
-    "plugins/",
+    "skills/",
     ".claude-plugin/",
     "docs/",
     "examples/",

package/src/commands/install.js

@@ -1,10 +1,16 @@
 // =============================================================================
-// attacca-forge install — Install skills into Claude Code plugin directory
+// attacca-forge install — Install as a Claude Code marketplace + plugin
+//
+// Registration approach (same pattern as nirbound-marketplace):
+//   1. Build marketplace structure at ~/.claude/plugins/local/attacca-forge/
+//   2. Register in settings.json (extraKnownMarketplaces + enabledPlugins)
+//   3. Register in known_marketplaces.json
+//   4. Register in installed_plugins.json + populate cache
 // =============================================================================
 
-import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
-import { getClaudeDir, getPluginDir, isClaudeInstalled } from '../utils/detect-claude.js';
+import { getClaudeDir, isClaudeInstalled } from '../utils/detect-claude.js';
 
 const MARKETPLACE_NAME = 'attacca-forge';
 const PLUGIN_NAME = 'attacca-forge';
@@ -21,27 +27,107 @@ function writeJsonFile(path, data) {
   writeFileSync(path, JSON.stringify(data, null, 2) + '\n', 'utf-8');
 }
 
-function registerMarketplace(claudeDir, targetDir) {
-  const marketplacesPath = join(claudeDir, 'plugins', 'known_marketplaces.json');
-  const marketplaces = readJsonFile(marketplacesPath) || {};
+// Step 1: Build marketplace directory structure
+function buildMarketplaceStructure(rootDir, targetDir, version) {
+  // Create marketplace root
+  mkdirSync(targetDir, { recursive: true });
+
+  // Write marketplace.json at marketplace root
+  const marketplaceJsonDir = join(targetDir, '.claude-plugin');
+  mkdirSync(marketplaceJsonDir, { recursive: true });
+  writeJsonFile(join(marketplaceJsonDir, 'marketplace.json'), {
+    $schema: 'https://anthropic.com/claude-code/marketplace.schema.json',
+    name: MARKETPLACE_NAME,
+    description:
+      'Spec-driven AI development toolkit — design, evaluate, stress-test, and certify autonomous agents',
+    owner: { name: 'Attacca' },
+    plugins: [
+      {
+        name: PLUGIN_NAME,
+        description:
+          'AI agent development methodology — design, evaluate, and align autonomous agents',
+        version,
+        author: { name: 'Attacca' },
+        source: `./plugins/${PLUGIN_NAME}`,
+        category: 'development',
+      },
+    ],
+  });
+
+  // Create plugin subdirectory: plugins/attacca-forge/
+  const pluginDir = join(targetDir, 'plugins', PLUGIN_NAME);
+  mkdirSync(pluginDir, { recursive: true });
+
+  // Copy plugin.json
+  const pluginJsonDir = join(pluginDir, '.claude-plugin');
+  mkdirSync(pluginJsonDir, { recursive: true });
+  const sourcePluginJson = join(rootDir, '.claude-plugin', 'plugin.json');
+  if (existsSync(sourcePluginJson)) {
+    cpSync(sourcePluginJson, join(pluginJsonDir, 'plugin.json'), { force: true });
+  }
 
-  if (marketplaces[MARKETPLACE_NAME]) {
-    marketplaces[MARKETPLACE_NAME].lastUpdated = new Date().toISOString();
-  } else {
-    marketplaces[MARKETPLACE_NAME] = {
+  // Copy skills into the plugin subdirectory
+  const sourceSkills = join(rootDir, 'skills');
+  const targetSkills = join(pluginDir, 'skills');
+  if (existsSync(sourceSkills)) {
+    cpSync(sourceSkills, targetSkills, { recursive: true, force: true });
+  }
+
+  return pluginDir;
+}
+
+// Step 2: Register in settings.json
+function registerInSettings(claudeDir, targetDir) {
+  const settingsPath = join(claudeDir, 'settings.json');
+  const settings = readJsonFile(settingsPath) || {};
+
+  let changed = false;
+
+  // Add to extraKnownMarketplaces
+  if (!settings.extraKnownMarketplaces) settings.extraKnownMarketplaces = {};
+  if (!settings.extraKnownMarketplaces[MARKETPLACE_NAME]) {
+    settings.extraKnownMarketplaces[MARKETPLACE_NAME] = {
       source: {
         source: 'directory',
         path: targetDir,
       },
-      installLocation: targetDir,
-      lastUpdated: new Date().toISOString(),
     };
+    changed = true;
   }
 
+  // Add to enabledPlugins
+  if (!settings.enabledPlugins) settings.enabledPlugins = {};
+  const pluginKey = `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
+  if (settings.enabledPlugins[pluginKey] === undefined) {
+    settings.enabledPlugins[pluginKey] = true;
+    changed = true;
+  }
+
+  if (changed) {
+    writeJsonFile(settingsPath, settings);
+  }
+
+  return changed;
+}
+
+// Step 3: Register in known_marketplaces.json
+function registerMarketplace(claudeDir, targetDir) {
+  const marketplacesPath = join(claudeDir, 'plugins', 'known_marketplaces.json');
+  const marketplaces = readJsonFile(marketplacesPath) || {};
+
+  marketplaces[MARKETPLACE_NAME] = {
+    source: {
+      source: 'directory',
+      path: targetDir,
+    },
+    installLocation: targetDir,
+    lastUpdated: new Date().toISOString(),
+  };
+
   writeJsonFile(marketplacesPath, marketplaces);
-  return true;
 }
 
+// Step 4: Register in installed_plugins.json + populate cache
 function registerPlugin(claudeDir, pluginDir, version) {
   const installedPath = join(claudeDir, 'plugins', 'installed_plugins.json');
   const installed = readJsonFile(installedPath) || { version: 2, plugins: {} };
@@ -52,9 +138,18 @@ function registerPlugin(claudeDir, pluginDir, version) {
   const pluginKey = `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
   const now = new Date().toISOString();
 
-  // Set up cache directory and copy skills there
+  // Copy to cache
   const cachePath = join(claudeDir, 'plugins', 'cache', MARKETPLACE_NAME, PLUGIN_NAME, version);
-  if (!existsSync(cachePath)) mkdirSync(cachePath, { recursive: true });
+  mkdirSync(cachePath, { recursive: true });
+
+  const sourcePluginJsonDir = join(pluginDir, '.claude-plugin');
+  const cachePluginJsonDir = join(cachePath, '.claude-plugin');
+  mkdirSync(cachePluginJsonDir, { recursive: true });
+  if (existsSync(join(sourcePluginJsonDir, 'plugin.json'))) {
+    cpSync(join(sourcePluginJsonDir, 'plugin.json'), join(cachePluginJsonDir, 'plugin.json'), {
+      force: true,
+    });
+  }
 
   const sourceSkills = join(pluginDir, 'skills');
   const cacheSkills = join(cachePath, 'skills');
@@ -62,6 +157,7 @@ function registerPlugin(claudeDir, pluginDir, version) {
     cpSync(sourceSkills, cacheSkills, { recursive: true, force: true });
   }
 
+  // Register
   if (installed.plugins[pluginKey]) {
     installed.plugins[pluginKey][0].version = version;
     installed.plugins[pluginKey][0].installPath = cachePath;
@@ -79,7 +175,6 @@ function registerPlugin(claudeDir, pluginDir, version) {
   }
 
   writeJsonFile(installedPath, installed);
-  return true;
 }
 
 export default async function install({ args, cwd, rootDir }) {
@@ -98,80 +193,51 @@ export default async function install({ args, cwd, rootDir }) {
 
   console.log('  ✓ Claude Code detected');
 
-  // Source directories (shipped with this package)
-  // Repo layout:
-  //   .claude-plugin/marketplace.json   ← marketplace descriptor
-  //   plugins/attacca-forge/            ← plugin with .claude-plugin/plugin.json + skills/
-  const sourceMarketplace = join(rootDir, '.claude-plugin', 'marketplace.json');
-  const sourcePlugin = join(rootDir, 'plugins', 'attacca-forge');
-
-  if (!existsSync(sourcePlugin)) {
-    console.error('  ✗ Plugin source not found. Package may be corrupted.');
+  // Verify source skills exist
+  const sourceSkills = join(rootDir, 'skills');
+  if (!existsSync(sourceSkills)) {
+    console.error('  ✗ Skills directory not found. Package may be corrupted.');
     process.exit(1);
   }
 
   // Read version from package.json
   const pkg = readJsonFile(join(rootDir, 'package.json'));
-  const version = pkg?.version || '0.5.2';
+  const version = pkg?.version || '0.6.0';
 
-  // Target: ~/.claude/plugins/local/attacca-forge/
-  // Installed layout (mirrors nirbound-marketplace):
-  //   .claude-plugin/marketplace.json
-  //   plugins/attacca-forge/.claude-plugin/plugin.json
-  //   plugins/attacca-forge/skills/
   const claudeDir = getClaudeDir();
-  const targetDir = getPluginDir();
-
-  const existed = existsSync(targetDir);
-  if (!existsSync(targetDir)) mkdirSync(targetDir, { recursive: true });
-
-  // 1. Copy marketplace descriptor to target root
-  const targetMarketplaceDir = join(targetDir, '.claude-plugin');
-  if (!existsSync(targetMarketplaceDir)) mkdirSync(targetMarketplaceDir, { recursive: true });
-  if (existsSync(sourceMarketplace)) {
-    cpSync(sourceMarketplace, join(targetMarketplaceDir, 'marketplace.json'), { force: true });
-  }
+  const targetDir = join(claudeDir, 'plugins', 'local', MARKETPLACE_NAME);
+  const pluginsDir = join(claudeDir, 'plugins');
+  if (!existsSync(pluginsDir)) mkdirSync(pluginsDir, { recursive: true });
 
-  // 2. Copy plugin (with .claude-plugin/plugin.json + skills/) into nested directory
-  const targetPlugin = join(targetDir, 'plugins', 'attacca-forge');
-  if (!existsSync(targetPlugin)) mkdirSync(targetPlugin, { recursive: true });
-  cpSync(sourcePlugin, targetPlugin, { recursive: true, force: true });
+  // Step 1: Build marketplace structure
+  const pluginDir = buildMarketplaceStructure(rootDir, targetDir, version);
 
   // Count skills
-  const targetSkills = join(targetPlugin, 'skills');
+  const { readdirSync } = await import('node:fs');
+  const skillsDir = join(pluginDir, 'skills');
   let skillCount = 0;
-  if (existsSync(targetSkills)) {
-    skillCount = readdirSync(targetSkills).filter((f) => {
-      return existsSync(join(targetSkills, f, 'SKILL.md'));
+  if (existsSync(skillsDir)) {
+    skillCount = readdirSync(skillsDir).filter((f) => {
+      return existsSync(join(skillsDir, f, 'SKILL.md'));
     }).length;
   }
 
-  console.log(`  ✓ ${existed ? 'Updated' : 'Installed'} ${skillCount} skills to Claude Code`);
-  console.log(`    Location: ${targetDir}`);
+  console.log(`  ✓ Installed ${skillCount} skills`);
+  console.log(`    Marketplace: ${targetDir}`);
 
-  // 3. Register marketplace in known_marketplaces.json
-  const pluginsDir = join(claudeDir, 'plugins');
-  if (!existsSync(pluginsDir)) mkdirSync(pluginsDir, { recursive: true });
+  // Step 2: Register in settings.json
+  const settingsChanged = registerInSettings(claudeDir, targetDir);
+  console.log(`  ✓ Settings ${settingsChanged ? 'updated' : 'already configured'}`);
 
+  // Step 3: Register in known_marketplaces.json
   registerMarketplace(claudeDir, targetDir);
   console.log('  ✓ Marketplace registered');
 
-  // 4. Register plugin in installed_plugins.json + populate cache
-  registerPlugin(claudeDir, targetPlugin, version);
+  // Step 4: Register plugin + populate cache
+  registerPlugin(claudeDir, pluginDir, version);
   console.log('  ✓ Plugin registered');
 
   console.log('');
   console.log('  Restart Claude Code to load the new skills.');
   console.log('');
-  console.log('  Available skills:');
-  console.log('    /spec-architect      Full behavioral spec with intent contracts');
-  console.log('    /spec-writer         Streamlined spec (no intent layer)');
-  console.log('    /stress-test         Factorial stress testing (22 variation types)');
-  console.log('    /intent-spec         Agent intent specification');
-  console.log('    /intent-audit        Organizational AI maturity audit');
-  console.log('    /codebase-discovery  Brownfield codebase discovery');
-  console.log('    /build-orchestrator  Build pipeline with 4-layer eval stack');
-  console.log('    /forge-help          Phase-aware guidance ("what\'s next?")');
-  console.log('    /forge-start         IDEA phase onboarding');
-  console.log('');
 }

package/.claude-plugin/marketplace.json

@@ -1,20 +0,0 @@
-{
-  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
-  "name": "attacca-forge",
-  "description": "Open-source AI agent development toolkit: spec writing, evaluation, intent engineering, and build orchestration for production-grade agents",
-  "owner": {
-    "name": "Attacca"
-  },
-  "plugins": [
-    {
-      "name": "attacca-forge",
-      "description": "AI agent development methodology — design, evaluate, and align autonomous agents with production-grade specifications, factorial stress testing, and intent engineering",
-      "version": "0.5.2",
-      "author": {
-        "name": "Attacca"
-      },
-      "source": "./plugins/attacca-forge",
-      "category": "development"
-    }
-  ]
-}