@angelmsger/fx 0.0.0-stage → 0.10.1

package/dist/application/harness/stages.js

@@ -0,0 +1,114 @@
+// Connects harness projection and readiness to sync and doctor.
+import { asDevkitError, DevkitError } from '../../domain/errors.js';
+import { preparationCheck } from '../../domain/preparation.js';
+import { finding } from '../../domain/report.js';
+import { McpReadinessBatch } from './mcp-readiness-batch.js';
+import { ReconcileHarness } from './reconcile.js';
+import { loadHarnessCommand } from './session.js';
+export async function manageHarness(command) {
+    const { deps, input } = await loadHarnessCommand(command);
+    const held = command.workspaceLease;
+    if (held && (held.workspace !== input.workspace || held.root !== input.root))
+        throw new DevkitError('conflict', 'HARNESS_PLAN_CHANGED', 'Workspace lease scope changed', {
+            nextSteps: ['Retry workspace synchronization.'],
+        });
+    const lock = held
+        ? {
+            acquire: async (request) => request.key === `workspace:${input.workspace}`
+                ? { release: async () => { } }
+                : deps.lock.acquire(request),
+        }
+        : deps.lock;
+    return new ReconcileHarness({ ...deps, lock }).execute({
+        ...input,
+        action: command.action,
+        dryRun: command.dryRun,
+        only: command.only,
+    });
+}
+export function harnessStage(command) {
+    return async () => {
+        const result = await manageHarness(command);
+        const summary = {};
+        for (const row of result.items) {
+            summary[row.action] = (summary[row.action] ?? 0) + 1;
+            if (row.handoff)
+                command.resolve.reporter.notice({
+                    code: 'HARNESS_NOT_READY',
+                    message: `${row.name}: ${row.action}`,
+                    nextSteps: ['fx doctor'],
+                    data: { handoff: row.handoff },
+                });
+        }
+        const checks = result.items.map((row) => {
+            let state = 'blocked';
+            if (['created', 'updated', 'unchanged', 'removed'].includes(row.action))
+                state = 'ready';
+            if (row.action === 'unsupported')
+                state = 'skipped';
+            return preparationCheck(`harness:${row.key}`, state, `${row.name}: ${row.action}`, {
+                resource: row.name,
+                required: row.kind === 'rules',
+                owner: 'user',
+            });
+        });
+        const activation = result.items
+            .filter((row) => row.kind === 'mcp' && row.action !== 'unsupported')
+            .map((row) => preparationCheck(`activation:${row.key}`, 'unknown', `${row.name}: native activation is unverified`, { resource: row.name, required: false, owner: 'user' }));
+        return {
+            summary,
+            details: { items: result.items },
+            checks: [...checks, ...activation],
+            operationChecks: checks.map((check) => ({ ...check, required: true })),
+        };
+    };
+}
+export function harnessDoctor(command, kind) {
+    return {
+        group: kind,
+        check: () => checkHarness(command, kind),
+        fix: async (options) => {
+            await manageHarness({ ...command, action: 'sync', only: kind, dryRun: options.dryRun });
+        },
+    };
+}
+async function checkHarness(command, kind) {
+    try {
+        const { deps, input } = await loadHarnessCommand(command);
+        const output = await new ReconcileHarness(deps).execute({ ...input, only: kind });
+        const findings = output.items.map((row) => finding(kind, row.key, row.action === 'unchanged' ? 'ok' : 'warn', `${row.name}: ${row.action}; native activation unverified`, {
+            handoff: row.handoff ?? undefined,
+            ...(row.action === 'unchanged' ? {} : { fix: 'fx sync --only mcp,docs' }),
+        }));
+        if (kind === 'mcp')
+            findings.push(...(await readinessFindings(command, { deps, input })));
+        return findings;
+    }
+    catch (err) {
+        // Doctor answers for every group, so an inspection that threw is an unanswered
+        // check rather than a failed one; see Coverage in domain/report.ts.
+        return [
+            finding(kind, 'inspection', 'warn', `Harness inspection failed: ${asDevkitError(err).code}`, {
+                fix: 'fx manifest validate --kind harness',
+                coverage: 'incomplete',
+            }),
+        ];
+    }
+}
+async function readinessFindings(command, loaded) {
+    const { deps, input } = loaded;
+    const results = await new McpReadinessBatch({
+        process: command.process,
+        trust: deps.trust,
+        env: command.env,
+    }).execute({
+        workspace: input.workspace,
+        resources: input.harness?.mcp ?? [],
+        posture: command.posture,
+    });
+    return results.map((result) => finding('mcp', `ready:${result.resource}`, result.status === 'ready' ? 'ok' : 'warn', `${result.resource}: ${result.status} (${result.evidence})`, {
+        handoff: result.handoff ?? undefined,
+        coverage: result.status === 'unknown' ? 'incomplete' : 'checked',
+    }));
+}
+//# sourceMappingURL=stages.js.map

