agemon 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Korak-997
+
+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,169 @@
+# agemon
+
+Bootstrap and reverse an AI coding agent environment in a repository with one CLI.
+
+`agemon` installs a curated plugin bundle, tracks all managed actions in a state manifest,
+and can cleanly reverse those actions with `nuke`.
+
+## What It Does
+
+Current v0.1 behavior is plugin-driven and runs in this order:
+
+1. `crg`: installs and verifies `code-review-graph`.
+2. `daemon`: registers `crg-daemon` autostart via `systemd --user`.
+3. `skills`: installs bundled skills via `npx skills`.
+4. `workflow-scaffolder`: writes bundled GitHub workflow files.
+5. `cli-tool`: installs bundled global CLI tools.
+6. `master-prompt`: consolidates agent rule files and pointer files.
+
+Every mutating plugin action is recorded in `.agemon/state.json` and used by `nuke` for
+targeted reversal.
+
+## Requirements
+
+- Linux with Ubuntu (`/etc/os-release` must report `ID=ubuntu`).
+- Node.js `>=24`.
+- `npx`.
+- Binaries checked at runtime: `python3`, `pip`, `pipx`, `uv`, `crg`.
+
+Notes:
+- The CLI reports binary availability but does not auto-install missing dependencies.
+- Unsupported platforms exit with a clear error message.
+
+## Install
+
+Install in the current repository:
+
+```bash
+npx agemon@latest install
+```
+
+Or use the local preflight script:
+
+```bash
+sh ./install.sh
+```
+
+## CLI Usage
+
+`install` is the default command:
+
+```bash
+agemon [options]
+```
+
+Reverse managed changes:
+
+```bash
+agemon nuke [options]
+```
+
+### Global Options
+
+- `--dry-run`: narrate actions without making changes.
+- `--yes`: skip confirmation prompts.
+- `--only <plugins>`: run only a comma-separated subset of plugins.
+- `--skip-daemon`: skip daemon registration during install.
+- `--no-color`: disable ANSI colors.
+- `-v, --verbose`: show raw subprocess output beneath each step.
+- `-q, --quiet`: reduce output to minimal step/final lines.
+
+Examples:
+
+```bash
+# See planned actions only
+npx agemon@latest install --dry-run
+
+# Install only skills and workflows
+npx agemon@latest install --only skills,workflow-scaffolder
+
+# Reverse only specific plugins
+npx agemon@latest nuke --only skills,workflow-scaffolder
+```
+
+## Reversibility Guarantees
+
+- `nuke` removes only agemon-managed artifacts tracked in `.agemon/state.json`.
+- Pre-existing tools/files are detected and preserved.
+- Master-prompt file edits are backed up in `.agemon/backups/master-prompt/` and restored
+	on uninstall.
+
+## Managed Outputs
+
+By default, agemon may manage these paths:
+
+- `.agemon/state.json`
+- `.agemon/backups/master-prompt/*.bak`
+- `.github/workflows/claude-code-security-review.yml`
+- `.github/workflows/code-review-graph-action.yml`
+- `AGENTS.md`
+- `CLAUDE.md`
+- `GEMINI.md`
+- `.cursorrules`
+- `.windsurfrules`
+
+It also invokes external installers (`pipx`, `npm -g`, `npx skills`) when required.
+
+## Local Development
+
+```bash
+npm install
+npm run build
+npm run typecheck
+npm run lint
+npm test
+```
+
+Development CLI entrypoint:
+
+```bash
+npm run dev -- --help
+```
+
+## Sandbox Harness
+
+Use the sandbox harness for isolated, repeatable checks against fixtures in `test/fixtures`:
+
+```bash
+# One run
+npm run sandbox -- run clean-repo
+
+# Dry-run simulation
+npm run sandbox -- run clean-repo --dry-run
+
+# Install + nuke roundtrip integrity
+npm run sandbox -- roundtrip clean-repo
+
+# Watch mode
+npm run sandbox -- watch clean-repo
+
+# Reset sandbox artifacts
+npm run sandbox -- reset
+```
+
+Useful sandbox flags:
+
+- `--real`: execute real subprocesses/services instead of fake backends.
+- `--trace`: map to verbose CLI output.
+- `--quiet`: suppress captured terminal output.
+- `--skip-daemon`: skip daemon plugin in the run.
+- `--only <plugins>`: run selected plugins only.
+
+## Detailed Docs
+
+- Architecture and operations: `docs/architecture-and-operations.md`
+- Release process: `docs/releasing.md`
+- Audit and review report: `docs/review-2026-08-13.md`
+- Historical implementation plan: `docs/implementation-plan.md`
+
+## Roadmap Notes
+
+Planned but not currently implemented:
+
+- Dedicated `status` command.
+- Dedicated `doctor` command.
+- Native Windows/macOS platform support.
+
+## License
+
+MIT

package/bin/agemon.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runCli } from "../dist/index.js";
+
+process.exitCode = await runCli(process.argv.slice(2));