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
/**
* Reference Repos routes.
*
* Per-app management of upstream repos we borrow code from. The
* `reference-watch` scheduled task uses `checkReferenceRepo` to find
* commits since each ref's `lastReviewedSha`, then dispatches a CoS
* sub-agent that records proposals in the app's CONFIGURED work tracker
* (PLAN.md / GitHub / GitLab / JIRA) for `/claim` / `plan-task` /
* `claim-issue*` to pick up. PLAN.md keeps checklist IDs; forge issues use
* human-readable titles and their issue number/key as the ID.
*
* Mounted at /api/apps/:appId/reference-repos so it sits next to the
* existing apps API surface.
*/
import { Router } from 'express';
import { asyncHandler, failValidation } from '../lib/errorHandler.js';
import { referenceRepoCreateSchema, referenceRepoUpdateSchema, referenceRepoReviewedBodySchema, validateRequest } from '../lib/validation.js';
import {
listReferenceRepos,
addReferenceRepo,
updateReferenceRepo,
deleteReferenceRepo,
checkReferenceRepo,
markReferenceRepoReviewed,
triggerReferenceAnalysis,
} from '../services/referenceRepos.js';
import { getAppById } from '../services/apps.js';
const router = Router({ mergeParams: true });
router.get('/', asyncHandler(async (req, res) => {
const refs = await listReferenceRepos(req.params.appId);
res.json({ referenceRepos: refs });
}));
router.post('/', asyncHandler(async (req, res) => {
const parsed = referenceRepoCreateSchema.safeParse(req.body || {});
if (!parsed.success) failValidation(parsed);
const ref = await addReferenceRepo(req.params.appId, parsed.data);
res.status(201).json(ref);
}));
router.patch('/:refId', asyncHandler(async (req, res) => {
const parsed = referenceRepoUpdateSchema.safeParse(req.body || {});
if (!parsed.success) failValidation(parsed);
const ref = await updateReferenceRepo(req.params.appId, req.params.refId, parsed.data);
res.json(ref);
}));
router.delete('/:refId', asyncHandler(async (req, res) => {
await deleteReferenceRepo(req.params.appId, req.params.refId);
res.json({ ok: true });
}));
// Run a check now — fetches the upstream repo, returns the commit list since
// lastReviewedSha, and queues a CoS analysis task when new commits exist.
// Does NOT advance lastReviewedSha; that happens via the explicit /reviewed
// endpoint after the user / agent has actually processed the changes.
router.post('/:refId/check', asyncHandler(async (req, res) => {
const { appId, refId } = req.params;
const snapshot = await checkReferenceRepo(appId, refId);
let analysis = { queued: false, reason: 'no-new-commits' };
if (snapshot.stale) {
analysis = { queued: false, reason: 'stale-snapshot' };
} else if (snapshot.commitCount > 0) {
const app = await getAppById(appId);
const ref = app?.referenceRepos?.find((r) => r.id === refId);
if (!app) {
analysis = { queued: false, reason: 'app-not-found' };
} else if (!ref) {
analysis = { queued: false, reason: 'ref-not-found' };
} else {
analysis = await triggerReferenceAnalysis(app, ref, snapshot)
.catch((err) => {
console.error(`❌ Analysis trigger failed for ${refId}: ${err instanceof Error ? err.message : String(err)}`);
return { queued: false, reason: 'analysis-trigger-failed' };
});
}
}
res.json({ ...snapshot, analysis });
}));
router.post('/:refId/reviewed', asyncHandler(async (req, res) => {
const { sha } = validateRequest(referenceRepoReviewedBodySchema, req.body ?? {});
const ref = await markReferenceRepoReviewed(req.params.appId, req.params.refId, sha);
res.json(ref);
}));
export default router;