Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
7adfbe3
feat(dashboard): add processing, usage, and runtime observability
happy-v587 Oct 31, 2026
bd226dc
feat(dashboard): add cloud-native monitoring guide and restructure Dr…
happy-v587 Nov 9, 2026
8a633f8
chore: retrigger CI
happy-v587 Nov 9, 2026
9476bed
chore: retrigger CI
happy-v587 Nov 9, 2026
be4bec4
chore: sync PR head
happy-v587 Nov 9, 2026
5fd5312
chore: retrigger CI
happy-v587 Nov 10, 2026
e9ff41d
feat(dashboard): show source save time
happy-v587 Nov 10, 2026
38ee86a
fix(ci): restore integration contracts and pin ACP runner SDK
happy-v587 Nov 10, 2026
0965f70
fix(ci): review source save metadata compatibility
happy-v587 Nov 10, 2026
706faed
test(persistence): expect unknown save time for legacy sources
happy-v587 Nov 10, 2026
e27fca3
fix(desktop): qualify current dashboard server contract
happy-v587 Nov 10, 2026
6e7c579
fix(dashboard): preserve source preview metadata and attribution
happy-v587 Nov 10, 2026
9608296
test(handoff): isolate report query budget from background SQL
happy-v587 Nov 10, 2026
e7bd019
test(dsh): install compatible plugin in web doctor fixture
happy-v587 Nov 10, 2026
2e5b3ba
fix(dashboard): preserve exact source navigation
happy-v587 Nov 11, 2026
ea7b073
fix(topic-memory): bound related history candidates
happy-v587 Nov 12, 2026
f94a655
fix(rebase): reconcile migration manifests and upgrade review
happy-v587 Nov 12, 2026
3be6c00
chore(rebase): regenerate API models
happy-v587 Nov 12, 2026
3e32757
fix(ci): add missing license headers to dashboard templates
happy-v587 Nov 12, 2026
90ea28a
test(e2e): rewind registered schema by the whole pending chain
happy-v587 Nov 12, 2026
7408253
chore: retrigger CI
happy-v587 Nov 12, 2026
bd54aff
fix(desktop): requalify the merged Dashboard contract
happy-v587 Nov 12, 2026
c1ca71c
fix(dashboard): prefill the saved feedback reason when editing
happy-v587 Nov 12, 2026
c749213
fix(dashboard): keep failure navigation consistent with its summary
happy-v587 Nov 13, 2026
c328f92
fix(desktop): requalify the Dashboard contract on SQLite
happy-v587 Nov 13, 2026
685f4ad
fix(release): review the status-filtered processing read
happy-v587 Nov 13, 2026
4e12b39
fix(integrations): rebuild bundles for the all-history summary
happy-v587 Nov 13, 2026
5cf73ec
test(native): wait out launchd's respawn throttle in the retry test
happy-v587 Nov 13, 2026
b2be0b6
refactor(dashboard): remove ledgers and show source artifacts
happy-v587 Nov 13, 2026
8596ad4
fix(dashboard): complete source lineage views and remove stale ledger…
happy-v587 Nov 13, 2026
a377df7
refactor: separate topic memory history fix
happy-v587 Nov 13, 2026
f56630c
merge: synchronize dashboard with master
happy-v587 Nov 13, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
feat(dashboard): add cloud-native monitoring guide and restructure Dr…
…eam run detail

Add a static cloud-native monitoring page under observation navigation covering
managed Docker Compose deployment, Server telemetry settings, Grafana/Phoenix
access, read-only verification and external platform connections. The page keeps
Dashboard authentication, requires no Scope or running monitoring stack, and
performs no deployment actions.

Split the Dream run detail into its own component and present Input, Processing,
and Output in reading order. Input shows up to 20 authorized exact Artifact
previews with identity and source references collapsed by default; the
processing stage retains recorded status, reason, error, timestamps and attempt
count; output links to the recorded candidate or states that no new output was
recorded. Unfinished tasks keep polling. Unselected sibling inputs no longer
leak into the detail view.

