generated from coulomb/repo-seed
tegwick
270065ff58
Some checks failed
ci / validate-registry (push) Has been cancelled
Add hub sync and report cohorts CLI commands with pytest coverage, document sibling index publish contract and hub hardening path, align INTENT layout, raise external evidence on three registry entries, and close gap priorities 19-23 (priority 18 deferred on sibling index blocks).
91 lines
2.4 KiB
Markdown
91 lines
2.4 KiB
Markdown
---
|
|
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. |