Metadata-Version: 2.5
Name: jetson
Version: 0.9.0
Summary: A verified, sourced knowledge base of everything known about NVIDIA Jetson devices — usable as a CLI, an MCP server, and a multilingual static site. Every claim cites its source, gaps are stated honestly, and existing projects and contributors are credited.
Project-URL: Homepage, https://github.com/agentculture/jetson
Project-URL: Issues, https://github.com/agentculture/jetson/issues
Author: AgentCulture
License-Expression: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# jetson

A verified, sourced knowledge base of everything known about NVIDIA Jetson
devices — usable as a CLI, an MCP server, and a multilingual static site. Every
claim cites its source, gaps are stated honestly, and existing projects and
contributors are credited.

## Status — scaffold

That paragraph is the **mission**, not a description of what is built. This repo
was scaffolded from
[`culture-agent-template`](https://github.com/agentculture/culture-agent-template)
on 2026-09-05 and, apart from renaming, is still the unmodified template: a
working agent-first CLI whose verbs are all *introspective*, a mesh identity, the
vendored skill kit, and a green CI/publish baseline.

The first domain content has landed since: one sourced knowledge topic,
[`boot-mode`](docs/knowledge/boot-mode.md), and the `boot` noun that renders it.
Still not built — an MCP server, the multilingual static site, a repo-wide
sourcing/citation schema (the one topic carries a minimal local shape), and any
other Jetson topic. See [`CLAUDE.md`](CLAUDE.md) for the full mission-vs-reality
breakdown.

## What is here today

- **An agent-first CLI** cited from [teken](https://github.com/agentculture/teken)
  (`afi-cli`) — the runtime package has no third-party dependencies.
- **A mesh identity** — `culture.yaml` (`suffix: jetson`, `backend: colleague`)
  and its resident prompt file `AGENTS.colleague.md`.
- **The vendored skill kit** under `.claude/skills/`, cite-don't-import from
  guildmaster, devague, and colleague. See
  [`docs/skill-sources.md`](docs/skill-sources.md).
- **A build + deploy baseline** — pytest, lint, the agent-first rubric gate, and
  PyPI Trusted Publishing wired into GitHub Actions.

## Quickstart

```bash
uv sync
uv run pytest -n auto                 # run the test suite
uv run jetson whoami                  # identity from culture.yaml
uv run jetson learn                   # self-teaching prompt (add --json)
uv run teken cli doctor . --strict    # the agent-first rubric gate CI runs
```

## CLI

| Verb | What it does |
|------|--------------|
| `whoami` | Report this agent's nick, version, backend, and model from `culture.yaml`. |
| `learn` | Print a structured self-teaching prompt. |
| `explain <path>` | Markdown docs for any noun/verb path. |
| `overview` | Read-only descriptive snapshot of the agent. |
| `doctor` | Check the agent-identity invariants (prompt-file-present, backend-consistency). |
| `cli overview` | Describe the CLI surface itself. |
| `boot mode` | Desktop (GUI) vs console boot on a Jetson, with sources. |
| `boot overview` | What the `boot` noun knows: claims, sources, and recorded gaps. |

Every command supports `--json`. Results go to stdout, errors/diagnostics to
stderr (never mixed). Exit codes: `0` success, `1` user error, `2` environment
error, `3+` reserved.

## Knowledge base

Domain content lives in `jetson/knowledge/` as plain Python data — claims, the
commands they justify, source ids, per-claim confidence, and an explicit gap
list — rendered by the CLI and mirrored as prose under `docs/knowledge/`.

| Topic | CLI | Doc |
|-------|-----|-----|
| `boot-mode` | `jetson boot mode` | [`docs/knowledge/boot-mode.md`](docs/knowledge/boot-mode.md) |

```bash
uv run jetson boot mode            # markdown, citations inline
uv run jetson boot mode --json     # claims + sources + gaps, machine-readable
```

## Contributing

Read [`CLAUDE.md`](CLAUDE.md) first — it carries the conventions:
version-bump-on-every-PR (CI enforces it), the `cicd` PR lane, the worktree
location rule, and the hands-off policy for the vendored `.claude/skills/` tree.

## License

Apache 2.0 — see [`LICENSE`](LICENSE).
