agentera 3.0.0-dev.5 → 3.0.0-dev.7

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

@@ -0,0 +1,210 @@
+import { publicDoctorStatus } from "../../../upgrade/doctor.js";
+import { projectInstallTrack } from "../../../upgrade/compatibility.js";
+import { formatNextAction } from "../../orientation.js";
+import { requestedFields, REQUIRED_SPARSE_CONTEXT_FIELDS } from "../../stateQuery.js";
+import { emitStructured } from "../../structured.js";
+import { startupCompletenessContract } from "../../startupCompletenessContract.js";
+export { startupCompletenessContract } from "../../startupCompletenessContract.js";
+/** Project a single {@link NextAction} to its JSON record shape. */
+function nextActionEntry(action) {
+    return { object: action.object, capability: action.capability, reason: action.reason, phase: action.phase };
+}
+/** Ranked state-readiness hint for the prime JSON `next_action` field (D76).
+ *  The recommended entry is flattened to top-level `object`/`capability`/
+ *  `reason`/`phase` so consumers reading `next_action.object` keep working,
+ *  and `alternatives` carries the cascade branches the early-return model
+ *  would have skipped, each with the same `{object, capability, reason, phase}`
+ *  shape. */
+function nextActionPayload(state) {
+    const { recommended, alternatives } = state.next_action;
+    return {
+        ...nextActionEntry(recommended),
+        alternatives: alternatives.map(nextActionEntry),
+    };
+}
+const STATUS_STRUCTURED_FIELDS = [
+    "command", "status", "app_home", "app", "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", "source", "source_contract",
+];
+/** Deprecated JSON field selectors kept for pre-3.0.0 consumers; not listed in source_contract.fields. */
+const DEPRECATED_PRIME_FIELD_ALIASES = ["issues"];
+const ISSUES_FIELD_DEPRECATION_MESSAGE = "Deprecation: prime JSON field 'issues' is deprecated; use 'todo'. The 'issues' field will be removed at the 3.0.0 stable cut.\n";
+function shouldEmitIssuesDeprecation(requested, payload) {
+    if (!("issues" in payload))
+        return false;
+    if (requested.length === 0)
+        return true;
+    return requested.includes("issues");
+}
+function emitIssuesFieldDeprecationWarning(requested, payload, err) {
+    if (shouldEmitIssuesDeprecation(requested, payload)) {
+        err(ISSUES_FIELD_DEPRECATION_MESSAGE);
+    }
+}
+function orientationAppHome(bundle) {
+    return {
+        install_track: projectInstallTrack(bundle.installKind),
+        status: bundle.status,
+        home: bundle.appHome,
+        source: bundle.appHomeSource,
+        managed_app_root: bundle.managedAppRoot,
+        user_data_root: bundle.userDataRoot,
+    };
+}
+export function buildOrientationJsonPayload(state, command) {
+    const bundle = state.app;
+    const schemasDir = state.schemas_dir;
+    const bundlePublic = publicDoctorStatus(bundle);
+    const appHome = orientationAppHome(bundle);
+    const bespoke = {
+        orchestration_context: null,
+        closeout_context: null,
+        evidence_context: null,
+        benchmark_context: null,
+        execution_context: null,
+    };
+    const render = command === "status"
+        ? "caller-owned README-style prime orientation dashboard"
+        : "caller-owned README-style prime orientation dashboard";
+    const access = command === "status"
+        ? "single installed CLI call; app/v1/profile safety included; no preflight glob/read/import/doctor calls during normal prime"
+        : "single installed CLI call; app/v1/profile safety included; no preflight glob/read/import/doctor calls during normal prime";
+    return {
+        command,
+        status: "ok",
+        app_home: appHome,
+        app: bundlePublic,
+        mode: state.mode,
+        profile: state.profile_dict,
+        v1_migration: state.v1_migration,
+        project_integration: state.project_integration,
+        health: state.health,
+        todo: state.counts,
+        issues: state.counts,
+        plan: state.plan,
+        docs: state.docs,
+        progress: state.progress,
+        objective: state.objective,
+        state_presence: state.state_presence,
+        attention: state.attention.slice(0, 6),
+        decision_attention: state.decision_attention,
+        next_action: nextActionPayload(state),
+        orchestration_context: bespoke.orchestration_context,
+        closeout_context: bespoke.closeout_context,
+        evidence_context: bespoke.evidence_context,
+        benchmark_context: bespoke.benchmark_context,
+        execution_context: bespoke.execution_context,
+        source: {
+            schemas_dir: schemasDir,
+            project: process.cwd(),
+            artifacts_present: state.mode === "returning",
+        },
+        source_contract: {
+            fields: STATUS_STRUCTURED_FIELDS,
+            render,
+            access,
+            empty_state: "fresh mode with missing artifact summaries and zero issue counts",
+            capability_startup: startupCompletenessContract({ profileStatus: state.profile_status }),
+            capability_context: null,
+        },
+    };
+}
+function availablePrimeFields(command) {
+    const base = command === "prime" ? [...STATUS_STRUCTURED_FIELDS, "capability_context"] : STATUS_STRUCTURED_FIELDS;
+    return [...base, ...DEPRECATED_PRIME_FIELD_ALIASES];
+}
+export function emitPrime(command, payload, format, fieldsArg, out, err) {
+    const requested = requestedFields(fieldsArg);
+    emitIssuesFieldDeprecationWarning(requested, payload, err);
+    if (requested.length === 0) {
+        emitStructured(payload, format, out);
+        return 0;
+    }
+    const available = availablePrimeFields(command);
+    const unsupported = requested.filter((f) => !available.includes(f));
+    if (unsupported.length > 0) {
+        err(`Error: unsupported field '${unsupported[0]}' for ${command}. Available fields: ${available.join(", ")}\n`);
+        return 1;
+    }
+    const selected = {};
+    for (const field of [...REQUIRED_SPARSE_CONTEXT_FIELDS, ...requested]) {
+        if (field in payload && !(field in selected))
+            selected[field] = payload[field];
+    }
+    emitStructured(selected, format, out);
+    return 0;
+}
+export function printOrientationTextBriefing(state, command, out) {
+    const bundle = state.app;
+    const mode = state.mode;
+    const profileStatus = state.profile_status;
+    const profile = state.profile;
+    const health = state.health;
+    const counts = state.counts;
+    const plan = state.plan;
+    const objective = state.objective;
+    const presence = state.state_presence;
+    const attention = state.attention;
+    const nextAction = state.next_action;
+    const dashboardLabel = command === "prime" ? "prime orientation dashboard" : "prime orientation dashboard";
+    out(`agentera ${command}\n`);
+    out(`app_home: install_track=${projectInstallTrack(bundle.installKind)} | status=${bundle.status} | home=${bundle.appHome} | ` +
+        `source=${bundle.appHomeSource} | managed_app=${bundle.managedAppRoot} | user_data=${bundle.userDataRoot} | expected=${bundle.expectedVersion} | ` +
+        `expected_source=${bundle.expectedVersionSource ?? "-"} | current=${bundle.markerVersion || "-"}\n`);
+    out(`mode: ${mode}\n`);
+    const projectIntegration = state.project_integration;
+    out(`project_integration: recommendation=${projectIntegration.recommendation} | ` +
+        `channel=${projectIntegration.update_channel} | pending_runtime=${projectIntegration.pending_runtime}\n`);
+    if (projectIntegration.recommendation === "upgrade" && projectIntegration.message) {
+        out(`project_integration_message: ${projectIntegration.message}\n`);
+    }
+    out(`profile: ${profileStatus} | path=${profile}\n`);
+    if (health.exists) {
+        const worst = health.worst;
+        const worstText = worst ? `${worst[0]}:${worst[1]}` : "none";
+        out(`health: audit=${health.number} | grade=${health.grade || "unknown"} | ` +
+            `trajectory=${health.trajectory || "unknown"} | worst=${worstText}\n`);
+    }
+    out(`todo: critical=${counts.critical} | degraded=${counts.degraded} | normal=${counts.normal} | annoying=${counts.annoying}\n`);
+    if (!presence.any_active) {
+        const missing = Object.keys(presence.absence).sort().join(", ") || "none";
+        out(`state: no active plan or objective | missing=${missing}\n`);
+    }
+    if (plan.exists && !plan.complete_plan) {
+        out(`plan: status=${plan.status || "unknown"} | progress=${plan.complete ?? 0}/${plan.total ?? 0}\n`);
+    }
+    if (objective.active) {
+        const target = objective.target ? ` | target=${objective.target}` : "";
+        out(`objective: active | name=${objective.name} | metric=${objective.metric}${target}\n`);
+    }
+    else if (objective.exists) {
+        out(`objective: none active | closed=${objective.closed_count ?? 0}\n`);
+    }
+    else {
+        out("objective: none active\n");
+    }
+    if (attention.length > 0) {
+        out("attention:\n");
+        for (const item of attention.slice(0, 6))
+            out(`- ${item}\n`);
+    }
+    out("next_action:\n");
+    out(`- ${formatNextAction(nextAction.recommended)}\n`);
+    for (const alt of nextAction.alternatives) {
+        out(`- alt: ${formatNextAction(alt)}\n`);
+    }
+    out("source_contract:\n");
+    out("- fields=app_home,mode,profile,v1_migration,project_integration,health,todo,plan,docs,progress,objective,state_presence,attention,decision_attention,next_action,orchestration_context,closeout_context,evidence_context,benchmark_context,execution_context\n");
+    out(`- render=caller-owned README-style ${dashboardLabel}\n`);
+    out("- access=single installed CLI call; app/v1/profile safety included; no preflight glob/read/import/doctor calls\n");
+    const startup = startupCompletenessContract({ profileStatus: state.profile_status });
+    out(`- capability_startup_complete=${String(startup.complete_for_capability_startup).toLowerCase()}\n`);
+    out(`- raw_artifact_reads_required=${String(startup.raw_artifact_reads_required).toLowerCase()}; policy=${startup.raw_artifact_read_policy}\n`);
+    const missingState = startup.missing_state.join("; ") || "none";
+    out(`- missing_state=${missingState}\n`);
+    out(`- confidence_caveats=${startup.confidence_caveats.join("; ")}\n`);
+    out(`- cli_fallback=${startup.cli_fallback.join("; ")}\n`);
+}
+//# sourceMappingURL=orientationOutput.js.map

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

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

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

