agent-config 0.3.2

Install hooks/integrations into AI coding harnesses (Claude Code, Cursor, Gemini CLI, OpenCode, Codex CLI, Cline, Windsurf, ...) without learning each one's filesystem layout.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

//! Cross-surface regression: a hook with `tag = "T"` and an instruction with
//! `name = "T"` installed into the same harness must not overwrite each
//! other. Pre-rename, both wrote to the same `AGENT-CONFIG:T` fence and the
//! second install silently replaced the first.

use std::fs;

use agent_config::{
    by_id, instruction_by_id, Event, HookSpec, InstructionPlacement, InstructionSpec, Matcher,
    Scope,
};

#[test]
fn hook_tag_and_instruction_name_coexist_in_same_memory_file() {
    let dir = tempfile::tempdir().unwrap();
    let scope = Scope::Local(dir.path().to_path_buf());

    // Hook with rules — Claude writes both a hook entry to settings.json and
    // a fenced rules block to CLAUDE.md, keyed on tag "shared".
    let hook_spec = HookSpec::builder("shared")
        .command_program("shared", ["hook"])
        .matcher(Matcher::Bash)
        .event(Event::PreToolUse)
        .rules("Hook rules content for the shared tag.")
        .build();

    let claude = by_id("claude").expect("claude integration");
    let _ = claude.install(&scope, &hook_spec).expect("install hook");

    // Instruction with the SAME name. ReferencedFile placement also writes
    // a fenced block into CLAUDE.md (an `@<NAME>.md` include). Pre-rename,
    // this would have overwritten the hook block.
    let instr_spec = InstructionSpec::builder("shared")
        .owner("instr-owner")
        .placement(InstructionPlacement::ReferencedFile)
        .body("# Shared instruction body.\n")
        .try_build()
        .expect("valid instruction spec");

    let instr_surface = instruction_by_id("claude").expect("claude instructions");
    let _ = instr_surface
        .install_instruction(&scope, &instr_spec)
        .expect("install instruction");

    let claude_md = fs::read_to_string(dir.path().join("CLAUDE.md")).unwrap();

    assert!(
        claude_md.contains("<!-- BEGIN AGENT-CONFIG:shared -->"),
        "hook fence missing after instruction install: {claude_md}"
    );
    assert!(
        claude_md.contains("<!-- BEGIN AGENT-CONFIG-INSTR:shared -->"),
        "instruction fence missing: {claude_md}"
    );
    assert!(
        claude_md.contains("Hook rules content for the shared tag."),
        "hook body lost: {claude_md}"
    );
    assert!(
        claude_md.contains("@.claude/instructions/shared.md"),
        "instruction include line missing: {claude_md}"
    );
}

#[test]
fn uninstalling_instruction_does_not_disturb_hook_block_with_same_tag() {
    let dir = tempfile::tempdir().unwrap();
    let scope = Scope::Local(dir.path().to_path_buf());

    let hook_spec = HookSpec::builder("shared")
        .command_program("shared", ["hook"])
        .matcher(Matcher::Bash)
        .event(Event::PreToolUse)
        .rules("Hook rules survive instruction uninstall.")
        .build();

    let claude = by_id("claude").expect("claude integration");
    let _ = claude.install(&scope, &hook_spec).unwrap();

    let instr_spec = InstructionSpec::builder("shared")
        .owner("instr-owner")
        .placement(InstructionPlacement::ReferencedFile)
        .body("# Shared instruction body.\n")
        .try_build()
        .unwrap();

    let instr_surface = instruction_by_id("claude").unwrap();
    let _ = instr_surface
        .install_instruction(&scope, &instr_spec)
        .unwrap();
    let _ = instr_surface
        .uninstall_instruction(&scope, "shared", "instr-owner")
        .unwrap();

    let claude_md = fs::read_to_string(dir.path().join("CLAUDE.md")).unwrap();

    assert!(
        claude_md.contains("<!-- BEGIN AGENT-CONFIG:shared -->"),
        "hook fence destroyed by instruction uninstall: {claude_md}"
    );
    assert!(
        claude_md.contains("Hook rules survive instruction uninstall."),
        "hook body destroyed by instruction uninstall: {claude_md}"
    );
    assert!(
        !claude_md.contains("<!-- BEGIN AGENT-CONFIG-INSTR:shared -->"),
        "instruction fence not removed: {claude_md}"
    );
    assert!(
        !claude_md.contains("@.claude/instructions/shared.md"),
        "instruction include line not removed: {claude_md}"
    );
}