agentera 3.0.0-dev.32 → 3.0.0-dev.39

package/dist/cli/commands/glossaryAdvice.js

@@ -0,0 +1,139 @@
+import fs from "node:fs";
+import { acquireGlossaryInputs } from "../../analytics/glossaryInputAcquisition.js";
+import { GlossaryAdviceInputError, resolveGlossaryAdvice, } from "../../analytics/glossaryAdviceResolution.js";
+import { loadYamlMapping } from "../../core/yaml.js";
+import { glossaryAdviceContract } from "../../registries/glossaryAdviceContract.js";
+import { discoverSchemasDir } from "../appContext.js";
+import { emitInvalidInput } from "../errors.js";
+import { registryArtifactPath } from "../orientation.js";
+import { emitStructured } from "../structured.js";
+const contract = glossaryAdviceContract();
+const COMMAND = contract.command.replace("REQUEST", "<file|->");
+const RECOVERY = `Correct the bounded request and retry ${COMMAND}; no state was changed.`;
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function invalid(io, body) {
+    return emitInvalidInput(io, { format: "json", body: { ...body, recovery: RECOVERY } });
+}
+function parseArgs(argv) {
+    let input;
+    for (let index = 0; index < argv.length; index += 1) {
+        const [name, inline] = argv[index].split("=", 2);
+        if (name !== "--input" && name !== "--format") {
+            return {
+                class: "unrecognized_argument",
+                message: `unrecognized arguments: ${name}`,
+                syntax: COMMAND,
+            };
+        }
+        const value = inline ?? argv[++index];
+        if (!value || value.startsWith("--")) {
+            return {
+                class: "missing_argument",
+                message: `${name} requires a value`,
+                syntax: `${name} VALUE`,
+            };
+        }
+        if (name === "--format" && value !== "json") {
+            return {
+                class: "invalid_choice",
+                message: "glossary-advice requires --format json",
+                valid_values: ["json"],
+            };
+        }
+        if (name === "--input") {
+            if (input !== undefined)
+                return { class: "mutually_exclusive", message: "--input may only be supplied once" };
+            input = value;
+        }
+    }
+    return input ?? { class: "missing_argument", message: "--input is required", syntax: COMMAND };
+}
+function readRequest(source, io) {
+    const bytes = source === "-"
+        ? Buffer.from(io.stdin ? io.stdin() : fs.readFileSync(0))
+        : fs.readFileSync(source);
+    if (bytes.length > contract.maxRequestUtf8Bytes)
+        throw new Error("over bound");
+    const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    const request = mapping(loadYamlMapping(text));
+    if (!request)
+        throw new Error("not a mapping");
+    return request;
+}
+function validatedRequest(request) {
+    const keys = Object.keys(request);
+    if (keys.some((key) => !contract.requestFields.includes(key)) ||
+        contract.requestFields.slice(0, 2).some((key) => !(key in request))) {
+        return {
+            class: "schema_violation",
+            message: "glossary advice request fields are invalid",
+            valid_values: contract.requestFields,
+        };
+    }
+    if (request.schema_version !== contract.requestSchemaVersion ||
+        typeof request.requested_term !== "string") {
+        return {
+            class: "schema_violation",
+            message: `request must use ${contract.requestSchemaVersion} with one string requested_term`,
+            valid_values: [contract.requestSchemaVersion],
+        };
+    }
+    if (request.host_review === undefined || request.host_review === null)
+        return { requestedTerm: request.requested_term };
+    const review = mapping(request.host_review);
+    if (!review ||
+        JSON.stringify(Object.keys(review).sort()) !==
+            JSON.stringify([...contract.hostReviewFields].sort())) {
+        return {
+            class: "schema_violation",
+            message: "host_review fields are invalid",
+            valid_values: contract.hostReviewFields,
+        };
+    }
+    return {
+        requestedTerm: request.requested_term,
+        hostReview: {
+            relation: review.relation,
+            candidate_owner: review.candidate_owner,
+            candidate_term: review.candidate_term,
+        },
+    };
+}
+export function runGlossaryAdviceCommand(argv, io) {
+    const parsedArgs = parseArgs(argv);
+    if (typeof parsedArgs !== "string")
+        return invalid(io, parsedArgs);
+    let request;
+    try {
+        request = readRequest(parsedArgs, io);
+    }
+    catch {
+        return invalid(io, {
+            class: "invalid_format",
+            message: "--input must be one readable bounded UTF-8 YAML or JSON mapping",
+        });
+    }
+    const parsed = validatedRequest(request);
+    if ("class" in parsed)
+        return invalid(io, parsed);
+    try {
+        const profilePath = registryArtifactPath("profile", discoverSchemasDir());
+        const advice = resolveGlossaryAdvice(parsed.requestedTerm, acquireGlossaryInputs(process.cwd(), profilePath), parsed.hostReview);
+        emitStructured({
+            schemaVersion: contract.schemaVersion,
+            command: "report glossary-advice",
+            status: "ok",
+            advice,
+        }, "json", io.out ?? ((text) => process.stdout.write(text)));
+        return 0;
+    }
+    catch (error) {
+        const code = error instanceof GlossaryAdviceInputError ? error.code : "invalid_acquisition";
+        return invalid(io, { class: "invalid_request", message: `glossary advice failed: ${code}` });
+    }
+}
+//# sourceMappingURL=glossaryAdvice.js.map

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

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

