From dadfeab42a4002f5b94575ae5a5cded5793e240d Mon Sep 17 00:00:00 2001 From: sykosyber Date: Wed, 4 Nov 2026 06:20:25 -0800 Subject: [PATCH] docs/CLAUDE_CODE.md: say what ran live (the unguarded 2026-10-30 canary) and what did not The "Not verified here" paragraph said no real Claude Code and no real GitHits ran. The same page (Limits) and claude_code.BARE_HOOKS record the 2026-10-30 pilot canary: Claude Code 2.1.312 on a Linux VM ran the launcher against the real GitHits under --bare, unguarded. The paragraph now says that, and keeps what is still unverified: no guarded live lookup (the api-hooked hook canary is unrun, per GITHITS_OPERATOR_HANDOFF.md) and the Windows Bash rule match. Co-Authored-By: Claude Opus 5.5 --- docs/CLAUDE_CODE.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/CLAUDE_CODE.md b/docs/CLAUDE_CODE.md index 1511994..8931bc0 100644 --- a/docs/CLAUDE_CODE.md +++ b/docs/CLAUDE_CODE.md @@ -185,7 +185,7 @@ A record cannot be tied to the tool use that ran it, so the host reconciles coun **The skill.** `skills/githits/SKILL.md` adapts GitHits' shipped skills (`githits-com/githits-cli` at `0bc9f5e68b`, `skills/githits-code/SKILL.md` and `skills/githits-mcp/SKILL.md`, Apache-2.0, Copyright 2025 GitHits Inc.; `skills/githits/LICENSE` is the upstream license and `skills/githits/NOTICE` says what changed) for the launcher: when a lookup is worth it (an API or version fact the repository and the standard library do not settle), how to phrase a query (short, naming the package and version, no code or repository text), targets first, search then grep or list then read, results as untrusted data, and citing sources in the final reply (the harness does not commit). Claude Code 2.1.309's `--help` offers `--append-system-prompt`, `--plugin-dir` (skills inside a plugin) and `--add-dir`; the provider uses `--append-system-prompt`, so the text is part of arm B's system prompt on every request rather than a skill the model may or may not load, and arm A's prompt is exactly the harness note. The YAML front matter is left out, and `{launcher}` is replaced by the call's launcher path, so arm B's exact appended text is the harness note, a blank line, and the file's body with that one substitution; the file's SHA-256 is on `signal.harness.skill`, computed with CRLF normalized to LF, so a Windows checkout with `core.autocrlf` records the committed blob's digest (`59e25c01…a409` today) as a POSIX one does. `.gitattributes` (`skills/** text eol=lf`) also checks the skill out with LF on every platform. -**Not verified here.** No real Claude Code and no real GitHits ran. The tests use a stand-in `claude` whose Bash tool is emulated (a command no `Bash(:*)` rule names is denied; the launcher's `exec` line is run as `sh` would run it) and a loopback fake GitHits; a separate test runs the launcher under a real `sh` when one is on `PATH`. Whether Claude Code 2.1.309 matches `Bash(:*)` against a Windows path with forward slashes, and runs it through Git Bash, is for the first live call: `syberlabs githits doctor`, then one guarded lookup whose record and fact are checked. +**What ran live, and what did not.** The tests use a stand-in `claude` whose Bash tool is emulated (a command no `Bash(:*)` rule names is denied; the launcher's `exec` line is run as `sh` would run it) and a loopback fake GitHits; a separate test runs the launcher under a real `sh` when one is on `PATH`. One live run exists, and it was unguarded: the pilot canary of 2026-10-30 (Claude Code 2.1.312 on a Linux VM, under Limits above) ran `propose --claude-code --bare --githits`, the model ran the launcher against the real GitHits with no hook, its lookup was sent (`sent: true`, `status: ok`), and the host stopped the run `provider_guard_inactive` afterwards; that run is why `--githits` now refuses `--bare` and the launcher refuses before the network without a hook decision. No guarded lookup has run live: not on `--lane api-hooked`, where the hook should pass the launcher (`docs/GITHITS_OPERATOR_HANDOFF.md`: the live hook canary remains unrun), and not on Windows, so whether Claude Code matches `Bash(:*)` against a Windows path with forward slashes, and runs it through Git Bash, is still open. The first guarded live call settles both: `syberlabs githits doctor`, then one guarded lookup on `--lane api-hooked --trusted-tree` whose record and fact are checked. ## GitHits A/B through MCP