package/dist/application/harness/stages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stages.js","sourceRoot":"","sources":["../../../src/application/harness/stages.ts"],"names":[],"mappings":"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"}

package/dist/application/harness/targets.js

@@ -0,0 +1,111 @@
+// Resolves shared resource targets for selected agents and cleanup.
+import { createHash } from 'node:crypto';
+import { handoffEnvelope } from '../../domain/errors.js';
+import { assessMcpSupport } from '../../domain/harness/mcp.js';
+export function harnessTargets(deps, input, state) {
+    if (input.cleanupAgents)
+        return cleanupTargets(deps, input, state);
+    const targets = new Map();
+    const rows = [];
+    for (const host of deps.hosts.filter((host) => input.selected.includes(host.id))) {
+        addHostMcp(deps, input, host, targets, rows);
+        if (input.only !== 'mcp' &&
+            input.harness &&
+            input.harness.rules?.enabled !== false &&
+            host.rules)
+            addTarget(targets, {
+                kind: 'rules',
+                name: 'fx-rules',
+                relative: host.rules.projectPath,
+                protocol: host.rules.protocol,
+                agents: [host.id],
+                resource: null,
+                support: null,
+                remove: false,
+            });
+    }
+    for (const receipt of state.receipts) {
+        if (input.only && receipt.kind !== input.only)
+            continue;
+        if (!targets.has(receipt.key) &&
+            !rows.some((row) => row.kind === receipt.kind &&
+                row.agents.some((id) => receipt.agents.includes(id)) &&
+                `fx-${row.name}` === receipt.name))
+            targets.set(receipt.key, {
+                ...receipt,
+                resource: null,
+                support: deps.hosts
+                    .map((host) => host.mcp)
+                    .find((support) => support.status === 'supported' &&
+                    support.projectPath === receipt.relative &&
+                    support.protocol === receipt.protocol) ?? null,
+                remove: true,
+            });
+    }
+    return { targets: [...targets.values()], rows };
+}
+function addHostMcp(deps, input, host, targets, rows) {
+    if (input.only !== 'rules')
+        for (const resource of input.harness?.mcp ?? []) {
+            const support = host.mcp;
+            const compatibility = assessMcpSupport(support, resource);
+            if (!compatibility.supported ||
+                support.status !== 'supported' ||
+                !deps.codec(support.protocol)) {
+                rows.push({
+                    key: `${host.id}:${resource.name}`,
+                    kind: 'mcp',
+                    name: resource.name,
+                    agents: [host.id],
+                    path: null,
+                    action: 'unsupported',
+                    variables: [],
+                    handoff: harnessHandoff(compatibility.reason ?? 'The native protocol is unavailable.'),
+                });
+                continue;
+            }
+            addTarget(targets, {
+                kind: 'mcp',
+                name: `fx-${resource.name}`,
+                relative: support.projectPath,
+                protocol: support.protocol,
+                agents: [host.id],
+                resource,
+                support,
+                remove: false,
+            });
+        }
+}
+function addTarget(targets, target) {
+    const key = createHash('sha256')
+        .update(JSON.stringify([target.kind, target.relative, target.protocol, target.name]))
+        .digest('hex');
+    const existing = targets.get(key);
+    targets.set(key, {
+        ...target,
+        key,
+        agents: [...new Set([...(existing?.agents ?? []), ...target.agents])].sort(),
+    });
+}
+export function harnessHandoff(message) {
+    return handoffEnvelope({
+        summary: message,
+        command: 'fx sync --only mcp,docs',
+        userSteps: [{ id: 'harness-setup', kind: 'manual', title: message }],
+        alternatives: ['fx doctor'],
+    });
+}
+function cleanupTargets(deps, input, state) {
+    const targets = [];
+    for (const receipt of state.receipts) {
+        if (!receipt.agents.some((id) => input.cleanupAgents?.includes(id)))
+            continue;
+        const agents = receipt.agents.filter((id) => !input.cleanupAgents?.includes(id) && input.selected.includes(id));
+        const support = deps.hosts
+            .flatMap((host) => (host.mcp.status === 'supported' ? [host.mcp] : []))
+            .find((spec) => spec.projectPath === receipt.relative && spec.protocol === receipt.protocol) ?? null;
+        targets.push({ ...receipt, agents, support, resource: null, remove: agents.length === 0 });
+    }
+    return { targets, rows: [] };
+}
+//# sourceMappingURL=targets.js.map