Tighten the processing detail type scale so nested sections inherit one
consistent size, and update bilingual documentation and labels.
  • Loading branch information
happy-v587 committed Nov 12, 2026
commit bd226dc4b1f4cce942bfd8fef8ba154c73a1f906
4 changes: 4 additions & 0 deletions docs/en/development/dashboard.md
Original file line number Diff line number Diff line change
Expand Up @@ -266,3 +266,7 @@ Blocked processing diagnostics on Home and Processing offer Retry processing for
Sidebar entries use distinct local SVGs from Tabler Icons v3.35.0, retaining consistent stroke and dimensions: automation settings, moon/stars, brain, hierarchy, tools, user scan, checklist, exchange arrows, search, coins, activity and adjustments match their respective labels.

Runtime configuration comes from an allowlisted snapshot of the BuiltinConfig used to assemble this Server and is returned in Dashboard HTML. There is no new public JSON configuration endpoint. It shows the service role, explicit Dream switch, Memory/Topic Memory/Experience intervals, Profile cron and time zone, generation configuration presence, concurrency and timeouts. It does not reload environment files, substitute source defaults for unavailable configuration, or expose credentials, model URLs or database paths. Health still comes from /health/live and /health/ready. Enabled configuration does not prove active execution; database cursor reads used during investigation are not a source for this configuration panel.

Dream task detail follows Input, Processing, and Output in order. Input shows up to 20 authorized exact Artifact previews. Identity and source references are collapsed by default. The processing stage retains saved status, reason, error, timestamps and attempt count. Output links to the recorded candidate or states that no new output was recorded; unfinished tasks keep polling.

Cloud-native monitoring in the observation navigation opens a static guide covering managed Docker Compose deployment, Server telemetry settings, Grafana/Phoenix access, read-only verification and external platform connections. The page keeps Dashboard authentication, requires no Scope or running monitoring stack, and performs no deployment actions.
4 changes: 4 additions & 0 deletions docs/zh/development/dashboard.md
Original file line number Diff line number Diff line change
Expand Up @@ -270,3 +270,7 @@ Dashboard 使用当前凭据调用已有 Generate 接口,并要求请求同源
侧栏图标使用 Tabler Icons v3.35.0 的本地 SVG,沿用线条和尺寸。自动处理用自动化设置、Dream 用星月、记忆用脑、主题记忆用层级、经验技能用工具、画像用用户扫描、审核用检查清单、交接用双向箭头、检索用放大镜、Token 用量用硬币、运行状态用脉冲、提示词用调节控件,各入口图标不同。

运行状态页的配置区来自当前 Server 组装时使用的 BuiltinConfig 白名单快照,通过 Dashboard HTML 返回,没有新增独立公共 JSON 配置接口。显示服务角色、显式 Dream 开关、记忆/主题记忆/经验自动调度周期、画像 cron 与时区、模型配置状态及并发/超时。不会读取磁盘环境文件或根据源码默认值补齐未知配置,不包含凭据、模型 URL 或数据库路径。健康状态仍通过 /health/live 和 /health/ready 获取。配置开启不证明任务正在执行;只读数据库游标属于排查证据,不属于本配置区的数据源。

Dream 任务详情按输入、处理、输出顺序展示。输入最多展示 20 项已授权的精确 Artifact 版本正文,记录身份与资料引用默认折叠。处理区保留已记录的状态、原因、错误、时间和尝试次数。输出区链接到已记录的候选;没有产物时明确说明。未结束任务保留自动刷新。

