agentera 3.0.0-dev.4 → 3.0.0-dev.6

package/dist/registries/evaluatorHandoffContract.js

@@ -0,0 +1,171 @@
+import fs from "node:fs";
+import { execSync } from "node:child_process";
+import path from "node:path";
+import { loadYamlMapping } from "../core/yaml.js";
+/**
+ * Evaluator-handoff contract loader and inspektera evaluation report validator.
+ * Authority: references/cli/capability-instruction-contract.yaml#evaluator_handoff
+ */
+export const EVALUATOR_HANDOFF_REPORT_SCHEMA_VERSION = "agentera.inspekteraEvaluationReport.v1";
+function isMapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function asString(value) {
+    return value === null || value === undefined ? "" : String(value).trim();
+}
+export function defaultEvaluatorHandoffContractPath(repoRoot) {
+    return path.join(repoRoot, "references", "cli", "capability-instruction-contract.yaml");
+}
+export function loadEvaluatorHandoffContract(contractPath) {
+    const data = loadYamlMapping(fs.readFileSync(contractPath, "utf8"));
+    const handoff = data.evaluator_handoff;
+    if (!isMapping(handoff)) {
+        throw new Error(`evaluator_handoff section missing in ${contractPath}`);
+    }
+    const rowSchema = isMapping(handoff.row_schema) ? handoff.row_schema : {};
+    const citationFormats = isMapping(rowSchema.citation_formats) ? rowSchema.citation_formats : {};
+    const fileLine = isMapping(citationFormats.file_line) ? citationFormats.file_line : {};
+    const notApplicable = isMapping(citationFormats.not_applicable) ? citationFormats.not_applicable : {};
+    const warnVerify = isMapping(rowSchema.warn_verify_command) ? rowSchema.warn_verify_command : {};
+    const patternSource = asString(fileLine.pattern) || "^[^:\\s]+:\\d+$";
+    return {
+        path: contractPath,
+        status: asString(handoff.status) || "unknown",
+        reportSchemaVersion: asString(handoff.report_schema_version) || EVALUATOR_HANDOFF_REPORT_SCHEMA_VERSION,
+        citationRequiredFor: Array.isArray(rowSchema.citation_required_for)
+            ? rowSchema.citation_required_for.map((v) => String(v))
+            : ["WARN", "FAIL"],
+        fileLinePattern: new RegExp(patternSource),
+        notApplicablePrefix: asString(notApplicable.prefix) || "not-applicable:",
+        minNotApplicableReasonLength: Number(notApplicable.min_reason_length) || 8,
+        warnVerifyCommandRequired: warnVerify.required_when === "file_line_citation",
+        warnVerifyCommandPrefixes: Array.isArray(warnVerify.allowed_prefixes)
+            ? warnVerify.allowed_prefixes.map((v) => String(v))
+            : ["grep", "git show"],
+    };
+}
+export function isFileLineCitation(citation, contract) {
+    return contract.fileLinePattern.test(citation);
+}
+export function isNotApplicableCitation(citation, contract) {
+    if (!citation.startsWith(contract.notApplicablePrefix))
+        return false;
+    const reason = citation.slice(contract.notApplicablePrefix.length).trim();
+    return reason.length >= contract.minNotApplicableReasonLength;
+}
+export function isValidCitation(citation, contract) {
+    const trimmed = citation.trim();
+    if (!trimmed)
+        return false;
+    return isFileLineCitation(trimmed, contract) || isNotApplicableCitation(trimmed, contract);
+}
+export function parseFileLineCitation(citation) {
+    const match = /^([^:\s]+):(\d+)$/.exec(citation.trim());
+    if (!match)
+        return null;
+    return { file: match[1], line: Number(match[2]) };
+}
+export function isAllowedVerifyCommand(command, contract) {
+    const trimmed = command.trim();
+    return contract.warnVerifyCommandPrefixes.some((prefix) => trimmed.startsWith(prefix));
+}
+export function validateEvaluationReportRow(row, index, contract) {
+    const errors = [];
+    const label = `rows[${index}]`;
+    const status = asString(row.status).toUpperCase();
+    const criterion = asString(row.criterion);
+    const evidence = asString(row.evidence);
+    if (!criterion)
+        errors.push(`${label}: missing criterion`);
+    if (!status)
+        errors.push(`${label}: missing status`);
+    if (!evidence)
+        errors.push(`${label}: missing evidence`);
+    if (!contract.citationRequiredFor.includes(status))
+        return errors;
+    const citation = asString(row.citation);
+    if (!citation) {
+        errors.push(`${label}: WARN/FAIL row missing citation`);
+        return errors;
+    }
+    if (!isValidCitation(citation, contract)) {
+        errors.push(`${label}: citation must be file:line (e.g. TODO.md:15) or not-applicable: <reason> (min ${contract.minNotApplicableReasonLength} chars)`);
+        return errors;
+    }
+    if (status === "WARN" && contract.warnVerifyCommandRequired && isFileLineCitation(citation, contract)) {
+        const verifyCommand = asString(row.verify_command);
+        if (!verifyCommand) {
+            errors.push(`${label}: WARN row with file:line citation missing verify_command`);
+        }
+        else if (!isAllowedVerifyCommand(verifyCommand, contract)) {
+            errors.push(`${label}: verify_command must start with grep or git show`);
+        }
+    }
+    return errors;
+}
+export function validateEvaluationReport(report, contract) {
+    const errors = [];
+    const schemaVersion = asString(report.schemaVersion);
+    if (schemaVersion && schemaVersion !== contract.reportSchemaVersion) {
+        errors.push(`schemaVersion must be ${contract.reportSchemaVersion}`);
+    }
+    const rows = Array.isArray(report.rows) ? report.rows : null;
+    if (!rows || rows.length === 0) {
+        errors.push("rows must be a non-empty array");
+        return errors;
+    }
+    rows.forEach((row, index) => {
+        errors.push(...validateEvaluationReportRow(row, index, contract));
+    });
+    return errors;
+}
+function readCitedLine(repoRoot, file, line) {
+    const absPath = path.isAbsolute(file) ? file : path.join(repoRoot, file);
+    if (!fs.existsSync(absPath))
+        return "";
+    const lines = fs.readFileSync(absPath, "utf8").split(/\r?\n/);
+    return (lines[line - 1] ?? "").trim();
+}
+export function verifyWarnCitationAtLine(row, repoRoot) {
+    const citation = asString(row.citation);
+    const verifyCommand = asString(row.verify_command);
+    const parsed = parseFileLineCitation(citation);
+    if (!parsed) {
+        return { ok: true, message: "not-applicable citation skips line verification" };
+    }
+    const citedLine = readCitedLine(repoRoot, parsed.file, parsed.line);
+    if (!citedLine) {
+        return { ok: false, message: `cited line ${parsed.line} is missing or empty in ${parsed.file}` };
+    }
+    if (!verifyCommand) {
+        return { ok: false, message: "missing verify_command for file:line citation" };
+    }
+    try {
+        const output = execSync(verifyCommand, { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] })
+            .trim();
+        if (output.includes(citedLine)) {
+            return { ok: true, message: "verify_command output includes cited line text" };
+        }
+        return {
+            ok: false,
+            message: `verify_command output does not reproduce cited line ${parsed.line} in ${parsed.file}`,
+        };
+    }
+    catch (exc) {
+        return { ok: false, message: `verify_command failed: ${exc.message}` };
+    }
+}
+export function evaluatorHandoffOutputRequirements(contract) {
+    return {
+        citation_required_for: contract.citationRequiredFor,
+        warn_verify_command_required: contract.warnVerifyCommandRequired,
+        citation_formats: {
+            file_line: "path/to/file:line",
+            not_applicable: `${contract.notApplicablePrefix}<reason>`,
+        },
+        verify_command_prefixes: contract.warnVerifyCommandPrefixes,
+        report_schema_version: contract.reportSchemaVersion,
+        schema_authority: "references/cli/capability-instruction-contract.yaml#evaluator_handoff",
+    };
+}
+//# sourceMappingURL=evaluatorHandoffContract.js.map

