@aexol/spectral 0.9.125 → 0.9.127

package/dist/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAIX,SAAS,EAET,MAAM,4BAA4B,CAAC;AAUpC,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,KAAK,WAAW,EAAmC,MAAM,aAAa,CAAC;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOrD,OAAO,KAAK,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AA4F7G,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASpG;AAED,wBAAgB,yBAAyB,CACxC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,GAC/C,MAAM,CAKR;AAiHD;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAChD,IAAI,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC,CAK3D;AAED,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAC/B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,gBAAgB,GACnB,SAAS,EAAE,CAqCb;AAuaD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACxC,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;CAAE,GACpF,IAAI,CAgZN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAIX,SAAS,EAET,MAAM,4BAA4B,CAAC;AAUpC,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,KAAK,WAAW,EAAmC,MAAM,aAAa,CAAC;AAEhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOrD,OAAO,KAAK,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AA4F7G,wBAAgB,+BAA+B,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CASpG;AAED,wBAAgB,yBAAyB,CACxC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CAAC,GAC/C,MAAM,CAKR;AAiHD;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAChD,IAAI,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC,CAK3D;AAED,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAC/B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,gBAAgB,GACnB,SAAS,EAAE,CAqCb;AA4aD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACxC,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;CAAE,GACpF,IAAI,CAgZN"}

package/dist/agent/index.js

@@ -494,6 +494,11 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
             if (event.type === "tool_execution_end" && event.isError) {
                 emitUpdate();
             }
