@interchained/portal-cli 0.1.1

package/dist/commands/explain.js

@@ -0,0 +1,75 @@
+/**
+ * portal explain <file> — explain a route, component, contract, or project
+ * structure in plain English using AI.
+ */
+import { readFile } from "node:fs/promises";
+import { join, extname } from "node:path";
+import pc from "picocolors";
+import ora from "ora";
+import { AiAssistClient } from "@interchained/portal-agent";
+import { banner, fail, blank } from "../utils/print.js";
+import { loadContract } from "../utils/contract.js";
+export async function explainCommand(target) {
+    banner();
+    const root = process.cwd();
+    const filePath = join(root, target);
+    let content;
+    try {
+        content = await readFile(filePath, "utf-8");
+    }
+    catch {
+        fail(`Cannot read file: ${target}`);
+        process.exit(1);
+    }
+    const contract = await loadContract(root);
+    const ext = extname(target);
+    const isContract = target.includes("contract");
+    const isAgent = target.includes("agent");
+    const fileType = isContract ? "app contract" :
+        isAgent ? "agent definition" :
+            ext === ".tsx" || ext === ".jsx" ? "React component/page" :
+                ext === ".ts" ? "TypeScript module" :
+                    "file";
+    let client;
+    try {
+        client = AiAssistClient.fromEnv();
+    }
+    catch {
+        fail("AIASSIST_API_KEY not set — portal explain requires AI.");
+        process.exit(1);
+    }
+    const spinner = ora(`Explaining ${target}…`).start();
+    const systemPrompt = `You are a senior developer explaining code to a teammate.
+Be clear, concrete, and direct. No jargon without explanation. Use plain paragraphs.
+Reference the app contract context where relevant.
+App: ${contract.name}
+Goals: ${contract.goals.slice(0, 3).join("; ")}`;
+    const prompt = `Explain this ${fileType} in plain English.
+Cover: what it does, why it exists, how it fits the app, and any notable patterns or gotchas.
+Keep it to 3–5 paragraphs.
+
+File: ${target}
+\`\`\`${ext.slice(1)}
+${content.slice(0, 6000)}
+\`\`\``;
+    let explanation;
+    try {
+        explanation = await client.complete(prompt, systemPrompt, {
+            temperature: 0.4,
+            maxTokens: 1_500,
+        });
+        spinner.stop();
+    }
+    catch (err) {
+        spinner.stop();
+        fail(`AI request failed: ${err.message}`);
+        process.exit(1);
+    }
+    console.log();
+    console.log(pc.bold(pc.cyan(`Explanation: ${target}`)));
+    console.log(pc.dim("─".repeat(60)));
+    console.log();
+    console.log(explanation);
+    blank();
+}
+//# sourceMappingURL=explain.js.map

package/dist/commands/explain.js.map

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

package/dist/commands/generate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * portal generate page <description>
+ * portal generate component <name>
+ * portal generate api <name>
+ */
+export type GenerateSubcommand = "page" | "landing" | "component" | "api";
+export interface GenerateOptions {
+    route?: string;
+    auto?: boolean;
+    noSentinel?: boolean;
+}
+export declare function generateCommand(sub: GenerateSubcommand, description: string, opts?: GenerateOptions): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,KAAK,CAAC;AAE1E,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAoDD,wBAAsB,eAAe,CACnC,GAAG,EAAE,kBAAkB,EACvB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAmLf"}

package/dist/commands/generate.js

