@litfamily/litcodex 1.0.0 → 1.0.2

package/node_modules/@litcodex/lit-loop/dist/skill-loop/ownership.js

@@ -1,145 +0,0 @@
-import { TextDecoder } from "node:util";
-import { readBlob } from "./store.js";
-import { SkillLoopError } from "./types.js";
-const utf8 = new TextDecoder("utf-8", { fatal: true });
-const MARKER_KEY = "litcodexAgentGenerated";
-const metadataEntry = /^metadata\s*:\s*$/u;
-const markerEntry = new RegExp(`^${MARKER_KEY}:\\s*(true|false)\\s*$`, "u");
-const exactMetadataKeys = new Set(["metadata"]);
-const exactMarkerKeys = new Set(["litcodexAgentGenerated"]);
-function mappingKey(line) {
-    const indent = /^ */u.exec(line)?.[0].length ?? 0;
-    const body = line.slice(indent);
-    const colon = body.indexOf(":");
-    if (colon < 0)
-        return null;
-    return { indent, key: body.slice(0, colon).trim() };
-}
-function hasUnsafeSemanticAlias(line, expectedIndent) {
-    const parsed = mappingKey(line);
-    if (parsed === null || (expectedIndent !== undefined && parsed.indent !== expectedIndent))
-        return false;
-    if (parsed.key.includes("\\"))
-        return true;
-    const normalized = parsed.key.normalize("NFKC");
-    if (parsed.indent === 0 && normalized.toLocaleLowerCase("en-US").includes("metadata")) {
-        return !exactMetadataKeys.has(parsed.key);
-    }
-    if (normalized.toLocaleLowerCase("en-US").includes("litcodexagentgenerated")) {
-        return !exactMarkerKeys.has(parsed.key);
-    }
-    return false;
-}
-function hasUnsupportedYamlSyntax(line) {
-    const body = line.trim();
-    if (body === "" || body.startsWith("#"))
-        return false;
-    if (/^[?%{[]/u.test(body))
-        return true;
-    const parsed = mappingKey(line);
-    if (parsed === null)
-        return false;
-    if (parsed.key === "<<" || /^[&*!{[]/u.test(parsed.key))
-        return true;
-    const colon = line.indexOf(":");
-    const value = colon < 0 ? "" : line.slice(colon + 1).trimStart();
-    return (/^(?:[!{[]|\*[^\s]+)/u.test(value) ||
-        /(?:^|\s)&[A-Za-z0-9_-]+(?:\s|$)/u.test(value) ||
-        /(?:^|\s)\*[A-Za-z0-9_-]+(?:\s|$)/u.test(value));
-}
-export function markerPresent(content) {
-    if (!content.startsWith("---\n"))
-        return false;
-    const lines = content.split("\n");
-    const end = lines.indexOf("---", 1);
-    if (end < 0)
-        return false;
-    const frontmatter = lines.slice(1, end);
-    if (frontmatter.some((line) => hasUnsupportedYamlSyntax(line) || hasUnsafeSemanticAlias(line)))
-        return false;
-    const metadataEntries = frontmatter
-        .map((line, index) => ({ line, index }))
-        .filter(({ line }) => /^metadata\s*:/u.test(line));
-    if (metadataEntries.length !== 1 || !metadataEntry.test(metadataEntries[0]?.line ?? ""))
-        return false;
-    const metadata = metadataEntries[0]?.index;
-    if (metadata === undefined)
-        return false;
-    let directIndent;
-    let markerCount = 0;
-    let markerIsTrue = false;
-    for (let index = metadata + 1; index < frontmatter.length; index += 1) {
-        const line = frontmatter[index] ?? "";
-        if (line.trim() === "" || line.trimStart().startsWith("#"))
-            continue;
-        const indent = /^ */u.exec(line)?.[0].length ?? 0;
-        if (indent === 0)
-            break;
-        directIndent ??= indent;
-        if (indent === directIndent) {
-            if (hasUnsafeSemanticAlias(line, directIndent))
-                return false;
-            const direct = line.slice(indent);
-            if (mappingKey(line)?.key !== MARKER_KEY)
-                continue;
-            markerCount += 1;
-            const marker = markerEntry.exec(direct);
-            if (marker === null || marker[1] !== "true")
-                return false;
-            markerIsTrue = true;
-        }
-    }
-    return markerCount === 1 && markerIsTrue;
-}
-export function stampMarker(content, skillId) {
-    if (markerPresent(content))
-        return content;
-    if (!content.startsWith("---\n")) {
-        return `---\nname: ${skillId}\ndescription: Agent-owned reusable skill.\nmetadata:\n  litcodexAgentGenerated: true\n---\n\n${content}`;
-    }
-    const lines = content.split("\n");
-    const end = lines.indexOf("---", 1);
-    if (end < 0)
-        throw new SkillLoopError("TARGET_MARKER_INVALID", "SKILL.md frontmatter is incomplete");
-    const frontmatter = lines.slice(1, end);
-    if (frontmatter.some((line) => hasUnsupportedYamlSyntax(line) || hasUnsafeSemanticAlias(line))) {
-        throw new SkillLoopError("TARGET_MARKER_INVALID", "SKILL.md metadata contains a noncanonical YAML key");
-    }
-    const metadataEntries = frontmatter
-        .map((line, index) => ({ line, index }))
-        .filter(({ line }) => /^metadata\s*:/u.test(line));
-    if (metadataEntries.length > 1 ||
-        (metadataEntries[0] !== undefined && !metadataEntry.test(metadataEntries[0].line))) {
-        throw new SkillLoopError("TARGET_MARKER_INVALID", "SKILL.md metadata must be a direct YAML mapping");
-    }
-    const metadata = metadataEntries[0]?.index;
-    if (metadata === undefined)
-        frontmatter.push("metadata:", "  litcodexAgentGenerated: true");
-    else {
-        let indent = "  ";
-        for (let index = metadata + 1; index < frontmatter.length; index += 1) {
-            const line = frontmatter[index] ?? "";
-            if (line.trim() === "" || line.trimStart().startsWith("#"))
-                continue;
-            const current = /^ */u.exec(line)?.[0] ?? "";
-            if (current.length === 0)
-                break;
-            indent = current;
-            break;
-        }
-        frontmatter.splice(metadata + 1, 0, `${indent}litcodexAgentGenerated: true`);
-    }
-    return ["---", ...frontmatter, "---", ...lines.slice(end + 1)].join("\n");
-}
-export function decodeSkillItem(paths, item) {
-    try {
-        return utf8.decode(readBlob(paths, item));
-    }
-    catch {
-        throw new SkillLoopError("TARGET_TEXT_INVALID", "the target skill file is not valid UTF-8");
-    }
-}
-export function snapshotIsAgentOwned(paths, snapshot) {
-    const skillFile = snapshot.find((item) => item.file === "SKILL.md");
-    return skillFile !== undefined && markerPresent(decodeSkillItem(paths, skillFile));
-}

package/node_modules/@litcodex/lit-loop/dist/skill-loop/paths.d.ts

@@ -1,18 +0,0 @@
-export interface SkillLoopPaths {
-    readonly workspaceRoot: string;
-    readonly stateRoot: string;
-    readonly proposalsDir: string;
-    readonly ledgerPath: string;
-    readonly blobsDir: string;
-    readonly lockPath: string;
-    readonly agentMutationLockPath: string;
-    readonly transactionPath: string;
-    readonly agentRoot: string;
-    readonly usagePath: string;
-    readonly archiveRoot: string;
-    readonly curatorBackupsRoot: string;
-}
-export declare function agentSkillRoot(env?: NodeJS.ProcessEnv): string;
-export declare function skillLoopPaths(workspaceRoot: string, env?: NodeJS.ProcessEnv): SkillLoopPaths;
-export declare function isWithin(root: string, candidate: string): boolean;
-export declare function targetSkillDir(paths: SkillLoopPaths, skillId: string): string;

package/node_modules/@litcodex/lit-loop/dist/skill-loop/paths.js

@@ -1,43 +0,0 @@
-import { isAbsolute, join, resolve, sep } from "node:path";
-import { SkillLoopError } from "./types.js";
-export function agentSkillRoot(env = process.env) {
-    const home = env["HOME"]?.trim();
-    if (!home || !isAbsolute(home)) {
-        throw new SkillLoopError("HOME_INVALID", "the skill-loop HOME is unavailable");
-    }
-    return resolve(home, ".agents", "skills");
-}
-export function skillLoopPaths(workspaceRoot, env = process.env) {
-    if (!isAbsolute(workspaceRoot)) {
-        throw new SkillLoopError("WORKSPACE_ROOT_INVALID", "the skill-loop workspace root must be absolute");
-    }
-    const root = resolve(workspaceRoot);
-    const stateRoot = join(root, ".litcodex");
-    const agentRoot = agentSkillRoot(env);
-    return {
-        workspaceRoot: root,
-        stateRoot,
-        proposalsDir: join(stateRoot, "skill-proposals"),
-        ledgerPath: join(stateRoot, "skill-ledger.jsonl"),
-        blobsDir: join(stateRoot, "skill-ledger-blobs"),
-        lockPath: join(stateRoot, "skill-loop.lock"),
-        agentMutationLockPath: join(resolve(agentRoot, ".."), ".litcodex-skill-loop-mutation.lock"),
-        transactionPath: join(stateRoot, "skill-transaction.json"),
-        agentRoot,
-        usagePath: join(agentRoot, ".litcodex-usage.json"),
-        archiveRoot: join(agentRoot, ".litcodex-archive"),
-        curatorBackupsRoot: join(agentRoot, ".litcodex-curator-backups"),
-    };
-}
-export function isWithin(root, candidate) {
-    const normalizedRoot = resolve(root);
-    const normalizedCandidate = resolve(candidate);
-    return normalizedCandidate === normalizedRoot || normalizedCandidate.startsWith(`${normalizedRoot}${sep}`);
-}
-export function targetSkillDir(paths, skillId) {
-    const target = resolve(paths.agentRoot, skillId);
-    if (!isWithin(paths.agentRoot, target) || target === paths.agentRoot) {
-        throw new SkillLoopError("TARGET_NOT_AGENT_OWNED", "the proposal target is not agent-owned");
-    }
-    return target;
-}

package/node_modules/@litcodex/lit-loop/dist/skill-loop/review.d.ts

@@ -1,28 +0,0 @@
-export interface ReviewOptions {
-    readonly env?: NodeJS.ProcessEnv | undefined;
-    readonly now?: () => Date;
-    readonly spawn?: ReviewSpawn;
-    /** Test-only race seam; production callers leave this unset. */
-    readonly beforeRead?: ((path: string) => void) | undefined;
-}
-export interface ReviewSpawnOptions {
-    readonly cwd: string;
-    readonly env: NodeJS.ProcessEnv;
-    readonly encoding: "utf8";
-    readonly stdio: ["ignore", "pipe", "pipe"];
-    readonly maxBuffer: number;
-    readonly timeout: number;
-}
-export interface ReviewSpawnResult {
-    readonly status: number | null;
-    readonly stdout: string;
-    readonly stderr: string;
-    readonly error?: Error;
-}
-export type ReviewSpawn = (command: string, args: readonly string[], options: ReviewSpawnOptions) => ReviewSpawnResult;
-export declare function buildReviewPacket(workspaceRoot: string, options?: Pick<ReviewOptions, "env" | "beforeRead">): string;
-export declare function runCodexReview(workspaceRoot: string, options?: ReviewOptions): {
-    readonly ok: true;
-    readonly proposalIds: readonly string[];
-    readonly noOp: boolean;
-};