@interchained/portal-cli 0.1.1

package/dist/commands/contract-cmd.js

@@ -0,0 +1,222 @@
+/**
+ * portal contract validate — validate all contract files
+ * portal contract init     — scaffold default contracts for existing apps
+ */
+import { writeFile, access } from "node:fs/promises";
+import { join } from "node:path";
+import pc from "picocolors";
+import prompts from "prompts";
+import { validateContract } from "@interchained/portal-contract";
+import { banner, header, success, fail, warn, info, blank } from "../utils/print.js";
+import { loadContract, findContractPath } from "../utils/contract.js";
+async function exists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── portal contract validate ──────────────────────────────────────────────────
+export async function contractValidateCommand() {
+    banner();
+    header("Contract Validation");
+    blank();
+    const root = process.cwd();
+    let failed = false;
+    // Find and load contract
+    const contractPath = await findContractPath(root);
+    if (!contractPath) {
+        fail("No app.contract.ts found — run: portal contract init");
+        process.exit(1);
+    }
+    let contract;
+    try {
+        contract = await loadContract(root);
+        validateContract(contract);
+        success("Contract schema valid");
+    }
+    catch (err) {
+        fail(`Contract schema invalid: ${err.message}`);
+        failed = true;
+    }
+    if (!failed) {
+        // Unreplaced template tokens
+        const contractStr = JSON.stringify(contract);
+        const tokens = contractStr.match(/\{\{[A-Z_]+\}\}/g);
+        if (tokens) {
+            const unique = [...new Set(tokens)];
+            for (const tok of unique) {
+                fail(`Unreplaced token: ${tok}`);
+            }
+            failed = true;
+        }
+        else {
+            success("No unreplaced template tokens");
+        }
+        // Required fields
+        if (!contract.name?.trim()) {
+            fail("contract.name is empty");
+            failed = true;
+        }
+        else {
+            success(`name: "${contract.name}"`);
+        }
+        if (!contract.goals?.length) {
+            fail("contract.goals is empty");
+            failed = true;
+        }
+        else {
+            success(`goals: ${contract.goals.length} defined`);
+        }
+        // Pages
+        const pages = contract.pages ?? [];
+        let pageIssues = 0;
+        for (const page of pages) {
+            if (!page.purpose?.trim()) {
+                warn(`Page "${page.route}" has no purpose`);
+                pageIssues++;
+            }
+            if (!page.primaryAction?.trim()) {
+                warn(`Page "${page.route}" has no primaryAction`);
+            }
+        }
+        if (pages.length === 0) {
+            warn("No pages declared in contract (optional but recommended)");
+        }
+        else if (pageIssues === 0) {
+            success(`pages: ${pages.length} declared, all have purpose`);
+        }
+        // Data files
+        const data = contract.data ?? {};
+        let missingData = 0;
+        for (const [name, filePath] of Object.entries(data)) {
+            const full = join(root, filePath);
+            if (!(await exists(full))) {
+                warn(`data.${name}: file missing (${filePath})`);
+                missingData++;
+            }
+            else {
+                success(`data.${name}: found`);
+            }
+        }
+    }
+    blank();
+    if (failed) {
+        fail("Contract validation failed — fix the issues above");
+        process.exit(1);
+    }
+    else {
+        success("Contract is valid and ready for agent operations");
+        blank();
+    }
+}
+// ── portal contract init ──────────────────────────────────────────────────────
+const DEFAULT_CONTRACT = (name, description) => `import { defineApp } from "@interchained/portal-contract";
+
+export default defineApp({
+  name: "${name}",
+  version: "1.1.0",
+
+  description: "${description}",
+
+  goals: [
+    "Describe the first thing this app is trying to accomplish",
+    "And the second",
+  ],
+
+  brand: {
+    voice: "clear, direct, professional",
+    colors: ["#0f172a", "#6366f1", "#f8fafc"],
+    forbiddenPhrases: ["world-class", "best-in-class", "game-changer"],
+  },
+
+  policies: {
+    publishing:    "human_review",
+    accessibility: "basic",
+    forbiddenClaims: [],
+  },
+
+  qualityGates: {
+    requireMetaTitle:       true,
+    requireMetaDescription: true,
+    requireH1:              true,
+    requirePrimaryCTA:      true,
+    forbidPlaceholderCopy:  true,
+  },
+
+  pages: [],
+});
+`;
+const DEFAULT_AGENT_CONFIG = `import { defineAgent } from "@interchained/portal-contract";
+
+// Add your agents here — run with: portal agent run <name>
+
+export const seoAgent = defineAgent({
+  name: "seo-reviewer",
+  model: "fast",
+  sentinel: "smart",
+  task: "Review page for SEO gaps and suggest improvements",
+  canPatch: true,
+  requiresApproval: true,
+});
+`;
+export async function contractInitCommand() {
+    banner();
+    const root = process.cwd();
+    // Check existing
+    const existing = await findContractPath(root);
+    if (existing) {
+        info(`Contract already exists: ${existing}`);
+        const { overwrite } = await prompts({
+            type: "confirm",
+            name: "overwrite",
+            message: "Overwrite it?",
+            initial: false,
+        });
+        if (!overwrite) {
+            blank();
+            return;
+        }
+    }
+    const { appName } = await prompts({
+        type: "text",
+        name: "appName",
+        message: "App name:",
+        initial: root.split("/").pop() ?? "my-portal",
+    });
+    const { description } = await prompts({
+        type: "text",
+        name: "description",
+        message: "One-line description:",
+        initial: "A Portal web application",
+    });
+    if (!appName) {
+        blank();
+        return;
+    }
+    // Write app.contract.ts
+    await writeFile(join(root, "app.contract.ts"), DEFAULT_CONTRACT(appName, description || "A Portal web application"), "utf-8");
+    success("Created: app.contract.ts");
+    // Write agent.config.ts if it doesn't exist
+    const agentConfigPath = join(root, "agent.config.ts");
+    if (!(await exists(agentConfigPath))) {
+        await writeFile(agentConfigPath, DEFAULT_AGENT_CONFIG, "utf-8");
+        success("Created: agent.config.ts");
+    }
+    // Create agents/ dir
+    const agentsDir = join(root, "agents");
+    if (!(await exists(agentsDir))) {
+        const { mkdir } = await import("node:fs/promises");
+        await mkdir(agentsDir, { recursive: true });
+        success("Created: agents/");
+    }
+    blank();
+    info("Next steps:");
+    console.log(pc.dim("  1. Edit app.contract.ts — define your goals, brand, and policies"));
+    console.log(pc.dim("  2. portal contract validate — verify it's correct"));
+    console.log(pc.dim("  3. portal audit — run your first audit"));
+    blank();
+}
+//# sourceMappingURL=contract-cmd.js.map

