Operations Pulse

유용하고 설명 가능한 운영을 위한 로컬 우선(local-first) 루프 오케스트레이터.

Operations Pulse는 반복되는 점검을 증거로, 증거를 지속 가능한 티켓으로, 티켓을 검토 가능한 운영 메모리로 전환합니다. 기본적으로 유료 서비스 없이 실행됩니다. Node.js, SQLite, Git, 로컬 파일, 로컬 로그만으로 유용한 펄스를 얻을 수 있습니다.

Openly Useful 프로젝트입니다: 유용한 것을 공개적으로 만드는 프로젝트입니다.

자격 증명에 안전한 실시간 설정 가이드는 operations-pulse-five.vercel.app에서 이용할 수 있습니다.

v0.1에 포함되는 것

• SQLite 티켓 및 펄스 원장(ledger).

• 리포지토리 상태, 문서, 구성된 로그 파일에 대한 읽기 전용 로컬 점검.

• 자기 설명(self-describing) 도구와 구조화된 결과를 갖춘 MCP 서버.

• Codex 및 호환 에이전트를 위한 이식 가능한 operations-pulse 스킬.

• 운영, 신호 검토, 트리아지, 통합을 위한 선택적 역할 정의.

• 무료/로컬, 구독, 호스트 OAuth, 자체 호스팅, 자격 증명 직접 제공(bring-your-own-credential) 경로를 구분하는 연결 카탈로그와 안내 설정.

• 완전한 마이그레이션 원장: 가져옴(imported), 다시 작성함(rewritten), 참조함(referenced), 제외함(excluded).

Related MCP server: Project Telos

무료 우선 빠른 시작

요구 사항: Node.js 24 이상. 기본 워크플로에는 API 키가 필요하지 않습니다.

npm install
npm run build
node packages/core/dist/cli.js init
node packages/core/dist/cli.js pulse run --root .
node packages/core/dist/cli.js tickets list

리포지토리, SQLite 데이터베이스, MCP 인자 또는 대화 기록에 자격 증명을 넣지 않고 선택적 읽기 전용 어댑터를 구성하세요:

export OPERATIONS_PULSE_GITHUB_TOKEN='stored by your shell or secret manager'
node packages/core/dist/cli.js connections configure \
  --id github --mode env-token \
  --credential-env OPERATIONS_PULSE_GITHUB_TOKEN
node packages/core/dist/cli.js connections test --id github
node packages/core/dist/cli.js pulse run --root . --connections github

이미 GitHub CLI로 인증된 로컬 머신에서는 제로카피(zero-copy) 대안을 사용할 수 있으며, 해당 세션은 읽기 전용 점검에만 사용되고 토큰은 저장되거나 출력되지 않습니다:

gh auth login
node packages/core/dist/cli.js connections configure --id github --mode github-cli
node packages/core/dist/cli.js connections test --id github

apps/site의 브라우저 기반 선택 도구는 이러한 안전한 설정 절차를 생성합니다. 자격 증명은 절대 수집되지 않습니다. 호스트 OAuth는 호스트의 자체 동의 UI에서만 이루어집니다.

stdio로 MCP 서버를 실행하세요:

npm run mcp

데이터베이스는 기본적으로 .operations-pulse/pulse.sqlite에 위치합니다. OPERATIONS_PULSE_DB를 설정해 재정의할 수 있습니다.

안전 모델

Operations Pulse는 도구나 명령이 명시적으로 쓰기(write)를 표시하지 않는 한 읽기 전용입니다. 펄스 실행은 --create-tickets(또는 그에 상응하는 MCP 인자)이 명시적으로 활성화되지 않는 한 티켓을 생성하지 않습니다. 연결은 설정되기 전까지는 비활성화 상태이며, 자격 증명은 카탈로그에 저장되지 않고, 외부에 표시되거나 유료인 작업은 별도의 인간 승인 경계가 필요합니다.

연결 기록에는 ID, 비밀 데이터가 아닌 설정, 엔드포인트, 환경 변수 참조만 남습니다. connections disconnect는 로컬 원장에서 해당 참조를 제거합니다. 초기 어댑터는 읽기 전용입니다: IMAP 읽지 않은 수 메타데이터, GitHub 신원, Linear 뷰어 신원, Sentry 프로젝트 접근, PostHog 프로젝트 접근. v0.1에는 원격 변경 어댑터가 포함되어 있지 않습니다.

선택적 하트비트

Node.js가 실행될 수 있는 어디서든 제한된 범위의 포그라운드 하트비트를 실행하세요:

node packages/core/dist/cli.js heartbeat serve --interval-minutes 30 --root .

macOS에서는 사용자 수준의 LaunchAgent를 검사한 후 명시적으로 설치하세요:

node packages/core/dist/cli.js schedule plan --interval-minutes 30 --root .
node packages/core/dist/cli.js schedule install --confirm-install --interval-minutes 30 --root .

