@shrkcrft/inspector 0.1.0-alpha.2

package/dist/agent-brief.js

@@ -0,0 +1,490 @@
+import { analyzeImpact } from "./impact-analysis.js";
+import { buildCoverageReport } from "./coverage-report.js";
+import { buildDriftReport } from "./drift.js";
+import { buildTaskPacket } from "./task-packet.js";
+import { compareQualityBaseline } from "./quality-baseline.js";
+import { listConstructs, loadConstructs } from "./construct-registry.js";
+import { listPlaybooks, loadPlaybooks, recommendPlaybooks } from "./playbook-registry.js";
+import { scanDevSession } from "./dev-session.js";
+import { readFeatureBundle } from "./feature-bundle.js";
+import { buildTaskRiskReport } from "./task-risk.js";
+export const AGENT_BRIEF_SCHEMA = 'sharkcraft.agent-brief/v1';
+export var BriefMode;
+(function (BriefMode) {
+    BriefMode["Compact"] = "compact";
+    BriefMode["Full"] = "full";
+    BriefMode["Review"] = "review";
+    BriefMode["Implementation"] = "implementation";
+    BriefMode["Handoff"] = "handoff";
+})(BriefMode || (BriefMode = {}));
+const SAFETY_NOTE = 'MCP is read-only. Use CLI for writes. Apply requires explicit human action.';
+function inferMode(input) {
+    if (input.mode)
+        return input.mode;
+    const taskGiven = (input.task ?? '').trim().length > 0;
+    const hasDiff = Boolean(input.since || input.staged || (input.files && input.files.length > 0));
+    if (input.sessionId && !taskGiven)
+        return BriefMode.Handoff;
+    if (input.bundleId && !taskGiven)
+        return BriefMode.Handoff;
+    if (hasDiff && !taskGiven)
+        return BriefMode.Review;
+    return BriefMode.Implementation;
+}
+function clipMarkdown(md, maxTokens) {
+    // Rough token estimate: 4 chars per token.
+    const maxChars = maxTokens * 4;
+    if (md.length <= maxChars)
+        return md;
+    return md.slice(0, maxChars) + '\n\n_…truncated to respect maxTokens budget_\n';
+}
+function tokenEstimate(s) {
+    return Math.ceil(s.length / 4);
+}
+function trimSectionBody(body, maxTokens) {
+    const maxChars = Math.max(40, maxTokens * 4);
+    if (body.length <= maxChars)
+        return body;
+    return body.slice(0, maxChars) + '\n\n_…section trimmed to respect section-budget._';
+}
+/** Chunk index ordering for stable file naming. */
+const SECTION_ORDER = [
+    'task',
+    'project-overview',
+    'rules',
+    'paths',
+    'templates',
+    'pipeline',
+    'action-hints',
+    'forbidden',
+    'impact',
+    'boundary',
+    'policy',
+    'ownership',
+    'coverage',
+    'drift',
+    'quality',
+    'bundle',
+    'session',
+    'playbooks',
+    'constructs',
+    'suggested-commands',
+    'safety',
+];
+async function gatherImpact(inspection, input) {
+    const files = [...(input.files ?? [])];
+    const planTargets = [];
+    if (input.bundleId) {
+        const b = readFeatureBundle(inspection.projectRoot, input.bundleId);
+        if (b) {
+            for (const f of b.affectedFiles)
+                files.push(f);
+            for (const p of b.plans)
+                for (const t of p.expectedTargets)
+                    planTargets.push(t);
+        }
+    }
+    if (files.length === 0 && planTargets.length === 0 && !input.task)
+        return null;
+    return analyzeImpact(inspection, {
+        ...(input.task ? { task: input.task } : {}),
+        files,
+        planTargets,
+    });
+}
+function section(id, title, body) {
+    return { id, title, body };
+}
+function projectOverviewSection(inspection) {
+    const ws = inspection.workspace;
+    const lines = [];
+    lines.push(`- **Name:** ${ws.packageName ?? '(unknown)'}`);
+    const frameworks = (ws.frameworks ?? [])
+        .map((f) => (typeof f === 'string' ? f : f.id ?? f.name ?? ''))
+        .filter(Boolean);
+    lines.push(`- **Frameworks:** ${frameworks.join(', ') || '(none detected)'}`);
+    lines.push(`- **TypeScript:** ${ws.hasTypeScript ? 'yes' : 'no'}`);
+    const pmRaw = ws.packageManager;
+    const pm = typeof pmRaw === 'string'
+        ? pmRaw
+        : pmRaw?.name ?? '(unknown)';
+    lines.push(`- **Package manager:** ${pm}`);
+    const packs = inspection.packs.validPacks ?? [];
+    lines.push(`- **Packs:** ${packs.length > 0 ? packs.map((p) => p.packageName).join(', ') : '(none)'}`);
+    return section('project-overview', 'Project overview', lines.join('\n'));
+}
+function rulesSection(packet, limit) {
+    const lines = [];
+    for (const r of packet.relevantRules.slice(0, limit)) {
+        lines.push(`- **${r.id}**${r.title ? ` — ${r.title}` : ''}`);
+    }
+    if (lines.length === 0)
+        lines.push('_No directly relevant rules._');
+    return section('rules', 'Relevant rules', lines.join('\n'));
+}
+function pathsSection(packet, limit) {
+    const lines = [];
+    for (const p of packet.relevantPaths.slice(0, limit)) {
+        lines.push(`- \`${p.id}\` ${p.title ? `— ${p.title}` : ''}`);
+    }
+    if (lines.length === 0)
+        lines.push('_No path conventions matched._');
+    return section('paths', 'Path conventions', lines.join('\n'));
+}
+function templatesSection(packet, limit) {
+    const lines = [];
+    for (const t of packet.relevantTemplates.slice(0, limit)) {
+        lines.push(`- \`${t.id}\` — ${t.name ?? ''}`);
+    }
+    if (lines.length === 0)
+        lines.push('_No templates matched._');
+    return section('templates', 'Templates', lines.join('\n'));
+}
+function pipelineSection(packet) {
+    const top = packet.recommendedPipelines[0];
+    if (!top)
+        return section('pipeline', 'Recommended pipeline', '_None recommended._');
+    return section('pipeline', 'Recommended pipeline', `\`${top.pipelineId}\` — ${top.reason ?? 'best match by task ranker'}`);
+}
+function actionHintsSection(packet) {
+    const lines = [];
+    const h = packet.actionHints;
+    if (h.commands.length > 0) {
+        lines.push('**Commands:**');
+        for (const c of h.commands.slice(0, 5))
+            lines.push(`- \`${c}\``);
+    }
+    if (h.mcpTools.length > 0) {
+        lines.push('**MCP tools:**');
+        for (const m of h.mcpTools.slice(0, 5))
+            lines.push(`- \`${m}\``);
+    }
+    if (h.verificationCommands.length > 0) {
+        lines.push('**Verification:**');
+        for (const v of h.verificationCommands.slice(0, 5))
+            lines.push(`- \`${v}\``);
+    }
+    if (lines.length === 0)
+        lines.push('_No action hints surfaced._');
+    return section('action-hints', 'Action hints', lines.join('\n'));
+}
+function forbiddenSection(packet) {
+    const lines = [];
+    if (packet.forbiddenActions.length === 0)
+        lines.push('_None._');
+    else
+        for (const f of packet.forbiddenActions.slice(0, 12))
+            lines.push(`- ${f}`);
+    return section('forbidden', 'Forbidden actions', lines.join('\n'));
+}
+function safetySection() {
+    return section('safety', 'Safety', SAFETY_NOTE);
+}
+function impactSection(impact) {
+    if (!impact)
+        return section('impact', 'Impact', '_No impact analysis available._');
+    const lines = [];
+    lines.push(`- **Risk:** ${impact.risk}`);
+    lines.push(`- **Direct dependents:** ${impact.directDependents.length}`);
+    lines.push(`- **Transitive dependents:** ${impact.transitiveDependents.length}`);
+    lines.push(`- **Areas:** ${impact.affectedAreas.map((a) => a.id).slice(0, 4).join(', ') || '(none)'}`);
+    if (impact.affectedTemplates.length > 0)
+        lines.push(`- **Templates:** ${impact.affectedTemplates.map((t) => t.id).join(', ')}`);
+    if (impact.affectedConstructs.length > 0)
+        lines.push(`- **Constructs:** ${impact.affectedConstructs.map((c) => c.id).join(', ')}`);
+    for (const r of impact.riskReasons.slice(0, 4))
+        lines.push(`  • ${r.code}: ${r.message}`);
+    return section('impact', 'Impact', lines.join('\n'));
+}
+function ownershipSection(impact) {
+    if (!impact?.affectedOwnership) {
+        return section('ownership', 'Ownership', '_No ownership data._');
+    }
+    const o = impact.affectedOwnership;
+    const lines = [];
+    if (o.owners.length > 0)
+        lines.push(`- **Owners:** ${o.owners.join(', ')}`);
+    if (o.reviewers.length > 0)
+        lines.push(`- **Reviewers:** ${o.reviewers.join(', ')}`);
+    if (o.requiredReviewFiles.length > 0) {
+        lines.push(`- **Required review** on: ${o.requiredReviewFiles.slice(0, 5).join(', ')}`);
+    }
+    if (lines.length === 0)
+        lines.push('_No ownership matches._');
+    return section('ownership', 'Ownership', lines.join('\n'));
+}
+function policySection(impact) {
+    if (!impact || impact.affectedPolicies.length === 0) {
+        return section('policy', 'Policy concerns', '_None detected._');
+    }
+    const lines = [];
+    for (const p of impact.affectedPolicies) {
+        lines.push(`- [${p.severity}] **${p.policyId}** — ${p.reason}`);
+    }
+    return section('policy', 'Policy concerns', lines.join('\n'));
+}
+function boundarySection(impact) {
+    if (!impact || impact.potentialBoundaryRisks.length === 0) {
+        return section('boundary', 'Boundary concerns', '_None detected._');
+    }
+    const lines = [];
+    for (const b of impact.potentialBoundaryRisks.slice(0, 6)) {
+        lines.push(`- [${b.severity}] \`${b.ruleId}\` — ${b.reason}`);
+    }
+    return section('boundary', 'Boundary concerns', lines.join('\n'));
+}
+function suggestedCommandsSection(impact, packet) {
+    const lines = [];
+    const commands = new Set();
+    for (const c of impact?.suggestedTestCommands ?? [])
+        commands.add(c);
+    for (const c of impact?.suggestedValidationCommands ?? [])
+        commands.add(c);
+    for (const c of packet.recommendedCliCommands ?? [])
+        commands.add(c);
+    for (const c of [...commands].slice(0, 10))
+        lines.push(`- \`${c}\``);
+    return {
+        section: section('suggested-commands', 'Suggested commands', lines.join('\n') || '_None._'),
+        commands: [...commands],
+    };
+}
+async function bundleHandoffSection(inspection, bundleId) {
+    const b = readFeatureBundle(inspection.projectRoot, bundleId);
+    if (!b)
+        return section('bundle', 'Bundle handoff', `_Bundle "${bundleId}" not found._`);
+    const lines = [];
+    lines.push(`- **Bundle:** ${b.id}`);
+    lines.push(`- **Status:** ${b.status}`);
+    lines.push(`- **Risk:** ${b.riskLevel}`);
+    lines.push(`- **Plans:** ${b.plans.length}`);
+    lines.push(`- **Validations:** ${b.validations.length}`);
+    lines.push(`- **Next:** ${b.nextAction ?? '(none)'}`);
+    return section('bundle', 'Bundle handoff', lines.join('\n'));
+}
+async function sessionHandoffSection(inspection, sessionId) {
+    const load = scanDevSession(inspection.projectRoot, sessionId);
+    if (!load)
+        return section('session', 'Session handoff', `_Session "${sessionId}" not found._`);
+    const state = load.state;
+    const lines = [];
+    lines.push(`- **Session:** ${load.id}`);
+    lines.push(`- **Task:** ${load.task || '(none)'}`);
+    lines.push(`- **Phase:** ${state?.phase ?? '(legacy)'}`);
+    lines.push(`- **Plans:** ${state?.plans.length ?? 0}`);
+    lines.push(`- **Applied:** ${state?.appliedPlans.length ?? 0}`);
+    if (state?.nextAction)
+        lines.push(`- **Next:** \`${state.nextAction}\``);
+    return section('session', 'Session handoff', lines.join('\n'));
+}
+async function coverageSection(inspection) {
+    try {
+        const cov = buildCoverageReport(inspection);
+        const lines = [`- **Overall:** ${cov.overall}`];
+        for (const c of cov.categories.slice(0, 5)) {
+            lines.push(`- \`${c.id}\` ${c.score}`);
+        }
+        return section('coverage', 'Coverage', lines.join('\n'));
+    }
+    catch {
+        return section('coverage', 'Coverage', '_unavailable_');
+    }
+}
+async function driftSection(inspection) {
+    try {
+        const d = buildDriftReport(inspection);
+        return section('drift', 'Drift', `errors=${d.counts.error} warnings=${d.counts.warning} info=${d.counts.info}`);
+    }
+    catch {
+        return section('drift', 'Drift', '_unavailable_');
+    }
+}
+async function qualitySection(inspection, baselineFile) {
+    if (!baselineFile)
+        return section('quality', 'Quality baseline', '_No baseline provided._');
+    const cmp = await compareQualityBaseline(inspection, baselineFile);
+    if (!cmp)
+        return section('quality', 'Quality baseline', `_No baseline at ${baselineFile}._`);
+    const lines = [
+        `- **Baseline score:** ${cmp.baseline.qualityScore}`,
+        `- **Current score:** ${cmp.current.qualityScore}`,
+        `- **Regressions:** ${cmp.regressions.length}`,
+        `- **Improvements:** ${cmp.improvements.length}`,
+    ];
+    return section('quality', 'Quality baseline', lines.join('\n'));
+}
+function sectionsToMarkdown(task, mode, sections) {
+    const lines = [];
+    lines.push(`# SharkCraft brief: ${task || '(no task)'}`);
+    lines.push('');
+    lines.push(`_Mode: \`${mode}\` — ${new Date().toISOString()}_`);
+    for (const s of sections) {
+        lines.push('');
+        lines.push(`## ${s.title}`);
+        lines.push('');
+        lines.push(s.body);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+export async function buildAgentBrief(inspection, input) {
+    // Warm registries so impact / brief can include constructs / playbooks.
+    await loadConstructs(inspection);
+    await loadPlaybooks(inspection);
+    const mode = inferMode(input);
+    const task = (input.task ?? '').trim();
+    const packet = buildTaskPacket(inspection, task || 'general project work', {
+        maxTokens: 3500,
+    });
+    const impact = await gatherImpact(inspection, input);
+    const sections = [];
+    if (task) {
+        sections.push(section('task', 'Task', task));
+    }
+    sections.push(projectOverviewSection(inspection));
+    if (mode !== BriefMode.Compact) {
+        sections.push(rulesSection(packet, 8));
+        sections.push(pathsSection(packet, 8));
+        sections.push(templatesSection(packet, 6));
+        sections.push(pipelineSection(packet));
+        sections.push(actionHintsSection(packet));
+        sections.push(forbiddenSection(packet));
+    }
+    else {
+        sections.push(rulesSection(packet, 4));
+        sections.push(pathsSection(packet, 4));
+        sections.push(templatesSection(packet, 4));
+        sections.push(actionHintsSection(packet));
+    }
+    if (mode === BriefMode.Full || mode === BriefMode.Review) {
+        sections.push(impactSection(impact));
+        sections.push(boundarySection(impact));
+        sections.push(policySection(impact));
+        sections.push(ownershipSection(impact));
+        sections.push(await coverageSection(inspection));
+        sections.push(await driftSection(inspection));
+        if (input.qualityBaselineFile)
+            sections.push(await qualitySection(inspection, input.qualityBaselineFile));
+    }
+    if (mode === BriefMode.Implementation) {
+        sections.push(impactSection(impact));
+        sections.push(boundarySection(impact));
+        sections.push(policySection(impact));
+    }
+    if (mode === BriefMode.Handoff) {
+        if (input.bundleId)
+            sections.push(await bundleHandoffSection(inspection, input.bundleId));
+        if (input.sessionId)
+            sections.push(await sessionHandoffSection(inspection, input.sessionId));
+        sections.push(impactSection(impact));
+    }
+    // Playbook recommendation.
+    if (task) {
+        const playbooks = listPlaybooks(inspection);
+        const recs = recommendPlaybooks(playbooks, task).slice(0, 3);
+        if (recs.length > 0) {
+            const lines = recs.map((r) => `- \`${r.playbook.id}\` (${r.score}) — ${r.reasons.slice(0, 3).join(', ')}`);
+            sections.push(section('playbooks', 'Suggested playbooks', lines.join('\n')));
+        }
+    }
+    // Construct hints when impact mentions any.
+    if (impact && impact.affectedConstructs.length > 0) {
+        const allConstructs = listConstructs(inspection);
+        const lines = impact.affectedConstructs.map((c) => {
+            const def = allConstructs.find((x) => x.id === c.id);
+            return `- \`${c.id}\` (${c.type})${def?.description ? ` — ${def.description}` : ''}`;
+        });
+        sections.push(section('constructs', 'Affected constructs', lines.join('\n')));
+    }
+    // Always include suggested commands + safety.
+    const { section: cmdSection, commands } = suggestedCommandsSection(impact, packet);
+    sections.push(cmdSection);
+    sections.push(safetySection());
+    // Apply per-section budgets when requested.
+    const trimmedSections = input.sectionBudgets && Object.keys(input.sectionBudgets).length > 0
+        ? sections.map((s) => {
+            const budget = input.sectionBudgets[s.id];
+            if (typeof budget !== 'number' || budget <= 0)
+                return s;
+            return { ...s, body: trimSectionBody(s.body, budget) };
+        })
+        : sections;
+    const markdown = clipMarkdown(sectionsToMarkdown(task || '(no task)', mode, trimmedSections), input.maxTokens ?? 6000);
+    const brief = {
+        schema: AGENT_BRIEF_SCHEMA,
+        task: task || '',
+        mode,
+        generatedAt: new Date().toISOString(),
+        projectRoot: inspection.projectRoot,
+        sections: trimmedSections,
+        markdown,
+        suggestedCommands: commands,
+        inputs: {
+            files: input.files ?? [],
+            since: input.since ?? null,
+            staged: input.staged ?? false,
+            bundleId: input.bundleId ?? null,
+            sessionId: input.sessionId ?? null,
+        },
+        warnings: [],
+        totalTokenEstimate: tokenEstimate(markdown),
+    };
+    if (impact)
+        brief.impact = impact;
+    // Attach a task-risk summary when a task is provided. Best-effort.
+    if (task) {
+        try {
+            brief.taskRisk = await buildTaskRiskReport(task, inspection, {
+                ...(input.files && input.files.length > 0 ? { files: input.files } : {}),
+                ...(input.since ? { since: input.since } : {}),
+                ...(input.staged ? { staged: true } : {}),
+            });
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    if (input.chunked) {
+        brief.chunks = buildBriefChunks(brief, trimmedSections);
+    }
+    return brief;
+}
+function buildBriefChunks(brief, sections) {
+    const ordered = [...sections].sort((a, b) => {
+        const ia = SECTION_ORDER.indexOf(a.id);
+        const ib = SECTION_ORDER.indexOf(b.id);
+        return (ia === -1 ? 99 : ia) - (ib === -1 ? 99 : ib);
+    });
+    const chunks = [];
+    const indexLines = [];
+    indexLines.push(`# SharkCraft brief — index`);
+    indexLines.push('');
+    indexLines.push(`_Mode: \`${brief.mode}\` — ${brief.generatedAt}_`);
+    if (brief.task)
+        indexLines.push(`_Task: ${brief.task}_`);
+    indexLines.push('');
+    indexLines.push('Read the chunks in order:');
+    for (let i = 0; i < ordered.length; i += 1) {
+        const s = ordered[i];
+        const idx = String(i + 1).padStart(2, '0');
+        const file = `${idx}-${s.id}.md`;
+        indexLines.push(`- [${s.title}](${file})`);
+        const body = `# ${s.title}\n\n${s.body}\n\n---\n\n_Safety: MCP is read-only. Use CLI for writes. Apply requires explicit human action._\n`;
+        chunks.push({
+            file,
+            sectionId: s.id,
+            title: s.title,
+            body,
+            tokenEstimate: tokenEstimate(body),
+        });
+    }
+    const indexBody = indexLines.join('\n') + '\n';
+    chunks.unshift({
+        file: '00-index.md',
+        sectionId: 'index',
+        title: 'Index',
+        body: indexBody,
+        tokenEstimate: tokenEstimate(indexBody),
+    });
+    return chunks;
+}

package/dist/agent-contract-gate.d.ts

@@ -0,0 +1,108 @@
+import type { IAgentContract } from './agent-contract.js';
+import type { IPlanSimulationReport } from './plan-simulation.js';
+import type { ISharkcraftInspection } from './sharkcraft-inspector.js';
+export declare const AGENT_CONTRACT_APPROVAL_SCHEMA = "sharkcraft.agent-contract-approval/v1";
+export declare const AGENT_CONTRACT_GATE_SCHEMA = "sharkcraft.agent-contract-gate/v1";
+export interface IAgentContractApproval {
+    schema: typeof AGENT_CONTRACT_APPROVAL_SCHEMA;
+    /** Stable hash of the contract this approval is bound to. */
+    contractHash: string;
+    /** Short contract id (slug + timestamp) for human readability. */
+    contractId?: string;
+    approvedBy: string;
+    reason: string;
+    approvedAt: string;
+    /** Specific gates the approver acknowledged. */
+    approvedGates: readonly string[];
+    /** ISO timestamp at which the approval expires; absent = no expiry. */
+    expiresAt?: string;
+    /** Optional HMAC signature when SHARKCRAFT_CONTRACT_SECRET is set. */
+    signature?: {
+        algo: 'sha256';
+        hmac: string;
+        signedAt: string;
+    };
+}
+export declare enum ContractGateStatus {
+    Pass = "pass",
+    RequiresApproval = "requires-approval",
+    Fail = "fail",
+    Warn = "warn"
+}
+export interface IContractGateResult {
+    id: string;
+    description: string;
+    status: ContractGateStatus;
+    detail?: string;
+}
+export declare enum ContractApprovalExpiryStatus {
+    Valid = "valid",
+    ExpiresSoon = "expires-soon",
+    Expired = "expired",
+    NoExpiry = "no-expiry",
+    Absent = "absent"
+}
+export interface IContractApprovalExpiry {
+    status: ContractApprovalExpiryStatus;
+    /** Milliseconds until expiry — negative when already expired. Absent for `absent` / `no-expiry`. */
+    expiresInMs?: number;
+    /** ISO timestamp at which the approval expires. */
+    expiresAt?: string;
+    /** ISO timestamp at which the approval expired (only set when `status === Expired`). */
+    expiredAt?: string;
+    /** Warning when the approval has no expiry and the contract is high/critical risk. */
+    noExpiryWarning?: string;
+}
+export interface IContractCheckReport {
+    schema: typeof AGENT_CONTRACT_GATE_SCHEMA;
+    generatedAt: string;
+    contractHash: string;
+    contractId?: string;
+    task: string;
+    role: string;
+    mode: string;
+    gates: readonly IContractGateResult[];
+    approval?: IAgentContractApproval;
+    approvalStatus: 'absent' | 'present' | 'expired' | 'mismatched' | 'unsigned' | 'verified' | 'invalid';
+    approvalMessage?: string;
+    /** Expiry detail (status + remaining time). */
+    approvalExpiry?: IContractApprovalExpiry;
+    pass: boolean;
+    blockingGates: readonly string[];
+    warnGates: readonly string[];
+    planSimulation?: IPlanSimulationReport;
+    notes: readonly string[];
+}
+export interface ICheckContractOptions {
+    planPath?: string;
+    approvalPath?: string;
+    /** Override secret env name; default `SHARKCRAFT_CONTRACT_SECRET`. */
+    secretEnv?: string;
+}
+export declare function computeContractHash(contract: IAgentContract): string;
+export declare function signApproval(a: IAgentContractApproval, secret: string): IAgentContractApproval;
+export declare function verifyApproval(a: IAgentContractApproval, secret: string): {
+    ok: boolean;
+    message: string;
+};
+export interface IBuildApprovalInput {
+    contractHash: string;
+    contractId?: string;
+    approvedBy: string;
+    reason: string;
+    approvedGates?: readonly string[];
+    expiresAt?: string;
+    /** When set, secret env (default `SHARKCRAFT_CONTRACT_SECRET`) signs the approval. */
+    secretEnv?: string;
+}
+export declare function buildApproval(input: IBuildApprovalInput): IAgentContractApproval;
+/**
+ * Parse a relative expiry string like `1h`, `2d`, `30m`, `45s`, `1w` and return
+ * an absolute ISO timestamp from `from` (default now). Returns null when the
+ * input cannot be parsed.
+ */
+export declare function parseRelativeExpiry(input: string, from?: Date): string | null;
+export declare function checkAgentContract(inspection: ISharkcraftInspection, contract: IAgentContract, options?: ICheckContractOptions): Promise<IContractCheckReport>;
+export declare function renderContractCheckText(r: IContractCheckReport): string;
+export declare function renderContractCheckMarkdown(r: IContractCheckReport): string;
+//# sourceMappingURL=agent-contract-gate.d.ts.map

package/dist/agent-contract-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-contract-gate.d.ts","sourceRoot":"","sources":["../src/agent-contract-gate.ts"],"names":[],"mappings":"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"}