github-llm-council 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Varun R
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,63 @@
+# LLM Council (VS Code Extension)
+
+Minimal, streaming “council” workflow using the VS Code Language Model API (e.g., Copilot models). Runs three stages, logs streams, and saves a markdown artifact per run.
+
+Current state
+- Command: `LLM Council` (editor context menu / `llmCouncil.run`).
+- Flow: pick context (file/selection/none) → pick prompt template → edit prompt → pick models (defaults auto-resolved and remembered per workspace) → council runs (3 stages) with streaming output.
+- Models: via `vscode.lm.selectChatModels`; defaults prefer `gpt-5.1`, `sonnet-4.5`, `gemini-pro-3` when available.
+- Output: streams tagged by stage/model; a markdown artifact (with front matter + transcripts) is saved to the workspace root and opened in a new tab. History kept in global storage (`llmCouncil.historySize`).
+- Tests: unit/integration via Vitest.
+
+## Installation
+Prereqs: VS Code ≥1.84, VS Code CLI `code` on PATH, Copilot (or other LM API provider) with chat models enabled.
+
+Dev/local install
+```bash
+npm install                 # install deps
+npm run package:vsix        # builds dist/llm-council.vsix
+code --install-extension dist/llm-council.vsix --force  # install into VS Code
+# Optional: npm pack  # to produce github-llm-council-0.0.1.tgz
+```
+
+User install after publish
+```bash
+npm install -g github-llm-council   # postinstall auto-installs the bundled VSIX via `code`
+```
+
+Upgrade
+```bash
+npm update -g github-llm-council    # or npm install -g github-llm-council@latest
+```
+
+Publish (maintainers)
+```bash
+npm install
+npm run package:vsix   # produce dist/llm-council.vsix
+npm pack               # produce github-llm-council-0.0.1.tgz
+npm publish            # prepublishOnly rebuilds/package before publish
+```
+
+## Usage
+1) Right-click in an editor → `LLM Council` (or run via Command Palette).
+2) Choose context (file/selection/none).
+3) Pick a prompt template, then edit/enter your prompt.
+4) Confirm model selection (defaults pre-selected and remembered per workspace).
+5) Watch streaming output; a markdown artifact opens and saves to the workspace root.
+
+Requires: VS Code with LM API-capable extension (e.g., GitHub Copilot) and access to chat models.
+
+## Configuration
+- `llmCouncil.defaultModels` (array): preferred model ids; first available three are used when no stored selection exists.
+- `llmCouncil.historySize` (number): maximum run summaries to retain.
+
+## Testing
+```bash
+npm run lint
+npm run test:unit
+npm run test:integration
+```
+
+## Notes
+- Model choices are remembered per workspace between runs.
+- Prompts live in `src/prompts.ts`; edit and rebuild/package to distribute changes.

package/bin/install.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+const { spawnSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const pkgRoot = path.join(__dirname, '..');
+const vsixPath = path.join(pkgRoot, 'dist', 'llm-council.vsix');
+const codeCandidates = [
+  process.env.CODE_BIN,
+  process.env.VSCODE_BIN,
+  'code',
+  'code-insiders'
+].filter(Boolean);
+
+function runCode(cmd, args) {
+  const res = spawnSync(cmd, args, { stdio: 'inherit' });
+  return res.status === 0;
+}
+
+function main() {
+  if (!fs.existsSync(vsixPath)) {
+    console.log(`[llm-council] VSIX not found at ${vsixPath}, skipping auto-install.`);
+    console.log('[llm-council] This is expected in dev; run `npm run package:vsix` before publishing.');
+    return;
+  }
+
+  const args = ['--install-extension', vsixPath, '--force'];
+
+  for (const candidate of codeCandidates) {
+    if (!candidate) continue;
+    console.log(`[llm-council] Installing via ${candidate} ${args.join(' ')}`);
+    if (runCode(candidate, args)) {
+      console.log('[llm-council] Extension installed successfully.');
+      return;
+    }
+  }
+
+  console.error('[llm-council] Failed to install extension. Ensure `code` (VS Code CLI) is on your PATH.');
+  console.error('On macOS: run "Shell Command: Install \'code\' command in PATH" from VS Code command palette.');
+  console.error('On Windows/Linux: ensure the VS Code bin directory is on PATH.');
+  process.exit(1);
+}
+
+main();

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "github-llm-council",
+  "displayName": "LLM Council",
+  "description": "VS Code extension for running an LLM council via the LM API",
+  "version": "0.0.1",
+  "publisher": "varunr89",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/varunr89/github-llm-council.git"
+  },
+  "engines": {
+    "vscode": "^1.84.0"
+  },
+  "bin": {
+    "github-llm-council": "bin/install.js"
+  },
+  "activationEvents": [
+    "onCommand:llmCouncil.run"
+  ],
+  "main": "./out/extension.js",
+  "contributes": {
+    "commands": [
+      {
+        "command": "llmCouncil.run",
+        "title": "LLM Council"
+      }
+    ],
+    "menus": {
+      "editor/context": [
+        {
+          "command": "llmCouncil.run",
+          "group": "navigation"
+        }
+      ]
+    },
+    "configuration": {
+      "title": "LLM Council",
+      "properties": {
+        "llmCouncil.defaultModels": {
+          "type": "array",
+          "default": ["gpt-5.1", "sonnet-4.5", "gemini-pro-3"],
+          "description": "Preferred model ids for council; first available three are used."
+        },
+        "llmCouncil.historySize": {
+          "type": "number",
+          "default": 20,
+          "description": "Maximum number of run summaries to keep."
+        }
+      }
+    }
+  },
+  "scripts": {
+    "vscode:prepublish": "npm run compile",
+    "compile": "tsc -p ./",
+    "watch": "tsc -watch -p ./",
+    "test": "npm run compile && npm run test:unit && npm run test:integration",
+    "test:unit": "vitest run",
+    "test:integration": "vitest run src/test/unit/markdownArtifact.integration.test.ts",
+    "lint": "tsc -p ./ --noEmit",
+    "package:vsix": "npx vsce package --no-yarn --out dist/llm-council.vsix",
+    "prepublishOnly": "npm run compile && npm run package:vsix",
+    "postinstall": "node bin/install.js"
+  },
+  "devDependencies": {
+    "@types/glob": "^7.2.0",
+    "@types/mocha": "^10.0.0",
+    "@types/node": "^20.0.0",
+    "@types/vscode": "^1.84.0",
+    "@vscode/test-electron": "^2.4.0",
+    "eslint": "^8.0.0",
+    "glob": "^7.2.3",
+    "mocha": "^10.0.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.0.0",
+    "vitest": "^1.6.1",
+    "@vscode/vsce": "^2.31.0"
+  }
+}