package/dist/application/harness/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../../src/application/harness/targets.ts"],"names":[],"mappings":"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"}

package/dist/application/harness/types.js

@@ -0,0 +1,10 @@
+// Harness plans and results carry reference names, never environment values.
+export const HARNESS_COLUMNS = [
+    'agent',
+    'action',
+    'activation',
+    'path',
+    'context',
+    'command',
+];
+//# sourceMappingURL=types.js.map

package/dist/application/harness/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/application/harness/types.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAoD7E,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,MAAM;IACN,SAAS;IACT,SAAS;CACD,CAAC"}

package/dist/application/hook/apply.js

@@ -0,0 +1,63 @@
+// Writes planned entries under the caller's hooks lease and records what survived.
+import { ownedReceipts } from './plan.js';
+const UNFINISHED = ['busy', 'conflict', 'foreign', 'invalid'];
+export async function applyHookPlan(deps, input, plan) {
+    const receipts = [...ownedReceipts(input, plan.state)];
+    const items = [];
+    for (const item of plan.plans) {
+        if (!item.receipt) {
+            items.push(item.row);
+            continue;
+        }
+        const result = await deps.files.write({
+            root: input.root,
+            relative: item.receipt.relative,
+            before: item.before,
+            text: item.text,
+        });
+        items.push({
+            ...item.row,
+            ...(result === 'busy' || result === 'conflict' ? { action: result } : {}),
+        });
+        if (result === 'busy' || result === 'conflict')
+            continue;
+        const at = receipts.findIndex((r) => r.agent === item.receipt.agent);
+        if (at >= 0)
+            receipts.splice(at, 1);
+        if (item.row.action !== 'remove')
+            receipts.push(item.receipt);
+        // Persist each completed projection before the next IO can fail. Preferences
+        // commit only after all projections and receipts have succeeded.
+        await deps.state.write(input.workspace, stateOf(input, plan, receipts));
+    }
+    const state = stateOf(input, plan, receipts);
+    await deps.state.write(input.workspace, state);
+    await commitPreference(deps, input, items);
+    const local = await deps.local.read(input.workspace);
+    return {
+        workspace: input.workspace,
+        root: input.root,
+        items,
+        enabled: input.globalEnabled && local.hooks?.enabled !== false,
+        state,
+    };
+}
+function stateOf(input, plan, receipts) {
+    return {
+        root: input.root,
+        receipts: [...receipts],
+        lastAttempt: plan.state?.lastAttempt ?? null,
+        lastRefresh: plan.state?.lastRefresh ?? null,
+        observations: plan.state?.observations ?? [],
+    };
+}
+async function commitPreference(deps, input, items) {
+    const complete = items.every((item) => !UNFINISHED.includes(item.action));
+    if (complete && (input.action === 'inject' || input.action === 'remove')) {
+        await deps.local.update(input.workspace, (local) => ({
+            ...local,
+            hooks: { enabled: input.action === 'inject' },
+        }));
+    }
+}
+//# sourceMappingURL=apply.js.map

package/dist/application/hook/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.js","sourceRoot":"","sources":["../../../src/application/hook/apply.ts"],"names":[],"mappings":"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"}

package/dist/application/hook/automatic-sync.js

