agentera 3.0.0-dev.3 → 3.0.0-dev.31

package/dist/state/stateMode.js

@@ -0,0 +1,83 @@
+import fs from "node:fs";
+import path from "node:path";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { loadYamlMapping } from "../core/yaml.js";
+import { EntityPublicationContext } from "./entityPublicationContext.js";
+import { validateRealProjectRoot } from "./projectRoot.js";
+import { readProjectFileSnapshot } from "./safeProjectFile.js";
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function contract(sourceRoot = resolveSourceRoot()) {
+    const authorityPath = path.join(sourceRoot, "references", "artifacts", "state-storage-authority.yaml");
+    const authority = loadYamlMapping(fs.readFileSync(authorityPath, "utf8"));
+    const migration = authority.entity_migration;
+    const marker = mapping(migration) ? migration.cutover_marker : null;
+    const entityMode = mapping(marker) ? marker.entity_mode : null;
+    if (!mapping(marker) ||
+        typeof marker.path !== "string" ||
+        typeof marker.schema_version !== "string" ||
+        !mapping(entityMode) ||
+        typeof entityMode.mode !== "string") {
+        throw new Error(`state storage authority '${authorityPath}' has no executable cutover marker contract`);
+    }
+    if (path.isAbsolute(marker.path) || marker.path.split(/[\\/]/).includes("..")) {
+        throw new Error(`state storage authority declares unsafe cutover marker path '${marker.path}'`);
+    }
+    return { markerPath: marker.path, schemaVersion: marker.schema_version, mode: entityMode.mode };
+}
+function readStableMarker(root, markerPath) {
+    const snapshot = readProjectFileSnapshot(root, markerPath);
+    if (snapshot.kind === "missing") {
+        if (path.resolve(snapshot.absolute) === root.path) {
+            throw new Error(`project root '${root.path}' changed while the state mode marker was inspected; restore the real directory and retry`);
+        }
+        return null;
+    }
+    if (snapshot.kind === "unsafe") {
+        const detail = snapshot.reason === "type"
+            ? "is not a regular file"
+            : snapshot.reason === "symlink"
+                ? "has an unsafe path"
+                : "changed or became unsafe while being read";
+        throw new Error(`state mode marker '${markerPath}' ${detail}; restore a stable project-local marker and retry`);
+    }
+    return snapshot.bytes;
+}
+/** Read the authority-owned cutover marker without creating or repairing state. */
+export function detectStateModeBinding(projectRoot, sourceRoot = resolveSourceRoot()) {
+    const root = validateRealProjectRoot(projectRoot);
+    const declared = contract(sourceRoot);
+    const bytes = readStableMarker(root, declared.markerPath);
+    if (bytes === null)
+        return { mode: "legacy", root };
+    let document;
+    try {
+        document = loadYamlMapping(bytes.toString("utf8"));
+    }
+    catch (error) {
+        throw new Error(`state mode marker '${declared.markerPath}' is corrupt: ${error.message}; restore the durable migration marker before retrying`);
+    }
+    if (document.schemaVersion !== declared.schemaVersion || document.mode !== declared.mode) {
+        throw new Error(`state mode marker '${declared.markerPath}' must declare schemaVersion '${declared.schemaVersion}' and mode '${declared.mode}'; restore the durable migration marker before retrying`);
+    }
+    return {
+        mode: "entities",
+        root,
+        publicationContext: EntityPublicationContext.open(root, declared.markerPath, bytes),
+    };
+}
+export function detectStateMode(projectRoot, sourceRoot = resolveSourceRoot()) {
+    const binding = detectStateModeBinding(projectRoot, sourceRoot);
+    if (binding.mode === "entities")
+        binding.publicationContext.close();
+    return binding.mode;
+}
+export function requireEntityStateBinding(projectRoot, sourceRoot = resolveSourceRoot()) {
+    const binding = detectStateModeBinding(projectRoot, sourceRoot);
+    if (binding.mode === "legacy") {
+        throw new Error("state writes require the durable entity-state marker; legacy aggregates are read-only migration input");
+    }
+    return binding;
+}
+//# sourceMappingURL=stateMode.js.map

package/dist/state/stateMode.js.map

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

package/dist/state/summaryEntityRead.js

