Simplify fingerprint package shape#168
Merged
Merged
Conversation
Resolve conflicts after main's monorepo initializer refactor: - scan/index.ts: keep signals rename + main's monorepo exports - README.md, cli-reference.mdx: combine signals/flat-checks copy with monorepo init docs; drop removed --with-intent examples - fingerprint-commands.ts: adopt main's registerInitCommand extraction - pack-release-tarball.mjs: take main's superset dependency resolver - cli-manifest.json: regenerate - Reconcile main's new init-command.ts/monorepo-init-command.ts with the removed memory/intent shape (flat fingerprint/checks.yml)
Merged
nahiyankhan
added a commit
that referenced
this pull request
Jun 24, 2026
…-shape Simplify fingerprint package shape
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Category: improvement
User Impact: Ghost users get a smaller, clearer fingerprint package with raw repo signals separated from curated inventory and deterministic checks flattened to
fingerprint/checks.yml.Problem: The canonical package shape still carried optional memory/cache support and a confusing
ghost inventorycommand, which blurred durable fingerprint layers with agent reconnaissance. Checks also lived underfingerprint/enforcement/checks.yml, adding a folder level for behavior that is validation support rather than a separate package surface.Solution: Remove memory/cache package support, rename
ghost inventorytoghost signals, and make checks a flat optional package file atfingerprint/checks.yml. Update docs, the skill bundle, dogfood fingerprints, generated CLI metadata, and tests around the simplified shape.Validation:
pnpm build: passedpnpm test: passed, 36 files / 387 testspnpm check: passedpnpm dump:cli-help --check: passedpnpm checkand format checkspnpm build,pnpm test, andpnpm checkChangeset: added major changeset in
.changeset/quiet-signals-major.mdbecause this removes/renames public CLI behavior and package fields, and moves checks tofingerprint/checks.yml.Ghost Review:
node packages/ghost/dist/bin.js check --base origin/main: passed with no active deterministic check failuresnode packages/ghost/dist/bin.js review --base origin/main: ran successfully; advisory packet emitted, diff was truncated at the default--max-diff-bytesbudgetFile changes
.changeset/quiet-signals-major.md
Adds the major release note for the breaking package-shape and CLI changes.
.ghost/fingerprint/checks.yml
Moves the dogfood checks file from
fingerprint/enforcement/checks.ymlto the flat package path..ghost/fingerprint/composition.yml
Updates dogfood composition guidance around flat checks and removed cache support.
.ghost/fingerprint/inventory.yml
Removes generated-cache source references and updates refs to the new signals framing.
.ghost/fingerprint/memory/intent.md
Deletes removed optional memory support from the dogfood package.
.ghost/fingerprint/prose.yml
Updates dogfood prose to describe raw signals, flat checks, and removed memory/cache support.
.ghost/fingerprint/sources/cache/.gitkeep
Deletes removed generated-cache package convention.
CLAUDE.md
Updates project docs for the new package shape and
ghost signalscommand.README.md
Updates public package shape, authoring flow, command table, and review examples.
apps/docs/src/app/page.tsx
Updates docs homepage copy to remove cache/memory and show flat checks.
apps/docs/src/content/docs/cli-reference.mdx
Updates CLI docs for
signals, removed flags, and flat checks path.apps/docs/src/content/docs/fingerprint-authoring.mdx
Refreshes authoring guidance around raw signals and simplified package layers.
apps/docs/src/content/docs/getting-started.mdx
Updates getting-started package tree and support-material explanation.
apps/docs/src/generated/cli-manifest.json
Regenerates CLI help metadata after command/flag/path changes.
docs/fingerprint-format.md
Documents the simplified fingerprint package format and flat
checks.yml.docs/generation-loop.md
Updates generation/review commands and removes generated-cache/memory references.
docs/host-adapters.md
Updates adapter guidance for raw signals and flat checks.
docs/ideas/fingerprint-first-architecture.md
Aligns architecture notes with
signalsandchecks.yml.docs/language-fingerprints.md
Updates language-check examples to use
fingerprint/checks.yml.packages/ghost-core/src/fingerprint-package.ts
Removes canonical memory/cache/enforcement path constants from the private package path model.
packages/ghost-core/src/index.ts
Removes now-deleted memory exports and enforcement path exports.
packages/ghost-core/src/memory/index.ts
Deletes removed memory package support.
packages/ghost-core/src/memory/lint.ts
Deletes removed memory decision lint support.
packages/ghost-core/src/memory/schema.ts
Deletes removed memory decision schema support.
packages/ghost-core/src/memory/types.ts
Deletes removed memory decision types.
packages/ghost-core/test/memory.test.ts
Deletes tests for removed memory decision package support.
packages/ghost-ui/.ghost/fingerprint/checks.yml
Moves the Ghost UI dogfood checks file to the flat path.
packages/ghost-ui/.ghost/fingerprint/inventory.yml
Removes generated-cache source references from Ghost UI dogfood inventory.
packages/ghost-ui/.ghost/fingerprint/sources/cache/.gitkeep
Deletes removed generated-cache placeholder.
packages/ghost/README.md
Updates package README for
signals, flat checks, and removed memory/cache support.packages/ghost/src/cli.ts
Removes
review --include-memoryplumbing.packages/ghost/src/command-discovery.ts
Renames command discovery metadata from
inventorytosignalsand removes cache wording.packages/ghost/src/context/entrypoint-markdown.ts
Removes the generated cache section from Relay/context markdown.
packages/ghost/src/context/entrypoint.ts
Updates suggested reads and selected context paths to flat
fingerprint/checks.yml.packages/ghost/src/context/graph.ts
Updates check source-file metadata to
fingerprint/checks.yml.packages/ghost/src/context/package-context.ts
Removes cache/intent loading from package context and reads flat checks.
packages/ghost/src/context/package-review-command.ts
Updates emitted review command copy for flat checks and no memory/cache support.
packages/ghost/src/fingerprint-commands.ts
Removes
init --with-intent, addssignals, resolves flat checks, and updates scan/init output.packages/ghost/src/fingerprint.ts
Removes removed constants from public fingerprint exports.
packages/ghost/src/ghost-core/fingerprint-package.ts
Updates bundled core package path constants for the simplified shape.
packages/ghost/src/ghost-core/fingerprint/schema.ts
Removes
cacheas an inventory source kind.packages/ghost/src/ghost-core/fingerprint/types.ts
Removes
cachefrom inventory source kind typing.packages/ghost/src/ghost-core/index.ts
Removes memory/enforcement exports from bundled core.
packages/ghost/src/ghost-core/memory/index.ts
Deletes removed bundled memory package support.
packages/ghost/src/ghost-core/memory/lint.ts
Deletes removed bundled memory lint support.
packages/ghost/src/ghost-core/memory/schema.ts
Deletes removed bundled memory schema support.
packages/ghost/src/ghost-core/memory/types.ts
Deletes removed bundled memory types.
packages/ghost/src/review-packet.ts
Removes packet
intent/accepted_decisionshandling and memory markdown sections.packages/ghost/src/scan-stack-command.ts
Removes stack output fields for removed memory decisions.
packages/ghost/src/scan/constants.ts
Removes memory/cache/enforcement constants from scan constants.
packages/ghost/src/scan/fingerprint-package-layers.ts
Removes template support for optional memory intent.
packages/ghost/src/scan/fingerprint-package.ts
Simplifies package path resolution, initialization, linting, and flat checks resolution.
packages/ghost/src/scan/fingerprint-stack.ts
Removes stack memory/cache/decision merge support and updates check merge diagnostics.
packages/ghost/src/scan/index.ts
Exports
signalsinstead ofinventoryand drops removed constants.packages/ghost/src/scan/inventory.ts
Renames the raw repo-signal API export to
signals.packages/ghost/src/scan/scan-status.ts
Removes scan
intentandcachestatus fields.packages/ghost/src/scan/verify-package.ts
Updates check verification diagnostics to
fingerprint/checks.yml.packages/ghost/src/skill-bundle/SKILL.md
Updates skill instructions for the simplified package shape and
signals.packages/ghost/src/skill-bundle/references/authoring-scenarios.md
Updates authoring scenarios for raw signals and removed memory/cache support.
packages/ghost/src/skill-bundle/references/brief.md
Removes cache/memory guidance from briefing workflow.
packages/ghost/src/skill-bundle/references/capture.md
Updates capture workflow for
signalsand flat checks.packages/ghost/src/skill-bundle/references/critique.md
Updates critique guidance for
missing-fingerprintand no memory fields.packages/ghost/src/skill-bundle/references/patterns.md
Updates pattern guidance for flat checks and raw signals.
packages/ghost/src/skill-bundle/references/recall.md
Removes memory accepted-decision context from recall workflow.
packages/ghost/src/skill-bundle/references/review.md
Updates review workflow for flat checks and removed memory packet fields.
packages/ghost/src/skill-bundle/references/schema.md
Updates package schema reference for flat
checks.yml.packages/ghost/src/skill-bundle/references/verify.md
Updates verification guidance after removed optional rationale files.
packages/ghost/src/skill-bundle/references/voice.md
Updates language check example path to
fingerprint/checks.yml.packages/ghost/test/cli.test.ts
Updates CLI coverage for
signals, removed flags, flat checks, scan fields, and review packet fields.packages/ghost/test/context-entrypoint.test.ts
Updates context expectations after generated-cache removal.
packages/ghost/test/fingerprint-package.test.ts
Updates package lint tests for removed
cachesource kind and simplified sources.packages/ghost/test/fingerprint-stack.test.ts
Updates stack tests for removed memory decisions and flat checks.
packages/ghost/test/fixtures/context-sandboxes/harness.ts
Updates sandbox package fixture generation to flat checks and no cache helper.
packages/ghost/test/public-exports.test.ts
Updates public export expectations from
inventorytosignals.packages/ghost/test/relay.test.ts
Updates Relay fixture usage after cache removal.
packages/ghost/test/scan-status.test.ts
Updates scan readiness expectations after removing cache/intent fields.
scripts/pack-release-tarball.mjs
Allows release tarball packaging to resolve runtime dependencies from hoisted root
node_modulesas well as package-local links.Screenshots/Demos: N/A