hush

hushspec: "0.1.0"
name: production-agent

rules:
  forbidden_paths:
    patterns:
      - "**/.ssh/**"
      - "**/.aws/**"
      - "/etc/shadow"

  egress:
    allow:
      - "api.openai.com"
      - "*.anthropic.com"
      - "api.github.com"
    default: block

  tool_access:
    block: [shell_exec, run_command]
    require_confirmation: [file_write, git_push]
    default: allow

  secret_patterns:
    patterns:
      - name: aws_key
        pattern: "AKIA[0-9A-Z]{16}"
        severity: critical
    skip_paths: ["**/test/**"]

  shell_commands:
    forbidden_patterns:
      - "rm\\s+-rf\\s+/"
      - "curl.*\\|.*bash"

[dependencies]
hushspec = "0.1"

npm install @hushspec/core

pip install hushspec

go get github.com/backbay-labs/hush/packages/go@main

use hushspec::HushSpec;

let yaml_str = "hushspec: \"0.1.0\"\nname: example\n";
let spec = HushSpec::parse(yaml_str)?;
let result = hushspec::validate(&spec);
assert!(result.is_valid());

import { parseOrThrow, validate } from '@hushspec/core';

const yamlString = 'hushspec: "0.1.0"\nname: example\n';
const spec = parseOrThrow(yamlString);
const result = validate(spec);
console.log(result.valid); // true

from hushspec import parse_or_raise, validate

yaml_string = 'hushspec: "0.1.0"\nname: example\n'
spec = parse_or_raise(yaml_string)
result = validate(spec)
assert result.is_valid

import (
    "fmt"

    "github.com/backbay-labs/hush/packages/go/hushspec"
)

yamlString := "hushspec: \"0.1.0\"\nname: example\n"
spec, err := hushspec.Parse(yamlString)
if err != nil {
    panic(err)
}
result := hushspec.Validate(spec)
fmt.Println(result.IsValid())

import { parseOrThrow, evaluate } from '@hushspec/core';

const spec = parseOrThrow(policyYaml);
const result = evaluate(spec, { type: 'egress', target: 'api.openai.com' });
// result.decision === 'allow' | 'warn' | 'deny'
// result.matched_rule === 'egress'

from hushspec import parse_or_raise, evaluate

spec = parse_or_raise(policy_yaml)
result = evaluate(spec, {"type": "egress", "target": "api.openai.com"})
assert result.decision in ("allow", "warn", "deny")

import { HushGuard } from '@hushspec/core';

const guard = HushGuard.fromFile('./policy.yaml');
guard.enforce({ type: 'tool_call', target: 'bash' }); // 拒否された場合はHushSpecDeniedをスロー

from hushspec import HushGuard

guard = HushGuard.from_file("./policy.yaml")
guard.enforce({"type": "tool_call", "target": "bash"})  # 拒否された場合はHushSpecDeniedを送出

# HushSpecスキーマに対してポリシーを検証
h2h validate policy.yaml

# 評価テストスイートを実行
h2h test --fixtures ./tests/

# 1つのアクションを評価し、決定を説明
h2h eval policy.yaml --type egress --target api.example.com
h2h explain policy.yaml --type egress --target api.example.com

# 静的解析とlint
h2h lint policy.yaml

# lintと決定に影響しない問題の自動修正
h2h lint policy.yaml --fix

# 2つのポリシーを比較し、実効的な決定の変更を表示
h2h diff old.yaml new.yaml

# ポリシーファイルを標準形式にフォーマット
h2h fmt policy.yaml

# 新しいポリシープロジェクトをスキャフォールド
h2h init --preset default

# Ed25519でポリシーに署名
h2h sign policy.yaml --key h2h.key

# ポリシーの署名を検証
h2h verify policy.yaml --key h2h.pub

# 新しいEd25519鍵ペアを生成
h2h keygen

# 緊急オーバーライド（全拒否のキルスイッチ）
h2h panic activate --sentinel /tmp/hushspec.panic
h2h panic deactivate --sentinel /tmp/hushspec.panic

extensions:
  posture:
    initial: standard
    states:
      standard: { capabilities: [file_access, egress] }
      restricted: { capabilities: [file_access] }
    transitions:
      - { from: "*", to: restricted, on: critical_violation }
  detection:
    prompt_injection:
      block_at_or_above: high

// HushSpecかClawdstrikeネイティブ形式かを自動検出
let policy = clawdstrike::Policy::from_yaml_auto(yaml)?;

# 形式間の変換
hush policy migrate policy.yaml --to hushspec

spec/              規範的な仕様書（コアおよび拡張ドキュメント）
schemas/           JSON Schema定義
crates/            Rustクレート
  hushspec/          コアライブラリ: パース、検証、マージ、解決、評価、検出、署名
  hushspec-cli/      CLIツール
  hushspec-testkit/  適合性テストランナー
packages/          TypeScript、Python、Goの言語SDK
rulesets/          組み込みセキュリティルールセット
fixtures/          適合性および評価フィクスチャ
docs/              mdBookドキュメントサイト
generated/         生成された共有SDKコントラクトアーティファクト
scripts/           コード生成およびCIツール