Skip to content

Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS

fix: show real wiki maintenance job state in empty Health Report and link vault setup (#11896)

Adam Eivy54627eea6ef8
diff --git a/client/src/components/wiki/tabs/OverviewTab.jsx b/client/src/components/wiki/tabs/OverviewTab.jsx
index 36e3f3f135..7f27e30da2 100644
--- a/client/src/components/wiki/tabs/OverviewTab.jsx
+++ b/client/src/components/wiki/tabs/OverviewTab.jsx
@@ -1,10 +1,50 @@
import { useState, useEffect, useMemo } from 'react';
-import { useNavigate, useSearchParams } from 'react-router';
+import { Link, useNavigate, useSearchParams } from 'react-router';
import * as api from '../../../services/api';
import { FolderOpen, RefreshCw, AlertTriangle } from 'lucide-react';
-import { timeAgo } from '../../../utils/formatters';
+import { timeAgo, formatDateTime } from '../../../utils/formatters';
import { WIKI_CATEGORIES, PageTypeIcon } from '../constants.jsx';
+const WIKI_JOB_ID = 'job-wiki-maintenance';
+
+// Reads the maintenance job's real state; 'unavailable' keeps a failed fetch
+// from reading as "off". Read-only: never runs the job.
+function WikiMaintenanceStatus() {
+ const [state, setState] = useState({ status: 'loading', job: null });
+
+ useEffect(() => {
+ let cancelled = false;
+ api.getCosJobs({ silent: true })
+ .then(data => {
+ if (cancelled) return;
+ const job = (data?.jobs || []).find(j => j.id === WIKI_JOB_ID) || null;
+ setState({ status: 'ready', job });
+ })
+ .catch(() => { if (!cancelled) setState({ status: 'unavailable', job: null }); });
+ return () => { cancelled = true; };
+ }, []);
+
+ const { status, job } = state;
+ if (status === 'loading') return null;
+ if (status === 'unavailable') {
+ return <p className="text-xs text-gray-600 mt-1">Wiki maintenance job status is unavailable right now.</p>;
+ }
+ if (job?.enabled) {
+ return (
+ <p className="text-xs text-gray-600 mt-1">
+ Weekly wiki maintenance is on
+ {job.nextRunAt ? <> — next run {formatDateTime(job.nextRunAt)}</> : null}.
+ </p>
+ );
+ }
+ return (
+ <p className="text-xs text-gray-600 mt-1">
+ Weekly wiki maintenance is off. Enable or run it in{' '}
+ <Link to="/cos/jobs" className="text-port-accent hover:underline">System Tasks</Link>.
+ </p>
+ );
+}
+
export default function OverviewTab({ vaultId, stats, notes, allNotes, onRefresh }) {
const navigate = useNavigate();
const [searchParams] = useSearchParams();
@@ -65,7 +105,7 @@ export default function OverviewTab({ vaultId, stats, notes, allNotes, onRefresh
</div>
<div className="divide-y divide-port-border/50">
{recentPages.length === 0 ? (
- <div className="p-4 text-center text-gray-500 text-sm">No wiki pages yet</div>
+ <div className="p-4 text-center text-gray-500 text-sm">No wiki pages yet. Add source files to the <code className="text-gray-300">raw/</code> folder in your vault.</div>
) : recentPages.map(note => (
<button
key={note.path}
@@ -104,7 +144,7 @@ export default function OverviewTab({ vaultId, stats, notes, allNotes, onRefresh
<div className="text-center py-6">
<AlertTriangle size={24} className="text-gray-600 mx-auto mb-2" />
<p className="text-sm text-gray-500">No lint report yet</p>
- <p className="text-xs text-gray-600 mt-1">The weekly wiki maintenance job will generate one, or ask the LLM to lint the wiki</p>
+ <WikiMaintenanceStatus />
</div>
)}
</div>
diff --git a/client/src/components/wiki/tabs/OverviewTab.test.jsx b/client/src/components/wiki/tabs/OverviewTab.test.jsx
new file mode 100644
index 0000000000..4102660110
--- /dev/null
+++ b/client/src/components/wiki/tabs/OverviewTab.test.jsx
@@ -0,0 +1,45 @@
+import { render, screen, waitFor } from '@testing-library/react';
+import { MemoryRouter } from 'react-router';
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import OverviewTab from './OverviewTab';
+import * as api from '../../../services/api';
+
+vi.mock('../../../services/api');
+
+const stats = { rawSources: 0, total: 0 };
+
+function renderTab() {
+ return render(
+ <MemoryRouter>
+ <OverviewTab vaultId="v1" stats={stats} notes={[]} allNotes={[]} onRefresh={() => {}} />
+ </MemoryRouter>
+ );
+}
+
+describe('OverviewTab empty Health Report', () => {
+ beforeEach(() => vi.clearAllMocks());
+
+ it('says maintenance is off and links to System Tasks when the job is disabled', async () => {
+ api.getCosJobs.mockResolvedValue({ jobs: [{ id: 'job-wiki-maintenance', enabled: false }] });
+ renderTab();
+ expect(await screen.findByText(/Weekly wiki maintenance is off/)).toBeTruthy();
+ expect(screen.getByRole('link', { name: 'System Tasks' }).getAttribute('href')).toBe('/cos/jobs');
+ expect(screen.queryByText(/will generate/)).toBeNull();
+ });
+
+ it('shows the next run when the job is enabled', async () => {
+ api.getCosJobs.mockResolvedValue({
+ jobs: [{ id: 'job-wiki-maintenance', enabled: true, nextRunAt: '2030-01-06T03:00:00.000Z' }],
+ });
+ renderTab();
+ expect(await screen.findByText(/Weekly wiki maintenance is on/)).toBeTruthy();
+ expect(screen.getByText(/next run/)).toBeTruthy();
+ });
+
+ it('reports unavailable status instead of off when the jobs request fails', async () => {
+ api.getCosJobs.mockRejectedValue(new Error('boom'));
+ renderTab();
+ await waitFor(() => expect(screen.getByText(/status is unavailable/)).toBeTruthy());
+ expect(screen.queryByText(/is off/)).toBeNull();
+ });
+});
diff --git a/client/src/pages/Wiki.jsx b/client/src/pages/Wiki.jsx
index 5d32172366..29b1842071 100644
--- a/client/src/pages/Wiki.jsx
+++ b/client/src/pages/Wiki.jsx
@@ -1,5 +1,5 @@
import { useState, useEffect, useCallback, useMemo, useRef } from 'react';
-import { useParams, useNavigate, useSearchParams } from 'react-router';
+import { Link, useParams, useNavigate, useSearchParams } from 'react-router';
import * as api from '../services/api';
import { BookOpen, Search, Network, FileText, BarChart3, Activity } from 'lucide-react';
import LoadFailedState from '../components/ui/LoadFailedState';
@@ -160,7 +160,7 @@ export default function Wiki() {
<div className="flex flex-col items-center justify-center h-full text-gray-500">
<BookOpen size={48} className="mb-3 opacity-30" />
<p className="text-sm">No Obsidian vaults connected</p>
- <p className="text-xs mt-1">Go to Brain &gt; Notes to connect a vault first</p>
+ <p className="text-xs mt-1">Go to <Link to="/brain/notes" className="text-port-accent hover:underline">Brain &gt; Notes</Link> to connect a vault first</p>
</div>
);
}