mirror of
https://github.com/rcourtman/Pulse.git
synced 2026-05-20 09:23:27 +00:00
3da835c5bc
The MCP adapter shipped in slice 51 with one install option:
clone the repo and go build. This slice integrates pulse-mcp
into Pulse's existing governed release pipeline so a Pulse
release publishes a pulse-mcp binary alongside the unified agent
and the install scripts that bring it home in one command.
What ships:
- scripts/build-release.sh extended to build pulse-mcp for
the same multi-OS matrix as the unified agent, package
per-platform tarballs and zips, and copy bare binaries to
RELEASE_DIR for /releases/latest/download/ redirect
compatibility.
- .github/workflows/create-release.yml extended to upload
the bare pulse-mcp binaries plus install-mcp.sh and
install-mcp.ps1 as release assets.
- scripts/install-mcp.sh: bash one-line installer that
detects platform/arch, downloads the matching binary from
the configured release (latest by default), verifies SHA256
against the published checksums.txt, places at
~/.local/bin/pulse-mcp (or /usr/local/bin if not writable).
Honors PULSE_MCP_VERSION, PULSE_MCP_BIN_DIR, PULSE_MCP_REPO,
PULSE_MCP_NO_VERIFY env vars; declines Windows shells with
a pointer at the .ps1 sibling.
- scripts/install-mcp.ps1: PowerShell installer for Windows,
placing pulse-mcp.exe at $LOCALAPPDATA\pulse-mcp.
Documentation aligned:
- cmd/pulse-mcp/README.md gains an Install section above
Quick start with three options: one-line installer,
GitHub Release download, go install. Documents the macOS
Gatekeeper bypass since v1 is unnotarized by design.
- The Settings -> API Access agent-integrations panel now
surfaces the curl|bash command above the config snippet so
operators see "install pulse-mcp" before "configure your
MCP client."
- docs/releases/AGENT_PARADIGM.md drops the "no published
distribution path" item from "what it does not do yet" and
documents the Gatekeeper / Homebrew gaps as next-tier
follow-ups.
Trade-offs surfaced and chosen:
- Same cadence as Pulse: pulse-mcp ships per Pulse release,
not on its own track. The MCP server reads the manifest
from the Pulse it talks to, so version alignment is the
natural model.
- No Homebrew tap or core formula in v1. Maintaining a tap
is real ongoing work; foundation supports adding Homebrew
later as a layer.
- No Docker image. Stdio JSON-RPC fights Docker's stdin
/stdout pattern.
- No notarization in v1. SHA256 verification through the
installer preserves the audit trail; README documents the
Gatekeeper bypass.
Subsystem contract: deployment-installability.md gains
scripts/install-mcp.sh, scripts/install-mcp.ps1, and
cmd/pulse-mcp/ in canonical files (mid-list entries
renumbered) plus a paragraph documenting the new MCP entry
point alongside the existing installer family.
Verification artifacts:
- scripts/installtests/build_release_assets_test.go gains
TestBuildReleasePackagesPulseMcpForAllPlatforms which pins
the build/package/copy wiring and the load-bearing
install-mcp.sh helpers (platform detection, SHA256
verification, install-dir resolution).
- scripts/release_control/render_release_body_test.py gains
test_agent_paradigm_release_notes_blurb_documents_-
distribution_path which pins the AGENT_PARADIGM.md draft's
install-mcp.sh reference and the four-axis frame so a
future edit cannot regress the install story silently.
Smoke-tested install-mcp.sh locally on darwin-arm64: platform
detection, install-dir resolution, URL building, and 404 error
handling all correct. The full end-to-end install path becomes
live the moment a Pulse release ships pulse-mcp binaries; the
next RC cut will exercise it.
|
||
|---|---|---|
| .. | ||
| internal | ||
| agent_preflight.py | ||
| agent_preflight_test.py | ||
| ai_runtime_docs_policy_test.py | ||
| canonical_completion_guard.py | ||
| canonical_completion_guard_test.py | ||
| commercial_cancellation_reactivation_proof.py | ||
| commercial_cancellation_reactivation_rehearsal.py | ||
| contract_audit.py | ||
| contract_audit_test.py | ||
| control_plane.py | ||
| control_plane_audit.py | ||
| control_plane_audit_test.py | ||
| dev_runtime_governance_test.py | ||
| documentation_currentness_test.py | ||
| format_staged_go.py | ||
| format_staged_go_test.py | ||
| generate_platform_support_backend_module.py | ||
| generate_platform_support_frontend_module.py | ||
| governance_stage_guard.py | ||
| governance_stage_guard_test.py | ||
| mobile_relay_auth_approvals_proof.py | ||
| paid_feature_claims_proof.py | ||
| proof_entrypoints_test.py | ||
| readiness_assertion_guard.py | ||
| readiness_assertion_guard_test.py | ||
| record_rc_to_ga_blocked.py | ||
| record_rc_to_ga_rehearsal.py | ||
| registry_audit.py | ||
| registry_audit_test.py | ||
| relay_registration_reconnect_drain_proof.py | ||
| release_promotion_policy_support.py | ||
| release_promotion_policy_support_test.py | ||
| release_promotion_policy_test.py | ||
| render_release_body.py | ||
| render_release_body_test.py | ||
| repo_file_io.py | ||
| repo_file_io_test.py | ||
| resolve_release_promotion.py | ||
| resolve_release_promotion_test.py | ||
| ssh_host_key_policy_test.py | ||
| staged_commit_shape_guard.py | ||
| staged_commit_shape_guard_test.py | ||
| status_audit.py | ||
| status_audit_test.py | ||
| status_lookup.py | ||
| status_lookup_test.py | ||
| subsystem_contracts.py | ||
| subsystem_contracts_test.py | ||
| subsystem_lookup.py | ||
| subsystem_lookup_test.py | ||
| work_claim.py | ||
| work_claim_test.py | ||