{
  "id": "okf_pulse_ops_ai_secure_home_agent_platform__7c942647",
  "kind": "okf",
  "category": "dados",
  "name": "How API surface is authored",
  "tagline": "Bundle OKF 0.2 · 0 conceitos · pulse-ops-ai/secure-home-agent-platform",
  "body": "# How API surface is authored\n\nPortable reasoning context for adding or changing API surface on a platform where\none definition is expected to produce every downstream artifact. It answers\n*where do I author this shape?*, *may I hand-write this type?*, and *what makes an\noperation callable from outside?*\n\nThis is **context, not authority**. It grants nothing, names no route, and\nreproduces no generated document.\n\n| Concept | Read |\n|---|---|\n| where a contract is authored, and what may not restate it | [authoring.md](authoring.md) |\n| how the published document is produced, and why it is a gate | [generation.md](generation.md) |\n| the four response shapes, and what a list answer must admit | [envelopes.md](envelopes.md) |\n| how an operation becomes callable, and what describing it does not confer | [exposure.md](exposure.md) |",
  "url": "https://github.com/pulse-ops-ai/secure-home-agent-platform/blob/HEAD/knowledge/platform/api-contract-conventions/index.md",
  "status": "live",
  "origin": "okf_github",
  "origin_id": "pulse-ops-ai/secure-home-agent-platform:knowledge/platform/api-contract-conventions/index.md",
  "install": "https://raw.githubusercontent.com/pulse-ops-ai/secure-home-agent-platform/HEAD/knowledge/platform/api-contract-conventions/index.md",
  "source": "https://github.com/pulse-ops-ai/secure-home-agent-platform",
  "transporte": "",
  "ns": "pulse-ops-ai",
  "versao": "0.2",
  "oficial_status": "",
  "repo_host": "github.com",
  "topico": "ai",
  "linguagem": "",
  "licenca": "",
  "repo_topics": "",
  "repo_slug": "pulse-ops-ai/secure-home-agent-platform",
  "stars": 0,
  "forks": 0,
  "prs_abertos": 0,
  "pushed_at": "",
  "repo_estado": "",
  "likes": 0,
  "comments": 0,
  "visits": 0,
  "readme_bytes": 0,
  "created_at": "2026-09-08 16:05:40",
  "updated_at": "2026-09-08 16:05:40",
  "mine": false,
  "api": "https://agentalog.com/api/listings/okf_pulse_ops_ai_secure_home_agent_platform__7c942647",
  "go": "https://agentalog.com/api/go/okf_pulse_ops_ai_secure_home_agent_platform__7c942647",
  "comments_api": "https://agentalog.com/api/listings/okf_pulse_ops_ai_secure_home_agent_platform__7c942647/comments",
  "readme_sha": "",
  "readme_em": "",
  "payload": {
    "name": "pulse-ops-ai/secure-home-agent-platform:knowledge/platform/api-contract-conventions/index.md",
    "title": "How API surface is authored",
    "version": "0.2",
    "okf_bundle_dir": "knowledge/platform/api-contract-conventions",
    "okf_index_path": "knowledge/platform/api-contract-conventions/index.md",
    "okf_conceitos": 0,
    "okf_ref": "HEAD",
    "okf_type": ""
  },
  "volatil_em": "2026-09-13 23:02:16"
}