@@ -0,0 +1,26 @@
+export function isSummaryEntity(entity) {
+    return entity.boundary === "progress_summary" || entity.boundary === "decision_summary" || entity.boundary === "health_summary";
+}
+export function summaryCaveat(artifact) {
+    return `${artifact} summary is immutable migrated history: incomplete historical evidence is read-only and full record detail is unavailable.`;
+}
+export function detailMetadata(entity) {
+    const summary = isSummaryEntity(entity);
+    return {
+        boundary: entity.boundary,
+        detail_availability: summary ? "summary" : "full",
+        compatibility: summary ? "degraded" : "current",
+        ...(summary ? { caveats: [summaryCaveat(entity.artifact)] } : {}),
+    };
+}
+export function detailProvenance(projectRelativePath, entity) {
+    const summary = isSummaryEntity(entity);
+    return {
+        storage: "canonical_entity_file",
+        path: projectRelativePath,
+        boundary: entity.boundary,
+        detail: summary ? "summary" : "full",
+        ...(summary ? { migration_provenance: entity.record.migration_provenance } : {}),
+    };
+}
+//# sourceMappingURL=summaryEntityRead.js.map

package/dist/state/summaryEntityRead.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summaryEntityRead.js","sourceRoot":"","sources":["../../../../../home/jgabor/git/agentera/packages/cli/src/state/summaryEntityRead.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,eAAe,CAAC,MAAwB;IACtD,OAAO,MAAM,CAAC,QAAQ,KAAK,kBAAkB,IAAI,MAAM,CAAC,QAAQ,KAAK,kBAAkB,IAAI,MAAM,CAAC,QAAQ,KAAK,gBAAgB,CAAC;AAClI,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,OAAO,GAAG,QAAQ,4HAA4H,CAAC;AACjJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAwB;IACrD,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAS;QAC1B,mBAAmB,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;QACjD,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QAC/C,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,QAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,mBAA2B,EAAE,MAAwB;IACpF,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO;QACL,OAAO,EAAE,uBAAuB;QAChC,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAS;QAC1B,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM;QACpC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,MAAM,CAAC,MAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClF,CAAC;AACJ,CAAC"}

package/dist/state/summaryMigrationProvenance.js

@@ -0,0 +1,67 @@
+import { createHash } from "node:crypto";
+import { loadYamlMapping } from "../core/yaml.js";
+import { canonicalRecordJson } from "./archiveDiscovery.js";
+import { canonicalMigrationRecord } from "./canonicalMigrationRecord.js";
+import { legacySummaryRecord } from "./legacySummaryRecord.js";
+import { readBoundMigrationSource } from "./migrationSourceBinding.js";
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+export function summaryMigrationProvenanceDeclaration(value, authorityPath) {
+    if (!Array.isArray(value.sources))
+        throw new Error(`invalid summary migration provenance sources declaration in '${authorityPath}'`);
+    return { sources: value.sources.map((source) => {
+            if (!mapping(source) || typeof source.path !== "string" || !Array.isArray(source.collections) || !source.collections.every((collection) => typeof collection === "string")) {
+                throw new Error(`invalid summary migration provenance source declaration in '${authorityPath}'`);
+            }
+            return { path: source.path, collections: source.collections };
+        }) };
+}
+/** Bind a degraded summary to one declared legacy source record, without reopening arbitrary project paths. */
+export function summaryMigrationProvenanceViolations(boundary, record, declaration, forbiddenAliases, binding) {
+    const provenance = record.migration_provenance;
+    if (!mapping(provenance))
+        return ["migration_provenance must be a mapping"];
+    if (canonicalRecordJson(Object.keys(provenance).sort()) !== canonicalRecordJson(["source_path", "source_record_sha256"])) {
+        return ["migration_provenance must contain exactly source_path and source_record_sha256"];
+    }
+    if (typeof record.summary !== "string")
+        return ["summary must be a string"];
+    const sourcePath = provenance.source_path;
+    const sourceDigest = provenance.source_record_sha256;
+    const declaredSource = typeof sourcePath === "string" ? declaration.sources.find((source) => source.path === sourcePath) : undefined;
+    if (!declaredSource)
+        return ["migration_provenance.source_path must be an authority-declared preserved aggregate path"];
+    if (typeof sourceDigest !== "string" || !/^[a-f0-9]{64}$/.test(sourceDigest))
+        return ["migration_provenance.source_record_sha256 must be a lowercase SHA-256 digest"];
+    if (binding === undefined)
+        return ["migration_provenance requires a source binding context for a compacted summary"];
+    const source = readBoundMigrationSource(binding, declaredSource.path);
+    if (source.kind !== "file")
+        return [`migration_provenance source '${declaredSource.path}' is ${source.kind === "missing" ? "missing" : `unsafe (${source.reason})`}`];
+    let document;
+    try {
+        document = loadYamlMapping(source.bytes);
+    }
+    catch (error) {
+        return [`migration_provenance source '${declaredSource.path}' is invalid YAML: ${error.message}`];
+    }
+    const retained = structuredClone(record);
+    delete retained.migration_provenance;
+    const candidates = declaredSource.collections.flatMap((collection) => {
+        const rows = document[collection];
+        return Array.isArray(rows) ? rows.flatMap((physical) => {
+            const candidate = legacySummaryRecord(physical);
+            return candidate ? [{ physical, candidate }] : [];
+        }) : [];
+    }).filter(({ physical, candidate }) => (typeof candidate.summary === "string" || candidate.detail_availability === "summary_only")
+        && createHash("sha256").update(canonicalRecordJson(physical)).digest("hex") === sourceDigest
+        && canonicalRecordJson(canonicalMigrationRecord(boundary, candidate, forbiddenAliases)) === canonicalRecordJson(retained));
+    const canonicalCandidates = new Set(candidates.map(({ candidate }) => canonicalRecordJson(canonicalMigrationRecord(boundary, candidate, forbiddenAliases))));
+    if (canonicalCandidates.size !== 1)
+        return [canonicalCandidates.size === 0
+                ? "migration_provenance does not bind a retained canonical summary to a declared source record"
+                : "migration_provenance ambiguously binds divergent declared source summary records"];
+    return [];
+}
+//# sourceMappingURL=summaryMigrationProvenance.js.map

