@interchained/portal-agent 0.1.0

package/dist/guard.js

@@ -0,0 +1,106 @@
+/**
+ * Portal Guard — prevents bad AI output from entering the codebase.
+ *
+ * Runs a set of deterministic safety checks BEFORE any patch is applied.
+ * Unlike audit (which checks existing code), guard checks proposed patches.
+ *
+ * Checks:
+ *  - No hallucinated phone numbers or emails (compares against data sources)
+ *  - No changed brand colors without approval
+ *  - No forbidden claims
+ *  - No broken internal links (routes that don't exist)
+ *  - No unsafe dependency additions
+ */
+// ── Individual guard rules ─────────────────────────────────────────────────────
+function checkForbiddenClaims(proposed, contract) {
+    const claims = contract.policies?.forbiddenClaims ?? [];
+    return claims
+        .filter((claim) => proposed.toLowerCase().includes(claim.toLowerCase()))
+        .map((claim) => ({
+        rule: "forbidden-claim",
+        severity: "block",
+        message: `Proposed patch contains forbidden claim: "${claim}"`,
+        evidence: claim,
+    }));
+}
+function checkForbiddenPhrases(proposed, contract) {
+    const phrases = contract.brand?.forbiddenPhrases ?? [];
+    return phrases
+        .filter((p) => proposed.toLowerCase().includes(p.toLowerCase()))
+        .map((p) => ({
+        rule: "forbidden-phrase",
+        severity: "block",
+        message: `Proposed patch contains forbidden brand phrase: "${p}"`,
+        evidence: p,
+    }));
+}
+function checkBrandColors(original, proposed, contract) {
+    const colors = contract.brand?.colors ?? [];
+    const violations = [];
+    for (const color of colors) {
+        const inOriginal = original.includes(color);
+        const inProposed = proposed.includes(color);
+        if (inOriginal && !inProposed) {
+            violations.push({
+                rule: "brand-color-removed",
+                severity: "warn",
+                message: `Brand color ${color} was present in original but removed in patch`,
+                evidence: color,
+            });
+        }
+    }
+    // Check for new hex colors not in the brand palette
+    const hexPattern = /#([0-9a-fA-F]{3,8})\b/g;
+    const originalColors = new Set([...original.matchAll(hexPattern)].map((m) => m[0].toLowerCase()));
+    const proposedColors = [...proposed.matchAll(hexPattern)].map((m) => m[0].toLowerCase());
+    const brandPalette = new Set(colors.map((c) => c.toLowerCase()));
+    for (const hex of proposedColors) {
+        if (!originalColors.has(hex) && !brandPalette.has(hex) && colors.length > 0) {
+            violations.push({
+                rule: "off-brand-color",
+                severity: "warn",
+                message: `New color ${hex} introduced — not in brand palette (${colors.join(", ")})`,
+                evidence: hex,
+            });
+        }
+    }
+    return violations;
+}
+function checkPhoneNumbers(original, proposed) {
+    const phonePattern = /\b(\+?1[-.\s]?)?\(?\d{3}\)?[-.\s]?\d{3}[-.\s]?\d{4}\b/g;
+    const originalPhones = new Set([...original.matchAll(phonePattern)].map((m) => m[0]));
+    const proposedPhones = [...proposed.matchAll(phonePattern)];
+    const violations = [];
+    for (const match of proposedPhones) {
+        if (!originalPhones.has(match[0])) {
+            violations.push({
+                rule: "hallucinated-phone",
+                severity: "block",
+                message: `New phone number "${match[0]}" found in patch — verify this is from a trusted data source`,
+                evidence: match[0],
+            });
+        }
+    }
+    return violations;
+}
+// ── Main guard runner ─────────────────────────────────────────────────────────
+export async function guardPatch(patch, contract) {
+    const violations = [
+        ...checkForbiddenClaims(patch.proposed, contract),
+        ...checkForbiddenPhrases(patch.proposed, contract),
+        ...checkBrandColors(patch.original, patch.proposed, contract),
+        ...checkPhoneNumbers(patch.original, patch.proposed),
+    ];
+    const blocking = violations.filter((v) => v.severity === "block");
+    return {
+        patchId: patch.id,
+        passed: blocking.length === 0,
+        violations,
+    };
+}
+/** Run guard checks across all pending patches */
+export async function guardAllPending(patches, contract) {
+    const pending = patches.filter((p) => p.status === "pending");
+    return Promise.all(pending.map((p) => guardPatch(p, contract)));
+}
+//# sourceMappingURL=guard.js.map

package/dist/guard.js.map

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

package/dist/improve.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Improvement engine.
+ *
+ * Takes audit findings and generates targeted patches to fix them.
+ * Each patch is passed through the Sentinel, then queued for approval.
+ */
+import type { AppContract } from "@interchained/portal-contract";
+import { Runner } from "./runner.js";
+import { Sentinel } from "./sentinel.js";
+import { type Patch } from "./patch.js";
+import type { AuditFinding, CheckCategory } from "./audit.js";
+export interface ImproveOptions {
+    runner: Runner;
+    sentinel?: Sentinel;
+    contract: AppContract;
+    projectRoot: string;
+    /** Filter to specific check categories */
+    target?: CheckCategory[];
+    requiresApproval?: boolean;
+}
+export interface ImproveResult {
+    finding: AuditFinding;
+    patch: Patch | null;
+    skipped?: string;
+    sentinelReview?: {
+        approved: boolean;
+        summary: string;
+        violations: string[];
+    };
+}
+/**
+ * Generate improvement patches for a list of audit findings.
+ * Returns one result per finding — some may be skipped if they need
+ * manual intervention.
+ */
+export declare function improveFromFindings(findings: AuditFinding[], opts: ImproveOptions): Promise<ImproveResult[]>;
+//# sourceMappingURL=improve.d.ts.map

package/dist/improve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve.d.ts","sourceRoot":"","sources":["../src/improve.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE;QACf,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACH;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,YAAY,EAAE,EACxB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,aAAa,EAAE,CAAC,CA2E1B"}

package/dist/improve.js

@@ -0,0 +1,85 @@
+/**
+ * Improvement engine.
+ *
+ * Takes audit findings and generates targeted patches to fix them.
+ * Each patch is passed through the Sentinel, then queued for approval.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { createPatch } from "./patch.js";
+/**
+ * Generate improvement patches for a list of audit findings.
+ * Returns one result per finding — some may be skipped if they need
+ * manual intervention.
+ */
+export async function improveFromFindings(findings, opts) {
+    const { runner, sentinel, contract, projectRoot } = opts;
+    const targets = findings.filter((f) => {
+        if (f.status === "pass")
+            return false;
+        if (opts.target && !opts.target.includes(f.category))
+            return false;
+        return true;
+    });
+    const requiresApproval = opts.requiresApproval ??
+        contract.policies?.publishing === "human_review";
+    const results = [];
+    for (const finding of targets) {
+        let original;
+        try {
+            original = await readFile(join(projectRoot, finding.file), "utf-8");
+        }
+        catch {
+            results.push({ finding, patch: null, skipped: "File not found" });
+            continue;
+        }
+        const contractSummary = `Name: ${contract.name}\nGoals: ${contract.goals.join("\n")}\nPolicies: ${JSON.stringify(contract.policies ?? {})}`;
+        let proposed;
+        try {
+            proposed = await runner.generatePatch({
+                filePath: finding.file,
+                originalContent: original,
+                finding: `[${finding.category.toUpperCase()}] ${finding.message}${finding.suggestion ? ` — Suggested fix: ${finding.suggestion}` : ""}`,
+                contract: contractSummary,
+            });
+        }
+        catch {
+            results.push({ finding, patch: null, skipped: "Runner failed to generate patch" });
+            continue;
+        }
+        let sentinelResult;
+        if (sentinel) {
+            try {
+                const review = await sentinel.review({
+                    contract,
+                    filePath: finding.file,
+                    original,
+                    proposed,
+                    agentTask: `Fix ${finding.category} issue: ${finding.message}`,
+                });
+                sentinelResult = {
+                    approved: review.approved,
+                    summary: review.summary,
+                    violations: review.violations,
+                };
+            }
+            catch {
+                // Sentinel failure doesn't block — patch is just flagged
+            }
+        }
+        const patch = createPatch({
+            agent: "portal-improve",
+            file: finding.file,
+            original,
+            proposed,
+            reason: `Fix [${finding.category}]: ${finding.message}`,
+            requiresApproval,
+            sentinelApproved: sentinelResult?.approved,
+            sentinelSummary: sentinelResult?.summary,
+            sentinelViolations: sentinelResult?.violations,
+        });
+        results.push({ finding, patch, sentinelReview: sentinelResult });
+    }
+    return results;
+}
+//# sourceMappingURL=improve.js.map

package/dist/improve.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export { AiAssistClient, AiAssistError } from "./aiassist.js";
+export type { AiAssistConfig, Message, CompletionOptions } from "./aiassist.js";
+export { Runner } from "./runner.js";
+export type { RunnerConfig } from "./runner.js";
+export { Sentinel } from "./sentinel.js";
+export type { SentinelReview } from "./sentinel.js";
+export { runAudit } from "./audit.js";
+export type { AuditFinding, AuditReport, CheckCategory, CheckStatus } from "./audit.js";
+export { generatePage, generateFromPrompt } from "./generate.js";
+export type { GenerateOptions, GenerateResult } from "./generate.js";
+export { improveFromFindings } from "./improve.js";
+export type { ImproveOptions, ImproveResult } from "./improve.js";
+export { guardPatch, guardAllPending } from "./guard.js";
+export type { GuardViolation, GuardResult } from "./guard.js";
+export { createPatch, applyPatch, inlineDiff, PatchStore, } from "./patch.js";
+export type { Patch, PatchStatus } from "./patch.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEhF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAExF,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EACL,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { AiAssistClient, AiAssistError } from "./aiassist.js";
+export { Runner } from "./runner.js";
+export { Sentinel } from "./sentinel.js";
+export { runAudit } from "./audit.js";
+export { generatePage, generateFromPrompt } from "./generate.js";
+export { improveFromFindings } from "./improve.js";
+export { guardPatch, guardAllPending } from "./guard.js";
+export { createPatch, applyPatch, inlineDiff, PatchStore, } from "./patch.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAGtC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGzD,OAAO,EACL,WAAW,EACX,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/patch.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Safe patch system — preview, approval, and application.
+ *
+ * Every agent-generated change is represented as a Patch.
+ * Patches with requiresApproval=true are shown as diffs
+ * and must be explicitly approved before being written to disk.
+ */
+export type PatchStatus = "pending" | "approved" | "rejected" | "applied";
+export interface Patch {
+    id: string;
+    /** Agent that generated this patch */
+    agent: string;
+    /** Path relative to project root */
+    file: string;
+    original: string;
+    proposed: string;
+    /** Human-readable reason for the change */
+    reason: string;
+    requiresApproval: boolean;
+    status: PatchStatus;
+    createdAt: string;
+    /** Sentinel review (if sentinel ran) */
+    sentinelApproved?: boolean;
+    sentinelSummary?: string;
+    sentinelViolations?: string[];
+}
+export declare class PatchStore {
+    private dir;
+    constructor(projectRoot: string);
+    save(patch: Patch): Promise<void>;
+    load(id: string): Promise<Patch | null>;
+    list(): Promise<Patch[]>;
+    update(id: string, updates: Partial<Patch>): Promise<void>;
+}
+export declare function createPatch(opts: Omit<Patch, "id" | "createdAt" | "status">): Patch;
+export declare function applyPatch(patch: Patch, projectRoot: string, store: PatchStore): Promise<void>;
+export declare function inlineDiff(original: string, proposed: string): string;
+//# sourceMappingURL=patch.d.ts.map

