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
/**
* Planner-attribution prompt section (`planner:<model>`).
*
* An issue-filing agent cannot reliably name its own model — self-identification
* is exactly the thing LLMs get wrong — so PortOS resolves the run's identity at
* spawn time (`resolvePlannerId` over the provider + model `agentLifecycle`
* actually dispatched with) and hands the agent the finished label. The shared
* dispatch guidance in `lib/dispatchLabels.js` tells every planner prompt that
* the axis exists and to take its value verbatim from HERE.
*
* Emitted for every run rather than only the ones we predict will file: a task
* that files an issue is not identifiable from its metadata (a claim run files
* follow-ups, an audit run files findings), and the section is four lines.
*/
import { formatPlannerLabelGuidance, resolvePlannerId, MANDATORY_DISPATCH_HINT_GUIDANCE } from '../../lib/dispatchLabels.js';
/**
* The `## Planner Attribution` section for one run, or '' when PortOS could not
* resolve an identity — an unattributable run says nothing rather than inviting
* the agent to guess a label.
*
* @param {object} options
* @param {string|null} [options.providerId] - resolved provider id
* @param {string|null} [options.model] - resolved per-task model
* @param {'gh'|'glab'} [options.forgeCli] - forge the run would file into
* @returns {string}
*/
export function buildPlannerAttributionSection({ providerId = null, model = null, forgeCli = 'gh' } = {}) {
const guidance = formatPlannerLabelGuidance(
resolvePlannerId({ providerId, model }),
{ cli: forgeCli === 'glab' ? 'glab' : 'gh' }
);
if (!guidance) return '';
return `## Planner Attribution\n\n${guidance}`;
}
const collapseWhitespace = (text) => String(text || '').replace(/\s+/g, ' ');
const EMBEDDED_CONTRACT = collapseWhitespace(MANDATORY_DISPATCH_HINT_GUIDANCE);
/**
* Runtime contract reaches stored/custom tasks and follow-ups, even without a
* planner identity. Skipped when the task body already carries the contract
* (the shipped claim-issue / issue-reconcile prompts embed it at the top, and
* the tracker-filing prompts carry it re-indented inside their tracker block);
* the attribution is always emitted because the task cannot name its own model.
* Templates keep their embed so the prompt editor shows a complete prompt — the
* runtime section defers to it rather than the other way round. Whitespace is
* collapsed on both sides so an indented copy still matches; a paraphrase
* does not.
*
* @param {object} [options]
* @param {string[]} [options.taskBody] - rendered task parts (description, context)
*/
export function buildIssueFilingSection({ taskBody = [], ...options } = {}) {
const attribution = buildPlannerAttributionSection(options);
if (taskBody.some((part) => collapseWhitespace(part).includes(EMBEDDED_CONTRACT))) return attribution;
return `## Issue Filing Labels\n\n${MANDATORY_DISPATCH_HINT_GUIDANCE}${attribution ? `\n\n${attribution}` : ''}`;
}