package/dist/cli/commands/personalGlossary.js

@@ -0,0 +1,177 @@
+import fs from "node:fs";
+import { updatePersonalGlossaryProfile } from "../../analytics/personalGlossaryProfile.js";
+import { loadYamlMapping } from "../../core/yaml.js";
+import { personalGlossaryOutputContract } from "../../registries/glossaryEntryContract.js";
+import { emitInvalidInput } from "../errors.js";
+import { emitStructured } from "../structured.js";
+const REQUEST_FIELDS = ["schema_version", "profile_path", "as_of", "fresh_entries", "retained_history"];
+const HISTORY_FIELDS = ["source_id", "evidence_anchor", "source_kind", "signal_type"];
+const RECOVERY = "Correct the request and retry the same command; no profile bytes were changed.";
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function calendarDate(value) {
+    if (typeof value !== "string" || !/^\d{4}-\d{2}-\d{2}$/.test(value))
+        return false;
+    const date = new Date(`${value}T00:00:00.000Z`);
+    return !Number.isNaN(date.getTime()) && date.toISOString().slice(0, 10) === value;
+}
+function invalid(io, body) {
+    return emitInvalidInput(io, { format: "json", body: { ...body, recovery: body.recovery ?? RECOVERY } });
+}
+function parseArgs(argv) {
+    let input;
+    let dryRun = false;
+    for (let index = 0; index < argv.length; index += 1) {
+        const argument = argv[index];
+        const [name, inline] = argument.split("=", 2);
+        if (name === "--dry-run") {
+            if (inline !== undefined)
+                return { class: "unrecognized_argument", message: "--dry-run does not accept a value" };
+            dryRun = true;
+            continue;
+        }
+        if (name === "--input" || name === "--format") {
+            const value = inline ?? argv[++index];
+            if (!value || value.startsWith("--"))
+                return { class: "missing_argument", message: `${name} requires a value`, syntax: `${name} VALUE` };
+            if (name === "--format") {
+                if (value !== "json")
+                    return { class: "invalid_choice", message: `argument --format: invalid choice: '${value}' (choose from 'json')`, valid_values: ["json"] };
+            }
+            else {
+                if (input !== undefined)
+                    return { class: "mutually_exclusive", message: "--input may only be supplied once" };
+                input = value;
+            }
+            continue;
+        }
+        return { class: "unrecognized_argument", message: `unrecognized arguments: ${argument}`, syntax: "agentera report profile-glossary --input <file|-> [--dry-run] --format json" };
+    }
+    if (!input)
+        return { class: "missing_argument", message: "--input is required", syntax: "agentera report profile-glossary --input <file|-> [--dry-run] --format json" };
+    return { input, dryRun };
+}
+function readRequest(source, io) {
+    let bytes;
+    if (source === "-")
+        bytes = Buffer.from(io.stdin ? io.stdin() : fs.readFileSync(0));
+    else
+        bytes = fs.readFileSync(source);
+    const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    const parsed = mapping(loadYamlMapping(text));
+    if (!parsed)
+        throw new Error("request is not a mapping");
+    return parsed;
+}
+function validateRequest(value) {
+    const contract = personalGlossaryOutputContract();
+    const keys = Object.keys(value);
+    const unsupported = keys.filter((key) => !REQUEST_FIELDS.includes(key));
+    const missing = REQUEST_FIELDS.filter((key) => !(key in value));
+    if (unsupported.length > 0 || missing.length > 0) {
+        return { class: "schema_violation", message: `request fields are invalid${missing.length ? `; missing: ${missing.join(", ")}` : ""}${unsupported.length ? `; unsupported: ${unsupported.join(", ")}` : ""}`, valid_values: REQUEST_FIELDS };
+    }
+    if (value.schema_version !== contract.requestSchemaVersion) {
+        return { class: "schema_violation", message: `schema_version must be ${contract.requestSchemaVersion}`, valid_values: [contract.requestSchemaVersion] };
+    }
+    if (typeof value.profile_path !== "string" || value.profile_path.trim() === "") {
+        return { class: "invalid_request", message: "profile_path must be the exact non-empty path returned by prime profile context", valid_values: ["profile_context.profile.path"] };
+    }
+    if (!calendarDate(value.as_of)) {
+        return { class: "invalid_request", message: "as_of must be an ISO calendar date", valid_values: ["YYYY-MM-DD"] };
+    }
+    if (!Array.isArray(value.fresh_entries) || value.fresh_entries.some((entry) => !mapping(entry))) {
+        return { class: "invalid_request", message: "fresh_entries must be a list of shared personal glossary entries", valid_values: ["fresh_entries: []"] };
+    }
+    for (const [index, raw] of value.fresh_entries.entries()) {
+        const entry = mapping(raw);
+        const temporal = mapping(entry.temporal);
+        if (!temporal || !calendarDate(temporal.observed_at) || !calendarDate(temporal.last_confirmed_at)) {
+            return { class: "invalid_request", message: `fresh_entries[${index}].temporal requires observed_at and last_confirmed_at ISO calendar dates`, valid_values: ["YYYY-MM-DD"] };
+        }
+        if (!["stable", "durable", "situational"].includes(entry.permanence)) {
+            return { class: "invalid_request", message: `fresh_entries[${index}].permanence is invalid`, valid_values: ["stable", "durable", "situational"] };
+        }
+        const provenance = mapping(entry.provenance);
+        if (!provenance || !["personal_explicit_definition", "personal_inferred_usage"].includes(String(provenance.kind))) {
+            return { class: "invalid_request", message: `fresh_entries[${index}].provenance.kind is invalid`, valid_values: ["personal_explicit_definition", "personal_inferred_usage"] };
+        }
+    }
+    if (!Array.isArray(value.retained_history) || value.retained_history.some((row) => !mapping(row))) {
+        return { class: "invalid_request", message: "retained_history must be a list", valid_values: ["retained_history: []"] };
+    }
+    for (const [index, raw] of value.retained_history.entries()) {
+        const row = mapping(raw);
+        if (JSON.stringify(Object.keys(row).sort()) !== JSON.stringify([...HISTORY_FIELDS].sort()) || HISTORY_FIELDS.some((field) => typeof row[field] !== "string" || String(row[field]).trim() === "")) {
+            return { class: "invalid_request", message: `retained_history[${index}] must contain exactly ${HISTORY_FIELDS.join(", ")}`, valid_values: HISTORY_FIELDS };
+        }
+    }
+    return null;
+}
+function admissionContext(rows) {
+    const retainedHistory = new Map();
+    for (const raw of rows) {
+        const row = mapping(raw);
+        const anchor = String(row.evidence_anchor);
+        if (retainedHistory.has(anchor))
+            return { class: "conflict", message: `retained_history contains duplicate evidence_anchor '${anchor}'`, valid_values: ["one row per evidence_anchor"] };
+        retainedHistory.set(anchor, { sourceId: String(row.source_id), sourceKind: String(row.source_kind), signalType: String(row.signal_type) });
+    }
+    return { retainedHistory };
+}
+export function runPersonalGlossaryCommand(argv, io) {
+    const parsed = parseArgs(argv);
+    if ("class" in parsed)
+        return invalid(io, parsed);
+    let request;
+    try {
+        request = readRequest(parsed.input, io);
+    }
+    catch {
+        return invalid(io, { class: "invalid_format", message: "--input must be a readable UTF-8 YAML or JSON mapping", valid_values: ["YAML mapping", "JSON object"] });
+    }
+    const requestError = validateRequest(request);
+    if (requestError)
+        return invalid(io, requestError);
+    const profilePath = String(request.profile_path);
+    try {
+        if (!fs.statSync(profilePath).isFile())
+            throw new Error("not a regular file");
+    }
+    catch {
+        return invalid(io, { class: "invalid_request", message: `profile_path is not an existing readable PROFILE.md file: ${profilePath}`, valid_values: ["existing PROFILE.md path from profile_context.profile.path"] });
+    }
+    const context = admissionContext(request.retained_history);
+    if ("class" in context)
+        return invalid(io, context);
+    try {
+        const result = updatePersonalGlossaryProfile({
+            profilePath,
+            asOf: String(request.as_of),
+            freshEntries: request.fresh_entries,
+            retainedHistory: context,
+            dryRun: parsed.dryRun,
+        });
+        const candidateStatus = result.changed ? "changed" : "unchanged";
+        emitStructured({
+            schemaVersion: "agentera.personalGlossaryUpdate.v1",
+            command: "report profile-glossary",
+            status: parsed.dryRun ? "dry_run_candidate" : result.changed ? "changed" : "unchanged_replay",
+            dry_run: parsed.dryRun,
+            candidate_status: candidateStatus,
+            profile_path: profilePath,
+            entry_count: result.entries.length,
+        }, "json", io.out ?? ((text) => process.stdout.write(text)));
+        return 0;
+    }
+    catch (error) {
+        const message = error.message;
+        return invalid(io, {
+            class: /conflict|duplicate|ambiguous/i.test(message) ? "conflict" : "invalid_request",
+            message,
+            valid_values: ["stable", "durable", "situational", "personal_explicit_definition", "personal_inferred_usage"],
+        });
+    }
+}
+//# sourceMappingURL=personalGlossary.js.map

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

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

