Add Victorious hackathon submission

submissions/Victorious/.env.example

@@ -0,0 +1,53 @@
+# Project Victorious — environment template.
+#
+# Copy to `.env` and fill in. `.env` is gitignored and must never be committed.
+# Settings are typed in apps/api/app/core/config.py; nesting uses `__`.
+
+# --- Core --------------------------------------------------------------------
+VICTORIOUS_ENVIRONMENT=local
+
+# --- Reasoning providers ------------------------------------------------------
+# anthropic (default) | gemini | fixture
+#
+# `fixture` replays recorded responses from disk: no network, no API spend. It is
+# how the test suite runs and how the demo is insulated from provider outages.
+VICTORIOUS_LLM__PROVIDER=anthropic
+
+# Required when the provider is `anthropic`.
+ANTHROPIC_API_KEY=
+
+# Required when the provider is `gemini`.
+GOOGLE_API_KEY=
+
+# Wrap the live provider in a recorder, writing every response to the fixture
+# directory. Run once with a real provider and a real project to produce the
+# offline demo corpus, then switch VICTORIOUS_LLM__PROVIDER back to `fixture`.
+VICTORIOUS_LLM__RECORD_FIXTURES=false
+
+# Where recorded responses are read from and written to.
+VICTORIOUS_LLM__FIXTURE_DIR=./fixtures
+
+# If a live provider cannot be built (usually a missing key above), the platform
+# falls back to recorded fixtures rather than refusing to start. It reports
+# `degraded` on /health/ready and names the real backend on every agent run.
+# See docs/adr/0008-fixture-provider-and-fallback.md.
+
+# --- Persistence --------------------------------------------------------------
+# SQLite by default so a native checkout needs no services. docker-compose
+# overrides this with PostgreSQL.
+# VICTORIOUS_DATABASE__URL=postgresql+asyncpg://victorious:victorious@localhost:5432/victorious
+
+# --- Semantic memory ----------------------------------------------------------
+# Embedded ChromaDB, off until the knowledge base needs it (Milestone 5+).
+VICTORIOUS_VECTOR_STORE__ENABLED=false
+
+# --- Observability ------------------------------------------------------------
+VICTORIOUS_OBSERVABILITY__LOG_LEVEL=INFO
+# Set false locally for readable console output instead of JSON.
+VICTORIOUS_OBSERVABILITY__JSON_LOGS=true
+
+# --- Web ----------------------------------------------------------------------
+# Used by the browser. Baked in at build time for container images.
+NEXT_PUBLIC_API_URL=http://localhost:8000
+# Used by server components inside compose.
+# API_INTERNAL_URL=http://api:8000

submissions/Victorious/.gitignore

@@ -0,0 +1,177 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.*
+!.env.example
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+.output
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp directory
+.temp
+
+# Sveltekit cache directory
+.svelte-kit/
+
+# vitepress build output
+**/.vitepress/dist
+
+# vitepress cache directory
+**/.vitepress/cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# Firebase cache directory
+.firebase/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# pnpm
+.pnpm-store
+
+# yarn v3
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+# Vite files
+vite.config.js.timestamp-*
+vite.config.ts.timestamp-*
+.vite/
+
+# Claude Code local settings (per-machine, not shared)
+.claude/settings.local.json
+
+# --- Mutagent / Helix installation --------------------------------------------
+# Developer-local tooling, installed with the Mutagent CLI. Deliberately not
+# committed: it is third-party (two skills are licensed Proprietary, and this
+# repository is MIT), it vendors ~23MB of node_modules, and nothing Victorious
+# runs depends on it — Helix is a development-time ADL conductor, never part of
+# the runtime execution path (`docs/07_System_Architecture.md`, ADR-0013).
+#
+# To restore it:  npx mutagent install helix
+.claude/agents/
+.claude/skills/
+.agents/
+.codex/
+
+# Points at a specific Mutagent workspace and organization — per-developer.
+.mutagentrc.json
+
+# --- Python (apps/api) --------------------------------------------------------
+.venv/
+venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Local databases and embedded vector store
+*.db
+*.sqlite3
+.chroma/

submissions/Victorious/AGENTS.md

@@ -0,0 +1,26 @@
+<!-- @mutagent/helix boot -->
+# Helix — MutagenT ADL conductor
+
+This project has the Helix orchestrator installed. To boot it, read and adopt the agent
+definition at `.agents/skills/mutagent-helix/orchestrator.md` (run its activation-instructions: persona → system index →
+ADL dashboard), then await a `*command`.
+
+Trigger: `*mutagent` · `/mutagent-helix` · `boot`.
+
+DASHBOARD RENDERING — HARD RULE (Codex): on `*mutagent`/`boot`/`*help`/`*status`, output the
+orchestrator's `help-display-template` VERBATIM inside a fenced `text` code block. Preserve its
+EXACT shape — the boxed MUTAGENT header (box-drawing chars), every panel (lifecycle · system index ·
+setup/onboarding · state), and the command roster. Replace ONLY the `{placeholder}` tokens with
+live values; change NOTHING else. Do NOT summarize, shorten, paraphrase, drop panels, or convert it
+to Markdown headings/tables/bullets unless the operator explicitly asks for a condensed view.
+<!-- @mutagent/helix boot -->
+
+<!-- Project Victorious note — outside the @mutagent/helix boot markers above. -->
+
+The Helix installation itself is **not committed** (`.gitignore`): it is
+third-party, partly proprietary, and vendors ~23MB of `node_modules`. Restore it
+with `npx mutagent install helix`.
+
+Helix is development-time tooling only. It is never called at runtime — see
+[ADR-0013](docs/adr/0013-engineering-review-layer.md) and
+[`docs/07_System_Architecture.md`](docs/07_System_Architecture.md).

submissions/Victorious/CLAUDE.md

@@ -0,0 +1,19 @@
+<!-- @mutagent/helix boot -->
+# Helix — MutagenT ADL conductor
+
+This project has the Helix orchestrator installed. To boot it, read and adopt the agent
+definition at `.claude/skills/mutagent-helix/orchestrator.md` (run its activation-instructions: persona → system index →
+ADL dashboard), then await a `*command`.
+
+Trigger: `*mutagent` · `/mutagent-helix` · `boot`.
+<!-- @mutagent/helix boot -->
+
+<!-- Project Victorious note — outside the @mutagent/helix boot markers above. -->
+
+The Helix installation itself is **not committed** (`.gitignore`): it is
+third-party, partly proprietary, and vendors ~23MB of `node_modules`. Restore it
+with `npx mutagent install helix`.
+
+Helix is development-time tooling only. It is never called at runtime — see
+[ADR-0013](docs/adr/0013-engineering-review-layer.md) and
+[`docs/07_System_Architecture.md`](docs/07_System_Architecture.md).