Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/described-nodes.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@anarchitecture/ghost": minor
---

Make `description` a first-class node field — the retrieval payload an agent matches a task against, the way a tool is selected by name + description. `ghost gather` with no argument now lists nodes by id + description (the catalog), built from the graph rather than a separate surface menu. Node frontmatter is now passthrough: free-form descriptive keys (`audience`, `stage`, …) are allowed and ride along untouched. The surface composition-edge vocabulary (`composes`/`governed-by`) is removed — lateral composition lives on node `relates`; `surfaces.yml` is now an optional terse spine file (id + parent + optional description) that folds into the node id space, not a distinct content concept.
5 changes: 5 additions & 0 deletions .changeset/drop-dead-deps.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@anarchitecture/ghost": patch
---

Drop two unused runtime dependencies (`jiti`, `tinyglobby`) — neither was imported anywhere in source. Ghost now ships three runtime deps (`cac`, `yaml`, `zod`), shrinking the install footprint by ~1.8 MB. Also fix the build to clear `tsconfig.tsbuildinfo` so `dist/` no longer retains deleted modules from incremental builds (the packed package drops from ~1.9 MB / 777 files to ~397 KB / 248 files).
2 changes: 1 addition & 1 deletion apps/docs/src/generated/cli-manifest.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
{
"generatedAt": "2026-06-28T03:43:13.793Z",
"generatedAt": "2026-06-28T13:42:06.396Z",
"tools": [
{
"tool": "ghost",
Expand Down
233 changes: 37 additions & 196 deletions docs/ideas/README.md

Large diffs are not rendered by default.

10 changes: 5 additions & 5 deletions docs/ideas/context-graph.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,11 +4,11 @@ status: exploring

# The context graph: Ghost as a curated, opinionated graph for generation

This note records a shift in how we frame Ghost's model. It is downstream of
`one-road.md` (remove the binding + nesting) and `contract-storage.md`
(facet-first vs surface-first storage), and it reframes both: the real shape of
the problem is a **curated, opinionated context graph**, and the right context
for an agent to generate an interaction is found by **traversing** it.
This note records the shift in how we frame Ghost's model: the real shape of the
problem is a **curated, opinionated context graph**, and the right context for an
agent to generate an interaction is found by **traversing** it. (It grew out of
two earlier explorations — removing the path binding/nesting, and the
storage-layout fork — both now shipped or subsumed; see git history.)

It composes with the build order already set: **one-road first**, storage and
anything here after. Nothing here is committed to code.
Expand Down
212 changes: 0 additions & 212 deletions docs/ideas/contract-and-binding.md

This file was deleted.

Loading