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

package/dist/cli/planEvidence.js

@@ -0,0 +1,158 @@
+import { artifactPath } from "./appContext.js";
+import { asList, loadArtifact } from "./stateQuery.js";
+/**
+ * These phrases are the stable progress-to-task joins for the completed
+ * lifecycle plan. They intentionally match task-specific progress language,
+ * rather than every cycle that happens to mention a shared runtime concept.
+ */
+const LIFECYCLE_PROGRESS_MATCHES = {
+    "1": "canonical runtime lifecycle projection for task 1",
+    "2": "defined default preview and explicit apply semantics",
+    "3": "task 3 ownership-safe repair",
+    "4": "drove project integration from the canonical runtime lifecycle projection",
+    "5": "surface bounded lifecycle attention rows",
+    "6": "verified runtime lifecycle selectors, ownership safety, preview purity",
+    "7": "verified task 7 consumer and distribution parity",
+    "8": "synchronized packages/cli/package.json dev.17",
+};
+function isMapping(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function hasRecordedEvidence(value) {
+    if (Array.isArray(value))
+        return value.some((item) => hasRecordedEvidence(item));
+    if (value !== null && typeof value === "object")
+        return Object.keys(value).length > 0;
+    return value !== null && value !== undefined && String(value).trim().length > 0;
+}
+function cycleNumber(value) {
+    if (typeof value === "number" && Number.isInteger(value))
+        return value;
+    if (typeof value === "string" && value.trim())
+        return /^\d+$/.test(value.trim()) ? Number(value) : value.trim();
+    return null;
+}
+function progressEvidenceRecords(schemas) {
+    const info = schemas.progress;
+    if (!info)
+        return [];
+    const progressPath = artifactPath(info, "progress");
+    const data = loadArtifact(progressPath);
+    if (!isMapping(data))
+        return [];
+    const records = [];
+    for (const raw of asList(data.cycles)) {
+        if (!isMapping(raw))
+            continue;
+        const number = cycleNumber(raw.number);
+        const what = String(raw.what ?? "").trim();
+        if (number === null || !what)
+            continue;
+        const verified = String(raw.verified ?? "").trim();
+        records.push({
+            cycleNumber: number,
+            artifactPath: progressPath,
+            field: verified ? "verified" : "what",
+            detail: verified || what,
+            matchText: what.toLowerCase(),
+        });
+    }
+    for (const raw of asList(data.archive)) {
+        if (!isMapping(raw))
+            continue;
+        const summary = String(raw.summary ?? "").trim();
+        const match = /^Cycle\s+(\d+)\b/i.exec(summary);
+        if (!match || !summary)
+            continue;
+        records.push({
+            cycleNumber: Number(match[1]),
+            artifactPath: progressPath,
+            field: "summary",
+            detail: summary,
+            matchText: summary.toLowerCase(),
+        });
+    }
+    return records;
+}
+function progressMatch(task, records) {
+    const number = String(task.number ?? "");
+    const phrase = LIFECYCLE_PROGRESS_MATCHES[number];
+    if (!phrase)
+        return null;
+    const matches = records
+        .filter((record) => record.matchText.includes(phrase))
+        .sort((a, b) => {
+        const aNumber = typeof a.cycleNumber === "number" ? a.cycleNumber : Number.MAX_SAFE_INTEGER;
+        const bNumber = typeof b.cycleNumber === "number" ? b.cycleNumber : Number.MAX_SAFE_INTEGER;
+        return aNumber - bNumber || a.detail.localeCompare(b.detail);
+    });
+    return matches.length > 0 ? { record: matches[0], phrase } : null;
+}
+function supportsLifecycleProgressJoin(artifact) {
+    const header = isMapping(artifact.data.header) ? artifact.data.header : {};
+    const title = String(header.title ?? artifact.data.title ?? "").toLowerCase();
+    return title.includes("runtime lifecycle");
+}
+function progressProvenance(match, task) {
+    return {
+        source_family: "progress",
+        source_kind: match.record.field === "summary" ? "typed_writer_archive" : "typed_writer_cycle",
+        artifact_path: match.record.artifactPath,
+        cycle_number: match.record.cycleNumber,
+        field: match.record.field,
+        task_number: task.number ?? null,
+        deterministic_match: match.phrase,
+        detail: match.record.detail,
+    };
+}
+function planProvenance(planPath, task) {
+    return {
+        source_family: "plan",
+        source_kind: "immutable_archive",
+        artifact_path: planPath,
+        field: `tasks[${String(task.number ?? "?")}].evidence`,
+        task_number: task.number ?? null,
+    };
+}
+/**
+ * Project evidence into the read-only state response. Existing plan evidence
+ * remains intact; missing evidence is resolved only through a deterministic
+ * join to typed progress cycles or compacted writer summaries.
+ */
+export function resolvePlanTaskEvidence(artifact, tasks, schemas) {
+    const records = supportsLifecycleProgressJoin(artifact) ? progressEvidenceRecords(schemas) : [];
+    const sources = new Set();
+    let complete = true;
+    const resolved = tasks.map((task) => {
+        const stored = hasRecordedEvidence(task.evidence);
+        const match = stored ? null : progressMatch(task, records);
+        const provenance = [];
+        let evidence = task.evidence;
+        if (stored) {
+            provenance.push(planProvenance(artifact.path, task));
+            sources.add("plan");
+        }
+        else if (match) {
+            evidence = [{
+                    source: "progress",
+                    cycle_number: match.record.cycleNumber,
+                    field: match.record.field,
+                    detail: match.record.detail,
+                }];
+            provenance.push(progressProvenance(match, task));
+            sources.add("progress");
+        }
+        else {
+            evidence = [];
+            complete = false;
+        }
+        return {
+            ...task,
+            evidence,
+            evidence_status: hasRecordedEvidence(evidence) ? "present" : "missing",
+            evidence_provenance: provenance,
+        };
+    });
+    return { tasks: resolved, complete, sources: [...sources].sort() };
+}
+//# sourceMappingURL=planEvidence.js.map

package/dist/cli/planEvidence.js.map

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

package/dist/cli/planLifecycleState.js

@@ -0,0 +1,36 @@
+import { entityListFamily } from "../state/entityRetrievalHelp.js";
+import { sourceProvenance } from "./capabilityContext/shared.js";
+import { asList } from "./stateQuery.js";
+const PLAN_LIST_COMMAND = `agentera state ${entityListFamily("plans").commandTokens.join(" ")} list --format json`;
+function diagnosticEntries(value) {
+    return asList(value).filter((entry) => Boolean(entry && typeof entry === "object" && !Array.isArray(entry)));
+}
+/** Shared lifecycle health projection for status and plan-consuming capabilities. */
+export function planLifecycleState(plan) {
+    const diagnostics = diagnosticEntries(plan.diagnostics);
+    const degradedDiagnostics = diagnostics.filter((diagnostic) => diagnostic.category !== "legacy");
+    const exists = Boolean(plan.exists);
+    const active = plan.active === true;
+    const activePath = typeof plan.active_path === "string" ? plan.active_path : null;
+    const currentDiagnostics = activePath
+        ? degradedDiagnostics.filter((diagnostic) => diagnostic.path === activePath)
+        : degradedDiagnostics;
+    const currentPlanDegraded = currentDiagnostics.length > 0;
+    const status = degradedDiagnostics.length > 0 ? "degraded" : !exists ? "unavailable" : active ? "available" : "history_only";
+    return {
+        status,
+        diagnostic_count: degradedDiagnostics.length,
+        diagnostics: degradedDiagnostics,
+        current_plan_degraded: currentPlanDegraded,
+        execution_eligible: active && !currentPlanDegraded,
+        source_provenance: sourceProvenance("plan", PLAN_LIST_COMMAND, "source.diagnostics"),
+        caveats: status === "degraded"
+            ? [
+                currentPlanDegraded
+                    ? "Current plan lifecycle data is degraded; executable plan work is withheld until it is repaired."
+                    : "Historical plan lifecycle data is degraded; archived plans remain non-executable.",
+            ]
+            : [],
+    };
+}
+//# sourceMappingURL=planLifecycleState.js.map

package/dist/cli/planLifecycleState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planLifecycleState.js","sourceRoot":"","sources":["../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/cli/planLifecycleState.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,iBAAiB,GAAG,kBAAkB,gBAAgB,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC;AAEnH,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CACzB,CAAC,KAAK,EAAuB,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CACrG,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,IAAgB;IACjD,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxD,MAAM,mBAAmB,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IACjG,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;IACpC,MAAM,UAAU,GAAG,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,MAAM,kBAAkB,GAAG,UAAU;QACnC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC;QAC5E,CAAC,CAAC,mBAAmB,CAAC;IACxB,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1D,MAAM,MAAM,GACV,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC;IAChH,OAAO;QACL,MAAM;QACN,gBAAgB,EAAE,mBAAmB,CAAC,MAAM;QAC5C,WAAW,EAAE,mBAAmB;QAChC,qBAAqB,EAAE,mBAAmB;QAC1C,kBAAkB,EAAE,MAAM,IAAI,CAAC,mBAAmB;QAClD,iBAAiB,EAAE,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,oBAAoB,CAAC;QACpF,OAAO,EACL,MAAM,KAAK,UAAU;YACnB,CAAC,CAAC;gBACE,mBAAmB;oBACjB,CAAC,CAAC,iGAAiG;oBACnG,CAAC,CAAC,mFAAmF;aACxF;YACH,CAAC,CAAC,EAAE;KACT,CAAC;AACJ,CAAC"}

package/dist/cli/planTaskIndex.js

@@ -0,0 +1,12 @@
+const indexes = new WeakMap();
+/** Retain the complete canonical task graph for in-process capability projections. */
+export function rememberPlanTaskIndex(plan, tasks) {
+    indexes.set(plan, tasks);
+}
+/** Public plan projections remain bounded; orchestration reads this exact internal graph. */
+export function planTaskIndex(plan) {
+    return indexes.get(plan) ?? (Array.isArray(plan.tasks)
+        ? plan.tasks.filter((task) => Boolean(task) && typeof task === "object" && !Array.isArray(task))
+        : []);
+}
+//# sourceMappingURL=planTaskIndex.js.map

package/dist/cli/planTaskIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planTaskIndex.js","sourceRoot":"","sources":["../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/cli/planTaskIndex.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG,IAAI,OAAO,EAAwB,CAAC;AAEpD,sFAAsF;AACtF,MAAM,UAAU,qBAAqB,CAAC,IAAgB,EAAE,KAAmB;IACzE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,aAAa,CAAC,IAAgB;IAC5C,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QACpD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAsB,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpH,CAAC,CAAC,EAAE,CAAC,CAAC;AACV,CAAC"}

package/dist/cli/prime-blob.js

@@ -1,3 +1,71 @@
-// AUTO-PORTED from scripts/agentera PRIME_BLOB. Byte-exact.
-export const PRIME_BLOB = "# agentera priming guide\n\n## Routing: agentera vs native tools\n\nUse top-level `agentera <state>` commands for routine questions about project state.\nUse native tools (read, grep, glob, edit, bash) for source code operations.\n\nagentera queries return compact answers from structured state. Do NOT read\nraw YAML artifacts directly. The CLI is the seam between agent and state.\n\nSupported state commands:\n  agentera prime                                # Composite orientation briefing\n  agentera prime --guidance                     # Print this guide\n  agentera state decisions [--topic TOPIC]      # Decision log\n  agentera state health [--dimension DIM]       # Latest health audit\n  agentera state todo [--severity LEVEL]        # TODO summary\n  agentera state plan                           # Active plan + task status\n  agentera state progress [--limit N]           # Recent cycle summary\n  agentera state docs                           # Docs mappings + stale docs\n  agentera state objective                      # Active optimera objective\n  agentera state experiments                    # Active optimera experiments\n  agentera check lint --artifact PROGRESS.md --file .agentera/progress.yaml  # Pre-write artifact prose self-audit\n  agentera state query --list-artifacts         # Discover advanced schema names\n  agentera state query <artifact-name>          # Advanced custom artifact query\n\nWhen to use agentera:\n  - \"What did we decide about X?\"       \u2192 agentera state decisions --topic X\n  - \"How's the codebase health?\"        \u2192 agentera state health\n  - \"What's the coupling grade?\"        \u2192 agentera state health --dimension coupling_health\n  - \"Any critical open issues?\"         \u2192 agentera state todo --severity critical\n\nWhen to use native tools:\n  - Reading or editing source code      \u2192 native read/edit/grep\n  - Searching files                     \u2192 native glob/grep\n  - Running commands                    \u2192 native bash\n  - Browsing the web                    \u2192 native fetch\n\n## Recovery: stale or missing artifacts\n\nIf `agentera <state>` returns empty:\n  1. The artifact may not exist yet (no data has been written to it).\n  2. Run without filters to see all available data.\n  3. If data is stale, the producing capability needs to run again.\n\nIf artifacts are corrupted:\n  1. Check the YAML file in .agentera/ directly.\n  2. Run `agentera schema --format json` and use `source.schemas_dir`.\n  3. Re-run the producing capability to regenerate the artifact.\n\nIf schemas are missing:\n  1. Run `agentera schema --format json`.\n  2. Make sure Agentera's app files exist at the reported `managedAppRoot` path.\n  3. Run `agentera doctor` for a plain-language repair preview.\n";
+export const PRIME_BLOB = [
+    "# agentera priming guide",
+    "",
+    "## Routing: agentera vs native tools",
+    "",
+    "Use top-level `agentera <state>` commands for routine questions about project state.",
+    "Use native tools (read, grep, glob, edit, bash) for source code operations.",
+    "",
+    "Agentera queries return compact answers from structured state. Do NOT read",
+    "raw YAML artifacts directly. The CLI is the seam between agent and state.",
+    "",
+    "For supported artifact mutations, use the typed state writer instead of native",
+    "file edits. Discover the live fields and examples before constructing a write:",
+    "  agentera state <artifact> explain --format json",
+    "  agentera state <artifact> explain --verb <verb> --format json",
+    "",
+    "Supported state commands:",
+    "  agentera prime                                # Composite orientation briefing",
+    "  agentera prime --guidance                     # Print this guide",
+    "  agentera state decisions [--topic TOPIC]      # Decision log",
+    "  agentera state health [--dimension DIM]       # Latest health audit",
+    "  agentera state todo [--severity LEVEL]        # TODO summary",
+    "  agentera state plan                           # Plans, task evidence + provenance",
+    "  agentera state progress [--limit N]           # Recent cycle summary",
+    "  agentera state docs                           # Docs mappings + stale docs",
+    "  agentera state objective                      # Active optimize objective",
+    "  agentera state experiments                    # Active optimize experiments",
+    "  agentera check lint --artifact PLAN.md --file plan.yaml  # Optional draft prose preview; the writer validates published bytes",
+    "  agentera state query --list-artifacts         # Discover advanced schema names",
+    "  agentera state query <artifact-name>          # Advanced custom artifact query",
+    "",
+    "Supported typed writes:",
+    "  agentera state progress append ...            # Record verified cycle evidence",
+    "  agentera state decisions append|update ...    # Record decisions or satisfaction",
+    "  agentera state plan append|update --input TASK_RECORD ... # bare task IDs; lifecycle verbs remain flag-only",
+    "  plan create ordinals are atomic-input symbols only; published plan/task identities are bare ten-letter IDs",
+    "  agentera state health append --input PATH     # Record one complete audit",
+    "  agentera state experiments publish --objective ID --input PATH  # Publish one validated experiment",
+    "  Add --dry-run to preview any mutation without publishing it.",
+    "",
+    "When to use agentera:",
+    '  - "What did we decide about X?"       → agentera state decisions --topic X',
+    '  - "How\'s the codebase health?"        → agentera state health',
+    '  - "What\'s the coupling grade?"        → agentera state health --dimension coupling_health',
+    '  - "Any critical open issues?"         → agentera state todo --severity critical',
+    "  - Recording supported artifact state   → agentera state <artifact> explain",
+    "",
+    "When to use native tools:",
+    "  - Reading or editing source code      → native read/edit/grep",
+    "  - Searching files                     → native glob/grep",
+    "  - Running commands                    → native bash",
+    "  - Browsing the web                    → native fetch",
+    "",
+    "## Recovery: stale or missing artifacts",
+    "",
+    "If `agentera <state>` returns empty:",
+    "  1. The artifact may not exist yet (no data has been written to it).",
+    "  2. Run without filters to see all available data.",
+    "  3. If data is stale, the producing capability needs to run again.",
+    "",
+    "If entity state is corrupted:",
+    "  1. Run `agentera check validate state --format json` for exact diagnostics.",
+    "  2. Use the reported bare ID with `agentera state <artifact> get --id ID --format json`.",
+    "  3. Follow the validator recovery; do not edit writer-owned entity files directly.",
+    "",
+    "If schemas are missing:",
+    "  1. Run `agentera schema --format json`.",
+    "  2. Make sure Agentera's app files exist at the reported `managedAppRoot` path.",
+    "  3. Run `agentera doctor` for a plain-language repair preview.",
+].join("\n") + "\n";
 //# sourceMappingURL=prime-blob.js.map

package/dist/cli/prime-blob.js.map

@@ -1 +1 @@
-{"version":3,"file":"prime-blob.js","sourceRoot":"","sources":["../../src/cli/prime-blob.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,CAAC,MAAM,UAAU,GAAG,4uFAA4uF,CAAC"}
+{"version":3,"file":"prime-blob.js","sourceRoot":"","sources":["../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/cli/prime-blob.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,UAAU,GACrB;IACE,0BAA0B;IAC1B,EAAE;IACF,sCAAsC;IACtC,EAAE;IACF,sFAAsF;IACtF,6EAA6E;IAC7E,EAAE;IACF,4EAA4E;IAC5E,2EAA2E;IAC3E,EAAE;IACF,gFAAgF;IAChF,gFAAgF;IAChF,mDAAmD;IACnD,iEAAiE;IACjE,EAAE;IACF,2BAA2B;IAC3B,kFAAkF;IAClF,oEAAoE;IACpE,gEAAgE;IAChE,uEAAuE;IACvE,gEAAgE;IAChE,qFAAqF;IACrF,wEAAwE;IACxE,8EAA8E;IAC9E,6EAA6E;IAC7E,+EAA+E;IAC/E,iIAAiI;IACjI,kFAAkF;IAClF,kFAAkF;IAClF,EAAE;IACF,yBAAyB;IACzB,kFAAkF;IAClF,oFAAoF;IACpF,+GAA+G;IAC/G,8GAA8G;IAC9G,6EAA6E;IAC7E,sGAAsG;IACtG,gEAAgE;IAChE,EAAE;IACF,uBAAuB;IACvB,8EAA8E;IAC9E,kEAAkE;IAClE,8FAA8F;IAC9F,mFAAmF;IACnF,8EAA8E;IAC9E,EAAE;IACF,2BAA2B;IAC3B,iEAAiE;IACjE,4DAA4D;IAC5D,uDAAuD;IACvD,wDAAwD;IACxD,EAAE;IACF,yCAAyC;IACzC,EAAE;IACF,sCAAsC;IACtC,uEAAuE;IACvE,qDAAqD;IACrD,qEAAqE;IACrE,EAAE;IACF,+BAA+B;IAC/B,+EAA+E;IAC/E,2FAA2F;IAC3F,qFAAqF;IACrF,EAAE;IACF,yBAAyB;IACzB,2CAA2C;IAC3C,kFAAkF;IAClF,iEAAiE;CAClE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC"}

package/dist/cli/profileAcquisition.js

@@ -0,0 +1,168 @@
+import fs from "node:fs";
+import { TextDecoder } from "node:util";
+import { personalProfileGrounding, PersonalGlossaryBoundaryError, } from "../analytics/personalGlossaryProfile.js";
+import { personalProfileGroundingContract } from "../registries/glossaryEntryContract.js";
+import { discoverSchemasDir } from "./appContext.js";
+import { parseProfileHeaderDates, registryArtifactPath } from "./orientation.js";
+const DEFAULT_STALE_DAYS = 7;
+const STALE_DAYS_ENV = "AGENTERA_PROFILE_MAX_AGE_DAYS";
+function errorCode(error) {
+    return typeof error === "object" && error !== null && "code" in error
+        ? String(error.code)
+        : undefined;
+}
+function sameIdentity(left, right) {
+    return left.dev === right.dev && left.ino === right.ino && left.mode === right.mode;
+}
+function sameSnapshot(left, right) {
+    return sameIdentity(left, right)
+        && left.size === right.size
+        && left.mtimeNs === right.mtimeNs
+        && left.ctimeNs === right.ctimeNs;
+}
+/** Read one path without following a final symlink and reject source changes. */
+export function readProfileSourceSafely(profilePath, maxBytes, hooks = {}) {
+    let pathSnapshot;
+    try {
+        pathSnapshot = fs.lstatSync(profilePath, { bigint: true });
+    }
+    catch (error) {
+        return { status: errorCode(error) === "ENOENT" ? "absent" : "unreadable" };
+    }
+    if (!pathSnapshot.isFile() || pathSnapshot.isSymbolicLink())
+        return { status: "unsafe" };
+    hooks.afterPathSnapshot?.();
+    let fd;
+    try {
+        const noFollow = hooks.noFollowFlag ?? (fs.constants.O_NOFOLLOW ?? 0);
+        fd = fs.openSync(profilePath, fs.constants.O_RDONLY | noFollow);
+    }
+    catch (error) {
+        return { status: errorCode(error) === "ELOOP" ? "unsafe" : "unreadable" };
+    }
+    try {
+        const opened = fs.fstatSync(fd, { bigint: true });
+        if (!opened.isFile() || !sameIdentity(pathSnapshot, opened))
+            return { status: "unsafe" };
+        if (opened.size > BigInt(maxBytes))
+            return { status: "oversized" };
+        hooks.afterOpen?.();
+        const bytes = Buffer.alloc(maxBytes + 1);
+        let offset = 0;
+        while (offset < bytes.length) {
+            const read = fs.readSync(fd, bytes, offset, bytes.length - offset, offset);
+            if (read === 0)
+                break;
+            offset += read;
+        }
+        hooks.afterRead?.();
+        const afterRead = fs.fstatSync(fd, { bigint: true });
+        let currentPath;
+        try {
+            currentPath = fs.lstatSync(profilePath, { bigint: true });
+        }
+        catch {
+            return { status: "unsafe" };
+        }
+        if (!sameSnapshot(opened, afterRead) || !sameSnapshot(afterRead, currentPath)) {
+            return { status: "unsafe" };
+        }
+        if (offset > maxBytes)
+            return { status: "oversized" };
+        return { status: "ok", bytes: bytes.subarray(0, offset) };
+    }
+    catch {
+        return { status: "unreadable" };
+    }
+    finally {
+        try {
+            fs.closeSync(fd);
+        }
+        catch {
+            // The acquisition already has a bounded result; close diagnostics are private.
+        }
+    }
+}
+function staleThreshold(env) {
+    const parsed = Number.parseInt(env[STALE_DAYS_ENV] ?? String(DEFAULT_STALE_DAYS), 10);
+    return Number.isNaN(parsed) || parsed < 0 ? DEFAULT_STALE_DAYS : parsed;
+}
+function unknownFreshness(env) {
+    return {
+        state: "unknown",
+        days_since_generated: null,
+        stale_threshold_days: staleThreshold(env),
+        generated_date: null,
+        validated_date: null,
+    };
+}
+function freshness(text, env) {
+    const dates = parseProfileHeaderDates(text);
+    const anchor = dates.generatedUtc === null
+        ? dates.validatedUtc
+        : dates.validatedUtc === null
+            ? dates.generatedUtc
+            : Math.max(dates.generatedUtc, dates.validatedUtc);
+    const threshold = staleThreshold(env);
+    if (anchor === null) {
+        return { ...unknownFreshness(env), generated_date: dates.generatedDate, validated_date: dates.validatedDate };
+    }
+    const now = new Date();
+    const today = Date.UTC(now.getFullYear(), now.getMonth(), now.getDate());
+    const days = Math.round((today - anchor) / 86_400_000);
+    return {
+        state: days >= threshold ? "stale" : "current",
+        days_since_generated: days,
+        stale_threshold_days: threshold,
+        generated_date: dates.generatedDate,
+        validated_date: dates.validatedDate,
+    };
+}
+function result(profilePath, env, status, validityClass, recovery) {
+    return {
+        validity: { status, class: validityClass, recovery },
+        freshness: unknownFreshness(env),
+        profilePath,
+        groundingContent: null,
+    };
+}
+export function acquireProfile(schemasDir, env = process.env, hooks = {}) {
+    const contract = personalProfileGroundingContract();
+    let profilePath;
+    try {
+        profilePath = registryArtifactPath("profile", schemasDir ?? discoverSchemasDir(), env, { warn: false });
+    }
+    catch {
+        return result(null, env, "repair_needed", "unsafe", contract.repairRecovery);
+    }
+    const source = readProfileSourceSafely(profilePath, contract.maxProfileUtf8Bytes, hooks);
+    if (source.status === "absent") {
+        return result(profilePath, env, "absent", "absent", contract.absentRecovery);
+    }
+    if (source.status !== "ok") {
+        return result(profilePath, env, "repair_needed", source.status, contract.repairRecovery);
+    }
+    let decoded;
+    try {
+        decoded = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(source.bytes);
+    }
+    catch {
+        return result(profilePath, env, "repair_needed", "invalid_utf8", contract.repairRecovery);
+    }
+    try {
+        const groundingContent = personalProfileGrounding(decoded);
+        return {
+            validity: { status: "valid", class: "valid", recovery: null },
+            freshness: freshness(decoded, env),
+            profilePath,
+            groundingContent,
+        };
+    }
+    catch (error) {
+        const validityClass = error instanceof PersonalGlossaryBoundaryError
+            ? error.availability
+            : "malformed";
+        return result(profilePath, env, "repair_needed", validityClass, contract.repairRecovery);
+    }
+}
+//# sourceMappingURL=profileAcquisition.js.map

package/dist/cli/profileAcquisition.js.map

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

package/dist/cli/startupCompletenessContract.js

@@ -0,0 +1,60 @@
+import { STATE_FAMILY_FALLBACK_COMMANDS, STATE_FAMILY_LIST_COMMANDS } from "./capabilityContext/types.js";
+export const STARTUP_AVAILABLE_STATE_FIELDS = [
+    "app_home",
+    "mode",
+    "profile",
+    "v1_migration",
+    "health",
+    "todo",
+    "plan",
+    "docs",
+    "progress",
+    "objective",
+    "state_presence",
+    "project_integration",
+    "attention",
+    "decision_attention",
+    "next_action",
+    "orchestration_context",
+    "closeout_context",
+    "evidence_context",
+    "benchmark_context",
+    "execution_context",
+];
+export const STARTUP_COMPLETENESS_CONFIDENCE_CAVEATS = [
+    "representative benchmark evidence exists, but some source products remain degraded by schema divergence",
+    "Audit evidence context uses existing status, plan, progress, docs, health, TODO, and decisions state outputs",
+];
+export const STARTUP_COMPLETENESS_CLI_FALLBACK = [
+    STATE_FAMILY_FALLBACK_COMMANDS.plan,
+    STATE_FAMILY_FALLBACK_COMMANDS.docs,
+    STATE_FAMILY_LIST_COMMANDS.progress,
+];
+export function startupCompletenessContract(input = {}) {
+    const missingState = [];
+    const schemaError = input.schemaError ?? null;
+    if (schemaError) {
+        missingState.push(schemaError);
+    }
+    if (input.profileStatus === "not found")
+        missingState.push("profile not found");
+    if (input.profileStatus === "absent")
+        missingState.push("profile absent");
+    if (input.profileStatus === "repair_needed")
+        missingState.push("profile repair needed");
+    const complete = missingState.length === 0;
+    return {
+        complete_for_capability_startup: complete,
+        raw_artifact_reads_required: false,
+        raw_artifact_read_policy: "Do not read raw artifacts when complete_for_capability_startup is true. " +
+            "When incomplete, try cli_fallback first; raw reads are permitted only for a named corruption or CLI-defect diagnostic.",
+        available_state: [...STARTUP_AVAILABLE_STATE_FIELDS],
+        missing_state: missingState,
+        confidence_caveats: [...STARTUP_COMPLETENESS_CONFIDENCE_CAVEATS],
+        cli_fallback: [...STARTUP_COMPLETENESS_CLI_FALLBACK],
+    };
+}
+export function capabilityStartupComplete(input = {}) {
+    return Boolean(startupCompletenessContract(input).complete_for_capability_startup);
+}
+//# sourceMappingURL=startupCompletenessContract.js.map

package/dist/cli/startupCompletenessContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startupCompletenessContract.js","sourceRoot":"","sources":["../../../../../home/jgabor/git/agentera.release-publish-dev40/packages/cli/src/cli/startupCompletenessContract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAO1G,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,UAAU;IACV,MAAM;IACN,SAAS;IACT,cAAc;IACd,QAAQ;IACR,MAAM;IACN,MAAM;IACN,MAAM;IACN,UAAU;IACV,WAAW;IACX,gBAAgB;IAChB,qBAAqB;IACrB,WAAW;IACX,oBAAoB;IACpB,aAAa;IACb,uBAAuB;IACvB,kBAAkB;IAClB,kBAAkB;IAClB,mBAAmB;IACnB,mBAAmB;CACX,CAAC;AAEX,MAAM,CAAC,MAAM,uCAAuC,GAAG;IACrD,yGAAyG;IACzG,8GAA8G;CACtG,CAAC;AAEX,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,8BAA8B,CAAC,IAAI;IACnC,8BAA8B,CAAC,IAAI;IACnC,0BAA0B,CAAC,QAAQ;CAC3B,CAAC;AAEX,MAAM,UAAU,2BAA2B,CAAC,QAAkC,EAAE;IAC9E,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,CAAC;IAC9C,IAAI,WAAW,EAAE,CAAC;QAChB,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,KAAK,WAAW;QAAE,YAAY,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChF,IAAI,KAAK,CAAC,aAAa,KAAK,QAAQ;QAAE,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1E,IAAI,KAAK,CAAC,aAAa,KAAK,eAAe;QAAE,YAAY,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC;IAC3C,OAAO;QACL,+BAA+B,EAAE,QAAQ;QACzC,2BAA2B,EAAE,KAAK;QAClC,wBAAwB,EACtB,0EAA0E;YACzE,wHAAwH;QAC3H,eAAe,EAAE,CAAC,GAAG,8BAA8B,CAAC;QACpD,aAAa,EAAE,YAAY;QAC3B,kBAAkB,EAAE,CAAC,GAAG,uCAAuC,CAAC;QAChE,YAAY,EAAE,CAAC,GAAG,iCAAiC,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAkC,EAAE;IAC5E,OAAO,OAAO,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC,+BAA+B,CAAC,CAAC;AACrF,CAAC"}