@skyforgeai/skyforge 2.0.0

package/README.md

@@ -0,0 +1,246 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/tryskyforge/skyforge/main/skyforge-tui.png" alt="SkyForge" width="600" />
+</p>
+
+<h3 align="center">SkyForge</h3>
+
+<p align="center">The autonomous ServiceNow development agent.</p>
+<p align="center"><em>AI-powered ServiceNow development, forged for you.</em></p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@skyforgeai/skyforge"><img alt="npm" src="https://img.shields.io/npm/v/%40skyforgeai%2Fskyforge?style=for-the-badge&logo=npm&logoColor=white&color=CB3837" /></a>
+</p>
+
+---
+
+## Install
+
+```bash
+npm i -g @skyforgeai/skyforge@latest
+```
+
+<details>
+<summary><b>More installation methods</b></summary>
+<br>
+
+```bash
+bun add -g @skyforgeai/skyforge@latest                # Bun
+pnpm i -g @skyforgeai/skyforge@latest                             # pnpm
+yarn global add @skyforgeai/skyforge@latest                       # Yarn
+curl -fsSL https://raw.githubusercontent.com/tryskyforge/skyforge/main/install | bash            # Install script
+brew install tryskyforge/tap/skyforge                      # macOS / Linux
+scoop install skyforge                                    # Windows
+```
+
+</details>
+
+## Quick Start
+
+```bash
+skyforge
+```
+
+That's it. SkyForge will prompt you to configure an AI provider on first launch.
+
+
+
+## Why SkyForge?
+
+<table>
+<tr>
+<td width="50%" valign="top">
+
+**ServiceNow-Native**<br>
+<sub>200+ MCP tools and 54 domain skills built for ServiceNow development, deployment, and automation.</sub>
+
+</td>
+<td width="50%" valign="top">
+
+**Any AI Provider**<br>
+<sub>20+ providers: Anthropic, OpenAI, Google, AWS Bedrock, Azure, Groq, xAI, OpenRouter, and more.</sub>
+
+</td>
+</tr>
+<tr>
+<td width="50%" valign="top">
+
+**Multi-Agent**<br>
+<sub>Built-in build &amp; plan agents. Custom agents with per-agent models, permissions, and temperature.</sub>
+
+</td>
+<td width="50%" valign="top">
+
+**Extensible**<br>
+<sub>MCP ecosystem support (stdio, SSE, HTTP). Plugin system via npm or local packages.</sub>
+
+</td>
+</tr>
+</table>
+
+## Supported Providers
+
+<table>
+<tr>
+<td><b>Anthropic</b></td>
+<td><b>OpenAI</b></td>
+<td><b>Google</b></td>
+<td><b>AWS Bedrock</b></td>
+</tr>
+<tr>
+<td><sub>Claude 4.5/4.6</sub></td>
+<td><sub>GPT-5, GPT-4, o-series</sub></td>
+<td><sub>Gemini 2.5 + Vertex AI</sub></td>
+<td><sub>All models, cross-region</sub></td>
+</tr>
+<tr><td colspan="4">&nbsp;</td></tr>
+<tr>
+<td><b>Azure</b></td>
+<td><b>Mistral</b></td>
+<td><b>Groq</b></td>
+<td><b>+ 13 more</b></td>
+</tr>
+<tr>
+<td><sub>OpenAI + Cognitive Services</sub></td>
+<td><sub>Large, Medium, Small</sub></td>
+<td><sub>Ultra-fast inference</sub></td>
+<td><sub>xAI, OpenRouter, Copilot, Cohere, Perplexity, ...</sub></td>
+</tr>
+</table>
+
+## Built-in Tools
+
+```
+ File Operations    Shell              Web                 Dev
+ ───────────────    ─────              ───                 ───
+ read               bash (streaming,   webfetch            plan (enter/exit)
+ write              pty support)       websearch           task management
+ edit                                  codesearch          LSP (experimental)
+ glob                                                      skill invocation
+ grep, ls
+ apply_patch
+```
+
+## ServiceNow MCP Tools
+
+Connect to your ServiceNow instance and access **200+ tools**:
+
+<table>
+<tr>
+<td valign="top"><sub><b>Operations</b> — Query tables, CMDB, users, metrics</sub></td>
+<td valign="top"><sub><b>Development</b> — Script Includes, Business Rules, Client Scripts, UI Policies</sub></td>
+</tr>
+<tr>
+<td valign="top"><sub><b>Deployment</b> — Widgets, Update Sets, validation, rollback</sub></td>
+<td valign="top"><sub><b>Automation</b> — Flow Designer, Scheduled Jobs, Approvals, Events</sub></td>
+</tr>
+<tr>
+<td valign="top"><sub><b>Security</b> — ACLs, Domain Separation, compliance, scanning</sub></td>
+<td valign="top"><sub><b>Analysis</b> — Reporting, Dashboards, KPIs, Performance Analytics</sub></td>
+</tr>
+</table>
+
+```jsonc
+{
+  "mcp": {
+    "servicenow": {
+      "type": "local",
+      "command": ["skyforge", "mcp", "start"],
+      "environment": {
+        "SERVICENOW_INSTANCE_URL": "https://your-instance.service-now.com",
+        "SERVICENOW_CLIENT_ID": "...",
+        "SERVICENOW_CLIENT_SECRET": "...",
+      },
+    },
+  },
+}
+```
+
+## Agents
+
+| Agent       | Description                                                   |
+| :---------- | :------------------------------------------------------------ |
+| **build**   | Full access agent for development work                        |
+| **plan**    | Read-only agent for analysis — denies edits, asks before bash |
+| **general** | Subagent for complex multi-step tasks (`@general`)            |
+
+## CLI
+
+```bash
+skyforge                        # Start TUI
+skyforge serve                  # Headless API server (port 4096)
+skyforge web                    # Server + web interface
+skyforge attach <url>           # Attach to remote server
+skyforge auth                   # Configure authentication
+skyforge models                 # List available models
+skyforge stats                  # Usage statistics
+skyforge export                 # Export session data
+skyforge pr                     # Pull request automation
+```
+
+## Configuration
+
+Config is loaded from (in priority order):
+
+| Priority | Source                                 |
+| :------- | :------------------------------------- |
+| 1        | Remote/well-known organization configs |
+| 2        | Global config (`~/.skyforge/`)        |
+| 3        | `SKY_FORGE_CONFIG` env variable        |
+| 4        | Project config (`skyforge.jsonc`)     |
+| 5        | `SKY_FORGE_CONFIG_CONTENT` inline      |
+
+<details>
+<summary><b>MCP servers</b></summary>
+<br>
+
+```jsonc
+{
+  "mcp": {
+    "my-server": { "type": "local", "command": ["node", "./server.js"] },
+    "remote": { "type": "remote", "url": "https://example.com/mcp" },
+  },
+}
+```
+
+Supports stdio, SSE, and streamable HTTP with OAuth.
+
+</details>
+
+<details>
+<summary><b>Plugins</b></summary>
+<br>
+
+```jsonc
+{
+  "plugin": ["my-skyforge-plugin", "file://./local-plugin"],
+}
+```
+
+</details>
+
+<details>
+<summary><b>Permissions</b></summary>
+<br>
+
+```jsonc
+{
+  "permission": {
+    "bash": "ask",
+    "write": "allow",
+    "read": "allow",
+    "external_directory": "deny",
+  },
+}
+```
+
+Glob patterns, per-agent rulesets, and env file protection included.
+
+</details>
+
+## Links
+
+- [Getting Started](https://skyforgeai.gitbook.io/internal-docs/getting-started)
+- [Configuration](https://skyforgeai.gitbook.io/internal-docs/configuration)
+- [Bug Reports & Feature Requests](https://skyforge.canny.io)
+
+

package/bin/sky-code

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("child_process")
+const fs = require("fs")
+const path = require("path")
+const os = require("os")
+
+const platformMap = { darwin: "darwin", linux: "linux", win32: "windows" }
+const archMap = { x64: "x64", arm64: "arm64" }
+
+const platform = platformMap[os.platform()] || os.platform()
+const arch = archMap[os.arch()] || os.arch()
+const pkgName = `@skyforgeai/skyforge-${platform}-${arch}`
+const binaryName = platform === "windows" ? "sky-code.exe" : "sky-code"
+
+// Search for the platform binary in node_modules
+function findBinary(startDir) {
+  let current = startDir
+  while (true) {
+    const candidate = path.join(current, "node_modules", pkgName, "bin", binaryName)
+    if (fs.existsSync(candidate)) return candidate
+    const parent = path.dirname(current)
+    if (parent === current) break
+    current = parent
+  }
+  return null
+}
+
+const scriptDir = path.dirname(fs.realpathSync(__filename))
+const binary = findBinary(scriptDir)
+
+if (!binary) {
+  console.error(`sky-code: Binary not found for ${platform}-${arch}`)
+  console.error(`Expected package: ${pkgName}`)
+  console.error(`Try: npm install -g @skyforgeai/skyforge`)
+  process.exit(1)
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" })
+process.exit(typeof result.status === "number" ? result.status : 0)

package/package.json

@@ -0,0 +1,150 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "version": "2.0.0",
+  "name": "@skyforgeai/skyforge",
+  "description": "SkyForge - ServiceNow Multi-Agent Development Framework powered by AI",
+  "license": "Elastic-2.0",
+  "private": false,
+  "scripts": {
+    "typecheck": "tsgo --noEmit",
+    "test": "bun test",
+    "build": "bun run script/build.ts",
+    "dev": "bun run --conditions=browser ./src/index.ts",
+    "clean": "echo 'Cleaning up...' && rm -rf node_modules dist",
+    "lint": "bun test --coverage",
+    "format": "bun run --prettier --write src/**/*.ts",
+    "build:mcp": "bun run script/build-mcp.ts"
+  },
+  "files": [
+    "bin",
+    "scripts",
+    "src/skill/bundled-snapshot.d.ts",
+    "README.md"
+  ],
+  "bin": {
+    "skyforge": "./bin/sky-code",
+    "sky-code": "./bin/sky-code"
+  },
+  "exports": {
+    "./*": "./src/*.ts"
+  },
+  "devDependencies": {
+    "@babel/core": "7.28.4",
+    "@octokit/webhooks-types": "7.6.1",
+    "@parcel/watcher-darwin-arm64": "2.5.1",
+    "@parcel/watcher-darwin-x64": "2.5.1",
+    "@parcel/watcher-linux-arm64-glibc": "2.5.1",
+    "@parcel/watcher-linux-arm64-musl": "2.5.1",
+    "@parcel/watcher-linux-x64-glibc": "2.5.1",
+    "@parcel/watcher-linux-x64-musl": "2.5.1",
+    "@parcel/watcher-win32-x64": "2.5.1",
+    "@standard-schema/spec": "1.0.0",
+    "@tsconfig/bun": "1.0.9",
+    "@types/babel__core": "7.20.5",
+    "@types/bun": "1.3.7",
+    "@types/turndown": "5.0.5",
+    "@types/yargs": "17.0.33",
+    "@typescript/native-preview": "7.0.0-dev.20251207.1",
+    "typescript": "5.8.2",
+    "vscode-languageserver-types": "3.17.5",
+    "why-is-node-running": "3.2.2",
+    "zod-to-json-schema": "3.25.1"
+  },
+  "dependencies": {
+    "@actions/core": "1.11.1",
+    "@actions/github": "6.0.1",
+    "@agentclientprotocol/sdk": "0.12.0",
+    "@ai-sdk/amazon-bedrock": "3.0.73",
+    "@ai-sdk/anthropic": "2.0.57",
+    "@ai-sdk/azure": "2.0.91",
+    "@ai-sdk/cerebras": "1.0.34",
+    "@ai-sdk/cohere": "2.0.22",
+    "@ai-sdk/deepinfra": "1.0.31",
+    "@ai-sdk/gateway": "2.0.25",
+    "@ai-sdk/google": "2.0.52",
+    "@ai-sdk/google-vertex": "3.0.97",
+    "@ai-sdk/groq": "2.0.34",
+    "@ai-sdk/mistral": "2.0.27",
+    "@ai-sdk/openai": "2.0.89",
+    "@ai-sdk/openai-compatible": "1.0.30",
+    "@ai-sdk/perplexity": "2.0.23",
+    "@ai-sdk/provider": "2.0.1",
+    "@ai-sdk/provider-utils": "3.0.20",
+    "@ai-sdk/togetherai": "1.0.31",
+    "@ai-sdk/vercel": "1.0.31",
+    "@ai-sdk/xai": "2.0.51",
+    "@clack/prompts": "1.0.0-alpha.1",
+    "@gitlab/gitlab-ai-provider": "3.3.1",
+    "@hono/standard-validator": "0.2.2",
+    "@hono/zod-validator": "0.7.6",
+    "@modelcontextprotocol/sdk": "1.26.0",
+    "@octokit/graphql": "9.0.2",
+    "@octokit/rest": "22.0.0",
+    "@openauthjs/openauth": "0.0.0-20250322224806",
+    "@openrouter/ai-sdk-provider": "1.5.2",
+    "@opentui/core": "0.1.77",
+    "@opentui/solid": "0.1.77",
+    "@parcel/watcher": "2.5.1",
+    "@pierre/diffs": "1.0.2",
+    "@solid-primitives/event-bus": "1.1.2",
+    "@solid-primitives/scheduled": "1.5.2",
+    "@standard-schema/spec": "1.0.0",
+    "@zip.js/zip.js": "2.7.62",
+    "ai": "5.0.124",
+    "axios": "1.13.5",
+    "bonjour-service": "1.3.0",
+    "bun-pty": "0.4.4",
+    "chokidar": "4.0.3",
+    "clipboardy": "4.0.0",
+    "decimal.js": "10.5.0",
+    "diff": "8.0.3",
+    "dotenv": "17.2.3",
+    "fuzzysort": "3.1.0",
+    "gray-matter": "4.0.3",
+    "hono": "4.11.10",
+    "hono-openapi": "1.2.0",
+    "ignore": "7.0.5",
+    "jsonc-parser": "3.3.1",
+    "minimatch": "10.2.1",
+    "node-machine-id": "1.1.12",
+    "open": "10.1.2",
+    "opentui-spinner": "0.0.6",
+    "partial-json": "0.1.7",
+    "remeda": "2.26.0",
+    "solid-js": "1.9.10",
+    "strip-ansi": "7.1.2",
+    "tree-sitter-bash": "0.25.0",
+    "turndown": "7.2.0",
+    "ulid": "3.0.1",
+    "vscode-jsonrpc": "8.2.1",
+    "web-tree-sitter": "0.25.10",
+    "winston": "3.19.0",
+    "xdg-basedir": "5.1.0",
+    "yargs": "18.0.0",
+    "zod": "4.1.8",
+    "zod-to-json-schema": "3.25.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tryskyforge/skyforge"
+  },
+  "homepage": "https://github.com/tryskyforge/skyforge#readme",
+  "bugs": {
+    "url": "https://skyforge.canny.io"
+  },
+  "keywords": [
+    "servicenow",
+    "ai",
+    "agent",
+    "mcp",
+    "cli",
+    "development"
+  ],
+  "optionalDependencies": {
+    "@skyforgeai/skyforge-darwin-arm64": "2.0.0",
+    "@skyforgeai/skyforge-darwin-x64": "2.0.0",
+    "@skyforgeai/skyforge-linux-arm64": "2.0.0",
+    "@skyforgeai/skyforge-linux-x64": "2.0.0",
+    "@skyforgeai/skyforge-windows-x64": "2.0.0"
+  }
+}

package/scripts/postinstall.cjs

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+const https = require("https")
+const fs = require("fs")
+const path = require("path")
+const os = require("os")
+const { execSync } = require("child_process")
+
+const pkg = require("../package.json")
+const VERSION = pkg.version
+const REPO = "tryskyforge/skyforge"
+
+const platformMap = { darwin: "darwin", linux: "linux", win32: "windows" }
+const archMap = { x64: "x64", arm64: "arm64" }
+
+const platform = platformMap[os.platform()] || os.platform()
+const arch = archMap[os.arch()] || os.arch()
+const archiveExt = ".tar.gz"
+const tarballName = "skyforge-" + platform + "-" + arch + archiveExt
+
+const pkgDir = path.join(__dirname, "..")
+const binaryName = platform === "windows" ? "sky-code.exe" : "sky-code"
+const binaryPath = path.join(pkgDir, "bin", binaryName)
+
+// Verify the binary matches the current platform by checking magic bytes
+function binaryMatchesPlatform(filePath) {
+  try {
+    var fd = fs.openSync(filePath, "r")
+    var buf = Buffer.alloc(4)
+    fs.readSync(fd, buf, 0, 4, 0)
+    fs.closeSync(fd)
+    var magic = buf.toString("hex")
+
+    if (platform === "darwin") {
+      // Mach-O: cffaedfe (64-bit LE), feedfacf (64-bit BE), cafebabe (universal/fat)
+      return magic === "cffaedfe" || magic === "feedfacf" || magic === "cafebabe"
+    }
+    if (platform === "linux") {
+      // ELF: 7f454c46
+      return magic === "7f454c46"
+    }
+    if (platform === "windows") {
+      // PE/MZ: 4d5a
+      return magic.startsWith("4d5a")
+    }
+    return false
+  } catch (e) {
+    return false
+  }
+}
+
+// Check if file exists AND is a real binary (not just a launcher script)
+// Launcher scripts are small (~2KB), actual binaries are 20MB+
+// Also verify the binary is for the current platform (not a leftover from CI)
+if (fs.existsSync(binaryPath)) {
+  var stats = fs.statSync(binaryPath)
+  if (stats.size > 100000 && binaryMatchesPlatform(binaryPath)) {
+    console.log("sky-code: Binary already exists")
+    process.exit(0)
+  }
+  if (stats.size > 100000) {
+    console.log("sky-code: Binary exists but is for wrong platform, re-downloading...")
+  }
+}
+
+const releaseUrl = "https://github.com/" + REPO + "/releases/download/v" + VERSION + "/" + tarballName
+console.log("sky-code: Downloading binary for " + platform + "-" + arch + "...")
+
+function followRedirects(url, callback) {
+  https.get(url, { headers: { "User-Agent": "sky-code" } }, function (res) {
+    if (res.statusCode === 302 || res.statusCode === 301) {
+      followRedirects(res.headers.location, callback)
+    } else {
+      callback(res)
+    }
+  })
+}
+
+var tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "skyforge-"))
+var tarPath = path.join(tmpDir, tarballName)
+var file = fs.createWriteStream(tarPath)
+
+followRedirects(releaseUrl, function (res) {
+  if (res.statusCode !== 200) {
+    console.warn("sky-code: Could not download binary (HTTP " + res.statusCode + ")")
+    console.warn("sky-code: Download manually from: https://github.com/" + REPO + "/releases")
+    process.exit(0)
+  }
+
+  res.pipe(file)
+  file.on("finish", function () {
+    file.close()
+    try {
+      // All platforms use tar.gz — tar is available on Windows 10+ (build 17063+)
+      execSync('tar -xzf "' + tarPath + '" -C "' + pkgDir + '"', { stdio: "pipe" })
+      if (fs.existsSync(binaryPath)) {
+        fs.chmodSync(binaryPath, 493)
+      }
+      console.log("sky-code: Binary installed successfully!")
+    } catch (e) {
+      console.warn("sky-code: Could not extract binary")
+    }
+    try {
+      fs.rmSync(tmpDir, { recursive: true })
+    } catch (e) {}
+  })
+})

package/src/skill/bundled-snapshot.d.ts

@@ -0,0 +1,6 @@
+export declare const bundled: readonly {
+  readonly name: string
+  readonly description: string
+  readonly location: string
+  readonly content: string
+}[]