agent-watch 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-02-15
+
+### Added
+
+- Initial release of agent-watch
+- CLI tool for keeping AI agent configuration files in sync with your codebase
+- Interactive setup command `agent-watch init` with guided configuration
+- Git hook integration with auto-detection for:
+  - Lefthook
+  - Husky
+  - Direct `.git/hooks/` installation
+- Support for multiple AI agent configuration files:
+  - `CLAUDE.md` (Claude Code)
+  - `.github/copilot-instructions.md` and `copilot-instructions.md` (GitHub Copilot)
+  - `AGENTS.md` / `agents.md` (Generic)
+  - `.cursorrules` / `.cursor/rules` (Cursor)
+  - `.windsurfrules` (Windsurf)
+  - `.clinerules` (Cline)
+- Git context gathering from:
+  - Commit messages
+  - Changed files
+  - AI chat sessions (GitHub Copilot CLI support)
+- Smart filtering to skip runs when only documentation/config files are modified
+- Configurable hook triggers (post-commit or pre-push)
+- Programmatic API for library usage:
+  - `loadConfig()` - Load agent-watch configuration
+  - `detectAgentFiles()` - Auto-detect agent files in project
+  - `KNOWN_AGENT_FILES` - List of supported agent file patterns
+- Idempotent hook installation (safe to re-run)
+- Configuration file `.agent-watch.json` for project settings
+
+[1.0.0]: https://github.com/surnr/agent-watch/releases/tag/v1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agent Watch Contributors
+
+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.

package/README.md

@@ -0,0 +1,95 @@
+# Agent Watch
+
+CLI tool that uses git hooks to keep your AI agent configuration files in sync with your codebase. It watches for commits or pushes, gathers context from git changes and chat sessions, and automatically updates your agent files.
+
+## Install
+
+```bash
+npm install -g agent-watch
+```
+
+Or run directly:
+
+```bash
+npx agent-watch init
+```
+
+## Quick start
+
+```bash
+cd your-project
+agent-watch init
+```
+
+The `init` command walks you through an interactive setup:
+
+1. **Select agent files** - auto-detects existing files and lets you pick which ones to manage (space to toggle, enter to confirm)
+2. **Git context** - choose whether to use commit messages and chat sessions when updating files
+3. **Hook trigger** - pick when to run: after `git commit` or before `git push`
+4. **AI agents** - select which agent integrations to enable (GitHub Copilot CLI, more coming)
+
+Your choices are saved to `.agent-watch.json` in the project root.
+
+## Supported agent files
+
+| File                              | Agent          |
+| --------------------------------- | -------------- |
+| `CLAUDE.md`                       | Claude Code    |
+| `.github/copilot-instructions.md` | GitHub Copilot |
+| `copilot-instructions.md`         | GitHub Copilot |
+| `AGENTS.md` / `agents.md`         | Generic        |
+| `.cursorrules` / `.cursor/rules`  | Cursor         |
+| `.windsurfrules`                  | Windsurf       |
+| `.clinerules`                     | Cline          |
+
+## How it works
+
+After running `agent-watch init`:
+
+- A git hook is installed (or instructions are provided if you use lefthook/husky)
+- On each commit or push (depending on your config), agent-watch gathers context from:
+  - Changed files in the commit
+  - Git commit messages
+  - Chat sessions from supported AI tools
+- It uses this context to update your selected agent configuration files
+
+**Smart filtering**: agent-watch automatically skips running when only documentation or config files are modified (like README.md, .gitignore, lock files, etc.), keeping your workflow fast.
+
+## Configuration
+
+The `.agent-watch.json` config file:
+
+```json
+{
+  "version": 1,
+  "agentFiles": ["CLAUDE.md", ".github/copilot-instructions.md"],
+  "useGitContext": true,
+  "hookTrigger": "commit",
+  "agents": ["github-copilot-cli"]
+}
+```
+
+## Git hook integration
+
+agent-watch detects your existing hook manager:
+
+- **Lefthook** - prints the config to add to `lefthook.yml`
+- **Husky** - prints the `npx husky add` command to run
+- **No hook manager** - installs directly to `.git/hooks/`
+
+The hook is idempotent and can be safely re-run.
+
+## Programmatic API
+
+You can also use agent-watch as a library:
+
+```ts
+import { loadConfig, detectAgentFiles, KNOWN_AGENT_FILES } from "agent-watch"
+
+const config = loadConfig("./my-project")
+const files = detectAgentFiles("./my-project")
+```
+
+## License
+
+MIT

package/dist/cli-nMe9-VkJ.d.ts

@@ -0,0 +1 @@
+export { };