@adityaaria/spark 6.0.7 → 6.0.9

package/.claude-plugin/marketplace.json

@@ -2,7 +2,7 @@
   "name": "spark-dev",
   "description": "Development marketplace for SPARK core skills library",
   "owner": {
-    "name": "Jesse Vincent",
+    "name": "Aditya Aria",
     "email": "jesse@fsck.com"
   },
   "plugins": [
@@ -12,7 +12,7 @@
       "version": "6.0.3",
       "source": "./",
       "author": {
-        "name": "Jesse Vincent",
+        "name": "Aditya Aria",
         "email": "jesse@fsck.com"
       }
     }

package/.claude-plugin/plugin.json

@@ -3,7 +3,7 @@
   "description": "Core skills library for Claude Code: TDD, debugging, collaboration patterns, and proven techniques",
   "version": "6.0.3",
   "author": {
-    "name": "Jesse Vincent",
+    "name": "Aditya Aria",
     "email": "jesse@fsck.com"
   },
   "homepage": "https://github.com/adityaaria/SPARK",

package/.codex-plugin/plugin.json

@@ -3,7 +3,7 @@
   "version": "6.0.3",
   "description": "An agentic skills framework & software development methodology that works: planning, TDD, debugging, and collaboration workflows.",
   "author": {
-    "name": "Jesse Vincent",
+    "name": "Aditya Aria",
     "email": "jesse@fsck.com",
     "url": "https://github.com/adityaaria"
   },
@@ -26,7 +26,7 @@
     "displayName": "SPARK",
     "shortDescription": "Planning, TDD, debugging, and delivery workflows for coding agents",
     "longDescription": "Use SPARK to guide agent work through brainstorming, implementation planning, test-driven development, systematic debugging, parallel execution, code review, and finish-the-branch workflows.",
