Commit Graph
8 Commits
Author SHA1 Message Date
Willie 54d0d5eed0 docs(wiki): require all five shell completions for command changes
The completion scripts are written by hand and never read the CLI's
dispatch, so new subcommands (mcp edit in bash and fish, backup list
and show in fish) went missing in some shells without any test failing.
Contributors now have an explicit rule and a completion-criteria check
for it.
2026-09-30 14:53:16 +08:00
Willie 8c98ab3b51 test(completion): exercise zsh and fish completions
The completion tests only grepped the generated scripts, so a script
that parses but offers nothing, or a flag listed in the wrong place,
passed. These tests load the scripts in a real fish (complete -C) and a
real zsh (compinit under zpty, capturing what compadd receives) and
assert the mcp subcommands and the mcp check flags, including --live
and --timeout. They skip where the shells are not installed; the
testing wiki says how to run them in a throwaway container.

Refs #141
2026-09-30 14:37:43 +08:00
Willie 92b78c2962 docs(wiki): route agents to the shared sync runners and request helpers
The recent refactors consolidated sync loops into internal/sync runners,
server body decoding into decodeJSON, and UI kind queries into kindQuery.
Without pointers in the topics an agent would likely reimplement these
inline and reintroduce the drift the refactors removed.
2026-09-30 02:41:39 +08:00
Willie cbe8d3a437 refactor(ui): share query hooks for overview, mcp, skills, targets and diff
Close to thirty components and pages each spelled out the same query key,
fetcher and stale time for these shared queries. They now call one hook
per query and pass only what differs per page: enabled flags, polling,
and the MCP stale time, which pages already disagreed on and keep.
2026-09-30 02:29:07 +08:00
Willie 8063a6f424 chore(windows): add UTM verification helper and skill
Windows acceptance on the local UTM guest was a pile of one-off
commands: finding utmctl, polling async exec, running as the desktop
user with a basic token, pinning builds, and pre-seeding the UI cache.
utm.sh wraps those steps, manual-setup.ps1 gives a one-line hands-on
setup in an isolated home, and the skill records the workflow and the
pitfalls hit along the way (S4U tokens, ARM64 emulation, zsh echo).

Refs #299
2026-09-28 16:05:16 +08:00
Willie c7eb59a78f fix(sync): stop linking single files with junctions on Windows
createLink always tried `mklink /J` first. mklink does not check the
source type, so agents, single-file extras such as a shared AGENTS.md, and
per-file extras links became directory junctions that point at a file:
Explorer shows a folder and tools cannot read it. Sync then compared only
the link destination and kept the broken junction forever.

Files now get real symlinks only. When the OS cannot create them (Windows
without Developer Mode, non-elevated), file-based link modes fall back to
copies at the mode level, so status, doctor, the API and later syncs all
see an effective `copy` mode. Fallback copies are tracked by hash so they
keep updating and pruning without touching the user's own files, and turn
back into links once links work. Single-file extras remember what they last
wrote, so an unedited copy is replaced silently instead of producing a
drift backup on every source edit, and switching a target back to import
restores the user's attach-time content plus the import block.

Includes a Windows runbook and script, verified on a Windows 11 ARM64 VM
with and without symlink rights.

Refs #299
2026-09-28 13:54:52 +08:00
Willie bf1226ea5c docs(skills): fix agent instructions that drifted from the code
Agents follow these skills literally, and several no longer matched the
repo: the test example called AssertSuccess() without t so every test
written from it failed to compile, update-docs grepped for a flag package
the CLI never uses, codebase-audit checked a targets.yaml schema and a
specs/ directory that are gone, and the auth-test recipe pointed at the
wrong package and ran credential-helper outside the login shell that puts
it on PATH. Also reconciles rules that contradicted AGENTS.md (host-side
test runs, unconditional scope confirmation, commit/tag authorization)
and drops a reference to an mdproof skill that is not installed.
2026-09-25 02:41:32 +08:00
Willie 262e639701 docs: add task-routed agent wiki
Add a shared instruction kernel and byte-budgeted topic router so agents load only task-relevant repository guidance. Wire drift checks into local and CI workflows and point project skills at the routed topics.
2026-09-25 02:32:37 +08:00