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
/**
* Job Gates Service
*
* Provides precondition checks ("gates") for autonomous jobs that determine
* whether an LLM agent actually needs to be spawned. When a gate returns
* { shouldRun: false }, the job completes successfully without consuming
* an agent slot or incurring LLM costs.
*
* Gate functions are pure async predicates registered by job ID. Each returns:
* { shouldRun: boolean, reason: string, context?: object }
*
* To add a new gate, register it in the GATES object below.
*/
import { getInboxLogCounts } from './brainStorage.js';
/**
* Brain Review gate: skip if there are no needs_review inbox items
* and no items still classifying.
*/
async function brainReviewGate() {
const counts = await getInboxLogCounts();
const needsReview = counts.needs_review || 0;
const classifying = counts.classifying || 0;
if (needsReview > 0) {
return {
shouldRun: true,
reason: `${needsReview} inbox item(s) need review`,
context: { needsReview, classifying }
};
}
// If items are still classifying, wait for them to finish
if (classifying > 0) {
return {
shouldRun: false,
reason: `${classifying} item(s) still classifying, no items need review yet`,
context: { needsReview, classifying }
};
}
return {
shouldRun: false,
reason: 'No inbox items need review',
context: { needsReview, classifying }
};
}
/**
* Registry of gate functions keyed by job ID.
* Jobs without a gate entry always run (no precondition).
*/
async function goalCheckInGate() {
const { getGoals } = await import('./identity.js');
const data = await getGoals();
const activeWithTarget = (data.goals || []).filter(g => g.status === 'active' && g.targetDate);
if (activeWithTarget.length > 0) {
return { shouldRun: true, reason: `${activeWithTarget.length} active goal(s) with target dates`, context: { count: activeWithTarget.length } };
}
return { shouldRun: false, reason: 'No active goals with target dates' };
}
/**
* Autobiography gate: the story prompt is an optional per-install feature, so
* the job stays silent on an install where the user turned it off — the job's
* own `enabled` flag governs the cadence, the feature flag governs whether the
* feature exists here at all.
*/
async function autobiographyPromptGate() {
const { isInstanceFeatureEnabled } = await import('./instanceFeatures.js');
if (await isInstanceFeatureEnabled('autobiography')) {
return { shouldRun: true, reason: 'Autobiography feature enabled' };
}
return { shouldRun: false, reason: 'Autobiography feature disabled on this instance' };
}
const GATES = Object.assign(Object.create(null), {
'job-brain-review': brainReviewGate,
'job-goal-check-in': goalCheckInGate,
'job-autobiography-prompt': autobiographyPromptGate
});
/**
* Check whether a job should run by evaluating its gate function.
* Jobs without a registered gate always pass (shouldRun: true).
*
* @param {string} jobId - The job ID to check
* @returns {Promise<{shouldRun: boolean, reason: string, context?: object}>}
*/
export async function checkJobGate(jobId) {
const gateFn = GATES[jobId];
if (!gateFn) {
return { shouldRun: true, reason: 'No gate configured' };
}
return gateFn();
}
/**
* Check if a job has a gate registered.
* @param {string} jobId
* @returns {boolean}
*/
export function hasGate(jobId) {
return Object.prototype.hasOwnProperty.call(GATES, jobId);
}
/**
* Get all registered gate IDs (for introspection/UI).
* @returns {string[]}
*/
export function getRegisteredGates() {
return Object.keys(GATES);
}
// GATES is not exported to prevent external mutation — use checkJobGate/hasGate/getRegisteredGates instead