@design-intelligence/ghost 0.0.0-next-20260715121453

package/dist/skill-bundle/references/self-check.md

@@ -0,0 +1,65 @@
+---
+name: self-check
+description: A pre-generation probe that reveals whether you have actually gathered and reasoned about the brand fingerprint, before you build.
+---
+
+# Recipe: Self-Check Before Generating
+
+Before writing UI, copy, email, or any output, check whether you are grounded in
+the fingerprint or about to fall back on generic instincts. These questions test
+your **grounding and provenance**, not the fingerprint's contents, so they hold
+for any fingerprint, however sparse, whatever the medium, whoever authored it.
+
+Ask yourself:
+
+1. **What did you gather?** Which Ghost nodes did you pull for this task (from
+   `ghost gather`), and can you cite them by id? If you have not gathered, you
+   are not grounded. Gather first.
+2. **What is Ghost-backed vs. provisional?** For each claim you are about to
+   encode, is it backed by a gathered node (cite the id), or is it your own
+   provisional local reasoning? You must be able to label every claim as one or
+   the other.
+3. **Do the conditions apply?** For each conditional truth you pulled, does its
+   stated situation actually hold for this task? For each kind with conditional
+   or scoped meaning **per the glossary**, apply it only when its stated
+   situation holds; do not apply it where it does not, and do not ignore it
+   where it does.
+4. **Where is the fingerprint silent?** What does the fingerprint not cover for
+   your task, and what will carry the reasoning in those gaps? Naming the silence
+   is part of being grounded; pretending coverage you do not have is not.
+
+## Steering readiness
+
+Before generating, can you cite:
+
+- the governing principle, stance, or tradeoff?
+- the concrete materials, if exactness matters?
+- the applicable pattern, if structure matters?
+- the relevant exemplar and what it is normative for?
+- the anti-goal that blocks the generic version?
+- the hard invariants?
+- the conditions that apply or do not apply?
+- any decision trace for ambiguous tradeoffs?
+- where the fingerprint is silent?
+
+Classify readiness:
+
+- **Green:** enough Ghost-backed guidance and concrete material for this surface
+  to generate.
+- **Yellow:** generation is safe, but some reasoning must be labeled
+  provisional; if there is no concrete material for this surface, readiness is
+  at most Yellow.
+- **Red:** missing brand-defining, high-risk, or irreversible guidance; ask a
+  human or author a node first.
+
+When you cannot answer the grounding questions:
+
+1. Run `ghost gather <ask>` to emit the menu for the actual task, then match the
+   work to nodes by their descriptions.
+2. Read the selected nodes' bodies and re-ask the questions, citing node ids.
+
+A genuinely silent fingerprint is an expected state, not a blocker. When it does
+not cover the task, say so plainly and proceed with provisional local reasoning
+when safe; label it non-Ghost-backed. If the fingerprint's cover declares a stricter
+silence posture, honor it over this default. Ask a human before
+high-risk or brand-defining choices.

package/dist/skill-bundle/references/steering-audit.md

