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
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
fix: show unavailable Prompt Manager catalogues instead of empty or deleted records (#11143)
[._.]/ Adam Eivyef304d471324
diff --git a/client/src/pages/PromptManager.jsx b/client/src/pages/PromptManager.jsxindex 4f1b5d0e94..0c4f78ed25 100644--- a/client/src/pages/PromptManager.jsx+++ b/client/src/pages/PromptManager.jsx@@ -40,6 +40,17 @@ const PAGE_SUBTITLE = 'Customize AI prompts for backend operations';const VAR_FORM_FIELDS = ['key', 'name', 'category', 'content'];const BLANK_VAR_FORM = Object.freeze({ key: '', name: '', category: '', content: '' });+// Names what failed and how to recover. `stale` means rows from an earlier+// successful read are still shown.+function CatalogueNotice({ label, stale, onRetry }) {+ return (+ <div role="alert" className="mb-2 rounded-lg border border-port-warning/40 bg-port-warning/10 px-3 py-2 text-xs text-port-warning">+ <div>{stale ? `${label} may be out of date — the last refresh failed.` : `${label} are unavailable right now.`}</div>+ <button onClick={onRetry} className="mt-1 text-port-accent hover:underline">Retry {label.toLowerCase()}</button>+ </div>+ );+}+export default function PromptManager() {const [searchParams, setSearchParams] = useSearchParams();const rawTab = searchParams.get('tab');@@ -75,6 +86,17 @@ export default function PromptManager() {const [systemStageKeys, setSystemStageKeys] = useState([]);const [variables, setVariables] = useState({});const [loading, setLoading] = useState(true);+ const [catalogueState, setCatalogueState] = useState({+ stages: { failed: false, loaded: false },+ variables: { failed: false, loaded: false },+ skills: { failed: false, loaded: false },+ providers: { failed: false, loaded: false },+ });+ const catalogueSeqRef = useRef({});+ const stagesFailed = catalogueState.stages.failed;+ const variablesFailed = catalogueState.variables.failed;+ const skillsFailed = catalogueState.skills.failed;+ const providersFailed = catalogueState.providers.failed;// Stage list search / grouping. The query is deliberately LOCAL, not a URL// param: it's a transient way to reach a stage, and the thing worth@@ -219,26 +241,53 @@ export default function PromptManager() {loadData();}, []);+ // Each catalogue loads, fails and retries on its own. A failed read keeps the+ // rows already on screen (flagged stale) and never reads as an empty list, so+ // "unavailable" can't be mistaken for "no records" or "deleted".+ const CATALOGUES = {+ stages: {+ load: () => getPrompts({ silent: true }),+ apply: (res) => {+ setStages(res.stages || {});+ // `Array.isArray` rather than `|| []`: an older server that predates the+ // `systemStages` key sends nothing, which must read as "no system stages+ // known" (no badges, empty System-only filter) — never as a crash.+ setSystemStageKeys(Array.isArray(res.systemStages) ? res.systemStages : []);+ },+ },+ variables: { load: () => getPromptVariables({ silent: true }), apply: (res) => setVariables(res.variables || {}) },+ skills: { load: () => getJobSkills({ silent: true }), apply: (res) => setJobSkills(res.skills || []) },+ providers: {+ load: () => getProviders({ silent: true }),+ apply: (res) => {+ setProviders((res.providers || []).filter(p => p.enabled));+ setActiveProviderId(res.activeProvider || null);+ },+ },+ };++ const loadCatalogues = async (keys) => {+ await Promise.all(keys.map(async (key) => {+ const seq = (catalogueSeqRef.current[key] || 0) + 1;+ catalogueSeqRef.current[key] = seq;+ const res = await CATALOGUES[key].load().catch(() => null);+ if (catalogueSeqRef.current[key] !== seq) return;+ if (res && typeof res === 'object') {+ CATALOGUES[key].apply(res);+ setCatalogueState((prev) => ({ ...prev, [key]: { failed: false, loaded: true } }));+ } else {+ setCatalogueState((prev) => ({ ...prev, [key]: { ...prev[key], failed: true } }));+ }+ }));+ };+const loadData = async () => {- setLoading(true);- const [stagesRes, varsRes, jobSkillsRes, providersRes] = await Promise.all([- getPrompts({ silent: true }).catch(() => ({ stages: {}, systemStages: [] })),- getPromptVariables({ silent: true }).catch(() => ({ variables: {} })),- getJobSkills({ silent: true }).catch(() => ({ skills: [] })),- getProviders({ silent: true }).catch(() => ({ providers: [] }))- ]);- setStages(stagesRes.stages || {});- // `Array.isArray` rather than `|| []`: an older server that predates the- // `systemStages` key sends nothing, which must read as "no system stages- // known" (no badges, empty System-only filter) — never as a crash.- setSystemStageKeys(Array.isArray(stagesRes.systemStages) ? stagesRes.systemStages : []);- setVariables(varsRes.variables || {});- setJobSkills(jobSkillsRes.skills || []);- setProviders((providersRes.providers || []).filter(p => p.enabled));- setActiveProviderId(providersRes.activeProvider || null);+ await loadCatalogues(Object.keys(CATALOGUES));setLoading(false);};+ const retryCatalogue = (key) => loadCatalogues([key]);+// Fetch the URL-selected stage's template + config. Keyed on selectedStage so// a deep link / reload restores the open editor; a cleared param resets it.useEffect(() => {@@ -761,10 +810,13 @@ export default function PromptManager() {System only</button><span className="text-xs text-gray-500">- {stageFilterActive ? `${stageMatchCount} of ${stageTotalCount}` : `${stageTotalCount} stages`}+ {stagesFailed && !catalogueState.stages.loaded ? 'Unavailable' : stageFilterActive ? `${stageMatchCount} of ${stageTotalCount}` : `${stageTotalCount} stages`}</span></div></div>+ {stagesFailed && (+ <CatalogueNotice label="Stages" stale={catalogueState.stages.loaded} onRetry={() => retryCatalogue('stages')} />+ )}<div className="space-y-1">{stageGroups.map(({ key: groupKey, label, stages: groupStages }) => {// A filter flips the default open — hits hidden behind collapsed@@ -839,7 +891,7 @@ export default function PromptManager() {</div>);})}- {stageGroups.length === 0 && (+ {stageGroups.length === 0 && !(stagesFailed && !catalogueState.stages.loaded) && (<div className="text-sm text-gray-500 px-3 py-2">{stageFilterActive ? 'No stages match that search' : 'No prompt stages found'}</div>@@ -849,7 +901,7 @@ export default function PromptManager() {{/* Stage Editor */}<div className="lg:col-span-2 space-y-4">- {selectedStage && !stages[selectedStage] ? (+ {selectedStage && !stages[selectedStage] && !stagesFailed ? (<div className="bg-port-card border border-port-border rounded-xl p-12 text-center text-gray-500">That stage could not be found — it may have been deleted or renamed.{' '}<button onClick={() => setSelectedStage(null)} className="text-port-accent hover:underline">@@ -928,6 +980,9 @@ export default function PromptManager() {</button></div></div>+ {providersFailed && (+ <CatalogueNotice label="Providers" stale={catalogueState.providers.loaded} onRetry={() => retryCatalogue('providers')} />+ )}{!stageConfig.provider ? (<selectdisabled={!stageReady}@@ -1018,6 +1073,9 @@ export default function PromptManager() {<Plus size={16} /></button></div>+ {variablesFailed && (+ <CatalogueNotice label="Variables" stale={catalogueState.variables.loaded} onRetry={() => retryCatalogue('variables')} />+ )}<div className="space-y-1">{/* The "+" has no list row of its own, so its discard questiontakes the top of the list. The dirty check is part of the@@ -1097,7 +1155,14 @@ export default function PromptManager() {{/* Variable Editor */}<div className="lg:col-span-2">- {selectedVar && !variables[selectedVar] ? (+ {selectedVar && !variables[selectedVar] && variablesFailed ? (+ <div className="bg-port-card border border-port-border rounded-xl p-12 text-center text-gray-500">+ The variable list is unavailable, so this variable cannot be shown.{' '}+ <button onClick={() => retryCatalogue('variables')} className="text-port-accent hover:underline">+ Retry variables+ </button>+ </div>+ ) : selectedVar && !variables[selectedVar] ? (<div className="bg-port-card border border-port-border rounded-xl p-12 text-center text-gray-500">That variable could not be found — it may have been deleted.{' '}<button onClick={() => switchVariable(null)} className="text-port-accent hover:underline">@@ -1185,6 +1250,9 @@ export default function PromptManager() {<h3 className="text-sm font-medium text-gray-400">Autonomous Job Skills</h3><p className="text-xs text-gray-500 mt-1">Versioned prompt templates for recurring jobs</p></div>+ {skillsFailed && (+ <CatalogueNotice label="Job skills" stale={catalogueState.skills.loaded} onRetry={() => retryCatalogue('skills')} />+ )}<div className="space-y-1">{jobSkills.map((skill) => (// The dirty check is part of the render condition, not just of@@ -1229,7 +1297,7 @@ export default function PromptManager() {</button>)))}- {jobSkills.length === 0 && (+ {jobSkills.length === 0 && !skillsFailed && (<div className="text-sm text-gray-500 px-3 py-2">No job skill templates found</div>)}</div>diff --git a/client/src/pages/PromptManager.test.jsx b/client/src/pages/PromptManager.test.jsxindex 7b72037ceb..5d65b854b9 100644--- a/client/src/pages/PromptManager.test.jsx+++ b/client/src/pages/PromptManager.test.jsx@@ -1312,3 +1312,70 @@ describe.each([expect(box().disabled).toBe(false);});});++describe('PromptManager unavailable catalogues (#11143)', () => {+ const SKILLS = [{ name: 'code-fixer', jobId: 'job-code-fixer', hasTemplate: true }];+ const VARS = { 'tone-guide': { name: 'Tone Guide', category: 'style', content: 'Be brief' } };+ const down = () => Promise.reject(new Error('503'));++ beforeEach(() => {+ getPrompts.mockReset().mockResolvedValue({ stages: STAGES, systemStages: SYSTEM_STAGES });+ getPrompt.mockReset().mockResolvedValue({ name: 'Pipeline — Prose Draft', template: 'body', variables: [] });+ getPromptUsage.mockReset().mockResolvedValue({ isSystemStage: false, usedBy: [], referencedBy: [], canDelete: true });+ getPromptVariables.mockReset().mockResolvedValue({ variables: VARS });+ getJobSkills.mockReset().mockResolvedValue({ skills: SKILLS });+ getJobSkill.mockReset().mockResolvedValue({ content: '# t', jobName: 'Job', jobId: 'job-code-fixer' });+ });++ it('names a failed stage catalogue without claiming the deep-linked stage was deleted, and recovers on Retry', async () => {+ getPrompts.mockReset().mockImplementationOnce(down).mockResolvedValue({ stages: STAGES, systemStages: SYSTEM_STAGES });+ await renderPage('/prompts?stage=pipeline-prose-draft');+ await screen.findByText(/Stages are unavailable/);+ expect(screen.queryByText('No prompt stages found')).toBeNull();+ expect(screen.queryByText(/could not be found/)).toBeNull();++ fireEvent.click(screen.getByRole('button', { name: 'Retry stages' }));+ await screen.findByText('4 stages');+ expect(screen.queryByText(/Stages are unavailable/)).toBeNull();+ });++ it('keeps other catalogues usable when only the variables read fails', async () => {+ getPromptVariables.mockReset().mockImplementation(down);+ await renderPage('/prompts?tab=variables&var=tone-guide');+ await screen.findByText(/Variables are unavailable/);+ expect(screen.queryByText(/could not be found/)).toBeNull();+ expect(screen.getAllByRole('button', { name: 'Retry variables' }).length).toBe(2);+ // Skills were never touched.+ fireEvent.click(screen.getByRole('button', { name: /Job Skills/i }));+ await screen.findByText('code-fixer');+ expect(screen.queryByText(/Job skills are unavailable/)).toBeNull();+ });++ it('shows the genuine empty state for a successful empty skills read', async () => {+ getJobSkills.mockReset().mockResolvedValue({ skills: [] });+ await renderPage('/prompts?tab=job-skills');+ await screen.findByText('No job skill templates found');+ expect(screen.queryByText(/Job skills are unavailable/)).toBeNull();+ });++ it('names a failed skills read instead of "No job skill templates found"', async () => {+ getJobSkills.mockReset().mockImplementation(down);+ await renderPage('/prompts?tab=job-skills');+ await screen.findByText(/Job skills are unavailable/);+ expect(screen.queryByText('No job skill templates found')).toBeNull();+ });++ it('keeps rows and the open variable when a refresh fails, flagging them stale', async () => {+ await renderPage('/prompts?tab=variables&var=tone-guide');+ await screen.findByText('Edit: tone-guide');+ getPromptVariables.mockReset().mockImplementation(down);+ fireEvent.click(screen.getByLabelText('Reload'));+ await screen.findByText(/Variables may be out of date/);+ expect(screen.getByText('Edit: tone-guide')).toBeTruthy();+ expect(screen.getByText('Tone Guide')).toBeTruthy();++ getPromptVariables.mockReset().mockResolvedValue({ variables: VARS });+ fireEvent.click(screen.getByRole('button', { name: 'Retry variables' }));+ await waitFor(() => expect(screen.queryByText(/may be out of date/)).toBeNull());+ });+});