{"_id":"@agent-stack2/ops","_rev":"2-615f21732eb18d926d867647a8a3b37f","name":"@agent-stack2/ops","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@agent-stack2/ops","version":"0.1.0","keywords":["agent-stack","ops","ci-cd","mcp","coding-agents"],"author":{"name":"jsalvadorlpz"},"license":"MIT","_id":"@agent-stack2/ops@0.1.0","maintainers":[{"name":"josepsalvador","email":"josep100998@gmail.com"}],"homepage":"https://github.com/jsalvadorlpz/agent-stack#readme","bugs":{"url":"https://github.com/jsalvadorlpz/agent-stack/issues"},"bin":{"agent-ops":"dist/server.js"},"dist":{"shasum":"e754da2f76ee7f1ccff4fe779e6edb5016762ca9","tarball":"https://registry.npmjs.org/@agent-stack2/ops/-/ops-0.1.0.tgz","fileCount":107,"integrity":"sha512-revl9lI/yuqyrwYKiW6iz0ZSbOEfQtjPDcPgonLa25sMbhSXlkp65ZjM9yj/yo84+LF11t+RwYvm0c9G4MWV1A==","signatures":[{"sig":"MEUCIQCgdh5Mr7iUmYVVpH6lXX7Yu4S0ekPYvTlBVF0+RZKz9wIgb6ytDEg0FOHzTlPqqxMoXwF2B+wwbgfBG7+Y/TkYMXg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":446405},"main":"dist/server.js","type":"module","_from":"file:agent-stack2-ops-0.1.0.tgz","types":"./dist/server.d.ts","engines":{"node":">=18.0.0"},"scripts":{"test":"vitest run","build":"tsc","clean":"rm -rf dist","start":"node dist/server.js","typecheck":"tsc --noEmit"},"_npmUser":{"name":"josepsalvador","email":"josep100998@gmail.com"},"_resolved":"/tmp/397df4dc14f213dbdc8ef3eae6596004/agent-stack2-ops-0.1.0.tgz","_integrity":"sha512-revl9lI/yuqyrwYKiW6iz0ZSbOEfQtjPDcPgonLa25sMbhSXlkp65ZjM9yj/yo84+LF11t+RwYvm0c9G4MWV1A==","repository":{"url":"git+https://github.com/jsalvadorlpz/agent-stack.git","type":"git","directory":"packages/ops"},"_npmVersion":"10.8.2","description":"Operational reality MCP for coding agents: CI, deploy, runtime, and release-readiness signals","directories":{},"_nodeVersion":"20.20.1","dependencies":{"zod":"^3.24.4","@agent-stack2/token-gate":"0.1.0","@modelcontextprotocol/sdk":"^1.12.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^3.1.1","typescript":"^5.8.3","@types/node":"^22.15.3"},"_npmOperationalInternal":{"tmp":"tmp/ops_0.1.0_1774196729912_0.6281604909759926","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@agent-stack2/ops","version":"0.2.0","description":"Operational reality MCP for coding agents: CI, deploy, runtime, and release-readiness signals","license":"MIT","author":{"name":"jsalvadorlpz"},"repository":{"type":"git","url":"git+https://github.com/jsalvadorlpz/agent-stack.git","directory":"packages/ops"},"homepage":"https://github.com/jsalvadorlpz/agent-stack#readme","bugs":{"url":"https://github.com/jsalvadorlpz/agent-stack/issues"},"keywords":["agent-stack","ops","ci-cd","mcp","coding-agents"],"type":"module","main":"dist/server.js","bin":{"agent-ops":"dist/server.js"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","zod":"^3.24.4","@agent-stack2/token-gate":"0.1.0"},"devDependencies":{"@types/node":"^22.15.3","typescript":"^5.8.3","vitest":"^3.1.1"},"scripts":{"build":"tsc","start":"node dist/server.js","test":"vitest run","clean":"rm -rf dist","typecheck":"tsc --noEmit"},"_id":"@agent-stack2/ops@0.2.0","types":"./dist/server.d.ts","_integrity":"sha512-dTen5K96gV8/br4WfxutitauFm37ZL3hwVquBW6x+sw+qQ9t8kdM9vMQ5hHAkeSI6l5AzFUPimTMBMuNWsjlaw==","_resolved":"/tmp/1e3a96f6237df104bfc4d452cf0780c3/agent-stack2-ops-0.2.0.tgz","_from":"file:agent-stack2-ops-0.2.0.tgz","_nodeVersion":"20.20.1","_npmVersion":"10.8.2","dist":{"integrity":"sha512-dTen5K96gV8/br4WfxutitauFm37ZL3hwVquBW6x+sw+qQ9t8kdM9vMQ5hHAkeSI6l5AzFUPimTMBMuNWsjlaw==","shasum":"19c29b8ee3692ff13d1766df5137b4b1109b252c","tarball":"https://registry.npmjs.org/@agent-stack2/ops/-/ops-0.2.0.tgz","fileCount":59,"unpackedSize":208088,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIF3wcHWMtC38+q7stC35dQqmA8AWU+iZHkbavXXoGRGbAiAwSUSRKJWPh5aBGSjTcGx306TNmHQlgYZz4n5Fy2fjRw=="}]},"_npmUser":{"name":"josepsalvador","email":"josep100998@gmail.com"},"directories":{},"maintainers":[{"name":"josepsalvador","email":"josep100998@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ops_0.2.0_1774461000388_0.4758533776241036"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-22T16:25:29.793Z","modified":"2026-03-25T17:50:00.672Z","0.1.0":"2026-03-22T16:25:30.062Z","0.2.0":"2026-03-25T17:50:00.533Z"},"bugs":{"url":"https://github.com/jsalvadorlpz/agent-stack/issues"},"author":{"name":"jsalvadorlpz"},"license":"MIT","homepage":"https://github.com/jsalvadorlpz/agent-stack#readme","keywords":["agent-stack","ops","ci-cd","mcp","coding-agents"],"repository":{"type":"git","url":"git+https://github.com/jsalvadorlpz/agent-stack.git","directory":"packages/ops"},"description":"Operational reality MCP for coding agents: CI, deploy, runtime, and release-readiness signals","maintainers":[{"name":"josepsalvador","email":"josep100998@gmail.com"}],"readme":"# Agent Ops\n\n`agent-ops` is the operational reality layer for coding agents.\n\nIt should answer the questions code search cannot:\n\n- Did the branch pass CI?\n- Is the latest commit actually deployed, and where?\n- Did runtime errors appear after that deploy?\n- Is the PR review-ready or release-blocked?\n- Who owns the problem if the system is unhealthy?\n\n## Honest current state\n\nToday this repo is a read-only MCP server with:\n\n- GitHub workflow status for the current branch\n- environment-aware deploy health checks with per-env commit comparison\n- a Sentry unresolved-issues snapshot\n- PR review and comment snapshotting\n- a normalized `get_ops_summary()` with full ops-context schema\n- explicit release-readiness computation with environment-aware blocker logic\n- append-only ops history with fingerprint dedup\n- a memory bridge to Agent Memory for durable ops findings\n- local config storage in `.agent-ops/config.json`\n\nStill missing:\n\n- incident provider integrations and regression detection from recurrence evidence\n- ownership/escalation signals\n- richer deploy/runtime providers beyond a generic health endpoint\n- a standalone operator-friendly CLI surface\n\n## Why this repo exists\n\nThe rest of the toolkit already covers adjacent truths:\n\n- `agent-memory` preserves execution continuity\n- `agent-coordinator` shows who is doing what now\n- `agent-guardian` validates change safety\n- `agent-project-context` explains business and product intent\n\n`agent-ops` should tell an agent what is true in CI, deploys, runtime, and release state right now.\n\n## When an agent should consult agent-ops\n\n- after pushing code\n- before merging or handing off work\n- at session boot for build, deploy, release, or incident tasks\n- when a human asks \"did this actually ship?\" or \"is prod healthy?\"\n- when deciding whether a failure is local, pipeline, deploy, or runtime\n\n## Current MCP tools\n\n- `check_ci()` - branch-level GitHub Actions status\n- `check_deploy()` - deploy health plus commit comparison (legacy single-environment)\n- `get_deploy_matrix()` - per-environment deploy state across all configured environments\n- `check_errors(since?)` - Sentry unresolved issue snapshot\n- `check_pr()` - PR state, reviews, and comments for the current branch\n- `get_ops_summary()` - full normalized operational context in one call\n- `get_release_readiness()` - release readiness with blockers and evidence\n- `record_ops_snapshot(nodeId?)` - persist snapshot to history and optionally bridge to Agent Memory\n- `configure_ops(config)` - save integration config with env-var token refs\n\n## Read this repo in this order\n\n1. `README.md`\n2. `ROADMAP.md`\n3. `PAIN-POINTS.md`\n4. `docs/IDEAL-OPS.md`\n5. `docs/OPS-CONTEXT-SPEC.md`\n6. `CLAUDE.md`\n\n## Local setup\n\n1. `npm install`\n2. `npm run build`\n3. `powershell -ExecutionPolicy Bypass -File scripts/bootstrap-memory.ps1`\n4. Open this repo in Claude Code or Codex with the local `.mcp.json`\n\n## Agent Memory\n\nThis project uses local Agent Memory via `.mcp.json`.\n\nIf `boot_context()` does not recover a usable active node, run\n`scripts/bootstrap-memory.ps1` before planning or editing. The bootstrap script\nseeds the repo with a project node, a completed baseline feature, and the\ncurrent active feature/task for the next implementation slice.\n","readmeFilename":"README.md"}