fusion-cli 1.1.0__tar.gz → 1.2.0__tar.gz

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fusion-cli
-Version: 1.1.0
+Version: 1.2.0
 Summary: The Fusion reference CLI — the notary of the Fusion Convention.
 Author: Bluewaves Boutique
 License-Expression: MIT

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fusion-cli"
-version = "1.1.0"
+version = "1.2.0"
 description = "The Fusion reference CLI — the notary of the Fusion Convention."
 readme = "README.md"
 requires-python = ">=3.11"

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/skills/fusion-analyst/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: fusion-analyst
-description: "The Fusion analyst — deliverables out of the bucket. Four gears: report (multi-section analysis from library + activities — the default), assess (scored assessment with explicit criteria and scale), compare (side-by-side matrix with deltas and red flags), export (CSV/JSON/XLSX data extracts). Everything lands in output/ as a summary-first document, cites every source path in data_sources, and ships signed in the ledger. Use for 'report on', 'analyze and write up', 'brief', 'assess', 'evaluate', 'score', 'compare X and Y', 'export as csv/excel'. For searching without producing a deliverable use fusion-librarian's query; for new documents of record use fusion-librarian's create. Applies only inside a Fusion bucket — a directory tree with BUCKET.md and LEDGER.md at its root; if there is no such bucket in play, this skill does not apply."
+description: "The Fusion analyst — deliverables out of the bucket. Four gears: report (multi-section analysis from library + activities — the default), assess (scored assessment with explicit criteria and scale), compare (side-by-side matrix with deltas and red flags), export (CSV/JSON/XLSX data extracts). Everything lands in output/ as a summary-first document, cites every source path in data_sources, and ships signed in the ledger. Use for 'report on', 'analyze and write up', 'brief', 'assess', 'evaluate', 'score', 'compare X and Y', 'export as csv/excel'. For searching without producing a deliverable use fusion-librarian's query; for new documents of record use fusion-librarian's create. Applies only inside a Fusion bucket — a directory tree with BUCKET.md and LEDGER.md at its root; if there is no such bucket in play, offer to create one with `fusion new` instead of improvising structure."
 license: MIT
 compatibility: "Requires the fusion CLI on PATH; uv for the export script (PEP 723: openpyxl)."
 ---
@@ -13,8 +13,11 @@ document cites the exact paths it was built from, and ships with a
 
 Read `references/fusion-conventions.md` once per session; read
 `BUCKET.md ## Conventions` before acting. No `BUCKET.md` up the tree and
-none named? Stop — this is not a Fusion bucket, and no Fusion skill
-applies (`fusion hub` lists the real ones).
+none named? Then nothing here is a Fusion bucket and no Fusion skill
+applies — but offer the door instead of walking away: `fusion new
+<path>` scaffolds a conformant bucket and registers it in the hub
+(`fusion hub` lists the ones that exist). Buckets are life-domains —
+few and bold — never improvised by hand.
 
 ## Pick the gear
 

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/skills/fusion-analyst/references/fusion-conventions.md

@@ -107,6 +107,11 @@ shell. The ledger verbs (closed set of eleven): `created`, `converted`,
 `shipped`, `reflected`, `noted`. Sign with your agent name (`--as claude`,
 or set `FUSION_ACTOR`).
 
+On a bucket that lives on more than one machine, git's union driver
+(`.gitattributes`, written at bucket birth) merges parallel `LEDGER.md`
+and `MANIFEST.md` appends. After any git merge: `fusion index`, then
+`fusion check`.
+
 ## The CLI crib
 
 | Command | What it does |
@@ -116,6 +121,7 @@ or set `FUSION_ACTOR`).
 | `fusion log <verb> <object>` | append a signed ledger entry |
 | `fusion index` | regenerate INDEX files (logs `indexed` when changed) |
 | `fusion check [path]` | conformance: errors, warnings, honest exit codes |
+| `fusion check --hub` | is every registered bucket where the hub says? |
 | `fusion status [--since …]` | one bucket at a glance |
 | `fusion today` | the composed morning across all hub buckets |
 | `fusion agenda` | dated + active items across buckets |
@@ -127,8 +133,14 @@ green before you call the work done.**
 
 ## When you're blocked
 
+- No bucket in play anywhere: never improvise Fusion structure by hand.
+  Offer `fusion new <path> --kind <kind> --description "…"` — six zones,
+  BUCKET.md, an opened ledger, a merge-safe `.gitattributes`, registered
+  in the hub. Guide the human toward few, bold, life-domain buckets
+  (personal, one per company, a studio).
 - `fusion` not on PATH: stop and tell the human — the install is
