More prep for initial public release readiness (#24)

* Changes for initial public release readiness

This commit makes the following changes as part of the overall effort
to prepare this 'advanced-security/codeql-development-mcp-server' to
be fully ready for initial public release:

- Rename entry point to codeql-development-mcp-server.ts
- Scope all codeql-pack.yml with advanced-security/ prefix
- Add npm publishConfig for GitHub Packages
- Add CODEQL_PATH env var with PATH-prepend strategy
- New package-paths.ts module for npm-install-safe path resolution
- Logger writes all output to stderr (stdout reserved for MCP protocol)
- Fix process.cwd() usages in language-resources, language-server-eval,
  temp-dir, and session-data-manager
- Fix relative cwd/test paths resolved against workspaceRootDir
- Language server spawn() honors CODEQL_PATH via PATH prepend
- Use path.delimiter for Windows portability
- Relax engines to node >=22.0.0
- Fix VERSION constant from 1.0.0 to 2.23.9
- Update server/README.md env vars and file listing
- Updates unit tests to cover source code changes
- Adds 'docs/public.md' documentation of intended public features

* fix: CODEQL_PATH tests and startup validation

- Fix codeql-path-tests CI job that timed out (~17min) on all three OSes
  due to bash pipe PID tracking bug (`$!` captured subshell PID, not
  server PID). Replace inline workflow steps with portable bash scripts
  using background watchdog + `wait` pattern (no GNU `timeout`).

- Add startup-time validation (`validateCodeQLBinaryReachable`) that runs
  `codeql version --format=terse` before tool registration. Server now
  fails fast with actionable error when codeql is not on PATH and
  CODEQL_PATH is not set.

- Add Test 3: verify server fails at startup when codeql is missing from
  both PATH and CODEQL_PATH.

- Address 5 Copilot PR review comments:
  - Implement caching in `resolveCodeQLBinary()` (short-circuit on repeat calls)
  - Fix JSDoc in temp-dir.ts (`<repoRoot>` -> `<packageRoot>`)
  - Gate Windows backslash test to `process.platform === 'win32'`
  - Use `path.isAbsolute()` for cross-platform database path check
  - Guard `additionalPacksPath` with `existsSync()` for npm-installed layouts

Scripts: server/scripts/test-codeql-path-{invalid,missing,valid}.sh
Tests: 375 passed (4 new)

* Attempted fix for cli-executor.test.ts

* Attempted fix for codeql-path-tests on windows-latest

* Address more PR review comments

* Standardize on node24 : v24.13.0

This commit:

- addresses the latest PR review comments for #24
- enforces consistent repo use of node v24.13.0 / node24

* Update package-lock.json

* Attempted fix for build-server.yml workflow

* Fix npm optional dependencies not installed from cache in CI (#25)

---------

Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>

Author: data-douser

.devcontainer/devcontainer.json

@@ -1,5 +1,5 @@
 {
-  "image": "mcr.microsoft.com/devcontainers/typescript-node:22",
+  "image": "mcr.microsoft.com/devcontainers/typescript-node:24",
   "customizations": {
     "vscode": {
       "extensions": [

.github/ISSUE_TEMPLATE/mcp-server-primitive-create.yml

@@ -19,7 +19,7 @@ body:
 
         1. **Repository Context**: Begin by reading these critical reference files:
            - **Repository Structure**: `README.md` - Overview of MCP server architecture and capabilities
-           - **Server Implementation**: `server/src/ql-mcp-server.ts` - Main server implementation
+           - **Server Implementation**: `server/src/codeql-development-mcp-server.ts` - Main server implementation
            - **Existing Tools**: `server/src/tools/codeql-tools.ts` - Current tool implementations
            - **Existing Resources**: `server/src/tools/codeql-resources.ts` - Current resource implementations
 

.github/ISSUE_TEMPLATE/mcp-server-primitive-update.yml

@@ -19,7 +19,7 @@ body:
 
         1. **Repository Context**: Begin by reading these critical reference files:
            - **Repository Structure**: `README.md` - Overview of MCP server architecture
-           - **Server Implementation**: `server/src/ql-mcp-server.ts` - Main server implementation
+           - **Server Implementation**: `server/src/codeql-development-mcp-server.ts` - Main server implementation
            - **Current Tools**: `server/src/tools/codeql-tools.ts` - Tool implementations to update
            - **Current Resources**: `server/src/tools/codeql-resources.ts` - Resource implementations to update
 

.github/agents/mcp-enabled-ql-query-developer.md

@@ -1,8 +1,8 @@
 ---
 name: mcp-enabled-ql-query-developer
 description: An agent enabled with QL MCP Server tools for developing CodeQL queries using test-driven development (TDD).
-model: Claude Opus 4.5 (copilot)
-tools: ['agent', 'codeql-dev-mcp-server/*', 'edit', 'read', 'search', 'todo', 'web', 'vscode']
+model: Claude Opus 4.6 (1M context) (copilot)
+tools: ['agent', 'ql-mcp/*', 'edit', 'read', 'search', 'todo', 'web', 'vscode']
 handoffs:
   - agent: ql-mcp-tool-developer
     label: Fix MCP Tool Issue
@@ -18,7 +18,7 @@ handoffs:
 
 My `mcp-enabled-ql-query-developer` agent:
 
-- Uses the QL MCP Server tools (`codeql-dev-mcp-server/*`) to develop, test, and validate CodeQL queries, libraries, and tests.
+- Uses the QL MCP Server tools (`ql-mcp/*`) to develop, test, and validate CodeQL queries, libraries, and tests.
 - Follows test-driven development (TDD) practices: write tests first, then implement queries to pass those tests.
 - Leverages the `codeql` CLI for all CodeQL operations.
 - ALWAYS uses verbose help (`codeql <subcommand> -h -vv`) when learning about `codeql` CLI commands.

.github/agents/mcp-enabled-ql-workshop-developer.md

@@ -1,7 +1,7 @@
 ---
 name: mcp-enabled-ql-workshop-developer
 description: An agent that creates CodeQL query development workshops from production queries using the QL MCP Server tools. Use this agent to generate guided learning materials that teach developers how to build CodeQL queries incrementally.
-model: Claude Opus 4.5 (copilot)
+model: Claude Opus 4.6 (1M context) (copilot)
 handoffs:
   - agent: ql-mcp-tool-tester
     label: Validate Solution Stage
@@ -35,7 +35,7 @@ My `mcp-enabled-ql-workshop-developer` agent:
 
 ## Core Capabilities
 
-- Uses the QL MCP Server tools (`codeql-dev-mcp-server/*`) to create comprehensive CodeQL query development workshops.
+- Uses the QL MCP Server tools (`ql-mcp/*`) to create comprehensive CodeQL query development workshops.
 - Follows the [`create-codeql-query-development-workshop`](../skills/create-codeql-query-development-workshop/SKILL.md) skill to generate workshops from production-grade queries.
 - Validates AST/CFG tools queries using the [`validate-ql-mcp-server-tools-queries`](../skills/validate-ql-mcp-server-tools-queries/SKILL.md) skill to ensure non-empty output.
 - Leverages the `codeql` CLI for all CodeQL operations.

.github/agents/ql-agent-skills-developer.md

@@ -2,7 +2,7 @@
 name: ql-agent-skills-developer
 description: Develops and improves Agent Skills for the CodeQL Development MCP Server.
 argument-hint: 'Provide the name(s) of the Agent Skill(s) to be created or improved under the .github/skills/ directory, along with specific requirements where available.'
-model: Claude Opus 4.5 (copilot)
+model: Claude Opus 4.6 (1M context) (copilot)
 handoffs:
   - label: Validate a newly created workshop
     agent: ql-mcp-tool-tester

.github/agents/ql-mcp-tool-developer.md

@@ -2,7 +2,7 @@
 name: ql-mcp-tool-developer
 description: An agent for developing new tools and/or improving existing tools for the QL MCP Server.
 argument-hint: 'Provide the name(s) of the CodeQL Development MCP Server tool(s) to be created or improved, along with specific requirements where available.'
-model: Claude Opus 4.5 (copilot)
+model: Claude Opus 4.6 (1M context) (copilot)
 handoffs:
   - label: Test the CodeQL MCP Server tools via workshop
     agent: ql-mcp-tool-tester
@@ -38,7 +38,7 @@ My `ql-mcp-tool-developer` agent:
   - Runs unit tests: `npm test --workspace=server`.
   - Runs integration tests: `client/scripts/run-integration-tests.sh`.
   - Manually validates tools using: `client/src/ql-mcp-client.js`.
-  - Verifies server startup/shutdown: `server/dist/ql-mcp-server.js`.
+  - Verifies server startup/shutdown: `server/dist/codeql-development-mcp-server.js`.
 - Maintains server documentation:
   - Keeps `server/QL-MCP-SERVER.md` synchronized with tool changes.
   - Updates the mermaid architecture diagram for structural changes.

.github/agents/ql-mcp-tool-tester.md

@@ -2,7 +2,7 @@
 name: ql-mcp-tool-tester
 description: An agent for testing and validating tools for the latest QL Development MCP Server.
 argument-hint: 'Provide the name(s) of the CodeQL Development MCP Server tool(s) to be tested and validated, along with specific testing requirements, where available.'
-model: Claude Opus 4.5 (copilot)
+model: Claude Opus 4.6 (1M context) (copilot)
 ---
 
 # `ql-mcp-tool-tester` Agent

.github/prompts/ql-mcp-server-fix-build-and-test.prompt.md

@@ -2,8 +2,7 @@
 name: ql-mcp-server-fix-build-and-test
 description: A prompt for fixing build issues for the QL MCP Server and ensuring extensive testing of the server functionality.
 agent: ql-mcp-tool-developer
-model: Claude Opus 4.5 (copilot)
-tools: [agent, edit, execute, memory, read, search, todo, 'codeql-dev-mcp-server/*']
+model: Claude Opus 4.6 (copilot)
 ---
 
 # `ql-mcp-server-fix-build-and-test` Prompt

.github/skills/add-mcp-support-for-new-language/SKILL.md

@@ -37,24 +37,27 @@ This skill includes automation scripts to accelerate implementation:
 
 ## Quick Reference: Files to Modify
 
-| Category          | File Path                                                      | Change                                  |
-| ----------------- | -------------------------------------------------------------- | --------------------------------------- |
-| **TypeScript**    | `server/src/prompts/workflow-prompts.ts`                       | Add to `SUPPORTED_LANGUAGES`            |
-|                   | `server/src/lib/query-file-finder.ts`                          | Add to `LANGUAGE_EXTENSIONS`            |
-|                   | `server/src/lib/cli-tool-registry.ts`                          | Update error message strings            |
-| **Query Packs**   | `server/ql/{language}/tools/src/`                              | Create 4 tool queries                   |
-|                   | `server/ql/{language}/tools/test/`                             | Create test cases                       |
-| **Scripts**       | `server/scripts/install-packs.sh`                              | Add to `VALID_LANGUAGES` + install call |
-|                   | `server/scripts/extract-test-databases.sh`                     | Add to `VALID_LANGUAGES`                |
-|                   | `server/scripts/run-query-unit-tests.sh`                       | Add to `VALID_LANGUAGES`                |
-| **Documentation** | `server/ql/README.md`                                          | Add language to list                    |
-|                   | `server/src/prompts/tools-query-workflow.prompt.md`            | Add to supported languages              |
-|                   | `server/src/prompts/explain-codeql-query.prompt.md`            | Add to language list                    |
-|                   | `server/src/prompts/document-codeql-query.prompt.md`           | Add to language list                    |
-| **Skills**        | `.github/skills/create-codeql-query-tdd-generic/SKILL.md`      | Add to supported languages              |
-|                   | `.github/skills/validate-ql-mcp-server-tools-queries/SKILL.md` | Add to language table                   |
-| **CI/CD**         | `.github/workflows/query-unit-tests.yml`                       | Add to matrix (standard)                |
-|                   | `.github/workflows/query-unit-tests-{lang}.yml`                | Create if special OS needed             |
+| Category          | File Path                                                      | Change                                          |
+| ----------------- | -------------------------------------------------------------- | ----------------------------------------------- |
+| **TypeScript**    | `server/src/prompts/workflow-prompts.ts`                       | Add to `SUPPORTED_LANGUAGES`                    |
+|                   | `server/src/lib/query-file-finder.ts`                          | Add to `LANGUAGE_EXTENSIONS`                    |
+|                   | `server/src/lib/cli-tool-registry.ts`                          | Update error message strings                    |
+| **Query Packs**   | `server/ql/{language}/tools/src/`                              | Create 4 tool queries                           |
+|                   | `server/ql/{language}/tools/test/`                             | Create test cases                               |
+| **npm Package**   | `server/package.json`                                          | Add `ql/{language}/tools/src/` to `files` array |
+| **Scripts**       | `server/scripts/install-packs.sh`                              | Add to `VALID_LANGUAGES` + install call         |
+|                   | `server/scripts/extract-test-databases.sh`                     | Add to `VALID_LANGUAGES`                        |
+|                   | `server/scripts/run-query-unit-tests.sh`                       | Add to `VALID_LANGUAGES`                        |
+| **Documentation** | `server/ql/README.md`                                          | Add language to list                            |
+|                   | `server/src/prompts/tools-query-workflow.prompt.md`            | Add to supported languages                      |
+|                   | `server/src/prompts/explain-codeql-query.prompt.md`            | Add to language list                            |
+|                   | `server/src/prompts/document-codeql-query.prompt.md`           | Add to language list                            |
+|                   | `docs/public.md`                                               | Add to Supported Languages table                |
+| **Skills**        | `.github/skills/create-codeql-query-tdd-generic/SKILL.md`      | Add to supported languages                      |
+|                   | `.github/skills/validate-ql-mcp-server-tools-queries/SKILL.md` | Add to language table                           |
+| **CI/CD**         | `.github/workflows/query-unit-tests.yml`                       | Add to matrix (standard)                        |
+|                   | `.github/workflows/query-unit-tests-{lang}.yml`                | Create if special OS needed                     |
+|                   | `.github/workflows/release.yml`                                | Add to `LANGUAGES` list in pack publish step    |
 
 ## Phase 1: Create Query Pack Structure
 
@@ -97,7 +100,7 @@ server/ql/{language}/tools/
 Create `server/ql/{language}/tools/src/codeql-pack.yml`:
 
 ```yaml
-name: ql-mcp-{language}-tools-src
+name: advanced-security/ql-mcp-{language}-tools-src
 version: 0.0.1
 library: false
 dependencies:
@@ -109,11 +112,11 @@ dependencies:
 Create `server/ql/{language}/tools/test/codeql-pack.yml`:
 
 ```yaml
-name: ql-mcp-{language}-tools-test
+name: advanced-security/ql-mcp-{language}-tools-test
 version: 0.0.1
 dependencies:
   codeql/{language}-queries: '*'
-  ql-mcp-{language}-tools-src: '*'
+  advanced-security/ql-mcp-{language}-tools-src: ${workspace}
 extractor: { language }
 ```
 
@@ -545,12 +548,16 @@ Before submitting the PR:
 - [ ] Pack lock files generated (`codeql-pack.lock.yml`)
 - [ ] TypeScript source updated and builds successfully
 - [ ] All scripts updated with new language
+- [ ] `server/package.json` `files` array includes `ql/{language}/tools/src/`
+- [ ] `.github/workflows/release.yml` `LANGUAGES` list includes new language
+- [ ] `docs/public.md` Supported Languages table updated
 - [ ] Documentation updated (4+ files)
 - [ ] Skills updated (2+ files)
 - [ ] CI workflow configured (matrix or dedicated)
-- [ ] Server bundle rebuilt (`server/dist/ql-mcp-server.js`)
+- [ ] Server bundle rebuilt (`server/dist/codeql-development-mcp-server.js`)
 - [ ] All existing tests still pass
 - [ ] New language tests pass
+- [ ] `npm pack --dry-run` (from `server/`) includes the new language's `.ql`, `.md`, and `codeql-pack.yml` files
 
 ## Success Criteria