package/dist/cli/commands/prime/buildExecutionRequest.js

@@ -0,0 +1,165 @@
+import fs from "node:fs";
+import { hasControlChars } from "../../argvalidate.js";
+import { loadYamlMapping } from "../../../core/yaml.js";
+export const BUILD_EXECUTION_REQUEST_SCHEMA = "agentera.buildExecutionRequest.v1";
+export const BUILD_EXECUTION_REQUEST_MAX_UTF8_BYTES = 32 * 1024;
+export const BUILD_EXECUTION_REQUEST_MAX_ITEMS = 12;
+export const BUILD_EXECUTION_REQUEST_MAX_CODE_POINTS = 160;
+const BUILD_EXECUTION_REQUEST_READ_CHUNK_BYTES = 8 * 1024;
+export class BuildExecutionRequestError extends Error {
+    body;
+    constructor(body) {
+        super(body.message);
+        this.body = body;
+    }
+}
+function fail(body) {
+    throw new BuildExecutionRequestError(body);
+}
+function codePointLength(value) {
+    return [...value].length;
+}
+function validateText(value, field) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        fail({ class: "schema_violation", message: `Build execution request ${field} must be a non-empty string` });
+    }
+    if (codePointLength(value) > BUILD_EXECUTION_REQUEST_MAX_CODE_POINTS) {
+        fail({ class: "schema_violation", message: `Build execution request ${field} exceeds 160 Unicode code points` });
+    }
+    if (hasControlChars(value)) {
+        fail({ class: "schema_violation", message: `Build execution request ${field} contains control characters` });
+    }
+    return value;
+}
+function unreadableInput() {
+    return fail({
+        class: "invalid_format",
+        message: "Build execution request input must be one readable regular file or bounded stdin stream",
+        syntax: "agentera prime --context build --input <file|-> --format json",
+    });
+}
+function oversizedInput() {
+    return fail({ class: "schema_violation", message: "Build execution request input exceeds the 32768-byte UTF-8 bound" });
+}
+function readBoundedDescriptor(fd) {
+    const chunks = [];
+    let total = 0;
+    while (total <= BUILD_EXECUTION_REQUEST_MAX_UTF8_BYTES) {
+        const remaining = BUILD_EXECUTION_REQUEST_MAX_UTF8_BYTES + 1 - total;
+        const chunk = Buffer.allocUnsafe(Math.min(BUILD_EXECUTION_REQUEST_READ_CHUNK_BYTES, remaining));
+        const count = fs.readSync(fd, chunk, 0, chunk.byteLength, null);
+        if (count === 0)
+            break;
+        chunks.push(chunk.subarray(0, count));
+        total += count;
+    }
+    if (total > BUILD_EXECUTION_REQUEST_MAX_UTF8_BYTES)
+        oversizedInput();
+    return Buffer.concat(chunks, total);
+}
+function sameIdentity(left, right) {
+    return left.dev === right.dev && left.ino === right.ino;
+}
+function readBoundedFile(source) {
+    let observed;
+    try {
+        observed = fs.lstatSync(source, { bigint: true });
+    }
+    catch {
+        return unreadableInput();
+    }
+    if (observed.isSymbolicLink() || !observed.isFile())
+        unreadableInput();
+    if (observed.size > BigInt(BUILD_EXECUTION_REQUEST_MAX_UTF8_BYTES))
+        oversizedInput();
+    let fd = null;
+    try {
+        fd = fs.openSync(source, fs.constants.O_RDONLY | (fs.constants.O_NOFOLLOW ?? 0));
+        const opened = fs.fstatSync(fd, { bigint: true });
+        if (!opened.isFile() || !sameIdentity(observed, opened))
+            unreadableInput();
+        if (opened.size > BigInt(BUILD_EXECUTION_REQUEST_MAX_UTF8_BYTES))
+            oversizedInput();
+        return readBoundedDescriptor(fd);
+    }
+    catch (error) {
+        if (error instanceof BuildExecutionRequestError)
+            throw error;
+        return unreadableInput();
+    }
+    finally {
+        if (fd !== null)
+            fs.closeSync(fd);
+    }
+}
+function readBytes(source, readStdin) {
+    if (source !== "-")
+        return readBoundedFile(source);
+    if (readStdin) {
+        let value;
+        try {
+            value = readStdin();
+        }
+        catch {
+            return unreadableInput();
+        }
+        const bytes = typeof value === "string" ? Buffer.from(value, "utf8") : value;
+        if (bytes.byteLength > BUILD_EXECUTION_REQUEST_MAX_UTF8_BYTES)
+            oversizedInput();
+        return bytes;
+    }
+    if (process.stdin.isTTY)
+        return Buffer.alloc(0);
+    try {
+        return readBoundedDescriptor(0);
+    }
+    catch (error) {
+        if (error instanceof BuildExecutionRequestError)
+            throw error;
+        return unreadableInput();
+    }
+}
+export function loadBuildExecutionRequest(source, readStdin) {
+    const bytes = readBytes(source, readStdin);
+    let input;
+    try {
+        const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+        input = loadYamlMapping(text);
+    }
+    catch {
+        return fail({
+            class: "invalid_format",
+            message: "Build execution request input must be one valid UTF-8 YAML or JSON mapping",
+        });
+    }
+    const fields = Object.keys(input);
+    const expected = ["schema_version", "scope", "acceptance"];
+    if (fields.some((field) => !expected.includes(field))) {
+        fail({ class: "schema_violation", message: "Build execution request contains unsupported fields" });
+    }
+    if (fields.length !== expected.length || expected.some((field) => !Object.hasOwn(input, field))) {
+        fail({ class: "schema_violation", message: "Build execution request requires exactly schema_version, scope, and acceptance" });
+    }
+    if (input.schema_version !== BUILD_EXECUTION_REQUEST_SCHEMA) {
+        fail({ class: "schema_violation", message: `Build execution request schema_version must be ${BUILD_EXECUTION_REQUEST_SCHEMA}` });
+    }
+    const scope = validateText(input.scope, "scope");
+    if (!Array.isArray(input.acceptance) || input.acceptance.length < 1 || input.acceptance.length > BUILD_EXECUTION_REQUEST_MAX_ITEMS) {
+        fail({ class: "schema_violation", message: "Build execution request acceptance must contain 1 to 12 strings" });
+    }
+    const acceptance = input.acceptance.map((value, index) => validateText(value, `acceptance[${index}]`));
+    if (new Set(acceptance).size !== acceptance.length) {
+        fail({ class: "schema_violation", message: "Build execution request acceptance must not contain duplicate values" });
+    }
+    return {
+        schema_version: BUILD_EXECUTION_REQUEST_SCHEMA,
+        scope,
+        acceptance,
+        source: {
+            kind: source === "-" ? "stdin" : "file",
+            schema_version: BUILD_EXECUTION_REQUEST_SCHEMA,
+            persisted: false,
+        },
+    };
+}
+//# sourceMappingURL=buildExecutionRequest.js.map

