From 6c83a35d6d5eba27ea98ee5dc5a73be6f06cdf85 Mon Sep 17 00:00:00 2001 From: vitya Date: Thu, 30 Apr 2026 00:33:05 +0300 Subject: [PATCH] =?UTF-8?q?feat(using-projects-meta):=20v1.1.0=20=E2=80=94?= =?UTF-8?q?=20mandatory=20Step=200=20freshness=20gate?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cross-machine workflows broke silently when the agent reasoned on a stale MCP cache, or hit sha-based optimistic-lock 422s on shared-wiki writes because another host had pushed minutes earlier. Codify the missing pre-flight as Step 0: 1. Always probe mcp__projects-meta__meta_status first. 2. If cache_age_minutes > 10 OR errors_count > 0 → run `node ~/.local/projects-meta-mcp/dist/sync.js` before any read. 3. For shared-wiki WRITES (knowledge_ingest, knowledge_promote) → unconditional `git -C ~/projects/projects-wiki pull --ff-only` (sha-lock will reject the commit otherwise; failure is opaque). 4. Tasks-mutations: sync via dist/sync.js is enough (no local clone of target tasks repo). 5. Sync 401/403 → STOP, send user to ~/.config/projects-mcp/auth.toml to rotate gitea_token. No silent retry. 10-minute cache window chosen as the read threshold — balances multi-machine drift detection against unnecessary Gitea round-trips. Common mistakes + Red flags expanded to call out the new failure modes. README mirrors the rule for human readers. Wiki concept page projects-meta-skills.md gets a "Freshness gate (v1.1.0)" subsection. Closes [using-projects-meta-freshness-gate]. Co-Authored-By: Claude Opus 4.7 (1M context) --- .tasks/STATUS.md | 11 +++- .tasks/using-projects-meta-freshness-gate.md | 34 ++++++++++++ .wiki/concepts/projects-meta-skills.md | 14 +++++ .wiki/log.md | 1 + dist/using-projects-meta.skill | Bin 7077 -> 8870 bytes skills/using-projects-meta/README.md | 26 ++++++++++ skills/using-projects-meta/SKILL.md | 52 +++++++++++++++++-- 7 files changed, 133 insertions(+), 5 deletions(-) create mode 100644 .tasks/using-projects-meta-freshness-gate.md diff --git a/.tasks/STATUS.md b/.tasks/STATUS.md index 08319aa..e9ed901 100644 --- a/.tasks/STATUS.md +++ b/.tasks/STATUS.md @@ -1,5 +1,5 @@ # Task Board -_Updated: 2026-04-29_ +_Updated: 2026-04-30_