ltcai 2.2.7 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (122) hide show
  1. package/README.md +72 -34
  2. package/docs/CHANGELOG.md +119 -0
  3. package/docs/V3_BACKEND_ARCHITECTURE.md +138 -0
  4. package/docs/V3_FRONTEND.md +139 -0
  5. package/knowledge_graph.py +649 -21
  6. package/latticeai/__init__.py +1 -1
  7. package/latticeai/api/admin.py +47 -0
  8. package/latticeai/api/agents.py +54 -31
  9. package/latticeai/api/auth.py +5 -2
  10. package/latticeai/api/chat.py +10 -2
  11. package/latticeai/api/search.py +240 -0
  12. package/latticeai/api/static_routes.py +11 -2
  13. package/latticeai/core/config.py +18 -0
  14. package/latticeai/core/embedding_providers.py +625 -0
  15. package/latticeai/core/local_embeddings.py +86 -0
  16. package/latticeai/core/workspace_os.py +1 -1
  17. package/latticeai/server_app.py +65 -1
  18. package/latticeai/services/agent_runtime.py +245 -0
  19. package/latticeai/services/search_service.py +346 -0
  20. package/package.json +13 -6
  21. package/scripts/build_v3_assets.mjs +164 -0
  22. package/scripts/capture/README.md +28 -0
  23. package/scripts/capture/capture_enterprise.js +8 -0
  24. package/scripts/capture/capture_graph.js +8 -0
  25. package/scripts/capture/capture_onboarding.js +8 -0
  26. package/scripts/capture/capture_page.js +43 -0
  27. package/scripts/capture/capture_release_media.js +125 -0
  28. package/scripts/capture/capture_skills.js +8 -0
  29. package/scripts/capture/capture_workspace.js +8 -0
  30. package/scripts/generate_diagrams.py +513 -0
  31. package/scripts/lint_v3.mjs +33 -0
  32. package/scripts/release-0.3.1.sh +105 -0
  33. package/scripts/take_screenshots.js +69 -0
  34. package/scripts/validate_release_artifacts.py +167 -0
  35. package/static/account.html +9 -9
  36. package/static/activity.html +4 -4
  37. package/static/admin.html +8 -8
  38. package/static/agents.html +4 -4
  39. package/static/chat.html +10 -10
  40. package/static/css/reference/account.css +137 -1
  41. package/static/css/reference/chat.css +31 -37
  42. package/static/css/responsive.css +42 -0
  43. package/static/css/tokens.5a595671.css +260 -0
  44. package/static/css/tokens.css +125 -130
  45. package/static/graph.html +9 -9
  46. package/static/manifest.json +3 -3
  47. package/static/plugins.html +4 -4
  48. package/static/scripts/account.js +4 -4
  49. package/static/scripts/chat.js +40 -8
  50. package/static/scripts/workspace.js +78 -0
  51. package/static/sw.js +3 -1
  52. package/static/v3/asset-manifest.json +47 -0
  53. package/static/v3/css/lattice.base.css +128 -0
  54. package/static/v3/css/lattice.base.e4cdd05d.css +128 -0
  55. package/static/v3/css/lattice.components.011e988b.css +447 -0
  56. package/static/v3/css/lattice.components.css +447 -0
  57. package/static/v3/css/lattice.shell.4920f42d.css +407 -0
  58. package/static/v3/css/lattice.shell.css +407 -0
  59. package/static/v3/css/lattice.tokens.c597ff81.css +132 -0
  60. package/static/v3/css/lattice.tokens.css +132 -0
  61. package/static/v3/css/lattice.views.3ee19d4e.css +277 -0
  62. package/static/v3/css/lattice.views.css +277 -0
  63. package/static/v3/index.html +69 -0
  64. package/static/v3/js/app.46fb61d9.js +26 -0
  65. package/static/v3/js/app.js +26 -0
  66. package/static/v3/js/core/api.22a41d42.js +344 -0
  67. package/static/v3/js/core/api.js +344 -0
  68. package/static/v3/js/core/components.4c83e0a9.js +222 -0
  69. package/static/v3/js/core/components.js +222 -0
  70. package/static/v3/js/core/dom.a2773eb0.js +148 -0
  71. package/static/v3/js/core/dom.js +148 -0
  72. package/static/v3/js/core/router.584570f2.js +37 -0
  73. package/static/v3/js/core/router.js +37 -0
  74. package/static/v3/js/core/routes.f935dd50.js +78 -0
  75. package/static/v3/js/core/routes.js +78 -0
  76. package/static/v3/js/core/shell.1b6199d6.js +363 -0
  77. package/static/v3/js/core/shell.js +363 -0
  78. package/static/v3/js/core/store.34ebd5e6.js +113 -0
  79. package/static/v3/js/core/store.js +113 -0
  80. package/static/v3/js/views/admin-audit.660a1fb1.js +185 -0
  81. package/static/v3/js/views/admin-audit.js +185 -0
  82. package/static/v3/js/views/admin-permissions.a7ae5f09.js +177 -0
  83. package/static/v3/js/views/admin-permissions.js +177 -0
  84. package/static/v3/js/views/admin-policies.3658fd86.js +102 -0
  85. package/static/v3/js/views/admin-policies.js +102 -0
  86. package/static/v3/js/views/admin-private-vpc.7d342d36.js +135 -0
  87. package/static/v3/js/views/admin-private-vpc.js +135 -0
  88. package/static/v3/js/views/admin-security.07c66b72.js +180 -0
  89. package/static/v3/js/views/admin-security.js +180 -0
  90. package/static/v3/js/views/admin-users.03bac88c.js +168 -0
  91. package/static/v3/js/views/admin-users.js +168 -0
  92. package/static/v3/js/views/agents.14e48bdd.js +193 -0
  93. package/static/v3/js/views/agents.js +193 -0
  94. package/static/v3/js/views/chat.718144ce.js +449 -0
  95. package/static/v3/js/views/chat.js +449 -0
  96. package/static/v3/js/views/files.4935197e.js +186 -0
  97. package/static/v3/js/views/files.js +186 -0
  98. package/static/v3/js/views/home.cdde3b32.js +119 -0
  99. package/static/v3/js/views/home.js +119 -0
  100. package/static/v3/js/views/hybrid-search.b22b97e0.js +195 -0
  101. package/static/v3/js/views/hybrid-search.js +195 -0
  102. package/static/v3/js/views/knowledge-graph.a14ea7e7.js +237 -0
  103. package/static/v3/js/views/knowledge-graph.js +237 -0
  104. package/static/v3/js/views/models.a1ffa147.js +256 -0
  105. package/static/v3/js/views/models.js +256 -0
  106. package/static/v3/js/views/my-computer.1b2ff621.js +237 -0
  107. package/static/v3/js/views/my-computer.js +237 -0
  108. package/static/v3/js/views/pipeline.c522f1ce.js +157 -0
  109. package/static/v3/js/views/pipeline.js +157 -0
  110. package/static/v3/js/views/settings.4f777210.js +250 -0
  111. package/static/v3/js/views/settings.js +250 -0
  112. package/static/workflows.html +4 -4
  113. package/static/workspace.css +340 -2
  114. package/static/workspace.html +43 -24
  115. package/docs/images/tmp_frames/frame_00.png +0 -0
  116. package/docs/images/tmp_frames/frame_01.png +0 -0
  117. package/docs/images/tmp_frames/frame_02.png +0 -0
  118. package/docs/images/tmp_frames/frame_03.png +0 -0
  119. package/docs/images/tmp_frames/hero_00.png +0 -0
  120. package/docs/images/tmp_frames/hero_01.png +0 -0
  121. package/docs/images/tmp_frames/hero_02.png +0 -0
  122. package/docs/images/tmp_frames/hero_03.png +0 -0
