# flaviocopes reference pack

112 routing cards covering 17 handbooks, 87 courses, and 8 MIT-licensed
software projects by Flavio Copes.

## What a card is

A card is a map, not the territory. Each one carries:

- what the title covers, as a condensed topic list
- the identifiers that appear in its code samples, as a concept index
- trigger phrases that should route a model to it
- when to reach for it, and when a sibling card is the better fit

Cards average about 2.7 KB. That is deliberate: a hundred of them have to
coexist in a model's skill listing without crowding out the task.

## What a card is not

Cards do not contain the source text. Nothing in this package reproduces the
books or courses. The card tells a model that a reference exists, what is in
it, and how to reach it.

## Getting the full text

`fetch` downloads a title from the publisher to your own machine, `index`
turns that local copy into a searchable store, and `search` reads it. The
corpus lives under `~/.omnius/library/flaviocopes/` and never enters the
package.

```bash
omnius library list flaviocopes           # what's in the pack
omnius library fetch flaviocopes          # pull every title (~95 MB)
omnius library fetch flaviocopes --title postgresql
omnius library index flaviocopes          # build the local search index
omnius library search flaviocopes "search_path"
```

Override the corpus location with `OMNIUS_LIBRARY_HOME`.

## Licensing

The 8 software projects are MIT and carry a redistribution grant; their cards
name the license and link the repository. The handbooks and courses are Flavio
Copes' own work, published for free download at
<https://flaviocopes.com/download/>. This pack ships derived routing metadata
only and points at his servers for the text itself.

## Regenerating

```bash
python3 reference-library/flaviocopes/extract-structure.py   # against fetched EPUBs
node scripts/build-reference-library.mjs flaviocopes
```
