From 209f0512ff1b5f0cc9cd4d56966b5faebf76b49f Mon Sep 17 00:00:00 2001 From: Toni Bergholm Date: Fri, 20 Nov 2026 16:04:19 +0200 Subject: [PATCH] chore(release): v0.1.0-alpha.3 Bump all seven workspaces, the exact internal pins, ENGINE_VERSION and the CLI/MCP versions to 0.1.0-alpha.3, and add the release notes. The release carries the security audit hardening (#84) and the install-script detection-gap fixes (#89, #90, #91, #92). --- .github/workflows/release.yml | 2 +- docs/releases/v0.1.0-alpha.3.md | 112 ++++++++++++++++++++++++++++++++ package-lock.json | 34 +++++----- package.json | 2 +- packages/action/package.json | 6 +- packages/cli/package.json | 6 +- packages/cli/src/index.ts | 2 +- packages/core/package.json | 2 +- packages/core/src/audit.ts | 2 +- packages/mcp/package.json | 4 +- packages/mcp/src/index.ts | 2 +- packages/proxy/package.json | 4 +- packages/sandbox/package.json | 4 +- packages/steward/package.json | 4 +- 14 files changed, 149 insertions(+), 37 deletions(-) create mode 100644 docs/releases/v0.1.0-alpha.3.md diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 2c026a3..eb2e26b 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -23,7 +23,7 @@ on: workflow_dispatch: inputs: tag: - description: "Release tag, e.g. v0.1.0-alpha.2 (must already point at this commit for Stage B)" + description: "Release tag, e.g. v0.1.0-alpha.3 (must already point at this commit for Stage B)" required: true publish: description: "Run Stage B (publish to npm + GitHub prerelease)" diff --git a/docs/releases/v0.1.0-alpha.3.md b/docs/releases/v0.1.0-alpha.3.md new file mode 100644 index 0000000..864d60c --- /dev/null +++ b/docs/releases/v0.1.0-alpha.3.md @@ -0,0 +1,112 @@ +# Sentinel v0.1.0-alpha.3 + +> ⚠️ **Alpha, pre-1.0.** Not production-ready; APIs may change without +> notice between prereleases. + +A security release. A full audit of Sentinel found ways for a package +author, a lockfile, an HTTP client or a sandboxed install script to get past +the checks Sentinel promises. This release closes them, then closes four +follow-up detection gaps in install-script analysis. ADR-0056 records each +decision. + +## Install + +```bash +npm install -g @git-agentic/sentinel-cli@alpha @git-agentic/sentinel-proxy@alpha +``` + +## Upgrade notes (breaking, pre-1.0) + +- The proxy and the steward listen on `127.0.0.1` by default. A deployment + reached over the network must set `SENTINEL_HOST` (proxy) or + `SENTINEL_STEWARD_HOST` (steward). +- `SENTINEL_POLICY` must be exactly `observe` or `block`; anything else stops + startup. +- In open mode, history import and retraction need `SENTINEL_PUBLISH_TOKENS`. +- `sentinel install --enforce` needs npm 7 or newer for dependency scripts, + and refuses packages npm records only with a sha1 hash. +- A lockfile entry from git, from a URL, or with no integrity hash now + blocks `audit-tree`. Older yarn v1 lockfiles from private registries can + hit this. +- Steward: challenges expire after 30 days and are single use. After the + upgrade, every challenge verified before it counts as used, so pending + approvals, transfers, renewals and rulings need a fresh challenge. Claims + linked only through a same-named GitHub or GitLab org now go through the + Tier-2 review. +- `ClaimSteward.approve` is async, and transfer signing takes the current + challenge id. +- Cached audits are re-run once after upgrading (`AUDIT_REVISION` 6). + +## Fixed + +**Scanner** (#84) + +- Tarballs are read the way npm installs them: type-7 entries, npm path + normalization, both readings of a backslash, PAX paths and trailing + separators. A second or hidden root `package.json` raises a critical + `manifest-confusion` finding. +- JavaScript that starts with a magic-byte label is still scanned. Nested + compression counts against the unpack cap. One malformed field no longer + disables a rule, and the regexes on the request path are linear. + +**Trust inputs** (#84) + +- Trusted-publisher repository and ref come from the Fulcio certificate, + not the signer-written predicate. An unmatched signature key id counts as + unsigned. Every SRI token in a lockfile is verified. + +**Proxy** (#84) + +- The npm compatibility routes no longer forward client credentials + upstream, and their bodies are capped. + +**Sandbox** (#84) + +- The macOS profile is passed inline instead of through a temp file a + script could rewrite. +- On Linux, bubblewrap gets its own pid namespace and session, and masks + local IPC sockets (session bus, Docker and other container runtimes). +- `launchctl`, `open`, `systemd-run` and similar tools are carved out. +- Enforced installs bind each dependency script to its audited integrity. + +**Steward** (#84) + +- Tier 1 needs a homepage or repository host under the claimed domain. +- Disputes survive freezes, and transfer signatures bind the current proof. + +**Action, CLI and CI** (#84) + +- The Action escapes workflow commands and Markdown, and the CLI strips + terminal escapes. +- The release workflow installs third-party code only in a job with no token. + +**Install-script analysis** (#89, #90, #91, #92) + +- A hook that calls `npm`, `pnpm`, `yarn` or `bun` is followed into the + package's own scripts, including `pre`/`post` hooks and npm's aliases. +- Scripts run through `source`, pipes, `/usr/bin/env`, `tsx`/`ts-node` or + `node .` are scanned. +- Preloads and command names served by the package's own bundled + `node_modules` are scanned. Node built-ins are excluded. +- Very deep code no longer drops the native-payload loader check into a + name-matching fallback; the loader-chain analysis now walks the syntax tree + iteratively. + +**Dependencies** (#84) + +- Production advisories are fixed (body-parser, hono, fast-uri, qs, zod); + `npm audit --omit=dev` reports none. + +## Known limits + +Recorded in ADR-0056 and the threat model: abstract unix sockets stay +reachable on Linux when `network` is approved, a sandboxed process can +outlive its script on macOS, and a few narrow shell-parsing corner cases in +install-script analysis. + +## Feedback + +Bugs and detection gaps: +[github.com/git-agentic/pkg-registry/issues](https://github.com/git-agentic/pkg-registry/issues). +Exploitable flaws: [private vulnerability reporting](https://github.com/git-agentic/pkg-registry/security) +(see SECURITY.md). diff --git a/package-lock.json b/package-lock.json index 04e7dbd..9d8b0ab 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "sentinel-registry", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "sentinel-registry", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "license": "Apache-2.0", "workspaces": [ "packages/core", @@ -2030,11 +2030,11 @@ }, "packages/action": { "name": "@git-agentic/sentinel-action", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "license": "Apache-2.0", "dependencies": { - "@git-agentic/sentinel-core": "0.1.0-alpha.2", - "@git-agentic/sentinel-proxy": "0.1.0-alpha.2" + "@git-agentic/sentinel-core": "0.1.0-alpha.3", + "@git-agentic/sentinel-proxy": "0.1.0-alpha.3" }, "bin": { "sentinel-ci": "dist/index.js" @@ -2048,11 +2048,11 @@ }, "packages/cli": { "name": "@git-agentic/sentinel-cli", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "license": "Apache-2.0", "dependencies": { - "@git-agentic/sentinel-core": "0.1.0-alpha.2", - "@git-agentic/sentinel-sandbox": "0.1.0-alpha.2", + "@git-agentic/sentinel-core": "0.1.0-alpha.3", + "@git-agentic/sentinel-sandbox": "0.1.0-alpha.3", "commander": "^15.0.0" }, "bin": { @@ -2068,7 +2068,7 @@ }, "packages/core": { "name": "@git-agentic/sentinel-core", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "license": "Apache-2.0", "dependencies": { "@sigstore/bundle": "^4.0.0", @@ -2090,10 +2090,10 @@ }, "packages/mcp": { "name": "@git-agentic/sentinel-mcp", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "license": "Apache-2.0", "dependencies": { - "@git-agentic/sentinel-core": "0.1.0-alpha.2", + "@git-agentic/sentinel-core": "0.1.0-alpha.3", "@modelcontextprotocol/sdk": "^1.29.0", "zod": "^4.6.7" }, @@ -2109,10 +2109,10 @@ }, "packages/proxy": { "name": "@git-agentic/sentinel-proxy", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "license": "Apache-2.0", "dependencies": { - "@git-agentic/sentinel-core": "0.1.0-alpha.2", + "@git-agentic/sentinel-core": "0.1.0-alpha.3", "commander": "^15.0.0", "express": "^5.2.1", "express-rate-limit": "^8.5.2" @@ -2131,10 +2131,10 @@ }, "packages/sandbox": { "name": "@git-agentic/sentinel-sandbox", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "license": "Apache-2.0", "dependencies": { - "@git-agentic/sentinel-core": "0.1.0-alpha.2" + "@git-agentic/sentinel-core": "0.1.0-alpha.3" }, "devDependencies": { "@types/node": "^24.13.2" @@ -2145,10 +2145,10 @@ }, "packages/steward": { "name": "@git-agentic/sentinel-steward", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "license": "Apache-2.0", "dependencies": { - "@git-agentic/sentinel-core": "0.1.0-alpha.2", + "@git-agentic/sentinel-core": "0.1.0-alpha.3", "express": "^5.2.1", "express-rate-limit": "^8.5.2" }, diff --git a/package.json b/package.json index f3fe48f..0e1ab1a 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "sentinel-registry", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "private": true, "description": "Sentinel — an agent-auditable security/audit proxy for the npm ecosystem (Phase 1 wedge).", "license": "Apache-2.0", diff --git a/packages/action/package.json b/packages/action/package.json index 6f2da29..0354705 100644 --- a/packages/action/package.json +++ b/packages/action/package.json @@ -1,6 +1,6 @@ { "name": "@git-agentic/sentinel-action", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "description": "Sentinel CI runner: self-booting dependency-tree audit for GitHub Actions (sentinel-ci) — audits a lockfile, writes a CycloneDX SBOM, and posts a PR verdict.", "license": "Apache-2.0", "type": "module", @@ -42,8 +42,8 @@ "sbom" ], "dependencies": { - "@git-agentic/sentinel-core": "0.1.0-alpha.2", - "@git-agentic/sentinel-proxy": "0.1.0-alpha.2" + "@git-agentic/sentinel-core": "0.1.0-alpha.3", + "@git-agentic/sentinel-proxy": "0.1.0-alpha.3" }, "devDependencies": { "@types/node": "^24.13.2" diff --git a/packages/cli/package.json b/packages/cli/package.json index de2971c..fae8a9b 100644 --- a/packages/cli/package.json +++ b/packages/cli/package.json @@ -1,6 +1,6 @@ { "name": "@git-agentic/sentinel-cli", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "description": "Sentinel CLI: pre-install audit verdicts, whole-tree lockfile audits, registry-redirected npm/npx, policy tooling, and sandbox-enforced installs.", "license": "Apache-2.0", "type": "module", @@ -44,8 +44,8 @@ "sandbox" ], "dependencies": { - "@git-agentic/sentinel-core": "0.1.0-alpha.2", - "@git-agentic/sentinel-sandbox": "0.1.0-alpha.2", + "@git-agentic/sentinel-core": "0.1.0-alpha.3", + "@git-agentic/sentinel-sandbox": "0.1.0-alpha.3", "commander": "^15.0.0" }, "devDependencies": { diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts index ca621e2..7b01c5c 100644 --- a/packages/cli/src/index.ts +++ b/packages/cli/src/index.ts @@ -29,7 +29,7 @@ const program = new Command(); program .name("sentinel") .description("Agent-auditable security layer for npm — pre-install audit verdicts.") - .version("0.1.0-alpha.2"); + .version("0.1.0-alpha.3"); program .command("audit") diff --git a/packages/core/package.json b/packages/core/package.json index ae7f10b..22ae607 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@git-agentic/sentinel-core", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "description": "Sentinel audit engine: deterministic heuristic rules, scoring, data model, lockfile parsing, SBOM export, and pluggable LLM adapter.", "license": "Apache-2.0", "type": "module", diff --git a/packages/core/src/audit.ts b/packages/core/src/audit.ts index e699872..6d91b23 100644 --- a/packages/core/src/audit.ts +++ b/packages/core/src/audit.ts @@ -24,7 +24,7 @@ import type { import type { Advisory } from "./advisory-corpus.js"; import type { VulnAdvisory } from "./vuln-corpus.js"; -export const ENGINE_VERSION = "0.1.0-alpha.2"; +export const ENGINE_VERSION = "0.1.0-alpha.3"; /** Bump whenever rule or extraction semantics change: cached and stored audits from another revision are recomputed. */ export const AUDIT_REVISION = 6; diff --git a/packages/mcp/package.json b/packages/mcp/package.json index 96d3a66..d0ba6f9 100644 --- a/packages/mcp/package.json +++ b/packages/mcp/package.json @@ -1,6 +1,6 @@ { "name": "@git-agentic/sentinel-mcp", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "description": "Sentinel MCP server: agent-native pre-install audit tools backed by the Sentinel proxy (stdio Model Context Protocol server).", "license": "Apache-2.0", "type": "module", @@ -42,7 +42,7 @@ "npm-audit" ], "dependencies": { - "@git-agentic/sentinel-core": "0.1.0-alpha.2", + "@git-agentic/sentinel-core": "0.1.0-alpha.3", "@modelcontextprotocol/sdk": "^1.29.0", "zod": "^4.6.7" }, diff --git a/packages/mcp/src/index.ts b/packages/mcp/src/index.ts index 35da250..66b8736 100644 --- a/packages/mcp/src/index.ts +++ b/packages/mcp/src/index.ts @@ -6,7 +6,7 @@ import { TOOLS } from "./tools.js"; /** Build an McpServer with every Sentinel tool registered against `client`. */ export function createMcpServer(client: ProxyClient): McpServer { - const server = new McpServer({ name: "sentinel", version: "0.1.0-alpha.2" }); + const server = new McpServer({ name: "sentinel", version: "0.1.0-alpha.3" }); for (const tool of TOOLS) { server.registerTool( tool.name, diff --git a/packages/proxy/package.json b/packages/proxy/package.json index dc805f4..19604ce 100644 --- a/packages/proxy/package.json +++ b/packages/proxy/package.json @@ -1,6 +1,6 @@ { "name": "@git-agentic/sentinel-proxy", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "description": "Sentinel registry proxy: transparently serves npm packages while intercepting and auditing each tarball, with an authoritative native publish path, verified claims, and time-locked retraction.", "license": "Apache-2.0", "type": "module", @@ -44,7 +44,7 @@ "package-retraction" ], "dependencies": { - "@git-agentic/sentinel-core": "0.1.0-alpha.2", + "@git-agentic/sentinel-core": "0.1.0-alpha.3", "commander": "^15.0.0", "express": "^5.2.1", "express-rate-limit": "^8.5.2" diff --git a/packages/sandbox/package.json b/packages/sandbox/package.json index 7c10333..418de43 100644 --- a/packages/sandbox/package.json +++ b/packages/sandbox/package.json @@ -1,6 +1,6 @@ { "name": "@git-agentic/sentinel-sandbox", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "description": "Sentinel capability sandbox: generate an OS sandbox profile from approved capabilities and run lifecycle scripts under it (macOS Seatbelt / Linux bubblewrap, deny-by-default).", "license": "Apache-2.0", "type": "module", @@ -43,7 +43,7 @@ "least-privilege" ], "dependencies": { - "@git-agentic/sentinel-core": "0.1.0-alpha.2" + "@git-agentic/sentinel-core": "0.1.0-alpha.3" }, "devDependencies": { "@types/node": "^24.13.2" diff --git a/packages/steward/package.json b/packages/steward/package.json index 41cbc6e..d7ba265 100644 --- a/packages/steward/package.json +++ b/packages/steward/package.json @@ -1,6 +1,6 @@ { "name": "@git-agentic/sentinel-steward", - "version": "0.1.0-alpha.2", + "version": "0.1.0-alpha.3", "description": "Sentinel namespace-claim steward: DNS TXT claim verification, renewal/freeze lifecycle, timelocked transfers, and Ed25519-signed claim/retraction corpus releases.", "license": "Apache-2.0", "type": "module", @@ -42,7 +42,7 @@ "npm-registry" ], "dependencies": { - "@git-agentic/sentinel-core": "0.1.0-alpha.2", + "@git-agentic/sentinel-core": "0.1.0-alpha.3", "express": "^5.2.1", "express-rate-limit": "^8.5.2" },