@@ -0,0 +1,50 @@
+import path from "node:path";
+import { loadCapabilitySchemaContract } from "../../../registries/capabilityContract.js";
+import { loadTriggerModel } from "../../../registries/triggerLoader.js";
+import { routeInput } from "../../../routing/index.js";
+import { resolveSourceRoot } from "../../../core/sourceRoot.js";
+/**
+ * `prime --route` output builder. Invokes the Layer 3-4 routing engine against
+ * the loaded trigger model and emits the request-derived route payload defined
+ * in references/cli/trigger-schema-enrichment.md §7.1. Mutually exclusive with
+ * the orientation dashboard: this payload MUST NOT include `next_action` or any
+ * state-derived field (spec §7.3).
+ */
+const ROUTE_CONTRACT_REL = "skills/agentera/capability_schema_contract.yaml";
+const ROUTE_SPEC = "references/cli/trigger-schema-enrichment.md";
+function roundConfidence(n) {
+    return Math.round(n);
+}
+/** Build the `prime --route` JSON payload for the given input text. */
+export function buildRoutePayload(input, options = {}) {
+    const sourceRoot = options.sourceRoot ?? resolveSourceRoot();
+    const contractPath = path.join(sourceRoot, ROUTE_CONTRACT_REL);
+    const contract = loadCapabilitySchemaContract(contractPath);
+    const model = loadTriggerModel(contract, { sourceRoot });
+    const result = routeInput(input, model);
+    const candidates = result.candidates.map((c) => {
+        const rounded = {
+            capability: c.capability,
+            confidence: roundConfidence(c.confidence),
+        };
+        if (c.hint !== undefined)
+            rounded.hint = c.hint;
+        return rounded;
+    });
+    return {
+        command: "prime --route",
+        status: "ok",
+        route: {
+            capability: result.capability,
+            confidence: roundConfidence(result.confidence),
+            fallback: result.fallback,
+            candidates,
+        },
+        input,
+        source_contract: {
+            engine: "layer-3-4",
+            spec: ROUTE_SPEC,
+        },
+    };
+}
+//# sourceMappingURL=routeOutput.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routeOutput.js","sourceRoot":"","sources":["../../../../src/cli/commands/prime/routeOutput.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,4BAA4B,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE;;;;;;GAMG;AAEH,MAAM,kBAAkB,GAAG,iDAAiD,CAAC;AAC7E,MAAM,UAAU,GAAG,6CAA6C,CAAC;AAEjE,SAAS,eAAe,CAAC,CAAS;IAChC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC;AA0BD,uEAAuE;AACvE,MAAM,UAAU,iBAAiB,CAAC,KAAa,EAAE,UAAmC,EAAE;IACpF,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC;IAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,4BAA4B,CAAC,YAAY,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAExC,MAAM,UAAU,GAA4B,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACtE,MAAM,OAAO,GAA0B;YACrC,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,UAAU,CAAC;SAC1C,CAAC;QACF,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QAChD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,eAAe;QACxB,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE;YACL,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC;YAC9C,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU;SACX;QACD,KAAK;QACL,eAAe,EAAE;YACf,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,UAAU;SACjB;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/cli/commands/prime/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,39 @@
+import fs from "node:fs";
+import path from "node:path";
+import { resolveInvokedUpdateChannel } from "../../../upgrade/channels.js";
+import { buildUpgradeCommands } from "../../../upgrade/upgradeCommands.js";
+export function isLocalCheckout(root) {
+    return ["skills/agentera/SKILL.md", "registry.json"].every((rel) => fs.existsSync(path.join(root, rel)));
+}
+export function v1MigrationSummary(v1Artifacts, opts) {
+    const detected = v1Artifacts.length > 0;
+    const channel = resolveInvokedUpdateChannel({
+        channel: null,
+        sourceRoot: opts.sourceRoot,
+        home: opts.home,
+        env: opts.env,
+    });
+    const cmds = detected
+        ? buildUpgradeCommands({
+            project: process.cwd(),
+            installRoot: null,
+            channel,
+            only: ["artifacts"],
+            cwdDefault: true,
+        })
+        : null;
+    const summary = {
+        detected,
+        affected_files: v1Artifacts,
+        dry_run_command: cmds?.dryRunCommand ?? null,
+        apply_command: cmds?.applyCommand ?? null,
+        requires_confirmation: detected,
+        update_channel: channel.channel,
+    };
+    if (detected && isLocalCheckout(process.cwd())) {
+        summary.local_dry_run_command = cmds?.dryRunCommand ?? null;
+        summary.local_apply_command = cmds?.applyCommand ?? null;
+    }
+    return summary;
+}
+//# sourceMappingURL=v1Migration.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"v1Migration.js","sourceRoot":"","sources":["../../../../src/cli/commands/prime/v1Migration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAI3E,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,CAAC,0BAA0B,EAAE,eAAe,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CACjE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,WAAqB,EACrB,IAAoD;IAEpD,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,2BAA2B,CAAC;QAC1C,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG;KACd,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,oBAAoB,CAAC;YACnB,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE;YACtB,WAAW,EAAE,IAAI;YACjB,OAAO;YACP,IAAI,EAAE,CAAC,WAAW,CAAC;YACnB,UAAU,EAAE,IAAI;SACjB,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,OAAO,GAAuB;QAClC,QAAQ;QACR,cAAc,EAAE,WAAW;QAC3B,eAAe,EAAE,IAAI,EAAE,aAAa,IAAI,IAAI;QAC5C,aAAa,EAAE,IAAI,EAAE,YAAY,IAAI,IAAI;QACzC,qBAAqB,EAAE,QAAQ;QAC/B,cAAc,EAAE,OAAO,CAAC,OAAO;KAChC,CAAC;IACF,IAAI,QAAQ,IAAI,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,qBAAqB,GAAG,IAAI,EAAE,aAAa,IAAI,IAAI,CAAC;QAC5D,OAAO,CAAC,mBAAmB,GAAG,IAAI,EAAE,YAAY,IAAI,IAAI,CAAC;IAC3D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}