~bigbes/agents-dev · parade

main · last commit 13 days ago · 7g0stsfu

← Back to the parade

ah-xuc.12 docs: sync SPEC with Stage 2 behavior Past Stand

status: closed P2 task @Eugene Blikh
bd reopen ah-xuc.12
Created byEugene Blikh
Ownerbigbes@gmail.com
Created2026-07-13T05:16:35Z
Started2026-07-13T07:53:57Z
Updated2026-07-13T08:38:17Z
Closed2026-07-13T08:38:17Z
Description
SPEC.md gains normative Stage 2 sections mirroring what landed, in the established style (invariants and failure modes, not narrative): domain deltas (stalled outcome, canonical buckets as a superset of states, Run.Timeout), ports deltas (Labels, Skills, Publish), store v2 migration, vikunja labels, runner skills plus publish (never force-push), reconciler claim spec resolution + Triage bounce + parked buckets + per-run timeout + watchdog + notification ordering, httpapi webhook endpoint (HMAC, disabled when unset), config reference with the full new example, security notes (webhook secret, TG token redaction, srht push scope), roadmap section 14 marks Stage 2 delivered. Cross-check config.example.yaml for drift. AGENTS.md and CLAUDE.md only if conventions changed (mirror both if so — independent files).
Acceptance criteria
Each new SPEC section spot-checked against the shipped code; no contradiction with Stage 1 sections; the research-v3 supersede note stays accurate

Depends on

  • ah-xuc.9 — reconcile: publish review branch, watchdog on stale events, Telegram notifications blocks closed
  • ah-xuc — Stage 2: webhooks, Task Spec, full buckets, Telegram, srht push, watchdog parent-child closed
  • ah-xuc.10 — cmd/agenthubd: wire webhook secret and Telegram notifier blocks closed

Depended on by

Nothing depends on this issue.

Prerequisite chain — everything this waits on, transitively

  • ah-xuc.9 — reconcile: publish review branch, watchdog on stale events, Telegram notifications blocks closed
  • ah-xuc.8 — reconcile: spec-driven claim, Triage bounce, parked buckets, per-run timeout blocks closed
  • ah-xuc.2 — internal/spec: Task Spec frontmatter parse, type-label defaults, validation blocks closed
  • ah-xuc — Stage 2: webhooks, Task Spec, full buckets, Telegram, srht push, watchdog parent-child closed
  • ah-xuc.1 — Stage 2 foundation: domain buckets/outcome, ports contracts, config surface blocks closed
  • ah-xuc.3 — vikunja: fetch task labels into BoardTask.Labels blocks closed
  • ah-xuc.4 — store: migration v2 — per-run timeout column blocks closed
  • ah-xuc.10 — cmd/agenthubd: wire webhook secret and Telegram notifier blocks closed
  • ah-xuc.6 — telegram: ports.Notifier implementation (Bot API through HTTPS_PROXY) blocks closed
  • ah-xuc.7 — httpapi: Vikunja webhook receiver with HMAC verification blocks closed

No comments.

Close reason

e13b65c + b48849f (two wording nits); accuracy reviewer merge-ready — every behavioral claim verified against code; SPEC section-12 example validates through ahub validate-config; pre-existing RunStatus.MetaAttempt drift filed as ah-6u0
  • Eugene Blikh added under epic ah-xuc · 2026-07-13T08:16:35Z
  • Eugene Blikh created the issue · 2026-07-13T08:16:35Z
  • Eugene Blikh added dependency on ah-xuc.9 · 2026-07-13T08:16:55Z
  • Eugene Blikh added dependency on ah-xuc.10 · 2026-07-13T08:16:55Z
  • Eugene Blikh claimed · 2026-07-13T10:53:56Z
  • Eugene Blikh closed the issue · 2026-07-13T11:38:17Z
    e13b65c + b48849f (two wording nits); accuracy reviewer merge-ready — every behavioral claim verified against code; SPEC section-12 example validates through ahub validate-config; pre-existing RunStatus.MetaAttempt drift filed as ah-6u0
  • Eugene Blikh added label milestone:stage-2 · 2026-07-20T03:08:47Z
  • Eugene Blikh removed label milestone:stage-2 · 2026-07-20T03:10:24Z
