@rpamis/comet 0.4.0-beta.3 → 0.4.0-beta.4

package/dist/platform/install/project-registry.js

@@ -0,0 +1,205 @@
+import { randomUUID } from 'crypto';
+import { promises as fs } from 'fs';
+import os from 'os';
+import path from 'path';
+import { ensureDir } from '../fs/file-system.js';
+export const PROJECT_REGISTRY_SCHEMA_VERSION = 1;
+export class ProjectRegistryError extends Error {
+    code;
+    registryPath;
+    constructor(code, message, registryPath) {
+        super(message);
+        this.code = code;
+        this.registryPath = registryPath;
+        this.name = 'ProjectRegistryError';
+    }
+}
+function nowIso(options) {
+    return (options.now ?? new Date()).toISOString();
+}
+export function getProjectRegistryPath(homeDir = os.homedir()) {
+    return path.join(homeDir, '.comet', 'installations.json');
+}
+function emptyRegistry(updatedAt) {
+    return {
+        schemaVersion: PROJECT_REGISTRY_SCHEMA_VERSION,
+        updatedAt,
+        projects: [],
+    };
+}
+function isMissingRegistryFile(error) {
+    const code = error?.code;
+    return code === 'ENOENT' || code === 'ENOTDIR';
+}
+async function registryFileExists(registryPath) {
+    try {
+        await fs.access(registryPath);
+        return true;
+    }
+    catch (error) {
+        if (isMissingRegistryFile(error))
+            return false;
+        throw error;
+    }
+}
+function canonicalKey(canonicalPath) {
+    return process.platform === 'win32' ? canonicalPath.toLowerCase() : canonicalPath;
+}
+function isProjectRegistrySource(value) {
+    return value === 'init' || value === 'update' || value === 'repair';
+}
+function isProjectRegistryTarget(value) {
+    return (Boolean(value) &&
+        typeof value === 'object' &&
+        typeof value.platform === 'string' &&
+        (value.language === 'en' ||
+            value.language === 'zh'));
+}
+function assertProjectRegistry(value, registryPath) {
+    if (!value || typeof value !== 'object') {
+        throw new ProjectRegistryError('invalid-schema', 'Project registry must be a JSON object', registryPath);
+    }
+    const candidate = value;
+    if (candidate.schemaVersion !== PROJECT_REGISTRY_SCHEMA_VERSION) {
+        throw new ProjectRegistryError('invalid-schema', `Unsupported project registry schema version: ${String(candidate.schemaVersion)}`, registryPath);
+    }
+    if (typeof candidate.updatedAt !== 'string' || !Array.isArray(candidate.projects)) {
+        throw new ProjectRegistryError('invalid-schema', 'Project registry must contain updatedAt and projects', registryPath);
+    }
+    const projects = candidate.projects.map((entry, index) => {
+        if (!entry || typeof entry !== 'object') {
+            throw new ProjectRegistryError('invalid-schema', `Project registry entry ${index} must be an object`, registryPath);
+        }
+        const project = entry;
+        if (typeof project.path !== 'string' ||
+            typeof project.canonicalPath !== 'string' ||
+            typeof project.addedAt !== 'string' ||
+            typeof project.updatedAt !== 'string' ||
+            typeof project.lastSeenAt !== 'string' ||
+            !isProjectRegistrySource(project.lastSource) ||
+            !Array.isArray(project.lastTargets)) {
+            throw new ProjectRegistryError('invalid-schema', `Project registry entry ${index} has invalid fields`, registryPath);
+        }
+        return {
+            path: project.path,
+            canonicalPath: project.canonicalPath,
+            addedAt: project.addedAt,
+            updatedAt: project.updatedAt,
+            lastSeenAt: project.lastSeenAt,
+            lastSource: project.lastSource,
+            lastTargets: project.lastTargets.map((target, targetIndex) => {
+                if (!isProjectRegistryTarget(target)) {
+                    throw new ProjectRegistryError('invalid-schema', `Project registry entry ${index} target ${targetIndex} has invalid fields`, registryPath);
+                }
+                return {
+                    platform: target.platform,
+                    language: target.language,
+                };
+            }),
+        };
+    });
+    return {
+        schemaVersion: PROJECT_REGISTRY_SCHEMA_VERSION,
+        updatedAt: candidate.updatedAt,
+        projects,
+    };
+}
+async function resolveProjectPath(projectPath) {
+    const resolved = path.resolve(projectPath);
+    try {
+        return {
+            path: resolved,
+            canonicalPath: await fs.realpath(resolved),
+        };
+    }
+    catch {
+        return {
+            path: resolved,
+            canonicalPath: resolved,
+        };
+    }
+}
+async function writeProjectRegistry(registry, registryPath) {
+    await ensureDir(path.dirname(registryPath));
+    const temporary = path.join(path.dirname(registryPath), `installations.${randomUUID()}.tmp`);
+    await fs.writeFile(temporary, `${JSON.stringify(registry, null, 2)}\n`, 'utf-8');
+    await fs.rename(temporary, registryPath);
+}
+export async function readProjectRegistry(options = {}) {
+    const registryPath = getProjectRegistryPath(options.homeDir);
+    const updatedAt = nowIso(options);
+    if (!(await registryFileExists(registryPath)))
+        return emptyRegistry(updatedAt);
+    let content;
+    try {
+        content = await fs.readFile(registryPath, 'utf-8');
+    }
+    catch (error) {
+        if (isMissingRegistryFile(error))
+            return emptyRegistry(updatedAt);
+        throw error;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch (error) {
+        if (options.strict) {
+            throw new ProjectRegistryError('invalid-json', `Project registry is invalid JSON: ${error.message}`, registryPath);
+        }
+        return emptyRegistry(updatedAt);
+    }
+    try {
+        return assertProjectRegistry(parsed, registryPath);
+    }
+    catch (error) {
+        if (options.strict)
+            throw error;
+        return emptyRegistry(updatedAt);
+    }
+}
+export async function listProjectRegistryEntries(options = {}) {
+    return (await readProjectRegistry(options)).projects;
+}
+export async function upsertProjectInstallation(projectPath, targets, source, options = {}) {
+    const registryPath = getProjectRegistryPath(options.homeDir);
+    const timestamp = nowIso(options);
+    const registry = await readProjectRegistry({ ...options, strict: false });
+    const resolved = await resolveProjectPath(projectPath);
+    const key = canonicalKey(resolved.canonicalPath);
+    const existing = registry.projects.find((entry) => canonicalKey(entry.canonicalPath) === key);
+    const entry = {
+        path: resolved.path,
+        canonicalPath: resolved.canonicalPath,
+        addedAt: existing?.addedAt ?? timestamp,
+        updatedAt: timestamp,
+        lastSeenAt: timestamp,
+        lastSource: source,
+        lastTargets: targets,
+    };
+    const projects = registry.projects.filter((project) => canonicalKey(project.canonicalPath) !== key);
+    projects.push(entry);
+    projects.sort((left, right) => left.path.localeCompare(right.path));
+    await writeProjectRegistry({
+        schemaVersion: PROJECT_REGISTRY_SCHEMA_VERSION,
+        updatedAt: timestamp,
+        projects,
+    }, registryPath);
+    return entry;
+}
+export async function removeProjectInstallation(projectPath, options = {}) {
+    const registryPath = getProjectRegistryPath(options.homeDir);
+    const registry = await readProjectRegistry({ ...options, strict: false });
+    const resolved = await resolveProjectPath(projectPath);
+    const key = canonicalKey(resolved.canonicalPath);
+    const projects = registry.projects.filter((project) => canonicalKey(project.canonicalPath) !== key);
+    if (projects.length === registry.projects.length)
+        return false;
+    await writeProjectRegistry({
+        schemaVersion: PROJECT_REGISTRY_SCHEMA_VERSION,
+        updatedAt: nowIso(options),
+        projects,
+    }, registryPath);
+    return true;
+}
+//# sourceMappingURL=project-registry.js.map

package/dist/platform/install/project-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-registry.js","sourceRoot":"","sources":["../../../platform/install/project-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC;AAgCjD,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAE3B;IAEA;IAHlB,YACkB,IAA8B,EAC9C,OAAe,EACC,YAAoB;QAEpC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAA0B;QAE9B,iBAAY,GAAZ,YAAY,CAAQ;QAGpC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,SAAS,MAAM,CAAC,OAA+B;IAC7C,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE;IAC3D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,aAAa,CAAC,SAAiB;IACtC,OAAO;QACL,aAAa,EAAE,+BAA+B;QAC9C,SAAS;QACT,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,MAAM,IAAI,GAAI,KAA2C,EAAE,IAAI,CAAC;IAChE,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,CAAC;AACjD,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,YAAoB;IACpD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,qBAAqB,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,aAAqB;IACzC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;AACpF,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,QAAQ,CAAC;AACtE,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,OAAO,CACL,OAAO,CAAC,KAAK,CAAC;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAQ,KAA+B,CAAC,QAAQ,KAAK,QAAQ;QAC7D,CAAE,KAA+B,CAAC,QAAQ,KAAK,IAAI;YAChD,KAA+B,CAAC,QAAQ,KAAK,IAAI,CAAC,CACtD,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc,EAAE,YAAoB;IACjE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,MAAM,IAAI,oBAAoB,CAC5B,gBAAgB,EAChB,wCAAwC,EACxC,YAAY,CACb,CAAC;IACJ,CAAC;IACD,MAAM,SAAS,GAAG,KAA6E,CAAC;IAChG,IAAI,SAAS,CAAC,aAAa,KAAK,+BAA+B,EAAE,CAAC;QAChE,MAAM,IAAI,oBAAoB,CAC5B,gBAAgB,EAChB,gDAAgD,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,EACjF,YAAY,CACb,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,SAAS,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClF,MAAM,IAAI,oBAAoB,CAC5B,gBAAgB,EAChB,sDAAsD,EACtD,YAAY,CACb,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAwB,EAAE;QAC7E,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,MAAM,IAAI,oBAAoB,CAC5B,gBAAgB,EAChB,0BAA0B,KAAK,oBAAoB,EACnD,YAAY,CACb,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAG,KAAsC,CAAC;QACvD,IACE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;YAChC,OAAO,OAAO,CAAC,aAAa,KAAK,QAAQ;YACzC,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;YACnC,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;YACrC,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;YACtC,CAAC,uBAAuB,CAAC,OAAO,CAAC,UAAU,CAAC;YAC5C,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EACnC,CAAC;YACD,MAAM,IAAI,oBAAoB,CAC5B,gBAAgB,EAChB,0BAA0B,KAAK,qBAAqB,EACpD,YAAY,CACb,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,WAAW,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE;gBAC3D,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrC,MAAM,IAAI,oBAAoB,CAC5B,gBAAgB,EAChB,0BAA0B,KAAK,WAAW,WAAW,qBAAqB,EAC1E,YAAY,CACb,CAAC;gBACJ,CAAC;gBAED,OAAO;oBACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;oBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;iBAC1B,CAAC;YACJ,CAAC,CAAC;SACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,aAAa,EAAE,+BAA+B;QAC9C,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IAInD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,aAAa,EAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;SAC3C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,aAAa,EAAE,QAAQ;SACxB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,QAAyB,EACzB,YAAoB;IAEpB,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,iBAAiB,UAAU,EAAE,MAAM,CAAC,CAAC;IAC7F,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjF,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAAkC,EAAE;IAEpC,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,CAAC,CAAC,MAAM,kBAAkB,CAAC,YAAY,CAAC,CAAC;QAAE,OAAO,aAAa,CAAC,SAAS,CAAC,CAAC;IAE/E,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,qBAAqB,CAAC,KAAK,CAAC;YAAE,OAAO,aAAa,CAAC,SAAS,CAAC,CAAC;QAClE,MAAM,KAAK,CAAC;IACd,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,oBAAoB,CAC5B,cAAc,EACd,qCAAsC,KAAe,CAAC,OAAO,EAAE,EAC/D,YAAY,CACb,CAAC;QACJ,CAAC;QACD,OAAO,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,CAAC;QACH,OAAO,qBAAqB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,KAAK,CAAC;QAChC,OAAO,aAAa,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAAkC,EAAE;IAEpC,OAAO,CAAC,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAAmB,EACnB,OAAgC,EAChC,MAA6B,EAC7B,UAAkC,EAAE;IAEpC,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,GAAG,CAAC,CAAC;IAC9F,MAAM,KAAK,GAAyB;QAClC,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,OAAO,EAAE,QAAQ,EAAE,OAAO,IAAI,SAAS;QACvC,SAAS,EAAE,SAAS;QACpB,UAAU,EAAE,SAAS;QACrB,UAAU,EAAE,MAAM;QAClB,WAAW,EAAE,OAAO;KACrB,CAAC;IACF,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CACvC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,GAAG,CACzD,CAAC;IACF,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAEpE,MAAM,oBAAoB,CACxB;QACE,aAAa,EAAE,+BAA+B;QAC9C,SAAS,EAAE,SAAS;QACpB,QAAQ;KACT,EACD,YAAY,CACb,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAAmB,EACnB,UAAkC,EAAE;IAEpC,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,CACvC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,GAAG,CACzD,CAAC;IACF,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,QAAQ,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE/D,MAAM,oBAAoB,CACxB;QACE,aAAa,EAAE,+BAA+B;QAC9C,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC;QAC1B,QAAQ;KACT,EACD,YAAY,CACb,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/eval/.env

@@ -0,0 +1,28 @@
+# Local eval environment (generated; uses mimo proxy in lieu of native ANTHROPIC_API_KEY).
+# Claude Code authenticates via the Anthropic-compatible proxy below.
+
+# Anthropic-compatible proxy (mimo). Mirrors ~/.claude/settings.json env block.
+ANTHROPIC_AUTH_TOKEN=tp-c0v2yajbthwu7ntb5reiaidghtdkr60dfm7dljdh7snbmxuw
+ANTHROPIC_BASE_URL=https://token-plan-cn.xiaomimimo.com/anthropic
+ANTHROPIC_MODEL=mimo-v2.5-pro
+ANTHROPIC_DEFAULT_HAIKU_MODEL=mimo-v2.5
+ANTHROPIC_DEFAULT_SONNET_MODEL=mimo-v2.5-pro
+ANTHROPIC_DEFAULT_OPUS_MODEL=mimo-v2.5-pro
+ANTHROPIC_DEFAULT_OPUS_MODEL_NAME=mimo-v2.5-pro
+ANTHROPIC_DEFAULT_SONNET_MODEL_NAME=mimo-v2.5-pro
+CLAUDE_CODE_SUBAGENT_MODEL=mimo-v2.5
+
+# Optional Claude Code model override (leave blank to use ANTHROPIC_MODEL).
+BENCH_CC_MODEL=
+BENCH_CC_VERSION=latest
+
+# LangSmith (left blank for local-only runs).
+LANGSMITH_API_KEY=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
+LANGSMITH_TRACING=true
+TRACE_TO_LANGSMITH=true
+LANGSMITH_ENDPOINT=https://api.smith.langchain.com
+LANGSMITH_PROJECT=comet-skill-eval
+BENCH_LLM_JUDGE=1
+BENCH_JUDGE_MODEL=glm-5.2
+BENCH_JUDGE_AUTH_TOKEN=70505c697ee343bba5d4480da6be4882.h7NoPY3zaEkETS4i
+BENCH_JUDGE_BASE_URL=https://open.bigmodel.cn/api/anthropic

package/eval/.env.example

@@ -0,0 +1,52 @@
+# Required for local and LangSmith eval runs unless ANTHROPIC_AUTH_TOKEN is set.
+# Keep values commented when you prefer system environment variables.
+# ANTHROPIC_API_KEY=
+
+# Optional Claude Code model override.
+# BENCH_CC_MODEL=
+# BENCH_CC_VERSION=latest
+
+# Optional: path to a custom user-simulator prompt for auto_user workflow evals.
+# Relative paths resolve from eval/. Defaults to eval/simulator-instruction.md.
+# BENCH_SIMULATOR_PROMPT_FILE=simulator-instruction.md
+
+# Optional LLM-as-judge. Judge provider settings are intentionally separate
+# from the subject agent's ANTHROPIC_* settings; BENCH_JUDGE_MODEL is required
+# when BENCH_LLM_JUDGE=1.
+# BENCH_LLM_JUDGE=1
+# BENCH_JUDGE_MODEL=
+# BENCH_JUDGE_AUTH_TOKEN=
+# BENCH_JUDGE_BASE_URL=
+# BENCH_JUDGE_API_KEY=
+
+# Claude Code via Anthropic-compatible proxy (BigModel / mimo / OpenRouter etc.).
+# When ANTHROPIC_API_KEY is unset, claude authenticates with these instead.
+# ANTHROPIC_AUTH_TOKEN=
+# ANTHROPIC_BASE_URL=
+# ANTHROPIC_MODEL=
+# ANTHROPIC_DEFAULT_HAIKU_MODEL=
+# ANTHROPIC_DEFAULT_SONNET_MODEL=
+# ANTHROPIC_DEFAULT_OPUS_MODEL=
+# ANTHROPIC_DEFAULT_OPUS_MODEL_NAME=
+# ANTHROPIC_DEFAULT_SONNET_MODEL_NAME=
+# CLAUDE_CODE_SUBAGENT_MODEL=
+
+# Required only for eval/langsmith.
+# LANGSMITH_API_KEY=
+# LANGSMITH_TRACING=true
+# LANGSMITH_ENDPOINT=https://api.smith.langchain.com
+# LANGSMITH_PROJECT=comet-skill-eval
+# The Claude Code plugin variables (TRACE_TO_LANGSMITH and CC_LANGSMITH_*) are
+# derived from the LANGSMITH_* settings by eval/langsmith/tests/conftest.py.
+
+# Optional: name the LangSmith experiment (project) per treatment so CONTROL vs
+# skill-injected runs compare in the experiment view.
+# LANGSMITH_EXPERIMENT=COMET_FULL_040_BETA
+
+# Optional trajectory tracing via the official langsmith-tracing Claude Code
+# plugin. When LANGSMITH_TRACING=true, the LangSmith suite auto-builds the
+# plugin into eval/.cache/langsmith-cc-plugin via node:20 and reuses that cache.
+# Do not mount a Windows-host-built node_modules directory into the Linux eval container.
+# Unset = rubric + comparison still logged, just without the nested trajectory.
+# CC_LANGSMITH_PLUGIN_DIR=/abs/path/to/comet/eval/.cache/langsmith-cc-plugin
+# CC_LANGSMITH_PLUGIN_AUTO_BUILD=true

package/eval/CLAUDE.md

@@ -0,0 +1,43 @@
+# Comet Skill Evaluation
+
+Benchmarks for evaluating the Comet skill workflow.
+
+## Structure
+
+```text
+scaffold/             # Shared Python runner, Docker helpers, loaders, validators
+local/                # Local suite: task corpus, treatments, skills, tests, logs
+langsmith/            # LangSmith suite entrypoint and logs
+```
+
+The LangSmith suite intentionally reuses `local/tasks`, `local/treatments`, and
+`local/skills` through environment path overrides. Keep shared runtime code in
+`scaffold/`; add suite-specific behavior under `local/` or `langsmith/`.
+
+## Running Local Eval
+
+```bash
+uv run pytest local/tests/tasks/test_tasks.py --task=comet-hotfix --treatment=COMET_FULL_040_BETA -v
+uv run pytest local/tests/tasks/test_tasks.py --task=comet-full-workflow --treatment=CONTROL,COMET_FULL_040_BETA -v
+uv run pytest local/tests/tasks/test_tasks.py -v
+```
+
+Local logs are written to `local/logs/experiments/`.
+
+## Running LangSmith Eval
+
+```bash
+uv run pytest langsmith/tests/tasks/test_tasks.py --task=comet-hotfix --treatment=COMET_FULL_040_BETA -v
+```
+
+LangSmith runs require `LANGSMITH_API_KEY` and write local reports to
+`langsmith/logs/experiments/`.
+
+## Adding Tasks
+
+For the default corpus, add tasks under `local/tasks/` and update
+`local/tasks/index.yaml`. Add task-specific prompt, Docker environment, and
+validation script together.
+
+If a task should be LangSmith-only, create a dedicated `langsmith/tasks/` corpus
+and set `BENCH_TASKS_DIR` in `langsmith/tests/conftest.py` accordingly.