fusion-cli 1.1.0__py3-none-any.whl

fusion/views.py

@@ -0,0 +1,111 @@
+"""fusion status / today / agenda — the composed day (design spec §5)."""
+from __future__ import annotations
+
+from collections import Counter
+from dataclasses import asdict
+from pathlib import Path
+
+from . import bucket, hub, ledger
+from .document import AURORAS
+
+
+def filter_since(entries: list[ledger.Entry], since: str | None):
+    if not since:
+        return entries
+    if since == "last-reflection":
+        last = max(
+            (i for i, e in enumerate(entries) if e.verb == "reflected"),
+            default=None,
+        )
+        return entries if last is None else entries[last + 1 :]
+    return [e for e in entries if e.date >= since]
+
+
+def status(root: Path, since: str | None = None) -> dict:
+    b = bucket.load(root)
+    auroras: Counter = Counter()
+    types: Counter = Counter()
+    activities: Counter = Counter()
+    total = 0
+    for zone, rel, doc in bucket.iter_documents(root):
+        total += 1
+        auroras[doc.aurora or "—"] += 1
+        types[doc.type or "—"] += 1
+        if zone == "activities":
+            activities[doc.status or "unset"] += 1
+    entries = filter_since(ledger.read(root), since)
+    return {
+        "bucket": b.name or root.name,
+        "documents": total,
+        "auroras": dict(sorted(auroras.items())),
+        "types": dict(sorted(types.items())),
+        "activities": dict(sorted(activities.items())),
+        "ledger": [asdict(e) for e in entries[-10:]],
+    }
+
+
+def _hub_buckets():
+    """Yield (bucket_name, root) for every readable hub bucket — read means
+    a BUCKET.md exists, not that the bucket holds any documents yet."""
+    for entry in hub.load():
+        root = hub.resolve(entry)
+        if not (root / "BUCKET.md").is_file():
+            continue
+        b = bucket.load(root)
+        yield (b.name or entry.name), root
+
+
+def _hub_documents():
+    """Yield (bucket_name, zone, rel, doc) across every readable hub bucket."""
+    for name, root in _hub_buckets():
+        for zone, rel, doc in bucket.iter_documents(root):
+            yield name, zone, rel, doc
+
+
+def _item(name: str, zone: str, rel, doc, date=None) -> dict:
+    return {
+        "bucket": name,
+        "title": doc.title or rel.stem,
+        "path": f"{zone}/{rel.as_posix()}",
+        "type": doc.type,
+        "aurora": doc.aurora,
+        "status": doc.status,
+        "date": date,
+    }
+
+
+def today() -> dict:
+    groups: dict[str, list] = {}
+    buckets: list[str] = []
+    for name, root in _hub_buckets():
+        buckets.append(name)
+        for zone, rel, doc in bucket.iter_documents(root):
+            if "archive" in rel.parts or doc.aurora == "archive":
+                continue
+            is_active_activity = zone == "activities" and doc.status == "active"
+            is_commitment = doc.aurora == "commitments"
+            if is_active_activity or is_commitment:
+                groups.setdefault(doc.aurora or "—", []).append(
+                    _item(name, zone, rel, doc)
+                )
+    ordered = {a: groups[a] for a in AURORAS if a in groups}
+    for aurora, items in groups.items():
+        if aurora not in ordered:
+            ordered[aurora] = items
+    return {"buckets": buckets, "groups": ordered}
+
+
+def agenda() -> dict:
+    dated: list[dict] = []
+    active: list[dict] = []
+    for name, zone, rel, doc in _hub_documents():
+        if "archive" in rel.parts or doc.aurora == "archive":
+            continue
+        fm = doc.frontmatter or {}
+        raw = fm.get("due") or fm.get("date")
+        if raw is not None:
+            dated.append(_item(name, zone, rel, doc, date=str(raw)[:10]))
+        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}