package/dist/cli/commands/prime/buildExecutionRequest.js.map

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

package/dist/cli/commands/prime/collectEntityOrientation.js

@@ -1,3 +1,4 @@
+import path from "node:path";
 import { listProgressEntities } from "../../../state/progressEntities.js";
 import { listDecisionEntities } from "../../../state/decisionEntities.js";
 import { listHealthEntities } from "../../../state/healthEntities.js";
@@ -9,8 +10,11 @@ import { discoverEntities } from "../../../state/entityStorage.js";
 import { summaryCaveat } from "../../../state/summaryEntityRead.js";
 import { boundStartupValue, STARTUP_ARRAY_LIMIT } from "../../../state/startupProjection.js";
 import { rememberPlanTaskIndex } from "../../planTaskIndex.js";
+import { firstActionablePlanTask } from "../../capabilityContext/planState.js";
 import { issueCounts } from "../../orientation.js";
 import { evaluateTodoReadinessQueue } from "../../todoReadinessSelection.js";
+import { projectCurrentGlossaryCaveats } from "../../../state/progressGlossaryCaveat.js";
+import { glossaryCaveatContract } from "../../../registries/glossaryCaveatContract.js";
 function entries(payload) {
     return Array.isArray(payload.entries)
         ? payload.entries.filter((entry) => Boolean(entry) && typeof entry === "object" && !Array.isArray(entry))
@@ -86,7 +90,14 @@ function selected(entries, artifact) {
 /** Bounded startup projection built only from canonical entity readers. */
 export function collectEntityOrientation(projectRoot, sourceRoot) {
     const discovery = discoverEntities(projectRoot, sourceRoot);
-    const progressList = listProgressEntities(projectRoot, 10, {}, undefined, { sourceRoot, format: "json", discovery });
+    const caveatContract = glossaryCaveatContract(path.join(sourceRoot, "references", "artifacts", "glossary-entry-contract.yaml"));
+    const glossaryCaveatProjection = projectCurrentGlossaryCaveats(discovery.entities, caveatContract);
+    const invalidProgress = (entity) => (entity.artifact === "progress" || ["progress_cycle", "progress_summary"].includes(entity.boundary ?? "")) &&
+        entity.classification !== "valid";
+    const progressDiscovery = discovery.entities.some(invalidProgress)
+        ? { ...discovery, entities: discovery.entities.filter((entity) => !invalidProgress(entity)) }
+        : discovery;
+    const progressList = listProgressEntities(projectRoot, 10, {}, undefined, { sourceRoot, format: "json", discovery: progressDiscovery });
     const decisionList = listDecisionEntities(projectRoot, 10, undefined, undefined, { sourceRoot, format: "json", discovery });
     const healthList = listHealthEntities(projectRoot, 10, undefined, undefined, { sourceRoot, format: "json", discovery });
     const planList = listPlanEntities(projectRoot, 2, undefined, { sourceRoot, format: "json", statuses: ["open", "active"], discovery });
@@ -126,7 +137,7 @@ export function collectEntityOrientation(projectRoot, sourceRoot) {
             .sort((left, right) => left.id.localeCompare(right.id))
             .map((entry) => ({ ...entry.record, id: entry.id, artifact: entry.artifact, provenance: { storage: "canonical_entity_file", path: entry.relativePath } }))
         : [];
-    const firstPending = allTaskEntries.find((entry) => !terminal(entry.status));
+    const firstPending = firstActionablePlanTask(allTaskEntries);
     const taskStatusCounts = allTaskEntries.reduce((counts, entry) => {
         const status = String(entry.status ?? "pending").toLowerCase();
         counts[status] = (counts[status] ?? 0) + 1;
@@ -251,6 +262,11 @@ export function collectEntityOrientation(projectRoot, sourceRoot) {
     const decision = firstDecision ? { object: String(firstDecision.id), title: String(record(firstDecision).question ?? "Decision review") } : null;
     const projection = bounded({
         plan, docs, progress, health, objective, todoItems, todoCounts, decision, decisionAttention,
+        glossaryCaveatAttention: glossaryCaveatProjection.attention,
+        glossaryCaveatAttentionPolicy: glossaryCaveatProjection.attention ? {
+            public_limit: glossaryCaveatProjection.publicAttentionLimit,
+            reserved_slots: glossaryCaveatProjection.reservedGlossarySlots,
+        } : null,
         history: {
             progress: projectedHistory(progressList, "progress", progressFullCount, progressSummaryCount, progressHistory),
             decisions: projectedHistory(decisionList, "decisions", decisionFullCount, decisionSummaryCount, decisionHistory),