观测导航中的“云原生监控”打开静态接入指南,覆盖 Docker Compose 托管部署、Server 遥测接入、Grafana/Phoenix 访问、只读验证和外部平台接入。页面遵守 Dashboard 认证,不依赖 Scope 或已启动的监控栈,也不执行部署操作。
6 changes: 5 additions & 1 deletion src/powercontext/server/dashboard/labels.en.json
Original file line number Diff line number Diff line change
Expand Up @@ -1011,5 +1011,9 @@
"method_dream_selection_notice": "Select content, then start a background task. Track progress in Dream processing; results still require review.",
"method_start_task": "Start task",
"method_selected_count": "{count} selected",
"method_generation_cancel": "Cancel"
"method_generation_cancel": "Cancel",
"processing_dream_no_output": "This run recorded no new output.",
"processing_dream_more_inputs": "{count} additional inputs are listed under references.",
"processing_dream_source_inputs": "This run recorded {count} source references. Expand references to inspect them.",
"observability": "Cloud-native monitoring"
}
6 changes: 5 additions & 1 deletion src/powercontext/server/dashboard/labels.json
Original file line number Diff line number Diff line change
Expand Up @@ -1002,5 +1002,9 @@
"method_dream_selection_notice": "选择要提炼的内容,再发起后台任务。可在 Dream 处理中查看进度,生成结果仍需审核。",
"method_start_task": "发起任务",
"method_selected_count": "已选择 {count} 项",
"method_generation_cancel": "取消"
"method_generation_cancel": "取消",
"processing_dream_no_output": "本次任务未记录新的产物。",
"processing_dream_more_inputs": "另有 {count} 项输入,可展开引用查看。",
"processing_dream_source_inputs": "本次任务记录了 {count} 项资料引用,可展开查看。",
"observability": "云原生监控"
}
7 changes: 4 additions & 3 deletions src/powercontext/server/dashboard/processing.py
Original file line number Diff line number Diff line change
Expand Up @@ -104,10 +104,10 @@ async def load_memory_previews(api, ctx):
await _load_memory_preview(api, ctx, ref)


async def load_run_previews(api, ctx):
async def load_run_previews(api, ctx, runs):
"""Resolve only the visible Dream inputs, with the same bounded read as results."""
selected = {}
for run in ctx.get("processing_items") or []:
for run in runs:
manifest = run.get("input_manifest")
if manifest is None:
continue
Expand Down Expand Up @@ -292,7 +292,7 @@ async def _load_source_history(api, request, ctx, scope, source_id) -> None:
async def _load_list_context(api, ctx, scope):
"""Read source diagnostics or Dream input previews for the visible list."""
if ctx["processing_kind"] == "dreams":
await load_run_previews(api, ctx)
await load_run_previews(api, ctx, ctx["processing_items"])
return
if ctx["processing_kind"] != "sources":
return
Expand Down Expand Up @@ -343,6 +343,7 @@ async def load_processing(api, request, ctx):
if run_id is not None:
ctx["processing_run"] = await api.read(f"/v1/scopes/{scope}/dream/{segment(run_id)}")
ctx["processing_run_sources"] = manifest_sources(ctx["processing_run"])
await load_run_previews(api, ctx, [ctx["processing_run"]])
return
family = {"sources": "processing_sources", "dreams": "processing_runs"}.get(kind, "processing_attempts")
params: dict[str, str | int] = {"limit": PAGE_SIZE}
Expand Down
5 changes: 3 additions & 2 deletions src/powercontext/server/dashboard/routes.py
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,7 @@
"review",
"processing",
"runtime",
"observability",
"entry",
*RECORDS,
}
Expand Down Expand Up @@ -879,7 +880,7 @@ async def screen(request: Request, page: str) -> HTMLResponse: # noqa: C901 --
from powercontext.server.dashboard.runtime import load_runtime

await load_runtime(api, ctx)
elif not await load_builtin_page(api, request, ctx):
elif page != "observability" and not await load_builtin_page(api, request, ctx):
descriptor = await default_scope(api, ctx)
if ctx["scope"]:
await scope_context(api, ctx, descriptor)
Expand All @@ -905,7 +906,7 @@ async def screen(request: Request, page: str) -> HTMLResponse: # noqa: C901 --
from powercontext.server.dashboard.usage import finish_usage

