Name: faf-cli
Author: Wolfe-Jam

Imported from Wolfe-Jam/faf-cli (AGENTS.md). Install upstream with npx skills add Wolfe-Jam/faf-cli. Copyright stays with the author.

AGENTS.md — faf-cli

CLI for IANA-registered .faf + .fafm (application/vnd.faf+yaml · vnd.fafm+yaml) — TypeScript · Bun-native since v6 · npm package faf-cli v7.2.0 (The Memory Edition).

Setup & build

bun install
bun run build    # clean → bun build cli+index → tsc (dist/)
bun run dev      # bun src/cli.ts

Run the tests

bun run test     # bun test --timeout=120000 — must pass before a change is done
bun run lint     # eslint src/**/*.ts

Ship-adjacent (when touching build output or publish path):

bun run check:no-hardcode   # fail if machine paths leaked into dist/

Where things live

Path	Role
`src/cli.ts`	CLI entry (Commander)
`src/index.ts`	Library entry
`src/commands/`	One file per `faf` subcommand (`init`, `score`, `export`, `sync`, `memory`, …)
`src/fafm/`	`.fafm` library (Soul, fromClaudeDir) — INTEROP with claude-fafm-sdk 1.0
`src/core/`	Domain engines (slots, scorer, types, schema) — compose, don’t fork
`src/detect/`	Stack / project detection
`src/interop/`	Context emitters (`agents.ts`, `claude.ts`, `gemini.ts`, …)
`src/wasm/`	Bridge to `faf-scoring-kernel` (Rust→WASM) — scoring lives here, not reimplemented in TS
`src/ui/`	Terminal UI helpers
`package.json`	Scripts, bin (`faf` / `faf-cli` → `dist/cli.js`)
`project.faf`	Project DNA (keep version/goal honest when they change)

Conventions

Bun-native — use bun, not npm, for install/run/test in this repo.
TypeScript strict + ESM ("type": "module") — obey tsconfig.json and ESLint; don’t restyle by hand.
Domain-model first — single-source engines in src/core/; compose them from commands; never reimplement scoring in TypeScript (use the WASM kernel).
Wording (product copy): FAF authors (never “generates”); never guessed (not “not guessed”); never write Guaranteed (any form) — free software.
Match the style of the surrounding file.

Guardrails

Always OK: read the tree · bun run test · bun run lint · bun run build · edit under src/ with tests.
Ask first: dependency adds/upgrades · deletions · publish / release / tag · changes to scoring kernel integration · dual-publish (faf ↔ faf-cli) path.
Never: force-push · push straight to main (branch and open a PR) · commit secrets · hand-run npm publish (releases go through /pubpro only) · reimplement scoring outside faf-scoring-kernel / src/wasm/.
FAF files live in git. project.faf · .fafm · .fafa · .fafi · .faf-dna stay tracked unless there is a named reason (secrets, personal soul, generated scratch). Gitignore is for caches and installer lockfiles, not the format family. .faf-dna is the birth certificate — do not hide it to clean status.

Definition of Done

Done when:

bun run lint exits 0
bun run test passes
If you touched the build/publish surface: bun run build and bun run check:no-hardcode pass
Change is on a branch with a clear conventional commit (feat:, fix:, chore:, …)

When stuck

Ask a clarifying question, propose a short plan, or open a draft PR with notes — do not push large speculative changes to main.

Commit & PR

Conventional Commits preferred.
One logical change per PR when practical.
If you change package.json scripts, layout under src/, or publish gates — update this file in the same PR.

Install faf-cli and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "wolfe-jam-faf-cli-faf-cli", "kind": "skill", "name": "faf-cli", "description": "CLI for IANA-registered `.faf` + `.fafm` (`application/vnd.faf+yaml` · `vnd.fafm+yaml`) — TypeScript · Bun-native since v6 · npm package `faf-cli` **v7.2.0** (The Memory Edition).", "publisher": "Wolfe-Jam", "version": "1.0.0", "capabilities": { "domains": [ "coding", "math" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "CLI for IANA-registered `.faf` + `.fafm` (`application/vnd.faf+yaml` · `vnd.fafm+yaml`) — TypeScript · Bun-native since v6 · npm package `faf-cli` **v7.2.0** (The Memory Edition)." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/Wolfe-Jam/faf-cli", "path": "AGENTS.md", "ref": "73712c5225467f7019dc4beef24af6aabb9751c3", "url": "https://github.com/Wolfe-Jam/faf-cli/blob/73712c5225467f7019dc4beef24af6aabb9751c3/AGENTS.md", "key": "Wolfe-Jam/faf-cli/AGENTS.md" } }, "instructions": "# AGENTS.md — faf-cli\n\nCLI for IANA-registered `.faf` + `.fafm` (`application/vnd.faf+yaml` · `vnd.fafm+yaml`) — TypeScript · Bun-native since v6 · npm package `faf-cli` **v7.2.0** (The Memory Edition).\n\n## Setup & build\n\n```bash\nbun install\nbun run build # clean → bun build cli+index → tsc (dist/)\nbun run dev # bun src/cli.ts\n```\n\n## Run the tests\n\n```bash\nbun run test # bun test --timeout=120000 — must pass before a change is done\nbun run lint # eslint src/**/*.ts\n```\n\nShip-adjacent (when touching build output or publish path):\n\n```bash\nbun run check:no-hardcode # fail if m", "cost": { "context_tokens": 873 } }

faf-cli

About