katvan 0.3.0__tar.gz → 0.3.2__tar.gz

{katvan-0.3.0 → katvan-0.3.2}/CHANGELOG.md

@@ -9,6 +9,36 @@ artifacts.
 
 ## [Unreleased]
 
+## [0.3.2] — 2026-05-24
+
+### Added
+
+- Cloudflare Workers deployment config (`site/wrangler.jsonc`) generated by
+  Wrangler autoconfig — serves the built `site/` output (`_site_culture`) as
+  static assets, enabling version-controlled, faster deploys of the
+  culture.dev front door.
+
+## [0.3.1] — 2026-05-18
+
+### Changed
+
+- Site front door (`site/`): hero now leads with the "function call vs
+  coworker" framing; new "The Loop" homepage section between the
+  capability pills and the ecosystem grid; Quickstart has an explicit
+  Prerequisites block (uv, Python, `ANTHROPIC_API_KEY`); each component
+  page gains a "How to reach it" line distinguishing direct CLIs from
+  tools accessed through `culture` or vended skills (#34).
+- Ecosystem category headings now read correctly ("Identity & Secrets",
+  "Resident Agents", etc.) via a new `_data/category_titles.yml` lookup;
+  prior `capitalize` filter only touched the first letter and produced
+  "Identity secrets" / "Resident culture" in the rendered preview.
+- "Resident Culture" category renamed to **Resident Agents** for outsider
+  legibility; URL slug `/categories/resident-culture/` unchanged.
+- `agex` demoted from sidebar peer to a nested child under
+  `Workspace Experience`; "Agent Experience" removed from the top
+  navigation. Agex enters the site through the Ecosystem like every
+  other tool.
+
 ## [0.3.0] — 2026-05-18
 
 ### Added

{katvan-0.3.0 → katvan-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: katvan
-Version: 0.3.0
+Version: 0.3.2
 Summary: Maintain sibling-repo docs under one roof on the culture.dev site.
 Project-URL: Homepage, https://github.com/agentculture/katvan
 Project-URL: Issues, https://github.com/agentculture/katvan/issues

{katvan-0.3.0 → katvan-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "katvan"
-version = "0.3.0"
+version = "0.3.2"
 description = "Maintain sibling-repo docs under one roof on the culture.dev site."
 readme = "README.md"
 license = "MIT"

{katvan-0.3.0 → katvan-0.3.2}/site/_config.culture.yml

@@ -43,8 +43,6 @@ aux_links:
     - "/ecosystem/"
   "AgentIRC":
     - "/agentirc/"
-  "Agent Experience":
-    - "https://culture.dev/agex/"
   "GitHub":
     - "https://github.com/agentculture/culture"
 

katvan-0.3.2/site/_data/category_titles.yml

@@ -0,0 +1,10 @@
+# site/_data/category_titles.yml
+# Display names for ecosystem category slugs. Used by templates that would
+# otherwise downcase multi-word categories via Liquid's `capitalize` filter
+# (which only touches the first character).
+workspace-experience: "Workspace Experience"
+core-runtime: "Core Runtime"
+identity-secrets: "Identity & Secrets"
+resident-culture: "Resident Agents"
+resident-domain: "Resident Domain"
+org-site: "Org Site"

{katvan-0.3.0 → katvan-0.3.2}/site/_data/landing.yml

@@ -5,8 +5,9 @@
 hero:
   headline: "The professional workspace for humans and AI agents."
   supporting: >-
-    Persistent agents that join your channels, share your stack,
-    and stay between sessions.
+    Most AI tooling treats an agent as a function call.
+    Culture treats it as a coworker in the room — persistent agents
+    that join your channels, share your stack, and stay between sessions.
   install_command: "uv tool install culture"
   start_command: "culture start"
   asciinema_cast: "/assets/casts/landing.cast"
@@ -27,6 +28,17 @@ pills:
       Bring Claude, GPT, or a local model. Bring your own keys. Bring your
       shell, your editor, your git workflow. Culture sits next to all of it.
 
+loop:
+  heading: "The loop"
+  intro: >-
+    What actually happens when you run Culture.
+  steps:
+    - "Start a local mesh."
+    - "Join the room as a human."
+    - "Add one or more agents."
+    - "Let them stay between sessions."
+    - "Inspect everything through IRC, CLI, and logs."
+
 why_band:
   paragraph: >-
     Organic Development is the idea that agents become useful by being

{katvan-0.3.0 → katvan-0.3.2}/site/_layouts/home.html

@@ -20,6 +20,16 @@ layout: default
     {% endfor %}
   </section>
 
+  <section class="band band--loop">
+    <h2>{{ site.data.landing.loop.heading }}</h2>
+    {% if site.data.landing.loop.intro %}<p class="loop-intro">{{ site.data.landing.loop.intro }}</p>{% endif %}
+    <ol class="loop-steps">
+      {% for step in site.data.landing.loop.steps %}
+      <li>{{ step }}</li>
+      {% endfor %}
+    </ol>
+  </section>
+
   <section class="band band--ecosystem">
     <h2>The ecosystem</h2>
     {% assign cats = "workspace-experience,core-runtime,identity-secrets,resident-culture,resident-domain,org-site" | split: "," %}
@@ -27,7 +37,7 @@ layout: default
       {% assign repos_in_cat = site.data.agentculture_repos | where: "category", cat %}
       {% if repos_in_cat.size > 0 %}
       <article class="cat-card">
-        <h3>{{ cat | replace: "-", " " | capitalize }}</h3>
+        <h3>{{ site.data.category_titles[cat] | default: cat }}</h3>
         <ul>
         {% for r in repos_in_cat %}
           {% if r.site_path %}{% assign r_path = r.site_path %}{% else %}{% assign r_path = r.id | prepend: "/" | append: "/" %}{% endif %}

{katvan-0.3.0 → katvan-0.3.2}/site/_sass/custom/custom.scss

@@ -363,4 +363,8 @@
 .home-content .band--ecosystem .cat-card ul { list-style: none; padding: 0; }
 .home-content .band--ecosystem .cat-card li { padding: 0.25rem 0; }
 .home-content .band--why .cta { font-weight: 600; }
+.home-content .band--loop h2 { margin: 0 0 1rem; }
+.home-content .band--loop .loop-intro { opacity: 0.75; margin: 0 0 1rem; }
+.home-content .band--loop .loop-steps { padding-left: 1.25rem; margin: 0; }
+.home-content .band--loop .loop-steps li { padding: 0.25rem 0; }
 @media (max-width: 720px) { .home-content .band--pills { grid-template-columns: 1fr; } }

{katvan-0.3.0 → katvan-0.3.2}/site/agex/index.md

@@ -1,7 +1,7 @@
 ---
 title: agex
+parent: "Workspace Experience"
 has_children: true
-nav_order: 1
 sites: [culture]
 permalink: /agex/
 description: Agent-operated developer-experience CLI for autonomous coding agents.

{katvan-0.3.0 → katvan-0.3.2}/site/docs/afi-cli/index.md

@@ -21,4 +21,6 @@ alias is planned.
 **Where it sits.** *Workspace Experience.* The contract layer the lens
 tools read from. Related: [culture](/culture/), [code-lens-cli](/code-lens-cli/).
 
+**How to reach it.** Reached through `culture afi` today; the spec is also installable standalone.
+
 [Reference →](/docs/afi-cli/reference/)

{katvan-0.3.0 → katvan-0.3.2}/site/docs/agentirc/index.md

@@ -20,3 +20,5 @@ wire. Bring your own client. Bring your own bot.
 **Where it sits.** *Core Runtime.* The protocol layer the rest of the stack
 depends on. Related: [culture](/culture/), [irc-lens](/irc-lens/).
 
+**How to reach it.** Reached through `culture server start`. Can also run as a standalone daemon.
+

{katvan-0.3.0 → katvan-0.3.2}/site/docs/agtag/index.md

@@ -1,6 +1,6 @@
 ---
 title: agtag
-parent: Resident Culture
+parent: "Resident Agents"
 nav_order: 1
 permalink: /agtag/
 sites: [culture]
@@ -17,7 +17,9 @@ on the target repo, polls for replies, and gives both sides a stable
 thread to work from. The same binary backs the cross-repo verbs in the
 `communicate` skill.
 
-**Where it sits.** *Resident Culture.* The mesh's cross-repo message bus.
+**Where it sits.** *Resident Agents.* The mesh's cross-repo message bus.
 Related: [steward](/steward/), [ghafi](/ghafi/).
 
+**How to reach it.** Direct entry point, and the engine behind the `communicate` skill that ships in sibling repos.
+
 [Reference →](/docs/agtag/reference/)

{katvan-0.3.0 → katvan-0.3.2}/site/docs/antoine/index.md

@@ -20,5 +20,7 @@ project is early; expect the shape to move.
 **Where it sits.** *Workspace Experience.* Pattern capture for agent
 workflows. Related: [agex](/agex/), [culture](/culture/).
 
+**How to reach it.** Direct entry point (experimental).
+
 [Reference →](/docs/antoine/reference/)
 

{katvan-0.3.0 → katvan-0.3.2}/site/docs/appsec/index.md

@@ -19,3 +19,5 @@ Early-stage; treat output as a second opinion, not a gate.
 **Where it sits.** *Resident Domain.* A domain-serving agent — the
 security domain. Related: [ghafi](/ghafi/), [steward](/steward/).
 
+**How to reach it.** Reached as a resident agent — start it from `culture`, not as a one-off CLI.
+

{katvan-0.3.0 → katvan-0.3.2}/site/docs/auntiepypi/index.md

@@ -1,6 +1,6 @@
 ---
 title: auntiepypi
-parent: Resident Culture
+parent: "Resident Agents"
 nav_order: 2
 permalink: /auntiepypi/
 sites: [culture]
@@ -17,7 +17,9 @@ version-bump conventions every other package in the org uses.
 `auntiepypi` owns the mechanical steps so each repo doesn't reinvent
 them. Early-stage; the API will move.
 
-**Where it sits.** *Resident Culture.* The org's release plumbing.
+**Where it sits.** *Resident Agents.* The org's release plumbing.
 Related: [ghafi](/ghafi/), [steward](/steward/).
 
+**How to reach it.** Direct entry point (early-stage; API will move).
+
 [Reference →](/docs/auntiepypi/reference/)

{katvan-0.3.0 → katvan-0.3.2}/site/docs/categories/resident-culture.md

@@ -1,13 +1,13 @@
 ---
-title: Resident Culture
+title: Resident Agents
 parent: Ecosystem
 permalink: /categories/resident-culture/
 sites: [culture]
 ---
 
-# Resident Culture
+# Resident Agents
 
-**What this category is for.** The agents and tooling that maintain the org itself — its docs, its CI, its packages, its edge, its GitHub.
+**What this category is for.** The agents and tooling that maintain the org itself — its docs, its CI, its packages, its edge, its GitHub. (Formerly "Resident Culture"; URL slug unchanged.)
 
 **When you'd care.** You are landing a change that touches more than one repo and want the docs on culture.dev to follow. You are cutting a release and need PyPI mechanics handled. You are reviewing a sibling-repo PR and want a resident agent to file the cross-repo follow-up. These are the residents that keep the AgentCulture surface coherent: docs sync, PR ergonomics, package publishing, DNS and edge delivery, agent-to-agent messaging. They are run by the org, for the org — the workspace agents that maintain the workspace.
 

{katvan-0.3.0 → katvan-0.3.2}/site/docs/code-lens-cli/index.md

@@ -19,4 +19,6 @@ than ripgrep, narrower than reading the whole tree.
 **Where it sits.** *Workspace Experience.* The read-side companion to the
 afi contract. Related: [afi-cli](/afi-cli/), [irc-lens](/irc-lens/).
 
+**How to reach it.** Direct entry point — agents call it from the command line like ripgrep.
+
 [Reference →](/docs/code-lens-cli/reference/)

{katvan-0.3.0 → katvan-0.3.2}/site/docs/culture/index.md

@@ -21,3 +21,5 @@ as a human. One install, one start, one room.
 of the registry composes underneath it. Related: [agentirc](/agentirc/),
 [afi-cli](/afi-cli/).
 
+**How to reach it.** Direct entry point — and the umbrella every other tool composes under.
+

{katvan-0.3.0 → katvan-0.3.2}/site/docs/cultureagent/index.md

@@ -20,4 +20,6 @@ that rule is enforced, not aspirational.
 **Where it sits.** *Core Runtime.* The bridge between a model provider and
 a room. Related: [culture](/culture/), [agentirc](/agentirc/).
 
+**How to reach it.** Reached through `culture start <agent-name>`.
+
 [Reference →](/docs/cultureagent/reference/)

{katvan-0.3.0 → katvan-0.3.2}/site/docs/cultureflare/index.md

@@ -1,6 +1,6 @@
 ---
 title: cultureflare
-parent: Resident Culture
+parent: "Resident Agents"
 nav_order: 3
 permalink: /cultureflare/
 sites: [culture]
@@ -17,6 +17,8 @@ change should be reviewable rather than clicked through a dashboard.
 `cultureflare` keeps the org's edge config in code and applies it from a
 single agent. Early-stage; expect rough edges.
 
-**Where it sits.** *Resident Culture.* The org's edge plumbing.
+**Where it sits.** *Resident Agents.* The org's edge plumbing.
 Related: [katvan](/katvan/), [landing-page](/landing-page/).
 
+**How to reach it.** Direct entry point (early-stage; expect to run it as an org agent rather than ad-hoc).
+

{katvan-0.3.0 → katvan-0.3.2}/site/docs/ecosystem.md

@@ -12,7 +12,7 @@ sites: [culture]
 {% assign repos_in_cat = site.data.agentculture_repos | where: "category", cat %}
 {% if repos_in_cat.size > 0 %}
 
-## {{ cat | replace: "-", " " | capitalize }}
+## {{ site.data.category_titles[cat] | default: cat }}
 
 [Read the category overview →](/categories/{{ cat }}/)
 

{katvan-0.3.0 → katvan-0.3.2}/site/docs/ghafi/index.md

@@ -1,6 +1,6 @@
 ---
 title: ghafi
-parent: Resident Culture
+parent: "Resident Agents"
 nav_order: 4
 permalink: /ghafi/
 sites: [culture]
@@ -17,7 +17,9 @@ extra, and fixes the mechanical pieces — labels, branch protection,
 description lines, topics. A rename is in flight, so pin the version you
 depend on.
 
-**Where it sits.** *Resident Culture.* The org's GitHub plumbing.
+**Where it sits.** *Resident Agents.* The org's GitHub plumbing.
 Related: [steward](/steward/), [agtag](/agtag/).
 
+**How to reach it.** Direct entry point. Rename in flight — pin the version you depend on.
+
 [Reference →](/docs/ghafi/reference/)

{katvan-0.3.0 → katvan-0.3.2}/site/docs/irc-lens/index.md

@@ -20,4 +20,6 @@ know whether the silence is the room or the protocol.
 **Where it sits.** *Core Runtime.* The read-side companion to the daemon.
 Related: [agentirc](/agentirc/), [code-lens-cli](/code-lens-cli/).
 
+**How to reach it.** Direct entry point.
+
 [Reference →](/docs/irc-lens/reference/)

{katvan-0.3.0 → katvan-0.3.2}/site/docs/katvan/index.md

@@ -1,6 +1,6 @@
 ---
 title: katvan
-parent: Resident Culture
+parent: "Resident Agents"
 nav_order: 5
 permalink: /katvan/
 sites: [culture]
@@ -18,7 +18,9 @@ syncs reference content via the sibling's AFI binary, and `katvan
 doctor` fails CI when a registered repo is missing its page. Runs as a
 CLI; also drives the docs-check workflow.
 
-**Where it sits.** *Resident Culture.* The site's resident docs agent.
+**Where it sits.** *Resident Agents.* The site's resident docs agent.
 Related: [steward](/steward/), [cultureflare](/cultureflare/).
 
+**How to reach it.** Direct entry point; also drives the `docs-check` CI workflow.
+
 [Reference →](/docs/katvan/reference/)

{katvan-0.3.0 → katvan-0.3.2}/site/docs/landing-page/index.md

@@ -20,3 +20,5 @@ sibling docs.
 **Where it sits.** *Org Site.* The only entry in this category.
 Related: [culture](/culture/), [katvan](/katvan/).
 
+**How to reach it.** Visit agentculture.com (the org site) — culture.dev is the product site.
+

{katvan-0.3.0 → katvan-0.3.2}/site/docs/office-agent/index.md

@@ -21,3 +21,5 @@ system of record.
 **Where it sits.** *Resident Domain.* A domain-serving agent — the
 office-logistics domain. Related: [telek](/telek/), [tipalti](/tipalti/).
 
+**How to reach it.** Reached as a resident agent — start it from `culture`.
+

{katvan-0.3.0 → katvan-0.3.2}/site/docs/quickstart.md

@@ -9,6 +9,12 @@ sites: [culture]
 
 Install, start a server, join the mesh, talk to an agent. About two minutes.
 
+## Prerequisites
+
+- [`uv`](https://docs.astral.sh/uv/) on your `PATH`
+- Python 3.10 or newer (uv will install one if you don't have it)
+- An `ANTHROPIC_API_KEY` exported in your shell — the default agent backend is Claude via the Agent SDK. You can swap backends later, but the steps below assume Claude.
+
 ## 1. Install
 
 ```bash

{katvan-0.3.0 → katvan-0.3.2}/site/docs/shushu/index.md

@@ -20,3 +20,5 @@ is planned but not yet shipped.
 **Where it sits.** *Identity & Secrets.* The secret side of mesh identity.
 Related: [zehut](/zehut/), [culture](/culture/).
 
+**How to reach it.** Direct entry point today; a `culture secret` wrapper is planned.
+

{katvan-0.3.0 → katvan-0.3.2}/site/docs/steward/index.md

@@ -1,6 +1,6 @@
 ---
 title: steward
-parent: Resident Culture
+parent: "Resident Agents"
 nav_order: 6
 permalink: /steward/
 sites: [culture]
@@ -17,6 +17,8 @@ stale within a week. `steward` is the source of truth: skills are
 authored there, vendored out to siblings, and re-pulled when steward
 cuts a new version. The repo also owns registry hygiene as a remit.
 
-**Where it sits.** *Resident Culture.* The skill source-of-truth.
+**Where it sits.** *Resident Agents.* The skill source-of-truth.
 Related: [katvan](/katvan/), [agtag](/agtag/).
 
+**How to reach it.** Reached through the skills it vends — `cicd`, `communicate`, and the rest — installed into sibling repos.
+

{katvan-0.3.0 → katvan-0.3.2}/site/docs/telek/index.md

@@ -21,3 +21,5 @@ call. Early-stage; rate limits and policy are your responsibility.
 Telegram-community domain. Related: [office-agent](/office-agent/),
 [appsec](/appsec/).
 
+**How to reach it.** Reached as a resident agent — start it from `culture`.
+

{katvan-0.3.0 → katvan-0.3.2}/site/docs/tipalti/index.md

@@ -22,3 +22,5 @@ read-only by default.
 external-finance-API domain. Related: [shushu](/shushu/),
 [office-agent](/office-agent/).
 
+**How to reach it.** Reached as a resident agent — start it from `culture`.
+

{katvan-0.3.0 → katvan-0.3.2}/site/docs/zehut/index.md

@@ -20,3 +20,5 @@ wrapper is planned but not yet shipped.
 **Where it sits.** *Identity & Secrets.* The identity side of mesh
 identity. Related: [shushu](/shushu/), [agentirc](/agentirc/).
 
+**How to reach it.** Direct entry point today; a `culture identity` wrapper is planned.
+

katvan-0.3.2/site/wrangler.jsonc

@@ -0,0 +1,16 @@
+{
+  "name": "katvan",
+  "compatibility_date": "2026-05-17",
+  "observability": {
+    "enabled": true
+  },
+  // Relative to this config file's directory (site/), so this resolves to
+  // site/_site_culture — the Jekyll build output (docs-check.yml builds with
+  // working-directory: site, -d _site_culture).
+  "assets": {
+    "directory": "_site_culture"
+  },
+  "compatibility_flags": [
+    "nodejs_compat"
+  ]
+}

{katvan-0.3.0 → katvan-0.3.2}/uv.lock

@@ -582,7 +582,7 @@ wheels = [
 
 [[package]]
 name = "katvan"
-version = "0.3.0"
+version = "0.3.2"
 source = { editable = "." }
 dependencies = [
     { name = "defusedxml" },