package/dist/state/summaryMigrationProvenance.js.map

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

package/dist/state/summarySourceRowAuthority.js

@@ -0,0 +1,37 @@
+const REFERENCE = "entity_target.declared_compacted_summary_contract.source_row_provenance";
+const BOUNDARIES = new Set(["progress_summary", "decision_summary", "health_summary"]);
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function strings(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string") ? value : [];
+}
+/** Validate the one source-row digest semantic contract used by every summary boundary. */
+export function validateCompactedSummarySourceRowAuthority(target, authorityPath) {
+    const compacted = mapping(target.declared_compacted_summary_contract) ? target.declared_compacted_summary_contract : null;
+    const semantic = mapping(compacted?.source_row_provenance) ? compacted.source_row_provenance : null;
+    const digest = mapping(semantic?.source_record_sha256) ? semantic.source_record_sha256 : null;
+    const accepted = strings(semantic?.accepted_parsed_row_values).sort();
+    if (semantic?.status !== "implemented"
+        || semantic.semantic_id !== "v2_compacted_summary_physical_row.v1"
+        || accepted.length !== 2 || accepted[0] !== "mapping" || accepted[1] !== "scalar_string"
+        || typeof semantic.normalization !== "string"
+        || digest?.format !== "lowercase_sha256_hex"
+        || typeof digest.input !== "string"
+        || typeof digest.canonicalization !== "string")
+        throw new Error(`invalid compacted-summary source-row provenance declaration in '${authorityPath}'`);
+    const declared = Array.isArray(compacted?.boundaries) ? compacted.boundaries : [];
+    const primary = Array.isArray(target.entities) ? target.entities : [];
+    for (const [scope, entries, provenance] of [
+        ["primary", primary, (entry) => mapping(entry.canonical_metadata) && mapping(entry.canonical_metadata.summary_migration_provenance) ? entry.canonical_metadata.summary_migration_provenance : null],
+        ["declared", declared, (entry) => mapping(entry.record) && mapping(entry.record.migration_provenance) ? entry.record.migration_provenance : null],
+    ]) {
+        for (const entry of entries) {
+            if (!mapping(entry) || !BOUNDARIES.has(String(entry.boundary)))
+                continue;
+            if (provenance(entry)?.source_row_provenance !== REFERENCE)
+                throw new Error(`${scope} summary boundary '${entry.boundary}' must reference the compacted-summary source-row provenance declaration in '${authorityPath}'`);
+        }
+    }
+}
+//# sourceMappingURL=summarySourceRowAuthority.js.map

package/dist/state/summarySourceRowAuthority.js.map

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

package/dist/state/todoDocsEntities.js

