@the-forge-flow/ultra-compress-pi 0.1.1

package/dist/services/llm-factory.d.ts

@@ -0,0 +1,15 @@
+import type { LLMCall } from "./compress-pipeline";
+interface PiModelRegistry {
+    find(provider: string, model: string): unknown;
+    getApiKeyAndHeaders(model: unknown): Promise<{
+        apiKey: string;
+        headers: Record<string, string>;
+    }>;
+}
+export interface LLMFactoryContext {
+    modelRegistry?: PiModelRegistry;
+    signal?: AbortSignal;
+}
+export declare function makeLLM(piCtx: LLMFactoryContext): LLMCall;
+export {};
+//# sourceMappingURL=llm-factory.d.ts.map

package/dist/services/llm-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-factory.d.ts","sourceRoot":"","sources":["../../src/services/llm-factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,UAAU,eAAe;IACxB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/C,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAC;CAClG;AAED,MAAM,WAAW,iBAAiB;IACjC,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAID,wBAAgB,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CA0BzD"}

package/dist/services/llm-factory.js

@@ -0,0 +1,24 @@
+import { PIContextRequiredError } from "../types";
+// Build a live LLMCall bound to the PI session's default model. Throws
+// PIContextRequiredError when invoked outside a live PI runtime (no registry).
+export function makeLLM(piCtx) {
+    return async (prompt, signal) => {
+        if (!piCtx.modelRegistry)
+            throw new PIContextRequiredError();
+        const mod = await import("@mariozechner/pi-ai");
+        const complete = mod.complete;
+        const model = piCtx.modelRegistry.find("", "");
+        const auth = await piCtx.modelRegistry.getApiKeyAndHeaders(model);
+        const resp = await complete(model, { messages: [{ role: "user", content: prompt }] }, {
+            apiKey: auth.apiKey,
+            headers: auth.headers,
+            maxTokens: 8192,
+            signal: signal ?? piCtx.signal,
+        });
+        return resp.content
+            .filter((c) => c.type === "text")
+            .map((c) => c.text ?? "")
+            .join("");
+    };
+}
+//# sourceMappingURL=llm-factory.js.map

package/dist/services/llm-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-factory.js","sourceRoot":"","sources":["../../src/services/llm-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAalD,uEAAuE;AACvE,+EAA+E;AAC/E,MAAM,UAAU,OAAO,CAAC,KAAwB;IAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;QAC/B,IAAI,CAAC,KAAK,CAAC,aAAa;YAAE,MAAM,IAAI,sBAAsB,EAAE,CAAC;QAC7D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAChD,MAAM,QAAQ,GACb,GAGA,CAAC,QAAQ,CAAC;QACX,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QAClE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAC1B,KAAK,EACL,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,EACjD;YACC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,MAAM,IAAI,KAAK,CAAC,MAAM;SAC9B,CACD,CAAC;QACF,OAAO,IAAI,CAAC,OAAO;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;aAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;aACxB,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,CAAC,CAAC;AACH,CAAC"}

package/dist/services/path-guard.d.ts

@@ -0,0 +1,8 @@
+export declare class PathEscapeError extends Error {
+    constructor(given: string, root: string);
+}
+export declare class SymlinkRejectedError extends Error {
+    constructor(path: string);
+}
+export declare function safeResolveInCwd(input: string, cwd: string): string;
+//# sourceMappingURL=path-guard.d.ts.map

package/dist/services/path-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-guard.d.ts","sourceRoot":"","sources":["../../src/services/path-guard.ts"],"names":[],"mappings":"AAGA,qBAAa,eAAgB,SAAQ,KAAK;gBAC7B,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAIvC;AAED,qBAAa,oBAAqB,SAAQ,KAAK;gBAClC,IAAI,EAAE,MAAM;CAIxB;AAID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAqBnE"}

package/dist/services/path-guard.js

