Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
* @rennf93
2 changes: 1 addition & 1 deletion .github/FUNDING.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# These are supported funding model platforms

github: rennf93
github: Guard-Core
# patreon: # Replace with a single Patreon username
# open_collective: # Replace with a single Open Collective username
# ko_fi: # Replace with a single Ko-fi username
Expand Down
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
blank_issues_enabled: false
contact_links:
- name: Guard Agent PHP Documentation
url: https://rennf93.github.io/guard-agent-php/
url: https://guard-core.github.io/guard-agent-php/
about: Check the documentation for usage information and tutorials
- name: Usage Questions
url: https://github.com/rennf93/guard-agent-php/discussions
url: https://github.com/Guard-Core/guard-agent-php/discussions
about: Please ask and answer questions in GitHub Discussions
- name: Discord
url: https://discord.gg/ZW7ZJbjMkK
Expand Down
14 changes: 7 additions & 7 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ Guidance for AI agents (including Claude Code) working in this repository.

## Project Overview

rennf93/guard-agent-php (https://github.com/rennf93/guard-agent-php) is the PHP telemetry agent for the guard-core ecosystem. It buffers security events, performance metrics, and agent status in memory (optionally persisted to Redis for crash recovery) and ships them to the Guard Core App ingestion API with at-least-once delivery semantics: nothing acknowledged is lost, nothing unacknowledged is forgotten.
rennf93/guard-agent-php (https://github.com/Guard-Core/guard-agent-php) is the PHP telemetry agent for the guard-core ecosystem. It buffers security events, performance metrics, and agent status in memory (optionally persisted to Redis for crash recovery) and ships them to the Guard Core App ingestion API with at-least-once delivery semantics: nothing acknowledged is lost, nothing unacknowledged is forgotten.

- Composer package `rennf93/guard-agent-php`, type `library`, license MIT. No `version` field in composer.json (the laravel-guard/symfony-guard convention); versions come from git tags and are reported to the server as `agent_version` from `RenzoFranceschini\GuardAgent\Version::VERSION` (`0.1.0` at the time of writing). Shipped tags: none yet.
- This package contains NO security logic. It reports what a host adapter already decided; detection, rate limiting, bans, and verdicts all live in guard-core (and guard-core-php).
Expand Down Expand Up @@ -140,9 +140,9 @@ Docker equivalents are in Quick Start. There is no Makefile (the sibling PHP rep

## Related Projects

- guard-core (engine): https://github.com/rennf93/guard-core
- guard-agent (Python, semantic reference): https://github.com/rennf93/guard-agent
- guard-agent-go (Go port): https://github.com/rennf93/guard-agent-go
- guardagent (TypeScript port): https://github.com/rennf93/guard-agent-ts
- guard-core-php (PHP engine port): https://github.com/rennf93/guard-core-php
- guard-core-app (SaaS ingestion API): https://github.com/rennf93/guard-core-app
- guard-core (engine): https://github.com/Guard-Core/guard-core
- guard-agent (Python, semantic reference): https://github.com/Guard-Core/guard-agent
- guard-agent-go (Go port): https://github.com/Guard-Core/guard-agent-go
- guardagent (TypeScript port): https://github.com/Guard-Core/guard-agent-ts
- guard-core-php (PHP engine port): https://github.com/Guard-Core/guard-core-php
- guard-core-app (SaaS ingestion API): https://github.com/Guard-Core/guard-core-app
14 changes: 7 additions & 7 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ Guidance for AI agents (including Claude Code) working in this repository.

## Project Overview

rennf93/guard-agent-php (https://github.com/rennf93/guard-agent-php) is the PHP telemetry agent for the guard-core ecosystem. It buffers security events, performance metrics, and agent status in memory (optionally persisted to Redis for crash recovery) and ships them to the Guard Core App ingestion API with at-least-once delivery semantics: nothing acknowledged is lost, nothing unacknowledged is forgotten.
rennf93/guard-agent-php (https://github.com/Guard-Core/guard-agent-php) is the PHP telemetry agent for the guard-core ecosystem. It buffers security events, performance metrics, and agent status in memory (optionally persisted to Redis for crash recovery) and ships them to the Guard Core App ingestion API with at-least-once delivery semantics: nothing acknowledged is lost, nothing unacknowledged is forgotten.

- Composer package `rennf93/guard-agent-php`, type `library`, license MIT. No `version` field in composer.json (the laravel-guard/symfony-guard convention); versions come from git tags and are reported to the server as `agent_version` from `RenzoFranceschini\GuardAgent\Version::VERSION` (`0.1.0` at the time of writing). Shipped tags: none yet.
- This package contains NO security logic. It reports what a host adapter already decided; detection, rate limiting, bans, and verdicts all live in guard-core (and guard-core-php).
Expand Down Expand Up @@ -140,9 +140,9 @@ Docker equivalents are in Quick Start. There is no Makefile (the sibling PHP rep

## Related Projects

- guard-core (engine): https://github.com/rennf93/guard-core
- guard-agent (Python, semantic reference): https://github.com/rennf93/guard-agent
- guard-agent-go (Go port): https://github.com/rennf93/guard-agent-go
- guardagent (TypeScript port): https://github.com/rennf93/guard-agent-ts
- guard-core-php (PHP engine port): https://github.com/rennf93/guard-core-php
- guard-core-app (SaaS ingestion API): https://github.com/rennf93/guard-core-app
- guard-core (engine): https://github.com/Guard-Core/guard-core
- guard-agent (Python, semantic reference): https://github.com/Guard-Core/guard-agent
- guard-agent-go (Go port): https://github.com/Guard-Core/guard-agent-go
- guardagent (TypeScript port): https://github.com/Guard-Core/guard-agent-ts
- guard-core-php (PHP engine port): https://github.com/Guard-Core/guard-core-php
- guard-core-app (SaaS ingestion API): https://github.com/Guard-Core/guard-core-app
2 changes: 1 addition & 1 deletion CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ Enforcement

Instances of abusive, harassing, or otherwise unacceptable behavior may be
reported to the community leaders responsible for enforcement at
@rennf93.
contact@guard-core.com.
All complaints will be reviewed and investigated promptly and fairly.

All community leaders are obligated to respect the privacy and security of the
Expand Down
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# guard-agent-php

PHP telemetry agent for the [guard-core](https://github.com/rennf93/guard-core) ecosystem. It buffers security events, performance metrics, and agent status in memory (optionally persisted to Redis) and ships them to the Guard Core App ingestion API with at-least-once delivery semantics: nothing acknowledged is lost, nothing unacknowledged is forgotten.
PHP telemetry agent for the [guard-core](https://github.com/Guard-Core/guard-core) ecosystem. It buffers security events, performance metrics, and agent status in memory (optionally persisted to Redis) and ships them to the Guard Core App ingestion API with at-least-once delivery semantics: nothing acknowledged is lost, nothing unacknowledged is forgotten.

Docs: <https://rennf93.github.io/guard-agent-php/>
Docs: <https://guard-core.github.io/guard-agent-php/>

This completes the agent-per-language lineup: [guard-agent](https://github.com/rennf93/guard-agent) (Python), guardagent (TypeScript), guard-agent-rs (Rust), guard-agent-go (Go), and now guard-agent-php (PHP). Like the other ports it is a library, not a process: it never throws into the host request path, and every telemetry failure is a log line plus a counter bump.
This completes the agent-per-language lineup: [guard-agent](https://github.com/Guard-Core/guard-agent) (Python), guardagent (TypeScript), guard-agent-rs (Rust), guard-agent-go (Go), and now guard-agent-php (PHP). Like the other ports it is a library, not a process: it never throws into the host request path, and every telemetry failure is a log line plus a counter bump.

## Install

Expand Down Expand Up @@ -101,9 +101,9 @@ With `redis` configured, every accepted item is written to Redis under a globall

## Related projects

- [guard-core](https://github.com/rennf93/guard-core): the framework-agnostic engine library.
- [guard-agent](https://github.com/rennf93/guard-agent) (Python), guardagent (TypeScript), guard-agent-rs (Rust), guard-agent-go (Go): sibling agents.
- [guard-core-app](https://github.com/rennf93/guard-core-app): the SaaS platform this agent reports to.
- [guard-core](https://github.com/Guard-Core/guard-core): the framework-agnostic engine library.
- [guard-agent](https://github.com/Guard-Core/guard-agent) (Python), guardagent (TypeScript), guard-agent-rs (Rust), guard-agent-go (Go): sibling agents.
- [guard-core-app](https://github.com/Guard-Core/guard-core-app): the SaaS platform this agent reports to.

## License

Expand Down
4 changes: 2 additions & 2 deletions SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,12 +16,12 @@ We take the security of Guard Agent PHP seriously. If you believe you've found a

1. **Do not disclose the vulnerability publicly** until it has been addressed by the maintainers.
2. **Report the vulnerability through GitHub's security advisory feature**:
- Go to the [Security tab](https://github.com/rennf93/guard-agent-php/security/advisories) of the Guard Agent PHP repository
- Go to the [Security tab](https://github.com/Guard-Core/guard-agent-php/security/advisories) of the Guard Agent PHP repository
- Click on "New draft security advisory"
- Fill in the details of the vulnerability
- Submit the advisory

Alternatively, you can report vulnerabilities through [GitHub's private vulnerability reporting feature](https://github.com/rennf93/guard-agent-php/security/advisories/new).
Alternatively, you can report vulnerabilities through [GitHub's private vulnerability reporting feature](https://github.com/Guard-Core/guard-agent-php/security/advisories/new).

3. Include the following information in your report:
- A description of the vulnerability and its potential impact
Expand Down
6 changes: 3 additions & 3 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,10 @@
`guard-agent-php` is the PHP telemetry agent of the Guard ecosystem. It
buffers security events, metrics, and status reports produced by your
application (typically through a guard-core adapter's block hooks) and ships
them to the [guard-core-app](https://github.com/rennf93/guard-core-app)
them to the [guard-core-app](https://github.com/Guard-Core/guard-core-app)
ingestion API with at-least-once delivery.

It is a port of the normative [guard-agent](https://github.com/rennf93/guard-agent)
It is a port of the normative [guard-agent](https://github.com/Guard-Core/guard-agent)
(Python) semantics: per-kind buffers, overflow policies, retry with backoff,
413 batch split-or-drop, Retry-After honoring, a circuit breaker, optional
Redis-backed queue persistence, and a persisted install id. Unlike the
Expand Down Expand Up @@ -60,7 +60,7 @@ register_shutdown_function(static function () use ($agent): void {
Most applications do not call the agent directly: the guard-core adapters
expose a block hook (for example guard-core-php's `SecurityConfig(onBlock: ...)`)
where the event construction belongs. See
[examples/basic_usage](https://github.com/rennf93/guard-agent-php/tree/main/examples/basic_usage)
[examples/basic_usage](https://github.com/Guard-Core/guard-agent-php/tree/main/examples/basic_usage)
for the wiring shape.

## What the agent guarantees
Expand Down
4 changes: 2 additions & 2 deletions mkdocs.yml
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
site_name: guard-agent-php
site_description: PHP telemetry agent reporting to the Guard Core App ingestion API
site_author: Renn F
repo_url: https://github.com/rennf93/guard-agent-php
repo_name: rennf93/guard-agent-php
repo_url: https://github.com/Guard-Core/guard-agent-php
repo_name: Guard-Core/guard-agent-php

theme:
name: material
Expand Down
Loading