{
  "schema_version": "1.0",
  "interface": {
    "name": "Harnessie CLI",
    "kind": "local process interface",
    "transport": "command line",
    "hosted": false,
    "network_service": false,
    "description": "Machine-readable synopsis of the local CLI shipped by the named Harnessie package version. This is not a hosted HTTP API."
  },
  "package": {
    "name": "harnessie",
    "version": "1.1.0",
    "registry": "https://pypi.org/project/harnessie/",
    "source": "https://github.com/snapsynapse/harnessie"
  },
  "global_options": {
    "--root": "Project root; defaults to the current working directory."
  },
  "paths": {
    "init": {
      "synopsis": "harnessie init [path] [--force] [--no-verify]",
      "purpose": "Scaffold a local project and, by default, run the zero-dollar guided readiness check.",
      "side_effects": "Writes scaffold files below the selected project root; refuses overwrite unless --force is explicit."
    },
    "run": {
      "synopsis": "harnessie run WORKFLOW [--goal GOAL] [--approval-policy FILE] [--approve-interactive] [--plugin NAME ...]",
      "purpose": "Run a governed workflow under declared budgets, ownership, sandbox, and verification policy.",
      "side_effects": "Side-effecting tools remain consent and policy gated; network is denied unless a phase explicitly allows it. Plugins never auto-load; each selected in-process plugin is operator-trusted code."
    },
    "resume": {
      "synopsis": "harnessie resume RUN_ID WORKFLOW [--goal GOAL] [--approval-policy FILE] [--approve-interactive] [--plugin NAME ...]",
      "purpose": "Resume from the audited journal while skipping already verified phases.",
      "side_effects": "Uses the same consent, ownership, sandbox, budget, and verification gates as run; the exact recorded plugin receipt is required."
    },
    "report": {
      "synopsis": "harnessie report RUN_ID [--raw]",
      "purpose": "Render a plain-language local run summary and its next operator action.",
      "side_effects": "Read-only."
    },
    "audit": {
      "synopsis": "harnessie audit RUN_ID",
      "purpose": "Verify the local event hash chain and render the governance timeline.",
      "side_effects": "Read-only."
    },
    "eval": {
      "synopsis": "harnessie eval [SUITE] [--live]",
      "purpose": "Run deterministic scorecards; --live is a separate explicit provider opt-in.",
      "side_effects": "Default suite is network-free; --live may call configured providers."
    },
    "validate": {
      "synopsis": "harnessie validate [PATH ...] [--kind KIND]",
      "purpose": "Validate the six stable v1 authoring contracts and their cross-document references without starting a run.",
      "side_effects": "Read-only; no model calls, network, sandbox admission, run-state creation, or workspace writes."
    },
    "ownership": {
      "synopsis": "harnessie ownership PATH --agent AGENT [--json]",
      "purpose": "Explain the ownership-ledger write decision for one agent and path relative to workspace/ without claiming or modifying it. JSON output uses schema_version 1 and a fixed source vocabulary.",
      "side_effects": "Read-only; no ledger mutation, workspace write, model call, network access, sandbox admission, or run-state creation. Valid allowed and denied decisions exit 0; invalid input exits 2."
    },
    "verify-manifest": {
      "synopsis": "harnessie verify-manifest [MANIFEST]",
      "purpose": "Verify hashes in the outward public trust bundle.",
      "side_effects": "Read-only."
    },
    "verify-inward-manifest": {
      "synopsis": "harnessie verify-inward-manifest [MANIFEST]",
      "purpose": "Verify shipped prompts, configuration, and ownership policy against the inward manifest.",
      "side_effects": "Read-only."
    },
    "approve-maiden": {
      "synopsis": "harnessie approve-maiden RUN_ID PHASE",
      "purpose": "Promote a previously staged maiden-voyage proposal after audit, ownership, artifact, and target hashes verify.",
      "side_effects": "Explicit operator action that writes only the verified staged proposal to an unchanged target."
    },
    "verify": {
      "synopsis": "harnessie verify --workspace DIR --criteria FILE [--check CMD] [--report-dir DIR] [--models FILE] [--tier TIER] [--verifier-prompt FILE] [--no-verifier] [--allow-network] [--max-steps N]",
      "purpose": "Verify a local artifact with deterministic checks followed by an optional independent verifier.",
      "side_effects": "Checks are sandboxed and network-denied by default; the verifier is read-only."
    }
  },
  "governance": {
    "human_approval": "Required where declared policy gates a side effect.",
    "human_arbitration": "Always required for contested decisions.",
    "unknown_or_unenforceable_control": "Fails closed."
  },
  "stability": {
    "status": "stable-1.x",
    "policy": "The six v1 authoring schemas and harnessie.tools.v1 plugin contract are stable for the 1.x line under SCHEMA_COMPATIBILITY.md and PLUGIN_CONTRACT.md."
  },
  "canonical": "https://harnessie.com/api/v1/index.json",
  "last_updated": "2026-08-20"
}