-  `uv tool install ./fusion/cli` from a clone of the Fusion repository.
+  `uv tool install fusion-cli` (or, from a clone of the Fusion
+  repository, `uv tool install ./fusion/cli`).
   Never imitate the notary by hand: no register writes while the CLI is
   missing.
 - `fusion check` red and you cannot fix it: stop, show the findings

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/skills/fusion-intake/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: fusion-intake
-description: "The Fusion intake gate — everything that enters a bucket enters through it, losslessly. Classify what landed in inbox/ (new, updated, duplicate, conflicting), preserve the original in sources/ with its sha256 in the MANIFEST, convert to a faithful summary-first document (xlsx, csv, docx, pptx, pdf, html, images, .eml mail, markdown/text exports), propose type and aurora, sign the ledger, clear the inbox. Use when the user says 'process the inbox', 'intake', 'ingest', 'convert this file', or drops files into a Fusion bucket's inbox/. For placement, curation, or restructuring of what is already inside, use fusion-librarian; for deliverables out of the bucket, use fusion-analyst. Applies only inside a Fusion bucket — a directory tree with BUCKET.md and LEDGER.md at its root; if there is no such bucket in play, this skill does not apply."
+description: "The Fusion intake gate — everything that enters a bucket enters through it, losslessly. Classify what landed in inbox/ (new, updated, duplicate, conflicting), preserve the original in sources/ with its sha256 in the MANIFEST, convert to a faithful summary-first document (xlsx, csv, docx, pptx, pdf, html, images, .eml mail, markdown/text exports), propose type and aurora, sign the ledger, clear the inbox. Use when the user says 'process the inbox', 'intake', 'ingest', 'convert this file', or drops files into a Fusion bucket's inbox/. For placement, curation, or restructuring of what is already inside, use fusion-librarian; for deliverables out of the bucket, use fusion-analyst. Applies only inside a Fusion bucket — a directory tree with BUCKET.md and LEDGER.md at its root; if there is no such bucket in play, offer to create one with `fusion new` instead of improvising structure."
 license: MIT
 compatibility: "Requires the fusion CLI on PATH and uv. LibreOffice (soffice on PATH) required for docx/pptx/legacy office/html formats — fails fast when missing, never silently degrades. Script deps via PEP 723 (openpyxl, PyYAML, pymupdf)."
 ---
@@ -14,8 +14,11 @@ that isn't clean and new.
 Read `references/fusion-conventions.md` once per session. Then, before
 touching anything: read the bucket's `BUCKET.md` — `## Conventions` may
 contain filing rules and standing delegations that bind this whole run.
-No `BUCKET.md` up the tree and none named? Stop — this is not a Fusion
-bucket, and no Fusion skill applies (`fusion hub` lists the real ones).
+No `BUCKET.md` up the tree and none named? Then nothing here is a
+Fusion bucket and no Fusion skill applies — but offer the door instead
+of walking away: `fusion new <path>` scaffolds a conformant bucket and
+registers it in the hub (`fusion hub` lists the ones that exist).
+Buckets are life-domains — few and bold — never improvised by hand.
 
 ## The pipeline
 

{fusion_cli-1.1.0/skills/fusion-librarian → fusion_cli-1.2.0/skills/fusion-intake}/references/fusion-conventions.md

@@ -107,6 +107,11 @@ shell. The ledger verbs (closed set of eleven): `created`, `converted`,
 `shipped`, `reflected`, `noted`. Sign with your agent name (`--as claude`,
 or set `FUSION_ACTOR`).
 
+On a bucket that lives on more than one machine, git's union driver
+(`.gitattributes`, written at bucket birth) merges parallel `LEDGER.md`
+and `MANIFEST.md` appends. After any git merge: `fusion index`, then
+`fusion check`.
+
 ## The CLI crib
 
 | Command | What it does |
@@ -116,6 +121,7 @@ or set `FUSION_ACTOR`).
 | `fusion log <verb> <object>` | append a signed ledger entry |
 | `fusion index` | regenerate INDEX files (logs `indexed` when changed) |
 | `fusion check [path]` | conformance: errors, warnings, honest exit codes |
+| `fusion check --hub` | is every registered bucket where the hub says? |
 | `fusion status [--since …]` | one bucket at a glance |
 | `fusion today` | the composed morning across all hub buckets |
 | `fusion agenda` | dated + active items across buckets |
@@ -127,8 +133,14 @@ green before you call the work done.**
 
 ## When you're blocked
 
+- No bucket in play anywhere: never improvise Fusion structure by hand.
+  Offer `fusion new <path> --kind <kind> --description "…"` — six zones,
+  BUCKET.md, an opened ledger, a merge-safe `.gitattributes`, registered
+  in the hub. Guide the human toward few, bold, life-domain buckets
+  (personal, one per company, a studio).
 - `fusion` not on PATH: stop and tell the human — the install is