package/dist/commands/contract-cmd.js.map

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

package/dist/commands/deploy.d.ts

@@ -0,0 +1,13 @@
+/**
+ * portal deploy — build and prepare deployment artifacts.
+ *
+ * Adapters: static | node | docker
+ */
+export type DeployAdapter = "static" | "node" | "docker";
+export interface DeployOptions {
+    adapter?: DeployAdapter;
+    outDir?: string;
+    tag?: string;
+}
+export declare function deployCommand(opts?: DeployOptions): Promise<void>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/commands/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA0CD,wBAAsB,aAAa,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiF3E"}

package/dist/commands/deploy.js

@@ -0,0 +1,135 @@
+/**
+ * portal deploy — build and prepare deployment artifacts.
+ *
+ * Adapters: static | node | docker
+ */
+import { writeFile, access } from "node:fs/promises";
+import { join } from "node:path";
+import pc from "picocolors";
+import { execa } from "execa";
+import prompts from "prompts";
+import { banner, header, success, fail, info, step, blank } from "../utils/print.js";
+const DOCKERFILE = `FROM node:20-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npx vite build
+
+FROM node:20-alpine
+WORKDIR /app
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/package*.json ./
+RUN npm ci --production
+EXPOSE 3000
+CMD ["node", "dist/server.js"]
+`;
+const SERVER_ENTRY = `import express from "express";
+import { createServer } from "node:http";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { existsSync } from "node:fs";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const app = express();
+const PORT = process.env.PORT ?? 3000;
+
+app.use(express.static(join(__dirname, ".")));
+app.get("*", (_req, res) => {
+  res.sendFile(join(__dirname, "index.html"));
+});
+
+createServer(app).listen(PORT, () => {
+  console.log(\`Portal app running on port \${PORT}\`);
+});
+`;
+async function exists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function deployCommand(opts = {}) {
+    banner();
+    const root = process.cwd();
+    let adapter = opts.adapter;
+    if (!adapter) {
+        const { chosen } = await prompts({
+            type: "select",
+            name: "chosen",
+            message: "Choose deployment adapter:",
+            choices: [
+                { title: `${pc.bold("static")}  ${pc.dim("— CDN / Netlify / Vercel / S3")}`, value: "static" },
+                { title: `${pc.bold("node")}    ${pc.dim("— Node.js server (Express)")}`, value: "node" },
+                { title: `${pc.bold("docker")}  ${pc.dim("— Docker container (self-hosted)")}`, value: "docker" },
+            ],
+        });
+        adapter = chosen;
+    }
+    if (!adapter) {
+        blank();
+        return;
+    }
+    header(`Deploying: ${pc.bold(adapter)}`);
+    blank();
+    // Always build first
+    step("Building production bundle…");
+    try {
+        await execa("npx", ["vite", "build", "--outDir", opts.outDir ?? "dist"], {
+            cwd: root,
+            stdio: "inherit",
+            env: { ...process.env, FORCE_COLOR: "1" },
+        });
+        success("Build complete");
+    }
+    catch {
+        fail("Build failed — fix errors before deploying");
+        process.exit(1);
+    }
+    blank();
+    if (adapter === "static") {
+        success("Static build ready in dist/");
+        info("Deploy dist/ to any static host: Netlify, Vercel, S3, Cloudflare Pages, or rsync.");
+    }
+    else if (adapter === "node") {
+        // Write server entry if missing
+        const serverPath = join(root, "dist", "server.js");
+        if (!(await exists(serverPath))) {
+            step("Writing Node.js server entry (dist/server.js)…");
+            await writeFile(serverPath, SERVER_ENTRY, "utf-8");
+            success("dist/server.js written");
+        }
+        info("Run: node dist/server.js");
+        info("Set PORT env var to choose the port (default 3000).");
+    }
+    else if (adapter === "docker") {
+        const dockerfilePath = join(root, "Dockerfile");
+        if (!(await exists(dockerfilePath))) {
+            step("Writing Dockerfile…");
+            await writeFile(dockerfilePath, DOCKERFILE, "utf-8");
+            success("Dockerfile written");
+        }
+        else {
+            info("Dockerfile already exists — using existing one");
+        }
+        const tag = opts.tag ?? "portal-app:latest";
+        step(`Building Docker image: ${tag}…`);
+        try {
+            await execa("docker", ["build", "-t", tag, "."], {
+                cwd: root,
+                stdio: "inherit",
+            });
+            success(`Docker image built: ${tag}`);
+            info(`Run: docker run -p 3000:3000 ${tag}`);
+        }
+        catch {
+            console.log(pc.yellow("⚠ Docker build failed — make sure Docker is running"));
+            info("Dockerfile written to project root — build manually when ready.");
+        }
+    }
+    blank();
+}
+//# sourceMappingURL=deploy.js.map

