Skip to content

Home

Jump to bottom
Greg Chambers edited this page Sep 30, 2026 · 5 revisions 
  ·      ✦          ·        ★            ·          ✦         ·       ·
███████╗████████╗ █████╗ ██████╗  ██████╗██╗  ██╗ █████╗ ██████╗ ████████╗
██╔════╝╚══██╔══╝██╔══██╗██╔══██╗██╔════╝██║  ██║██╔══██╗██╔══██╗╚══██╔══╝
███████╗   ██║   ███████║██████╔╝██║     ███████║███████║██████╔╝   ██║
╚════██║   ██║   ██╔══██║██╔══██╗██║     ██╔══██║██╔══██║██╔══██╗   ██║
███████║   ██║   ██║  ██║██║  ██║╚██████╗██║  ██║██║  ██║██║  ██║   ██║
╚══════╝   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝   ╚═╝
☠ EVERY DEPENDENCY. CODE TO COSMOS. ────────── A SPACE PIRATE ZERO JOINT ☠
     ·         ·         ✦           ·          ★          ·         ·

Every dependency. Code to cosmos. This is the STARCHART wiki: what the tool is, why it exists, what it looks like on a real change, and a map of every page. Start here, then jump to Getting Started or the Pro Universe tutorial.

What STARCHART is

STARCHART is a dependency graph for everything your product touches, not just your code. It charts three layers (code, facts and world) and the bridges between them, so a price, a product id or a Swift view is connected to the website, the OG image, the App Store listing, the Stripe price and the promo reel that depend on it. Change anything on any layer and STARCHART tells you what else is now wrong, explains why, fixes what it can, and turns the rest into a checklist.

flowchart BT
  subgraph CODE["CODE (extracted, never hand-written)"]
    sym["symbol:ios/Pricing.proUSD"]
    scr["screen:ios/Paywall"]
    rte["route:web/pricing"]
  end
  subgraph FACTS["FACTS (authored in .starchart/)"]
    price["addon:pro.price.usd = 4.99"]
    feat["addon:pro.features"]
  end
  subgraph WORLD["WORLD (bound through adapters)"]
    page["web:pricing-page"]
    og["web:og-pro"]
    shot["appstore:screenshots/6.9/03"]
    stripe["stripe:price/pro-monthly"]
  end
  sym -- anchors --> price
  page -- embeds --> price
  og -- renders --> price
  stripe -- mirrors --> price
  shot -- captures --> scr
  rte -- publishes --> page
Loading

Arrows point the way you read them in YAML ("the page embeds the price", "the screenshot captures the paywall"). Impact mostly flows against them: change the price and the page, the OG image and the Stripe price light up; change the paywall screen and the screenshot goes stale. (anchors works both ways, and publishes runs with the arrow.) See Three-Layer Model and Edge Types.

What a change looks like

This is real output from the bundled demo after bumping addon:pro.price.usd from 4.99 to 5.99 in .starchart/entities/pro.yaml (a temp copy of examples/pro-universe):

$ starchart plan
Change: addon:pro.price  {"usd":4.99,"eur":4.99} → {"usd":5.99,"eur":4.99}
Change: addon:pro.price.usd  4.99 → 5.99

  ! manual  appstore:iap/pro-monthly                            mirrors    update in appstore (adapter is read-only)
  ! manual  appstore:listing/description                        embeds     adapter "appstore" cannot write
  ! manual  appstore:screenshots/6.9/03                         embeds     value is burned into media
  ! manual  stripe:price/pro-monthly                            mirrors    update in stripe (adapter is read-only)
  ! manual  web:live-pricing                                    embeds     adapter "url" cannot write
  ~ auto    email:onboarding-day-3                              embeds     replace embedded value
  ~ auto    symbol:ios/StarchartFacts.AddonPro.Price.usd        anchors    regenerate fact constants (codegen)
  ~ auto    symbol:web/lib/starchart-facts#ADDON_PRO_PRICE_USD  anchors    regenerate fact constants (codegen)
  ~ auto    web:messages-en                                     embeds     replace embedded value
  ~ auto    web:og-pro                                          renders    regenerate from template
  ~ auto    web:pricing-page                                    embeds     replace embedded value
  ? review  web:landing-hero                                    describes  describes this semantically
  ⌘ code    symbol:ios/Pricing.proUSD                           anchors    hardcoded value anchors this fact; update or switch to codegen
  ⌘ code    symbol:web/lib/stripe#PRICE_PRO_MONTHLY             anchors    holds this artifact's external id; update it if the id changes
  ✗ retire  reel:spring-2026                                    embeds     expired 2026-06-30
  ✓ tests   test:ios/Tests/PaywallTests.swift                   tests      run these tests