@@ -0,0 +1,184 @@
+// Automatic work has separate network and projection clocks. Attempts are
+// recorded before IO so interrupted workers do not hammer an unavailable
+// upstream; dated evidence never asserts current tool readiness.
+import { asDevkitError } from '../../domain/errors.js';
+import { samePath } from '../../domain/path.js';
+import { MANIFEST_UPDATE_TTL_MS } from '../update/policy.js';
+export class AutomaticSync {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    // Outcomes a contended state lease could not record yet, kept for the next
+    // write of this run.
+    delayed = [];
+    async execute(input) {
+        if (!(await this.deps.canWrite()))
+            return;
+        this.delayed = [];
+        const lease = await this.deps.lock.acquire({ key: `workspace:${input.workspace}`, waitMs: 0 });
+        if (!lease)
+            return;
+        try {
+            await this.run(input, lease);
+        }
+        finally {
+            await lease.release();
+        }
+    }
+    async run(input, lease) {
+        const now = this.deps.clock.now().getTime();
+        const previous = await this.deps.state.read(input.workspace);
+        if (previous?.lastAttempt !== null &&
+            previous?.lastAttempt !== undefined &&
+            now - previous.lastAttempt >= 0 &&
+            now - previous.lastAttempt < 15000)
+            return;
+        const refreshAt = previous?.lastRefresh;
+        const refreshing = refreshAt === null ||
+            refreshAt === undefined ||
+            now - refreshAt >= MANIFEST_UPDATE_TTL_MS ||
+            now < refreshAt;
+        const phases = this.phases(lease, refreshing);
+        // A worker its supervisor kills mid-phase never reaches its own recovery
+        // path, so the phases this run committed to are dated before any of them
+        // starts. A phase that reported replaces its own row; one still carrying
+        // this code was planned and never answered.
+        if (!(await this.update(input, { lastAttempt: now }, undefined, phases.map(unreported(now)))))
+            return;
+        if (refreshing && !(await this.update(input, { lastRefresh: now })))
+            return;
+        for (const phase of phases)
+            await this.step(input, phase);
+        if (this.delayed.length)
+            await this.update(input, {});
+    }
+    phases(lease, refreshing) {
+        return [
+            // Local and read-only, so it answers before any phase that can stall.
+            {
+                name: 'root',
+                run: this.deps.root,
+                code: 'ROOT_CHECK_FAILED',
+                command: 'fx doctor',
+            },
+            ...(refreshing
+                ? [
+                    {
+                        name: 'manifest',
+                        run: this.deps.refresh,
+                        code: 'MANIFEST_REFRESH_FAILED',
+                        command: 'fx sync',
+                    },
+                ]
+                : []),
+            {
+                name: 'docs',
+                run: () => this.deps.docs(lease),
+                code: 'DOCS_SYNC_FAILED',
+                command: 'fx sync --only docs',
+            },
+            {
+                name: 'skills',
+                run: this.deps.skills,
+                code: 'SKILL_SYNC_FAILED',
+                command: 'fx sync --only skills',
+            },
+            ...(this.deps.self
+                ? [
+                    {
+                        name: 'self',
+                        run: this.deps.self,
+                        code: 'FX_UPDATE_UNAVAILABLE',
+                        command: 'fx doctor',
+                    },
+                ]
+                : []),
+            {
+                name: 'checks',
+                run: this.deps.checks,
+                code: 'HOOK_CHECKS_INCOMPLETE',
+                command: 'fx doctor',
+            },
+        ];
+    }
+    async step(input, phase) {
+        if (!(await this.deps.canWrite()))
+            return;
+        let observations;
+        try {
+            observations = await phase.run();
+        }
+        catch (error) {
+            const failure = asDevkitError(error);
+            observations = [
+                {
+                    phase: phase.name,
+                    code: phase.code,
+                    command: phase.command,
+                    checkedAt: this.deps.clock.now().getTime(),
+                    detail: oneLine(`${failure.code}: ${failure.message}`),
+                },
+            ];
+        }
+        await this.update(input, {}, phase.name, observations);
+    }
+    async update(input, patch, phase, observations = []) {
+        const lease = await this.deps.lock.acquire({ key: `hooks:${input.workspace}`, waitMs: 0 });
+        if (!lease) {
+            // A hook never waits for the state lease, and a dropped outcome would
+            // read as unchanged.
+            this.delayed.push(...observations.map((observation) => concurrent(observation)));
+            return false;
+        }
+        const pending = [...this.delayed, ...observations];
+        try {
+            const current = await this.deps.state.read(input.workspace);
+            if (current && !samePath(current.root, input.root))
+                return false;
+            const replaced = new Set(pending.map((observation) => observation.phase));
+            await this.deps.state.write(input.workspace, {
+                root: input.root,
+                receipts: current?.receipts ?? [],
+                lastAttempt: current?.lastAttempt ?? null,
+                lastRefresh: current?.lastRefresh ?? null,
+                ...patch,
+                observations: [
+                    ...(current?.observations ?? []).filter((o) => o.phase !== phase && !replaced.has(o.phase)),
+                    ...pending,
+                ],
+            });
+            this.delayed = [];
+            return true;
+        }
+        finally {
+            await lease.release();
+        }
+    }
+}
+function unreported(at) {
+    return (phase) => ({
+        phase: phase.name,
+        code: 'HOOK_PHASE_UNREPORTED',
+        command: phase.command,
+        checkedAt: at,
+    });
+}
+function concurrent(observation) {
+    return {
+        ...observation,
+        code: 'HOOK_STATE_BUSY',
+        detail: oneLine(observation.detail === undefined
+            ? observation.code
+            : `${observation.code}: ${observation.detail}`),
+    };
+}
+// Observations are dated status fields, not a log: the reason is kept as a
+// single bounded line so a background failure stays diagnosable without
+// storing companion output.
+const DETAIL_LIMIT = 200;
+function oneLine(text) {
+    const line = text.replace(/\s+/g, ' ').trim();
+    return line.length > DETAIL_LIMIT ? `${line.slice(0, DETAIL_LIMIT - 3)}...` : line;
+}
+//# sourceMappingURL=automatic-sync.js.map

