---
id: capability.statehub.progress-log
name: Work Progress Logging
summary: Record progress events, decisions, and session notes against workstreams and tasks in State Hub.
owner: state-hub
status: draft
domain: helix_forge
tags: [state-hub, progress, coordination]

maturity:
  discovery:
    current: D4
    target: D5
    confidence: medium
    rationale: Progress API and agent session protocol are documented in state-hub AGENTS.md.
  availability:
    current: A4
    target: A6
    confidence: medium
    rationale: Available via State Hub HTTP POST /progress/ endpoint.

external_evidence:
  completeness:
    level: C3
    name: Functional Core
    confidence: medium
    basis: scope_vs_intent_and_consumer_expectations
    satisfied_expectations:
      - progress events attach to workstreams
      - agents can log session summaries
    broken_expectations: []
    out_of_scope_expectations:
      - replacing git commit history
  reliability:
    level: R3
    name: Usable
    confidence: medium
    basis: consumer_quality_signals
    known_reliability_risks:
      - depends on hub availability and tunnel health for remote agents
    evidence:
      satisfied_signals:
        - reuse-surface AGENTS.md session-close protocol cites POST /progress/
        - cross-repo agents log progress with workstream_id linkage

discovery:
  intent: Provide auditable progress memory for cross-repo agent and operator work.
  includes:
    - progress event creation
    - workstream and task linkage
    - author attribution
  excludes:
    - canonical workplan storage
  use_cases: []

availability:
  current_level: A4
  target_level: A6
  current_artifacts:
    - state-hub/api/
  consumption_modes:
    - service API

relations:
  depends_on:
    - capability.statehub.workstream-coordinate
  supports: []
  related_to:
    - capability.statehub.workstream-coordinate

evidence:
  documentation:
    - AGENTS.md
  consumer_feedback:
    - >
        reuse-surface agents (REUSE-WP-0012): session-close progress posts to State
        Hub succeeded for workstream fb0b6067 during federation workplan work.

consumer_guidance:
  recommended_for:
    - closing agent sessions with hub progress notes
  not_recommended_for:
    - authoritative task status (use workplan files + fix-consistency)
  known_limitations:
    - hub must be running locally or via tunnel
---

# Work Progress Logging

Progress logging complements file-backed workplans with live session memory in
State Hub.