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

package/dist/analytics/personalGlossaryProfile.js

@@ -0,0 +1,219 @@
+import fs from "node:fs";
+import { loadProfileDecayParameters } from "../capabilities/profile/instructions.js";
+import { writeFileAtomic } from "../core/atomicWriter.js";
+import { GlossaryEntryBoundError, validateGlossaryEntry, } from "../registries/glossaryEntryContract.js";
+import { unicodeCaselessExact } from "../registries/glossaryTermIdentity.js";
+const START = "<!-- agentera:personal-glossary:start -->";
+const END = "<!-- agentera:personal-glossary:end -->";
+const HEADING = "## Glossary";
+const SCHEMA_VERSION = "agentera.personalGlossarySection.v1";
+const DECAY = loadProfileDecayParameters();
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function calendarDate(value) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(value))
+        throw new Error(`expected ISO calendar date, received '${value}'`);
+    const date = new Date(`${value}T00:00:00.000Z`);
+    if (Number.isNaN(date.getTime()) || date.toISOString().slice(0, 10) !== value) {
+        throw new Error(`expected ISO calendar date, received '${value}'`);
+    }
+    return date;
+}
+function daysBetween(from, to) {
+    const days = (calendarDate(to).getTime() - calendarDate(from).getTime()) / 86_400_000;
+    if (days < 0)
+        throw new Error(`as_of ${to} precedes last_confirmed_at ${from}`);
+    return days;
+}
+function count(text, token) {
+    return text.split(token).length - 1;
+}
+function persistedContext(entry) {
+    const retained = new Map();
+    for (const evidence of entry.provenance.evidence) {
+        retained.set(evidence.evidence_anchor, {
+            sourceId: evidence.source_id,
+            sourceKind: "source_kind" in evidence ? evidence.source_kind : "conversation_turn",
+            signalType: "signal_type" in evidence ? evidence.signal_type : "instruction",
+        });
+    }
+    return { retainedHistory: retained };
+}
+function validateEntry(entry, context) {
+    const errors = validateGlossaryEntry(entry, "personal", context);
+    if (errors.length > 0)
+        throw new Error(`invalid personal glossary entry '${String(entry.term)}': ${errors.join("; ")}`);
+}
+function validateUnique(entries, label) {
+    for (const [index, entry] of entries.entries()) {
+        if (entries.slice(0, index).some((candidate) => unicodeCaselessExact(candidate.term, entry.term))) {
+            throw new Error(`${label} contains duplicate Unicode caseless-exact term '${entry.term}'`);
+        }
+    }
+}
+function matchingIndex(entries, term) {
+    return entries.findIndex((entry) => unicodeCaselessExact(entry.term, term));
+}
+function confidenceBasisFor(document, term) {
+    const key = Object.keys(document.confidence_basis).find((candidate) => unicodeCaselessExact(candidate, term));
+    return key === undefined ? Number.NaN : document.confidence_basis[key];
+}
+function parseSection(profile, maxEntries = Number.POSITIVE_INFINITY) {
+    const starts = count(profile, START);
+    const ends = count(profile, END);
+    const headings = [...profile.matchAll(/^## Glossary\s*$/gm)].length;
+    if (starts === 0 && ends === 0 && headings === 0)
+        return { document: null, start: -1, end: -1 };
+    if (starts > 1 || ends > 1 || headings > 1 || (headings > 0 && starts === 0 && ends === 0))
+        throw new PersonalGlossaryBoundaryError("ambiguous");
+    if (starts !== 1 || ends !== 1 || headings !== 1)
+        throw new PersonalGlossaryBoundaryError("malformed");
+    const start = profile.indexOf(START);
+    const end = profile.indexOf(END, start) + END.length;
+    if (start < 0 || end < END.length || end <= start)
+        throw new Error("PROFILE.md Glossary section has malformed or ambiguous owned boundaries");
+    const owned = profile.slice(start, end);
+    const match = new RegExp(`^${START}\n${HEADING}\n\n\`\`\`json\n([\\s\\S]+)\n\`\`\`\n${END}$`).exec(owned);
+    if (!match)
+        throw new Error("PROFILE.md Glossary section is malformed");
+    let value;
+    try {
+        value = JSON.parse(match[1]);
+    }
+    catch {
+        throw new Error("PROFILE.md Glossary section contains invalid JSON");
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("PROFILE.md Glossary section document is malformed");
+    const document = value;
+    if (JSON.stringify(Object.keys(document)) !== JSON.stringify(["schema_version", "as_of", "confidence_basis", "entries"]) || document.schema_version !== SCHEMA_VERSION || !Array.isArray(document.entries) || !document.confidence_basis || typeof document.confidence_basis !== "object" || Array.isArray(document.confidence_basis)) {
+        throw new Error("PROFILE.md Glossary section document is malformed");
+    }
+    if (document.entries.length > maxEntries)
+        throw new GlossaryEntryBoundError("personal glossary exceeds the consumer entry bound");
+    calendarDate(document.as_of);
+    validateUnique(document.entries, "existing personal glossary");
+    const basisKeys = Object.keys(document.confidence_basis);
+    if (basisKeys.length !== document.entries.length || basisKeys.some((key, index) => basisKeys.slice(0, index).some((candidate) => unicodeCaselessExact(candidate, key)) || matchingIndex(document.entries, key) < 0)) {
+        throw new Error("PROFILE.md Glossary section confidence basis is malformed");
+    }
+    for (const entry of document.entries) {
+        validateEntry(entry, persistedContext(entry));
+        const basis = confidenceBasisFor(document, entry.term);
+        if (!Number.isInteger(basis) || basis < 0 || basis > 100)
+            throw new Error("PROFILE.md Glossary section confidence basis is malformed");
+        daysBetween(entry.temporal.last_confirmed_at, document.as_of);
+    }
+    return { document, start, end };
+}
+export class PersonalGlossaryBoundaryError extends Error {
+    availability;
+    constructor(availability) {
+        super("PROFILE.md Glossary section has malformed or ambiguous owned boundaries");
+        this.availability = availability;
+    }
+}
+/** Parse only the owned glossary range and project only consumer-safe fields. */
+export function personalGlossaryConsumerEntries(profile, maxEntries) {
+    const document = parseSection(profile, maxEntries).document;
+    return document?.entries.map(({ term, meaning }) => ({ term, meaning })) ?? null;
+}
+/** Return profile grounding with the validated owned glossary range excluded byte-for-byte. */
+export function personalProfileGrounding(profile) {
+    const section = parseSection(profile);
+    return section.document === null
+        ? profile
+        : `${profile.slice(0, section.start)}${profile.slice(section.end)}`;
+}
+function orderedEntry(entry) {
+    return {
+        term: entry.term,
+        meaning: entry.meaning,
+        confidence: entry.confidence,
+        permanence: entry.permanence,
+        temporal: {
+            observed_at: entry.temporal.observed_at,
+            last_confirmed_at: entry.temporal.last_confirmed_at,
+        },
+        provenance: {
+            kind: entry.provenance.kind,
+            evidence: entry.provenance.evidence.map((item) => ({ ...item })),
+        },
+    };
+}
+function render(document) {
+    return `${START}\n${HEADING}\n\n\`\`\`json\n${JSON.stringify(document, null, 2)}\n\`\`\`\n${END}`;
+}
+export function updatePersonalGlossaryProfile(input) {
+    calendarDate(input.asOf);
+    const original = fs.readFileSync(input.profilePath, "utf8");
+    const section = parseSection(original);
+    if (section.document && calendarDate(input.asOf).getTime() < calendarDate(section.document.as_of).getTime()) {
+        throw new Error("personal glossary as_of cannot move backward");
+    }
+    validateUnique(input.freshEntries, "fresh personal glossary evidence");
+    for (const entry of input.freshEntries)
+        validateEntry(entry, input.retainedHistory);
+    const fresh = input.freshEntries;
+    const established = section.document?.entries ?? [];
+    const merged = [];
+    const confidenceBasis = new Map();
+    const usedFresh = new Set();
+    for (const previous of established) {
+        const freshIndex = matchingIndex(fresh, previous.term);
+        const current = freshIndex >= 0 ? fresh[freshIndex] : undefined;
+        if (freshIndex >= 0)
+            usedFresh.add(freshIndex);
+        let entry;
+        let entryBasis;
+        if (current) {
+            if (previous.meaning !== current.meaning || previous.provenance.kind !== current.provenance.kind) {
+                throw new Error(`personal glossary conflict for established term '${previous.term}'`);
+            }
+            daysBetween(previous.temporal.last_confirmed_at, input.asOf);
+            entryBasis = current.confidence;
+            entry = orderedEntry({
+                ...current,
+                term: previous.term,
+                permanence: previous.permanence,
+                temporal: { observed_at: previous.temporal.observed_at, last_confirmed_at: input.asOf },
+            });
+        }
+        else {
+            entryBasis = confidenceBasisFor(section.document, previous.term);
+            const days = daysBetween(previous.temporal.last_confirmed_at, input.asOf);
+            entry = orderedEntry({
+                ...previous,
+                confidence: Math.max(DECAY.floor, Math.round(entryBasis * Math.exp(-DECAY.lambdas[previous.permanence] * days))),
+            });
+        }
+        merged.push(entry);
+        confidenceBasis.set(entry.term, entryBasis);
+    }
+    for (const [index, current] of fresh.entries()) {
+        if (usedFresh.has(index))
+            continue;
+        const entryBasis = current.confidence;
+        if (calendarDate(current.temporal.observed_at).getTime() > calendarDate(input.asOf).getTime())
+            throw new Error(`observed_at for '${current.term}' is after as_of`);
+        const entry = orderedEntry({
+            ...current,
+            temporal: { observed_at: current.temporal.observed_at, last_confirmed_at: input.asOf },
+        });
+        merged.push(entry);
+        confidenceBasis.set(entry.term, entryBasis);
+    }
+    merged.sort((left, right) => compareText(left.term, right.term));
+    const orderedBasis = Object.fromEntries(merged.map((entry) => [entry.term, confidenceBasis.get(entry.term)]));
+    const document = { schema_version: SCHEMA_VERSION, as_of: input.asOf, confidence_basis: orderedBasis, entries: merged };
+    const rendered = render(document);
+    const candidate = section.document
+        ? `${original.slice(0, section.start)}${rendered}${original.slice(section.end)}`
+        : `${original}${original.endsWith("\n") ? "\n" : "\n\n"}${rendered}\n`;
+    const changed = candidate !== original;
+    if (changed && !input.dryRun)
+        writeFileAtomic(input.profilePath, candidate);
+    return { changed, profilePath: input.profilePath, entries: merged };
+}
+//# sourceMappingURL=personalGlossaryProfile.js.map

package/dist/analytics/personalGlossaryProfile.js.map

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

package/dist/audit/terminologyDrift.js

@@ -0,0 +1,282 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { resolveSourceRoot } from "../core/sourceRoot.js";
+import { loadYamlMappingFile } from "../core/yaml.js";
+import { isSafeProjectSourcePath } from "../registries/glossaryEntryContract.js";
+import { unicodeCaselessExact } from "../registries/glossaryTermIdentity.js";
+import { containsGlossaryTerm } from "../registries/glossaryTermOccurrence.js";
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+/** Deterministic variant ordering only; never use this key for term identity. */
+function variantSortKey(term) {
+    return term.toLowerCase();
+}
+function orderedEvidence(evidence) {
+    return [...evidence].sort((left, right) => compareText(left.source_path, right.source_path)
+        || left.line - right.line
+        || compareText(left.source_record_sha256, right.source_record_sha256));
+}
+function evidenceIdentity(item) {
+    return `${item.source_path}:${item.line}`;
+}
+function proposalWithoutDigest(proposal) {
+    const { proposal_digest: _digest, ...finding } = proposal;
+    return {
+        ...finding,
+        canonical_evidence: orderedEvidence(finding.canonical_evidence),
+        variants: finding.variants
+            .map((variant) => ({ ...variant, evidence: orderedEvidence(variant.evidence) }))
+            .sort((left, right) => compareText(variantSortKey(left.term), variantSortKey(right.term))
+            || compareText(left.term, right.term)),
+    };
+}
+export function canonicalTerminologyJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonicalTerminologyJson).join(",")}]`;
+    if (value !== null && typeof value === "object") {
+        return `{${Object.entries(value)
+            .filter(([, item]) => item !== undefined)
+            .sort(([left], [right]) => compareText(left, right))
+            .map(([key, item]) => `${JSON.stringify(key)}:${canonicalTerminologyJson(item)}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+/** Digest one complete finding while ignoring semantically irrelevant array order. */
+export function terminologyProposalDigest(proposal) {
+    return crypto
+        .createHash("sha256")
+        .update(canonicalTerminologyJson(proposalWithoutDigest(proposal)))
+        .digest("hex");
+}
+function canonicalProposal(seed) {
+    const ordered = seed.terms
+        .map((term) => ({ term: term.term, evidence: orderedEvidence(term.evidence) }))
+        .sort((left, right) => right.evidence.length - left.evidence.length || compareText(left.term, right.term));
+    const [canonical, ...variants] = ordered;
+    const finding = {
+        family: "terminology_drift",
+        concept: seed.concept,
+        proposed_canonical_term: canonical.term,
+        canonical_evidence: canonical.evidence,
+        variants: variants.sort((left, right) => compareText(variantSortKey(left.term), variantSortKey(right.term))
+            || compareText(left.term, right.term)),
+        severity: seed.confidence < 70 ? "info" : seed.severity,
+        confidence: seed.confidence,
+        ...(seed.personal_divergence ? { personal_divergence: seed.personal_divergence } : {}),
+    };
+    return { ...finding, proposal_digest: terminologyProposalDigest(finding) };
+}
+function mapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function exactFields(value, allowed) {
+    return Object.keys(value).every((field) => allowed.includes(field));
+}
+function proposalEvidence(value, label, violations) {
+    if (!mapping(value) || !exactFields(value, ["source_path", "line", "source_record_sha256"])) {
+        violations.push(`${label} must contain only source_path, line, and source_record_sha256`);
+        return null;
+    }
+    if (!isSafeProjectSourcePath(value.source_path)
+        || !Number.isInteger(value.line)
+        || Number(value.line) < 1
+        || typeof value.source_record_sha256 !== "string"
+        || !/^[a-f0-9]{64}$/.test(value.source_record_sha256)) {
+        violations.push(`${label} must identify one safe project-relative source line with a lowercase SHA-256`);
+        return null;
+    }
+    return value;
+}
+/** Validate and normalize the complete finding shape that Audit itself can emit. */
+export function validateTerminologyProposal(value) {
+    const violations = [];
+    const fields = ["family", "concept", "proposed_canonical_term", "canonical_evidence", "variants", "severity", "confidence", "personal_divergence", "proposal_digest"];
+    if (!mapping(value) || !exactFields(value, fields)) {
+        return { proposal: null, violations: ["proposal must be one complete terminology_drift finding with no undeclared fields"] };
+    }
+    if (value.family !== "terminology_drift")
+        violations.push("proposal family must be terminology_drift");
+    if (typeof value.concept !== "string" || value.concept.trim() === "")
+        violations.push("proposal concept must be non-empty");
+    if (typeof value.proposed_canonical_term !== "string" || value.proposed_canonical_term.trim() === "")
+        violations.push("proposed canonical term must be non-empty");
+    if (!["critical", "warning", "info"].includes(String(value.severity)))
+        violations.push("proposal severity is invalid");
+    const minimumConfidence = confidenceFloor();
+    if (!Number.isInteger(value.confidence) || Number(value.confidence) < minimumConfidence || Number(value.confidence) > 100) {
+        violations.push(`proposal confidence must be an integer from ${minimumConfidence} through 100`);
+    }
+    if (Number.isInteger(value.confidence) && Number(value.confidence) < 70 && value.severity !== "info") {
+        violations.push("confidence below 70 requires info severity");
+    }
+    if (typeof value.proposal_digest !== "string" || !/^[a-f0-9]{64}$/.test(value.proposal_digest))
+        violations.push("proposal_digest must be a lowercase SHA-256");
+    const terms = [];
+    const readTerm = (term, records, label) => {
+        if (typeof term !== "string" || term.trim() === "") {
+            violations.push(`${label} term must be non-empty`);
+            return;
+        }
+        if (!Array.isArray(records) || records.length === 0) {
+            violations.push(`${label} evidence must be non-empty`);
+            return;
+        }
+        const parsed = records
+            .map((record, index) => proposalEvidence(record, `${label}[${index}]`, violations))
+            .filter((record) => record !== null);
+        if (new Set(parsed.map(evidenceIdentity)).size !== parsed.length) {
+            violations.push(`${label} identities must be distinct`);
+        }
+        terms.push({ term, evidence: parsed });
+    };
+    readTerm(value.proposed_canonical_term, value.canonical_evidence, "canonical_evidence");
+    if (!Array.isArray(value.variants) || value.variants.length === 0) {
+        violations.push("proposal variants must be non-empty");
+    }
+    else {
+        value.variants.forEach((variant, index) => {
+            if (!mapping(variant) || !exactFields(variant, ["term", "evidence"])) {
+                violations.push(`variants[${index}] must contain only term and evidence`);
+                return;
+            }
+            readTerm(variant.term, variant.evidence, `variants[${index}].evidence`);
+        });
+    }
+    if (terms.some((term, index) => terms.slice(0, index).some((candidate) => unicodeCaselessExact(candidate.term, term.term)))) {
+        violations.push("proposal term identities must be Unicode caseless-exact unique");
+    }
+    let divergence;
+    if (value.personal_divergence !== undefined) {
+        if (!mapping(value.personal_divergence)
+            || !exactFields(value.personal_divergence, ["personal_term", "project_term"])
+            || typeof value.personal_divergence.personal_term !== "string"
+            || value.personal_divergence.personal_term.trim() === ""
+            || value.personal_divergence.project_term !== value.proposed_canonical_term)
+            violations.push("personal_divergence must bind a non-empty personal term to the proposed project term");
+        else
+            divergence = value.personal_divergence;
+    }
+    if (violations.length > 0 || terms.length < 2)
+        return { proposal: null, violations };
+    const expected = canonicalProposal({
+        family: "terminology_drift",
+        concept: value.concept,
+        terms,
+        severity: value.severity,
+        confidence: value.confidence,
+        ...(divergence ? { personal_divergence: divergence } : {}),
+    });
+    if (expected.proposed_canonical_term !== value.proposed_canonical_term)
+        violations.push("proposed canonical term is not the best-supported term under the Audit tie-break");
+    if (canonicalTerminologyJson(proposalWithoutDigest(expected)) !== canonicalTerminologyJson(proposalWithoutDigest(value))) {
+        violations.push("proposal shape or ordering is not the canonical Audit output");
+    }
+    if (expected.proposal_digest !== value.proposal_digest)
+        violations.push("proposal_digest does not match the canonical Audit output");
+    return { proposal: violations.length === 0 ? expected : null, violations };
+}
+function confidenceFloor() {
+    const protocol = loadYamlMappingFile(path.join(resolveSourceRoot(), "skills", "agentera", "protocol.yaml"));
+    const scale = protocol.CONFIDENCE_SCALE;
+    const range = scale?.["3"]?.range;
+    if (!Array.isArray(range) || !Number.isInteger(range[0])) {
+        throw new Error("protocol CONFIDENCE_SCALE CS3 lower bound is unavailable");
+    }
+    return Number(range[0]);
+}
+function verifiedEvidence(projectRoot, term, evidence) {
+    const root = fs.realpathSync(projectRoot);
+    const verified = [];
+    const identities = new Set();
+    for (const item of evidence) {
+        if (!Number.isInteger(item.line) || item.line < 1 || !isSafeProjectSourcePath(item.source_path))
+            return null;
+        const pathname = path.resolve(root, item.source_path);
+        if (pathname !== root && !pathname.startsWith(`${root}${path.sep}`))
+            return null;
+        let realPath;
+        try {
+            realPath = fs.realpathSync(pathname);
+        }
+        catch {
+            return null;
+        }
+        if (!realPath.startsWith(`${root}${path.sep}`) || !fs.statSync(realPath).isFile())
+            return null;
+        const line = fs.readFileSync(realPath, "utf8").split(/\r?\n/)[item.line - 1];
+        if (line === undefined || !containsGlossaryTerm(line, term))
+            return null;
+        const sourcePath = path.relative(root, realPath).split(path.sep).join(path.posix.sep);
+        const identity = `${sourcePath}:${item.line}`;
+        if (identities.has(identity))
+            continue;
+        identities.add(identity);
+        verified.push({
+            source_path: sourcePath,
+            line: item.line,
+            source_record_sha256: crypto.createHash("sha256").update(line).digest("hex"),
+        });
+    }
+    return verified.length > 0 ? verified : null;
+}
+/** Generate findings from assessed concepts without writing project or personal state. */
+export function assessTerminologyDrift(input) {
+    const minimumConfidence = confidenceFloor();
+    const findings = [];
+    for (const concept of input.concepts) {
+        if (concept.confidence < minimumConfidence ||
+            concept.confidence > 100 ||
+            !Number.isInteger(concept.confidence) ||
+            input.deliberateDecisionConcepts.has(concept.concept) ||
+            input.trackedIssueConcepts.has(concept.concept))
+            continue;
+        const consolidated = [];
+        let invalidEvidence = false;
+        for (const candidate of concept.terms) {
+            const term = candidate.term.trim();
+            const evidence = term ? verifiedEvidence(input.projectRoot, term, candidate.evidence) : null;
+            if (!evidence) {
+                invalidEvidence = true;
+                break;
+            }
+            const group = consolidated.find((item) => unicodeCaselessExact(item.term, term)) ?? { term, evidence: new Map() };
+            for (const item of evidence)
+                group.evidence.set(`${item.source_path}:${item.line}`, item);
+            if (!consolidated.includes(group))
+                consolidated.push(group);
+        }
+        if (invalidEvidence || consolidated.length < 2)
+            continue;
+        const terms = consolidated.map((term) => ({
+            term: term.term,
+            evidence: orderedEvidence([...term.evidence.values()]),
+        }));
+        const seed = {
+            family: "terminology_drift",
+            concept: concept.concept,
+            terms,
+            severity: concept.severity,
+            confidence: concept.confidence,
+        };
+        let finding = canonicalProposal(seed);
+        const personalTerm = input.personalTerms?.get(concept.concept)?.trim();
+        if (personalTerm && !unicodeCaselessExact(personalTerm, finding.proposed_canonical_term)) {
+            finding = canonicalProposal({
+                ...seed,
+                personal_divergence: {
+                    personal_term: personalTerm,
+                    project_term: finding.proposed_canonical_term,
+                },
+            });
+        }
+        const validated = validateTerminologyProposal(finding);
+        if (!validated.proposal)
+            throw new Error(`Audit produced an invalid terminology proposal: ${validated.violations.join("; ")}`);
+        findings.push(validated.proposal);
+    }
+    return findings;
+}
+//# sourceMappingURL=terminologyDrift.js.map

package/dist/audit/terminologyDrift.js.map

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

package/dist/capabilities/audit/instructions.js

@@ -12,5 +12,6 @@ Publish a completed audit with \`agentera state health append --input PATH --for
     .replaceAll("`.agentera/progress.yaml`", "the progress entity view")
     .replaceAll("`.agentera/health.yaml`", "the health entity view")
     .replaceAll("`.agentera/plan.yaml`", "the plan entity view")
-    .replace("The writer assigns the audit number, validates the candidate and final compacted bytes, and applies shared retention before publishing.", "The writer assigns a bare ID, validates the entity, and publishes one canonical file.");
+    .replace("The writer assigns the audit number, validates the candidate and final compacted bytes, and applies shared retention before publishing.", "The writer assigns a bare ID, validates the entity, and publishes one canonical file.")
+    .replace("Lean on `evidence_context.source_contract` from `agentera prime --context audit --format json` for evaluation startup. Do not re-encode its machine-readable rules in prose.", "Lean on `evidence_context.source_contract` from `agentera prime --context audit --format json` for evaluation startup. Do not re-encode its machine-readable rules in prose.\n\n## Terminology-drift findings\n\nAudit implements one mutation-free, read-only terminology-drift finding family. Assess cited project-file terms for one concept, propose the best-supported canonical term, retain project-file evidence for every drift variant, and emit the deterministic proposal digest consumed by the typed publication path. Compare optional personal PROFILE usage without writing profile state. Apply the existing confidence, deliberate-decision, and tracked-TODO filters; weak, known, tracked, and no-drift evidence yields no finding. A proposal is not approval: Build project-glossary publication is active and requires proposal-specific user confirmation. Audit never performs consumer lookup or mutation; Discuss, Plan, and Build use the separate active read-only advice path. Personal-profile mutation and docs-mapping mutation remain outside both paths.");
 //# sourceMappingURL=instructions.js.map

package/dist/capabilities/audit/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../../../../home/jgabor/git/agentera/packages/cli/src/capabilities/audit/instructions.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAAW,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAA,uymBAAuymB,CAAC,CAAC;AACl2mB,eAAe,YAAY;KACxB,OAAO,CAAC,8CAA8C,EAAE;;;;;;mBAMxC,CAAC;KACjB,UAAU,CAAC,4BAA4B,EAAE,2BAA2B,CAAC;KACrE,UAAU,CAAC,2BAA2B,EAAE,0BAA0B,CAAC;KACnE,UAAU,CAAC,yBAAyB,EAAE,wBAAwB,CAAC;KAC/D,UAAU,CAAC,uBAAuB,EAAE,sBAAsB,CAAC;KAC3D,OAAO,CAAC,yIAAyI,EAAE,uFAAuF,CAAC,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../../../../home/jgabor/git/agentera/packages/cli/src/capabilities/audit/instructions.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAAW,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAA,uymBAAuymB,CAAC,CAAC;AACl2mB,eAAe,YAAY;KACxB,OAAO,CAAC,8CAA8C,EAAE;;;;;;mBAMxC,CAAC;KACjB,UAAU,CAAC,4BAA4B,EAAE,2BAA2B,CAAC;KACrE,UAAU,CAAC,2BAA2B,EAAE,0BAA0B,CAAC;KACnE,UAAU,CAAC,yBAAyB,EAAE,wBAAwB,CAAC;KAC/D,UAAU,CAAC,uBAAuB,EAAE,sBAAsB,CAAC;KAC3D,OAAO,CAAC,yIAAyI,EAAE,uFAAuF,CAAC;KAC3O,OAAO,CAAC,8KAA8K,EAAE,+hCAA+hC,CAAC,CAAC"}

package/dist/capabilities/build/instructions.js

@@ -6,13 +6,52 @@ export default instructions
 
 Progress, plans, health audits, and decisions use entity authority: each record has \`id\` and \`artifact\`, lives in one writer-owned entity file, and is read through exact, list, or bounded CLI commands. Use \`agentera state <artifact> explain --format json\` before every supported mutation; never edit entity paths directly. Vision, docs policy, changelog, design, and profile remain intentional singletons.
 
-Build appends progress with \`agentera state progress append\`, advances a plan task with its bare ID through \`agentera state plan set-status --id ID\`, and reads context from \`agentera prime --context build --format json\` plus declared fallback commands. Root \`TODO.md\` and \`CHANGELOG.md\` remain capability-owned editorial files.
+Build appends progress with \`agentera state progress append\`, advances a plan task with its bare ID through \`agentera state plan set-status --id ID\`, and is the sole owner of explicitly confirmed project terminology publication through \`agentera state glossary publish --input REQUEST\`. Glossary publication records the approval and shared entry atomically; it does not authorize glossary lookup, personal-profile mutation, or docs-mapping mutation. Build reads context from \`agentera prime --context build --format json\` plus declared fallback commands. When no current executable plan exists, explicit transient work may instead start through \`agentera prime --context build --input <file|-> --format json\` with an \`agentera.buildExecutionRequest.v1\` mapping containing exactly \`schema_version\`, \`scope\`, and \`acceptance\`. This input is bounded, read-only, never persists or creates plan state, and conflicts with current plan-owned execution. Read profile grounding only from the \`content\` returned by \`agentera report profile-grounding --format json\`; never direct-read the profile path. The grounding command excludes the owned personal Glossary section and fails closed when its boundaries are malformed. Root \`TODO.md\` and \`CHANGELOG.md\` remain capability-owned editorial files.
 
 ## Workflow phases: The cycle`)
     .replaceAll("--number N", "--id ID")
     .replaceAll("--task N", "--id ID")
+    .replace("Use `status.profile` for profile summary; stale or missing profile is a caveat, not approval to refresh profile state.", `Use \`status.profile\` for profile summary; stale or missing profile is a caveat, not approval to refresh profile state.
+
+#### Governed terminology advice
+
+At initial meaning-sensitive cycle intent, request acquisition and advice with the structured, headless interface declared by \`agentera report glossary-advice --help\` and the vocabulary authority. Repeat only when a later user-authored requirement, intent, acceptance change, cycle-intent change, or clarification answer can alter the affected meaning. Do not refresh for unchanged replay, unrelated turns, background rereads, rendering, or tool output.
+
+Use only \`advice.applicable_meaning\` with \`advice.applicable_owner\`: an exact project entry governs, including an exact divergent collision, while a personal entry applies only after the CLI proves a valid project gap. Invalid or unavailable acquisition abstains; never fabricate fallback. Preserve bounded tension without changing authority.
+
+When \`review\` requires acknowledgment before disputed reliance and interaction is available, ask one focused clarification before meaning-sensitive execution. Re-run advice only for that affected meaning using the clarification answer and an authority-declared host review when applicable. Clarification is not approval or publication consent.
+
+When autonomous or no-pause execution cannot resolve required review, do not use the disputed meaning. Continue only conservatively safe work and append one Build-owned \`glossary_caveat\` current event through \`agentera state progress append\`; discover its exact flags with \`agentera state progress explain --verb append --format json\`. The writer assigns an opaque caveat identity, suppresses duplicate current events, and supports explicit resolved or superseded lifecycle events after a governed refresh. Never put a term, meaning, definition, anchor, path, raw section, provenance, or clock expiry in the caveat.
+
+Advice, tension, clarification, and caveat lifecycle never call \`agentera state glossary publish\`, create or reuse an approval, replace proposal-digest confirmation, satisfy decisions or plan state, or grant Discuss or Audit publication authority. Explicit project publication remains the separate Build-owned digest-confirmed operation.`)
     .replaceAll("progress.yaml aggregate cycle entry", "progress entity record")
+    .replace("Every cycle runs the effective profile.", "Every cycle uses only the sanitized non-glossary profile content returned by `agentera report profile-grounding --format json`.")
     .replaceAll("**Dual-write**: build maintains `.agentera/progress.yaml` and root `CHANGELOG.md`.", "Build records entity progress through the typed writer and maintains root `CHANGELOG.md` separately.")
     .replaceAll("`.agentera/health.yaml` findings", "Health findings returned by `agentera state health list --format json`")
-    .replace("If `.agentera/plan.yaml` has `header.status: complete` and every task is complete", "If the selected plan entity is complete and every related task entity is complete");
+    .replace("If `.agentera/plan.yaml` has `header.status: complete` and every task is complete", "If the selected plan entity is complete and every related task entity is complete")
+    .replace("orient through log, exit signal reported", "orient through commit, exit signal reported")
+    .replace("Steps: orient, select, research, plan, dispatch, verify, commit, log.", "Steps: orient, select, research, plan, dispatch, verify, log, commit.")
+    .replace("implemented, verified, committed, artifacts updated", "implemented, verified, artifacts updated, committed")
+    .replace(/### Step 7: Commit[\s\S]*?Then stop\. One cycle complete\./, `### Step 7: Log
+
+**Before writing**, run \`agentera check lint --artifact <artifact> --text "<draft>"\` (or \`--file <path>\`) on the draft entry to check verbosity overruns, abstraction creep, and filler accumulation. Max 3 revision attempts. Flag with \`[post-audit-flagged]\` if still failing.
+
+Build records entity progress through the typed writer and maintains root \`CHANGELOG.md\` separately. Complete every required artifact update before committing so implementation, tests, and cycle state land together.
+
+- **TODO.md**: add newly discovered open issues in severity bands with \`- [ ]\`. Move completed work to \`## ✓ Resolved\` as \`- [x]\` with a resolution summary.
+- **progress**: run \`agentera state progress append --type TYPE --phase build --what TEXT --intent TEXT --verified TEXT --format json\`. The writer assigns \`id\`, \`artifact\`, and \`publication_order\`, validates the record, atomically publishes one entity, and returns post-write state.
+- **CHANGELOG.md**: append a one-line entry under \`## [Unreleased]\`.
+- **plan**: when a plan task closes, run \`agentera state plan set-status --id ID --status complete --format json\` rather than editing the plan directly.
+
+TODO.md Resolved compaction follows the 10/40/50 cap via the validate-artifact hook or \`agentera check compact --mode fix\`.
+
+### Step 8: Commit
+
+Commit once with a conventional commit message: \`type(scope): summary\`.
+
+Types: \`feat\`, \`fix\`, \`docs\`, \`refactor\`, \`chore\`, \`test\`. Include implementation, tests, and all required artifact updates. MUST NOT commit partial or broken work.
+
+If the current task is a version bump: read \`.agentera/docs.yaml\` for the \`versioning\` section. Update every file in \`version_files\` before committing.
+
+Then stop. One cycle complete.`);
 //# sourceMappingURL=instructions.js.map

package/dist/capabilities/build/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../../../../home/jgabor/git/agentera/packages/cli/src/capabilities/build/instructions.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAAW,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAA,26gBAA26gB,CAAC,CAAC;AACt+gB,eAAe,YAAY;KACxB,OAAO,CAAC,yDAAyD,EAAE;;;;;;8BAMxC,CAAC;KAC5B,UAAU,CAAC,YAAY,EAAE,SAAS,CAAC;KACnC,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC;KACjC,UAAU,CAAC,qCAAqC,EAAE,wBAAwB,CAAC;KAC3E,UAAU,CAAC,oFAAoF,EAAE,sGAAsG,CAAC;KACxM,UAAU,CAAC,kCAAkC,EAAE,wEAAwE,CAAC;KACxH,OAAO,CAAC,mFAAmF,EAAE,mFAAmF,CAAC,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../../../../../../home/jgabor/git/agentera/packages/cli/src/capabilities/build/instructions.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAAW,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAA,26gBAA26gB,CAAC,CAAC;AACt+gB,eAAe,YAAY;KACxB,OAAO,CAAC,yDAAyD,EAAE;;;;;;8BAMxC,CAAC;KAC5B,UAAU,CAAC,YAAY,EAAE,SAAS,CAAC;KACnC,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC;KACjC,OAAO,CAAC,wHAAwH,EAAE;;;;;;;;;;;;oVAY+M,CAAC;KAClV,UAAU,CAAC,qCAAqC,EAAE,wBAAwB,CAAC;KAC3E,OAAO,CAAC,yCAAyC,EAAE,iIAAiI,CAAC;KACrL,UAAU,CAAC,oFAAoF,EAAE,sGAAsG,CAAC;KACxM,UAAU,CAAC,kCAAkC,EAAE,wEAAwE,CAAC;KACxH,OAAO,CAAC,mFAAmF,EAAE,mFAAmF,CAAC;KACjL,OAAO,CAAC,0CAA0C,EAAE,6CAA6C,CAAC;KAClG,OAAO,CAAC,uEAAuE,EAAE,uEAAuE,CAAC;KACzJ,OAAO,CAAC,qDAAqD,EAAE,qDAAqD,CAAC;KACrH,OAAO,CAAC,4DAA4D,EAAE;;;;;;;;;;;;;;;;;;;;;+BAqB1C,CAAC,CAAC"}