package/dist/registries/evaluatorHandoffContract.js.map

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

package/dist/release/releaseMetadata.js

@@ -0,0 +1,235 @@
+import fs from "node:fs";
+import path from "node:path";
+import { resolvePath } from "../core/paths.js";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { loadYamlMappingFile } from "../core/yaml.js";
+export const RELEASE_METADATA_AUTHORITY_FILES = [
+    "registry.json",
+    "packages/cli/package.json",
+    "references/cli/update-channels.yaml",
+];
+export const RELEASE_METADATA_ADVISORY_FILES = [
+    "packages/cli/bundle/.agentera-npx-bundle.json",
+];
+const SEMVER_CORE_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
+const SEMVER_STRICT_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
+const PRE_RELEASE_RE = /-(.+)$/;
+const GIT_REF_HEX_RE = /^[0-9a-f]{40}$/i;
+function rootDefault() {
+    return resolveSourceRoot();
+}
+function readJson(pathname) {
+    try {
+        return JSON.parse(fs.readFileSync(pathname, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function readRegistryVersion(root) {
+    const source = "registry.json";
+    const data = readJson(path.join(root, source));
+    if (data === null) {
+        return { version: null, source };
+    }
+    const skills = data.skills;
+    if (!Array.isArray(skills) || skills.length === 0) {
+        return { version: null, source };
+    }
+    const first = skills[0];
+    if (!first || typeof first !== "object") {
+        return { version: null, source };
+    }
+    const version = first.version;
+    return { version: typeof version === "string" ? version : null, source };
+}
+function readPackageJson(root) {
+    const candidate = path.join(root, "packages/cli/package.json");
+    if (!fs.existsSync(candidate)) {
+        return null;
+    }
+    return readJson(candidate);
+}
+function readUpdateChannels(root) {
+    const candidate = path.join(root, "references/cli/update-channels.yaml");
+    if (!fs.existsSync(candidate)) {
+        return null;
+    }
+    try {
+        return loadYamlMappingFile(candidate);
+    }
+    catch {
+        return null;
+    }
+}
+function readBundleSentinel(root) {
+    const source = "packages/cli/bundle/.agentera-npx-bundle.json";
+    const candidate = path.join(root, source);
+    if (!fs.existsSync(candidate)) {
+        return { version: null, source };
+    }
+    const data = readJson(candidate);
+    if (data === null) {
+        return { version: null, source };
+    }
+    const version = data.suiteVersion;
+    return { version: typeof version === "string" ? version : null, source };
+}
+/** Parse `X.Y.Z` core (ignore pre-release and build metadata). */
+function parseSemverCore(version) {
+    const match = SEMVER_CORE_RE.exec(version);
+    if (!match) {
+        return null;
+    }
+    const core = `${match[1]}.${match[2]}.${match[3]}`;
+    const preMatch = PRE_RELEASE_RE.exec(version);
+    return { core, preRelease: preMatch ? preMatch[1] : null };
+}
+function pickChannelDefaults(authority) {
+    if (authority === null) {
+        return { development: null, stable: null };
+    }
+    const versionResolution = authority.version_resolution;
+    const latestOnChannel = versionResolution?.latest_on_channel;
+    const defaults = (latestOnChannel?.offline_defaults ?? {});
+    return {
+        development: typeof defaults.development === "string" ? defaults.development : null,
+        stable: typeof defaults.stable === "string" ? defaults.stable : null,
+    };
+}
+export function readReleaseMetadata(root = rootDefault()) {
+    const resolved = resolvePath(root);
+    const registry = readRegistryVersion(resolved);
+    const pkg = readPackageJson(resolved);
+    const channels = readUpdateChannels(resolved);
+    const bundle = readBundleSentinel(resolved);
+    const topVersion = pkg && typeof pkg.version === "string" ? pkg.version : null;
+    const agenteraBlock = pkg && typeof pkg.agentera === "object" && pkg.agentera !== null
+        ? pkg.agentera
+        : null;
+    const suiteVersion = agenteraBlock && typeof agenteraBlock.suiteVersion === "string"
+        ? agenteraBlock.suiteVersion
+        : null;
+    const gitRef = agenteraBlock && typeof agenteraBlock.gitRef === "string"
+        ? agenteraBlock.gitRef
+        : null;
+    const { development, stable } = pickChannelDefaults(channels);
+    return {
+        authoritativeVersion: registry.version,
+        authoritativeSource: registry.source,
+        packageVersion: topVersion,
+        packageSuiteVersion: suiteVersion,
+        packageGitRef: gitRef,
+        developmentChannelDefault: development,
+        stableChannelDefault: stable,
+        bundleSuiteVersion: bundle.version,
+    };
+}
+/**
+ * Validate release-metadata coherence. Returns an empty array when the
+ * source-tree version surfaces agree on a single release train.
+ */
+export function validateReleaseMetadata(root = rootDefault()) {
+    const errors = [];
+    const snap = readReleaseMetadata(root);
+    const rootLabel = path.basename(resolvePath(root)) || "repo root";
+    // 1. registry.json must publish a valid semver `skills[0].version`.
+    if (snap.authoritativeVersion === null) {
+        errors.push("registry.json: skills[0].version is required for release-metadata validation");
+    }
+    else {
+        const parsed = parseSemverCore(snap.authoritativeVersion);
+        if (parsed === null) {
+            errors.push(`registry.json: skills[0].version ${JSON.stringify(snap.authoritativeVersion)} is not a valid semver`);
+        }
+        else if (parsed.preRelease !== null) {
+            // registry.json is the suite authority and stays on the released core;
+            // pre-release suffixes belong only to packages/cli/package.json.
+            errors.push(`registry.json: skills[0].version must be a released core version (no pre-release suffix); got ${JSON.stringify(snap.authoritativeVersion)}`);
+        }
+    }
+    // 2. packages/cli/package.json must exist and parse.
+    if (snap.packageVersion === null && snap.packageSuiteVersion === null && snap.packageGitRef === null) {
+        errors.push("packages/cli/package.json: missing or unreadable; cannot validate release-metadata");
+    }
+    else {
+        // 2a. top-level `version` must be valid semver and share its core with registry.
+        if (snap.packageVersion === null) {
+            errors.push("packages/cli/package.json: top-level `version` is required");
+        }
+        else {
+            const parsed = parseSemverCore(snap.packageVersion);
+            if (parsed === null) {
+                errors.push(`packages/cli/package.json: top-level version ${JSON.stringify(snap.packageVersion)} is not a valid semver`);
+            }
+            else if (snap.authoritativeVersion !== null &&
+                parseSemverCore(snap.authoritativeVersion)?.core !== parsed.core) {
+                errors.push(`release-metadata divergence: registry.json skills[0].version core is ${JSON.stringify(parseSemverCore(snap.authoritativeVersion)?.core)} ` +
+                    `but packages/cli/package.json top-level version core is ${JSON.stringify(parsed.core)}; ` +
+                    `the npm package version must share its major.minor.patch with the registry suite version`);
+            }
+        }
+        // 2b. `agentera.suiteVersion` must match registry exactly.
+        if (snap.packageSuiteVersion === null) {
+            errors.push("packages/cli/package.json: `agentera.suiteVersion` is required");
+        }
+        else if (snap.authoritativeVersion !== null &&
+            snap.packageSuiteVersion !== snap.authoritativeVersion) {
+            errors.push(`release-metadata divergence: registry.json skills[0].version is ${JSON.stringify(snap.authoritativeVersion)} ` +
+                `but packages/cli/package.json agentera.suiteVersion is ${JSON.stringify(snap.packageSuiteVersion)}; ` +
+                `the agentera.suiteVersion mirror must equal the registry version exactly`);
+        }
+        else if (!SEMVER_STRICT_RE.test(snap.packageSuiteVersion)) {
+            errors.push(`packages/cli/package.json: agentera.suiteVersion ${JSON.stringify(snap.packageSuiteVersion)} is not a released core semver`);
+        }
+        // 2c. `agentera.gitRef` must be a 40-character hex SHA.
+        if (snap.packageGitRef === null || snap.packageGitRef === "") {
+            errors.push("packages/cli/package.json: `agentera.gitRef` is required for release-metadata validation");
+        }
+        else if (!GIT_REF_HEX_RE.test(snap.packageGitRef)) {
+            errors.push(`packages/cli/package.json: agentera.gitRef ${JSON.stringify(snap.packageGitRef)} must be a 40-character hex SHA; ` +
+                `short SHAs and branch names are not reproducible release references`);
+        }
+    }
+    // 3. update-channels.yaml development default must equal the registry version.
+    if (snap.developmentChannelDefault === null) {
+        errors.push("references/cli/update-channels.yaml: version_resolution.latest_on_channel.offline_defaults.development is required");
+    }
+    else if (snap.authoritativeVersion !== null &&
+        snap.developmentChannelDefault !== snap.authoritativeVersion) {
+        errors.push(`release-metadata divergence: registry.json skills[0].version is ${JSON.stringify(snap.authoritativeVersion)} ` +
+            `but update-channels.yaml offline_defaults.development is ${JSON.stringify(snap.developmentChannelDefault)}; ` +
+            `the development channel default must match the registry version exactly`);
+    }
+    // 4. Stable channel default is informational on the @next branch; the
+    // validator surfaces it so maintainers can confirm the stable line still
+    // resolves to its declared 2.x version. A drift on the stable channel
+    // alone is not an error here — that lane is owned by the `main` branch
+    // compatibility boundary per `references/cli/update-channels.yaml`.
+    void snap.stableChannelDefault;
+    // 5. Advisory check on the local bundle sentinel.
+    if (snap.bundleSuiteVersion !== null) {
+        if (snap.authoritativeVersion !== null &&
+            snap.bundleSuiteVersion !== snap.authoritativeVersion) {
+            errors.push(`release-metadata drift (advisory): packages/cli/bundle/.agentera-npx-bundle.json suiteVersion is ${JSON.stringify(snap.bundleSuiteVersion)} ` +
+                `but registry.json skills[0].version is ${JSON.stringify(snap.authoritativeVersion)}; ` +
+                `run \`npm run bundle:data\` (or \`pnpm -C packages/cli run bundle:data\`) at ${rootLabel} to refresh the local bundle copy before publishing`);
+        }
+    }
+    return errors;
+}
+export function releaseMetadataMain(opts = {}) {
+    const root = resolvePath(opts.root ?? rootDefault());
+    const out = opts.out ?? ((line) => process.stdout.write(line + "\n"));
+    const err = opts.err ?? ((line) => process.stderr.write(line + "\n"));
+    const errors = validateReleaseMetadata(root);
+    if (errors.length > 0) {
+        out("release-metadata validation failed:");
+        for (const message of errors)
+            out(`- ${message}`);
+        return 1;
+    }
+    out("release-metadata ok");
+    return 0;
+}
+//# sourceMappingURL=releaseMetadata.js.map

package/dist/release/releaseMetadata.js.map

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

package/dist/setup/codex/agents.js

@@ -0,0 +1,96 @@
+import fs from "node:fs";
+import path from "node:path";
+import { expanduser, isFile, pathExists } from "../../core/paths.js";
+import { CAPABILITY_AGENT_NAMES } from "./constants.js";
+export function codexAgentSourceDir(installRoot) {
+    const candidates = [
+        path.join(installRoot, "app", "skills", "agentera", "agents"),
+        path.join(installRoot, "skills", "agentera", "agents"),
+    ];
+    for (const candidate of candidates) {
+        try {
+            if (fs.statSync(candidate).isDirectory())
+                return candidate;
+        }
+        catch {
+            /* not a dir */
+        }
+    }
+    return candidates[0];
+}
+export function defaultAgentsDirForConfig(configPath) {
+    const expanded = expanduser(configPath);
+    if (path.basename(expanded) === "config.toml" && path.basename(path.dirname(expanded)) === ".codex") {
+        return path.join(path.dirname(expanded), "agents");
+    }
+    throw new Error("Codex agent descriptors can be inferred only for documented config layouts: " +
+        "~/.codex/config.toml or <project>/.codex/config.toml. " +
+        "Pass --agents-dir for nonstandard --config-file paths.");
+}
+function codexDescriptorManaged(text) {
+    const lines = text.split(/\r\n|\r|\n/).slice(0, 5);
+    return lines.some((line) => line.trim() === "# agentera_managed: true");
+}
+export function planAgentDescriptorChanges(installRoot, agentsDir, opts) {
+    const sourceDir = codexAgentSourceDir(installRoot);
+    const changes = [];
+    for (const name of CAPABILITY_AGENT_NAMES) {
+        const source = path.join(sourceDir, `${name}.toml`);
+        const target = path.join(agentsDir, `${name}.toml`);
+        let sourceText;
+        try {
+            sourceText = fs.readFileSync(source, "utf8");
+        }
+        catch {
+            changes.push({ action: "blocked", name, source, target, message: "source descriptor is missing", content: "" });
+            continue;
+        }
+        if (!pathExists(target)) {
+            changes.push({ action: "pending", name, source, target, message: "would install Codex agent descriptor", content: sourceText });
+            continue;
+        }
+        if (!isFile(target)) {
+            changes.push({ action: "blocked", name, source, target, message: "target exists but is not a regular file", content: sourceText });
+            continue;
+        }
+        let targetText;
+        try {
+            targetText = fs.readFileSync(target, "utf8");
+        }
+        catch (exc) {
+            changes.push({ action: "blocked", name, source, target, message: `cannot read target descriptor: ${exc.message}`, content: sourceText });
+            continue;
+        }
+        if (targetText === sourceText) {
+            changes.push({ action: "noop", name, source, target, message: "Codex agent descriptor is current", content: sourceText });
+        }
+        else if (opts.force || codexDescriptorManaged(targetText)) {
+            changes.push({ action: "pending", name, source, target, message: "would refresh Codex agent descriptor", content: sourceText });
+        }
+        else {
+            changes.push({
+                action: "blocked",
+                name,
+                source,
+                target,
+                message: "target exists without Agentera ownership proof; treating it as user-owned",
+                content: sourceText,
+            });
+        }
+    }
+    return changes;
+}
+export function writeAgentDescriptorChanges(changes) {
+    for (const change of changes) {
+        if (change.action !== "pending")
+            continue;
+        fs.mkdirSync(path.dirname(change.target), { recursive: true });
+        fs.writeFileSync(change.target, change.content, "utf8");
+    }
+}
+function readTextOrNull(p) {
+    if (!pathExists(p))
+        return null;
+    return fs.readFileSync(p, "utf8");
+}
+//# sourceMappingURL=agents.js.map

package/dist/setup/codex/agents.js.map

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