mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
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]>
287 lines
24 KiB
HTML
287 lines
24 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hip-1327</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-1327.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hip-1327">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hip-1327.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-1327</h1><p class="lede">HIP-1327: Public Channels — Finding a Room in Another Org. Status Draft. Hanzo architectural specification.</p><h1>HIP-1327: Public Channels — Finding a Room in Another Org</h1>
|
|
<h2>Abstract</h2>
|
|
<p>A room is already public or private (HIP-0523), and public is the default. But public means <em>anyone in the org</em> — the list a person can browse stops at their own tenant. This HIP specifies how a room becomes findable from outside the org that owns it, and what it takes to join one.</p>
|
|
<p>It adds one platform-scoped <strong>directory</strong> and two addresses. It does not add a second room store, a second message path, or federation between deployments. A room joined from another org is the same room in the same store; what changes is who its roster admits.</p>
|
|
<h2>Motivation</h2>
|
|
<p>The ask is ordinary and the product does not answer it: <em>everyone should be able to see and join the Hanzo channels, and browse orgs that have public ones.</em> An open-source project's channel is worth nothing if only the company that owns the org can find it.</p>
|
|
<p>What blocks it is not policy. <code>listRooms</code> (<code>apps/team/room.go:208</code>) resolves the caller's org, asks <code>SpacesForOrg</code> for that org's spaces, and reads each with <code>byClasses(org, space, …)</code>. That last call is <code>s.db(org, space)</code> (<code>apps/team/store.go:198</code>) — <strong>the org and space select a distinct database.</strong> Tenancy here is physical, which is the estate's rule and not this subsystem's quirk: a distinct org is a distinct file.</p>
|
|
<p>So "list public rooms across orgs" cannot be a predicate added to that handler. Answering it there would mean opening every tenant's database on an unauthenticated person's behalf, which is the one thing the storage model exists to prevent. The feature needs somewhere else to look.</p>
|
|
<h2>Specification</h2>
|
|
<h3>1. The directory</h3>
|
|
<p>A single platform-scoped index, outside every org's store, holding one row per room that is public:</p>
|
|
<p> org the owning org space the space within it room the room id, as the owning store knows it name what a person sees topic one line, when the room has one members a count, never a roster updated when this row was last written</p>
|
|
<p>It holds <strong>no message, no member identity, and no private room.</strong> A row is the minimum needed to render a result and address the room it names; anything more would be a second copy of the room, and HIP-0523 has one store for a reason.</p>
|
|
<p>The directory is a projection, never a source. If it disagrees with the owning org's store, the store is right and the row is stale.</p>
|
|
<h3>2. When a row is written</h3>
|
|
<p>The owning org writes its own rows. Four events, all of them already writes the <code>team</code> app performs:</p>
|
|
<p>| event | effect | |---|---| | a public room is opened | insert | | a room is renamed or its topic set | update | | a room turns private | <strong>delete</strong> | | a room is archived | delete |</p>
|
|
<p>A room that turns private must leave the directory in the same write that turns it, not on a later sweep. The window between the two is a window in which a private room is advertised.</p>
|
|
<h3>3. Finding</h3>
|
|
<p> GET /v1/team/public?q=&org=&limit=&cursor=</p>
|
|
<p>Answers rows from the directory, newest-updated first. <code>q</code> matches name and topic; <code>org</code> narrows to one. It is readable by any authenticated principal — the rows carry nothing an org has not published, and a directory only its own org can read is not a directory.</p>
|
|
<p>It is NOT part of <code>GET /v1/team/rooms</code>. That address answers <em>the caller's</em> rooms and its meaning must not change: a client that renders it as a sidebar would start listing strangers' channels in a person's own list.</p>
|
|
<h3>4. Joining</h3>
|
|
<p> POST /v1/team/rooms/{id}/join</p>
|
|
<p>The one write that crosses a tenant boundary, and the whole of the new authorization. It admits the calling principal to the roster of a room their org does not own, and it is refused unless every one of these holds:</p>
|
|
<ol><li>the room is in the directory — that is what "public" means here, and reading</li></ol>
|
|
<p> the owning store to decide would be the cross-tenant read this HIP avoids;</p>
|
|
<ol><li>the room is still public in the owning store, re-read at the moment of the</li></ol>
|
|
<p> write, because a directory row can be stale and a stale row must not admit anybody;</p>
|
|
<ol><li>the caller is an authenticated principal with a home org — a machine token</li></ol>
|
|
<p> with no org joins nothing;</p>
|
|
<ol><li>the owning org has not barred the caller's org.</li></ol>
|
|
<p>A join writes a member into the owning org's store. It does not copy the room, and it does not give the joiner's org a room of its own.</p>
|
|
<h4>What this costs, measured</h4>
|
|
<p>Admitting a stranger is not a matter of appending to <code>members</code>. Every read path resolves the space through <code>identity.admit</code> (<code>apps/team/account.go:1267</code>), which calls <code>SpaceByUUID(ctx, cl.org, wsUUID)</code> — <strong>the space is looked up scoped to the CALLER'S org</strong>, so a space another org owns does not resolve for a stranger at all, and the call returns <code>errNoSpace</code> before membership is ever consulted. <code>AccountForSubject</code> (<code>account_store.go:390</code>) is the same shape one layer down: it asks IAM whether the subject may act <em>in that org</em> and answers <code>false</code> for anybody who may not.</p>
|
|
<p>So room membership across orgs cannot be added as a row. It requires a room-scope that exists independently of org membership — a caller admitted to one document in a tenant they are not a member of — and that is a change to what <code>admit</code> means, which is the tenant boundary itself. <strong>It is an architecture decision and this HIP does not smuggle it in as an implementation detail.</strong> Two shapes are worth weighing, and neither should be chosen without the owner:</p>
|
|
<ol><li><strong>A guest membership row in the owning org</strong>, carrying the room it is scoped</li></ol>
|
|
<p> to. <code>admit</code> gains a second question rather than a looser first one; the boundary stays a boundary and a guest reaches exactly one document.</p>
|
|
<ol><li><strong>Grant the joiner IAM membership of the owning org.</strong> Simpler to write and</li></ol>
|
|
<p> much larger than it looks: it makes a channel-joiner a member of the company, which is not what joining a channel means.</p>
|
|
<p>The directory and its read (§1–§3) do not wait on this, and are shipped.</p>
|
|
<h3>5. What a joined member is</h3>
|
|
<p>A member from another org is a member: they read the room's messages and write messages to it. They are NOT an administrator of it. Specifically, they may not rename it, bind it, make it private, archive it, or admit anybody else. Those verbs stay with the owning org, because the room is the owning org's document and its lifecycle is that org's to state.</p>
|
|
<p>Leaving is <code>DELETE</code> on the same address, and removes exactly the caller.</p>
|
|
<h3>6. What this does not specify</h3>
|
|
<ul><li><strong>Federation between deployments.</strong> Everything here is within one estate. Two</li></ul>
|
|
<p> estates sharing a channel is a different problem and needs a different HIP.</p>
|
|
<ul><li><strong>A public DM.</strong> <code>teamRoomNew</code> carries no <code>direct</code> field</li></ul>
|
|
<p> (<code>apps/team/room.go:432</code>), so a direct message is not opened by that route and is not made public by this one.</p>
|
|
<ul><li><strong>Discovery of orgs.</strong> <code>org=</code> filters the directory by a name the caller</li></ul>
|
|
<p> already has. An index of orgs is <code>iam</code>'s to publish, not <code>team</code>'s.</p>
|
|
<h2>Rationale</h2>
|
|
<p><strong>Why a directory rather than a query.</strong> The alternative is a handler that opens every org's database and filters. That is not a bigger version of the current read; it is the opposite of it. The physical partition is the isolation, so a reader that spans partitions has no isolation left to rely on — one bug in the predicate leaks a private room, and nothing structural stops it. A projection holding only published fields cannot leak what it never held.</p>
|
|
<p><strong>Why the join re-reads the owning store.</strong> A directory is eventually consistent by construction. Trusting it for the admission decision means a room that turned private a second ago still admits strangers. The row decides what is <em>findable</em>; the store decides what is <em>joinable</em>. Two questions, two sources, and the stricter one wins.</p>
|
|
<p><strong>Why joining does not copy the room.</strong> A copy is a second store, and then two rooms drift and nobody can say which one a message landed in — the same argument HIP-0523 makes for having one store at all.</p>
|
|
<p><strong>Why a member count and not a roster.</strong> "How busy is this channel" is what a person choosing between rooms is asking. Who is in it is that org's to disclose, and a roster in a public index is a membership list published without consent.</p>
|
|
<h2>Security Considerations</h2>
|
|
<p><strong>The directory is the disclosure boundary.</strong> Every field in it is world-readable to authenticated principals; nothing may be added to it that an org has not chosen to publish by making a room public. Adding a field to that row is a disclosure decision, not a schema change.</p>
|
|
<p><strong>A stale row must never admit.</strong> §4.2 is the load-bearing clause. Without the re-read, the window between "turned private" and "row deleted" is a window in which anybody can join a private room, and directory writes are exactly the kind of thing that fails quietly.</p>
|
|
<p><strong>A join is an audited privileged write.</strong> It adds a principal from outside the tenant to a document inside it. It belongs in the audit trail with the joiner, the room, and both orgs named, for the same reason every other cross-boundary write does.</p>
|
|
<p><strong>Barring is per-org and must be checkable without the joiner's cooperation.</strong> §4.4 is what lets an org that publishes a channel stop a specific org from entering it. It is a property of the owning org, read on the join path.</p>
|
|
<h2>Measured state, 2026-09-01</h2>
|
|
<p>Against <code>apps/team</code> at <code>84c74fee81</code>, and probed on production and a local cloud with <code>/v1/bogus-control-xyz</code> (404) as the control:</p>
|
|
<p>| thing | state | |---|---| | <code>GET /v1/team/rooms</code> | shipped — <code>room.go:121</code>, 403 unauthenticated | | <code>POST /v1/team/rooms</code> | shipped — <code>room.go:122</code>, opens a room, public by default | | <code>PUT /v1/team/rooms/{id}</code> | shipped — <code>room.go:123</code>, states intent | | <code>GET/POST /rooms/{id}/messages</code> | shipped — <code>message.go:103-104</code> | | <code>private</code> on a room | shipped — <code>teamRoomNew</code>, <code>room.go:432</code> | | org-scoped listing | shipped — <code>room.go:208</code>, via <code>s.db(org, space)</code> | | the directory | <strong>shipped</strong> — <code>apps/team/public.go</code>, system namespace | | <code>GET /v1/team/public</code> | <strong>shipped</strong> — typed, <code>x-tool</code>, published in the subset | | publish on open | <strong>shipped</strong> — <code>room.go</code>, public rooms only, best-effort | | <code>POST /v1/team/rooms/{id}/join</code> | <strong>absent</strong> — blocked on §4's decision |</p>
|
|
<p>A local cloud's <code>/v1/openapi.json</code> listed <code>GET</code> alone on <code>/v1/team/rooms</code> while the route answered <code>403</code> to a <code>POST</code>. The document lagged the binary; the route is the measurement. Probe the address, not the spec.</p>
|
|
<h2>References</h2>
|
|
<ul><li>HIP-0139 — A Capability Answers At Its Own Name</li><li>HIP-0523 — Rooms — One Store, Two Views, Many Bridges</li><li>HIP-1048 — Team</li><li>HIP-1066 — Channels — One Inbox</li></ul>
|
|
<h2>Copyright</h2>
|
|
<p>Released under the same terms as the rest of the HIPs repository.</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-1327.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |