@interchained/portal-agent 0.1.0

package/dist/aiassist.d.ts

@@ -0,0 +1,43 @@
+/**
+ * AiAssist.net HTTP client.
+ * Uses an OpenAI-compatible chat completions API.
+ * Set AIASSIST_API_KEY or VITE_AIAS_API_KEY in your environment.
+ */
+export interface Message {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+export interface CompletionOptions {
+    temperature?: number;
+    maxTokens?: number;
+    /** Stop sequences */
+    stop?: string[];
+}
+export declare class AiAssistError extends Error {
+    readonly statusCode: number;
+    readonly body?: string | undefined;
+    constructor(message: string, statusCode: number, body?: string | undefined);
+}
+export interface AiAssistConfig {
+    apiKey: string;
+    /** Base URL for the AiAssist API. Defaults to https://api.aiassist.net/v1 */
+    baseUrl?: string;
+    /** Model identifier */
+    model?: string;
+    /** Request timeout in ms. Defaults to 60 000 */
+    timeoutMs?: number;
+}
+export declare class AiAssistClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly model;
+    private readonly timeoutMs;
+    constructor(config: AiAssistConfig);
+    /** Single-turn completion — convenience wrapper around chat() */
+    complete(prompt: string, systemPrompt?: string, options?: CompletionOptions): Promise<string>;
+    /** Multi-turn chat completion */
+    chat(messages: Message[], options?: CompletionOptions): Promise<string>;
+    /** Resolve API key from environment if not explicitly provided */
+    static fromEnv(overrides?: Partial<AiAssistConfig>): AiAssistClient;
+}
+//# sourceMappingURL=aiassist.d.ts.map

package/dist/aiassist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiassist.d.ts","sourceRoot":"","sources":["../src/aiassist.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAUD,qBAAa,aAAc,SAAQ,KAAK;aAGpB,UAAU,EAAE,MAAM;aAClB,IAAI,CAAC,EAAE,MAAM;gBAF7B,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,cAAc;IAOlC,iEAAiE;IAC3D,QAAQ,CACZ,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,MAAM,CAAC;IAOlB,iCAAiC;IAC3B,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IA+C7E,kEAAkE;IAClE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc;CAapE"}

package/dist/aiassist.js

@@ -0,0 +1,87 @@
+/**
+ * AiAssist.net HTTP client.
+ * Uses an OpenAI-compatible chat completions API.
+ * Set AIASSIST_API_KEY or VITE_AIAS_API_KEY in your environment.
+ */
+export class AiAssistError extends Error {
+    statusCode;
+    body;
+    constructor(message, statusCode, body) {
+        super(message);
+        this.statusCode = statusCode;
+        this.body = body;
+        this.name = "AiAssistError";
+    }
+}
+export class AiAssistClient {
+    apiKey;
+    baseUrl;
+    model;
+    timeoutMs;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.baseUrl = (config.baseUrl ?? "https://api.aiassist.net/v1").replace(/\/$/, "");
+        this.model = config.model ?? "gpt-4o";
+        this.timeoutMs = config.timeoutMs ?? 60_000;
+    }
+    /** Single-turn completion — convenience wrapper around chat() */
+    async complete(prompt, systemPrompt, options) {
+        const messages = [];
+        if (systemPrompt)
+            messages.push({ role: "system", content: systemPrompt });
+        messages.push({ role: "user", content: prompt });
+        return this.chat(messages, options);
+    }
+    /** Multi-turn chat completion */
+    async chat(messages, options) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        let response;
+        try {
+            response = await fetch(`${this.baseUrl}/chat/completions`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: this.model,
+                    messages,
+                    temperature: options?.temperature ?? 0.3,
+                    max_tokens: options?.maxTokens ?? 4_096,
+                    ...(options?.stop ? { stop: options.stop } : {}),
+                }),
+                signal: controller.signal,
+            });
+        }
+        catch (err) {
+            clearTimeout(timer);
+            if (err.name === "AbortError") {
+                throw new AiAssistError("Request timed out", 408);
+            }
+            throw new AiAssistError(`Network error: ${err.message}`, 0);
+        }
+        clearTimeout(timer);
+        if (!response.ok) {
+            const body = await response.text().catch(() => "");
+            throw new AiAssistError(`AiAssist API error ${response.status}`, response.status, body);
+        }
+        const data = (await response.json());
+        const content = data.choices?.[0]?.message?.content;
+        if (typeof content !== "string") {
+            throw new AiAssistError("Unexpected response shape from AiAssist API", 500);
+        }
+        return content;
+    }
+    /** Resolve API key from environment if not explicitly provided */
+    static fromEnv(overrides) {
+        const apiKey = overrides?.apiKey ??
+            process.env["AIASSIST_API_KEY"] ??
+            process.env["VITE_AIAS_API_KEY"];
+        if (!apiKey) {
+            throw new Error("AiAssist API key not found. Set AIASSIST_API_KEY or VITE_AIAS_API_KEY.");
+        }
+        return new AiAssistClient({ apiKey, ...overrides });
+    }
+}
+//# sourceMappingURL=aiassist.js.map

package/dist/aiassist.js.map

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

package/dist/audit.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Portal Audit Engine — v1.1
+ *
+ * Runs structured checks across all route files against the app contract.
+ * Quality gates in the contract promote specific warns to hard fails.
+ *
+ * Categories: seo · cta · links · brand · accessibility · quality
+ */
+import type { AppContract } from "@interchained/portal-contract";
+import { Runner } from "./runner.js";
+export type CheckCategory = "seo" | "cta" | "links" | "brand" | "accessibility" | "quality";
+export type CheckStatus = "pass" | "warn" | "fail";
+export interface AuditFinding {
+    category: CheckCategory;
+    status: CheckStatus;
+    file: string;
+    message: string;
+    suggestion?: string;
+    line?: number;
+}
+export interface AuditReport {
+    timestamp: string;
+    appName: string;
+    routesDir: string;
+    findings: AuditFinding[];
+    summary: {
+        pass: number;
+        warn: number;
+        fail: number;
+        total: number;
+    };
+}
+export declare function runAudit(contract: AppContract, routesDir: string, options?: {
+    ai?: boolean;
+    runner?: Runner;
+}): Promise<AuditReport>;
+//# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,WAAW,EAGZ,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,KAAK,GACL,OAAO,GACP,OAAO,GACP,eAAe,GACf,SAAS,CAAC;AACd,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AA0ND,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,WAAW,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9C,OAAO,CAAC,WAAW,CAAC,CA+EtB"}

package/dist/audit.js

@@ -0,0 +1,233 @@
+/**
+ * Portal Audit Engine — v1.1
+ *
+ * Runs structured checks across all route files against the app contract.
+ * Quality gates in the contract promote specific warns to hard fails.
+ *
+ * Categories: seo · cta · links · brand · accessibility · quality
+ */
+import { readFile, readdir } from "node:fs/promises";
+import { join, extname, relative } from "node:path";
+// ── Gate helpers ──────────────────────────────────────────────────────────────
+function gated(gates, gate, defaultStatus = "warn") {
+    return gates?.[gate] === true ? "fail" : defaultStatus;
+}
+// ── Static checks ─────────────────────────────────────────────────────────────
+function checkSeoStatic(content, file, page, contract) {
+    const gates = contract.qualityGates;
+    const findings = [];
+    const rel = relative(process.cwd(), file);
+    const hasHeadTitle = content.includes("<Head") ||
+        content.includes("useHead") ||
+        /title\s*[:=]/.test(content);
+    if (!hasHeadTitle) {
+        findings.push({
+            category: "seo",
+            status: gated(gates, "requireMetaTitle"),
+            file: rel,
+            message: "No <Head title> found — page is missing title metadata",
+            suggestion: `Add <Head title="..." description="..." /> from @interchained/portal-react`,
+        });
+    }
+    const hasDescription = /description\s*[:=]/.test(content) || content.includes("meta name=\"description\"");
+    if (!hasDescription) {
+        findings.push({
+            category: "seo",
+            status: gated(gates, "requireMetaDescription"),
+            file: rel,
+            message: "No meta description found",
+            suggestion: "Add a description prop to <Head>",
+        });
+    }
+    if (!/<h1[\s>]/i.test(content)) {
+        findings.push({
+            category: "seo",
+            status: gated(gates, "requireH1"),
+            file: rel,
+            message: "No <h1> element found — every page needs exactly one h1",
+            suggestion: "Add an <h1> with your primary heading",
+        });
+    }
+    const seoKeyword = page?.seoKeyword ?? contract.seo?.primaryKeyword;
+    if (seoKeyword && !content.toLowerCase().includes(seoKeyword.toLowerCase())) {
+        findings.push({
+            category: "seo",
+            status: "warn",
+            file: rel,
+            message: `Target SEO keyword "${seoKeyword}" not found in page content`,
+            suggestion: `Include "${seoKeyword}" naturally in headings or body copy`,
+        });
+    }
+    return findings;
+}
+function checkCtaStatic(content, file, gates) {
+    const rel = relative(process.cwd(), file);
+    const hasCta = /<button|<Button|<Link[\s>]|href=|onClick/i.test(content);
+    if (!hasCta) {
+        return [
+            {
+                category: "cta",
+                status: gated(gates, "requirePrimaryCTA"),
+                file: rel,
+                message: "No call-to-action found (button, link, or click handler)",
+                suggestion: "Every page should guide the user toward a specific action",
+            },
+        ];
+    }
+    return [];
+}
+function checkAccessibilityStatic(content, file, level, gates) {
+    const findings = [];
+    const rel = relative(process.cwd(), file);
+    for (const match of content.matchAll(/<img\s[^>]*>/gi)) {
+        if (!/alt\s*=/i.test(match[0])) {
+            findings.push({
+                category: "accessibility",
+                status: gated(gates, "requireAltText", level === "strict" ? "fail" : "warn"),
+                file: rel,
+                message: "<img> tag missing alt attribute",
+                suggestion: `Add alt="" (decorative) or descriptive alt text`,
+            });
+        }
+    }
+    if (level === "strict" && !/<main[\s>]/i.test(content)) {
+        findings.push({
+            category: "accessibility",
+            status: "warn",
+            file: rel,
+            message: "No <main> landmark element found",
+            suggestion: "Wrap primary content in <main> for screen readers",
+        });
+    }
+    return findings;
+}
+function checkBrandStatic(content, file, contract) {
+    const findings = [];
+    const rel = relative(process.cwd(), file);
+    for (const phrase of contract.brand?.forbiddenPhrases ?? []) {
+        if (content.toLowerCase().includes(phrase.toLowerCase())) {
+            findings.push({
+                category: "brand",
+                status: "fail",
+                file: rel,
+                message: `Forbidden brand phrase found: "${phrase}"`,
+                suggestion: "Remove or replace — this phrase violates brand guidelines",
+            });
+        }
+    }
+    return findings;
+}
+function checkQualityStatic(content, file, gates) {
+    const findings = [];
+    const rel = relative(process.cwd(), file);
+    if (gates?.forbidPlaceholderCopy) {
+        const placeholders = ["lorem ipsum", "placeholder text", "todo:", "fixme:"];
+        for (const p of placeholders) {
+            if (content.toLowerCase().includes(p)) {
+                findings.push({
+                    category: "quality",
+                    status: "fail",
+                    file: rel,
+                    message: `Placeholder copy found: "${p}"`,
+                    suggestion: "Replace with real content before shipping",
+                });
+                break;
+            }
+        }
+    }
+    if (gates?.forbidUnreplacedTokens) {
+        const tokenMatch = content.match(/\{\{[A-Z_]+\}\}/);
+        if (tokenMatch) {
+            findings.push({
+                category: "quality",
+                status: "fail",
+                file: rel,
+                message: `Unreplaced template token found: "${tokenMatch[0]}"`,
+                suggestion: "Replace all {{TOKEN}} values with real content",
+            });
+        }
+    }
+    return findings;
+}
+// ── Route discovery ───────────────────────────────────────────────────────────
+async function findRouteFiles(routesDir) {
+    const files = [];
+    try {
+        const entries = await readdir(routesDir, { recursive: true });
+        for (const entry of entries) {
+            if (typeof entry === "string") {
+                const ext = extname(entry);
+                if ([".tsx", ".jsx", ".ts", ".js"].includes(ext)) {
+                    files.push(join(routesDir, entry));
+                }
+            }
+        }
+    }
+    catch {
+        // routesDir doesn't exist
+    }
+    return files;
+}
+// ── Main ──────────────────────────────────────────────────────────────────────
+export async function runAudit(contract, routesDir, options = {}) {
+    const files = await findRouteFiles(routesDir);
+    const allFindings = [];
+    const accessibility = contract.policies?.accessibility ?? "basic";
+    const gates = contract.qualityGates;
+    for (const file of files) {
+        const content = await readFile(file, "utf-8");
+        const rel = relative(process.cwd(), file);
+        const routeSlug = rel
+            .replace(/^routes\//, "")
+            .replace(/\.page\.(tsx|jsx|ts|js)$/, "")
+            .replace(/index$/, "");
+        const route = "/" + routeSlug;
+        const pageContract = contract.pages?.find((p) => p.route === route);
+        allFindings.push(...checkSeoStatic(content, file, pageContract, contract));
+        allFindings.push(...checkCtaStatic(content, file, gates));
+        allFindings.push(...checkBrandStatic(content, file, contract));
+        allFindings.push(...checkQualityStatic(content, file, gates));
+        if (accessibility !== "none") {
+            allFindings.push(...checkAccessibilityStatic(content, file, accessibility, gates));
+        }
+        if (options.ai && options.runner) {
+            try {
+                const contractSummary = `Name: ${contract.name}\nGoals: ${contract.goals.join(", ")}`;
+                const raw = await options.runner.analyzeFile({
+                    filePath: rel,
+                    content,
+                    checks: ["seo", "cta", "brand", "accessibility", "contract-alignment"],
+                    contract: contractSummary,
+                });
+                const jsonStr = raw.replace(/^```json\s*/i, "").replace(/\s*```$/, "").trim();
+                const aiFindings = JSON.parse(jsonStr);
+                for (const f of aiFindings) {
+                    if (f.status !== "pass") {
+                        allFindings.push({
+                            category: f.check,
+                            status: f.status,
+                            file: rel,
+                            message: f.message,
+                            line: f.line,
+                            suggestion: f.suggestion,
+                        });
+                    }
+                }
+            }
+            catch {
+                // AI analysis is best-effort
+            }
+        }
+    }
+    const pass = allFindings.filter((f) => f.status === "pass").length;
+    const warn = allFindings.filter((f) => f.status === "warn").length;
+    const fail = allFindings.filter((f) => f.status === "fail").length;
+    return {
+        timestamp: new Date().toISOString(),
+        appName: contract.name,
+        routesDir,
+        findings: allFindings,
+        summary: { pass, warn, fail, total: allFindings.length },
+    };
+}
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

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

package/dist/generate.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Page / component generation.
+ *
+ * Reads the app contract, calls the Runner to generate a React component,
+ * passes it through the Sentinel for safety review, then creates a Patch
+ * for human approval (if required by policy).
+ */
+import type { AppContract, PageContract } from "@interchained/portal-contract";
+import { Runner } from "./runner.js";
+import { Sentinel } from "./sentinel.js";
+import { type Patch } from "./patch.js";
+export interface GenerateOptions {
+    runner: Runner;
+    sentinel?: Sentinel;
+    contract: AppContract;
+    projectRoot: string;
+    /** Override the policy — useful for interactive approve-later flow */
+    requiresApproval?: boolean;
+}
+export interface GenerateResult {
+    patch: Patch;
+    sentinelReview?: {
+        approved: boolean;
+        summary: string;
+        violations: string[];
+    };
+}
+/**
+ * Generate a new page component from a PageContract or an ad-hoc prompt.
+ */
+export declare function generatePage(page: PageContract & {
+    description?: string;
+}, opts: GenerateOptions): Promise<GenerateResult>;
+/**
+ * Generate a page from a freeform description (no pre-existing PageContract).
+ * `portal generate page "Father's Day promo"` style.
+ */
+export declare function generateFromPrompt(prompt: string, opts: GenerateOptions & {
+    route?: string;
+}): Promise<GenerateResult>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,EAAE,WAAW,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,CAAC,EAAE;QACf,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,YAAY,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,cAAc,CAAC,CAwDzB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,eAAe,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACzC,OAAO,CAAC,cAAc,CAAC,CASzB"}

package/dist/generate.js

@@ -0,0 +1,92 @@
+/**
+ * Page / component generation.
+ *
+ * Reads the app contract, calls the Runner to generate a React component,
+ * passes it through the Sentinel for safety review, then creates a Patch
+ * for human approval (if required by policy).
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { createPatch } from "./patch.js";
+/**
+ * Generate a new page component from a PageContract or an ad-hoc prompt.
+ */
+export async function generatePage(page, opts) {
+    const { runner, sentinel, contract } = opts;
+    // Check if the file already exists — use as context
+    const fileName = routeToFileName(page.route);
+    const filePath = join(opts.projectRoot, "routes", fileName);
+    let original = "";
+    try {
+        original = await readFile(filePath, "utf-8");
+    }
+    catch {
+        // New file — original is empty
+    }
+    const proposed = await runner.generateComponent({
+        route: page.route,
+        purpose: page.purpose,
+        audience: page.audience,
+        primaryAction: page.primaryAction,
+        brandVoice: contract.brand?.voice,
+        colors: contract.brand?.colors,
+    });
+    const requiresApproval = opts.requiresApproval ??
+        contract.policies?.publishing === "human_review";
+    let sentinelResult;
+    if (sentinel) {
+        const review = await sentinel.review({
+            contract,
+            filePath,
+            original,
+            proposed,
+            agentTask: `Generate page for route "${page.route}": ${page.purpose}`,
+        });
+        sentinelResult = {
+            approved: review.approved,
+            summary: review.summary,
+            violations: review.violations,
+        };
+    }
+    const patch = createPatch({
+        agent: "portal-generate",
+        file: join("routes", fileName),
+        original,
+        proposed,
+        reason: `Generate page: ${page.purpose}`,
+        requiresApproval,
+        sentinelApproved: sentinelResult?.approved,
+        sentinelSummary: sentinelResult?.summary,
+        sentinelViolations: sentinelResult?.violations,
+    });
+    return { patch, sentinelReview: sentinelResult };
+}
+/**
+ * Generate a page from a freeform description (no pre-existing PageContract).
+ * `portal generate page "Father's Day promo"` style.
+ */
+export async function generateFromPrompt(prompt, opts) {
+    const route = opts.route ?? promptToRoute(prompt);
+    const page = {
+        route,
+        purpose: prompt,
+        audience: undefined,
+        primaryAction: undefined,
+    };
+    return generatePage(page, opts);
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function routeToFileName(route) {
+    const clean = route.replace(/^\//, "") || "index";
+    return `${clean}.page.tsx`;
+}
+function promptToRoute(prompt) {
+    return ("/" +
+        prompt
+            .toLowerCase()
+            .replace(/[^a-z0-9\s-]/g, "")
+            .trim()
+            .replace(/\s+/g, "-")
+            .slice(0, 48));
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

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

package/dist/guard.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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
+ */
+import type { AppContract } from "@interchained/portal-contract";
+import type { Patch } from "./patch.js";
+export interface GuardViolation {
+    rule: string;
+    severity: "block" | "warn";
+    message: string;
+    evidence?: string;
+}
+export interface GuardResult {
+    patchId: string;
+    passed: boolean;
+    violations: GuardViolation[];
+}
+export declare function guardPatch(patch: Patch, contract: AppContract): Promise<GuardResult>;
+/** Run guard checks across all pending patches */
+export declare function guardAllPending(patches: Patch[], contract: AppContract): Promise<GuardResult[]>;
+//# sourceMappingURL=guard.d.ts.map

package/dist/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../src/guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAmGD,wBAAsB,UAAU,CAC9B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,WAAW,CAAC,CAetB;AAED,kDAAkD;AAClD,wBAAsB,eAAe,CACnC,OAAO,EAAE,KAAK,EAAE,EAChB,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,WAAW,EAAE,CAAC,CAGxB"}