@adityaaria/spark 6.0.6 → 6.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adityaaria/spark",
-  "version": "6.0.6",
+  "version": "6.0.7",
   "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 Claude-compatible 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,68 @@
+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 = [
+  '.claude-plugin',
+  'assets',
+  path.join('hooks', 'hooks.json'),
+  path.join('hooks', 'run-hook.cmd'),
+  path.join('hooks', 'session-start'),
+  '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 relativePath of COPY_PATHS) {
+      const sourcePath = path.join(packageRoot, relativePath);
+      const targetPath = path.join(targetRoot, relativePath);
+      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);
+    }
+
+    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(),