Stored rows — what this pane was built from, as read
issues 1 row
id ah-xuc.12
content_hash 14d3638d45c9064a76941832983973f494233fccabe6a738101abdf7f06e6d89
title docs: sync SPEC with Stage 2 behavior
description SPEC.md gains normative Stage 2 sections mirroring what landed, in the established style (invariants and failure modes, not narrative): domain deltas (stalled outcome, canonical buckets as a superset of states, Run.Timeout), ports deltas (Labels, Skills, Publish), store v2 migration, vikunja labels, runner skills plus publish (never force-push), reconciler claim spec resolution + Triage bounce + parked buckets + per-run timeout + watchdog + notification ordering, httpapi webhook endpoint (HMAC, disabled when unset), config reference with the full new example, security notes (webhook secret, TG token redaction, srht push scope), roadmap section 14 marks Stage 2 delivered. Cross-check config.example.yaml for drift. AGENTS.md and CLAUDE.md only if conventions changed (mirror both if so — independent files).
design
acceptance_criteria Each new SPEC section spot-checked against the shipped code; no contradiction with Stage 1 sections; the research-v3 supersede note stays accurate
notes
status closed
priority 2
issue_type task
assignee Eugene Blikh
estimated_minutes NULL
created_at 2026-07-13T05:16:35Z
created_by Eugene Blikh
owner bigbes@gmail.com
updated_at 2026-07-13T08:38:17Z
closed_at 2026-07-13T08:38:17Z
closed_by_session
external_ref NULL
spec_id
compaction_level 0
compacted_at NULL
compacted_at_commit NULL
original_size NULL
sender
ephemeral 0
wisp_type
pinned 0
is_template 0
mol_type
work_type
source_system
metadata �{}
source_repo
close_reason e13b65c + b48849f (two wording nits); accuracy reviewer merge-ready — every behavioral claim verified against code; SPEC section-12 example validates through ahub validate-config; pre-existing RunStatus.MetaAttempt drift filed as ah-6u0
event_kind
actor
target
payload
await_type
await_id
timeout_ns 0
waiters
hook_bead
role_bead
agent_state
last_activity NULL
role_type
rig
due_at NULL
defer_until NULL
no_history 0
started_at 2026-07-13T07:53:57Z
is_blocked 0
dependencies 3 rows
id 3785cc92-86f6-58d9-81c6-642d4811cc8f
issue_id ah-xuc.12
type blocks
created_at 2026-07-13T08:16:55Z
created_by Eugene Blikh
metadata �{}
thread_id
depends_on_issue_id ah-xuc.9
depends_on_wisp_id NULL
depends_on_external NULL
id a15afbfe-2443-533e-be9d-c7e27fbc77e2
issue_id ah-xuc.12
type parent-child
created_at 2026-07-13T08:16:35Z
created_by Eugene Blikh
metadata �{}
thread_id
depends_on_issue_id ah-xuc
depends_on_wisp_id NULL
depends_on_external NULL
id bfe7a6ef-2ee8-5c89-8083-819af5d086ff
issue_id ah-xuc.12
type blocks
created_at 2026-07-13T08:16:55Z
created_by Eugene Blikh
metadata �{}
thread_id
depends_on_issue_id ah-xuc.10
depends_on_wisp_id NULL
depends_on_external NULL
events 5 rows
id 019f59e7-dcf7-7524-8d16-fc30d1cf5915
issue_id ah-xuc.12
event_type created
actor Eugene Blikh
old_value
new_value
comment NULL
created_at 2026-07-13T08:16:35Z
id 019f5a77-eda7-7288-aa1a-d7bf1cffad00
issue_id ah-xuc.12
event_type claimed
actor Eugene Blikh
old_value {"id":"ah-xuc.12","title":"docs: sync SPEC with Stage 2 behavior","description":"SPEC.md gains normative Stage 2 sections mirroring what landed, in the established style (invariants and failure modes, not narrative): domain deltas (stalled outcome, canonical buckets as a superset of states, Run.Timeout), ports deltas (Labels, Skills, Publish), store v2 migration, vikunja labels, runner skills plus publish (never force-push), reconciler claim spec resolution + Triage bounce + parked buckets + per-run timeout + watchdog + notification ordering, httpapi webhook endpoint (HMAC, disabled when unset), config reference with the full new example, security notes (webhook secret, TG token redaction, srht push scope), roadmap section 14 marks Stage 2 delivered. Cross-check config.example.yaml for drift. AGENTS.md and CLAUDE.md only if conventions changed (mirror both if so — independent files).","acceptance_criteria":"Each new SPEC section spot-checked against the shipped code; no contradiction with Stage 1 sections; the research-v3 supersede note stays accurate","status":"open","priority":2,"issue_type":"task","owner":"bigbes@gmail.com","created_at":"2026-07-13T05:16:35Z","created_by":"Eugene Blikh","updated_at":"2026-07-13T05:16:35Z"}
new_value {"assignee":"Eugene Blikh","status":"in_progress"}
comment NULL
created_at 2026-07-13T10:53:56Z
id 019f5aa0-85b0-7ed4-a1ad-3695bf4f9c33
issue_id ah-xuc.12
event_type closed
actor Eugene Blikh
old_value
new_value e13b65c + b48849f (two wording nits); accuracy reviewer merge-ready — every behavioral claim verified against code; SPEC section-12 example validates through ahub validate-config; pre-existing RunStatus.MetaAttempt drift filed as ah-6u0
comment NULL
created_at 2026-07-13T11:38:17Z
id 019f7cda-934e-71cc-87dc-d2c38a8e8b10
issue_id ah-xuc.12
event_type label_added
actor Eugene Blikh
old_value NULL
new_value NULL
comment Added label: milestone:stage-2
created_at 2026-07-20T03:08:47Z
id 019f7cdc-0f2a-7328-b32a-2e3e34ee83c5
issue_id ah-xuc.12
event_type label_removed
actor Eugene Blikh
old_value NULL
new_value NULL
comment Removed label: milestone:stage-2
created_at 2026-07-20T03:10:24Z