+            if (event.type === "agent_end" && event.error) {
+                hadError = true;
+                currentResult.errorMessage = event.error;
+                currentResult.stderr = event.error;
+            }
         }
         // Drain the stream result (already consumed by iteration, but ensure cleanup)
         try {

package/dist/cli.js

@@ -43,6 +43,7 @@ function printHeader() {
         "  spectral serve         Connect this machine to the Aexol relay backend",
         "  spectral bind          Link this directory to an Aexol Studio project",
         "  spectral unbind        Remove the Aexol Studio project binding",
+        "  spectral update        Check for and install the latest Spectral version",
         "  spectral --version     Print version and exit",
         "  spectral --help        Print this help and exit",
         "",
@@ -115,6 +116,11 @@ async function main() {
         await runUnbind();
         process.exit(0);
     }
+    if (first === "update") {
+        const { runUpdate } = await import("./commands/update.js");
+        await runUpdate(args.slice(1));
+        process.exit(0);
+    }
     // No TUI/interactive mode is supported. All other invocations must use
     // explicit subcommands.
     process.stderr.write(`spectral: unknown command "${first ?? ""}".\n` +

package/dist/commands/update.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `spectral update` — standalone binary self-update.
+ *
+ * Fetches the latest release manifest from api.aexol.ai, compares versions,
+ * downloads the new binary, verifies its SHA256 checksum, and atomically
+ * replaces the running binary on disk.
+ *
+ * Non-standalone install modes (Electron desktop app, npm global) are detected
+ * and the user is pointed at the correct update path instead.
+ */
+/**
+ * Run the `spectral update` subcommand.
+ *
+ * @param args remaining CLI args after the `update` subcommand
+ */
+export declare function runUpdate(args: string[]): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsOH;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA8H7D"}

package/dist/commands/update.js

@@ -0,0 +1,292 @@
+/**
+ * `spectral update` — standalone binary self-update.
+ *
+ * Fetches the latest release manifest from api.aexol.ai, compares versions,
+ * downloads the new binary, verifies its SHA256 checksum, and atomically
+ * replaces the running binary on disk.
+ *
+ * Non-standalone install modes (Electron desktop app, npm global) are detected
+ * and the user is pointed at the correct update path instead.
+ */
+import { createHash } from "node:crypto";
+import { chmod, mkdtemp, rename, rm, stat, writeFile, } from "node:fs/promises";
+import { readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import pc from "picocolors";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** Base URL for the Aexol release manifest / binary downloads. */
+const RELEASE_BASE = "https://api.aexol.ai/api/releases/download";
+/**
+ * Resolve the current CLI version. Reads package.json adjacent to this module
+ * when available (dev / npm install), falling back to the npm-injected env var
+ * and finally "0.0.0" — mirroring the logic in cli.ts.
+ */
+function currentVersion() {
+    try {
+        const pkgPath = resolve(__dirname, "..", "package.json");
+        const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+        return pkg.version;
+    }
+    catch {
+        return process.env.npm_package_version ?? "0.0.0";
+    }
+}
+/**
+ * Compare two semver-ish version strings (e.g. "1.2.3", "v1.2.3").
+ * Returns a negative number if `a` < `b`, zero if equal, positive if `a` > `b`.
+ * Only numeric major.minor.patch parts are compared; pre-release tags ignored.
+ */
+function compareSemver(a, b) {
+    const pa = a.replace(/^v/i, "").split(".").map((n) => Number(n) || 0);
+    const pb = b.replace(/^v/i, "").split(".").map((n) => Number(n) || 0);
+    const len = Math.max(pa.length, pb.length);
+    for (let i = 0; i < len; i++) {
+        const da = pa[i] ?? 0;
+        const db = pb[i] ?? 0;
+        if (da !== db)
+            return da - db;
+    }
+    return 0;
+}
+/**
+ * Detect the release platform slug from the current process.
+ * - darwin → `darwin-${arch}` (arm64 | x64)
+ * - linux  → `linux-x64`
+ * - win32  → `win-x64`
+ */
+function detectPlatform() {
+    const { platform, arch } = process;
+    if (platform === "darwin") {
+        const a = arch === "arm64" || arch === "x64" ? arch : "x64";
+        return `darwin-${a}`;
+    }
+    if (platform === "linux")
+        return "linux-x64";
+    if (platform === "win32")
+        return "win-x64";
+    return null;
+}
+/**
+ * Whether the process is running as a Bun `--compile` standalone binary.
+ *
+ * In a compiled binary, `process.execPath` points at the binary itself (e.g.
+ * `spectral`) rather than a `node`/`bun` runtime, and Bun's embedded-files
+ * surface may be present.
+ */
+function isStandaloneBinary() {
+    // Bun-compiled binary with embedded files is a strong positive signal.
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const Bun = globalThis.Bun;
+    if (Bun && typeof Bun === "object" && "embeddedFiles" in Bun) {
+        return true;
+    }
+    const execName = basename(process.execPath).replace(/\.exe$/i, "");
+    const isRuntime = execName === "node" || execName === "bun";
+    return !isRuntime;
+}
+/** True when invoked inside the Electron desktop app. */
+function isElectronBundled() {
+    return Boolean(process.env.SPECTRAL_DESKTOP_VERSION);
+}
+/**
+ * Compute the SHA256 hex digest of a file's contents.
+ */
+async function sha256OfFile(filePath) {
+    const { createReadStream } = await import("node:fs");
+    return new Promise((resolveHash, reject) => {
+        const hash = createHash("sha256");
+        const stream = createReadStream(filePath);
+        stream.on("data", (chunk) => hash.update(chunk));
+        stream.on("end", () => resolveHash(hash.digest("hex")));
+        stream.on("error", reject);
+    });
+}
+/**
+ * Download `url` to `destPath`, streaming the body to disk.
+ */
+async function downloadToFile(url, destPath) {
+    const res = await fetch(url);
+    if (!res.ok || !res.body) {
+        throw new Error(`Download failed: HTTP ${res.status} ${res.statusText} for ${url}`);
+    }
+    const reader = res.body.getReader();
+    const chunks = [];
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        if (value)
+            chunks.push(value);
+    }
+    const total = chunks.reduce((sum, c) => sum + c.length, 0);
+    const buf = new Uint8Array(total);
+    let offset = 0;
+    for (const c of chunks) {
+        buf.set(c, offset);
+        offset += c.length;
+    }
+    await writeFile(destPath, buf);
+}
+/**
+ * Fetch and parse the latest release manifest for `platform`.
+ */
+async function fetchManifest(platform) {
+    const url = `${RELEASE_BASE}/latest/latest-${platform}.json`;
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`Manifest fetch failed: HTTP ${res.status} ${res.statusText}`);
+    }
+    const data = (await res.json());
+    return data;
+}
+/**
+ * Atomically replace the running binary at `currentPath` with `newBinaryPath`.
+ *
+ * On Unix: moves the old binary aside to `<name>.old`, moves the new binary into
+ * place, and makes it executable. On Windows the running executable cannot be
+ * renamed while live, so we print an actionable message instead.
+ */
+async function atomicReplace(currentPath, newBinaryPath) {
+    const isWindows = process.platform === "win32";
+    const dir = dirname(currentPath);
+    if (isWindows) {
+        // Cannot atomically replace a running .exe on Windows from within itself.
+        // Leave the downloaded binary next to the current one and instruct the
+        // user to restart. A launcher / wrapper script would handle the swap.
+        const staged = join(dir, basename(currentPath) + ".new");
+        await rename(newBinaryPath, staged);
+        process.stdout.write(pc.yellow(`New binary staged at ${staged}\n` +
+            `Close all spectral processes, then replace the .exe manually,\n` +
+            `or run the provided update helper.\n`));
+        return;
+    }
+    const oldPath = currentPath + ".old";
+    // Make the new binary executable before it takes over.
+    await chmod(newBinaryPath, 0o755);
+    // Remove any stale .old binary from a previous update.
+    try {
+        await rm(oldPath, { force: true });
+    }
+    catch {
+        /* ignore — best effort cleanup */
+    }
+    // Move the current binary aside, then move the new one into place.
+    try {
+        await rename(currentPath, oldPath);
+    }
+    catch (err) {
+        // If the current path can't be moved (e.g. permissions), abort cleanly.
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Could not move current binary aside: ${msg}`);
+    }
+    try {
+        await rename(newBinaryPath, currentPath);
+    }
+    catch (err) {
+        // Attempt to restore the old binary on failure.
+        try {
+            await rename(oldPath, currentPath);
+        }
+        catch {
+            /* leave as-is */
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Could not install new binary: ${msg}`);
+    }
+    // Best-effort cleanup of the old binary.
+    try {
+        await rm(oldPath, { force: true });
+    }
+    catch {
+        /* non-fatal */
+    }
+}
+/**
+ * Run the `spectral update` subcommand.
+ *
+ * @param args remaining CLI args after the `update` subcommand
+ */
+export async function runUpdate(args) {
+    const checkOnly = args.includes("--check") || args.includes("-c");
+    // --- Installation mode detection --------------------------------------
+    if (isElectronBundled()) {
+        process.stdout.write(pc.cyan("You're running Spectral inside the desktop app. Use the app menu → " +
+            "Check for Updates to update.\n"));
+        return;
+    }
+    if (!isStandaloneBinary()) {
+        process.stdout.write(pc.cyan("Run `npm i -g @aexol/spectral@latest` to update.\n"));
+        return;
+    }
+    // --- Standalone self-update flow --------------------------------------
+    const platform = detectPlatform();
+    if (!platform) {
+        process.stderr.write(pc.red(`Update is not supported on this platform (${process.platform}/${process.arch}).\n`));
+        return;
+    }
+    const cur = currentVersion();
+    let manifest;
+    try {
+        manifest = await fetchManifest(platform);
+    }
+    catch {
+        process.stdout.write(pc.yellow("Could not check for updates. Make sure you're connected to the internet.\n"));
+        return;
+    }
+    const latest = manifest.version.replace(/^v/i, "");
+    const comparison = compareSemver(cur, latest);
+    if (comparison >= 0) {
+        process.stdout.write(pc.green(`Spectral is up to date (v${cur}).\n`));
+        return;
+    }
+    if (checkOnly) {
+        process.stdout.write(pc.cyan(`Update available: v${cur} → v${latest}. Run \`spectral update\` to install.\n`));
+        return;
+    }
+    // --- Download + verify + replace -------------------------------------
+    if (!manifest.url) {
+        process.stderr.write(pc.red("Update manifest is missing a download URL. Aborting.\n"));
+        return;
+    }
+    let tempDir = null;
+    try {
+        tempDir = await mkdtemp(join(tmpdir(), "spectral-update-"));
+        const downloadedPath = join(tempDir, "spectral-new");
+        process.stdout.write(pc.dim(`Downloading v${latest}…\n`));
+        await downloadToFile(manifest.url, downloadedPath);
+        // Verify the download is complete and readable.
+        await stat(downloadedPath);
+        // SHA256 verification.
+        if (manifest.sha256) {
+            process.stdout.write(pc.dim("Verifying checksum…\n"));
+            const actual = await sha256OfFile(downloadedPath);
+            const expected = manifest.sha256.toLowerCase();
+            if (actual.toLowerCase() !== expected) {
+                process.stderr.write(pc.red(`Checksum mismatch. Expected ${expected}, got ${actual}.\n` +
+                    "The downloaded file may be corrupted or tampered with. Aborting.\n"));
+                return;
+            }
+        }
+        const currentPath = process.execPath;
+        process.stdout.write(pc.dim("Installing…\n"));
+        await atomicReplace(currentPath, downloadedPath);
+        process.stdout.write(pc.green(`Spectral updated to v${latest}. Restart spectral to use the new version.\n`));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(pc.red(`Update failed: ${msg}\n`));
+    }
+    finally {
+        if (tempDir) {
+            try {
+                await rm(tempDir, { recursive: true, force: true });
+            }
+            catch {
+                /* best-effort cleanup */
+            }
+        }
+    }
+}