-  `uv tool install ./fusion/cli` from a clone of the Fusion repository.
+  `uv tool install fusion-cli` (or, from a clone of the Fusion
+  repository, `uv tool install ./fusion/cli`).
   Never imitate the notary by hand: no register writes while the CLI is
   missing.
 - `fusion check` red and you cannot fix it: stop, show the findings

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/skills/fusion-librarian/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: fusion-librarian
-description: "The Fusion librarian — the accountable owner of a bucket's order. One entry, eight gears: query (natural-language search over the bucket — the default), create (a new conformant document), tag (bulk frontmatter metadata), cross-reference (map what relates to what), promote (workbench → a real zone, validated), archive (out of the way, path + aurora agreeing), restructure (reorganize and sign your reasons), reflect (the reflection ritual: introspect the ledger, propose curation, land what was learned). Use for 'find', 'search', 'where is', 'create a document', 'tag', 'what links to', 'promote', 'archive this', 'reorganize', 'restructure', 'run a reflection'. For files arriving from outside use fusion-intake; for activity planning use fusion-planner; for reports and exports use fusion-analyst. Applies only inside a Fusion bucket — a directory tree with BUCKET.md and LEDGER.md at its root; if there is no such bucket in play, this skill does not apply."
+description: "The Fusion librarian — the accountable owner of a bucket's order. One entry, eight gears: query (natural-language search over the bucket — the default), create (a new conformant document), tag (bulk frontmatter metadata), cross-reference (map what relates to what), promote (workbench → a real zone, validated), archive (out of the way, path + aurora agreeing), restructure (reorganize and sign your reasons), reflect (the reflection ritual: introspect the ledger, propose curation, land what was learned). Use for 'find', 'search', 'where is', 'create a document', 'tag', 'what links to', 'promote', 'archive this', 'reorganize', 'restructure', 'run a reflection'. For files arriving from outside use fusion-intake; for activity planning use fusion-planner; for reports and exports use fusion-analyst. Applies only inside a Fusion bucket — a directory tree with BUCKET.md and LEDGER.md at its root; if there is no such bucket in play, offer to create one with `fusion new` instead of improvising structure."
 license: MIT
 compatibility: "Requires the fusion CLI on PATH."
 ---
@@ -14,8 +14,11 @@ ledger with its reasons.
 Read `references/fusion-conventions.md` once per session. Before any gear:
 read the bucket's `BUCKET.md` — `### Rules` bind how this bucket files
 things; `### Delegations` say what you may do without asking. No
-`BUCKET.md` up the tree and none named? Stop — this is not a Fusion
-bucket, and no Fusion skill applies (`fusion hub` lists the real ones).
+`BUCKET.md` up the tree and none named? Then nothing here is a Fusion
+bucket and no Fusion skill applies — but offer the door instead of
+walking away: `fusion new <path>` scaffolds a conformant bucket and
+registers it in the hub (`fusion hub` lists the ones that exist).
+Buckets are life-domains — few and bold — never improvised by hand.
 
 ## Pick the gear
 

{fusion_cli-1.1.0/skills/fusion-planner → fusion_cli-1.2.0/skills/fusion-librarian}/references/fusion-conventions.md

@@ -107,6 +107,11 @@ shell. The ledger verbs (closed set of eleven): `created`, `converted`,
 `shipped`, `reflected`, `noted`. Sign with your agent name (`--as claude`,
 or set `FUSION_ACTOR`).
 
+On a bucket that lives on more than one machine, git's union driver
+(`.gitattributes`, written at bucket birth) merges parallel `LEDGER.md`
+and `MANIFEST.md` appends. After any git merge: `fusion index`, then
+`fusion check`.
+
 ## The CLI crib
 
 | Command | What it does |
@@ -116,6 +121,7 @@ or set `FUSION_ACTOR`).
 | `fusion log <verb> <object>` | append a signed ledger entry |
 | `fusion index` | regenerate INDEX files (logs `indexed` when changed) |
 | `fusion check [path]` | conformance: errors, warnings, honest exit codes |
+| `fusion check --hub` | is every registered bucket where the hub says? |
 | `fusion status [--since …]` | one bucket at a glance |
 | `fusion today` | the composed morning across all hub buckets |
 | `fusion agenda` | dated + active items across buckets |
@@ -127,8 +133,14 @@ green before you call the work done.**
 
 ## When you're blocked
 
+- No bucket in play anywhere: never improvise Fusion structure by hand.
+  Offer `fusion new <path> --kind <kind> --description "…"` — six zones,
+  BUCKET.md, an opened ledger, a merge-safe `.gitattributes`, registered
+  in the hub. Guide the human toward few, bold, life-domain buckets
+  (personal, one per company, a studio).
 - `fusion` not on PATH: stop and tell the human — the install is