@@ -0,0 +1,222 @@
+/**
+ * portal generate page <description>
+ * portal generate component <name>
+ * portal generate api <name>
+ */
+import { join } from "node:path";
+import { writeFile, mkdir } from "node:fs/promises";
+import prompts from "prompts";
+import pc from "picocolors";
+import ora from "ora";
+import { Runner, Sentinel, generateFromPrompt, applyPatch, PatchStore, } from "@interchained/portal-agent";
+import { banner, header, success, fail, info, blank, icon } from "../utils/print.js";
+import { loadContract } from "../utils/contract.js";
+// ── Component generation prompt ───────────────────────────────────────────────
+async function generateComponentSource(runner, name, description, colors, voice) {
+    return runner["client"]
+        ? runner
+            .client.complete("", "")
+            .then(() => "")
+            .catch(() => "")
+        : runner["generateComponent" in runner
+            ? "generateComponent"
+            : "generateComponent"]({
+            route: `/components/${name}`,
+            purpose: description,
+            brandVoice: voice,
+            colors,
+        });
+}
+// ── API route template ────────────────────────────────────────────────────────
+function apiRouteTemplate(name) {
+    const fnName = name.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+    return `import type { Request, Response } from "express";
+
+/**
+ * API route: /api/${name}
+ * TODO: Implement this route handler.
+ */
+export async function ${fnName}Handler(req: Request, res: Response): Promise<void> {
+  try {
+    // Read from req.body, req.query, req.params as needed
+    const data = {};
+
+    res.json({ ok: true, data });
+  } catch (err) {
+    res.status(500).json({ ok: false, error: (err as Error).message });
+  }
+}
+`;
+}
+// ── Main generate command ─────────────────────────────────────────────────────
+export async function generateCommand(sub, description, opts = {}) {
+    banner();
+    const root = process.cwd();
+    const contract = await loadContract(root);
+    const store = new PatchStore(root);
+    info(`Generating ${sub}: ${pc.bold(pc.white(description))}`);
+    info(`App: ${pc.bold(contract.name)}`);
+    blank();
+    // ── API route (no AI needed for scaffold) ────────────────────────────────
+    if (sub === "api") {
+        const slug = description.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+        const apiDir = join(root, "api");
+        const outPath = join(apiDir, `${slug}.ts`);
+        await mkdir(apiDir, { recursive: true });
+        const source = apiRouteTemplate(slug);
+        if (!opts.auto) {
+            console.log(pc.dim("─── preview ─────────────────────────────────────────"));
+            source.split("\n").forEach((l) => console.log(pc.dim("  ") + l));
+            console.log(pc.dim("─────────────────────────────────────────────────────"));
+            blank();
+            const { choice } = await prompts({
+                type: "select",
+                name: "choice",
+                message: `Write to api/${slug}.ts?`,
+                choices: [
+                    { title: pc.green("✓ Yes"), value: "yes" },
+                    { title: pc.red("✗ No"), value: "no" },
+                ],
+            });
+            if (choice !== "yes") {
+                info("Cancelled.");
+                blank();
+                return;
+            }
+        }
+        await writeFile(outPath, source, "utf-8");
+        success(`Created: api/${slug}.ts`);
+        blank();
+        return;
+    }
+    // ── Component (AI generation) ────────────────────────────────────────────
+    if (sub === "component") {
+        let runner;
+        try {
+            runner = new Runner();
+        }
+        catch {
+            fail("AIASSIST_API_KEY not set.");
+            process.exit(1);
+        }
+        const spinner = ora(`Generating component "${description}"…`).start();
+        let source;
+        try {
+            source = await runner.generateComponent({
+                route: `/components/${description}`,
+                purpose: description,
+                brandVoice: contract.brand?.voice,
+                colors: contract.brand?.colors,
+            });
+            spinner.stop();
+        }
+        catch (err) {
+            spinner.stop();
+            fail(`Generation failed: ${err.message}`);
+            process.exit(1);
+        }
+        const slug = description.toLowerCase().replace(/\s+/g, "-").replace(/[^a-z0-9-]/g, "");
+        const pascal = slug.split("-").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join("");
+        const outDir = join(root, "src", "components");
+        const outFile = join(outDir, `${pascal}.tsx`);
+        const relPath = `src/components/${pascal}.tsx`;
+        console.log(pc.dim("─── preview ─────────────────────────────────────────"));
+        source.split("\n").slice(0, 30).forEach((l) => console.log(pc.dim("  ") + l));
+        console.log(pc.dim("─────────────────────────────────────────────────────"));
+        blank();
+        if (!opts.auto) {
+            const { choice } = await prompts({
+                type: "select",
+                name: "choice",
+                message: `Write to ${relPath}?`,
+                choices: [
+                    { title: pc.green("✓ Yes, write it"), value: "yes" },
+                    { title: pc.red("✗ Discard"), value: "no" },
+                ],
+            });
+            if (choice !== "yes") {
+                info("Discarded.");
+                blank();
+                return;
+            }
+        }
+        await mkdir(outDir, { recursive: true });
+        await writeFile(outFile, source, "utf-8");
+        success(`Created: ${relPath}`);
+        blank();
+        return;
+    }
+    // ── Page / landing (full runner+sentinel+patch flow) ─────────────────────
+    let runner;
+    try {
+        runner = new Runner();
+    }
+    catch {
+        fail("AIASSIST_API_KEY not set — cannot generate pages.");
+        process.exit(1);
+    }
+    const sentinel = opts.noSentinel ? undefined : new Sentinel();
+    const spinner = ora(`Asking agent to generate "${description}"…`).start();
+    let result;
+    try {
+        result = await generateFromPrompt(description, {
+            runner, sentinel, contract, projectRoot: root,
+            route: opts.route,
+            requiresApproval: !opts.auto,
+        });
+        spinner.stop();
+    }
+    catch (err) {
+        spinner.stop();
+        fail(`Generation failed: ${err.message}`);
+        process.exit(1);
+    }
+    const { patch, sentinelReview } = result;
+    await store.save(patch);
+    header(`Generated: ${patch.file}`);
+    blank();
+    if (sentinelReview) {
+        const si = sentinelReview.approved ? icon.pass : icon.warn;
+        console.log(`${si} Sentinel: ${sentinelReview.summary}`);
+        sentinelReview.violations.forEach((v) => console.log(`   ${icon.fail} ${pc.red(v)}`));
+        blank();
+    }
+    console.log(pc.dim("─── preview ─────────────────────────────────────────"));
+    patch.proposed.split("\n").slice(0, 40).forEach((l) => console.log(pc.dim("  ") + l));
+    if (patch.proposed.split("\n").length > 40)
+        console.log(pc.dim("  …"));
+    console.log(pc.dim("─────────────────────────────────────────────────────"));
+    blank();
+    if (opts.auto) {
+        await applyPatch({ ...patch, status: "approved" }, root, store);
+        success(`Created: ${pc.bold(patch.file)}`);
+        info(`Run portal dev to see the new page.`);
+        blank();
+        return;
+    }
+    const { choice } = await prompts({
+        type: "select",
+        name: "choice",
+        message: `Write to ${pc.bold(patch.file)}?`,
+        choices: [
+            { title: pc.green("✓ Yes, write it"), value: "apply" },
+            { title: pc.yellow("~ Save for later"), value: "save" },
+            { title: pc.red("✗ Discard"), value: "discard" },
+        ],
+    });
+    if (choice === "apply") {
+        await store.update(patch.id, { status: "approved" });
+        await applyPatch({ ...patch, status: "approved" }, root, store);
+        success(`Created: ${pc.bold(patch.file)}`);
+        info(`Run portal dev to see it.`);
+    }
+    else if (choice === "save") {
+        info(`Patch saved — run portal patch to apply later.`);
+    }
+    else {
+        await store.update(patch.id, { status: "rejected" });
+        info("Discarded.");
+    }
+    blank();
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

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

package/dist/commands/guard.d.ts

@@ -0,0 +1,12 @@
+/**
+ * portal guard — safety check on pending patches before they touch the codebase.
+ *
+ * Usage:
+ *   portal guard             (check all pending patches)
+ *   portal guard --apply     (apply patches that pass all guard checks)
+ */
+export interface GuardOptions {
+    apply?: boolean;
+}
+export declare function guardCommand(opts?: GuardOptions): Promise<void>;
+//# sourceMappingURL=guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/commands/guard.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,YAAY,CAAC,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqEzE"}

package/dist/commands/guard.js

@@ -0,0 +1,71 @@
+/**
+ * portal guard — safety check on pending patches before they touch the codebase.
+ *
+ * Usage:
+ *   portal guard             (check all pending patches)
+ *   portal guard --apply     (apply patches that pass all guard checks)
+ */
+import pc from "picocolors";
+import { guardAllPending, PatchStore, applyPatch } from "@interchained/portal-agent";
+import { banner, header, success, fail, warn, info, blank, icon } from "../utils/print.js";
+import { loadContract } from "../utils/contract.js";
+export async function guardCommand(opts = {}) {
+    banner();
+    const root = process.cwd();
+    const contract = await loadContract(root);
+    const store = new PatchStore(root);
+    const patches = await store.list();
+    const pending = patches.filter((p) => p.status === "pending");
+    if (pending.length === 0) {
+        success("No pending patches to guard.");
+        blank();
+        info("Patches are created by portal generate and portal improve.");
+        return;
+    }
+    info(`Checking ${pending.length} pending patch${pending.length !== 1 ? "es" : ""}…`);
+    blank();
+    const results = await guardAllPending(patches, contract);
+    let blocked = 0;
+    let cleared = 0;
+    for (const result of results) {
+        const patch = patches.find((p) => p.id === result.patchId);
+        header(`Patch: ${patch.file}`);
+        console.log(pc.dim(`  Agent: ${patch.agent}  ·  Reason: ${patch.reason}`));
+        blank();
+        const blockViolations = result.violations.filter((v) => v.severity === "block");
+        const warnViolations = result.violations.filter((v) => v.severity === "warn");
+        if (result.passed) {
+            cleared++;
+            success("Guard passed — no violations");
+            for (const v of warnViolations) {
+                warn(`  ${v.rule}: ${v.message}`);
+            }
+            if (opts.apply) {
+                await store.update(patch.id, { status: "approved" });
+                await applyPatch({ ...patch, status: "approved" }, root, store);
+                success(`Applied: ${patch.file}`);
+            }
+            else {
+                info(`Run ${pc.white("portal guard --apply")} to apply cleared patches.`);
+            }
+        }
+        else {
+            blocked++;
+            fail(`Guard BLOCKED — ${blockViolations.length} violation${blockViolations.length !== 1 ? "s" : ""}`);
+            for (const v of blockViolations) {
+                console.log(`  ${icon.fail} ${pc.bold(v.rule)}: ${pc.red(v.message)}`);
+                if (v.evidence)
+                    console.log(pc.dim(`       evidence: "${v.evidence}"`));
+            }
+            await store.update(patch.id, { status: "rejected" });
+        }
+        blank();
+    }
+    header("Guard Summary");
+    if (cleared > 0)
+        success(`${cleared} patch${cleared !== 1 ? "es" : ""} cleared`);
+    if (blocked > 0)
+        fail(`${blocked} patch${blocked !== 1 ? "es" : ""} blocked and rejected`);
+    blank();
+}
+//# sourceMappingURL=guard.js.map

package/dist/commands/guard.js.map

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

package/dist/commands/improve.d.ts

@@ -0,0 +1,18 @@
+/**
+ * portal improve — generates AI patches for audit findings, with human approval.
+ *
+ * Usage:
+ *   portal improve
+ *   portal improve --target seo
+ *   portal improve --target accessibility
+ *   portal improve --auto   (apply without asking — use carefully)
+ */
+import { type CheckCategory } from "@interchained/portal-agent";
+export interface ImproveOptions {
+    target?: CheckCategory;
+    auto?: boolean;
+    routesDir?: string;
+    noSentinel?: boolean;
+}
+export declare function improveCommand(opts?: ImproveOptions): Promise<void>;
+//# sourceMappingURL=improve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"improve.d.ts","sourceRoot":"","sources":["../../src/commands/improve.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAQL,KAAK,aAAa,EACnB,MAAM,4BAA4B,CAAC;AAMpC,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,cAAc,CAAC,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqJ7E"}

package/dist/commands/improve.js

@@ -0,0 +1,157 @@
+/**
+ * portal improve — generates AI patches for audit findings, with human approval.
+ *
+ * Usage:
+ *   portal improve
+ *   portal improve --target seo
+ *   portal improve --target accessibility
+ *   portal improve --auto   (apply without asking — use carefully)
+ */
+import { join } from "node:path";
+import prompts from "prompts";
+import pc from "picocolors";
+import ora from "ora";
+import { runAudit, Runner, Sentinel, improveFromFindings, applyPatch, inlineDiff, PatchStore, } from "@interchained/portal-agent";
+import { banner, header, success, fail, warn, info, blank, icon, } from "../utils/print.js";
+import { loadContract } from "../utils/contract.js";
+export async function improveCommand(opts = {}) {
+    banner();
+    const root = process.cwd();
+    const contract = await loadContract(root);
+    const routesDir = opts.routesDir ?? join(root, "routes");
+    const store = new PatchStore(root);
+    info(`Improving: ${pc.bold(contract.name)}`);
+    blank();
+    // 1. Run audit to get findings
+    const auditSpinner = ora("Running audit…").start();
+    const report = await runAudit(contract, routesDir, { ai: false });
+    auditSpinner.stop();
+    const actionable = report.findings.filter((f) => {
+        if (f.status === "pass")
+            return false;
+        if (opts.target && f.category !== opts.target)
+            return false;
+        return true;
+    });
+    if (actionable.length === 0) {
+        success("Nothing to improve — all checks passed!");
+        return;
+    }
+    info(`Found ${pc.bold(String(actionable.length))} issues to address.`);
+    blank();
+    // 2. Create AI clients
+    let runner;
+    try {
+        runner = new Runner();
+    }
+    catch {
+        fail("AIASSIST_API_KEY not set — cannot generate improvements.");
+        info("Set AIASSIST_API_KEY or VITE_AIAS_API_KEY to enable AI improvements.");
+        process.exit(1);
+    }
+    const sentinel = opts.noSentinel ? undefined : new Sentinel();
+    // 3. Generate patches
+    const genSpinner = ora(`Generating patches for ${actionable.length} issues…`).start();
+    const results = await improveFromFindings(actionable, {
+        runner,
+        sentinel,
+        contract,
+        projectRoot: root,
+        target: opts.target ? [opts.target] : undefined,
+        requiresApproval: !opts.auto,
+    });
+    genSpinner.stop();
+    // 4. Review and apply
+    let applied = 0;
+    let rejected = 0;
+    let skipped = 0;
+    for (const result of results) {
+        if (result.skipped || !result.patch) {
+            warn(`Skipped: ${result.finding.file} — ${result.skipped ?? "no patch"}`);
+            skipped++;
+            continue;
+        }
+        const { patch, sentinelReview } = result;
+        // Save the patch to .portal/patches/
+        await store.save(patch);
+        header(`[${result.finding.category.toUpperCase()}] ${result.finding.file}`);
+        console.log(`  ${pc.dim(result.finding.message)}`);
+        blank();
+        // Show sentinel review
+        if (sentinelReview) {
+            const sentinelIcon = sentinelReview.approved ? icon.pass : icon.warn;
+            console.log(`${sentinelIcon} Sentinel: ${sentinelReview.summary}`);
+            if (sentinelReview.violations.length > 0) {
+                for (const v of sentinelReview.violations) {
+                    console.log(`   ${icon.fail} ${pc.red(v)}`);
+                }
+            }
+            blank();
+        }
+        // Show diff
+        console.log(pc.dim("─── diff ───────────────────────────────────────────"));
+        const diff = inlineDiff(patch.original, patch.proposed);
+        const diffLines = diff.split("\n").slice(0, 30);
+        for (const line of diffLines) {
+            if (line.startsWith("+ "))
+                console.log(pc.green(line));
+            else if (line.startsWith("- "))
+                console.log(pc.red(line));
+            else
+                console.log(pc.dim(line));
+        }
+        if (diff.split("\n").length > 30)
+            console.log(pc.dim("  … (truncated)"));
+        console.log(pc.dim("────────────────────────────────────────────────────"));
+        blank();
+        // Block if sentinel found violations
+        if (sentinelReview && !sentinelReview.approved && !opts.auto) {
+            warn("Sentinel rejected this patch — skipping.");
+            await store.update(patch.id, { status: "rejected" });
+            rejected++;
+            continue;
+        }
+        if (opts.auto) {
+            await applyPatch({ ...patch, status: "approved" }, root, store);
+            success(`Applied: ${patch.file}`);
+            applied++;
+            continue;
+        }
+        const { choice } = await prompts({
+            type: "select",
+            name: "choice",
+            message: `Apply this patch to ${pc.bold(patch.file)}?`,
+            choices: [
+                { title: pc.green("✓ Apply"), value: "apply" },
+                { title: pc.yellow("~ Skip"), value: "skip" },
+                { title: pc.red("✗ Reject"), value: "reject" },
+            ],
+        });
+        if (choice === "apply") {
+            await store.update(patch.id, { status: "approved" });
+            await applyPatch({ ...patch, status: "approved" }, root, store);
+            success(`Applied: ${patch.file}`);
+            applied++;
+        }
+        else if (choice === "reject") {
+            await store.update(patch.id, { status: "rejected" });
+            warn(`Rejected: ${patch.file}`);
+            rejected++;
+        }
+        else {
+            info(`Skipped: ${patch.file} (patch saved to .portal/patches/${patch.id}.json)`);
+            skipped++;
+        }
+        blank();
+    }
+    // Summary
+    header("Done");
+    if (applied > 0)
+        success(`${applied} patch${applied !== 1 ? "es" : ""} applied`);
+    if (rejected > 0)
+        fail(`${rejected} patch${rejected !== 1 ? "es" : ""} rejected`);
+    if (skipped > 0)
+        info(`${skipped} skipped`);
+    blank();
+}
+//# sourceMappingURL=improve.js.map

package/dist/commands/improve.js.map

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

package/dist/commands/lint.d.ts

@@ -0,0 +1,5 @@
+/**
+ * portal lint — ESLint + TypeScript checks + contract schema validation.
+ */
+export declare function lintCommand(): Promise<void>;
+//# sourceMappingURL=lint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/commands/lint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAsEjD"}