스케줄러는 도구, 모델 응답 또는 페이지 로드에 의해서는 절대 설치되지 않습니다. 제거하려면 schedule uninstall --confirm-uninstall이 필요합니다.

리포지토리 지도

• packages/core — SQLite 원장과 결정적(deterministic) 점검.

• packages/mcp — MCP stdio 서버.

• skill/operations-pulse — 이식 가능한 에이전트 스킬.

• plugins/openai/operations-pulse — 생성된 Codex 스킬 및 MCP 래퍼.

• plugins/claude/operations-pulse14 — 생성된 Claude Code 스킬 및 MCP 래퍼.

• .agents/plugins/marketplace.json — 리포지토리 로컬 Codex 마켓플레이스.

• .claude-plugin/marketplace.json — 리포지토리 로컬 Claude 마켓플레이스.

• mcp-registry/operations-pulse/server.json — 스테이징된 공식 MCP Registry 메타데이터.

• publisher/publisher.json — 공개 발행자 권한(authority)의 저장소 소비자 미러.

• agents — 선택적 역할 정의.

• catalog — 시작 시 표시되는 도구 및 연결 설명.

• docs — 아키텍처, 워크플로, 연결 가이드 및 시작 체크리스트.

• migrations — 소스 목록 및 삭제(sanitization) 결정.

• vendor — 출처를 밝힌 타사 스킬 팩, 절대 조용히 병합하지 않음.

• apps/site — 의존성 없는 프로젝트 사이트.

상태

이 저장소는 첫 공개 릴리스를 준비하는 단계입니다. 로컬 우선 코어가 지원되는 기준선(baseline)입니다. IMAP, GitHub, Linear, Sentry, PostHog에는 읽기 전용 어댑터 테스트가 있습니다. 호스트 OAuth는 호환되는 호스트의 자체 동의 흐름을 필요로 하며, 기본적으로 원격 쓰기 어댑터는 활성화되어 있지 않습니다.

발행자 및 등록 모델

Openly Useful은 발행자이자 개발자 브랜드입니다. openlyuseful.org는 오픈 소스, 발행자, 정책, 보안, 지원 표면이며, openlyuseful.com`은 Studio/상용 표면입니다. Openly Useful LLC는 계획된 법인이며, 설립되었거나 활동 중이라는 의미의 표현은 아닙니니다. Openly Useful는 현재 창업자가 개인 자격으로 운영하고 있으며, 창업자-소유자는 법인 설립 절차가 진행되는 동안 외부 소스 및 레지스트리 공개를 승인했습니다.

publisher/publisher.json의 저장소 미러는 https://openlyuseful.org/publisher/manifest.json에 공개된 권한 엔드포인트를 소비합니다. 공급자 매니페스트는 공개 이름, 연락처, 네임스페이스, 정책 URL을 해당 기록에서 파생합니다. 스테이징된 공급자 메타데이터의 저장소 URL은 계획된 공개 소스인 https://github.com/Openly-Useful/operations-pulse입니다.

기준 스킬은 skill/operations-pulse로 유지됩니다. 공급자 래퍼 복사본은 별도로 편집할 수 있는 원본이 아니라 생성된 산출물입니다:

npm run registration:sync
npm run registration:check

래퍼는 이식 가능한 스킬과 함께 변경 불가능한 stdio 명령 npx --yes @openly-useful/operations-pulse-mcp@0.1.0을 등합니다. 래퍼는 계정 인증, 스케줄러 설치, 어댑터 구성, 자격 증명 수집을 수행하지 않습니다. 이에 해당하는 MCP Registry 식별자는 org.openlyuseful/operations-pulse입니다. 플러그인 설치 또는 업그레이드 후에는 새 Codex 태스크를 시작하거나 Claude Code를 다시 시작하여 호스트가 MCP 도구를 새로고침하게 하세요. 기본적으로 MCP 데이터베이스는 호스트 프로세스 작업 디렉터리의 .operations-pulse/pulse.sqlite입니다. 명시적인 경로를 지정하려면 호스트 환경에서 OPERATIONS_PULSE_DB를 설정하세요.

로컬 생성과 검증은 허용됩니다. 공개 저장소 생성, 패키지 게시, MCP Registry 제출, 마켓플레이스 제출, 설치, 인증, 배포는 각각 별도의 외부 작업입니다. 두 게시 가능한 워크스페이스 모두 prepublishOnly에서 실패 시 폐쇄(fail closed)됩니다. 정확한 창업자-소유자 승인, 발행자 식별, 정책 출처, 네임스페이스, 패키지 식별 이름, 저장소 출처(provenance)가 모두 공개 권위와 일치해야 합니다. LLC 설립 대기(formation-pending) 상태 자체로는 npm 아티팩트를 막지 않습니다. Openly Useful는 창업자가 운영하는 개인 프로젝트이며, 설립 기간 동안 해당 인한의 효과가 명시적으로 유효하기 때문입니다. 네임스페이스 검증, 공급자 인증, 공급자 검토는 해당 레지스트리 또는 공급자 워크플로의 별도 요구 사항입니다.