@@ -0,0 +1,185 @@
1
+ /* ============================================================================
2
+ * View: Audit Logs — Administration · activity and access trail.
3
+ * Reads /admin/audit (live) and renders unavailable state when it cannot load.
4
+ * Severity filter narrows the rendered events; a compact stat row summarizes
5
+ * actors, volume and risk at a glance.
6
+ * ========================================================================== */
7
+
8
+ import { timeAgo } from "../core/dom.a2773eb0.js";
9
+
10
+ const SEVERITY = {
11
+ warning: { variant: "warn", label: "Warning", icon: "alert-triangle" },
12
+ notice: { variant: "info", label: "Notice", icon: "info-circle" },
13
+ informational: { variant: "", label: "Informational", icon: "point" },
14
+ };
15
+ function severityMeta(s) {
16
+ return SEVERITY[String(s || "").toLowerCase()] || { variant: "", label: titleCase(s) || "Event", icon: "point" };
17
+ }
18
+
19
+ const FILTERS = [
20
+ { key: "all", label: "All" },
21
+ { key: "informational", label: "Informational" },
22
+ { key: "notice", label: "Notice" },
23
+ { key: "warning", label: "Warning" },
24
+ ];
25
+
26
+ export async function render(ctx) {
27
+ const { h, icon, api, c } = ctx;
28
+
29
+ const state = { events: [], source: "pending", filter: "all", loaded: false };
30
+
31
+ const srcSlot = h("span", c.sourceBadge("pending"));
32
+ const filterHost = h("div", buildTabs());
33
+ const statHost = h("div.lt3-statrow", c.loading({ lines: 1 }));
34
+ const tableHost = h("div", c.loading({ lines: 6 }));
35
+
36
+ const root = h("div.lt3-stack-6",
37
+ c.viewHeader({
38
+ eyebrow: "Administration",
39
+ title: "Audit Logs",
40
+ sub: "Activity and access trail",
41
+ actions: [
42
+ srcSlot,
43
+ h("button.lt3-btn.lt3-btn--ghost", {
44
+ on: { click: () => ctx.toast("Audit export is not available in this build (SIEM export is an Enterprise feature).", "warn") },
45
+ }, icon("download"), "Export"),
46
+ ],
47
+ }),
48
+ statHost,
49
+ c.panel({
50
+ eyebrow: "Trail",
51
+ title: "Recent events",
52
+ head: h("div.lt3-row", { style: { "justify-content": "space-between", flex: "1 1 auto", gap: "var(--lt3-space-3)" } },
53
+ h("div", h("div.lt3-eyebrow", "Trail"), h("h3.lt3-panel__title", "Recent events")),
54
+ filterHost,
55
+ ),
56
+ children: tableHost,
57
+ }),
58
+ );
59
+
60
+ function buildTabs() {
61
+ return c.tabs(FILTERS, state.filter, (key) => {
62
+ state.filter = key;
63
+ filterHost.replaceChildren(buildTabs());
64
+ renderTable();
65
+ });
66
+ }
67
+
68
+ function visibleEvents() {
69
+ if (state.filter === "all") return state.events;
70
+ return state.events.filter((e) => String(e.severity || "").toLowerCase() === state.filter);
71
+ }
72
+
73
+ function renderStats() {
74
+ const events = state.events;
75
+ const actors = new Set(events.map((e) => e.actor).filter(Boolean)).size;
76
+ const startOfDay = new Date(); startOfDay.setHours(0, 0, 0, 0);
77
+ const today = events.filter((e) => {
78
+ const t = e.ts ? new Date(e.ts).getTime() : NaN;
79
+ return !Number.isNaN(t) && t >= startOfDay.getTime();
80
+ }).length;
81
+ const high = events.filter((e) => ["warning", "high", "critical"].includes(String(e.severity || "").toLowerCase())).length;
82
+ statHost.replaceChildren(
83
+ c.stat({ label: "Total events", value: c.fmtNum(events.length), icon: "list-details" }),
84
+ c.stat({ label: "Actors", value: c.fmtNum(actors), icon: "users" }),
85
+ c.stat({ label: "Today", value: c.fmtNum(today), icon: "calendar-event" }),
86
+ c.stat({ label: "High-severity", value: c.fmtNum(high), icon: "shield-exclamation" }),
87
+ );
88
+ }
89
+
90
+ function renderTable() {
91
+ const rows = visibleEvents();
92
+ if (!rows.length) {
93
+ tableHost.replaceChildren(state.loaded
94
+ ? c.emptyState({
95
+ icon: "history-off",
96
+ title: state.filter === "all" ? "No audit events" : "No matching events",
97
+ body: state.filter === "all"
98
+ ? "Activity will appear here as users act in the workspace."
99
+ : "No events match this severity. Try a broader filter.",
100
+ action: state.filter === "all" ? null : h("button.lt3-btn.lt3-btn--subtle.lt3-btn--sm", {
101
+ on: { click: () => { state.filter = "all"; filterHost.replaceChildren(buildTabs()); renderTable(); } },
102
+ }, icon("filter-off"), "Clear filter"),
103
+ })
104
+ : c.loading({ lines: 6 }));
105
+ return;
106
+ }
107
+ tableHost.replaceChildren(c.table(columns(ctx), rows));
108
+ }
109
+
110
+ async function load() {
111
+ const res = await api.adminAudit();
112
+ state.events = normalize(res.data);
113
+ state.source = res.source;
114
+ state.loaded = true;
115
+ srcSlot.replaceChildren(c.sourceBadge(res.source));
116
+ renderStats();
117
+ renderTable();
118
+ }
119
+
120
+ load();
121
+ return root;
122
+ }
123
+
124
+ /* ── table ───────────────────────────────────────────────────────────────── */
125
+ function columns({ h, icon, c }) {
126
+ return [
127
+ {
128
+ key: "ts", label: "Time", width: "1%",
129
+ render: (e) => h("span.lt3-mono.lt3-faint", { style: { "white-space": "nowrap", "font-size": "var(--lt3-text-2xs)" } },
130
+ e.ts ? timeAgo(e.ts) : "—"),
131
+ },
132
+ {
133
+ key: "actor", label: "Actor",
134
+ render: (e) => h("div.lt3-row-2",
135
+ h("span.lt3-avatar", { style: { width: "26px", height: "26px" } }, initials(e.actor)),
136
+ h("span", { style: { "font-size": "var(--lt3-text-sm)", "white-space": "nowrap" } }, e.actor || "system"),
137
+ ),
138
+ },
139
+ {
140
+ key: "action", label: "Action", width: "1%",
141
+ render: (e) => h("span.lt3-pill.lt3-mono", { style: { "white-space": "nowrap" } }, e.action || "event"),
142
+ },
143
+ {
144
+ key: "target", label: "Target",
145
+ render: (e) => h("span.lt3-faint", { style: { "font-size": "var(--lt3-text-sm)" } }, e.target || "—"),
146
+ },
147
+ {
148
+ key: "severity", label: "Severity", width: "1%",
149
+ render: (e) => {
150
+ const m = severityMeta(e.severity);
151
+ return c.pill(m.label, m.variant, { dot: true });
152
+ },
153
+ },
154
+ ];
155
+ }
156
+
157
+ /* ── helpers ─────────────────────────────────────────────────────────────── */
158
+ function normalize(data) {
159
+ const list = Array.isArray(data) ? data
160
+ : Array.isArray(data && data.recent_events) ? data.recent_events
161
+ : Array.isArray(data && data.events) ? data.events
162
+ : [];
163
+ return list.map((e) => ({
164
+ ts: e.ts || e.timestamp || e.time || null,
165
+ actor: e.actor || e.user || e.email || "system",
166
+ action: e.action || e.event || "event",
167
+ target: e.target || e.resource || "",
168
+ severity: e.severity || e.level || "informational",
169
+ }));
170
+ }
171
+
172
+ function initials(name) {
173
+ const s = String(name || "·").trim();
174
+ if (!s || s === "system") return "SY";
175
+ const at = s.indexOf("@");
176
+ const base = at > 0 ? s.slice(0, at) : s;
177
+ const parts = base.split(/[\s._-]+/).filter(Boolean);
178
+ if (parts.length >= 2) return (parts[0][0] + parts[1][0]).toUpperCase();
179
+ return base.slice(0, 2).toUpperCase();
180
+ }
181
+
182
+ function titleCase(s) {
183
+ s = String(s || "").trim();
184
+ return s ? s[0].toUpperCase() + s.slice(1).toLowerCase() : "";
185
+ }
@@ -0,0 +1,185 @@
1
+ /* ============================================================================
2
+ * View: Audit Logs — Administration · activity and access trail.
3
+ * Reads /admin/audit (live) and renders unavailable state when it cannot load.
4
+ * Severity filter narrows the rendered events; a compact stat row summarizes
5
+ * actors, volume and risk at a glance.
6
+ * ========================================================================== */
7
+
8
+ import { timeAgo } from "../core/dom.js";
9
+
10
+ const SEVERITY = {
11
+ warning: { variant: "warn", label: "Warning", icon: "alert-triangle" },
12
+ notice: { variant: "info", label: "Notice", icon: "info-circle" },
13
+ informational: { variant: "", label: "Informational", icon: "point" },
14
+ };
15
+ function severityMeta(s) {
16
+ return SEVERITY[String(s || "").toLowerCase()] || { variant: "", label: titleCase(s) || "Event", icon: "point" };
17
+ }
18
+
19
+ const FILTERS = [
20
+ { key: "all", label: "All" },
21
+ { key: "informational", label: "Informational" },
22
+ { key: "notice", label: "Notice" },
23
+ { key: "warning", label: "Warning" },
24
+ ];
25
+
26
+ export async function render(ctx) {
27
+ const { h, icon, api, c } = ctx;
28
+
29
+ const state = { events: [], source: "pending", filter: "all", loaded: false };
30
+
31
+ const srcSlot = h("span", c.sourceBadge("pending"));
32
+ const filterHost = h("div", buildTabs());
33
+ const statHost = h("div.lt3-statrow", c.loading({ lines: 1 }));
34
+ const tableHost = h("div", c.loading({ lines: 6 }));
35
+
36
+ const root = h("div.lt3-stack-6",
37
+ c.viewHeader({
38
+ eyebrow: "Administration",
39
+ title: "Audit Logs",
40
+ sub: "Activity and access trail",
41
+ actions: [
42
+ srcSlot,
43
+ h("button.lt3-btn.lt3-btn--ghost", {
44
+ on: { click: () => ctx.toast("Audit export is not available in this build (SIEM export is an Enterprise feature).", "warn") },
45
+ }, icon("download"), "Export"),
46
+ ],
47
+ }),
48
+ statHost,
49
+ c.panel({
50
+ eyebrow: "Trail",
51
+ title: "Recent events",
52
+ head: h("div.lt3-row", { style: { "justify-content": "space-between", flex: "1 1 auto", gap: "var(--lt3-space-3)" } },
53
+ h("div", h("div.lt3-eyebrow", "Trail"), h("h3.lt3-panel__title", "Recent events")),
54
+ filterHost,
55
+ ),
56
+ children: tableHost,
57
+ }),
58
+ );
59
+
60
+ function buildTabs() {
61
+ return c.tabs(FILTERS, state.filter, (key) => {
62
+ state.filter = key;
63
+ filterHost.replaceChildren(buildTabs());
64
+ renderTable();
65
+ });
66
+ }
67
+
68
+ function visibleEvents() {
69
+ if (state.filter === "all") return state.events;
70
+ return state.events.filter((e) => String(e.severity || "").toLowerCase() === state.filter);
71
+ }
72
+
73
+ function renderStats() {
74
+ const events = state.events;
75
+ const actors = new Set(events.map((e) => e.actor).filter(Boolean)).size;
76
+ const startOfDay = new Date(); startOfDay.setHours(0, 0, 0, 0);
77
+ const today = events.filter((e) => {
78
+ const t = e.ts ? new Date(e.ts).getTime() : NaN;
79
+ return !Number.isNaN(t) && t >= startOfDay.getTime();
80
+ }).length;
81
+ const high = events.filter((e) => ["warning", "high", "critical"].includes(String(e.severity || "").toLowerCase())).length;
82
+ statHost.replaceChildren(
83
+ c.stat({ label: "Total events", value: c.fmtNum(events.length), icon: "list-details" }),
84
+ c.stat({ label: "Actors", value: c.fmtNum(actors), icon: "users" }),
85
+ c.stat({ label: "Today", value: c.fmtNum(today), icon: "calendar-event" }),
86
+ c.stat({ label: "High-severity", value: c.fmtNum(high), icon: "shield-exclamation" }),
87
+ );
88
+ }
89
+
90
+ function renderTable() {
91
+ const rows = visibleEvents();
92
+ if (!rows.length) {
93
+ tableHost.replaceChildren(state.loaded
94
+ ? c.emptyState({
95
+ icon: "history-off",
96
+ title: state.filter === "all" ? "No audit events" : "No matching events",
97
+ body: state.filter === "all"
98
+ ? "Activity will appear here as users act in the workspace."
99
+ : "No events match this severity. Try a broader filter.",
100
+ action: state.filter === "all" ? null : h("button.lt3-btn.lt3-btn--subtle.lt3-btn--sm", {
101
+ on: { click: () => { state.filter = "all"; filterHost.replaceChildren(buildTabs()); renderTable(); } },
102
+ }, icon("filter-off"), "Clear filter"),
103
+ })
104
+ : c.loading({ lines: 6 }));
105
+ return;
106
+ }
107
+ tableHost.replaceChildren(c.table(columns(ctx), rows));
108
+ }
109
+
110
+ async function load() {
111
+ const res = await api.adminAudit();
112
+ state.events = normalize(res.data);
113
+ state.source = res.source;
114
+ state.loaded = true;
115
+ srcSlot.replaceChildren(c.sourceBadge(res.source));
116
+ renderStats();
117
+ renderTable();
118
+ }
119
+
120
+ load();
121
+ return root;
122
+ }
123
+
124
+ /* ── table ───────────────────────────────────────────────────────────────── */
125
+ function columns({ h, icon, c }) {
126
+ return [
127
+ {
128
+ key: "ts", label: "Time", width: "1%",
129
+ render: (e) => h("span.lt3-mono.lt3-faint", { style: { "white-space": "nowrap", "font-size": "var(--lt3-text-2xs)" } },
130
+ e.ts ? timeAgo(e.ts) : "—"),
131
+ },
132
+ {
133
+ key: "actor", label: "Actor",
134
+ render: (e) => h("div.lt3-row-2",
135
+ h("span.lt3-avatar", { style: { width: "26px", height: "26px" } }, initials(e.actor)),
136
+ h("span", { style: { "font-size": "var(--lt3-text-sm)", "white-space": "nowrap" } }, e.actor || "system"),
137
+ ),
138
+ },
139
+ {
140
+ key: "action", label: "Action", width: "1%",
141
+ render: (e) => h("span.lt3-pill.lt3-mono", { style: { "white-space": "nowrap" } }, e.action || "event"),
142
+ },
143
+ {
144
+ key: "target", label: "Target",
145
+ render: (e) => h("span.lt3-faint", { style: { "font-size": "var(--lt3-text-sm)" } }, e.target || "—"),
146
+ },
147
+ {
148
+ key: "severity", label: "Severity", width: "1%",
149
+ render: (e) => {
150
+ const m = severityMeta(e.severity);
151
+ return c.pill(m.label, m.variant, { dot: true });
152
+ },
153
+ },
154
+ ];
155
+ }
156
+
157
+ /* ── helpers ─────────────────────────────────────────────────────────────── */
158
+ function normalize(data) {
159
+ const list = Array.isArray(data) ? data
160
+ : Array.isArray(data && data.recent_events) ? data.recent_events
161
+ : Array.isArray(data && data.events) ? data.events
162
+ : [];
163
+ return list.map((e) => ({
164
+ ts: e.ts || e.timestamp || e.time || null,
165
+ actor: e.actor || e.user || e.email || "system",
166
+ action: e.action || e.event || "event",
167
+ target: e.target || e.resource || "",
168
+ severity: e.severity || e.level || "informational",
169
+ }));
170
+ }
171
+
172
+ function initials(name) {
173
+ const s = String(name || "·").trim();
174
+ if (!s || s === "system") return "SY";
175
+ const at = s.indexOf("@");
176
+ const base = at > 0 ? s.slice(0, at) : s;
177
+ const parts = base.split(/[\s._-]+/).filter(Boolean);
178
+ if (parts.length >= 2) return (parts[0][0] + parts[1][0]).toUpperCase();
179
+ return base.slice(0, 2).toUpperCase();
180
+ }
181
+
182
+ function titleCase(s) {
183
+ s = String(s || "").trim();
184
+ return s ? s[0].toUpperCase() + s.slice(1).toLowerCase() : "";
185
+ }
@@ -0,0 +1,177 @@
1
+ /* ============================================================================
2
+ * View: Permissions — Administration · roles and capability mapping (RBAC).
3
+ * Renders the role → capability matrix and per-role summaries from the admin
4
+ * roles endpoint. Capabilities map to product areas; "all" grants everything.
5
+ * Role editing is read-only unless a backend mutation route is added.
6
+ *
7
+ * View contract (shared by all views):
8
+ * export async function render(ctx) -> single DOM node
9
+ * ctx = { h, icon, api, store, c, route, params, navigate, toast }
10
+ * ========================================================================== */
11
+
12
+ /* Capability columns, in product-area order. Each maps to a routable surface
13
+ * and a Tabler icon so the matrix reads at a glance. */
14
+ const CAPS = [
15
+ { key: "chat", label: "Chat", icon: "message-2", route: "chat" },
16
+ { key: "search", label: "Search", icon: "arrows-join", route: "hybrid-search" },
17
+ { key: "files", label: "Files", icon: "folders", route: "files" },
18
+ { key: "pipeline", label: "Pipeline", icon: "git-branch", route: "pipeline" },
19
+ { key: "users", label: "Users", icon: "users", route: "admin/users" },
20
+ { key: "policies", label: "Policies", icon: "shield-lock", route: "admin/policies" },
21
+ { key: "audit", label: "Audit", icon: "history", route: "admin/audit" },
22
+ { key: "security", label: "Security", icon: "shield-check", route: "admin/security" },
23
+ ];
24
+
25
+ const ROLE_META = {
26
+ owner: { icon: "crown", variant: "ok" },
27
+ admin: { icon: "shield-check", variant: "info" },
28
+ member: { icon: "user-check", variant: "" },
29
+ viewer: { icon: "eye", variant: "warn" },
30
+ };
31
+ const metaFor = (role) => ROLE_META[String(role).toLowerCase()] || { icon: "user", variant: "" };
32
+
33
+ /** A role grants a capability when it holds "all" or that specific cap. */
34
+ const grants = (caps, key) => Array.isArray(caps) && (caps.includes("all") || caps.includes(key));
35
+ const capLabel = (key) => (CAPS.find((cc) => cc.key === key)?.label) || key;
36
+
37
+ export async function render(ctx) {
38
+ const { h, icon, c, navigate, toast } = ctx;
39
+
40
+ // Live RBAC roles from /admin/roles.
41
+ const res = await ctx.api.adminRoles();
42
+ const roles = Array.isArray(res.data && res.data.roles) ? res.data.roles
43
+ : (Array.isArray(res.data) ? res.data : []);
44
+ const source = res.source;
45
+ const totalMembers = roles.reduce((sum, r) => sum + (r.members || 0), 0);
46
+
47
+ const root = h("div.lt3-stack-6",
48
+ c.viewHeader({
49
+ eyebrow: "Administration",
50
+ title: "Permissions",
51
+ sub: "Roles and capability mapping.",
52
+ actions: [
53
+ c.sourceBadge(source),
54
+ h("button.lt3-btn.lt3-btn--ghost", { on: { click: () => navigate("admin/users") } }, icon("users"), "Members"),
55
+ h("button.lt3-btn.lt3-btn--primary", { on: { click: () => pendingToast(toast, "Creating a role") } }, icon("plus"), "New role"),
56
+ ],
57
+ }),
58
+
59
+ c.banner(
60
+ "Access is role-based (RBAC): every member holds exactly one role, and each role grants a set of capabilities that map to product areas. The owner role grants all capabilities.",
61
+ "info",
62
+ "shield-lock",
63
+ ),
64
+
65
+ h("div.lt3-statrow",
66
+ c.stat({ label: "Roles", value: roles.length, icon: "id-badge-2" }),
67
+ c.stat({ label: "Members", value: c.fmtNum(totalMembers), icon: "users" }),
68
+ c.stat({ label: "Capabilities", value: CAPS.length, icon: "key" }),
69
+ c.stat({ label: "Full-access roles", value: roles.filter((r) => (r.caps || []).includes("all")).length, icon: "crown" }),
70
+ ),
71
+
72
+ c.panel({
73
+ eyebrow: "RBAC",
74
+ title: "Capability matrix",
75
+ sub: "Which product areas each role can reach. Scroll horizontally to see every capability.",
76
+ children: buildMatrix(ctx, roles),
77
+ }),
78
+
79
+ h("section",
80
+ c.sectionHead("Roles", c.sourceBadge(source)),
81
+ buildRoleGrid(ctx, roles),
82
+ ),
83
+ );
84
+
85
+ return root;
86
+ }
87
+
88
+ /* ── Capability matrix ──────────────────────────────────────────────────── */
89
+ function buildMatrix(ctx, roles) {
90
+ const { h, icon, c } = ctx;
91
+
92
+ if (!roles.length) {
93
+ return c.emptyState({ icon: "lock-off", title: "No roles defined", body: "Define a role to start mapping capabilities." });
94
+ }
95
+
96
+ const columns = [
97
+ {
98
+ key: "role",
99
+ label: "Role",
100
+ width: "180px",
101
+ render: (r) => {
102
+ const m = metaFor(r.role);
103
+ return h("div.lt3-row-2", { style: { "align-items": "center" } },
104
+ h("span.lt3-result__rank", { style: { color: "var(--accent)" } }, icon(m.icon)),
105
+ h("div.lt3-stack",
106
+ h("b", { style: { "font-size": "var(--lt3-text-sm)", "text-transform": "capitalize" } }, r.role),
107
+ c.pill(`${c.fmtNum(r.members || 0)} ${(r.members === 1) ? "member" : "members"}`, m.variant || "", { dot: true }),
108
+ ),
109
+ );
110
+ },
111
+ },
112
+ ...CAPS.map((cap) => ({
113
+ key: cap.key,
114
+ label: cap.label,
115
+ render: (r) => cell(ctx, grants(r.caps, cap.key)),
116
+ })),
117
+ ];
118
+
119
+ return c.table(columns, roles);
120
+ }
121
+
122
+ /** A matrix cell: accent check when granted, muted dash when not. */
123
+ function cell({ h, icon }, granted) {
124
+ return h("div", { style: { display: "grid", "place-items": "center" }, "aria-label": granted ? "granted" : "not granted" },
125
+ granted
126
+ ? h("span", { style: { color: "var(--accent)", "font-size": "var(--lt3-text-lg)", "line-height": "1" } }, icon("check"))
127
+ : h("span.lt3-faint", { style: { "font-size": "var(--lt3-text-lg)", "line-height": "1" }, "aria-hidden": "true" }, "–"),
128
+ );
129
+ }
130
+
131
+ /* ── Per-role summary cards ─────────────────────────────────────────────── */
132
+ function buildRoleGrid(ctx, roles) {
133
+ const { h } = ctx;
134
+ if (!roles.length) {
135
+ return ctx.c.emptyState({ icon: "lock-off", title: "No roles defined", body: "Define a role to map capabilities." });
136
+ }
137
+ return h("div.lt3-grid-auto", roles.map((r) => roleCard(ctx, r)));
138
+ }
139
+
140
+ function roleCard(ctx, r) {
141
+ const { h, icon, c, toast } = ctx;
142
+ const m = metaFor(r.role);
143
+ const isAll = (r.caps || []).includes("all");
144
+ const grantedKeys = isAll ? CAPS.map((cc) => cc.key) : CAPS.filter((cc) => (r.caps || []).includes(cc.key)).map((cc) => cc.key);
145
+
146
+ return c.card(
147
+ h("div.lt3-stack-3",
148
+ h("div.lt3-row", { style: { "justify-content": "space-between", "align-items": "flex-start" } },
149
+ h("div.lt3-row-2", { style: { "align-items": "center" } },
150
+ h("span.lt3-quick__icon", icon(m.icon)),
151
+ h("div.lt3-stack",
152
+ h("b", { style: { "font-size": "var(--lt3-text-md)", "text-transform": "capitalize" } }, r.role),
153
+ h("div.lt3-faint", { style: { "font-size": "var(--lt3-text-2xs)" } }, `${c.fmtNum(r.members || 0)} ${(r.members === 1) ? "member" : "members"}`),
154
+ ),
155
+ ),
156
+ c.pill(isAll ? "Full access" : `${grantedKeys.length}/${CAPS.length}`, m.variant || "info"),
157
+ ),
158
+
159
+ h("div.lt3-cluster", { "aria-label": `${r.role} capabilities` },
160
+ isAll
161
+ ? h("span.lt3-chip", { dataset: { active: "true" } }, icon("infinity"), "All capabilities")
162
+ : (grantedKeys.length
163
+ ? grantedKeys.map((k) => h("span.lt3-chip", { dataset: { active: "true" } }, icon(CAPS.find((cc) => cc.key === k).icon), capLabel(k)))
164
+ : h("span.lt3-faint", { style: { "font-size": "var(--lt3-text-xs)" } }, "No capabilities")),
165
+ ),
166
+
167
+ h("button.lt3-btn.lt3-btn--subtle.lt3-btn--sm", { style: { "align-self": "flex-start" }, on: { click: () => pendingToast(toast, `Editing the ${r.role} role`) } },
168
+ icon("edit"), "Edit role"),
169
+ ),
170
+ { attrs: { "data-role": r.role } },
171
+ );
172
+ }
173
+
174
+ /* ── Read-only affordance ───────────────────────────────────────────────── */
175
+ function pendingToast(toast, what) {
176
+ toast(`${what} is not available in this build — roles are a fixed RBAC model (owner · admin · member · viewer).`, "warn");
177
+ }