agentera 3.0.0-dev.22 → 3.0.0-dev.25

package/dist/state/progressEntities.js

@@ -0,0 +1,382 @@
+import { createHash, createHmac, timingSafeEqual } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { loadYamlMapping } from "../core/yaml.js";
+import { canonicalRecordJson } from "./archiveDiscovery.js";
+import { StateRetrievalFailure } from "./directRetrieval.js";
+import { allocateAndPublishEntity, allocateEntityId, discoverEntities, publishEntity, } from "./entityStorage.js";
+import { localTimestamp } from "./write/assign.js";
+const ARTIFACT = "progress";
+const BOUNDARY = "progress_cycle";
+const ORDER = "timestamp_desc_then_id_asc";
+const CURSOR_VERSION = 1;
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function positive(value, field) {
+    const number = Number(value);
+    if (!Number.isSafeInteger(number) || number < 1)
+        throw new Error(`invalid progress entity ${field} in state storage authority`);
+    return number;
+}
+function progressContract(sourceRoot = resolveSourceRoot()) {
+    const authorityPath = path.join(sourceRoot, "references", "artifacts", "state-storage-authority.yaml");
+    const authority = loadYamlMapping(fs.readFileSync(authorityPath, "utf8"));
+    const target = authority.entity_target;
+    const storage = mapping(target) && mapping(target.storage_boundary)
+        ? target.storage_boundary.shared_primitives
+        : null;
+    const entities = mapping(target) && Array.isArray(target.entities) ? target.entities : [];
+    const progress = entities.find((entity) => mapping(entity) && entity.boundary === BOUNDARY && entity.artifact === ARTIFACT);
+    const retrieval = mapping(progress) ? progress.retrieval : null;
+    if (!mapping(storage) || typeof storage.canonical_root !== "string" || !mapping(retrieval)) {
+        throw new Error(`invalid progress entity contract in '${authorityPath}'`);
+    }
+    return {
+        authorityPath,
+        entityRoot: storage.canonical_root,
+        defaultLimit: positive(retrieval.default_limit, "default_limit"),
+        maximumLimit: positive(retrieval.maximum_limit, "maximum_limit"),
+        maxUtf8Bytes: positive(retrieval.max_utf8_bytes, "max_utf8_bytes"),
+    };
+}
+function failure(className, message, recovery, id, exitCode = 1) {
+    return new StateRetrievalFailure({
+        schemaVersion: "agentera.stateFailure.v1",
+        status: "fail",
+        error: {
+            class: className,
+            message,
+            syntax: "agentera state progress get --id ID --format json",
+            example: `agentera state progress get --id ${id ?? "qjtrmnpvka"} --format json`,
+            recovery,
+            artifact: ARTIFACT,
+            ...(id ? { id } : {}),
+        },
+    }, exitCode);
+}
+function listFailure(className, message, recovery, exitCode = 1) {
+    const result = failure(className, message, recovery, undefined, exitCode);
+    result.body.error.syntax =
+        "agentera state progress list [--limit N] [--cursor TOKEN] --format json";
+    result.body.error.example = "agentera state progress list --limit 20 --format json";
+    return result;
+}
+function progressRecord(values) {
+    const context = mapping(values.context) ? values.context : {};
+    const record = {
+        timestamp: typeof values.timestamp === "string" ? values.timestamp : localTimestamp(),
+        type: String(values.type ?? ""),
+        phase: String(values.phase ?? ""),
+        what: String(values.what ?? ""),
+        context: { intent: String(context.intent ?? "") },
+    };
+    for (const field of ["inspiration", "discovered", "verified", "next"]) {
+        if (typeof values[field] === "string")
+            record[field] = values[field];
+    }
+    for (const field of ["constraints", "unknowns", "scope"]) {
+        if (typeof context[field] === "string")
+            record.context[field] = context[field];
+    }
+    if (!/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/.test(String(record.timestamp)))
+        throw new Error("progress entity timestamp must use YYYY-MM-DD HH:MM");
+    if (!record.type || !record.phase || !record.what || !record.context.intent)
+        throw new Error("progress entity requires type, phase, what, and context.intent");
+    return record;
+}
+function relative(projectRoot, candidate) {
+    return path.relative(path.resolve(projectRoot), candidate).split(path.sep).join("/");
+}
+export function appendProgressEntity(req, options = {}) {
+    const sourceRoot = options.sourceRoot ?? resolveSourceRoot();
+    const contract = progressContract(sourceRoot);
+    const record = progressRecord(req.values);
+    if (req.dryRun) {
+        options.publicationContext?.assertValid();
+        const allocationRoot = options.publicationContext?.pinnedPath() ?? req.projectRoot;
+        const id = options.id ?? allocateEntityId(allocationRoot, options.candidate, sourceRoot);
+        const target = path.join(path.resolve(req.projectRoot), contract.entityRoot, ARTIFACT, BOUNDARY, `${id}.yaml`);
+        options.publicationContext?.assertValid();
+        return {
+            schemaVersion: "agentera.stateWrite.v1",
+            command: "state progress append",
+            status: "pass",
+            path: target,
+            id,
+            artifact: ARTIFACT,
+            record,
+            operation: { verb: "append", dry_run: true, idempotent_replay: false },
+            validation: { status: "pass", violations: [] },
+        };
+    }
+    const published = options.id
+        ? publishEntity({
+            projectRoot: req.projectRoot,
+            sourceRoot,
+            publicationContext: options.publicationContext,
+            artifact: ARTIFACT,
+            boundary: BOUNDARY,
+            id: options.id,
+            record,
+        })
+        : allocateAndPublishEntity({
+            projectRoot: req.projectRoot,
+            sourceRoot,
+            publicationContext: options.publicationContext,
+            artifact: ARTIFACT,
+            boundary: BOUNDARY,
+            record,
+        }, options.candidate);
+    return {
+        schemaVersion: "agentera.stateWrite.v1",
+        command: "state progress append",
+        status: "pass",
+        path: published.path,
+        id: published.id,
+        artifact: published.artifact,
+        record,
+        operation: { verb: "append", dry_run: false, idempotent_replay: published.replay },
+        validation: { status: "pass", violations: [] },
+    };
+}
+function sortKey(entity) {
+    return `${String(entity.record?.timestamp ?? "")}\0${entity.id}`;
+}
+function sortedProgress(discovery) {
+    const progress = discovery.entities.filter((entity) => entity.boundary === BOUNDARY || entity.artifact === ARTIFACT);
+    const duplicate = progress.find((entity) => entity.classification === "duplicate");
+    if (duplicate)
+        throw listFailure("ambiguous", `progress entity ID '${duplicate.id}' has multiple canonical candidates`, "Run agentera check validate state, assign unique IDs, and retry.");
+    const corrupt = progress.find((entity) => entity.classification !== "valid" ||
+        !entity.id ||
+        !entity.record ||
+        typeof entity.record.timestamp !== "string");
+    if (corrupt)
+        throw listFailure("corrupt", `progress entity '${corrupt.relativePath}' is corrupt or violates the progress record contract`, "Run agentera check validate state, repair the canonical entity file, and retry.");
+    return progress.sort((left, right) => String(right.record.timestamp).localeCompare(String(left.record.timestamp)) ||
+        left.id.localeCompare(right.id));
+}
+function entry(projectRoot, entity) {
+    const id = entity.id;
+    return {
+        id,
+        artifact: ARTIFACT,
+        record: entity.record,
+        provenance: {
+            storage: "canonical_entity_file",
+            path: relative(projectRoot, entity.path),
+            boundary: BOUNDARY,
+            detail: "full",
+        },
+        retrieval: { get: `agentera state progress get --id ${id} --format json` },
+    };
+}
+function snapshotId(entities) {
+    const source = entities.map((entity) => ({
+        id: entity.id,
+        artifact: entity.artifact,
+        record: entity.record,
+    }));
+    return createHash("sha256").update(canonicalRecordJson(source), "utf8").digest("hex");
+}
+function cursorKey(projectRoot, authorityPath) {
+    return createHash("sha256")
+        .update(path.resolve(projectRoot))
+        .update("\0")
+        .update(fs.readFileSync(authorityPath))
+        .digest();
+}
+function encodeCursor(payload, projectRoot, authorityPath) {
+    const bytes = Buffer.from(canonicalRecordJson(payload), "utf8");
+    const signature = createHmac("sha256", cursorKey(projectRoot, authorityPath))
+        .update(bytes)
+        .digest();
+    return `${bytes.toString("base64url")}.${signature.toString("base64url")}`;
+}
+function decodeCursor(token, projectRoot, authorityPath) {
+    const [encoded, signed, extra] = token.split(".");
+    if (!encoded || !signed || extra)
+        throw listFailure("cursor_invalid", "progress cursor is malformed", "Copy next_cursor exactly, or omit --cursor to start from the current snapshot.");
+    let bytes;
+    let signature;
+    try {
+        bytes = Buffer.from(encoded, "base64url");
+        signature = Buffer.from(signed, "base64url");
+    }
+    catch {
+        throw listFailure("cursor_invalid", "progress cursor is malformed", "Copy next_cursor exactly, or omit --cursor to start from the current snapshot.");
+    }
+    const expected = createHmac("sha256", cursorKey(projectRoot, authorityPath))
+        .update(bytes)
+        .digest();
+    if (signature.length !== expected.length || !timingSafeEqual(signature, expected))
+        throw listFailure("cursor_invalid", "progress cursor signature is invalid", "Copy next_cursor exactly, or omit --cursor to start from the current snapshot.");
+    let payload;
+    try {
+        payload = JSON.parse(bytes.toString("utf8"));
+    }
+    catch {
+        payload = null;
+    }
+    if (!mapping(payload) ||
+        payload.version !== CURSOR_VERSION ||
+        payload.artifact !== ARTIFACT ||
+        payload.order !== ORDER ||
+        !mapping(payload.filters) ||
+        typeof payload.snapshot_id !== "string" ||
+        typeof payload.after_key !== "string") {
+        throw listFailure("cursor_invalid", "progress cursor does not match the progress entity list contract", "Omit --cursor to establish a new snapshot.");
+    }
+    return payload;
+}
+function values(value) {
+    if (typeof value === "string")
+        return [value];
+    if (Array.isArray(value))
+        return value.flatMap(values);
+    if (mapping(value))
+        return Object.entries(value).flatMap(([key, child]) => [key, ...values(child)]);
+    return [];
+}
+function filtersObject(filters) {
+    return { topic: filters.topic ?? null, status: filters.status ?? null };
+}
+function serializedBytes(value, format) {
+    const text = format === "json" ? JSON.stringify(value, null, 2) + "\n" : YAML.stringify(value);
+    return Buffer.byteLength(text, "utf8");
+}
+export function getProgressEntity(projectRoot, id, sourceRoot = resolveSourceRoot()) {
+    if (!/^[a-z]{10}$/.test(id))
+        throw failure("invalid_request", `progress ID '${id}' must be ten lowercase letters`, "Use the bare ID returned by progress append or list.", id, 2);
+    const discovery = discoverEntities(projectRoot, sourceRoot);
+    const matches = discovery.entities.filter((entity) => entity.id === id);
+    if (matches.length > 1 || matches.some((entity) => entity.classification === "duplicate"))
+        throw failure("ambiguous", `progress entity ID '${id}' has multiple canonical candidates`, "Run agentera check validate state, assign unique IDs, and retry.", id);
+    const selected = matches[0];
+    const expectedPath = path.join(path.resolve(projectRoot), progressContract(sourceRoot).entityRoot, ARTIFACT, BOUNDARY, `${id}.yaml`);
+    const corruptAtCanonicalPath = discovery.entities.find((entity) => entity.path === expectedPath);
+    if (!selected && corruptAtCanonicalPath)
+        throw failure("corrupt", `progress entity '${corruptAtCanonicalPath.relativePath}' does not match its canonical ID envelope`, "Run agentera check validate state, repair the canonical entity file, and retry.", id);
+    if (!selected || selected.artifact !== ARTIFACT || selected.boundary !== BOUNDARY)
+        throw failure("not_found", `no progress entity exists with ID '${id}'`, "Copy an ID from agentera state progress list --format json and retry.", id);
+    if (selected.classification !== "valid" ||
+        !selected.record ||
+        typeof selected.record.timestamp !== "string")
+        throw failure("corrupt", `progress entity '${selected.relativePath}' is corrupt or violates the progress record contract`, "Run agentera check validate state, repair the canonical entity file, and retry.", id);
+    return {
+        schemaVersion: "agentera.stateRetrieval.v1",
+        command: "state progress get",
+        status: "ok",
+        entry: entry(projectRoot, selected),
+        source: { artifact: ARTIFACT, authority: "canonical_entity_file" },
+        source_contract: {
+            authority: "references/artifacts/state-storage-authority.yaml",
+            detail: "full",
+        },
+    };
+}
+export function listProgressEntities(projectRoot, limit, filters = {}, cursor, options = {}) {
+    const sourceRoot = options.sourceRoot ?? resolveSourceRoot();
+    const contract = progressContract(sourceRoot);
+    const effectiveLimit = limit ?? contract.defaultLimit;
+    if (!Number.isSafeInteger(effectiveLimit) ||
+        effectiveLimit < 1 ||
+        effectiveLimit > contract.maximumLimit) {
+        throw listFailure("invalid_request", `--limit must be between 1 and ${contract.maximumLimit}`, `Use --limit ${contract.defaultLimit} or another value in the declared range.`, 2);
+    }
+    const all = sortedProgress(discoverEntities(projectRoot, sourceRoot));
+    const snapshot = snapshotId(all);
+    const filterState = filtersObject(filters);
+    let afterKey = "";
+    if (cursor) {
+        const parsed = decodeCursor(cursor, projectRoot, contract.authorityPath);
+        if (canonicalRecordJson(parsed.filters) !== canonicalRecordJson(filterState))
+            throw listFailure("cursor_invalid", "progress cursor filters do not match this request", "Repeat the original filters or omit --cursor to establish a new snapshot.");
+        if (parsed.snapshot_id !== snapshot)
+            throw listFailure("cursor_snapshot_unavailable", "progress entity source changed after this cursor snapshot", "Omit --cursor to restart from the current canonical entity snapshot.");
+        afterKey = parsed.after_key;
+    }
+    const filtered = all.filter((entity) => {
+        if (filters.status &&
+            String(entity.record.type).toLowerCase() !== filters.status.toLowerCase())
+            return false;
+        return (!filters.topic ||
+            values(entity.record).some((value) => value.toLowerCase().includes(filters.topic.toLowerCase())));
+    });
+    const start = afterKey ? filtered.findIndex((entity) => sortKey(entity) === afterKey) + 1 : 0;
+    if (afterKey && start === 0)
+        throw listFailure("cursor_snapshot_unavailable", "progress cursor continuation no longer exists in the canonical snapshot", "Omit --cursor to restart from the current canonical entity snapshot.");
+    let selected = filtered.slice(start, start + effectiveLimit);
+    let byteTrimmed = false;
+    const makeResponse = () => {
+        const remaining = filtered.length - start - selected.length;
+        const nextCursor = remaining > 0 && selected.length > 0
+            ? encodeCursor({
+                version: CURSOR_VERSION,
+                artifact: ARTIFACT,
+                order: ORDER,
+                filters: filterState,
+                snapshot_id: snapshot,
+                after_key: sortKey(selected.at(-1)),
+            }, projectRoot, contract.authorityPath)
+            : undefined;
+        const filterFlags = [
+            ...(filters.topic ? ["--topic", JSON.stringify(filters.topic)] : []),
+            ...(filters.status ? ["--status", JSON.stringify(filters.status)] : []),
+        ].join(" ");
+        return {
+            schemaVersion: "agentera.stateList.v1",
+            command: "state progress list",
+            status: remaining > 0 ? "degraded" : "ok",
+            entries: selected.map((entity) => entry(projectRoot, entity)),
+            counts: { total: filtered.length, returned: selected.length, remaining },
+            filters: filterState,
+            snapshot: {
+                id: snapshot,
+                first_page: !cursor,
+                order: ORDER,
+                has_more: remaining > 0,
+                candidate_count: filtered.length,
+            },
+            source: {
+                artifact: ARTIFACT,
+                authority: "canonical_entity_files",
+                root: contract.entityRoot,
+            },
+            source_contract: {
+                authority: "references/artifacts/state-storage-authority.yaml",
+                detail: "full",
+                cursor: "opaque_snapshot_cursor",
+            },
+            ...(remaining > 0
+                ? {
+                    omitted: true,
+                    omitted_count: remaining,
+                    omission_reason: byteTrimmed ? "serialized_byte_budget" : "page_limit",
+                    retrieval: {
+                        continue: `agentera state progress list --limit ${effectiveLimit}${filterFlags ? ` ${filterFlags}` : ""} --cursor ${nextCursor} --format json`,
+                        get: "agentera state progress get --id ID --format json",
+                    },
+                    next_cursor: nextCursor,
+                }
+                : {}),
+        };
+    };
+    const format = options.format ?? "json";
+    let response = makeResponse();
+    while (serializedBytes(response, format) > contract.maxUtf8Bytes && selected.length > 0) {
+        selected = selected.slice(0, -1);
+        byteTrimmed = true;
+        response = makeResponse();
+    }
+    if (selected.length === 0 && filtered.length > start)
+        throw listFailure("unsupported_state", `one full progress entity cannot fit the ${contract.maxUtf8Bytes}-byte list budget`, "Use exact get by ID for the full canonical entity, or reduce the entity scalar size before retrying.");
+    return response;
+}
+export function renderProgressEntityListText(response) {
+    return YAML.stringify(response);
+}
+//# sourceMappingURL=progressEntities.js.map

