AGENTS.md@apps/desktop/src/main/app-monitorA

AGENTS.md@apps/desktop/src/main/app-monitor from maomaochong-ai/open-astravia is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add maomaochong-ai/open-astravia/apps/desktop/src/main/app-monitor/AGENTS.md@git:20260818.4f19511

Pins git:20260818.4f19511 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
maomaochong-ai/open-astravia
Path
apps/desktop/src/main/app-monitor/AGENTS.md
Versions recorded
1
Latest version
git:20260818.4f19511, committed Aug 18, 2026
Size
2,053 bytes
Repository stars
39
License
Apache-2.0

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# App Monitor Rules

> 本目录规则适用于应用监控实现。监控不是日志记录,也不是业务流程的一部分。

## Core Principle

应用监控必须是旁路能力:可失败、可延迟、可丢失,不能影响、阻塞或改变原有业务流程。

## Implementation Rules

- 监控记录不得成为业务成功条件。业务操作成功与否只能由原业务逻辑决定。
- 监控失败必须被吞掉或降级为 warn,不得向调用方抛出并中断业务流程。
- 不要在 IPC handler、加工轮、会话执行、文件维护等关键路径里 `await` 纯监控 IO。
- 需要扫描磁盘、读取大文件、统计快照、写持久化文件时,应使用后台调度、合并去重或周期 flush。
- 高频事件只能做轻量内存计数;持久化走既有周期落盘机制。
- 监控数据只能保存聚合指标和当前快照,不保存事件流水、用户内容、文件内容或可还原隐私的数据。
- 修改 `AppMonitorData` 的持久化结构时,必须先评估兼容方式:纯新增聚合字段且可由 normalize 补默认值时,不必提高 `APP_MONITOR_SCHEMA_VERSION`;需要显式转换旧数据语义时,才提高版本并补齐连续 migration。
- 监控逻辑不得引入业务锁、扩大现有锁范围,或改变原有互斥/并发语义。
- 监控订阅必须可释放,不能因为监控导致 session、timer、listener 泄漏。

## Acceptable Patterns

- 业务完成后同步增加内存计数。
- 业务完成后触发 `void` 后台任务记录快照。
- 多次快照请求合并为一轮后台扫描,扫描期间只记录 pending 标记。
- 后台监控任务内部 catch 错误并记录 warn。

## Forbidden Patterns

- 为了监控在业务路径中新增必经 IO。
- 因监控写入失败让 IPC 请求失败。
- 因监控扫描耗时延迟用户操作返回。
- 为了监控重新读取或重算已经不需要的业务数据,并在主流程中等待结果。
- 把监控实现成详细日志、审计流水或事件明细存储。

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add maomaochong-ai/open-astravia/apps/desktop/src/main/app-monitor/AGENTS.md@sha256:422c03a229e234b8

The line at the top of this page pins the label git:20260818.4f19511, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_7kotsq3yxsxv3kzv.svg)](https://markdownregistry.com/a/art_7kotsq3yxsxv3kzv)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Aug 18, 2026.

versioncommittedcommitsizeaudit
git:20260818.4f19511 latest2026-08-18 4f19511 2,053 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (2053 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

maomaochong-ai/open-astravia · 39 stars · license Apache-2.0 · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7kotsq3yxsxv3kzv
GET https://markdownregistry.com/api/v1/resolve?ref=maomaochong-ai/open-astravia/apps/desktop/src/main/app-monitor/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/422c03a229e234b8502fd67e891230c66588b2ba04b76b50f5490f53dbe63348

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from maomaochong-ai/open-astravia

astravia-testing SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/astravia-testing/SKILL.md · 为 OpenAstravia 的功能变更、Bug 修复、重构、公共合同和 UI 交互设计、编写或审查测试;在决定测试范围、补充回归测试、覆盖用户常见使用流程或评估测试质量时使用。纯文档或没有运行时行为变化的编辑不使用。
git:20261014.02ac874 · audit A · 39 stars
compose-component-design SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/compose-component-design/SKILL.md · Use when designing or reviewing reusable Jetpack Compose component APIs with modifier parameters, root layout…
git:20260928.e3f9971 · audit A · 39 stars
compose-state-and-effects SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/compose-state-and-effects/SKILL.md · Use when writing or reviewing Jetpack Compose state ownership, remember state, state hoisting, screen state holders…
git:20260928.e3f9971 · audit A · 39 stars
design-taste-frontend SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/design-taste-frontend/SKILL.md · Anti-slop frontend skill for landing pages, portfolios, and redesigns. The agent reads the brief, infers the right…
git:20260911.9951787 · audit B · 39 stars
diagnose SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/diagnose/SKILL.md · Disciplined diagnosis loop for hard bugs and performance regressions. Reproduce → minimise → hypothesise → instrument →…
git:20260922.7ea4a67 · audit A · 39 stars
expo-overview SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/expo-overview/SKILL.md · Framework (OSS). Entry point and router for every Expo or EAS task. Load this skill first — before writing code and…
v1.1.0 · audit A · 39 stars
expo-project-structure SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/expo-project-structure/SKILL.md · Framework (OSS). Folder structure for a new Expo app. Use when scaffolding or laying out a new Expo project with Expo…
v1.0.0 · audit B · 39 stars
expo-router SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/expo-router/SKILL.md · Framework (OSS). Navigation and routing for Expo Router. Covers file-based routes, groups and dynamic routes, folder…
v1.0.1 · audit A · 39 stars
find-skills SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/find-skills/SKILL.md · Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is…
git:20260901.3ee8f34 · audit A · 39 stars
frontend-design SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/frontend-design/SKILL.md · Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with…
git:20260911.9951787 · audit A · 39 stars
grill-me SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/grill-me/SKILL.md · Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of…
git:20260922.7ea4a67 · audit A · 39 stars
grill-with-docs SKILL.md skill
maomaochong-ai/open-astravia · .agents/skills/grill-with-docs/SKILL.md · Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates…
git:20260922.7ea4a67 · audit A · 39 stars

Every file in maomaochong-ai/open-astravia

Browse by kind, by grade A, or by owner.