procesio-cli 0.1.1__py3-none-any.whl

procesio_cli/tools/framework-map/fm_strings.py

@@ -0,0 +1,101 @@
+"""UI copy for this distribution.
+
+LBL is the generic interface vocabulary and is carried whole. S holds only
+the page copy this distribution actually renders; the hero comes from the
+engine's own fallback, so nothing here has to be authored by hand.
+"""
+from __future__ import annotations
+
+LBL = {
+    "en": {
+        "ctl_collapse": "Collapse all",
+        "ctl_expand": "Expand all",
+        "ctl_search": "Search tools, agents, skills, actions...   e.g. whatsapp, invoice, search-people",
+        "empty": "Nothing matches that search.",
+        "exp_h2": "Explore everything",
+        "exp_intro": "The full registry, straight from the manifests. Search by name or by what it does. Open a tool to see its actions, open an action to see its arguments. Green dot means its credentials are already in place. Names, commands, and the per-action technical notes stay in English, as in the terminal.",
+        "exp_kicker": "Every capability, drillable",
+        "l_actions": "Actions",
+        "l_autotrigger": "auto-trigger",
+        "l_creds": "Credentials it needs",
+        "l_drives": "Drives these tools",
+        "l_noargs": "no arguments",
+        "l_opt": "opt",
+        "l_primary": "Primary use",
+        "l_req": "req",
+        "l_triggers": "Triggers on",
+        "l_when": "When it triggers & what it does",
+        "m_many": "matches",
+        "m_one": "match",
+        "nav_cases": "Use cases",
+        "nav_explore": "Explore",
+        "nav_line": "The line",
+        "nav_loop": "The loop",
+        "nav_pieces": "The pieces",
+        "nav_platform": "The driver",
+        "nav_prompts": "Prompts",
+        "nav_schedules": "Schedules",
+        "nav_store": "The store",
+        "nav_together": "Working together",
+        "nav_triggers": "Who triggers what",
+        "tab_agents": "Agents",
+        "tab_skills": "Skills",
+        "tab_tools": "Tools",
+        "tip_needs": "needs credentials",
+        "tip_ready": "credentials present",
+        "w_actions": "actions",
+        "w_arg": "arg",
+        "w_args": "args",
+        "w_tools": "tools",
+    },
+    "ro": {
+        "ctl_collapse": "Restrânge tot",
+        "ctl_expand": "Extinde tot",
+        "ctl_search": "Caută tool-uri, agenți, skill-uri, acțiuni...   ex. whatsapp, factură, search-people",
+        "empty": "Nimic nu se potrivește cu căutarea.",
+        "exp_h2": "Explorează tot",
+        "exp_intro": "Registrul complet, direct din manifeste. Caută după nume sau după ce face. Deschide un tool ca să-i vezi acțiunile, deschide o acțiune ca să-i vezi argumentele. Punctul verde înseamnă că credentialele sunt deja la locul lor. Numele, comenzile și notele tehnice de la nivel de acțiune rămân în engleză, ca în terminal.",
+        "exp_kicker": "Fiecare capabilitate, în detaliu",
+        "l_actions": "Acțiuni",
+        "l_autotrigger": "auto-declanșare",
+        "l_creds": "Credentiale necesare",
+        "l_drives": "Conduce aceste tool-uri",
+        "l_noargs": "fără argumente",
+        "l_opt": "opt",
+        "l_primary": "Utilizare principală",
+        "l_req": "oblig",
+        "l_triggers": "Se declanșează la",
+        "l_when": "Când se declanșează & ce face",
+        "m_many": "potriviri",
+        "m_one": "potrivire",
+        "nav_cases": "Exemple",
+        "nav_explore": "Explorează",
+        "nav_line": "Linia",
+        "nav_loop": "Bucla",
+        "nav_pieces": "Componentele",
+        "nav_platform": "Driverul",
+        "nav_prompts": "Prompturi",
+        "nav_schedules": "Programări",
+        "nav_store": "Memoria",
+        "nav_together": "Cum lucrează împreună",
+        "nav_triggers": "Cine declanșează ce",
+        "tab_agents": "Agenți",
+        "tab_skills": "Skill-uri",
+        "tab_tools": "Tool-uri",
+        "tip_needs": "lipsesc credentiale",
+        "tip_ready": "credentiale prezente",
+        "w_actions": "acțiuni",
+        "w_arg": "arg",
+        "w_args": "argumente",
+        "w_tools": "tool-uri",
+    },
+}
+
+S = {
+    "en": {
+        "footer": "Generated from the live manifests, $NTOOLS tools &middot; $NAGENTS agents &middot; $NSKILLS skills &middot; $NACTIONS actions. The registry is the source of truth, this map regenerates from it. Framework capability is shared and versioned, your data stays in <code>context-state-knowledge/</code>, secrets stay in the Windows Credential Store.",
+    },
+    "ro": {
+        "footer": "Generat din manifestele vii, $NTOOLS tool-uri &middot; $NAGENTS agenți &middot; $NSKILLS skill-uri &middot; $NACTIONS acțiuni. Registrul e sursa de adevăr - harta asta se regenerează din el. Capabilitatea de framework e partajată și versionată, datele tale rămân în <code>context-state-knowledge/</code>, secretele rămân în Windows Credential Store.",
+    },
+}