package/dist/extensions/seo/analyzers/content.d.ts

@@ -5,12 +5,35 @@
  * analysis: filler phrase detection, AI-pattern detection, information density,
  * and repetition scoring. No external API calls.
  */
-import type { ContentQualityResult } from "../types.js";
+import type { ContentQualityResult, HeadingInfo, PageData, SchemaBlock } from "../types.js";
+/** Split text into sentences, respecting common abbreviations. */
+export declare function splitSentences(text: string): string[];
+/** Calculate Flesch-Kincaid Grade Level and related readability metrics. */
+export declare function calculateReadability(text: string): {
+    fleschKincaid: number;
+    sentenceCount: number;
+    avgSentenceLength: number;
+    avgWordLength: number;
+};
+/** Extract named entities from text using proper noun heuristics. */
+export declare function extractEntities(text: string, schemaBlocks?: SchemaBlock[]): string[];
+/** Check whether heading keywords appear in body text. */
+export declare function headingContentAlignment(headings: HeadingInfo[], bodyText: string, stopWords?: Set<string>): {
+    score: number;
+    missingKeywords: string[];
+};
+/** Evaluate heading structure depth and completeness. */
+export declare function calculateSemanticDepth(headings: HeadingInfo[]): {
+    score: number;
+    hasH1: boolean;
+    hasH2: boolean;
+    hasH3: boolean;
+    headingCount: number;
+};
 /**
- * Analyze content quality of a text string.
- *
- * All scores are 0-100 where higher is better (except filler and AI pattern
- * scores, where higher means MORE problematic content).
+ * Detect language using word-frequency profiles of common function words.
+ * Returns the ISO 639-1 language code of the best match, or null if confidence is too low.
  */
-export declare function analyzeContentQuality(text: string, url?: string): ContentQualityResult;
+export declare function detectLanguage(text: string): string | null;
+export declare function analyzeContentQuality(text: string, url?: string, pageData?: PageData, customStopWords?: string[]): ContentQualityResult;
 //# sourceMappingURL=content.d.ts.map

package/dist/extensions/seo/analyzers/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../../src/extensions/seo/analyzers/content.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA8HxD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAgDtF"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../../src/extensions/seo/analyzers/content.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,QAAQ,EAAqB,WAAW,EAAE,MAAM,aAAa,CAAC;AAqJ/G,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAcrD;AAaD,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAClD,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB,CA2BA;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,GAAG,MAAM,EAAE,CA0BpF;AAED,0DAA0D;AAC1D,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,WAAW,EAAE,EACvB,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,EAAE,CAAA;CAAE,CAsB9C;AAED,yDAAyD;AACzD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB,CAiBA;AAmBD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgC1D;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,QAAQ,EACnB,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,oBAAoB,CAoFtB"}