-  `uv tool install ./fusion/cli` from a clone of the Fusion repository.
+  `uv tool install fusion-cli` (or, from a clone of the Fusion
+  repository, `uv tool install ./fusion/cli`).
   Never imitate the notary by hand: no register writes while the CLI is
   missing.
 - `fusion check` red and you cannot fix it: stop, show the findings

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/skills/fusion-planner/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: fusion-planner
-description: "The Fusion planner — the horizon keeper. The human drives activities; the planner structures them. Three gears: create-activity (a new activity folder with a stateful plan document — works for plans, campaigns, programs, agendas alike), horizon (review what's live: stalled activities, expiring commitments, what fusion today will show tomorrow), close (finish an activity: status done, archived, out of the way). Use for 'new project/activity/campaign', 'plan this', 'what's on my plate', 'review my activities', 'what's stalled', 'agenda', 'close/finish this activity'. For placing knowledge use fusion-librarian; for deliverables use fusion-analyst. Applies only inside a Fusion bucket — a directory tree with BUCKET.md and LEDGER.md at its root; if there is no such bucket in play, this skill does not apply."
+description: "The Fusion planner — the horizon keeper. The human drives activities; the planner structures them. Three gears: create-activity (a new activity folder with a stateful plan document — works for plans, campaigns, programs, agendas alike), horizon (review what's live: stalled activities, expiring commitments, what fusion today will show tomorrow), close (finish an activity: status done, archived, out of the way). Use for 'new project/activity/campaign', 'plan this', 'what's on my plate', 'review my activities', 'what's stalled', 'agenda', 'close/finish this activity'. For placing knowledge use fusion-librarian; for deliverables use fusion-analyst. Applies only inside a Fusion bucket — a directory tree with BUCKET.md and LEDGER.md at its root; if there is no such bucket in play, offer to create one with `fusion new` instead of improvising structure."
 license: MIT
 compatibility: "Requires the fusion CLI on PATH."
 ---
@@ -13,8 +13,11 @@ composes tomorrow morning is this skill's report card.
 
 Read `references/fusion-conventions.md` once per session; read the
 bucket's `BUCKET.md ## Conventions` before acting. No `BUCKET.md` up the
-tree and none named? Stop — this is not a Fusion bucket, and no Fusion
-skill applies (`fusion hub` lists the real ones).
+tree and none named? Then nothing here is a Fusion bucket and no
+Fusion skill applies — but offer the door instead of walking away:
+`fusion new <path>` scaffolds a conformant bucket and registers it in
+the hub (`fusion hub` lists the ones that exist). Buckets are
+life-domains — few and bold — never improvised by hand.
 
 ## Pick the gear
 

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/skills/fusion-planner/references/create-activity.md

@@ -36,3 +36,24 @@
 4. `fusion log created "activities/<slug>/plan.md" --bucket <root>
    --as <you>` · `fusion index <root>` · `fusion check <root>` green.
    Then show the human what `fusion today` now includes.
+
+## The external project
+
+An activity about building something that is code — an app, a site, a
+tool — keeps the repository OUTSIDE the bucket (Fusion holds knowledge
+and work, never code). Point at it instead:
+
+    ---
+    title: <name>
+    type: plan
+    aurora: focus
+    status: active
+    created: <today>
+    resource: <path or URL of the repository>
+    ---
+
+The repo keeps its own history; the activity keeps what the code cannot
+remember — the plan, the decisions, the progress log, links to the
+bucket documents it draws on. The normative example:
+`examples/crazy-ones/activities/band-site/plan.md` in the Fusion
+repository.

{fusion_cli-1.1.0/skills/fusion-intake → fusion_cli-1.2.0/skills/fusion-planner}/references/fusion-conventions.md

@@ -107,6 +107,11 @@ shell. The ledger verbs (closed set of eleven): `created`, `converted`,
 `shipped`, `reflected`, `noted`. Sign with your agent name (`--as claude`,
 or set `FUSION_ACTOR`).
 
+On a bucket that lives on more than one machine, git's union driver
+(`.gitattributes`, written at bucket birth) merges parallel `LEDGER.md`
+and `MANIFEST.md` appends. After any git merge: `fusion index`, then
+`fusion check`.
+
 ## The CLI crib
 
 | Command | What it does |
@@ -116,6 +121,7 @@ or set `FUSION_ACTOR`).
 | `fusion log <verb> <object>` | append a signed ledger entry |
 | `fusion index` | regenerate INDEX files (logs `indexed` when changed) |
 | `fusion check [path]` | conformance: errors, warnings, honest exit codes |
+| `fusion check --hub` | is every registered bucket where the hub says? |
 | `fusion status [--since …]` | one bucket at a glance |
 | `fusion today` | the composed morning across all hub buckets |
 | `fusion agenda` | dated + active items across buckets |
@@ -127,8 +133,14 @@ green before you call the work done.**
 
 ## When you're blocked
 