package/dist/state/progressEntities.js.map

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

package/dist/state/projectRoot.js

@@ -0,0 +1,63 @@
+import fs from "node:fs";
+import path from "node:path";
+function directoryPrefixes(absolute) {
+    const parsed = path.parse(absolute);
+    const segments = absolute.slice(parsed.root.length).split(path.sep).filter(Boolean);
+    return [parsed.root, ...segments.map((_, index) => path.join(parsed.root, ...segments.slice(0, index + 1)))];
+}
+export function assertValidatedProjectRoot(root) {
+    const stable = root.identities.every((identity) => {
+        try {
+            const current = fs.lstatSync(identity.absolute, { bigint: true });
+            return identity.type === "directory"
+                && current.isDirectory()
+                && !current.isSymbolicLink()
+                && current.dev === identity.dev
+                && current.ino === identity.ino;
+        }
+        catch {
+            return false;
+        }
+    });
+    if (!stable) {
+        throw new Error(`project root '${root.path}' changed after validation; restore the exact real directory and retry`);
+    }
+}
+export function validateRealProjectRoot(projectRoot) {
+    const root = path.resolve(projectRoot);
+    let stat;
+    try {
+        stat = fs.lstatSync(root, { bigint: true });
+    }
+    catch {
+        throw new Error(`project root '${root}' does not exist; choose an existing, real directory and retry`);
+    }
+    if (stat.isSymbolicLink()) {
+        throw new Error(`project root '${root}' is a symbolic link; choose an existing, real directory and retry`);
+    }
+    if (!stat.isDirectory()) {
+        throw new Error(`project root '${root}' is not a directory; choose an existing, real directory and retry`);
+    }
+    try {
+        if (fs.realpathSync(root) !== root) {
+            throw new Error(`project root '${root}' traverses a symbolic link; choose an existing, real directory and retry`);
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.startsWith("project root '"))
+            throw error;
+        throw new Error(`project root '${root}' cannot be resolved safely; choose an existing, real directory and retry`);
+    }
+    const identities = directoryPrefixes(root).map((absolute) => {
+        const current = fs.lstatSync(absolute, { bigint: true });
+        return { absolute, dev: current.dev, ino: current.ino, type: "directory" };
+    });
+    const validated = { path: root, identities };
+    const rootIdentity = identities.at(-1);
+    if (rootIdentity.dev !== stat.dev || rootIdentity.ino !== stat.ino) {
+        throw new Error(`project root '${root}' changed during validation; restore the exact real directory and retry`);
+    }
+    assertValidatedProjectRoot(validated);
+    return validated;
+}
+//# sourceMappingURL=projectRoot.js.map

package/dist/state/projectRoot.js.map

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