package/dist/commands/deploy.js.map

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

package/dist/commands/dev.d.ts

@@ -0,0 +1,10 @@
+/**
+ * portal dev — starts the Vite dev server with Portal plugin.
+ */
+export interface DevOptions {
+    port?: number;
+    host?: boolean;
+    open?: boolean;
+}
+export declare function devCommand(opts?: DevOptions): Promise<void>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/commands/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,UAAU,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BrE"}

package/dist/commands/dev.js

@@ -0,0 +1,37 @@
+/**
+ * portal dev — starts the Vite dev server with Portal plugin.
+ */
+import { join } from "node:path";
+import { execa } from "execa";
+import pc from "picocolors";
+import { banner, step } from "../utils/print.js";
+export async function devCommand(opts = {}) {
+    banner();
+    const root = process.cwd();
+    const viteConfig = join(root, "vite.config.ts");
+    step(`Starting dev server${opts.port ? ` on port ${opts.port}` : ""}…`);
+    console.log(pc.dim(`  root: ${root}`));
+    console.log();
+    const args = ["vite", "--config", viteConfig];
+    if (opts.port)
+        args.push("--port", String(opts.port));
+    if (opts.host)
+        args.push("--host");
+    if (opts.open)
+        args.push("--open");
+    try {
+        await execa("npx", args, {
+            stdio: "inherit",
+            cwd: root,
+            env: { ...process.env, FORCE_COLOR: "1" },
+        });
+    }
+    catch (err) {
+        // Vite exits non-zero on SIGINT — that's fine
+        const code = err.exitCode;
+        if (code !== 0 && code !== null && code !== undefined) {
+            process.exit(code);
+        }
+    }
+}
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAQ,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAQvD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAmB,EAAE;IACpD,MAAM,EAAE,CAAC;IAET,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAEhD,IAAI,CAAC,sBAAsB,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IAC9C,IAAI,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE;YACvB,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,IAAI;YACT,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE;SAC1C,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,8CAA8C;QAC9C,MAAM,IAAI,GAAI,GAA6B,CAAC,QAAQ,CAAC;QACrD,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,6 @@
+/**
+ * portal doctor — environment + project health check.
+ * Runs before you let agents near your code.
+ */
+export declare function doctorCommand(): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAgInD"}

package/dist/commands/doctor.js

