@entelligentsia/forgecli 0.20.0 → 0.20.3

package/CHANGELOG.md

@@ -7,6 +7,57 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.20.3] — 2026-05-25
+
+### Fixed
+
+- **update.md Row 1: config refresh always runs.** Row 1 ("up to date, no
+  pending migrations") previously said "exit" — causing the agent to skip
+  Step 4 entirely, including the config refresh (forgeRoot, forgeRef,
+  backfill). Missing config fields accumulate across version boundaries;
+  backfill ensures the config stays structurally complete after every
+  `/forge:update` invocation. Row 1 now executes Step 4 config refresh
+  before proceeding to Step 5.
+
+## [0.20.2] — 2026-05-25
+
+### Added
+
+- **`manage-config backfill` subcommand** — schema-validated config field backfill.
+  Reads `$FORGE_ROOT/schemas/config.schema.json`, compares against current
+  `.forge/config.json`, and writes defaults for any missing fields with
+  schema-defined defaults. Also stamps the top-level `version` field from
+  the bundled plugin version. Supports `--dry-run` for preview.
+  Fixes the root cause of `/forge:health` config-incompleteness findings:
+  the update flow now deterministically backfills missing config fields
+  instead of relying on the LLM agent to compose them manually.
+
+### Changed
+
+- **update.md Step 4** — calls `manage-config backfill` after writing
+  `paths.forgeRoot`/`paths.forgeRef`, ensuring all schema-required and
+  schema-defaulted fields are present after every update.
+- **forge-init Phase 4** — now writes `paths.forgeRef` (FR-010) and calls
+  `manage-config backfill` after `paths.forgeRoot`, ensuring fresh inits
+  also have complete config fields.
+- **`parseArgs` in manage-config.cjs** — boolean flags (e.g. `--dry-run`)
+  without a following value are now treated as `true` instead of being
+  silently dropped.
+
+## [0.20.1] — 2026-05-25
+
+### Fixed
+
+- **build-payload: expand schemas/ (dotless) to mirror full forge/forge/schemas/.**
+  Previously only structure-manifest.json was copied to the dotless schemas/
+  dir. Plugin command files (health.md, etc.) that reference
+  `$FORGE_ROOT/schemas/config.schema.json` at runtime couldn't find it — the
+  file only existed in `.schemas/` (dotted). The build now recursively copies
+  all `.json` files from forge/forge/schemas/ into schemas/ (skipping
+  `__tests__`), including enum-catalog.json, transitions/*.json, and all
+  schema files. This resolves /forge:health config-validation failures in
+  forge-cli projects.
+
 ## [0.20.0] — 2026-05-25
 
 ### Changed

package/dist/extensions/forgecli/forge-init/phase4-register.js

@@ -16,6 +16,18 @@ import * as path from "node:path";
 import { deleteInitProgress } from "../init-progress.js";
 import { execFileAsync, runToolAdvisory } from "../lib/exec-helpers.js";
 import { getRefreshKbLinksHandler } from "../refresh-kb-links.js";
+/** Read the bundled forge version from .claude-plugin/plugin.json */
+function getBundledForgeVersion(bundleRoot) {
+    try {
+        const pluginPath = path.join(bundleRoot, ".claude-plugin", "plugin.json");
+        const raw = fs.readFileSync(pluginPath, "utf8");
+        const plugin = JSON.parse(raw);
+        return typeof plugin.version === "string" ? plugin.version : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
 // ── Private helpers ────────────────────────────────────────────────────────
 function updateGitignore(cwd, ctx) {
     const gitignorePath = path.join(cwd, ".gitignore");
@@ -175,6 +187,13 @@ export async function runPhase4(ctx4) {
             forgeRootToStamp = bundleRoot;
         }
         await runToolAdvisory(manageConfigTool, ["set", "paths.forgeRoot", forgeRootToStamp], cwd, ctx, "step 4-1 paths.forgeRoot");
+        // Write paths.forgeRef (FR-010) — the bundled plugin version
+        const bundledVersion = getBundledForgeVersion(bundleRoot);
+        if (bundledVersion && bundledVersion !== "0.0.0") {
+            await runToolAdvisory(manageConfigTool, ["set", "paths.forgeRef", bundledVersion], cwd, ctx, "step 4-1 paths.forgeRef");
+        }
+        // Backfill missing config fields from schema defaults (version, paths.*, etc.)
+        await runToolAdvisory(manageConfigTool, ["backfill", "--forge-root", bundleRoot], cwd, ctx, "step 4-1 config backfill");
     }
     const schemasSrc = path.join(bundleRoot, ".schemas");
     const schemasDest = path.join(cwd, ".forge", "schemas");

package/dist/extensions/forgecli/forge-init/phase4-register.js.map

@@ -1 +1 @@
-{"version":3,"file":"phase4-register.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/forge-init/phase4-register.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"phase4-register.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/forge-init/phase4-register.ts"],"names":[],"mappings":"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"}

package/dist/forge-payload/commands/update.md

@@ -244,7 +244,7 @@ Now evaluate — **stop at the first matching row and follow only that row's act
 
 | # | Condition | Action |
 |---|-----------|--------|
-| 1 | `REMOTE_VERSION` == `LOCAL_VERSION` and `LOCAL_VERSION` == baseline | Print "Forge {LOCAL_VERSION} — up to date. No pending migrations." and **exit**. |
+| 1 | `REMOTE_VERSION` == `LOCAL_VERSION` and `LOCAL_VERSION` == baseline | Print "Forge {LOCAL_VERSION} — up to date. No pending migrations." Then execute **Step 4 config refresh** (paths.forgeRoot, paths.forgeRef, backfill) and proceed to **Step 5**. |
 | 2 | `REMOTE_VERSION` == `LOCAL_VERSION` and `LOCAL_VERSION` != baseline | Jump to **Step 2B** (project migration — no install needed). |
 | 3 | `IS_CANARY` is true | Jump to **Step 2B** (canary — no install needed). |
 | 4 | `LOCAL_VERSION` > `REMOTE_VERSION` | Print "Local version ({LOCAL_VERSION}) is ahead of the release channel ({REMOTE_VERSION}). No install needed — applying any pending project migrations." then jump to **Step 2B**. |
@@ -469,6 +469,13 @@ node "$FORGE_ROOT/tools/banners.cjs" --phase 4 7 "Apply migrations" forge \
 > before any migration targets or regeneration commands execute. This ensures all
 > subsequent tool invocations in Step 4 (including `build-init-context.cjs` called
 > by regeneration sub-steps) use the current, correct plugin path.
+>
+> **Config refresh always runs.** The Step 4 header section (forgeRoot, forgeRef,
+> backfill) executes regardless of whether migrations are pending — even Row 1
+> ("up to date") proceeds through this section before skipping to Step 5. The
+> "skip to Step 5" directive skips only the migration chain walk and regeneration.
+> Missing config fields can accumulate across version boundaries; backfill ensures
+> the config stays structurally complete after every `/forge:update` invocation.
 
 **Refresh `paths.forgeRoot` before applying migrations:**
 
@@ -485,6 +492,21 @@ LOCAL_VERSION=$(node -e "console.log(require('$FORGE_ROOT/.claude-plugin/plugin.
 node "$FORGE_ROOT/tools/manage-config.cjs" set paths.forgeRef "$LOCAL_VERSION"
 ```
 
+**Backfill missing config fields:** Config schema evolves across versions — new
+required or recommended fields may have been added since the project was last
+initialized. `manage-config backfill` reads the config schema, compares it
+against the current `.forge/config.json`, and writes defaults for any missing
+fields with schema-defined defaults. It also stamps the top-level `version`
+field from the bundled plugin version. Run after setting forgeRoot/forgeRef:
+
+```sh
+node "$FORGE_ROOT/tools/manage-config.cjs" backfill --forge-root "$FORGE_ROOT"
+```
+
+If the project was recently initialized and all fields are already present, the
+command prints `〇 No missing fields to backfill.` and exits cleanly —
+no changes, no side effects.
+
 Determine the baseline version:
 - Use `migratedFrom` from `CACHE_FILE` (set in Step 1)
 - Or the `--from <version>` argument if provided

package/dist/forge-payload/schemas/_defs/phaseSummary.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forge/_defs/phaseSummary.schema.json",
+  "title": "PhaseSummary",
+  "description": "Shared shape for terse structured summaries of phase artifacts. Single-sourced under _defs/ and $ref'd from task.schema.json and bug.schema.json. Optional bug-only `route` field is permitted on every $ref site but only meaningful on the triage phase summary written by meta-fix-bug.md.",
+  "type": "object",
+  "required": ["objective", "written_at"],
+  "properties": {
+    "objective":   { "type": "string", "maxLength": 280 },
+    "key_changes": { "type": "array", "items": { "type": "string", "maxLength": 200 }, "maxItems": 12 },
+    "findings":    { "type": "array", "items": { "type": "string", "maxLength": 200 }, "maxItems": 12 },
+    "verdict":     { "type": "string", "enum": ["approved", "revision", "n/a"] },
+    "written_at":  { "type": "string", "format": "date-time" },
+    "artifact_ref":{ "type": "string", "description": "Relative path to the full artifact" },
+    "route":       { "type": "string", "enum": ["A", "B"], "description": "Fix-bug pipeline route decision. Only set on the triage phase summary by meta-fix-bug.md. A = short-circuit (skip plan-fix + review-plan); B = full loop (default). Optional and meaningless on non-triage phases — see meta-fix-bug.md § Triage Judgement." }
+  },
+  "additionalProperties": false
+}

package/dist/forge-payload/schemas/bug.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forge/bug.schema.json",
+  "title": "Bug",
+  "type": "object",
+  "required": ["bugId", "title", "severity", "status", "path", "reportedAt"],
+  "properties": {
+    "bugId":               { "type": "string" },
+    "title":               { "type": "string" },
+    "description":         { "type": "string" },
+    "severity":            { "type": "string", "enum": ["critical", "major", "minor"] },
+    "status":              { "type": "string", "enum": ["reported", "triaged", "in-progress", "fixed"] },
+    "path":                { "type": "string" },
+    "rootCauseCategory": {
+      "type": "string",
+      "enum": ["validation", "auth", "business-rule", "data-integrity", "race-condition", "integration", "configuration", "regression"]
+    },
+    "similarBugs":         { "type": "array", "items": { "type": "string" } },
+    "checklistItemAdded":  { "type": "boolean" },
+    "businessRuleUpdated": { "type": "boolean" },
+    "githubIssue":         { "type": "string", "format": "uri" },
+    "reportedAt":          { "type": "string", "format": "date-time" },
+    "resolvedAt":          { "type": "string", "format": "date-time" },
+    "summaries": {
+      "type": "object",
+      "description": "Terse structured summaries of phase artifacts. Optional; full artifacts on disk remain authoritative.",
+      "properties": {
+        "plan":           { "$ref": "_defs/phaseSummary.schema.json" },
+        "triage":         { "$ref": "_defs/phaseSummary.schema.json" },
+        "review_plan":    { "$ref": "_defs/phaseSummary.schema.json" },
+        "implementation": { "$ref": "_defs/phaseSummary.schema.json" },
+        "code_review":    { "$ref": "_defs/phaseSummary.schema.json" },
+        "validation":     { "$ref": "_defs/phaseSummary.schema.json" },
+        "approve":        { "$ref": "_defs/phaseSummary.schema.json" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/dist/forge-payload/schemas/collation-state.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forge/collation-state.schema.json",
+  "title": "Collation State",
+  "description": "Last-collation watermark written to .forge/store/COLLATION_STATE.json",
+  "type": "object",
+  "required": ["collatedAt", "featureCount", "sprintCount", "taskCount", "bugCount"],
+  "additionalProperties": false,
+  "properties": {
+    "collatedAt":   { "type": "string",  "format": "date-time" },
+    "featureCount": { "type": "integer", "minimum": 0 },
+    "sprintCount":  { "type": "integer", "minimum": 0 },
+    "taskCount":    { "type": "integer", "minimum": 0 },
+    "bugCount":     { "type": "integer", "minimum": 0 }
+  }
+}

package/dist/forge-payload/schemas/config.schema.json

@@ -0,0 +1,215 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/Entelligentsia/agentic-skills/forge/config.schema.json",
+  "title": "ForgeConfig",
+  "description": "Schema for .forge/config.json — the per-project Forge configuration file. Canonical single-source schema (FORGE-S25-T12 reconciled sdlc-config.schema.json into this file and deleted the sibling). Generated by /forge:init and refreshed by /forge:update.",
+  "type": "object",
+  "required": ["version", "project", "paths"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "Config schema version (e.g. '1.0'). Used for migration support."
+    },
+    "project": {
+      "type": "object",
+      "required": ["prefix", "name"],
+      "properties": {
+        "prefix": {
+          "type": "string",
+          "description": "Short prefix for task/sprint/bug IDs (e.g. ACME)"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable project name"
+        },
+        "description": {
+          "type": "string",
+          "description": "One-line project description"
+        }
+      }
+    },
+    "stack": {
+      "type": "object",
+      "description": "Detected/declared project technology stack. Optional fields nullable because not every project ships e.g. a frontend or task queue.",
+      "properties": {
+        "languages": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Primary languages detected"
+        },
+        "framework":         { "type": ["string", "null"], "description": "Primary backend framework" },
+        "frontendFramework": { "type": ["string", "null"], "description": "Frontend framework if detected" },
+        "database":          { "type": ["string", "null"], "description": "Primary database" },
+        "taskQueue":         { "type": ["string", "null"], "description": "Task queue if detected (celery, sidekiq, etc.)" },
+        "containerisation":  { "type": ["string", "null"], "description": "Container tooling if detected" }
+      }
+    },
+    "commands": {
+      "type": "object",
+      "description": "Resolved project tooling commands. Workflows reference these via {COMMAND_TEST} / {LINT_COMMAND} placeholders.",
+      "properties": {
+        "test":          { "type": "string" },
+        "build":         { "type": "string" },
+        "lint":          { "type": "string" },
+        "syntaxCheck": {
+          "type": "object",
+          "additionalProperties": { "type": "string" }
+        },
+        "migrate":       { "type": "string" },
+        "migrateCheck":  { "type": "string" }
+      }
+    },
+    "paths": {
+      "type": "object",
+      "required": ["engineering", "store", "forgeRoot"],
+      "properties": {
+        "engineering":     { "type": "string", "default": "engineering" },
+        "store":           { "type": "string", "default": ".forge/store" },
+        "workflows":       { "type": "string", "default": ".forge/workflows" },
+        "commands":        { "type": "string", "default": ".claude/commands" },
+        "templates":       { "type": "string", "default": ".forge/templates" },
+        "customCommands":  { "type": "string", "default": "engineering/commands", "description": "Directory for project-specific custom pipeline phase commands. Files here are workflow scripts invoked directly by the orchestrator via the phase workflow field." },
+        "forgeRoot":       { "type": "string", "description": "Absolute path to the installed Forge plugin root. Set at init time and refreshed by /forge:update. Used by generated workflows to invoke Forge tools without requiring $CLAUDE_PLUGIN_ROOT in subagent contexts." },
+        "forgeRef":        { "type": "string", "description": "Pinned Forge plugin reference (tag or commit) the project was generated against." }
+      }
+    },
+    "pipeline": {
+      "type": "object",
+      "description": "Optional pipeline customisation for the default pipeline",
+      "properties": {
+        "skipPhases": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "maxReviewIterations": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 3
+        },
+        "includeTokenDataInBugReports": {
+          "type": "boolean",
+          "description": "If set, silently opt in (true) or out (false) of appending sprint token usage data to Forge bug reports. When absent, the user is prompted at report time."
+        }
+      }
+    },
+    "pipelines": {
+      "type": "object",
+      "description": "Named pipeline definitions. Each key is a pipeline name that tasks can reference via their `pipeline` field. The `default` pipeline is used when a task has no `pipeline` field. Projects define custom pipelines to route tasks to specialized agent commands.",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["phases"],
+        "properties": {
+          "description": {
+            "type": "string",
+            "description": "Human-readable description of when to use this pipeline"
+          },
+          "phases": {
+            "type": "array",
+            "description": "Ordered list of pipeline phases. Each phase maps to a slash command.",
+            "items": {
+              "type": "object",
+              "required": ["command", "role"],
+              "properties": {
+                "command": {
+                  "type": "string",
+                  "description": "Slash command name (without /) to invoke for this phase"
+                },
+                "role": {
+                  "type": "string",
+                  "enum": ["plan", "review-plan", "implement", "review-code", "validate", "approve", "commit"],
+                  "description": "Semantic role of this phase in the pipeline lifecycle"
+                },
+                "model": {
+                  "type": "string",
+                  "description": "Optional model override for this phase"
+                },
+                "maxIterations": {
+                  "type": "integer",
+                  "description": "Max revision loop iterations for review phases",
+                  "default": 3
+                },
+                "on_revision": {
+                  "type": "string",
+                  "description": "Command name of the phase to re-invoke on 'Revision Required'. Defaults to the nearest preceding non-review phase if omitted."
+                },
+                "workflow": {
+                  "type": "string",
+                  "description": "Optional path to a workflow file. When set, the orchestrator reads and follows this file directly instead of deriving the workflow from the command name. Use for custom phase commands in engineering/commands/."
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "installedSkills": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Marketplace skill names installed during forge:init or recommended by forge:health. Used to wire skill invocations into generated personas and workflows.",
+      "examples": ["vue-best-practices", "stripe-integration", "claude-api"]
+    },
+    "sprint": {
+      "type": "object",
+      "description": "Optional sprint execution configuration",
+      "properties": {
+        "execution": {
+          "type": "object",
+          "properties": {
+            "mode": {
+              "type": "string",
+              "enum": ["sequential", "wave-parallel", "full-parallel"],
+              "default": "sequential"
+            },
+            "maxConcurrentAgents": {
+              "type": "integer",
+              "default": 3
+            }
+          }
+        }
+      }
+    },
+    "calibrationBaseline": {
+      "type": "object",
+      "description": "Calibration baseline written by /forge:init after skill generation. Records the state at calibration time so /forge:calibrate can detect drift.",
+      "properties": {
+        "lastCalibrated":   { "type": "string", "description": "ISO date (YYYY-MM-DD) of the last calibration run" },
+        "version":          { "type": "string", "description": "Plugin version string at calibration time (e.g. 0.9.3)" },
+        "masterIndexHash":  { "type": "string", "description": "SHA-256 hex digest of the semantic content of engineering/MASTER_INDEX.md at calibration time" },
+        "sprintsCovered":   { "type": "array", "items": { "type": "string" }, "description": "Sprint IDs whose tasks and outcomes were included in the calibration baseline" }
+      }
+    },
+    "calibrationHistory": {
+      "type": "array",
+      "description": "Audit trail of calibration runs. Each entry records the drift categories detected and the patches applied.",
+      "items": {
+        "type": "object",
+        "required": ["date", "version", "categories", "patches"],
+        "additionalProperties": false,
+        "properties": {
+          "date":       { "type": "string", "description": "ISO date (YYYY-MM-DD) of this calibration run" },
+          "version":    { "type": "string", "description": "Plugin version at calibration time" },
+          "categories": { "type": "array", "items": { "type": "string" }, "description": "Drift categories detected: technical, business, retrospective, acceptance-criteria" },
+          "patches": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["target", "type", "applied"],
+              "additionalProperties": false,
+              "properties": {
+                "target":  { "type": "string", "description": "Regeneration target (e.g. personas:engineer, skills:supervisor-skills)" },
+                "type":    { "type": "string", "enum": ["regenerate"], "description": "Patch type (currently only 'regenerate' is supported)" },
+                "applied": { "type": "boolean", "description": "Whether this patch was applied (true if approved and succeeded, false if skipped or failed)" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["full", "fast"],
+      "description": "Init mode. 'fast' means scaffolding was generated by /forge:init --fast (stubs present, heavy artifacts deferred to first use). 'full' means all artifacts are generated. Absent on pre-0.12 projects — treated as 'full' by all readers. Flipped to 'full' by /forge:regenerate (default) or /forge:materialize --all."
+    }
+  },
+  "additionalProperties": false
+}

package/dist/forge-payload/schemas/enum-catalog.json

@@ -0,0 +1,71 @@
+{
+  "version": "0.51.1",
+  "generated": "2026-05-23",
+  "note": "Authoritative enum catalog. Source: build-enum-catalog.cjs. Regenerate via node forge/tools/build-manifest.cjs.",
+  "enums": {
+    "task.status": [
+      "draft",
+      "planned",
+      "plan-approved",
+      "implementing",
+      "implemented",
+      "review-approved",
+      "approved",
+      "committed",
+      "plan-revision-required",
+      "code-revision-required",
+      "blocked",
+      "escalated",
+      "abandoned"
+    ],
+    "sprint.status": [
+      "planning",
+      "active",
+      "completed",
+      "retrospective-done",
+      "blocked",
+      "partially-completed",
+      "abandoned"
+    ],
+    "bug.status": [
+      "reported",
+      "triaged",
+      "in-progress",
+      "fixed"
+    ]
+  },
+  "commandNames": [
+    "forge:sprint-intake",
+    "forge:plan",
+    "forge:review-plan",
+    "forge:implement",
+    "forge:review-code",
+    "forge:fix-bug",
+    "forge:sprint-plan",
+    "forge:run-task",
+    "forge:run-sprint",
+    "forge:collate",
+    "forge:retrospective",
+    "forge:approve",
+    "forge:commit",
+    "forge:enhance",
+    "forge:quiz-agent",
+    "forge:validate",
+    "forge:init",
+    "forge:health",
+    "forge:regenerate",
+    "forge:update",
+    "forge:add-task",
+    "forge:add-pipeline",
+    "forge:calibrate",
+    "forge:materialize",
+    "forge:remove",
+    "forge:report-bug",
+    "forge:store-query",
+    "forge:store-repair",
+    "forge:config",
+    "forge:ask",
+    "forge:store-custodian",
+    "forge:refresh-kb-links"
+  ]
+}

package/dist/forge-payload/schemas/event-sidecar.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "forge/event-sidecar.schema.json",
+  "title": "Event Sidecar",
+  "description": "Subset of event schema — token/cost/duration fields written by agents before canonical merge. All fields other than eventId are optional; presence enforcement happens on the canonical event, not the sidecar.",
+  "type": "object",
+  "required": ["eventId"],
+  "additionalProperties": false,
+  "properties": {
+    "eventId":          { "type": "string", "minLength": 1 },
+    "inputTokens":      { "type": "integer", "minimum": 0 },
+    "outputTokens":     { "type": "integer", "minimum": 0 },
+    "cacheReadTokens":  { "type": "integer", "minimum": 0 },
+    "cacheWriteTokens": { "type": "integer", "minimum": 0 },
+    "model":            { "type": "string",  "maxLength": 120 },
+    "provider":         { "type": "string",  "maxLength": 60 },
+    "durationMinutes":  { "type": "number",  "minimum": 0 },
+    "startTimestamp":   { "type": "string",  "format": "date-time" },
+    "endTimestamp":     { "type": "string",  "format": "date-time" },
+    "tokenSource":      { "type": "string",  "enum": ["reported", "estimated"] }
+  }
+}