Skip to content

armgit / mso

Public Imported from GitHub
0

Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.

feat(organization): surface as first-class app

Rahmand393347d60a8
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index b578a72d..f0c17494 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -8,6 +8,7 @@ this is the *what*, and it is what Settings → About shows as “What's new”.
**Added**
+- `organization` surface as first-class app
- `organization` add agent org chart and routing
- `workflows` complete server-native automation parity
- `workflows` add server-native workflow graph
diff --git a/docs/ORGANIZATION.md b/docs/ORGANIZATION.md
index 0240a279..619cb08b 100644
--- a/docs/ORGANIZATION.md
+++ b/docs/ORGANIZATION.md
@@ -100,7 +100,7 @@ This is a private runtime store. MSO source ships **no operator-specific organiz
## UI
-Open **Alfa → Organization**.
+Open the first-class **Organization** app from the dock, launcher, Start menu, App Library, Spotlight, or `/organization`. **Alfa → Organization** remains a secondary deep-link to the same view and SSOT.
The default `All organization` view renders the complete reporting hierarchy across units. Selecting a unit filters the view while keeping the same SSOT. Seat cards show role, unit, seat mode, execution binding, and current runtime state.
diff --git a/docs/SLICE-CATALOG.md b/docs/SLICE-CATALOG.md
index 10d5a193..45285250 100644
--- a/docs/SLICE-CATALOG.md
+++ b/docs/SLICE-CATALOG.md
@@ -3,12 +3,12 @@
> **Current reference.** Counts are checked against the directory tree by
> `scripts/check-docs.mjs`; the directory remains the final authority.
-<!-- slice-catalog: slices=24 appshell-features=10 -->
+<!-- slice-catalog: slices=25 appshell-features=10 -->
Every application is a vertical slice under `frontend/slices/`. Host-facing slices use the
shared API/host seam rather than reaching arbitrary Node host APIs from client code.
-## Slices (24)
+## Slices (25)
| Slug | Purpose |
|---|---|
@@ -31,6 +31,7 @@ shared API/host seam rather than reaching arbitrary Node host APIs from client c
| `os-settings` | MSO Settings |
| `os-shell` | MSO consumer manifest/capabilities for AppShell |
| `os-terminal` | Interactive PTY Terminal / Claude Code surface |
+| `organization` | Owner-private organization chart, reporting lines, seat state, and execution bindings |
| `quicklinks` | Website shortcuts/favicons |
| `reel-editor` | Video/reel timeline editor |
| `shell-settings` | Shared shell settings UI primitives |
diff --git a/frontend/slices/appshell/components/mobile-app-library.tsx b/frontend/slices/appshell/components/mobile-app-library.tsx
index c6613909..9debec69 100644
--- a/frontend/slices/appshell/components/mobile-app-library.tsx
+++ b/frontend/slices/appshell/components/mobile-app-library.tsx
@@ -21,9 +21,12 @@ const CATEGORY: Record<string, string> = {
"create-app": "Develop",
browser: "Web & AI",
assistant: "Web & AI",
+ organization: "Work & Automation",
+ workflows: "Work & Automation",
+ integrations: "Work & Automation",
"app-store": "Web & AI",
};
-const ORDER = ["Files & System", "Creative", "Develop", "Web & AI", "Other"];
+const ORDER = ["Files & System", "Creative", "Develop", "Work & Automation", "Web & AI", "Other"];
// iPhone App Library: category folder-cards by default; an A–Z list while the
// search field has text. Tapping a folder's cluster (or its label) opens it.
diff --git a/frontend/slices/assistant/CONTRACT.md b/frontend/slices/assistant/CONTRACT.md
index d9b256eb..7c94de52 100644
--- a/frontend/slices/assistant/CONTRACT.md
+++ b/frontend/slices/assistant/CONTRACT.md
@@ -98,7 +98,7 @@ complete. See [`docs/MCP.md`](../../../docs/MCP.md) and [`skills/README.md`](../
## Organization (not an Alfa persona)
-The **Organization** tab is a server-side owner-private operating-structure view, not another browser Agent persona store. Its SSOT is `~/.mso/private/organization.json` via `lib/agent/organization-store.ts`. Units and seats define stable hierarchy/reporting context; a seat can point at an existing Project Agent, Local Agent/session, or A2A peer. Those references grant no extra tools or credentials. Workflows may resolve `orgSeatId` at execution time. See [`docs/ORGANIZATION.md`](../../../docs/ORGANIZATION.md).
+Organization is a first-class app/domain with a secondary **Organization** tab inside Alfa. Both render the same server-side owner-private SSOT at `~/.mso/private/organization.json` via `lib/agent/organization-store.ts`; Alfa does not own or duplicate it. Units and seats define stable hierarchy/reporting context; a seat can point at an existing Project Agent, Local Agent/session, or A2A peer. Those references grant no extra tools or credentials. Workflows may resolve `orgSeatId` at execution time. See [`docs/ORGANIZATION.md`](../../../docs/ORGANIZATION.md).
## Agent
diff --git a/frontend/slices/assistant/app.tsx b/frontend/slices/assistant/app.tsx
index ac778e29..06769275 100644
--- a/frontend/slices/assistant/app.tsx
+++ b/frontend/slices/assistant/app.tsx
@@ -17,7 +17,7 @@ import { ThreadList } from "./components/thread-list";
import { LibraryGrid } from "./components/library-grid";
import { SkillForm } from "./components/skill-form";
import { McpActivityView } from "./components/mcp-activity-view";
-import { OrganizationView } from "./components/organization-view";
+import { OrganizationView } from "@/features/organization";
import { AlfaCockpitBar } from "./components/alfa-cockpit-bar";
import { assistantRouteFromPayload, type AssistantTab } from "./lib/navigation";
diff --git a/frontend/slices/organization/app.tsx b/frontend/slices/organization/app.tsx
new file mode 100644
index 00000000..aa3e8347
--- /dev/null
+++ b/frontend/slices/organization/app.tsx
@@ -0,0 +1,13 @@
+"use client";
+
+import type { AppProps } from "@/features/appshell";
+import { AppFrame } from "@/features/appshell";
+import { OrganizationView } from "./components/organization-view";
+
+export default function OrganizationApp(_props: AppProps) {
+ return (
+ <AppFrame safeArea={false} className="h-full bg-background" bodyClassName="overflow-hidden">
+ <OrganizationView />
+ </AppFrame>
+ );
+}
diff --git a/frontend/slices/assistant/components/organization-editor.tsx b/frontend/slices/organization/components/organization-editor.tsx
similarity index 100%
rename from frontend/slices/assistant/components/organization-editor.tsx
rename to frontend/slices/organization/components/organization-editor.tsx
diff --git a/frontend/slices/assistant/components/organization-tree.tsx b/frontend/slices/organization/components/organization-tree.tsx
similarity index 100%
rename from frontend/slices/assistant/components/organization-tree.tsx
rename to frontend/slices/organization/components/organization-tree.tsx
diff --git a/frontend/slices/assistant/components/organization-view.tsx b/frontend/slices/organization/components/organization-view.tsx
similarity index 100%
rename from frontend/slices/assistant/components/organization-view.tsx
rename to frontend/slices/organization/components/organization-view.tsx
diff --git a/frontend/slices/organization/index.ts b/frontend/slices/organization/index.ts
new file mode 100644
index 00000000..49ea0ea8
--- /dev/null
+++ b/frontend/slices/organization/index.ts
@@ -0,0 +1,13 @@
+import { Network } from "lucide-react";
+import type { AppDescriptor } from "@/features/appshell";
+
+export const organizationApp: AppDescriptor = {
+ id: "organization",
+ title: "Organization",
+ icon: Network,
+ gradient: "linear-gradient(160deg,#2563eb,#0f172a)",
+ load: () => import("./app"),
+ defaultSize: { w: 1120, h: 720 },
+};
+
+export { OrganizationView } from "./components/organization-view";
diff --git a/frontend/slices/assistant/lib/organization-api.ts b/frontend/slices/organization/lib/organization-api.ts
similarity index 100%
rename from frontend/slices/assistant/lib/organization-api.ts
rename to frontend/slices/organization/lib/organization-api.ts
diff --git a/frontend/slices/os-shell/organization-app.test.ts b/frontend/slices/os-shell/organization-app.test.ts
new file mode 100644
index 00000000..b0d10bfb
--- /dev/null
+++ b/frontend/slices/os-shell/organization-app.test.ts
@@ -0,0 +1,12 @@
+import { describe, expect, it } from "vitest";
+import { BUILTIN_APPS } from "./shell.manifest";
+
+describe("Organization app registration", () => {
+ it("exposes Organization as a first-class built-in route", () => {
+ const app = BUILTIN_APPS.find((item) => item.id === "organization");
+ expect(app).toBeDefined();
+ expect(app?.title).toBe("Organization");
+ expect(app?.slug).toBe("organization");
+ expect(app?.noDock).not.toBe(true);
+ });
+});
diff --git a/frontend/slices/os-shell/shell.manifest.ts b/frontend/slices/os-shell/shell.manifest.ts
index f416454f..c485bee6 100644
--- a/frontend/slices/os-shell/shell.manifest.ts
+++ b/frontend/slices/os-shell/shell.manifest.ts
@@ -22,6 +22,7 @@ import { quicklinksApp } from "@/features/quicklinks";
import { docsApp } from "@/features/docs";
import { integrationsApp } from "@/features/integrations";
import { workflowsApp } from "@/features/workflows";
+import { organizationApp } from "@/features/organization";
import { cloudflareApp, dokployApp } from "@/features/infrastructure";
import { themeQuickPickerFeature } from "./theme-quick-picker";
import { serverConnectionStatusFeature } from "./server-connection-status";
@@ -69,6 +70,7 @@ export const BUILTIN_APPS: AppDescriptor[] = [
withSlug(withArtwork(nineRouterApp), "9router"),
pin(withSlug(integrationsApp, "connections")),
pin(withSlug(withArtwork(workflowsApp), "workflows")),
+ withSlug(withArtwork(organizationApp), "organization"),
withSlug(withArtwork(dokployApp), "dokploy"),
withSlug(withArtwork(cloudflareApp), "cloudflare"),
withSlug(withArtwork(quicklinksApp), "links"),