procesio_cli/tools/framework-map/main.py

@@ -0,0 +1,95 @@
+"""framework-map tool entrypoint - action dispatch.
+
+Regenerates the interactive bilingual (EN default / RO) framework map HTML from
+the live registry. JSON in / JSON out. No secrets, no user data - the generated
+file is a build artifact (it does reflect current credential presence via the
+readiness dots, nothing more).
+"""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+TOOL_ROOT = Path(__file__).resolve().parent
+FRAMEWORK_ROOT = TOOL_ROOT.parents[1]
+_VENV_PY = FRAMEWORK_ROOT / ".venv" / "Scripts" / "python.exe"
+if _VENV_PY.exists() and Path(sys.executable).resolve() != _VENV_PY.resolve():
+    import subprocess
+    sys.exit(subprocess.run([str(_VENV_PY), __file__, *sys.argv[1:]]).returncode)
+
+import argparse  # noqa: E402
+
+for _p in (str(FRAMEWORK_ROOT), str(TOOL_ROOT)):
+    if _p not in sys.path:
+        sys.path.insert(0, _p)
+
+from tools._lib.io import emit, fail, log  # noqa: E402
+import fm_builder  # noqa: E402
+
+
+class ActionDef:
+    def __init__(self, add_args, run, description=""):
+        self._add_args = add_args
+        self.run = run
+        self.description = description
+
+    def add_args(self, parser):
+        self._add_args(parser)
+
+
+def _add_build_args(p):
+    p.add_argument("--out", default="framework-map.html",
+                   help="Output path for the HTML (relative paths resolve from the repo root).")
+
+
+def _run_build(args):
+    log("extracting registry + assembling map ...")
+    html, stats = fm_builder.build_html(FRAMEWORK_ROOT)
+    if not html.rstrip().endswith("</html>"):
+        fail("assembly_error", "generated HTML is truncated (missing </html>)")
+    out = Path(args.out)
+    if not out.is_absolute():
+        out = FRAMEWORK_ROOT / out
+    data = html.encode("utf-8")
+    out.write_bytes(data)  # bytes, not write_text: avoid Windows CRLF translation
+    size = out.stat().st_size
+    if size != len(data):
+        fail("write_mismatch", "written byte count does not match generated HTML",
+             {"written": size, "expected": len(data)})
+    log(f"wrote {out} ({size} bytes)")
+    emit({"path": str(out), "bytes": size, **stats})
+
+
+def _add_check_args(p):
+    return None
+
+
+def _run_check(args):
+    emit(fm_builder.stats_only(FRAMEWORK_ROOT))
+
+
+ACTIONS = {
+    "build": ActionDef(_add_build_args, _run_build,
+                       "Extract the live registry, translate the catalog to RO, write the single-file HTML map."),
+    "check": ActionDef(_add_check_args, _run_check,
+                       "Report counts, categories, and catalog strings still missing an RO translation. Writes nothing."),
+}
+
+
+def main():
+    parser = argparse.ArgumentParser(prog="framework-map", description="Regenerate the framework map.")
+    sub = parser.add_subparsers(dest="action", required=True)
+    for name, defn in ACTIONS.items():
+        sp = sub.add_parser(name, help=defn.description)
+        defn.add_args(sp)
+    args = parser.parse_args()
+    try:
+        ACTIONS[args.action].run(args)
+    except SystemExit:
+        raise
+    except Exception as e:  # noqa: BLE001
+        fail("build_error", str(e), {"action": args.action})
+
+
+if __name__ == "__main__":
+    main()

procesio_cli/tools/framework-map/styles.css