package/dist/application/hook/automatic-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automatic-sync.js","sourceRoot":"","sources":["../../../src/application/hook/automatic-sync.ts"],"names":[],"mappings":"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"}

package/dist/application/hook/cleanup.js

@@ -0,0 +1,46 @@
+// Global agent unpick cleans only that agent's receipts in registered roots.
+// A missing or inaccessible workspace remains a row so cleanup can be retried.
+import { cleanupAgentWorkspaces } from '../agent/workspace-cleanup.js';
+import { readSettings } from '../config/settings.js';
+import { ReconcileHooks } from './reconcile.js';
+export class CleanupAgentHooks {
+    deps;
+    config;
+    fs;
+    manifestDirFor;
+    constructor(deps, config, fs, manifestDirFor) {
+        this.deps = deps;
+        this.config = config;
+        this.fs = fs;
+        this.manifestDirFor = manifestDirFor;
+    }
+    async execute(input) {
+        const file = await this.config.read();
+        const settings = readSettings({ env: input.env, file });
+        return cleanupAgentWorkspaces({
+            config: this.config,
+            fs: this.fs,
+            lock: this.deps.lock,
+            manifestDirFor: this.manifestDirFor,
+        }, {
+            ...input,
+            workspaces: Object.keys(file.workspaces ?? {}),
+            reconcile: async (workspace, root) => {
+                const result = await new ReconcileHooks(this.deps).execute({
+                    workspace,
+                    root,
+                    action: 'sync',
+                    removeAgents: input.ids,
+                    dryRun: input.dryRun,
+                    posture: input.posture,
+                    configured: settings.agents,
+                    globalEnabled: settings.hooks,
+                });
+                return result.items
+                    .filter((row) => input.ids.includes(row.agent))
+                    .map((row) => ({ workspace, agent: row.agent, action: row.action }));
+            },
+        });
+    }
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/application/hook/cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.js","sourceRoot":"","sources":["../../../src/application/hook/cleanup.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,+EAA+E;AAM/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,MAAM,OAAO,iBAAiB;IAET;IACA;IACA;IACA;IAJnB,YACmB,IAAc,EACd,MAAmB,EACnB,EAAc,EACd,cAAwC;QAHxC,SAAI,GAAJ,IAAI,CAAU;QACd,WAAM,GAAN,MAAM,CAAa;QACnB,OAAE,GAAF,EAAE,CAAY;QACd,mBAAc,GAAd,cAAc,CAA0B;IACxD,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,KAAwB;QACpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,OAAO,sBAAsB,CAC3B;YACE,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;YACpB,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,EACD;YACE,GAAG,KAAK;YACR,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;YAC9C,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE;gBACnC,MAAM,MAAM,GAAG,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;oBACzD,SAAS;oBACT,IAAI;oBACJ,MAAM,EAAE,MAAM;oBACd,YAAY,EAAE,KAAK,CAAC,GAAG;oBACvB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,UAAU,EAAE,QAAQ,CAAC,MAAM;oBAC3B,aAAa,EAAE,QAAQ,CAAC,KAAK;iBAC9B,CAAC,CAAC;gBACH,OAAO,MAAM,CAAC,KAAK;qBAChB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;qBAC9C,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACzE,CAAC;SACF,CACF,CAAC;IACJ,CAAC;CACF"}

package/dist/application/hook/dispatch-host.js

@@ -0,0 +1,9 @@
+// Compatibility loaders may discover another host's hook entry. Runtime
+// evidence from the capability table prevents those entries from dispatching.
+export function resolveHookHost(hosts, requested, env) {
+    const identified = hosts.filter((host) => host.hooks?.identityEnvironment.some((key) => Boolean(env[key])));
+    if (identified.some((host) => host.id !== requested))
+        return null;
+    return hosts.find((host) => host.id === requested && host.hooks !== null) ?? null;
+}
+//# sourceMappingURL=dispatch-host.js.map

package/dist/application/hook/dispatch-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-host.js","sourceRoot":"","sources":["../../../src/application/hook/dispatch-host.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,8EAA8E;AAI9E,MAAM,UAAU,eAAe,CAC7B,KAA2B,EAC3B,SAAiB,EACjB,GAAiD;IAEjD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACvC,IAAI,CAAC,KAAK,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CACjE,CAAC;IACF,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAClE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC;AACpF,CAAC"}