Order: stripe:price/pro-monthly → appstore:iap/pro-monthly → appstore:listing/description → … → web:live-pricing → reel:spring-2026

Plan: 5 manual · 6 auto · 1 review · 2 code · 1 retire · 1 tests
(4 informational items hidden; use --verbose)

One YAML edit. Sixteen things across code, stores, payments, web, email and video. starchart apply then rewrites the pricing page, the web copy and the email, re-renders the OG PNG, regenerates the two codegen constants, journals an undo record and relocks. The Stripe and App Store items stay manual because external writes are opt-in, and plan keeps listing them (in step with starchart check) until someone does the work and runs starchart ack.

Why

Code has dependency graphs. The world around your code doesn't, and nothing connects the two.

  • dependency-cruiser, Nx and Bazel know PaywallView.swift references Pricing.swift. They have no idea App Store screenshot 3 shows that paywall, that the website says "$4.99", or that a promo reel burned the price into a video.
  • Marketing tools know the website. They have no idea ProductID.proMonthly in the iOS app has to match an App Store product and a Stripe price.

So you change the Pro add-on and play whack-a-mole across code, copy, stores, images and video. Something always gets missed. STARCHART makes the misses a build failure instead of a customer email.

Features

Chart

Check

Fix

Integrate

  • Claude Code hook: every file an agent edits gets its world impact injected back. Claude Code Hook
  • MCP server for any agent. MCP Server
  • GitHub Action: a sticky PR comment with the blast radius. GitHub Action
  • Reality X-Ray browser extension. Reality X-Ray
  • Plugins: custom adapters and rule packs load from plugins: in config, so the CLI, MCP server and hook all see them. Writing an Adapter · Rule Packs

Quick start

Install it in your project from npm:

npm i -D @space-pirate-zero/starchart

Always use the scoped name @space-pirate-zero/starchart: the unscoped starchart package on npm belongs to someone else. Once it's installed locally, npx starchart runs your copy:

npx starchart init --discover
npx starchart lock

init writes .starchart/config.yaml and detects your code scopes. --discover proposes facts, artifacts and bridges in .starchart/proposals/discovered.yaml, which the loader ignores until you review it and move it into .starchart/ (for example .starchart/entities/offer.yaml). lock pins every artifact to today's facts and code. Commit .starchart/ and starchart.lock. No install? npx @space-pirate-zero/starchart <command> does the same thing. Full walkthrough: Getting Started.

Where to go next

Section Pages
Guides Getting Started · Tutorial: Pro Universe · FAQ and Troubleshooting
Concepts Three-Layer Model · Facts and Entities · Artifacts and Bindings · Edge Types · Node IDs · Impact Analysis · Lockfile and Drift · Rollout Ordering
Authoring Configuration · Authoring YAML · Annotations · Code-Authority Facts · Design Tokens · Vocabulary
Code layer Code Ingestion · Git Diff Impact · Bridges and Discovery
Commands & API CLI Reference · Library API · Codegen · JSON-LD and SEO · Time Machine
Adapters & engine Adapters Overview · Adapter: fs · Adapter: url · Adapter: Stripe · Adapter: App Store Connect · Writing an Adapter · Audit and Break Detection · Apply, Revert and Journals · Future Universe Preview · Viewer and Serve · Reality X-Ray
Rules & analysis Rules Engine · Rule Packs · Privacy Drift · Orphans · Reality Score · Change Cost
Integrations MCP Server · Claude Code Hook · GitHub Action
Project Architecture · Contributing · Security · Roadmap

STARCHART is a Space Pirate Zero project, licensed Apache-2.0. Source: space-pirate-zero/starchart.

See also

        ·              ✦                ·
    ★               _________               ·
                .-'           '-.
     ·         /                 \         ✦
              |   .---.   .---.   |
              |   ( ✦ )   ( ✦ )   |
      ✦        \  '---'   '---'  /        ·
                '.     /_\     .'
                  |'|'|'|'|'|'|
                  '-._______.-'
                        ·
      \\\\\\                         //////
           >=======   S P Z   =======<
      //////                         \\\\\\
            ·           ★           ·

★ STARCHART ☠ SPZ · every dependency, code to cosmos · a Space Pirate Zero joint · Apache-2.0 · Repo · Issues

 ★ STARCHART
 ☠ a Space Pirate Zero joint

STARCHART Every dependency. Code to cosmos.

Guides

Concepts

Authoring

Code layer

Commands & API

Adapters & engine

Rules & analysis

Integrations

Project

Clone this wiki locally