@@ -0,0 +1,214 @@
+
+:root{
+  --bg:#f5f6f8; --panel:#ffffff; --ink:#12151c; --muted:#5b6472; --faint:#8a93a3;
+  --line:#e5e8ef; --line2:#eef1f6;
+  --tool:#0e7490; --tool-bg:#ecfeff; --tool-ln:#a5e8ef;
+  --agent:#6d28d9; --agent-bg:#f5f3ff; --agent-ln:#d6ccf7;
+  --skill:#b45309; --skill-bg:#fff8ec; --skill-ln:#f3ddb0;
+  --store:#047857; --store-bg:#ecfdf5; --store-ln:#b3e6ce;
+  --brand:#2563eb; --brand-bg:#eef4ff;
+  --shadow:0 1px 2px rgba(16,22,40,.04),0 6px 24px rgba(16,22,40,.05);
+}
+*{box-sizing:border-box}
+html{scroll-behavior:smooth}
+body{margin:0;background:var(--bg);color:var(--ink);
+  font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Inter,Helvetica,Arial,sans-serif;
+  font-size:15px;line-height:1.55;-webkit-font-smoothing:antialiased}
+code,.mono{font-family:ui-monospace,SFMono-Regular,"SF Mono",Menlo,Consolas,"Liberation Mono",monospace}
+a{color:var(--brand);text-decoration:none}
+a:hover{text-decoration:underline}
+.wrap{max-width:1180px;margin:0 auto;padding:0 22px}
+
+/* header */
+header.top{position:sticky;top:0;z-index:50;background:rgba(255,255,255,.86);
+  backdrop-filter:saturate(1.2) blur(8px);border-bottom:1px solid var(--line)}
+.top-in{max-width:1180px;margin:0 auto;padding:10px 22px;display:flex;align-items:center;gap:18px;flex-wrap:wrap}
+.brand{font-weight:700;letter-spacing:-.01em;font-size:16px;display:flex;align-items:center;gap:9px}
+.brand .dot{width:11px;height:11px;border-radius:3px;background:linear-gradient(135deg,var(--tool),var(--agent))}
+.nav{display:flex;gap:2px;flex-wrap:wrap;order:1;flex-basis:100%;margin-top:3px}
+.nav a{color:var(--muted);padding:5px 10px;border-radius:7px;font-size:13.5px;font-weight:500}
+.nav a:hover{background:var(--brand-bg);color:var(--brand);text-decoration:none}
+
+/* hero */
+.hero{padding:56px 0 30px}
+.eyebrow{color:var(--brand);font-weight:600;font-size:13px;letter-spacing:.04em;text-transform:uppercase}
+h1{font-size:42px;line-height:1.05;letter-spacing:-.025em;margin:12px 0 6px;font-weight:760}
+.sub{font-size:19px;color:var(--muted);max-width:720px;margin:0 0 20px}
+.lead{font-size:16.5px;max-width:760px;color:#2b313d}
+.counts{display:flex;gap:10px;flex-wrap:wrap;margin:26px 0 4px}
+.count{background:var(--panel);border:1px solid var(--line);border-radius:12px;padding:12px 18px;box-shadow:var(--shadow)}
+.count b{font-size:26px;font-weight:730;letter-spacing:-.02em;display:block}
+.count span{font-size:12.5px;color:var(--muted);text-transform:uppercase;letter-spacing:.04em}
+
+section.band{padding:44px 0;border-top:1px solid var(--line)}
+.band h2{font-size:27px;letter-spacing:-.02em;margin:0 0 6px;font-weight:720}
+.band .kicker{color:var(--faint);font-weight:600;font-size:12.5px;letter-spacing:.06em;text-transform:uppercase;margin-bottom:14px}
+.band p.intro{font-size:16px;color:#333a47;max-width:800px;margin:0 0 22px}
+
+/* element cards */
+.layer-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(250px,1fr));gap:16px}
+.lcard{background:var(--panel);border:1px solid var(--line);border-radius:14px;padding:20px;box-shadow:var(--shadow);position:relative;overflow:hidden}
+.lcard:before{content:"";position:absolute;left:0;top:0;bottom:0;width:4px}
+.lcard.tool:before{background:var(--tool)} .lcard.agent:before{background:var(--agent)}
+.lcard.skill:before{background:var(--skill)} .lcard.store:before{background:var(--store)}
+.lcard h3{margin:0 0 3px;font-size:18px;display:flex;align-items:center;gap:9px;font-weight:680}
+.tag{font-size:11px;font-weight:700;letter-spacing:.05em;text-transform:uppercase;padding:3px 8px;border-radius:6px}
+.tag.tool{background:var(--tool-bg);color:var(--tool)} .tag.agent{background:var(--agent-bg);color:var(--agent)}
+.tag.skill{background:var(--skill-bg);color:var(--skill)} .tag.store{background:var(--store-bg);color:var(--store)}
+.lcard .role{color:var(--faint);font-size:12.5px;margin:0 0 10px}
+.lcard p{margin:0 0 8px;font-size:14.5px;color:#2f3641}
+details.more{margin-top:8px;border-top:1px solid var(--line2);padding-top:8px}
+details.more>summary{cursor:pointer;color:var(--brand);font-weight:600;font-size:13.5px;list-style:none}
+details.more>summary::-webkit-details-marker{display:none}
+details.more>summary:before{content:"+ ";font-weight:700}
+details.more[open]>summary:before{content:"– "}
+details.more .body{font-size:13.8px;color:#3a414d;padding-top:8px}
+details.more .body{color:#3a414d}
+.kv{margin:6px 0}.kv b{color:var(--ink)}
+
+/* diagrams */
+.diagram{background:var(--panel);border:1px solid var(--line);border-radius:16px;padding:8px;box-shadow:var(--shadow);overflow-x:auto}
+.diagram svg{display:block;width:100%;height:auto;min-width:640px}
+.split{display:grid;grid-template-columns:1fr auto 1fr;gap:0;align-items:stretch;background:var(--panel);
+  border:1px solid var(--line);border-radius:16px;overflow:hidden;box-shadow:var(--shadow)}
+.split .half{padding:22px}
+.split .fw{background:linear-gradient(180deg,#f0f7ff,#fff)}
+.split .ud{background:linear-gradient(180deg,#f0fcf6,#fff)}
+.split .mid{width:1px;background:repeating-linear-gradient(180deg,var(--line) 0 8px,transparent 8px 16px)}
+.split h4{margin:0 0 3px;font-size:16px}
+.split .lab{font-size:11.5px;font-weight:700;letter-spacing:.05em;text-transform:uppercase;padding:2px 8px;border-radius:6px;display:inline-block;margin-bottom:9px}
+.split .lab.a{background:var(--brand-bg);color:var(--brand)}
+.split .lab.b{background:var(--store-bg);color:var(--store)}
+.chiprow{display:flex;flex-wrap:wrap;gap:7px;margin-top:8px}
+.chip{background:#f3f5f9;border:1px solid var(--line);border-radius:999px;padding:4px 11px;font-size:12.5px;color:#3b424e;font-weight:500}
+.chip.mono{font-family:ui-monospace,monospace;font-size:11.5px}
+.note{font-size:13px;color:var(--muted);margin-top:14px;padding:12px 15px;background:#fbfcfd;border:1px solid var(--line);border-radius:10px}
+.note b{color:var(--ink)}
+
+/* trigger rows */
+.trigrid{display:grid;grid-template-columns:repeat(auto-fit,minmax(255px,1fr));gap:14px}
+.trig{background:var(--panel);border:1px solid var(--line);border-radius:13px;padding:16px 18px;box-shadow:var(--shadow)}
+.trig .flow{font-weight:700;font-size:15px;display:flex;align-items:center;gap:8px;margin-bottom:6px}
+.trig .flow .ar{color:var(--faint)}
+.trig p{margin:0;font-size:13.8px;color:#3a414d}
+.pill{font-size:11px;font-weight:700;padding:2px 8px;border-radius:6px;text-transform:uppercase;letter-spacing:.03em}
+.pill.user{background:var(--brand-bg);color:var(--brand)}
+.pill.orch{background:#eef2ff;color:#4338ca}
+.pill.skill{background:var(--skill-bg);color:var(--skill)}
+.pill.clock{background:#fef2f2;color:#b91c1c}
+.pill.agent{background:var(--agent-bg);color:var(--agent)}
+.pill.tool{background:var(--tool-bg);color:var(--tool)}
+
+/* loop stepper */
+.loop{display:grid;grid-template-columns:repeat(6,1fr);gap:10px}
+.step{background:var(--panel);border:1px solid var(--line);border-radius:12px;padding:14px;box-shadow:var(--shadow);position:relative}
+.step .n{width:24px;height:24px;border-radius:7px;background:var(--brand-bg);color:var(--brand);font-weight:700;font-size:13px;display:flex;align-items:center;justify-content:center;margin-bottom:8px}
+.step h4{margin:0 0 4px;font-size:14.5px}
+.step p{margin:0;font-size:12.8px;color:var(--muted)}
+
+/* modes */
+.modes{display:grid;grid-template-columns:1fr 1fr;gap:16px}
+.mode{background:var(--panel);border:1px solid var(--line);border-radius:14px;padding:20px;box-shadow:var(--shadow)}
+.mode.auto{border-top:3px solid var(--store)}
+.mode.driver{border-top:3px solid var(--agent)}
+.mode h4{margin:0 0 8px;font-size:17px;display:flex;align-items:center;gap:9px}
+
+/* tree */
+.tree{background:#0f1420;color:#d6deeb;border-radius:14px;padding:20px 22px;font-family:ui-monospace,monospace;font-size:13.2px;line-height:1.75;overflow-x:auto;box-shadow:var(--shadow)}
+.tree .d{color:#7dd3fc}.tree .f{color:#e2e8f0}.tree .c{color:#64748b}.tree .lock{color:#fbbf24}
+
+/* explorer */
+.exp-bar{position:sticky;top:52px;z-index:40;background:var(--bg);padding:14px 0;display:flex;gap:12px;align-items:center;flex-wrap:wrap}
+#search{flex:1;min-width:200px;padding:11px 15px;border:1px solid var(--line);border-radius:11px;font-size:15px;background:var(--panel);box-shadow:var(--shadow)}
+#search:focus{outline:none;border-color:var(--brand);box-shadow:0 0 0 3px var(--brand-bg)}
+.tabs{display:flex;gap:4px;background:var(--panel);border:1px solid var(--line);border-radius:11px;padding:4px}
+.tabs button{border:0;background:transparent;padding:8px 15px;border-radius:8px;font-size:14px;font-weight:600;color:var(--muted);cursor:pointer}
+.tabs button.on{background:var(--brand);color:#fff}
+.exp-tools button.on{background:var(--tool)} .exp-agents button.on{background:var(--agent)} .exp-skills button.on{background:var(--skill)}
+.btn{border:1px solid var(--line);background:var(--panel);padding:9px 13px;border-radius:10px;font-size:13px;font-weight:600;color:var(--muted);cursor:pointer;box-shadow:var(--shadow)}
+.btn:hover{color:var(--ink);border-color:#d3d9e3}
+.expcount{font-size:13px;color:var(--faint);margin-left:2px}
+
+.cathead{display:flex;align-items:center;gap:10px;margin:22px 0 12px;cursor:pointer;user-select:none}
+.cathead .cx{font-size:13px;color:var(--faint);font-weight:600}
+.cathead h3{margin:0;font-size:16px;font-weight:680}
+.cathead .tw{font-size:11px;transition:transform .15s;color:var(--faint)}
+.cathead.closed .tw{transform:rotate(-90deg)}
+.catgrid{display:grid;grid-template-columns:repeat(auto-fill,minmax(330px,1fr));gap:14px}
+.catgrid.hide{display:none}
+
+.card{background:var(--panel);border:1px solid var(--line);border-radius:13px;box-shadow:var(--shadow);overflow:hidden}
+.card>summary{cursor:pointer;list-style:none;padding:15px 17px;display:flex;align-items:flex-start;gap:10px}
+.card>summary::-webkit-details-marker{display:none}
+.card .nm{font-weight:680;font-size:15.5px;font-family:ui-monospace,monospace;letter-spacing:-.01em}
+.card .ds{font-size:13px;color:var(--muted);margin-top:3px;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden}
+.card[open] .ds{display:block;-webkit-line-clamp:unset}
+.card .meta{margin-left:auto;display:flex;flex-direction:column;align-items:flex-end;gap:5px;flex-shrink:0}
+.acount{font-size:11.5px;font-weight:700;padding:3px 9px;border-radius:999px;background:#f0f2f6;color:var(--muted);white-space:nowrap}
+.dotr{width:8px;height:8px;border-radius:50%}
+.dotr.on{background:#16a34a}.dotr.off{background:#d1d5db}
+.card .tw{font-size:11px;color:var(--faint);margin-top:3px}
+.card[open] .tw{transform:rotate(90deg)}
+.card .body{padding:0 17px 16px;border-top:1px solid var(--line2)}
+.card .body .full{font-size:13.8px;color:#333a47;margin:12px 0}
+.sec-l{font-size:11px;font-weight:700;letter-spacing:.05em;text-transform:uppercase;color:var(--faint);margin:14px 0 7px}
+.ex{background:#0f1420;color:#d6deeb;border-radius:9px;padding:10px 13px;font-family:ui-monospace,monospace;font-size:12.4px;overflow-x:auto;white-space:pre-wrap;word-break:break-word}
+.trigchips .chip{background:var(--brand-bg);color:#3949c4;border-color:#dbe3ff;font-size:11.5px}
+.seccap .chip{cursor:pointer}
+.seccap .chip:hover{border-color:var(--agent);color:var(--agent)}
+.lockchip{background:#fffbeb;border:1px solid #f3ddb0;color:#92600a;border-radius:999px;padding:3px 10px;font-size:11.8px;font-family:ui-monospace,monospace;display:inline-flex;gap:5px;align-items:center}
+
+/* action list */
+.acts{margin-top:4px}
+.act{border:1px solid var(--line2);border-radius:9px;margin-bottom:6px;overflow:hidden;background:#fcfdfe}
+.act>summary{cursor:pointer;list-style:none;padding:9px 12px;display:flex;align-items:center;gap:9px;font-family:ui-monospace,monospace;font-size:13px;font-weight:600}
+.act>summary::-webkit-details-marker{display:none}
+.act>summary:before{content:"▸";color:var(--faint);font-size:10px;transition:transform .12s}
+.act[open]>summary:before{transform:rotate(90deg)}
+.act .argn{margin-left:auto;font-size:10.5px;font-weight:700;color:var(--faint);font-family:inherit}
+.act .abody{padding:2px 12px 11px 30px}
+.act .adesc{font-size:12.8px;color:#41485a;margin:2px 0 8px;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif}
+.arg{display:flex;gap:8px;align-items:baseline;padding:3px 0;border-top:1px dashed var(--line);font-size:12.3px}
+.arg .an{font-family:ui-monospace,monospace;font-weight:600;color:var(--tool)}
+.arg .req{font-size:9.5px;font-weight:800;letter-spacing:.04em;padding:1px 5px;border-radius:4px;background:#fee2e2;color:#b91c1c;text-transform:uppercase}
+.arg .opt{font-size:9.5px;font-weight:800;letter-spacing:.04em;padding:1px 5px;border-radius:4px;background:#f0f2f6;color:var(--faint);text-transform:uppercase}
+.arg .ad{color:var(--muted)}
+.noargs{font-size:12.3px;color:var(--faint);font-style:italic;padding:4px 0}
+.drives{display:flex;flex-wrap:wrap;gap:6px}
+.tchip{background:var(--tool-bg);color:var(--tool);border:1px solid var(--tool-ln);border-radius:999px;padding:3px 11px;font-size:12px;font-family:ui-monospace,monospace;cursor:pointer;font-weight:600}
+.tchip:hover{background:var(--tool);color:#fff}
+.hl{animation:hl 2s ease}
+@keyframes hl{0%,40%{box-shadow:0 0 0 3px var(--agent)}100%{box-shadow:var(--shadow)}}
+.empty{padding:40px;text-align:center;color:var(--faint)}
+
+/* use cases */
+.uc{background:var(--panel);border:1px solid var(--line);border-radius:14px;padding:18px 20px;box-shadow:var(--shadow);margin-bottom:14px}
+.uc h4{margin:0 0 4px;font-size:16.5px}
+.uc .ask{font-family:ui-monospace,monospace;font-size:13px;color:var(--brand);background:var(--brand-bg);padding:2px 9px;border-radius:6px;display:inline-block;margin-bottom:9px}
+.uc p{margin:0 0 11px;font-size:14.3px;color:#333a47}
+.uc .chain{display:flex;flex-wrap:wrap;gap:6px;align-items:center}
+.uc .chain .ar{color:var(--faint);font-size:12px}
+.jump{border-radius:999px;padding:3px 11px;font-size:12px;font-weight:600;cursor:pointer;border:1px solid}
+.jump.tool{background:var(--tool-bg);color:var(--tool);border-color:var(--tool-ln)}
+.jump.agent{background:var(--agent-bg);color:var(--agent);border-color:var(--agent-ln)}
+.jump.orch{background:#eef2ff;color:#4338ca;border-color:#d5ddff}
+.jump:hover{filter:brightness(.96)}
+
+footer{padding:36px 0 60px;color:var(--faint);font-size:13px;border-top:1px solid var(--line);margin-top:20px}
+@media(max-width:820px){
+  .loop{grid-template-columns:1fr 1fr}.modes{grid-template-columns:1fr}
+  .split{grid-template-columns:1fr}.split .mid{display:none}
+  h1{font-size:33px}.nav{display:none}
+}
+@media print{
+  header.top,.exp-bar,.nav{position:static}
+  .card,.act{break-inside:avoid}
+  body{background:#fff}
+}
+.langtoggle{display:flex;gap:2px;background:var(--panel);border:1px solid var(--line);border-radius:9px;padding:3px;margin-left:auto}
+.langtoggle button{border:0;background:transparent;padding:5px 12px;border-radius:6px;font-size:13px;font-weight:700;color:var(--muted);cursor:pointer;letter-spacing:.03em}
+.langtoggle button.on{background:var(--brand);color:#fff}
+.lang-ro{display:none}
+body.ro .lang-en{display:none}
+body.ro .lang-ro{display:block}
+@media(max-width:820px){ .langtoggle{margin-left:auto} }

procesio_cli/tools/framework-map/tests/conftest.py

@@ -0,0 +1,33 @@
+"""Module loading for the framework-map tool (hyphenated dir).
+
+The dir name has a hyphen, so modules can't be imported as
+``tools.framework-map.*``. The tool's own modules are already fm_-prefixed
+(fm_builder / fm_strings / fm_ro_catalog), so they import cleanly by bare name
+once the tool root is on sys.path and never collide with other tools. Only
+main.py needs an alias (``fm_main``) to avoid clashing with other tools' main.py
+during a full-suite run.
+"""
+from __future__ import annotations
+
+import importlib.util
+import sys
+from pathlib import Path
+
+TOOL_ROOT = Path(__file__).resolve().parents[1]
+FRAMEWORK_ROOT = Path(__file__).resolve().parents[3]
+for _p in (str(FRAMEWORK_ROOT), str(TOOL_ROOT)):
+    if _p not in sys.path:
+        sys.path.insert(0, _p)
+
+
+def _load(name: str, filename: str):
+    spec = importlib.util.spec_from_file_location(name, str(TOOL_ROOT / filename))
+    mod = importlib.util.module_from_spec(spec)
+    sys.modules[name] = mod
+    spec.loader.exec_module(mod)
+    return mod
+
+
+# main.py imports fm_builder, which imports fm_strings + fm_ro_catalog by name
+# (resolved via TOOL_ROOT on sys.path). Load main under a unique alias.
+_load("fm_main", "main.py")

procesio_cli/tools/framework-map/tests/test_fm_build.py

@@ -0,0 +1,126 @@
+"""Build the map from the live registry and assert its structure + invariants."""
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+
+import fm_builder
+
+FRAMEWORK_ROOT = Path(fm_builder.__file__).resolve().parents[2]
+
+
+def test_stats_only_shape():
+    s = fm_builder.stats_only(FRAMEWORK_ROOT)
+    for key in ("tools", "agents", "skills", "actions", "tool_actions",
+                "agent_actions", "categories", "uncategorized", "ro_untranslated"):
+        assert key in s
+    # Deliberately not a census (">= 39 tools"): that asserted the contents of one
+    # checkout rather than the behaviour of the builder, so it failed in any
+    # distribution of the framework that ships a different set. What must hold is
+    # that the registry produced something of each kind and that the totals agree.
+    assert s["tools"] >= 1 and s["agents"] >= 1
+    assert s["actions"] == s["tool_actions"] + s["agent_actions"]
+
+
+def test_every_tool_is_categorized():
+    # a new tool with no CAT entry falls into "Other"; keep the map curated.
+    s = fm_builder.stats_only(FRAMEWORK_ROOT)
+    assert s["uncategorized"] == [], f"uncategorized tools: {s['uncategorized']}"
+
+
+def test_catalog_fully_translated_to_ro():
+    # adding a tool/agent/skill without an RO catalog translation shows up here;
+    # `framework-map check` lists exactly what to translate.
+    s = fm_builder.stats_only(FRAMEWORK_ROOT)
+    assert s["ro_untranslated"] == {}, f"missing RO translations: {s['ro_untranslated']}"
+
+
+def test_build_html_structure():
+    html, stats = fm_builder.build_html(FRAMEWORK_ROOT)
+    assert html.startswith("<!DOCTYPE html>")
+    assert html.rstrip().endswith("</html>")
+    # both datasets embedded + language toggle present
+    assert "const DATA=" in html and "const DATA_RO=" in html and "const LBL=" in html
+    assert 'data-lang="ro"' in html and "lang-ro" in html
+    # self-contained: no external resource references
+    assert 'href="http' not in html and 'src="http' not in html
+    # counts made it into the page
+    assert "{:,}".format(stats["tools"]) in html
+
+
+def test_no_unresolved_template_tokens():
+    html, _ = fm_builder.build_html(FRAMEWORK_ROOT)
+    # narrative placeholders ($svg_*, $NTOOLS, $uc1_h, $footer ...) must all be
+    # substituted. ($filter can legitimately appear inside embedded manifest text.)
+    import re
+    body = html.split("const DATA=", 1)[0]  # ignore the embedded JSON payload
+    leftover = set(re.findall(r"\$[A-Za-z_]{2,}", body))
+    assert not leftover, f"unresolved template tokens: {sorted(leftover)}"
+
+
+def test_marker_ids_unique_per_language():
+    html, _ = fm_builder.build_html(FRAMEWORK_ROOT)
+    # The arrowheads live in the architecture diagram, which is part of the
+    # narrative a distribution may not ship. Where there is no diagram there is
+    # nothing to assert; where there is one, the markers must be per-language or
+    # the RO arrows reference a hidden EN marker and vanish.
+    if "<marker" not in html:
+        pytest.skip("this distribution does not ship the architecture diagram")
+    assert 'id="ahg-en"' in html and 'id="ahg-ro"' in html
+    assert "url(#ahg-ro)" in html and "url(#ahg-en)" in html
+
+
+# -- structural + reference guards (build once, reuse) ------------------------
+
+_CACHE: dict = {}
+
+
+def _built():
+    if "html" not in _CACHE:
+        _CACHE["html"], _ = fm_builder.build_html(FRAMEWORK_ROOT)
+        # everything before the embedded JSON payload is the real markup
+        _CACHE["body"] = _CACHE["html"].split("const DATA=", 1)[0]
+    return _CACHE
+
+
+def test_section_and_div_tags_balanced():
+    # a dropped closing tag orphans every later section (this actually happened);
+    # balance is the cheapest guard that would have caught it immediately.
+    body = _built()["body"]
+    assert body.count("<section") == body.count("</section>"), "unbalanced <section> tags"
+    assert body.count("<div") == body.count("</div>"), "unbalanced <div> tags"
+
+
+def test_nav_links_resolve_to_sections():
+    import re
+    html = _built()["html"]
+    hrefs = set(re.findall(r'<a href="#([\w-]+)"', html))
+    targets = (set(re.findall(r'id="([\w-]+)"', html))
+               | set(re.findall(r'data-sec="([\w-]+)"', html)))
+    missing = hrefs - targets
+    assert not missing, f"nav links with no matching section: {missing}"
+
+
+def test_narrative_references_resolve():
+    # use-case chips + the generated schedule note reference agents/tools by name
+    # via data-ujump; a rename/removal must not leave a dead pointer.
+    import re
+    body = _built()["body"]
+    refs = set(re.findall(r'data-ujump="([\w-]+)"', body))
+    dump = fm_builder.compress(fm_builder.extract(FRAMEWORK_ROOT))
+    real = ({t["name"] for t in dump["tools"]}
+            | {a["name"] for a in dump["agents"]} | {"__none__"})
+    unknown = refs - real
+    assert not unknown, f"data-ujump references a non-existent capability: {unknown}"
+
+
+def test_schedule_note_generated_from_yaml():
+    # the 'Live today' note is derived from schedule.yaml, not hardcoded. When a
+    # schedule exists it names the real target agents; the fallback is generic.
+    note_en = fm_builder._schedule_note("en")
+    if note_en is None:  # fresh/wiped install -> fallback path
+        assert "schedule.yaml" in fm_builder._SCHED_FALLBACK["en"]
+    else:
+        assert note_en.startswith("<b>Live today:</b>")
+        assert 'data-ujump=' in note_en

procesio_cli/tools/framework-map/tests/test_fm_manifest_sync.py

@@ -0,0 +1,63 @@
+"""Guard: tool.yaml declares exactly the actions the dispatcher registers, and
+each action's manifest args match its argparse (both directions), with
+argparse-required flags marked required in the manifest.
+"""
+from __future__ import annotations
+
+import argparse
+from pathlib import Path
+
+from tools._lib.manifest import load_tool
+
+import fm_main as main
+
+
+def _manifest():
+    return load_tool(Path(main.__file__).resolve().parent / "tool.yaml")
+
+
+def test_manifest_actions_match_dispatch():
+    m = _manifest()
+    assert set(m.action_names()) == set(main.ACTIONS), (
+        f"only in manifest: {set(m.action_names()) - set(main.ACTIONS)}; "
+        f"only in code: {set(main.ACTIONS) - set(m.action_names())}")
+
+
+def test_expected_actions():
+    assert set(main.ACTIONS) == {"build", "check"}
+
+
+def _argparse_names(defn):
+    parser = argparse.ArgumentParser()
+    defn.add_args(parser)
+    names, required = set(), set()
+    for action in parser._actions:
+        for opt in action.option_strings:
+            if opt.startswith("--") and opt != "--help":
+                names.add(opt[2:])
+                if getattr(action, "required", False):
+                    required.add(opt[2:])
+    return names, required
+
+
+def test_manifest_args_match_argparse():
+    m = _manifest()
+    for name, defn in main.ACTIONS.items():
+        argparse_names, _ = _argparse_names(defn)
+        manifest_names = {a.name for a in m.get_action(name).args}
+        assert manifest_names == argparse_names, (
+            f"{name}: only manifest {manifest_names - argparse_names}; "
+            f"only argparse {argparse_names - manifest_names}")
+
+
+def test_required_args_marked_required():
+    m = _manifest()
+    for name, defn in main.ACTIONS.items():
+        argparse_names, required_argparse = _argparse_names(defn)
+        required_manifest = {a.name for a in m.get_action(name).args if a.required}
+        assert required_argparse <= required_manifest
+        assert required_manifest <= argparse_names
+
+
+def test_no_secrets():
+    assert _manifest().secrets == []