@@ -0,0 +1,267 @@
+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 { canonicalRecordJson } from "./archiveDiscovery.js";
+import { StateRetrievalFailure } from "./directRetrieval.js";
+import { allocateEntityId, assertEntityDiscoveryOrigin, canonicalEntityRecordViolations, discoverEntities, publishEntityUnderLock, replaceEntityUnderLock, validateEntityState, withEntityWriterLock, } from "./entityStorage.js";
+import { detectStateModeBinding } from "./stateMode.js";
+import { reject } from "./write/errors.js";
+import { loadYamlMapping } from "../core/yaml.js";
+import { TODO_SEVERITIES, TODO_STATUSES, todoDocsRecordViolations } from "./todoDocsEntityValidation.js";
+import { todoReadinessReferenceViolations } from "../registries/todoReadinessContract.js";
+const ID = /^[a-z]{10}$/;
+const TODO = { artifact: "todo", boundary: "todo_item", order: "severity_then_status_then_id" };
+const DOCS = { artifact: "docs", boundary: "documentation_inventory_entry", order: "path_then_id" };
+function mapping(value) { return value !== null && typeof value === "object" && !Array.isArray(value); }
+function relative(root, file) { return path.relative(path.resolve(root), file).split(path.sep).join("/"); }
+function shell(value) { return `'${String(value).replaceAll("'", "'\\''")}'`; }
+function definition(artifact) { return artifact === "todo" ? TODO : DOCS; }
+function contract(boundary, sourceRoot = resolveSourceRoot()) {
+    const authorityPath = path.join(sourceRoot, "references/artifacts/state-storage-authority.yaml");
+    const authority = loadYamlMapping(fs.readFileSync(authorityPath, "utf8"));
+    const target = mapping(authority.entity_target) ? authority.entity_target : {};
+    const storage = mapping(target.storage_boundary) && mapping(target.storage_boundary.shared_primitives) ? target.storage_boundary.shared_primitives : {};
+    const entity = (Array.isArray(target.entities) ? target.entities : []).find((value) => mapping(value) && value.boundary === boundary);
+    const retrieval = mapping(entity) && mapping(entity.retrieval) ? entity.retrieval : {};
+    const positive = (value, name) => { const result = Number(value); if (!Number.isSafeInteger(result) || result < 1)
+        throw new Error(`invalid ${boundary} ${name} authority`); return result; };
+    if (typeof storage.canonical_root !== "string")
+        throw new Error(`invalid entity authority '${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(kind, artifact, message, recovery, id, exitCode = 1) {
+    return new StateRetrievalFailure({ schemaVersion: "agentera.stateFailure.v1", status: "fail", error: { class: kind, message, syntax: `agentera state ${artifact} get --id ID --format json`, example: `agentera state ${artifact} get --id ${id ?? "qjtrmnpvka"} --format json`, recovery, artifact, ...(id ? { id } : {}) } }, exitCode);
+}
+function relevant(root, sourceRoot, artifact, supplied, sourceBinding) {
+    if (supplied)
+        assertEntityDiscoveryOrigin(root, sourceRoot, supplied);
+    const discovery = supplied ?? discoverEntities(root, sourceRoot, sourceBinding);
+    const selected = discovery.entities.filter((entity) => [TODO.boundary, DOCS.boundary].includes(entity.boundary) || [TODO.artifact, DOCS.artifact].includes(entity.artifact));
+    const bad = selected.find(({ classification, id, record }) => classification !== "valid" || !id || !record);
+    if (bad)
+        throw failure(bad.classification === "duplicate" ? "ambiguous" : "corrupt", artifact ?? bad.artifact ?? "todo", `entity '${bad.relativePath}' is not canonical`, "Run agentera check validate state and resolve every invalid identity or record before retrying.", bad.id ?? undefined);
+    return selected;
+}
+function selectedById(entities, artifact, id) {
+    if (!ID.test(id))
+        throw failure("invalid_request", artifact, `${artifact} ID '${id}' must be ten lowercase letters`, `Use a bare ${artifact} ID returned by create or list; numeric, prefixed, composite, path, and alias identities are invalid.`, id, 2);
+    const boundary = definition(artifact).boundary;
+    const matches = entities.filter((entity) => entity.boundary === boundary && entity.id === id);
+    if (matches.length !== 1)
+        throw failure(matches.length ? "ambiguous" : "not_found", artifact, matches.length ? `${artifact} ID '${id}' has conflicting ownership` : `${artifact} ID '${id}' was not found`, `Run agentera state ${artifact} list --format json and select one canonical ID.`, id);
+    return matches[0];
+}
+function recordViolations(artifact, record, sourceRoot) {
+    const boundary = definition(artifact).boundary;
+    const violations = [...canonicalEntityRecordViolations(boundary, record, sourceRoot), ...todoDocsRecordViolations(boundary, record, sourceRoot)];
+    return [...new Set(violations)];
+}
+function assertState(root, sourceRoot, sourceBinding) {
+    const state = validateEntityState(root, sourceRoot, sourceBinding);
+    if (!state.valid)
+        reject({ class: "conflict", message: `canonical entity state is invalid: ${state.issues.map(({ message }) => message).join("; ")}`, recovery: "Run agentera check validate state and resolve every identity or record conflict before retrying; no state was changed." });
+}
+function envelope(command, entity, artifact, record, dryRun) {
+    return { schemaVersion: "agentera.stateWrite.v1", command, status: "pass", path: entity.path, id: entity.id, artifact, record, operation: { verb: command.split(" ").at(-1), dry_run: dryRun, idempotent_replay: entity.replay }, validation: { status: "pass", violations: [] } };
+}
+function targetPath(root, sourceRoot, artifact, id) {
+    const model = definition(artifact);
+    return path.join(root, contract(model.boundary, sourceRoot).entityRoot, artifact, model.boundary, `${id}.yaml`);
+}
+function mutationRecord(req, current) {
+    if (req.artifact === "docs")
+        return structuredClone(req.input ?? {});
+    const record = structuredClone(current ?? { severity: req.values.severity, status: "open", description: req.values.description });
+    if (req.values.severity !== undefined)
+        record.severity = req.values.severity;
+    if (req.values.description !== undefined)
+        record.description = req.values.description;
+    if (mapping(req.values.readiness)) {
+        const input = req.values.readiness;
+        const dependencies = Array.isArray(input.dependencies) ? input.dependencies : [];
+        record.readiness = {
+            ...(input.capability !== undefined ? { capability: input.capability } : {}),
+            ...(input.reason !== undefined ? { reason: input.reason } : {}),
+            dependencies: dependencies.map((id) => ({ artifact: "todo", id })),
+            blocked: mapping(input.blocked) ? input.blocked : null,
+            gate: mapping(input.gate) ? input.gate : null,
+            ...(input.queue_rank !== undefined ? { queue_rank: input.queue_rank } : {}),
+            ...(input.order_reason !== undefined ? { order_reason: input.order_reason } : {}),
+        };
+    }
+    if (req.spec.verb === "resolve")
+        record.status = "resolved";
+    return record;
+}
+function assertTodoReferences(id, record, entities) {
+    if (record.readiness === undefined)
+        return;
+    const todos = entities
+        .filter((entity) => entity.boundary === TODO.boundary && entity.id && entity.record && entity.id !== id)
+        .map((entity) => ({ id: entity.id, record: entity.record }));
+    todos.push({ id, record });
+    const violations = todoReadinessReferenceViolations(id, record.readiness, todos);
+    if (violations.length)
+        reject({
+            class: "schema_violation",
+            message: "todo readiness dependencies are invalid",
+            violations,
+            recovery: "Use bare ten-letter IDs returned by `agentera state todo list --format json`; reference existing TODO items only and remove self-references or cycles, then retry.",
+        });
+}
+function todoReadinessRecovery(verb) {
+    return `Run agentera state todo explain --verb ${verb} --format json, then supply --capability, --reason, --queue-rank, and --order-reason together; use dependency IDs returned by agentera state todo list --format json.`;
+}
+export function mutateTodoDocsEntity(req, options = {}) {
+    const artifact = req.artifact;
+    if (artifact !== "todo" && artifact !== "docs")
+        throw new Error("TODO/docs entity mutation received an unsupported artifact");
+    const sourceRoot = options.sourceRoot ?? resolveSourceRoot();
+    if (!options.publicationContext) {
+        const binding = detectStateModeBinding(req.projectRoot, sourceRoot);
+        if (binding.mode !== "entities")
+            reject({ class: "unsupported_target", message: `${artifact} entity mutations require the durable entity-mode marker; legacy aggregate behavior is unchanged` });
+        try {
+            return mutateTodoDocsEntity(req, { ...options, publicationContext: binding.publicationContext });
+        }
+        finally {
+            binding.publicationContext.close();
+        }
+    }
+    const context = options.publicationContext;
+    return withEntityWriterLock(context, () => {
+        const pinnedRoot = context.pinnedPath();
+        const sourceBinding = { kind: "project", projectRoot: context.validatedRoot };
+        context.assertValid();
+        assertState(pinnedRoot, sourceRoot, sourceBinding);
+        context.assertValid();
+        const entities = relevant(pinnedRoot, sourceRoot, artifact, undefined, sourceBinding);
+        context.assertValid();
+        if (req.spec.verb === "create") {
+            const record = mutationRecord(req);
+            const violations = recordViolations(artifact, record, sourceRoot);
+            if (violations.length)
+                reject({ class: "schema_violation", message: `${artifact} entity input is invalid`, violations, ...(artifact === "todo" && record.readiness !== undefined ? { recovery: todoReadinessRecovery(req.spec.verb) } : {}) });
+            const id = allocateEntityId(context.pinnedPath(), options.candidate, sourceRoot);
+            if (artifact === "todo" && mapping(req.values.readiness))
+                assertTodoReferences(id, record, entities);
+            if (req.dryRun)
+                return envelope(`state ${artifact} create`, { id, path: targetPath(req.projectRoot, sourceRoot, artifact, id), replay: false }, artifact, record, true);
+            let published;
+            try {
+                const result = publishEntityUnderLock({ projectRoot: req.projectRoot, sourceRoot, publicationContext: context, artifact, boundary: definition(artifact).boundary, id, record });
+                published = result;
+                assertState(pinnedRoot, sourceRoot, sourceBinding);
+                context.assertValid();
+                return envelope(`state ${artifact} create`, result, artifact, record, false);
+            }
+            catch (error) {
+                if (published?.publishedIdentity)
+                    context.removeExact(relative(req.projectRoot, published.path), published.publishedIdentity);
+                throw error;
+            }
+        }
+        const id = String(req.values.id ?? "");
+        if (!ID.test(id))
+            reject({ class: "invalid_request", message: `${artifact} ID '${id}' must be ten lowercase letters`, recovery: `Use a bare ${artifact} ID returned by create or list; numeric, prefixed, composite, path, and alias identities are invalid.` });
+        const entity = selectedById(entities, artifact, id);
+        const record = mutationRecord(req, entity.record);
+        const violations = recordViolations(artifact, record, sourceRoot);
+        if (violations.length)
+            reject({ class: "schema_violation", message: `${artifact} entity input is invalid`, violations, ...(artifact === "todo" && record.readiness !== undefined ? { recovery: todoReadinessRecovery(req.spec.verb) } : {}) });
+        if (artifact === "todo" && mapping(req.values.readiness))
+            assertTodoReferences(id, record, entities);
+        if (canonicalRecordJson(record) === canonicalRecordJson(entity.record))
+            return envelope(`state ${artifact} ${req.spec.verb}`, { id, path: entity.path, replay: true }, artifact, record, req.dryRun);
+        if (req.dryRun)
+            return envelope(`state ${artifact} ${req.spec.verb}`, { id, path: entity.path, replay: false }, artifact, record, true);
+        const request = { projectRoot: req.projectRoot, sourceRoot, publicationContext: context, artifact, boundary: definition(artifact).boundary, id, expectedRecord: entity.record, record };
+        let replaced = false;
+        try {
+            const result = replaceEntityUnderLock(request);
+            replaced = !result.replay;
+            assertState(pinnedRoot, sourceRoot, sourceBinding);
+            context.assertValid();
+            return envelope(`state ${artifact} ${req.spec.verb}`, result, artifact, record, false);
+        }
+        catch (error) {
+            if (replaced)
+                replaceEntityUnderLock({ ...request, expectedRecord: record, record: entity.record });
+            throw error;
+        }
+    });
+}
+function entry(root, entity) { return { id: entity.id, artifact: entity.artifact, record: entity.record, provenance: { storage: "canonical_entity_file", path: relative(root, entity.path), immutable: false } }; }
+function snapshot(root, entities) { return createHash("sha256").update(canonicalRecordJson(entities.map((entity) => ({ id: entity.id, boundary: entity.boundary, path: relative(root, entity.path), record: entity.record })).sort((a, b) => canonicalRecordJson(a).localeCompare(canonicalRecordJson(b))))).digest("hex"); }
+function secret(root, authorityPath) { return createHash("sha256").update(path.resolve(root)).update("\0").update(fs.readFileSync(authorityPath)).digest(); }
+function encode(value, root, authorityPath) { const bytes = Buffer.from(canonicalRecordJson(value)); return `${bytes.toString("base64url")}.${createHmac("sha256", secret(root, authorityPath)).update(bytes).digest("base64url")}`; }
+function decode(token, root, authorityPath, artifact) { try {
+    const [body, signature, extra] = token.split(".");
+    if (!body || !signature || extra)
+        throw new Error();
+    const bytes = Buffer.from(body, "base64url");
+    const supplied = Buffer.from(signature, "base64url");
+    const expected = createHmac("sha256", secret(root, authorityPath)).update(bytes).digest();
+    if (supplied.length !== expected.length || !timingSafeEqual(supplied, expected))
+        throw new Error();
+    const value = JSON.parse(bytes.toString());
+    if (!mapping(value))
+        throw new Error();
+    return value;
+}
+catch {
+    throw failure("cursor_invalid", artifact, `${artifact} cursor is malformed or belongs to another project`, "Copy next_cursor exactly, or omit --cursor to restart.");
+} }
+function sorted(artifact, entities) {
+    const selected = entities.filter(({ boundary }) => boundary === definition(artifact).boundary);
+    if (artifact === "docs")
+        return selected.sort((a, b) => String(a.record.path).localeCompare(String(b.record.path)) || a.id.localeCompare(b.id));
+    return selected.sort((a, b) => TODO_SEVERITIES.indexOf(a.record.severity) - TODO_SEVERITIES.indexOf(b.record.severity) || TODO_STATUSES.indexOf(a.record.status) - TODO_STATUSES.indexOf(b.record.status) || a.id.localeCompare(b.id));
+}
+export function getTodoDocsEntity(root, artifact, id, sourceRoot = resolveSourceRoot()) {
+    const entity = selectedById(relevant(root, sourceRoot, artifact), artifact, id);
+    return { schemaVersion: "agentera.stateGet.v1", command: `state ${artifact} get`, status: "ok", entry: entry(root, entity), source_contract: { authority: "references/artifacts/state-storage-authority.yaml", detail: "full_entity" } };
+}
+export function listTodoDocsEntities(root, artifact, limit, cursor, filters = {}, options = {}) {
+    const sourceRoot = options.sourceRoot ?? resolveSourceRoot();
+    const declared = contract(definition(artifact).boundary, sourceRoot);
+    const take = limit ?? declared.defaultLimit;
+    if (!Number.isSafeInteger(take) || take < 1 || take > declared.maximumLimit)
+        throw failure("invalid_request", artifact, `${artifact} list limit must be 1..${declared.maximumLimit}`, "Use a limit in the declared range.", undefined, 2);
+    const all = relevant(root, sourceRoot, artifact, options.discovery).filter(({ boundary }) => boundary === definition(artifact).boundary);
+    let selected = sorted(artifact, all);
+    if (artifact === "todo")
+        selected = selected.filter((entity) => (!filters.severity || entity.record.severity === filters.severity) && (!filters.status || entity.record.status === filters.status));
+    if (artifact === "docs")
+        selected = selected.filter((entity) => (!filters.status || entity.record.status === filters.status) && (!filters.topic || [entity.record.document, entity.record.path, entity.record.status].some((value) => String(value).toLowerCase().includes(String(filters.topic).toLowerCase()))));
+    const snap = snapshot(root, all);
+    let start = 0;
+    if (cursor) {
+        const value = decode(cursor, root, declared.authorityPath, artifact);
+        if (value.snapshot_id !== snap || value.order !== definition(artifact).order || canonicalRecordJson(value.filters) !== canonicalRecordJson(filters))
+            throw failure("cursor_snapshot_unavailable", artifact, `${artifact} state changed after this cursor snapshot`, "Omit --cursor to restart from current state.");
+        const found = selected.findIndex(({ id }) => id === value.after);
+        if (found < 0)
+            throw failure("cursor_snapshot_unavailable", artifact, `${artifact} cursor continuation is unavailable`, "Omit --cursor to restart.");
+        start = found + 1;
+    }
+    let page = selected.slice(start, start + take);
+    let trimmed = false;
+    const response = () => { const remaining = selected.length - start - page.length; const next = remaining && page.length ? encode({ snapshot_id: snap, order: definition(artifact).order, filters, after: page.at(-1).id }, root, declared.authorityPath) : undefined; const filterFlags = Object.entries(filters).map(([name, value]) => ` --${name} ${shell(value)}`).join(""); return { schemaVersion: "agentera.stateList.v1", command: `state ${artifact} list`, status: remaining ? "degraded" : "ok", entries: page.map((entity) => entry(root, entity)), counts: { total: selected.length, returned: page.length, remaining }, order: definition(artifact).order, filters, snapshot: { id: snap, first_page: !cursor, has_more: Boolean(remaining), candidate_count: selected.length }, source: { artifact, authority: "canonical_entity_files", root: declared.entityRoot }, source_contract: { authority: "references/artifacts/state-storage-authority.yaml", detail: "full", cursor: "opaque_snapshot_cursor" }, retrieval: { get: `agentera state ${artifact} get --id ID --format json`, ...(next ? { continue: `agentera state ${artifact} list${filterFlags} --limit ${take} --cursor ${next} --format json` } : {}) }, ...(remaining ? { omitted: true, omitted_count: remaining, omission_reason: trimmed ? "serialized_byte_budget" : "page_limit", next_cursor: next } : {}) }; };
+    const outputBudget = declared.maxUtf8Bytes - (options.reservedUtf8Bytes ?? 0);
+    if (outputBudget < 1024)
+        throw failure("unsupported_state", artifact, `${artifact} singleton metadata leaves no room for a bounded entity view`, "Reduce the authority-owned singleton metadata within its declared artifact budget.");
+    let result = response();
+    const bytes = () => Buffer.byteLength(options.format === "yaml" ? YAML.stringify(result) : `${JSON.stringify(result, null, 2)}\n`);
+    while (bytes() > outputBudget && page.length) {
+        page = page.slice(0, -1);
+        trimmed = true;
+        result = response();
+    }
+    if (!page.length && selected.length > start)
+        throw failure("unsupported_state", artifact, `one full ${artifact} entity cannot fit the ${declared.maxUtf8Bytes}-byte list budget`, "Use exact get by ID.");
+    return result;
+}
+//# sourceMappingURL=todoDocsEntities.js.map

package/dist/state/todoDocsEntities.js.map

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

package/dist/state/todoDocsEntityValidation.js

@@ -0,0 +1,34 @@
+import path from "node:path";
+import { loadTodoReadinessContract, todoReadinessRecordViolations } from "../registries/todoReadinessContract.js";
+export const TODO_SEVERITIES = ["critical", "degraded", "normal", "annoying"];
+export const TODO_STATUSES = ["open", "resolved"];
+export const DOC_STATUSES = ["current", "stale", "missing", "intent", "generated"];
+export function todoDocsRecordViolations(boundary, record, sourceRoot) {
+    const violations = [];
+    if (boundary === "todo_item") {
+        if (!TODO_SEVERITIES.includes(record.severity))
+            violations.push(`severity must be one of: ${TODO_SEVERITIES.join(", ")}`);
+        if (!TODO_STATUSES.includes(record.status))
+            violations.push(`status must be one of: ${TODO_STATUSES.join(", ")}`);
+        if (typeof record.description !== "string" || !record.description.trim())
+            violations.push("description is required");
+        if (record.readiness !== undefined) {
+            const contract = sourceRoot
+                ? loadTodoReadinessContract(path.join(sourceRoot, "skills/agentera/schemas/artifacts/todo.yaml"), path.join(sourceRoot, "skills/agentera/protocol.yaml"), path.join(sourceRoot, "skills/agentera/capability_schema_contract.yaml"))
+                : undefined;
+            violations.push(...todoReadinessRecordViolations(record.readiness, contract));
+        }
+    }
+    if (boundary === "documentation_inventory_entry") {
+        if (typeof record.document !== "string" || !record.document.trim())
+            violations.push("document is required");
+        if (typeof record.path !== "string" || !record.path.trim())
+            violations.push("path is required record data");
+        if (!/^\d{4}-\d{2}-\d{2}$/.test(String(record.last_updated ?? "")))
+            violations.push("last_updated must be YYYY-MM-DD");
+        if (!DOC_STATUSES.includes(record.status))
+            violations.push(`status must be one of: ${DOC_STATUSES.join(", ")}`);
+    }
+    return violations;
+}
+//# sourceMappingURL=todoDocsEntityValidation.js.map

package/dist/state/todoDocsEntityValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todoDocsEntityValidation.js","sourceRoot":"","sources":["../../../../../home/jgabor/git/agentera/packages/cli/src/state/todoDocsEntityValidation.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AAElH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAU,CAAC;AACvF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,UAAU,CAAU,CAAC;AAC3D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAU,CAAC;AAE5F,MAAM,UAAU,wBAAwB,CAAC,QAAgB,EAAE,MAAkB,EAAE,UAAmB;IAChG,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,QAAQ,KAAK,WAAW,EAAE,CAAC;QAC7B,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,QAA0C,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,4BAA4B,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5J,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAsC,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,0BAA0B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClJ,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;YAAE,UAAU,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACrH,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,UAAU;gBACzB,CAAC,CAAC,yBAAyB,CACzB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,6CAA6C,CAAC,EACpE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,+BAA+B,CAAC,EACtD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iDAAiD,CAAC,CACzE;gBACD,CAAC,CAAC,SAAS,CAAC;YACd,UAAU,CAAC,IAAI,CAAC,GAAG,6BAA6B,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,KAAK,+BAA+B,EAAE,CAAC;QACjD,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;YAAE,UAAU,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC5G,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,UAAU,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;QAC5G,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACvH,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAqC,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,0BAA0B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}