agentera 0.0.0 → 3.0.0-dev.0

package/dist/cli/commands/doctor.js

@@ -0,0 +1,180 @@
+import os from "node:os";
+import { expanduser, resolvePath } from "../../core/paths.js";
+import { resolveDoctorInstallRoot, resolveSourceRootStrict, } from "../../upgrade/appModel.js";
+import { APP_MANUAL_REVIEW_NEEDED, APP_MIGRATION_NEEDED, APP_OUTDATED, APP_REPAIR_NEEDED, APP_UP_TO_DATE, buildDoctorStatus, EXPECTED_STATE_COMMANDS, publicDoctorStatus, } from "../../upgrade/doctor.js";
+const PLAIN_STATUS = {
+    pending: "ready to fix",
+    applied: "fixed",
+    noop: "already OK",
+    blocked: "needs a decision",
+    failed: "failed",
+    skipped: "skipped",
+    [APP_UP_TO_DATE]: "up to date",
+    [APP_REPAIR_NEEDED]: "needs repair",
+    [APP_OUTDATED]: "outdated",
+    [APP_MIGRATION_NEEDED]: "needs migration",
+    [APP_MANUAL_REVIEW_NEEDED]: "needs manual review",
+};
+/** Commands the TS dispatcher exposes (used by the in-process CLI probe). */
+const DISPATCHER_COMMANDS = new Set([
+    "prime", "hej", "schema", "describe", "state", "query", "check", "lint", "backfill",
+    "compact", "gate", "validate", "decisions", "health", "todo", "plan", "progress",
+    "docs", "objective", "experiments",
+]);
+function plainStatus(value) {
+    return PLAIN_STATUS[value] ?? value.replace(/_/g, " ").replace(/-/g, " ");
+}
+function doctorActionNoun(status) {
+    if (status.status === APP_OUTDATED)
+        return "update";
+    if (status.status === APP_MIGRATION_NEEDED)
+        return "migration";
+    return "repair";
+}
+/** In-process probe: confirm the TS CLI exposes the expected state commands. */
+function inProcessProbe(args) {
+    const missing = args.expectedCommands.filter((name) => !DISPATCHER_COMMANDS.has(name));
+    const command = ["npx", "-y", "agentera", "--help"];
+    return {
+        ok: missing.length === 0,
+        command,
+        returnCode: 0,
+        stdoutTail: [],
+        stderrTail: [],
+        missingCommands: missing,
+        message: missing.length === 0
+            ? "CLI exposes expected state commands"
+            : "CLI is missing expected state commands",
+    };
+}
+export function renderDoctorStatus(status) {
+    const actionNoun = doctorActionNoun(status);
+    const lines = [
+        "Agentera doctor",
+        `status: ${plainStatus(status.status)}`,
+        `expected version: ${status.expectedVersion}`,
+        `Agentera directory: ${status.appHome}`,
+        `App files directory: ${status.managedAppRoot}`,
+        `Your Agentera data directory: ${status.userDataRoot}`,
+    ];
+    if (status.signals && status.signals.length > 0) {
+        lines.push("");
+        lines.push("What needs attention:");
+        for (const signal of status.signals) {
+            lines.push(`  - ${plainStatus(signal.status)}: ${signal.message}`);
+            if (signal.missingCommands && signal.missingCommands.length > 0) {
+                lines.push(`    Missing command: ${signal.missingCommands.join(", ")}`);
+            }
+        }
+    }
+    if (status.status === APP_UP_TO_DATE) {
+        lines.push("");
+        lines.push("No action needed: Agentera app files are up to date.");
+    }
+    else if (status.dryRunCommand) {
+        lines.push("");
+        lines.push("Next:");
+        lines.push(`  1. Preview the ${actionNoun}: ${status.dryRunCommand}`);
+        lines.push(`  2. If the preview looks right, apply the ${actionNoun}: ${status.applyCommand}`);
+        lines.push(`  3. Then retry Agentera: ${status.retryCommand}`);
+    }
+    else {
+        lines.push("");
+        lines.push("Next: choose a safer Agentera directory, or use `--force` only after checking the directory is safe to replace.");
+    }
+    return lines.join("\n");
+}
+export function pyJsonIndentSorted(value) {
+    return jsonIndent(value, 0);
+}
+function jsonAscii(str) {
+    let out = '"';
+    for (const ch of str) {
+        const cp = ch.codePointAt(0);
+        if (ch === '"')
+            out += '\\"';
+        else if (ch === "\\")
+            out += "\\\\";
+        else if (cp === 0x08)
+            out += "\\b";
+        else if (cp === 0x09)
+            out += "\\t";
+        else if (cp === 0x0a)
+            out += "\\n";
+        else if (cp === 0x0c)
+            out += "\\f";
+        else if (cp === 0x0d)
+            out += "\\r";
+        else if (cp < 0x20)
+            out += "\\u" + cp.toString(16).padStart(4, "0");
+        else if (cp < 0x80)
+            out += ch;
+        else if (cp > 0xffff) {
+            const v = cp - 0x10000;
+            out += "\\u" + (0xd800 + (v >> 10)).toString(16).padStart(4, "0");
+            out += "\\u" + (0xdc00 + (v & 0x3ff)).toString(16).padStart(4, "0");
+        }
+        else
+            out += "\\u" + cp.toString(16).padStart(4, "0");
+    }
+    return out + '"';
+}
+function jsonIndent(value, level) {
+    const pad = "  ".repeat(level);
+    const padIn = "  ".repeat(level + 1);
+    if (value === null || value === undefined)
+        return "null";
+    if (value === true)
+        return "true";
+    if (value === false)
+        return "false";
+    if (typeof value === "number")
+        return String(value);
+    if (typeof value === "string")
+        return jsonAscii(value);
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return "[]";
+        return "[\n" + value.map((v) => padIn + jsonIndent(v, level + 1)).join(",\n") + "\n" + pad + "]";
+    }
+    if (typeof value === "object") {
+        const keys = Object.keys(value).sort();
+        if (keys.length === 0)
+            return "{}";
+        return "{\n" + keys.map((k) => padIn + jsonAscii(k) + ": " + jsonIndent(value[k], level + 1)).join(",\n") + "\n" + pad + "}";
+    }
+    return "null";
+}
+export function cmdDoctor(args, io = {}) {
+    const out = io.out ?? ((t) => process.stdout.write(t));
+    const err = io.err ?? ((t) => process.stderr.write(t));
+    let sourceRoot;
+    try {
+        sourceRoot = resolveSourceRootStrict();
+    }
+    catch (exc) {
+        err(`doctor error: ${exc.message}\n`);
+        return 2;
+    }
+    const home = resolvePath(expanduser(args.home ?? os.homedir()));
+    const [installRoot, rootSource] = resolveDoctorInstallRoot(args.installRoot ?? null, { home, sourceRoot });
+    const expectedCommands = args.expectCommand && args.expectCommand.length > 0 ? args.expectCommand : [...EXPECTED_STATE_COMMANDS];
+    const status = buildDoctorStatus(installRoot, {
+        rootSource,
+        sourceRoot,
+        home,
+        project: resolvePath(expanduser(args.project ?? process.cwd())),
+        expectedVersion: args.expectedVersion ?? null,
+        expectedCommands,
+        probeCli: true,
+        probeRunner: inProcessProbe,
+    });
+    if ((args.format ?? "text") === "json") {
+        out(pyJsonIndentSorted(publicDoctorStatus(status)) + "\n");
+    }
+    else {
+        out(renderDoctorStatus(status) + "\n");
+    }
+    return status.status === APP_UP_TO_DATE ? 0 : 1;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

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

package/dist/cli/commands/lint.js

@@ -0,0 +1,179 @@
+import fs from "node:fs";
+import { checkAbstraction, checkFiller, checkFullFileVerbosity, checkVerbosity, } from "../../validate/selfAudit.js";
+import { artifactPath, discoverSchemasDir, loadSchemas } from "../appContext.js";
+import { pathStem, validateAgentString } from "../argvalidate.js";
+import { emitStructured } from "../structured.js";
+/** Port of scripts/agentera `cmd_lint` and its `_lint_*` helpers. */
+const LINT_CHECKS = [
+    ["verbosity", "Shorten the entry or split it into smaller concrete entries."],
+    ["abstraction", "Add a concrete anchor such as a path, line number, metric, command, identifier, or quote."],
+    ["filler", "Remove the named filler phrase category before writing the artifact."],
+];
+const LINT_CANONICAL_LABELS = {
+    changelog: "CHANGELOG.md",
+    decisions: "DECISIONS.md",
+    design: "DESIGN.md",
+    docs: "DOCS.md",
+    health: "HEALTH.md",
+    plan: "PLAN.md",
+    progress: "PROGRESS.md",
+    todo: "TODO.md",
+    vision: "VISION.md",
+    experiments: "EXPERIMENTS.md",
+};
+const VALIDATE_ARTIFACT_LABELS = [
+    "CHANGELOG.md",
+    "DECISIONS.md",
+    "DESIGN.md",
+    "DOCS.md",
+    "HEALTH.md",
+    "PLAN.md",
+    "PROGRESS.md",
+    "TODO.md",
+    "VISION.md",
+];
+function lintSchemaName(artifact, schemas) {
+    if (artifact in schemas)
+        return artifact;
+    const lowered = artifact.toLowerCase();
+    if (lowered in schemas)
+        return lowered;
+    for (const [name, info] of Object.entries(schemas)) {
+        const record = info.record;
+        if (record && record.displayName === artifact)
+            return name;
+    }
+    const stem = pathStem(artifact).toLowerCase();
+    if (stem in schemas)
+        return stem;
+    return null;
+}
+function lintCanonicalLabel(schemaName, info, artifact) {
+    if (schemaName in LINT_CANONICAL_LABELS)
+        return LINT_CANONICAL_LABELS[schemaName];
+    const record = info.record;
+    if (record && record.displayName)
+        return record.displayName;
+    if (VALIDATE_ARTIFACT_LABELS.includes(artifact))
+        return artifact;
+    const upper = artifact.trim().toUpperCase();
+    if (VALIDATE_ARTIFACT_LABELS.includes(upper))
+        return upper;
+    return artifact;
+}
+function resolveLintArtifactFile(artifact) {
+    const schemas = loadSchemas(discoverSchemasDir());
+    const schemaName = lintSchemaName(artifact, schemas);
+    if (schemaName === null) {
+        const validLabels = VALIDATE_ARTIFACT_LABELS.join(", ");
+        throw new Error(`unsupported artifact ${pyRepr(artifact)}; provide --file or --text, ` +
+            "or use a schema name from `agentera query --list-artifacts` " +
+            `or a canonical label (${validLabels})`);
+    }
+    const info = schemas[schemaName];
+    const p = artifactPath(info, schemaName);
+    const canonical = lintCanonicalLabel(schemaName, info, artifact);
+    return [p, canonical];
+}
+function pyRepr(value) {
+    return value.includes("'") && !value.includes('"') ? `"${value}"` : `'${value}'`;
+}
+/** [text, source, fullArtifact, budgetArtifact]. */
+function lintInputText(args) {
+    if (args.text !== undefined && args.text !== null) {
+        return [String(args.text), "text", false, null];
+    }
+    if (args.file !== undefined && args.file !== null) {
+        const p = String(args.file);
+        try {
+            return [fs.readFileSync(p, "utf8"), p, true, null];
+        }
+        catch (exc) {
+            throw new Error(`could not read lint file ${p}: ${exc.message}`);
+        }
+    }
+    const artifact = String(args.artifact);
+    const [p, canonical] = resolveLintArtifactFile(artifact);
+    if (isFileSafe(p)) {
+        try {
+            return [fs.readFileSync(p, "utf8"), p, true, canonical];
+        }
+        catch (exc) {
+            throw new Error(`could not read lint file ${p}: ${exc.message}`);
+        }
+    }
+    throw new Error(`lint requires --text, --file, or piped stdin; artifact file ${p} does not exist`);
+}
+function isFileSafe(p) {
+    try {
+        return fs.statSync(p).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function lintChecks(text, artifact, fullArtifact) {
+    const verbosityCheck = fullArtifact ? checkFullFileVerbosity(text, artifact) : checkVerbosity(text, artifact);
+    const raw = {
+        verbosity: verbosityCheck,
+        abstraction: checkAbstraction(text),
+        filler: checkFiller(text),
+    };
+    const actions = Object.fromEntries(LINT_CHECKS);
+    const checks = [];
+    for (const [name] of LINT_CHECKS) {
+        const [passed, detail] = raw[name];
+        checks.push({
+            name,
+            status: passed ? "pass" : "fail",
+            detail,
+            action: passed ? "" : actions[name],
+        });
+    }
+    return checks;
+}
+export function lintPayload(args) {
+    const [text, source, fullArtifact, budgetArtifact] = lintInputText(args);
+    const artifact = budgetArtifact || String(args.artifact);
+    validateAgentString(artifact, "artifact");
+    const checks = lintChecks(text, artifact, fullArtifact);
+    const failures = checks.filter((c) => c.status === "fail");
+    return {
+        command: "lint",
+        status: failures.length > 0 ? "fail" : "pass",
+        artifact,
+        source,
+        strict: Boolean(args.strict),
+        checks,
+        summary: {
+            failed: failures.length,
+            passed: checks.length - failures.length,
+            advisory: !args.strict,
+        },
+    };
+}
+function emitLintText(payload, out) {
+    const failures = payload.checks.filter((c) => c.status === "fail");
+    out(`lint ${payload.status}: ${payload.artifact} (${payload.source})\n`);
+    if (failures.length === 0) {
+        out("all self-audit checks passed\n");
+        return;
+    }
+    out(`${failures.length} issue(s); advisory by default, use --strict to fail on issues\n`);
+    for (const check of failures) {
+        out(`- ${check.name}: ${check.detail}\n`);
+        out(`  action: ${check.action}\n`);
+    }
+}
+export function cmdLint(args, io = {}) {
+    const out = io.out ?? ((t) => process.stdout.write(t));
+    const payload = lintPayload(args);
+    if ((args.format ?? "text") === "json") {
+        emitStructured(payload, "json", out);
+    }
+    else {
+        emitLintText(payload, out);
+    }
+    return payload.status === "fail" ? 1 : 0;
+}
+//# sourceMappingURL=lint.js.map

package/dist/cli/commands/lint.js.map

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