@adityaaria/spark 6.0.6 → 6.0.8

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.6",
+  "version": "6.0.8",
   "description": "SPARK skills and runtime bootstrap for coding agents",
   "type": "module",
   "publishConfig": {

package/src/cli/install.js

@@ -139,12 +139,14 @@ function interpolatePlanText(text, metadata) {
 function buildReadyLines(adapter, plan, metadata) {
   const lines = [];
 
-  if (metadata.relativeTargetRoot) {
+  if (metadata.relativeTargetRoot && adapter.id === 'vscode') {
+    lines.push(bullet(`Local VS Code bundle prepared at ${pathText(metadata.relativeTargetRoot)}.`));
+  } else if (metadata.relativeTargetRoot) {
     lines.push(bullet(`Plugin bundle staged at ${pathText(metadata.relativeTargetRoot)}.`));
   }
 
   if (metadata.relativeMarketplaceRoot) {
-    lines.push(bullet(`Local Codex marketplace staged at ${pathText(metadata.relativeMarketplaceRoot)}.`));
+    lines.push(bullet(`Local marketplace staged at ${pathText(metadata.relativeMarketplaceRoot)}.`));
   }
 
   if (adapter.id === 'codex') {
@@ -152,6 +154,14 @@ function buildReadyLines(adapter, plan, metadata) {
     return lines;
   }
 
+  if (adapter.id === 'vscode') {
+    if (metadata.relativeSettingsPath) {
+      lines.push(bullet(`VS Code plugin registration was written to ${pathText(metadata.relativeSettingsPath)}.`));
+    }
+    lines.push(bullet('Open a fresh VS Code agent session to confirm using-spark loads before coding.'));
+    return lines;
+  }
+
   lines.push(bullet('Start a fresh session in the selected harness to confirm using-spark loads before coding.'));
   return lines;
 }

package/src/cli/output.js

@@ -24,7 +24,7 @@ export function printHelp() {
   printLine('');
   printMuted('Without --harness, the installer will ask which AI assistance to target.');
   printLine('');
-  printLine(labelValue('Supported', 'Codex, Cursor, Antigravity, Copilot, OpenCode, Gemini, Pi'));
+  printLine(labelValue('Supported', 'Claude Code, Codex CLI, VS Code, Cursor, Copilot CLI, OpenCode, Gemini CLI, Pi, Antigravity'));
 }
 
 export function printCommandHeader(title) {
@@ -101,9 +101,15 @@ export function formatPromptPrefix() {
   return `${styled('◆', 'spark')} ${styled('Select', 'pink', true)} ${styled('›', 'dimGray')} `;
 }
 
-export function promptOption(index, label, id, hint = null) {
+export function promptOption(index, label, id, hint = null, detail = null) {
   const base = `${styled(`${index}.`, 'spark', true)} ${styled(label, 'white', true)} ${styled(`(${id})`, 'dimGray')}`;
-  return hint ? `${base} ${styled(hint, 'warning')}` : base;
+  const header = hint ? `${base} ${styled(hint, 'warning')}` : base;
+
+  if (!detail) {
+    return header;
+  }
+
+  return `${header}\n   ${styled(detail, 'dimGray')}`;
 }
 
 function styled(text, tone, bold = false) {

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

@@ -2,6 +2,7 @@ import { createAdapter } from './common.js';
 import { stageClaudePlugin } from './claude-staging.js';
 import { stageCodexPlugin } from './codex-staging.js';
 import { installCursorPlugin } from './cursor-staging.js';
+import { installVsCodePlugin } from './vscode-staging.js';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
@@ -42,14 +43,14 @@ export function createClaudeCodeAdapter() {
 export function createCodexAdapter() {
   return createAdapter({
     id: 'codex',
-    label: 'Codex',
+    label: 'Codex CLI',
     kind: 'shell-hook',
     envKeys: ['CLAUDE_PLUGIN_ROOT'],
     binaryNames: ['codex'],
     bootstrap: 'shell hook -> hooks/session-start-codex -> using-spark',
     installHint: '.codex-plugin/plugin.json + hooks/hooks-codex.json + hooks/session-start-codex',
     verifyHint: 'Run a fresh Codex session and confirm using-spark loads before coding.',
-    successMessage: 'Installed SPARK for Codex.',
+    successMessage: 'Installed SPARK for Codex CLI.',
     commands: [
       {
         file: 'codex',
@@ -71,6 +72,26 @@ export function createCodexAdapter() {
   });
 }
 
+export function createVsCodeAdapter() {
+  return createAdapter({
+    id: 'vscode',
+    label: 'VS Code',
+    kind: 'shell-hook',
+    bootstrap: 'workspace plugin bundle -> VS Code chat.pluginLocations -> hooks/session-start -> using-spark',
+    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: [
+      'Prepare a local VS Code plugin bundle at .spark/vscode-plugin.',
+      'Register that bundle in .vscode/settings.json via chat.pluginLocations.',
+      'Start a fresh VS Code agent session so using-spark loads before coding.',
+    ],
+    customInstall({ cwd, dryRun }) {
+      return installVsCodePlugin({ cwd, packageRoot, dryRun });
+    },
+  });
+}
+
 export function createCursorAdapter() {
   return createAdapter({
     id: 'cursor',

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

@@ -0,0 +1,75 @@
+import fs from 'node:fs';
+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 = [
+  { 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 }) {
+  const targetRoot = path.join(cwd, VSCODE_PLUGIN_DIR);
+  const settingsPath = path.join(cwd, SETTINGS_PATH);
+
+  if (!dryRun) {
+    fs.mkdirSync(targetRoot, { recursive: true });
+
+    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()) {
+        fs.cpSync(sourcePath, targetPath, { recursive: true });
+        continue;
+      }
+
+      fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+      fs.copyFileSync(sourcePath, targetPath);
+      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);
+  }
+
+  return {
+    targetRoot,
+    relativeTargetRoot: VSCODE_PLUGIN_DIR,
+    settingsPath,
+    relativeSettingsPath: SETTINGS_PATH,
+  };
+}
+
+function writeVsCodeSettings(settingsPath, targetRoot) {
+  fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
+
+  let settings = {};
+  if (fs.existsSync(settingsPath)) {
+    settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+  }
+
+  const pluginLocations = isPlainObject(settings['chat.pluginLocations'])
+    ? { ...settings['chat.pluginLocations'] }
+    : {};
+
+  pluginLocations[targetRoot] = true;
+  settings['chat.pluginLocations'] = pluginLocations;
+
+  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf8');
+}
+
+function isPlainObject(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}

package/src/installer/detect.js

@@ -164,7 +164,15 @@ function renderPrompt(candidates, validationMessage = null) {
 
   for (const [index, candidate] of candidates.entries()) {
     const hint = recommendedIds.has(candidate.id) ? 'recommended' : null;
-    lines.push(promptOption(index + 1, candidate.label, candidate.id, hint));
+    lines.push(
+      promptOption(
+        index + 1,
+        candidate.label,
+        candidate.id,
+        hint,
+        describeHarness(candidate.id)
+      )
+    );
   }
 
   return formatPromptBlock(
@@ -189,6 +197,42 @@ function resolvePromptAnswer(answer, candidates) {
   return getAdapterById(exact.id);
 }
 
+function describeHarness(id) {
+  const descriptions = {
+    claude: 'Best for Claude Code sessions and project-local plugin workflows.',
+    codex: 'For the Codex CLI plugin marketplace flow in terminal sessions.',
+    vscode: 'One install path for VS Code agent sessions across Claude, Copilot, GPT, and other supported models.',
+    cursor: 'Native Cursor plugin install for fresh Agent sessions.',
+    copilot: 'For GitHub Copilot CLI in terminal-based agent sessions.',
+    opencode: 'Registers the OpenCode plugin in your local config directory.',
+    gemini: 'Installs the Gemini CLI extension and loads SPARK at startup.',
+    pi: 'Installs the Pi extension from the SPARK repository.',
+    antigravity: 'Installs the Antigravity plugin and loads SPARK on new sessions.',
+  };
+
+  return descriptions[id] ?? null;
+}
+
 function normalizeHarness(value) {
-  return String(value ?? '').trim().toLowerCase();
+  const normalized = String(value ?? '').trim().toLowerCase();
+
+  if (!normalized) {
+    return '';
+  }
+
+  const aliases = new Map([
+    ['codex cli', 'codex'],
+    ['codex-cli', 'codex'],
+    ['codex vscode', 'vscode'],
+    ['codex vs code', 'vscode'],
+    ['codex-vs-code', 'vscode'],
+    ['codex app', 'vscode'],
+    ['copilot vscode', 'vscode'],
+    ['copilot vs code', 'vscode'],
+    ['copilot-vs-code', 'vscode'],
+    ['vscode agent', 'vscode'],
+    ['vs code', 'vscode'],
+  ]);
+
+  return aliases.get(normalized) ?? normalized;
 }

package/src/installer/registry.js

@@ -3,6 +3,7 @@ import {
   createCodexAdapter,
   createCopilotAdapter,
   createCursorAdapter,
+  createVsCodeAdapter,
 } from './adapters/shell-hook.js';
 import {
   createAntigravityAdapter,
@@ -14,6 +15,7 @@ import {
 const ADAPTERS = [
   createClaudeCodeAdapter(),
   createCodexAdapter(),
+  createVsCodeAdapter(),
   createCursorAdapter(),
   createCopilotAdapter(),
   createOpenCodeAdapter(),