package.json

{
  "name": "specsmith-vscode",
  "displayName": "specsmith - AEE Workbench",
  "description": "Applied Epistemic Engineering workbench. Multi-agent activity routing, BYOE endpoints, AEE phase tree, epistemic notebooks, hierarchical rules, MCP server registry, FPGA/HDL tool support, Ollama local LLMs.",
"version": "0.10.1",
  "publisher": "BitConcepts",
  "license": "MIT",
  "engines": {
    "vscode": "^1.116.0"
  },
  "categories": [
    "AI",
    "Other"
  ],
  "keywords": [
    "ai",
    "agent",
    "epistemic",
    "requirements",
    "governance",
    "specsmith",
    "fpga",
    "hdl",
    "ollama",
    "execution-profiles"
  ],
  "repository": {
    "type": "git",
    "url": "https://github.com/BitConcepts/specsmith-vscode"
  },
  "privacyPolicy": "https://github.com/BitConcepts/specsmith-vscode/blob/main/PRIVACY.md",
  "activationEvents": [
    "onStartupFinished"
  ],
  "main": "./out/extension.js",
  "contributes": {
    "viewsContainers": {
      "activitybar": [
        {
          "id": "specsmith",
          "title": "specsmith AEE",
          "icon": "media/specsmith.svg"
        }
      ]
    },
    "views": {
      "specsmith": [
        {
          "id": "specsmith.projects",
          "name": "Projects",
          "type": "tree"
        },
        {
          "id": "specsmith.sessions",
          "name": "Sessions",
          "type": "tree"
        },
        {
          "id": "specsmith.workflows",
          "name": "Workflows",
          "type": "tree"
        },
        {
          "id": "specsmith.notebooks",
          "name": "Notebooks",
          "type": "tree"
        },
        {
          "id": "specsmith.rules",
          "name": "Rules",
          "type": "tree"
        },
        {
          "id": "specsmith.mcp",
          "name": "MCP Servers",
          "type": "tree"
        },
        {
          "id": "specsmith.drive",
          "name": "Drive",
          "type": "tree"
        },
        {
          "id": "specsmith.endpoints",
          "name": "BYOE Endpoints",
          "type": "tree"
        },
        {
          "id": "specsmith.agents",
          "name": "Agent Profiles",
          "type": "tree"
        },
        {
          "id": "specsmith.bookmarks",
          "name": "Bookmarks",
          "type": "tree"
        }
      ]
    },
    "commands": [
      {
        "command": "specsmith.newSession",
        "title": "New Agent Session",
        "category": "specsmith",
        "icon": "$(add)"
      },
      {
        "command": "specsmith.newSessionFromProject",
        "title": "Open Agent Session",
        "category": "specsmith",
        "icon": "$(comment-discussion)"
      },
      {
        "command": "specsmith.deleteSession",
        "title": "Remove Session",
        "category": "specsmith",
        "icon": "$(trash)"
      },
      {
        "command": "specsmith.openProject",
        "title": "Add Project Folder",
        "category": "specsmith",
        "icon": "$(folder-opened)"
      },
      {
        "command": "specsmith.createProject",
        "title": "Create New Project",
        "category": "specsmith",
        "icon": "$(add)"
      },
      {
        "command": "specsmith.importProject",
        "title": "Import Existing Project",
        "category": "specsmith",
        "icon": "$(cloud-download)"
      },
      {
        "command": "specsmith.removeProject",
        "title": "Remove from Sidebar",
        "category": "specsmith",
        "icon": "$(remove)"
      },
      {
        "command": "specsmith.refreshProjects",
        "title": "Refresh",
        "category": "specsmith",
        "icon": "$(refresh)"
      },
      {
        "command": "specsmith.newFile",
        "title": "New File",
        "category": "specsmith",
        "icon": "$(new-file)"
      },
      {
        "command": "specsmith.newFolder",
        "title": "New Folder",
        "category": "specsmith",
        "icon": "$(new-folder)"
      },
      {
        "command": "specsmith.deleteFile",
        "title": "Delete",
        "category": "specsmith",
        "icon": "$(trash)"
      },
      {
        "command": "specsmith.renameFile",
        "title": "Rename",
        "category": "specsmith"
      },
      {
        "command": "specsmith.copyFilePath",
        "title": "Copy Path",
        "category": "specsmith"
      },
      {
        "command": "specsmith.revealInExplorer",
        "title": "Reveal in Explorer",
        "category": "specsmith"
      },
      {
        "command": "specsmith.setApiKey",
        "title": "Set API Key",
        "category": "specsmith",
        "icon": "$(key)"
      },
      {
        "command": "specsmith.clearApiKey",
        "title": "Clear API Key",
        "category": "specsmith"
      },
      {
        "command": "specsmith.apiKeyStatus",
        "title": "API Key Status",
        "category": "specsmith"
      },
      {
        "command": "specsmith.runAudit",
        "title": "Run Audit",
        "category": "specsmith"
      },
      {
        "command": "specsmith.runValidate",
        "title": "Run Validate",
        "category": "specsmith"
      },
      {
        "command": "specsmith.runDoctor",
        "title": "Run Doctor",
        "category": "specsmith"
      },
      {
        "command": "specsmith.runPreflight",
        "title": "Run Preflight (Nexus)",
        "category": "specsmith",
        "icon": "$(rocket)"
      },
      {
        "command": "specsmith.runVerify",
        "title": "Run Verify (Nexus)",
        "category": "specsmith",
        "icon": "$(check)"
      },
      {
        "command": "specsmith.toggleWhy",
        "title": "Toggle /why Governance Details",
        "category": "specsmith",
        "icon": "$(question)"
      },
      {
        "command": "specsmith.openChat",
        "title": "Open Chat (Nexus JSONL)",
        "category": "specsmith",
        "icon": "$(comment-discussion)"
      },
      {
        "command": "specsmith.switchProfile",
        "title": "Switch Execution Profile",
        "category": "specsmith",
        "icon": "$(shield)"
      },
      {
        "command": "specsmith.openCreditsReport",
        "title": "Open Credits Summary",
        "category": "specsmith",
        "icon": "$(graph)"
      },
      {
        "command": "specsmith.runWorkflow",
        "title": "Run Workflow",
        "category": "specsmith",
        "icon": "$(play-circle)"
      },
      {
        "command": "specsmith.addRequirement",
        "title": "Quick Add Requirement",
        "category": "specsmith",
        "icon": "$(add)"
      },
      {
        "command": "specsmith.navigateRequirements",
        "title": "Navigate Requirements",
        "category": "specsmith",
        "icon": "$(list-unordered)"
      },
      {
        "command": "specsmith.openScaffold",
        "title": "Open Scaffolding File",
        "category": "specsmith",
        "icon": "$(settings-gear)"
      },
      {
        "command": "specsmith.showSettings",
        "title": "Settings",
        "category": "specsmith",
        "icon": "$(gear)"
      },
      {
        "command": "specsmith.showHelp",
        "title": "Show Help",
        "category": "specsmith",
        "icon": "$(question)"
      },
      {
        "command": "specsmith.showGovernance",
        "title": "Open Project Settings",
        "category": "specsmith",
        "icon": "$(settings-gear)"
      },
      {
        "command": "specsmith.installOrUpgrade",
        "title": "Install or Upgrade specsmith",
        "category": "specsmith",
        "icon": "$(cloud-download)"
      },
      {
        "command": "specsmith.restartAgent",
        "title": "Restart Agent (active session)",
        "category": "specsmith",
        "icon": "$(debug-restart)"
      },
      {
        "command": "specsmith.clearHistory",
        "title": "Clear Chat History (current session)",
        "category": "specsmith",
        "icon": "$(clear-all)"
      },
      {
        "command": "specsmith.clearAllHistory",
        "title": "Clear Chat History (all sessions)",
        "category": "specsmith",
        "icon": "$(clear-all)"
      },
      {
        "command": "specsmith.downloadModel",
        "title": "Download Ollama Model",
        "category": "specsmith",
        "icon": "$(cloud-download)"
      },
      {
        "command": "specsmith.selectModelForTask",
        "title": "Select Model for Task (GPU-aware)",
        "category": "specsmith",
        "icon": "$(symbol-misc)"
      },
      {
        "command": "specsmith.reportBug",
        "title": "Report a Bug",
        "category": "specsmith",
        "icon": "$(bug)"
      },
      {
        "command": "specsmith.reportIssue",
        "title": "Report Issue / Suggest Feature",
        "category": "specsmith",
        "icon": "$(comment-discussion)"
      },
      {
        "command": "specsmith.openWelcome",
        "title": "Show Welcome",
        "category": "specsmith",
        "icon": "$(home)"
      },
      {
        "command": "specsmith.spawnSubAgent",
        "title": "Spawn Sub-Agent",
        "category": "specsmith",
        "icon": "$(repo-forked)"
      },
      {
        "command": "specsmith.bookmarkBlock",
        "title": "Open Block Bookmarks",
        "category": "specsmith",
        "icon": "$(bookmark)"
      },
      {
        "command": "specsmith.drivePush",
        "title": "Drive: Push to Drive",
        "category": "specsmith",
        "icon": "$(cloud-upload)"
      },
      {
        "command": "specsmith.drivePull",
        "title": "Drive: Pull from Drive",
        "category": "specsmith",
        "icon": "$(cloud-download)"
      },
      {
        "command": "specsmith.driveRefresh",
        "title": "Drive: Refresh",
        "category": "specsmith",
        "icon": "$(refresh)"
      },
      {
        "command": "specsmith.driveRevealRoot",
        "title": "Drive: Reveal Folder in OS",
        "category": "specsmith",
        "icon": "$(folder-opened)"
      },
      {
        "command": "specsmith.removeBookmark",
        "title": "Remove Bookmark",
        "category": "specsmith",
        "icon": "$(trash)"
      },
      {
        "command": "specsmith.revealBookmark",
        "title": "Reveal Bookmark",
        "category": "specsmith"
      },
      {
        "command": "specsmith.refreshBookmarks",
        "title": "Refresh Bookmarks",
        "category": "specsmith",
        "icon": "$(refresh)"
      },
      {
        "command": "specsmith.searchHistory",
        "title": "Search Agent History",
        "category": "specsmith",
        "icon": "$(search)"
      },
      {
        "command": "specsmith.transcribeAudio",
        "title": "Transcribe Audio File (Voice)",
        "category": "specsmith",
        "icon": "$(unmute)"
      },
      {
        "command": "specsmith.suggestCommand",
        "title": "Suggest Command",
        "category": "specsmith",
        "icon": "$(lightbulb)"
      },
      {
        "command": "specsmith.endpoints",
        "title": "BYOE Endpoints\u2026",
        "category": "specsmith",
        "icon": "$(plug)"
      },
      {
        "command": "specsmith.testEndpoint",
        "title": "Test BYOE Endpoint",
        "category": "specsmith",
        "icon": "$(beaker)"
      },
      {
        "command": "specsmith.refreshEndpoints",
        "title": "Refresh BYOE Endpoints",
        "category": "specsmith",
        "icon": "$(refresh)"
      },
      {
        "command": "specsmith.agents",
        "title": "Agent Profiles\u2026",
        "category": "specsmith",
        "icon": "$(person)"
      },
      {
        "command": "specsmith.testAgent",
        "title": "Test Agent Profile",
        "category": "specsmith",
        "icon": "$(beaker)"
      },
      {
        "command": "specsmith.refreshAgents",
        "title": "Refresh Agent Profiles",
        "category": "specsmith",
        "icon": "$(refresh)"
      },
      {
        "command": "specsmith.applyAgentPreset",
        "title": "Apply Agent Preset (default / local-only / frontier-only / cost-conscious)",
        "category": "specsmith",
        "icon": "$(library)"
      },
      {
        "command": "specsmith.routeActivity",
        "title": "Route Activity to Agent Profile",
        "category": "specsmith",
        "icon": "$(arrow-right)"
      },
      {
        "command": "specsmith.pickSessionProfile",
        "title": "Pick Session Profile",
        "category": "specsmith",
        "icon": "$(person-add)"
      },
      {
        "command": "specsmith.refreshWorkflows",
        "title": "Refresh Workflows",
        "category": "specsmith",
        "icon": "$(refresh)"
      },
      {
        "command": "specsmith.advancePhase",
        "title": "Advance AEE Phase",
        "category": "specsmith",
        "icon": "$(arrow-right)"
      },
      {
        "command": "specsmith.openRun",
        "title": "Open Run Folder",
        "category": "specsmith"
      },
      {
        "command": "specsmith.refreshNotebooks",
        "title": "Refresh Epistemic Notebooks",
        "category": "specsmith",
        "icon": "$(refresh)"
      },
      {
        "command": "specsmith.newNotebook",
        "title": "New Epistemic Notebook",
        "category": "specsmith",
        "icon": "$(add)"
      },
      {
        "command": "specsmith.refreshRules",
        "title": "Refresh Rules",
        "category": "specsmith",
        "icon": "$(refresh)"
      },
      {
        "command": "specsmith.refreshMcp",
        "title": "Refresh MCP Servers",
        "category": "specsmith",
        "icon": "$(refresh)"
      }
    ],
    "menus": {
      "view/title": [
        {
          "command": "specsmith.newSession",
          "when": "view == specsmith.sessions",
          "group": "navigation"
        },
        {
          "command": "specsmith.showSettings",
          "when": "view == specsmith.sessions",
          "group": "navigation"
        },
        {
          "command": "specsmith.showHelp",
          "when": "view == specsmith.sessions",
          "group": "navigation"
        },
        {
          "command": "specsmith.showSettings",
          "when": "view == specsmith.projects",
          "group": "navigation"
        },
        {
          "command": "specsmith.openProject",
          "when": "view == specsmith.projects",
          "group": "navigation"
        },
        {
          "command": "specsmith.createProject",
          "when": "view == specsmith.projects",
          "group": "navigation"
        },
        {
          "command": "specsmith.importProject",
          "when": "view == specsmith.projects",
          "group": "navigation"
        },
        {
          "command": "specsmith.refreshProjects",
          "when": "view == specsmith.projects",
          "group": "navigation"
        },
        {
          "command": "specsmith.drivePush",
          "when": "view == specsmith.drive",
          "group": "navigation"
        },
        {
          "command": "specsmith.drivePull",
          "when": "view == specsmith.drive",
          "group": "navigation"
        },
        {
          "command": "specsmith.driveRefresh",
          "when": "view == specsmith.drive",
          "group": "navigation"
        },
        {
          "command": "specsmith.driveRevealRoot",
          "when": "view == specsmith.drive",
          "group": "navigation"
        },
        {
          "command": "specsmith.refreshBookmarks",
          "when": "view == specsmith.bookmarks",
          "group": "navigation"
        },
        {
          "command": "specsmith.refreshEndpoints",
          "when": "view == specsmith.endpoints",
          "group": "navigation"
        },
        {
          "command": "specsmith.endpoints",
          "when": "view == specsmith.endpoints",
          "group": "navigation"
        },
        {
          "command": "specsmith.refreshAgents",
          "when": "view == specsmith.agents",
          "group": "navigation"
        },
        {
          "command": "specsmith.agents",
          "when": "view == specsmith.agents",
          "group": "navigation"
        },
        {
          "command": "specsmith.applyAgentPreset",
          "when": "view == specsmith.agents",
          "group": "navigation"
        },
        {
          "command": "specsmith.refreshWorkflows",
          "when": "view == specsmith.workflows",
          "group": "navigation"
        },
        {
          "command": "specsmith.advancePhase",
          "when": "view == specsmith.workflows",
          "group": "navigation"
        },
        {
          "command": "specsmith.refreshNotebooks",
          "when": "view == specsmith.notebooks",
          "group": "navigation"
        },
        {
          "command": "specsmith.newNotebook",
          "when": "view == specsmith.notebooks",
          "group": "navigation"
        },
        {
          "command": "specsmith.refreshRules",
          "when": "view == specsmith.rules",
          "group": "navigation"
        },
        {
          "command": "specsmith.refreshMcp",
          "when": "view == specsmith.mcp",
          "group": "navigation"
        }
      ],
      "view/item/context": [
        {
          "command": "specsmith.showGovernance",
          "when": "view == specsmith.projects && viewItem == project",
          "group": "inline"
        },
        {
          "command": "specsmith.newSessionFromProject",
          "when": "view == specsmith.projects && viewItem == project",
          "group": "inline"
        },
        {
          "command": "specsmith.removeProject",
          "when": "view == specsmith.projects && viewItem == project",
          "group": "1_project"
        },
        {
          "command": "specsmith.deleteSession",
          "when": "view == specsmith.sessions && viewItem == session",
          "group": "inline"
        },
        {
          "command": "specsmith.newFile",
          "when": "view == specsmith.projects && (viewItem == dir || viewItem == project)",
          "group": "inline"
        },
        {
          "command": "specsmith.newFolder",
          "when": "view == specsmith.projects && (viewItem == dir || viewItem == project)",
          "group": "inline"
        },
        {
          "command": "specsmith.deleteFile",
          "when": "view == specsmith.projects && (viewItem == file || viewItem == dir)",
          "group": "7_modification"
        },
        {
          "command": "specsmith.renameFile",
          "when": "view == specsmith.projects && (viewItem == file || viewItem == dir)",
          "group": "7_modification"
        },
        {
          "command": "specsmith.copyFilePath",
          "when": "view == specsmith.projects && (viewItem == file || viewItem == dir || viewItem == govdoc)",
          "group": "6_copy"
        },
        {
          "command": "specsmith.revealInExplorer",
          "when": "view == specsmith.projects && (viewItem == file || viewItem == dir)",
          "group": "6_copy"
        },
        {
          "command": "specsmith.removeBookmark",
          "when": "view == specsmith.bookmarks && viewItem == bookmark",
          "group": "inline"
        }
      ]
    },
    "keybindings": [
      {
        "command": "specsmith.newSession",
        "key": "ctrl+shift+;",
        "mac": "cmd+shift+;"
      },
      {
        "command": "specsmith.showSettings",
        "key": "ctrl+shift+,",
        "mac": "cmd+shift+,"
      },
      {
        "command": "specsmith.showGovernance",
        "key": "ctrl+shift+g",
        "mac": "cmd+shift+g"
      },
      {
        "command": "specsmith.addRequirement",
        "key": "ctrl+shift+r",
        "mac": "cmd+shift+r"
      },
      {
        "command": "specsmith.navigateRequirements",
        "key": "ctrl+shift+q",
        "mac": "cmd+shift+q"
      },
      {
        "command": "specsmith.showHelp",
        "key": "ctrl+shift+h",
        "mac": "cmd+shift+h",
        "when": "activeWebviewPanelId == 'specsmithSession'"
      }
    ],
    "configuration": {
      "title": "specsmith",
      "properties": {
        "specsmith.executablePath": {
          "type": "string",
          "default": "specsmith",
          "description": "Path to the specsmith CLI. Defaults to 'specsmith' (must be on PATH). If specsmith isn't found, set the full path here."
        },
        "specsmith.startupTimeoutMs": {
          "type": "number",
          "default": 60000,
          "minimum": 5000,
          "maximum": 600000,
          "description": "Milliseconds the bridge waits for `specsmith run --json-events` to emit a `ready` event before retrying once and then surfacing a recoverable error. Raise this if cold Ollama model loads (14B+ on first run) routinely time out. Clamped to [5000, 600000]; default 60000."
        },
        "specsmith.defaultProvider": {
          "type": "string",
          "default": "ollama",
          "enum": [
            "ollama",
            "anthropic",
            "openai",
            "gemini",
            "mistral"
          ],
          "enumDescriptions": [
            "Ollama local models — no API key needed (default)",
            "Anthropic Claude — set key via 'specsmith: Set API Key'",
            "OpenAI GPT/O-series — set key via 'specsmith: Set API Key'",
            "Google Gemini — set key via 'specsmith: Set API Key'",
            "Mistral AI + Pixtral OCR — set key via 'specsmith: Set API Key'"
          ],
          "description": "Default LLM provider. Ollama (local) is the default — no API key needed. Auto-overridden if exactly one cloud API key is configured."
        },
        "specsmith.defaultModel": {
          "type": "string",
          "default": "",
          "description": "Default model (blank = provider default). Per-project settings override this."
        },
        "specsmith.watchedProjects": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "default": [],
          "description": "Project directories to persist in the sidebar."
        },
        "specsmith.autoOpenGovernancePanel": {
          "type": "boolean",
          "default": true,
          "description": "Automatically open the Settings and Project Settings panels when VS Code starts. Settings (global: venv, Ollama, version) always opens. Project Settings (project scaffold, tools, files) opens when a workspace folder is available."
        },
        "specsmith.ollamaContextLength": {
          "type": "number",
          "default": 0,
          "enum": [
            0,
            4096,
            8192,
            16384,
            32768,
            65536,
            131072
          ],
          "enumDescriptions": [
            "Auto-detect based on GPU VRAM (recommended)",
            "4K tokens — safe for all hardware",
            "8K tokens — 4-8GB VRAM",
            "16K tokens — 8-16GB VRAM",
            "32K tokens — 16-24GB VRAM",
            "64K tokens — 24GB+ VRAM",
            "128K tokens — 24GB+ VRAM (supported models only)"
          ],
          "description": "Ollama context window size (num_ctx). 0 = auto-detect from GPU VRAM. Session-specific: changing this takes effect when you open a new session."
        },
        "specsmith.envPath": {
          "type": "string",
          "default": "",
          "description": "Custom path to the specsmith environment (venv). Leave empty to use the default: ~/.specsmith/venv (or %USERPROFILE%\\.specsmith\\venv on Windows). The directory must contain a specsmith binary. Restart VS Code after changing this setting."
        },
        "specsmith.releaseChannel": {
          "type": "string",
          "default": "stable",
          "enum": [
            "stable",
            "pre-release"
          ],
          "enumDescriptions": [
            "Latest stable release from PyPI (recommended). Uses pipx upgrade or pip install --upgrade.",
            "Latest pre-release / dev build (0.x.y.devN). Cutting-edge features; may have rough edges. Uses pip install --pre."
          ],
          "description": "specsmith release channel. Controls which version is installed by the 'Install or Upgrade' command and the Install Update button in the Settings panel."
        },
        "specsmith.checkForUpdatesOnStart": {
          "type": "boolean",
          "default": true,
          "description": "Automatically check for specsmith CLI updates when VS Code starts. Shows a notification if a newer version is available."
        },
        "specsmith.checkOllamaOnStart": {
          "type": "boolean",
          "default": true,
          "description": "Automatically check Ollama version and model updates when VS Code starts. Shows update indicators in the Ollama tab."
        },
        "specsmith.showPhaseInStatusBar": {
          "type": "boolean",
          "default": true,
          "description": "Show the current AEE lifecycle phase in the VS Code status bar."
        },
        "specsmith.enablePredictNext": {
          "type": "boolean",
          "default": true,
          "description": "Show predict-next ghost text in Markdown files. Calls `specsmith preflight --predict-only` against the current line and proposes a refined utterance. Disable if you don't want the extension to spawn the CLI on each keystroke pause."
        },
        "specsmith.remoteServeUrl": {
          "type": "string",
          "default": "",
          "description": "Optional remote `specsmith serve` URL (e.g. http://10.0.0.4:8421). When set, future remote bridges will connect here instead of spawning a local agent. Leave blank for local sessions (default). REQ-137 \u2014 the active remote bridge wiring lands in a follow-up; this setting is read at session start so configuring it is safe today."
        },
        "specsmith.remoteServeToken": {
          "type": "string",
          "default": "",
          "description": "Bearer token for the remote `specsmith serve --auth-token` endpoint configured in `specsmith.remoteServeUrl`. Stored in your settings.json; if you prefer the OS keychain, leave this blank and use `specsmith: Set API Key` once a 'remote' provider lands. REQ-137."
        }
      }
    }
  },
  "scripts": {
    "build": "node esbuild.mjs",
    "watch": "node esbuild.mjs --watch",
    "package": "npm run build && vsce package",
    "lint": "tsc --noEmit",
    "test": "mocha"
  },
  "devDependencies": {
    "@types/mocha": "^10.0.10",
    "@types/node": "^25.6.0",
    "@types/vscode": "^1.116.0",
    "@vscode/test-electron": "^2.5.2",
    "esbuild": "^0.28.0",
    "mocha": "^11.7.5",
    "ts-node": "^10.9.2",
    "typescript": "^6.0.3"
  },
  "overrides": {
    "serialize-javascript": ">=7.0.3",
    "diff": ">=8.0.3"
  }
}