@@ -0,0 +1,42 @@
+import { lstatSync } from "node:fs";
+import { resolve, sep } from "node:path";
+export class PathEscapeError extends Error {
+    constructor(given, root) {
+        super(`ultra-compress: refusing to access "${given}" — escapes project root "${root}"`);
+        this.name = "PathEscapeError";
+    }
+}
+export class SymlinkRejectedError extends Error {
+    constructor(path) {
+        super(`ultra-compress: refusing to follow symlink at "${path}"`);
+        this.name = "SymlinkRejectedError";
+    }
+}
+// Resolve `input` against `cwd`, reject if the resolved path escapes cwd,
+// and reject if any path component (the file itself) is a symlink.
+export function safeResolveInCwd(input, cwd) {
+    const cwdAbs = resolve(cwd);
+    const abs = resolve(cwdAbs, input);
+    const prefix = cwdAbs.endsWith(sep) ? cwdAbs : cwdAbs + sep;
+    if (abs !== cwdAbs && !abs.startsWith(prefix)) {
+        throw new PathEscapeError(input, cwdAbs);
+    }
+    // lstat to detect symlinks without following them. Only checks the final
+    // path; acceptable for v1 (callers can't plant a symlink they couldn't
+    // already read/write via the OS). Skip if path doesn't exist (creation OK).
+    try {
+        const st = lstatSync(abs);
+        if (st.isSymbolicLink())
+            throw new SymlinkRejectedError(abs);
+    }
+    catch (e) {
+        if (e.code !== "ENOENT") {
+            if (e instanceof SymlinkRejectedError)
+                throw e;
+            // other stat errors (EACCES etc.) are passed through
+            throw e;
+        }
+    }
+    return abs;
+}
+//# sourceMappingURL=path-guard.js.map

package/dist/services/path-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-guard.js","sourceRoot":"","sources":["../../src/services/path-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACzC,YAAY,KAAa,EAAE,IAAY;QACtC,KAAK,CAAC,uCAAuC,KAAK,6BAA6B,IAAI,GAAG,CAAC,CAAC;QACxF,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC9C,YAAY,IAAY;QACvB,KAAK,CAAC,kDAAkD,IAAI,GAAG,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACpC,CAAC;CACD;AAED,0EAA0E;AAC1E,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,GAAW;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;IAC5D,IAAI,GAAG,KAAK,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IACD,yEAAyE;IACzE,uEAAuE;IACvE,4EAA4E;IAC5E,IAAI,CAAC;QACJ,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,EAAE,CAAC,cAAc,EAAE;YAAE,MAAM,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpD,IAAI,CAAC,YAAY,oBAAoB;gBAAE,MAAM,CAAC,CAAC;YAC/C,qDAAqD;YACrD,MAAM,CAAC,CAAC;QACT,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC"}

package/dist/services/state-store.d.ts

@@ -0,0 +1,10 @@
+import type { Level, ProjectState } from "../types";
+export declare function setProjectRootForTest(root: string): void;
+export declare function loadState(projectRoot?: string): Promise<ProjectState>;
+export declare function saveState(state: ProjectState, projectRoot?: string): Promise<void>;
+export declare function saveLevel(level: Level, projectRoot?: string): Promise<ProjectState>;
+export declare function resetSessionStats(projectRoot?: string): Promise<ProjectState>;
+export declare function appendCompressedFile(entry: ProjectState["session"]["filesCompressed"][number], projectRoot?: string): Promise<void>;
+export declare function incrementAutoClarity(projectRoot?: string): Promise<void>;
+export declare function addCharsSaved(chars: number, projectRoot?: string): Promise<void>;
+//# sourceMappingURL=state-store.d.ts.map

package/dist/services/state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/services/state-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAgB,MAAM,UAAU,CAAC;AAOlE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAExD;AAwBD,wBAAsB,SAAS,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAmB3E;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxF;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CASzF;AAED,wBAAsB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CASnF;AAED,wBAAsB,oBAAoB,CACzC,KAAK,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,EACzD,WAAW,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI9E;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAItF"}

package/dist/services/state-store.js

