# deploy version: 0.1.953
# free-claim: /isco-1212/
# free-claim-url: /isco-1212/
# free-claim-agent: /isco-1212/agent.json
# free-claim-ui: /isco-1212/
# free-claim-docs: /docs/free-path.md
# free-path-docs: /docs/free-path.md
# free-path-api: /api/freepath
# free-path-api-alias: /api/free-path
# cloud-itonami (itonami.cloud)

> Governed OSS business fleet + operator cockpit. AI agents and operators
> can discover live APIs and flagship demos from this file.

## Free-path maturity (no Stripe)

- Target: GET /api/status → scores.productSurface 6340/6340
- Compact maturity: GET /api/maturity (freePathOk + productSurfaceTarget; not full status)
- CORS: OPTIONS any /api/* → 204 + Access-Control-Allow-Origin: *
- Free-path digest: GET /api/freepath (headers x-itonami-version, x-itonami-product-surface-target, body.maturity)
- Live health: GET /api/health (headers x-itonami-live, x-itonami-version, x-itonami-free-path-ok)
- Status headers: x-itonami-product-surface-passed/total/target + free-path-ok
- Badge: GET /api/badge (SVG, versioned free-path e.g. ok v0.1.71; ≡ deploy version; x-itonami headers)
- Badge headers: GET /api/badge → x-itonami-next-owner (first-paid-checkout when p0) + x-itonami-free-claim
- Jobs/open-business/marketplace/market-entry: x-itonami-free-path headers on public catalog APIs
- Security: /.well-known/security.txt (RFC 9116 Contact)
- Licenses: /licenses/ UI + /licenses.json (kyoninka procedures)
- Agent runs (activity + nextOwnerActions): GET /api/agent-runs → x-itonami-free-path-ok + version
- Open-business UI: /open-business/6399 · /open-business/7810
- Billing public headers: GET /api/billing/status → x-itonami-billing-public (booleans only)
- Metrics headers: GET /api/metrics and /api/fleet/metrics → x-itonami-free-path-ok + x-itonami-version
- Product metrics (BMC + nextOwnerActions): https://itonami.cloud/api/metrics
- Fleet index (discovery → metrics): https://itonami.cloud/api/fleet
- Discovery links: digests (health/freepath/metrics/fleet/billing/agent-runs/jobs) share links.fleet + wedgePages + openapi + badge
- Fleet metrics (tenants + nextOwnerActions): https://itonami.cloud/api/fleet/metrics
- Billing readiness (booleans + nextOwnerActions): https://itonami.cloud/api/billing/status
- Agent discovery: /.well-known/ai-plugin.json → openapi-free-path + free_path_docs + maturity_status
- Jobs filters: ?q= · ?remote=1 · ?location=USA
- Marketplace filters: ?q=talent · ?q=6399
- Catalog APIs (jobs/marketplace/market-entry/open-business) include nextOwnerActions → /isco-1212/
- Counters: /api/freepath ≡ /api/metrics freePath ≡ /api/fleet/metrics tenants
- Static registries: /health.json · /open-business.json · /marketplace.json · /sitemap.xml
- Agent runs: GET /api/agent-runs?limit=5 · ?isic=6399|6310|7810|8299 filters
- Version align: openapi ≡ health.json ≡ /api/health ≡ /api/freepath
- Owner paid path (docs only on free surface): /docs/stripe-billing-setup.md
- Live digest: GET /api/freepath (alias /api/free-path)
- Dogfood free tenants span ISIC 6399 / 6310 / 7810 / 8299 (not paid)
- Smoke: `nbb scripts/free_path_smoke.cljs` (explicit User-Agent required)

- freeClaim densify: body freeClaim/freeClaimUrl/freeClaimAgent/freeClaimUi/freeClaimDocs + freePath nest (or freePathDetail when freePath is boolean)
- freePath.docs dual of freePathDocs on freePath/freePathDetail objects
- freeClaimDocs: /docs/free-path.md · freeClaimAgent: /isco-1212/agent.json · freeClaimUi: /isco-1212/ · freeClaimUrl: /isco-1212/
- nextOwnerActions densify freeClaim tetrad + freePathDocs on every action
- OpenAPI FreeClaimDiscovery / NextOwnerAction schemas on free-path responses
- Headers: x-itonami-free-claim · x-itonami-free-claim-url · x-itonami-free-claim-agent · x-itonami-free-claim-ui · x-itonami-free-claim-docs · x-itonami-free-path-docs

## Live surfaces (production)

- Home cockpit: https://itonami.cloud/
- Market entry UI: https://itonami.cloud/#market-entry
- Health (static): https://itonami.cloud/health.json
- Live free-path health: https://itonami.cloud/api/health
- Free-path digest (light): https://itonami.cloud/api/freepath
- Free-path digest (light; nextOwnerActions): https://itonami.cloud/api/freepath  (alias /api/free-path)
- Free-path badge (SVG): https://itonami.cloud/api/badge
- Platform status (maturity checklist + freePath + nextOwnerActions): https://itonami.cloud/api/status
- Product metrics (BMC gate, PII-free): https://itonami.cloud/api/metrics
- Agent runs (dry-run activity 7d): https://itonami.cloud/api/agent-runs
- Jobs search filters: https://itonami.cloud/api/jobs?q=engineer&remote=1&limit=10
- Jobs meta-search API (public, no auth): https://itonami.cloud/api/jobs
- Market entry API (ISO3166 countries): https://itonami.cloud/api/market-entry
- Market entry detail: https://itonami.cloud/api/market-entry?country=JPN
- Market entry search: https://itonami.cloud/api/market-entry?q=japan&limit=10
- Open business search: https://itonami.cloud/api/open-business?q=talent&limit=10
- Fleet metrics (KV live): https://itonami.cloud/api/fleet/metrics
- Tenant metrics (org path): https://itonami.cloud/api/gftdcojp/cloud-itonami/metrics
- Billing readiness (Stripe secret booleans): https://itonami.cloud/api/billing/status
- HR paid path (webauthn + checkout): https://itonami.cloud/isco-1212/
- Free tenant claim (no Stripe): https://itonami.cloud/isco-1212/?org=ops-demo&repo=hr-practice
- Go live UI: https://itonami.cloud/#go-live
- Open Business registry API: https://itonami.cloud/api/open-business
- Open Business item API: https://itonami.cloud/api/open-business/6399
- Open Business maturity seed (self-reg): https://itonami.cloud/api/open-business/8299
- Open Business dry-run POST: /api/open-business/{isic}/{intakes|recommendations|approvals}
  (simulated committed:false; writes agent-run:* for agentRuns7d metrics, 7d TTL)
- Open Business static snapshot: https://itonami.cloud/open-business.json
- Marketplace catalog (HTML): https://itonami.cloud/marketplace/
- Marketplace JSON: https://itonami.cloud/marketplace.json
- Marketplace API (filterable): https://itonami.cloud/api/marketplace?q=talent&limit=10
- Free path (no Stripe): https://itonami.cloud/docs/free-path.md
- Checkout preflight (owner, before first paid): https://itonami.cloud/docs/checkout-preflight.md
- Wedge demo Pages catalog (20 conversion LPs): https://itonami.cloud/docs/wedge-pages.md
- Distribution drafts (not posted): https://itonami.cloud/docs/distribution-drafts.md
- OpenAPI free path: https://itonami.cloud/openapi-free-path.json
- Agent plugin: https://itonami.cloud/.well-known/ai-plugin.json
- Stripe setup (owner): https://itonami.cloud/docs/stripe-billing-setup.md
- Go-live runbook: https://itonami.cloud/docs/go-live.md

## Flagship demos (build-time actor runs, not mockups)

- ISIC 6399 Meta Job Search (Indeed-class, governed publish/delist):
  https://cloud-itonami.github.io/cloud-itonami-isic-6399/
  repo: https://github.com/cloud-itonami/cloud-itonami-isic-6399
- ISIC 6310 Talent Actor (kaonavi-class HR):
  https://cloud-itonami.github.io/cloud-itonami-isic-6310/
  repo: https://github.com/cloud-itonami/cloud-itonami-isic-6310
- ISIC 7810 Employment / placement (near-flagship):
  https://cloud-itonami.github.io/cloud-itonami-isic-7810/

## Wedge demos (Lane D conversion faces, GitHub Pages live)

Catalog: https://itonami.cloud/docs/wedge-pages.md
- Fleet-wide: densified ISIC product faces publish via GitHub Pages at
  https://cloud-itonami.github.io/cloud-itonami-isic-{ISIC}/

- Insurance: 6511 life · 6512 non-life · 6622 brokers
  https://cloud-itonami.github.io/cloud-itonami-isic-6511/
- Health: 8610 hospital · 8620 medical/dental · 8690 other health
  https://cloud-itonami.github.io/cloud-itonami-isic-8610/
- Professional services: 6201 programming · 7020 consultancy · 6920 accounting
  https://cloud-itonami.github.io/cloud-itonami-isic-7020/
- Open-business seed: 8299
  https://cloud-itonami.github.io/cloud-itonami-isic-8299/
- All claim/paid CTA: https://itonami.cloud/isco-1212/

## UNSPSC open-business consoles (github.io)

Linked from open-business registry `console` fields (were 404; now densified):

- https://cloud-itonami.github.io/cloud-itonami-unspsc-10/ (apiary/pollinator)
- https://cloud-itonami.github.io/cloud-itonami-unspsc-27/ (tool fleet)
- https://cloud-itonami.github.io/cloud-itonami-unspsc-39/ (solar/EV)
- https://cloud-itonami.github.io/cloud-itonami-unspsc-43/ (IT asset recovery)
- https://cloud-itonami.github.io/cloud-itonami-unspsc-73/ (industrial cleaning)

## Positioning (jobs)

- itonami.cloud GET /api/jobs = gftdcojp-operated live jobs lane (ADR-0022)
- cloud-itonami-isic-6399 = forkable OSS vertical for external operators (ADR-0023)
- They are complementary; neither replaces the other.

## Maturity notes (honest)

- productSurface checklist target: /api/status → scores.productSurface (free path ~100%)
- Stripe secrets configured (GET /api/billing/status readyForLiveCheckout=true, mode live)
- Paid path (hyp/itonami-smb-pay) still needs ≥1 external paid org via /isco-1212/ Checkout
- Free path works without Stripe: claim + open-business dry-run + fleet metrics
- externalPaid is still 0 until a real Checkout completes (do not invent revenue)

## Optional

- Fleet catalog (github.io): https://cloud-itonami.github.io/
- Platform repo: https://github.com/gftdcojp/cloud-itonami
- ISIC 7810 open-business item: https://itonami.cloud/api/open-business/7810

## Agent HTTP client note

Cloudflare may return **403 error code 1010** for browser-signature bans on
default `Python-urllib/*` User-Agents. Use curl, Node fetch, httpx/aiohttp,
or set an explicit User-Agent, e.g.:

```
User-Agent: my-agent/1.0 (+https://itonami.cloud/llms.txt)
```

BMC collect and free-path smoke use a non-empty UA. Free-path smoke:

```
nbb scripts/free_path_smoke.cljs
```
- Dry-run: POST only /api/open-business/{isic}/{intakes|recommendations|approvals}; GET → 405 JSON howTo
- HEAD supported on free-path digests (health/freepath/metrics/fleet/billing/status/badge/…); directory indexes: /api/stripe /api/webauthn /api/nudge
- Indexes: /api/stripe · /api/webauthn · /api/nudge · tenant metrics /api/{org}/{repo}/metrics (+ nextOwnerActions)
- POST-only probes: GET /api/stripe/webhook · /api/webauthn/{challenge,login,register} · /api/nudge/scan → 405 JSON howTo (not 502)
- Tenant paths: GET /api/org · /api/{org} · /api/{org}/{repo} discovery; metrics at /api/{org}/{repo}/metrics
- Deploy version: see /health.json and GET /api/health version field (badge SVG vX.Y.Z)
- Claim agent JSON: https://itonami.cloud/isco-1212/agent.json (passkey free claim + paid Checkout gate, no HTML scrape)
- Catalog version: GET /api/jobs · /api/marketplace · /api/open-business · /api/market-entry body.version + x-itonami-version