await finish_usage(api, request, ctx)
if page not in {"entry", "runtime"} and not ctx["scope_descriptor"] and not ctx["record_only"]:
if page not in {"entry", "runtime", "observability"} and not ctx["scope_descriptor"] and not ctx["record_only"]:
await load_entry_scopes(api, request, ctx)
except ReadError as error:
if error.status == 401:
Expand Down
11 changes: 8 additions & 3 deletions src/powercontext/server/dashboard/static/layout.css
Original file line number Diff line number Diff line change
Expand Up @@ -232,6 +232,9 @@ limitations under the License.
.home-issue + .home-issue { border-top: 1px solid #ead9b8; margin-top: 1rem; padding-top: 1rem; }
.home-issue h3 { font-size: 1rem; margin-bottom: .75rem; }
.home-issue p, .topic-diagnosis p { font-size: .875rem; line-height: 1.7; margin: 0 0 .5rem; overflow-wrap: anywhere; }
.topic-diagnosis { font-size: .8125rem; }
.topic-diagnosis p { font-size: inherit; }
.topic-diagnosis :is(code, .small) { font-size: .75rem; }
.home-issue a { font-size: .8125rem; }
[data-bs-theme="dark"] .home-issue + .home-issue { border-color: #4b402a; }

Expand All @@ -256,16 +259,18 @@ limitations under the License.
.processing-runs-table td:nth-child(3), .processing-runs-table td:nth-child(5) { overflow-wrap: anywhere; }
.processing-runs-table .processing-table-input { display: -webkit-box; -webkit-line-clamp: 2; -webkit-box-orient: vertical; overflow: hidden; }
.processing-attempt-detail-row > td { padding: 0; border: 0; }
.processing-attempt-details { padding: 1.25rem 1.25rem 1.25rem 3rem; background: var(--tblr-bg-surface-secondary); border-bottom: 1px solid var(--tblr-border-color); overflow-wrap: anywhere; font-size: .875rem; }
.processing-attempt-details { padding: 1.25rem 1.25rem 1.25rem 3rem; background: var(--tblr-bg-surface-secondary); border-bottom: 1px solid var(--tblr-border-color); overflow-wrap: anywhere; font-size: .8125rem; }
.processing-attempt-details :is(.processing-history-label, .processing-history-text, .processing-failure-reason-title) { font-size: inherit; }
.processing-attempt-details :is(.processing-failure-meta, .document-meta, .small) { font-size: .75rem; }
.processing-attempt-details .processing-history-flow { margin-top: 0; }
.processing-failure-reason { padding: .75rem 1rem; margin-bottom: .75rem; border-left: 3px solid var(--tblr-danger); border-radius: 0 .375rem .375rem 0; background: var(--tblr-danger-lt); }
.processing-failure-reason-title { margin: 0 0 .35rem; color: var(--tblr-danger); font-size: .875rem; font-weight: 600; }
.processing-failure-reason .processing-history-text { margin: 0 0 .35rem; }
.processing-failure-meta { margin: 0; color: var(--tblr-danger); font-size: .8125rem; }
.processing-failure-meta code { color: inherit; }
@media (max-width: 575px) { .processing-attempt-details { padding-left: 1.25rem; } }
.processing-attempt-details h3 { font-size: .875rem; margin: 0 0 .75rem; }
.processing-attempt-details .processing-input-body { font-size: .875rem; line-height: 1.7; }
.processing-attempt-details h3 { font-size: inherit; margin: 0 0 .75rem; }
.processing-attempt-detail-row .processing-attempt-details :is(.processing-input-body, .processing-text, .processing-body) { font-size: inherit; line-height: 1.7; }
.processing-attempt-details h3:not(:first-child) { margin-top: 1.5rem; }
.processing-attempt-details p { line-height: 1.7; }

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
<!--
Copyright (c) 2026 OceanBase.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
{% set run = processing_run %}
{% set manifest = run.input_manifest %}
<div id="dream-run-detail" class="dream-run-reading" {% if run.status in ['queued','running'] %}hx-get="{{ link() }}" hx-trigger="every 3s" hx-select="#dream-run-detail" hx-target="this" hx-swap="outerHTML"{% endif %}>
<h1 class="page-title mb-3">{{ t.get('processing_operation_' ~ run.operation,run.operation) }}</h1>
<a class="processing-back" href="{{ link(run_id=none) }}">← {{ t.processing_runs }}</a>
<ol class="processing-steps">
<li class="processing-step" data-dream-stage="input">
<div class="processing-step-heading"><span class="processing-step-number">1</span><h2>{{ t.processing_history_input }}</h2></div>
<div class="processing-step-body">
{% if manifest %}
{% for ref in manifest.artifacts[:20] %}
{% set preview = processing_memory_previews.get(ref.family ~ '/' ~ ref.artifact_id ~ '@' ~ ref.revision) %}
<div class="processing-document">
{% if preview and preview.title %}<strong>{{ preview.title }}</strong>{% endif %}
{% if preview and preview.text %}<p class="dream-input-text mb-0">{{ preview.text|truncate(600,true) }}</p>
{% if preview.text|length > 600 %}<details class="processing-more"><summary>{{ t.processing_saved_content }}</summary><p class="dream-input-text mt-2 mb-0">{{ preview.text }}</p></details>{% endif %}
{% elif preview and preview.error %}{{ read_error(preview.error,t.processing_run_inputs) }}
{% else %}<p class="text-secondary mb-0">{{ t.processing_output_content_unavailable }}</p>{% endif %}
</div>
{% endfor %}
{% if manifest.artifacts|length > 20 %}<p class="processing-caption mt-3">{{ t.processing_dream_more_inputs.format(count=manifest.artifacts|length - 20) }}</p>{% endif %}
{% if not manifest.artifacts %}<p class="text-secondary mb-0">{{ t.processing_dream_source_inputs.format(count=processing_run_sources|length) }}</p>{% endif %}
{% if manifest.incomplete %}<p class="text-warning mt-3 mb-0">{{ t.processing_inputs_incomplete }}</p>{% endif %}
{% else %}<p class="text-secondary mb-0">{{ t.processing_inputs_unknown }}</p>{% endif %}
</div>
</li>
<li class="processing-step" data-dream-stage="process">
<div class="processing-step-heading"><span class="processing-step-number">2</span><h2>{{ t.processing_history_process }}</h2><span class="badge bg-{{ {'queued':'secondary','running':'blue','succeeded':'green','failed':'red'}[run.status] }}-lt ms-auto">{{ t['processing_status_' ~ run.status] }}</span></div>
<div class="processing-step-body">
{% if run.outcome %}<p class="mb-2"><strong>{{ t.get('processing_outcome_' ~ run.outcome,t.processing_outcome_unrecorded) }}</strong></p>{% endif %}
{% if run.reason %}<p class="dream-input-text mb-2">{{ run.reason }}</p>{% endif %}
{% if run.error %}<p class="text-danger mb-2"><code>{{ run.error }}</code></p>{% endif %}
{% if run.status in ['queued','running'] %}<p class="text-secondary mb-2">{{ t.processing_execution_pending }}</p>{% endif %}
<div class="document-meta"><span>{{ t.processing_started }} {{ run.started_at|display_time if run.started_at else t.unknown_value }}</span><span>{{ t.processing_completed }} {{ run.completed_at|display_time if run.completed_at else t.unknown_value }}</span><span>{{ t.processing_attempts }} {{ run.attempt_count }}</span></div>
</div>
</li>
<li class="processing-step" data-dream-stage="output">
<div class="processing-step-heading"><span class="processing-step-number">3</span><h2>{{ t.processing_history_output }}</h2></div>
<div class="processing-step-body">
{% if run.candidate %}<a class="btn btn-sm btn-primary" href="{{ link('review', candidate_id=run.candidate.candidate_id, candidate_kind=run.candidate.kind, review_status=none, resource_type='all') }}">{{ t.processing_open_candidate }} →</a><p class="processing-caption mt-2">{{ t.processing_candidate_scope }}</p>
{% elif run.status in ['queued','running'] %}<p class="text-secondary mb-0">{{ t.processing_execution_pending }}</p>
{% else %}<p class="text-secondary mb-0">{{ t.processing_dream_no_output }}</p>{% endif %}
</div>
</li>
</ol>
<details class="processing-record-details" data-dream-references>
<summary>{{ t.note_record_identity }}</summary>
<div class="processing-details-body">
<dl class="processing-facts"><dt>{{ t.note_record_identity }}</dt><dd>{{ run.run_id }}</dd><dt>{{ t.processing_accepted }}</dt><dd>{{ run.accepted_at|display_time }}</dd><dt>{{ t.processing_prompt_version }}</dt><dd>{{ run.prompt_version }}</dd></dl>
{% if run.target %}{% set destination = artifact_destination(run.target) %}<div class="processing-document"><strong>{{ t.processing_target }}</strong><div class="processing-reference">{% if destination %}<a href="{{ destination }}">{{ run.target.family }}/{{ run.target.artifact_id }}@{{ run.target.revision }}</a>{% else %}{{ run.target.family }}/{{ run.target.artifact_id }}@{{ run.target.revision }}{% endif %}</div></div>{% endif %}
{% if manifest %}
{% for ref in manifest.artifacts if ref != run.target %}{% set destination = artifact_destination(ref) %}<div class="processing-document processing-reference">{% if destination %}<a href="{{ destination }}">{{ t.get(ref.family,ref.family) }} · {{ ref.artifact_id }}@{{ ref.revision }}</a>{% else %}{{ ref.family }}/{{ ref.artifact_id }}@{{ ref.revision }}{% endif %}</div>{% endfor %}
{% for source in processing_run_sources %}<div class="processing-document processing-reference">{{ source.source_type }}/{{ source.source_id }}{% if source.source_type == 'content' %} <a href="{{ link(record_type='sources',source_id=source.source_id,run_id=none) }}">{{ t.source_original }} →</a>{% endif %}</div>{% endfor %}
{% endif %}
<p class="mt-3">{{ t.processing_inputs_scope }}</p>
<p class="mb-0">{{ t.processing_attempts_scope }}</p>
</div>
</details>
</div>
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@
<p class="small mt-2" data-scope-error {% if not errors.get('scopes') %}hidden{% endif %}>{{ t.scope_list_unavailable }}</p>
</form>
<ul class="navbar-nav w-100" aria-label="{{ t.navigation }}">
{% for group, items in [('', ['home']), ('nav_runtime', ['source_records', 'dream_records']), ('nav_content', ['notes', 'topics', 'methods', 'profile']), ('nav_work', ['review', 'handoff']), ('nav_observation', ['usage', 'usage_resources', 'runtime']), ('nav_configuration', ['prompts'])] %}
{% for group, items in [('', ['home']), ('nav_runtime', ['source_records', 'dream_records']), ('nav_content', ['notes', 'topics', 'methods', 'profile']), ('nav_work', ['review', 'handoff']), ('nav_observation', ['usage', 'usage_resources', 'runtime', 'observability']), ('nav_configuration', ['prompts'])] %}
{% if group %}<li class="nav-section" role="presentation">{{ t[group] }}</li>{% endif %}
{% for item in items %}
{% set processing_entry = {'source_records':'sources','processing':'attempts','dream_records':'dreams'}.get(item) %}
Expand Down
Loading