Skip to content

Simplify fingerprint package shape#168

Merged
nahiyankhan merged 2 commits into
mainfrom
codex/simplify-fingerprint-package-shape
Jun 23, 2026
Merged

Simplify fingerprint package shape#168
nahiyankhan merged 2 commits into
mainfrom
codex/simplify-fingerprint-package-shape

Conversation

@nahiyankhan

Copy link
Copy Markdown
Collaborator

♻️ Recreated from #163, which GitHub auto-closed during a repository history rewrite (dogfood removal). Same branch, same commit, same work — no changes lost.


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 inventory command, which blurred durable fingerprint layers with agent reconnaissance. Checks also lived under fingerprint/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 inventory to ghost signals, and make checks a flat optional package file at fingerprint/checks.yml. Update docs, the skill bundle, dogfood fingerprints, generated CLI metadata, and tests around the simplified shape.

Validation:

  • pnpm build: passed
  • pnpm test: passed, 36 files / 387 tests
  • pnpm check: passed
  • pnpm dump:cli-help --check: passed
  • pre-commit hook: passed pnpm check and format checks
  • pre-push hook: passed pnpm build, pnpm test, and pnpm check

Changeset: added major changeset in .changeset/quiet-signals-major.md because this removes/renames public CLI behavior and package fields, and moves checks to fingerprint/checks.yml.

Ghost Review:

  • node packages/ghost/dist/bin.js check --base origin/main: passed with no active deterministic check failures
  • node packages/ghost/dist/bin.js review --base origin/main: ran successfully; advisory packet emitted, diff was truncated at the default --max-diff-bytes budget
File 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.yml to 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 signals command.

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 signals and checks.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-memory plumbing.

packages/ghost/src/command-discovery.ts
Renames command discovery metadata from inventory to signals and 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, adds signals, 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 cache as an inventory source kind.

packages/ghost/src/ghost-core/fingerprint/types.ts
Removes cache from 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_decisions handling 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 signals instead of inventory and 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 intent and cache status 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 signals and flat checks.

packages/ghost/src/skill-bundle/references/critique.md
Updates critique guidance for missing-fingerprint and 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 cache source 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 inventory to signals.

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_modules as well as package-local links.

Screenshots/Demos: N/A

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)
@nahiyankhan nahiyankhan merged commit b1f7625 into main Jun 23, 2026
4 checks passed
@github-actions github-actions Bot mentioned this pull request Jun 23, 2026
nahiyankhan added a commit that referenced this pull request Jun 24, 2026
…-shape

Simplify fingerprint package shape
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant