From cfff86c6c3aa8527585f89f6c91a4db235e46b18 Mon Sep 17 00:00:00 2001 From: Menglei Li <57990306+Lumos-789@users.noreply.github.com> Date: Wed, 18 Nov 2026 01:52:07 +0800 Subject: [PATCH 1/3] =?UTF-8?q?rebase(guster):=20single-commit=20rebuild?= =?UTF-8?q?=20on=20upstream=20main=20=E2=80=94=20payload=20unchanged?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- assets/guster/icon.png | Bin 0 -> 157496 bytes .../guster/.codex-plugin/plugin.json | 34 + .../guster/.zcode-plugin/plugin.json | 27 + external_plugins/guster/CHANGELOG.md | 349 ++++++ external_plugins/guster/LICENSE | 21 + external_plugins/guster/README.md | 347 ++++++ external_plugins/guster/README_CN.md | 287 +++++ .../guster/assets/guster/icon.png | Bin 0 -> 157496 bytes external_plugins/guster/bin/guster | 13 + external_plugins/guster/cordis.patch.yml | 3 + external_plugins/guster/index.js | 84 ++ .../guster/schemas/hub.schema.json | 111 ++ .../guster/schemas/plan.schema.json | 161 +++ .../guster/skills/guster-hub/SKILL.md | 85 ++ .../guster/skills/guster/SKILL.md | 214 ++++ .../skills/guster/reference/framework.md | 55 + .../guster/skills/guster/reference/metrics.md | 52 + .../skills/guster/reference/placement.md | 51 + .../skills/guster/reference/reformat.md | 97 ++ .../guster/skills/guster/reference/spec.md | 112 ++ .../guster/src/guster/__init__.py | 3 + .../guster/src/guster/__main__.py | 5 + external_plugins/guster/src/guster/cli.py | 1004 +++++++++++++++ .../guster/src/guster/discover.py | 1099 +++++++++++++++++ .../guster/src/guster/executor.py | 281 +++++ external_plugins/guster/src/guster/hub.py | 282 +++++ external_plugins/guster/src/guster/layout.py | 148 +++ external_plugins/guster/src/guster/metrics.py | 199 +++ external_plugins/guster/src/guster/planner.py | 191 +++ external_plugins/guster/src/guster/policy.py | 1050 ++++++++++++++++ external_plugins/guster/src/guster/report.py | 366 ++++++ external_plugins/guster/src/guster/util.py | 741 +++++++++++ .../guster/templates/hub/AGENTS.md | 23 + .../guster/templates/hub/README.md | 18 + .../guster/templates/hub/gitignore.tmpl | 2 + .../guster/templates/hub/hub.yaml.tmpl | 11 + .../guster/templates/hub/knowledge/README.md | 5 + .../hub/knowledge/general/start-here.md | 11 + .../templates/hub/knowledge/projects/.gitkeep | 1 + .../templates/hub/projects/_registry.md.tmpl | 8 + .../guster/templates/hub/tools/README.md | 30 + marketplace.json | 91 +- 42 files changed, 7659 insertions(+), 13 deletions(-) create mode 100644 assets/guster/icon.png create mode 100644 external_plugins/guster/.codex-plugin/plugin.json create mode 100644 external_plugins/guster/.zcode-plugin/plugin.json create mode 100644 external_plugins/guster/CHANGELOG.md create mode 100644 external_plugins/guster/LICENSE create mode 100644 external_plugins/guster/README.md create mode 100644 external_plugins/guster/README_CN.md create mode 100644 external_plugins/guster/assets/guster/icon.png create mode 100644 external_plugins/guster/bin/guster create mode 100644 external_plugins/guster/cordis.patch.yml create mode 100644 external_plugins/guster/index.js create mode 100644 external_plugins/guster/schemas/hub.schema.json create mode 100644 external_plugins/guster/schemas/plan.schema.json create mode 100644 external_plugins/guster/skills/guster-hub/SKILL.md create mode 100644 external_plugins/guster/skills/guster/SKILL.md create mode 100644 external_plugins/guster/skills/guster/reference/framework.md create mode 100644 external_plugins/guster/skills/guster/reference/metrics.md create mode 100644 external_plugins/guster/skills/guster/reference/placement.md create mode 100644 external_plugins/guster/skills/guster/reference/reformat.md create mode 100644 external_plugins/guster/skills/guster/reference/spec.md create mode 100644 external_plugins/guster/src/guster/__init__.py create mode 100644 external_plugins/guster/src/guster/__main__.py create mode 100644 external_plugins/guster/src/guster/cli.py create mode 100644 external_plugins/guster/src/guster/discover.py create mode 100644 external_plugins/guster/src/guster/executor.py create mode 100644 external_plugins/guster/src/guster/hub.py create mode 100644 external_plugins/guster/src/guster/layout.py create mode 100644 external_plugins/guster/src/guster/metrics.py create mode 100644 external_plugins/guster/src/guster/planner.py create mode 100644 external_plugins/guster/src/guster/policy.py create mode 100644 external_plugins/guster/src/guster/report.py create mode 100644 external_plugins/guster/src/guster/util.py create mode 100644 external_plugins/guster/templates/hub/AGENTS.md create mode 100644 external_plugins/guster/templates/hub/README.md create mode 100644 external_plugins/guster/templates/hub/gitignore.tmpl create mode 100644 external_plugins/guster/templates/hub/hub.yaml.tmpl create mode 100644 external_plugins/guster/templates/hub/knowledge/README.md create mode 100644 external_plugins/guster/templates/hub/knowledge/general/start-here.md create mode 100644 external_plugins/guster/templates/hub/knowledge/projects/.gitkeep create mode 100644 external_plugins/guster/templates/hub/projects/_registry.md.tmpl create mode 100644 external_plugins/guster/templates/hub/tools/README.md diff --git a/assets/guster/icon.png b/assets/guster/icon.png new file mode 100644 index 0000000000000000000000000000000000000000..cd932818d76d45855eee5276aa855a4095c6d45c GIT binary patch literal 157496 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
n7%1_r1fk3Oc!w(Q|mzzVE&F zecum}uhwG12wT~(hxHaaLmmCou=7vbpJVGF_2>DRcukb&TinTs3BmXix^BF$9Pft9r!$Pzd5-!7Ts%eF@{dOYG8!G$Usi=SyhCXH zG4v>oG#HGOiu?eKBCg9#e~zCK{24l0P!RLfH|G0XRm0>{T)3acH*3m*$5h7Yf*8*u zQ}P(5NSbG7cxJlevZ8E?;C*0dPnVWba8grDc7Q|vlH@a3r z2A2Y*0rNYgx}kppdtT7nVHh<~m~jaL2-XwU1SqvY@s68`JQGhxLr}xAd=m1ZXU&$F zPsKbahWK>m!v~M;9PgoXJ3|f#b_RZql*SU;lx8+6oa5^v-u6ooYp>0=FWzs>efKW% zxFEfS98iVTDtK(j!h5mz1(+z)Wbl)cGqXQ4v;$sbdeq9!@SZ=_pPA|sz;&xo8?R5; zUFQMDd|CL0&+zBB*!kR_!OpyH1~RB8aRbDrR)?A+Dcmy{kH79 ziqAt8^+4@+@q-&g9;85!O7!kSDxIl`S6#5QFO*`NQl7X}@?ynp6lF76MRMCVh&XTw zGqF!>Q}C$+!VLh=z?cXkS4=LBcP@h#O;te3 z-nEUUo``Dqbe#2+=tIxlvtgyjtr~;#IdQ``)g5DW$l--u71a zQdDAlcL1eLoA-l=Q|=I_ zp#CauVuuC`v>@(7u+WedO%>@xHr4!)ilFF>FisJ_GF2Hxjj~r{+m7Q03*>oRsWrX-kZ zA~QKn1m*iGyf9kn=_>uV{?dQ^$go-m;a}EG<_&;cr-iQQ*sJ0_l(a<%k0izs_*ARL z91JZYgd=7jaV0hVfIM|z*e@%G#Lxc3Yac3uE?!mt&41%x|IzRKu#|03Q>dzsaPL0l z#*W`rw+SD-e)!tmUtV731ZaHoS0BEfEyXY1y-b7G%gZoGt@XeAKltzev;V@s;8MI? zHgD-x)S%Klp1V9T?+;tmTE$d)E9zBr_g(6DUSHcw@tgD*0std8DRdr5q6dFaPt%rE zz_$0^_8ym{qU*-c$!YA|pozPhypNVb#Usr8WE+!l*^zRCNp-k&K641r9|s6LFza#a zFJ+TGA)Y)uTms*NXeziJyV4Up0{Y>c;{&TfbQMr!THP*uS4D;;81{1B2EidR;sBd^ zJm7I0$ZK~e7(AxB;?@GoyTbe7rW25}GQl<5+2xV*ReqKywAwsm=OGE7(i21kWH%5p zm?Jl(`eLt5D?SG8fpyqN0mc^{eTp=t_&?^ZTG?6EtnL5qzx{vv{&(J+-{voUmEKyr zTrP0yTwFzDToPIi*0$bzegE=^&bKzRZ@bULM5Klc=m&rDkN=B*;m^Mgr2cIOVH`+H zr+5f^_OTiwb`vqVeE8~m*|vSZHpOWwxZ`R+QXz8<^>(iww znp!!=0;tru&`u2jM6!?#!Dkpzl}l#E�={Ly1&-(mYM~yyG)S(M_;%7QdNQj-i_z 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 literal 0 HcmV?d00001 diff --git a/external_plugins/guster/.codex-plugin/plugin.json b/external_plugins/guster/.codex-plugin/plugin.json new file mode 100644 index 00000000..922b206b --- /dev/null +++ b/external_plugins/guster/.codex-plugin/plugin.json @@ -0,0 +1,34 @@ +{ + "name": "guster", + "version": "0.9.2", + "description": "Discover, audit, plan and evolve agent context across projects, skills, tools, knowledge and credentials; optionally scaffold a lightweight Guster Hub for durable knowledge and project state.", + "author": { + "name": "Lumos-789", + "url": "https://github.com/Lumos-789" + }, + "homepage": "https://github.com/Lumos-789/guster", + "repository": "https://github.com/Lumos-789/guster", + "license": "MIT", + "keywords": [ + "agent", + "context", + "governance", + "skills", + "mcp", + "codex", + "zcode", + "dsh" + ], + "skills": "./skills/", + "interface": { + "displayName": "Guster", + "shortDescription": "Audit and evolve agent context", + "longDescription": "Guster discovers agent projects, instruction files, skills, tools, knowledge, state, evidence and credential references. It diagnoses drift, computes a context health score, produces reviewable migration plans, and can scaffold a lightweight hub for durable knowledge and project state.", + "developerName": "Lumos-789", + "category": "Developer Tools", + "capabilities": [ + "Read", + "Write with confirmation" + ] + } +} diff --git a/external_plugins/guster/.zcode-plugin/plugin.json b/external_plugins/guster/.zcode-plugin/plugin.json new file mode 100644 index 00000000..bf75d92d --- /dev/null +++ b/external_plugins/guster/.zcode-plugin/plugin.json @@ -0,0 +1,27 @@ +{ + "name": "guster", + "version": "0.9.2", + "description": "Discover, audit, plan and evolve agent context across projects, skills, tools, knowledge and credentials; optionally scaffold a lightweight Guster Hub for durable knowledge and project state.", + "description_i18n": { + "en": "Discover, audit, plan and evolve agent context across projects, skills, tools, knowledge and credentials; optionally scaffold a lightweight Guster Hub for durable knowledge and project state.", + "zh-CN": "发现、诊断、规划和演进全机 agent 上下文:项目、指令、Skill、工具、知识、状态与凭据引用;可初始化一个轻量 Guster Hub,承载长期知识与项目状态。" + }, + "author": { + "name": "Lumos-789", + "url": "https://github.com/Lumos-789" + }, + "homepage": "https://github.com/Lumos-789/guster", + "repository": "https://github.com/Lumos-789/guster", + "license": "MIT", + "keywords": [ + "agent", + "context", + "governance", + "skills", + "mcp", + "codex", + "zcode", + "dsh" + ], + "skills": "skills" +} diff --git a/external_plugins/guster/CHANGELOG.md b/external_plugins/guster/CHANGELOG.md new file mode 100644 index 00000000..b277acf4 --- /dev/null +++ b/external_plugins/guster/CHANGELOG.md @@ -0,0 +1,349 @@ +# Changelog + +## 0.9.2 — 2026-11-18 + +- New icon: a 1-bit pixel directory-tree base patrolled by four glowing + sparks — the audited-order home with agents shuttling between levels. + Part of the shared pixel family across the six plugins; no code changes. + +Notable changes. Earlier history is in `git log`. + +## 0.9.1 — 2026-11-14 + +The format-spec release: the context format contract is now externally +deliverable — schema-checked in the editor, sourced to open conventions, and +stated in attributable vocabulary. + +- **JSON Schema contracts**: `schemas/hub.schema.json` and + `schemas/plan.schema.json` (draft 2020-12, derived from the code that + reads and writes each format) pin the `hub.yaml` manifest and the plan + JSON. The scaffolded `hub.yaml` ships a yaml-language-server modeline on + its first line, so the VS Code YAML extension validates it with zero + configuration, and an agent hand-writing a batch plan has the exact field + contract to check against before the `apply` dry-run. `tests/test_schemas.py` + keeps both contracts honest with a stdlib-only mini validator. +- **CTX-09 optional keys**: a note header may carry `name` and `description` + (the one-fact-per-file shape inspired by the Claude Code memory tool) and + `superseded_by`, the path or stem of the note that replaced this one — pure + metadata, never part of the pointer scan, no new finding. The naked-pointer + scan now skips front-matter, so `superseded_by` values are not misread as + naked pointers. `spec_version` stays 1. +- **Open conventions, sourced**: the spec's conventions section now states + AGENTS.md as an open format (nearest-wins nested discovery, the same + narrow-never-contradict discipline as CTX-01, plus the + `ln -s AGENTS.md CLAUDE.md` recipe) and YAML front-matter as the de-facto + standard Jekyll, Hugo and Gray Matter share. +- **README positioning**: both READMEs gain a schema-contracts chapter, the + conventions sourcing, a compact prior-art section (Cline Memory Bank, + Claude Code memory tool, Letta, Mem0, Zep — inspired-by wording + throughout), and the Anthropic vocabulary (structured note-taking, + 'just in time' context, context rot, compaction); the project tree lists + `schemas/`. English and Chinese stay semantically aligned. + +## 0.9.0 — 2026-11-14 + +The "installed and fully usable" release: the new-user journey is closed end +to end — first run, configuration, onboarding a project, and the patrol loop. + +- **First run without a config**: guster probes the conventional roots + (`~/Projects`, `~/code`, `~/dev`, `~/src`), scans hits under an + "Unconfigured" banner telling you to run `guster init`, and fails loud + (exit 1, pointing at `init --root`) when none exists. The silent fallback + to scanning the whole home directory is gone. `init` now writes the + detected roots instead of hardcoding `~/`; a bare `init` with no candidates + requires `--root`. +- **`guster check`**: `scan` → `doctor` → `score --trend` in one pass, one + report; the exit code carries the doctor semantics (2 high, 3 critical). + Human-driven patrol only — no scheduled runs. +- **`guster zones list|add|remove`**: manage the machine zones in + `config.json` with the same fail-loud validation as the rest of the config. +- **Config validation is uniform**: `roots` must be a list of existing + absolute paths (a bare string is a type error, never a list of characters), + `roots: []` is rejected, as are relative paths, missing zone directories + and a `hub` that is not a directory. +- **Default hub de-privatized**: nothing defaults to a private layout anymore; + without a config there is no hub and the banner says so. `hub status` + prints "no hub attached" and exits 0; `--hub` pointing at a non-hub + directory is a `hub-manifest-missing` finding instead of a silent clean + report. Hub wording: "missing" → "absent". +- **Registry drift (CTX-10)**: the machine table (`registry.json`), the hub's + human table (`projects/_registry.md`, read through its path column) and the + git roots on disk are three-way diffed; dead rows, unscanned rows and + unregistered projects are findings, never a CHI dimension. `host:/path` + remote rows are counted apart. +- **Data safety**: state writes are atomic (tmp + `os.replace`) and serialized + by an flock on `/.lock`; `--no-write` genuinely suppresses the + state file of `scan`, `doctor`, `score` and `check`; a corrupt registry + warns and rescans instead of silently self-healing. +- **Freshness and dates**: `verified_at` is the canonical date key; English + prose keys (`Last updated:`/`updated:`) join the Chinese family; without a + declared date the ladder falls back to the last git commit and then to file + mtime (labeled in the raw column). Index matching requires the backtick + form, so `a.md` no longer hits `data.md`. +- **Credentials**: rows with too few columns raise parse warnings instead of + vanishing; `guster credentials` prints bilingual scope labels; the fixed + 9-column order is documented with a copyable sample (README and spec). +- **Plans and recovery**: a bad plan reports the expected schema shape; + `.moved.md` pointers carry a `verified_at` date; only the newest 10 plan + backup directories are kept; a failed apply rolls back automatically, and + if the rollback itself fails the error names the backup directory for + manual recovery (there is no separate rollback command — the README now + says exactly this). +- **Skill**: new "New project onboarding" playbook (inventory roots/zones → + propose placement → user confirms → create + `init --project` → draft the + CTX-10 registry row → `scan`/`doctor` close the loop; git operations follow + the user's own git conventions). Waivers now state explicitly that a waiver + greens the gate, not the score. "Company repository" wording is replaced by + the mechanism: tracked files you do not own or have no authority over. + Private skill references are gone. +- **Docs**: README/README_CN gain a roots-and-zones configuration chapter + (including `scan_max_depth`), the `check` command, a full exit-code table + (0–4, shared with the skill), and the four fixed inaccuracies (backups + manual recovery, five state files, `export`'s default output path, the + credential sample row). Hub templates emit `verified_at` dates. The main + `guster --help` carries a one-line epilog about state writes and exit codes. + +## 0.8.0 — 2026-11-14 + +- **Declarative hub contract (schema 2)**: `hub.yaml` sections are now + declared, not prescribed. A schema-2 hub declares what it has — only + `knowledge` and `projects` are mandatory — so a hub without a `tools` + section validates instead of failing. Declared sections may point outside + the hub with an absolute or `~/` path (validated for existence, not + containment). Schema-1 manifests behave exactly as before. +- **Machine zones with governance profiles** (`config.json` `zones`): + `{path, profile}` entries describe tool areas that are not repositories. + The `light` profile scans AGENTS.md/README.md entry docs (pointer health, + freshness) and `.env` secrets without demanding `.agents/` slots — a + non-git tool layer is governed without pretending each tool is a project. + Registry and `status` carry the zone summary; bad zone config fails loud. +- **Tool entry docs join pointer checks**: artifacts of kind `tool` (hub + tools sections and machine zones) are now pointer-scanned like other entry + documents; previously only their AGENTS.md was seen. +- Pointer scan cap raised from 200 to 500 files per run. +- `status` warns when the cached registry was written by a different CLI + version, and prints declared zones. +- Default workspace roots no longer include the private `~/ZCodeProject`; + candidates are `~/IdeaProjects` and `~/Projects` (config overrides). +- `hub init` template now emits a schema-2 manifest. + +## 0.7.4 — 2026-11-12 + +- **CTX-09 opt-in now wins over malformedness** (`parse_note_header`): a + header that never declares `type:` can no longer report + `note-header-malformed`. Previously the parser bailed out as malformed + before reaching the `type:` gate, so legacy prose notes that merely open + with `---` (unclosed fence, prose inside the fence, a `----` opener, plain + non key:value lines) were flagged against the documented contract. The + opening fence is now strictly `---` (the same rule `parse_frontmatter` + applies), and only headers that opted in can be malformed. +- Note headers parse literal/folded block scalars (`updated: |` with an + indented block, `>` folded), aligning `parse_note_header` with + `parse_frontmatter` — a legal block-scalar date was previously reported + as a malformed line. +- **Apply rollback leaves no lying artifacts**: a `move` with a `.moved.md` + pointer now registers the pointer write in the undo list — a pre-existing + pointer is backed up and restored, a freshly written one is deleted — and + fresh `write` targets register an undo entry too. A failed batch now + restores sources, removes destinations, pointers and fresh writes, matching + the documented "backs up every touched path and rolls back on failure". + +## 0.7.3 — 2026-11-11 + +- **Legacy context reformat playbook** (`skills/guster/reference/reformat.md`): + step-by-step guidance for bringing a scattered, pre-spec context site under + the format contract — the piece the 0.7.0 spec lacked. Four passes: + inventory and classify (doctor findings as the worklist, one destination + class per artifact, duplicates pick a canonical copy), placement first + (`plan init` for the slots, `plan move` or one hand-written batch plan — + apply backs up every path and rolls back), content second (the CTX symptom + → transform table: index lines, naked paths to links, date lines, duplicate + to pointer card), then verify (`doctor` zero new findings, `score --trend` + before/after). Principles are explicit: meaning-preserving (no invented + facts), classify-before-touch (garbage is proposed for deletion, not + formatted), placement before content (paths final before pointers are + written). Deletions and distillations ride the classification table for + user approval; company-tracked files are never migration targets. + Field-tested on two real projects (a migrated repo with a stale cross-repo + link and a stray root state doc): the lessons — search referencers by stem + before moving, override shape-based slot suggestions by classification, + delete `.moved.md` transition pointers after referencers update — are + folded back into the playbook. +- SKILL.md wiring: trigger phrases for scattered/legacy context, a + "Reformatting legacy context" section, and the reference entry. + +## 0.7.2 — 2026-11-09 + +- **CTX-09 structured note headers** (opt-in): knowledge notes may carry YAML + front-matter following the Obsidian properties convention — the interchange + format Foam/Quartz/Logseq also accept, so guster defines no schema of its + own. A header that declares `type:` is machine-checked (`note-header-malformed`): + it must parse and carry a machine-readable date (`updated`/`date`/`lastmod`/ + `created`, YYYY-MM-DD), and the note's body then joins the CTX-03 pointer + scan so a pointer card's truth links are verified. Truth sources live in the + body as ordinary links, never as invented header keys. Legacy prose notes + without `type:` are unaffected. + +## 0.7.1 — 2026-11-09 + +- Fixed the placement tree in `reference/framework.md`: the three arrows for + status/proof/durable-understanding questions pointed at the wrong plane + numbers (4/5/6 instead of 5/6/4), contradicting the plane definitions in the + same file. +- Documentation now teaches bare commands instead of the no-op flags + `score --write` and `init --home`: the flags are still accepted for existing + scripts, but writing metrics and initializing the state home are the defaults + with or without them (README, README_CN, AGENTS.md, SKILL.md, doctor's + next-action hint. + +## 0.7.0 — 2026-11-09 + +- **Context format spec v1** (`skills/guster/reference/spec.md`): the format + contract behind the metrics, written down and versioned — eight rules + (`CTX-01..08`, markdownlint-style stable IDs) covering instruction files, + indexes, pointers, dates, slots, single-source, skill metadata and + credentials, each naming the finding that enforces it. Follows open + conventions: `AGENTS.md` (agents.md) for instruction files, llms.txt-shaped + link indexes, stable rule IDs. The skill cites it when writing or moving + context assets; project and hub scaffolds now state the pointer rule. +- **New finding `naked-pointer` (medium)**: file paths left outside a markdown + link or code span in an instruction or index document are reported — until + now such paths were invisible to the pointer check, so a broken link written + in prose never fired. Directory references in prose are deliberately not + flagged. Advisory only: no CHI dimension changes, scores stay comparable. +- `metrics.raw.naked_pointers` counts the new finding; the guster skill + workflow adds a post-apply `doctor` pass and triggers on 上下文格式/格式规范. + +## 0.6.1 — 2026-11-05 + +- **Workspace and group roots are no longer scored as projects.** A directory + that holds other scanned projects (a per-user workspace root, a per-group + checkout root) carries group-level `AGENTS.md` files but is not a project: counting it + inflated `Projects:` and turned one container's partial `.agents/` into a + permanent placement failure. `registry.json` marks `container`, PCR/ICR skip + them, and the report reads `Projects: 62 (workspace containers: 2)`. +- **PCR explains itself.** The raw column breaks a shortfall into extra + top-level entries / missing slots / missing index. "9/41 · 25 extra entries" + is actionable; "21.4%" alone reads like a crisis. +- Two boundaries are now written down instead of being implicit, so they stop + coming back as "bugs": PCR's denominator is adopters only (a repo whose sole + context asset is one well-placed `AGENTS.md` has nothing to place — demanding + six empty slot directories there would be structure theater, and + `/skills/` is product source in a skill repository, not unplaced + context), and SIR does not scan arbitrary file content for token shapes (the + release gate owns that; SIR only claims host configuration it actually read). + +## 0.6.0 — 2026-11-05 + +Measurement honesty pass. Every change below removes a case where the score +claimed knowledge it did not have. + +- **An empty denominator is now `n/a`, not 1.0.** A dimension with no evidence + is dropped and the remaining weights are renormalized; a scope with no + evidence reports `CHI: n/a`. This reverses the 0.5.5 behavior ("empty + denominators still print `0/0` and score 1.0"), which let a scope with fewer + artifacts outrank a measured one. `project`/`group` CHI therefore drops when + their denominators are empty, and scores are no longer comparable across + scopes with different coverage. RBR follows the same rule per component: a + missing entry file is not a perfect budget. +- **Git probe failures are loud instead of clean.** `git ls-files` and + `git log` returning an error used to look like "no tracked files" and "no + commit dates": credentials read as isolated and state documents read as + undated. Both now return `None`, surface as a new `git-unavailable` finding, + and SIR counts the affected credentials as unverified. `registry.json` + records `git_state` per project. +- **SIR stops punishing registered credentials.** The numerator is now + unregistered-outside + tracked + unverified + inline, so a file declared in + `~/.agents/credentials/registry.md` no longer costs points; previously 30 of + 31 in-place company `.env` files were counted as failures while the matching + finding was suppressed. The `secret-outside-root` finding and SIR finally + share one definition. +- **Dates are read where a freshness claim actually lives.** A filename date + must open the name (`2026-11-05-x`, `20261105-x`); `ticket-20261105-notes.md` + no longer counts as today's work. `最后更新` is matched in the first 40 lines + only, so prose mentioning another file cannot date this one. +- **PHR sees directory pointers** (`knowledge/general/`) and resolves paths + against the enclosing repository root, so `.claude/CLAUDE.md` and + `.agents/README.md` stop reporting root-relative links as broken. The report + states when the 200-file pointer cap narrowed the scan. +- **RBR probes the host that is actually installed.** It used to read + `~/.zcode/AGENTS.md` only; a DSH-only machine measured 0 bytes and scored + full marks. It now sums the entry files that exist, deduplicated by real path. +- **Wider credential detection, same read-only boundary.** `.env` discovery + goes two levels deep instead of one, and inline detection covers `api_key`, + `secret_key`, `auth_token` and `sk-…` shapes besides `Bearer`. Values stay + redacted and are never printed. +- **ICR requires a non-empty index**: an empty `README.md` no longer counts as + indexing `.agents/`. +- **`status` reports a snapshot instead of mixing two scans.** It used to run + fresh policy against a cached registry; it now prints the cached registry plus + the last `metrics.jsonl` entry, and says so. +- **`score --fail-under N`** turns CHI into an opt-in gate (exit 2). `score` + still exits 0 by default. +- **`metrics.jsonl` records the scope and both value sets** (raw `metrics` and + capped `scores`), so a trend line no longer mixes a budget ratio with a score. +- Knowledge files up to 8 MB are hashed (was 2 MB); oversized ones are counted + in `knowledge_unhashed` instead of silently skipping single-source checks. +- The report now prints how many projects have no `.agents/` directory, which + dimension had no evidence, and when the pointer scan was truncated. + +## 0.5.5 — 2026-11-05 + +- FRS now counts state documents under the hub project root (`projects/`), + `handoff/`, `provision/` and `.agents/plans/`, not only `kind: state`. + Project `.agents/plans/*` therefore enters the FRS denominator, so a project + or group with a stale plan loses freshness points instead of reporting + `100.0 (0/0)`. Plans use the existing 90-day rule: a declared + `verified_at`/`最后更新` or filename date, otherwise the last git commit of the + repository that owns them. Stale-state findings now point at the offending + in-scope document, so a project/group report explains the lost points instead + of filtering the finding out as hub-level. Empty denominators still print + `0/0` and score 1.0. +- `doctor --scope hub` reports the project cards known to the hub + (`Projects: 3 (scanned roots: 0)`) instead of the number of scanned roots, and + omits the empty `Workspaces:` header line when the scope has no workspaces. + +## 0.5.4 — 2026-11-04 + +- Removed three skill sub-pages that nothing pointed at: `init/SETUP.md`, + `use/OPERATE.md`, `test/SELFTEST.md`. `SKILL.md` carries the workflow itself; + the sub-pages had drifted and were never loaded. + +## 0.5.3 — 2026-11-04 + +- `doctor` reports exactly the dimensions that enter CHI for the run's scope. + `--scope hub` no longer prints RBR/PCR/SIR rows it never scores, and the + always-informational GCR value is labeled `Not counted in CHI`. +- `project` and `group` runs now apply one boundary to artifacts and findings: + hub knowledge, hub state documents and the machine-level local wiki no longer + sit in ICR/FRS/PHR denominators while their findings are filtered out. A + denominator now only contains documents that can raise an in-scope finding, + so those scopes no longer inherit a score from out-of-scope health. +- Removed the unused `templates/` file skeletons and `schema/*.json`: nothing + read them, and the project `AGENTS.md` / `.agents/README.md` text already + lives in `planner.py`. `templates/hub/` is the only shipped template set and + `package.json` no longer ships `schema/`. + +## 0.5.2 — 2026-11-04 + +- Bad plan files no longer crash: a non-object plan, a malformed operation, or an + unreadable plan path fails through the `[guster] ...` / plan-error output and a + non-zero exit. +- `guster apply --dry-run` is accepted as the documented explicit dry run and is + rejected when combined with `--yes`. +- A missing `--root` workspace and an unreadable or non-object Guster config now + fail loud instead of silently scanning defaults. +- Pointer health counts each target once per file, so a link whose text is also + inline code is no longer double-counted. +- Project `.agents/README.md` and hub knowledge indexes are now actually + pointer-checked; the filter listed them but they were never scanned. +- A refused `apply`, `init` or `hub init` prints `FAILED` instead of `APPLIED`. +- The home directory is no longer classified as a project just because it holds + the user-level `~/.agents/`; a fresh `init --home` setup scores clean. +- The setup skill points at the shipped `skills/` directory. + +## 0.5.1 — 2026-11-03 + +- Added reasoned `doctor.waivers` and precise pointer checks. +- Fixed double-counting of linked wiki files and OpenSpec state. +- Added `GUSTER_EXTRA_SKILL_ROOTS` for additional skill hosts. diff --git a/external_plugins/guster/LICENSE b/external_plugins/guster/LICENSE new file mode 100644 index 00000000..b6c14d9c --- /dev/null +++ b/external_plugins/guster/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Lumos-789 + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/external_plugins/guster/README.md b/external_plugins/guster/README.md new file mode 100644 index 00000000..392f621f --- /dev/null +++ b/external_plugins/guster/README.md @@ -0,0 +1,347 @@ +# Guster + +Guster is a distributable agent plugin that audits and evolves the context of a whole machine: projects, instruction files, skills, tools, knowledge, project state, evidence and credential references. It can also scaffold a lightweight Hub for durable knowledge and project state. + +It is the **control plane** for agent context. A Guster Hub is the optional **data plane**: the local repository that holds project cards, knowledge, tools and reports. The plugin does not replace the hub; it discovers it, validates it, and helps keep it coherent. + +## Prior art + +The ideas are borrowed with credit; the implementation is guster's own. + +- **Cline Memory Bank** — inspired the layered responsibilities of the files (project cards, knowledge, state) and the banking rhythm of refreshing them per working session; both banks are plain markdown. +- **Claude Code memory tool** — inspired the one-fact-per-file note shape and front-matter metadata; guster's note headers spell the keys `name`, `description`, `type`. +- **Letta (MemGPT)** — inspired the label/limit abstraction of memory blocks behind guster's resident budgets. +- **Mem0** — inspired the decide-first stance (ADD/UPDATE/DELETE/NOOP, soft invalidation by marking instead of deleting) behind plan/apply/waiver; a waiver greens the gate, not the score. +- **Zep/Graphiti** — inspired the dual-timeline fact model (`valid_at`/`invalid_at`); `superseded_by` is its one-file simplification. +- The framing vocabulary — structured note-taking (agentic memory), 'just in time' context, context rot, compaction — is inspired by Anthropic's "Effective context engineering for AI agents" (2025-09-29). + +## What it does + +- **Discovers** Git roots, `AGENTS.md` / `CLAUDE.md`, `.agents/` directories, skills, tools, knowledge, state, evidence and credential locations. +- **Diagnoses** resident budgets, skill metadata budgets, copy drift, duplicate canonical sources, orphan knowledge, broken pointers, misplaced task folders, stale state, inline tokens and credentials outside the canonical root. +- **Scores** context health with seven dimensions and a CHI dashboard. +- **Plans** structural changes as reviewable JSON plans. +- **Applies** only with `--yes`, backing up every touched path and rolling back + automatically when an operation fails. +- **Initializes** a standard `.agents/` layout for a new project or a new machine. +- **Scaffolds** a lite Guster Hub when the user does not have a data plane yet. + +## Quick start + +```bash +cd +./bin/guster init --yes +./bin/guster hub init --path --yes +./bin/guster scan +./bin/guster doctor +./bin/guster score +``` + +`guster check` runs the scan → doctor → score (with trend) pass as one command +when you want the whole picture at once. + +The CLI is Python 3.9+ and has no third-party Python dependencies. + +Install a stable command on your `PATH`: + +```bash +ln -s "$(pwd)/bin/guster" ~/.local/bin/guster +``` + +## Commands + +| Command | Purpose | +|---|---| +| `guster status` | Show plugin version, registry and health summary | +| `guster scan` | Discover context assets and write `registry.json` | +| `guster doctor` | Run policy checks and write `findings.json` | +| `guster score` | Compute metrics and CHI; append `metrics.jsonl`. `--fail-under N` turns it into a gate (exit 2) | +| `guster check` | `scan` + `doctor` + `score --trend` in one pass; exit code carries the doctor semantics | +| `guster zones list/add/remove` | Manage the machine zones in `config.json` | +| `guster plan findings` | Turn findings into a review checklist | +| `guster plan move` | Plan a move with backup and pointer | +| `guster plan init` | Plan a standard `.agents/` layout | +| `guster apply ` | Dry-run by default; `--yes` writes with backup | +| `guster init` | Initialize the state home or a project | +| `guster hub init` | Create a lite Hub and attach it to the local config | +| `guster hub attach` | Attach an existing Hub without copying its content | +| `guster hub status` | Show the Hub manifest and contract checks | +| `guster hub validate` | Validate the lite Hub contract | +| `guster link` | Check context pointers | +| `guster export` | Export a redacted Markdown/JSON report | +| `guster credentials` | List registered credentials by scope (company / personal) | +| `guster upgrade` | Check Codex/ZCode/package manifest versions | + +## Configuration: roots and zones + +`~/.agents/guster/config.json` declares where your context lives: + +```json +{ + "version": 1, + "roots": ["/home/me/Projects"], + "zones": [{ "path": "/home/me/tools", "profile": "light" }], + "scan_max_depth": 5 +} +``` + +- **`roots`** — the workspace roots scanned for git repositories. Must be a + list of existing absolute paths; a bare string, an empty list, a relative + path or a missing directory fails loud instead of being reinterpreted. +- **`hub`** — the attached Guster Hub path (written by `hub init`/`hub attach`). +- **`scan_max_depth`** — how deep under each root the scanner walks looking + for git repositories (default 5). Raise it for deeply nested layouts, lower + it to speed up huge trees. +- **`zones`** — tool areas that are not repositories: a tools directory you + want governed without pretending each tool is a project. A zone is scanned + light-style: its `AGENTS.md`/`README.md` entry docs join the pointer and + freshness checks, its `.env` files join the secret scan, and `.agents/` + slot compliance never applies. `profile` is recorded and must be + `light` or `full`; the scan itself is light for every zone today. + +Manage zones with the `zones` subcommand (`list`, `add --profile`, +`remove `); it writes `config.json` and applies the same validation. + +**First run without a config**: guster probes the conventional directories +`~/Projects`, `~/code`, `~/dev` and `~/src`. Hits are scanned with an +"Unconfigured" banner telling you to run `guster init` to pin them; if none +exists the command fails loud (exit 1) pointing at +`guster init --root `. Guster never silently scans your home directory. + +## Lite Hub + +The plugin can create a deliberately small data plane: + +```text +Guster/ +├── AGENTS.md +├── README.md +├── hub.yaml +├── knowledge/ +│ ├── README.md +│ └── general/start-here.md +├── projects/ +│ └── _registry.md +└── tools/ + └── README.md +``` + +`tools/` is present as an index and contract, with no tool preinstalled. `handoff/` and `reports/` are optional and are not created by the lite profile. The scanner skips missing optional directories. + +`guster hub init` refuses a non-empty target, writes a reviewable plan, and attaches the new Hub to `~/.agents/guster/config.json`. Use `guster hub attach --path ` for an existing Hub. + +The three core roots can be chosen at creation time: + +```bash +guster hub init --path --knowledge notes --projects work --tools scripts --yes +``` + +They are recorded in `hub.yaml` under `paths` and can be changed later. Paths must be relative to the Hub and must stay inside it. + +Scanning follows the directories that exist, not a mode: `profile` in `hub.yaml` is only a label. A hub is scanned across its knowledge root (`general/`, `projects/` and `workgroups/` under it), the configured project state root, `handoff/`, `provision/`, `reports/`, `Human Output/`, `manuals/`, `cron-tasks/`, `openspec/`, `archive/`, `.agents/plans/` and `strategy.md` whenever those exist. Generated or runtime areas such as `out/`, `.manual-site/`, `.playwright-mcp/` and `.codegraph/` are not treated as knowledge sources. `--scope hub` is Hub-only; local wiki and machine-level secrets belong to the machine scope. + +## Health model + +```text +CHI = 0.20 SSR + 0.15 RBR + 0.15 PCR + 0.15 ICR + + 0.15 FRS + 0.10 PHR + 0.10 SIR +``` + +- **SSR** single-source rate +- **RBR** resident budget ratio +- **PCR** placement compliance rate: share of `.agents/` dirs with all six + standard slots, a non-empty index and no unknown top-level entry. The + denominator is `.agents/` dirs only — a repository that never adopted the + layout is not scored, and a directory that holds other scanned projects (a + workspace or group root) is not a project. The report prints the failure + breakdown, so a low number says why instead of just being low. +- **ICR** index coverage rate +- **FRS** state freshness rate: share of state documents under the hub's + project root (`projects/`), `handoff/`, `provision/` and `.agents/plans/` + that were verified within the 90-day SLA. The denominator is those four + prefixes only — a hub `reports/` file or a machine-level note is not state. + The date comes from a declared key — `verified_at` (canonical), the Chinese + `最后更新` family or the English `Last updated:`/`updated:` — in the first 40 + lines, or a date that opens the filename (`2026-11-05-…`, `20261105-…`); + without one, the ladder falls back to the owning repository's last git + commit, then to file mtime (labeled as such in the raw column). A date + buried in prose or a ticket number inside the name is not a freshness claim. +- **PHR** pointer health rate +- **SIR** secret isolation rate: credential files plus literal tokens in host + configuration. Guster does not scan arbitrary file content for token shapes — + that is the release gate's job; SIR only claims what it actually looked at. + +Critical findings do not rescale CHI: they make `doctor` exit 3 (any `high` +finding exits 2), and the score stays the weighted sum above. Treat the exit code +as the gate and CHI as the trend. + +A dimension with no evidence is reported as `n/a` and dropped from the weighted +sum instead of scoring 1.0: an empty denominator means "not measured", not +"perfect". When every dimension of a scope is empty, CHI itself is `n/a`. + +## Context format spec + +The metrics are static — filename stems, content hashes, path resolution, git +dates — so they only see documents that keep the format contract. The contract +is written down and versioned: [`skills/guster/reference/spec.md`](skills/guster/reference/spec.md) +(spec_version 1, rules `CTX-01..10` — `CTX-09` structured note header, `CTX-10` +machine-readable project registry — markdownlint-style stable IDs). It follows +open conventions instead of inventing new ones: the open `AGENTS.md` format +([agents.md](https://agents.md)) for instruction files — discovery is nested +and nearest-wins, the same discipline as CTX-01 (a nested `AGENTS.md` narrows +the parent, never contradicts it), and a host that only reads `CLAUDE.md` is +served with `ln -s AGENTS.md CLAUDE.md` — llms.txt-shaped link indexes +([llmstxt.org](https://llmstxt.org)), YAML front-matter for note headers (the +de-facto standard Jekyll, Hugo and Gray Matter share), and stable rule IDs +like markdownlint. + +A document that ignores the contract is not scored lower — it is invisible: a +naked path in prose never reaches the pointer check, a date written as "last +week" falls back to git, an index without filenames counts as missing. Since +0.7.0 the `naked-pointer` finding closes that gap from the other side: file +paths left outside a link or code span in an instruction or index document are +reported, so the unwritable form is also the flagged form. + +## Schema contracts + +The two machine-readable formats carry JSON Schema (draft 2020-12) contracts, +derived from the code that reads and writes them: + +- [`schemas/hub.schema.json`](schemas/hub.schema.json) — `hub.yaml`. The + scaffolded manifest ships with a yaml-language-server modeline on its first + line, so the VS Code YAML extension (or any editor speaking + yaml-language-server) validates `hub.yaml` with zero configuration: + + ```yaml + # yaml-language-server: $schema=https://raw.githubusercontent.com/Lumos-789/guster/main/schemas/hub.schema.json + ``` + +- [`schemas/plan.schema.json`](schemas/plan.schema.json) — the plan JSON that + `plan` writes and `apply` executes. An agent hand-writing a batch plan has + the exact field contract to check against before the `apply` dry-run. + +## Scopes + +| Level | Command | Scored dimensions | +|---|---|---| +| machine | `guster doctor` | SSR RBR PCR ICR FRS PHR SIR | +| hub | `guster doctor --scope hub` | SSR ICR FRS PHR | +| group | `guster doctor --root A --root B` | SSR PCR ICR FRS PHR | +| project | `guster doctor --root ` | SSR PCR ICR FRS PHR | + +Scoped runs write to `~/.agents/guster/scoped//`. + +Every scoped run applies one boundary to both sides of the report: an artifact +counts toward a denominator only when a finding about it could also appear in +that scope. `project` and `group` runs therefore drop hub knowledge, hub state +documents and the machine-level local wiki from ICR/FRS/PHR unless they live +under one of the given roots; the report table shows exactly the dimensions that +enter CHI, and any extra value is labeled `Not counted in CHI`. A dimension with +no in-scope artifacts stays vacuous (`0/0` in the raw column, `n/a` score) instead +of borrowing health from out-of-scope files. This changes CHI for `project` and +`group` scopes; hub health keeps being reported by `--scope hub` and the +machine-wide run. Because empty dimensions are dropped and the weights are +renormalized over what remains, CHI is not comparable across scopes with +different coverage. + +## Credential registry + +Guster reads `~/.agents/credentials/registry.md` and checks it against every credential file it finds: + +- `secret-undeclared` - a credential file is not registered. +- `secret-missing` - a registered location no longer exists. +- `git-unavailable` - a repository could not be queried, so tracked state and + commit dates are unknown. SIR counts those credentials as unverified rather + than clean. + +The registry holds scope (`company` / `personal`), site, account, kind, location and variable names. +It never holds values. `guster credentials` prints the split. A copyable row +(column order is fixed — see the format spec; the first six columns are +required, `keys`/`used_by`/`status` are optional): + +```markdown +| ID | scope | site | account | kind | locations | keys | used_by | status | +|---|---|---|---|---|---|---|---|---| +| example-host | personal | example.com | me@example.com | token | `~/.agents/credentials/example-host.env` | `EXAMPLE_HOST_TOKEN` | my-cli | active | +``` + +## The eight planes + +1. **Truth** — code, tests, build and runtime config. +2. **Instruction** — `AGENTS.md` and policies. +3. **Capability** — skills, tools, MCP, plugins, scripts. +4. **Knowledge** — durable principles, methods, business semantics, pitfalls. +5. **State** — project cards, handoffs, environment and port registries. +6. **Evidence** — reports, screenshots, videos, test output. +7. **Runtime** — sessions, caches, logs, temp files, browser profiles. +8. **Secret** — passwords, tokens, keys, cookies; references only. + +## Safety + +- Read-only on your workspace by default. `apply --yes`, `init --yes`, `hub init --yes` and `hub attach` are the only commands that change workspace files or Guster config on their own; `export` always writes a report file — `/context-health.md` by default, or the path you name with `--out` (plus a `.json` sibling with `--format json`). +- Guster keeps five files under its state directory (`~/.agents/guster/`, or `scoped//`): `config.json` (roots/zones/hub, written by `init`, `hub init`/`attach` and `zones`), `registry.json`, which every scanning command rewrites (`status` included, when no registry exists yet), `findings.json` from `doctor`, `metrics.jsonl` from `score`, and the transient `.lock` that serializes concurrent runs. `--no-write` suppresses the state writes of `scan`, `doctor`, `score` and `check` only. (`plans/` and `backups/` are directories, not files.) +- Credential values are never persisted or printed; scans keep only paths and redacted shapes. +- No automatic `git add`, `commit`, `push` or deploy. +- Tracked files you do not own or have no authority over — a shared or employer repository usually qualifies — are not ordinary migration targets. +- Plans are written to `~/.agents/guster/plans/`. `apply` copies every touched path under `~/.agents/guster/backups//` before changing it, and rolls back automatically when an operation fails; if the rollback itself fails, the error names that backup directory and you restore by copying the pre-change copies back. Only the newest 10 plan backup directories are kept. + +## Exit codes + +| Code | Meaning | +|---|---| +| `0` | success — clean run, or findings no worse than `medium` | +| `1` | tool/config error: malformed or unreadable plan, an apply that failed mid-operation and was rolled back, missing workspace root, invalid `config.json` (non-list `roots`, a bad root/zone/hub path, empty `roots`, no scan candidates — run `guster init`); `hub status` also returns 1 when the attached hub fails its checks | +| `2` | `doctor`/`check` found `high` (but no `critical`) findings; `score --fail-under` below target or CHI not computable; `hub validate` failed the lite contract; `link` found broken pointers; `upgrade` found disagreeing manifest versions | +| `3` | `doctor`/`check` found `critical` findings | +| `4` | `apply`, `init` or `hub init` refused the plan at preflight — nothing was touched (missing move source, existing destination, bad target type) | + +The same table ships in the `guster` skill so agents and humans read one +contract. Treat the exit code as the gate and CHI as the trend. + +## Plugin hosts + +| Host | Manifest | +|---|---| +| Codex | `.codex-plugin/plugin.json` | +| ZCode | `.zcode-plugin/plugin.json` | +| DSH | `package.json` + `cordis.patch.yml` | + +All three point at `skills/` (the `guster` and `guster-hub` skills). Keep their versions synchronized. + +```bash +# DSH bundle +dsh plugin add /path/to/guster +``` + +### Extra skill roots + +By default guster scans `~/.agents/skills`, `~/.codex/skills`, `~/.dsh/skills` and +`~/.claude/skills`. Additional hosts stay local and are injected without changing +the published source: + +```bash +export GUSTER_EXTRA_SKILL_ROOTS="name=/path/to/skills:other=/another/path" +``` + +## Project layout + +```text +skills/guster/ agent-facing skill +skills/guster-hub/ hub bootstrap and validation skill +src/guster/ Python CLI and policy engine +bin/guster executable wrapper +templates/hub/ lite Hub scaffold (the only shipped template set) +schemas/ JSON Schema contracts for hub.yaml and plan JSON +tests/ fixture and plugin tests +``` + +## Test + +```bash +python3 -m unittest discover -s tests -v +node --test tests/test_plugin.mjs +``` + +## License + +MIT © Lumos-789 diff --git a/external_plugins/guster/README_CN.md b/external_plugins/guster/README_CN.md new file mode 100644 index 00000000..7e470494 --- /dev/null +++ b/external_plugins/guster/README_CN.md @@ -0,0 +1,287 @@ +# Guster + +Guster 是一个可分发的 Agent 插件,用来审计和演进整台机器的上下文:项目、指令文件、Skill、工具、知识、项目状态、证据和凭据引用;也可以初始化一个轻量 Hub,承载长期知识与项目状态。 + +它是上下文的**控制面**。Guster Hub 是可选的**数据面**:承载项目卡、知识、工具和报告的本地仓库。插件不替代 Hub,而是发现它、校验它,并帮助它保持自洽。 + +## 理念来源 + +理念皆有出处,实现是 guster 自己的: + +- **Cline Memory Bank** —— 启发了分层文件的职责划分(项目卡、知识、状态)与每个工作会话刷新一次的 banking 节奏;两边的记忆库都是纯 markdown。 +- **Claude Code memory tool** —— 启发了「一事实一文件」的笔记形状与 front-matter 元数据;guster 的笔记头把这些键拼写为 `name`、`description`、`type`。 +- **Letta (MemGPT)** —— 启发了 memory block 的 label/limit 抽象,guster 的常驻预算背后正是它。 +- **Mem0** —— 启发了先裁决再动手的语义(ADD/UPDATE/DELETE/NOOP、以标记代删除的软失效),落到 plan/apply/waiver;waiver 只让门禁变绿,不改分数。 +- **Zep/Graphiti** —— 启发了双时间轴事实建模(`valid_at`/`invalid_at`),`superseded_by` 是它的文件化简化。 +- 定位词汇——structured note-taking(agentic memory)、'just in time' context、context rot、compaction——借鉴自 Anthropic《Effective context engineering for AI agents》(2025-09-29)。 + +## 它做什么 + +- **发现** Git 根、`AGENTS.md` / `CLAUDE.md`、`.agents/`、Skill、工具、知识、状态、证据和凭据位置。 +- **诊断** 常驻预算、Skill 元数据预算、副本漂移、多规范源、孤儿知识、断链、错位任务目录、陈旧状态、内联 token 和凭据越界。 +- **评分** 用七个维度和一个 CHI 仪表盘衡量上下文健康。 +- **计划** 把结构变更写成可审阅的 JSON plan。 +- **执行** 只有带 `--yes` 才写入;每个被改路径先备份,操作失败自动回滚。 +- **初始化** 新项目或新机器的标准 `.agents/` 布局。 +- **脚手架** 用户还没有数据面时,生成一个 Lite Guster Hub。 + +## 快速开始 + +```bash +cd +./bin/guster init --yes +./bin/guster hub init --path --yes +./bin/guster scan +./bin/guster doctor +./bin/guster score +``` + +想一次拿到全貌时,`guster check` 一条命令跑 scan → doctor → score(含趋势)。 + +CLI 依赖 Python 3.9+,无第三方 Python 依赖。 + +安装一个稳定的 `guster` 命令: + +```bash +ln -s "$(pwd)/bin/guster" ~/.local/bin/guster +``` + +## 命令 + +| 命令 | 用途 | +|---|---| +| `guster status` | 查看插件版本、registry 和健康摘要 | +| `guster scan` | 发现上下文资产并写 `registry.json` | +| `guster doctor` | 跑规则并写 `findings.json` | +| `guster score` | 计算指标和 CHI,追加 `metrics.jsonl`;`--fail-under N` 变成门禁(低于则退出码 2) | +| `guster check` | `scan` + `doctor` + `score --trend` 一条命令跑完;退出码承接 doctor 语义 | +| `guster zones list/add/remove` | 管理 `config.json` 里的机器 zone | +| `guster plan findings` | 把发现转成审阅清单 | +| `guster plan move` | 计划一次带备份和指针的移动 | +| `guster plan init` | 计划标准 `.agents/` 布局 | +| `guster apply ` | 默认 dry-run;`--yes` 才写入 | +| `guster init` | 初始化状态目录或项目布局 | +| `guster hub init` | 创建 Lite Hub 并接入本地配置 | +| `guster hub attach` | 接入已有 Hub,不复制其内容 | +| `guster hub status` | 查看 Hub manifest 和契约检查 | +| `guster hub validate` | 校验 Lite Hub 契约 | +| `guster link` | 检查上下文指针 | +| `guster export` | 导出脱敏 Markdown/JSON 报告 | +| `guster credentials` | 按范围(公司 / 个人)列出已登记凭据 | +| `guster upgrade` | 检查 Codex/ZCode/package 版本一致性 | + +## 配置:roots 与 zones + +`~/.agents/guster/config.json` 声明你的上下文在哪里: + +```json +{ + "version": 1, + "roots": ["/home/me/Projects"], + "zones": [{ "path": "/home/me/tools", "profile": "light" }], + "scan_max_depth": 5 +} +``` + +- **`roots`** —— 扫 git 仓库的工作区根。必须是「已存在的绝对路径」列表; + 裸字符串、空列表、相对路径、不存在的目录都会 fail-loud,绝不悄悄换解释。 +- **`hub`** —— 已接入的 Guster Hub 路径(由 `hub init`/`hub attach` 写入)。 +- **`scan_max_depth`** —— 在每个 root 下找 git 仓库时的目录递归深度(默认 5)。 + 嵌套深的布局可以调大,巨大的目录树可以调小加速。 +- **`zones`** —— 不是仓库的工具区:想让一个工具目录被治理、又不必把每个工具 + 当成项目。zone 按 light 方式扫描:其 `AGENTS.md`/`README.md` 入口文档进指针 + 与新鲜度检查,`.env` 进密钥扫描,`.agents/` 六槽合规永不适用。`profile` + 会被记录且只允许 `light`/`full`;当前扫描对所有 zone 都是 light 行为。 + +zone 用 `zones` 子命令管理(`list`、`add --profile`、`remove `), +直接写 `config.json`,校验同上。 + +**没有 config 的首跑**:guster 探测约定目录 `~/Projects`、`~/code`、`~/dev`、 +`~/src`。命中即照常扫描并打「未配置」横幅提示跑 `guster init` 固定;一个都 +没有则 fail-loud(退出码 1)并指路 `guster init --root `。绝不静默扫 +整个 home 目录。 + +## Lite Hub + +插件可以生成一个刻意保持很小的数据面: + +```text +Guster/ +├── AGENTS.md +├── README.md +├── hub.yaml +├── knowledge/ +│ ├── README.md +│ └── general/start-here.md +├── projects/ +│ └── _registry.md +└── tools/ + └── README.md +``` + +`tools/` 只提供索引和收录契约,不预装任何工具;`handoff/`、`reports/` 仍是可选模块,Lite 档不创建,扫描器会跳过缺失的可选目录。 + +`guster hub init` 会拒绝非空目录,先写可审阅的 plan,再把新 Hub 接入 `~/.agents/guster/config.json`。已有 Hub 用 `guster hub attach --path `。 + +三个核心目录可以在创建时自定义: + +```bash +guster hub init --path --knowledge notes --projects work --tools scripts --yes +``` + +它们记录在 `hub.yaml` 的 `paths` 下,之后也可以修改。路径必须是 Hub 内的相对路径。 + +扫描按目录是否存在走,不是开关:`hub.yaml` 里的 `profile` 只是标签。Hub 只要有 knowledge 根(其下的 `general/`、`projects/`、`workgroups/`)、配置的项目状态根、`handoff/`、`provision/`、`reports/`、`Human Output/`、`manuals/`、`cron-tasks/`、`openspec/`、`archive/`、`.agents/plans/` 和 `strategy.md`,就会被扫到。`out/`、`.manual-site/`、`.playwright-mcp/`、`.codegraph/` 等生成物或运行态不作为知识源。`--scope hub` 只算 Hub;本地 wiki 和机器级凭据归机器范围。 + +## 健康模型 + +```text +CHI = 0.20 SSR + 0.15 RBR + 0.15 PCR + 0.15 ICR + + 0.15 FRS + 0.10 PHR + 0.10 SIR +``` + +- **SSR** 单源率 +- **RBR** 常驻预算比 +- **PCR** 落位合规率:`.agents/` 中同时具备 6 个标准槽、非空索引且无未知顶层项的比例。 + 分母只算 `.agents/` 目录本身 —— 从未采用该布局的仓库不计分,而「包含其他已扫描项目」 + 的目录(工作区或组根)不算项目。报告会打出不合格原因分布,低分能自己解释为什么低。 +- **ICR** 索引覆盖率 +- **FRS** 状态新鲜度:Hub 项目卡目录(`projects/`)、`handoff/`、`provision/` + 与 `.agents/plans/` 四类状态文档中在 90 天 SLA 内核实过的比例;分母只认这四个 + 前缀,Hub `reports/` 或机器级笔记不算状态文档。日期取自前 40 行内的声明键—— + `verified_at`(canonical)、中文 `最后更新` 族或英文 `Last updated:`/`updated:` + ——或文件名开头处的日期(`2026-11-05-…`、`20261105-…`);都没有时依次兜底到 + 所属仓库最后一次 git 提交、再兜底文件 mtime(Raw 列会标注来源)。正文深处的 + 日期和文件名里的工单号都不算新鲜度声明。 +- **PHR** 指针健康率 +- **SIR** 敏感隔离率:凭据文件 + host 配置里的字面令牌。Guster 不扫描任意文件内容找 + token 形状 —— 那是发布闸的职责;SIR 只声称它确实看过的东西。 + +严重 finding 不改写 CHI:它让 `doctor` 以 3 退出(任意 `high` 退出 2),分数仍是上面的加权和。门禁看退出码,CHI 看趋势。 + +某个维度没有证据时记为 `n/a` 并从加权和中剔除,而不是记 1.0:空分母表示「没测」,不是「满分」。某 scope 的所有维度都为空时,CHI 本身为 `n/a`。 + +## 上下文格式规范 + +指标全是静态的——文件名主干、内容哈希、路径解析、git 日期——所以只有守住格式契约的文档才被测得到。契约本身已写成文档并版本化:[`skills/guster/reference/spec.md`](skills/guster/reference/spec.md)(spec_version 1,规则 `CTX-01..10`——`CTX-09` 结构化条目头、`CTX-10` 机器可读项目登记表,markdownlint 式稳定编号)。它遵循开源惯例而不是另造一套:指令文件用 `AGENTS.md` 开放格式([agents.md](https://agents.md))——发现规则是嵌套 nearest-wins,与 CTX-01(嵌套只收窄、绝不矛盾)是同一条纪律,只认 `CLAUDE.md` 的宿主用 `ln -s AGENTS.md CLAUDE.md` 即可伺候——索引文件用 llms.txt 形态的链接列表([llmstxt.org](https://llmstxt.org))、笔记头用 YAML front-matter(Jekyll/Hugo/Gray Matter 共同坐实的业界事实标准)、规则编号学 markdownlint。 + +不守契约的文档不是被扣分——而是彻底隐身:正文里裸写的路径永远到不了指针检查、「上周更新」落到 git 时间兜底、索引里没有文件名等于没索引。0.7.0 起 `naked-pointer` finding 从另一侧堵上这个缺口:指令文档/索引页里留在链接和代码记号之外的文件路径会被直接报告,写不规范的形态同时也是会被标记的形态。 + +## Schema 契约 + +两份机器可读格式都带 JSON Schema(draft 2020-12)契约,字段全部从读写它们的代码实况推导: + +- [`schemas/hub.schema.json`](schemas/hub.schema.json) —— `hub.yaml` 清单。脚手架生成的 manifest 首行自带 yaml-language-server modeline,VS Code YAML 扩展(或任何接 yaml-language-server 的编辑器)零配置即可校验: + + ```yaml + # yaml-language-server: $schema=https://raw.githubusercontent.com/Lumos-789/guster/main/schemas/hub.schema.json + ``` + +- [`schemas/plan.schema.json`](schemas/plan.schema.json) —— `plan` 产出、`apply` 执行的 plan JSON。agent 手搓批量 plan 时,它就是完整的字段契约,`apply` dry-run 前先对照自查。 + +## 层级 + +| 层级 | 命令 | 计分维度 | +|---|---|---| +| 机器 | `guster doctor` | SSR RBR PCR ICR FRS PHR SIR | +| Hub | `guster doctor --scope hub` | SSR ICR FRS PHR | +| 组 | `guster doctor --root A --root B` | SSR PCR ICR FRS PHR | +| 项目 | `guster doctor --root ` | SSR PCR ICR FRS PHR | + +带范围的运行写入 `~/.agents/guster/scoped//`。 + +每个带范围的运行对报告两侧使用同一条边界:一个 artifact 只有在「针对它的 finding 也能出现在该 scope」时,才计入分母。因此 `project` / `group` 运行会把 Hub 知识、Hub 状态文档和机器级本地 wiki 从 ICR/FRS/PHR 分母中剔除,除非它们就在给定 root 之下;报告表格只列真正进入 CHI 的维度,额外展示的数值必须标注 `Not counted in CHI`。某个维度在该 scope 内没有 artifact 时保持空集口径(Raw 列显示 `0/0`,得分 `n/a`),而不是借用 scope 外文件的健康度。这会改变 `project` / `group` 的 CHI;Hub 健康度仍由 `--scope hub` 和全机运行报告。空维度被剔除后权重在剩余维度上归一,因此覆盖度不同的 scope 之间 CHI 不可横向比较。 + +## 凭据登记 + +Guster 读取 `~/.agents/credentials/registry.md`,并对照它检查发现的每个凭据文件: + +- `secret-undeclared` — 凭据文件没有登记。 +- `secret-missing` — 已登记的位置已不存在。 +- `git-unavailable` — 某个仓库查询失败,跟踪状态与提交日期未知;SIR 会把这类凭据记为「未核实」而不是「干净」。 + +登记表保存范围(`company` / `personal`)、站点、账号、类型、位置和变量名,从不保存凭据值。`guster credentials` 按范围输出。一行可复制的样例(列序固定——详见格式规范;前 6 列必填,`keys`/`used_by`/`status` 可选): + +```markdown +| ID | scope | site | account | kind | locations | keys | used_by | status | +|---|---|---|---|---|---|---|---|---| +| example-host | personal | example.com | me@example.com | token | `~/.agents/credentials/example-host.env` | `EXAMPLE_HOST_TOKEN` | my-cli | active | +``` + +## 八个平面 + +1. **Truth** — 代码、测试、构建和运行配置。 +2. **Instruction** — `AGENTS.md` 和策略。 +3. **Capability** — Skill、工具、MCP、插件、脚本。 +4. **Knowledge** — 稳定原则、方法、业务语义、坑。 +5. **State** — 项目卡、交接、环境和端口台账。 +6. **Evidence** — 报告、截图、视频、测试输出。 +7. **Runtime** — 会话、缓存、日志、临时文件、浏览器 profile。 +8. **Secret** — 密码、token、key、cookie;只存引用。 + +## 安全边界 + +- 默认不写工作区:只有 `apply --yes`、`init --yes`、`hub init --yes` 和 `hub attach` 会自行改动工作区文件或 Guster 配置;`export` 总会写报告文件——默认 `/context-health.md`,或 `--out` 指定的路径(`--format json` 时另加 `.json` 姊妹文件)。 +- Guster 会在状态目录(`~/.agents/guster/` 或 `scoped//`)维护五个文件:`config.json`(roots/zones/hub,由 `init`、`hub init`/`attach` 和 `zones` 写入)、所有扫描类命令都会重写的 `registry.json`(`status` 在没有 registry 时也会写)、`doctor` 的 `findings.json`、`score` 的 `metrics.jsonl`,以及串行化并发运行的临时 `.lock`。`--no-write` 只对 `scan`、`doctor`、`score`、`check` 关闭本命令的状态写入。(`plans/` 与 `backups/` 是目录,不算文件。) +- 永不持久化或输出凭据值;扫描只保留路径和脱敏形态。 +- 不自动 `git add` / `commit` / `push` / 部署。 +- 不拥有、也无权变更其 tracked 文件的仓库——共享仓或雇主仓通常是——不是普通迁移目标。 +- plan 写 `~/.agents/guster/plans/`。`apply` 改动前把每个被触碰路径复制到 `~/.agents/guster/backups//`,操作失败自动回滚;若回滚本身也失败,报错会点名该备份目录,手工把改动前副本拷回即完成恢复。plan 备份目录只保留最近 10 个。 + +## 退出码 + +| 码 | 含义 | +|---|---| +| `0` | 成功——干净运行,或 finding 严重度不高于 `medium` | +| `1` | 工具/配置错误:plan 损坏或不可读、执行中失败且已回滚的 apply、工作区根不存在、`config.json` 无效(`roots` 非列表、root/zone/hub 路径坏、`roots` 为空、无可扫候选——跑 `guster init`);已接入 hub 校验不过时 `hub status` 也返回 1 | +| `2` | `doctor`/`check` 发现 `high`(但无 `critical`)finding;`score --fail-under` 低于目标或 CHI 不可算;`hub validate` 未过 Lite 契约;`link` 发现断链;`upgrade` 发现各 manifest 版本不一致 | +| `3` | `doctor`/`check` 发现 `critical` finding | +| `4` | `apply`、`init` 或 `hub init` 在 preflight 拒绝了 plan——什么都没动(move 源不存在、目标已存在、目标类型不对) | + +同一张表也随 `guster` skill 发布,agent 与人读同一份契约。门禁看退出码,CHI 看趋势。 + +## 插件宿主 + +| 宿主 | Manifest | +|---|---| +| Codex | `.codex-plugin/plugin.json` | +| ZCode | `.zcode-plugin/plugin.json` | +| DSH | `package.json` + `cordis.patch.yml` | + +三端都指向 `skills/`(`guster` 与 `guster-hub` 两个 Skill),版本必须同步。 + +```bash +# DSH bundle +dsh plugin add /path/to/guster +``` + +### 额外 Skill 根 + +默认扫描 `~/.agents/skills`、`~/.codex/skills`、`~/.dsh/skills` 和 `~/.claude/skills`。其他宿主保持在本机,通过环境变量注入,不改发布源: + +```bash +export GUSTER_EXTRA_SKILL_ROOTS="name=/path/to/skills:other=/another/path" +``` + +## 项目结构 + +```text +skills/guster/ agent 侧治理 skill +skills/guster-hub/ Hub 初始化与校验 skill +src/guster/ Python CLI 与策略引擎 +bin/guster 可执行入口 +templates/hub/ Lite Hub 脚手架(唯一随包发布的模板集) +schemas/ hub.yaml 与 plan JSON 的 JSON Schema 契约 +tests/ fixture 与插件测试 +``` + +## 测试 + +```bash +python3 -m unittest discover -s tests -v +node --test tests/test_plugin.mjs +``` + +## License + +MIT © Lumos-789 diff --git a/external_plugins/guster/assets/guster/icon.png b/external_plugins/guster/assets/guster/icon.png new file mode 100644 index 0000000000000000000000000000000000000000..cd932818d76d45855eee5276aa855a4095c6d45c GIT binary patch literal 157496 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
n7%1_r1fk3Oc!w(Q|mzzVE&F zecum}uhwG12wT~(hxHaaLmmCou=7vbpJVGF_2>DRcukb&TinTs3BmXix^BF$9Pft9r!$Pzd5-!7Ts%eF@{dOYG8!G$Usi=SyhCXH zG4v>oG#HGOiu?eKBCg9#e~zCK{24l0P!RLfH|G0XRm0>{T)3acH*3m*$5h7Yf*8*u zQ}P(5NSbG7cxJlevZ8E?;C*0dPnVWba8grDc7Q|vlH@a3r z2A2Y*0rNYgx}kppdtT7nVHh<~m~jaL2-XwU1SqvY@s68`JQGhxLr}xAd=m1ZXU&$F zPsKbahWK>m!v~M;9PgoXJ3|f#b_RZql*SU;lx8+6oa5^v-u6ooYp>0=FWzs>efKW% zxFEfS98iVTDtK(j!h5mz1(+z)Wbl)cGqXQ4v;$sbdeq9!@SZ=_pPA|sz;&xo8?R5; zUFQMDd|CL0&+zBB*!kR_!OpyH1~RB8aRbDrR)?A+Dcmy{kH79 ziqAt8^+4@+@q-&g9;85!O7!kSDxIl`S6#5QFO*`NQl7X}@?ynp6lF76MRMCVh&XTw zGqF!>Q}C$+!VLh=z?cXkS4=LBcP@h#O;te3 z-nEUUo``Dqbe#2+=tIxlvtgyjtr~;#IdQ``)g5DW$l--u71a zQdDAlcL1eLoA-l=Q|=I_ zp#CauVuuC`v>@(7u+WedO%>@xHr4!)ilFF>FisJ_GF2Hxjj~r{+m7Q03*>oRsWrX-kZ zA~QKn1m*iGyf9kn=_>uV{?dQ^$go-m;a}EG<_&;cr-iQQ*sJ0_l(a<%k0izs_*ARL z91JZYgd=7jaV0hVfIM|z*e@%G#Lxc3Yac3uE?!mt&41%x|IzRKu#|03Q>dzsaPL0l z#*W`rw+SD-e)!tmUtV731ZaHoS0BEfEyXY1y-b7G%gZoGt@XeAKltzev;V@s;8MI? zHgD-x)S%Klp1V9T?+;tmTE$d)E9zBr_g(6DUSHcw@tgD*0std8DRdr5q6dFaPt%rE zz_$0^_8ym{qU*-c$!YA|pozPhypNVb#Usr8WE+!l*^zRCNp-k&K641r9|s6LFza#a zFJ+TGA)Y)uTms*NXeziJyV4Up0{Y>c;{&TfbQMr!THP*uS4D;;81{1B2EidR;sBd^ zJm7I0$ZK~e7(AxB;?@GoyTbe7rW25}GQl<5+2xV*ReqKywAwsm=OGE7(i21kWH%5p zm?Jl(`eLt5D?SG8fpyqN0mc^{eTp=t_&?^ZTG?6EtnL5qzx{vv{&(J+-{voUmEKyr zTrP0yTwFzDToPIi*0$bzegE=^&bKzRZ@bULM5Klc=m&rDkN=B*;m^Mgr2cIOVH`+H zr+5f^_OTiwb`vqVeE8~m*|vSZHpOWwxZ`R+QXz8<^>(iww znp!!=0;tru&`u2jM6!?#!Dkpzl}l#E�={Ly1&-(mYM~yyG)S(M_;%7QdNQj-i_z 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 literal 0 HcmV?d00001 diff --git a/external_plugins/guster/bin/guster b/external_plugins/guster/bin/guster new file mode 100644 index 00000000..e97baaeb --- /dev/null +++ b/external_plugins/guster/bin/guster @@ -0,0 +1,13 @@ +#!/usr/bin/env bash +set -euo pipefail +SOURCE="${BASH_SOURCE[0]}" +while [ -L "$SOURCE" ]; do + DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)" + SOURCE="$(readlink "$SOURCE")" + case "$SOURCE" in + /*) ;; + *) SOURCE="$DIR/$SOURCE" ;; + esac +done +HERE="$(cd -P "$(dirname "$SOURCE")/.." && pwd)" +PYTHONPATH="$HERE/src${PYTHONPATH:+:$PYTHONPATH}" exec python3 -m guster "$@" diff --git a/external_plugins/guster/cordis.patch.yml b/external_plugins/guster/cordis.patch.yml new file mode 100644 index 00000000..e172e1ba --- /dev/null +++ b/external_plugins/guster/cordis.patch.yml @@ -0,0 +1,3 @@ +- insert: + - id: guster + name: 'guster' diff --git a/external_plugins/guster/index.js b/external_plugins/guster/index.js new file mode 100644 index 00000000..bb454824 --- /dev/null +++ b/external_plugins/guster/index.js @@ -0,0 +1,84 @@ +import { readFileSync } from "node:fs"; +import { join } from "node:path"; +import { fileURLToPath } from "node:url"; + +const skillRoots = { + guster: fileURLToPath(new URL("./skills/guster/", import.meta.url)), + "guster-hub": fileURLToPath(new URL("./skills/guster-hub/", import.meta.url)), +}; + +function parseFrontmatter(source, skillPath) { + const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/.exec(source); + if (!match) throw new Error(`guster: missing YAML frontmatter in ${skillPath}`); + const header = {}; + for (const rawLine of match[1].split(/\r?\n/)) { + const line = rawLine.trimEnd(); + if (!line || line.startsWith("#") || /^\s/.test(line)) continue; + const colon = line.indexOf(":"); + if (colon < 1) continue; + const key = line.slice(0, colon).trim(); + let value = line.slice(colon + 1).trim(); + if ( + (value.startsWith('"') && value.endsWith('"')) || + (value.startsWith("'") && value.endsWith("'")) + ) { + value = value.slice(1, -1); + } + header[key] = value; + } + return { header, body: source.slice(match[0].length).trimStart() }; +} + +function loadSkill(skillName) { + const skillRoot = skillRoots[skillName]; + const skillPath = join(skillRoot, "SKILL.md"); + const source = readFileSync(skillPath, "utf8"); + const { header, body } = parseFrontmatter(source, skillPath); + if (typeof header.name !== "string" || typeof header.description !== "string") { + throw new Error(`guster: invalid skill metadata in ${skillPath}`); + } + return { + name: header.name, + description: header.description, + content: body, + source: "bundled", + path: skillPath, + resourceBase: { kind: "directory", path: skillRoot }, + invocation: { modelInvocable: true, userInvocable: true }, + }; +} + +const skills = Object.keys(skillRoots).map((skillName) => loadSkill(skillName)); + +export const name = "guster"; +export const inject = ["skills", "agents"]; + +export function apply(ctx) { + for (const skill of skills) ctx.skills.register(skill); + + const agentRegistrations = new Map(); + const registerForAgent = (agent) => { + if (agentRegistrations.has(agent)) return; + const injection = agent.ctx.inject(["skills"], (agentCtx) => { + for (const skill of skills) agentCtx.skills.register(skill); + }); + agentRegistrations.set(agent, () => injection.dispose()); + }; + + for (const agent of ctx.agents.list()) registerForAgent(agent); + + ctx.on("agent/created", ({ agent }) => registerForAgent(agent)); + ctx.on("agent/disposed", ({ agent }) => { + agentRegistrations.get(agent)?.(); + agentRegistrations.delete(agent); + }); + + ctx.effect( + () => () => { + const disposals = [...agentRegistrations.values()].map((dispose) => dispose()); + agentRegistrations.clear(); + return Promise.all(disposals); + }, + "guster agent registrations", + ); +} diff --git a/external_plugins/guster/schemas/hub.schema.json b/external_plugins/guster/schemas/hub.schema.json new file mode 100644 index 00000000..fa72921e --- /dev/null +++ b/external_plugins/guster/schemas/hub.schema.json @@ -0,0 +1,111 @@ +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$id": "https://raw.githubusercontent.com/Lumos-789/guster/main/schemas/hub.schema.json", + "title": "Guster hub manifest", + "description": "Format contract for hub.yaml, the Guster hub manifest. Field semantics follow src/guster/layout.py and src/guster/hub.py. Guster reads values in their string form, so quoted and unquoted spellings of schema_version are equivalent.", + "type": "object", + "required": [ + "schema_version" + ], + "additionalProperties": false, + "properties": { + "schema_version": { + "description": "Manifest format major version; absent means 1.", + "enum": ["1", "2", 1, 2] + }, + "profile": { + "description": "Hub profile; any other value draws a `hub validate` warning.", + "type": "string", + "enum": ["lite", "full"] + }, + "hub_version": { + "description": "Version of the hub's own contract; informational, shown by `hub status`.", + "type": "string" + }, + "min_guster": { + "description": "Minimum guster CLI version this hub needs; compared numerically by dotted segments.", + "type": "string" + }, + "name": { + "description": "Human-readable hub name.", + "type": "string" + }, + "created_at": { + "description": "ISO date the hub was created.", + "type": "string" + }, + "paths": { + "description": "Declared hub sections. Relative values are hub-relative and must not contain '..'; a hub may also declare external sections with absolute or ~/ paths. Schema 2 must declare knowledge and projects.", + "type": "object", + "additionalProperties": { + "type": "string", + "minLength": 1 + }, + "properties": { + "knowledge": { + "type": "string", + "minLength": 1 + }, + "projects": { + "type": "string", + "minLength": 1 + }, + "tools": { + "type": "string", + "minLength": 1 + } + } + }, + "doctor": { + "description": "Settings for `guster doctor`.", + "type": "object", + "additionalProperties": false, + "properties": { + "waivers": { + "description": "Silence a finding; every waiver must carry a written reason.", + "type": "array", + "items": { + "type": "object", + "required": [ + "rule", + "reason" + ], + "additionalProperties": false, + "properties": { + "rule": { + "description": "Rule name of the waived finding, e.g. broken-pointer; the name a doctor finding reports, not the CTX spec id.", + "type": "string", + "minLength": 1 + }, + "path": { + "description": "Optional scope; only findings for this path are waived.", + "type": "string" + }, + "reason": { + "description": "Written justification; a waiver without one fails loud.", + "type": "string", + "minLength": 1 + } + } + } + } + } + } + }, + "if": { + "required": ["schema_version"], + "properties": { + "schema_version": { + "enum": ["2", 2] + } + } + }, + "then": { + "required": ["paths"], + "properties": { + "paths": { + "required": ["knowledge", "projects"] + } + } + } +} diff --git a/external_plugins/guster/schemas/plan.schema.json b/external_plugins/guster/schemas/plan.schema.json new file mode 100644 index 00000000..7435297e --- /dev/null +++ b/external_plugins/guster/schemas/plan.schema.json @@ -0,0 +1,161 @@ +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "$id": "https://raw.githubusercontent.com/Lumos-789/guster/main/schemas/plan.schema.json", + "title": "Guster plan", + "description": "Format contract for the plan JSON produced by src/guster/planner.py (build_plan and the op_* constructors) and consumed by `guster apply` (src/guster/executor.py). mkdir/move/write run on apply; manual ops stay a skipped checklist.", + "type": "object", + "required": [ + "version", + "id", + "created_at", + "title", + "notes", + "operations" + ], + "additionalProperties": false, + "properties": { + "version": { + "description": "Plan format version; the integer 1.", + "type": "integer", + "enum": [1] + }, + "id": { + "description": "Unique plan id; also the plan file name stem.", + "type": "string", + "minLength": 1 + }, + "created_at": { + "description": "ISO timestamp of plan creation.", + "type": "string" + }, + "title": { + "description": "One-line plan title.", + "type": "string", + "minLength": 1 + }, + "notes": { + "description": "What the plan does and how to apply it; may be empty.", + "type": "string" + }, + "operations": { + "description": "Ordered operations applied one by one; a failure rolls back.", + "type": "array", + "items": { + "oneOf": [ + { + "type": "object", + "required": [ + "kind", + "path" + ], + "additionalProperties": false, + "properties": { + "kind": { + "enum": ["mkdir"] + }, + "path": { + "description": "Directory to create.", + "type": "string", + "minLength": 1 + } + } + }, + { + "type": "object", + "required": [ + "kind", + "src", + "dst" + ], + "additionalProperties": false, + "properties": { + "kind": { + "enum": ["move"] + }, + "src": { + "description": "Existing file or directory to move.", + "type": "string", + "minLength": 1 + }, + "dst": { + "description": "Destination path; must not exist yet.", + "type": "string", + "minLength": 1 + }, + "pointer": { + "description": "Optional note left at the old location; null when unused.", + "oneOf": [ + { + "type": "null" + }, + { + "type": "object", + "additionalProperties": false, + "properties": { + "path": { + "type": "string" + }, + "content": { + "type": "string" + } + } + } + ] + } + } + }, + { + "type": "object", + "required": [ + "kind", + "path", + "content" + ], + "additionalProperties": false, + "properties": { + "kind": { + "enum": ["write"] + }, + "path": { + "description": "File to write.", + "type": "string", + "minLength": 1 + }, + "content": { + "description": "Full file content.", + "type": "string" + } + } + }, + { + "type": "object", + "required": [ + "kind", + "path", + "action", + "reason" + ], + "additionalProperties": false, + "properties": { + "kind": { + "enum": ["manual"] + }, + "path": { + "description": "Path the action is about; may be empty.", + "type": "string" + }, + "action": { + "description": "What a human should do.", + "type": "string" + }, + "reason": { + "description": "Why; usually the finding rule and message.", + "type": "string" + } + } + } + ] + } + } + } +} diff --git a/external_plugins/guster/skills/guster-hub/SKILL.md b/external_plugins/guster/skills/guster-hub/SKILL.md new file mode 100644 index 00000000..2bc955ff --- /dev/null +++ b/external_plugins/guster/skills/guster-hub/SKILL.md @@ -0,0 +1,85 @@ +--- +name: guster-hub +description: Create, attach or validate a lightweight Guster Hub data plane for the Guster plugin. Use when the user says 建文件阵地/Guster Hub/精简 Hub/初始化知识枢纽/接入现有 Hub. +--- + +# Guster Hub + +The Hub is the data plane: a plain repository for durable knowledge and project state. The Guster plugin is the control plane and reads this repository; it does not replace it. + +## Lite profile + +The lite Hub intentionally ships only: + +- `AGENTS.md`, `README.md` and `hub.yaml` +- `knowledge/` with a single index and one starter note +- `projects/` with a project registry +- `tools/` with an index and inclusion rules, but no tool preinstalled + +It does **not** ship `handoff/` or `reports/`. Add those later only when the workflow needs them. Missing optional directories are ignored by the scanner. + +The three core roots default to `knowledge/`, `projects/` and `tools/`, but they are configurable. They live in `hub.yaml` under `paths`. + +There is no mode switch: the scanner follows the directories that exist, and `profile` in `hub.yaml` is only a label. A fuller hub is also scanned across `handoff/`, `reports/`, `Human Output/`, `provision/`, `manuals/`, `cron-tasks/`, `openspec/`, `archive/`, `.agents/plans/`, `strategy.md` and `knowledge/workgroups/` when present. Generated directories such as `out/` are not knowledge sources. `--scope hub` excludes local wiki and machine-level secrets. + +## Workflow + +1. Check whether a hub is already attached: + +```bash +guster hub status +``` + +2. Create a new lite hub: + +```bash +guster hub init --path --yes +``` + +This refuses a non-empty target and attaches the new hub to `~/.agents/guster/config.json`. + +Choose custom core paths at creation time: + +```bash +guster hub init --path --knowledge notes --projects work --tools scripts --yes +``` + +Paths are relative to the Hub and must not escape it. To change them later, edit the `paths` map in `hub.yaml`, then run `guster hub validate`. + +The same manifest carries `doctor.waivers`: findings the owner knowingly accepts, each with a `reason` and an optional `path`. Keep them in the hub so the decision is versioned next to the corpus it protects. + +3. Validate and score it: + +```bash +guster hub validate +guster scan +guster doctor --scope hub +``` + +4. Add content: + +- Create one topic per file under `knowledge/general/` or `knowledge/projects/`. +- Add the file name to `knowledge/README.md`. +- Register a project in `projects/_registry.md`, then create `projects/{slug}.md`. +- Add a tool only when it is a run-once command: one directory with its own `AGENTS.md`, then a row in `tools/README.md`. +- Put `verified_at: YYYY-MM-DD` in every state document (`最后更新:` is the + accepted Chinese form; `verified_at` is canonical — see the format spec). +- Optional structured header (CTX-09): front-matter that declares `type:` plus a date key (Obsidian properties convention) opts the note into machine checks. Keep truth sources as body markdown links, never as invented header keys. + +## Existing hub + +If the directory already exists, use: + +```bash +guster hub attach --path +``` + +`attach` validates the core layout and backs up the Guster config before changing the hub path. Legacy hubs without `hub.yaml` are accepted with warnings; `guster hub validate` is the strict lite-contract check. + +## Boundaries + +- Never copy private content from another hub into a new one. +- Never add credentials, company secrets, generated caches or scratch files. +- Do not add optional modules just to fill the tree. +- Do not write Hub content from the governance skill; propose durable notes to + the user and let them (or their capture workflow of choice) file them. diff --git a/external_plugins/guster/skills/guster/SKILL.md b/external_plugins/guster/skills/guster/SKILL.md new file mode 100644 index 00000000..6ec55140 --- /dev/null +++ b/external_plugins/guster/skills/guster/SKILL.md @@ -0,0 +1,214 @@ +--- +name: guster +description: Audit and evolve agent context across projects, skills, tools, knowledge and credential references. Use when the user says 上下文治理/项目上下文/上下文结构/上下文格式/格式规范/整理 .agents/归位/搬迁/断链/健康评分/凭据登记, or asks where a fact, file, skill or credential belongs, or wants to reformat scattered legacy context into the standard format, or wants a before/after context health score. +--- + +# Guster + +Guster is the control plane for agent context. It discovers projects, instruction files, skills, tools, knowledge, state, evidence and credential references; diagnoses drift; computes a health score; and produces reviewable migration plans. + +Guster Hub is the data plane: the optional local repository that holds knowledge, project cards, tools and reports. Guster the plugin does not replace the hub. + +For a new data plane, use the companion `guster-hub` skill or `guster hub init`. + +## When to use + +Use Guster when the user asks: + +- to inspect or reorganize the machine's agent context structure; +- where a file, skill, tool, project card, knowledge note or credential reference belongs; +- to audit drift, duplicates, broken pointers, budgets or stale state; +- to initialize a project with the standard `.agents/` layout; +- to onboard a new project — place it, scaffold it and register it (see below); +- to migrate task folders into `plans/`, `wiki/`, `evidence/`, `tmp/` or `archive/`; +- to make context documents machine-verifiable under the context format spec; +- to reformat scattered, legacy (pre-spec) context into the standard format; +- for a context health score or a before/after comparison; +- to install the same context rules on another machine or workspace. + +Do not use Guster for ordinary code edits, runtime debugging or content writing unless the request is about the context structure itself. + +## Scope + +Four levels. `--scope` is inferred from `--root` when omitted. + +| Level | Command | Covers | Scored dimensions | +|---|---|---|---| +| machine | `guster doctor` | every repo under the workspace roots, declared `zones` and the hub | SSR RBR PCR ICR FRS PHR SIR | +| hub | `guster doctor --scope hub` | knowledge, project cards, tools, reports, handoffs | SSR ICR FRS PHR | +| group | `guster doctor --root A --root B [--root C]` | a requirement family or any set of related repos | SSR PCR ICR FRS PHR | +| project | `guster doctor --root ` | one repository | SSR PCR ICR FRS PHR | + +Rules: + +- Machine level owns resident budgets, skill budgets and credential layout. +- Hub level owns knowledge indexing, project-card freshness and hub pointers. +- Group level exposes cross-repo facts: the same file name with different content, + duplicated copies, and per-repo placement gaps. +- Project level shows only that repo's findings and states how many machine-level + findings were hidden. +- Every scoped run writes to `~/.agents/guster/scoped//`, so it never + overwrites the machine-wide registry or trend. +- Pointer checks skip documentation templates (`draft-NNN.md`, + `daily-YYYY-MM-DD.md`, `0X-xxx.md`) and `~/` paths that sit on an + `ssh`/`scp`/`rsync` command line, because those name a remote home. + +## Workflow + +1. `guster status` +2. `guster scan --json` (add `--root ` for a single project) +3. `guster doctor` +4. `guster score` +5. `guster plan findings` or a targeted `guster plan move|init` +6. Read the plan with the user. +7. `guster apply --yes` +8. `guster doctor` again — zero new findings means the edit kept the format contract +9. `guster score --trend` + +Workspace writes are gated behind a plan and `--yes`. Reading is not fully +read-only: every scanning command refreshes `~/.agents/guster/registry.json`, +`doctor` also writes `findings.json`, and `score` appends `metrics.jsonl`. +`--no-write` skips that command's own state file for `scan`, `doctor`, `score` +and `check`. + +For a human-driven patrol, `guster check` runs scan → doctor → score with the +trend in one pass; its exit code carries the doctor semantics. + +## Commands + +```bash +guster status +guster scan --root ~/Projects --json +guster doctor +guster score --trend +guster score --fail-under 80 # optional gate: exit 2 when CHI is below the target +guster check # scan + doctor + score --trend in one pass +guster zones list # configured machine zones +guster zones add [--profile light|full] +guster zones remove +guster plan findings +guster plan move --from --to +guster plan init --project +guster apply --yes +guster init +guster init --project --yes +guster hub init --path --yes +guster hub attach --path +guster hub status +guster hub validate +guster link +guster export --format md +guster credentials +guster upgrade +``` + +## Gates + +- **Never persist or print credential values.** Paths, variable names and redacted forms only. +- **Never auto-commit, auto-push or auto-deploy.** +- **Never apply a plan without explicit confirmation.** +- **Never treat tracked files you do not own or have no authority over as + ordinary migration targets** — the test is ownership/authority over the + tracked files (a shared or employer repository usually fails it), not the + word "company". +- **Fail loud** on an unknown workspace, malformed plan or missing backup. +- Prefer no-focus, CLI-only operation. Do not activate apps or switch Spaces. +- If the scan finds a credential in git, stop structural work and report it as critical. + +## Waivers + +A finding you knowingly accept is waived in `/hub.yaml` under `doctor.waivers`, +never by deleting the check: + +```yaml +doctor: + waivers: + - rule: broken-pointer + path: ~/work/company-repo + reason: company-tracked doc, owned upstream +``` + +`path` is optional; without it the whole rule is waived. Every waiver needs a +`reason` — a malformed block fails loud. Waived findings still appear in +`doctor --json` and in the report's `Waived` section, so the decision stays +visible. Use a waiver only when the fix is outside your authority (tracked +files owned upstream, host limitations), not to skip ordinary work. + +A waiver greens the gate, not the score: waived findings no longer set the +`doctor` exit code, but metrics are computed from the registry before waivers +apply, so CHI does not improve. A waived problem is an acknowledged problem, +not a healthy one. + +## Format spec + +Context assets follow the versioned format contract in `reference/spec.md` +(CTX-01..10): `AGENTS.md` instruction files, llms.txt-shaped indexes, +machine-verifiable pointers, machine-readable dates, the six `.agents/` slots, +one home per fact, skill metadata budgets, credentials by reference, and the +machine-readable project registry table. When writing or moving a context +asset, follow the spec; when a doctor finding fires, it names the rule that +was broken. CTX-09 note headers also accept optional `name` and `description` +keys (the one-fact-per-file shape inspired by the Claude Code memory tool) and +`superseded_by` (metadata only; `superseded_by` never joins the pointer scan), +and the plugin's `schemas/` directory carries JSON Schema +(draft 2020-12) contracts for `hub.yaml` and the plan JSON. + +## New project onboarding + +When the user starts a new project (新项目开张/立项/开新仓), the goal is that it +lands in the right place, gets the standard `.agents/` layout and shows up in +the hub registry — with the user confirming every structural step. This is +orchestration of existing commands, not new machinery. + +1. **Inventory the layout** — `guster status --json` (or read + `~/.agents/guster/config.json`): configured `roots`, `zones`, attached hub. + With no config yet the report banner names the auto-scanned roots; suggest + `guster init` to pin them before adding a project. +2. **Propose a placement** — under a configured root or zone the user already + governs, never a new top-level directory of your own invention. Naming and + sub-structure follow the user's own conventions (their instruction files, + their existing registry rows), not ours. +3. **User confirms the path** before anything is created. +4. **Create** — `mkdir` the directory; `git init` and all other git operations + follow the user's own git conventions (Guster never runs git). Then + scaffold the standard layout with `guster init --project ` — the + default dry run lists the tree it will create, which also catches typos in + the path — and apply with `--yes` once the user has read it. +5. **Register** — draft a CTX-10 row for the hub's `projects/_registry.md` + (slug, display name, project path, note) and hand it to the user to paste; + Guster does not edit hub content itself. +6. **Close the loop** — `guster scan` so the project enters the machine table, + then `guster doctor`: zero new findings (placement, registry row, freshness) + is the definition of done. `guster check` adds a score baseline in the same + pass. + +## Reformatting legacy context + +When the target is not a new asset but an inherited mess — a project or hub +whose context predates the spec — run the playbook in +`reference/reformat.md`: **inventory and classify** every artifact (doctor +findings as the worklist, one destination class each) → **placement** +(`plan init` for the slots, one `plan move` or one batch plan for moves — +paths final before pointers are written) → **content** (index lines, naked +paths to links, date lines, duplicates to pointer cards, per the CTX table) → +**verify** (`doctor` zero new findings, `score --trend` before/after). The +pass is meaning-preserving; deletions and distillations are proposed in the +classification table for the user to approve, never silent. + +## References + +- `reference/spec.md` — context format spec v1 (CTX rules and their findings). +- `reference/reformat.md` — legacy context reformat playbook (four passes, classify-before-touch). +- `reference/framework.md` — 1-3-5-8 framework and placement tree. +- `reference/metrics.md` — metric definitions, targets and CHI. +- `reference/placement.md` — user/hub/project directory trees and the git boundary. + +## Exit codes + +| Code | Meaning | +|---|---| +| `0` | success — clean run, or findings no worse than `medium` | +| `1` | tool/config error: malformed or unreadable plan, an apply that failed mid-operation and was rolled back, missing workspace root, invalid `config.json` (non-list `roots`, a bad root/zone/hub path, empty `roots`, no scan candidates — run `guster init`); `hub status` also returns 1 when the attached hub fails its checks | +| `2` | `doctor`/`check` found `high` (but no `critical`) findings; `score --fail-under` below target or CHI not computable; `hub validate` failed the lite contract; `link` found broken pointers; `upgrade` found disagreeing manifest versions | +| `3` | `doctor`/`check` found `critical` findings | +| `4` | `apply`, `init` or `hub init` refused the plan at preflight — nothing was touched (missing move source, existing destination, bad target type) | diff --git a/external_plugins/guster/skills/guster/reference/framework.md b/external_plugins/guster/skills/guster/reference/framework.md new file mode 100644 index 00000000..61667f27 --- /dev/null +++ b/external_plugins/guster/skills/guster/reference/framework.md @@ -0,0 +1,55 @@ +# Guster Framework + +## One principle + +One fact has one home; one home tells one story; show it only when needed. + +## Three laws + +1. **Single home** — one canonical source per topic; other locations are + pointers, generated copies or immutable evidence. +2. **Load on demand** — resident instructions only for rules that apply to + every task in scope, change default behavior, and have costly failure. +3. **Layer isolation** — a container holds content with the same scope, + authority, lifetime, sensitivity and load mode. + +## Five sameness checks + +- scope: global / workgroup / project / subdirectory / task / session +- authority: platform / instruction / code / runtime / knowledge / evidence +- lifetime: invariant / monthly / weekly / daily / hourly / one-shot +- sensitivity: public / internal / confidential / secret +- load: resident / run-start / triggered / retrieved / never + +If one container mixes two values on any axis, split it. + +## Eight planes + +1. Truth: code, tests, build and runtime config. +2. Instruction: AGENTS.md and policies. +3. Capability: skills, tools, MCP, plugins, scripts. +4. Knowledge: durable principles, methods, business semantics, pitfalls. +5. State: project cards, handoffs, environment and port registries. +6. Evidence: reports, screenshots, videos, test output. +7. Runtime: sessions, caches, logs, temp files, browser profiles. +8. Secret: passwords, tokens, keys, cookies; references only. + +## Placement tree + +1. Secret? → 8. +2. Code/config? → 1. +3. Changes default behavior for all tasks? → 2. +4. Repeatable action/procedure? → 3. +5. Current status/next step? → 5. +6. Proof/artifact? → 6. +7. Durable understanding? → 4. +8. Temporary working data? → 7. + +If content hits multiple planes, split it into conclusion + evidence + pointer. + +## Conflict rules + +- Safety: strictest wins. +- Fact: closest to runtime/code wins. +- Preference: most specific scope wins. +- Same level: do not guess; fix the missing canonical source. diff --git a/external_plugins/guster/skills/guster/reference/metrics.md b/external_plugins/guster/skills/guster/reference/metrics.md new file mode 100644 index 00000000..fe7c2649 --- /dev/null +++ b/external_plugins/guster/skills/guster/reference/metrics.md @@ -0,0 +1,52 @@ +# Guster Metrics + +Every number is a static count: files, bytes, characters, dates, path +resolution and git metadata. Nothing measures runtime token usage. + +## Core metrics + +| ID | Metric | Target | Numerator / denominator | +|---|---|---:|---| +| SSR | single-source rate | ≥95% | topics with one source / all topics (filename stem + content hash) | +| RBR | resident budget ratio | ≤100% | bytes of existing host entry files + hub `AGENTS.md` over 20 KB; skill descriptions over 6,000 chars | +| PCR | placement compliance rate | ≥90% | `.agents/` dirs with all six slots, a non-empty index and no unknown top-level entry / dirs that have `.agents/` (workspace containers excluded) | +| ICR | index coverage rate | knowledge 100%, `.agents` ≥90% | mean of indexed knowledge files and `.agents/` dirs with an index | +| FRS | state freshness rate | ≥90% | state docs verified within 90 days / state docs | +| PHR | pointer health rate | 100% | resolvable pointers / resolvable-looking pointers | +| SIR | secret isolation rate | ≥95% | credential files that are unregistered, tracked, unverifiable or inline / credential files + inline tokens. Inline means host config, not arbitrary file content | +| GCR | governance complexity ratio | ≤0.5 | governance documents / 8; reported, never scored | + +## Targets + +- Resident: one ≤20 KB budget for the entry files that exist (deduplicated by + real path, host symlinks do not double count) plus the hub instruction file. + Soft line budgets are 150 per user entry and 50 for the hub. +- Skills: ≤6,000 characters of description in total, ≤500 per skill. +- State: one 90-day SLA for every state document — hub `projects/`, `handoff/`, + `provision/` and `.agents/plans/`. There is no separate 7- or 30-day tier. + The date is `verified_at`, a `最后更新` line in the first 40 lines, a date that + opens the filename, or the owning repository's last commit — that last one is + "touched", not "verified". +- Knowledge: index every durable file; review every 90–180 days. +- Secrets: 0 in git; 1 canonical root; 0 inline tokens. A file kept in place is + accepted when `registry.md` declares it; an unreadable repository counts as + unverified, never as clean. + +## No evidence means n/a + +An empty denominator produces `n/a`, not 1.0: the dimension is dropped and the +remaining weights are renormalized. A scope with no evidence at all reports +`CHI: n/a`. Scores from scopes with different coverage are not comparable. + +## CHI + +The Context Health Index is a dashboard, not a KPI: + +```text +CHI = 0.20 SSR + 0.15 RBR + 0.15 PCR + 0.15 ICR + + 0.15 FRS + 0.10 PHR + 0.10 SIR +``` + +Critical findings do not rescale the score. They set the exit code: `doctor` +returns 3 on any critical and 2 on any high finding. `score --fail-under N` +turns the index into an explicit gate. diff --git a/external_plugins/guster/skills/guster/reference/placement.md b/external_plugins/guster/skills/guster/reference/placement.md new file mode 100644 index 00000000..94c26631 --- /dev/null +++ b/external_plugins/guster/skills/guster/reference/placement.md @@ -0,0 +1,51 @@ +# Guster Placement + +## User level + +```text +~/.agents/ +├── skills/ # shared capabilities +├── wiki/ # local/sensitive knowledge +├── credentials/ # secret root (target) +├── tmp/ # scratch +└── archive/ +``` + +User instructions remain a single canonical file with host symlinks. + +## Guster Hub + +```text +/ +├── projects/ # state +├── handoff/ # state +├── knowledge/ # knowledge +├── provision/ # state +├── tools/ # capability +├── reports/ # evidence +├── Human Output/ # evidence / deliverables +└── .agents/ # local plans and scratch +``` + +## Project level + +```text +/.agents/ +├── README.md # required index +├── plans/ # active plans +├── wiki/ # durable project knowledge +├── evidence/ # screenshots, videos, test output +├── skills/ # project-local skills +├── tmp/ # 14-day TTL +└── archive/ # superseded material +``` + +Topic directories are allowed only under a slot, e.g. +`evidence/brand-report-20261028/`, not at `.agents/` top level. + +## Git boundary + +- Portable, non-sensitive knowledge → hub `knowledge/` and git. +- Local paths, accounts, production IDs, sensitive pitfalls → `~/.agents/wiki/`. +- Plans, evidence, scratch → project `.agents/`, ignored. +- Credentials → secret root only; never git, docs, reports or chat. diff --git a/external_plugins/guster/skills/guster/reference/reformat.md b/external_plugins/guster/skills/guster/reference/reformat.md new file mode 100644 index 00000000..b2a04fad --- /dev/null +++ b/external_plugins/guster/skills/guster/reference/reformat.md @@ -0,0 +1,97 @@ +# Legacy Context Reformat + +The playbook for bringing a scattered, pre-spec context site under the format +contract (`spec.md`). Reach for it when inheriting a project or hub whose +context predates the spec: instruction files written as essays, knowledge with +no index, naked paths in prose, undated state documents, duplicated copies, +task folders sitting at the top level. The agent supplies the judgment; this +page fixes the order of operations so the deterministic tools stay useful +from the first inventory to the final verify. + +## Principles + +- **Meaning-preserving.** Reformat moves and links what is already there; it + never invents facts, fills gaps with guesses or rewrites wording for style. + A claim that cannot be verified keeps its text, flagged for the user. +- **Classify before touching.** Formatting garbage launders it. Every + artifact gets a destination class first; what has no future reader is + proposed for deletion or distillation, not formatted. +- **Placement before content.** A pointer written before its target moves is + a pointer rewritten after. Moves and deletions land first, content edits + second, so paths are final when pointers get written. +- **One scope, one pass.** Leave the scope internally consistent — indexed, + pointed, dated — even if the pass ends at its boundary. + +## Pass 1 — Inventory and classify + +1. `guster doctor --root ` (add `--json`): the findings list is the + worklist and each finding names the CTX rule it broke. `guster scan` adds + the asset inventory behind the findings. +2. Classify every artifact — flagged or not — into exactly one class: + + | Class | Destination | + |---|---| + | instruction | root `AGENTS.md`, narrowed per CTX-01 | + | durable knowledge | hub `knowledge/` (cross-project) or `.agents/wiki/` (project-local) | + | plan / task bundle | `.agents/plans/` | + | evidence | `.agents/evidence/` | + | skill | `.agents/skills/` (project) or `~/.agents/skills/` (machine) | + | scratch | `.agents/tmp/` — or delete | + | retired | `.agents/archive/` — or distill into wiki, then delete | + | code or config | the repository itself, not context | + | no future reader | propose deletion, never format | + +3. Duplicate stems (CTX-06): pick the canonical copy by freshness and + completeness; mark the rest to become pointer cards in pass 3. +4. A credential value found anywhere stops structural work: report critical, + then continue with references only (CTX-08). + +## Pass 2 — Placement + +- No `.agents/` yet: `guster plan init --project ` gives the six slots, + README and a minimal `AGENTS.md`. +- Before any move, search the repo for the artifact's path stem: every + referencer found now is a pointer you update in pass 3; doctor after the + move confirms none were missed (it catches what the search missed). +- The slot a `misplaced-artifact` finding suggests is shape-based — + classification can override it (a finished review report is a wiki + conclusion, not a live plan). +- One artifact: `guster plan move --from --to ` (backup plus a + pointer at the old location on apply). +- A batch: hand-write one plan JSON — `version: 1`, an `operations` list of + `mkdir`/`move`/`write` objects, same shape `plan move` emits — covering the + whole destination slot, then `guster apply ` dry-run, read it with the + user, `--yes`. Apply backs up every touched path and rolls back on failure. +- Nothing inside a moved file is rewritten in this pass. + +## Pass 3 — Content (per scope, table order) + +| Symptom | Transform | Rule | +|---|---|---| +| Scope has files but no index | Write the llms.txt-shaped README: H1, one-line blockquote, one link per file | CTX-02 | +| Knowledge file missing from its index | Add `- [title](path): one-line description` — the description says when to read it | CTX-02 | +| Naked path in prose or index | Markdown link in indexes, `` `code span` `` in prose, when-to-read in the same sentence | CTX-03 | +| State document without a machine-readable date | Add `verified_at: YYYY-MM-DD` / `最后更新: YYYY-MM-DD` — today only if you re-verified, otherwise the git date | CTX-04 | +| Task bundle at `.agents/` top level | Move into its slot (pass 2) | CTX-05 | +| Non-canonical duplicate | Replace with a pointer card: front-matter `type: pointer` plus a date key, truth links in the body; volatile values are deleted, not copied | CTX-06, CTX-09 | +| Instruction file over budget or contradicting a narrower one | Cut or split — nesting narrows, never contradicts | CTX-01 | +| Referencer still pointing at a pre-move path | Update it to the new path (doctor reports each as `broken-pointer`); `~`-prefixed links are resolved against home, so cross-repo pointers to a hub stay verifiable | CTX-03 | +| `.moved.md` left by an applied move | Delete once every referencer is updated — a transition pointer nobody reads re-triggers `misplaced-artifact`; keep it only for referencers outside your control | CTX-05 | + +Content edits are ordinary file edits by the agent; plans are for moves. + +## Pass 4 — Verify + +1. `guster doctor` — the pass kept the contract iff zero new findings appear. +2. `guster link` for a pointer-only check; `guster score --trend` for the + before/after number to hand the user. +3. Committing is the user's workflow; guster never auto-commits. + +## Scale and review + +Batch by directory or topic. For a large legacy site, deliver the pass-1 +classification table (artifact → class → keep/merge/delete) to the user +before pass 2 — one approval for the map, not one per file. Deletion and +distillation proposals live in that table, never execute silently. A +company-tracked file is never a migration target: report it, waive it with a +reason if the user accepts, move on. diff --git a/external_plugins/guster/skills/guster/reference/spec.md b/external_plugins/guster/skills/guster/reference/spec.md new file mode 100644 index 00000000..8edd6af9 --- /dev/null +++ b/external_plugins/guster/skills/guster/reference/spec.md @@ -0,0 +1,112 @@ +# Context Format Spec + +spec_version: 1. The format contract for context assets — the shapes that let +both an agent and `guster doctor` verify a document without reading minds. +Each rule carries a stable ID (markdownlint style) and names the finding that +mechanically enforces it. What no finding enforces is guidance for the agent +that writes the document. + +## Open conventions this spec follows + +- **AGENTS.md** (agents.md) — the open format for the tool-agnostic + instruction file. Discovery is nested: hosts collect `AGENTS.md` files + walking outward from the working directory and the nearest one wins. On + that precedence CTX-01 stacks a stricter discipline: a nested file narrows + the parent, never contradicts it. Guster reads `AGENTS.md` (and legacy + `CLAUDE.md`) wherever a host reads them and does not invent a competing + instruction format; a host that only knows `CLAUDE.md` is served with + `ln -s AGENTS.md CLAUDE.md`. +- **llms.txt** (llmstxt.org) — index files as curated link lists. A knowledge + index is an H1, a one-line blockquote summary, then one markdown link per + file with a one-line description. Same shape, local files instead of URLs. +- **YAML front-matter** — the `---`-delimited metadata block; the de-facto + standard Jekyll, Hugo and Gray Matter share. CTX-09 rides it rather than + inventing a note format. +- **Stable rule IDs** (markdownlint) — rules are numbered, cited by findings + and waivers, and only change meaning on a spec_version bump. + +## Rules + +| ID | Rule | Enforced by | +|---|---|---| +| CTX-01 | `AGENTS.md` is the instruction file; nested ones narrow, never contradict. Budgets: hub ≤50 lines, user entry ≤150 lines, resident total ≤20 KB. | `resident-budget` | +| CTX-02 | Every knowledge scope has a README index in llms.txt shape; every knowledge file appears there verbatim, as `- [title](path): one-line description`. An index that names nothing is empty. | `orphan-knowledge` | +| CTX-03 | Any file path in an instruction or index document is machine-verifiable: a markdown link or inline code, never naked in prose. A pointer also states when to read the target. | `broken-pointer`, `naked-pointer` | +| CTX-04 | State documents carry a machine-readable date. The canonical key is `verified_at: YYYY-MM-DD`; the Chinese prose keys (`最后更新`/`更新时间`/`更新于`/`最近核实`/`最后核实`/`已核实`) and the English prose keys (`Last updated:`/`updated:`) are accepted equivalents within the first 40 lines, as is a date that opens the filename. Without a declared date the ladder falls back to the repository's last git commit, then to file mtime; no signal at all means stale. | `stale-state` | +| CTX-05 | `.agents/` has exactly the six slots — `plans/`, `wiki/`, `evidence/`, `skills/`, `tmp/`, `archive/` — plus `README.md`/`AGENTS.md`. Task bundles live in a slot, never at the top level. | `misplaced-artifact` | +| CTX-06 | One home per fact. Same topic, same filename stem; the second home becomes a pointer to the first. Copies are either byte-identical or a mistake. | `duplicate-canonical`, `skill-copy-drift` | +| CTX-07 | Skill frontmatter carries `name` and `description` only; one trigger sentence, ≤500 chars each, ≤6,000 chars across the library. | `skill-budget` | +| CTX-08 | Credentials appear by reference — a path in the registry under the canonical root — never as a value in a document, a config or git. | `secret-in-git`, `secret-outside-root`, `secret-inline`, `secret-undeclared`, `secret-missing` | +| CTX-09 | A knowledge note may carry YAML front-matter following the Obsidian properties convention (the interchange format Foam/Quartz/Logseq also accept). The header is opt-in: it is machine-checked only when it declares `type:`. A checked header must parse and carry a machine-readable date (`updated`/`date`/`lastmod`/`created` as YYYY-MM-DD), and the note's body then joins the CTX-03 pointer scan — truth sources go in the body as links, never as invented header keys. Optional keys: `name` and `description` state what the note is (the one-fact-per-file shape inspired by the Claude Code memory tool), and `superseded_by` names the path or stem of the note that replaced this one; that key is metadata about the note, not a truth source, so it never joins the pointer scan and never raises a finding. | `note-header-malformed`, `broken-pointer`, `naked-pointer` | +| CTX-10 | The hub's project registry (`projects/_registry.md`) is a machine-readable table. The header row names the columns; whichever column header contains `path` or `路径` is the path column, and each row's cell there holds one project location — `~/...`, absolute, or relative to the hub root. The slug column (first column) never counts as a path. Remote forms (`host:/path`, URLs) and placeholder cells (`-`, `—`) are skipped, not resolved. | `registry-drift` | + +### CTX-10 in detail + +The registry table is read through its path column, so a row is only as good +as its path cell. Conventions that keep the three-way diff (machine table +`registry.json` ↔ this human table ↔ git roots on disk) meaningful: + +- Header row first: the parser finds the path column by header name + (`path` / `路径`, case-insensitive) and never guesses by position. +- One project per row; the path cell names the project **directory**, not a + file inside it. Trailing `/` and wrapping backticks are tolerated. +- `~/`-relative paths resolve against the user's home; bare relative paths + resolve against the **hub root**; absolute paths resolve as-is. +- A row whose path does not exist on disk is a dead row (`registry-drift`, + medium); a row that exists but is never scanned points outside the + configured roots (medium); a scanned project with no row is unregistered + (low). Remote references are counted apart instead of drifting forever. + +### Credential registry table + +CTX-08's registry (`~/.agents/credentials/registry.md`) is a markdown table +with a fixed column order; only paths and variable **names** live here, +never values: + +| # | Column | Required | +|---|---|---| +| 1 | ID | yes | +| 2 | scope (`company`/`personal`) | yes | +| 3 | site | yes | +| 4 | account | yes | +| 5 | kind | yes | +| 6 | locations | yes | +| 7 | keys (variable names) | no | +| 8 | used_by | no | +| 9 | status | no | + +A pipe row with fewer than the six required columns is a parse warning, not +silence; `guster credentials` prints it. + +## Why a format contract + +The metrics are static: filename stems, content hashes, path resolution, git +dates. A document that ignores the contract is not scored lower — it is +invisible. A naked path in prose never reaches the pointer check; a date +written as "last week" falls back to git; an index without filenames counts as +missing. The contract is what makes measurement possible, and the score is +what keeps the contract from drifting. Both directions are load-bearing. + +## Writing guide (no finding enforces this) + +When creating or moving a context asset: + +1. Pick the home by CTX-06, the slot by CTX-05, the index entry by CTX-02; a + new project gets its registry row by CTX-10. +2. Write pointers as `[label](relative/path.md)` in indexes and `` `path` `` + in prose; add when-to-read in the same sentence. +3. Add the date line before saving a state document; run `guster doctor` + after edits — a new finding names the rule you just broke. +4. A note that summarizes knowledge whose truth lives elsewhere (a pointer + card) opts into CTX-09: standard front-matter (`type: pointer`, a date + key, `tags` if useful) plus a truth section of ordinary markdown links. + `name` and `description` are optional metadata; so is `superseded_by`, + which marks the note a better one replaced — the chain is for readers; + the scanner never resolves it. Volatile values (latest numbers, current + picks) stay out of the card and are read from the truth sources instead. + +## Versioning + +Additive changes keep spec_version; a rule that changes meaning bumps it and +gets a CHANGELOG entry. Findings cite rule IDs, waivers accept them, so a +spec change never silently re-targets an existing waiver. diff --git a/external_plugins/guster/src/guster/__init__.py b/external_plugins/guster/src/guster/__init__.py new file mode 100644 index 00000000..30c9c1fa --- /dev/null +++ b/external_plugins/guster/src/guster/__init__.py @@ -0,0 +1,3 @@ +"""Guster: agent context steward.""" + +__version__ = "0.9.1" diff --git a/external_plugins/guster/src/guster/__main__.py b/external_plugins/guster/src/guster/__main__.py new file mode 100644 index 00000000..a049ad7a --- /dev/null +++ b/external_plugins/guster/src/guster/__main__.py @@ -0,0 +1,5 @@ +from .cli import main + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/external_plugins/guster/src/guster/cli.py b/external_plugins/guster/src/guster/cli.py new file mode 100644 index 00000000..9b3fbd11 --- /dev/null +++ b/external_plugins/guster/src/guster/cli.py @@ -0,0 +1,1004 @@ +from __future__ import annotations + +import argparse +import hashlib +import json +import sys +from pathlib import Path +from typing import Any, Dict, List, Optional, Sequence + +from . import __version__ +from .discover import ScanConfig, count_zone_tools, default_roots, scan +from .executor import ApplyError, apply_plan, init_home +from .hub import attach_hub, default_hub_path, init_hub, validate_hub +from .metrics import compute_metrics, metric_line +from .planner import ( + load_plan, + plan_from_findings, + plan_init_project, + plan_move, + save_plan, +) +from .policy import run_policy +from .report import redacted_registry, render_report, render_status +from .util import ( + json_dumps, + load_json_strict, + now_iso, + save_json, + state_lock, + write_text, +) + + +def default_state_dir(home: Path) -> Path: + return home / ".agents" / "guster" + + +def state_dir_from(args: argparse.Namespace) -> Path: + """Explicit --state-dir or the machine default; used by commands that do + not need a full scan config (init/apply/plan/hub/zones).""" + if args.state_dir: + return Path(args.state_dir).expanduser() + return default_state_dir(Path.home()) + + +def load_config(config_path: Path) -> Dict[str, Any]: + if not config_path.is_file(): + return {} + try: + local = json.loads(config_path.read_text(encoding="utf-8")) + except (OSError, ValueError) as exc: + raise ValueError(f"cannot read Guster config {config_path}: {exc}") from exc + if not isinstance(local, dict): + raise ValueError(f"Guster config must be a JSON object: {config_path}") + return local + + +def resolve_root(root: Path) -> Path: + if not root.exists(): + raise ValueError(f"workspace root does not exist: {root.resolve()}") + if not root.is_dir(): + raise ValueError(f"workspace root is not a directory: {root.resolve()}") + return root + + +def parse_roots(raw: Any, config_path: Path) -> List[Path]: + """Config roots must be existing absolute directories; one bad entry stops + the run instead of being silently reinterpreted (a bare string is a type + error, never a list of characters).""" + if not isinstance(raw, list): + raise ValueError( + f"Guster config 'roots' must be a list of absolute paths, " + f"got {type(raw).__name__}: {config_path}" + ) + if not raw: + raise ValueError(f"Guster config 'roots' must list at least one path: {config_path}") + roots: List[Path] = [] + for item in raw: + if not isinstance(item, str) or not item.strip(): + raise ValueError( + f"Guster config 'roots' entries must be non-empty strings: {item!r} in {config_path}" + ) + path = Path(item).expanduser() + if not path.is_absolute(): + raise ValueError( + f"Guster config 'roots' entries must be absolute paths: {item!r} in {config_path}" + ) + roots.append(resolve_root(path)) + return roots + + +def parse_zones(raw: Any, config_path: Path) -> List[Dict[str, str]]: + if not isinstance(raw, list): + raise ValueError(f"Guster config 'zones' must be a list: {config_path}") + zones: List[Dict[str, str]] = [] + for item in raw: + if not isinstance(item, dict) or not str(item.get("path", "")).strip(): + raise ValueError(f"zone entry needs a 'path' in {config_path}: {item!r}") + zone_path = Path(str(item["path"])).expanduser() + if not zone_path.is_absolute(): + raise ValueError( + f"Guster config 'zones' entries must be absolute paths: {item!r} in {config_path}" + ) + profile = str(item.get("profile", "light")) + if not zone_path.is_dir(): + raise ValueError(f"configured zone does not exist: {zone_path.resolve()}") + if profile not in {"light", "full"}: + raise ValueError(f"zone profile must be 'light' or 'full': {profile}") + zones.append({"path": str(zone_path), "profile": profile}) + return zones + + +def add_common(parser: argparse.ArgumentParser) -> None: + parser.add_argument("--root", action="append", default=None, help="Workspace root; repeatable.") + parser.add_argument( + "--scope", + choices=["auto", "machine", "hub", "project", "group"], + default="auto", + help="Context scope: machine (default), hub, one project, or a group of projects.", + ) + parser.add_argument("--hub", default=None, help="Guster Hub path.") + parser.add_argument("--state-dir", default=None, help="Guster state directory.") + parser.add_argument("--json", action="store_true", help="Emit JSON.") + parser.add_argument("--quiet", action="store_true", help="Only print errors.") + + +def cli_roots(raw: Optional[Sequence[str]]) -> List[Path]: + """--root values follow the config roots discipline: existing absolute dirs, + so the persisted registry never carries a path that drifts with CWD.""" + roots: List[Path] = [] + for item in raw or []: + path = Path(item).expanduser() + if not path.is_absolute(): + raise ValueError(f"--root paths must be absolute: {item!r}") + roots.append(resolve_root(path)) + return roots + + +def parse_max_depth(raw: Any, config_path: Path) -> int: + if isinstance(raw, bool) or not isinstance(raw, int) or raw <= 0: + raise ValueError( + f"Guster config 'scan_max_depth' must be a positive integer, " + f"got {raw!r} ({type(raw).__name__}) in {config_path}" + ) + return raw + + +def build_config(args: argparse.Namespace) -> ScanConfig: + home = Path.home() + base_state = Path(args.state_dir).expanduser() if args.state_dir else default_state_dir(home) + config_path = base_state / "config.json" + unconfigured = not config_path.is_file() + local = load_config(config_path) + + hub: Optional[Path] = None + if args.hub: + hub = Path(args.hub).expanduser() + elif "hub" in local: + raw_hub = local["hub"] + if not isinstance(raw_hub, str) or not raw_hub.strip(): + raise ValueError(f"Guster config 'hub' must be a path string: {config_path}") + hub = Path(raw_hub).expanduser() + if hub is not None: + if not hub.exists(): + raise ValueError(f"hub directory does not exist: {hub.resolve()}") + if not hub.is_dir(): + raise ValueError(f"hub is not a directory: {hub.resolve()}") + + explicit_roots = cli_roots(args.root) + scope = getattr(args, "scope", "auto") or "auto" + if scope == "auto": + scope = "machine" if not explicit_roots else ("project" if len(explicit_roots) == 1 else "group") + if scope in {"project", "group"} and not explicit_roots: + raise ValueError("--scope project|group needs at least one --root") + if scope == "hub" and hub is None: + raise ValueError("--scope hub needs --hub or an attached hub") + auto_roots = False + if scope == "hub": + roots: List[Path] = [] + elif explicit_roots: + roots = explicit_roots + elif "roots" in local: + roots = parse_roots(local.get("roots"), config_path) + else: + roots = default_roots(home) + if not roots: + raise ValueError( + "no workspace roots configured and none of " + "~/Projects, ~/code, ~/dev, ~/src exists — " + "run `guster init --root ` to configure Guster" + ) + auto_roots = True + + state_dir = base_state + if not args.state_dir and (scope != "machine" or explicit_roots): + # Scoped runs keep their own registry and trend so they never overwrite + # the machine-wide view. + key = "|".join([scope] + sorted(str(root.resolve()) for root in roots) + [str(hub or "")]) + state_dir = base_state / "scoped" / hashlib.sha1(key.encode()).hexdigest()[:10] + + plugin_root = Path(__file__).resolve().parents[2] + zones = parse_zones(local.get("zones", []), config_path) + + return ScanConfig( + home=home, + hub=hub, + roots=roots, + state_dir=state_dir, + plugin_root=plugin_root, + max_depth=parse_max_depth(local.get("scan_max_depth", 5), config_path), + scope=scope, + zones=zones, + unconfigured=unconfigured, + auto_roots=auto_roots, + ) + + +def ensure_state(config: ScanConfig) -> None: + config.state_dir.mkdir(parents=True, exist_ok=True) + (config.state_dir / "plans").mkdir(parents=True, exist_ok=True) + (config.state_dir / "backups").mkdir(parents=True, exist_ok=True) + + +def do_scan(config: ScanConfig, write: bool = True) -> Dict[str, Any]: + ensure_state(config) + with state_lock(config.state_dir): + registry = scan(config) + if write: + save_json(config.state_dir / "registry.json", registry) + return registry + + +def load_registry(config: ScanConfig) -> Optional[Dict[str, Any]]: + """Cached registry; corrupt content warns and reads as absent so `status` + rescans instead of silently self-healing.""" + path = config.state_dir / "registry.json" + data, error = load_json_strict(path) + if error is not None: + print(f"[guster] warning: {path} is corrupt ({error}); rescanning", file=sys.stderr) + return None + if data is None: + return None + if not isinstance(data, dict): + print(f"[guster] warning: {path} is not a JSON object; rescanning", file=sys.stderr) + return None + return data + + +def evaluate(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: + policy_result = run_policy(registry, config) + metric_result = compute_metrics(registry, policy_result) + return {"policy": policy_result, "metrics": metric_result} + + +def append_metric(config: ScanConfig, metric_result: Dict[str, Any]) -> None: + ensure_state(config) + with state_lock(config.state_dir): + path = config.state_dir / "metrics.jsonl" + line = { + "at": metric_result.get("generated_at", now_iso()), + "scope": metric_result.get("scope"), + "chi": metric_result.get("chi"), + "dims": metric_result.get("dims"), + "unscored_dims": metric_result.get("unscored_dims"), + "metrics": metric_result.get("metrics", {}), + "scores": metric_result.get("scores", {}), + } + with path.open("a", encoding="utf-8") as handle: + handle.write(json.dumps(line, ensure_ascii=False) + "\n") + + +def last_metric(config: ScanConfig) -> Optional[Dict[str, Any]]: + """Newest persisted snapshot; `status` reports this instead of mixing a stale scan with fresh policy.""" + path = config.state_dir / "metrics.jsonl" + if not path.is_file(): + return None + lines = [line for line in path.read_text(encoding="utf-8").splitlines() if line.strip()] + if not lines: + return None + try: + item = json.loads(lines[-1]) + except ValueError as exc: + print(f"[guster] warning: {path} last line is corrupt ({exc}); no cached metric shown", file=sys.stderr) + return None + if not isinstance(item, dict): + print(f"[guster] warning: {path} last line is not a JSON object; no cached metric shown", file=sys.stderr) + return None + item.setdefault("generated_at", item.get("at")) + return item + + +def write_findings(config: ScanConfig, policy_result: Dict[str, Any]) -> None: + ensure_state(config) + with state_lock(config.state_dir): + save_json(config.state_dir / "findings.json", policy_result) + + +def print_scan_summary(registry: Dict[str, Any], config: ScanConfig) -> None: + summary = registry.get("summary", {}) + print("Guster scan") + print(f" workspaces: {', '.join(registry.get('workspaces', []))}") + print(f" hub: {registry.get('hub') or '(none)'}") + if config.scope == "hub": + print( + f" projects: {summary.get('project_cards', 0)} " + f"(scanned roots: {summary.get('projects', 0)})" + ) + else: + print(f" projects: {summary.get('projects', 0)}") + print(f" .agents: {summary.get('agents_dirs', 0)} (indexed {summary.get('agents_with_index', 0)})") + print(f" skills: {summary.get('skills', 0)} unique / {summary.get('skill_copies', 0)} copies") + print(f" knowledge: {summary.get('knowledge', 0)}") + print(f" state: {summary.get('state', 0)}") + print(f" evidence: {summary.get('evidence', 0)}") + print(f" credentials:{summary.get('secret_files', 0)} files; {summary.get('inline_bearers', 0)} inline") + print(f" registry: {config.state_dir / 'registry.json'}") + + +def cmd_status(args: argparse.Namespace) -> int: + config = build_config(args) + registry = load_registry(config) + cached = registry is not None + if registry is None: + registry = do_scan(config, write=True) + policy_result: Optional[Dict[str, Any]] = None + if cached: + # The cached registry describes an earlier scan. Running policy against + # it would mix old artifacts with fresh file contents, so report the + # stored snapshot and let `doctor` own the fresh evaluation. + metric_result = last_metric(config) + else: + result = evaluate(registry, config) + policy_result = result["policy"] + metric_result = result["metrics"] + if args.json: + print(json_dumps({ + "registry": { + "plugin": registry.get("plugin"), + "generated_at": registry.get("generated_at"), + "hub": registry.get("hub"), + "workspaces": registry.get("workspaces"), + "summary": registry.get("summary"), + }, + "metrics": metric_result, + "cached": cached, + "findings": None if policy_result is None else len(policy_result["findings"]), + "scope": registry.get("scope"), + "state_dir": str(config.state_dir), + })) + else: + print(render_status(registry, metric_result)) + if policy_result is None: + print("cached registry; run `guster doctor` for a fresh evaluation") + elif metric_result is not None: + print(metric_line(metric_result)) + print(f"findings: {len(policy_result['findings'])}") + return 0 + + +def cmd_scan(args: argparse.Namespace) -> int: + config = build_config(args) + registry = do_scan(config, write=not args.no_write) + if args.json: + print(json_dumps(registry)) + elif not args.quiet: + print_scan_summary(registry, config) + return 0 + + +def cmd_doctor(args: argparse.Namespace) -> int: + config = build_config(args) + registry = do_scan(config, write=not args.no_write) + result = evaluate(registry, config) + policy_result = result["policy"] + if not args.no_write: + write_findings(config, policy_result) + findings = policy_result["findings"] + if args.json: + print(json_dumps(policy_result)) + elif not args.quiet: + print(render_report(registry, policy_result, result["metrics"])) + severities = {item["severity"] for item in findings} + if "critical" in severities: + return 3 + if "high" in severities: + return 2 + return 0 + + +def cmd_score(args: argparse.Namespace) -> int: + config = build_config(args) + registry = do_scan(config, write=not args.no_write) + result = evaluate(registry, config) + metric_result = result["metrics"] + if not args.no_write: + append_metric(config, metric_result) + if args.json: + print(json_dumps(metric_result)) + elif not args.quiet: + chi = metric_result.get("chi") + print(f"Guster Context Health: {'n/a' if chi is None else chi} / 100") + print("") + dims = set(metric_result.get("dims") or []) + for key, value in metric_result["scores"].items(): + if dims and key not in dims: + continue + print(f" {key.upper():4s} {'n/a' if value is None else f'{value:6.1f}'}") + print("") + print(metric_line(metric_result)) + print(f"registry: {config.state_dir / 'registry.json'}") + print(f"metrics: {config.state_dir / 'metrics.jsonl'}") + if args.trend: + path = config.state_dir / "metrics.jsonl" + if path.is_file(): + lines = path.read_text(encoding="utf-8").splitlines()[-10:] + print("") + print("Recent trend:") + for line in lines: + try: + item = json.loads(line) + print(f" {item.get('at')} CHI {item.get('chi')}") + except ValueError: + continue + if args.fail_under is not None: + chi = metric_result.get("chi") + if chi is None: + print("error: CHI is not computable; no dimension has evidence", file=sys.stderr) + return 2 + if chi < args.fail_under: + print(f"error: CHI {chi} is below --fail-under {args.fail_under}", file=sys.stderr) + return 2 + return 0 + + +def cmd_check(args: argparse.Namespace) -> int: + """scan -> doctor -> score --trend in one pass; the exit code carries the + doctor semantics (3 critical, 2 high, 0 clean).""" + config = build_config(args) + registry = do_scan(config, write=not args.no_write) + result = evaluate(registry, config) + policy_result = result["policy"] + if not args.no_write: + write_findings(config, policy_result) + append_metric(config, result["metrics"]) + if args.json: + print(json_dumps({"policy": policy_result, "metrics": result["metrics"]})) + elif not args.quiet: + print(render_report(registry, policy_result, result["metrics"])) + path = config.state_dir / "metrics.jsonl" + if path.is_file(): + lines = [line for line in path.read_text(encoding="utf-8").splitlines() if line.strip()][-10:] + if lines: + print("") + print("Recent trend:") + for line in lines: + try: + item = json.loads(line) + print(f" {item.get('at')} CHI {item.get('chi')}") + except ValueError: + continue + severities = {item["severity"] for item in policy_result["findings"]} + if "critical" in severities: + return 3 + if "high" in severities: + return 2 + return 0 + + +def cmd_plan(args: argparse.Namespace) -> int: + if args.plan_action == "findings": + config = build_config(args) + ensure_state(config) + registry = do_scan(config, write=True) + result = evaluate(registry, config) + plan = plan_from_findings(result["policy"]["findings"]) + state_dir = config.state_dir + elif args.plan_action == "move": + src = Path(args.source).expanduser() + dst = Path(args.destination).expanduser() + plan = plan_move(src, dst) + state_dir = state_dir_from(args) + elif args.plan_action == "init": + plan = plan_init_project(Path(args.project).expanduser()) + state_dir = state_dir_from(args) + else: + raise SystemExit(f"unknown plan action: {args.plan_action}") + + path = save_plan(state_dir, plan) + if args.json: + print(json_dumps(plan)) + elif not args.quiet: + print(f"plan: {path}") + print(f"operations: {len(plan.get('operations', []))}") + for index, operation in enumerate(plan.get("operations", []), start=1): + kind = operation.get("kind") + if kind == "move": + print(f" {index}. move {operation['src']} -> {operation['dst']}") + elif kind == "mkdir": + print(f" {index}. mkdir {operation['path']}") + elif kind == "write": + print(f" {index}. write {operation['path']}") + elif kind == "manual": + print(f" {index}. manual {operation['path']}: {operation['action']}") + print("review the plan; apply with `guster apply --yes`.") + return 0 + + +def cmd_apply(args: argparse.Namespace) -> int: + if args.dry_run and args.yes: + raise ValueError("--dry-run and --yes are mutually exclusive") + plan = load_plan(Path(args.plan).expanduser()) + result = apply_plan( + plan, + state_dir_from(args), + dry_run=not args.yes, + yes=args.yes, + ) + if args.json: + print(json_dumps(result)) + elif not args.quiet: + if result.get("dry_run"): + mode = "DRY RUN" + elif result.get("ok"): + mode = "APPLIED" + else: + mode = "FAILED" + print(f"{mode}: {result.get('plan')}") + print(f" applied: {result.get('applied', 0)}") + print(f" skipped: {result.get('skipped', 0)}") + if result.get("backup"): + print(f" backup: {result['backup']}") + if result.get("errors"): + for error in result["errors"]: + print(f" error: {error}") + return 0 if result.get("ok") else 4 + + +def cmd_init(args: argparse.Namespace) -> int: + state_dir = state_dir_from(args) + if args.project: + project = Path(args.project).expanduser() + plan = plan_init_project(project) + path = save_plan(state_dir, plan) + result = apply_plan(plan, state_dir, dry_run=not args.yes, yes=args.yes) + if not args.json and not args.quiet: + print(f"plan: {path}") + if result.get("dry_run"): + missing: List[Path] = [] + probe = project.resolve() + while not probe.exists() and probe != probe.parent: + missing.append(probe) + probe = probe.parent + if missing: + print(" these directories do not exist yet and will be created:") + for entry in sorted(missing, key=lambda item: len(item.parts)): + print(f" {entry}") + for index, operation in enumerate(plan.get("operations", []), start=1): + kind = operation.get("kind") + if kind == "mkdir": + print(f" {index}. mkdir {operation['path']}") + elif kind == "write": + print(f" {index}. write {operation['path']}") + else: + explicit_roots = cli_roots(args.root) + result = init_home( + state_dir, + yes=args.yes, + dry_run=not args.yes, + home=Path.home(), + roots=explicit_roots or None, + ) + if args.json: + print(json_dumps(result)) + elif not args.quiet: + if result.get("dry_run"): + mode = "DRY RUN" + elif result.get("ok"): + mode = "APPLIED" + else: + mode = "FAILED" + print(f"{mode}: init") + print(f" applied: {result.get('applied', 0)}") + print(f" skipped: {result.get('skipped', 0)}") + if result.get("errors"): + for error in result["errors"]: + print(f" error: {error}") + return 0 if result.get("ok") else 4 + + +def cmd_hub(args: argparse.Namespace) -> int: + state_dir = state_dir_from(args) + action = args.hub_action + local = load_config(state_dir / "config.json") + attached: Optional[Path] = None + if "hub" in local: + raw_hub = local["hub"] + if not isinstance(raw_hub, str) or not raw_hub.strip(): + raise ValueError( + f"Guster config 'hub' must be a path string: {state_dir / 'config.json'}" + ) + attached = Path(raw_hub).expanduser() + if attached is None and not getattr(args, "path", None) and not getattr(args, "hub", None): + if action == "status": + if args.json: + print(json_dumps({"attached": False, "hub": None})) + elif not args.quiet: + print("no hub attached") + return 0 + if action == "validate": + raise ValueError("no hub attached; pass --path to validate one") + target = Path( + getattr(args, "path", None) + or getattr(args, "hub", None) + or attached + or default_hub_path(Path.home()) + ).expanduser() + + if action == "init": + result = init_hub( + target, + state_dir, + yes=args.yes, + dry_run=not args.yes, + name=args.name, + knowledge=args.knowledge, + projects=args.projects, + tools=args.tools, + ) + if args.json: + print(json_dumps(result)) + elif not args.quiet: + if result.get("dry_run"): + mode = "DRY RUN" + elif result.get("ok"): + mode = "APPLIED" + else: + mode = "FAILED" + print(f"{mode}: hub {result['hub']}") + print(f" plan: {result.get('plan')}") + print(f" applied: {result.get('applied', 0)}") + print(f" skipped: {result.get('skipped', 0)}") + if result.get("attach"): + print(f" config: {result['attach']['config']}") + paths = result.get("paths") or {} + if paths: + print( + " paths: " + f"knowledge={paths['knowledge']} " + f"projects={paths['projects']} " + f"tools={paths['tools']}" + ) + if result.get("errors"): + for error in result["errors"]: + print(f" error: {error}") + return 0 if result.get("ok") else 4 + + if action == "attach": + result = attach_hub(state_dir, target) + if args.json: + print(json_dumps(result)) + elif not args.quiet: + print(f"attached: {result['hub']}") + print(f" config: {result['config']}") + if result.get("backup"): + print(f" backup: {result['backup']}") + print(" run `guster scan` to refresh the registry with the hub") + return 0 + + info = validate_hub(target, strict=action == "validate") + if args.json: + print(json_dumps(info)) + elif not args.quiet: + manifest = info.get("manifest") or {} + print(f"Hub: {info['hub']}") + if info.get("profile") == "legacy": + print("Manifest: legacy (no hub.yaml)") + else: + print( + "Manifest: " + f"{info.get('profile') or '(absent)'} " + f"schema={manifest.get('schema_version') or '(absent)'} " + f"hub={manifest.get('hub_version') or '(absent)'} " + f"min_guster={manifest.get('min_guster') or '(absent)'}" + ) + print(f"Plugin: {info['plugin']}") + paths = info.get("paths") or {} + if paths: + print( + "Paths: " + f"knowledge={paths.get('knowledge', '(absent)')} " + f"projects={paths.get('projects', '(absent)')} " + f"tools={paths.get('tools', '(absent)')}" + ) + if info["errors"]: + for error in info["errors"]: + print(f" error: {error}") + for warning in info["warnings"]: + print(f" warning: {warning}") + if info["ok"]: + print("Checks: OK") + if action == "validate": + return 0 if info["ok"] else 2 + return 0 if info["ok"] else 1 + + +def cmd_zones(args: argparse.Namespace) -> int: + state_dir = state_dir_from(args) + config_path = state_dir / "config.json" + config = load_config(config_path) + action = args.zones_action + + if action == "list": + zones = parse_zones(config.get("zones", []), config_path) + if args.json: + print(json_dumps({"zones": zones})) + elif not args.quiet: + if not zones: + print("no zones configured; add one with `guster zones add `") + for item in zones: + zone_path = Path(item["path"]).expanduser() + print(f"{item['path']} profile={item['profile']} tools={count_zone_tools(zone_path)}") + return 0 + + zone_path = Path(args.path).expanduser() + raw_zones = config.get("zones", []) + if not isinstance(raw_zones, list): + raise ValueError(f"Guster config 'zones' must be a list: {config_path}") + + if action == "add": + if not zone_path.is_dir(): + raise ValueError(f"zone directory does not exist: {zone_path.resolve()}") + for item in raw_zones: + if isinstance(item, dict) and str(item.get("path", "")).strip(): + if Path(str(item["path"])).expanduser().resolve() == zone_path.resolve(): + raise ValueError(f"zone already configured: {zone_path.resolve()}") + entry = {"path": str(zone_path), "profile": args.profile} + config.setdefault("version", 1) + config["zones"] = raw_zones + [entry] + zones = parse_zones(config["zones"], config_path) + state_dir.mkdir(parents=True, exist_ok=True) + save_json(config_path, config) + if args.json: + print(json_dumps({"ok": True, "added": entry, "zones": zones, "config": str(config_path)})) + elif not args.quiet: + print(f"added zone: {entry['path']} (profile: {entry['profile']})") + print(f"config: {config_path}") + return 0 + + if action == "remove": + remaining = [ + item + for item in raw_zones + if not ( + isinstance(item, dict) + and str(item.get("path", "")).strip() + and Path(str(item["path"])).expanduser().resolve() == zone_path.resolve() + ) + ] + if len(remaining) == len(raw_zones): + raise ValueError(f"zone is not configured: {zone_path.resolve()}") + if remaining: + config["zones"] = remaining + else: + config.pop("zones", None) + state_dir.mkdir(parents=True, exist_ok=True) + save_json(config_path, config) + if args.json: + print(json_dumps({"ok": True, "removed": str(zone_path), "config": str(config_path)})) + elif not args.quiet: + print(f"removed zone: {zone_path}") + print(f"config: {config_path}") + return 0 + + raise SystemExit(f"unknown zones action: {action}") + + +def cmd_link(args: argparse.Namespace) -> int: + config = build_config(args) + registry = do_scan(config, write=True) + result = evaluate(registry, config) + findings = [item for item in result["policy"]["findings"] if item["rule"] == "broken-pointer"] + if args.json: + print(json_dumps({"findings": findings, "stats": result["policy"]["stats"]})) + elif not args.quiet: + print(f"broken pointer files: {len(findings)}") + for item in findings: + print(f" {item['path']}") + for pointer in item.get("evidence", {}).get("pointers", []): + print(f" - {pointer}") + return 0 if not findings else 2 + + +def cmd_export(args: argparse.Namespace) -> int: + config = build_config(args) + registry = do_scan(config, write=True) + result = evaluate(registry, config) + report = render_report(registry, result["policy"], result["metrics"]) + out = Path(args.out).expanduser() if args.out else config.state_dir / "context-health.md" + write_text(out, report) + if args.format == "json": + json_out = out.with_suffix(".json") + save_json(json_out, { + "registry": redacted_registry(registry), + "policy": result["policy"], + "metrics": result["metrics"], + }) + if not args.quiet: + print(f"report: {out}") + print(f"json: {json_out}") + elif not args.quiet: + print(f"report: {out}") + return 0 + + +def cmd_credentials(args: argparse.Namespace) -> int: + config = build_config(args) + registry = do_scan(config, write=True) + info = (registry.get("secrets") or {}).get("registry") or {} + entries = info.get("entries") or [] + scopes: Dict[str, List[Dict[str, str]]] = {} + for entry in entries: + scopes.setdefault(entry.get("scope", "unknown"), []).append(entry) + if args.json: + print(json_dumps({"path": info.get("path"), "entries": entries})) + return 0 + if not args.quiet: + print(f"registry: {info.get('path') or '(missing)'}") + for warning in info.get("parse_warnings") or []: + print(f" warning: {warning}") + for scope in ("company", "personal", "unknown"): + items = scopes.pop(scope, []) + if not items: + continue + label = {"company": "company 公司", "personal": "personal 个人", "unknown": "unknown 未分类"}[scope] + print(f"\n{label}({len(items)})") + for entry in items: + keys = f" [{entry['keys']}]" if entry.get("keys") not in {"", "-"} else "" + print(f" {entry['id']:24} {entry['site'][:16]:18} {entry['kind']:8} {entry['status']}{keys}") + for scope, items in scopes.items(): + print(f"\n{scope}({len(items)})") + for entry in items: + print(f" {entry['id']:24} {entry['site'][:16]:18} {entry['kind']:8} {entry['status']}") + return 0 + + +def cmd_upgrade(args: argparse.Namespace) -> int: + config = build_config(args) + registry = do_scan(config, write=True) + manifests = registry.get("plugin_manifests", {}) + versions = { + key: value.get("version") + for key, value in manifests.items() + if isinstance(value, dict) and value.get("exists") + } + if args.json: + print(json_dumps({"plugin": __version__, "manifests": versions})) + elif not args.quiet: + print(f"Guster CLI: {__version__}") + for key, version in versions.items(): + print(f" {key}: {version or '(missing)'}") + if len(set(versions.values())) > 1: + print(" WARNING: manifest versions differ") + return 0 if len(set(versions.values())) <= 1 else 2 + + +def build_parser() -> argparse.ArgumentParser: + parser = argparse.ArgumentParser( + prog="guster", + description="Discover, audit, plan and evolve agent context.", + epilog=( + "Scans refresh Guster's state files; workspace writes need a plan with --yes. " + "Exit codes: 1 tool/config error, 2 high findings, 3 critical findings, 4 plan refused at preflight." + ), + ) + parser.add_argument("--version", action="version", version=f"%(prog)s {__version__}") + subparsers = parser.add_subparsers(dest="command", required=True) + + common = argparse.ArgumentParser(add_help=False) + add_common(common) + + status = subparsers.add_parser("status", parents=[common], help="Show plugin, registry and health status.") + status.set_defaults(func=cmd_status) + + scan_parser = subparsers.add_parser("scan", parents=[common], help="Discover context assets.") + scan_parser.add_argument("--no-write", action="store_true", help="Do not write registry.json.") + scan_parser.set_defaults(func=cmd_scan) + + doctor = subparsers.add_parser("doctor", parents=[common], help="Run policy checks.") + doctor.add_argument("--no-write", action="store_true", help="Do not write registry.json or findings.json.") + doctor.set_defaults(func=cmd_doctor) + + score = subparsers.add_parser("score", parents=[common], help="Compute metrics and CHI.") + score.add_argument("--write", action="store_true", help="Write metrics (default; kept for explicit scripts).") + score.add_argument("--no-write", action="store_true", help="Do not write registry.json or append metrics.jsonl.") + score.add_argument("--trend", action="store_true", help="Show the last 10 metric snapshots.") + score.add_argument( + "--fail-under", + type=float, + default=None, + metavar="CHI", + help="Exit 2 when CHI is below this value (opt-in gate for CI).", + ) + score.set_defaults(func=cmd_score) + + check = subparsers.add_parser( + "check", + parents=[common], + help="Run scan, doctor and score --trend in one pass.", + ) + check.add_argument("--no-write", action="store_true", help="Do not write registry, findings or metrics.") + check.set_defaults(func=cmd_check) + + zones_parser = subparsers.add_parser("zones", help="List or manage configured machine zones.") + zones_sub = zones_parser.add_subparsers(dest="zones_action", required=True) + zones_list = zones_sub.add_parser("list", parents=[common], help="List configured zones.") + zones_list.set_defaults(func=cmd_zones) + zones_add = zones_sub.add_parser("add", parents=[common], help="Add a zone to config.json.") + zones_add.add_argument("path", help="Zone directory (must exist).") + zones_add.add_argument("--profile", choices=["light", "full"], default="light", help="Zone profile.") + zones_add.set_defaults(func=cmd_zones) + zones_remove = zones_sub.add_parser("remove", parents=[common], help="Remove a configured zone.") + zones_remove.add_argument("path", help="Zone directory as configured.") + zones_remove.set_defaults(func=cmd_zones) + + plan = subparsers.add_parser("plan", help="Create a reviewable plan.") + plan_sub = plan.add_subparsers(dest="plan_action", required=True) + plan_findings = plan_sub.add_parser("findings", parents=[common], help="Turn findings into a review checklist.") + plan_findings.set_defaults(func=cmd_plan) + plan_move_parser = plan_sub.add_parser("move", parents=[common], help="Plan a move with backup and pointer.") + plan_move_parser.add_argument("--from", dest="source", required=True, help="Source path.") + plan_move_parser.add_argument("--to", dest="destination", required=True, help="Destination path.") + plan_move_parser.set_defaults(func=cmd_plan) + plan_init_parser = plan_sub.add_parser("init", parents=[common], help="Plan a standard .agents layout.") + plan_init_parser.add_argument("--project", required=True, help="Project root.") + plan_init_parser.set_defaults(func=cmd_plan) + + apply_parser = subparsers.add_parser("apply", parents=[common], help="Apply a plan.") + apply_parser.add_argument("plan", help="Plan JSON path.") + apply_parser.add_argument("--yes", action="store_true", help="Actually write; without it this is a dry run.") + apply_parser.add_argument( + "--dry-run", + action="store_true", + help="Explicit dry run (the default); cannot be combined with --yes.", + ) + apply_parser.set_defaults(func=cmd_apply) + + init = subparsers.add_parser("init", parents=[common], help="Initialize Guster home or a project layout.") + init.add_argument("--home", action="store_true", help="Initialize the Guster state home (default when --project is omitted).") + init.add_argument("--project", default=None, help="Project root; omit to initialize the Guster state home.") + init.add_argument("--yes", action="store_true", help="Actually write; without it this is a dry run.") + init.set_defaults(func=cmd_init) + + hub = subparsers.add_parser("hub", help="Create, attach or inspect a Guster Hub.") + hub_sub = hub.add_subparsers(dest="hub_action", required=True) + hub_init = hub_sub.add_parser("init", parents=[common], help="Create a lite Guster Hub.") + hub_init.add_argument("--path", default=None, help="Hub directory; defaults to the attached hub or the conventional Guster Hub path.") + hub_init.add_argument("--name", default=None, help="Hub display name.") + hub_init.add_argument("--knowledge", default="knowledge", help="Knowledge root relative to the hub.") + hub_init.add_argument("--projects", default="projects", help="Project state root relative to the hub.") + hub_init.add_argument("--tools", default="tools", help="Tool root relative to the hub.") + hub_init.add_argument("--yes", action="store_true", help="Actually write; without it this is a dry run.") + hub_init.set_defaults(func=cmd_hub) + hub_attach = hub_sub.add_parser("attach", parents=[common], help="Attach an existing hub to Guster config.") + hub_attach.add_argument("--path", default=None, help="Hub directory; defaults to the attached hub or the conventional Guster Hub path.") + hub_attach.set_defaults(func=cmd_hub) + hub_status = hub_sub.add_parser("status", parents=[common], help="Show hub manifest and validation status.") + hub_status.add_argument("--path", default=None, help="Hub directory; defaults to the attached hub or the conventional Guster Hub path.") + hub_status.set_defaults(func=cmd_hub) + hub_validate = hub_sub.add_parser("validate", parents=[common], help="Validate a hub against the lite contract.") + hub_validate.add_argument("--path", default=None, help="Hub directory; defaults to the attached hub or the conventional Guster Hub path.") + hub_validate.set_defaults(func=cmd_hub) + + link = subparsers.add_parser("link", parents=[common], help="Check context pointers.") + link.set_defaults(func=cmd_link) + + export = subparsers.add_parser("export", parents=[common], help="Export a redacted health report.") + export.add_argument("--format", choices=["md", "json"], default="md") + export.add_argument("--out", default=None, help="Output path.") + export.set_defaults(func=cmd_export) + + creds = subparsers.add_parser("credentials", parents=[common], help="List registered credentials by scope.") + creds.set_defaults(func=cmd_credentials) + + upgrade = subparsers.add_parser("upgrade", parents=[common], help="Check plugin manifest versions.") + upgrade.set_defaults(func=cmd_upgrade) + + return parser + + +def main(argv: Optional[Sequence[str]] = None) -> int: + parser = build_parser() + args = parser.parse_args(argv) + try: + return int(args.func(args)) + except (ApplyError, OSError, ValueError) as exc: + if getattr(args, "json", False): + print(json_dumps({"ok": False, "error": str(exc)})) + else: + print(f"[guster] {exc}", file=sys.stderr) + return 1 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/external_plugins/guster/src/guster/discover.py b/external_plugins/guster/src/guster/discover.py new file mode 100644 index 00000000..1d6ff469 --- /dev/null +++ b/external_plugins/guster/src/guster/discover.py @@ -0,0 +1,1099 @@ +from __future__ import annotations + +import os +import re +from dataclasses import dataclass, field +from pathlib import Path +from typing import Any, Dict, List, Optional, Sequence, Set, Tuple + +from . import __version__ +from .layout import resolve_hub_layout +from .util import ( + EXCLUDE_DIRS, + find_git_roots, + first_heading, + git_tracked, + is_indexed, + is_under, + iter_files, + load_json, + now_iso, + parse_frontmatter, + read_text, + relative, + sha256_file, + sha256_text, +) + + +STANDARD_AGENTS_SLOTS = ["plans", "wiki", "evidence", "skills", "tmp", "archive"] +ARTIFACT_KIND_PRIORITY = { + "instruction": 0, + "knowledge": 1, + "plan": 2, + "tool": 3, + "evidence": 4, + "state": 5, + "archive": 6, +} +GENERIC_TOPIC_STEMS = { + "readme", + "index", + "agents", + "notes", + "notesmd", + "proposal", + "tasks", + "design", + "spec", + "plan", + "todo", + "changelog", + "summary", + "skill", + "openspec", + "config", + "example", + "template", +} +SECRET_SUFFIX_NAMES = {".env", "config.json", "credentials.json", "credentials.local.json"} +INLINE_CONFIG_FILES = [ + "~/.codex/config.toml", + "~/.zcode/cli/config.json", + "~/.dsh/cordis.patch.yml", +] +INLINE_PATTERNS = [ + # Host configs carry tokens in more shapes than one: keep the detector + # narrow enough to stay quiet, broad enough not to miss a literal key. + r"\bBearer\s+([A-Za-z0-9._\-]{8,})", + r"\bsk-[A-Za-z0-9]{16,}", + r"(?i)\b(?:api[_-]?key|access[_-]?token|auth[_-]?token|secret[_-]?key)" + r"\s*[:=]\s*[\"']?([A-Za-z0-9._\-]{16,})", +] +SECRET_ENV_DEPTH = 2 +HASH_LIMIT = 8_000_000 + + +@dataclass +class ScanConfig: + home: Path + hub: Optional[Path] + roots: List[Path] + state_dir: Path + plugin_root: Optional[Path] = None + max_depth: int = 5 + scope: str = "machine" + now: str = field(default_factory=now_iso) + # Declared machine zones (`config.json` `zones`): {"path": ..., "profile": ...}. + # "light" zones are tool areas — AGENTS/README artifacts and secrets, no + # project slots — so a non-git tool layer is governed without pretending + # each tool is a repository. + zones: List[Dict[str, str]] = field(default_factory=list) + # First-run UX: no config.json existed, and roots came from auto-detection. + # Drives the "run `guster init`" banner; empty candidates fail loud earlier. + unconfigured: bool = False + auto_roots: bool = False + + +def scope_roots(config: ScanConfig) -> Optional[List[Path]]: + """Directories that define the run's scope; None means the machine-wide view. + + The same boundary filters artifacts and findings, so a scoped report never + counts a document it can no longer raise a finding about. + """ + if config.scope == "hub": + return [config.hub.expanduser().resolve()] if config.hub else [] + if config.scope in {"project", "group"}: + return [root.expanduser().resolve() for root in config.roots] + return None + + +def in_scope_path(value: str, roots: Sequence[Path]) -> bool: + if not value: + return False + try: + candidate = Path(value).expanduser().resolve() + except OSError: + return False + return any(candidate == root or root in candidate.parents for root in roots) + + +def default_roots(home: Path) -> List[Path]: + """Generic first-run candidates; empty when none exist so callers fail loud.""" + candidates = [home / name for name in ("Projects", "code", "dev", "src")] + seen: Set[str] = set() + roots: List[Path] = [] + for candidate in candidates: + if candidate.is_dir(): + resolved = str(candidate.resolve()) + if resolved not in seen: + seen.add(resolved) + roots.append(candidate) + return roots + + +def dedupe_artifacts(items: Sequence[Dict[str, Any]]) -> List[Dict[str, Any]]: + """Keep one record per path so ratios count files, not scan passes.""" + best: Dict[str, Tuple[int, Dict[str, Any]]] = {} + order: List[str] = [] + for item in items: + path = item["path"] + rank = ARTIFACT_KIND_PRIORITY.get(str(item.get("kind")), 9) + current = best.get(path) + if current is None: + order.append(path) + best[path] = (rank, item) + elif rank < current[0]: + best[path] = (rank, item) + return [best[path][1] for path in order] + + +def topic_key(path: Path) -> str: + stem = path.stem.strip().lower().lstrip(".") + stem = re.sub(r"[-_ ]?20\d{6}$", "", stem) + stem = re.sub(r"[-_ ]?\d{4}-\d{2}-\d{2}$", "", stem) + return stem + + +def derive_topics( + artifacts: Sequence[Dict[str, Any]], + skills: Sequence[Dict[str, Any]], +) -> Dict[str, Any]: + """Group knowledge into facts and report the ones with more than one home.""" + knowledge_all = [ + item + for item in artifacts + if item.get("kind") == "knowledge" + and Path(item["path"]).name.lower() not in {"readme.md", "agents.md"} + ] + knowledge = [item for item in knowledge_all if item.get("hash")] + unhashed = sum(1 for item in knowledge_all if not item.get("hash")) + consumed: Set[str] = set() + topics: List[Dict[str, Any]] = [] + + by_stem: Dict[str, List[Dict[str, Any]]] = {} + for item in knowledge: + stem = topic_key(Path(item["path"])) + if not stem or stem in GENERIC_TOPIC_STEMS or len(stem) < 4: + continue + by_stem.setdefault(stem, []).append(item) + for stem, items in sorted(by_stem.items()): + hashes = {item["hash"] for item in items} + if len(hashes) > 1: + topics.append( + { + "key": stem, + "reason": "same-name-different-content", + "sources": len(hashes), + "paths": [item["path"] for item in items], + } + ) + consumed.update(item["path"] for item in items) + + by_hash: Dict[str, List[Dict[str, Any]]] = {} + for item in knowledge: + if item["path"] in consumed: + continue + by_hash.setdefault(item["hash"], []).append(item) + for digest, items in by_hash.items(): + topics.append( + { + "key": topic_key(Path(items[0]["path"])) or digest[:8], + "reason": "duplicate-content" if len(items) > 1 else "single", + "sources": len(items), + "paths": [item["path"] for item in items], + } + ) + + for skill in skills: + copies = skill.get("copies") or [] + hashes = {copy.get("hash", "") for copy in copies} or {skill.get("hash", "")} + topics.append( + { + "key": f"skill:{skill['name']}", + "reason": "skill-copy-drift" if len(hashes) > 1 else "single", + "sources": len(hashes) if len(hashes) > 1 else 1, + "paths": [copy.get("root", "") for copy in copies] or [skill.get("root", "")], + } + ) + + multi = [topic for topic in topics if int(topic.get("sources", 1)) > 1] + return { + "total": len(topics), + "multi": len(multi), + "multi_topics": multi, + "unhashed": unhashed, + } + + +def scan(config: ScanConfig) -> Dict[str, Any]: + home = config.home + hub = config.hub + scope = config.scope + roots = [root for root in config.roots if root.exists()] + git_roots = find_git_roots(roots, max_depth=config.max_depth) + project_roots: List[Path] = list(git_roots) + known = {item.resolve() for item in project_roots} + for root in roots: + resolved = root.resolve() + if resolved in known: + continue + if resolved == home.resolve() and not has_project_marker(root): + # `~/.agents/` is the user-level context root; the home directory is + # a workspace, not a project, unless it carries its own markers. + continue + if looks_like_project(root): + project_roots.append(root) + known.add(resolved) + + projects: List[Dict[str, Any]] = [] + project_tracked: Dict[str, Optional[Set[str]]] = {} + used_ids: Set[str] = set() + for root in sorted(project_roots, key=lambda item: str(item)): + tracked = git_tracked(root) + project_tracked[str(root)] = tracked + project = scan_project( + root=root, + group=root.parent.name, + tracked=tracked, + now=config.now, + taken=used_ids, + ) + used_ids.add(project["id"]) + projects.append(project) + + mark_containers(projects) + index_texts = load_index_texts(home, hub, projects) + + walk_errors: List[str] = [] + artifacts: List[Dict[str, Any]] = [] + zones = [ + item + for item in config.zones + if Path(item["path"]).expanduser().is_dir() + ] + if scope != "hub": + artifacts.extend(scan_project_agents(projects, index_texts, project_tracked, walk_errors)) + artifacts.extend(scan_zones(zones, walk_errors)) + artifacts.extend(scan_hub_knowledge(hub, index_texts, walk_errors)) + if scope != "hub": + artifacts.extend(scan_local_wiki(home, index_texts, walk_errors)) + artifacts = dedupe_artifacts(artifacts) + scoped = scope_roots(config) + if scoped is not None: + # Scoped runs must not carry artifacts whose findings they filter out: + # that inflates ICR/FRS/PHR denominators and depresses the score. + artifacts = [item for item in artifacts if in_scope_path(item["path"], scoped)] + + skills = scan_skills(home) if scope != "hub" else [] + topics = derive_topics(artifacts, skills) + secret_files = scan_secret_files( + home, + hub, + projects, + project_tracked, + zones=zones, + include_home=scope != "hub", + errors=walk_errors, + ) + credential_registry = scan_credential_registry(home) + inline_bearers = scan_inline_bearers(home) if scope != "hub" else [] + governance_docs = find_governance_docs(home, hub) + if scope == "hub" and hub: + governance_docs = [ + item for item in governance_docs if is_under(Path(item), hub) + ] + manifests = scan_plugin_manifests(config.plugin_root) if scope != "hub" else {} + + registry: Dict[str, Any] = { + "version": 1, + "plugin": {"name": "guster", "version": __version__}, + "generated_at": config.now, + "scope": config.scope, + "home": str(home), + "hub": str(hub) if hub else None, + "state_dir": str(config.state_dir), + "unconfigured": config.unconfigured, + "auto_roots": config.auto_roots, + "workspaces": [str(root) for root in roots], + "scan_errors": {"count": len(walk_errors), "examples": walk_errors[:10]}, + "zones": [ + { + "path": str(Path(item["path"]).expanduser()), + "profile": item.get("profile", "light"), + "tools": count_zone_tools(Path(item["path"]).expanduser()), + } + for item in zones + ], + "projects": projects, + "skills": skills, + "topics": topics, + "artifacts": artifacts, + "secrets": { + "canonical_roots": [ + str(home / ".agents" / "credentials"), + ], + "files": secret_files, + "inline_bearers": inline_bearers, + "registry": credential_registry, + }, + "governance_docs": governance_docs, + "plugin_manifests": manifests, + "summary": summarize( + projects, + skills, + artifacts, + secret_files, + inline_bearers, + count_project_cards(hub, walk_errors), + ), + } + return registry + + +def mark_containers(projects: List[Dict[str, Any]]) -> None: + """A directory holding other scanned projects is a workspace/group, not a project. + + Group-level AGENTS.md files are instruction assets of the group; counting the + container as a project inflates the project count and turns one container's + partial `.agents/` into a permanent placement failure. + """ + roots = [Path(project["path"]) for project in projects] + for project in projects: + root = Path(project["path"]) + project["container"] = any(root in other.parents for other in roots if other != root) + + +def looks_like_project(root: Path) -> bool: + return ( + has_project_marker(root) + or (root / ".agents").is_dir() + or (root / "skills").is_dir() + ) + + +def has_project_marker(root: Path) -> bool: + return ( + (root / "AGENTS.md").is_file() + or (root / "CLAUDE.md").is_file() + or (root / "package.json").is_file() + ) + + +def scan_project( + root: Path, + group: str, + tracked: Optional[Set[str]], + now: str, + taken: Optional[Set[str]] = None, +) -> Dict[str, Any]: + agent_files = find_agent_files(root, max_depth=3) + agents_dir = root / ".agents" + agents_entries: List[str] = [] + standard_slots: List[str] = [] + has_index = False + if agents_dir.is_dir(): + try: + agents_entries = sorted( + item.name for item in agents_dir.iterdir() if item.name != ".DS_Store" + ) + except OSError: + agents_entries = [] + standard_slots = [slot for slot in STANDARD_AGENTS_SLOTS if (agents_dir / slot).exists()] + has_index = agents_index_present(agents_dir) + + status = "unknown" + for agent_file in agent_files: + text = read_text(agent_file, limit=200_000) + match = re.search(r"\*\*状态\*\*\s*[::]\s*(.+)", text) + if match: + status = match.group(1).strip() + break + + project_id = unique_project_id(root.name, root, taken) + return { + "id": project_id, + "path": str(root), + "group": group, + "git_root": str(root), + "agent_files": [relative(path, root) for path in agent_files], + "agents_dir": str(agents_dir) if agents_dir.is_dir() else None, + "agents_entries": agents_entries, + "standard_slots": standard_slots, + "has_index": has_index, + "skills": find_project_skills(root), + "tools": find_project_tools(root), + "status": status, + "last_scan": now, + "container": False, + "git_state": "ok" if tracked is not None else "error", + "tracked_count": len(tracked) if tracked is not None else None, + } + + +def agents_index_present(agents_dir: Path) -> bool: + """An index must have content; an empty placeholder indexes nothing.""" + for name in ("README.md", "AGENTS.md"): + path = agents_dir / name + try: + if path.is_file() and path.stat().st_size > 0: + return True + except OSError: + continue + return False + + +def unique_project_id(name: str, root: Path, taken: Optional[Set[str]] = None) -> str: + """Slug id; a same-name sibling gets a short path-hash suffix so + `project:{id}` index keys never overwrite each other.""" + cleaned = re.sub(r"[^A-Za-z0-9._-]+", "-", name.strip()).strip("-") + base = cleaned or sha256_text(str(root))[:10] + if taken is not None and base in taken: + return f"{base}-{sha256_text(str(root))[:8]}" + return base + + +def find_agent_files(root: Path, max_depth: int = 3) -> List[Path]: + results: List[Path] = [] + for name in ("AGENTS.md", "CLAUDE.md"): + candidate = root / name + if candidate.is_file(): + results.append(candidate) + root_depth = len(root.resolve().parts) + for current, dirs, files in os.walk(root): + current_path = Path(current) + depth = len(current_path.resolve().parts) - root_depth + if depth >= max_depth: + dirs[:] = [] + dirs[:] = sorted(d for d in dirs if d not in EXCLUDE_DIRS and not d.startswith(".git")) + for name in ("AGENTS.md", "CLAUDE.md"): + candidate = current_path / name + if candidate.is_file() and candidate not in results: + results.append(candidate) + return sorted(results, key=lambda item: str(item)) + + +def find_project_skills(root: Path) -> List[str]: + roots = [root / "skills", root / ".agents" / "skills", root / ".claude" / "skills"] + found: List[str] = [] + for skill_root in roots: + if not skill_root.is_dir(): + continue + for child in sorted(skill_root.iterdir()): + if (child / "SKILL.md").is_file(): + found.append(str(child)) + return found + + +def find_project_tools(root: Path) -> List[str]: + tools_root = root / "tools" + if not tools_root.is_dir(): + return [] + found: List[str] = [] + for child in sorted(tools_root.iterdir()): + if child.is_dir() and ((child / "AGENTS.md").exists() or (child / "README.md").exists()): + found.append(str(child)) + return found + + +def load_index_texts(home: Path, hub: Optional[Path], projects: Sequence[Dict[str, Any]]) -> Dict[str, str]: + texts: Dict[str, str] = {} + if hub: + layout = resolve_hub_layout(hub) + texts["hub"] = read_text(layout["knowledge"] / "README.md", limit=2_000_000) + tools_root = layout.get("tools") + if tools_root: + texts["tools"] = read_text(tools_root / "README.md", limit=2_000_000) + texts["local_wiki"] = read_text(home / ".agents" / "wiki" / "README.md", limit=2_000_000) + for project in projects: + agents_dir = project.get("agents_dir") + if agents_dir: + texts[f"project:{project['id']}"] = read_text( + Path(agents_dir) / "README.md", limit=1_000_000 + ) + return texts + + +def artifact_record( + path: Path, + kind: str, + plane: str, + scope: str, + project_id: Optional[str], + indexed: Optional[bool], + tracked: Optional[Set[str]] = None, + base: Optional[Path] = None, +) -> Dict[str, Any]: + text = "" + if path.suffix.lower() in {".md", ".markdown", ".txt", ".json", ".yaml", ".yml", ".toml"}: + text = read_text(path, limit=1_000_000) + frontmatter, body = parse_frontmatter(text) + size = 0 + mtime = 0.0 + try: + # One stat, no exists-then-stat window: a file deleted mid-scan reads + # as absent (0), never as a crash. + info = path.stat() + size = info.st_size + mtime = info.st_mtime + except OSError: + pass + tracked_flag: Optional[bool] = False + if tracked is None: + # Unknown is not "untracked": a failed git probe must stay visible. + tracked_flag = None + elif base is not None: + try: + tracked_flag = str(path.resolve().relative_to(base.resolve())) in tracked + except (OSError, ValueError): + tracked_flag = False + oversized = size > HASH_LIMIT + file_hash = "" if oversized else sha256_file(path) + return { + "path": str(path), + "rel": relative(path, base) if base else str(path), + "kind": kind, + "plane": plane, + "scope": scope, + "project": project_id, + "size": size, + "mtime": mtime, + "hash": file_hash, + "hash_error": not oversized and not file_hash, + "frontmatter": frontmatter, + "title": first_heading(body if text else "", path.stem), + "indexed": indexed, + "git_tracked": tracked_flag, + "verified_at": frontmatter.get("verified_at") or frontmatter.get("updated", ""), + "stale_after": frontmatter.get("stale_after", ""), + "status": frontmatter.get("status", ""), + } + + +def scan_project_agents( + projects: Sequence[Dict[str, Any]], + index_texts: Dict[str, str], + project_tracked: Dict[str, Optional[Set[str]]], + errors: Optional[List[str]] = None, +) -> List[Dict[str, Any]]: + records: List[Dict[str, Any]] = [] + for project in projects: + root = Path(project["path"]) + tracked = project_tracked.get(project["path"], set()) + for agent_rel in project.get("agent_files", []): + path = root / agent_rel + records.append( + artifact_record(path, "instruction", "instruction", "project", project["id"], None, tracked, root) + ) + agents_dir = project.get("agents_dir") + if not agents_dir: + continue + agents_path = Path(agents_dir) + index_text = index_texts.get(f"project:{project['id']}", "") + index_path = agents_path / "README.md" + if index_path.is_file() and not index_path.is_symlink(): + records.append( + artifact_record( + index_path, "instruction", "instruction", "project", project["id"], None, tracked, root + ) + ) + for slot, kind, plane in ( + ("plans", "plan", "state"), + ("wiki", "knowledge", "knowledge"), + ("evidence", "evidence", "evidence"), + ("archive", "archive", "evidence"), + ): + slot_root = agents_path / slot + if not slot_root.is_dir(): + continue + if slot_root.is_symlink(): + # A shared slot (e.g. a wiki linked from a sibling checkout) is + # scanned under the project that owns the real directory. + continue + for path in iter_files(slot_root, suffixes={".md", ".json", ".yaml", ".yml"}, errors=errors): + if "openspec" in path.parts[:-1]: + # OpenSpec store config and change metadata are state, not knowledge. + continue + if path.is_symlink(): + continue + indexed = is_indexed(path.name, index_text) if kind == "knowledge" else None + records.append( + artifact_record(path, kind, plane, "project", project["id"], indexed, tracked, root) + ) + return records + + +def scan_hub_knowledge( + hub: Optional[Path], + index_texts: Dict[str, str], + errors: Optional[List[str]] = None, +) -> List[Dict[str, Any]]: + if not hub: + return [] + records: List[Dict[str, Any]] = [] + tracked = git_tracked(hub) + knowledge_index = index_texts.get("hub", "") + layout = resolve_hub_layout(hub) + knowledge_index_path = layout["knowledge"] / "README.md" + if knowledge_index_path.is_file(): + records.append( + artifact_record( + knowledge_index_path, "instruction", "instruction", "project", None, None, tracked, hub + ) + ) + default_suffixes = {".md", ".json", ".yaml", ".yml"} + groups = [ + (layout["knowledge"] / "general", "knowledge", "knowledge", "general", True, default_suffixes), + (layout["knowledge"] / "projects", "knowledge", "knowledge", "project", True, default_suffixes), + (layout["knowledge"] / "workgroups", "knowledge", "knowledge", "workgroup", True, default_suffixes), + (layout["projects"], "state", "state", "project", False, default_suffixes), + (hub / "handoff", "state", "state", "project", False, default_suffixes), + (hub / "provision", "state", "state", "project", False, default_suffixes), + (hub / "reports", "evidence", "evidence", "project", False, default_suffixes), + (hub / "Human Output", "evidence", "evidence", "project", False, default_suffixes), + (hub / "manuals", "state", "state", "project", False, default_suffixes), + (hub / "cron-tasks", "state", "state", "project", False, default_suffixes | {".plist"}), + (hub / "openspec", "plan", "state", "project", False, default_suffixes), + (hub / "archive", "archive", "archive", "project", False, default_suffixes), + (hub / ".agents" / "plans", "plan", "state", "project", False, default_suffixes), + ] + for root, kind, plane, scope, check_index, suffixes in groups: + if not root.is_dir(): + continue + for path in iter_files(root, suffixes=suffixes, errors=errors): + indexed = None + if check_index and kind == "knowledge": + indexed = is_indexed(path.name, knowledge_index) + records.append( + artifact_record(path, kind, plane, scope, None, indexed, tracked, hub) + ) + strategy = hub / "strategy.md" + if strategy.is_file(): + records.append( + artifact_record( + strategy, "state", "state", "project", None, None, tracked, hub + ) + ) + tools_root = layout.get("tools") + for path in iter_files(tools_root, suffixes={".md"}, max_depth=3, errors=errors) if tools_root else []: + if path.name in {"AGENTS.md", "README.md"}: + records.append( + artifact_record(path, "tool", "capability", "project", None, None, tracked, hub) + ) + return records + + +def scan_local_wiki( + home: Path, + index_texts: Dict[str, str], + errors: Optional[List[str]] = None, +) -> List[Dict[str, Any]]: + root = home / ".agents" / "wiki" + if not root.is_dir(): + return [] + index_text = index_texts.get("local_wiki", "") + records: List[Dict[str, Any]] = [] + for path in iter_files(root, suffixes={".md"}, skip_dirs=EXCLUDE_DIRS | {"assets"}, errors=errors): + if path.is_symlink(): + # Compatibility links point at a canonical file already counted. + continue + records.append( + artifact_record( + path, + "knowledge", + "knowledge", + "local", + None, + is_indexed(path.name, index_text), + ) + ) + return records + + +def count_zone_tools(root: Path) -> int: + """Tool count for a zone summary: flat zones hold tools at depth 1, + grouped zones (like common/company) hold them at depth 2.""" + if not root.is_dir(): + return 0 + count = 0 + for child in sorted(root.iterdir()): + if not child.is_dir() or child.name.startswith("."): + continue + if (child / "AGENTS.md").exists() or (child / "README.md").exists(): + count += 1 + continue + for grandchild in sorted(child.iterdir()): + if not grandchild.is_dir() or grandchild.name.startswith("."): + continue + if (grandchild / "AGENTS.md").exists() or (grandchild / "README.md").exists(): + count += 1 + return count + + +def scan_zones( + zones: Sequence[Dict[str, str]], + errors: Optional[List[str]] = None, +) -> List[Dict[str, Any]]: + """Light-profile zone scan: entry docs and nothing else. + + A declared tool zone is not a project tree. The light profile collects + AGENTS.md/README.md so pointer health and freshness can see them, and the + caller feeds the zone root to the secret scan; slot compliance never + applies because a tool is not a repository with `.agents/` slots. + """ + records: List[Dict[str, Any]] = [] + for zone in zones: + root = Path(zone["path"]).expanduser() + for path in iter_files(root, suffixes={".md"}, max_depth=3, errors=errors): + if path.is_symlink() or path.name not in {"AGENTS.md", "README.md"}: + continue + records.append( + artifact_record( + path, + "tool", + "capability", + "zone", + None, + None, + None, + root, + ) + ) + return records + + +def extra_skill_roots() -> List[Tuple[str, Path]]: + """Extra skill hosts from GUSTER_EXTRA_SKILL_ROOTS (name=path, os.pathsep separated). + + Declared hosts are configuration, not guesses: a malformed entry or a missing + directory stops the run instead of silently dropping the host.""" + roots: List[Tuple[str, Path]] = [] + for item in os.environ.get("GUSTER_EXTRA_SKILL_ROOTS", "").split(os.pathsep): + item = item.strip() + if not item: + continue + name, sep, raw = item.partition("=") + if not sep or not name.strip() or not raw.strip(): + raise ValueError(f"GUSTER_EXTRA_SKILL_ROOTS entries must be name=path: {item!r}") + root = Path(raw.strip()).expanduser() + if not root.is_dir(): + raise ValueError( + f"GUSTER_EXTRA_SKILL_ROOTS host {name.strip()!r} directory does not exist: {root}" + ) + roots.append((name.strip(), root)) + return roots + + +def scan_skills(home: Path) -> List[Dict[str, Any]]: + roots = [ + ("agents", home / ".agents" / "skills"), + ("codex", home / ".codex" / "skills"), + ("dsh", home / ".dsh" / "skills"), + ("claude", home / ".claude" / "skills"), + ] + extra_skill_roots() + raw: List[Dict[str, Any]] = [] + for host, root in roots: + if not root.is_dir(): + continue + for skill_md in sorted(root.glob("*/SKILL.md")): + text = read_text(skill_md, limit=500_000) + frontmatter, _ = parse_frontmatter(text) + name = frontmatter.get("name") or skill_md.parent.name + description = frontmatter.get("description", "") + raw.append( + { + "name": name, + "root": str(skill_md.parent), + "host": host, + "description": description, + "description_chars": len(description), + "hash": sha256_file(skill_md), + } + ) + + grouped: Dict[str, List[Dict[str, Any]]] = {} + for item in raw: + grouped.setdefault(item["name"], []).append(item) + + skills: List[Dict[str, Any]] = [] + for name in sorted(grouped): + copies = sorted(grouped[name], key=lambda item: item["root"]) + primary = copies[0] + skills.append( + { + "name": name, + "root": primary["root"], + "host": primary["host"], + "description": primary["description"], + "description_chars": len(primary["description"]), + "hash": primary["hash"], + "copies": [ + {"host": item["host"], "root": item["root"], "hash": item["hash"]} + for item in copies + ], + } + ) + return skills + + +def find_env_files(root: Path, max_depth: int = SECRET_ENV_DEPTH) -> List[Path]: + """`.env` files under a project, bounded by depth so the scan stays cheap.""" + found: List[Path] = [] + stack: List[Tuple[Path, int]] = [(root, 0)] + while stack: + current, depth = stack.pop() + try: + entries = list(current.iterdir()) + except OSError: + continue + for entry in entries: + if entry.is_file() and entry.name == ".env": + found.append(entry) + elif ( + entry.is_dir() + and depth < max_depth + and not entry.name.startswith(".") + and entry.name not in EXCLUDE_DIRS + and not entry.is_symlink() + ): + stack.append((entry, depth + 1)) + return sorted(found) + + +def scan_secret_files( + home: Path, + hub: Optional[Path], + projects: Sequence[Dict[str, Any]], + project_tracked: Dict[str, Optional[Set[str]]], + zones: Sequence[Dict[str, str]] = (), + include_home: bool = True, + errors: Optional[List[str]] = None, +) -> List[Dict[str, Any]]: + candidates: List[Path] = [] + if include_home: + for root in (home / ".agents" / "credentials",): + if root.is_dir(): + candidates.extend( + path + for path in iter_files(root, errors=errors) + if path.is_file() and path.suffix.lower() != ".md" + ) + if hub: + tools_root = resolve_hub_layout(hub).get("tools") + if tools_root and tools_root.is_dir(): + for path in iter_files(tools_root, max_depth=3, errors=errors): + if path.name in SECRET_SUFFIX_NAMES or path.name.startswith("credentials.") or path.name.endswith(".local.json"): + candidates.append(path) + for zone in zones: + candidates.extend(find_env_files(Path(zone["path"]).expanduser())) + for project in projects: + candidates.extend(find_env_files(Path(project["path"]))) + + seen: Set[str] = set() + records: List[Dict[str, Any]] = [] + for path in candidates: + try: + resolved = str(path.resolve()) + except OSError: + continue + if resolved in seen: + continue + seen.add(resolved) + canonical = is_under(path, home / ".agents" / "credentials") + tracked: Optional[bool] = None + for project in projects: + project_root = Path(project["path"]) + if not is_under(path, project_root): + continue + tracked_set = project_tracked.get(str(project_root)) + if tracked_set is None: + tracked = None + else: + try: + rel = str(path.resolve().relative_to(project_root.resolve())) + except ValueError: + rel = "" + tracked = rel in tracked_set + break + if tracked is None and not any(is_under(path, Path(p["path"])) for p in projects): + # Outside every scanned repository there is nothing that could track it. + tracked = False + try: + size = path.stat().st_size + except OSError: + size = 0 + records.append( + { + "path": str(path), + "canonical": canonical, + "git_tracked": tracked, + "size": size, + "kind": infer_secret_kind(path), + } + ) + return records + + +def scan_credential_registry(home: Path) -> Dict[str, Any]: + """Read the credential registry table; it never contains secret values.""" + path = home / ".agents" / "credentials" / "registry.md" + entries: List[Dict[str, str]] = [] + warnings: List[str] = [] + if path.is_file(): + for line_no, line in enumerate(read_text(path, limit=1_000_000).splitlines(), start=1): + stripped = line.strip() + if not stripped.startswith("|"): + continue + cells = [cell.strip() for cell in stripped.strip("|").split("|")] + if cells[0] in {"ID", ""} or set(cells[0]) <= {"-", ":"}: + continue + if len(cells) < 6: + # An entry-shaped row that cannot be an entry is a broken row, + # not silence: ID|scope|site|account|kind|locations are required. + warnings.append( + f"line {line_no}: expected at least 6 columns " + f"(ID|scope|site|account|kind|locations), got {len(cells)}: {stripped[:80]}" + ) + continue + entries.append( + { + "id": cells[0], + "scope": cells[1], + "site": cells[2], + "account": cells[3], + "kind": cells[4], + "locations": cells[5], + "keys": cells[6] if len(cells) > 6 else "", + "used_by": cells[7] if len(cells) > 7 else "", + "status": cells[8] if len(cells) > 8 else "", + } + ) + return { + "path": str(path) if path.is_file() else None, + "entries": entries, + "parse_warnings": warnings, + } + + +def infer_secret_kind(path: Path) -> str: + name = path.name.lower() + if name.endswith(".env") or name.endswith(".env.example"): + return "env" + if "token" in name or "secret" in name or "credential" in name: + return "token" + if name.endswith((".json", ".yaml", ".yml", ".toml")): + return "config" + return "file" + + +def scan_inline_bearers(home: Path) -> List[Dict[str, Any]]: + records: List[Dict[str, Any]] = [] + for raw in INLINE_CONFIG_FILES: + path = home / raw[2:] if raw.startswith("~/") else Path(raw) + if not path.is_file(): + continue + text = read_text(path, limit=2_000_000) + values: List[str] = [] + for pattern in INLINE_PATTERNS: + for match in re.finditer(pattern, text): + value = match.group(1) + redacted = f"{value[:4]}...{value[-4:]}" + if redacted not in values: + values.append(redacted) + if values: + records.append({"path": str(path), "count": len(values), "redacted": values}) + return records + + +def find_governance_docs(home: Path, hub: Optional[Path]) -> List[str]: + # Framework docs, not topic authorities. A doc that labels itself a facet + # ("分册") belongs to the primary framework and does not compete with it. + named = { + "agent-context-map.md", + "codex-context-stack.md", + "context-engineering-principles.md", + "knowledge-taxonomy.md", + "project-agents-layout.md", + } + candidates: List[Path] = [] + if hub: + general = resolve_hub_layout(hub)["knowledge"] / "general" + if general.is_dir(): + candidates.extend(path for path in general.iterdir() if path.name in named) + candidates.extend( + path + for path in (home / ".agents" / "wiki").glob("*.md") + if path.name in named + ) + primary = [] + for path in candidates: + header = "\n".join(read_text(path, limit=4000).splitlines()[:5]) + if "分册" not in header: + primary.append(str(path)) + return sorted(primary) + + +def scan_plugin_manifests(plugin_root: Optional[Path]) -> Dict[str, Any]: + if plugin_root is None: + return {} + manifests: Dict[str, Any] = {} + for label, rel in ( + ("codex", ".codex-plugin/plugin.json"), + ("zcode", ".zcode-plugin/plugin.json"), + ("package", "package.json"), + ): + path = plugin_root / rel + data = load_json(path, {}) + manifests[label] = { + "path": str(path), + "exists": path.is_file(), + "version": data.get("version") if isinstance(data, dict) else None, + "name": data.get("name") if isinstance(data, dict) else None, + } + return manifests + + +PROJECT_CARD_NAMES = {"_registry.md", "readme.md", "agents.md"} + + +def count_project_cards(hub: Optional[Path], errors: Optional[List[str]] = None) -> int: + """Project cards known to the hub, not the project roots a run scanned.""" + if not hub: + return 0 + root = resolve_hub_layout(hub)["projects"] + if not root.is_dir(): + return 0 + return sum( + 1 + for path in iter_files(root, suffixes={".md"}, max_depth=1, errors=errors) + if path.parent == root and path.name.lower() not in PROJECT_CARD_NAMES + ) + + +def summarize( + projects: Sequence[Dict[str, Any]], + skills: Sequence[Dict[str, Any]], + artifacts: Sequence[Dict[str, Any]], + secret_files: Sequence[Dict[str, Any]], + inline_bearers: Sequence[Dict[str, Any]], + project_cards: int = 0, +) -> Dict[str, Any]: + return { + "projects": len(projects), + "containers": sum(1 for project in projects if project.get("container")), + "project_cards": project_cards, + "agents_dirs": sum(1 for project in projects if project.get("agents_dir")), + "agents_with_index": sum(1 for project in projects if project.get("has_index")), + "git_errors": sum(1 for project in projects if project.get("git_state") == "error"), + "skills": len(skills), + "skill_copies": sum(len(skill.get("copies", [])) for skill in skills), + "artifacts": len(artifacts), + "knowledge": sum(1 for item in artifacts if item.get("kind") == "knowledge"), + "state": sum(1 for item in artifacts if item.get("kind") == "state"), + "evidence": sum(1 for item in artifacts if item.get("kind") == "evidence"), + "secret_files": len(secret_files), + "secret_outside_root": sum(1 for item in secret_files if not item.get("canonical")), + "secret_in_git": sum(1 for item in secret_files if item.get("git_tracked")), + "inline_bearer_files": len(inline_bearers), + "inline_bearers": sum(item.get("count", 0) for item in inline_bearers), + } diff --git a/external_plugins/guster/src/guster/executor.py b/external_plugins/guster/src/guster/executor.py new file mode 100644 index 00000000..5ff4e9ce --- /dev/null +++ b/external_plugins/guster/src/guster/executor.py @@ -0,0 +1,281 @@ +from __future__ import annotations + +import json +import shutil +from pathlib import Path +from typing import Any, Dict, List, Optional, Tuple + +from .discover import default_roots +from .util import now_iso, unique_suffix, write_text + + +class ApplyError(RuntimeError): + pass + + +BACKUPS_KEEP = 10 + + +def prune_backups(state_dir: Path, keep: int = BACKUPS_KEEP) -> List[str]: + """Keep the newest `keep` plan backup directories; hub-config files and + anything unexpected in backups/ stay untouched.""" + root = state_dir / "backups" + if not root.is_dir(): + return [] + + def stamp(item: Path) -> float: + try: + return item.stat().st_mtime + except OSError: + return 0.0 + + dirs = sorted( + (item for item in root.iterdir() if item.is_dir()), + key=stamp, + reverse=True, + ) + removed: List[str] = [] + for item in dirs[keep:]: + try: + shutil.rmtree(item) + except OSError: + continue + removed.append(str(item)) + return removed + + +def preflight(plan: Dict[str, Any]) -> List[str]: + errors: List[str] = [] + operations = plan.get("operations", []) + if not isinstance(operations, list): + return ["plan operations must be a list"] + for index, operation in enumerate(operations, start=1): + if not isinstance(operation, dict): + errors.append(f"op {index}: operation is not a JSON object") + continue + kind = operation.get("kind") + if not isinstance(kind, str) or not kind: + errors.append(f"op {index}: missing operation kind") + continue + if kind == "move": + src_value = operation.get("src") + dst_value = operation.get("dst") + missing = [ + key + for key, value in (("src", src_value), ("dst", dst_value)) + if not isinstance(value, str) or not value + ] + if missing: + errors.append(f"op {index}: move needs string field(s): {', '.join(missing)}") + continue + src = Path(src_value) + dst = Path(dst_value) + if not src.exists(): + errors.append(f"op {index}: source does not exist: {src}") + if dst.exists(): + errors.append(f"op {index}: destination already exists: {dst}") + if src == dst: + errors.append(f"op {index}: source and destination are identical") + elif kind in {"write", "mkdir"}: + value = operation.get("path") + if not isinstance(value, str) or not value: + errors.append(f"op {index}: {kind} needs a string 'path'") + continue + path = Path(value) + if kind == "mkdir": + if path.exists() and not path.is_dir(): + errors.append(f"op {index}: target exists and is not a directory: {path}") + elif path.exists() and not path.is_file(): + errors.append(f"op {index}: target is not a file: {path}") + elif kind != "manual": + errors.append(f"op {index}: unknown operation kind: {kind}") + return errors + + +def apply_plan( + plan: Dict[str, Any], + state_dir: Path, + dry_run: bool = True, + yes: bool = False, +) -> Dict[str, Any]: + if not dry_run and not yes: + raise ApplyError("refusing to write without --yes") + errors = preflight(plan) + if errors: + return { + "ok": False, + "dry_run": dry_run, + "plan": plan.get("id"), + "errors": errors, + "applied": 0, + "skipped": 0, + } + + plan_id = plan.get("id") or "plan" + backup_dir = state_dir / "backups" / plan_id + undo: List[Tuple[str, Dict[str, Any]]] = [] + applied = 0 + skipped = 0 + + if dry_run: + for operation in plan.get("operations", []): + if operation.get("kind") == "manual": + skipped += 1 + else: + applied += 1 + return { + "ok": True, + "dry_run": True, + "plan": plan_id, + "errors": [], + "applied": applied, + "skipped": skipped, + "operations": plan.get("operations", []), + } + + backup_dir.mkdir(parents=True, exist_ok=True) + try: + for index, operation in enumerate(plan.get("operations", []), start=1): + kind = operation.get("kind") + if kind == "manual": + skipped += 1 + continue + if kind == "mkdir": + path = Path(operation["path"]) + path.mkdir(parents=True, exist_ok=True) + applied += 1 + elif kind == "move": + src = Path(operation["src"]) + dst = Path(operation["dst"]) + backup = backup_dir / f"{index:03d}-{src.name}" + if src.is_dir(): + shutil.copytree(src, backup) + else: + shutil.copy2(src, backup) + undo.append(("move", {"src": str(src), "dst": str(dst), "backup": str(backup)})) + dst.parent.mkdir(parents=True, exist_ok=True) + shutil.move(str(src), str(dst)) + pointer = operation.get("pointer") + if pointer and pointer.get("path"): + pointer_path = Path(pointer["path"]) + pointer_backup = backup_dir / f"{index:03d}-pointer-{pointer_path.name}" + if pointer_path.exists(): + shutil.copy2(pointer_path, pointer_backup) + undo.append( + ("write", {"path": str(pointer_path), "backup": str(pointer_backup)}) + ) + write_text(pointer_path, pointer.get("content", "")) + applied += 1 + elif kind == "write": + path = Path(operation["path"]) + backup = backup_dir / f"{index:03d}-{path.name}" + if path.exists(): + shutil.copy2(path, backup) + undo.append(("write", {"path": str(path), "backup": str(backup)})) + write_text(path, operation.get("content", "")) + applied += 1 + else: + raise ApplyError(f"unsupported operation: {kind}") + except Exception as exc: + rollback_error: Optional[BaseException] = None + try: + rollback(undo) + except BaseException as undo_exc: # noqa: BLE001 - reported, never hidden + rollback_error = undo_exc + if rollback_error is not None: + # Both the apply and the rollback failed: keep the root cause and + # name the recovery material instead of swallowing either. + raise ApplyError( + f"apply failed ({exc}); rollback also failed ({rollback_error}) — " + f"backups for manual recovery: {backup_dir}" + ) from exc + raise ApplyError(f"apply failed and was rolled back: {exc}") from exc + + pruned = prune_backups(state_dir) + return { + "ok": True, + "dry_run": False, + "plan": plan_id, + "errors": [], + "applied": applied, + "skipped": skipped, + "backup": str(backup_dir), + "pruned_backups": pruned, + "finished_at": now_iso(), + } + + +def rollback(undo: List[Tuple[str, Dict[str, Any]]]) -> None: + for kind, payload in reversed(undo): + if kind == "move": + src = Path(payload["src"]) + dst = Path(payload["dst"]) + backup = Path(payload["backup"]) + if dst.exists(): + if dst.is_dir(): + shutil.rmtree(dst) + else: + dst.unlink() + if backup.is_dir(): + shutil.copytree(backup, src, dirs_exist_ok=True) + elif backup.exists(): + src.parent.mkdir(parents=True, exist_ok=True) + shutil.copy2(backup, src) + elif kind == "write": + path = Path(payload["path"]) + backup = Path(payload["backup"]) + if backup.exists(): + shutil.copy2(backup, path) + elif path.exists(): + path.unlink() + + +def init_home( + state_dir: Path, + yes: bool = False, + dry_run: bool = True, + home: Optional[Path] = None, + roots: Optional[List[Path]] = None, +) -> Dict[str, Any]: + operations = [ + {"kind": "mkdir", "path": str(state_dir)}, + {"kind": "mkdir", "path": str(state_dir / "plans")}, + {"kind": "mkdir", "path": str(state_dir / "backups")}, + ] + config_path = state_dir / "config.json" + if not config_path.exists(): + resolved_home = (home or Path.home()).expanduser().resolve() + if roots is None: + roots = default_roots(resolved_home) + if not roots: + raise ValueError( + f"no workspace roots detected under {resolved_home} " + "(looked for ~/Projects, ~/code, ~/dev, ~/src); " + "pass --root to declare where your projects live" + ) + config: Dict[str, Any] = { + "version": 1, + "roots": [str(root) for root in roots], + "scan_max_depth": 5, + } + operations.append( + { + "kind": "write", + "path": str(config_path), + "content": json.dumps( + config, + ensure_ascii=False, + indent=2, + ) + + "\n", + } + ) + plan = { + "version": 1, + "id": f"init-home-{now_iso().replace(':', '').replace('-', '')}-{unique_suffix()}", + "created_at": now_iso(), + "title": "Initialize Guster state home", + "notes": "Creates the local state directory and default config.", + "operations": operations, + } + return apply_plan(plan, state_dir, dry_run=dry_run, yes=yes) diff --git a/external_plugins/guster/src/guster/hub.py b/external_plugins/guster/src/guster/hub.py new file mode 100644 index 00000000..269e5562 --- /dev/null +++ b/external_plugins/guster/src/guster/hub.py @@ -0,0 +1,282 @@ +from __future__ import annotations + +import re +from pathlib import Path +from typing import Any, Dict, List, Optional + +from . import __version__ +from .executor import apply_plan +from .layout import DEFAULT_PATHS, load_manifest, resolve_hub_layout, validate_layout_value +from .planner import build_plan, op_mkdir, op_write, save_plan +from .util import is_indexed, load_json_strict, now_iso, read_text, save_json, today_iso, unique_suffix + + +def default_hub_path(home: Path) -> Path: + return home / "guster-hub" + + +def template_root() -> Path: + root = Path(__file__).resolve().parents[2] / "templates" / "hub" + if not root.is_dir(): + raise FileNotFoundError(f"lite hub template not found: {root}") + return root + + +def _version_tuple(value: str) -> tuple: + parts = [int(item) for item in re.findall(r"\d+", str(value))[:3]] + return tuple(parts + [0] * (3 - len(parts))) + + +def _render(text: str, replacements: Dict[str, str]) -> str: + for key, value in replacements.items(): + text = text.replace("{{" + key + "}}", value) + if "{{" in text: + raise ValueError("hub template still contains an unresolved placeholder") + return text + + +def _relative(path: Path, root: Path) -> str: + try: + return str(path.relative_to(root)) + except ValueError: + return str(path) + + +def plan_init_hub( + target: Path, + name: Optional[str] = None, + knowledge: str = DEFAULT_PATHS["knowledge"], + projects: str = DEFAULT_PATHS["projects"], + tools: str = DEFAULT_PATHS["tools"], +) -> Dict[str, Any]: + root = template_root() + hub = target.expanduser().resolve() + path_values = { + "knowledge": validate_layout_value(knowledge, "knowledge"), + "projects": validate_layout_value(projects, "projects"), + "tools": validate_layout_value(tools, "tools"), + } + layout = {key: (hub / value).resolve() for key, value in path_values.items()} + if len(set(layout.values())) != len(layout): + raise ValueError("hub paths must point to distinct directories") + replacements = { + "DATE": today_iso(), + "HUB_NAME": name or hub.name, + "PLUGIN_VERSION": __version__, + "KNOWLEDGE_PATH": path_values["knowledge"], + "PROJECTS_PATH": path_values["projects"], + "TOOLS_PATH": path_values["tools"], + } + operations: List[Dict[str, Any]] = [op_mkdir(hub)] + for path in layout.values(): + operations.append(op_mkdir(path)) + for path in sorted(root.rglob("*")): + if not path.is_file(): + continue + rel = path.relative_to(root) + if rel.parts[0] in layout: + output = layout[rel.parts[0]].joinpath(*rel.parts[1:]) + else: + output = hub / rel + if path.name == "gitignore.tmpl": + output = hub / rel.parent / ".gitignore" + elif path.suffix == ".tmpl": + output = output.with_suffix("") + content = ( + "" + if path.name == ".gitkeep" + else _render(path.read_text(encoding="utf-8"), replacements) + ) + operations.append(op_write(output, content)) + return build_plan( + f"Initialize Guster Hub {hub.name}", + operations, + notes=( + "Creates the lite data plane: knowledge, project state, tool index " + "and the hub contract." + ), + ) + + +def validate_hub(target: Path, strict: bool = True) -> Dict[str, Any]: + hub = target.expanduser().resolve() + errors: List[str] = [] + warnings: List[str] = [] + if not hub.is_dir(): + return { + "ok": False, + "hub": str(hub), + "manifest": {}, + "errors": [f"hub directory does not exist: {hub}"], + "warnings": [], + "plugin": __version__, + } + + manifest = load_manifest(hub / "hub.yaml") + try: + layout = resolve_hub_layout(hub) + except ValueError as exc: + layout = {key: (hub / value).resolve() for key, value in DEFAULT_PATHS.items()} + errors.append(f"invalid hub layout: {exc}") + + legacy = ( + not manifest + and (hub / "AGENTS.md").is_file() + and (hub / "knowledge").is_dir() + and (hub / "projects").is_dir() + ) + required_files = [hub / "AGENTS.md", hub / "README.md", hub / "hub.yaml"] + required_dirs = [] + if "knowledge" in layout: + required_files.append(layout["knowledge"] / "README.md") + required_dirs.extend( + [layout["knowledge"], layout["knowledge"] / "general", layout["knowledge"] / "projects"] + ) + if "projects" in layout: + required_files.append(layout["projects"] / "_registry.md") + required_dirs.append(layout["projects"]) + if "tools" in layout: + required_files.append(layout["tools"] / "README.md") + required_dirs.append(layout["tools"]) + for path in required_files: + if path.is_file(): + continue + rel = _relative(path, hub) + if legacy and not strict: + warnings.append(f"legacy hub lite contract file is absent: {rel}") + else: + errors.append(f"required file is absent: {rel}") + for path in required_dirs: + if path.is_dir(): + continue + rel = _relative(path, hub) + if legacy and not strict: + warnings.append(f"legacy hub lite contract directory is absent: {rel}") + else: + errors.append(f"required directory is absent: {rel}") + + if not manifest: + message = "hub.yaml is absent or empty" + if legacy and not strict: + warnings.append(message + " (legacy hub)") + elif (hub / "hub.yaml").is_file(): + errors.append(message) + else: + if manifest.get("schema_version") not in {"1", "2"}: + errors.append(f"unsupported hub schema: {manifest.get('schema_version') or '(absent)'}") + if manifest.get("profile") not in {"lite", "full"}: + warnings.append(f"unexpected hub profile: {manifest.get('profile') or '(absent)'}") + minimum = manifest.get("min_guster") + if minimum and _version_tuple(minimum) > _version_tuple(__version__): + errors.append(f"hub requires Guster >= {minimum}; installed CLI is {__version__}") + + agents = hub / "AGENTS.md" + if agents.is_file() and len(read_text(agents).splitlines()) > 50: + warnings.append("AGENTS.md exceeds the 50-line soft budget") + + if strict: + index_path = layout["knowledge"] / "README.md" + if index_path.is_file(): + index = read_text(index_path) + for folder in ("general", "projects"): + root = layout["knowledge"] / folder + if not root.is_dir(): + continue + for note in sorted(root.rglob("*.md")): + if note.name.lower() == "readme.md": + continue + if not is_indexed(note.name, index): + errors.append(f"knowledge note is not indexed: {_relative(note, hub)}") + + registry_path = layout["projects"] / "_registry.md" + if registry_path.is_file(): + registry = read_text(registry_path) + if not re.search( + r"(?:最后更新|更新时间|更新于|最近核实|最后核实|已核实|verified_at|(?i:last updated|updated))" + r"\s*\*{0,2}\s*[::]\s*\*{0,2}\s*\d{4}[-/]\d{1,2}[-/]\d{1,2}", + registry, + ): + errors.append(f"{_relative(registry_path, hub)} has no verified date") + + return { + "ok": not errors, + "hub": str(hub), + "manifest": manifest, + "paths": {key: _relative(value, hub) for key, value in layout.items()}, + "profile": manifest.get("profile") or ("legacy" if legacy else ""), + "errors": errors, + "warnings": warnings, + "plugin": __version__, + } + + +def attach_hub(state_dir: Path, target: Path) -> Dict[str, Any]: + info = validate_hub(target, strict=False) + if not info["ok"]: + raise ValueError("hub validation failed: " + "; ".join(info["errors"])) + hub = target.expanduser().resolve() + state_dir.mkdir(parents=True, exist_ok=True) + config_path = state_dir / "config.json" + data, error = load_json_strict(config_path) + if error is not None: + raise ValueError(f"cannot read Guster config {config_path}: {error}") + if data is None: + config: Dict[str, Any] = {} + elif not isinstance(data, dict): + raise ValueError(f"Guster config must be a JSON object: {config_path}") + else: + config = data + backup: Optional[Path] = None + if config_path.is_file(): + backup_dir = state_dir / "backups" + backup_dir.mkdir(parents=True, exist_ok=True) + stamp = re.sub(r"[^0-9A-Za-z]", "", now_iso()) + backup = backup_dir / f"hub-config-{stamp}-{unique_suffix()}.json" + backup.write_bytes(config_path.read_bytes()) + config.setdefault("version", 1) + config["hub"] = str(hub) + save_json(config_path, config) + return { + "ok": True, + "hub": str(hub), + "config": str(config_path), + "backup": str(backup) if backup else None, + } + + +def init_hub( + target: Path, + state_dir: Path, + yes: bool = False, + dry_run: bool = True, + name: Optional[str] = None, + knowledge: str = DEFAULT_PATHS["knowledge"], + projects: str = DEFAULT_PATHS["projects"], + tools: str = DEFAULT_PATHS["tools"], +) -> Dict[str, Any]: + hub = target.expanduser().resolve() + if hub.exists(): + if not hub.is_dir(): + raise ValueError(f"hub target is not a directory: {hub}") + if any(item.name != ".DS_Store" for item in hub.iterdir()): + raise ValueError(f"hub target is not empty: {hub}") + path_values = { + "knowledge": validate_layout_value(knowledge, "knowledge"), + "projects": validate_layout_value(projects, "projects"), + "tools": validate_layout_value(tools, "tools"), + } + plan = plan_init_hub( + hub, + name=name, + knowledge=path_values["knowledge"], + projects=path_values["projects"], + tools=path_values["tools"], + ) + plan_path = save_plan(state_dir, plan) + result = apply_plan(plan, state_dir, dry_run=dry_run, yes=yes) + result["hub"] = str(hub) + result["plan"] = str(plan_path) + result["paths"] = path_values + if result.get("ok") and not dry_run: + result["attach"] = attach_hub(state_dir, hub) + return result diff --git a/external_plugins/guster/src/guster/layout.py b/external_plugins/guster/src/guster/layout.py new file mode 100644 index 00000000..e9380a2a --- /dev/null +++ b/external_plugins/guster/src/guster/layout.py @@ -0,0 +1,148 @@ +from __future__ import annotations + +from pathlib import Path +from typing import Any, Dict, List, Optional + +from .util import read_text + + +DEFAULT_PATHS = { + "knowledge": "knowledge", + "projects": "projects", + "tools": "tools", +} +# Schema 2 hubs declare what they have: only these two sections are mandatory, +# every other one (tools, ...) is optional and may live outside the hub. +HUB_CORE_SECTIONS = ("knowledge", "projects") + + +def load_manifest(path: Path) -> Dict[str, Any]: + """Parse the small flat YAML subset used by hub.yaml, including one paths map.""" + data: Dict[str, Any] = {} + current: Optional[str] = None + for raw_line in read_text(path).splitlines(): + if not raw_line.strip() or raw_line.lstrip().startswith("#"): + continue + indent = len(raw_line) - len(raw_line.lstrip(" ")) + line = raw_line.strip() + if ":" not in line: + continue + key, value = line.split(":", 1) + key = key.strip() + value = value.strip().strip("'\"") + if indent == 0: + current = key if key == "paths" and not value else None + if current: + data.setdefault("paths", {}) + else: + data[key] = value + elif current == "paths": + data.setdefault("paths", {})[key] = value + return data + + +def validate_layout_value(value: str, key: str) -> str: + raw = str(value).strip() + if not raw: + raise ValueError(f"hub path '{key}' is empty") + if raw.startswith("~"): + raise ValueError(f"hub path '{key}' must be relative to the hub") + path = Path(raw) + if path.is_absolute(): + raise ValueError(f"hub path '{key}' must be relative to the hub") + if ".." in path.parts: + raise ValueError(f"hub path '{key}' must not contain '..'") + if raw in {".", "./"}: + raise ValueError(f"hub path '{key}' must not be the hub root") + return str(path) + + +def is_external_layout_value(raw: str) -> bool: + text = str(raw).strip() + return text.startswith("~") or Path(text).is_absolute() + + +def resolve_layout_entry(raw: str, key: str, hub_root: Path) -> Path: + """One declared section: relative stays inside the hub, absolute/~/ is external. + + External sections describe a world where the directory does not belong to + the hub; the declaration still has to name a real directory, which the + caller checks, but it is not confined by the hub boundary. + """ + text = str(raw).strip() + if not text: + raise ValueError(f"hub path '{key}' is empty") + if is_external_layout_value(text): + return Path(text).expanduser().resolve() + value = validate_layout_value(text, key) + candidate = (hub_root / value).resolve() + if candidate == hub_root or hub_root not in candidate.parents: + raise ValueError(f"hub path '{key}' escapes the hub: {value}") + return candidate + + +def resolve_hub_layout(hub: Path) -> Dict[str, Path]: + root = hub.expanduser().resolve() + manifest = load_manifest(root / "hub.yaml") + raw_paths = manifest.get("paths") + paths = raw_paths if isinstance(raw_paths, dict) else {} + resolved: Dict[str, Path] = {} + if str(manifest.get("schema_version", "1")) == "2": + for key in HUB_CORE_SECTIONS: + if key not in paths: + raise ValueError(f"hub schema 2 must declare the '{key}' section") + for key, raw in paths.items(): + resolved[key] = resolve_layout_entry(str(raw), key, root) + else: + for key, default in DEFAULT_PATHS.items(): + resolved[key] = resolve_layout_entry(str(paths.get(key, default)), key, root) + if len(set(resolved.values())) != len(resolved): + raise ValueError("hub paths must point to distinct directories") + return resolved + + +def load_waivers(hub: Optional[Path]) -> List[Dict[str, str]]: + """Read `doctor.waivers` from `/hub.yaml`. + + Waivers are the only way to silence a finding, so each entry must carry a + rule and a written reason; a broken block fails loud instead of guessing. + """ + if hub is None: + return [] + manifest = Path(hub) / "hub.yaml" + if not manifest.is_file(): + return [] + waivers: List[Dict[str, str]] = [] + current: Optional[Dict[str, str]] = None + in_block = False + for raw_line in read_text(manifest).splitlines(): + if not raw_line.strip() or raw_line.lstrip().startswith("#"): + continue + indent = len(raw_line) - len(raw_line.lstrip(" ")) + line = raw_line.strip() + if line.endswith("waivers:"): + in_block = True + current = None + continue + if not in_block: + continue + if indent == 0: + break + if line.startswith("- "): + current = {} + waivers.append(current) + line = line[2:].strip() + if current is None or ":" not in line: + continue + key, value = line.split(":", 1) + current[key.strip()] = value.strip().strip("'\"") + for entry in waivers: + rule = entry.get("rule", "").strip() + reason = entry.get("reason", "").strip() + if not rule or not reason: + raise ValueError(f"doctor waiver needs rule and reason in {manifest}") + entry["path"] = entry.get("path", "").strip() + return [ + {"rule": entry["rule"].strip(), "path": entry["path"], "reason": entry["reason"].strip()} + for entry in waivers + ] diff --git a/external_plugins/guster/src/guster/metrics.py b/external_plugins/guster/src/guster/metrics.py new file mode 100644 index 00000000..a4c09aea --- /dev/null +++ b/external_plugins/guster/src/guster/metrics.py @@ -0,0 +1,199 @@ +from __future__ import annotations + +from typing import Any, Dict, List, Optional, Sequence + +from .util import now_iso + + +CHI_WEIGHTS = { + "ssr": 0.20, + "rbr": 0.15, + "pcr": 0.15, + "icr": 0.15, + "frs": 0.15, + "phr": 0.10, + "sir": 0.10, +} +SCOPE_DIMS = { + "machine": ["ssr", "rbr", "pcr", "icr", "frs", "phr", "sir"], + "project": ["ssr", "pcr", "icr", "frs", "phr"], + "group": ["ssr", "pcr", "icr", "frs", "phr"], + "hub": ["ssr", "icr", "frs", "phr"], +} +RBR_BUDGET_BYTES = 20_000 +RBR_BUDGET_SKILL_CHARS = 6_000 +GCR_TARGET = 0.5 + + +def dimensions_for_scope(scope: str) -> List[str]: + """Dimensions that enter CHI for a scope; the report must show exactly these.""" + return list(SCOPE_DIMS.get(scope) or SCOPE_DIMS["machine"]) + + +def safe_ratio(numerator: float, denominator: float) -> Optional[float]: + """A ratio, or None when the denominator is empty. + + An empty denominator means the run has no evidence, not a perfect score; a + default of 1.0 would let an unmeasured scope outrank a measured one. + """ + if denominator <= 0: + return None + return max(0.0, min(1.0, numerator / denominator)) + + +def mean_available(values: Sequence[Optional[float]]) -> Optional[float]: + present = [value for value in values if value is not None] + if not present: + return None + return sum(present) / len(present) + + +def percent(value: Optional[float]) -> Optional[float]: + return None if value is None else round(value * 100, 1) + + +def compute_metrics(registry: Dict[str, Any], policy_result: Dict[str, Any]) -> Dict[str, Any]: + stats = policy_result.get("stats", {}) + governance_count = int(stats.get("governance_docs", 0)) + + topic_data = registry.get("topics") or {} + topic_total = int(topic_data.get("total", 0)) + topic_multi = int(topic_data.get("multi", 0)) + ssr = safe_ratio(topic_total - topic_multi, topic_total) + + resident_bytes = max(0, int(stats.get("resident_bytes", 0))) + skill_chars = max(0, int(stats.get("skill_chars", 0))) + resident_ratio = resident_bytes / RBR_BUDGET_BYTES if resident_bytes > 0 else None + skill_ratio = skill_chars / RBR_BUDGET_SKILL_CHARS if skill_chars > 0 else None + resident_score = None if resident_ratio is None else min(1.0, 1.0 / resident_ratio) + skill_score = None if skill_ratio is None else min(1.0, 1.0 / skill_ratio) + rbr = mean_available([resident_ratio, skill_ratio]) + rbr_score = mean_available([resident_score, skill_score]) + + pcr = safe_ratio( + int(stats.get("agents_dirs_compliant", 0)), + int(stats.get("agents_dirs_total", 0)), + ) + knowledge_icr = safe_ratio( + int(stats.get("knowledge_indexed", 0)), + int(stats.get("knowledge_total", 0)), + ) + agents_icr = safe_ratio( + int(stats.get("agents_indexed", 0)), + int(stats.get("agents_dirs_total", 0)), + ) + icr = mean_available([knowledge_icr, agents_icr]) + frs = safe_ratio( + int(stats.get("state_docs_fresh", 0)), + int(stats.get("state_docs_total", 0)), + ) + phr = safe_ratio( + int(stats.get("pointers_valid", 0)), + int(stats.get("pointers_checked", 0)), + ) + inline_bearers = int(stats.get("inline_bearers", 0)) + undeclared = int( + stats.get("secret_undeclared_outside", stats.get("secret_outside_root", 0)) + ) + secret_bad = ( + undeclared + + inline_bearers + + int(stats.get("secret_in_git", 0)) + + int(stats.get("secret_tracking_unknown", 0)) + ) + secret_total = int(stats.get("secret_total", 0)) + inline_bearers + sir = None if secret_total <= 0 else 1.0 - min(1.0, secret_bad / secret_total) + gcr = governance_count / 8.0 if governance_count else 0.0 + gcr_score = 1.0 if gcr == 0 else min(1.0, GCR_TARGET / max(gcr, 0.01)) + + dim_values: Dict[str, Optional[float]] = { + "ssr": ssr, + "rbr": rbr_score, + "pcr": pcr, + "icr": icr, + "frs": frs, + "phr": phr, + "sir": sir, + } + raw_values: Dict[str, Optional[float]] = { + "ssr": ssr, + "rbr": rbr, + "pcr": pcr, + "icr": icr, + "frs": frs, + "phr": phr, + "sir": sir, + } + scope = registry.get("scope", "machine") + scope_dims = dimensions_for_scope(scope) + scored_dims = [dim for dim in scope_dims if dim_values[dim] is not None] + if scored_dims: + total_weight = sum(CHI_WEIGHTS[dim] for dim in scored_dims) + chi = sum(CHI_WEIGHTS[dim] * dim_values[dim] for dim in scored_dims) / total_weight + else: + chi = None + + metrics: Dict[str, Optional[float]] = { + dim: (None if value is None else round(value, 4)) for dim, value in raw_values.items() + } + metrics["gcr"] = round(gcr, 4) + scores: Dict[str, Optional[float]] = {dim: percent(value) for dim, value in dim_values.items()} + scores["gcr"] = round(gcr_score * 100, 1) + + return { + "generated_at": now_iso(), + "metrics": metrics, + "scores": scores, + "chi": None if chi is None else round(chi * 100, 1), + "scope": scope, + "dims": scope_dims, + "scored_dims": scored_dims, + "unscored_dims": [dim for dim in scope_dims if dim not in scored_dims], + "raw": { + "resident_bytes": resident_bytes, + "resident_lines": int(stats.get("resident_lines", 0)), + "resident_entries": int(stats.get("resident_entries", 0)), + "skill_chars": skill_chars, + "topics_total": topic_total, + "topics_multi": topic_multi, + "knowledge_unhashed": int(topic_data.get("unhashed", 0)), + "agents_dirs_total": int(stats.get("agents_dirs_total", 0)), + "agents_dirs_compliant": int(stats.get("agents_dirs_compliant", 0)), + "agents_dirs_missing_index": int(stats.get("agents_dirs_missing_index", 0)), + "agents_dirs_missing_slots": int(stats.get("agents_dirs_missing_slots", 0)), + "agents_dirs_extra_entries": int(stats.get("agents_dirs_extra_entries", 0)), + "agents_indexed": int(stats.get("agents_indexed", 0)), + "knowledge_total": int(stats.get("knowledge_total", 0)), + "knowledge_indexed": int(stats.get("knowledge_indexed", 0)), + "state_docs_total": int(stats.get("state_docs_total", 0)), + "state_docs_fresh": int(stats.get("state_docs_fresh", 0)), + "state_docs_fresh_declared": int(stats.get("state_docs_fresh_declared", 0)), + "state_docs_fresh_from_git": int(stats.get("state_docs_fresh_from_git", 0)), + "state_docs_fresh_from_mtime": int(stats.get("state_docs_fresh_from_mtime", 0)), + "pointers_checked": int(stats.get("pointers_checked", 0)), + "pointers_valid": int(stats.get("pointers_valid", 0)), + "broken_pointers": int(stats.get("broken_pointers", 0)), + "naked_pointers": int(stats.get("naked_pointers", 0)), + "pointer_files_total": int(stats.get("pointer_files_total", 0)), + "pointer_files_scanned": int(stats.get("pointer_files_scanned", 0)), + "secret_total": int(stats.get("secret_total", 0)), + "secret_outside_root": int(stats.get("secret_outside_root", 0)), + "secret_undeclared_outside": undeclared, + "secret_tracking_unknown": int(stats.get("secret_tracking_unknown", 0)), + "secret_in_git": int(stats.get("secret_in_git", 0)), + "inline_bearers": inline_bearers, + "git_probe_failures": int(stats.get("git_probe_failures", 0)), + "scan_walk_errors": int(stats.get("scan_walk_errors", 0)), + "governance_docs": governance_count, + }, + } + + +def metric_line(result: Dict[str, Any]) -> str: + chi = result.get("chi") + parts = [f"CHI {'n/a' if chi is None else chi} ({result.get('scope')})"] + scores = result.get("scores") or {} + for dim in result.get("dims") or []: + value = scores.get(dim) + parts.append(f"{dim.upper()} {'n/a' if value is None else value}") + return " | ".join(parts) diff --git a/external_plugins/guster/src/guster/planner.py b/external_plugins/guster/src/guster/planner.py new file mode 100644 index 00000000..494b0e74 --- /dev/null +++ b/external_plugins/guster/src/guster/planner.py @@ -0,0 +1,191 @@ +from __future__ import annotations + +import json +from pathlib import Path +from typing import Any, Dict, List, Optional, Sequence + +from .util import now_iso, save_json, slugify, today_iso, unique_suffix + + +PLAN_SCHEMA_HINT = ( + '{"version": 1, "operations": [{"kind": "mkdir", "path": "..."}, ' + '{"kind": "move", "src": "...", "dst": "..."}, ' + '{"kind": "write", "path": "...", "content": "..."}, ' + '{"kind": "manual", "path": "...", "action": "...", "reason": "..."}]}' +) + + +def new_plan_id(title: str) -> str: + stamp = now_iso().replace(":", "").replace("-", "").replace("+", "p") + return f"{stamp}-{slugify(title)[:40]}-{unique_suffix()}" + + +def build_plan(title: str, operations: Sequence[Dict[str, Any]], notes: Optional[str] = None) -> Dict[str, Any]: + plan_id = new_plan_id(title) + return { + "version": 1, + "id": plan_id, + "created_at": now_iso(), + "title": title, + "notes": notes or "", + "operations": list(operations), + } + + +def op_mkdir(path: Path) -> Dict[str, Any]: + return {"kind": "mkdir", "path": str(path)} + + +def op_move( + src: Path, + dst: Path, + pointer: Optional[Dict[str, str]] = None, +) -> Dict[str, Any]: + return { + "kind": "move", + "src": str(src), + "dst": str(dst), + "pointer": pointer or None, + } + + +def op_write(path: Path, content: str) -> Dict[str, Any]: + return {"kind": "write", "path": str(path), "content": content} + + +def op_manual(path: str, action: str, reason: str) -> Dict[str, Any]: + return {"kind": "manual", "path": path, "action": action, "reason": reason} + + +def plan_move(src: Path, dst: Path) -> Dict[str, Any]: + if not src.exists(): + raise FileNotFoundError(f"source does not exist: {src}") + if dst.exists(): + raise FileExistsError(f"destination already exists: {dst}") + operations = [ + op_mkdir(dst.parent), + op_move( + src, + dst, + pointer={ + "path": str(src.parent / f"{src.name}.moved.md"), + "content": ( + f"# Moved\n\nThis path moved to `{dst}`.\n\n" + f"verified_at: {today_iso()}\n" + ), + }, + ), + ] + return build_plan( + f"Move {src.name} to {dst.name}", + operations, + notes="Dry-run by default. Apply creates a backup and keeps a pointer at the old location.", + ) + + +def plan_init_project(project_root: Path) -> Dict[str, Any]: + root = project_root.resolve() + agents = root / ".agents" + operations: List[Dict[str, Any]] = [] + for slot in ("plans", "wiki", "evidence", "skills", "tmp", "archive"): + operations.append(op_mkdir(agents / slot)) + readme = agents / "README.md" + if not readme.exists(): + operations.append( + op_write( + readme, + "# Project Agent Context\n\n" + "| Area | Path | Purpose |\n" + "|---|---|---|\n" + "| Plans | `plans/` | Active plans, PRDs and checklists |\n" + "| Wiki | `wiki/` | Stable project knowledge |\n" + "| Evidence | `evidence/` | Screenshots, videos, test output, acceptance proof |\n" + "| Skills | `skills/` | Project-local skills |\n" + "| Tmp | `tmp/` | Scratch, 14-day TTL |\n" + "| Archive | `archive/` | Superseded plans and evidence |\n", + ) + ) + agents_md = root / "AGENTS.md" + if not agents_md.exists(): + operations.append( + op_write( + agents_md, + "# Project Instructions\n\n" + "## Scope\n\n" + "This project uses Guster's standard `.agents/` layout. " + "Put active plans in `.agents/plans/`, durable project knowledge in `.agents/wiki/`, " + "evidence in `.agents/evidence/`, and scratch files in `.agents/tmp/`.\n\n" + "## Boundaries\n\n" + "- Code and tests are the source of truth for behavior.\n" + "- Do not put credentials in this repository.\n" + "- Do not commit `.agents/` unless the repository explicitly chooses to share it.\n\n" + "## Context format\n\n" + "File paths in this file and `.agents/README.md` are markdown links or inline code, " + "never naked in prose, so `guster doctor` can verify them (CTX-03).\n", + ) + ) + return build_plan( + f"Initialize {root.name}", + operations, + notes="Creates the standard .agents layout, README index and a minimal AGENTS.md if absent.", + ) + + +def plan_from_findings(findings: Sequence[Dict[str, Any]]) -> Dict[str, Any]: + operations: List[Dict[str, Any]] = [] + for item in findings: + if item.get("severity") in {"critical", "high", "medium"}: + if item.get("rule") == "misplaced-artifact": + suggested = (item.get("evidence") or {}).get("suggested") or {} + for entry, slot in suggested.items(): + operations.append( + op_manual( + f"{item.get('path', '')}/.agents/{entry}", + f"Move under .agents/{slot}/ after updating any references", + f"misplaced-artifact: {entry} does not match a standard slot", + ) + ) + continue + operations.append( + op_manual( + item.get("path", ""), + item.get("suggestion", ""), + f"{item.get('rule')}: {item.get('message')}", + ) + ) + return build_plan( + "Review context findings", + operations, + notes="This plan is a review checklist. It contains no automatic writes.", + ) + + +def save_plan(state_dir: Path, plan: Dict[str, Any]) -> Path: + path = state_dir / "plans" / f"{plan['id']}.json" + save_json(path, plan) + return path + + +def load_plan(path: Path) -> Dict[str, Any]: + try: + raw = path.read_text(encoding="utf-8") + except OSError as exc: + raise ValueError(f"cannot read plan {path}: {exc}") from exc + try: + data = json.loads(raw) + except ValueError as exc: + raise ValueError(f"invalid plan JSON {path}: {exc}") from exc + if not isinstance(data, dict): + raise ValueError(f"plan must be a JSON object: {path}") + version = data.get("version") + if isinstance(version, bool) or not isinstance(version, int) or version != 1: + raise ValueError( + f"unsupported plan version: {version!r} (expected the integer 1); " + f"a plan is shaped {PLAN_SCHEMA_HINT}" + ) + if not isinstance(data.get("operations"), list): + raise ValueError( + "plan has no operations list; expected an 'operations' array of operation " + f"objects with a 'kind' of mkdir/move/write/manual, e.g. {PLAN_SCHEMA_HINT}" + ) + return data diff --git a/external_plugins/guster/src/guster/policy.py b/external_plugins/guster/src/guster/policy.py new file mode 100644 index 00000000..f98c81e1 --- /dev/null +++ b/external_plugins/guster/src/guster/policy.py @@ -0,0 +1,1050 @@ +from __future__ import annotations + +import glob +import os +import re +from datetime import datetime, timezone +from pathlib import Path +from typing import Any, Dict, List, Optional, Sequence, Set, Tuple + +from .discover import ScanConfig, STANDARD_AGENTS_SLOTS, in_scope_path, scope_roots +from .layout import load_waivers, resolve_hub_layout +from .util import ( + NOTE_DATE_KEYS, + age_days, + extract_naked_pointers, + extract_pointers, + git_last_commit_dates, + load_json, + note_header_date, + parse_date, + parse_note_header, + read_text, + relative, + resolve_pointer, +) + + +SEVERITY_ORDER = {"critical": 0, "high": 1, "medium": 2, "low": 3, "info": 4} +COMMON_KNOWLEDGE_NAMES = {"readme.md", "agents.md", "index.md", "skill.md"} +MEDIA_SUFFIXES = {".png", ".jpg", ".jpeg", ".gif", ".webp", ".mp4", ".mov", ".wav", ".mp3"} +RESIDENT_ENTRIES = ( + (".zcode", "AGENTS.md"), + (".dsh", "AGENTS.md"), + (".codex", "AGENTS.md"), + (".claude", "CLAUDE.md"), +) +DATE_HEADER_LINES = 40 +VERIFIED_DATE_KEYS = r"(?:最后更新|更新时间|更新于|最近核实|最后核实|已核实|verified_at|(?i:last updated|updated))" +FRESH_SOURCE_STATS = { + "declared": "state_docs_fresh_declared", + "git": "state_docs_fresh_from_git", + "mtime": "state_docs_fresh_from_mtime", +} + + +def resident_entries(home: Path) -> List[Path]: + """Host entry files that exist, deduped by real path (hosts often symlink one file).""" + seen: Set[str] = set() + entries: List[Path] = [] + for folder, name in RESIDENT_ENTRIES: + path = home / folder / name + if not path.is_file(): + continue + try: + real = str(path.resolve()) + except OSError: + continue + if real in seen: + continue + seen.add(real) + entries.append(path) + return entries + + +def finding( + rule: str, + severity: str, + title: str, + path: str, + message: str, + suggestion: str, + evidence: Optional[Dict[str, Any]] = None, +) -> Dict[str, Any]: + return { + "rule": rule, + "severity": severity, + "title": title, + "path": path, + "message": message, + "suggestion": suggestion, + "evidence": evidence or {}, + } + + +def suggest_slot(name: str, is_dir: bool) -> str: + """Guess the standard slot an unplaced top-level entry belongs to.""" + lowered = name.lower() + if is_dir: + if lowered in {"skills", "tools", "scripts"}: + return "skills" + if lowered in {"wiki", "knowledge"}: + return "wiki" + if any( + key in lowered + for key in ( + "shot", "screenshot", "截图", "review", "evidence", "audit", + "verify", "verification", "acceptance", "visual", "frame", + "panorama", "photo", + ) + ): + return "evidence" + if any(key in lowered for key in ("scratch", "tmp", "backup", "bak", "cache")): + return "archive" + return "plans" + suffix = Path(name).suffix.lower() + if suffix in MEDIA_SUFFIXES or suffix in {".pdf", ".xlsx"}: + return "evidence" + if suffix in {".py", ".sh", ".mjs"}: + return "skills" + if suffix in {".json", ".log", ".txt", ".bak", ".tsv", ".html"}: + return "tmp" + return "plans" + + +REGISTRY_PATH_COLUMN = re.compile(r"path|路径", re.IGNORECASE) +REGISTRY_ROW_SKIP = {"", "-", "—", ".", ".."} +# `host:/path` (and URLs) reference another machine; a local three-way diff +# can never see them, so they are counted apart instead of drifting forever. +REGISTRY_REMOTE_FORM = re.compile(r"^[A-Za-z][A-Za-z0-9+.-]*:") + + +def parse_registry_rows(text: str) -> List[Dict[str, str]]: + """CTX-10: the hub's human project table, read through its path column. + + The column whose header mentions "path"/"路径" holds one location per row + (`~/...`, absolute, or relative to the hub root); the slug column never + counts as a path.""" + rows: List[Dict[str, str]] = [] + path_index: Optional[int] = None + for line in text.splitlines(): + stripped = line.strip() + if not stripped.startswith("|"): + continue + cells = [cell.strip().strip("`").rstrip("/") for cell in stripped.strip("|").split("|")] + if not cells: + continue + if path_index is None: + for index, cell in enumerate(cells): + if REGISTRY_PATH_COLUMN.search(cell): + path_index = index + break + continue + if cells[0] in {"ID", "slug", ""} or set(cells[0]) <= {"-", ":"}: + continue + raw = cells[path_index] if path_index < len(cells) else "" + if raw in REGISTRY_ROW_SKIP: + continue + rows.append({"slug": cells[0], "path": raw}) + return rows + + +def resolve_registry_row_path(raw: str, hub_root: Path, home: Path) -> Optional[Path]: + """A registry row path resolves against the hub root, `~` or an absolute.""" + value = raw.strip().rstrip("/") + if not value: + return None + if value.startswith("~"): + return home / value[2:] + candidate = Path(value) + if candidate.is_absolute(): + return candidate + return (hub_root / candidate).resolve() + + +def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: + findings: List[Dict[str, Any]] = [] + stats: Dict[str, Any] = { + "pointers_checked": 0, + "pointers_valid": 0, + "broken_pointers": 0, + "naked_pointers": 0, + "agents_dirs_total": 0, + "agents_dirs_compliant": 0, + "agents_dirs_missing_index": 0, + "agents_dirs_missing_slots": 0, + "agents_dirs_extra_entries": 0, + "knowledge_total": 0, + "knowledge_indexed": 0, + "agents_index_total": 0, + "agents_indexed": 0, + "state_docs_total": 0, + "state_docs_fresh": 0, + "state_docs_fresh_declared": 0, + "state_docs_fresh_from_git": 0, + "state_docs_fresh_from_mtime": 0, + "duplicate_knowledge": 0, + "note_headers_total": 0, + "governance_docs": len(registry.get("governance_docs", [])), + "misplaced_entries": 0, + "resident_entries": 0, + "secret_total": 0, + "secret_outside_root": 0, + "secret_in_git": 0, + "secret_tracking_unknown": 0, + "secret_undeclared_outside": 0, + "pointer_files_total": 0, + "pointer_files_scanned": 0, + "git_probe_failures": 0, + "inline_bearers": 0, + "registry_rows": 0, + "registry_rows_remote": 0, + "registry_drift_dead_rows": 0, + "registry_drift_unscanned_rows": 0, + "registry_drift_unregistered": 0, + "registry_drift_stale_machine": 0, + "scan_walk_errors": int((registry.get("scan_errors") or {}).get("count") or 0), + } + home = config.home + hub = config.hub + scope = getattr(config, "scope", "machine") + hub_layout = resolve_hub_layout(hub) if hub else {} + artifacts = registry.get("artifacts", []) + projects = registry.get("projects", []) + git_failures: List[str] = [ + str(project.get("path") or project.get("id")) + for project in projects + if project.get("git_state") == "error" + ] + skills = registry.get("skills", []) + + # Resident budget: every host entry file that exists, counted once. + user_agents = resident_entries(home) if scope != "hub" else [] + hub_agents = (hub / "AGENTS.md") if hub and (hub / "AGENTS.md").is_file() else None + resident_bytes = sum(file_size(path) for path in user_agents) + ( + file_size(hub_agents) if hub_agents else 0 + ) + resident_lines = sum(count_lines(path) for path in user_agents) + ( + count_lines(hub_agents) if hub_agents else 0 + ) + stats["resident_bytes"] = resident_bytes + stats["resident_lines"] = resident_lines + stats["resident_entries"] = len(user_agents) + if resident_bytes > 20_000: + findings.append( + finding( + "resident-budget", + "medium", + "Resident context exceeds 20 KB", + str(user_agents[0] if user_agents else (hub_agents or "")), + f"User + hub resident instruction is {resident_bytes} bytes / {resident_lines} lines.", + "Move procedures, examples and state tables into knowledge or skills; keep only rules and pointers.", + {"bytes": resident_bytes, "lines": resident_lines, "target_bytes": 20_000}, + ) + ) + for path in user_agents: + lines = count_lines(path) + if lines > 150: + findings.append( + finding( + "resident-budget", + "medium", + "User-level instruction exceeds soft line budget", + str(path), + f"{lines} lines; soft target is 150.", + "Demote long procedures and examples.", + ) + ) + if hub_agents and count_lines(hub_agents) > 50: + findings.append( + finding( + "resident-budget", + "medium", + "Hub instruction exceeds soft line budget", + str(hub_agents), + f"{count_lines(hub_agents)} lines; soft target is 50.", + "Move detail into a knowledge reference doc under knowledge/general/.", + ) + ) + + if scope != "hub": + # Skill metadata budget + total_skill_chars = sum(int(skill.get("description_chars", 0)) for skill in skills) + stats["skill_chars"] = total_skill_chars + for skill in skills: + chars = int(skill.get("description_chars", 0)) + if chars <= 500: + continue + findings.append( + finding( + "skill-budget", + "high", + "Skill description exceeds per-item budget", + skill.get("root", ""), + f"{skill.get('name')} description is {chars} chars; limit is 500.", + "Shorten the description to trigger conditions only; move detail into SKILL.md body.", + {"skill": skill.get("name"), "chars": chars}, + ) + ) + if total_skill_chars > 6_000: + findings.append( + finding( + "skill-budget", + "high", + "Skill metadata exceeds total budget", + str(home / ".agents" / "skills"), + f"Unique skill descriptions total {total_skill_chars} chars; budget is 6,000.", + "Trim the longest descriptions first; keep each description to one clear trigger sentence.", + {"chars": total_skill_chars, "target": 6_000}, + ) + ) + + # Skill copy drift + for skill in skills: + copies = skill.get("copies", []) + hashes = {copy.get("hash") for copy in copies if copy.get("hash")} + if len(copies) > 1 and len(hashes) > 1: + findings.append( + finding( + "skill-copy-drift", + "high", + "Skill copies drifted", + skill.get("root", ""), + f"{skill.get('name')} has {len(hashes)} different copies.", + "Make copies byte-identical or replace the copy strategy with symlinks where the host supports it.", + {"copies": copies}, + ) + ) + + # Knowledge index coverage and duplicates + knowledge = [item for item in artifacts if item.get("kind") == "knowledge"] + stats["knowledge_total"] = len(knowledge) + orphan_groups: Dict[str, List[Dict[str, Any]]] = {} + for item in knowledge: + if item.get("indexed") is True: + stats["knowledge_indexed"] += 1 + elif item.get("indexed") is False: + if Path(item["path"]).name.lower() in COMMON_KNOWLEDGE_NAMES: + # An index does not index itself. + continue + orphan_groups.setdefault(item.get("scope", "unknown"), []).append(item) + + for scope, items in orphan_groups.items(): + severity = "medium" if scope in {"general", "project", "workgroup"} else "low" + examples = [relative(Path(item["path"]), Path(item["path"]).parent) for item in items[:10]] + findings.append( + finding( + "orphan-knowledge", + severity, + "Knowledge files are not indexed", + str(items[0]["path"]), + f"{len(items)} knowledge file(s) in scope '{scope}' are absent from the relevant README index.", + "Add each file to its README index, or merge/delete it if obsolete.", + {"count": len(items), "examples": examples}, + ) + ) + + multi_topics = (registry.get("topics") or {}).get("multi_topics") or [] + stats["duplicate_knowledge"] = len(multi_topics) + if multi_topics: + examples = [path for topic in multi_topics[:4] for path in topic.get("paths", [])[:2]] + reasons = sorted({str(topic.get("reason")) for topic in multi_topics}) + findings.append( + finding( + "duplicate-canonical", + "medium", + "The same fact has more than one home", + examples[0] if examples else "", + f"{len(multi_topics)} topic(s) have more than one source ({', '.join(reasons)}).", + "Pick one canonical home and replace the others with pointers; keep a copy only when it is generated and verified.", + { + "count": len(multi_topics), + "topics": [topic.get("key") for topic in multi_topics[:10]], + "examples": examples[:10], + }, + ) + ) + + # Structured note headers (CTX-09). Opt-in: only notes whose front-matter + # declares a ``type:`` are checked, so legacy prose notes never fire. The + # format follows the Obsidian properties convention (see reference/spec.md); + # truth pointers live in the body as CTX-03 links, not in the header. + structured_notes: List[Dict[str, Any]] = [] + for item in knowledge: + if Path(item["path"]).suffix.lower() != ".md": + continue + text = read_text(Path(item["path"]), limit=200_000) + header = parse_note_header(text) + if header is None: + continue + stats["note_headers_total"] += 1 + structured_notes.append(item) + problems: List[str] = [] + if header.get("_malformed"): + problems.append( + f"front-matter cannot be parsed (line {header.get('line')}: " + f"{header.get('text')})" + ) + else: + if not note_header_date(header): + problems.append( + "no machine-readable date (one of " + f"{', '.join(NOTE_DATE_KEYS)} as YYYY-MM-DD)" + ) + if problems: + findings.append( + finding( + "note-header-malformed", + "medium", + "Structured note header is not well-formed", + item["path"], + "; ".join(problems) + ".", + "Fix the front-matter (Obsidian properties convention: type + a " + "date key), or drop the type key to make it a plain note.", + {"problems": problems}, + ) + ) + + # Project .agents layout + for project in projects: + if not project.get("agents_dir"): + continue + if project.get("container"): + # A workspace/group root keeps container-level context; judging it as + # a project would score scaffolding the group never needed. + continue + stats["agents_dirs_total"] += 1 + if project.get("has_index"): + stats["agents_indexed"] += 1 + unknown = [ + entry + for entry in project.get("agents_entries", []) + if entry not in STANDARD_AGENTS_SLOTS and entry not in {"README.md", "AGENTS.md"} + ] + slots_ok = set(STANDARD_AGENTS_SLOTS).issubset(set(project.get("standard_slots", []))) + if project.get("has_index") and slots_ok and not unknown: + stats["agents_dirs_compliant"] += 1 + elif not project.get("has_index"): + stats["agents_dirs_missing_index"] += 1 + elif not slots_ok: + stats["agents_dirs_missing_slots"] += 1 + else: + stats["agents_dirs_extra_entries"] += 1 + if unknown: + stats["misplaced_entries"] += len(unknown) + agents_root = Path(project.get("agents_dir") or "") + suggested = { + entry: suggest_slot(entry, (agents_root / entry).is_dir()) + for entry in unknown + } + findings.append( + finding( + "misplaced-artifact", + "medium", + "Project .agents has task-shaped top-level entries", + project["path"], + f"{len(unknown)} top-level entr{'y' if len(unknown) == 1 else 'ies'} do not match the standard slots.", + "Move task bundles under evidence/, plans/, wiki/ or archive/, then add a README index.", + {"entries": unknown[:100], "suggested": suggested}, + ) + ) + + # State freshness. Plans are state-plane documents too, even though their + # kind is "plan"; select on the plane so project/group scopes are not + # vacuously fresh. The date ladder is declared (verified_at / updated / + # 最后更新 / filename date) → owning repository's git date → file mtime, + # each tier reported as its own freshness source. + state_prefixes = ["handoff/", "provision/", ".agents/plans/"] + if hub_layout: + state_prefixes.append(relative(hub_layout["projects"], hub).rstrip("/") + "/") + state_docs = [ + item + for item in artifacts + if item.get("plane") == "state" + and any(item.get("rel", "").startswith(prefix) for prefix in state_prefixes) + ] + stats["state_docs_total"] = len(state_docs) + commit_dates = git_last_commit_dates(hub) if hub else {} + if commit_dates is None: + if str(hub) not in git_failures: + git_failures.append(str(hub)) + commit_dates = {} + project_roots = {str(project["id"]): Path(project["path"]) for project in projects} + project_commit_dates: Dict[str, Dict[str, str]] = {} + stale_missing: List[str] = [] + stale_old: List[Tuple[str, str]] = [] + for item in state_docs: + path = Path(item["path"]) + text = read_text(path, limit=500_000) + verified = ( + item.get("verified_at") + or extract_verified_date(text) + or extract_filename_date(path) + ) + source = "declared" + if not verified: + project_root = project_roots.get(str(item.get("project"))) + if project_root is None: + verified = commit_dates.get(item.get("rel", ""), "") + else: + key = str(project_root) + if key not in project_commit_dates: + dates = git_last_commit_dates(project_root) + if dates is None: + if key not in git_failures: + git_failures.append(key) + dates = {} + project_commit_dates[key] = dates + verified = project_commit_dates[key].get(item.get("rel", ""), "") + source = "git" + if not verified and item.get("mtime"): + # Files git never saw (e.g. gitignored `.agents/` docs) still carry + # an mtime; count it as its own source instead of a freshness cliff. + verified = ( + datetime.fromtimestamp(float(item["mtime"]), tz=timezone.utc) + .date() + .isoformat() + ) + source = "mtime" + if not verified: + stale_missing.append(str(path)) + continue + parsed = parse_date(verified) + if parsed is None: + stale_missing.append(str(path)) + continue + if parsed.tzinfo is None: + parsed = parsed.replace(tzinfo=timezone.utc) + if (datetime.now(timezone.utc) - parsed.astimezone(timezone.utc)).days <= 90: + stats["state_docs_fresh"] += 1 + stats[FRESH_SOURCE_STATS[source]] += 1 + else: + stale_old.append((str(path), verified)) + if stale_missing: + findings.append( + finding( + "stale-state", + "medium", + "State documents lack a verifiable freshness date", + stale_missing[0], + f"{len(stale_missing)} state document(s) have no verified_at or update date.", + "Add verified_at to project cards/handoffs/environment docs; refresh active cards before relying on them.", + {"count": len(stale_missing), "examples": stale_missing[:10]}, + ) + ) + if stale_old: + findings.append( + finding( + "stale-state", + "medium", + "State documents are older than 90 days", + stale_old[0][0], + f"{len(stale_old)} state document(s) are older than the 90-day SLA.", + "Re-verify against git/runtime and update verified_at, or archive the document.", + {"count": len(stale_old), "examples": stale_old[:10]}, + ) + ) + stats["git_probe_failures"] = len(git_failures) + if git_failures: + findings.append( + finding( + "git-unavailable", + "high", + "Repository state could not be read", + git_failures[0], + f"{len(git_failures)} repository(ies) could not be queried; tracked state and commit dates are unknown.", + "Fix git access for these repositories and re-run; SIR and FRS do not count them as clean.", + {"count": len(git_failures), "repos": git_failures[:10]}, + ) + ) + + # Pointers + pointer_files = [ + item + for item in artifacts + if Path(item["path"]).suffix.lower() == ".md" + and ( + Path(item["path"]).name in {"AGENTS.md", "CLAUDE.md"} + or ( + Path(item["path"]).name == "README.md" + and ( + # Project .agents indexes and hub knowledge indexes are + # instruction artifacts, including custom hub layouts; tool + # entry docs (hub sections and machine zones) carry + # pointers like any other entry document. + item.get("kind") == "instruction" + or item.get("kind") == "tool" + or item.get("path", "").endswith( + ( + "/knowledge/README.md", + "/tools/README.md", + "/.agents/README.md", + "/.agents/wiki/README.md", + ) + ) + ) + ) + ) + ] + broken_by_file: List[Dict[str, Any]] = [] + naked_by_file: List[Dict[str, Any]] = [] + # Structured notes (CTX-09) opt their whole body into pointer checks, so a + # pointer card's truth links are verified like any CTX-03 pointer. + seen_pointer_paths = {item["path"] for item in pointer_files} + pointer_files += [ + item for item in structured_notes if item["path"] not in seen_pointer_paths + ] + stats["pointer_files_total"] = len(pointer_files) + scanned_pointer_files = pointer_files[:500] + stats["pointer_files_scanned"] = len(scanned_pointer_files) + for item in scanned_pointer_files: + path = Path(item["path"]) + text = read_text(path, limit=1_000_000) + pointers = extract_pointers(text) + broken: List[str] = [] + for pointer in pointers: + resolved = resolve_pointer(pointer, path, hub, home, config_roots=config.roots) + if resolved is None: + continue + stats["pointers_checked"] += 1 + if resolved.exists(): + stats["pointers_valid"] += 1 + else: + broken.append(pointer) + stats["broken_pointers"] += 1 + if broken: + broken_by_file.append( + finding( + "broken-pointer", + "high", + "Broken context pointer", + str(path), + f"{len(broken)} pointer(s) do not resolve.", + "Fix the path or replace it with a pointer that states when to read the target.", + {"pointers": broken[:10]}, + ) + ) + naked = extract_naked_pointers(text) + if naked: + stats["naked_pointers"] += len(naked) + naked_by_file.append( + finding( + "naked-pointer", + "medium", + "Path in prose is not machine-verifiable", + str(path), + f"{len(naked)} file path(s) sit outside a link or code span, so the pointer check never sees them.", + "Wrap each path in a markdown link or inline code (CTX-03, reference/spec.md).", + {"paths": naked[:10]}, + ) + ) + findings.extend(broken_by_file[:100]) + findings.extend(naked_by_file[:100]) + + # Secrets + secret_data = registry.get("secrets", {}) + secret_files = secret_data.get("files", []) + inline = secret_data.get("inline_bearers", []) + stats["secret_total"] = len(secret_files) + stats["inline_bearers"] = sum(int(item.get("count", 0)) for item in inline) + outside = [item for item in secret_files if not item.get("canonical")] + stats["secret_outside_root"] = len(outside) + stats["secret_tracking_unknown"] = sum( + 1 for item in secret_files if item.get("git_tracked") is None + ) + registry_info = secret_data.get("registry") or {} + entries = registry_info.get("entries") or [] + declared_paths: Set[str] = set() + missing_locations: List[str] = [] + declared_entries: Set[str] = set() + for entry in entries: + for location in str(entry.get("locations", "")).split(";"): + location = location.strip() + if not location or location == "-": + continue + pattern = str(home / location[2:]) if location.startswith("~/") else os.path.expanduser(location) + matches = glob.glob(pattern) + if not matches: + missing_locations.append(location) + continue + declared_entries.add(str(entry.get("id"))) + for match in matches: + try: + declared_paths.add(str(Path(match).resolve())) + except OSError: + continue + tracked = [item for item in secret_files if item.get("git_tracked")] + stats["secret_in_git"] = len(tracked) + for item in tracked[:20]: + findings.append( + finding( + "secret-in-git", + "critical", + "Credential file is tracked by git", + item["path"], + "A credential-bearing file is tracked; this must be removed from the index and history, not just deleted.", + "Stop, rotate the credential, remove it from the index/history, and add an ignore rule.", + ) + ) + outside_undeclared = [] + for item in outside: + try: + if str(Path(item["path"]).resolve()) not in declared_paths: + outside_undeclared.append(item["path"]) + except OSError: + continue + stats["secret_undeclared_outside"] = len(outside_undeclared) + if outside_undeclared: + findings.append( + finding( + "secret-outside-root", + "high", + "Credential files are unregistered outside the canonical root", + outside_undeclared[0], + f"{len(outside_undeclared)} credential-bearing file(s) live outside" + " ~/.agents/credentials and are not in the registry.", + "Register each location with its scope, or move the value into the canonical root.", + { + "count": len(outside_undeclared), + "declared_outside_root": len(outside) - len(outside_undeclared), + "examples": outside_undeclared[:10], + }, + ) + ) + for item in inline: + findings.append( + finding( + "secret-inline", + "high", + "Literal bearer token in host configuration", + item["path"], + f"{item.get('count', 0)} bearer token(s) are inline; values are redacted.", + "Replace with an environment/credential reference supported by the host; rotate if the file was shared.", + {"count": item.get("count", 0), "redacted": item.get("redacted", [])}, + ) + ) + + # Credential registry coverage + stats["credentials_registered"] = len(entries) + stats["credentials_by_scope"] = {} + for entry in entries: + scope = entry.get("scope", "unknown") + stats["credentials_by_scope"][scope] = stats["credentials_by_scope"].get(scope, 0) + 1 + if entries: + undeclared = [] + for item in secret_files: + try: + resolved = str(Path(item["path"]).resolve()) + except OSError: + continue + if resolved not in declared_paths: + undeclared.append(item["path"]) + stats["credentials_undeclared"] = len(undeclared) + stats["credentials_missing"] = len(missing_locations) + if undeclared: + findings.append( + finding( + "secret-undeclared", + "medium", + "Credential file is not registered", + undeclared[0], + f"{len(undeclared)} credential file(s) are absent from ~/.agents/credentials/registry.md.", + "Add an entry with scope (company/personal), site, account, location and keys.", + {"count": len(undeclared), "examples": undeclared[:10]}, + ) + ) + if missing_locations: + findings.append( + finding( + "secret-missing", + "medium", + "Registered credential location does not exist", + registry_info.get("path") or "", + f"{len(missing_locations)} registered location(s) resolve to nothing.", + "Rotate/restore the secret or drop the stale registry row.", + {"count": len(missing_locations), "examples": missing_locations[:10]}, + ) + ) + + # Governance document overlap + governance_docs = registry.get("governance_docs", []) + if len(governance_docs) > 4: + findings.append( + finding( + "governance-overlap", + "high", + "Too many documents claim to define context governance", + governance_docs[0], + f"{len(governance_docs)} primary framework documents are present.", + "Keep one primary framework and label the rest as facets or history.", + {"docs": governance_docs}, + ) + ) + + # Tmp and evidence hygiene + tmp_old: List[str] = [] + for project in projects: + agents_dir = project.get("agents_dir") + if not agents_dir: + continue + tmp_root = Path(agents_dir) / "tmp" + if not tmp_root.is_dir(): + continue + for path in tmp_root.rglob("*"): + age = age_days(path) + if age is not None and age > 14 and path.is_file(): + tmp_old.append(str(path)) + if tmp_old: + findings.append( + finding( + "tmp-overdue", + "low", + "Temporary files exceed the 14-day TTL", + tmp_old[0], + f"{len(tmp_old)} file(s) in .agents/tmp are older than 14 days.", + "Archive what matters and delete the rest; tmp is not a knowledge store.", + {"count": len(tmp_old), "examples": tmp_old[:10]}, + ) + ) + + # Plugin manifest drift + manifests = registry.get("plugin_manifests", {}) + versions = { + key: value.get("version") + for key, value in manifests.items() + if isinstance(value, dict) and value.get("exists") and value.get("version") + } + if len(set(versions.values())) > 1: + findings.append( + finding( + "host-manifest-drift", + "high", + "Plugin manifests disagree on version", + str(manifests.get("package", {}).get("path", "")), + f"Manifest versions: {versions}", + "Synchronize Codex, ZCode and package versions before release.", + {"versions": versions}, + ) + ) + + # Registry drift (CTX-10): the machine table (registry.json), the hub's + # human table (_registry.md path column) and the git roots on disk each + # claim to know which projects exist; disagreement is a finding, never a + # CHI dimension. The human side needs a hub; the machine↔disk edge stands + # on its own for hub-less users. + if hub is not None and not (hub / "hub.yaml").is_file() and not (hub / "AGENTS.md").is_file(): + findings.append( + finding( + "hub-manifest-missing", + "high", + "Attached hub is not recognizable as a hub", + str(hub), + f"{hub} has neither hub.yaml nor AGENTS.md, so no hub contract applies to it.", + "Point config/--hub at a real hub (`guster hub init`), or drop the hub setting.", + {"hub": str(hub)}, + ) + ) + machine_paths: Set[str] = set() + machine_projects: Set[str] = set() + for project in projects: + try: + key = str(Path(project["path"]).resolve()) + except OSError: + continue + machine_paths.add(key) + if not project.get("container"): + machine_projects.add(key) + human_paths: Set[str] = set() + dead_rows: List[str] = [] + unscanned_rows: List[str] = [] + registry_md: Optional[Path] = None + if hub is not None: + projects_root = hub_layout.get("projects") + registry_md = (projects_root / "_registry.md") if projects_root else None + if registry_md is not None and registry_md.is_file(): + hub_root = hub.expanduser().resolve() + for row in parse_registry_rows(read_text(registry_md, limit=1_000_000)): + if REGISTRY_REMOTE_FORM.match(row["path"]): + stats["registry_rows_remote"] += 1 + continue + resolved = resolve_registry_row_path(row["path"], hub_root, home) + if resolved is None: + continue + try: + key = str(resolved.resolve()) + except OSError: + continue + human_paths.add(key) + if not resolved.exists(): + dead_rows.append(row["path"]) + elif scope == "machine" and key not in machine_paths: + unscanned_rows.append(row["path"]) + stats["registry_rows"] = len(human_paths) + stats["registry_drift_dead_rows"] = len(dead_rows) + stats["registry_drift_unscanned_rows"] = len(unscanned_rows) + if registry_md is not None and registry_md.is_file(): + if dead_rows: + findings.append( + finding( + "registry-drift", + "medium", + "Hub registry rows point at paths that do not exist", + str(registry_md), + f"{len(dead_rows)} row(s) in the human registry name a path that is not on disk.", + "Fix the row path, or delete the row; a registry row must resolve to the project directory.", + {"count": len(dead_rows), "rows": dead_rows[:10]}, + ) + ) + if unscanned_rows: + findings.append( + finding( + "registry-drift", + "medium", + "Hub registry rows are outside the machine scan", + str(registry_md), + f"{len(unscanned_rows)} registered path(s) exist but the scan never records them; " + "the machine table cannot see what the human table claims.", + "Add the containing directory to the configured roots (guster init/zones), or fix the row path.", + {"count": len(unscanned_rows), "rows": unscanned_rows[:10]}, + ) + ) + unregistered = sorted(machine_projects - human_paths) + stats["registry_drift_unregistered"] = len(unregistered) + if unregistered: + findings.append( + finding( + "registry-drift", + "low", + "Scanned projects are not registered in the hub", + unregistered[0], + f"{len(unregistered)} scanned project(s) have no row in the human registry.", + "Add a CTX-10 row per project, or waive deliberately unregistered ones in hub.yaml.", + {"count": len(unregistered), "examples": unregistered[:10]}, + ) + ) + persisted_registry = load_json(config.state_dir / "registry.json", None) + if isinstance(persisted_registry, dict) and isinstance(persisted_registry.get("projects"), list): + persisted_paths: Set[str] = set() + for project in persisted_registry["projects"]: + if not isinstance(project, dict) or not project.get("path"): + continue + try: + persisted_paths.add(str(Path(project["path"]).resolve())) + except OSError: + continue + if persisted_paths != machine_paths: + vanished = sorted(persisted_paths - machine_paths) + appeared = sorted(machine_paths - persisted_paths) + stats["registry_drift_stale_machine"] = len(vanished) + len(appeared) + findings.append( + finding( + "registry-drift", + "low", + "Machine registry is out of date with disk", + str(config.state_dir / "registry.json"), + f"{len(vanished)} project(s) listed in registry.json no longer scan; " + f"{len(appeared)} on disk are missing from it.", + "Re-run `guster scan`/`guster doctor` without --no-write to refresh the machine table.", + {"vanished": vanished[:10], "appeared": appeared[:10]}, + ) + ) + + scoped = scope_roots(config) + if scoped is not None: + kept = [ + item for item in findings if in_scope_path(item.get("path", ""), scoped) + ] + hidden = [ + item for item in findings if not in_scope_path(item.get("path", ""), scoped) + ] + stats["scoped_hidden_findings"] = len(hidden) + if hidden: + by_rule: Dict[str, int] = {} + for item in hidden: + by_rule[item["rule"]] = by_rule.get(item["rule"], 0) + 1 + kept.append( + finding( + "out-of-scope", + "info", + f"Machine-level findings hidden in {scope} scope", + "", + f"{len(hidden)} finding(s) sit outside the {scope} scope.", + "Run `guster doctor` without --root for the machine-wide view.", + {"by_rule": by_rule}, + ) + ) + findings = kept + + waived: List[Dict[str, Any]] = [] + waivers = load_waivers(hub) + if waivers: + kept, waived = [], [] + for item in findings: + reason = _waiver_reason(item, waivers) + if reason is None: + kept.append(item) + else: + item["waiver_reason"] = reason + waived.append(item) + stats["waived_findings"] = len(waived) + findings = kept + + findings.sort(key=lambda item: (SEVERITY_ORDER.get(item["severity"], 9), item["rule"], item["path"])) + for index, item in enumerate(findings, start=1): + item["id"] = f"F{index:04d}" + return {"findings": findings, "waived": waived, "stats": stats} + + +def _waiver_reason(item: Dict[str, Any], waivers: Sequence[Dict[str, str]]) -> Optional[str]: + target = str(item.get("path") or "") + for waiver in waivers: + if waiver["rule"] != item.get("rule"): + continue + scope_path = waiver.get("path", "") + if not scope_path: + return waiver["reason"] + root = Path(os.path.expanduser(scope_path)) + try: + if Path(target).resolve() == root.resolve(): + return waiver["reason"] + if root.resolve() in Path(target).resolve().parents: + return waiver["reason"] + except OSError: + continue + return None + + +def extract_verified_date(text: str) -> str: + """Declared date from the document header; prose deeper down is not a claim about this file.""" + head = "\n".join(text.splitlines()[:DATE_HEADER_LINES]) + match = re.search( + VERIFIED_DATE_KEYS + r"\s*\*{0,2}\s*[::]\s*\*{0,2}\s*(\d{4}[-/]\d{1,2}[-/]\d{1,2})", + head, + ) + return match.group(1) if match else "" + + +def extract_filename_date(path: Path) -> str: + """Only a date that opens the filename counts; a ticket id is not a freshness claim.""" + stem = path.stem.lstrip(".") + match = re.match(r"(20\d{2})[-_]?(\d{2})[-_]?(\d{2})(?:$|[-_.])", stem) + if not match: + return "" + year, month, day = match.groups() + try: + datetime(int(year), int(month), int(day)) + except ValueError: + return "" + return f"{year}-{month}-{day}" + + +def count_lines(path: Path) -> int: + text = read_text(path, limit=5_000_000) + return len(text.splitlines()) if text else 0 + + +def file_size(path: Path) -> int: + try: + return path.stat().st_size + except OSError: + return 0 diff --git a/external_plugins/guster/src/guster/report.py b/external_plugins/guster/src/guster/report.py new file mode 100644 index 00000000..ad3b8023 --- /dev/null +++ b/external_plugins/guster/src/guster/report.py @@ -0,0 +1,366 @@ +from __future__ import annotations + +import json +from pathlib import Path +from typing import Any, Dict, List, Optional, Sequence, Set + +from . import __version__ +from .util import human_bytes, now_iso + + +SEVERITY_LABEL = { + "critical": "CRITICAL", + "high": "HIGH", + "medium": "MEDIUM", + "low": "LOW", + "info": "INFO", +} +RULE_ACTION_HINTS = { + "secret-in-git": "rotate the exposed credential, then remove it from the git index/history", + "secret-inline": "replace inline tokens with environment references and rotate them", + "secret-outside-root": "register or move unregistered credential files into the canonical root", + "secret-undeclared": "register credential files in ~/.agents/credentials/registry.md", + "secret-missing": "rotate or drop stale credential registry rows", + "broken-pointer": "fix the pointer path or replace it with a when-to-read pointer (`guster link` lists them)", + "naked-pointer": "wrap naked paths in a link or inline code (CTX-03)", + "misplaced-artifact": "move task bundles under a standard slot (`guster plan move`)", + "stale-state": "refresh verified_at on state documents or archive them", + "orphan-knowledge": "index knowledge files in their README, or delete them", + "duplicate-canonical": "keep one canonical home and turn the rest into pointers", + "skill-budget": "trim skill descriptions to one trigger sentence", + "skill-copy-drift": "make drifted skill copies byte-identical", + "resident-budget": "demote resident detail into knowledge or skills", + "registry-drift": "reconcile the hub registry rows with scanned projects (CTX-10)", + "hub-manifest-missing": "point the hub config at a real hub (`guster hub init`)", + "note-header-malformed": "fix note front-matter (type key + machine-readable date)", + "git-unavailable": "fix git access for the failing repositories", + "tmp-overdue": "archive or delete overdue files in .agents/tmp", + "governance-overlap": "reduce competing frameworks to one primary document", + "host-manifest-drift": "synchronize plugin manifest versions", +} + + +def next_actions(findings: Sequence[Dict[str, Any]]) -> List[str]: + """Actions derived from the findings that actually fired; an empty list + keeps the baseline ritual instead of naming problems that do not exist.""" + if not findings: + return [ + "No open findings — run `guster score` to record the baseline, and `guster check` after context edits." + ] + counts: Dict[str, int] = {} + for item in findings: + rule = str(item.get("rule") or "") + if rule == "out-of-scope": + continue + counts[rule] = counts.get(rule, 0) + 1 + actions: List[str] = [] + critical_rules = sorted( + { + str(item.get("rule") or "") + for item in findings + if item.get("severity") == "critical" and item.get("rule") != "out-of-scope" + } + ) + if critical_rules: + actions.append( + f"Fix the critical finding(s) first ({', '.join(critical_rules)}); " + "rotate any exposed credential before further edits." + ) + seen: Set[str] = set() + for item in findings: # findings arrive sorted by severity + rule = str(item.get("rule") or "") + if rule in seen or rule == "out-of-scope": + continue + seen.add(rule) + hint = RULE_ACTION_HINTS.get(rule) + if hint is None: + continue + actions.append(f"`{rule}` × {counts[rule]}: {hint}.") + if len(actions) >= 5: + break + actions.append( + "Turn the rest into a checklist with `guster plan findings`; structural changes go " + "through `guster plan move`/`guster plan init` and `guster apply --yes`." + ) + actions.append("Re-run `guster score` after fixes and compare the trend.") + return actions + + +def render_report( + registry: Dict[str, Any], + policy_result: Dict[str, Any], + metric_result: Dict[str, Any], +) -> str: + summary = registry.get("summary", {}) + metrics = metric_result.get("metrics", {}) + scores = metric_result.get("scores", {}) + raw = metric_result.get("raw", {}) + findings = policy_result.get("findings", []) + scope = metric_result.get("scope", registry.get("scope", "machine")) + workspaces = registry.get("workspaces", []) + if scope == "hub": + project_cards = summary.get("project_cards", 0) + projects_line = f"- Projects: **{project_cards}** (scanned roots: {summary.get('projects', 0)})" + else: + total_projects = int(summary.get("projects", 0)) + containers = int(summary.get("containers", 0)) + projects_line = f"- Projects: **{total_projects - containers}**" + if containers: + projects_line += f" (workspace containers: {containers})" + + lines: List[str] = [] + lines.append("# Guster Context Health") + lines.append("") + lines.append(f"> Generated: {metric_result.get('generated_at', now_iso())}") + if workspaces: + lines.append(f"> Workspaces: {', '.join(workspaces)}") + if registry.get("unconfigured"): + if registry.get("auto_roots") and workspaces: + lines.append( + f"> **Unconfigured:** auto-scanning {', '.join(workspaces)} — " + "run `guster init` to pin these roots." + ) + if not registry.get("hub"): + lines.append("> **No hub attached** — run `guster hub init` to create one.") + lines.append("") + lines.append("## Summary") + lines.append("") + lines.append(projects_line) + projects_total = int(summary.get("projects", 0)) + agents_dirs = int(summary.get("agents_dirs", 0)) + lines.append( + f"- `.agents/` dirs: **{agents_dirs}** " + f"(with index: {summary.get('agents_with_index', 0)}); " + f"projects without one: {max(0, projects_total - agents_dirs)}" + ) + lines.append( + f"- Skills: **{summary.get('skills', 0)}** unique / " + f"**{summary.get('skill_copies', 0)}** copies" + ) + lines.append( + f"- Knowledge: **{summary.get('knowledge', 0)}** files; " + f"state: {summary.get('state', 0)}; evidence: {summary.get('evidence', 0)}" + ) + lines.append( + f"- Credentials: **{summary.get('secret_files', 0)}** files " + f"({raw.get('secret_undeclared_outside', 0)} outside and unregistered, " + f"{raw.get('inline_bearers', 0)} inline)" + ) + lines.append("") + lines.append("## Context Health Index") + lines.append("") + dims = metric_result.get("dims") or [] + label = f"{scope} scope" + chi = metric_result.get("chi") + lines.append(f"**CHI: {'n/a' if chi is None else chi} / 100** ({label})") + lines.append("") + lines.append("| Dimension | Value | Score | Raw |") + lines.append("|---|---:|---:|---|") + rows = [ + ( + "Single source", + "ssr", + metrics.get("ssr"), + scores.get("ssr"), + f"{raw.get('topics_total', 0) - raw.get('topics_multi', 0)}/{raw.get('topics_total', 0)} topics single-source", + ), + ( + "Resident budget", + "rbr", + metrics.get("rbr"), + scores.get("rbr"), + f"{human_bytes(raw.get('resident_bytes', 0))} over {raw.get('resident_entries', 0)} entry files; " + f"skills {raw.get('skill_chars', 0)} chars", + ), + ( + "Placement", + "pcr", + metrics.get("pcr"), + scores.get("pcr"), + f"{raw.get('agents_dirs_compliant', 0)}/{raw.get('agents_dirs_total', 0)} compliant" + f" ({raw.get('agents_dirs_extra_entries', 0)} extra entries, " + f"{raw.get('agents_dirs_missing_slots', 0)} missing slots, " + f"{raw.get('agents_dirs_missing_index', 0)} no index)", + ), + ( + "Index coverage", + "icr", + metrics.get("icr"), + scores.get("icr"), + f"knowledge {raw.get('knowledge_indexed', 0)}/{raw.get('knowledge_total', 0)}; " + f".agents index {raw.get('agents_indexed', 0)}/{raw.get('agents_dirs_total', 0)}", + ), + ( + "State freshness", + "frs", + metrics.get("frs"), + scores.get("frs"), + f"{raw.get('state_docs_fresh', 0)}/{raw.get('state_docs_total', 0)} fresh " + f"({raw.get('state_docs_fresh_declared', 0)} declared, " + f"{raw.get('state_docs_fresh_from_git', 0)} from git, " + f"{raw.get('state_docs_fresh_from_mtime', 0)} from mtime)", + ), + ("Pointer health", "phr", metrics.get("phr"), scores.get("phr"), f"{raw.get('pointers_valid', 0)}/{raw.get('pointers_checked', 0)} valid"), + ( + "Secret isolation", + "sir", + metrics.get("sir"), + scores.get("sir"), + f"{raw.get('secret_undeclared_outside', 0)} undeclared outside; " + f"{raw.get('inline_bearers', 0)} inline; {raw.get('secret_in_git', 0)} in git; " + f"{raw.get('secret_tracking_unknown', 0)} unverifiable", + ), + ] + for label, key, value, score, detail in rows: + if dims and key not in dims: + continue + lines.append( + f"| {label} | {'n/a' if value is None else value} " + f"| {'n/a' if score is None else score} | {detail} |" + ) + lines.append("") + unscored = metric_result.get("unscored_dims") or [] + if unscored: + lines.append( + f"_No evidence: {', '.join(dim.upper() for dim in unscored)}. " + "CHI is normalized over the dimensions that had evidence, so it is not comparable " + "across scopes with different coverage._" + ) + lines.append("") + if raw.get("pointer_files_total", 0) > raw.get("pointer_files_scanned", 0): + lines.append( + f"_Pointer scan covered {raw.get('pointer_files_scanned')} of " + f"{raw.get('pointer_files_total')} pointer files._" + ) + lines.append("") + if raw.get("knowledge_unhashed", 0): + lines.append( + f"_Knowledge files excluded from single-source checks (above the hash limit or unreadable): " + f"{raw.get('knowledge_unhashed')}._" + ) + lines.append("") + lines.append( + f"_Not counted in CHI: Governance simplicity {metrics.get('gcr')} " + f"(score {scores.get('gcr')}, {raw.get('governance_docs', 0)} docs)._" + ) + lines.append("") + lines.append("## Findings") + lines.append("") + if not findings: + lines.append("No findings.") + else: + counts: Dict[str, int] = {} + for item in findings: + counts[item["severity"]] = counts.get(item["severity"], 0) + 1 + lines.append( + "Counts: " + + ", ".join( + f"{SEVERITY_LABEL.get(level, level)} {counts.get(level, 0)}" + for level in ("critical", "high", "medium", "low", "info") + if counts.get(level) + ) + ) + lines.append("") + for item in findings[:80]: + label = SEVERITY_LABEL.get(item["severity"], item["severity"]) + lines.append(f"### [{label}] {item['title']}") + lines.append("") + lines.append(f"- Rule: `{item['rule']}`") + lines.append(f"- Path: `{item['path']}`") + lines.append(f"- {item['message']}") + lines.append(f"- Action: {item['suggestion']}") + evidence = item.get("evidence") or {} + if evidence: + compact = json.dumps(evidence, ensure_ascii=False) + if len(compact) > 500: + compact = compact[:500] + "..." + lines.append(f"- Evidence: `{compact}`") + lines.append("") + if len(findings) > 80: + lines.append(f"_...and {len(findings) - 80} more findings; use `guster doctor --json`._") + lines.append("") + waived = policy_result.get("waived", []) + if waived: + lines.append(f"## Waived ({len(waived)})") + lines.append("") + for item in waived: + lines.append(f"- `{item['rule']}` — `{item['path']}` — {item.get('waiver_reason', '')}") + lines.append("") + lines.append("## Next Actions") + lines.append("") + for index, action in enumerate(next_actions(findings), start=1): + lines.append(f"{index}. {action}") + lines.append("") + return "\n".join(lines) + + +def render_status(registry: Dict[str, Any], metric_result: Optional[Dict[str, Any]] = None) -> str: + plugin = registry.get("plugin", {}) + summary = registry.get("summary", {}) + projects = ( + summary.get("project_cards", 0) + if registry.get("scope") == "hub" + else summary.get("projects", 0) + ) + lines = [ + f"Guster {plugin.get('version', '?')}", + f"generated: {registry.get('generated_at', '?')}", + f"hub: {registry.get('hub') or '(none)'}", + f"workspaces: {', '.join(registry.get('workspaces', []))}", + ] + zones = registry.get("zones") or [] + if zones: + lines.append( + "zones: " + + ", ".join( + f"{Path(item.get('path', '.')).name}({item.get('profile', 'light')}, {item.get('tools', 0)} tools)" + for item in zones + ) + ) + if registry.get("unconfigured"): + if registry.get("auto_roots") and registry.get("workspaces"): + lines.append( + "note: no config yet — auto-scanning " + + ", ".join(registry["workspaces"]) + + "; run `guster init` to pin roots" + ) + if not registry.get("hub"): + lines.append("note: no hub attached; run `guster hub init` to create one") + state_dir = registry.get("state_dir") + if state_dir and Path(state_dir).parent.name == "scoped": + lines.append(f"scope: {registry.get('scope', 'machine')} (state: {state_dir})") + lines.extend( + [ + f"projects: {projects}", + f"skills: {summary.get('skills', 0)} unique / {summary.get('skill_copies', 0)} copies", + f"knowledge: {summary.get('knowledge', 0)}", + f"credentials: {summary.get('secret_files', 0)} files; {summary.get('inline_bearers', 0)} inline", + ] + ) + if plugin.get("version") and plugin.get("version") != __version__: + lines.append( + f"(registry was scanned by guster {plugin.get('version')}; " + f"current CLI is {__version__} — run `guster doctor` to refresh)" + ) + if metric_result: + chi = metric_result.get("chi") + stamp = metric_result.get("generated_at") + suffix = f" (scored {stamp})" if stamp else "" + lines.append(f"CHI: {'n/a' if chi is None else chi}{suffix}") + return "\n".join(lines) + + +def redacted_registry(registry: Dict[str, Any]) -> Dict[str, Any]: + def scrub(value: Any) -> Any: + if isinstance(value, dict): + return { + key: scrub(item) + for key, item in value.items() + if key.lower() not in {"value", "password", "token", "secret", "authorization"} + } + if isinstance(value, list): + return [scrub(item) for item in value] + return value + + return scrub(registry) + diff --git a/external_plugins/guster/src/guster/util.py b/external_plugins/guster/src/guster/util.py new file mode 100644 index 00000000..63da18e1 --- /dev/null +++ b/external_plugins/guster/src/guster/util.py @@ -0,0 +1,741 @@ +from __future__ import annotations + +import contextlib +import hashlib +import json +import os +import re +import subprocess +import tempfile +import time +from contextlib import contextmanager +from datetime import datetime +from pathlib import Path +from typing import Any, Dict, Iterator, List, Optional, Sequence, Set, Tuple + +try: + import fcntl +except ImportError: # pragma: no cover - non-POSIX hosts + fcntl = None # type: ignore[assignment] + + +EXCLUDE_DIRS = { + ".git", + ".hg", + ".svn", + "node_modules", + "build", + "dist", + "out", + "__pycache__", + ".pytest_cache", + ".mypy_cache", + ".ruff_cache", + ".next", + ".nuxt", + ".venv", + "venv", + "target", + ".idea", + ".vscode", +} + +TEXT_SUFFIXES = { + ".md", + ".markdown", + ".txt", + ".json", + ".yaml", + ".yml", + ".toml", + ".ini", + ".cfg", + ".conf", + ".sh", + ".bash", + ".zsh", + ".py", + ".js", + ".mjs", + ".ts", + ".tsx", + ".jsx", + ".go", + ".java", + ".kt", + ".rs", + ".rb", + ".php", + ".sql", +} + +POINTER_SUFFIXES = { + ".md", + ".json", + ".yaml", + ".yml", + ".toml", + ".sh", + ".bash", + ".zsh", + ".py", + ".js", + ".mjs", + ".ts", + ".tsx", + ".jsx", + ".go", + ".java", + ".kt", + ".rs", + ".sql", + ".png", + ".jpg", + ".jpeg", + ".gif", + ".webp", + ".svg", + ".mp4", + ".mov", + ".jsonl", + ".csv", +} + + +def now_iso() -> str: + return datetime.now().astimezone().isoformat(timespec="seconds") + + +def today_iso() -> str: + return datetime.now().astimezone().date().isoformat() + + +def read_text(path: Path, limit: Optional[int] = None) -> str: + try: + text = path.read_text(encoding="utf-8", errors="replace") + except OSError: + return "" + if limit is not None and len(text) > limit: + return text[:limit] + return text + + +def write_text(path: Path, text: str) -> None: + """Atomic replace: a concurrent reader sees the old or the new file, never a mix.""" + path.parent.mkdir(parents=True, exist_ok=True) + fd, tmp_name = tempfile.mkstemp( + dir=str(path.parent), prefix=f".{path.name}.", suffix=".tmp" + ) + try: + with os.fdopen(fd, "w", encoding="utf-8") as handle: + handle.write(text) + os.replace(tmp_name, path) + except BaseException: + with contextlib.suppress(OSError): + os.unlink(tmp_name) + raise + + +@contextmanager +def state_lock(state_dir: Path) -> Iterator[None]: + """Exclusive lock over one state dir so concurrent CLI runs cannot interleave + scan/policy writes. flock is POSIX-only; elsewhere the lock degrades to a no-op + while write_text itself stays atomic.""" + state_dir.mkdir(parents=True, exist_ok=True) + handle = (state_dir / ".lock").open("w") + try: + if fcntl is not None: + fcntl.flock(handle.fileno(), fcntl.LOCK_EX) + yield + finally: + handle.close() + + +def sha256_bytes(data: bytes) -> str: + return hashlib.sha256(data).hexdigest() + + +def sha256_text(text: str) -> str: + return sha256_bytes(text.encode("utf-8")) + + +def sha256_file(path: Path) -> str: + try: + return sha256_bytes(path.read_bytes()) + except OSError: + return "" + + +def is_under(path: Path, root: Path) -> bool: + try: + path.resolve().relative_to(root.resolve()) + return True + except (OSError, ValueError): + return False + + +def relative(path: Path, base: Path) -> str: + try: + return str(path.resolve().relative_to(base.resolve())) + except (OSError, ValueError): + return str(path) + + +def slugify(value: str) -> str: + value = value.strip().lower() + value = re.sub(r"[^a-z0-9._-]+", "-", value) + value = re.sub(r"-{2,}", "-", value).strip("-") + return value or "item" + + +def unique_suffix(length: int = 3) -> str: + """Random hex tail; same-second plan ids and backups must not overwrite.""" + return os.urandom(length).hex() + + +def human_bytes(value: int) -> str: + if value < 1024: + return f"{value} B" + if value < 1024 * 1024: + return f"{value / 1024:.1f} KB" + return f"{value / (1024 * 1024):.1f} MB" + + +def json_dumps(data: Any, pretty: bool = True) -> str: + return json.dumps(data, ensure_ascii=False, indent=2 if pretty else None, sort_keys=False) + + +def load_json(path: Path, default: Any = None) -> Any: + try: + return json.loads(path.read_text(encoding="utf-8")) + except (OSError, ValueError): + return default + + +def load_json_strict(path: Path) -> Tuple[Any, Optional[str]]: + """Value and error apart: absent is (None, None), corrupt is (None, reason). + + Missing and corrupt are different conditions; a caller that can rescan must + warn about corruption instead of silently treating it as absent.""" + try: + raw = path.read_text(encoding="utf-8") + except FileNotFoundError: + return None, None + except OSError as exc: + return None, str(exc) + try: + return json.loads(raw), None + except ValueError as exc: + return None, str(exc) + + +def is_indexed(name: str, index_text: str) -> bool: + """A backtick-wrapped index row, bare or as a `dir/name` tail. + + A bare substring does not count: `a.md` inside `data.md` is not an index row.""" + return f"`{name}`" in index_text or f"/{name}`" in index_text + + +def save_json(path: Path, data: Any) -> None: + write_text(path, json_dumps(data) + "\n") + + +def parse_frontmatter(text: str) -> Tuple[Dict[str, str], str]: + """Parse the small YAML frontmatter subset used by agent files. + + Supports scalar keys, quoted values and literal/folded blocks. It deliberately + avoids a PyYAML dependency so the plugin runs on a stock Python install. + """ + if not text.startswith("---"): + return {}, text + lines = text.splitlines() + if not lines or lines[0].strip() != "---": + return {}, text + end: Optional[int] = None + for index in range(1, len(lines)): + if lines[index].strip() == "---": + end = index + break + if end is None: + return {}, text + + data: Dict[str, str] = {} + index = 1 + while index < end: + line = lines[index] + if not line.strip() or line.lstrip().startswith("#"): + index += 1 + continue + if line.startswith((" ", "\t")) or ":" not in line: + index += 1 + continue + key, raw = line.split(":", 1) + key = key.strip() + value = raw.strip() + if value in ("|", ">"): + block: List[str] = [] + index += 1 + while index < end: + candidate = lines[index] + if candidate.startswith(" "): + block.append(candidate[2:]) + elif not candidate.strip(): + block.append("") + else: + break + index += 1 + data[key] = ("\n" if value == "|" else " ").join(block).strip() + continue + data[key] = unquote(value) + index += 1 + return data, "\n".join(lines[end + 1 :]) + + +def unquote(value: str) -> str: + value = value.strip() + if len(value) >= 2 and value[0] == value[-1] and value[0] in ('"', "'"): + return value[1:-1] + return value + + +def first_heading(text: str, fallback: str = "") -> str: + for line in text.splitlines(): + if line.startswith("# "): + return line[2:].strip() + return fallback + + +def iter_files( + root: Path, + suffixes: Optional[Set[str]] = None, + max_depth: Optional[int] = None, + skip_dirs: Optional[Set[str]] = None, + errors: Optional[List[str]] = None, +) -> Iterator[Path]: + if not root.exists(): + return + skip = EXCLUDE_DIRS if skip_dirs is None else skip_dirs + root = root.resolve() + + def on_error(exc: OSError) -> None: + if errors is not None: + errors.append(f"{exc.filename or root}: {exc.strerror or exc}") + + for current, dirs, files in os.walk(root, onerror=on_error): + current_path = Path(current) + depth = len(current_path.relative_to(root).parts) + if max_depth is not None and depth >= max_depth: + dirs[:] = [] + dirs[:] = sorted(d for d in dirs if d not in skip) + for name in sorted(files): + path = current_path / name + if suffixes is not None and path.suffix.lower() not in suffixes: + continue + yield path + + +def find_git_roots(roots: Sequence[Path], max_depth: int = 5) -> List[Path]: + found: List[Path] = [] + seen: Set[str] = set() + + def visit(path: Path, depth: int) -> None: + try: + resolved = str(path.resolve()) + except OSError: + return + if resolved in seen: + return + seen.add(resolved) + if not path.is_dir(): + return + if (path / ".git").exists(): + found.append(path) + return + if depth >= max_depth: + return + try: + entries = sorted(path.iterdir(), key=lambda item: item.name) + except OSError: + return + for entry in entries: + if entry.name in EXCLUDE_DIRS or entry.name.startswith("."): + continue + if entry.is_dir(): + visit(entry, depth + 1) + + for root in roots: + visit(root, 0) + return sorted(found, key=lambda item: str(item)) + + +def git_tracked(root: Path) -> Optional[Set[str]]: + """Tracked paths; None means git could not answer, never a silent empty set.""" + if not (root / ".git").exists(): + return set() + try: + result = subprocess.run( + ["git", "-C", str(root), "ls-files", "-z"], + check=False, + capture_output=True, + timeout=10, + ) + except (OSError, subprocess.SubprocessError): + return None + if result.returncode != 0: + return None + tracked: Set[str] = set() + for raw in result.stdout.split(b"\x00"): + if not raw: + continue + tracked.add(raw.decode("utf-8", errors="replace")) + return tracked + + +def git_last_commit_dates(root: Path) -> Optional[Dict[str, str]]: + """Map repo-relative paths to the newest commit date; None when git failed.""" + if not (root / ".git").exists(): + return {} + try: + result = subprocess.run( + ["git", "-C", str(root), "log", "--format=%x00%cI", "--name-only"], + check=False, + capture_output=True, + text=True, + timeout=30, + ) + except (OSError, subprocess.SubprocessError): + return None + if result.returncode != 0: + if result.returncode == 128 and "does not have any commits yet" in ( + result.stderr or "" + ): + # A freshly `git init`-ed repo has no history to read: no dates, + # not a git failure. + return {} + return None + dates: Dict[str, str] = {} + current = "" + for line in result.stdout.splitlines(): + if line.startswith("\x00"): + current = line[1:].strip() + continue + rel = line.strip() + if not rel or not current: + continue + dates.setdefault(rel, current) + return dates + + +NOTE_DATE_KEYS = ("updated", "date", "lastmod", "created") +_NOTE_DATE_RE = re.compile(r"^\d{4}-\d{2}-\d{2}(?:[T ][\d:]+)?") + + +def parse_note_header(text: str) -> Optional[Dict[str, Any]]: + """Parse a knowledge note's YAML front-matter (CTX-09). + + Follows the Obsidian properties convention — the interchange format the + open-source markdown knowledge bases (Foam, Quartz, Logseq) all accept. + Hand-rolled for the simple subset (scalar keys, one list per key, ``#`` + comments, literal/folded block scalars) because the CLI runs on stock + Python without third-party deps. + + Returns None when the text has no front-matter or declares no ``type`` — + the structured header is opt-in, and that gate wins over malformedness, + so legacy prose notes that merely open with dashes never report. A dict + with ``_malformed`` reports a header that opted in but cannot be parsed. + """ + lines = text.splitlines() + if not text.startswith("---") or not lines or lines[0].strip() != "---": + return None + keys: Dict[str, Any] = {} + list_key: Optional[str] = None + malformed: Optional[Dict[str, Any]] = None + end: Optional[int] = None + limit = min(len(lines), 80) + index = 1 + while index < limit: + line = lines[index] + if line.strip() == "---": + end = index + break + stripped = line.strip() + if not stripped or stripped.startswith("#"): + index += 1 + continue + if stripped.startswith("- ") and list_key is not None: + value = stripped[2:].split("#", 1)[0].strip() + if value: + keys[list_key].append(value) + index += 1 + continue + match = re.match(r"^([A-Za-z0-9_-]+):\s*(.*)$", stripped) + if not match: + if malformed is None: + malformed = {"line": index + 1, "text": stripped[:60]} + index += 1 + continue + key = match.group(1) + value = match.group(2).split("#", 1)[0].strip() + if value in ("|", ">"): + block: List[str] = [] + index += 1 + while index < limit: + candidate = lines[index] + if candidate.startswith(" "): + block.append(candidate[2:]) + elif not candidate.strip(): + block.append("") + else: + break + index += 1 + keys[key] = ("\n" if value == "|" else " ").join(block).strip() + list_key = None + continue + if len(value) >= 2 and value[0] == value[-1] and value[0] in "\"'": + value = value[1:-1] + if value: + keys[key] = value + list_key = None + else: + keys[key] = [] + list_key = key + index += 1 + note_type = keys.get("type") + if isinstance(note_type, list): + note_type = note_type[0] if note_type else "" + if not note_type or not str(note_type).strip().strip("[]"): + return None + if malformed is not None: + return {"_malformed": True, **malformed} + if end is None: + return {"_malformed": True, "line": len(lines), "text": "front-matter not closed"} + return keys + + +def note_header_date(header: Dict[str, Any]) -> Optional[str]: + """First machine-readable date value among the convention's date keys.""" + for key in NOTE_DATE_KEYS: + value = header.get(key) + if isinstance(value, str) and _NOTE_DATE_RE.match(value.strip()): + return value.strip() + return None + + +def extract_pointers(text: str) -> List[str]: + # A leading front-matter block is metadata, not prose (CTX-09: the body, + # never the header, joins the pointer scan). + text = _strip_frontmatter(text) + text = re.sub(r"```.*?```", "", text, flags=re.DOTALL) + pointers: List[str] = [] + + def add(candidate: str) -> None: + # `[`path`](path)` matches both the link and the inline-code pass; count + # each target once per file so pointer health is not double-weighted. + if _looks_like_pointer(candidate) and candidate not in pointers: + pointers.append(candidate) + + for match in re.finditer(r"\[[^\]]*\]\(([^)]+)\)", text): + add(match.group(1).strip()) + for match in re.finditer(r"`([^`\n]+)`", text): + candidate = match.group(1).strip() + if candidate.startswith("~/") and _is_remote_command(_line_at(text, match.start())): + continue + add(candidate) + return pointers + + +def _line_at(text: str, offset: int) -> str: + start = text.rfind("\n", 0, offset) + 1 + end = text.find("\n", offset) + return text[start : end if end != -1 else len(text)] + + +def _is_remote_command(line: str) -> bool: + # `ssh mini` + `~/...` in the same line names the remote home, not a local path. + if re.search(r"\bssh\s+(?:-[\w-]+\s+)*[A-Za-z0-9._-]+", line): + return True + return re.search(r"\b(?:scp|rsync)\b[^\n]*?[A-Za-z0-9._-]+:~/", line) is not None + + +def _looks_like_pointer(candidate: str) -> bool: + if not candidate or _is_placeholder(candidate): + return False + if any(char.isspace() for char in candidate): + return False + if candidate.startswith(("http://", "https://", "mailto:", "tel:", "#", "...")): + return False + suffix = Path(candidate).suffix.lower() + if candidate.startswith("~/"): + return True + if candidate.startswith(("./", "../")): + return True + if candidate.startswith("/"): + known_roots = ( + "/Users/", + "/home/", + "/tmp/", + "/Applications/", + "/System/", + "/opt/", + "/usr/", + "/var/", + "/etc/", + "/private/", + "/Volumes/", + ) + return candidate.startswith(known_roots) + if candidate.endswith("/"): + # A relative directory pointer (`knowledge/general/`) has no suffix and + # is still a link worth checking. + return True + return "/" in candidate and suffix in POINTER_SUFFIXES + + +def _is_placeholder(pointer: str) -> bool: + if any(token in pointer for token in ("<", ">", "*", "{", "}", "$", "|")): + return True + # File templates in docs: draft-NNN.md, daily-YYYY-MM-DD.md, 0X-xxx.md. + return re.search(r"(?:N{2,}|Y{4}|X{3,}|x{3,}|0[xX][-_/])", pointer) is not None + + +def _strip_pointer(pointer: str) -> str: + pointer = pointer.strip() + if pointer.startswith("<") and ">" in pointer: + pointer = pointer[1 : pointer.index(">")] + pointer = pointer.split(" ", 1)[0] + if pointer.startswith("file://"): + pointer = pointer[7:] + pointer = re.sub(r":\d+(?::\d+)?$", "", pointer) + return pointer + + +# Path-shaped token in prose: optional ~/ ./ ../ / prefix, then at least one +# path segment. The lookbehind keeps the match from starting inside a word, a +# URL or an email; CJK characters do not block, so `见docs/x.md` still matches. +NAKED_POINTER_TOKEN_RE = re.compile( + r"(? str: + """Body after a leading YAML front-matter block; header metadata is not prose.""" + if not text.startswith("---"): + return text + lines = text.splitlines() + if not lines or lines[0].strip() != "---": + return text + for index in range(1, len(lines)): + if lines[index].strip() == "---": + return "\n".join(lines[index + 1 :]) + return text + + +def extract_naked_pointers(text: str) -> List[str]: + """File-shaped paths left in prose after links, code spans and code blocks are removed. + + Only suffix-bearing paths count: directory references in prose (a bare + `~/some/repo`) name a place far more often than they point at a read, and + flagging them would drown the signal. A leading front-matter block is + metadata, not prose — a path-valued key (CTX-09 `superseded_by`) is never + a naked pointer. + """ + text = _strip_frontmatter(text) + residual = re.sub(r"```.*?```", "", text, flags=re.DOTALL) + residual = re.sub(r"\[[^\]]*\]\([^)]+\)", "", residual) + residual = re.sub(r"`[^`\n]+`", "", residual) + found: List[str] = [] + for match in NAKED_POINTER_TOKEN_RE.finditer(residual): + token = match.group(0).rstrip(".,;:!?\"')") + if not token or token in found: + continue + if _is_placeholder(token): + continue + if token.startswith(("http://", "https://", "mailto:", "tel:", "#")): + continue + if token.startswith(("/tmp/", "/private/tmp/", "/var/folders/")): + continue + if Path(token).suffix.lower() not in POINTER_SUFFIXES: + continue + found.append(token) + return found + + +def find_repo_root(start: Path) -> Optional[Path]: + """Nearest enclosing git work tree; `.claude/` and `.agents/` docs address the repo root.""" + cursor = start + for _ in range(8): + if (cursor / ".git").exists(): + return cursor + if cursor.parent == cursor: + return None + cursor = cursor.parent + return None + + +def resolve_pointer( + pointer: str, + base_file: Path, + hub: Optional[Path] = None, + home: Optional[Path] = None, + config_roots: Optional[Sequence[Path]] = None, +) -> Optional[Path]: + if not pointer or _is_placeholder(pointer): + return None + cleaned = _strip_pointer(pointer) + lowered = cleaned.lower() + if lowered.startswith(("http://", "https://", "mailto:", "tel:", "#")): + return None + if not cleaned: + return None + expanded = Path(os.path.expanduser(cleaned)) + if expanded.is_absolute(): + if str(expanded).startswith(("/tmp/", "/private/tmp/", "/var/folders/")): + # Runtime scratch paths are never expected to exist at rest. + return None + return expanded + if cleaned.startswith(("./", "../")): + return (base_file.parent / expanded).resolve() + anchor = cleaned.split("/", 1)[0] + anchors: List[Path] = [base_file.parent] + repo_root = find_repo_root(base_file.parent) + if repo_root is not None and repo_root != base_file.parent: + anchors.append(repo_root) + if hub is not None: + anchors.append(hub) + if home is not None: + anchors.append(home) + if config_roots: + # Anchors follow the user's declared roots, never hardcoded layouts. + anchors.extend(config_roots) + if not any((root / anchor).exists() for root in anchors): + # A bare relative path only counts as a pointer when its first segment + # exists in one of the known roots. Otherwise it is prose about another repo. + return None + candidates: List[Path] = [(root / expanded).resolve() for root in anchors] + for candidate in candidates: + if candidate.exists(): + return candidate + return candidates[0] + + +def age_days(path: Path) -> Optional[float]: + """Age in days; None when stat fails — unknown age, never a fake zero.""" + try: + return max(0.0, (time.time() - path.stat().st_mtime) / 86400.0) + except OSError: + return None + + +def parse_date(value: str) -> Optional[datetime]: + value = (value or "").strip() + if not value: + return None + for fmt in ("%Y-%m-%d", "%Y/%m/%d", "%Y-%m-%dT%H:%M:%S%z", "%Y-%m-%d %H:%M:%S"): + try: + return datetime.strptime(value, fmt) + except ValueError: + continue + try: + return datetime.fromisoformat(value) + except ValueError: + return None diff --git a/external_plugins/guster/templates/hub/AGENTS.md b/external_plugins/guster/templates/hub/AGENTS.md new file mode 100644 index 00000000..b2bb8dc4 --- /dev/null +++ b/external_plugins/guster/templates/hub/AGENTS.md @@ -0,0 +1,23 @@ +# Guster Hub + +This repository is the data plane for agent context. The Guster plugin reads it; it does not replace it. + +## Map + +- Knowledge index: [{{KNOWLEDGE_PATH}}/README.md]({{KNOWLEDGE_PATH}}/README.md) +- Project registry: [{{PROJECTS_PATH}}/_registry.md]({{PROJECTS_PATH}}/_registry.md) +- Tool index: [{{TOOLS_PATH}}/README.md]({{TOOLS_PATH}}/README.md) +- Hub contract: [hub.yaml](hub.yaml) + +## Rules + +- One topic per knowledge file. Put durable, reusable knowledge in `{{KNOWLEDGE_PATH}}/general/` or `{{KNOWLEDGE_PATH}}/projects/`. +- Register a project in `{{PROJECTS_PATH}}/_registry.md` before adding `{{PROJECTS_PATH}}/{slug}.md`. +- State documents must carry `verified_at: YYYY-MM-DD`. +- File paths are markdown links or inline code, never naked in prose, so `guster doctor` can verify them (CTX-03). +- Code and tests remain the source of truth; this hub stores decisions and pointers. +- Never store credentials, company secrets, generated caches or scratch files here. + +## Optional modules + +Add `handoff/` or `reports/` only when the workflow needs them. diff --git a/external_plugins/guster/templates/hub/README.md b/external_plugins/guster/templates/hub/README.md new file mode 100644 index 00000000..e1b1e685 --- /dev/null +++ b/external_plugins/guster/templates/hub/README.md @@ -0,0 +1,18 @@ +# Guster Hub (Lite) + +A minimal data plane for the Guster plugin. It holds durable knowledge and project state; governance lives in the plugin. + +## Start + +```bash +guster hub status +guster scan +guster doctor --scope hub +``` + +## Add content + +- Knowledge: create one topic per file under `{{KNOWLEDGE_PATH}}/general/` or `{{KNOWLEDGE_PATH}}/projects/`, then add it to `{{KNOWLEDGE_PATH}}/README.md`. +- Project: add a row to `{{PROJECTS_PATH}}/_registry.md`, then create `{{PROJECTS_PATH}}/{slug}.md` with a `verified_at` date. +- Tool: add one directory under `{{TOOLS_PATH}}/` with its own `AGENTS.md`, then register it in `{{TOOLS_PATH}}/README.md`. +- Handoff and reports are optional modules. Add them only when the workflow needs them. diff --git a/external_plugins/guster/templates/hub/gitignore.tmpl b/external_plugins/guster/templates/hub/gitignore.tmpl new file mode 100644 index 00000000..9fa88ac4 --- /dev/null +++ b/external_plugins/guster/templates/hub/gitignore.tmpl @@ -0,0 +1,2 @@ +.DS_Store +*.log diff --git a/external_plugins/guster/templates/hub/hub.yaml.tmpl b/external_plugins/guster/templates/hub/hub.yaml.tmpl new file mode 100644 index 00000000..c04c25c3 --- /dev/null +++ b/external_plugins/guster/templates/hub/hub.yaml.tmpl @@ -0,0 +1,11 @@ +# yaml-language-server: $schema=https://raw.githubusercontent.com/Lumos-789/guster/main/schemas/hub.schema.json +schema_version: 2 +profile: lite +hub_version: 0.1.0 +min_guster: {{PLUGIN_VERSION}} +name: {{HUB_NAME}} +created_at: {{DATE}} +paths: + knowledge: {{KNOWLEDGE_PATH}} + projects: {{PROJECTS_PATH}} + tools: {{TOOLS_PATH}} diff --git a/external_plugins/guster/templates/hub/knowledge/README.md b/external_plugins/guster/templates/hub/knowledge/README.md new file mode 100644 index 00000000..ff1efcbd --- /dev/null +++ b/external_plugins/guster/templates/hub/knowledge/README.md @@ -0,0 +1,5 @@ +# Knowledge Index + +| File | Topic | +|---|---| +| `general/start-here.md` | How this hub is organized | diff --git a/external_plugins/guster/templates/hub/knowledge/general/start-here.md b/external_plugins/guster/templates/hub/knowledge/general/start-here.md new file mode 100644 index 00000000..b233ffee --- /dev/null +++ b/external_plugins/guster/templates/hub/knowledge/general/start-here.md @@ -0,0 +1,11 @@ +# Start Here + +This hub is the data plane. The Guster plugin discovers it, checks its structure and scores its health. + +## What goes where + +- `general/` — reusable principles, methods and tool notes that apply across projects. +- `projects/` — durable business and architecture knowledge for one project. +- the hub's project state lives outside this knowledge root and is listed in its registry. + +Keep one topic per file. Add every knowledge file to [the knowledge index](../README.md). diff --git a/external_plugins/guster/templates/hub/knowledge/projects/.gitkeep b/external_plugins/guster/templates/hub/knowledge/projects/.gitkeep new file mode 100644 index 00000000..8b137891 --- /dev/null +++ b/external_plugins/guster/templates/hub/knowledge/projects/.gitkeep @@ -0,0 +1 @@ + diff --git a/external_plugins/guster/templates/hub/projects/_registry.md.tmpl b/external_plugins/guster/templates/hub/projects/_registry.md.tmpl new file mode 100644 index 00000000..199ddfcf --- /dev/null +++ b/external_plugins/guster/templates/hub/projects/_registry.md.tmpl @@ -0,0 +1,8 @@ +# Project Registry + +**verified_at**: {{DATE}} + +> Register a project here before creating `{slug}.md` in this directory. + +| slug | Display name | Project path | Notes | +|---|---|---|---| diff --git a/external_plugins/guster/templates/hub/tools/README.md b/external_plugins/guster/templates/hub/tools/README.md new file mode 100644 index 00000000..471d00b7 --- /dev/null +++ b/external_plugins/guster/templates/hub/tools/README.md @@ -0,0 +1,30 @@ +# Tools + +This is the index for manual tools in this hub. The Lite profile ships no tool by default; add one only when it earns a place. + +## What belongs here + +- Run-once commands that a person or agent invokes deliberately. +- One directory per tool, with an `AGENTS.md` covering purpose, entry point, inputs, outputs, failure behavior and credential references. +- The smallest executable entry point needed to do the job. + +## What does not + +- Long-running services, cron jobs or background daemons. +- Skills or agent instructions; those belong in the plugin or project `.agents/`. +- Knowledge notes; those belong in `knowledge/`. +- Generated caches, logs or scratch files. + +## Index + +| Tool | Purpose | Entry point | Credentials | +|---|---|---|---| +| _(none yet)_ | | | | + +## Add a tool + +1. Create `/` next to this file. +2. Add an `AGENTS.md` with the contract above. +3. Add the entry point. +4. Add a row to the index. +5. Reference credentials by path or variable name only; never commit values. diff --git a/marketplace.json b/marketplace.json index c1a9a6ee..ca48b138 100644 --- a/marketplace.json +++ b/marketplace.json @@ -10,7 +10,10 @@ "url": "https://z.ai" }, "unlistedPlugins": [ - { "name": "openpencil", "source": "./external_plugins/openpencil" } + { + "name": "openpencil", + "source": "./external_plugins/openpencil" + } ], "plugins": [ { @@ -827,7 +830,9 @@ }, { "name": "excalidraw", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "Excalidraw", "displayName_i18n": { "en": "Excalidraw", @@ -850,7 +855,9 @@ "name": "photocraft", "icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/photocraft/icon.png", "source": "./external_plugins/photocraft", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "PhotoCraft", "displayName_i18n": { "en": "PhotoCraft", @@ -877,7 +884,9 @@ "name": "vectorcraft", "icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/vectorcraft/icon.png", "source": "./external_plugins/vectorcraft", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "VectorCraft", "displayName_i18n": { "en": "VectorCraft", @@ -904,7 +913,9 @@ "name": "pdfcraft", "icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/pdfcraft/icon.png", "source": "./external_plugins/pdfcraft", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "PdfCraft", "displayName_i18n": { "en": "PdfCraft", @@ -931,7 +942,9 @@ "name": "designcraft", "icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/designcraft/icon.png", "source": "./external_plugins/designcraft", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "DesignCraft", "displayName_i18n": { "en": "DesignCraft", @@ -958,7 +971,9 @@ "name": "wordcraft", "icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/wordcraft/icon.png", "source": "./external_plugins/wordcraft", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "WordCraft", "displayName_i18n": { "en": "WordCraft", @@ -985,7 +1000,9 @@ "name": "gridcraft", "icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/gridcraft/icon.png", "source": "./external_plugins/gridcraft", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "GridCraft", "displayName_i18n": { "en": "GridCraft", @@ -1012,7 +1029,9 @@ "name": "deckcraft", "icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/deckcraft/icon.png", "source": "./external_plugins/deckcraft", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "DeckCraft", "displayName_i18n": { "en": "DeckCraft", @@ -1039,7 +1058,9 @@ "name": "cadcraft", "icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/cadcraft/icon.png", "source": "./external_plugins/cadcraft", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "CADCraft", "displayName_i18n": { "en": "CADCraft", @@ -1066,7 +1087,9 @@ "name": "soundcraft", "icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/soundcraft/icon.png", "source": "./external_plugins/soundcraft", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "SoundCraft", "displayName_i18n": { "en": "SoundCraft", @@ -1149,7 +1172,9 @@ }, "category": "developer-tools", "icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/kicad/icon.png", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "KiCad", "displayName_i18n": { "en": "KiCad", @@ -1531,6 +1556,46 @@ "repository": "https://github.com/geer1895/rfauto", "license": "GPL-3.0-only", "icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/rfauto/icon.png" + }, + { + "name": "guster", + "source": "./external_plugins/guster", + "icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/guster/icon.png", + "description": "Discover, audit, plan and evolve agent context across projects, skills, tools, knowledge and credentials; optionally scaffold a lightweight Guster Hub for durable knowledge and project state.", + "description_i18n": { + "en": "Discover, audit, plan and evolve agent context across projects, skills, tools, knowledge and credentials; optionally scaffold a lightweight Guster Hub for durable knowledge and project state.", + "zh-CN": "发现、诊断、规划和演进全机 agent 上下文:项目、指令、Skill、工具、知识、状态与凭据引用;可初始化一个轻量 Guster Hub,承载长期知识与项目状态。" + }, + "version": "0.9.2", + "author": { + "name": "Lumos-789", + "url": "https://github.com/Lumos-789" + }, + "category": "developer-tools", + "keywords": [ + "agent", + "context", + "governance", + "skills", + "mcp", + "codex", + "zcode", + "dsh" + ], + "examplePrompts": [ + "Run a full context audit and show me the health score", + "Initialize this project with the standard .agents layout" + ], + "examplePrompts_i18n": { + "zh-CN": [ + "跑一遍全机上下文审计,给我健康分", + "用标准 .agents 布局初始化这个项目" + ] + }, + "displayName": "Guster", + "displayName_i18n": { + "zh-CN": "Guster" + } } ] -} \ No newline at end of file +} From a140e7b05cb9e25c054317594a5e476211d7d58b Mon Sep 17 00:00:00 2001 From: Menglei Li <57990306+Lumos-789@users.noreply.github.com> Date: Wed, 18 Nov 2026 21:50:56 +0800 Subject: [PATCH 2/3] =?UTF-8?q?guster=200.9.3:=20refresh=20payload=20?= =?UTF-8?q?=E2=80=94=20new=201-bit=20pixel=20icon=20+=20version=20bump?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../guster/.codex-plugin/plugin.json | 2 +- .../guster/.zcode-plugin/plugin.json | 2 +- external_plugins/guster/CHANGELOG.md | 36 +++++++++++++++++++ external_plugins/guster/README.md | 12 +++++-- external_plugins/guster/README_CN.md | 11 ++++-- .../guster/schemas/hub.schema.json | 8 +++++ .../guster/skills/guster/SKILL.md | 2 +- .../guster/skills/guster/reference/metrics.md | 6 +++- .../guster/src/guster/__init__.py | 2 +- external_plugins/guster/src/guster/cli.py | 28 +++++++-------- .../guster/src/guster/discover.py | 21 +++++------ external_plugins/guster/src/guster/layout.py | 31 ++++++++++++++++ external_plugins/guster/src/guster/metrics.py | 12 +++---- external_plugins/guster/src/guster/policy.py | 5 +-- external_plugins/guster/src/guster/report.py | 14 +++++--- marketplace.json | 2 +- 16 files changed, 141 insertions(+), 53 deletions(-) diff --git a/external_plugins/guster/.codex-plugin/plugin.json b/external_plugins/guster/.codex-plugin/plugin.json index 922b206b..7a2b2500 100644 --- a/external_plugins/guster/.codex-plugin/plugin.json +++ b/external_plugins/guster/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "guster", - "version": "0.9.2", + "version": "0.9.3", "description": "Discover, audit, plan and evolve agent context across projects, skills, tools, knowledge and credentials; optionally scaffold a lightweight Guster Hub for durable knowledge and project state.", "author": { "name": "Lumos-789", diff --git a/external_plugins/guster/.zcode-plugin/plugin.json b/external_plugins/guster/.zcode-plugin/plugin.json index bf75d92d..e7441f42 100644 --- a/external_plugins/guster/.zcode-plugin/plugin.json +++ b/external_plugins/guster/.zcode-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "guster", - "version": "0.9.2", + "version": "0.9.3", "description": "Discover, audit, plan and evolve agent context across projects, skills, tools, knowledge and credentials; optionally scaffold a lightweight Guster Hub for durable knowledge and project state.", "description_i18n": { "en": "Discover, audit, plan and evolve agent context across projects, skills, tools, knowledge and credentials; optionally scaffold a lightweight Guster Hub for durable knowledge and project state.", diff --git a/external_plugins/guster/CHANGELOG.md b/external_plugins/guster/CHANGELOG.md index b277acf4..2aa9d068 100644 --- a/external_plugins/guster/CHANGELOG.md +++ b/external_plugins/guster/CHANGELOG.md @@ -1,5 +1,41 @@ # Changelog +## 0.9.3 — 2026-11-18 + +The honest-third-party release: no measurement ships with a built-in list of +the author's own documents, no version drift can hide between the CLI and the +manifests, and no flag pretends to do something it does not. + +- **GCR is configured, not hardcoded** (breaking for the metric): the + governance complexity ratio counted five fixed framework doc names that only + exist in the original author's hub, so every third-party install measured + `0` and still looked scored. The list is now the hub's own `governance_docs` + key in `hub.yaml` (added to `schemas/hub.schema.json`); a hub that declares + no list reports GCR as `n/a` through the same empty-evidence rule as every + other dimension. `scores.gcr` no longer exists in any output — GCR was + documented as "reported, never scored", and now the JSON agrees. The + `governance-overlap` finding (more than 4 framework docs) still fires when + the list is declared. +- **`upgrade` compares the CLI too**: the command only diffed the three + manifests against each other, so a CLI that drifted from all of them stayed + green. The CLI `__version__` is now part of the comparison set and any + disagreement exits 2; `--json` reports a `versions` object (`cli`, `codex`, + `zcode`, `package`) instead of the old `manifests` map. +- **`export --format json` writes only the JSON report** (behavior change): + it used to write the Markdown report unconditionally and add a `.json` + sibling; with `--format json` the Markdown file is no longer produced. + `--format md` (the default) is unchanged. +- **Removed the dead `score --write` flag**: `cmd_score` never read it — + writing metrics is the default and `--no-write` is the real opt-out. +- **`.release-gate.json` left public tracking**: the local release-gate + allowlist now lives in the gitignored `.agents/` directory; the gate tool + reads it from either location. +- All five version sources (CLI, `pyproject.toml`, both plugin manifests, + `package.json`) realigned at 0.9.3; `test_manifest_versions_match` is green + again. + +Notable changes. Earlier history is in `git log`. + ## 0.9.2 — 2026-11-18 - New icon: a 1-bit pixel directory-tree base patrolled by four glowing diff --git a/external_plugins/guster/README.md b/external_plugins/guster/README.md index 392f621f..b5430a29 100644 --- a/external_plugins/guster/README.md +++ b/external_plugins/guster/README.md @@ -70,7 +70,7 @@ ln -s "$(pwd)/bin/guster" ~/.local/bin/guster | `guster link` | Check context pointers | | `guster export` | Export a redacted Markdown/JSON report | | `guster credentials` | List registered credentials by scope (company / personal) | -| `guster upgrade` | Check Codex/ZCode/package manifest versions | +| `guster upgrade` | Check that the CLI, Codex, ZCode and package versions agree | ## Configuration: roots and zones @@ -171,6 +171,12 @@ CHI = 0.20 SSR + 0.15 RBR + 0.15 PCR + 0.15 ICR configuration. Guster does not scan arbitrary file content for token shapes — that is the release gate's job; SIR only claims what it actually looked at. +**GCR** (governance complexity ratio) is reported next to the score, never in +it. It counts the framework documents named by the hub's `hub.yaml` +`governance_docs` list (looked up under the hub's `knowledge/general/` and +`~/.agents/wiki/`); a hub that declares no list has no governance fact to +measure, so GCR reports `n/a`, and no score is derived from it in any output. + Critical findings do not rescale CHI: they make `doctor` exit 3 (any `high` finding exits 2), and the score stays the weighted sum above. Treat the exit code as the gate and CHI as the trend. @@ -278,7 +284,7 @@ required, `keys`/`used_by`/`status` are optional): ## Safety -- Read-only on your workspace by default. `apply --yes`, `init --yes`, `hub init --yes` and `hub attach` are the only commands that change workspace files or Guster config on their own; `export` always writes a report file — `/context-health.md` by default, or the path you name with `--out` (plus a `.json` sibling with `--format json`). +- Read-only on your workspace by default. `apply --yes`, `init --yes`, `hub init --yes` and `hub attach` are the only commands that change workspace files or Guster config on their own; `export` always writes one report file — `/context-health.md` by default, or the path you name with `--out`. `--format json` writes only the `.json` report (no Markdown). - Guster keeps five files under its state directory (`~/.agents/guster/`, or `scoped//`): `config.json` (roots/zones/hub, written by `init`, `hub init`/`attach` and `zones`), `registry.json`, which every scanning command rewrites (`status` included, when no registry exists yet), `findings.json` from `doctor`, `metrics.jsonl` from `score`, and the transient `.lock` that serializes concurrent runs. `--no-write` suppresses the state writes of `scan`, `doctor`, `score` and `check` only. (`plans/` and `backups/` are directories, not files.) - Credential values are never persisted or printed; scans keep only paths and redacted shapes. - No automatic `git add`, `commit`, `push` or deploy. @@ -291,7 +297,7 @@ required, `keys`/`used_by`/`status` are optional): |---|---| | `0` | success — clean run, or findings no worse than `medium` | | `1` | tool/config error: malformed or unreadable plan, an apply that failed mid-operation and was rolled back, missing workspace root, invalid `config.json` (non-list `roots`, a bad root/zone/hub path, empty `roots`, no scan candidates — run `guster init`); `hub status` also returns 1 when the attached hub fails its checks | -| `2` | `doctor`/`check` found `high` (but no `critical`) findings; `score --fail-under` below target or CHI not computable; `hub validate` failed the lite contract; `link` found broken pointers; `upgrade` found disagreeing manifest versions | +| `2` | `doctor`/`check` found `high` (but no `critical`) findings; `score --fail-under` below target or CHI not computable; `hub validate` failed the lite contract; `link` found broken pointers; `upgrade` found disagreeing plugin versions | | `3` | `doctor`/`check` found `critical` findings | | `4` | `apply`, `init` or `hub init` refused the plan at preflight — nothing was touched (missing move source, existing destination, bad target type) | diff --git a/external_plugins/guster/README_CN.md b/external_plugins/guster/README_CN.md index 7e470494..e7bdb9db 100644 --- a/external_plugins/guster/README_CN.md +++ b/external_plugins/guster/README_CN.md @@ -68,7 +68,7 @@ ln -s "$(pwd)/bin/guster" ~/.local/bin/guster | `guster link` | 检查上下文指针 | | `guster export` | 导出脱敏 Markdown/JSON 报告 | | `guster credentials` | 按范围(公司 / 个人)列出已登记凭据 | -| `guster upgrade` | 检查 Codex/ZCode/package 版本一致性 | +| `guster upgrade` | 检查 CLI 与 Codex/ZCode/package 版本一致 | ## 配置:roots 与 zones @@ -157,6 +157,11 @@ CHI = 0.20 SSR + 0.15 RBR + 0.15 PCR + 0.15 ICR - **SIR** 敏感隔离率:凭据文件 + host 配置里的字面令牌。Guster 不扫描任意文件内容找 token 形状 —— 那是发布闸的职责;SIR 只声称它确实看过的东西。 +**GCR**(治理复杂度比)只随分数一起展示,从不计入 CHI。它统计的是 hub +`hub.yaml` 里 `governance_docs` 名单点到的框架文档(在 Hub `knowledge/general/` +与 `~/.agents/wiki/` 下查找);没声明名单的 Hub 没有可测的治理事实,GCR 记 +`n/a`,任何输出都不再从它派生分数。 + 严重 finding 不改写 CHI:它让 `doctor` 以 3 退出(任意 `high` 退出 2),分数仍是上面的加权和。门禁看退出码,CHI 看趋势。 某个维度没有证据时记为 `n/a` 并从加权和中剔除,而不是记 1.0:空分母表示「没测」,不是「满分」。某 scope 的所有维度都为空时,CHI 本身为 `n/a`。 @@ -221,7 +226,7 @@ Guster 读取 `~/.agents/credentials/registry.md`,并对照它检查发现的 ## 安全边界 -- 默认不写工作区:只有 `apply --yes`、`init --yes`、`hub init --yes` 和 `hub attach` 会自行改动工作区文件或 Guster 配置;`export` 总会写报告文件——默认 `/context-health.md`,或 `--out` 指定的路径(`--format json` 时另加 `.json` 姊妹文件)。 +- 默认不写工作区:只有 `apply --yes`、`init --yes`、`hub init --yes` 和 `hub attach` 会自行改动工作区文件或 Guster 配置;`export` 总会写一个报告文件——默认 `/context-health.md`,或 `--out` 指定的路径;`--format json` 只写 `.json` 报告(不再同时写 Markdown)。 - Guster 会在状态目录(`~/.agents/guster/` 或 `scoped//`)维护五个文件:`config.json`(roots/zones/hub,由 `init`、`hub init`/`attach` 和 `zones` 写入)、所有扫描类命令都会重写的 `registry.json`(`status` 在没有 registry 时也会写)、`doctor` 的 `findings.json`、`score` 的 `metrics.jsonl`,以及串行化并发运行的临时 `.lock`。`--no-write` 只对 `scan`、`doctor`、`score`、`check` 关闭本命令的状态写入。(`plans/` 与 `backups/` 是目录,不算文件。) - 永不持久化或输出凭据值;扫描只保留路径和脱敏形态。 - 不自动 `git add` / `commit` / `push` / 部署。 @@ -234,7 +239,7 @@ Guster 读取 `~/.agents/credentials/registry.md`,并对照它检查发现的 |---|---| | `0` | 成功——干净运行,或 finding 严重度不高于 `medium` | | `1` | 工具/配置错误:plan 损坏或不可读、执行中失败且已回滚的 apply、工作区根不存在、`config.json` 无效(`roots` 非列表、root/zone/hub 路径坏、`roots` 为空、无可扫候选——跑 `guster init`);已接入 hub 校验不过时 `hub status` 也返回 1 | -| `2` | `doctor`/`check` 发现 `high`(但无 `critical`)finding;`score --fail-under` 低于目标或 CHI 不可算;`hub validate` 未过 Lite 契约;`link` 发现断链;`upgrade` 发现各 manifest 版本不一致 | +| `2` | `doctor`/`check` 发现 `high`(但无 `critical`)finding;`score --fail-under` 低于目标或 CHI 不可算;`hub validate` 未过 Lite 契约;`link` 发现断链;`upgrade` 发现插件各版本不一致 | | `3` | `doctor`/`check` 发现 `critical` finding | | `4` | `apply`、`init` 或 `hub init` 在 preflight 拒绝了 plan——什么都没动(move 源不存在、目标已存在、目标类型不对) | diff --git a/external_plugins/guster/schemas/hub.schema.json b/external_plugins/guster/schemas/hub.schema.json index fa72921e..43f57f65 100644 --- a/external_plugins/guster/schemas/hub.schema.json +++ b/external_plugins/guster/schemas/hub.schema.json @@ -34,6 +34,14 @@ "description": "ISO date the hub was created.", "type": "string" }, + "governance_docs": { + "description": "File names this hub counts as primary context-governance framework docs, looked up under the hub knowledge/general and ~/.agents/wiki. Absent or empty means GCR is reported as n/a instead of measured.", + "type": "array", + "items": { + "type": "string", + "minLength": 1 + } + }, "paths": { "description": "Declared hub sections. Relative values are hub-relative and must not contain '..'; a hub may also declare external sections with absolute or ~/ paths. Schema 2 must declare knowledge and projects.", "type": "object", diff --git a/external_plugins/guster/skills/guster/SKILL.md b/external_plugins/guster/skills/guster/SKILL.md index 6ec55140..00d204c2 100644 --- a/external_plugins/guster/skills/guster/SKILL.md +++ b/external_plugins/guster/skills/guster/SKILL.md @@ -209,6 +209,6 @@ classification table for the user to approve, never silent. |---|---| | `0` | success — clean run, or findings no worse than `medium` | | `1` | tool/config error: malformed or unreadable plan, an apply that failed mid-operation and was rolled back, missing workspace root, invalid `config.json` (non-list `roots`, a bad root/zone/hub path, empty `roots`, no scan candidates — run `guster init`); `hub status` also returns 1 when the attached hub fails its checks | -| `2` | `doctor`/`check` found `high` (but no `critical`) findings; `score --fail-under` below target or CHI not computable; `hub validate` failed the lite contract; `link` found broken pointers; `upgrade` found disagreeing manifest versions | +| `2` | `doctor`/`check` found `high` (but no `critical`) findings; `score --fail-under` below target or CHI not computable; `hub validate` failed the lite contract; `link` found broken pointers; `upgrade` found disagreeing plugin versions | | `3` | `doctor`/`check` found `critical` findings | | `4` | `apply`, `init` or `hub init` refused the plan at preflight — nothing was touched (missing move source, existing destination, bad target type) | diff --git a/external_plugins/guster/skills/guster/reference/metrics.md b/external_plugins/guster/skills/guster/reference/metrics.md index fe7c2649..6944d8ce 100644 --- a/external_plugins/guster/skills/guster/reference/metrics.md +++ b/external_plugins/guster/skills/guster/reference/metrics.md @@ -14,7 +14,7 @@ resolution and git metadata. Nothing measures runtime token usage. | FRS | state freshness rate | ≥90% | state docs verified within 90 days / state docs | | PHR | pointer health rate | 100% | resolvable pointers / resolvable-looking pointers | | SIR | secret isolation rate | ≥95% | credential files that are unregistered, tracked, unverifiable or inline / credential files + inline tokens. Inline means host config, not arbitrary file content | -| GCR | governance complexity ratio | ≤0.5 | governance documents / 8; reported, never scored | +| GCR | governance complexity ratio | ≤0.5 | framework docs named by the hub.yaml `governance_docs` list / 8; n/a when the hub declares no list; reported, never scored — no `scores.gcr` exists | ## Targets @@ -31,6 +31,10 @@ resolution and git metadata. Nothing measures runtime token usage. - Secrets: 0 in git; 1 canonical root; 0 inline tokens. A file kept in place is accepted when `registry.md` declares it; an unreadable repository counts as unverified, never as clean. +- Governance: the hub's `hub.yaml` `governance_docs` list names the framework + documents GCR counts (under the hub's `knowledge/general/` and + `~/.agents/wiki/`). There are no shipped defaults — the names are per-hub + facts; a hub that declares no list reports GCR as `n/a`. ## No evidence means n/a diff --git a/external_plugins/guster/src/guster/__init__.py b/external_plugins/guster/src/guster/__init__.py index 30c9c1fa..7064b159 100644 --- a/external_plugins/guster/src/guster/__init__.py +++ b/external_plugins/guster/src/guster/__init__.py @@ -1,3 +1,3 @@ """Guster: agent context steward.""" -__version__ = "0.9.1" +__version__ = "0.9.3" diff --git a/external_plugins/guster/src/guster/cli.py b/external_plugins/guster/src/guster/cli.py index 9b3fbd11..8f6ef0eb 100644 --- a/external_plugins/guster/src/guster/cli.py +++ b/external_plugins/guster/src/guster/cli.py @@ -794,20 +794,17 @@ def cmd_export(args: argparse.Namespace) -> int: config = build_config(args) registry = do_scan(config, write=True) result = evaluate(registry, config) - report = render_report(registry, result["policy"], result["metrics"]) out = Path(args.out).expanduser() if args.out else config.state_dir / "context-health.md" - write_text(out, report) if args.format == "json": - json_out = out.with_suffix(".json") - save_json(json_out, { + out = out.with_suffix(".json") + save_json(out, { "registry": redacted_registry(registry), "policy": result["policy"], "metrics": result["metrics"], }) - if not args.quiet: - print(f"report: {out}") - print(f"json: {json_out}") - elif not args.quiet: + else: + write_text(out, render_report(registry, result["policy"], result["metrics"])) + if not args.quiet: print(f"report: {out}") return 0 @@ -852,15 +849,15 @@ def cmd_upgrade(args: argparse.Namespace) -> int: for key, value in manifests.items() if isinstance(value, dict) and value.get("exists") } + compared = {"cli": __version__, **versions} if args.json: - print(json_dumps({"plugin": __version__, "manifests": versions})) + print(json_dumps({"plugin": __version__, "versions": compared})) elif not args.quiet: - print(f"Guster CLI: {__version__}") - for key, version in versions.items(): + for key, version in compared.items(): print(f" {key}: {version or '(missing)'}") - if len(set(versions.values())) > 1: - print(" WARNING: manifest versions differ") - return 0 if len(set(versions.values())) <= 1 else 2 + if len(set(compared.values())) > 1: + print(" WARNING: plugin versions differ") + return 0 if len(set(compared.values())) <= 1 else 2 def build_parser() -> argparse.ArgumentParser: @@ -890,7 +887,6 @@ def build_parser() -> argparse.ArgumentParser: doctor.set_defaults(func=cmd_doctor) score = subparsers.add_parser("score", parents=[common], help="Compute metrics and CHI.") - score.add_argument("--write", action="store_true", help="Write metrics (default; kept for explicit scripts).") score.add_argument("--no-write", action="store_true", help="Do not write registry.json or append metrics.jsonl.") score.add_argument("--trend", action="store_true", help="Show the last 10 metric snapshots.") score.add_argument( @@ -981,7 +977,7 @@ def build_parser() -> argparse.ArgumentParser: creds = subparsers.add_parser("credentials", parents=[common], help="List registered credentials by scope.") creds.set_defaults(func=cmd_credentials) - upgrade = subparsers.add_parser("upgrade", parents=[common], help="Check plugin manifest versions.") + upgrade = subparsers.add_parser("upgrade", parents=[common], help="Check that the CLI and all plugin manifests agree.") upgrade.set_defaults(func=cmd_upgrade) return parser diff --git a/external_plugins/guster/src/guster/discover.py b/external_plugins/guster/src/guster/discover.py index 1d6ff469..60ead959 100644 --- a/external_plugins/guster/src/guster/discover.py +++ b/external_plugins/guster/src/guster/discover.py @@ -7,7 +7,7 @@ from typing import Any, Dict, List, Optional, Sequence, Set, Tuple from . import __version__ -from .layout import resolve_hub_layout +from .layout import load_governance_docs, resolve_hub_layout from .util import ( EXCLUDE_DIRS, find_git_roots, @@ -299,7 +299,7 @@ def scan(config: ScanConfig) -> Dict[str, Any]: credential_registry = scan_credential_registry(home) inline_bearers = scan_inline_bearers(home) if scope != "hub" else [] governance_docs = find_governance_docs(home, hub) - if scope == "hub" and hub: + if governance_docs is not None and scope == "hub" and hub: governance_docs = [ item for item in governance_docs if is_under(Path(item), hub) ] @@ -1005,25 +1005,22 @@ def scan_inline_bearers(home: Path) -> List[Dict[str, Any]]: return records -def find_governance_docs(home: Path, hub: Optional[Path]) -> List[str]: +def find_governance_docs(home: Path, hub: Optional[Path]) -> Optional[List[str]]: # Framework docs, not topic authorities. A doc that labels itself a facet # ("分册") belongs to the primary framework and does not compete with it. - named = { - "agent-context-map.md", - "codex-context-stack.md", - "context-engineering-principles.md", - "knowledge-taxonomy.md", - "project-agents-layout.md", - } + named = load_governance_docs(hub) + if named is None: + return None + wanted = set(named) candidates: List[Path] = [] if hub: general = resolve_hub_layout(hub)["knowledge"] / "general" if general.is_dir(): - candidates.extend(path for path in general.iterdir() if path.name in named) + candidates.extend(path for path in general.iterdir() if path.name in wanted) candidates.extend( path for path in (home / ".agents" / "wiki").glob("*.md") - if path.name in named + if path.name in wanted ) primary = [] for path in candidates: diff --git a/external_plugins/guster/src/guster/layout.py b/external_plugins/guster/src/guster/layout.py index e9380a2a..867c707c 100644 --- a/external_plugins/guster/src/guster/layout.py +++ b/external_plugins/guster/src/guster/layout.py @@ -101,6 +101,37 @@ def resolve_hub_layout(hub: Path) -> Dict[str, Path]: return resolved +def load_governance_docs(hub: Optional[Path]) -> Optional[List[str]]: + """Read the `governance_docs` file-name list from `/hub.yaml`. + + None means the hub declares no list, so governance complexity is not + applicable (n/a) rather than measured at zero; the framework doc names are + per-hub facts, never shipped defaults. + """ + if hub is None: + return None + manifest = Path(hub) / "hub.yaml" + if not manifest.is_file(): + return None + docs: List[str] = [] + in_block = False + for raw_line in read_text(manifest).splitlines(): + if not raw_line.strip() or raw_line.lstrip().startswith("#"): + continue + indent = len(raw_line) - len(raw_line.lstrip(" ")) + line = raw_line.strip() + if indent == 0: + in_block = line == "governance_docs:" + continue + if not in_block or not line.startswith("- "): + continue + name = line[2:].strip().strip("'\"") + if not name: + raise ValueError(f"governance_docs entry must name a file in {manifest}") + docs.append(name) + return docs or None + + def load_waivers(hub: Optional[Path]) -> List[Dict[str, str]]: """Read `doctor.waivers` from `/hub.yaml`. diff --git a/external_plugins/guster/src/guster/metrics.py b/external_plugins/guster/src/guster/metrics.py index a4c09aea..e707d650 100644 --- a/external_plugins/guster/src/guster/metrics.py +++ b/external_plugins/guster/src/guster/metrics.py @@ -22,7 +22,6 @@ } RBR_BUDGET_BYTES = 20_000 RBR_BUDGET_SKILL_CHARS = 6_000 -GCR_TARGET = 0.5 def dimensions_for_scope(scope: str) -> List[str]: @@ -54,7 +53,8 @@ def percent(value: Optional[float]) -> Optional[float]: def compute_metrics(registry: Dict[str, Any], policy_result: Dict[str, Any]) -> Dict[str, Any]: stats = policy_result.get("stats", {}) - governance_count = int(stats.get("governance_docs", 0)) + governance_declared = stats.get("governance_docs") is not None + governance_count = int(stats.get("governance_docs") or 0) topic_data = registry.get("topics") or {} topic_total = int(topic_data.get("total", 0)) @@ -103,8 +103,7 @@ def compute_metrics(registry: Dict[str, Any], policy_result: Dict[str, Any]) -> ) secret_total = int(stats.get("secret_total", 0)) + inline_bearers sir = None if secret_total <= 0 else 1.0 - min(1.0, secret_bad / secret_total) - gcr = governance_count / 8.0 if governance_count else 0.0 - gcr_score = 1.0 if gcr == 0 else min(1.0, GCR_TARGET / max(gcr, 0.01)) + gcr = governance_count / 8.0 if governance_declared else None dim_values: Dict[str, Optional[float]] = { "ssr": ssr, @@ -136,9 +135,8 @@ def compute_metrics(registry: Dict[str, Any], policy_result: Dict[str, Any]) -> metrics: Dict[str, Optional[float]] = { dim: (None if value is None else round(value, 4)) for dim, value in raw_values.items() } - metrics["gcr"] = round(gcr, 4) + metrics["gcr"] = None if gcr is None else round(gcr, 4) scores: Dict[str, Optional[float]] = {dim: percent(value) for dim, value in dim_values.items()} - scores["gcr"] = round(gcr_score * 100, 1) return { "generated_at": now_iso(), @@ -184,7 +182,7 @@ def compute_metrics(registry: Dict[str, Any], policy_result: Dict[str, Any]) -> "inline_bearers": inline_bearers, "git_probe_failures": int(stats.get("git_probe_failures", 0)), "scan_walk_errors": int(stats.get("scan_walk_errors", 0)), - "governance_docs": governance_count, + "governance_docs": governance_count if governance_declared else None, }, } diff --git a/external_plugins/guster/src/guster/policy.py b/external_plugins/guster/src/guster/policy.py index f98c81e1..c060b7ca 100644 --- a/external_plugins/guster/src/guster/policy.py +++ b/external_plugins/guster/src/guster/policy.py @@ -164,6 +164,7 @@ def resolve_registry_row_path(raw: str, hub_root: Path, home: Path) -> Optional[ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: findings: List[Dict[str, Any]] = [] + governance = registry.get("governance_docs") stats: Dict[str, Any] = { "pointers_checked": 0, "pointers_valid": 0, @@ -185,7 +186,7 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: "state_docs_fresh_from_mtime": 0, "duplicate_knowledge": 0, "note_headers_total": 0, - "governance_docs": len(registry.get("governance_docs", [])), + "governance_docs": None if governance is None else len(governance), "misplaced_entries": 0, "resident_entries": 0, "secret_total": 0, @@ -767,7 +768,7 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: ) # Governance document overlap - governance_docs = registry.get("governance_docs", []) + governance_docs = registry.get("governance_docs") or [] if len(governance_docs) > 4: findings.append( finding( diff --git a/external_plugins/guster/src/guster/report.py b/external_plugins/guster/src/guster/report.py index ad3b8023..960d43f0 100644 --- a/external_plugins/guster/src/guster/report.py +++ b/external_plugins/guster/src/guster/report.py @@ -239,10 +239,16 @@ def render_report( f"{raw.get('knowledge_unhashed')}._" ) lines.append("") - lines.append( - f"_Not counted in CHI: Governance simplicity {metrics.get('gcr')} " - f"(score {scores.get('gcr')}, {raw.get('governance_docs', 0)} docs)._" - ) + if metrics.get("gcr") is None: + lines.append( + "_Not counted in CHI: Governance simplicity n/a " + "(hub.yaml declares no governance_docs list)._" + ) + else: + lines.append( + f"_Not counted in CHI: Governance simplicity {metrics.get('gcr')} " + f"({raw.get('governance_docs', 0)} framework docs / 8; target ≤0.5)._" + ) lines.append("") lines.append("## Findings") lines.append("") diff --git a/marketplace.json b/marketplace.json index ca48b138..410b87d3 100644 --- a/marketplace.json +++ b/marketplace.json @@ -1566,7 +1566,7 @@ "en": "Discover, audit, plan and evolve agent context across projects, skills, tools, knowledge and credentials; optionally scaffold a lightweight Guster Hub for durable knowledge and project state.", "zh-CN": "发现、诊断、规划和演进全机 agent 上下文:项目、指令、Skill、工具、知识、状态与凭据引用;可初始化一个轻量 Guster Hub,承载长期知识与项目状态。" }, - "version": "0.9.2", + "version": "0.9.3", "author": { "name": "Lumos-789", "url": "https://github.com/Lumos-789" From 5000984ba93368c2ebe4e82a8b34cafefc329972 Mon Sep 17 00:00:00 2001 From: Menglei Li <57990306+Lumos-789@users.noreply.github.com> Date: Thu, 19 Nov 2026 03:37:44 +0800 Subject: [PATCH 3/3] =?UTF-8?q?guster=200.9.4:=20refresh=20payload=20?= =?UTF-8?q?=E2=80=94=20new=201-bit=20pixel=20icon=20+=20version=20bump?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../guster/.codex-plugin/plugin.json | 2 +- .../guster/.zcode-plugin/plugin.json | 2 +- external_plugins/guster/CHANGELOG.md | 102 +++++ external_plugins/guster/README.md | 59 +-- external_plugins/guster/README_CN.md | 48 +- .../guster/schemas/hub.schema.json | 8 +- .../guster/skills/guster-hub/SKILL.md | 18 +- .../guster/skills/guster/SKILL.md | 36 +- .../skills/guster/reference/framework.md | 2 +- .../guster/skills/guster/reference/metrics.md | 16 +- .../skills/guster/reference/placement.md | 5 +- .../skills/guster/reference/reformat.md | 11 +- .../guster/skills/guster/reference/spec.md | 73 ++- .../guster/src/guster/__init__.py | 2 +- external_plugins/guster/src/guster/cli.py | 75 ++- .../guster/src/guster/discover.py | 56 +-- external_plugins/guster/src/guster/hub.py | 54 ++- external_plugins/guster/src/guster/metrics.py | 2 - external_plugins/guster/src/guster/planner.py | 16 +- external_plugins/guster/src/guster/policy.py | 429 +++++++++++++++--- external_plugins/guster/src/guster/report.py | 37 +- external_plugins/guster/src/guster/util.py | 125 ++++- .../guster/templates/hub/AGENTS.md | 8 +- .../guster/templates/hub/README.md | 4 +- .../guster/templates/hub/hub.yaml.tmpl | 1 - .../general/knowledge-v1-skeleton.txt | 20 + .../hub/knowledge/general/start-here.md | 5 +- .../guster/templates/hub/projects/.gitkeep | 0 .../templates/hub/projects/_registry.md.tmpl | 8 - .../templates/hub/register/projects.yaml.tmpl | 19 + marketplace.json | 2 +- 31 files changed, 926 insertions(+), 319 deletions(-) create mode 100644 external_plugins/guster/templates/hub/knowledge/general/knowledge-v1-skeleton.txt create mode 100644 external_plugins/guster/templates/hub/projects/.gitkeep delete mode 100644 external_plugins/guster/templates/hub/projects/_registry.md.tmpl create mode 100644 external_plugins/guster/templates/hub/register/projects.yaml.tmpl diff --git a/external_plugins/guster/.codex-plugin/plugin.json b/external_plugins/guster/.codex-plugin/plugin.json index 7a2b2500..7ebe1c68 100644 --- a/external_plugins/guster/.codex-plugin/plugin.json +++ b/external_plugins/guster/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "guster", - "version": "0.9.3", + "version": "0.9.4", "description": "Discover, audit, plan and evolve agent context across projects, skills, tools, knowledge and credentials; optionally scaffold a lightweight Guster Hub for durable knowledge and project state.", "author": { "name": "Lumos-789", diff --git a/external_plugins/guster/.zcode-plugin/plugin.json b/external_plugins/guster/.zcode-plugin/plugin.json index e7441f42..3fca7b9c 100644 --- a/external_plugins/guster/.zcode-plugin/plugin.json +++ b/external_plugins/guster/.zcode-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "guster", - "version": "0.9.3", + "version": "0.9.4", "description": "Discover, audit, plan and evolve agent context across projects, skills, tools, knowledge and credentials; optionally scaffold a lightweight Guster Hub for durable knowledge and project state.", "description_i18n": { "en": "Discover, audit, plan and evolve agent context across projects, skills, tools, knowledge and credentials; optionally scaffold a lightweight Guster Hub for durable knowledge and project state.", diff --git a/external_plugins/guster/CHANGELOG.md b/external_plugins/guster/CHANGELOG.md index 2aa9d068..32e6076a 100644 --- a/external_plugins/guster/CHANGELOG.md +++ b/external_plugins/guster/CHANGELOG.md @@ -1,5 +1,107 @@ # Changelog +## 0.9.4 — 2026-11-19 + +The hub contract catches up with the reference hub's 2026-11-19 restructure, +and the format spec gains its first structured-knowledge contract. The plugin +still ships no organization policy — it discovers what exists and validates +what files declare. + +- **Root README.md is optional** (relaxation): required root files are now + `AGENTS.md` + `hub.yaml`; an existing root README.md stays untouched (no + check depends on it), and `hub init` still scaffolds one. +1 test. +- **Hub scan alias `output/`** joins `Human Output/` (kept as the legacy + alias) for evidence/deliverables directories. +- **Knowledge subzones are discovered, not enumerated**: the scanner no + longer hardcodes `general/` + `projects/` + `workgroups/` under the + knowledge root. Every first-level directory (`machines/`, or anything) is + scanned as knowledge and index-checked against `knowledge/README.md`. + Strict validation now index-checks `.yaml`/`.yml` notes, not only `.md`, + and only requires the knowledge root plus its README — no specific subzone + names. +- **CTX-10 becomes register/v1** (breaking, spec_version 2): the hub's human + project table moves from `projects/_registry.md` (markdown table) to + `register/projects.yaml` — a `schema: register/v1` + `kind: projects` + + `updated:` header with one row per project (`id`, `status`, `as_of`, + `name`, `spec.path`). `hub init` scaffolds it; validation requires it; the + three-way drift diff (machine table ↔ register ↔ disk) and the entry + counter follow. New `registry-format` finding: wrong `schema`/`kind`, duplicate ids, + missing `spec.path` or non-date `as_of`/`status` (a missing `updated` + date is caught by strict `hub validate`, not by the finding). +- **register/v1 shape errors fail loud**: a register whose body carries + column-0 `id:`/`name:` mapping keys but parses zero `- id:` rows (the flat + single-project map) now raises `registry-format` instead of silently + validating nothing. `hub validate`'s `updated:` check is strict ISO at the + same time — `2026/1/5` no longer passes, only `2026-01-05`. +- **register/v1 vocabulary clarified**: `status` adds `on-hold`; `as_of` is + optional (checked when present); `name` is optional and never validated; + `spec.path: ./` is the legal placeholder for a row that owns no directory + of its own; unknown row keys and `spec` subkeys are ignored and never + validated — the vocabulary only grows, semantics change only on a + spec_version bump. Another register/ YAML declaring register/v1 with a + foreign `kind:` gets an info finding: accepted as register data, never + validated. +- **CTX-11: the knowledge/v1 contract** (new, opt-in): a YAML knowledge file + that declares `schema: knowledge/v1` gets strict checks — required metadata + (`id` = file stem, `type` required with vocabulary, optional in-vocabulary + `status`, non-empty `topic`, + YYYY-MM-DD `as_of`/`updated` with `updated` ≥ `as_of`), `see_also` bare-id + cross-references resolved against the knowledge root, one-id-one-file, and + a 90-day freshness SLA for active `state`/`index` files. Plain notes are + never touched. Findings: `knowledge-format`, `see-also-broken`, + `duplicate-knowledge-id`, `knowledge-stale`. +- **knowledge/v1 typos stay visible**: a knowledge file that declares a + `knowledge/*` or `register/*` schema other than knowledge/v1 reports an + info finding instead of silently opting out of every check, and a + `see-also-broken` reference whose file exists without the v1 header says + so in the finding. CTX-02 accepts an equivalent two-column markdown index + (backticked path + topic). The hub scaffold gains an all-commented + knowledge/v1 skeleton (`knowledge/general/knowledge-v1-skeleton.txt`) and + the register template a commented example row. +- **Dependency-free metadata parsing**: `parse_yaml_head` / + `parse_register_rows` read only the column-0 metadata face of YAML files + (scalars, one inline list, nested `spec.path`); the prose body is never + parsed, so the plugin still runs on a stock Python install. +- All CTX-11/registry-format findings stay outside CHI (the registry-drift + discipline), so health scores remain comparable across the upgrade. +- **`plan move` stops writing pointers** (breaking for plan outputs): the + plan is mkdir + move with a backup; the automatic `.moved.md` + transition pointer at the old location is gone. It outlived its + referencers, re-triggered `misplaced-artifact`, and read as reversible + after the source was gone — update the referencers in the same pass + instead. +- **`guster link` removed**: the standalone pointer listing duplicated what + `doctor`'s `broken-pointer` finding already reports. The command, its + exit-code row and the report hint are gone. +- **Zone and hub `profile` retired**: `zones add --profile` is gone and + `config.json` zone entries are `{path}` only (a legacy `profile` key is + tolerated and ignored); `hub.yaml` loses `profile` (a leftover key is + ignored, and unknown top-level manifest keys no longer fail the JSON + Schema — local extensions validate too). +- **GCR leaves every output**: after 0.9.3 made it reported-only, the + governance metric is deleted — no `metrics.gcr`, no report footnote. The + `hub.yaml` `governance_docs` declaration and the `governance-overlap` + finding (more than 4 framework docs) stay. +- **Score output says what it measured**: a CHI that cannot be computed + prints how many dimensions were (`n/a / 100 (5/7 dims scored)`), trend + lines render `n/a` instead of `None`, and the output points at + `skills/guster/reference/metrics.md` for definitions and targets. The + machine-scope summary labels its skills line "(user-level roots only)", + `guster init`'s dry run lists the files it would create, and finding + paths resolve to one spelling (`/private/tmp` vs `/tmp` no longer mix). +- **Templates and both SKILL playbooks rewritten for the register (the + new-project onboarding step now drafts a register/v1 row); `project cards` + vocabulary retired across docs. +- **Migration from 0.9.3**: create `register/projects.yaml` (header: + `schema: register/v1`, `kind: projects`, `updated:` date; then one row per + project), delete the old `projects/_registry.md`, and re-run + `guster hub validate`. Until then `hub attach`/`hub status` refuse the hub + and doctor reports `registry-drift: Hub has no register/projects.yaml`. + 192 py + 2 node tests green (+26 over 0.9.3, covering dynamic subzones, yaml + index checks, register drift/format/shape and vocabulary, knowledge/v1 + typo visibility, the pointer/link/profile/GCR retirements and the score + output). + ## 0.9.3 — 2026-11-18 The honest-third-party release: no measurement ships with a built-in list of diff --git a/external_plugins/guster/README.md b/external_plugins/guster/README.md index b5430a29..2d2823e4 100644 --- a/external_plugins/guster/README.md +++ b/external_plugins/guster/README.md @@ -2,13 +2,13 @@ Guster is a distributable agent plugin that audits and evolves the context of a whole machine: projects, instruction files, skills, tools, knowledge, project state, evidence and credential references. It can also scaffold a lightweight Hub for durable knowledge and project state. -It is the **control plane** for agent context. A Guster Hub is the optional **data plane**: the local repository that holds project cards, knowledge, tools and reports. The plugin does not replace the hub; it discovers it, validates it, and helps keep it coherent. +It is the **control plane** for agent context. A Guster Hub is the optional **data plane**: the local repository that holds the project register, knowledge, tools and reports. The plugin does not replace the hub; it discovers it, validates it, and helps keep it coherent. ## Prior art The ideas are borrowed with credit; the implementation is guster's own. -- **Cline Memory Bank** — inspired the layered responsibilities of the files (project cards, knowledge, state) and the banking rhythm of refreshing them per working session; both banks are plain markdown. +- **Cline Memory Bank** — inspired the layered responsibilities of the files (project register, knowledge, state) and the banking rhythm of refreshing them per working session; both banks are plain markdown. - **Claude Code memory tool** — inspired the one-fact-per-file note shape and front-matter metadata; guster's note headers spell the keys `name`, `description`, `type`. - **Letta (MemGPT)** — inspired the label/limit abstraction of memory blocks behind guster's resident budgets. - **Mem0** — inspired the decide-first stance (ADD/UPDATE/DELETE/NOOP, soft invalidation by marking instead of deleting) behind plan/apply/waiver; a waiver greens the gate, not the score. @@ -59,7 +59,7 @@ ln -s "$(pwd)/bin/guster" ~/.local/bin/guster | `guster check` | `scan` + `doctor` + `score --trend` in one pass; exit code carries the doctor semantics | | `guster zones list/add/remove` | Manage the machine zones in `config.json` | | `guster plan findings` | Turn findings into a review checklist | -| `guster plan move` | Plan a move with backup and pointer | +| `guster plan move` | Plan a move with backup (no pointer is written) | | `guster plan init` | Plan a standard `.agents/` layout | | `guster apply ` | Dry-run by default; `--yes` writes with backup | | `guster init` | Initialize the state home or a project | @@ -67,7 +67,6 @@ ln -s "$(pwd)/bin/guster" ~/.local/bin/guster | `guster hub attach` | Attach an existing Hub without copying its content | | `guster hub status` | Show the Hub manifest and contract checks | | `guster hub validate` | Validate the lite Hub contract | -| `guster link` | Check context pointers | | `guster export` | Export a redacted Markdown/JSON report | | `guster credentials` | List registered credentials by scope (company / personal) | | `guster upgrade` | Check that the CLI, Codex, ZCode and package versions agree | @@ -80,7 +79,7 @@ ln -s "$(pwd)/bin/guster" ~/.local/bin/guster { "version": 1, "roots": ["/home/me/Projects"], - "zones": [{ "path": "/home/me/tools", "profile": "light" }], + "zones": [{ "path": "/home/me/tools" }], "scan_max_depth": 5 } ``` @@ -96,10 +95,11 @@ ln -s "$(pwd)/bin/guster" ~/.local/bin/guster want governed without pretending each tool is a project. A zone is scanned light-style: its `AGENTS.md`/`README.md` entry docs join the pointer and freshness checks, its `.env` files join the secret scan, and `.agents/` - slot compliance never applies. `profile` is recorded and must be - `light` or `full`; the scan itself is light for every zone today. + slot compliance never applies. An entry is `{path}` only; extra keys a + legacy config may still carry (e.g. a retired `profile`) are tolerated + and ignored. -Manage zones with the `zones` subcommand (`list`, `add --profile`, +Manage zones with the `zones` subcommand (`list`, `add `, `remove `); it writes `config.json` and applies the same validation. **First run without a config**: guster probes the conventional directories @@ -119,14 +119,17 @@ Guster/ ├── hub.yaml ├── knowledge/ │ ├── README.md -│ └── general/start-here.md +│ └── general/ +│ ├── start-here.md +│ └── knowledge-v1-skeleton.txt ├── projects/ -│ └── _registry.md +├── register/ +│ └── projects.yaml └── tools/ └── README.md ``` -`tools/` is present as an index and contract, with no tool preinstalled. `handoff/` and `reports/` are optional and are not created by the lite profile. The scanner skips missing optional directories. +`tools/` is present as an index and contract, with no tool preinstalled. `handoff/` and `reports/` are optional and are not created by the lite scaffold. The scanner skips missing optional directories. `guster hub init` refuses a non-empty target, writes a reviewable plan, and attaches the new Hub to `~/.agents/guster/config.json`. Use `guster hub attach --path ` for an existing Hub. @@ -138,7 +141,7 @@ guster hub init --path --knowledge notes --projects work --tools scripts - They are recorded in `hub.yaml` under `paths` and can be changed later. Paths must be relative to the Hub and must stay inside it. -Scanning follows the directories that exist, not a mode: `profile` in `hub.yaml` is only a label. A hub is scanned across its knowledge root (`general/`, `projects/` and `workgroups/` under it), the configured project state root, `handoff/`, `provision/`, `reports/`, `Human Output/`, `manuals/`, `cron-tasks/`, `openspec/`, `archive/`, `.agents/plans/` and `strategy.md` whenever those exist. Generated or runtime areas such as `out/`, `.manual-site/`, `.playwright-mcp/` and `.codegraph/` are not treated as knowledge sources. `--scope hub` is Hub-only; local wiki and machine-level secrets belong to the machine scope. +Scanning follows the directories that exist, not a mode: there is no `profile` concept in `hub.yaml` (a leftover key from an older version is ignored, as are unknown top-level manifest keys). Knowledge subzones are discovered, not enumerated — every first-level directory under the knowledge root (`general/`, `projects/`, `machines/`, ...) is scanned and index-checked. A hub is also scanned across the configured project state root, `register/`, `handoff/`, `provision/`, `reports/`, `output/` (legacy alias `Human Output/`), `manuals/`, `cron-tasks/`, `openspec/`, `archive/`, `.agents/plans/` and `strategy.md` whenever those exist. Generated or runtime areas such as `out/`, `.manual-site/`, `.playwright-mcp/` and `.codegraph/` are not treated as knowledge sources. `--scope hub` is Hub-only; local wiki and machine-level secrets belong to the machine scope. ## Health model @@ -157,9 +160,10 @@ CHI = 0.20 SSR + 0.15 RBR + 0.15 PCR + 0.15 ICR breakdown, so a low number says why instead of just being low. - **ICR** index coverage rate - **FRS** state freshness rate: share of state documents under the hub's - project root (`projects/`), `handoff/`, `provision/` and `.agents/plans/` - that were verified within the 90-day SLA. The denominator is those four - prefixes only — a hub `reports/` file or a machine-level note is not state. + project root (`projects/`), `register/`, `handoff/`, `provision/` and + `.agents/plans/` that were verified within the 90-day SLA. The denominator + is those prefixes only — a hub `reports/` file or a machine-level note is + not state. The date comes from a declared key — `verified_at` (canonical), the Chinese `最后更新` family or the English `Last updated:`/`updated:` — in the first 40 lines, or a date that opens the filename (`2026-11-05-…`, `20261105-…`); @@ -171,27 +175,25 @@ CHI = 0.20 SSR + 0.15 RBR + 0.15 PCR + 0.15 ICR configuration. Guster does not scan arbitrary file content for token shapes — that is the release gate's job; SIR only claims what it actually looked at. -**GCR** (governance complexity ratio) is reported next to the score, never in -it. It counts the framework documents named by the hub's `hub.yaml` -`governance_docs` list (looked up under the hub's `knowledge/general/` and -`~/.agents/wiki/`); a hub that declares no list has no governance fact to -measure, so GCR reports `n/a`, and no score is derived from it in any output. - Critical findings do not rescale CHI: they make `doctor` exit 3 (any `high` finding exits 2), and the score stays the weighted sum above. Treat the exit code as the gate and CHI as the trend. A dimension with no evidence is reported as `n/a` and dropped from the weighted sum instead of scoring 1.0: an empty denominator means "not measured", not -"perfect". When every dimension of a scope is empty, CHI itself is `n/a`. +"perfect". When every dimension of a scope is empty, CHI itself is `n/a`, and +the `score` headline says what it measured — `n/a / 100 (5/7 dims scored)`. +Metric definitions and targets live in +[`skills/guster/reference/metrics.md`](skills/guster/reference/metrics.md). ## Context format spec The metrics are static — filename stems, content hashes, path resolution, git dates — so they only see documents that keep the format contract. The contract is written down and versioned: [`skills/guster/reference/spec.md`](skills/guster/reference/spec.md) -(spec_version 1, rules `CTX-01..10` — `CTX-09` structured note header, `CTX-10` -machine-readable project registry — markdownlint-style stable IDs). It follows +(spec_version 2, rules `CTX-01..11` — `CTX-09` structured note header, + `CTX-10` register/v1 project register, `CTX-11` opt-in knowledge/v1 +structured knowledge contract — markdownlint-style stable IDs). It follows open conventions instead of inventing new ones: the open `AGENTS.md` format ([agents.md](https://agents.md)) for instruction files — discovery is nested and nearest-wins, the same discipline as CTX-01 (a nested `AGENTS.md` narrows @@ -277,7 +279,7 @@ required, `keys`/`used_by`/`status` are optional): 2. **Instruction** — `AGENTS.md` and policies. 3. **Capability** — skills, tools, MCP, plugins, scripts. 4. **Knowledge** — durable principles, methods, business semantics, pitfalls. -5. **State** — project cards, handoffs, environment and port registries. +5. **State** — the project register, handoffs, environment and port registries. 6. **Evidence** — reports, screenshots, videos, test output. 7. **Runtime** — sessions, caches, logs, temp files, browser profiles. 8. **Secret** — passwords, tokens, keys, cookies; references only. @@ -297,7 +299,7 @@ required, `keys`/`used_by`/`status` are optional): |---|---| | `0` | success — clean run, or findings no worse than `medium` | | `1` | tool/config error: malformed or unreadable plan, an apply that failed mid-operation and was rolled back, missing workspace root, invalid `config.json` (non-list `roots`, a bad root/zone/hub path, empty `roots`, no scan candidates — run `guster init`); `hub status` also returns 1 when the attached hub fails its checks | -| `2` | `doctor`/`check` found `high` (but no `critical`) findings; `score --fail-under` below target or CHI not computable; `hub validate` failed the lite contract; `link` found broken pointers; `upgrade` found disagreeing plugin versions | +| `2` | `doctor`/`check` found `high` (but no `critical`) findings; `score --fail-under` below target or CHI not computable; `hub validate` failed the lite contract; `upgrade` found disagreeing plugin versions | | `3` | `doctor`/`check` found `critical` findings | | `4` | `apply`, `init` or `hub init` refused the plan at preflight — nothing was touched (missing move source, existing destination, bad target type) | @@ -322,8 +324,9 @@ dsh plugin add /path/to/guster ### Extra skill roots By default guster scans `~/.agents/skills`, `~/.codex/skills`, `~/.dsh/skills` and -`~/.claude/skills`. Additional hosts stay local and are injected without changing -the published source: +`~/.claude/skills` (user-level roots only — project-local `.agents/skills/` +directories are not part of the skill scan). Additional hosts stay local and are +injected without changing the published source: ```bash export GUSTER_EXTRA_SKILL_ROOTS="name=/path/to/skills:other=/another/path" diff --git a/external_plugins/guster/README_CN.md b/external_plugins/guster/README_CN.md index e7bdb9db..537957aa 100644 --- a/external_plugins/guster/README_CN.md +++ b/external_plugins/guster/README_CN.md @@ -2,13 +2,13 @@ Guster 是一个可分发的 Agent 插件,用来审计和演进整台机器的上下文:项目、指令文件、Skill、工具、知识、项目状态、证据和凭据引用;也可以初始化一个轻量 Hub,承载长期知识与项目状态。 -它是上下文的**控制面**。Guster Hub 是可选的**数据面**:承载项目卡、知识、工具和报告的本地仓库。插件不替代 Hub,而是发现它、校验它,并帮助它保持自洽。 +它是上下文的**控制面**。Guster Hub 是可选的**数据面**:承载项目登记册、知识、工具和报告的本地仓库。插件不替代 Hub,而是发现它、校验它,并帮助它保持自洽。 ## 理念来源 理念皆有出处,实现是 guster 自己的: -- **Cline Memory Bank** —— 启发了分层文件的职责划分(项目卡、知识、状态)与每个工作会话刷新一次的 banking 节奏;两边的记忆库都是纯 markdown。 +- **Cline Memory Bank** —— 启发了分层文件的职责划分(项目登记册、知识、状态)与每个工作会话刷新一次的 banking 节奏;两边的记忆库都是纯 markdown。 - **Claude Code memory tool** —— 启发了「一事实一文件」的笔记形状与 front-matter 元数据;guster 的笔记头把这些键拼写为 `name`、`description`、`type`。 - **Letta (MemGPT)** —— 启发了 memory block 的 label/limit 抽象,guster 的常驻预算背后正是它。 - **Mem0** —— 启发了先裁决再动手的语义(ADD/UPDATE/DELETE/NOOP、以标记代删除的软失效),落到 plan/apply/waiver;waiver 只让门禁变绿,不改分数。 @@ -57,7 +57,7 @@ ln -s "$(pwd)/bin/guster" ~/.local/bin/guster | `guster check` | `scan` + `doctor` + `score --trend` 一条命令跑完;退出码承接 doctor 语义 | | `guster zones list/add/remove` | 管理 `config.json` 里的机器 zone | | `guster plan findings` | 把发现转成审阅清单 | -| `guster plan move` | 计划一次带备份和指针的移动 | +| `guster plan move` | 计划一次带备份的移动(不再自动写指针) | | `guster plan init` | 计划标准 `.agents/` 布局 | | `guster apply ` | 默认 dry-run;`--yes` 才写入 | | `guster init` | 初始化状态目录或项目布局 | @@ -65,7 +65,6 @@ ln -s "$(pwd)/bin/guster" ~/.local/bin/guster | `guster hub attach` | 接入已有 Hub,不复制其内容 | | `guster hub status` | 查看 Hub manifest 和契约检查 | | `guster hub validate` | 校验 Lite Hub 契约 | -| `guster link` | 检查上下文指针 | | `guster export` | 导出脱敏 Markdown/JSON 报告 | | `guster credentials` | 按范围(公司 / 个人)列出已登记凭据 | | `guster upgrade` | 检查 CLI 与 Codex/ZCode/package 版本一致 | @@ -78,7 +77,7 @@ ln -s "$(pwd)/bin/guster" ~/.local/bin/guster { "version": 1, "roots": ["/home/me/Projects"], - "zones": [{ "path": "/home/me/tools", "profile": "light" }], + "zones": [{ "path": "/home/me/tools" }], "scan_max_depth": 5 } ``` @@ -90,10 +89,10 @@ ln -s "$(pwd)/bin/guster" ~/.local/bin/guster 嵌套深的布局可以调大,巨大的目录树可以调小加速。 - **`zones`** —— 不是仓库的工具区:想让一个工具目录被治理、又不必把每个工具 当成项目。zone 按 light 方式扫描:其 `AGENTS.md`/`README.md` 入口文档进指针 - 与新鲜度检查,`.env` 进密钥扫描,`.agents/` 六槽合规永不适用。`profile` - 会被记录且只允许 `light`/`full`;当前扫描对所有 zone 都是 light 行为。 + 与新鲜度检查,`.env` 进密钥扫描,`.agents/` 六槽合规永不适用。条目只认 + `{path}`;旧配置可能残留的多余键(如已退役的 `profile`)容忍并忽略。 -zone 用 `zones` 子命令管理(`list`、`add --profile`、`remove `), +zone 用 `zones` 子命令管理(`list`、`add `、`remove `), 直接写 `config.json`,校验同上。 **没有 config 的首跑**:guster 探测约定目录 `~/Projects`、`~/code`、`~/dev`、 @@ -112,14 +111,17 @@ Guster/ ├── hub.yaml ├── knowledge/ │ ├── README.md -│ └── general/start-here.md +│ └── general/ +│ ├── start-here.md +│ └── knowledge-v1-skeleton.txt ├── projects/ -│ └── _registry.md +├── register/ +│ └── projects.yaml └── tools/ └── README.md ``` -`tools/` 只提供索引和收录契约,不预装任何工具;`handoff/`、`reports/` 仍是可选模块,Lite 档不创建,扫描器会跳过缺失的可选目录。 +`tools/` 只提供索引和收录契约,不预装任何工具;`handoff/`、`reports/` 仍是可选模块,Lite 脚手架不创建,扫描器会跳过缺失的可选目录。 `guster hub init` 会拒绝非空目录,先写可审阅的 plan,再把新 Hub 接入 `~/.agents/guster/config.json`。已有 Hub 用 `guster hub attach --path `。 @@ -131,7 +133,7 @@ guster hub init --path --knowledge notes --projects work --tools scripts - 它们记录在 `hub.yaml` 的 `paths` 下,之后也可以修改。路径必须是 Hub 内的相对路径。 -扫描按目录是否存在走,不是开关:`hub.yaml` 里的 `profile` 只是标签。Hub 只要有 knowledge 根(其下的 `general/`、`projects/`、`workgroups/`)、配置的项目状态根、`handoff/`、`provision/`、`reports/`、`Human Output/`、`manuals/`、`cron-tasks/`、`openspec/`、`archive/`、`.agents/plans/` 和 `strategy.md`,就会被扫到。`out/`、`.manual-site/`、`.playwright-mcp/`、`.codegraph/` 等生成物或运行态不作为知识源。`--scope hub` 只算 Hub;本地 wiki 和机器级凭据归机器范围。 +扫描按目录是否存在走,不是开关:`hub.yaml` 没有 `profile` 概念(旧版残留的键会被忽略,未知的 manifest 顶层键同样忽略)。knowledge 子区是动态发现的,不写死枚举——knowledge 根下任意一层目录(`general/`、`projects/`、`machines/`……)都会被扫描并做索引检查。Hub 只要有配置的项目状态根、`register/`、`handoff/`、`provision/`、`reports/`、`output/`(旧别名 `Human Output/`)、`manuals/`、`cron-tasks/`、`openspec/`、`archive/`、`.agents/plans/` 和 `strategy.md`,就会被扫到。`out/`、`.manual-site/`、`.playwright-mcp/`、`.codegraph/` 等生成物或运行态不作为知识源。`--scope hub` 只算 Hub;本地 wiki 和机器级凭据归机器范围。 ## 健康模型 @@ -146,9 +148,9 @@ CHI = 0.20 SSR + 0.15 RBR + 0.15 PCR + 0.15 ICR 分母只算 `.agents/` 目录本身 —— 从未采用该布局的仓库不计分,而「包含其他已扫描项目」 的目录(工作区或组根)不算项目。报告会打出不合格原因分布,低分能自己解释为什么低。 - **ICR** 索引覆盖率 -- **FRS** 状态新鲜度:Hub 项目卡目录(`projects/`)、`handoff/`、`provision/` - 与 `.agents/plans/` 四类状态文档中在 90 天 SLA 内核实过的比例;分母只认这四个 - 前缀,Hub `reports/` 或机器级笔记不算状态文档。日期取自前 40 行内的声明键—— +- **FRS** 状态新鲜度:Hub 项目目录(`projects/`)、`register/`、`handoff/`、 + `provision/` 与 `.agents/plans/` 各前缀下状态文档中在 90 天 SLA 内核实过的 + 比例;分母只认这些前缀,Hub `reports/` 或机器级笔记不算状态文档。日期取自前 40 行内的声明键—— `verified_at`(canonical)、中文 `最后更新` 族或英文 `Last updated:`/`updated:` ——或文件名开头处的日期(`2026-11-05-…`、`20261105-…`);都没有时依次兜底到 所属仓库最后一次 git 提交、再兜底文件 mtime(Raw 列会标注来源)。正文深处的 @@ -157,18 +159,14 @@ CHI = 0.20 SSR + 0.15 RBR + 0.15 PCR + 0.15 ICR - **SIR** 敏感隔离率:凭据文件 + host 配置里的字面令牌。Guster 不扫描任意文件内容找 token 形状 —— 那是发布闸的职责;SIR 只声称它确实看过的东西。 -**GCR**(治理复杂度比)只随分数一起展示,从不计入 CHI。它统计的是 hub -`hub.yaml` 里 `governance_docs` 名单点到的框架文档(在 Hub `knowledge/general/` -与 `~/.agents/wiki/` 下查找);没声明名单的 Hub 没有可测的治理事实,GCR 记 -`n/a`,任何输出都不再从它派生分数。 - 严重 finding 不改写 CHI:它让 `doctor` 以 3 退出(任意 `high` 退出 2),分数仍是上面的加权和。门禁看退出码,CHI 看趋势。 -某个维度没有证据时记为 `n/a` 并从加权和中剔除,而不是记 1.0:空分母表示「没测」,不是「满分」。某 scope 的所有维度都为空时,CHI 本身为 `n/a`。 +某个维度没有证据时记为 `n/a` 并从加权和中剔除,而不是记 1.0:空分母表示「没测」,不是「满分」。某 scope 的所有维度都为空时,CHI 本身为 `n/a`,`score` 标题行也会说明实际测了几个维度——`n/a / 100 (5/7 dims scored)`。指标定义与目标值见 +[`skills/guster/reference/metrics.md`](skills/guster/reference/metrics.md)。 ## 上下文格式规范 -指标全是静态的——文件名主干、内容哈希、路径解析、git 日期——所以只有守住格式契约的文档才被测得到。契约本身已写成文档并版本化:[`skills/guster/reference/spec.md`](skills/guster/reference/spec.md)(spec_version 1,规则 `CTX-01..10`——`CTX-09` 结构化条目头、`CTX-10` 机器可读项目登记表,markdownlint 式稳定编号)。它遵循开源惯例而不是另造一套:指令文件用 `AGENTS.md` 开放格式([agents.md](https://agents.md))——发现规则是嵌套 nearest-wins,与 CTX-01(嵌套只收窄、绝不矛盾)是同一条纪律,只认 `CLAUDE.md` 的宿主用 `ln -s AGENTS.md CLAUDE.md` 即可伺候——索引文件用 llms.txt 形态的链接列表([llmstxt.org](https://llmstxt.org))、笔记头用 YAML front-matter(Jekyll/Hugo/Gray Matter 共同坐实的业界事实标准)、规则编号学 markdownlint。 +指标全是静态的——文件名主干、内容哈希、路径解析、git 日期——所以只有守住格式契约的文档才被测得到。契约本身已写成文档并版本化:[`skills/guster/reference/spec.md`](skills/guster/reference/spec.md)(spec_version 2,规则 `CTX-01..11`——`CTX-09` 结构化条目头、`CTX-10` register/v1 项目登记册、`CTX-11` 可选加入的 knowledge/v1 契约,markdownlint 式稳定编号)。它遵循开源惯例而不是另造一套:指令文件用 `AGENTS.md` 开放格式([agents.md](https://agents.md))——发现规则是嵌套 nearest-wins,与 CTX-01(嵌套只收窄、绝不矛盾)是同一条纪律,只认 `CLAUDE.md` 的宿主用 `ln -s AGENTS.md CLAUDE.md` 即可伺候——索引文件用 llms.txt 形态的链接列表([llmstxt.org](https://llmstxt.org))、笔记头用 YAML front-matter(Jekyll/Hugo/Gray Matter 共同坐实的业界事实标准)、规则编号学 markdownlint。 不守契约的文档不是被扣分——而是彻底隐身:正文里裸写的路径永远到不了指针检查、「上周更新」落到 git 时间兜底、索引里没有文件名等于没索引。0.7.0 起 `naked-pointer` finding 从另一侧堵上这个缺口:指令文档/索引页里留在链接和代码记号之外的文件路径会被直接报告,写不规范的形态同时也是会被标记的形态。 @@ -219,7 +217,7 @@ Guster 读取 `~/.agents/credentials/registry.md`,并对照它检查发现的 2. **Instruction** — `AGENTS.md` 和策略。 3. **Capability** — Skill、工具、MCP、插件、脚本。 4. **Knowledge** — 稳定原则、方法、业务语义、坑。 -5. **State** — 项目卡、交接、环境和端口台账。 +5. **State** — 项目登记册、交接、环境和端口台账。 6. **Evidence** — 报告、截图、视频、测试输出。 7. **Runtime** — 会话、缓存、日志、临时文件、浏览器 profile。 8. **Secret** — 密码、token、key、cookie;只存引用。 @@ -239,7 +237,7 @@ Guster 读取 `~/.agents/credentials/registry.md`,并对照它检查发现的 |---|---| | `0` | 成功——干净运行,或 finding 严重度不高于 `medium` | | `1` | 工具/配置错误:plan 损坏或不可读、执行中失败且已回滚的 apply、工作区根不存在、`config.json` 无效(`roots` 非列表、root/zone/hub 路径坏、`roots` 为空、无可扫候选——跑 `guster init`);已接入 hub 校验不过时 `hub status` 也返回 1 | -| `2` | `doctor`/`check` 发现 `high`(但无 `critical`)finding;`score --fail-under` 低于目标或 CHI 不可算;`hub validate` 未过 Lite 契约;`link` 发现断链;`upgrade` 发现插件各版本不一致 | +| `2` | `doctor`/`check` 发现 `high`(但无 `critical`)finding;`score --fail-under` 低于目标或 CHI 不可算;`hub validate` 未过 Lite 契约;`upgrade` 发现插件各版本不一致 | | `3` | `doctor`/`check` 发现 `critical` finding | | `4` | `apply`、`init` 或 `hub init` 在 preflight 拒绝了 plan——什么都没动(move 源不存在、目标已存在、目标类型不对) | @@ -262,7 +260,7 @@ dsh plugin add /path/to/guster ### 额外 Skill 根 -默认扫描 `~/.agents/skills`、`~/.codex/skills`、`~/.dsh/skills` 和 `~/.claude/skills`。其他宿主保持在本机,通过环境变量注入,不改发布源: +默认扫描 `~/.agents/skills`、`~/.codex/skills`、`~/.dsh/skills` 和 `~/.claude/skills`(仅用户级根——项目内 `.agents/skills/` 目录不在 skill 扫描面内)。其他宿主保持在本机,通过环境变量注入,不改发布源: ```bash export GUSTER_EXTRA_SKILL_ROOTS="name=/path/to/skills:other=/another/path" diff --git a/external_plugins/guster/schemas/hub.schema.json b/external_plugins/guster/schemas/hub.schema.json index 43f57f65..9869b70c 100644 --- a/external_plugins/guster/schemas/hub.schema.json +++ b/external_plugins/guster/schemas/hub.schema.json @@ -2,22 +2,16 @@ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://raw.githubusercontent.com/Lumos-789/guster/main/schemas/hub.schema.json", "title": "Guster hub manifest", - "description": "Format contract for hub.yaml, the Guster hub manifest. Field semantics follow src/guster/layout.py and src/guster/hub.py. Guster reads values in their string form, so quoted and unquoted spellings of schema_version are equivalent.", + "description": "Format contract for hub.yaml, the Guster hub manifest. Field semantics follow src/guster/layout.py and src/guster/hub.py. Guster reads values in their string form, so quoted and unquoted spellings of schema_version are equivalent. Unknown top-level keys (e.g. a leftover `profile`) are ignored by the CLI, so local extensions validate too.", "type": "object", "required": [ "schema_version" ], - "additionalProperties": false, "properties": { "schema_version": { "description": "Manifest format major version; absent means 1.", "enum": ["1", "2", 1, 2] }, - "profile": { - "description": "Hub profile; any other value draws a `hub validate` warning.", - "type": "string", - "enum": ["lite", "full"] - }, "hub_version": { "description": "Version of the hub's own contract; informational, shown by `hub status`.", "type": "string" diff --git a/external_plugins/guster/skills/guster-hub/SKILL.md b/external_plugins/guster/skills/guster-hub/SKILL.md index 2bc955ff..a4517220 100644 --- a/external_plugins/guster/skills/guster-hub/SKILL.md +++ b/external_plugins/guster/skills/guster-hub/SKILL.md @@ -7,20 +7,23 @@ description: Create, attach or validate a lightweight Guster Hub data plane for The Hub is the data plane: a plain repository for durable knowledge and project state. The Guster plugin is the control plane and reads this repository; it does not replace it. -## Lite profile +## Lite hub The lite Hub intentionally ships only: - `AGENTS.md`, `README.md` and `hub.yaml` -- `knowledge/` with a single index and one starter note -- `projects/` with a project registry +- `knowledge/` with a single index, the `general/` starter note, an + all-commented knowledge/v1 skeleton next to it, and an empty `projects/` + subzone to grow into +- `register/projects.yaml`, the project table (register/v1: one row per + project, with a commented example row in the scaffold) - `tools/` with an index and inclusion rules, but no tool preinstalled It does **not** ship `handoff/` or `reports/`. Add those later only when the workflow needs them. Missing optional directories are ignored by the scanner. The three core roots default to `knowledge/`, `projects/` and `tools/`, but they are configurable. They live in `hub.yaml` under `paths`. -There is no mode switch: the scanner follows the directories that exist, and `profile` in `hub.yaml` is only a label. A fuller hub is also scanned across `handoff/`, `reports/`, `Human Output/`, `provision/`, `manuals/`, `cron-tasks/`, `openspec/`, `archive/`, `.agents/plans/`, `strategy.md` and `knowledge/workgroups/` when present. Generated directories such as `out/` are not knowledge sources. `--scope hub` excludes local wiki and machine-level secrets. +There is no mode switch: the scanner follows the directories that exist — `hub.yaml` has no `profile` concept, and a leftover key from an older version is ignored like any unknown top-level manifest key. Knowledge subzones are discovered, not enumerated: every first-level directory under the knowledge root (`general/`, `projects/`, `machines/`, ...) is scanned and index-checked, whatever it is named. A fuller hub is also scanned across `handoff/`, `reports/`, `register/`, `output/` (legacy alias `Human Output/`), `provision/`, `manuals/`, `cron-tasks/`, `openspec/`, `archive/`, `.agents/plans/` and `strategy.md` when present. Generated directories such as `out/` are not knowledge sources. `--scope hub` excludes local wiki and machine-level secrets. ## Workflow @@ -58,13 +61,14 @@ guster doctor --scope hub 4. Add content: -- Create one topic per file under `knowledge/general/` or `knowledge/projects/`. +- Create one topic per file under any first-level subzone of `knowledge/` (`general/`, `projects/`, ...). - Add the file name to `knowledge/README.md`. -- Register a project in `projects/_registry.md`, then create `projects/{slug}.md`. +- Register a project as a row in `register/projects.yaml` (id, status, as_of, name, spec.path); spec.path must resolve to the project directory on this machine. - Add a tool only when it is a run-once command: one directory with its own `AGENTS.md`, then a row in `tools/README.md`. - Put `verified_at: YYYY-MM-DD` in every state document (`最后更新:` is the accepted Chinese form; `verified_at` is canonical — see the format spec). - Optional structured header (CTX-09): front-matter that declares `type:` plus a date key (Obsidian properties convention) opts the note into machine checks. Keep truth sources as body markdown links, never as invented header keys. +- YAML knowledge files may opt into the knowledge/v1 contract (CTX-11) by declaring `schema: knowledge/v1` with `id/type/status/topic/as_of/updated` metadata; opted-in files get strict format, see_also cross-reference and freshness checks. The scaffold ships an all-commented skeleton (`knowledge/general/knowledge-v1-skeleton.txt`) showing every field. ## Existing hub @@ -74,7 +78,7 @@ If the directory already exists, use: guster hub attach --path ``` -`attach` validates the core layout and backs up the Guster config before changing the hub path. Legacy hubs without `hub.yaml` are accepted with warnings; `guster hub validate` is the strict lite-contract check. +`attach` validates the core layout and backs up the Guster config before changing the hub path. Legacy hubs without `hub.yaml` are accepted with warnings; `guster hub validate` is the strict lite-contract check. Upgrading a 0.9.3 hub: create `register/projects.yaml` (header `schema: register/v1`, `kind: projects`, `updated:` date, one row per project — the old `projects/_registry.md` table), delete `_registry.md`, then re-validate; see CHANGELOG 0.9.4. ## Boundaries diff --git a/external_plugins/guster/skills/guster/SKILL.md b/external_plugins/guster/skills/guster/SKILL.md index 00d204c2..e5d7a95b 100644 --- a/external_plugins/guster/skills/guster/SKILL.md +++ b/external_plugins/guster/skills/guster/SKILL.md @@ -7,7 +7,7 @@ description: Audit and evolve agent context across projects, skills, tools, know Guster is the control plane for agent context. It discovers projects, instruction files, skills, tools, knowledge, state, evidence and credential references; diagnoses drift; computes a health score; and produces reviewable migration plans. -Guster Hub is the data plane: the optional local repository that holds knowledge, project cards, tools and reports. Guster the plugin does not replace the hub. +Guster Hub is the data plane: the optional local repository that holds knowledge, the project register, tools and reports. Guster the plugin does not replace the hub. For a new data plane, use the companion `guster-hub` skill or `guster hub init`. @@ -16,7 +16,7 @@ For a new data plane, use the companion `guster-hub` skill or `guster hub init`. Use Guster when the user asks: - to inspect or reorganize the machine's agent context structure; -- where a file, skill, tool, project card, knowledge note or credential reference belongs; +- where a file, skill, tool, register entry, knowledge note or credential reference belongs; - to audit drift, duplicates, broken pointers, budgets or stale state; - to initialize a project with the standard `.agents/` layout; - to onboard a new project — place it, scaffold it and register it (see below); @@ -35,14 +35,14 @@ Four levels. `--scope` is inferred from `--root` when omitted. | Level | Command | Covers | Scored dimensions | |---|---|---|---| | machine | `guster doctor` | every repo under the workspace roots, declared `zones` and the hub | SSR RBR PCR ICR FRS PHR SIR | -| hub | `guster doctor --scope hub` | knowledge, project cards, tools, reports, handoffs | SSR ICR FRS PHR | +| hub | `guster doctor --scope hub` | knowledge, the project register, tools, reports, handoffs | SSR ICR FRS PHR | | group | `guster doctor --root A --root B [--root C]` | a requirement family or any set of related repos | SSR PCR ICR FRS PHR | | project | `guster doctor --root ` | one repository | SSR PCR ICR FRS PHR | Rules: - Machine level owns resident budgets, skill budgets and credential layout. -- Hub level owns knowledge indexing, project-card freshness and hub pointers. +- Hub level owns knowledge indexing, register freshness and hub pointers. - Group level exposes cross-repo facts: the same file name with different content, duplicated copies, and per-repo placement gaps. - Project level shows only that repo's findings and states how many machine-level @@ -84,7 +84,7 @@ guster score --trend guster score --fail-under 80 # optional gate: exit 2 when CHI is below the target guster check # scan + doctor + score --trend in one pass guster zones list # configured machine zones -guster zones add [--profile light|full] +guster zones add guster zones remove guster plan findings guster plan move --from --to @@ -96,7 +96,6 @@ guster hub init --path --yes guster hub attach --path guster hub status guster hub validate -guster link guster export --format md guster credentials guster upgrade @@ -142,10 +141,11 @@ not a healthy one. ## Format spec Context assets follow the versioned format contract in `reference/spec.md` -(CTX-01..10): `AGENTS.md` instruction files, llms.txt-shaped indexes, +(CTX-01..11): `AGENTS.md` instruction files, llms.txt-shaped indexes, machine-verifiable pointers, machine-readable dates, the six `.agents/` slots, -one home per fact, skill metadata budgets, credentials by reference, and the -machine-readable project registry table. When writing or moving a context +one home per fact, skill metadata budgets, credentials by reference, the +machine-readable project register (register/v1) and the opt-in knowledge/v1 +contract. When writing or moving a context asset, follow the spec; when a doctor finding fires, it names the rule that was broken. CTX-09 note headers also accept optional `name` and `description` keys (the one-fact-per-file shape inspired by the Claude Code memory tool) and @@ -174,11 +174,15 @@ orchestration of existing commands, not new machinery. scaffold the standard layout with `guster init --project ` — the default dry run lists the tree it will create, which also catches typos in the path — and apply with `--yes` once the user has read it. -5. **Register** — draft a CTX-10 row for the hub's `projects/_registry.md` - (slug, display name, project path, note) and hand it to the user to paste; - Guster does not edit hub content itself. +5. **Register** — draft a register/v1 row for the hub's + `register/projects.yaml` (id, status, as_of, name, spec.path and an + optional note; `as_of`/`name` are optional, unknown keys are ignored) and + hand it to the user to paste; Guster does not edit hub content itself. + `spec.path` resolves against the hub root (or `~` / absolute) and must + exist on disk — a row that owns no directory of its own uses the `./` + placeholder. 6. **Close the loop** — `guster scan` so the project enters the machine table, - then `guster doctor`: zero new findings (placement, registry row, freshness) + then `guster doctor`: zero new findings (placement, register row, freshness) is the definition of done. `guster check` adds a score baseline in the same pass. @@ -190,14 +194,14 @@ whose context predates the spec — run the playbook in findings as the worklist, one destination class each) → **placement** (`plan init` for the slots, one `plan move` or one batch plan for moves — paths final before pointers are written) → **content** (index lines, naked -paths to links, date lines, duplicates to pointer cards, per the CTX table) → +paths to links, date lines, duplicates to pointer notes, per the CTX table) → **verify** (`doctor` zero new findings, `score --trend` before/after). The pass is meaning-preserving; deletions and distillations are proposed in the classification table for the user to approve, never silent. ## References -- `reference/spec.md` — context format spec v1 (CTX rules and their findings). +- `reference/spec.md` — context format spec v2 (CTX rules and their findings). - `reference/reformat.md` — legacy context reformat playbook (four passes, classify-before-touch). - `reference/framework.md` — 1-3-5-8 framework and placement tree. - `reference/metrics.md` — metric definitions, targets and CHI. @@ -209,6 +213,6 @@ classification table for the user to approve, never silent. |---|---| | `0` | success — clean run, or findings no worse than `medium` | | `1` | tool/config error: malformed or unreadable plan, an apply that failed mid-operation and was rolled back, missing workspace root, invalid `config.json` (non-list `roots`, a bad root/zone/hub path, empty `roots`, no scan candidates — run `guster init`); `hub status` also returns 1 when the attached hub fails its checks | -| `2` | `doctor`/`check` found `high` (but no `critical`) findings; `score --fail-under` below target or CHI not computable; `hub validate` failed the lite contract; `link` found broken pointers; `upgrade` found disagreeing plugin versions | +| `2` | `doctor`/`check` found `high` (but no `critical`) findings; `score --fail-under` below target or CHI not computable; `hub validate` failed the lite contract; `upgrade` found disagreeing plugin versions | | `3` | `doctor`/`check` found `critical` findings | | `4` | `apply`, `init` or `hub init` refused the plan at preflight — nothing was touched (missing move source, existing destination, bad target type) | diff --git a/external_plugins/guster/skills/guster/reference/framework.md b/external_plugins/guster/skills/guster/reference/framework.md index 61667f27..ed77c737 100644 --- a/external_plugins/guster/skills/guster/reference/framework.md +++ b/external_plugins/guster/skills/guster/reference/framework.md @@ -29,7 +29,7 @@ If one container mixes two values on any axis, split it. 2. Instruction: AGENTS.md and policies. 3. Capability: skills, tools, MCP, plugins, scripts. 4. Knowledge: durable principles, methods, business semantics, pitfalls. -5. State: project cards, handoffs, environment and port registries. +5. State: the project register, handoffs, environment and port registries. 6. Evidence: reports, screenshots, videos, test output. 7. Runtime: sessions, caches, logs, temp files, browser profiles. 8. Secret: passwords, tokens, keys, cookies; references only. diff --git a/external_plugins/guster/skills/guster/reference/metrics.md b/external_plugins/guster/skills/guster/reference/metrics.md index 6944d8ce..f8b43577 100644 --- a/external_plugins/guster/skills/guster/reference/metrics.md +++ b/external_plugins/guster/skills/guster/reference/metrics.md @@ -14,7 +14,17 @@ resolution and git metadata. Nothing measures runtime token usage. | FRS | state freshness rate | ≥90% | state docs verified within 90 days / state docs | | PHR | pointer health rate | 100% | resolvable pointers / resolvable-looking pointers | | SIR | secret isolation rate | ≥95% | credential files that are unregistered, tracked, unverifiable or inline / credential files + inline tokens. Inline means host config, not arbitrary file content | -| GCR | governance complexity ratio | ≤0.5 | framework docs named by the hub.yaml `governance_docs` list / 8; n/a when the hub declares no list; reported, never scored — no `scores.gcr` exists | + +## Score transforms + +- RBR: each sub-ratio (entry bytes / 20 KB, skill chars / 6,000) becomes + `min(1, 1/ratio)` and the two transformed scores are averaged — that score is + what enters CHI. The report's Value column shows the mean of the raw ratios + instead: budget used, lower is better. +- ICR: an unweighted mean of two heterogeneous coverage ratios (knowledge + files indexed, `.agents/` dirs with an index). When one denominator dwarfs + the other, the equal-weight average lets the small side dominate the + dimension. ## Targets @@ -31,10 +41,6 @@ resolution and git metadata. Nothing measures runtime token usage. - Secrets: 0 in git; 1 canonical root; 0 inline tokens. A file kept in place is accepted when `registry.md` declares it; an unreadable repository counts as unverified, never as clean. -- Governance: the hub's `hub.yaml` `governance_docs` list names the framework - documents GCR counts (under the hub's `knowledge/general/` and - `~/.agents/wiki/`). There are no shipped defaults — the names are per-hub - facts; a hub that declares no list reports GCR as `n/a`. ## No evidence means n/a diff --git a/external_plugins/guster/skills/guster/reference/placement.md b/external_plugins/guster/skills/guster/reference/placement.md index 94c26631..f230e0f7 100644 --- a/external_plugins/guster/skills/guster/reference/placement.md +++ b/external_plugins/guster/skills/guster/reference/placement.md @@ -17,13 +17,14 @@ User instructions remain a single canonical file with host symlinks. ```text / +├── register/ # state — project register (register/projects.yaml, CTX-10) ├── projects/ # state ├── handoff/ # state -├── knowledge/ # knowledge +├── knowledge/ # knowledge — subzones are discovered, not fixed (general/, projects/, machines/, ...) ├── provision/ # state ├── tools/ # capability ├── reports/ # evidence -├── Human Output/ # evidence / deliverables +├── output/ # evidence / deliverables (legacy alias: Human Output/) └── .agents/ # local plans and scratch ``` diff --git a/external_plugins/guster/skills/guster/reference/reformat.md b/external_plugins/guster/skills/guster/reference/reformat.md index b2a04fad..64a54bec 100644 --- a/external_plugins/guster/skills/guster/reference/reformat.md +++ b/external_plugins/guster/skills/guster/reference/reformat.md @@ -56,8 +56,8 @@ from the first inventory to the final verify. - The slot a `misplaced-artifact` finding suggests is shape-based — classification can override it (a finished review report is a wiki conclusion, not a live plan). -- One artifact: `guster plan move --from --to ` (backup plus a - pointer at the old location on apply). +- One artifact: `guster plan move --from --to ` (backup on apply; + no pointer is written — every referencer is updated in pass 3 instead). - A batch: hand-write one plan JSON — `version: 1`, an `operations` list of `mkdir`/`move`/`write` objects, same shape `plan move` emits — covering the whole destination slot, then `guster apply ` dry-run, read it with the @@ -76,15 +76,16 @@ from the first inventory to the final verify. | Non-canonical duplicate | Replace with a pointer card: front-matter `type: pointer` plus a date key, truth links in the body; volatile values are deleted, not copied | CTX-06, CTX-09 | | Instruction file over budget or contradicting a narrower one | Cut or split — nesting narrows, never contradicts | CTX-01 | | Referencer still pointing at a pre-move path | Update it to the new path (doctor reports each as `broken-pointer`); `~`-prefixed links are resolved against home, so cross-repo pointers to a hub stay verifiable | CTX-03 | -| `.moved.md` left by an applied move | Delete once every referencer is updated — a transition pointer nobody reads re-triggers `misplaced-artifact`; keep it only for referencers outside your control | CTX-05 | +| Leftover `.moved.md` transition pointer (older guster versions wrote them on apply) | Delete once every referencer is updated — a transition pointer nobody reads re-triggers `misplaced-artifact`; keep it only for referencers outside your control | CTX-05 | Content edits are ordinary file edits by the agent; plans are for moves. ## Pass 4 — Verify 1. `guster doctor` — the pass kept the contract iff zero new findings appear. -2. `guster link` for a pointer-only check; `guster score --trend` for the - before/after number to hand the user. +2. `guster score --trend` for the before/after number to hand the user; + `doctor`'s `broken-pointer`/`naked-pointer` findings are the pointer + check. 3. Committing is the user's workflow; guster never auto-commits. ## Scale and review diff --git a/external_plugins/guster/skills/guster/reference/spec.md b/external_plugins/guster/skills/guster/reference/spec.md index 8edd6af9..ecc58117 100644 --- a/external_plugins/guster/skills/guster/reference/spec.md +++ b/external_plugins/guster/skills/guster/reference/spec.md @@ -1,6 +1,6 @@ # Context Format Spec -spec_version: 1. The format contract for context assets — the shapes that let +spec_version: 2. The format contract for context assets — the shapes that let both an agent and `guster doctor` verify a document without reading minds. Each rule carries a stable ID (markdownlint style) and names the finding that mechanically enforces it. What no finding enforces is guidance for the agent @@ -30,7 +30,7 @@ that writes the document. | ID | Rule | Enforced by | |---|---|---| | CTX-01 | `AGENTS.md` is the instruction file; nested ones narrow, never contradict. Budgets: hub ≤50 lines, user entry ≤150 lines, resident total ≤20 KB. | `resident-budget` | -| CTX-02 | Every knowledge scope has a README index in llms.txt shape; every knowledge file appears there verbatim, as `- [title](path): one-line description`. An index that names nothing is empty. | `orphan-knowledge` | +| CTX-02 | Every knowledge scope has a README index in llms.txt shape; every knowledge file appears there verbatim, as `- [title](path): one-line description`; an equivalent two-column markdown table (backticked path + topic) is accepted. An index that names nothing is empty. | `orphan-knowledge` | | CTX-03 | Any file path in an instruction or index document is machine-verifiable: a markdown link or inline code, never naked in prose. A pointer also states when to read the target. | `broken-pointer`, `naked-pointer` | | CTX-04 | State documents carry a machine-readable date. The canonical key is `verified_at: YYYY-MM-DD`; the Chinese prose keys (`最后更新`/`更新时间`/`更新于`/`最近核实`/`最后核实`/`已核实`) and the English prose keys (`Last updated:`/`updated:`) are accepted equivalents within the first 40 lines, as is a date that opens the filename. Without a declared date the ladder falls back to the repository's last git commit, then to file mtime; no signal at all means stale. | `stale-state` | | CTX-05 | `.agents/` has exactly the six slots — `plans/`, `wiki/`, `evidence/`, `skills/`, `tmp/`, `archive/` — plus `README.md`/`AGENTS.md`. Task bundles live in a slot, never at the top level. | `misplaced-artifact` | @@ -38,24 +38,75 @@ that writes the document. | CTX-07 | Skill frontmatter carries `name` and `description` only; one trigger sentence, ≤500 chars each, ≤6,000 chars across the library. | `skill-budget` | | CTX-08 | Credentials appear by reference — a path in the registry under the canonical root — never as a value in a document, a config or git. | `secret-in-git`, `secret-outside-root`, `secret-inline`, `secret-undeclared`, `secret-missing` | | CTX-09 | A knowledge note may carry YAML front-matter following the Obsidian properties convention (the interchange format Foam/Quartz/Logseq also accept). The header is opt-in: it is machine-checked only when it declares `type:`. A checked header must parse and carry a machine-readable date (`updated`/`date`/`lastmod`/`created` as YYYY-MM-DD), and the note's body then joins the CTX-03 pointer scan — truth sources go in the body as links, never as invented header keys. Optional keys: `name` and `description` state what the note is (the one-fact-per-file shape inspired by the Claude Code memory tool), and `superseded_by` names the path or stem of the note that replaced this one; that key is metadata about the note, not a truth source, so it never joins the pointer scan and never raises a finding. | `note-header-malformed`, `broken-pointer`, `naked-pointer` | -| CTX-10 | The hub's project registry (`projects/_registry.md`) is a machine-readable table. The header row names the columns; whichever column header contains `path` or `路径` is the path column, and each row's cell there holds one project location — `~/...`, absolute, or relative to the hub root. The slug column (first column) never counts as a path. Remote forms (`host:/path`, URLs) and placeholder cells (`-`, `—`) are skipped, not resolved. | `registry-drift` | +| CTX-10 | The hub's project register (`register/projects.yaml`) follows the register/v1 format: a `schema: register/v1` + `kind: projects` + `updated:` header, then one row per project — top-level `- id:` list items under the `projects:` key — with `id` (unique), `status` (active, pending, on-hold, stale, retired; optional but in-vocabulary), `as_of` (YYYY-MM-DD, optional; checked when present), `name` (optional, never validated) and `spec.path`. v1 validates this one table; a register/ YAML that declares register/v1 with another `kind:` gets an info finding, not errors. `spec.path` is the project location — `~/...`, absolute, or relative to the hub root — and must resolve to a directory on this machine; `./` is the legal placeholder for a row with no directory of its own. Unknown row keys and spec subkeys are ignored and never validated; the vocabulary only grows — semantics change only on a spec_version bump. Remote forms (`host:/path`, URLs) are counted apart, never resolved. | `registry-drift`, `registry-format` | +| CTX-11 | A YAML knowledge file may declare `schema: knowledge/v1` to opt into the structured knowledge contract. An opted-in file must carry, at the top level: `id` (equal to the file stem), `type` (state, howto, principle, pitfall, decision, index, reference), `status` (active, dormant, superseded, archived; optional but must be in-vocabulary), `topic` (non-empty one-liner), `as_of` and `updated` (YYYY-MM-DD, `updated` ≥ `as_of`), and optionally `see_also` — an inline list of **ids of other files in the same knowledge root** (bare ids only; path-like references belong in the body under CTX-03). Local extensions (zone, host, history, ...) are allowed and ignored. Freshness: active `state`/`index` files older than 90 days (`updated`) raise `knowledge-stale`. | `knowledge-format`, `see-also-broken`, `duplicate-knowledge-id`, `knowledge-stale` | ### CTX-10 in detail -The registry table is read through its path column, so a row is only as good -as its path cell. Conventions that keep the three-way diff (machine table -`registry.json` ↔ this human table ↔ git roots on disk) meaningful: +The register is read through `spec.path`, so a row is only as good as its +path. Conventions that keep the three-way diff (machine table `registry.json` +↔ this register ↔ git roots on disk) meaningful: -- Header row first: the parser finds the path column by header name - (`path` / `路径`, case-insensitive) and never guesses by position. -- One project per row; the path cell names the project **directory**, not a - file inside it. Trailing `/` and wrapping backticks are tolerated. +- One project per row; `spec.path` names the project **directory** (or a + knowledge-backed entry such as a topic file — `spec.path: ./` is the legal + placeholder when the row owns no directory), not an arbitrary file. - `~/`-relative paths resolve against the user's home; bare relative paths resolve against the **hub root**; absolute paths resolve as-is. +- A malformed header (wrong `schema`/`kind`), a duplicated `id`, a missing + `spec.path` or a non-date `as_of` raises `registry-format` (medium); so does + a register that parses zero rows while column-0 `id:`/`name:` keys betray a + flat single-project map. The header `updated:` date is not part of that + check — strict `guster hub validate` reports it instead, doctor does not. +- Unknown row keys and `spec` subkeys (owner, repo, priority, tags, ...) are + ignored and never validated; the vocabulary only grows — semantics change + only on a spec_version bump. - A row whose path does not exist on disk is a dead row (`registry-drift`, medium); a row that exists but is never scanned points outside the configured roots (medium); a scanned project with no row is unregistered (low). Remote references are counted apart instead of drifting forever. +- register/v1 validates `kind: projects` only. Another YAML under register/ + that declares register/v1 with a different `kind:` reports an info finding: + accepted as register data, never validated. + +### CTX-11 in detail + +The knowledge/v1 contract is opt-in and metadata-only: the plugin reads the +column-0 keys of the YAML file (scalars, one inline list for `see_also`) and +never parses the `body`. That keeps the check dependency-free and the prose +free-form. A minimal complete file, saved as a `.yaml` under the knowledge +root (e.g. `knowledge/general/deploy-checklist.yaml`): + +```yaml +schema: knowledge/v1 +id: deploy-checklist +type: howto +status: active +topic: One-line topic +as_of: 2026-01-01 +updated: 2026-01-01 +see_also: [ci-pipeline] +body: | + Free-form prose; the checker never parses past the metadata face. +``` + +- `see_also` accepts bare ids; each id must belong to a file that also + declares knowledge/v1 in the same knowledge root (reference a plain note + and the checker cannot see its id — a see_also id whose file exists without + the header says so in the finding). Path-like or remote references are + left to CTX-03 and never flagged here. +- One id, one file: the same id in two files (even across subzones) raises + `duplicate-knowledge-id`. +- A file that declares a `knowledge/*` or `register/*` schema other than + knowledge/v1 reports an info finding (declares X — current supported is + knowledge/v1): a typo'd declaration stays visible instead of silently + opting out of every check. +- Freshness applies only to active `state` and `index` types — principles and + references do not rot. The 90-day window is fixed, not configurable from + hub.yaml; setting `status: dormant` (or `superseded`/`archived`) is the + only way to take a file out of the SLA deliberately. +- Subzones under the knowledge root are discovered, not enumerated: + `general/`, `projects/`, `machines/` or any first-level directory is scanned + and index-checked the same way. ### Credential registry table @@ -92,7 +143,7 @@ what keeps the contract from drifting. Both directions are load-bearing. When creating or moving a context asset: 1. Pick the home by CTX-06, the slot by CTX-05, the index entry by CTX-02; a - new project gets its registry row by CTX-10. + new project gets its register row by CTX-10. 2. Write pointers as `[label](relative/path.md)` in indexes and `` `path` `` in prose; add when-to-read in the same sentence. 3. Add the date line before saving a state document; run `guster doctor` diff --git a/external_plugins/guster/src/guster/__init__.py b/external_plugins/guster/src/guster/__init__.py index 7064b159..100faa67 100644 --- a/external_plugins/guster/src/guster/__init__.py +++ b/external_plugins/guster/src/guster/__init__.py @@ -1,3 +1,3 @@ """Guster: agent context steward.""" -__version__ = "0.9.3" +__version__ = "0.9.4" diff --git a/external_plugins/guster/src/guster/cli.py b/external_plugins/guster/src/guster/cli.py index 8f6ef0eb..9fbcbc38 100644 --- a/external_plugins/guster/src/guster/cli.py +++ b/external_plugins/guster/src/guster/cli.py @@ -90,6 +90,8 @@ def parse_roots(raw: Any, config_path: Path) -> List[Path]: def parse_zones(raw: Any, config_path: Path) -> List[Dict[str, str]]: + """Only 'path' is read; extra keys a legacy config may still carry (e.g. a + retired 'profile') are tolerated silently.""" if not isinstance(raw, list): raise ValueError(f"Guster config 'zones' must be a list: {config_path}") zones: List[Dict[str, str]] = [] @@ -101,12 +103,9 @@ def parse_zones(raw: Any, config_path: Path) -> List[Dict[str, str]]: raise ValueError( f"Guster config 'zones' entries must be absolute paths: {item!r} in {config_path}" ) - profile = str(item.get("profile", "light")) if not zone_path.is_dir(): raise ValueError(f"configured zone does not exist: {zone_path.resolve()}") - if profile not in {"light", "full"}: - raise ValueError(f"zone profile must be 'light' or 'full': {profile}") - zones.append({"path": str(zone_path), "profile": profile}) + zones.append({"path": str(zone_path)}) return zones @@ -302,13 +301,14 @@ def print_scan_summary(registry: Dict[str, Any], config: ScanConfig) -> None: print(f" hub: {registry.get('hub') or '(none)'}") if config.scope == "hub": print( - f" projects: {summary.get('project_cards', 0)} " + f" registered: {summary.get('registry_entries', 0)} " f"(scanned roots: {summary.get('projects', 0)})" ) else: print(f" projects: {summary.get('projects', 0)}") print(f" .agents: {summary.get('agents_dirs', 0)} (indexed {summary.get('agents_with_index', 0)})") - print(f" skills: {summary.get('skills', 0)} unique / {summary.get('skill_copies', 0)} copies") + skills_note = "" if config.scope == "hub" else " (user-level roots only)" + print(f" skills: {summary.get('skills', 0)} unique / {summary.get('skill_copies', 0)} copies{skills_note}") print(f" knowledge: {summary.get('knowledge', 0)}") print(f" state: {summary.get('state', 0)}") print(f" evidence: {summary.get('evidence', 0)}") @@ -398,7 +398,13 @@ def cmd_score(args: argparse.Namespace) -> int: print(json_dumps(metric_result)) elif not args.quiet: chi = metric_result.get("chi") - print(f"Guster Context Health: {'n/a' if chi is None else chi} / 100") + headline = f"Guster Context Health: {'n/a' if chi is None else chi} / 100" + unscored = metric_result.get("unscored_dims") or [] + if unscored: + scored = len(metric_result.get("scored_dims") or []) + total = len(metric_result.get("dims") or []) + headline += f" ({scored}/{total} dims scored)" + print(headline) print("") dims = set(metric_result.get("dims") or []) for key, value in metric_result["scores"].items(): @@ -406,9 +412,9 @@ def cmd_score(args: argparse.Namespace) -> int: continue print(f" {key.upper():4s} {'n/a' if value is None else f'{value:6.1f}'}") print("") - print(metric_line(metric_result)) print(f"registry: {config.state_dir / 'registry.json'}") print(f"metrics: {config.state_dir / 'metrics.jsonl'}") + print("Definitions & targets: skills/guster/reference/metrics.md") if args.trend: path = config.state_dir / "metrics.jsonl" if path.is_file(): @@ -418,7 +424,8 @@ def cmd_score(args: argparse.Namespace) -> int: for line in lines: try: item = json.loads(line) - print(f" {item.get('at')} CHI {item.get('chi')}") + chi = item.get("chi") + print(f" {item.get('at')} CHI {'n/a' if chi is None else chi}") except ValueError: continue if args.fail_under is not None: @@ -455,7 +462,8 @@ def cmd_check(args: argparse.Namespace) -> int: for line in lines: try: item = json.loads(line) - print(f" {item.get('at')} CHI {item.get('chi')}") + chi = item.get("chi") + print(f" {item.get('at')} CHI {'n/a' if chi is None else chi}") except ValueError: continue severities = {item["severity"] for item in policy_result["findings"]} @@ -579,8 +587,16 @@ def cmd_init(args: argparse.Namespace) -> int: else: mode = "FAILED" print(f"{mode}: init") - print(f" applied: {result.get('applied', 0)}") - print(f" skipped: {result.get('skipped', 0)}") + if result.get("dry_run"): + for index, operation in enumerate(result.get("operations") or [], start=1): + kind = operation.get("kind") + if kind == "mkdir": + print(f" {index}. mkdir {operation['path']}") + elif kind == "write": + print(f" {index}. write {operation['path']}") + else: + print(f" applied: {result.get('applied', 0)}") + print(f" skipped: {result.get('skipped', 0)}") if result.get("errors"): for error in result["errors"]: print(f" error: {error}") @@ -672,16 +688,15 @@ def cmd_hub(args: argparse.Namespace) -> int: elif not args.quiet: manifest = info.get("manifest") or {} print(f"Hub: {info['hub']}") - if info.get("profile") == "legacy": - print("Manifest: legacy (no hub.yaml)") - else: + if manifest: print( "Manifest: " - f"{info.get('profile') or '(absent)'} " f"schema={manifest.get('schema_version') or '(absent)'} " f"hub={manifest.get('hub_version') or '(absent)'} " f"min_guster={manifest.get('min_guster') or '(absent)'}" ) + else: + print("Manifest: (absent)") print(f"Plugin: {info['plugin']}") paths = info.get("paths") or {} if paths: @@ -718,7 +733,7 @@ def cmd_zones(args: argparse.Namespace) -> int: print("no zones configured; add one with `guster zones add `") for item in zones: zone_path = Path(item["path"]).expanduser() - print(f"{item['path']} profile={item['profile']} tools={count_zone_tools(zone_path)}") + print(f"{item['path']} tools={count_zone_tools(zone_path)}") return 0 zone_path = Path(args.path).expanduser() @@ -733,7 +748,7 @@ def cmd_zones(args: argparse.Namespace) -> int: if isinstance(item, dict) and str(item.get("path", "")).strip(): if Path(str(item["path"])).expanduser().resolve() == zone_path.resolve(): raise ValueError(f"zone already configured: {zone_path.resolve()}") - entry = {"path": str(zone_path), "profile": args.profile} + entry = {"path": str(zone_path)} config.setdefault("version", 1) config["zones"] = raw_zones + [entry] zones = parse_zones(config["zones"], config_path) @@ -742,7 +757,7 @@ def cmd_zones(args: argparse.Namespace) -> int: if args.json: print(json_dumps({"ok": True, "added": entry, "zones": zones, "config": str(config_path)})) elif not args.quiet: - print(f"added zone: {entry['path']} (profile: {entry['profile']})") + print(f"added zone: {entry['path']}") print(f"config: {config_path}") return 0 @@ -774,22 +789,6 @@ def cmd_zones(args: argparse.Namespace) -> int: raise SystemExit(f"unknown zones action: {action}") -def cmd_link(args: argparse.Namespace) -> int: - config = build_config(args) - registry = do_scan(config, write=True) - result = evaluate(registry, config) - findings = [item for item in result["policy"]["findings"] if item["rule"] == "broken-pointer"] - if args.json: - print(json_dumps({"findings": findings, "stats": result["policy"]["stats"]})) - elif not args.quiet: - print(f"broken pointer files: {len(findings)}") - for item in findings: - print(f" {item['path']}") - for pointer in item.get("evidence", {}).get("pointers", []): - print(f" - {pointer}") - return 0 if not findings else 2 - - def cmd_export(args: argparse.Namespace) -> int: config = build_config(args) registry = do_scan(config, write=True) @@ -912,7 +911,6 @@ def build_parser() -> argparse.ArgumentParser: zones_list.set_defaults(func=cmd_zones) zones_add = zones_sub.add_parser("add", parents=[common], help="Add a zone to config.json.") zones_add.add_argument("path", help="Zone directory (must exist).") - zones_add.add_argument("--profile", choices=["light", "full"], default="light", help="Zone profile.") zones_add.set_defaults(func=cmd_zones) zones_remove = zones_sub.add_parser("remove", parents=[common], help="Remove a configured zone.") zones_remove.add_argument("path", help="Zone directory as configured.") @@ -922,7 +920,7 @@ def build_parser() -> argparse.ArgumentParser: plan_sub = plan.add_subparsers(dest="plan_action", required=True) plan_findings = plan_sub.add_parser("findings", parents=[common], help="Turn findings into a review checklist.") plan_findings.set_defaults(func=cmd_plan) - plan_move_parser = plan_sub.add_parser("move", parents=[common], help="Plan a move with backup and pointer.") + plan_move_parser = plan_sub.add_parser("move", parents=[common], help="Plan a move with backup.") plan_move_parser.add_argument("--from", dest="source", required=True, help="Source path.") plan_move_parser.add_argument("--to", dest="destination", required=True, help="Destination path.") plan_move_parser.set_defaults(func=cmd_plan) @@ -966,9 +964,6 @@ def build_parser() -> argparse.ArgumentParser: hub_validate.add_argument("--path", default=None, help="Hub directory; defaults to the attached hub or the conventional Guster Hub path.") hub_validate.set_defaults(func=cmd_hub) - link = subparsers.add_parser("link", parents=[common], help="Check context pointers.") - link.set_defaults(func=cmd_link) - export = subparsers.add_parser("export", parents=[common], help="Export a redacted health report.") export.add_argument("--format", choices=["md", "json"], default="md") export.add_argument("--out", default=None, help="Output path.") diff --git a/external_plugins/guster/src/guster/discover.py b/external_plugins/guster/src/guster/discover.py index 60ead959..60bd9cfd 100644 --- a/external_plugins/guster/src/guster/discover.py +++ b/external_plugins/guster/src/guster/discover.py @@ -19,6 +19,7 @@ load_json, now_iso, parse_frontmatter, + parse_register_rows, read_text, relative, sha256_file, @@ -84,10 +85,9 @@ class ScanConfig: max_depth: int = 5 scope: str = "machine" now: str = field(default_factory=now_iso) - # Declared machine zones (`config.json` `zones`): {"path": ..., "profile": ...}. - # "light" zones are tool areas — AGENTS/README artifacts and secrets, no - # project slots — so a non-git tool layer is governed without pretending - # each tool is a repository. + # Declared machine zones (`config.json` `zones`): {"path": ...}. Zones are + # tool areas — AGENTS/README artifacts and secrets, no project slots — so a + # non-git tool layer is governed without pretending each tool is a repository. zones: List[Dict[str, str]] = field(default_factory=list) # First-run UX: no config.json existed, and roots came from auto-detection. # Drives the "run `guster init`" banner; empty candidates fail loud earlier. @@ -320,7 +320,6 @@ def scan(config: ScanConfig) -> Dict[str, Any]: "zones": [ { "path": str(Path(item["path"]).expanduser()), - "profile": item.get("profile", "light"), "tools": count_zone_tools(Path(item["path"]).expanduser()), } for item in zones @@ -345,7 +344,7 @@ def scan(config: ScanConfig) -> Dict[str, Any]: artifacts, secret_files, inline_bearers, - count_project_cards(hub, walk_errors), + count_registry_entries(hub, walk_errors), ), } return registry @@ -642,21 +641,30 @@ def scan_hub_knowledge( ) ) default_suffixes = {".md", ".json", ".yaml", ".yml"} - groups = [ - (layout["knowledge"] / "general", "knowledge", "knowledge", "general", True, default_suffixes), - (layout["knowledge"] / "projects", "knowledge", "knowledge", "project", True, default_suffixes), - (layout["knowledge"] / "workgroups", "knowledge", "knowledge", "workgroup", True, default_suffixes), + groups: List[Tuple[Path, str, str, str, bool, Set[str]]] = [] + # Knowledge subzones are discovered, not enumerated: every first-level + # directory under the knowledge root (general/, projects/, machines/, ...) + # is scanned as hub knowledge and index-checked against the README. + knowledge_root = layout["knowledge"] + if knowledge_root.is_dir(): + for child in sorted(knowledge_root.iterdir()): + if not child.is_dir() or child.name.startswith(".") or child.name in EXCLUDE_DIRS: + continue + groups.append((child, "knowledge", "knowledge", child.name, True, default_suffixes)) + groups.extend([ (layout["projects"], "state", "state", "project", False, default_suffixes), + (hub / "register", "state", "state", "project", False, default_suffixes), (hub / "handoff", "state", "state", "project", False, default_suffixes), (hub / "provision", "state", "state", "project", False, default_suffixes), (hub / "reports", "evidence", "evidence", "project", False, default_suffixes), + (hub / "output", "evidence", "evidence", "project", False, default_suffixes), (hub / "Human Output", "evidence", "evidence", "project", False, default_suffixes), (hub / "manuals", "state", "state", "project", False, default_suffixes), (hub / "cron-tasks", "state", "state", "project", False, default_suffixes | {".plist"}), (hub / "openspec", "plan", "state", "project", False, default_suffixes), (hub / "archive", "archive", "archive", "project", False, default_suffixes), (hub / ".agents" / "plans", "plan", "state", "project", False, default_suffixes), - ] + ]) for root, kind, plane, scope, check_index, suffixes in groups: if not root.is_dir(): continue @@ -734,9 +742,9 @@ def scan_zones( zones: Sequence[Dict[str, str]], errors: Optional[List[str]] = None, ) -> List[Dict[str, Any]]: - """Light-profile zone scan: entry docs and nothing else. + """Zone scan: entry docs and nothing else. - A declared tool zone is not a project tree. The light profile collects + A declared tool zone is not a project tree. The scan collects AGENTS.md/README.md so pointer health and freshness can see them, and the caller feeds the zone root to the secret scan; slot compliance never applies because a tool is not a repository with `.agents/` slots. @@ -1050,21 +1058,17 @@ def scan_plugin_manifests(plugin_root: Optional[Path]) -> Dict[str, Any]: return manifests -PROJECT_CARD_NAMES = {"_registry.md", "readme.md", "agents.md"} - +def count_registry_entries(hub: Optional[Path], errors: Optional[List[str]] = None) -> int: + """Projects registered in the hub's register (register/projects.yaml). -def count_project_cards(hub: Optional[Path], errors: Optional[List[str]] = None) -> int: - """Project cards known to the hub, not the project roots a run scanned.""" + Same parser as the drift reconciliation, so the summary and the CTX-10 + diff can never disagree about how many rows exist.""" if not hub: return 0 - root = resolve_hub_layout(hub)["projects"] - if not root.is_dir(): + path = hub.expanduser().resolve() / "register" / "projects.yaml" + if not path.is_file(): return 0 - return sum( - 1 - for path in iter_files(root, suffixes={".md"}, max_depth=1, errors=errors) - if path.parent == root and path.name.lower() not in PROJECT_CARD_NAMES - ) + return len(parse_register_rows(read_text(path, limit=1_000_000))) def summarize( @@ -1073,12 +1077,12 @@ def summarize( artifacts: Sequence[Dict[str, Any]], secret_files: Sequence[Dict[str, Any]], inline_bearers: Sequence[Dict[str, Any]], - project_cards: int = 0, + registry_entries: int = 0, ) -> Dict[str, Any]: return { "projects": len(projects), "containers": sum(1 for project in projects if project.get("container")), - "project_cards": project_cards, + "registry_entries": registry_entries, "agents_dirs": sum(1 for project in projects if project.get("agents_dir")), "agents_with_index": sum(1 for project in projects if project.get("has_index")), "git_errors": sum(1 for project in projects if project.get("git_state") == "error"), diff --git a/external_plugins/guster/src/guster/hub.py b/external_plugins/guster/src/guster/hub.py index 269e5562..8f02c346 100644 --- a/external_plugins/guster/src/guster/hub.py +++ b/external_plugins/guster/src/guster/hub.py @@ -8,7 +8,7 @@ from .executor import apply_plan from .layout import DEFAULT_PATHS, load_manifest, resolve_hub_layout, validate_layout_value from .planner import build_plan, op_mkdir, op_write, save_plan -from .util import is_indexed, load_json_strict, now_iso, read_text, save_json, today_iso, unique_suffix +from .util import DATE_ONLY_RE, EXCLUDE_DIRS, is_indexed, iter_files, load_json_strict, now_iso, read_text, save_json, today_iso, unique_suffix def default_hub_path(home: Path) -> Path: @@ -125,16 +125,20 @@ def validate_hub(target: Path, strict: bool = True) -> Dict[str, Any]: and (hub / "knowledge").is_dir() and (hub / "projects").is_dir() ) - required_files = [hub / "AGENTS.md", hub / "README.md", hub / "hub.yaml"] + required_files = [hub / "AGENTS.md", hub / "hub.yaml"] required_dirs = [] if "knowledge" in layout: required_files.append(layout["knowledge"] / "README.md") - required_dirs.extend( - [layout["knowledge"], layout["knowledge"] / "general", layout["knowledge"] / "projects"] - ) + required_dirs.append(layout["knowledge"]) if "projects" in layout: - required_files.append(layout["projects"] / "_registry.md") + register = hub / "register" / "projects.yaml" + required_files.append(register) required_dirs.append(layout["projects"]) + migration_note = ( + " (migrate from projects/_registry.md - see CHANGELOG 0.9.4)" + if not register.is_file() and (layout["projects"] / "_registry.md").is_file() + else "" + ) if "tools" in layout: required_files.append(layout["tools"] / "README.md") required_dirs.append(layout["tools"]) @@ -142,10 +146,11 @@ def validate_hub(target: Path, strict: bool = True) -> Dict[str, Any]: if path.is_file(): continue rel = _relative(path, hub) + message = f"required file is absent: {rel}{migration_note if path == register and not legacy else ''}" if legacy and not strict: warnings.append(f"legacy hub lite contract file is absent: {rel}") else: - errors.append(f"required file is absent: {rel}") + errors.append(message) for path in required_dirs: if path.is_dir(): continue @@ -164,8 +169,6 @@ def validate_hub(target: Path, strict: bool = True) -> Dict[str, Any]: else: if manifest.get("schema_version") not in {"1", "2"}: errors.append(f"unsupported hub schema: {manifest.get('schema_version') or '(absent)'}") - if manifest.get("profile") not in {"lite", "full"}: - warnings.append(f"unexpected hub profile: {manifest.get('profile') or '(absent)'}") minimum = manifest.get("min_guster") if minimum and _version_tuple(minimum) > _version_tuple(__version__): errors.append(f"hub requires Guster >= {minimum}; installed CLI is {__version__}") @@ -177,33 +180,36 @@ def validate_hub(target: Path, strict: bool = True) -> Dict[str, Any]: if strict: index_path = layout["knowledge"] / "README.md" if index_path.is_file(): - index = read_text(index_path) - for folder in ("general", "projects"): - root = layout["knowledge"] / folder - if not root.is_dir(): + index = read_text(index_path, limit=2_000_000) + knowledge_root = layout["knowledge"] + try: + subzones = sorted(knowledge_root.iterdir()) if knowledge_root.is_dir() else [] + except OSError as exc: + subzones = [] + errors.append(f"cannot list knowledge root {knowledge_root}: {exc}") + for subzone in subzones: + if not subzone.is_dir() or subzone.name.startswith(".") or subzone.name in EXCLUDE_DIRS: continue - for note in sorted(root.rglob("*.md")): + for note in sorted( + iter_files(subzone, suffixes={".md", ".json", ".yaml", ".yml"}) + ): if note.name.lower() == "readme.md": continue if not is_indexed(note.name, index): errors.append(f"knowledge note is not indexed: {_relative(note, hub)}") - registry_path = layout["projects"] / "_registry.md" - if registry_path.is_file(): - registry = read_text(registry_path) - if not re.search( - r"(?:最后更新|更新时间|更新于|最近核实|最后核实|已核实|verified_at|(?i:last updated|updated))" - r"\s*\*{0,2}\s*[::]\s*\*{0,2}\s*\d{4}[-/]\d{1,2}[-/]\d{1,2}", - registry, - ): - errors.append(f"{_relative(registry_path, hub)} has no verified date") + register_path = hub / "register" / "projects.yaml" + if register_path.is_file(): + register = read_text(register_path) + declared = re.search(r"^updated:\s*['\"]?([^'\"\s#]+)", register, re.MULTILINE) + if declared is None or not DATE_ONLY_RE.fullmatch(declared.group(1)): + errors.append(f"{_relative(register_path, hub)} has no updated date") return { "ok": not errors, "hub": str(hub), "manifest": manifest, "paths": {key: _relative(value, hub) for key, value in layout.items()}, - "profile": manifest.get("profile") or ("legacy" if legacy else ""), "errors": errors, "warnings": warnings, "plugin": __version__, diff --git a/external_plugins/guster/src/guster/metrics.py b/external_plugins/guster/src/guster/metrics.py index e707d650..8786f1e8 100644 --- a/external_plugins/guster/src/guster/metrics.py +++ b/external_plugins/guster/src/guster/metrics.py @@ -103,7 +103,6 @@ def compute_metrics(registry: Dict[str, Any], policy_result: Dict[str, Any]) -> ) secret_total = int(stats.get("secret_total", 0)) + inline_bearers sir = None if secret_total <= 0 else 1.0 - min(1.0, secret_bad / secret_total) - gcr = governance_count / 8.0 if governance_declared else None dim_values: Dict[str, Optional[float]] = { "ssr": ssr, @@ -135,7 +134,6 @@ def compute_metrics(registry: Dict[str, Any], policy_result: Dict[str, Any]) -> metrics: Dict[str, Optional[float]] = { dim: (None if value is None else round(value, 4)) for dim, value in raw_values.items() } - metrics["gcr"] = None if gcr is None else round(gcr, 4) scores: Dict[str, Optional[float]] = {dim: percent(value) for dim, value in dim_values.items()} return { diff --git a/external_plugins/guster/src/guster/planner.py b/external_plugins/guster/src/guster/planner.py index 494b0e74..83ecae1e 100644 --- a/external_plugins/guster/src/guster/planner.py +++ b/external_plugins/guster/src/guster/planner.py @@ -4,7 +4,7 @@ from pathlib import Path from typing import Any, Dict, List, Optional, Sequence -from .util import now_iso, save_json, slugify, today_iso, unique_suffix +from .util import now_iso, save_json, slugify, unique_suffix PLAN_SCHEMA_HINT = ( @@ -64,22 +64,12 @@ def plan_move(src: Path, dst: Path) -> Dict[str, Any]: raise FileExistsError(f"destination already exists: {dst}") operations = [ op_mkdir(dst.parent), - op_move( - src, - dst, - pointer={ - "path": str(src.parent / f"{src.name}.moved.md"), - "content": ( - f"# Moved\n\nThis path moved to `{dst}`.\n\n" - f"verified_at: {today_iso()}\n" - ), - }, - ), + op_move(src, dst), ] return build_plan( f"Move {src.name} to {dst.name}", operations, - notes="Dry-run by default. Apply creates a backup and keeps a pointer at the old location.", + notes="Dry-run by default. Apply creates a backup.", ) diff --git a/external_plugins/guster/src/guster/policy.py b/external_plugins/guster/src/guster/policy.py index c060b7ca..43cb5bce 100644 --- a/external_plugins/guster/src/guster/policy.py +++ b/external_plugins/guster/src/guster/policy.py @@ -10,15 +10,20 @@ from .discover import ScanConfig, STANDARD_AGENTS_SLOTS, in_scope_path, scope_roots from .layout import load_waivers, resolve_hub_layout from .util import ( + DATE_ONLY_RE, NOTE_DATE_KEYS, age_days, extract_naked_pointers, extract_pointers, git_last_commit_dates, + has_top_level_row_keys, + is_under, load_json, note_header_date, parse_date, parse_note_header, + parse_register_rows, + parse_yaml_head, read_text, relative, resolve_pointer, @@ -112,45 +117,26 @@ def suggest_slot(name: str, is_dir: bool) -> str: return "plans" -REGISTRY_PATH_COLUMN = re.compile(r"path|路径", re.IGNORECASE) -REGISTRY_ROW_SKIP = {"", "-", "—", ".", ".."} # `host:/path` (and URLs) reference another machine; a local three-way diff # can never see them, so they are counted apart instead of drifting forever. REGISTRY_REMOTE_FORM = re.compile(r"^[A-Za-z][A-Za-z0-9+.-]*:") - -def parse_registry_rows(text: str) -> List[Dict[str, str]]: - """CTX-10: the hub's human project table, read through its path column. - - The column whose header mentions "path"/"路径" holds one location per row - (`~/...`, absolute, or relative to the hub root); the slug column never - counts as a path.""" - rows: List[Dict[str, str]] = [] - path_index: Optional[int] = None - for line in text.splitlines(): - stripped = line.strip() - if not stripped.startswith("|"): - continue - cells = [cell.strip().strip("`").rstrip("/") for cell in stripped.strip("|").split("|")] - if not cells: - continue - if path_index is None: - for index, cell in enumerate(cells): - if REGISTRY_PATH_COLUMN.search(cell): - path_index = index - break - continue - if cells[0] in {"ID", "slug", ""} or set(cells[0]) <= {"-", ":"}: - continue - raw = cells[path_index] if path_index < len(cells) else "" - if raw in REGISTRY_ROW_SKIP: - continue - rows.append({"slug": cells[0], "path": raw}) - return rows +# knowledge/v1 format contract (CTX-11). Opt-in: only files whose metadata +# face declares `schema: knowledge/v1` are validated, so plain notes stay +# untouched. Vocabularies ship with the format; zone/host/history-style local +# extensions are ignored, never validated. +KNOWLEDGE_SCHEMA = "knowledge/v1" +KNOWLEDGE_TYPES = {"state", "howto", "principle", "pitfall", "decision", "index", "reference"} +KNOWLEDGE_STATUSES = {"active", "dormant", "superseded", "archived"} +KNOWLEDGE_STALE_TYPES = {"state", "index"} +KNOWLEDGE_STALE_DAYS = 90 +REGISTER_SCHEMA = "register/v1" +REGISTER_KIND = "projects" +REGISTER_STATUSES = {"active", "pending", "on-hold", "stale", "retired"} def resolve_registry_row_path(raw: str, hub_root: Path, home: Path) -> Optional[Path]: - """A registry row path resolves against the hub root, `~` or an absolute.""" + """A register row path resolves against the hub root, `~` or an absolute.""" value = raw.strip().rstrip("/") if not value: return None @@ -162,6 +148,45 @@ def resolve_registry_row_path(raw: str, hub_root: Path, home: Path) -> Optional[ return (hub_root / candidate).resolve() +def resolved_str(raw: str) -> str: + """Canonical spelling for finding paths: one doctor report must not mix + /tmp and /private/tmp forms of the same directory.""" + try: + return str(Path(raw).resolve()) + except OSError: + return raw + + +def collect_knowledge_v1( + artifacts: List[Dict[str, Any]], knowledge_root: Optional[Path] +) -> Tuple[List[Dict[str, Any]], List[Tuple[Path, str]]]: + """Read the metadata face of every knowledge/v1 file under the hub's + knowledge root. Files without the `schema: knowledge/v1` header are + skipped: the format contract is opt-in by declaration. A file that + declares a knowledge/* or register/* schema other than the current one is + returned as a mismatch, so a typo'd declaration stays visible instead of + silently opting out of every check.""" + docs: List[Dict[str, Any]] = [] + mismatches: List[Tuple[Path, str]] = [] + if knowledge_root is None: + return docs, mismatches + for item in artifacts: + if item.get("kind") != "knowledge": + continue + path = Path(item["path"]) + if path.suffix.lower() not in {".yaml", ".yml"}: + continue + if not is_under(path, knowledge_root): + continue + head = parse_yaml_head(read_text(path, limit=500_000)) + declared = head.get("schema") + if declared == KNOWLEDGE_SCHEMA: + docs.append({"path": path, "stem": path.stem, "head": head}) + elif isinstance(declared, str) and declared.startswith(("knowledge/", "register/")): + mismatches.append((path, declared)) + return docs, mismatches + + def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: findings: List[Dict[str, Any]] = [] governance = registry.get("governance_docs") @@ -204,6 +229,12 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: "registry_drift_unscanned_rows": 0, "registry_drift_unregistered": 0, "registry_drift_stale_machine": 0, + "registry_format_bad": 0, + "knowledge_v1_total": 0, + "knowledge_format_bad": 0, + "see_also_broken": 0, + "knowledge_duplicate_ids": 0, + "knowledge_stale": 0, "scan_walk_errors": int((registry.get("scan_errors") or {}).get("count") or 0), } home = config.home @@ -330,8 +361,8 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: continue orphan_groups.setdefault(item.get("scope", "unknown"), []).append(item) - for scope, items in orphan_groups.items(): - severity = "medium" if scope in {"general", "project", "workgroup"} else "low" + for orphan_scope, items in orphan_groups.items(): + severity = "medium" if orphan_scope != "local" else "low" examples = [relative(Path(item["path"]), Path(item["path"]).parent) for item in items[:10]] findings.append( finding( @@ -339,12 +370,190 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: severity, "Knowledge files are not indexed", str(items[0]["path"]), - f"{len(items)} knowledge file(s) in scope '{scope}' are absent from the relevant README index.", + f"{len(items)} knowledge file(s) in scope '{orphan_scope}' are absent from the relevant README index.", "Add each file to its README index, or merge/delete it if obsolete.", {"count": len(items), "examples": examples}, ) ) + # knowledge/v1 format contract (CTX-11): files that declare the schema + # header get strict format, cross-reference and freshness checks; plain + # notes are never touched. These findings stay outside CHI (same + # discipline as registry-drift) so scores stay comparable. + v1_docs: List[Dict[str, Any]] = [] + schema_mismatches: List[Tuple[Path, str]] = [] + knowledge_root = hub_layout.get("knowledge") if hub is not None else None + if knowledge_root is not None: + v1_docs, schema_mismatches = collect_knowledge_v1(artifacts, knowledge_root) + stats["knowledge_v1_total"] = len(v1_docs) + knowledge_yaml_stems: Set[str] = set() + if knowledge_root is not None: + for item in artifacts: + if item.get("kind") != "knowledge": + continue + candidate = Path(item["path"]) + if candidate.suffix.lower() in {".yaml", ".yml"} and is_under(candidate, knowledge_root): + knowledge_yaml_stems.add(candidate.stem) + for mismatch_path, declared in schema_mismatches: + findings.append( + finding( + "knowledge-format", + "info", + "knowledge file declares an unsupported schema", + str(mismatch_path), + f"declares schema {declared} — current supported is {KNOWLEDGE_SCHEMA}; " + "the file is skipped by every knowledge/v1 check.", + f"Fix the header to '{KNOWLEDGE_SCHEMA}', or drop the schema key to keep it a plain note.", + {"declared": declared, "current": KNOWLEDGE_SCHEMA}, + ) + ) + known_ids: Set[str] = set() + for doc in v1_docs: + doc_id = doc["head"].get("id") + if isinstance(doc_id, str) and doc_id: + known_ids.add(doc_id) + format_bad: List[Tuple[str, List[str]]] = [] + broken_refs: List[Tuple[str, List[str]]] = [] + stale_files: List[str] = [] + id_owners: Dict[str, List[str]] = {} + today = datetime.now(timezone.utc).date() + for doc in v1_docs: + head = doc["head"] + path = doc["path"] + issues: List[str] = [] + doc_id = head.get("id") + if not isinstance(doc_id, str) or not doc_id: + issues.append("id is missing") + elif doc_id != doc["stem"]: + issues.append(f"id {doc_id!r} does not match file stem {doc['stem']!r}") + else: + id_owners.setdefault(doc_id, []).append(str(path)) + doc_type = head.get("type") + if doc_type is None: + issues.append("type is missing (vocabulary: " + ", ".join(sorted(KNOWLEDGE_TYPES)) + ")") + elif doc_type not in KNOWLEDGE_TYPES: + issues.append(f"type {doc_type!r} not in vocabulary {sorted(KNOWLEDGE_TYPES)}") + if "status" in head and not isinstance(head.get("status"), str): + issues.append("status must be a scalar like active, not a block") + doc_status = head.get("status") + if isinstance(doc_status, str) and doc_status not in KNOWLEDGE_STATUSES: + issues.append(f"status {doc_status!r} not in vocabulary {sorted(KNOWLEDGE_STATUSES)}") + topic = head.get("topic") + if not isinstance(topic, str) or not topic.strip(): + issues.append("topic is missing or empty") + for date_key in ("as_of", "updated"): + value = head.get(date_key) + if not isinstance(value, str) or not DATE_ONLY_RE.match(value): + issues.append(f"{date_key} is missing or not YYYY-MM-DD: {value!r}") + as_of_value, updated_value = head.get("as_of"), head.get("updated") + if ( + isinstance(as_of_value, str) + and isinstance(updated_value, str) + and DATE_ONLY_RE.match(as_of_value) + and DATE_ONLY_RE.match(updated_value) + and updated_value < as_of_value + ): + issues.append(f"updated {updated_value} predates as_of {as_of_value}") + if "see_also" in head and not isinstance(head.get("see_also"), list): + issues.append("see_also must be an inline list like [id-a, id-b]") + see = head.get("see_also") + if isinstance(see, list): + missing = sorted( + ref + for ref in see + if isinstance(ref, str) + and ref + and "/" not in ref + and not ref.startswith("~") + and not REGISTRY_REMOTE_FORM.match(ref) + and ref not in known_ids + ) + if missing: + broken_refs.append((str(path), missing)) + if issues: + format_bad.append((str(path), issues)) + if ( + doc_type in KNOWLEDGE_STALE_TYPES + and doc_status == "active" + and isinstance(updated_value, str) + and DATE_ONLY_RE.match(updated_value) + ): + age = (today - datetime.strptime(updated_value, "%Y-%m-%d").date()).days + if age > KNOWLEDGE_STALE_DAYS: + stale_files.append(f"{path} (updated {updated_value})") + stats["knowledge_format_bad"] = len(format_bad) + stats["see_also_broken"] = len(broken_refs) + stats["knowledge_stale"] = len(stale_files) + if format_bad: + findings.append( + finding( + "knowledge-format", + "medium", + "knowledge/v1 files violate the format contract", + format_bad[0][0], + f"{len(format_bad)} file(s) declare knowledge/v1 but break the contract: " + + "; ".join( + f"{Path(p).name}: {', '.join(items[:3])}" for p, items in format_bad[:5] + ), + "Fix the metadata per the CTX-11 contract (reference/spec.md), or drop the schema header.", + { + "count": len(format_bad), + "issues": [ + f"{Path(p).name}: {', '.join(items[:3])}" + for p, items in format_bad[:20] + ], + }, + ) + ) + if broken_refs: + first_path, first_missing = broken_refs[0] + described = [ + f"{ref} (file exists but does not declare knowledge/v1)" + if ref in knowledge_yaml_stems + else ref + for ref in first_missing[:5] + ] + findings.append( + finding( + "see-also-broken", + "medium", + "see_also references point at ids that do not exist", + first_path, + f"{len(broken_refs)} file(s) reference unknown ids; " + f"first: {', '.join(described)}.", + "Point see_also at existing ids only; rename both sides together, or drop the stale reference.", + {"count": len(broken_refs), "refs": first_missing[:10]}, + ) + ) + duplicate_ids = {doc_id: owners for doc_id, owners in id_owners.items() if len(owners) > 1} + stats["knowledge_duplicate_ids"] = len(duplicate_ids) + if duplicate_ids: + first_id, owners = sorted(duplicate_ids.items())[0] + findings.append( + finding( + "duplicate-knowledge-id", + "medium", + "The same knowledge id lives in more than one file", + owners[0], + f"{len(duplicate_ids)} id(s) are duplicated; {first_id}: {owners[:3]}.", + "One fact, one file: merge the files or split the ids so each id has exactly one home.", + {"count": len(duplicate_ids), "ids": sorted(duplicate_ids)[:10]}, + ) + ) + if stale_files: + findings.append( + finding( + "knowledge-stale", + "medium", + "State-flavored knowledge files are past the freshness SLA", + stale_files[0], + f"{len(stale_files)} active state/index file(s) not updated within " + f"{KNOWLEDGE_STALE_DAYS} days.", + "Re-verify the content and bump `updated`, or set status dormant/archived when it no longer needs review.", + {"count": len(stale_files), "files": stale_files[:10]}, + ) + ) + multi_topics = (registry.get("topics") or {}).get("multi_topics") or [] stats["duplicate_knowledge"] = len(multi_topics) if multi_topics: @@ -443,7 +652,7 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: "misplaced-artifact", "medium", "Project .agents has task-shaped top-level entries", - project["path"], + resolved_str(str(project["path"])), f"{len(unknown)} top-level entr{'y' if len(unknown) == 1 else 'ies'} do not match the standard slots.", "Move task bundles under evidence/, plans/, wiki/ or archive/, then add a README index.", {"entries": unknown[:100], "suggested": suggested}, @@ -455,7 +664,7 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: # vacuously fresh. The date ladder is declared (verified_at / updated / # 最后更新 / filename date) → owning repository's git date → file mtime, # each tier reported as its own freshness source. - state_prefixes = ["handoff/", "provision/", ".agents/plans/"] + state_prefixes = ["handoff/", "provision/", "register/", ".agents/plans/"] if hub_layout: state_prefixes.append(relative(hub_layout["projects"], hub).rstrip("/") + "/") state_docs = [ @@ -529,7 +738,7 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: "State documents lack a verifiable freshness date", stale_missing[0], f"{len(stale_missing)} state document(s) have no verified_at or update date.", - "Add verified_at to project cards/handoffs/environment docs; refresh active cards before relying on them.", + "Add verified_at to project state docs/handoffs/environment docs; refresh active ones before relying on them.", {"count": len(stale_missing), "examples": stale_missing[:10]}, ) ) @@ -619,7 +828,7 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: "broken-pointer", "high", "Broken context pointer", - str(path), + resolved_str(str(path)), f"{len(broken)} pointer(s) do not resolve.", "Fix the path or replace it with a pointer that states when to read the target.", {"pointers": broken[:10]}, @@ -633,7 +842,7 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: "naked-pointer", "medium", "Path in prose is not machine-verifiable", - str(path), + resolved_str(str(path)), f"{len(naked)} file path(s) sit outside a link or code span, so the pointer check never sees them.", "Wrap each path in a markdown link or inline code (CTX-03, reference/spec.md).", {"paths": naked[:10]}, @@ -829,10 +1038,10 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: ) # Registry drift (CTX-10): the machine table (registry.json), the hub's - # human table (_registry.md path column) and the git roots on disk each - # claim to know which projects exist; disagreement is a finding, never a - # CHI dimension. The human side needs a hub; the machine↔disk edge stands - # on its own for hub-less users. + # register (register/projects.yaml spec.path entries) and the git roots on + # disk each claim to know which projects exist; disagreement is a finding, + # never a CHI dimension. The human side needs a hub; the machine↔disk edge + # stands on its own for hub-less users. if hub is not None and not (hub / "hub.yaml").is_file() and not (hub / "AGENTS.md").is_file(): findings.append( finding( @@ -858,17 +1067,38 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: human_paths: Set[str] = set() dead_rows: List[str] = [] unscanned_rows: List[str] = [] - registry_md: Optional[Path] = None + register_path: Optional[Path] = None + register_rows: List[Dict[str, str]] = [] + register_text = "" if hub is not None: - projects_root = hub_layout.get("projects") - registry_md = (projects_root / "_registry.md") if projects_root else None - if registry_md is not None and registry_md.is_file(): + register_path = hub / "register" / "projects.yaml" + register_display = resolved_str(str(register_path)) + if not register_path.is_file() and hub_layout.get("projects") is not None: + findings.append( + finding( + "registry-drift", + "medium", + "Hub has no register/projects.yaml", + register_display, + "The hub declares a projects section but carries no register table, so the " + "CTX-10 three-way diff cannot run (0.9.4 replaced projects/_registry.md).", + "Create register/projects.yaml (register/v1 header + one row per project); " + "see CHANGELOG 0.9.4 for the migration.", + {"hub": resolved_str(str(hub))}, + ) + ) + if register_path.is_file(): + register_text = read_text(register_path, limit=1_000_000) + register_rows = parse_register_rows(register_text) hub_root = hub.expanduser().resolve() - for row in parse_registry_rows(read_text(registry_md, limit=1_000_000)): - if REGISTRY_REMOTE_FORM.match(row["path"]): + for row in register_rows: + raw = row.get("path") or "" + if not raw: + continue + if REGISTRY_REMOTE_FORM.match(raw): stats["registry_rows_remote"] += 1 continue - resolved = resolve_registry_row_path(row["path"], hub_root, home) + resolved = resolve_registry_row_path(raw, hub_root, home) if resolved is None: continue try: @@ -877,22 +1107,66 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: continue human_paths.add(key) if not resolved.exists(): - dead_rows.append(row["path"]) - elif scope == "machine" and key not in machine_paths: - unscanned_rows.append(row["path"]) - stats["registry_rows"] = len(human_paths) + dead_rows.append(raw) + elif getattr(config, "scope", "machine") == "machine" and key not in machine_paths: + unscanned_rows.append(raw) + stats["registry_rows"] = len(register_rows) stats["registry_drift_dead_rows"] = len(dead_rows) stats["registry_drift_unscanned_rows"] = len(unscanned_rows) - if registry_md is not None and registry_md.is_file(): + if register_path is not None and register_path.is_file(): + format_issues: List[str] = [] + header = parse_yaml_head(register_text) + if header.get("schema") != REGISTER_SCHEMA: + format_issues.append(f"schema is {header.get('schema')!r}, expected '{REGISTER_SCHEMA}'") + if header.get("kind") != REGISTER_KIND: + format_issues.append(f"kind is {header.get('kind')!r}, expected '{REGISTER_KIND}'") + if not register_rows and has_top_level_row_keys(register_text): + format_issues.append( + "no project rows parsed — expected top-level `- id:` list items under `projects:`" + ) + seen_ids: Dict[str, int] = {} + for row in register_rows: + row_id = row.get("id") or "" + if not row_id: + format_issues.append("a row has no id") + else: + seen_ids[row_id] = seen_ids.get(row_id, 0) + 1 + if not row.get("path"): + format_issues.append(f"row {row_id or '(no id)'} has no spec.path") + as_of = row.get("as_of") or "" + if as_of and not DATE_ONLY_RE.match(as_of): + format_issues.append(f"row {row_id or '(no id)'} as_of is not YYYY-MM-DD: {as_of!r}") + row_status = row.get("status") or "" + if row_status and row_status not in REGISTER_STATUSES: + format_issues.append( + f"row {row_id or '(no id)'} status {row_status!r} not in vocabulary " + f"{sorted(REGISTER_STATUSES)}" + ) + for row_id, count in seen_ids.items(): + if count > 1: + format_issues.append(f"id {row_id!r} appears {count} times") + stats["registry_format_bad"] = len(format_issues) + if format_issues: + findings.append( + finding( + "registry-format", + "medium", + "Register table violates the register/v1 contract", + register_display, + "; ".join(format_issues[:10]), + "Fix the header (schema/kind) and each row (unique id, spec.path, YYYY-MM-DD as_of).", + {"count": len(format_issues), "issues": format_issues[:20]}, + ) + ) if dead_rows: findings.append( finding( "registry-drift", "medium", - "Hub registry rows point at paths that do not exist", - str(registry_md), - f"{len(dead_rows)} row(s) in the human registry name a path that is not on disk.", - "Fix the row path, or delete the row; a registry row must resolve to the project directory.", + "Register rows point at paths that do not exist", + register_display, + f"{len(dead_rows)} row(s) in the register name a path that is not on disk.", + "Fix the row path, or delete the row; a register row must resolve to the project directory.", {"count": len(dead_rows), "rows": dead_rows[:10]}, ) ) @@ -901,10 +1175,10 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: finding( "registry-drift", "medium", - "Hub registry rows are outside the machine scan", - str(registry_md), + "Register rows are outside the machine scan", + register_display, f"{len(unscanned_rows)} registered path(s) exist but the scan never records them; " - "the machine table cannot see what the human table claims.", + "the machine table cannot see what the register claims.", "Add the containing directory to the configured roots (guster init/zones), or fix the row path.", {"count": len(unscanned_rows), "rows": unscanned_rows[:10]}, ) @@ -918,11 +1192,36 @@ def run_policy(registry: Dict[str, Any], config: ScanConfig) -> Dict[str, Any]: "low", "Scanned projects are not registered in the hub", unregistered[0], - f"{len(unregistered)} scanned project(s) have no row in the human registry.", - "Add a CTX-10 row per project, or waive deliberately unregistered ones in hub.yaml.", + f"{len(unregistered)} scanned project(s) have no row in the register.", + "Add a register/projects.yaml row per project, or waive deliberately unregistered ones in hub.yaml.", {"count": len(unregistered), "examples": unregistered[:10]}, ) ) + if hub is not None and (hub / "register").is_dir(): + try: + register_siblings = sorted((hub / "register").iterdir()) + except OSError: + register_siblings = [] + for extra in register_siblings: + if not extra.is_file() or extra.suffix.lower() not in {".yaml", ".yml"}: + continue + if register_path is not None and extra == register_path: + continue + head = parse_yaml_head(read_text(extra, limit=10_000)) + if head.get("schema") == REGISTER_SCHEMA and head.get("kind") != REGISTER_KIND: + findings.append( + finding( + "registry-format", + "info", + "Register table declares a kind v1 does not validate", + resolved_str(str(extra)), + f"declares register/v1 kind={head.get('kind')!r} — " + "v1 validates kind: projects only.", + "This table is accepted as register data but never validated; keep the " + "projects table in register/projects.yaml.", + {"kind": head.get("kind")}, + ) + ) persisted_registry = load_json(config.state_dir / "registry.json", None) if isinstance(persisted_registry, dict) and isinstance(persisted_registry.get("projects"), list): persisted_paths: Set[str] = set() diff --git a/external_plugins/guster/src/guster/report.py b/external_plugins/guster/src/guster/report.py index 960d43f0..81985fcb 100644 --- a/external_plugins/guster/src/guster/report.py +++ b/external_plugins/guster/src/guster/report.py @@ -21,7 +21,7 @@ "secret-outside-root": "register or move unregistered credential files into the canonical root", "secret-undeclared": "register credential files in ~/.agents/credentials/registry.md", "secret-missing": "rotate or drop stale credential registry rows", - "broken-pointer": "fix the pointer path or replace it with a when-to-read pointer (`guster link` lists them)", + "broken-pointer": "fix the pointer path or replace it with a when-to-read pointer", "naked-pointer": "wrap naked paths in a link or inline code (CTX-03)", "misplaced-artifact": "move task bundles under a standard slot (`guster plan move`)", "stale-state": "refresh verified_at on state documents or archive them", @@ -30,7 +30,12 @@ "skill-budget": "trim skill descriptions to one trigger sentence", "skill-copy-drift": "make drifted skill copies byte-identical", "resident-budget": "demote resident detail into knowledge or skills", - "registry-drift": "reconcile the hub registry rows with scanned projects (CTX-10)", + "registry-drift": "reconcile the register rows with scanned projects (CTX-10)", + "registry-format": "fix the register/v1 header and rows (unique id, spec.path, dates)", + "knowledge-format": "fix knowledge/v1 metadata per the CTX-11 contract, or drop the schema header", + "see-also-broken": "point see_also at existing ids, or drop the stale reference", + "duplicate-knowledge-id": "merge the files or split the ids so each id has one home", + "knowledge-stale": "re-verify and bump `updated`, or set status dormant/archived", "hub-manifest-missing": "point the hub config at a real hub (`guster hub init`)", "note-header-malformed": "fix note front-matter (type key + machine-readable date)", "git-unavailable": "fix git access for the failing repositories", @@ -99,8 +104,8 @@ def render_report( scope = metric_result.get("scope", registry.get("scope", "machine")) workspaces = registry.get("workspaces", []) if scope == "hub": - project_cards = summary.get("project_cards", 0) - projects_line = f"- Projects: **{project_cards}** (scanned roots: {summary.get('projects', 0)})" + registered = summary.get("registry_entries", 0) + projects_line = f"- Registered projects: **{registered}** (scanned roots: {summary.get('projects', 0)})" else: total_projects = int(summary.get("projects", 0)) containers = int(summary.get("containers", 0)) @@ -136,6 +141,7 @@ def render_report( lines.append( f"- Skills: **{summary.get('skills', 0)}** unique / " f"**{summary.get('skill_copies', 0)}** copies" + + ("" if scope == "hub" else " (user-level roots only)") ) lines.append( f"- Knowledge: **{summary.get('knowledge', 0)}** files; " @@ -169,8 +175,9 @@ def render_report( "rbr", metrics.get("rbr"), scores.get("rbr"), - f"{human_bytes(raw.get('resident_bytes', 0))} over {raw.get('resident_entries', 0)} entry files; " - f"skills {raw.get('skill_chars', 0)} chars", + f"{human_bytes(raw.get('resident_bytes', 0))} entry bytes " + f"({raw.get('resident_entries', 0)} host entry files + hub AGENTS.md); " + f"skills {raw.get('skill_chars', 0)} chars; budget used, lower is better", ), ( "Placement", @@ -238,17 +245,6 @@ def render_report( f"_Knowledge files excluded from single-source checks (above the hash limit or unreadable): " f"{raw.get('knowledge_unhashed')}._" ) - lines.append("") - if metrics.get("gcr") is None: - lines.append( - "_Not counted in CHI: Governance simplicity n/a " - "(hub.yaml declares no governance_docs list)._" - ) - else: - lines.append( - f"_Not counted in CHI: Governance simplicity {metrics.get('gcr')} " - f"({raw.get('governance_docs', 0)} framework docs / 8; target ≤0.5)._" - ) lines.append("") lines.append("## Findings") lines.append("") @@ -304,7 +300,7 @@ def render_status(registry: Dict[str, Any], metric_result: Optional[Dict[str, An plugin = registry.get("plugin", {}) summary = registry.get("summary", {}) projects = ( - summary.get("project_cards", 0) + summary.get("registry_entries", 0) if registry.get("scope") == "hub" else summary.get("projects", 0) ) @@ -319,7 +315,7 @@ def render_status(registry: Dict[str, Any], metric_result: Optional[Dict[str, An lines.append( "zones: " + ", ".join( - f"{Path(item.get('path', '.')).name}({item.get('profile', 'light')}, {item.get('tools', 0)} tools)" + f"{Path(item.get('path', '.')).name}({item.get('tools', 0)} tools)" for item in zones ) ) @@ -338,7 +334,8 @@ def render_status(registry: Dict[str, Any], metric_result: Optional[Dict[str, An lines.extend( [ f"projects: {projects}", - f"skills: {summary.get('skills', 0)} unique / {summary.get('skill_copies', 0)} copies", + f"skills: {summary.get('skills', 0)} unique / {summary.get('skill_copies', 0)} copies" + + ("" if registry.get("scope") == "hub" else " (user-level roots only)"), f"knowledge: {summary.get('knowledge', 0)}", f"credentials: {summary.get('secret_files', 0)} files; {summary.get('inline_bearers', 0)} inline", ] diff --git a/external_plugins/guster/src/guster/util.py b/external_plugins/guster/src/guster/util.py index 63da18e1..f43376a6 100644 --- a/external_plugins/guster/src/guster/util.py +++ b/external_plugins/guster/src/guster/util.py @@ -230,10 +230,16 @@ def load_json_strict(path: Path) -> Tuple[Any, Optional[str]]: def is_indexed(name: str, index_text: str) -> bool: - """A backtick-wrapped index row, bare or as a `dir/name` tail. + """An index row naming the file: backtick-wrapped (bare or as a `dir/name` + tail), a backtick-wrapped stem, or a markdown table cell holding the stem. A bare substring does not count: `a.md` inside `data.md` is not an index row.""" - return f"`{name}`" in index_text or f"/{name}`" in index_text + if f"`{name}`" in index_text or f"/{name}`" in index_text: + return True + stem = Path(name).stem + if f"`{stem}`" in index_text: + return True + return re.search(rf"^\|\s*{re.escape(stem)}\s*\|", index_text, re.MULTILINE) is not None def save_json(path: Path, data: Any) -> None: @@ -298,6 +304,120 @@ def unquote(value: str) -> str: return value +def _scalar(raw: str) -> str: + raw = raw.strip() + if raw[:1] in ('"', "'"): + raw = unquote(raw) + return unquote(raw.split(" #", 1)[0].strip()) + + +_TOP_KEY = re.compile(r"^([A-Za-z_][A-Za-z0-9_-]*):(?:[ \t]+(.*))?$") +_INLINE_LIST = re.compile(r"^\[(.*)\]$") + + +def parse_yaml_head(text: str) -> Dict[str, Any]: + """Parse the metadata face of a knowledge/v1 file without PyYAML. + + Only column-0 `key: value` lines are read: scalar keys get their unquoted + string, a `key: [a, b]` inline list becomes a list of unquoted strings, + and block keys (`history:`, `body:`, `key: |`...) are recorded as None so + callers can tell "present but opaque" from "absent". List items and + anything indented are skipped. This covers the frontmatter-like header of + knowledge/v1 documents; the prose body is never parsed.""" + data: Dict[str, Any] = {} + for line in text.lstrip("\ufeff").splitlines(): + stripped = line.strip() + if not stripped or stripped.startswith("#"): + continue + if line[:1] in (" ", "\t") or stripped.startswith("- "): + continue + match = _TOP_KEY.match(line) + if match is None: + continue + key = match.group(1) + raw = (match.group(2) or "").strip() + inline = _INLINE_LIST.match(raw) + if inline: + items = [unquote(item) for item in inline.group(1).split(",") if item.strip()] + data[key] = items + elif raw in ("", "|", ">"): + # First block key ends the metadata face; prose below never + # overwrites header values with same-name column-0 lines. + data[key] = None + if key in ("body", "history"): + break + else: + data[key] = _scalar(raw) + return data + + +_ROW_KEY = re.compile(r"^([A-Za-z_][A-Za-z0-9_-]*):(?:[ \t]+(.*))?$") +_ROW_ITEM = re.compile(r"^-\s+(.*)$") + + +def parse_register_rows(text: str) -> List[Dict[str, str]]: + """Parse the project rows of a register/v1 table (register/projects.yaml). + + Returns one dict per top-level `- id: ...` entry with the flat keys the + drift reconciliation needs: id, status, as_of, name and the spec.path + nested one level down. Header keys (schema/kind/updated) and any other + nesting are ignored. Dependency-free by design, like parse_yaml_head.""" + rows: List[Dict[str, str]] = [] + current: Optional[Dict[str, str]] = None + in_spec = False + skipping_nested = False + for line in text.lstrip("\ufeff").splitlines(): + stripped = line.strip() + if not stripped or stripped.startswith("#"): + continue + indented = line[:1].isspace() + indent = len(line) - len(line.lstrip(" ")) + item = _ROW_ITEM.match(stripped) + if item is not None: + if not indented or indent <= 2: + payload = item.group(1) + match = _ROW_KEY.match(payload) + if match is not None and match.group(1) == "id": + current = {"id": _scalar(match.group(2) or "")} + rows.append(current) + in_spec = False + skipping_nested = False + continue + else: + # a deeper `- key:` list item (deps, aliases...) belongs to a + # nested block, never to the current top-level row + skipping_nested = True + continue + if current is None or skipping_nested: + continue + if line[:1].isspace(): + match = _ROW_KEY.match(stripped) + if match is None: + continue + key = match.group(1) + raw = (match.group(2) or "").strip() + if in_spec: + if key == "path" and raw: + current["path"] = _scalar(raw) + continue + if key == "spec" and raw == "": + in_spec = True + elif raw and key in ("status", "as_of", "name"): + current[key] = _scalar(raw) + else: + in_spec = False + return rows + + +_TOP_ROW_KEY_LINE = re.compile(r"^(?:id|name):(?:\s|$)", re.MULTILINE) + + +def has_top_level_row_keys(text: str) -> bool: + """Column-0 `id:`/`name:` mapping keys — the flat-map mistake behind a + register table that parsed zero `- id:` rows.""" + return _TOP_ROW_KEY_LINE.search(text) is not None + + def first_heading(text: str, fallback: str = "") -> str: for line in text.splitlines(): if line.startswith("# "): @@ -428,6 +548,7 @@ def git_last_commit_dates(root: Path) -> Optional[Dict[str, str]]: NOTE_DATE_KEYS = ("updated", "date", "lastmod", "created") _NOTE_DATE_RE = re.compile(r"^\d{4}-\d{2}-\d{2}(?:[T ][\d:]+)?") +DATE_ONLY_RE = re.compile(r"^\d{4}-(?:0[1-9]|1[0-2])-(?:0[1-9]|[12]\d|3[01])$") def parse_note_header(text: str) -> Optional[Dict[str, Any]]: diff --git a/external_plugins/guster/templates/hub/AGENTS.md b/external_plugins/guster/templates/hub/AGENTS.md index b2bb8dc4..c089b03d 100644 --- a/external_plugins/guster/templates/hub/AGENTS.md +++ b/external_plugins/guster/templates/hub/AGENTS.md @@ -5,16 +5,16 @@ This repository is the data plane for agent context. The Guster plugin reads it; ## Map - Knowledge index: [{{KNOWLEDGE_PATH}}/README.md]({{KNOWLEDGE_PATH}}/README.md) -- Project registry: [{{PROJECTS_PATH}}/_registry.md]({{PROJECTS_PATH}}/_registry.md) +- Project register: [register/projects.yaml](register/projects.yaml) - Tool index: [{{TOOLS_PATH}}/README.md]({{TOOLS_PATH}}/README.md) - Hub contract: [hub.yaml](hub.yaml) ## Rules -- One topic per knowledge file. Put durable, reusable knowledge in `{{KNOWLEDGE_PATH}}/general/` or `{{KNOWLEDGE_PATH}}/projects/`. -- Register a project in `{{PROJECTS_PATH}}/_registry.md` before adding `{{PROJECTS_PATH}}/{slug}.md`. +- One topic per knowledge file. First-level directories under `{{KNOWLEDGE_PATH}}/` are subzones (`general/`, `projects/`, `reference/`, ...), all discovered and index-checked. +- Register every project as a row in `register/projects.yaml` (id, status, as_of, spec.path); keep spec.path resolvable. - State documents must carry `verified_at: YYYY-MM-DD`. -- File paths are markdown links or inline code, never naked in prose, so `guster doctor` can verify them (CTX-03). +- File paths are markdown links or inline code, never naked in prose, so `guster doctor` can verify them. - Code and tests remain the source of truth; this hub stores decisions and pointers. - Never store credentials, company secrets, generated caches or scratch files here. diff --git a/external_plugins/guster/templates/hub/README.md b/external_plugins/guster/templates/hub/README.md index e1b1e685..2db1e050 100644 --- a/external_plugins/guster/templates/hub/README.md +++ b/external_plugins/guster/templates/hub/README.md @@ -12,7 +12,7 @@ guster doctor --scope hub ## Add content -- Knowledge: create one topic per file under `{{KNOWLEDGE_PATH}}/general/` or `{{KNOWLEDGE_PATH}}/projects/`, then add it to `{{KNOWLEDGE_PATH}}/README.md`. -- Project: add a row to `{{PROJECTS_PATH}}/_registry.md`, then create `{{PROJECTS_PATH}}/{slug}.md` with a `verified_at` date. +- Knowledge: create one topic per file under any first-level subzone of `{{KNOWLEDGE_PATH}}/` (`general/`, `projects/`, ...), then add it to `{{KNOWLEDGE_PATH}}/README.md`. +- Project: add a row to `register/projects.yaml` (id, status, as_of, spec.path, ...) pointing at the project directory. - Tool: add one directory under `{{TOOLS_PATH}}/` with its own `AGENTS.md`, then register it in `{{TOOLS_PATH}}/README.md`. - Handoff and reports are optional modules. Add them only when the workflow needs them. diff --git a/external_plugins/guster/templates/hub/hub.yaml.tmpl b/external_plugins/guster/templates/hub/hub.yaml.tmpl index c04c25c3..daa9cd3b 100644 --- a/external_plugins/guster/templates/hub/hub.yaml.tmpl +++ b/external_plugins/guster/templates/hub/hub.yaml.tmpl @@ -1,6 +1,5 @@ # yaml-language-server: $schema=https://raw.githubusercontent.com/Lumos-789/guster/main/schemas/hub.schema.json schema_version: 2 -profile: lite hub_version: 0.1.0 min_guster: {{PLUGIN_VERSION}} name: {{HUB_NAME}} diff --git a/external_plugins/guster/templates/hub/knowledge/general/knowledge-v1-skeleton.txt b/external_plugins/guster/templates/hub/knowledge/general/knowledge-v1-skeleton.txt new file mode 100644 index 00000000..0bd7639f --- /dev/null +++ b/external_plugins/guster/templates/hub/knowledge/general/knowledge-v1-skeleton.txt @@ -0,0 +1,20 @@ +# knowledge/v1 skeleton — copy to .yaml next to this file, then uncomment +# and fill each line. The contract is opt-in: only files whose metadata face +# carries the uncommented `schema: knowledge/v1` header are validated; plain +# notes are never touched. Index the new file in knowledge/README.md. +# +# schema: knowledge/v1 +# id: my-topic # must equal the file stem (my-topic.yaml) +# type: howto # state | howto | principle | pitfall | decision | index | reference +# status: active # active | dormant | superseded | archived +# topic: one-line theme +# as_of: '2026-11-19' # date the facts were last checked (YYYY-MM-DD) +# updated: '2026-11-19' # last re-verification; must not predate as_of +# see_also: [] # inline list of other knowledge ids, e.g. [other-topic] +# body: # everything below the body key is free-form content +# - h: Heading +# text: | +# The durable knowledge itself. One topic per file. +# +# `type: state` and `type: index` files carry a 90-day freshness SLA while +# `status: active` — re-verify and bump `updated`, or set status dormant/archived. diff --git a/external_plugins/guster/templates/hub/knowledge/general/start-here.md b/external_plugins/guster/templates/hub/knowledge/general/start-here.md index b233ffee..516278e6 100644 --- a/external_plugins/guster/templates/hub/knowledge/general/start-here.md +++ b/external_plugins/guster/templates/hub/knowledge/general/start-here.md @@ -6,6 +6,9 @@ This hub is the data plane. The Guster plugin discovers it, checks its structure - `general/` — reusable principles, methods and tool notes that apply across projects. - `projects/` — durable business and architecture knowledge for one project. -- the hub's project state lives outside this knowledge root and is listed in its registry. +- more subzones (e.g. `reference/`) may exist; every first-level directory here is discovered automatically. +- the hub's project register lives outside this knowledge root in `register/projects.yaml`. Keep one topic per file. Add every knowledge file to [the knowledge index](../README.md). + +Structured knowledge files opt in via a `schema: knowledge/v1` header; every field is shown in the all-commented skeleton `knowledge-v1-skeleton.txt` in this directory. diff --git a/external_plugins/guster/templates/hub/projects/.gitkeep b/external_plugins/guster/templates/hub/projects/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/external_plugins/guster/templates/hub/projects/_registry.md.tmpl b/external_plugins/guster/templates/hub/projects/_registry.md.tmpl deleted file mode 100644 index 199ddfcf..00000000 --- a/external_plugins/guster/templates/hub/projects/_registry.md.tmpl +++ /dev/null @@ -1,8 +0,0 @@ -# Project Registry - -**verified_at**: {{DATE}} - -> Register a project here before creating `{slug}.md` in this directory. - -| slug | Display name | Project path | Notes | -|---|---|---|---| diff --git a/external_plugins/guster/templates/hub/register/projects.yaml.tmpl b/external_plugins/guster/templates/hub/register/projects.yaml.tmpl new file mode 100644 index 00000000..9fec3c20 --- /dev/null +++ b/external_plugins/guster/templates/hub/register/projects.yaml.tmpl @@ -0,0 +1,19 @@ +schema: register/v1 +kind: projects +updated: '{{DATE}}' +# One row per project: a top-level `- id:` list item under the `projects:` key. +# Keys: id / status (active|pending|on-hold|stale|retired) / as_of "YYYY-MM-DD" / +# name / desc / spec.path (relative to the hub root, or ~/ or absolute) / +# spec.aliases / notes. spec.path must resolve to a directory that exists on +# this machine; `./` is the legal placeholder for a row with no directory of +# its own. Unknown keys are ignored. +# +# Example shape (uncomment and edit; the table may also start empty): +# projects: +# - id: example +# status: active +# as_of: '{{DATE}}' +# name: Example +# spec: +# path: ~/code/example +# notes: one line of free-form notes diff --git a/marketplace.json b/marketplace.json index 410b87d3..40c5540f 100644 --- a/marketplace.json +++ b/marketplace.json @@ -1566,7 +1566,7 @@ "en": "Discover, audit, plan and evolve agent context across projects, skills, tools, knowledge and credentials; optionally scaffold a lightweight Guster Hub for durable knowledge and project state.", "zh-CN": "发现、诊断、规划和演进全机 agent 上下文:项目、指令、Skill、工具、知识、状态与凭据引用;可初始化一个轻量 Guster Hub,承载长期知识与项目状态。" }, - "version": "0.9.3", + "version": "0.9.4", "author": { "name": "Lumos-789", "url": "https://github.com/Lumos-789"