CLI - Pactmark

Uyumluluk: Pactmark 0.2.x. pactmark ikili dosyası @pactmark/cli’a aittir ve enjekte edilmiş host adaptörleri üzerinden çalışır. Komutlar mutasyondan önce bilinmeyen girdiyi ve yetkiyi doğrular.

Kullanım

pactmark <command> [options]

Commands:
  dev
  compile
  run <agent> --input <file-or-json>
  inspect <runId>
  events <runId> [--after <sequence>]
  replay <runId>
  doctor [--profile local|preview|production] [--production]
  test [scenario]
  eval [suite]
  evidence export <runId> [--format json|md]
  evidence verify <path>
  audit verify <runId>
  migrate status|up
  policy explain <fixture>
  effects reconcile <runId> <effectId> --resolution <file-or-json>
  effects compensate <runId> <effectId> --request <file-or-json>

Global options: --json --debug --help --version

Otomasyon için --json kullanın ve kararlı KAF_* kodlarına göre dallanın. İnsan metni, belgelenmiş sözleşme dışındaki sıralama ve stack trace’ler kararlı API değildir.

Geliştirme

Yerel geliştirme döngüsü

Projenin geliştirme giriş noktasını çalıştırır.

Ajan manifestini derle

AGENT.md ve isteğe bağlı skills/* girdilerini okur, ardından .pactmark/generated/agent-manifest.json dosyasını atomik olarak yazar.

Bir koşu yürüt

npx pactmark run support-refund-agent --input ./fixtures/refund.json --json

İnceleme

Güncel projeksiyon

Durum, sıra, bekleyen kimlikler, artifact ve doğrulama kimlikleri, sonlanma hata kodu.

Olay akışı

npx pactmark events run_01J8… --after 42 --json

Çalıştırmadan doğrula

Sonlanmış bir koşuyu hiçbir araç veya model çalıştırmadan saklanan olaylar ve artifact’lardan doğrular. Bir koşu yeniden oynatılamıyorsa geçmişi sağlam değildir.

Denetim bağlarını doğrula

Yetki ve karar kayıtlarının tutarlı çözüldüğünü denetler.

Tanılama

npx pactmark doctor --profile production --json

Üretim doctor’ı, gereken dayanıklılık, sandbox, kimlik bilgisi, politika veya kayıt kanıtı yoksa başarısız olur. Taze, bellek destekli bir projede başarısız olmalıdır — boşlukları bir kontrol listesi olarak okuyun.

npx pactmark policy explain ./fixtures/refund-r4.json --json

Bir politika kararını bir fixture’a karşı açıklar. İncelemede ve bir reddin kasıtlı olduğunu kanıtlamakta işe yarar.

Kanıt

npx pactmark evidence export run_01J8… --format json > evidence.json

npx pactmark evidence export run_01J8… --format md > evidence.md

npx pactmark evidence verify ./evidence.json --json

evidence verify iç referansları yeniden denetler; eksik veya uyumsuz bir kayıt KAF_EVIDENCE_INVALID_REFERENCE olarak yüzeye çıkar.

Göçler

npx pactmark migrate status --json
npx pactmark migrate up --json

Sıralı ve ileri yönde uygulanır. Bir üretim yayılımından önce temsili bir yükseltmeyi, bir projeksiyon yeniden kurulumunu, bir geri alma planını, bir yedek geri yüklemesini ve eski koşu incelemesini test edin.

Etkiler

npx pactmark effects reconcile <runId> <effectId> \
  --resolution '{"kind":"recovered_acknowledgement","providerRef":"re_1Nc…"}' --json

npx pactmark effects compensate <runId> <effectId> \
  --request '{"reason":"incident_resolved","approvedBy":"role:sre_lead"}' --json

effects reconcile, varsaydığınızı değil tespit ettiğinizi kaydeder. abandon_uncertain çözümü, etkinin gerçekleşmiş olabileceğini açıkça kaydeder — ve ona bağımlı her şey KAF_EFFECT_ABANDONED_UNCERTAIN üretir.

effects compensate, ayrıca yetkilendirilmiş bir telafi koşusu başlatır. Bir geri alma değildir.

Testler ve değerlendirmeler

npx pactmark test --json
npx pactmark eval --json

Betiklemek

#!/usr/bin/env bash
set -euo pipefail

result=$(npx pactmark inspect "$RUN_ID" --json)
status=$(jq -r '.status' <<<"$result")

case "$status" in
  completed) npx pactmark evidence export "$RUN_ID" --format json > "evidence-$RUN_ID.json" ;;
  failed)    jq -r '.terminalErrorCode' <<<"$result" | xargs -I{} ./notify.sh {} ;;
  *)         echo "hâlâ çalışıyor: $status" ;;
esac

.status ve .terminalErrorCode alanlarına göre dallanın, yazdırılan metne göre asla.

Hata başvurusu

Betiklerinizin dallanması gereken kodlar.

HTTP API

Aynı yüzeyler hat üzerinden.

​Kullanım

​Geliştirme

​İnceleme

​Tanılama

​Kanıt

​Göçler

​Etkiler

​Testler ve değerlendirmeler

​Betiklemek

Hata başvurusu

HTTP API

Kullanım

Geliştirme

İnceleme

Tanılama

Kanıt

Göçler

Etkiler

Testler ve değerlendirmeler

Betiklemek