https://github.com/royashbrook/lifescored

You are already a number. Every rule cited, every weight editable.
https://github.com/royashbrook/lifescored

cloudflare-workers life-score svelte transparency

Last synced: 1 day ago
JSON representation

You are already a number. Every rule cited, every weight editable.

• Host: GitHub
• URL: https://github.com/royashbrook/lifescored
• Owner: royashbrook
• License: mit
• Created: 2026-06-12T22:08:48.000Z (30 days ago)
• Default Branch: main
• Last Pushed: 2026-06-29T17:04:42.000Z (13 days ago)
• Last Synced: 2026-06-29T19:07:26.300Z (13 days ago)
• Topics: cloudflare-workers, life-score, svelte, transparency
• Language: TypeScript
• Size: 430 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# life. scored.

[![deploy](https://github.com/royashbrook/lifescored/actions/workflows/deploy.yml/badge.svg)](https://github.com/royashbrook/lifescored/actions/workflows/deploy.yml)

**You are already a number.**

A credit score, an actuarial row, a callback probability — this app rebuilds those numbers in the open: every rule cited or flagged as a guess, every weight visible and editable. Transparency, not judgment.

[check it out - lifescored.com](https://lifescored.com)

## Stack

- Svelte 5 + SvelteKit, prerendered static pages, deployed to Cloudflare Workers

- One dynamic endpoint: `POST /api/narrative` — KV-cached Gemini narratives with a

  deterministic local fallback (the app is fully functional with no API key at all)

- All user data stays in the browser (localStorage + URL-fragment share links)

- Traffic is measured with Cloudflare Web Analytics — cookieless and aggregate; it cannot see your inputs, which never leave your device anyway.

## Develop

    npm install

    npm run dev      # app at localhost:5173 (narrative falls back to local composer)

    npm test         # vitest suite: rulebook invariants, engine, codec, worker handler

    npm run check    # svelte-check

## Deploy (Cloudflare free tier)

Deploys run automatically from GitHub Actions on every push to `main`

([`.github/workflows/deploy.yml`](.github/workflows/deploy.yml)): the workflow

runs the full test suite + typecheck, and only then builds and deploys.

**One-time setup:**

Secrets are kept in [hush](https://github.com/royashbrook/hush): stored once in your OS keychain,

then piped straight into the consumer — they never get pasted into a terminal, echoed, or printed.

This project's hush items use a `lifescored-` prefix so they group together in a keychain search.

(No hush? Drop the `hush pipe … --` prefix and run the bare `npx wrangler` / `gh` command; hush just

wraps it.) Local dev needs no secrets at all — the narrative falls back to a local composer.

1. Create the KV namespace and paste its id into `wrangler.jsonc`:

       npx wrangler kv namespace create NARRATIVE_KV

2. Set the Gemini key as a Worker secret (persists across deploys; optional —

   omit to run AI-free with the local narrative fallback):

       hush set lifescored-gemini-key                                   # paste it once, hidden dialog

       hush pipe lifescored-gemini-key -- npx wrangler secret put GEMINI_API_KEY

3. Give GitHub Actions the deploy credentials

   (Settings → Secrets and variables → Actions):

       hush set lifescored-cloudflare-api-token                         # "Edit Cloudflare Workers" token

       hush pipe lifescored-cloudflare-api-token -- gh secret set CLOUDFLARE_API_TOKEN

       gh secret set CLOUDFLARE_ACCOUNT_ID --body ""    # account id isn't secret

Push to `main` and the action ships it. To deploy by hand instead:

       npm run deploy

## Deploy your own

Fork the repo, do the one-time setup above with your own Cloudflare account, and

push. The app is fully functional with no Gemini key at all.

## Editing the rulebook

Rules live in `src/lib/rulebook/.ts`. Each rule is declarative: logic,

evidence tag (`SOURCED`/`SPECULATIVE`), citation with access date, a pure

`position(inputs)` (the measured fact, normalized to a numeric position), declared

`bounds` (negative floors only where the cited system itself subtracts; the wealth

rules are uncapped above), and a `weightRationale` justifying its weight against

the 1.0× income baseline; the engine computes `points = round(position × weight)`.

Add a rule, and the UI, weight editor, share

codec, and about-page source list pick it up automatically. `npm test` enforces

the invariants (bounds, integer scores, citation present).

## Use it from an agent (MCP or skill)

The whole rulebook + exact math is published so any agent can compute a score **on its own side** — nothing about a person is ever sent to lifescored.com.

- **MCP server** — `com.lifescored/mcp` on the [official registry](https://registry.modelcontextprotocol.io); endpoint `https://lifescored.com/mcp` (stateless Streamable HTTP, no auth, accepts no personal data). Tools: `get_rulebook`, `get_input_schema`, `get_methodology`, `how_to_give_feedback`.

- **Skill** — a drop-in [`skills/lifescored/`](skills/lifescored/SKILL.md) skill. Copy it into your agent's skills directory (e.g. `~/.claude/skills/`). It prefers the MCP and falls back to `rules.json`.

- **Raw data** — [`https://lifescored.com/rules.json`](https://lifescored.com/rules.json) and [`/llms.txt`](https://lifescored.com/llms.txt).

## Contributing

Every commit must reference a GitHub issue number, e.g. `feat: add presets (#2)` or `refs #5`. A `commit-msg` hook enforces this automatically — it is installed via `core.hooksPath` pointing to `.githooks/`, which activates on `npm install` (the `prepare` script runs `git config core.hooksPath .githooks`). Merge commits and reverts are exempt. To find or open an issue: `gh issue list` / `gh issue create`.

## License

MIT — see LICENSE.