+- No bucket in play anywhere: never improvise Fusion structure by hand.
+  Offer `fusion new <path> --kind <kind> --description "…"` — six zones,
+  BUCKET.md, an opened ledger, a merge-safe `.gitattributes`, registered
+  in the hub. Guide the human toward few, bold, life-domain buckets
+  (personal, one per company, a studio).
 - `fusion` not on PATH: stop and tell the human — the install is
-  `uv tool install ./fusion/cli` from a clone of the Fusion repository.
+  `uv tool install fusion-cli` (or, from a clone of the Fusion
+  repository, `uv tool install ./fusion/cli`).
   Never imitate the notary by hand: no register writes while the CLI is
   missing.
 - `fusion check` red and you cannot fix it: stop, show the findings

fusion_cli-1.2.0/src/fusion/__init__.py

@@ -0,0 +1,8 @@
+"""fusion — the reference CLI of the Fusion Convention."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("fusion-cli")
+except PackageNotFoundError:  # running from a checkout, not an install
+    __version__ = "0.0.0+dev"

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/src/fusion/checker.py

@@ -6,7 +6,7 @@ import time
 from dataclasses import dataclass
 from pathlib import Path
 
-from . import indexer, ledger, manifest
+from . import hub, indexer, ledger, manifest
 from .bucket import DOC_ZONES, REQUIRED_BUCKET_FIELDS, ZONES, load, iter_documents
 from .document import AURORAS, FILENAME_RE, MAX_STEM
 
@@ -19,7 +19,7 @@ EXPORT_FILENAME_RE = re.compile(r"^[a-z0-9]+(?:-[a-z0-9]+)*\.[a-z0-9]+$")
 @dataclass
 class Finding:
     level: str  # "error" | "warning"
-    code: str   # E1..E8, W1..W5
+    code: str   # E1..E8, W1..W5 — plus H1..H2 from check_hub (CLI vocabulary, not SPEC)
     path: str   # bucket-relative, "" when bucket-wide
     message: str
 
@@ -246,3 +246,30 @@ def _w5_untouched_activities(root: Path) -> list[Finding]:
             "active activity with no ledger mention across the last "
             "reflection window"))
     return findings
+
+
+def check_hub() -> list[Finding]:
+    """The hub's own audit — dangling entries and name drift.
+
+    H-codes are CLI vocabulary, not SPEC conformance codes: the hub is a
+    per-machine register and consumers must tolerate anything in it. All
+    findings are warnings; a hub audit never fails.
+    """
+    findings: list[Finding] = []
+    for entry in hub.load():
+        root = hub.resolve(entry)
+        if not (root / "BUCKET.md").is_file():
+            findings.append(Finding(
+                "warning", "H1", entry.path,
+                f"'{entry.name}' — no bucket at this path; clone it "
+                f"there, or `fusion hub remove {entry.name}`",
+            ))
+            continue
+        name = load(root).name
+        if name and name != entry.name:
+            findings.append(Finding(
+                "warning", "H2", entry.path,
+                f"hub says '{entry.name}' but BUCKET.md says '{name}' — "
+                "re-register: `fusion hub remove` then `fusion hub add`",
+            ))
+    return findings

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/src/fusion/cli.py

@@ -88,11 +88,20 @@ def cmd_hub(args) -> int:
               f"'{args.name}' retired from the hub. The files live on.")
         return 0
     entries = hub.load()
-    human = "\n".join(
-        f"- **{e.name}** · {e.kind} · {e.path} — {e.description}"
-        for e in entries
-    ) or "the hub is empty — `fusion new` a bucket."
-    _emit([asdict(e) for e in entries], args.json, human)
+    flagged = [
+        (e, not (hub.resolve(e) / "BUCKET.md").is_file()) for e in entries
+    ]
+    lines = []
+    for e, missing in flagged:
+        lines.append(f"- **{e.name}** · {e.kind} · {e.path} — {e.description}")
+        if missing:
+            lines.append(
+                f"  ⚠ no bucket at that path — clone it there, "
+                f"or `fusion hub remove {e.name}`"
+            )
+    human = "\n".join(lines) or "the hub is empty — `fusion new` a bucket."
+    _emit([{**asdict(e), "missing": missing} for e, missing in flagged],
+          args.json, human)
     return 0
 
 
@@ -140,12 +149,36 @@ def cmd_index(args) -> int:
     return 0
 
 
+def _check_hub(args) -> int:
+    findings = checker.check_hub()
+    entries = hub.load()
+    if args.json:
+        _emit({
+            "hub": str(hub.hub_path()),
+            "buckets": len(entries),
+            "ok": not findings,
+            "warnings": [asdict(f) for f in findings],
+        }, True, "")
+    else:
+        for f in findings:
+            print(f"  {f.code} · {f.path} — {f.message}")
+        n, w = len(entries), len(findings)
+        verdict = ("every bucket answers." if not findings
+                   else "some buckets are not where the hub says.")
+        print(f"hub: {n} bucket{'s' if n != 1 else ''} · "
+              f"{w} warning{'s' if w != 1 else ''} — {verdict}")
+    return 0
+
+
 def cmd_check(args) -> int:
+    if getattr(args, "hub", False):
+        return _check_hub(args)
     root = _root_from(args)
     if root is None:
         given = getattr(args, "path", None)
-        return _fail(f"no bucket at: {given}" if given else
-                     "not inside a bucket and no path given", args.json)
+        if given is None:
+            return _check_hub(args)  # outside any bucket: audit the hub
+        return _fail(f"no bucket at: {given}", args.json)
     findings = checker.check(root)
     errors = [f for f in findings if f.level == "error"]
     warnings = [f for f in findings if f.level == "warning"]
@@ -207,6 +240,12 @@ def _render_items(items) -> list[str]:
 
 def cmd_today(args) -> int:
     t = views.today()
+    for m in t["missing"]:
+        print(
+            f"note: hub bucket '{m['name']}' is not at {m['path']} — "
+            f"clone it there, or `fusion hub remove {m['name']}`",
+            file=sys.stderr,
+        )
     lines = [f"Today across {len(t['buckets'])} bucket"
              f"{'s' if len(t['buckets']) != 1 else ''}"]
     for aurora, items in t["groups"].items():
@@ -220,6 +259,12 @@ def cmd_today(args) -> int:
 
 def cmd_agenda(args) -> int:
     a = views.agenda()
+    for m in a["missing"]:
+        print(
+            f"note: hub bucket '{m['name']}' is not at {m['path']} — "
+            f"clone it there, or `fusion hub remove {m['name']}`",
+            file=sys.stderr,
+        )
     lines = []
     if a["dated"]:
         lines.append("dated:")
@@ -336,8 +381,10 @@ def build_parser() -> argparse.ArgumentParser:
     flag_as(p); flag_json(p)
     p.set_defaults(func=cmd_index)
 
-    p = sub.add_parser("check", help="audit a bucket against the convention", description="Audit a bucket against the convention (SPEC §11). Exit 1 on errors; warnings never fail the check.")
+    p = sub.add_parser("check", help="audit a bucket against the convention", description="Audit a bucket against the convention (SPEC §11). Exit 1 on errors; warnings never fail the check. --hub (or running outside any bucket) audits the hub instead: every registered bucket present and answering to its name.")
     p.add_argument("path", nargs="?", help="bucket root (default: walk up from the current directory)")
+    p.add_argument("--hub", action="store_true",
+                   help="audit the hub instead: every entry answers at its path")
     flag_json(p)
     p.set_defaults(func=cmd_check)
 

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/src/fusion/scaffold.py

@@ -43,6 +43,14 @@ MANIFEST_HEADER = (
     "|---|---|---|---|---|\n"
 )
 
+GITATTRIBUTES = (
+    "# written by fusion new — multi-machine merges stay safe (SPEC §6)\n"
+    "* text=auto eol=lf\n"
+    "sources/** -text\n"
+    "LEDGER.md merge=union\n"
+    "sources/MANIFEST.md merge=union\n"
+)
+
 
 class ScaffoldError(Exception):
     pass
@@ -85,6 +93,9 @@ def new_bucket(
     (root / "sources" / "MANIFEST.md").write_text(
         MANIFEST_HEADER, encoding="utf-8", newline="\n"
     )
+    (root / ".gitattributes").write_text(
+        GITATTRIBUTES, encoding="utf-8", newline="\n"
+    )
     ledger.append(root, actor, "created", "BUCKET.md", note="bucket born", at=at)
     indexer.write_indexes(root, actor=None)
 

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/src/fusion/views.py

@@ -62,6 +62,16 @@ def _hub_documents():
             yield name, zone, rel, doc
 
 
+def missing_hub_entries() -> list[dict]:
+    """Hub entries whose path holds no readable BUCKET.md — a bucket not
+    yet cloned to this machine, moved, or gone."""
+    return [
+        {"name": entry.name, "path": entry.path}
+        for entry in hub.load()
+        if not (hub.resolve(entry) / "BUCKET.md").is_file()
+    ]
+
+
 def _item(name: str, zone: str, rel, doc, date=None) -> dict:
     return {
         "bucket": name,
@@ -92,7 +102,7 @@ def today() -> dict:
     for aurora, items in groups.items():
         if aurora not in ordered:
             ordered[aurora] = items
-    return {"buckets": buckets, "groups": ordered}
+    return {"buckets": buckets, "groups": ordered, "missing": missing_hub_entries()}
 
 
 def agenda() -> dict:
@@ -108,4 +118,4 @@ def agenda() -> dict:
         elif zone == "activities" and doc.status == "active":
             active.append(_item(name, zone, rel, doc))
     dated.sort(key=lambda i: i["date"])
-    return {"dated": dated, "active": active}
+    return {"dated": dated, "active": active, "missing": missing_hub_entries()}

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/tests/test_checker_warnings.py

@@ -225,3 +225,33 @@ def test_w5_directory_mention_suppresses(make_bucket):
     from fusion import indexer
     indexer.write_indexes(root)
     assert not [f for f in warnings(root) if f.code == "W5"]
+
+
+def test_check_hub_dangling_and_drift(tmp_path, monkeypatch):
+    from fusion import checker, hub
+    from fusion.scaffold import new_bucket
+
+    monkeypatch.setenv("FUSION_HUB", str(tmp_path / "hub.md"))
+    new_bucket(tmp_path / "here", description="d", actor="test")
+    hub.add(hub.HubEntry("ghost", "personal", str(tmp_path / "gone"), "x"))
+    drifted, _ = new_bucket(tmp_path / "drift", name="oldname",
+                            description="d", actor="test")
+    text = (drifted / "BUCKET.md").read_text(encoding="utf-8")
+    (drifted / "BUCKET.md").write_text(
+        text.replace("name: oldname", "name: newname"), encoding="utf-8"
+    )
+    findings = checker.check_hub()
+    assert [(f.code, f.level) for f in findings] == [
+        ("H1", "warning"), ("H2", "warning")
+    ]
+    assert "ghost" in findings[0].message
+    assert "newname" in findings[1].message
+
+
+def test_check_hub_all_present_is_empty(tmp_path, monkeypatch):
+    from fusion import checker
+    from fusion.scaffold import new_bucket
+
+    monkeypatch.setenv("FUSION_HUB", str(tmp_path / "hub.md"))
+    new_bucket(tmp_path / "here", description="d", actor="test")
+    assert checker.check_hub() == []

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/tests/test_cli.py

@@ -89,11 +89,11 @@ def test_index_logs_when_changed(tmp_path, capsys):
 
 def test_status_today_agenda_json(fixture_bucket, capsys):
     assert main(["status", str(fixture_bucket), "--json"]) == 0
-    assert out_json(capsys)["documents"] == 6
+    assert out_json(capsys)["documents"] == 7
     assert main(["today", "--json"]) == 0
     assert out_json(capsys)["groups"] == {}  # empty hub, empty day
     assert main(["agenda", "--json"]) == 0
-    assert out_json(capsys) == {"dated": [], "active": []}
+    assert out_json(capsys) == {"dated": [], "active": [], "missing": []}
 
 
 def test_every_command_has_help(capsys):
@@ -223,3 +223,43 @@ def test_parent_listing_has_one_liners(capsys):
     output = capsys.readouterr().out
     for cmd, oneliner in hub_sub_help.items():
         assert oneliner in output, f"Hub subcommand help missing for '{cmd}': '{oneliner}'"
+
+
+def test_hub_list_flags_missing(tmp_path, capsys, monkeypatch):
+    from fusion import hub
+
+    monkeypatch.setenv("FUSION_HUB", str(tmp_path / "hub.md"))
+    hub.add(hub.HubEntry("ghost", "personal", str(tmp_path / "gone"), "x"))
+    assert main(["hub"]) == 0
+    out = capsys.readouterr().out
+    assert "ghost" in out and "fusion hub remove ghost" in out
+    assert main(["hub", "--json"]) == 0
+    assert out_json(capsys)[0]["missing"] is True
+
+
+def test_check_hub_mode(tmp_path, capsys, monkeypatch):
+    from fusion import hub
+
+    monkeypatch.setenv("FUSION_HUB", str(tmp_path / "hub.md"))
+    hub.add(hub.HubEntry("ghost", "personal", str(tmp_path / "gone"), "x"))
+    assert main(["check", "--hub", "--json"]) == 0  # warnings never fail
+    payload = out_json(capsys)
+    assert payload["ok"] is False
+    assert payload["warnings"][0]["code"] == "H1"
+    # outside any bucket, path-less check falls back to the hub audit
+    monkeypatch.chdir(tmp_path)
+    assert main(["check"]) == 0
+    assert "H1" in capsys.readouterr().out
+
+
+def test_today_agenda_note_missing_buckets(tmp_path, capsys, monkeypatch):
+    from fusion import hub
+
+    monkeypatch.setenv("FUSION_HUB", str(tmp_path / "hub.md"))
+    hub.add(hub.HubEntry("ghost", "personal", str(tmp_path / "gone"), "x"))
+    assert main(["today"]) == 0
+    assert "ghost" in capsys.readouterr().err
+    assert main(["agenda", "--json"]) == 0
+    captured = capsys.readouterr()
+    assert "ghost" in captured.err
+    assert json.loads(captured.out)["missing"][0]["name"] == "ghost"

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/tests/test_hub_bucket.py

@@ -79,10 +79,10 @@ def test_load_bucket(fixture_bucket):
 
 def test_iter_documents_fixture(fixture_bucket):
     docs = list(bucket.iter_documents(fixture_bucket))
-    assert len(docs) == 6
+    assert len(docs) == 7
     from collections import Counter
     zone_counts = Counter(zone for zone, _, _ in docs)
-    assert zone_counts == {"library": 3, "activities": 2, "output": 1}
+    assert zone_counts == {"library": 3, "activities": 3, "output": 1}
     names = {rel.name for _, rel, _ in docs}
     assert "INDEX.md" not in names
     # yields (zone, path relative to the zone, Document)

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/tests/test_ledger.py

@@ -15,7 +15,7 @@ def test_verbs_are_the_eleven_verbatim():
 
 def test_parse_fixture(fixture_bucket):
     entries = ledger.read(fixture_bucket)
-    assert len(entries) == 17
+    assert len(entries) == 19
     first = entries[0]
     assert (first.date, first.time, first.actor, first.verb) == (
         "2026-07-08", "09:00", "bertrand", "created"

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/tests/test_roundtrip.py

@@ -63,4 +63,4 @@ def test_round_trip(tmp_path, capsys):
     today = out_json(capsys)
     assert today["buckets"] == ["scratch"]
     assert main(["agenda", "--json"]) == 0
-    assert out_json(capsys) == {"dated": [], "active": []}
+    assert out_json(capsys) == {"dated": [], "active": [], "missing": []}

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/tests/test_scaffold.py

@@ -107,3 +107,13 @@ def test_hub_failure_is_a_warning_not_an_error(tmp_path, monkeypatch):
     root, warnings = new_bucket(tmp_path / "b", description="d", actor="c")
     assert root.exists()
     assert any("hub registration failed" in w for w in warnings)
+
+
+def test_new_bucket_writes_gitattributes(tmp_path):
+    root, _ = new_bucket(tmp_path / "b", description="d", actor="test")
+    text = (root / ".gitattributes").read_text(encoding="utf-8")
+    assert "LEDGER.md merge=union" in text
+    assert "sources/MANIFEST.md merge=union" in text
+    assert "* text=auto eol=lf" in text
+    assert "sources/** -text" in text
+    assert "\r" not in text

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/tests/test_views.py

@@ -7,17 +7,17 @@ from fusion.ledger import Entry
 def test_status_fixture(fixture_bucket):
     s = views.status(fixture_bucket)
     assert s["bucket"] == "crazy-ones"
-    assert s["documents"] == 6
-    assert s["auroras"] == {"archive": 1, "collab": 1, "focus": 1, "library": 3}
-    assert s["types"] == {"instrument": 2, "plan": 2, "press-kit": 1, "recipe": 1}
-    assert s["activities"] == {"active": 1, "done": 1}
-    assert len(s["ledger"]) == 10  # last ten of seventeen
+    assert s["documents"] == 7
+    assert s["auroras"] == {"archive": 1, "collab": 1, "focus": 2, "library": 3}
+    assert s["types"] == {"instrument": 2, "plan": 3, "press-kit": 1, "recipe": 1}
+    assert s["activities"] == {"active": 2, "done": 1}
+    assert len(s["ledger"]) == 10  # last ten of nineteen
     assert s["ledger"][-1]["verb"] == "reflected"
 
 
 def test_status_since_date(fixture_bucket):
     s = views.status(fixture_bucket, since="2026-07-10")
-    assert len(s["ledger"]) == 5
+    assert len(s["ledger"]) == 7
     assert all(e["date"] == "2026-07-10" for e in s["ledger"])
 
 
@@ -106,7 +106,11 @@ def test_today_skips_hub_entries_without_bucket(tmp_path, monkeypatch):
 
     monkeypatch.setenv("FUSION_HUB", str(tmp_path / "hub.md"))
     hub.add(hub.HubEntry("ghost", "personal", str(tmp_path / "gone"), "missing"))
-    assert views.today()["buckets"] == []
+    t = views.today()
+    assert t["buckets"] == []
+    assert t["missing"] == [
+        {"name": "ghost", "path": str(tmp_path / "gone")}
+    ]
 
 
 def test_views_exclude_archive_aurora_off_archive_paths(two_bucket_hub):

{fusion_cli-1.1.0 → fusion_cli-1.2.0}/uv.lock

@@ -13,7 +13,7 @@ wheels = [
 
 [[package]]
 name = "fusion-cli"
-version = "1.1.0"
+version = "1.2.0"
 source = { editable = "." }
 dependencies = [
     { name = "pyyaml" },

fusion_cli-1.1.0/src/fusion/__init__.py

@@ -1,3 +0,0 @@
-"""fusion — the reference CLI of the Fusion Convention."""
-
-__version__ = "1.0.0"