-    "developerName": "Jesse Vincent",
+    "developerName": "Aditya Aria",
     "category": "Coding",
     "capabilities": [
       "Interactive",

package/.cursor-plugin/plugin.json

@@ -4,7 +4,7 @@
   "description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques",
   "version": "6.0.3",
   "author": {
-    "name": "Jesse Vincent",
+    "name": "Aditya Aria",
     "email": "jesse@fsck.com"
   },
   "homepage": "https://github.com/adityaaria/SPARK",

package/.kimi-plugin/plugin.json

@@ -3,7 +3,7 @@
   "version": "6.0.3",
   "description": "An agentic skills framework and software development methodology.",
   "author": {
-    "name": "Jesse Vincent",
+    "name": "Aditya Aria",
     "email": "jesse@fsck.com"
   },
   "homepage": "https://github.com/adityaaria/SPARK",
@@ -27,7 +27,7 @@
     "displayName": "SPARK",
     "shortDescription": "Planning, TDD, debugging, and delivery workflows for coding agents",
     "longDescription": "Use SPARK to guide agent work through brainstorming, implementation planning, test-driven development, systematic debugging, parallel execution, code review, and finish-the-branch workflows.",
-    "developerName": "Jesse Vincent",
+    "developerName": "Aditya Aria",
     "capabilities": [
       "Interactive",
       "Read",

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Jesse Vincent
+Copyright (c) 2025 Aditya Aria
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -276,7 +276,7 @@ MIT License - see LICENSE file for details
 
 ## Community
 
-SPARK is built by [Jesse Vincent](https://blog.fsck.com) and contributors.
+SPARK is built by [Aditya Aria](https://blog.fsck.com) and contributors.
 
 - **Community**: Use the repository issues and discussions for support, questions, and sharing what you're building with SPARK
 - **Issues**: https://github.com/adityaaria/SPARK/issues

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adityaaria/spark",
-  "version": "6.0.7",
+  "version": "6.0.9",
   "description": "SPARK skills and runtime bootstrap for coding agents",
   "type": "module",
   "publishConfig": {

package/src/installer/adapters/common.js

@@ -66,6 +66,18 @@ export function createAdapter({
           encoding: 'utf8',
         });
 
+        if (result.error) {
+          if (result.error.code === 'ENOENT') {
+            throw new InstallerError(
+              `\n\u2715 ${label} install failed: Command '${entry.file}' not found.\n` +
+              `SPARK requires ${label} to be installed first.\n` +
+              `Please install ${label} from its official source (e.g. npm install -g <package-name>)\n` +
+              `and ensure '${entry.file}' is in your PATH before retrying.\n`
+            );
+          }
+          throw new InstallerError(`${label} install failed: ${result.error.message}`);
+        }
+
         if (result.status !== 0) {
           throw new InstallerError(
             `${label} install failed: ${result.stderr || result.stdout || 'unknown error'}`

package/src/installer/adapters/shell-hook.js

@@ -78,7 +78,7 @@ export function createVsCodeAdapter() {
     label: 'VS Code',
     kind: 'shell-hook',
     bootstrap: 'workspace plugin bundle -> VS Code chat.pluginLocations -> hooks/session-start -> using-spark',
-    installHint: 'A Claude-compatible plugin bundle is staged locally and registered through .vscode/settings.json chat.pluginLocations.',
+    installHint: 'A standard plugin bundle is staged locally and registered through .vscode/settings.json chat.pluginLocations.',
     verifyHint: 'Open a fresh VS Code agent session and confirm using-spark loads before coding.',
     successMessage: 'SPARK is ready in VS Code.',
     automatedSteps: [

package/src/installer/adapters/vscode-staging.js

@@ -4,12 +4,12 @@ import path from 'node:path';
 const VSCODE_PLUGIN_DIR = path.join('.spark', 'vscode-plugin');
 const SETTINGS_PATH = path.join('.vscode', 'settings.json');
 const COPY_PATHS = [
-  '.claude-plugin',
-  'assets',
-  path.join('hooks', 'hooks.json'),
-  path.join('hooks', 'run-hook.cmd'),
-  path.join('hooks', 'session-start'),
-  'skills',
+  { src: '.claude-plugin', dest: '.vscode-plugin' },
+  { src: 'assets', dest: 'assets' },
+  { src: path.join('hooks', 'hooks.json'), dest: path.join('hooks', 'hooks.json') },
+  { src: path.join('hooks', 'run-hook.cmd'), dest: path.join('hooks', 'run-hook.cmd') },
+  { src: path.join('hooks', 'session-start'), dest: path.join('hooks', 'session-start') },
+  { src: 'skills', dest: 'skills' },
 ];
 
 export function installVsCodePlugin({ cwd = process.cwd(), packageRoot, dryRun = false }) {
@@ -19,9 +19,9 @@ export function installVsCodePlugin({ cwd = process.cwd(), packageRoot, dryRun =
   if (!dryRun) {
     fs.mkdirSync(targetRoot, { recursive: true });
 
-    for (const relativePath of COPY_PATHS) {
-      const sourcePath = path.join(packageRoot, relativePath);
-      const targetPath = path.join(targetRoot, relativePath);
+    for (const mapping of COPY_PATHS) {
+      const sourcePath = path.join(packageRoot, mapping.src);
+      const targetPath = path.join(targetRoot, mapping.dest);
       const stat = fs.statSync(sourcePath);
 
       if (stat.isDirectory()) {
@@ -34,6 +34,13 @@ export function installVsCodePlugin({ cwd = process.cwd(), packageRoot, dryRun =
       fs.chmodSync(targetPath, stat.mode);
     }
 
+    const targetPluginJsonPath = path.join(targetRoot, '.vscode-plugin', 'plugin.json');
+    if (fs.existsSync(targetPluginJsonPath)) {
+      const pluginData = JSON.parse(fs.readFileSync(targetPluginJsonPath, 'utf8'));
+      pluginData.description = "Core skills library for VS Code: TDD, debugging, collaboration patterns, and proven techniques";
+      fs.writeFileSync(targetPluginJsonPath, JSON.stringify(pluginData, null, 2) + '\n', 'utf8');
+    }
+
     writeVsCodeSettings(settingsPath, targetRoot);
   }
 

package/src/installer/detect.js

@@ -33,8 +33,9 @@ export async function chooseHarness({
     throw new InstallerError('No harness selected. Re-run with --harness or use an interactive terminal.');
   }
 
+  const homeDir = os.homedir();
   const detectedCandidates = detectHarnessCandidates({ env, fsImpl: fs });
-  const candidates = buildPromptCandidates(detectedCandidates);
+  const candidates = buildPromptCandidates(detectedCandidates, env, fs, homeDir);
 
   let validationMessage = null;
   while (true) {
@@ -51,6 +52,8 @@ function scoreAdapter(adapter, env, fsImpl, homeDir) {
   let score = 0;
   const reasons = [];
 
+  let missingBinaries = false;
+
   for (const key of adapter.envKeys) {
     if (env[key]) {
       score += 100;
@@ -58,10 +61,15 @@ function scoreAdapter(adapter, env, fsImpl, homeDir) {
     }
   }
 
-  for (const binaryName of adapter.binaryNames) {
-    if (commandExists(binaryName, env, fsImpl)) {
-      score += 70;
-      reasons.push(`path:${binaryName}`);
+  if (adapter.binaryNames && adapter.binaryNames.length > 0) {
+    missingBinaries = true;
+    for (const binaryName of adapter.binaryNames) {
+      if (commandExists(binaryName, env, fsImpl)) {
+        score += 70;
+        reasons.push(`path:${binaryName}`);
+        missingBinaries = false;
+        break;
+      }
     }
   }
 
@@ -80,6 +88,7 @@ function scoreAdapter(adapter, env, fsImpl, homeDir) {
     label: adapter.label,
     score,
     reasons,
+    missingBinaries,
   };
 }
 
@@ -129,7 +138,7 @@ function commandExists(commandName, env, fsImpl) {
   return false;
 }
 
-function buildPromptCandidates(detectedCandidates) {
+function buildPromptCandidates(detectedCandidates, env, fsImpl, homeDir) {
   const allAdapters = listAdapters();
   const detectedIds = new Set(detectedCandidates.map((candidate) => candidate.id));
 
@@ -137,12 +146,12 @@ function buildPromptCandidates(detectedCandidates) {
     ...detectedCandidates,
     ...allAdapters
       .filter((adapter) => !detectedIds.has(adapter.id))
-      .map((adapter) => ({
-        id: adapter.id,
-        label: adapter.label,
-        score: 0,
-        reasons: [],
-      })),
+      .map((adapter) => {
+        const result = scoreAdapter(adapter, env, fsImpl, homeDir);
+        result.score = 0;
+        result.reasons = [];
+        return result;
+      }),
   ];
 }
 
@@ -163,14 +172,19 @@ function renderPrompt(candidates, validationMessage = null) {
   }
 
   for (const [index, candidate] of candidates.entries()) {
+    let label = candidate.label;
+    if (candidate.missingBinaries) {
+      label += ' [Missing CLI]';
+    }
+
     const hint = recommendedIds.has(candidate.id) ? 'recommended' : null;
     lines.push(
       promptOption(
         index + 1,
-        candidate.label,
+        label,
         candidate.id,
         hint,
-        describeHarness(candidate.id)
+        describeHarness(candidate.id, candidate.missingBinaries)
       )
     );
   }
@@ -197,7 +211,7 @@ function resolvePromptAnswer(answer, candidates) {
   return getAdapterById(exact.id);
 }
 
-function describeHarness(id) {
+function describeHarness(id, missingBinaries = false) {
   const descriptions = {
     claude: 'Best for Claude Code sessions and project-local plugin workflows.',
     codex: 'For the Codex CLI plugin marketplace flow in terminal sessions.',
@@ -210,7 +224,12 @@ function describeHarness(id) {
     antigravity: 'Installs the Antigravity plugin and loads SPARK on new sessions.',
   };
 
-  return descriptions[id] ?? null;
+  let description = descriptions[id] ?? null;
+  if (description && missingBinaries) {
+    description += '\n   ⚠️  Requires its official CLI to be installed first.';
+  }
+
+  return description;
 }
 
 function normalizeHarness(value) {