agentera 3.0.0-dev.22 → 3.0.0-dev.25

package/dist/state/write/explain.js

@@ -7,15 +7,17 @@ import { nextEntryNumber, nextTaskNumber } from "./assign.js";
 import { schemaBudget, projectedFields } from "./fields.js";
 import { operationSpec, verbsForArtifact, } from "./operations.js";
 import { reject } from "./errors.js";
+import { detectStateMode } from "../stateMode.js";
 function liveDoc(p) {
     if (!fs.existsSync(p))
         return {};
     return loadYamlMapping(fs.readFileSync(p, "utf8"));
 }
 function defaultVerb(artifact) {
-    return artifact === "experiments" ? "publish" : "append";
+    return artifact === "experiments" ? "publish" : ["objective", "todo", "docs"].includes(artifact) ? "create" : "append";
 }
 export function buildExplain(artifact, projectRoot, requestedVerb) {
+    const stateMode = detectStateMode(projectRoot);
     const verb = (requestedVerb ?? defaultVerb(artifact));
     const spec = operationSpec(artifact, verb);
     if (!spec) {
@@ -28,11 +30,15 @@ export function buildExplain(artifact, projectRoot, requestedVerb) {
     const record = loadArtifactRegistry().get(artifact);
     if (!record)
         reject({ class: "unsupported_target", message: `artifact "${artifact}" is not registered` });
-    const resolved = artifact === "experiments"
-        ? path.join(projectRoot, ".agentera", "optimize", "<objective>", "experiments.yaml")
-        : resolveArtifactPath(record, projectRoot, { strictWrite: true });
-    const doc = artifact === "experiments" ? {} : liveDoc(resolved);
-    const next = artifact === "experiments"
+    const legacyEvidence = stateMode === "legacy" && ["progress", "decisions", "health", "plan"].includes(artifact);
+    const entityArtifact = !legacyEvidence && ["progress", "decisions", "health", "plan", "objective", "experiments", "todo", "docs"].includes(artifact);
+    const resolved = entityArtifact
+        ? path.join(projectRoot, ".agentera", "entities", artifact, artifact === "progress" ? "progress_cycle" : artifact === "health" ? "health_audit" : artifact === "plan" ? ["append", "update", "set-status", "record-evaluation"].includes(verb) ? "plan_task" : "plan" : artifact === "objective" ? "objective" : artifact === "experiments" ? "experiment" : artifact === "todo" ? "todo_item" : artifact === "docs" ? "documentation_inventory_entry" : verb === "append" ? "decision" : verb === "update" ? "decision_satisfaction" : "decision_revision", "<id>.yaml")
+        : artifact === "experiments"
+            ? path.join(projectRoot, ".agentera", "optimize", "<objective>", "experiments.yaml")
+            : resolveArtifactPath(record, projectRoot, { strictWrite: true });
+    const doc = artifact === "experiments" || entityArtifact ? {} : liveDoc(resolved);
+    const next = artifact === "experiments" || entityArtifact
         ? {}
         : artifact === "plan"
             ? { task_number: nextTaskNumber(doc) }
@@ -40,14 +46,24 @@ export function buildExplain(artifact, projectRoot, requestedVerb) {
                 number: nextEntryNumber(doc, artifact === "progress" ? "cycles" : artifact === "decisions" ? "decisions" : "audits"),
             };
     const validator = new ArtifactSchemaValidator();
-    const fields = projectedFields(spec, validator).map((field) => ({
-        flag: field.flag,
-        field: field.field,
-        required: Boolean(field.required),
-        type: field.kind,
+    const fields = projectedFields(spec, validator)
+        .filter(() => !(entityArtifact && artifact === "health" && verb === "repair"))
+        .filter((field) => artifact !== "decisions" || !["update", "amend"].includes(verb) || (entityArtifact ? field.flag !== "--number" : !["--id", "--base-sha256"].includes(field.flag)))
+        .filter((field) => !(entityArtifact && artifact === "experiments" && field.flag === "--number"))
+        .map((field) => ({
+        flag: entityArtifact && artifact === "plan" && field.flag === "--task" ? "--id" : field.flag,
+        field: entityArtifact && artifact === "plan" && field.flag === "--task" ? "id" : field.field,
+        required: Boolean(field.required || (artifact === "decisions" && ["update", "amend"].includes(verb) && (entityArtifact ? field.flag === "--id" || (verb === "amend" && field.flag === "--base-sha256") : field.flag === "--number"))),
+        type: entityArtifact && artifact === "plan" && field.flag === "--task" ? "string" : field.kind,
         ...(field.validValues ? { valid_values: field.validValues } : {}),
         ...(field.repeatable ? { repeatable: true } : {}),
-        ...(field.description ? { description: field.description } : {}),
+        ...(field.description ? { description: entityArtifact && artifact === "objective" && field.flag === "--id"
+                ? "Bare ten-letter objective ID returned by objective create or list."
+                : entityArtifact && artifact === "experiments" && field.flag === "--objective"
+                    ? "Bare ten-letter objective ID owning the experiment."
+                    : entityArtifact && artifact === "experiments" && field.flag === "--id"
+                        ? "Existing bare ten-letter experiment ID for exact immutable replay."
+                        : field.description } : {}),
         ...(field.kind === "date" ? { format: "YYYY-MM-DD" } : {}),
         ...(field.kind === "datetime" ? { format: "YYYY-MM-DD HH:MM" } : {}),
         ...(field.flag === "--timestamp" ? { default: "now" } : {}),
@@ -58,6 +74,11 @@ export function buildExplain(artifact, projectRoot, requestedVerb) {
         command: `state ${artifact} explain`,
         requested_verb: verb,
         artifact,
+        ...(legacyEvidence ? {
+            classification: "legacy_migration_evidence",
+            recovery_only: true,
+            recovery: `Complete the entity cutover with agentera state migrate entities --project ${projectRoot} --dry-run --format json; this writer remains aggregate-only and creates no entity state.`,
+        } : {}),
         path: path.relative(projectRoot, resolved) || resolved,
         verbs: verbsForArtifact(artifact),
         next,
@@ -65,9 +86,11 @@ export function buildExplain(artifact, projectRoot, requestedVerb) {
         fields,
     };
     if (spec.compacts) {
-        result.compaction = artifact === "experiments"
-            ? "uniform_10_40_50 (10 active full-detail and 40 one-line archive entries); runs automatically on publication; durable archival is deferred"
-            : "uniform_10_40_50 (bounded active/archive projections: 10 active full-detail and 40 archive entries; verified numbered archives remain authoritative; no destructive deletion; recovery refuses to omit entries when archive evidence is missing); runs automatically on append";
+        result.compaction = entityArtifact
+            ? `not applicable; each canonical ${artifact} entity is authority and no aggregate projection or numbered archive is written`
+            : artifact === "experiments"
+                ? "uniform_10_40_50 (10 active full-detail and 40 one-line archive entries); runs automatically on publication; durable archival is deferred"
+                : "uniform_10_40_50 (bounded active/archive projections: 10 active full-detail and 40 archive entries; verified numbered archives remain authoritative; no destructive deletion; recovery refuses to omit entries when archive evidence is missing); runs automatically on append";
     }
     if (spec.inputRoot) {
         result.input_schema = {
@@ -76,7 +99,11 @@ export function buildExplain(artifact, projectRoot, requestedVerb) {
             parser: "yaml",
             accepts_json: true,
             root: spec.inputRoot,
-            cli_owned_fields: spec.cliOwnedFields ?? [],
+            cli_owned_fields: entityArtifact && artifact === "experiments"
+                ? ["id", "artifact", "objective"]
+                : entityArtifact && artifact === "objective"
+                    ? ["id", "artifact"]
+                    : entityArtifact && ["health", "docs", "plan"].includes(artifact) ? ["id", "artifact"] : spec.cliOwnedFields ?? [],
             defaulted_fields: artifact === "health" ? { date: "today" } : {},
             groups: artifact === "health"
                 ? ["AUDIT", "DIMENSION", "FINDING", "TRENDS"]
@@ -85,45 +112,141 @@ export function buildExplain(artifact, projectRoot, requestedVerb) {
                     : ["HEADER", "PLAN", "SCOPE", "TASK"],
         };
     }
-    result.guidance = [
-        artifact === "plan" && verb === "create"
-            ? "supply sequential task numbers and valid dependencies; previous_plan_archived is assigned by the CLI"
-            : artifact === "plan"
-                ? "task numbers are assigned by the CLI for append"
-                : artifact === "health" && verb === "repair"
-                    ? "repair is a destructive projection edit; select an existing duplicate audit and pass --force"
-                    : artifact === "experiments"
-                        ? "pass the intended non-negative --number; the CLI validates and assigns it to the entry"
-                        : "number is assigned by the CLI; do not pass --number",
+    result.guidance = decisionsGuidance(artifact, verb, entityArtifact && artifact === "decisions", entityArtifact && artifact === "health", entityArtifact);
+    result.example = entityArtifact && artifact === "health" && verb === "repair"
+        ? "agentera check validate state --format json"
+        : exampleFor(artifact, verb, entityArtifact && artifact === "decisions", entityArtifact);
+    return result;
+}
+function decisionsGuidance(artifact, verb, entityDecisions = false, entityHealth = false, entityArtifact = false) {
+    const base = [
         "do not embed commit hashes; evidence belongs in the commit message (Decision 66)",
         "fold the artifact write into the implementation commit per AGENTS.md",
     ];
-    result.example = exampleFor(artifact, verb);
-    return result;
+    if (entityArtifact && artifact === "plan" && verb === "create")
+        return [
+            "the CLI assigns bare IDs to the plan and each task and publishes one canonical file per entity",
+            ...base,
+        ];
+    if (entityArtifact && artifact === "plan" && ["update", "set-status", "record-evaluation"].includes(verb))
+        return ["select one task entity with its bare ten-letter --id; ordinal selectors are unavailable", ...base];
+    if (entityArtifact && artifact === "plan" && verb === "append")
+        return ["the CLI assigns a bare ten-letter ID to the new task entity", ...base];
+    if (entityArtifact && artifact === "plan")
+        return ["the active plan entity is selected by lifecycle state", ...base];
+    if (artifact === "plan" && verb === "create")
+        return [
+            "supply sequential task numbers and valid dependencies; previous_plan_archived is assigned by the CLI",
+            ...base,
+        ];
+    if (artifact === "plan")
+        return ["task numbers are assigned by the CLI for append", ...base];
+    if (entityHealth && verb === "repair")
+        return ["canonical health audit entities are immutable; validate malformed or duplicate ownership with agentera check validate state", ...base];
+    if (artifact === "health" && verb === "repair")
+        return ["repair is a destructive projection edit; select an existing duplicate audit and pass --force", ...base];
+    if (entityArtifact && artifact === "experiments")
+        return ["select the owner with its bare ten-letter --objective ID; numeric and composite selectors are unavailable", "omit --id for a new immutable experiment; pass an existing bare --id only for exact replay", ...base];
+    if (artifact === "experiments")
+        return ["pass the intended non-negative --number; the CLI validates and assigns it to the entry", ...base];
+    if (entityArtifact && artifact === "objective" && verb === "update")
+        return ["select one objective with its bare ten-letter --id; numeric and composite selectors are unavailable", "the CLI preserves that ID while replacing the validated objective record", ...base];
+    if (entityArtifact && artifact === "objective")
+        return ["a bare ten-letter objective ID is assigned by the CLI; do not pass an identity", ...base];
+    if (entityArtifact && artifact === "todo" && verb !== "create")
+        return ["select one TODO item with its bare ten-letter --id; numeric, prefixed, composite, alias, and path identities are unavailable", ...base];
+    if (entityArtifact && artifact === "todo")
+        return ["a bare ten-letter TODO item ID is assigned by the CLI; status starts open", ...base];
+    if (entityArtifact && artifact === "docs" && verb === "update")
+        return ["select one documentation inventory entry with its bare ten-letter --id; path remains record data, not identity", ...base];
+    if (entityArtifact && artifact === "docs")
+        return ["a bare ten-letter documentation inventory ID is assigned by the CLI; path remains record data", ...base];
+    if (entityDecisions && verb === "update")
+        return [
+            "select one base decision with its bare --id; numeric selectors are unavailable",
+            "update replaces only that decision's authority-owned satisfaction entity after transition validation",
+            ...base,
+        ];
+    if (entityDecisions && verb === "amend")
+        return [
+            "select one base decision with its bare --id and current --base-sha256",
+            "supply at least one amendable content field; satisfaction remains a separate mutation",
+            "apply publishes one immutable revision entity; identical retries converge and same-base divergence conflicts",
+            ...base,
+        ];
+    if (artifact === "decisions" && verb === "update")
+        return [
+            entityDecisions
+                ? "select an existing decision by bare ID with --id; it is caller-supplied and never assigned by the CLI"
+                : "select an existing decision number with --number; it is caller-supplied and never assigned by the CLI",
+            "update writes only satisfaction overlay fields; decision content is amended, not updated",
+            ...base,
+        ];
+    if (artifact === "decisions" && verb === "amend")
+        return [
+            entityDecisions
+                ? "select an existing decision by bare ID with --id; it is caller-supplied and never assigned by the CLI"
+                : "select an existing decision number with --number; it is caller-supplied and never assigned by the CLI",
+            "supply at least one amendable content field (--question, --context, --alternative-chosen, --alternative-rejected, --choice, --reasoning, --confidence, --feeds-into)",
+            "--alternative-rejected is repeatable and appends one rejected alternative each time it is supplied",
+            "confidence must be current vocabulary (firm, provisional, exploratory); unsupported inherited labels on untouched records stay legacy",
+            "dry-run reports the exact revision, effective record, and projection effect without writing any file",
+            "apply publishes a record-local revision document override with recovery; the decisions projection stays byte-stable and reads compose base→revisions→overlay",
+            "an identical re-submission is an idempotent replay; retry converges on a stable revision identity without duplicates or mixed state",
+        ];
+    return [entityArtifact ? "a bare ten-letter ID is assigned by the CLI; do not pass an identity" : "number is assigned by the CLI; do not pass --number", ...base];
 }
-export function exampleFor(artifact, verb) {
+export function exampleFor(artifact, verb, entityDecisions = false, entityArtifact = false) {
     if (artifact === "progress")
         return 'agentera state progress append --type fix --phase build --what "..." --intent "..." --format json';
     if (artifact === "decisions" && verb === "update")
-        return 'agentera state decisions update --number 1 --satisfaction-state provisionally_satisfied --satisfaction-evidence "..."';
+        return entityDecisions
+            ? 'agentera state decisions update --id qjtrmnpvka --satisfaction-state provisionally_satisfied --satisfaction-evidence "..."'
+            : 'agentera state decisions update --number 1 --satisfaction-state provisionally_satisfied --satisfaction-evidence "..."';
+    if (artifact === "decisions" && verb === "amend")
+        return entityDecisions
+            ? 'agentera state decisions amend --id qjtrmnpvka --base-sha256 HASH --choice "..." --dry-run --format json'
+            : 'agentera state decisions amend --number 53 --choice "..." --reasoning "..." --confidence firm --dry-run --format json';
     if (artifact === "decisions")
         return 'agentera state decisions append --question "..." --context "..." --alternative-chosen "..." --choice "..." --reasoning "..." --confidence firm';
     if (artifact === "health" && verb === "repair")
         return "agentera state health repair --number 14 --keep first --force --format json";
     if (artifact === "health")
         return "agentera state health append --input audit.yaml --format json";
+    if (entityArtifact && artifact === "objective" && verb === "create")
+        return "agentera state objective create --input objective.yaml --format json";
+    if (entityArtifact && artifact === "objective" && verb === "update")
+        return "agentera state objective update --id qjtrmnpvka --input objective.yaml --format json";
+    if (entityArtifact && artifact === "todo" && verb === "create")
+        return 'agentera state todo create --severity normal --description "..." --format json';
+    if (entityArtifact && artifact === "todo" && verb === "resolve")
+        return "agentera state todo resolve --id qjtrmnpvka --format json";
+    if (entityArtifact && artifact === "todo" && verb === "update")
+        return 'agentera state todo update --id qjtrmnpvka --description "..." --format json';
+    if (entityArtifact && artifact === "docs" && verb === "create")
+        return "agentera state docs create --input documentation.yaml --format json";
+    if (entityArtifact && artifact === "docs" && verb === "update")
+        return "agentera state docs update --id qjtrmnpvka --input documentation.yaml --format json";
     if (verb === "create")
         return "agentera state plan create --input plan.yaml --format json";
     if (verb === "archive")
         return "agentera state plan archive --dry-run";
     if (verb === "update")
-        return 'agentera state plan update --task 1 --name "..." --format json';
+        return entityArtifact
+            ? 'agentera state plan update --id qjtrmnpvka --name "..." --format json'
+            : 'agentera state plan update --task 1 --name "..." --format json';
     if (verb === "set-status")
-        return "agentera state plan set-status --task 1 --status complete --format json";
+        return entityArtifact
+            ? "agentera state plan set-status --id qjtrmnpvka --status complete --format json"
+            : "agentera state plan set-status --task 1 --status complete --format json";
     if (verb === "set-plan-status")
         return "agentera state plan set-plan-status --status complete --format json";
     if (verb === "record-evaluation")
-        return 'agentera state plan record-evaluation --task 1 --attempt-id audit-1 --verdict pass --provenance "audit report" --format json';
+        return entityArtifact
+            ? 'agentera state plan record-evaluation --id qjtrmnpvka --attempt-id audit-1 --verdict pass --provenance "audit report" --format json'
+            : 'agentera state plan record-evaluation --task 1 --attempt-id audit-1 --verdict pass --provenance "audit report" --format json';
+    if (entityArtifact && verb === "publish")
+        return "agentera state experiments publish --objective qjtrmnpvka --input experiment.yaml --format json";
     if (verb === "publish")
         return "agentera state experiments publish --objective OBJECTIVE_ID --number 0 --input experiment.yaml --format json";
     return `agentera state plan ${verb} --name "..."`;

package/dist/state/write/explain.js.map

@@ -1 +1 @@
-{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../../src/state/write/explain.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"explain.js","sourceRoot":"","sources":["../../../src/state/write/explain.ts"],"names":[],"mappings":"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"}

package/dist/state/write/helpers.js

@@ -5,4 +5,26 @@ export function schemaViolation(violations) {
 export function findByNumber(entries, number) {
     return entries.find((entry) => Number(entry.number) === number);
 }
+/** Coerce an unknown value into a plain mapping, returning `{}` for non-objects. */
+export function mapping(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+/** Return the object-valued elements of `doc[key]`, dropping non-mapping entries. */
+export function array(doc, key) {
+    return Array.isArray(doc[key])
+        ? doc[key].filter((v) => Boolean(v && typeof v === "object" && !Array.isArray(v)))
+        : [];
+}
+/** Traverse a dotted field path into a nested mapping, returning `undefined` on miss. */
+export function mappingPath(entry, field) {
+    let value = entry;
+    for (const part of field.split(".")) {
+        if (!value || typeof value !== "object" || Array.isArray(value))
+            return undefined;
+        value = value[part];
+    }
+    return value;
+}
 //# sourceMappingURL=helpers.js.map

package/dist/state/write/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/state/write/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,UAAU,eAAe,CAAC,UAAoB;IAClD,MAAM,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,OAAkC,EAClC,MAAc;IAEd,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC;AAClE,CAAC"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/state/write/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,UAAU,eAAe,CAAC,UAAoB;IAClD,MAAM,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,OAAkC,EAClC,MAAc;IAEd,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,CAAC;AAClE,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,KAAK,CAAC,GAA4B,EAAE,GAAW;IAC7D,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC,CAAE,GAAG,CAAC,GAAG,CAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAgC,EAAE,CACjE,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CACzD;QACH,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,WAAW,CAAC,KAA8B,EAAE,KAAa;IACvE,IAAI,KAAK,GAAY,KAAK,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAClF,KAAK,GAAI,KAAiC,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}