Files
skills/public/hip-1167.html
zeekayandHanzo Dev 9e10c1c10e Each llms index points at the other two
hanzoskills.com/llms.txt now opens with the install line, the API
reference index and the company index, so an agent that lands on any
one of the three can find the rest.

robots.txt claimed 537 documents while llms.txt counts 920. The number
is gone from robots.txt; llms.txt derives it.

public/ is regenerated from scripts/site.py, which it had fallen
behind: the copy-prompt menu and agent bar were in the generator and
not in the committed pages. tests/site.mjs passes against the result.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 00:27:59 -07:00

285 lines
26 KiB
HTML

<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>hip-1167</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="alternate" type="text/markdown" href="/hip-1167.md">
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/hip-1167">
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/hip-1167.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>hip-1167</h1><p class="lede">HIP-1167: Dataset — An Immutable Snapshot. Status Final. Hanzo architectural specification.</p><h1>HIP-1167: Dataset — An Immutable Snapshot</h1>
<h2>Abstract</h2>
<p><code>/v1/risk/datasets</code> is the per-org dataset plane of <code>/v1/risk</code>: a dataset is a versioned, immutable snapshot of one tenant&#x27;s own event surface, and this is where it is declared, materialised, described, exported and disposed of. It is implemented in <code>hanzoai/cloud</code> at <code>apps/dataset</code> (HIP-0106). HIP-1046 states the invariants that hold across the four planes of the risk product; this HIP states this one.</p>
<h2>Motivation</h2>
<p>Storing a query and re-running it guarantees irreproducibility. The source is a merging table, its retention drops the tail, and the rollup behind it can be re-run — so the same question asked twice is two answers, and a model that cites &quot;the query&quot; has cited nothing. A dataset here is bytes: declared as a version, materialised once, and never rewritten. A model can name the exact rows it was fitted on, forever, which is the only form in which an audit can be answered.</p>
<h2>Specification</h2>
<p>The key words MUST, MUST NOT, SHOULD, SHOULD NOT and MAY are to be interpreted as in RFC 2119.</p>
<h3>§1 The store</h3>
<p>Two tables in the shared warehouse, owned outright and created idempotently: the register, <code>hanzo.risk_dataset</code>, and the rows, <code>hanzo.risk_row</code> (<code>apps/dataset/plane.go:85</code>). The tenant leads the sort key AND the partition expression of both.</p>
<p>It only READS its source, <code>hanzo.risk_feature</code> — the per-org feature surface, one row per kind, subject and bucket — and never creates it. One writer and one DDL owner per table: a reader that finds the source absent MUST report an honest gap, not conjure a second definition that would drift from the first. The source is also the ONLY admitted source, and that is correctness rather than convenience: a dataset row&#x27;s coordinates must be the coordinates the scorer sees, and two reductions of one stream diverge silently, which trains a model on coordinates production never produces.</p>
<p>Neither owned table carries a TTL. A table TTL is a fleet-wide clock no tenant can lengthen and none can shorten, which is the opposite of per-tenant retention. Disposal is the tenant&#x27;s own partition drop on <code>(org, dataset)</code>, whose expression leads with the tenant, so a disposal cannot be spelled across one.</p>
<h3>§2 The address</h3>
<p>Seven typed operations under <code>/v1/risk/datasets</code>: declare the next version of a dataset, list the org&#x27;s datasets, describe every version of one, dispose of one and every version of it, materialise a declared version into immutable rows, show a version&#x27;s lineage, and read a version&#x27;s rows back one bounded page at a time. Every one is a typed op — there is no declared-untyped operation on this surface, and no route here answers anything but a value.</p>
<p>The ops register at ABSOLUTE paths on the typed registry rather than through a group root, because a group root composes to a trailing slash and a trailing slash in the document is a trailing slash in every generated client.</p>
<h3>§3 One prefix, four capabilities</h3>
<p><code>/v1/risk</code> carries operations from four apps: <code>risk</code> at the root, and <code>dataset</code>, <code>label</code> and <code>reference</code> at their own leaves. What MUST hold:</p>
<ol><li>The four MUST partition <code>/v1/risk</code> by DISJOINT sub-prefix. No two may claim</li></ol>
<p> one prefix; the composer refuses two owners for one prefix, so this is checked and not agreed. The router resolves by specificity, so mount order decides nothing.</p>
<ol><li>The root belongs to <code>risk</code> (HIP-1046). A capability with a leaf MUST group</li></ol>
<p> its own middleware on its own leaf and never on the stem: middleware at <code>/v1/risk</code> for a shorter route would land on a subtree this app does not own, which is the escape the scoping refuses.</p>
<ol><li>Each of the four MUST own its own store. Two apps sharing one store is the</li></ol>
<p> defect HIP-0106 names, and HIP-0139 §7.2 refuses a split that creates it. This one owns the two tables in §1 and shares no state with a scorer.</p>
<ol><li>The tag on an operation is the app that serves it, not the address&#x27;s first</li></ol>
<p> segment (HIP-0139 §4.1). A generated client therefore offers a class holding exactly these seven operations even though the address reads <code>risk</code>.</p>
<ol><li>These operations MUST stay under <code>/v1/risk</code>. The published product membership</li></ol>
<p> is read off the FIRST <code>/v1</code> segment of a path and off nothing else, so an address is a product declaration: filed anywhere else, these rows are filed into another product, and the operation-count ratchet reads the arrival as growth because it refuses a shrink and only a shrink; <code>address_test.go</code> in this package holds that as a check rather than a recollection. The pair <code>/v1/risk dataset</code> in cloud&#x27;s <code>openapi/misfiled.txt</code> therefore closes by the decision this section makes — one product, four capabilities, disjoint leaves — and MUST NOT close by moving these seven operations to a second top-level address.</p>
<h3>§4 Tenancy</h3>
<p>The tenant is a <code>tenant.Key</code>, and the key is <code>&lt;brand&gt;/&lt;org&gt;</code>, not <code>&lt;org&gt;</code>: an org name is unique within an issuer and not across issuers, so two brands&#x27; identically-named orgs would otherwise be one set of rows and one dataset. The org half comes from the validated bearer owner claim (HIP-0026); the brand half is the deployment&#x27;s own and NEVER a field, because a caller that can choose its brand has chosen which tenant space its org lands in.</p>
<p>The key has no exported field. It cannot be written as a literal outside its own package and cannot be decoded from a request body, and every function that can reach the store takes one — so there is no path from this package to the store that does not carry a tenant. Off the HTTP path there is no request and no principal, and the answer is a refusal. The mint&#x27;s shape is re-asserted at the boundary and a key that is not qualified is 403, because that one value is the register index, the row index and a partition component at once.</p>
<p>The data key and the billing identity are deliberately different values: the key indexes the rows, the ledger names the org that is debited. Conflating them would either bill the wrong account or key the wrong tenant.</p>
<h3>§5 Money</h3>
<p>Metered, and the unit is the ACT that reads the source, never the row.</p>
<ul><li>Declaring a version is free: it is a register write (<code>declareCost</code>, zero).</li><li>Materialising is ten cents (<code>materializeCost</code>), a flat fee for ADMISSION to a</li></ul>
<p> bounded job. The bound is the product, so the price is for the bound and not for the rows.</p>
<ul><li>Lineage is two cents (<code>lineageCost</code>) — below a materialisation because it</li></ul>
<p> re-runs the same census over the same window of the same table for the same tenant and then stops, writing nothing; above zero because a free re-run of the plane&#x27;s most expensive statement is a free warehouse scan with a verb in front of it.</p>
<ul><li>Listing, describing, exporting and disposing are free.</li></ul>
<p>The gate runs before the act and the debit lands after it, both through the one shared <code>cloud.ResourceMeter</code> under the product label <code>dataset</code>. A gate refusal is rendered as the money wire&#x27;s own bytes by <code>cloud.DenyEnvelope</code>, so this plane answers the fleet&#x27;s one denial contract rather than a private spelling of it; any error that is not a denial passes through untouched. Every scan of the source goes through ONE gate, which is what makes &quot;gated, metered and bounded&quot; a property of the admission type rather than a rule each new operation has to remember.</p>
<h3>§6 Events</h3>
<p>It publishes nothing on the bus; a customer&#x27;s webhooks receive no <code>dataset.*</code> events.</p>
<h3>§7 Observability</h3>
<p>Beyond the request span every route gets, structured log lines only: the mount line naming the brand and whether billing enforces, a boot warning when the register is unreachable, and one line per gate refusal carrying the tenant and the cents. It emits no metric of its own and imports no trace transport of its own — tracing is the composer&#x27;s, installed once at the root of every program.</p>
<p>The register-unreachable line is the one that matters. A plane whose store cannot be read answers an honest GAP rather than an empty list, and the log line is what lets an operator tell a tenant who holds nothing from a warehouse that could not be asked.</p>
<h3>§8 Stage</h3>
<p><code>beta</code>. The manifest row declares it (<code>manifest/apps.go:270</code>, <code>Stage: Beta</code>), so the plane is reached by flag until promoted (HIP-0139 §8).</p>
<h3>§9 Upstream</h3>
<p>It derives from none: it forks nothing, embeds nothing and mirrors nothing. It reaches the warehouse through cloud&#x27;s one connection to it and mints its key through the tenant package. No modelling, training or serving code is linked into this app.</p>
<h3>§10 One writer, said plainly</h3>
<p>Every read, every declaration and every disposal is a pure function of the store and answers identically from any process. ADMISSION is not: the one-scan-per-tenant slot and the in-process ceiling are this process&#x27;s own map, so N replicas are N ceilings, and two processes could admit one version&#x27;s materialisation between them — both would write rows under one number and the register would keep whichever completion landed last.</p>
<p>This plane is therefore deployed as a SINGLE WRITER, and that is a deployment fact stated here rather than a property claimed and not held. A durable lease is the only thing that would make it a property, and a plane that runs at one replica does not need one.</p>
<h3>§11 The boundary</h3>
<p>Within the risk product, each plane owns one thing and the four do not overlap: <code>risk</code> decides and learns, <code>label</code> is the answer key that arrives late, <code>reference</code> is the lookup data a decision cannot derive, and this capability is the record of what a model was fitted on. Ground truth and lookup sets are capabilities of their own with their own stores (HIP-1046).</p>
<p>Against <code>/v1/ml</code>: that is the model-SERVING plane, with its own consumers. The rows here feed a model that learns in-process from the org&#x27;s own events and is not served there, so these operations do not belong to it. The pull towards that address is real enough that a test holds this one, rather than a convention.</p>
<h2>Rationale</h2>
<p>The alternative to storing bytes is storing a spec and re-running it, which is cheaper by one table and wrong by construction for the one question a dataset exists to answer. The alternative to a per-tenant partition is a retention policy on the table, which takes the retention decision away from the tenant it belongs to.</p>
<p>The plane is its own app because it shares no state with a scorer: no model in memory, no ring, no single-writer file. Every answer it gives is a function of the store, so it restarts empty and a restart loses nothing but the jobs in flight — which is exactly what a plane holding the record of what a model trained on must do, and exactly what a process pinned to one replica for its in-memory state cannot promise.</p>
<h2>Security Considerations</h2>
<p>Four things a wrong implementation would give an attacker, and where each is refused.</p>
<p><strong>Another tenant&#x27;s training data.</strong> The defence is that the wrong statement is not expressible: every statement opens with a bound tenant predicate, the predicate LEADS both tables&#x27; sort key and partition expression, and the value it binds cannot be written as a literal or decoded from a body. A predicate that opens with a time bound would filter across every tenant&#x27;s rows — slower, and, the half that matters, correct only by a term that is not first.</p>
<p><strong>An identifier of the caller&#x27;s choosing.</strong> Nothing caller-derived ever becomes one. Table names are package constants, columns resolve through a fixed allowlist, the kind is a closed set, and the tenant key, the dataset name, the window, the seed and the caps all bind. Normalisation is total and is the only way to obtain a spec, so every statement takes a normalised value.</p>
<p><strong>A rewritten citation.</strong> A published version is <code>ready</code>, and the only rank above it is <code>disposed</code> — the tenant&#x27;s own retention decision, the one write that may outrank a publication. No other stage can displace it, at the endpoint or in the engine. Version numbers are monotone and never reused, including across disposal, because a citation that is ambiguous across time is not a citation.</p>
<p><strong>The warehouse itself.</strong> The window, the maturity horizon, the row cap, the number of names and the number of versions are all bounded at the endpoint, and every source scan is admitted through one priced gate — one per tenant, a fixed ceiling in the process, each with its own deadline. The per-tenant limit alone is not enough: a thousand tenants each holding their own single slot is still a thousand concurrent scans of one stateful store, which is a fleet resource no tenant owns. An unbounded, unpriced read wearing a GET is what both halves of that gate exist to refuse.</p>
<p>The record itself is a compliance artefact: a dataset a model cited may have to be produced years later against an adverse decision. That is why disposal marks the register instead of deleting it, and why a disposed name continues its version sequence rather than restarting it.</p>
<h2>References</h2>
<ul><li>HIP-0026 — Identity and Access Management</li><li>HIP-0106 — Hanzo Plugin Contract</li><li>HIP-0139 — Capability</li><li>HIP-1046 — Risk</li></ul>
<h2>Copyright</h2>
<p>Released under CC0 1.0 Universal Public Domain Dedication.</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/hip-1167.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>