package/dist/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../src/patch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAE1E,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAID,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAS;gBAER,WAAW,EAAE,MAAM;IAIzB,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IASjC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IASvC,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAmBxB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAKjE;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,GAAG,WAAW,GAAG,QAAQ,CAAC,GAAG,KAAK,CAOnF;AAID,wBAAsB,UAAU,CAC9B,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,IAAI,CAAC,CAQf;AAID,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBrE"}

package/dist/patch.js

@@ -0,0 +1,97 @@
+/**
+ * Safe patch system — preview, approval, and application.
+ *
+ * Every agent-generated change is represented as a Patch.
+ * Patches with requiresApproval=true are shown as diffs
+ * and must be explicitly approved before being written to disk.
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { randomUUID } from "node:crypto";
+// ── Patch store (file-backed, .portal/patches/) ───────────────────────────────
+export class PatchStore {
+    dir;
+    constructor(projectRoot) {
+        this.dir = join(projectRoot, ".portal", "patches");
+    }
+    async save(patch) {
+        await mkdir(this.dir, { recursive: true });
+        await writeFile(join(this.dir, `${patch.id}.json`), JSON.stringify(patch, null, 2), "utf-8");
+    }
+    async load(id) {
+        try {
+            const raw = await readFile(join(this.dir, `${id}.json`), "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    async list() {
+        const { readdir } = await import("node:fs/promises");
+        try {
+            const files = await readdir(this.dir);
+            const patches = [];
+            for (const f of files) {
+                if (f.endsWith(".json")) {
+                    try {
+                        const raw = await readFile(join(this.dir, f), "utf-8");
+                        patches.push(JSON.parse(raw));
+                    }
+                    catch { /* skip corrupt */ }
+                }
+            }
+            return patches.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+        }
+        catch {
+            return [];
+        }
+    }
+    async update(id, updates) {
+        const patch = await this.load(id);
+        if (!patch)
+            throw new Error(`Patch ${id} not found`);
+        await this.save({ ...patch, ...updates });
+    }
+}
+// ── Patch factory ─────────────────────────────────────────────────────────────
+export function createPatch(opts) {
+    return {
+        ...opts,
+        id: randomUUID(),
+        status: "pending",
+        createdAt: new Date().toISOString(),
+    };
+}
+// ── Apply ─────────────────────────────────────────────────────────────────────
+export async function applyPatch(patch, projectRoot, store) {
+    if (patch.status !== "approved" && patch.requiresApproval) {
+        throw new Error(`Patch ${patch.id} requires approval before applying`);
+    }
+    const filePath = join(projectRoot, patch.file);
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, patch.proposed, "utf-8");
+    await store.update(patch.id, { status: "applied" });
+}
+// ── Inline diff (terminal-friendly) ──────────────────────────────────────────
+export function inlineDiff(original, proposed) {
+    const oLines = original.split("\n");
+    const pLines = proposed.split("\n");
+    const lines = [];
+    const maxLen = Math.max(oLines.length, pLines.length);
+    for (let i = 0; i < maxLen; i++) {
+        const o = oLines[i];
+        const p = pLines[i];
+        if (o === p) {
+            lines.push(`  ${o ?? ""}`);
+        }
+        else {
+            if (o !== undefined)
+                lines.push(`- ${o}`);
+            if (p !== undefined)
+                lines.push(`+ ${p}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=patch.js.map

package/dist/patch.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Runner — fast, cheap first-pass AI model.
+ * Does the actual generation/analysis work.
+ * Output is reviewed by the Sentinel before being applied.
+ */
+import { type AiAssistConfig } from "./aiassist.js";
+export interface RunnerConfig extends Partial<AiAssistConfig> {
+    /** Override model with a fast/cheap option */
+    model?: string;
+}
+export declare class Runner {
+    private client;
+    constructor(config?: RunnerConfig);
+    run(task: string, context: string, systemPrompt?: string): Promise<string>;
+    /** Generate a React page component */
+    generateComponent(opts: {
+        route: string;
+        purpose: string;
+        audience?: string;
+        primaryAction?: string;
+        brandVoice?: string;
+        colors?: string[];
+        existingImports?: string;
+    }): Promise<string>;
+    /** Analyze a file for audit issues */
+    analyzeFile(opts: {
+        filePath: string;
+        content: string;
+        checks: string[];
+        contract: string;
+    }): Promise<string>;
+    /** Generate an improvement patch for an audit finding */
+    generatePatch(opts: {
+        filePath: string;
+        originalContent: string;
+        finding: string;
+        contract: string;
+    }): Promise<string>;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAkB,KAAK,cAAc,EAAgB,MAAM,eAAe,CAAC;AAElF,MAAM,WAAW,YAAa,SAAQ,OAAO,CAAC,cAAc,CAAC;IAC3D,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,GAAE,YAAiB;IAS/B,GAAG,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IAYlB,sCAAsC;IAChC,iBAAiB,CAAC,IAAI,EAAE;QAC5B,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBnB,sCAAsC;IAChC,WAAW,CAAC,IAAI,EAAE;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBnB,yDAAyD;IACnD,aAAa,CAAC,IAAI,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,MAAM,CAAC;CAoBpB"}

package/dist/runner.js

@@ -0,0 +1,81 @@
+/**
+ * Runner — fast, cheap first-pass AI model.
+ * Does the actual generation/analysis work.
+ * Output is reviewed by the Sentinel before being applied.
+ */
+import { AiAssistClient } from "./aiassist.js";
+export class Runner {
+    client;
+    constructor(config = {}) {
+        this.client = new AiAssistClient({
+            apiKey: config.apiKey ?? process.env["AIASSIST_API_KEY"] ?? process.env["VITE_AIAS_API_KEY"] ?? "",
+            baseUrl: config.baseUrl,
+            model: config.model ?? "gpt-4o-mini",
+            timeoutMs: config.timeoutMs ?? 45_000,
+        });
+    }
+    async run(task, context, systemPrompt) {
+        const messages = [];
+        if (systemPrompt) {
+            messages.push({ role: "system", content: systemPrompt });
+        }
+        messages.push({
+            role: "user",
+            content: `${context}\n\n---\nTASK: ${task}`,
+        });
+        return this.client.chat(messages, { temperature: 0.2 });
+    }
+    /** Generate a React page component */
+    async generateComponent(opts) {
+        const systemPrompt = `You are an expert React/TypeScript developer writing components for the Portal framework.
+Output ONLY valid TypeScript JSX. No markdown, no explanation, no code fences.
+Use Tailwind CSS for styling. Follow these rules:
+- Use functional components with explicit return types
+- Import from "@interchained/portal-react" for Link, Head, useNavigate, useParams
+- Colors: ${opts.colors?.join(", ") ?? "follow modern design"}
+- Voice/tone: ${opts.brandVoice ?? "professional and clear"}
+- Always export default`;
+        const prompt = `Generate a React page component for the route "${opts.route}".
+Purpose: ${opts.purpose}
+${opts.audience ? `Audience: ${opts.audience}` : ""}
+${opts.primaryAction ? `Primary action: ${opts.primaryAction}` : ""}
+The component should directly serve the stated purpose with real, compelling content.`;
+        return this.client.complete(prompt, systemPrompt, { maxTokens: 3_000 });
+    }
+    /** Analyze a file for audit issues */
+    async analyzeFile(opts) {
+        const prompt = `Analyze this file for the following issues: ${opts.checks.join(", ")}.
+
+App contract context:
+${opts.contract}
+
+File: ${opts.filePath}
+\`\`\`tsx
+${opts.content}
+\`\`\`
+
+Respond as JSON array of findings:
+[{"check": "seo|cta|links|brand|accessibility", "status": "pass|warn|fail", "message": "...", "line": null, "suggestion": "..."}]`;
+        return this.client.complete(prompt, undefined, { temperature: 0.1 });
+    }
+    /** Generate an improvement patch for an audit finding */
+    async generatePatch(opts) {
+        const systemPrompt = `You are generating a minimal, surgical patch to fix a specific issue in a React/TypeScript file.
+Output ONLY the complete corrected file contents — no explanation, no markdown.`;
+        const prompt = `Fix the following issue in this file:
+
+Issue: ${opts.finding}
+
+App contract:
+${opts.contract}
+
+File: ${opts.filePath}
+\`\`\`tsx
+${opts.originalContent}
+\`\`\`
+
+Return the complete corrected file. Change only what is necessary to fix the issue.`;
+        return this.client.complete(prompt, systemPrompt, { temperature: 0.1, maxTokens: 4_000 });
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAqC,MAAM,eAAe,CAAC;AAOlF,MAAM,OAAO,MAAM;IACT,MAAM,CAAiB;IAE/B,YAAY,SAAuB,EAAE;QACnC,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,EAAE;YAClG,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,aAAa;YACpC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM;SACtC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CACP,IAAY,EACZ,OAAe,EACf,YAAqB;QAErB,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,IAAI,YAAY,EAAE,CAAC;YACjB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,GAAG,OAAO,kBAAkB,IAAI,EAAE;SAC5C,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,iBAAiB,CAAC,IAQvB;QACC,MAAM,YAAY,GAAG;;;;;YAKb,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,sBAAsB;gBAC7C,IAAI,CAAC,UAAU,IAAI,wBAAwB;wBACnC,CAAC;QAErB,MAAM,MAAM,GAAG,kDAAkD,IAAI,CAAC,KAAK;WACpE,IAAI,CAAC,OAAO;EACrB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;EACjD,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;sFACmB,CAAC;QAEnF,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,sCAAsC;IACtC,KAAK,CAAC,WAAW,CAAC,IAKjB;QACC,MAAM,MAAM,GAAG,+CAA+C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAGtF,IAAI,CAAC,QAAQ;;QAEP,IAAI,CAAC,QAAQ;;EAEnB,IAAI,CAAC,OAAO;;;;kIAIoH,CAAC;QAE/H,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,yDAAyD;IACzD,KAAK,CAAC,aAAa,CAAC,IAKnB;QACC,MAAM,YAAY,GAAG;gFACuD,CAAC;QAE7E,MAAM,MAAM,GAAG;;SAEV,IAAI,CAAC,OAAO;;;EAGnB,IAAI,CAAC,QAAQ;;QAEP,IAAI,CAAC,QAAQ;;EAEnB,IAAI,CAAC,eAAe;;;oFAG8D,CAAC;QAEjF,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5F,CAAC;CACF"}

package/dist/sentinel.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Sentinel — reviews Runner output before it touches the codebase.
+ *
+ * The sentinel is a stronger/slower model that:
+ * 1. Checks that the patch actually fixes what it claims to fix
+ * 2. Verifies no forbidden claims or brand violations were introduced
+ * 3. Confirms the change is faithful to the app contract
+ * 4. Produces a human-readable review summary for the approval UI
+ */
+import { type AiAssistConfig } from "./aiassist.js";
+import type { AppContract } from "@interchained/portal-contract";
+export interface SentinelReview {
+    approved: boolean;
+    summary: string;
+    violations: string[];
+    /** Diff-friendly line annotations */
+    annotations: Array<{
+        line?: number;
+        type: "ok" | "warning" | "violation";
+        note: string;
+    }>;
+}
+export declare class Sentinel {
+    private client;
+    constructor(config?: Partial<AiAssistConfig>);
+    /** Review a generated patch against the app contract */
+    review(opts: {
+        contract: AppContract;
+        filePath: string;
+        original: string;
+        proposed: string;
+        agentTask: string;
+    }): Promise<SentinelReview>;
+}
+//# sourceMappingURL=sentinel.d.ts.map

package/dist/sentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinel.d.ts","sourceRoot":"","sources":["../src/sentinel.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,qCAAqC;IACrC,WAAW,EAAE,KAAK,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,WAAW,CAAC;QACrC,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAShD,wDAAwD;IAClD,MAAM,CAAC,IAAI,EAAE;QACjB,QAAQ,EAAE,WAAW,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,cAAc,CAAC;CAsD5B"}