fusion_cli-1.1.0.dist-info/METADATA

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: fusion-cli
+Version: 1.1.0
+Summary: The Fusion reference CLI — the notary of the Fusion Convention.
+Author: Bluewaves Boutique
+License-Expression: MIT
+Requires-Python: >=3.11
+Requires-Dist: pyyaml>=6.0
+Description-Content-Type: text/markdown
+
+# fusion — the notary of the Fusion Convention
+
+The reference CLI. It records, checks, and composes; it never judges —
+judgment belongs to the skill family. Buckets that follow
+[the convention](../SPEC.md) are Fusion whether or not this tool ever
+touches them.
+
+## Install
+
+One line, installs the CLI and the four skills into every agent that
+reads them:
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/bluewaves-creations/fusion/main/install.sh | sh
+```
+
+Just the CLI, from PyPI:
+
+```sh
+uv tool install fusion-cli
+```
+
+From a clone:
+
+```sh
+git clone https://github.com/bluewaves-creations/fusion.git
+uv tool install ./fusion/cli
+fusion --version
+```
+
+## The nine commands (there is no tenth)
+
+| Command | Does |
+|---|---|
+| `fusion new <path>` | Scaffold a complete bucket + register it in the hub |
+| `fusion hub` | List / register (`add <path>`) / retire (`remove <name>`) buckets |
+| `fusion log <verb> <object>` | Append a ledger entry — the only writer. No args: read the ledger |
+| `fusion index [path]` | Regenerate `INDEX.md` in `library/` and `activities/` |
+| `fusion check [path]` | Audit a bucket against SPEC §11 — exit 1 on errors |
+| `fusion status [path]` | One bucket at a glance |
+| `fusion today` | The composed day, across every bucket in the hub |
+| `fusion agenda` | The wider horizon — dated and active, across the hub |
+| `fusion setup` | Install the skills into every detected agent — the installer's brain. `--remove` undoes it |
+
+Every command takes `--json` (agents parse, never scrape). `log`, `new`,
+and `index` take `--as <actor>`; the pen defaults to `FUSION_ACTOR`, then
+the OS username. `status` and `log` take `--since <date|last-reflection>`.
+`log` also takes `--bucket` (resolves the ledger; default: walk up from the current directory).
+The hub lives at `~/.fusion/hub.md` (`FUSION_HUB` overrides).
+
+## Development
+
+```sh
+cd cli
+uv run pytest        # the suite — golden tests run against ../examples/crazy-ones
+uv run fusion check ../examples/crazy-ones
+```

fusion_cli-1.1.0.dist-info/RECORD

@@ -0,0 +1,46 @@
+fusion/__init__.py,sha256=llHMk8mEYtxolae7jRHA6InBi4s9_I63LdBprNYR12A,84
+fusion/bucket.py,sha256=EZQH80Uu2VFetkcQPzzNreoCIJsg7rUbwze1FWmRYm4,2124
+fusion/checker.py,sha256=W03XPxWorCqcvxz3oX2dt3Q7GzOHDgi1I0xWEJNUzRI,9462
+fusion/cli.py,sha256=sHAJ4z1yOvdyM1vCqA-cu2nveZWK1xw2D_GvhzqJtq8,17205
+fusion/document.py,sha256=Ajh-faFQLXgwVLibagdxIxwAjMI57CHKQbGsGNwNRNE,4813
+fusion/hub.py,sha256=RgmXtlFqZ36C4rnP4D3syr8O6f3ZrKTIVQGYd_7EeNY,1974
+fusion/indexer.py,sha256=SA9ZBOh4OSZ4lx2x33yUpPte82ZHGPpGtLvFfw6Yhj8,2694
+fusion/ledger.py,sha256=oJNladLLRhA4zhyVTUOgzaaMy3o8nTjDgg3qza0uotw,3280
+fusion/manifest.py,sha256=7UU5HlvTctoSpz9iqLlwJxYQLewXj7GJv3zdhIHoeyI,871
+fusion/scaffold.py,sha256=Dzz5np91MUWCtS38l3dIY60IaXdPFKO2AfjxMsIV5CU,3607
+fusion/setup.py,sha256=j_3nwgvtvxe-ZuIbQXrQWfI8MSoMLRycxV6x6Gp_99E,12771
+fusion/views.py,sha256=hCdq1IjTisd-8drXkuoTmt680NHSBV3dyOaFERj0qes,3796
+fusion/_skills/fusion-analyst/SKILL.md,sha256=T7XnaeylxdyniCcWtXZYEKvgzOZx_I-H2nmHvmX5HKI,2872
+fusion/_skills/fusion-analyst/references/assess.md,sha256=6JKusH38m5uCXp0zRtFsVmiAMdmFL7vwA0jtlqYKGFs,624
+fusion/_skills/fusion-analyst/references/compare.md,sha256=uBEIVC7fa-D6t_SCXNIGGI_dZAYtLIdQ9Ds-ivLizv8,626
+fusion/_skills/fusion-analyst/references/export.md,sha256=CCcirWNSwkZ6GbDeVn1-tmVT7SbTvN9cfIqIQR_Fw6Q,747
+fusion/_skills/fusion-analyst/references/fusion-conventions.md,sha256=dLqp_HFTnhUKl69CyeoEbNXjMy1lCOSfDgbWMVh-tfI,6216
+fusion/_skills/fusion-analyst/references/report.md,sha256=kjsh5G9xaHAuEiotB74pLc_4bs5rYKilSPmJwA2Agbs,751
+fusion/_skills/fusion-analyst/scripts/export.py,sha256=59HhpIfJqPikGUI2GFxrg1JIAQ2JYJnsZvP2sCi67oc,1959
+fusion/_skills/fusion-intake/SKILL.md,sha256=-zhBmLkUgJRnM3DqXfhKc6LQdlvE_8QtWXOcIPhPAGQ,7557
+fusion/_skills/fusion-intake/references/convert.md,sha256=yxEdUnvxVTmSX7wqyYhdRBL49ph3inOEswESVXeO3bY,4392
+fusion/_skills/fusion-intake/references/delivery.md,sha256=r1qmVfq2sUhBqmW35sCEfjyH-C2NTE1RBPEMigXap14,5879
+fusion/_skills/fusion-intake/references/fusion-conventions.md,sha256=dLqp_HFTnhUKl69CyeoEbNXjMy1lCOSfDgbWMVh-tfI,6216
+fusion/_skills/fusion-intake/references/gate.md,sha256=bJ3cEnVXJGqGg8DmkjJakzzzILOlcpr7GZi392YZ-6A,5304
+fusion/_skills/fusion-intake/scripts/convert.py,sha256=FcFQ-ibeWjkyujG-4IZQltUY072RzlFLH1XO7A3v18Q,34829
+fusion/_skills/fusion-intake/scripts/gate.py,sha256=mn2pG2ldAS_h1Y6hrZdB-8QNHo8xYojGPDLsQ5Ja0aY,10002
+fusion/_skills/fusion-librarian/SKILL.md,sha256=EsEaH5TIswQYkeNjO5Xb4Xj704VmcKiig9TGTB6bXuE,3706
+fusion/_skills/fusion-librarian/references/archive.md,sha256=i4xITrqsjjC68aJq1ktsefzZYCChed6uFKuitJxAMy8,1088
+fusion/_skills/fusion-librarian/references/create.md,sha256=cH-NSwPLXDsweQ4MFQLw_YEUwtjksFMa7lU3KqW-x4o,869
+fusion/_skills/fusion-librarian/references/cross-reference.md,sha256=HhEs_j7SqaGgmAE2wJI64x3J8fcmL6uG9H4y8p3DcnI,2481
+fusion/_skills/fusion-librarian/references/fusion-conventions.md,sha256=dLqp_HFTnhUKl69CyeoEbNXjMy1lCOSfDgbWMVh-tfI,6216
+fusion/_skills/fusion-librarian/references/promote.md,sha256=x6qLJWqt6zBN3FgF9r5K65jjwE5h43qvM4e4R9wEuvE,1128
+fusion/_skills/fusion-librarian/references/query.md,sha256=JmQHQfdktK6hFoC7x-ms5Xvj2oGluAiwuO_mpY4MbeQ,831
+fusion/_skills/fusion-librarian/references/reflect.md,sha256=3lkmqhfOhJdZfKw_2vHwEf19Kp4DXZSBI4jyAf1C0WQ,1933
+fusion/_skills/fusion-librarian/references/restructure.md,sha256=U_WtJzmo_uNfIZAN0inga0mtFhqQO1xIvT6VJ2EI1aE,1077
+fusion/_skills/fusion-librarian/references/tag.md,sha256=E9M2Wec5PiGlMpEAF3Q3VbYYDo7O9kMA5ZPv22pbmSs,689
+fusion/_skills/fusion-librarian/scripts/link-repair.py,sha256=q3_dDf-d1kJ852MzzPuxPFAWNlwYJMizbvRlFbG079w,15422
+fusion/_skills/fusion-planner/SKILL.md,sha256=ljMMYpUkykzwpj8Gja-Kfd0QoZ--bSUWc_NRUJvUaro,3018
+fusion/_skills/fusion-planner/references/close.md,sha256=ucKMR93bQazTE532mNqKJLTK0iMji3YzYuIMZfCr51s,709
+fusion/_skills/fusion-planner/references/create-activity.md,sha256=RFIJStk1CCoUYLVBZUxaVz4-SgNRm7YGGesRup4aR-U,994
+fusion/_skills/fusion-planner/references/fusion-conventions.md,sha256=dLqp_HFTnhUKl69CyeoEbNXjMy1lCOSfDgbWMVh-tfI,6216
+fusion/_skills/fusion-planner/references/horizon.md,sha256=E3YchjopfxC-ERTyAxTj5hzmvEnFYd_teY8TScYcg2o,1096
+fusion_cli-1.1.0.dist-info/METADATA,sha256=G1YNkkxeO0gEhxihsLQVwmRAQNfFQi6EUN55RhvHfG8,2289
+fusion_cli-1.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+fusion_cli-1.1.0.dist-info/entry_points.txt,sha256=fVgiRsE5pSqmAqNKk9YQCJnpBW3A780OzNC-A4CjzqM,49
+fusion_cli-1.1.0.dist-info/RECORD,,

fusion_cli-1.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

fusion_cli-1.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fusion = fusion.cli:main_entry