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.

fix(web): point marketing-page docs links at the Docusaurus site (#245)

Asin sayed ali60f80e4ebba7
diff --git a/.env.example b/.env.example
index 7aa544385..2e6822b19 100644
--- a/.env.example
+++ b/.env.example
@@ -162,3 +162,7 @@ AZURE_WORKSPACE_NAME=
NEXT_PUBLIC_API_URL=http://localhost:8000
NEXT_PUBLIC_REALTIME_URL=http://localhost:8086
NEXT_PUBLIC_WS_URL=ws://localhost:8086
+
+# Override the docs site base URL (default: https://beenuar.github.io/AiSOC/docs).
+# Set this when serving docs from a custom domain like https://docs.tryaisoc.com/docs.
+# NEXT_PUBLIC_DOCS_URL=https://docs.tryaisoc.com/docs
diff --git a/apps/web/src/app/(marketing)/sovereign/page.tsx b/apps/web/src/app/(marketing)/sovereign/page.tsx
index 71a40589f..3de56db44 100644
--- a/apps/web/src/app/(marketing)/sovereign/page.tsx
+++ b/apps/web/src/app/(marketing)/sovereign/page.tsx
@@ -395,7 +395,7 @@ export default function SovereignPage() {
<RepoArtefact
label="Investigation ledger"
path="services/agents/app/ledger/"
- href="https://github.com/beenuar/AiSOC#investigation-ledger"
+ href="https://github.com/beenuar/AiSOC/tree/main/services/agents/app/ledger"
body="Every prompt, tool call, evidence row, and decision the agent makes — durable and replayable. The auditor reads the events directly, not a vendor summary."
/>
<RepoArtefact
diff --git a/apps/web/src/app/benchmark/page.tsx b/apps/web/src/app/benchmark/page.tsx
index e9b923791..90cd42d85 100644
--- a/apps/web/src/app/benchmark/page.tsx
+++ b/apps/web/src/app/benchmark/page.tsx
@@ -9,6 +9,7 @@ import {
import { ComparisonTable } from '@/components/benchmark/ComparisonTable';
import { KpiBar } from '@/components/benchmark/KpiBar';
import { CommunitySubmissions } from '@/components/benchmark/CommunitySubmissions';
+import { docs } from '@/lib/docs';
export const metadata: Metadata = {
title: 'Public benchmark scoreboard',
@@ -169,7 +170,7 @@ export default async function BenchmarkPage() {
append-only weekly history (substrate and wet-eval rows side-by-side
with a MITRE-accuracy trend chart), see the{' '}
<a
- href="https://github.com/beenuar/AiSOC#readme"
+ href={docs('benchmark')}
target="_blank"
rel="noreferrer"
className="underline decoration-dotted hover:text-gray-300"
@@ -414,7 +415,7 @@ export default async function BenchmarkPage() {
</p>
<div className="mt-6 flex flex-wrap justify-center gap-3">
<a
- href="https://github.com/beenuar/AiSOC/blob/main/CONTRIBUTING.md"
+ href={docs('contributing/guidelines')}
target="_blank"
rel="noreferrer"
className="inline-flex items-center gap-2 rounded-md bg-brand-500 px-4 py-2 text-sm font-semibold text-white transition hover:bg-brand-400"
diff --git a/apps/web/src/app/layout.tsx b/apps/web/src/app/layout.tsx
index 694dc8fb7..5850d53ce 100644
--- a/apps/web/src/app/layout.tsx
+++ b/apps/web/src/app/layout.tsx
@@ -5,6 +5,7 @@ import './globals.css';
import { PwaBootstrap } from '@/components/pwa/PwaBootstrap';
import { ThemeProvider } from '@/components/theme/ThemeProvider';
import { themeBootstrapScript } from '@/components/theme/themeScript';
+import { docs } from '@/lib/docs';
import { DISCOVERY_KEYWORDS, getPublicSiteUrl } from '@/lib/site';
const inter = Inter({
@@ -125,7 +126,7 @@ const jsonLd = {
},
url: siteUrl,
downloadUrl: 'https://github.com/beenuar/AiSOC',
- installUrl: 'https://github.com/beenuar/AiSOC#quick-start',
+ installUrl: docs('quickstart'),
releaseNotes: 'https://github.com/beenuar/AiSOC/releases',
featureList: [
'Click-and-connect 26 security sources (EDR, SIEM, cloud, IAM, SaaS) with encrypted credential vault',
diff --git a/apps/web/src/app/page.tsx b/apps/web/src/app/page.tsx
index 3e735383e..b789fd07c 100644
--- a/apps/web/src/app/page.tsx
+++ b/apps/web/src/app/page.tsx
@@ -1,5 +1,6 @@
import type { Metadata } from 'next';
import dynamic from 'next/dynamic';
+import { docs } from '@/lib/docs';
import { getPublicSiteUrl } from '@/lib/site';
import { velvetFontVariables } from '@/lib/marketing-fonts';
import { StickyNav } from '@/components/landing/sections/StickyNav';
@@ -116,7 +117,7 @@ const productJsonLd = {
license: 'https://opensource.org/licenses/MIT',
url: siteUrl,
downloadUrl: 'https://github.com/beenuar/AiSOC',
- installUrl: 'https://github.com/beenuar/AiSOC#quick-start',
+ installUrl: docs('quickstart'),
releaseNotes: 'https://github.com/beenuar/AiSOC/releases',
description:
'AiSOC is an MIT-licensed agentic Security Operations Center: four specialised agents (Detect, Triage, Hunt, Respond), 69 first-party connectors, a public 200-incident benchmark, and air-gap deploy on a single environment flag.',
diff --git a/apps/web/src/app/why-open-source/page.tsx b/apps/web/src/app/why-open-source/page.tsx
index f2bec755b..a5acbe6ca 100644
--- a/apps/web/src/app/why-open-source/page.tsx
+++ b/apps/web/src/app/why-open-source/page.tsx
@@ -2,6 +2,7 @@ import type { Metadata } from 'next';
import Link from 'next/link';
import { LandingNav } from '@/components/landing/LandingNav';
import { Footer } from '@/components/landing/Footer';
+import { docs } from '@/lib/docs';
export const metadata: Metadata = {
// Use `absolute` so the root layout's `template: '%s | AiSOC'` doesn't
@@ -22,7 +23,7 @@ export const metadata: Metadata = {
const PILLARS = [
{
label: 'Investigation Ledger',
- href: 'https://github.com/beenuar/AiSOC#investigation-ledger',
+ href: docs('architecture/itsm-as-source-of-truth'),
body: 'Every prompt, tool call, evidence citation, and decision the agent emits is written to a durable, queryable, replayable ledger. The ledger stores the literal LLM input and output, not a summary.',
},
{
diff --git a/apps/web/src/components/demo/DemoBanner.tsx b/apps/web/src/components/demo/DemoBanner.tsx
index 196e87423..1b3bc6a51 100644
--- a/apps/web/src/components/demo/DemoBanner.tsx
+++ b/apps/web/src/components/demo/DemoBanner.tsx
@@ -13,6 +13,7 @@
*/
import { isDemoMode, demoBannerMessage } from '@/lib/demoMode';
+import { docs } from '@/lib/docs';
export function DemoBanner() {
if (!isDemoMode()) return null;
@@ -36,7 +37,7 @@ export function DemoBanner() {
|
</span>
<a
- href="https://github.com/beenuar/AiSOC#quickstart"
+ href={docs('quickstart')}
target="_blank"
rel="noopener noreferrer"
className="underline underline-offset-2 hover:text-amber-100 transition-colors"
diff --git a/apps/web/src/components/landing/Footer.tsx b/apps/web/src/components/landing/Footer.tsx
index bc70cb784..3c95bcce0 100644
--- a/apps/web/src/components/landing/Footer.tsx
+++ b/apps/web/src/components/landing/Footer.tsx
@@ -1,5 +1,6 @@
import Link from 'next/link';
import packageJson from '../../../package.json';
+import { docs } from '@/lib/docs';
import { Logo } from './Logo';
const APP_VERSION = packageJson.version;
@@ -22,7 +23,7 @@ const COLUMNS = [
links: [
{ label: 'Why open source', href: '/why-open-source' },
{ label: 'GitHub', href: 'https://github.com/beenuar/AiSOC' },
- { label: 'Quickstart', href: 'https://github.com/beenuar/AiSOC#quickstart' },
+ { label: 'Quickstart', href: docs('quickstart') },
{ label: 'Roadmap', href: 'https://github.com/beenuar/AiSOC/blob/main/ROADMAP.md' },
{ label: 'Changelog', href: 'https://github.com/beenuar/AiSOC/blob/main/CHANGELOG.md' },
],
@@ -32,7 +33,7 @@ const COLUMNS = [
links: [
{ label: 'Issues', href: 'https://github.com/beenuar/AiSOC/issues' },
{ label: 'Discussions', href: 'https://github.com/beenuar/AiSOC/discussions' },
- { label: 'Contributing', href: 'https://github.com/beenuar/AiSOC/blob/main/CONTRIBUTING.md' },
+ { label: 'Contributing', href: docs('contributing/guidelines') },
{ label: 'Code of conduct', href: 'https://github.com/beenuar/AiSOC/blob/main/CODE_OF_CONDUCT.md' },
],
},
diff --git a/apps/web/src/components/landing/OpenSource.tsx b/apps/web/src/components/landing/OpenSource.tsx
index ed3706b60..6b0d8cb5a 100644
--- a/apps/web/src/components/landing/OpenSource.tsx
+++ b/apps/web/src/components/landing/OpenSource.tsx
@@ -2,6 +2,7 @@
import Link from 'next/link';
import { motion } from 'framer-motion';
+import { docs } from '@/lib/docs';
const PILLARS = [
{
@@ -63,7 +64,7 @@ export function OpenSource() {
github.com/beenuar/AiSOC
</a>
<a
- href="https://github.com/beenuar/AiSOC#quickstart"
+ href={docs('quickstart')}
target="_blank"
rel="noreferrer"
className="inline-flex items-center gap-2 rounded-lg border border-velvet-content-primary/15 bg-white/[0.04] px-5 py-3 text-sm font-semibold text-gray-200 transition hover:border-velvet-content-primary/30 hover:bg-white/[0.08]"
diff --git a/apps/web/src/components/landing/sections/BenchmarkBand.tsx b/apps/web/src/components/landing/sections/BenchmarkBand.tsx
index 6d737d539..b315f7c87 100644
--- a/apps/web/src/components/landing/sections/BenchmarkBand.tsx
+++ b/apps/web/src/components/landing/sections/BenchmarkBand.tsx
@@ -20,6 +20,7 @@ import Link from 'next/link';
import { motion, useReducedMotion } from 'framer-motion';
import { ArrowRight, ExternalLink, GitCompare } from 'lucide-react';
import { NumberTicker } from '@/components/magicui/NumberTicker';
+import { docs } from '@/lib/docs';
interface Metric {
/**
@@ -135,7 +136,7 @@ export function BenchmarkBand() {
/>
</Link>
<Link
- href="https://github.com/beenuar/AiSOC#readme"
+ href={docs('benchmark')}
className="inline-flex items-center gap-1 text-sm font-medium text-velvet-content-tertiary transition-colors duration-200 hover:text-velvet-content-primary focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-velvet-emerald-mint focus-visible:ring-offset-2 focus-visible:ring-offset-velvet-surface-base"
>
Open the public scoreboard
diff --git a/apps/web/src/components/landing/sections/ConnectorsMarquee.tsx b/apps/web/src/components/landing/sections/ConnectorsMarquee.tsx
index b3e92bd5e..2f2c9b97c 100644
--- a/apps/web/src/components/landing/sections/ConnectorsMarquee.tsx
+++ b/apps/web/src/components/landing/sections/ConnectorsMarquee.tsx
@@ -19,6 +19,7 @@
import Link from 'next/link';
import { ArrowRight } from 'lucide-react';
import { Marquee } from '@/components/magicui/Marquee';
+import { docs } from '@/lib/docs';
import { cn } from '@/lib/utils';
interface ConnectorPill {
@@ -203,7 +204,7 @@ export function ConnectorsMarquee() {
TypeScript, and Go.
</p>
<Link
- href="https://github.com/beenuar/AiSOC#readme"
+ href={docs('contributing/guidelines')}
className="group mt-5 inline-flex items-center gap-1 text-sm font-semibold text-velvet-emerald-mint transition-colors duration-200 hover:text-velvet-emerald-mint focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-velvet-emerald-mint focus-visible:ring-offset-2 focus-visible:ring-offset-velvet-surface-base"
>
Read the connector SDK
diff --git a/apps/web/src/components/landing/sections/DemoEmbed.tsx b/apps/web/src/components/landing/sections/DemoEmbed.tsx
index e5ff4b86f..a464ed96e 100644
--- a/apps/web/src/components/landing/sections/DemoEmbed.tsx
+++ b/apps/web/src/components/landing/sections/DemoEmbed.tsx
@@ -25,6 +25,7 @@ import Link from 'next/link';
import { motion, useReducedMotion } from 'framer-motion';
import { ArrowRight, Clock, Cpu, Database } from 'lucide-react';
import { BorderBeam } from '@/components/magicui/BorderBeam';
+import { docs } from '@/lib/docs';
import { cn } from '@/lib/utils';
interface LedgerStep {
@@ -278,7 +279,7 @@ export function DemoEmbed() {
<div className="mx-auto mt-10 flex max-w-3xl flex-col items-center justify-center gap-3 text-center sm:flex-row sm:gap-5">
<Link
- href="https://github.com/beenuar/AiSOC#5-minute-demo"
+ href={docs('quickstart')}
className="group inline-flex h-11 items-center gap-2 rounded-md bg-velvet-emerald-cta px-6 text-sm font-semibold text-velvet-content-primary shadow-[0_1px_0_rgba(255,255,255,0.18)_inset] transition-shadow duration-200 ease-landing-out-quart motion-safe:hover:shadow-glow-emerald-sm focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-velvet-emerald-mint focus-visible:ring-offset-2 focus-visible:ring-offset-velvet-surface-base"
>
Run this yourself in 5 minutes
@@ -288,7 +289,7 @@ export function DemoEmbed() {
/>
</Link>
<Link
- href="https://github.com/beenuar/AiSOC#readme"
+ href={docs('architecture')}
className="inline-flex items-center gap-1 text-sm font-medium text-velvet-content-tertiary transition-colors duration-200 hover:text-velvet-content-primary focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-velvet-emerald-mint focus-visible:ring-offset-2 focus-visible:ring-offset-velvet-surface-base"
>
Read the architecture
diff --git a/apps/web/src/components/landing/sections/Footer.tsx b/apps/web/src/components/landing/sections/Footer.tsx
index 7835e6f89..9d0de9407 100644
--- a/apps/web/src/components/landing/sections/Footer.tsx
+++ b/apps/web/src/components/landing/sections/Footer.tsx
@@ -15,6 +15,7 @@
import type { ReactElement, SVGProps } from 'react';
import Link from 'next/link';
import { GithubMark } from './icons';
+import { docs } from '@/lib/docs';
interface LinkSpec {
label: string;
@@ -41,8 +42,8 @@ const COLUMNS: ReadonlyArray<LinkColumn> = [
{
heading: 'Resources',
links: [
- { label: 'Docs', href: 'https://github.com/beenuar/AiSOC#readme' },
- { label: 'Architecture', href: 'https://github.com/beenuar/AiSOC#readme' },
+ { label: 'Docs', href: docs('intro') },
+ { label: 'Architecture', href: docs('architecture') },
{ label: 'Benchmark', href: '/benchmark' },
{ label: 'Blog', href: '/blog' },
{ label: 'Changelog', href: '/changelog' },
diff --git a/apps/web/src/components/landing/sections/OpenSourceMoment.tsx b/apps/web/src/components/landing/sections/OpenSourceMoment.tsx
index 38e94b425..947e4c354 100644
--- a/apps/web/src/components/landing/sections/OpenSourceMoment.tsx
+++ b/apps/web/src/components/landing/sections/OpenSourceMoment.tsx
@@ -20,10 +20,11 @@ import Link from 'next/link';
import { motion, useReducedMotion } from 'framer-motion';
import { ArrowRight, GitBranch, Star, Terminal } from 'lucide-react';
import { BorderBeam } from '@/components/magicui/BorderBeam';
+import { docs } from '@/lib/docs';
import { GithubMark } from './icons';
const REPO_URL = 'https://github.com/beenuar/AiSOC';
-const CONTRIBUTING_URL = 'https://github.com/beenuar/AiSOC/blob/main/CONTRIBUTING.md';
+const CONTRIBUTING_URL = docs('contributing/guidelines');
const SNIPPET = `git clone https://github.com/beenuar/AiSOC.git
cd AiSOC
pnpm aisoc:demo`;
diff --git a/apps/web/src/components/landing/sections/Pillars.tsx b/apps/web/src/components/landing/sections/Pillars.tsx
index a9079d52a..fe9c55c0f 100644
--- a/apps/web/src/components/landing/sections/Pillars.tsx
+++ b/apps/web/src/components/landing/sections/Pillars.tsx
@@ -22,6 +22,7 @@ import { motion, useReducedMotion } from 'framer-motion';
import { ArrowRight, GitGraph, ScrollText, Sparkles, Boxes } from 'lucide-react';
import type { ComponentType, SVGProps } from 'react';
import { GlowingEffect } from '@/components/aceternity/GlowingEffect';
+import { docs } from '@/lib/docs';
import { cn } from '@/lib/utils';
interface Pillar {
@@ -55,7 +56,7 @@ const PILLARS: ReadonlyArray<Pillar> = [
'The entity graph is written while events are normalised, not when an analyst clicks "show graph." Schema v1.0 is published.',
stat: '17 + 14',
statLabel: 'node labels · relationships',
- href: 'https://github.com/beenuar/AiSOC#readme',
+ href: docs('architecture/graph-schema'),
linkLabel: 'Read the graph schema',
},
{
@@ -66,7 +67,7 @@ const PILLARS: ReadonlyArray<Pillar> = [
'Four named agents. Every prompt, tool call, and decision is logged, the LLM-input contract fails closed on malformed prompts, and a CI-gated CVE audit blocks every merge.',
stat: '4 / 100%',
statLabel: 'agents · audited',
- href: 'https://github.com/beenuar/AiSOC#readme',
+ href: docs('architecture/agents'),
linkLabel: 'Read the agent contract',
},
{
@@ -77,7 +78,7 @@ const PILLARS: ReadonlyArray<Pillar> = [
'Render, Fly.io, Kubernetes, AWS, your air-gapped rack — same code path. BYOK LLM credentials in the encrypted vault.',
stat: '6 + 1',
statLabel: 'deploy targets · air-gap overlay',
- href: 'https://github.com/beenuar/AiSOC#readme',
+ href: docs('deployment/docker'),
linkLabel: 'Read the deployment guide',
},
];
diff --git a/apps/web/src/components/landing/sections/StickyNav.tsx b/apps/web/src/components/landing/sections/StickyNav.tsx
index de19bd478..8276f5d93 100644
--- a/apps/web/src/components/landing/sections/StickyNav.tsx
+++ b/apps/web/src/components/landing/sections/StickyNav.tsx
@@ -19,6 +19,7 @@ import Link from 'next/link';
import { useEffect, useState } from 'react';
import { ArrowRight, Menu, X } from 'lucide-react';
import { GithubMark } from './icons';
+import { docs } from '@/lib/docs';
import { cn } from '@/lib/utils';
const NAV_LINKS: ReadonlyArray<{ label: string; href: string }> = [
@@ -27,7 +28,7 @@ const NAV_LINKS: ReadonlyArray<{ label: string; href: string }> = [
{ label: 'Connectors', href: '#connectors' },
{ label: 'Benchmark', href: '#benchmark' },
{ label: 'Pricing', href: '#pricing' },
- { label: 'Docs', href: 'https://github.com/beenuar/AiSOC#readme' },
+ { label: 'Docs', href: docs('intro') },
];
export function StickyNav() {
diff --git a/apps/web/src/lib/docs.ts b/apps/web/src/lib/docs.ts
new file mode 100644
index 000000000..1e84142df
--- /dev/null
+++ b/apps/web/src/lib/docs.ts
@@ -0,0 +1,5 @@
+export const DOCS_BASE =
+ process.env.NEXT_PUBLIC_DOCS_URL ?? "https://beenuar.github.io/AiSOC/docs";
+
+export const docs = (path: string) =>
+ `${DOCS_BASE}/${path.replace(/^\//, "")}`;