@rubytech/create-maxy-code 0.1.38 → 0.1.39

package/payload/platform/plugins/admin/mcp/dist/lib/onboarding.d.ts

@@ -0,0 +1,39 @@
+export interface OnboardingState {
+    currentStep: number;
+    step1CompletedAt: string | null;
+    step2CompletedAt: string | null;
+    step3CompletedAt: string | null;
+    step4CompletedAt: string | null;
+    step5CompletedAt: string | null;
+    step6CompletedAt: string | null;
+    step7CompletedAt: string | null;
+    step8CompletedAt: string | null;
+    step9CompletedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SessionLike {
+    run(query: string, params?: Record<string, unknown>): Promise<{
+        records: Array<{
+            get(key: string): unknown;
+        }>;
+    }>;
+    close(): Promise<void>;
+}
+/**
+ * Task 562: consume the step-7 completion flag written by setup-tunnel.sh
+ * before the service restart. The script runs inside ${BRAND}.service's
+ * cgroup and cannot complete the MCP call after dispatching the restart —
+ * so it drops a filesystem marker instead. The first read of onboarding
+ * state after the restart picks it up, advances the graph via the same
+ * CASE-WHEN-NULL cypher as completeOnboardingStep, and deletes the marker.
+ *
+ * Idempotent at every layer: a missing flag is a no-op; a flag present
+ * against an already-completed step is a no-op on the graph (CASE-WHEN-NULL
+ * preserves the existing timestamp); a crash between graph write and flag
+ * delete re-consumes on the next call with the same no-op outcome.
+ */
+export declare function consumeStep7Flag(session: SessionLike, accountId: string, accountDir: string): Promise<boolean>;
+export declare function getOnboardingState(sessionFactory: () => SessionLike, accountId: string, accountDir: string): Promise<OnboardingState>;
+export declare function completeOnboardingStep(sessionFactory: () => SessionLike, accountId: string, step: number): Promise<OnboardingState>;
+//# sourceMappingURL=onboarding.d.ts.map

package/payload/platform/plugins/admin/mcp/dist/lib/onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAC5D,OAAO,EAAE,KAAK,CAAC;YAAE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;SAAE,CAAC,CAAC;KAC/C,CAAC,CAAC;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAoED;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CA4DlB;AAgBD,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,MAAM,WAAW,EACjC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CA4E1B;AAED,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,MAAM,WAAW,EACjC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,eAAe,CAAC,CA6C1B"}

package/payload/platform/plugins/admin/mcp/dist/lib/onboarding.js

@@ -0,0 +1,249 @@
+// Onboarding state management — graph-persisted workflow state.
+// Purpose-built for Phase 0; migrates to a Workflow node with Task 13.
+import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const STEP_FIELDS = [
+    "step1CompletedAt",
+    "step2CompletedAt",
+    "step3CompletedAt",
+    "step4CompletedAt",
+    "step5CompletedAt",
+    "step6CompletedAt",
+    "step7CompletedAt",
+    "step8CompletedAt",
+    "step9CompletedAt",
+];
+// neo4j-driver v5 returns Integer objects for integer properties, not native
+// JS numbers. This converts them safely (values 0–9 are well within range).
+function toJsNumber(val) {
+    if (typeof val === "number")
+        return val;
+    if (val && typeof val === "object" && "toNumber" in val) {
+        return val.toNumber();
+    }
+    return 0;
+}
+function recordToState(record) {
+    return {
+        currentStep: toJsNumber(record.get("currentStep")),
+        step1CompletedAt: record.get("step1CompletedAt") ?? null,
+        step2CompletedAt: record.get("step2CompletedAt") ?? null,
+        step3CompletedAt: record.get("step3CompletedAt") ?? null,
+        step4CompletedAt: record.get("step4CompletedAt") ?? null,
+        step5CompletedAt: record.get("step5CompletedAt") ?? null,
+        step6CompletedAt: record.get("step6CompletedAt") ?? null,
+        step7CompletedAt: record.get("step7CompletedAt") ?? null,
+        step8CompletedAt: record.get("step8CompletedAt") ?? null,
+        step9CompletedAt: record.get("step9CompletedAt") ?? null,
+        createdAt: record.get("createdAt") ?? new Date().toISOString(),
+        updatedAt: record.get("updatedAt") ?? new Date().toISOString(),
+    };
+}
+function readMigrationStep(accountDir) {
+    try {
+        const raw = readFileSync(join(accountDir, "account.json"), "utf-8");
+        const config = JSON.parse(raw);
+        if (typeof config.onboardingStep === "number" && config.onboardingStep > 0) {
+            return config.onboardingStep;
+        }
+    }
+    catch {
+        // File missing, unreadable, or malformed — no migration data
+    }
+    return 0;
+}
+function removeOnboardingStepFromFile(accountDir) {
+    try {
+        const configPath = join(accountDir, "account.json");
+        const raw = readFileSync(configPath, "utf-8");
+        const config = JSON.parse(raw);
+        if ("onboardingStep" in config) {
+            delete config.onboardingStep;
+            writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+        }
+    }
+    catch {
+        // Tolerate cleanup failure — graph is the authority now
+    }
+}
+/**
+ * Task 562: consume the step-7 completion flag written by setup-tunnel.sh
+ * before the service restart. The script runs inside ${BRAND}.service's
+ * cgroup and cannot complete the MCP call after dispatching the restart —
+ * so it drops a filesystem marker instead. The first read of onboarding
+ * state after the restart picks it up, advances the graph via the same
+ * CASE-WHEN-NULL cypher as completeOnboardingStep, and deletes the marker.
+ *
+ * Idempotent at every layer: a missing flag is a no-op; a flag present
+ * against an already-completed step is a no-op on the graph (CASE-WHEN-NULL
+ * preserves the existing timestamp); a crash between graph write and flag
+ * delete re-consumes on the next call with the same no-op outcome.
+ */
+export async function consumeStep7Flag(session, accountId, accountDir) {
+    const flagPath = join(accountDir, "onboarding", "step7-complete");
+    if (!existsSync(flagPath))
+        return false;
+    let completedAt = new Date().toISOString();
+    try {
+        const raw = readFileSync(flagPath, "utf-8").trim();
+        if (raw) {
+            const parsed = JSON.parse(raw);
+            if (typeof parsed.completedAt === "string") {
+                completedAt = parsed.completedAt;
+            }
+        }
+    }
+    catch {
+        // Malformed flag content still advances state — the flag's presence
+        // alone is the authoritative signal; the embedded timestamp is forensic.
+    }
+    // RETURN count(o) so we can detect the "no OnboardingState node" case
+    // where SET is a silent no-op. Without this check, rmSync below would
+    // delete the flag against a graph that never applied the write, silently
+    // losing the step-7 completion signal forever.
+    const result = await session.run(`MATCH (o:OnboardingState {accountId: $accountId})
+     SET o.step7CompletedAt = CASE WHEN o.step7CompletedAt IS NULL THEN $completedAt ELSE o.step7CompletedAt END,
+         o.currentStep = CASE WHEN 7 > o.currentStep THEN 7 ELSE o.currentStep END,
+         o.updatedAt = $completedAt
+     RETURN count(o) AS updated`, { accountId, completedAt });
+    const updatedRaw = result.records[0]?.get("updated");
+    const updated = toJsNumber(updatedRaw);
+    if (updated === 0) {
+        // No OnboardingState node yet — leave the flag in place so the next
+        // reader (after node creation via MERGE in this function's migration
+        // branch below) can still consume it.
+        console.log(`[onboarding-flag-consumed] accountId=${accountId.slice(0, 8)}… step=7 ` +
+            `source=filesystem flagPath=${flagPath} skipped=no-node`);
+        return false;
+    }
+    console.log(`[onboarding-flag-consumed] accountId=${accountId.slice(0, 8)}… step=7 ` +
+        `source=filesystem flagPath=${flagPath} completedAt=${completedAt}`);
+    try {
+        rmSync(flagPath);
+    }
+    catch (err) {
+        console.error(`[onboarding-flag-consumed] warn: failed to delete ${flagPath}: ` +
+            `${err instanceof Error ? err.message : String(err)}`);
+    }
+    return true;
+}
+const READ_STATE_QUERY = `MATCH (o:OnboardingState {accountId: $accountId})
+       RETURN o.currentStep AS currentStep,
+              o.step1CompletedAt AS step1CompletedAt,
+              o.step2CompletedAt AS step2CompletedAt,
+              o.step3CompletedAt AS step3CompletedAt,
+              o.step4CompletedAt AS step4CompletedAt,
+              o.step5CompletedAt AS step5CompletedAt,
+              o.step6CompletedAt AS step6CompletedAt,
+              o.step7CompletedAt AS step7CompletedAt,
+              o.step8CompletedAt AS step8CompletedAt,
+              o.step9CompletedAt AS step9CompletedAt,
+              o.createdAt AS createdAt,
+              o.updatedAt AS updatedAt`;
+export async function getOnboardingState(sessionFactory, accountId, accountDir) {
+    const session = sessionFactory();
+    try {
+        // Check for existing graph node
+        const existing = await session.run(READ_STATE_QUERY, { accountId });
+        const nodeExisted = existing.records.length > 0;
+        if (nodeExisted) {
+            // Task 562: consume setup-tunnel.sh step-7 flag against the existing
+            // node. loadOnboardingStep (UI side) usually does this first at session
+            // start; this call is defensive in case this read precedes it.
+            //
+            // Always re-read after the consume attempt. If a concurrent caller
+            // consumed the flag between our initial read and our consumeStep7Flag
+            // call, consumeStep7Flag returns false (flag gone) but the graph still
+            // advanced — returning `existing.records[0]` would hand back the stale
+            // pre-consumption record. One extra indexed MATCH is negligible and
+            // guarantees the caller sees the authoritative state.
+            await consumeStep7Flag(session, accountId, accountDir);
+            const refreshed = await session.run(READ_STATE_QUERY, { accountId });
+            return recordToState(refreshed.records[0]);
+        }
+        // No graph node — check for migration from account.json
+        const migratedStep = readMigrationStep(accountDir);
+        const now = new Date().toISOString();
+        // Build step completion timestamps for migrated steps.
+        // account.json only stored a step counter, not per-step timestamps,
+        // so migrated steps all get the current time — the original times
+        // were never recorded.
+        const stepProps = {};
+        for (let i = 0; i < STEP_FIELDS.length; i++) {
+            stepProps[STEP_FIELDS[i]] = i < migratedStep ? now : null;
+        }
+        // Create the node via MERGE (idempotent under concurrent access)
+        const result = await session.run(`MERGE (o:OnboardingState {accountId: $accountId})
+       ON CREATE SET
+         o.currentStep = $currentStep,
+         o.step1CompletedAt = $step1CompletedAt,
+         o.step2CompletedAt = $step2CompletedAt,
+         o.step3CompletedAt = $step3CompletedAt,
+         o.step4CompletedAt = $step4CompletedAt,
+         o.step5CompletedAt = $step5CompletedAt,
+         o.step6CompletedAt = $step6CompletedAt,
+         o.step7CompletedAt = $step7CompletedAt,
+         o.step8CompletedAt = $step8CompletedAt,
+         o.step9CompletedAt = $step9CompletedAt,
+         o.createdAt = $now,
+         o.updatedAt = $now
+       RETURN o.currentStep AS currentStep,
+              o.step1CompletedAt AS step1CompletedAt,
+              o.step2CompletedAt AS step2CompletedAt,
+              o.step3CompletedAt AS step3CompletedAt,
+              o.step4CompletedAt AS step4CompletedAt,
+              o.step5CompletedAt AS step5CompletedAt,
+              o.step6CompletedAt AS step6CompletedAt,
+              o.step7CompletedAt AS step7CompletedAt,
+              o.step8CompletedAt AS step8CompletedAt,
+              o.step9CompletedAt AS step9CompletedAt,
+              o.createdAt AS createdAt,
+              o.updatedAt AS updatedAt`, { accountId, currentStep: migratedStep, now, ...stepProps });
+        // Clean up account.json if migration happened
+        if (migratedStep > 0) {
+            removeOnboardingStepFromFile(accountDir);
+        }
+        return recordToState(result.records[0]);
+    }
+    finally {
+        await session.close();
+    }
+}
+export async function completeOnboardingStep(sessionFactory, accountId, step) {
+    if (!Number.isInteger(step) || step < 1 || step > 9) {
+        throw new Error("Step must be between 1 and 9");
+    }
+    const session = sessionFactory();
+    try {
+        const stepField = STEP_FIELDS[step - 1];
+        const now = new Date().toISOString();
+        // Single query: MATCH + SET. If no node exists, MATCH returns zero
+        // records and we detect that from the result — no separate check needed.
+        const result = await session.run(`MATCH (o:OnboardingState {accountId: $accountId})
+       SET o.${stepField} = CASE WHEN o.${stepField} IS NULL THEN $now ELSE o.${stepField} END,
+           o.currentStep = CASE WHEN $step > o.currentStep THEN $step ELSE o.currentStep END,
+           o.updatedAt = $now
+       RETURN o.currentStep AS currentStep,
+              o.step1CompletedAt AS step1CompletedAt,
+              o.step2CompletedAt AS step2CompletedAt,
+              o.step3CompletedAt AS step3CompletedAt,
+              o.step4CompletedAt AS step4CompletedAt,
+              o.step5CompletedAt AS step5CompletedAt,
+              o.step6CompletedAt AS step6CompletedAt,
+              o.step7CompletedAt AS step7CompletedAt,
+              o.step8CompletedAt AS step8CompletedAt,
+              o.step9CompletedAt AS step9CompletedAt,
+              o.createdAt AS createdAt,
+              o.updatedAt AS updatedAt`, { accountId, step, now });
+        if (result.records.length === 0) {
+            throw new Error("No onboarding state found for this account. Call onboarding-get first.");
+        }
+        console.log(`[onboarding-step-complete] accountId=${accountId.slice(0, 8)}… ` +
+            `step=${step} completedAt=${now}`);
+        return recordToState(result.records[0]);
+    }
+    finally {
+        await session.close();
+    }
+}
+//# sourceMappingURL=onboarding.js.map

package/payload/platform/plugins/admin/mcp/dist/lib/onboarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../src/lib/onboarding.ts"],"names":[],"mappings":"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"}

package/payload/platform/plugins/docs/references/platform.md

@@ -70,7 +70,7 @@ There is no dashboard, no settings panel, no menus. Everything is done through c
 
 The chat input auto-grows as you type — it expands to fit your message and shrinks back when you delete text. You can also drag the resize handle above the input to set a custom height.
 
-The admin interface is a three-pane layout: a sidebar on the left with navigation (Sessions, People, Agents, Projects, Tasks, Artefacts) and your recent conversations; the chat in the middle; and an artefact pane on the right that opens when you select a document, click a project, or open Browser, Data, or Graph from the menu, holding the surface side-by-side with the conversation so the chat stays live while you work in it. Above the SESSIONS group head — outside the scrolling sessions list — a borderless row holds two controls: a "+ New session" button on the left that spawns a fresh Claude Code session, and a Mode trigger on the right showing the current permission mode (Ask, Accept edits, Plan, or Auto). Both controls render as plain text-plus-icon affordances with no surrounding rectangle; hover only tints the background. Clicking the Mode trigger opens a popover downward from the row whose header reads "Mode" and lists the four permission modes with the current selection check-marked. The sidebar's nav rows swap the list view in place: Sessions shows recent conversations, Projects shows your active work projects, and Artefacts lists every KnowledgeDocument plus this account's agent templates (your admin agent's IDENTITY, SOUL, and KNOWLEDGE files plus one entry per enabled specialist). Each recent session row carries a small status dot (filled sage for alive, hollow circle for ended) so you can read the live state at a glance without parsing the subtitle. The People, Agents, and Tasks rows are graph shortcuts: clicking each opens the artefact-pane Graph filtered to every Person, every public Agent, or every Task in your account respectively, with no side-list, because the graph itself is the result. Public agents become first-class graph entities the moment you create them, with edges to their IDENTITY/SOUL/KNOWLEDGE files, edges to every knowledge document they have access to, and edges from every conversation they have handled, so a single Agents click reveals the whole shape of who knows what and who has been talking to whom. Click an artefact row to open the document. KnowledgeDocuments and your admin agent's templates are editable: type in the document and changes save automatically; specialist agent templates are read-only because they ship with Maxy and your edits would be overwritten on the next install. PDF artefacts render inline so you can read them without leaving the pane. If your browser doesn't have a built-in PDF viewer, a Download button appears instead. Artefacts that have no readable file backing them (orphan rows, files removed from disk, unsupported content types) show a one-line banner explaining the skip instead of opening to a blank pane. Click a project row to open the Graph view focused on that project's neighbourhood; clicking a second project swaps the focus rather than stacking on top. The chat and artefact divider is drag-resizable: drag the line between the columns to make either side wider; double-click it to reset to half of the available width (viewport minus sidebar), clamped to the chat and artefact min-width floors. Your chosen width is remembered across reloads. On wider screens (>1280px) all three panes are visible. The sidebar narrows at 1280px, the artefact pane hides at 1080px (Browser, Data, and Graph then open as full-window pages instead), and the sidebar collapses to a 56px icon rail at 820px. On every viewport the chat header reads left to right as a triptych: a dedicated sidebar toggle (the panel-right icon, which swaps to panel-right-open when the sidebar is showing), the brand mark next to the title in the centre, and the menu burger on the right. This header toggle is the sole sidebar-toggle button; the sidebar itself no longer carries a duplicate. Tap the sidebar toggle to show or hide the sidebar: on phones (<720px) it slides the drawer in or out, on wider screens it collapses or expands the sidebar column. The brand mark in the centre is decorative; clicks go through the dedicated toggle so the affordance is unambiguous. The drawer animation only fires on tap (220ms slide in or out); resizing your window across the 720px boundary snaps the layout without animation, so you never see a half-open flash. At ≤640px the session metadata pane stacks each label above its value instead of the desktop two-column grid, and the row of action buttons (Open in new tab / Open JSONL / Rename / Pin / Archive / End or Purge) collapses behind a single Actions trigger that opens a popover upward from the foot of the pane. Breakpoint summary: >1280px = full sidebar + chat + artefact pane (drag-resizable divider); 1280px→1080px = sidebar narrows; 1080px→820px = artefact pane hides (Browser/Data/Graph open as full-window pages instead); 820px→720px = sidebar collapses to 56px icon rail; ≤720px = sidebar becomes off-canvas drawer (vertical stack of nav, recents list, foot, the same shape as the desktop sidebar, just on top of the chat instead of beside it).
+The admin interface is a three-pane layout: a sidebar on the left with navigation (Sessions, People, Agents, Projects, Tasks, Artefacts) and your recent conversations; the chat in the middle; and an artefact pane on the right that opens when you select a document, click a project, or open Browser, Data, or Graph from the menu, holding the surface side-by-side with the conversation so the chat stays live while you work in it. At the very top of the sidebar — above the nav rows — a borderless row holds two controls: a "+ New session" button on the left that spawns a fresh Claude Code session, and a Mode trigger on the right showing the current permission mode (Ask, Accept edits, Plan, or Auto). The sidebar's vertical order is: new-session strip first, then the nav (Sessions, People, Agents, Projects, Tasks, Artefacts), then the sessions list, then the footer. Both controls render as plain text-plus-icon affordances with no surrounding rectangle; hover only tints the background. Clicking the Mode trigger opens a popover downward from the row whose header reads "Mode" and lists the four permission modes with the current selection check-marked. The sidebar's nav rows swap the list view in place: Sessions shows recent conversations, Projects shows your active work projects, and Artefacts lists every KnowledgeDocument plus this account's agent templates (your admin agent's IDENTITY, SOUL, and KNOWLEDGE files plus one entry per enabled specialist). Each recent session row carries a small status dot (filled sage for alive, hollow circle for ended) so you can read the live state at a glance without parsing the subtitle. The People, Agents, and Tasks rows are graph shortcuts: clicking each opens the artefact-pane Graph filtered to every Person, every public Agent, or every Task in your account respectively, with no side-list, because the graph itself is the result. Public agents become first-class graph entities the moment you create them, with edges to their IDENTITY/SOUL/KNOWLEDGE files, edges to every knowledge document they have access to, and edges from every conversation they have handled, so a single Agents click reveals the whole shape of who knows what and who has been talking to whom. Click an artefact row to open the document. KnowledgeDocuments and your admin agent's templates are editable: type in the document and changes save automatically; specialist agent templates are read-only because they ship with Maxy and your edits would be overwritten on the next install. PDF artefacts render inline so you can read them without leaving the pane. If your browser doesn't have a built-in PDF viewer, a Download button appears instead. Artefacts that have no readable file backing them (orphan rows, files removed from disk, unsupported content types) show a one-line banner explaining the skip instead of opening to a blank pane. Click a project row to open the Graph view focused on that project's neighbourhood; clicking a second project swaps the focus rather than stacking on top. The chat and artefact divider is drag-resizable: drag the line between the columns to make either side wider; double-click it to reset to half of the available width (viewport minus sidebar), clamped to the chat and artefact min-width floors. Your chosen width is remembered across reloads. On wider screens (>1280px) all three panes are visible. The sidebar narrows at 1280px, the artefact pane hides at 1080px (Browser, Data, and Graph then open as full-window pages instead), and the sidebar collapses to a 56px icon rail at 820px. On every viewport the chat header reads left to right as a triptych: a dedicated sidebar toggle (the panel-right icon, which swaps to panel-right-open when the sidebar is showing), the brand mark next to the title in the centre, and the menu burger on the right. This header toggle is the sole sidebar-toggle button; the sidebar itself no longer carries a duplicate. Tap the sidebar toggle to show or hide the sidebar: on phones (<720px) it slides the drawer in or out, on wider screens it collapses or expands the sidebar column. The brand mark in the centre is decorative; clicks go through the dedicated toggle so the affordance is unambiguous. The drawer animation only fires on tap (220ms slide in or out); resizing your window across the 720px boundary snaps the layout without animation, so you never see a half-open flash. At ≤640px the session metadata pane stacks each label above its value instead of the desktop two-column grid, and the row of action buttons (Open in new tab / Open JSONL / Rename / Pin / Archive / End or Purge) collapses behind a single Actions trigger that opens a popover upward from the foot of the pane. Breakpoint summary: >1280px = full sidebar + chat + artefact pane (drag-resizable divider); 1280px→1080px = sidebar narrows; 1080px→820px = artefact pane hides (Browser/Data/Graph open as full-window pages instead); 820px→720px = sidebar collapses to 56px icon rail; ≤720px = sidebar becomes off-canvas drawer (vertical stack of nav, recents list, foot, the same shape as the desktop sidebar, just on top of the chat instead of beside it).
 
 Page titles are brand-aware: the browser tab shows your product name (e.g. `Real Agent` instead of `Maxy`) on every shell — chat, graph, and data — so a non-default brand never leaks the default name in tab strips or browser history.
 

package/payload/platform/plugins/real-agency/plugins/.claude-plugin/marketplace.json

@@ -0,0 +1,13 @@
+{
+  "name": "maxy-premium-real-agency",
+  "owner": {
+    "name": "Rubytech LLC"
+  },
+  "plugins": [
+    {
+      "name": "loop",
+      "source": "./loop",
+      "version": "0.1.0"
+    }
+  ]
+}

package/payload/platform/plugins/real-agency/plugins/loop/.claude-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+  "name": "loop",
+  "description": "loop plugin",
+  "version": "0.1.0",
+  "author": {
+    "name": "Rubytech LLC"
+  },
+  "mcpServers": {
+    "loop": {
+      "type": "stdio",
+      "command": "node",
+      "args": [
+        "${CLAUDE_PLUGIN_ROOT}/mcp/dist/index.js"
+      ]
+    }
+  }
+}

package/payload/platform/plugins/real-agency/plugins/loop/mcp/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/payload/platform/plugins/real-agency/plugins/loop/mcp/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}