@@ -0,0 +1,106 @@
+import { existsSync, lstatSync } from "node:fs";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+const STATE_FILENAME = "ultra-compress.json";
+const STATE_SUBDIR = ".pi";
+let projectRootOverride;
+export function setProjectRootForTest(root) {
+    projectRootOverride = root;
+}
+function resolveStatePath(projectRoot) {
+    const root = projectRootOverride ?? projectRoot ?? process.cwd();
+    return join(root, STATE_SUBDIR, STATE_FILENAME);
+}
+function freshSession() {
+    return {
+        startedAt: new Date().toISOString(),
+        autoClarityCount: 0,
+        estimatedOutputCharsSaved: 0,
+        filesCompressed: [],
+    };
+}
+function defaultState() {
+    return {
+        level: "off",
+        updatedAt: new Date().toISOString(),
+        session: freshSession(),
+    };
+}
+export async function loadState(projectRoot) {
+    const path = resolveStatePath(projectRoot);
+    if (!existsSync(path))
+        return defaultState();
+    try {
+        const raw = await readFile(path, "utf8");
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object")
+            throw new Error("not an object");
+        const level = (parsed.level ?? "off");
+        return {
+            level,
+            updatedAt: parsed.updatedAt ?? new Date().toISOString(),
+            session: parsed.session ?? freshSession(),
+        };
+    }
+    catch {
+        const corruptPath = `${path}.corrupt-${Date.now()}`;
+        await rename(path, corruptPath).catch(() => { });
+        return defaultState();
+    }
+}
+export async function saveState(state, projectRoot) {
+    const path = resolveStatePath(projectRoot);
+    await mkdir(dirname(path), { recursive: true });
+    // Refuse to write if the existing path is a symlink (avoid writing through
+    // a symlink the user didn't intend).
+    try {
+        const st = lstatSync(path);
+        if (st.isSymbolicLink()) {
+            throw new Error(`ultra-compress: refusing to overwrite symlink state file at ${path}`);
+        }
+    }
+    catch (e) {
+        if (e.code !== "ENOENT")
+            throw e;
+    }
+    const tmp = `${path}.tmp-${process.pid}-${Math.random().toString(36).slice(2, 10)}`;
+    await writeFile(tmp, JSON.stringify(state, null, 2), "utf8");
+    await rename(tmp, path);
+}
+export async function saveLevel(level, projectRoot) {
+    const current = await loadState(projectRoot);
+    const next = {
+        ...current,
+        level,
+        updatedAt: new Date().toISOString(),
+    };
+    await saveState(next, projectRoot);
+    return next;
+}
+export async function resetSessionStats(projectRoot) {
+    const current = await loadState(projectRoot);
+    const next = {
+        ...current,
+        session: freshSession(),
+        updatedAt: new Date().toISOString(),
+    };
+    await saveState(next, projectRoot);
+    return next;
+}
+export async function appendCompressedFile(entry, projectRoot) {
+    const current = await loadState(projectRoot);
+    current.session.filesCompressed.push(entry);
+    current.updatedAt = new Date().toISOString();
+    await saveState(current, projectRoot);
+}
+export async function incrementAutoClarity(projectRoot) {
+    const current = await loadState(projectRoot);
+    current.session.autoClarityCount += 1;
+    await saveState(current, projectRoot);
+}
+export async function addCharsSaved(chars, projectRoot) {
+    const current = await loadState(projectRoot);
+    current.session.estimatedOutputCharsSaved += chars;
+    await saveState(current, projectRoot);
+}
+//# sourceMappingURL=state-store.js.map

package/dist/services/state-store.js.map

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

package/dist/services/stats.d.ts

@@ -0,0 +1,4 @@
+import type { Level } from "../types";
+export declare function levelFactor(level: Level): number;
+export declare function estimateCharsSaved(actualChars: number, level: Level): number;
+//# sourceMappingURL=stats.d.ts.map

package/dist/services/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/services/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAUtC,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEhD;AAED,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,CAK5E"}

package/dist/services/stats.js

@@ -0,0 +1,18 @@
+const FACTORS = {
+    off: 1,
+    lite: 0.85,
+    standard: 0.65,
+    ultra: 0.5,
+    symbolic: 0.4,
+};
+export function levelFactor(level) {
+    return FACTORS[level];
+}
+export function estimateCharsSaved(actualChars, level) {
+    if (level === "off")
+        return 0;
+    const factor = FACTORS[level];
+    const baseline = actualChars / factor;
+    return Math.max(0, Math.round(baseline - actualChars));
+}
+//# sourceMappingURL=stats.js.map

package/dist/services/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/services/stats.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAA0B;IACtC,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;IACd,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACb,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,KAAY;IACvC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAAmB,EAAE,KAAY;IACnE,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/services/validator.d.ts

@@ -0,0 +1,3 @@
+import type { ValidatorReport } from "../types";
+export declare function validateCompression(original: string, compressed: string): ValidatorReport;
+//# sourceMappingURL=validator.d.ts.map

package/dist/services/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/services/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AA6BhD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,CAkEzF"}

package/dist/services/validator.js

