agentera 3.0.0-dev.4 → 3.0.0-dev.41

package/dist/state/stateStorageAuthority.js

@@ -0,0 +1,48 @@
+import fs from "node:fs";
+import path from "node:path";
+import { loadYamlMapping } from "../core/yaml.js";
+const AUTHORITY_RELATIVE_PATH = path.join("references", "artifacts", "state-storage-authority.yaml");
+let cache;
+function immutableGraph(root) {
+    const proxies = new WeakMap();
+    const immutable = (value) => {
+        if (value === null || typeof value !== "object")
+            return value;
+        const existing = proxies.get(value);
+        if (existing)
+            return existing;
+        const proxy = new Proxy(value, {
+            get: (target, property, receiver) => immutable(Reflect.get(target, property, receiver)),
+            getOwnPropertyDescriptor: (target, property) => {
+                const descriptor = Reflect.getOwnPropertyDescriptor(target, property);
+                return descriptor && "value" in descriptor
+                    ? { ...descriptor, value: immutable(descriptor.value) }
+                    : descriptor;
+            },
+            set: () => { throw new TypeError("state storage authority is immutable"); },
+            defineProperty: () => { throw new TypeError("state storage authority is immutable"); },
+            deleteProperty: () => { throw new TypeError("state storage authority is immutable"); },
+            preventExtensions: () => { throw new TypeError("state storage authority is immutable"); },
+            setPrototypeOf: () => { throw new TypeError("state storage authority is immutable"); },
+        });
+        proxies.set(value, proxy);
+        return proxy;
+    };
+    return immutable(root);
+}
+/**
+ * Read the state-storage authority on every call and reuse its immutable parsed
+ * graph only while the canonical path and exact file bytes remain unchanged.
+ */
+export function loadStateStorageAuthority(sourceRoot) {
+    const authorityPath = path.resolve(sourceRoot, AUTHORITY_RELATIVE_PATH);
+    const bytes = fs.readFileSync(authorityPath);
+    if (cache?.authorityPath === authorityPath && cache.bytes.equals(bytes)) {
+        return { authorityPath, document: cache.document, revision: cache.revision };
+    }
+    const document = immutableGraph(loadYamlMapping(bytes.toString("utf8")));
+    const revision = Symbol(authorityPath);
+    cache = { authorityPath, bytes, document, revision };
+    return { authorityPath, document, revision };
+}
+//# sourceMappingURL=stateStorageAuthority.js.map

package/dist/state/stateStorageAuthority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateStorageAuthority.js","sourceRoot":"","sources":["../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/state/stateStorageAuthority.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.release-publish-dev40/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.release-publish-dev40/packages/cli/src/state/summaryMigrationProvenance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAsC,MAAM,6BAA6B,CAAC;AAM3G,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,KAAiB,EAAE,aAAqB;IAC5F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gEAAgE,aAAa,GAAG,CAAC,CAAC;IACrI,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YAC7C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,OAAO,UAAU,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAC3K,MAAM,IAAI,KAAK,CAAC,+DAA+D,aAAa,GAAG,CAAC,CAAC;YACnG,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;QAChE,CAAC,CAAC,EAAE,CAAC;AACP,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,oCAAoC,CAClD,QAAgB,EAChB,MAAkB,EAClB,WAAkD,EAClD,gBAAmC,EACnC,OAAuC;IAEvC,MAAM,UAAU,GAAG,MAAM,CAAC,oBAAoB,CAAC;IAC/C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,wCAAwC,CAAC,CAAC;IAC5E,IAAI,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,mBAAmB,CAAC,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC;QACzH,OAAO,CAAC,gFAAgF,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAC5E,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,CAAC;IAC1C,MAAM,YAAY,GAAG,UAAU,CAAC,oBAAoB,CAAC;IACrD,MAAM,cAAc,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrI,IAAI,CAAC,cAAc;QAAE,OAAO,CAAC,yFAAyF,CAAC,CAAC;IACxH,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,YAAY,CAAC;QAAE,OAAO,CAAC,8EAA8E,CAAC,CAAC;IACtK,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,gFAAgF,CAAC,CAAC;IAErH,MAAM,MAAM,GAAG,wBAAwB,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;IACtE,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,CAAC,gCAAgC,cAAc,CAAC,IAAI,QAAQ,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACtK,IAAI,QAAoB,CAAC;IACzB,IAAI,CAAC;QAAC,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,CAAe,CAAC;IAAC,CAAC;IAC/D,OAAO,KAAK,EAAE,CAAC;QAAC,OAAO,CAAC,gCAAgC,cAAc,CAAC,IAAI,sBAAuB,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IAC/H,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACzC,OAAO,QAAQ,CAAC,oBAAoB,CAAC;IACrC,MAAM,UAAU,GAAG,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;QACnE,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YACrD,MAAM,SAAS,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAChD,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACV,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ,IAAI,SAAS,CAAC,mBAAmB,KAAK,cAAc,CAAC;WAC7H,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,YAAY;WACzF,mBAAmB,CAAC,wBAAwB,CAAC,QAAQ,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC,KAAK,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7H,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,mBAAmB,CAAC,wBAAwB,CAAC,QAAQ,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7J,IAAI,mBAAmB,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,mBAAmB,CAAC,IAAI,KAAK,CAAC;gBACxE,CAAC,CAAC,6FAA6F;gBAC/F,CAAC,CAAC,kFAAkF,CAAC,CAAC;IACxF,OAAO,EAAE,CAAC;AACZ,CAAC"}

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.release-publish-dev40/packages/cli/src/state/summarySourceRowAuthority.ts"],"names":[],"mappings":"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"}