sigmap 3.0.0 → 3.0.1-alpha.1

package/CHANGELOG.md

@@ -6,6 +6,17 @@ Format: [Semantic Versioning](https://semver.org/)
 
 ---
 
+## [Unreleased]
+
+### Fixed
+- **`output` config key not honored for copilot adapter** · [#30](https://github.com/manojmallick/sigmap/issues/30)
+  - Custom `output` path in config now correctly used for copilot adapter instead of hard-wired `.github/copilot-instructions.md`
+  - Added `resolveAdapterPath()` helper to centralize adapter path resolution
+  - Other adapters (claude, cursor, windsurf) continue to use fixed paths as designed
+  - 5 new integration tests ensure custom paths work correctly across all config combinations
+
+---
+
 ## [3.0.0] — 2026-04-06 — Platform: Multi-Adapter Architecture
 
 ### Added

package/README.md

@@ -26,7 +26,7 @@
 [![Changelog](https://img.shields.io/badge/changelog-CHANGELOG.md-blue)](CHANGELOG.md)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
 [![VS Code](https://img.shields.io/badge/VS%20Code-extension-0078d4?logo=visual-studio-code)](https://marketplace.visualstudio.com/items?itemName=manojmallick.sigmap)
-[![JetBrains](https://img.shields.io/badge/JetBrains-plugin-000000?logo=jetbrains)](https://plugins.jetbrains.com/plugin/sigmap)
+[![JetBrains](https://img.shields.io/badge/JetBrains-plugin-000000?logo=jetbrains)](https://plugins.jetbrains.com/plugin/31109-sigmap--ai-context-engine/)
 [![Open VSX](https://img.shields.io/open-vsx/v/manojmallick/sigmap?color=a251e3&label=Open%20VSX&logo=vscodium)](https://open-vsx.org/extension/manojmallick/sigmap)
 
 </div>
@@ -123,6 +123,7 @@ AI agent session starts with full context
 | **Evaluation dashboard output** | Generate shareable HTML/JSON benchmark summaries from CLI runs |
 | **CI-friendly metrics export** | Persist machine-readable metrics for release gates and regression tracking |
 | **Release quality gates** | Add pass/fail thresholds for hit@5 and precision before publish |
+
 ## 🔌 v3.0 — Platform: Multi-Adapter Architecture
 
 SigMap is now an **adapter platform**. Any AI assistant — Copilot, Claude, Cursor, Windsurf, OpenAI, or Gemini — plugs in through a standard interface.
@@ -155,6 +156,13 @@ const systemPrompt = adapt(context, 'openai', { version: '3.0.0' });
 See full roadmap: [manojmallick.github.io/sigmap/roadmap.html](https://manojmallick.github.io/sigmap/roadmap.html)
 
 ---
+
+## ⚡ Quick start
+
+Download the single-file CLI and generate context immediately:
+
+```bash
+# 1. Download
 curl -O https://raw.githubusercontent.com/manojmallick/sigmap/main/gen-context.js
 
 # 2. Generate your context file
@@ -238,7 +246,7 @@ The `jetbrains-plugin/` directory contains a Kotlin-based plugin for JetBrains I
 
 Compatible with **IntelliJ IDEA 2024.1+** (Community & Ultimate), **WebStorm**, **PyCharm**, **GoLand**, **RubyMine**, **PhpStorm**, and all other IntelliJ-based IDEs.
 
-**Install:** [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/sigmap) | [Manual setup guide](docs/JETBRAINS_SETUP.md)
+**Install:** [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/31109-sigmap--ai-context-engine/) | [Manual setup guide](docs/JETBRAINS_SETUP.md)
 
 ---
 
@@ -441,6 +449,7 @@ Copy `gen-context.config.json.example` to `gen-context.config.json`:
 
 ```json
 {
+  "output": ".github/copilot-instructions.md",
   "srcDirs": ["src", "app", "lib"],
   "maxTokens": 6000,
   "outputs": ["copilot"],
@@ -451,6 +460,15 @@ Copy `gen-context.config.json.example` to `gen-context.config.json`:
 }
 ```
 
+**Key fields:**
+
+- **`output`** — custom path for the primary markdown output file (used by `copilot` adapter). Default: `.github/copilot-instructions.md`
+- **`outputs`** — which adapters to write to: `copilot` | `claude` | `cursor` | `windsurf`
+- **`srcDirs`** — directories to scan (relative to project root)
+- **`maxTokens`** — max tokens in final output before budget enforcement
+- **`secretScan`** — redact secrets (AWS keys, tokens, etc.) from output
+- **`strategy`** — output mode: `full` (default) | `per-module` | `hot-cold`
+
 Exclusions go in `.contextignore` (gitignore syntax). Also reads `.repomixignore` if present.
 
 ```
@@ -468,12 +486,25 @@ Run `node gen-context.js --init` to scaffold both files in one step.
 
 | Key | Output file | Read by |
 |---|---|---|
-| `"copilot"` | `.github/copilot-instructions.md` | GitHub Copilot |
+| `"copilot"` | `.github/copilot-instructions.md` *(or custom path via `output`)* | GitHub Copilot |
 | `"claude"` | `CLAUDE.md` (appends below marker) | Claude Code |
 | `"cursor"` | `.cursorrules` | Cursor |
 | `"windsurf"` | `.windsurfrules` | Windsurf |
 
----
+The **`output`** config key sets the primary output file path. It is used by the `copilot` adapter when enabled. Other adapters always write to their fixed paths.
+
+**Example:**
+
+```json
+{
+  "output": ".context/ai-context.md",
+  "outputs": ["copilot"]
+}
+```
+
+This writes to `.context/ai-context.md` instead of `.github/copilot-instructions.md`.
+
+If `output` is omitted, the default `.github/copilot-instructions.md` is used.
 
 ## 📊 Observability
 

package/gen-context.js

@@ -4903,7 +4903,7 @@ const path = require('path');
 const os = require('os');
 const { execSync } = require('child_process');
 
-const VERSION = '3.0.0';
+const VERSION = '3.0.1';
 const MARKER = '\n\n## Auto-generated signatures\n<!-- Updated by gen-context.js -->\n';
 
 function requireSourceOrBundled(key) {
@@ -5445,6 +5445,29 @@ function ensureDir(filePath) {
   if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
 }
 
+// ---------------------------------------------------------------------------
+// Resolve output path for a given adapter
+// ---------------------------------------------------------------------------
+// Takes config.output into account for the copilot adapter.
+// Returns the full path where output should be written.
+function resolveAdapterPath(adapter, cwd, config) {
+  config = config || {};
+  
+  // Copilot uses config.output if available, otherwise default
+  if (adapter === 'copilot') {
+    return config.output 
+      ? path.join(cwd, config.output)
+      : path.join(cwd, '.github', 'copilot-instructions.md');
+  }
+  
+  // Fixed paths for other adapters
+  if (adapter === 'claude') return path.join(cwd, 'CLAUDE.md');
+  if (adapter === 'cursor') return path.join(cwd, '.cursorrules');
+  if (adapter === 'windsurf') return path.join(cwd, '.windsurfrules');
+  
+  return null;
+}
+
 // ---------------------------------------------------------------------------
 // Cache output writer (v0.8)
 // ---------------------------------------------------------------------------
@@ -5460,14 +5483,15 @@ function writeCacheOutput(content, cwd) {
   }
 }
 
-function writeOutputs(content, targets, cwd) {
+function writeOutputs(content, targets, cwd, config) {
+  config = config || {};
   // v3.0+: adapter-aware output targets
   const ADAPTER_TARGETS = new Set(['openai', 'gemini']);
 
   const targetMap = {
-    copilot: path.join(cwd, '.github', 'copilot-instructions.md'),
-    cursor: path.join(cwd, '.cursorrules'),
-    windsurf: path.join(cwd, '.windsurfrules'),
+    copilot: resolveAdapterPath('copilot', cwd, config),
+    cursor: resolveAdapterPath('cursor', cwd, config),
+    windsurf: resolveAdapterPath('windsurf', cwd, config),
   };
 
   for (const target of targets) {
@@ -5709,7 +5733,7 @@ function runPerModuleStrategy(cwd, config, fileEntries, inputTokenTotal) {
   overviewLines.push('> For cross-module questions load both files.');
   const overviewContent = overviewLines.join('\n') + '\n';
   const primaryTargets = (config.outputs || ['copilot']).filter((t) => t !== 'claude');
-  writeOutputs(overviewContent, primaryTargets, cwd);
+  writeOutputs(overviewContent, primaryTargets, cwd, config);
 
   const overviewTokens = estimateTokens(overviewContent);
   console.warn(`[sigmap] per-module: overview ~${overviewTokens} tokens (always-on), modules total ~${totalOut} tokens (on-demand)`);
@@ -5728,7 +5752,7 @@ function runHotColdStrategy(cwd, config, fileEntries, recentFiles, inputTokenTot
     ? formatOutput(hotEntries, cwd, false, config, null)
     : '<!-- Generated by SigMap — no recently changed files -->\n';
   const primaryTargets = (config.outputs || ['copilot']).filter((t) => t !== 'claude');
-  writeOutputs(hotContent, primaryTargets, cwd);
+  writeOutputs(hotContent, primaryTargets, cwd, config);
   const hotTokens = estimateTokens(hotContent);
 
   // Cold → .github/context-cold.md (MCP reads this on demand)
@@ -5831,7 +5855,7 @@ function runDiff(cwd, config, stagedOnly, baseRef) {
   const diffSection = baseRef ? buildDiffSectionFromBase(cwd, baseRef, fileEntries, config) : [];
   const content = formatOutput(fileEntries, cwd, routingEnabled, config, { diffSection });
   const finalTokens = estimateTokens(content);
-  writeOutputs(content, config.outputs, cwd);
+  writeOutputs(content, config.outputs, cwd, config);
 
   const scope = baseRef ? `diff-vs-${baseRef}` : (stagedOnly ? 'staged' : 'diff');
   console.warn(`[sigmap] ${scope} files: ${fileEntries.length}, diff tokens: ~${finalTokens}`);
@@ -5940,7 +5964,7 @@ function runGenerate(cwd, config, reportMode, reportJson = false) {
       const finalTokens = estimateTokens(content);
       const formatIdx = process.argv.indexOf('--format');
       const formatValue = formatIdx >= 0 ? process.argv[formatIdx + 1] : (config.format || 'default');
-      writeOutputs(content, config.outputs, cwd);
+      writeOutputs(content, config.outputs, cwd, config);
       if (formatValue === 'cache') writeCacheOutput(content, cwd);
       result = { inputTokenTotal, finalTokens, fileCount: beforeCount, droppedCount };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap",
-  "version": "3.0.0",
+  "version": "3.0.1-alpha.1",
   "description": "Zero-dependency AI context engine — 97% token reduction. No npm install. Runs on Node 18+.",
   "main": "gen-context.js",
   "exports": {

package/packages/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap-cli",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "SigMap CLI wrapper — thin adapter for programmatic CLI invocation",
   "main": "index.js",
   "keywords": [

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sigmap-core",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "SigMap core library — zero-dependency code signature extraction, retrieval, and security scanning",
   "main": "index.js",
   "keywords": [

package/src/mcp/server.js

@@ -18,7 +18,7 @@ const { readContext, searchSignatures, getMap, createCheckpoint, getRouting, exp
 
 const SERVER_INFO = {
   name: 'sigmap',
-  version: '3.0.0',
+  version: '3.0.1',
   description: 'SigMap MCP server — code signatures on demand',
 };