@@ -0,0 +1,139 @@
+/**
+ * portal doctor — environment + project health check.
+ * Runs before you let agents near your code.
+ */
+import { access, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import pc from "picocolors";
+import { banner, header, success, warn, fail, blank } from "../utils/print.js";
+import { loadContract, findContractPath } from "../utils/contract.js";
+async function exists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function doctorCommand() {
+    banner();
+    header("Portal Doctor");
+    const root = process.cwd();
+    const checks = [];
+    // Node version
+    const nodeVer = process.version;
+    const nodeMaj = parseInt(nodeVer.slice(1), 10);
+    checks.push({
+        label: `Node.js ${nodeVer}`,
+        status: nodeMaj >= 18 ? "ok" : "fail",
+        detail: nodeMaj < 18 ? "Portal requires Node.js 18 or newer" : undefined,
+    });
+    // vite.config.ts / portal.config.ts
+    const hasViteConfig = (await exists(join(root, "vite.config.ts"))) ||
+        (await exists(join(root, "vite.config.js"))) ||
+        (await exists(join(root, "portal.config.ts")));
+    checks.push({
+        label: "vite.config.ts",
+        status: hasViteConfig ? "ok" : "warn",
+        detail: !hasViteConfig ? "No Vite config found — run: npm create portal-app" : undefined,
+    });
+    // app.contract.ts
+    const contractPath = await findContractPath(root);
+    checks.push({
+        label: "app.contract.ts",
+        status: contractPath ? "ok" : "warn",
+        detail: !contractPath
+            ? "No contract found — run: portal contract init"
+            : undefined,
+    });
+    // routes/ directory
+    const routesDir = join(root, "routes");
+    const hasRoutes = await exists(routesDir);
+    let routeCount = 0;
+    if (hasRoutes) {
+        try {
+            const entries = await readdir(routesDir, { recursive: true });
+            routeCount = entries.filter((e) => e.endsWith(".page.tsx") || e.endsWith(".page.jsx")).length;
+        }
+        catch { /* */ }
+    }
+    checks.push({
+        label: `routes/ (${routeCount} page${routeCount !== 1 ? "s" : ""})`,
+        status: hasRoutes && routeCount > 0 ? "ok" : "warn",
+        detail: !hasRoutes
+            ? "No routes/ directory found"
+            : routeCount === 0
+                ? "routes/ exists but has no *.page.tsx files"
+                : undefined,
+    });
+    // package.json
+    const hasPkg = await exists(join(root, "package.json"));
+    checks.push({
+        label: "package.json",
+        status: hasPkg ? "ok" : "fail",
+        detail: !hasPkg ? "No package.json — are you in the right directory?" : undefined,
+    });
+    // AI API key
+    const hasApiKey = !!process.env["AIASSIST_API_KEY"] || !!process.env["VITE_AIAS_API_KEY"];
+    checks.push({
+        label: "AIASSIST_API_KEY",
+        status: hasApiKey ? "ok" : "warn",
+        detail: !hasApiKey
+            ? "Not set — portal audit --ai, portal improve, and portal generate require this"
+            : undefined,
+    });
+    // Data files referenced in contract
+    if (contractPath) {
+        const contract = await loadContract(root);
+        for (const [name, filePath] of Object.entries(contract.data ?? {})) {
+            const fullPath = join(root, filePath);
+            const fileExists = await exists(fullPath);
+            checks.push({
+                label: `data.${name} (${filePath})`,
+                status: fileExists ? "ok" : "warn",
+                detail: !fileExists ? `Data file missing: ${filePath}` : undefined,
+            });
+        }
+        // Check for unreplaced tokens in contract name
+        if (contract.name.includes("{{")) {
+            checks.push({
+                label: "contract.name",
+                status: "fail",
+                detail: `Contract name contains unreplaced token: "${contract.name}"`,
+            });
+        }
+    }
+    // Print results
+    blank();
+    for (const check of checks) {
+        if (check.status === "ok") {
+            success(check.label);
+        }
+        else if (check.status === "warn") {
+            warn(check.label);
+            if (check.detail)
+                console.log(pc.dim(`   ${check.detail}`));
+        }
+        else {
+            fail(check.label);
+            if (check.detail)
+                console.log(pc.red(`   ${check.detail}`));
+        }
+    }
+    blank();
+    const failCount = checks.filter((c) => c.status === "fail").length;
+    const warnCount = checks.filter((c) => c.status === "warn").length;
+    if (failCount > 0) {
+        fail(`${failCount} critical issue${failCount !== 1 ? "s" : ""} found — fix before proceeding`);
+        process.exit(1);
+    }
+    else if (warnCount > 0) {
+        warn(`${warnCount} warning${warnCount !== 1 ? "s" : ""} — not blocking, but worth fixing`);
+    }
+    else {
+        success("All checks passed — project looks healthy");
+    }
+    blank();
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/explain.d.ts

@@ -0,0 +1,6 @@
+/**
+ * portal explain <file> — explain a route, component, contract, or project
+ * structure in plain English using AI.
+ */
+export declare function explainCommand(target: string): Promise<void>;
+//# sourceMappingURL=explain.d.ts.map

package/dist/commands/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsElE"}