# 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 47/47
- 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.51; ≡ deploy version)
- Metrics headers: GET /api/metrics → x-itonami-free-path-ok + x-itonami-version
- Jobs filters: ?q= · ?remote=1 · ?location=USA
- Marketplace filters: ?q=talent · ?q=6399
- 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)

## 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 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
- 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/

## 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
- Paid path (hyp/itonami-smb-pay) blocked until owner configures STRIPE_* secrets
- Free path works without Stripe: claim + open-business dry-run + fleet metrics

## 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
```