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
import { readFileSync } from 'node:fs';
import { dirname, join } from 'node:path';
import { fileURLToPath } from 'node:url';
import { describe, it, expect, beforeEach } from 'vitest';
import {
detectIdleLeftoverBranches,
formatLeftoverBranchSnippet,
__resetLeftoverBranchCache,
} from './userActionDetectors.js';
const SRC = readFileSync(join(dirname(fileURLToPath(import.meta.url)), 'userActionDetectors.js'), 'utf-8');
const leftoverInput = (overrides = {}) => ({
branch: 'claim/issue-1',
liveOwnerReason: null,
...overrides,
});
const deps = (overrides = {}) => ({
now: Date.parse('2026-09-02T12:00:00.000Z'),
getActiveAgentIds: () => [],
getActiveApps: async () => [
{ id: 'portos-default', name: 'PortOS', repoPath: '/tmp/portos' },
{ id: 'app-acme', name: 'Acme', repoPath: '/tmp/acme' },
],
getDefaultBranch: async () => 'main',
gatherBranchState: async (repoPath) => (repoPath === '/tmp/acme' ? [leftoverInput()] : []),
classifyBranches: (inputs) => inputs.map((input) => ({ ...input, state: 'NEEDS_PR' })),
listUserActions: async () => [{
type: 'cos.schedule.trigger',
actor: 'user',
target: 'branch-reconcile',
payload: { appId: 'app-acme' },
happenedAt: '2026-08-28T10:00:00.000Z',
}],
portosRoot: '/tmp/portos',
...overrides,
});
describe('detectIdleLeftoverBranches', () => {
beforeEach(() => __resetLeftoverBranchCache());
it('never imports or calls reconcile / triggerOnDemandTask', () => {
expect(SRC).not.toMatch(/\btriggerOnDemandTask\b/);
expect(SRC).not.toMatch(/\breconcile\s*\(/);
expect(SRC).not.toMatch(/import\s*\{[^}]*\breconcile\b/);
});
it('returns a finding when agents are idle and leftover branches exist', async () => {
const findings = await detectIdleLeftoverBranches(deps());
expect(findings).toEqual([{
appId: 'app-acme',
// The insight card names the app the operator knows, not the registry id.
appName: 'Acme',
leftoverCount: 1,
states: { NEEDS_PR: 1 },
branches: ['claim/issue-1'],
lastUserReconcileAt: '2026-08-28T10:00:00.000Z',
agentsIdle: true,
}]);
});
// The card leads with one app by name, so the busiest one has to sort first —
// otherwise "N branches on <app>" points at whichever app the registry listed
// first rather than the one actually worth reconciling.
it('reports the app with the most leftover branches first, with its state mix', async () => {
const findings = await detectIdleLeftoverBranches(deps({
gatherBranchState: async (repoPath) => (repoPath === '/tmp/acme'
? [leftoverInput()]
: [leftoverInput({ branch: 'claim/a' }), leftoverInput({ branch: 'claim/b' }), leftoverInput({ branch: 'claim/c' })]),
classifyBranches: (inputs) => inputs.map((input) => ({
...input,
state: input.branch === 'claim/c' ? 'MERGED' : 'NEEDS_PR',
})),
}));
expect(findings.map((finding) => finding.appId)).toEqual(['portos-default', 'app-acme']);
expect(findings[0]).toMatchObject({
appName: 'PortOS',
leftoverCount: 3,
states: { NEEDS_PR: 2, MERGED: 1 },
branches: ['claim/a', 'claim/b', 'claim/c'],
});
});
it('returns nothing while any agent is still running', async () => {
const gatherBranchState = async () => { throw new Error('must not gather while agents run'); };
await expect(detectIdleLeftoverBranches(deps({
getActiveAgentIds: () => ['agent-1'],
gatherBranchState,
}))).resolves.toEqual([]);
});
it('returns nothing when every leftover branch has a live owner', async () => {
await expect(detectIdleLeftoverBranches(deps({
gatherBranchState: async () => [leftoverInput({ liveOwnerReason: 'active-agent' })],
}))).resolves.toEqual([]);
});
it('skips an app whose gather fails rather than throwing', async () => {
const findings = await detectIdleLeftoverBranches(deps({
gatherBranchState: async () => { throw new Error('git lock'); },
}));
expect(findings).toEqual([]);
});
});
describe('formatLeftoverBranchSnippet', () => {
it('renders a compact per-app line, using never when there is no prior reconcile', () => {
expect(formatLeftoverBranchSnippet([{
appId: 'app-acme', leftoverCount: 3, lastUserReconcileAt: null, agentsIdle: true,
}])).toBe('leftover-branches: app app-acme has 3 local branches, agents idle, last manual reconcile never');
});
});