@@ -0,0 +1,87 @@
+const FENCED_RE = /```[\s\S]*?```/g;
+const URL_RE = /\bhttps?:\/\/\S+/g;
+const PATH_RE = /(?:^|\s)(\.?[\w.\-/]+\/[\w.\-/]+)(?=\s|$)/g;
+const HEADING_RE = /^(#{1,6})\s+(.+?)\s*$/gm;
+const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n/;
+const BULLET_RE = /^\s*[-*+]\s+/gm;
+const ARG_RE = /\$ARGUMENTS\b/g;
+function extractAll(re, src, group = 0) {
+    const out = [];
+    const r = new RegExp(re.source, re.flags);
+    let m = r.exec(src);
+    while (m !== null) {
+        out.push(m[group] ?? m[0]);
+        m = r.exec(src);
+    }
+    return out;
+}
+function setEqual(a, b) {
+    const as = new Set(a);
+    const bs = new Set(b);
+    if (as.size !== bs.size)
+        return false;
+    for (const v of as)
+        if (!bs.has(v))
+            return false;
+    return true;
+}
+export function validateCompression(original, compressed) {
+    const errors = [];
+    const warnings = [];
+    const fencedBefore = extractAll(FENCED_RE, original);
+    const fencedAfter = extractAll(FENCED_RE, compressed);
+    if (fencedBefore.length !== fencedAfter.length) {
+        errors.push(`fenced code block count changed: ${fencedBefore.length} → ${fencedAfter.length}`);
+    }
+    else {
+        for (let i = 0; i < fencedBefore.length; i++) {
+            if (fencedBefore[i] !== fencedAfter[i]) {
+                errors.push(`fenced code block #${i} content changed`);
+                break;
+            }
+        }
+    }
+    const urlsBefore = extractAll(URL_RE, original);
+    const urlsAfter = extractAll(URL_RE, compressed);
+    if (!setEqual(urlsBefore, urlsAfter)) {
+        errors.push(`URL set changed (before=${urlsBefore.length}, after=${urlsAfter.length})`);
+    }
+    const pathsBefore = extractAll(PATH_RE, original, 1);
+    const pathsAfter = extractAll(PATH_RE, compressed, 1);
+    if (!setEqual(pathsBefore, pathsAfter)) {
+        errors.push(`path set changed (before=${pathsBefore.length}, after=${pathsAfter.length})`);
+    }
+    const headingsBefore = extractAll(HEADING_RE, original).map((h) => h.trim());
+    const headingsAfter = extractAll(HEADING_RE, compressed).map((h) => h.trim());
+    if (headingsBefore.length !== headingsAfter.length) {
+        errors.push(`heading count changed: ${headingsBefore.length} → ${headingsAfter.length}`);
+    }
+    else {
+        for (let i = 0; i < headingsBefore.length; i++) {
+            if (headingsBefore[i] !== headingsAfter[i]) {
+                errors.push(`heading order or text changed at position ${i}`);
+                break;
+            }
+        }
+    }
+    const fmBefore = original.match(FRONTMATTER_RE)?.[0];
+    const fmAfter = compressed.match(FRONTMATTER_RE)?.[0];
+    if (fmBefore && fmBefore !== fmAfter) {
+        errors.push("frontmatter drifted");
+    }
+    const argsBefore = (original.match(ARG_RE) ?? []).length;
+    const argsAfter = (compressed.match(ARG_RE) ?? []).length;
+    if (argsBefore !== argsAfter) {
+        errors.push(`$ARGUMENTS count changed: ${argsBefore} → ${argsAfter}`);
+    }
+    const bulletsBefore = (original.match(BULLET_RE) ?? []).length;
+    const bulletsAfter = (compressed.match(BULLET_RE) ?? []).length;
+    if (bulletsBefore > 0) {
+        const drift = Math.abs(bulletsBefore - bulletsAfter) / bulletsBefore;
+        if (drift > 0.15) {
+            warnings.push(`bullet count drift ${(drift * 100).toFixed(0)}% (${bulletsBefore} → ${bulletsAfter})`);
+        }
+    }
+    return { ok: errors.length === 0, warnings, errors };
+}
+//# sourceMappingURL=validator.js.map

package/dist/services/validator.js.map

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

package/dist/skills/ultra-compress/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: ultra-compress
+description: "Compress runtime output or markdown files. Levels: off|lite|standard|ultra|symbolic. Triggers: \"caveman mode\" | \"ultra compress\" | \"shorten output\" | \"compress skill\" | \"compress this file\" | \"make it formal\" | \"use formal notation\" | \"talk like caveman\"."
+license: MIT
+allowed-tools: read, write, edit, glob, grep
+disable-model-invocation: false
+---
+
+# ultra-compress — κ
+
+Let:
+  L ∈ {off, lite, standard, ultra, symbolic}  — level
+  M ∈ {runtime, file}                          — mode
+  Π := protected zones (¬compress)
+  Ω := Auto-Clarity override
+
+## κ(L, M) — compress
+
+M = runtime → reshape current assistant msg per L rules.
+M = file    → rewrite .md file per L rules, preserve Π byte-identical.
+
+Each L ⊃ all prior L's rules (inheritance).
+
+## L = lite
+
+¬{filler: just, really, basically, actually, simply, essentially, generally};
+¬{hedging: "might be worth", "could consider", "you might want to"};
+¬{pleasantries: sure, certainly, "of course", "happy to", "I'd recommend"};
+keep articles ∧ full sentences.
+
+## L = standard
+
+lite ∧:
+¬articles(a, an, the);
+¬connectives(however, furthermore, additionally, moreover);
+fragments OK: [thing] [action] [reason]. [next].
+subst: {utilize → use, "in order to" → to, "make sure to" → ensure,
+        "the reason is because" → because, "prior to" → before}.
+
+## L = ultra
+
+standard ∧:
+abbrev: {database → DB, authentication → auth, configuration → config,
+         request → req, response → res, function → fn, implementation → impl,
+         environment → env, error → err};
+causality: "X causes Y" → "X → Y";
+¬conjunctions(where meaning survives).
+
+## L = symbolic
+
+ultra ∧:
+math/logic ops: {∀, ∃, ∧, ∨, ¬, →, ⟺, ∈, ∉, ⊂, ∪, ∩, ∅, { }, ; };
+predicate folding: "pred(x) ⟺ A ∧ B";
+Greek vars (φ, γ, τ, π, σ) ← concepts ≥3×;
+IMPORTANT: ∃ context ⟹ reader ¬fluent(notation) → fallback L = ultra.
+
+## Π — protected zones (¬compress, ∀ L, ∀ M)
+
+frontmatter · fenced + inline code · URLs · file paths · CLI commands ·
+headings(count + order) · $ARGUMENTS · tool names · numeric versions/dates ·
+quoted error strings · table structure · bullet nesting depth.
+
+## Ω — Auto-Clarity (M = runtime ∧ L ≠ off)
+
+turn ∈ { security-warning, destructive-confirm, ordered-multi-step, verbatim-error-quote }
+  → fallback prose(current msg) ∧ resume(L, next turn) ∧ autoClarityCount += 1.
+
+destructive := { rm -rf, "git reset --hard", force-push, DROP, TRUNCATE }.
+
+## file-mode pipeline (M = file)
+
+O_file {
+  resolve(path);
+  guard(size ≤ 500KB ∧ ext ∈ {md, txt, rst} ∧ ¬backup-exists);
+  mask(input, Π) → (masked, tokens);
+  lexical-pre-pass(masked, L) → L-masked;
+  LLM(L-masked, level-prompt(L, file)) → raw;
+  strip-outer-fence(raw) → stripped;
+  unmask(stripped, tokens) → candidate;
+  validate(input, candidate) → report;
+  report.ok ? write(candidate, backup=.original.md) : repair-loop(≤ 2);
+} → { compressed, ratio, warnings }.
+
+repair-loop: LLM(¬recompress ∧ patch-only(report.errors)) → retry.
+final-fail → restore(original) ∧ throw ValidatorFailedError.
+
+## commands (PI)
+
+/uc L                                  → κ-runtime set L, persist .pi/ultra-compress.json
+/uc-file path L [--yes]                → κ-file path L, preview unless --yes
+/uc-status                             → L ∧ session stats
+/uc-revert path                        → restore path from .original.md
+
+completers: autocomplete(L) ∀ /uc, /uc-file; glob(*.md) ∀ /uc-file position 1.

package/dist/types.d.ts

@@ -0,0 +1,62 @@
+export type Level = "off" | "lite" | "standard" | "ultra" | "symbolic";
+export type ActiveLevel = Exclude<Level, "off">;
+export type Mode = "runtime" | "file";
+export declare const ALL_LEVELS: readonly ["off", "lite", "standard", "ultra", "symbolic"];
+export declare const ACTIVE_LEVELS: readonly ["lite", "standard", "ultra", "symbolic"];
+export interface SessionStats {
+    startedAt: string;
+    autoClarityCount: number;
+    estimatedOutputCharsSaved: number;
+    filesCompressed: CompressedFileEntry[];
+}
+export interface CompressedFileEntry {
+    path: string;
+    level: ActiveLevel;
+    before: number;
+    after: number;
+    at: string;
+}
+export interface ProjectState {
+    level: Level;
+    updatedAt: string;
+    session: SessionStats;
+}
+export interface CompressResult {
+    compressed: string;
+    before: number;
+    after: number;
+    ratio: number;
+    warnings: string[];
+    substitutions?: Array<{
+        symbol: string;
+        concept: string;
+    }>;
+}
+export interface CompressOptions {
+    maxRepairRetries?: number;
+}
+export interface ValidatorReport {
+    ok: boolean;
+    warnings: string[];
+    errors: string[];
+}
+export declare class PIContextRequiredError extends Error {
+    constructor();
+}
+export declare class InvalidLevelError extends Error {
+    constructor(given: string);
+}
+export declare class FileTooLargeError extends Error {
+    constructor(path: string, bytes: number);
+}
+export declare class BackupExistsError extends Error {
+    constructor(backupPath: string);
+}
+export declare class UnsupportedFileTypeError extends Error {
+    constructor(path: string, reason: string);
+}
+export declare class ValidatorFailedError extends Error {
+    readonly errors: string[];
+    constructor(errors: string[]);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;AAEvE,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAEhD,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC;AAEtC,eAAO,MAAM,UAAU,2DAA4D,CAAC;AACpF,eAAO,MAAM,aAAa,oDAAqD,CAAC;AAEhF,MAAM,WAAW,YAAY;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB,EAAE,MAAM,CAAC;IAClC,eAAe,EAAE,mBAAmB,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,eAAe;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;;CAKhD;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC/B,KAAK,EAAE,MAAM;CAMzB;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC/B,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAIvC;AAED,qBAAa,iBAAkB,SAAQ,KAAK;gBAC/B,UAAU,EAAE,MAAM;CAI9B;AAED,qBAAa,wBAAyB,SAAQ,KAAK;gBACtC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIxC;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBACd,MAAM,EAAE,MAAM,EAAE;CAK5B"}

package/dist/types.js

@@ -0,0 +1,41 @@
+export const ALL_LEVELS = ["off", "lite", "standard", "ultra", "symbolic"];
+export const ACTIVE_LEVELS = ["lite", "standard", "ultra", "symbolic"];
+export class PIContextRequiredError extends Error {
+    constructor() {
+        super("ultra-compress: PI ExtensionContext is required for LLM-backed operations");
+        this.name = "PIContextRequiredError";
+    }
+}
+export class InvalidLevelError extends Error {
+    constructor(given) {
+        super(`ultra-compress: invalid level "${given}" (expected one of: off|lite|standard|ultra|symbolic)`);
+        this.name = "InvalidLevelError";
+    }
+}
+export class FileTooLargeError extends Error {
+    constructor(path, bytes) {
+        super(`ultra-compress: file "${path}" is ${bytes} bytes (max 512000)`);
+        this.name = "FileTooLargeError";
+    }
+}
+export class BackupExistsError extends Error {
+    constructor(backupPath) {
+        super(`ultra-compress: backup "${backupPath}" already exists — run /uc-revert first`);
+        this.name = "BackupExistsError";
+    }
+}
+export class UnsupportedFileTypeError extends Error {
+    constructor(path, reason) {
+        super(`ultra-compress: refusing to compress "${path}": ${reason}`);
+        this.name = "UnsupportedFileTypeError";
+    }
+}
+export class ValidatorFailedError extends Error {
+    errors;
+    constructor(errors) {
+        super(`ultra-compress: validator failed after repair retries — ${errors.join("; ")}`);
+        this.name = "ValidatorFailedError";
+        this.errors = errors;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AACpF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AA0ChF,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAChD;QACC,KAAK,CAAC,2EAA2E,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACtC,CAAC;CACD;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC3C,YAAY,KAAa;QACxB,KAAK,CACJ,kCAAkC,KAAK,uDAAuD,CAC9F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACjC,CAAC;CACD;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC3C,YAAY,IAAY,EAAE,KAAa;QACtC,KAAK,CAAC,yBAAyB,IAAI,QAAQ,KAAK,qBAAqB,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACjC,CAAC;CACD;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC3C,YAAY,UAAkB;QAC7B,KAAK,CAAC,2BAA2B,UAAU,yCAAyC,CAAC,CAAC;QACtF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACjC,CAAC;CACD;AAED,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAClD,YAAY,IAAY,EAAE,MAAc;QACvC,KAAK,CAAC,yCAAyC,IAAI,MAAM,MAAM,EAAE,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACxC,CAAC;CACD;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACrC,MAAM,CAAW;IAC1B,YAAY,MAAgB;QAC3B,KAAK,CAAC,2DAA2D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;CACD"}