Skip to content

armgit / AiSOC

Public Imported from GitHub
0

Open-source AI Security Operations Center: alert fusion, LLM-agent triage, MITRE ATT&CK investigation, and a replayable decision ledger for every agent step. Self-hostable, runs with no API keys, MIT licensed. Ships an MCP server for Claude, Cursor and Continue.

docs(plans): add README + codeql paths-ignore for cyble-aisoc subtree

Beenu Arora34fe58532703
diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml
index 26e21479a..34f283b0d 100644
--- a/.github/workflows/codeql.yml
+++ b/.github/workflows/codeql.yml
@@ -30,6 +30,15 @@ jobs:
with:
languages: ${{ matrix.language }}
queries: security-and-quality
+ # `plans/cyble-aisoc/` is a historical-spec mirror of the (private)
+ # AISOC-Cyble repository, kept for open-source provenance. Its
+ # `platform/` Python prototype was superseded by the canonical
+ # implementation under `services/` and is not a deployed artifact;
+ # CodeQL findings there would be noise, not actionable security
+ # issues.
+ config: |
+ paths-ignore:
+ - 'plans/cyble-aisoc/**'
- name: Autobuild
uses: github/codeql-action/autobuild@v4
diff --git a/plans/cyble-aisoc/README.md b/plans/cyble-aisoc/README.md
new file mode 100644
index 000000000..1ef2c3315
--- /dev/null
+++ b/plans/cyble-aisoc/README.md
@@ -0,0 +1,55 @@
+# Cyble AiSOC — historical spec + prototype
+
+This directory is the open-source mirror of the (formerly private) `beenuar/AISOC-Cyble`
+repository, merged in via `git subtree` on 2026-06-27 to consolidate all
+project history under a single public home.
+
+It is **historical / spec content**, not deployed code. The canonical, deployed,
+production implementation lives at the repo root (`services/`, `apps/`,
+`infra/`, `packages/`, etc.).
+
+## What's in here
+
+| Path | What it is |
+| ---- | ---------- |
+| `cyble-aisoc-plan.md` | The 79 KB north-star authoring spec that the public monorepo at the root was built against. Treat as read-only. |
+| `architecture/` | Early architecture notes: agent topology, integration matrix. Superseded by `docs/architecture/` at the repo root. |
+| `roadmap/` | Original 12-month roadmap. Superseded by `ROADMAP.md` + `plans/aisoc_v8.0_north_star_plan_*.plan.md` at the repo root. |
+| `platform/` | FastAPI + static-frontend prototype that proved out the agent mesh, vertical detection packs, MSSP white-label, FinOps ledger, marketplace, academy, supply-chain risk, multi-region routing, observability, streaming runtime, threat-actor profiler, TS connector SDK, and more. Re-implemented (and significantly extended) under `services/api/` in the deployed monorepo. |
+| `platform/.github/workflows/detections-validate.yml` | Old detection-validation workflow. Inert here (GitHub Actions only triggers workflows in the repo-root `.github/workflows/`). The active equivalent at the root is `.github/workflows/validate-detections.yml`. |
+| `AGENTS.md` | Original workspace AGENTS memory. The active AGENTS file is at the repo root. |
+| `index.html` | Original landing page. The live landing page is served from `apps/web/`. |
+
+## Why it's preserved
+
+1. **Provenance** — anyone reading the public history can trace how `services/api/app/agents/*` evolved from `platform/backend/app/agents/*`, file-by-file.
+2. **Spec ↔ code** — `cyble-aisoc-plan.md` is the source-of-truth design doc; the deployed monorepo implements it.
+3. **Reference detection rules** — `platform/backend/app/detections/rules/` contains ~150 YAML rules across cloud / endpoint / identity / network / email / webserver / vertical (healthcare, finserv, manufacturing, retail, public sector) categories. These were the seed corpus for the production detection pack now under `detections/` at the repo root.
+
+## What NOT to do
+
+- **Don't run `platform/`'s Dockerfile in production.** It was a single-process prototype; the deployed system is a multi-service compose (`docker-compose.yml` + `infra/terraform/`).
+- **Don't `pip install` from `platform/backend/requirements.txt`.** Versions are frozen to the prototype era; production dependencies are in `services/*/pyproject.toml`.
+- **Don't import from `plans.cyble_aisoc.platform.*` into deployed code.** Use the canonical implementations under `services/`.
+
+## CI / scanning policy
+
+CodeQL is configured (`.github/workflows/codeql.yml`) to skip everything under
+`plans/cyble-aisoc/**` — its findings would be informational rather than
+actionable because nothing under this tree is shipped to users.
+
+The repo-root `validate-detections` workflow only walks the root-level
+`detections/` directory; it does not pick up the prototype YAML rules here.
+
+## Git history
+
+The subtree merge preserved both founding commits of AISOC-Cyble:
+
+- `5581d4b Initial import: Cyble AiSOC platform`
+- `e4080973 feat(platform): land 13 feature areas from cyble-aisoc-plan.md`
+
+They are reachable from `main` of this repo via the merge commit titled
+`Add 'plans/cyble-aisoc/' from commit '<sha>'`.
+
+For future cross-repo syncs, the original is at
+`https://github.com/beenuar/AISOC-Cyble` (private). Use `git subtree pull --prefix=plans/cyble-aisoc aisoc-cyble main` if it ever needs to be refreshed.