@@ -0,0 +1,60 @@
+---
+name: steering-audit
+description: Audit a Ghost fingerprint for concrete steering coverage.
+---
+
+# Recipe: Audit Steering Coverage
+
+A steering audit asks whether a fingerprint can move generation away from the
+generic median. It is not a validation pass; `ghost validate` handles package
+shape.
+
+Start with:
+
+```bash
+ghost validate
+ghost gather --format json
+ghost pulse --format json
+```
+
+If checks are installed and a diff exists, run `ghost review` too.
+
+## Headline the audit with concreteness
+
+Report first:
+
+- **Concreteness coverage:** total nodes, concrete-material nodes, prose-only
+  nodes. Concrete means non-empty `materials`, a fenced code block of at least 3
+  lines, or a `## Skeleton` section. `ghost gather` also breaks out materials,
+  substantial fenced examples, and Skeletons as payload labels.
+- **Pulse by concreteness:** concrete-material exposure/pull rate vs prose-only
+  exposure/pull rate. In markdown this is the `Concrete material` row. This is
+  the tuning instrument: if concrete nodes are not pulled when applicable,
+  descriptions or task selection are failing.
+
+## Corpus-level table
+
+| Row | Status | Evidence | Next move |
+| --- | --- | --- | --- |
+| Retrieval | strong / weak | descriptions, ids, cover | sharpen descriptions or move universal truth to the cover |
+| Concreteness | strong / thin | materials, fenced examples, Skeletons | add concrete locators, exemplars, or opening structures |
+| Anti-goals | present / missing / vague | `anti-goal.*`, review packet | write not-X-instead-Y replacements and material locators |
+| Consistency | clean / conflicting | concrete bodies vs rules | update stale examples; examples average with rules |
+| Stance | present / missing | cover, `principle.*` | write forced-choice principles |
+| Materials | present / missing | `materials`, inspect-pointers | point at real assets/components/tokens |
+| Exemplars | annotated / unannotated / missing | fenced samples, screenshots | say what to copy and what is incidental |
+| Patterns | bound-open / loose / missing | `pattern.*`, Skeletons | state applies / bound / open and add a Skeleton when opening structure matters |
+| Checks | covered / partial / missing | checks/, probes, review packet | add checks/probes for high-risk invariants |
+| Silence posture | defined / missing | cover | say when to proceed provisionally or ask |
+
+## Task-level readiness
+
+For a task, gather, pull, and report:
+
+- **Green:** enough Ghost-backed concrete guidance to generate.
+- **Yellow:** safe to generate, but some reasoning is provisional. If there is
+  no concrete material for this surface, readiness is at most Yellow.
+- **Red:** missing brand-defining, high-risk, irreversible, legal, privacy, or
+  security guidance; ask or author first.
+
+Never present steering coverage as deterministic pass/fail.

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@design-intelligence/ghost",
+  "version": "0.0.0-next-20260715121453",
+  "description": "Ghost CLI for the brand fingerprint: a portable steering packet of prose truths your agent reads before it builds, with advisory review after",
+  "license": "Apache-2.0",
+  "author": "Block, Inc.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/block/ghost.git"
+  },
+  "homepage": "https://github.com/block/ghost#readme",
+  "bugs": {
+    "url": "https://github.com/block/ghost/issues"
+  },
+  "keywords": [
+    "fingerprint",
+    "product-surface",
+    "surface-composition",
+    "design-system",
+    "design-tokens",
+    "shadcn",
+    "design-language",
+    "cli"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "ghost": "./dist/bin.js",
+    "ghost-fingerprint": "./dist/bin.js"
+  },
+  "imports": {
+    "#ghost-core": {
+      "types": "./src/ghost-core/index.ts",
+      "import": "./dist/ghost-core/index.js"
+    },
+    "#scan": {
+      "types": "./src/scan/index.ts",
+      "import": "./dist/scan/index.js"
+    }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/ghost-core/index.d.ts",
+      "import": "./dist/ghost-core/index.js"
+    },
+    "./fingerprint": {
+      "types": "./dist/fingerprint.d.ts",
+      "import": "./dist/fingerprint.js"
+    },
+    "./scan": {
+      "types": "./dist/scan/index.d.ts",
+      "import": "./dist/scan/index.js"
+    },
+    "./cli": {
+      "types": "./dist/cli.d.ts",
+      "import": "./dist/cli.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "cac": "^6.7.14",
+    "yaml": "^2.8.3",
+    "zod": "^4.3.6"
+  },
+  "scripts": {
+    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc --build --force && chmod +x dist/bin.js && node ../../scripts/link-package-bin.mjs && cp -r src/skill-bundle dist/skill-bundle && node ../../scripts/sync-init-payloads.mjs"
+  }
+}