<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Anavay Sharma</title>
    <description>The latest articles on DEV Community by Anavay Sharma (@supersaiyan101).</description>
    <link>https://dev.to/supersaiyan101</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F4205960%2Fd07ccb81-3c12-40a8-8439-170892184961.jpg</url>
      <title>DEV Community: Anavay Sharma</title>
      <link>https://dev.to/supersaiyan101</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/supersaiyan101"/>
    <language>en</language>
    <item>
      <title>I let L from Death Note grill my software experience while optical sensors monitored my blood flow</title>
      <dc:creator>Anavay Sharma</dc:creator>
      <pubDate>Sat, 14 Nov 2026 18:59:48 +0000</pubDate>
      <link>https://dev.to/supersaiyan101/i-let-l-from-death-note-grill-my-software-experience-while-optical-sensors-monitored-my-blood-flow-509p</link>
      <guid>https://dev.to/supersaiyan101/i-let-l-from-death-note-grill-my-software-experience-while-optical-sensors-monitored-my-blood-flow-509p</guid>
      <description>&lt;p&gt;&lt;em&gt;This is a submission for the &lt;a href="https://dev.to/challenges/presage-2026-11-04"&gt;Presage SmartSpectra SDK Challenge&lt;/a&gt;&lt;/em&gt;&lt;/p&gt;

&lt;h2&gt;
  
  
  What I Built
&lt;/h2&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;"I am L. Candidate kun... you claim on your resume that you architected distributed clusters handling fifty million requests per second. Yet the exact millisecond I asked you about cache invalidation, your optical pulse surged by nineteen beats per minute and your micro vascular blood volume doubled. Tell me... why are your capillaries confessing before you even open your mouth?"&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;Technical interviews in 2026 are completely broken. &lt;/p&gt;

&lt;p&gt;Candidate resumes are stuffed with artificial intelligence buzzwords, exaggerated claims of scaling global cloud infrastructure, and rehearsed algorithm solutions memorized the night before. Standard whiteboard interviews can no longer distinguish genuine architectural masters from confident prompt engineers.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;RejectNote&lt;/strong&gt; is a satirical technical interview roasting chamber powered by optical contactless photoplethysmography polygraph surveillance. Instead of a polite human resources screen, iconic anime personalities interrogate your resume claims in real time.&lt;/p&gt;

&lt;p&gt;Currently in Season 1, the master detective &lt;strong&gt;L Lawliet&lt;/strong&gt; from &lt;em&gt;Death Note&lt;/em&gt; sits across the table as your chief inquisitor. As you attempt to defend your architectural decisions, the Presage SmartSpectra SDK silently turns your standard camera feed into an optical polygraph. It monitors involuntary sub surface facial blood flow, cardiac pulse surges, respiration shifts, and physiological stress arousal directly through ambient light reflected off your skin.&lt;/p&gt;

&lt;p&gt;When your heart rate accelerates or breathing tightens during a tough technical question, L immediately pounces on the biological tell, calls out your bluff with authentic voice audio, triggers dramatic anime visual reactions, and logs an indelible entry into the Rejection Note.&lt;/p&gt;

&lt;h3&gt;
  
  
  Watching Your Bluffs Unravel
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;👁️ &lt;strong&gt;Optical rPPG Capillary Scan&lt;/strong&gt;: Analyzes sub surface light absorption in facial micro vessels via the webcam using the Presage SmartSpectra SDK. No wearables or external hardware touched.&lt;/li&gt;
&lt;li&gt;💓 &lt;strong&gt;Cardiac Surge Polygraph&lt;/strong&gt;: Calculates resting pulse baseline in the first 15 seconds. If a candidate bluffs and pulse spikes by over 15 BPM, L immediately pounces.&lt;/li&gt;
&lt;li&gt;🫁 &lt;strong&gt;Respiration Hyperventilation Monitor&lt;/strong&gt;: Tracks chest and diaphragm breathing cycles. When technical panic sets in, rapid breathing trips the suspicion gauge.&lt;/li&gt;
&lt;li&gt;⚡ &lt;strong&gt;Scouter Ki Level and Power Surge&lt;/strong&gt;: Smoothly calculates resume credibility while Goku goes Super Saiyan, scaling scouter power readings from 1,050 to over 9,000 with ki aura visuals.&lt;/li&gt;
&lt;li&gt;📜 &lt;strong&gt;The Rejection Note Autopsy&lt;/strong&gt;: Generates an indelible cryptographic report card documenting every physiological spike, timestamped lie, and final verdict.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Demo
&lt;/h2&gt;

&lt;p&gt;  &lt;iframe src="https://www.youtube.com/embed/7mf08mP4sQg" width="710" height="399"&gt;
  &lt;/iframe&gt;
&lt;/p&gt;

&lt;p&gt;Direct link: &lt;a href="https://youtu.be/7mf08mP4sQg" rel="noopener noreferrer"&gt;https://youtu.be/7mf08mP4sQg&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Video Highlights:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;0:00 Candidate profile intake and resume parsing&lt;/li&gt;
&lt;li&gt;0:25 Optical camera calibration and baseline signal lock&lt;/li&gt;
&lt;li&gt;0:50 Interrogation by L with live biometric polygraph telemetry&lt;/li&gt;
&lt;li&gt;1:35 Stress surges trigger dynamic anime roasting and tactical interrogation&lt;/li&gt;
&lt;li&gt;2:20 Cryptographic Rejection Note and final verdict&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Code
&lt;/h2&gt;

&lt;p&gt;The complete source code is public on GitHub:&lt;br&gt;
&lt;a href="https://github.com/Supersaiyan101/Reject_Note" rel="noopener noreferrer"&gt;https://github.com/Supersaiyan101/Reject_Note&lt;/a&gt;&lt;/p&gt;

&lt;h3&gt;
  
  
  Quick Setup Instructions
&lt;/h3&gt;

&lt;ol&gt;
&lt;li&gt;Clone the repository:
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git clone https://github.com/Supersaiyan101/Reject_Note.git
&lt;span class="nb"&gt;cd&lt;/span&gt; Reject_Note
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;Install dependencies:
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm install
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;Configure environment keys:
Create a &lt;code&gt;.env&lt;/code&gt; file in the project root:
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;VITE_PRESAGE_API_KEY=your_presage_api_key_here
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;Launch the local development server:
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm run dev
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Visit &lt;code&gt;http://localhost:5173&lt;/code&gt; in any modern Chromium browser with webcam access.&lt;/p&gt;

&lt;h2&gt;
  
  
  How It Responds to Human Signals
&lt;/h2&gt;

&lt;p&gt;RejectNote integrates the &lt;strong&gt;Presage SmartSpectra SDK&lt;/strong&gt; to extract rich physiological signals directly from ambient light reflections on the candidate facial skin:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Optical Signal Extraction&lt;/strong&gt;: &lt;br&gt;
The application captures high frequency video frames client side. SmartSpectra analyzes subtle color variations in red, green, and blue spectrums caused by pulsatile blood volume changes in the micro vascular bed.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Physiological Baseline Calibration&lt;/strong&gt;:&lt;br&gt;
During the intake stage, the system conducts a fifteen second resting baseline capture. It computes baseline resting pulse rate (BPM), breathing rate (RPM), and sympathetic tone index.&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Dynamic Stress Response Engine&lt;/strong&gt;:&lt;br&gt;
As L presents challenging questions about concurrency, caching, and database transactions, the app continuously compares incoming telemetry against the baseline:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Calm State (Delta under 8 BPM)&lt;/strong&gt;: L remains analytical and observant.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Agitated State (Delta between 8 and 15 BPM)&lt;/strong&gt;: L raises his thumb to his lip, warning the candidate that micro tremors suggest deception.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Caught Red Handed (Delta over 15 BPM or respiration surge over 30 percent)&lt;/strong&gt;: L slams the desk, red alert flashing fills the screen, custom voice audio fires, and the interrogation suspicion gauge maxes out.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;&lt;p&gt;&lt;strong&gt;Multi Modal Audio and Visual Feedback&lt;/strong&gt;:&lt;br&gt;
Biometric spikes directly manipulate the visual novel engine. L shifts between calm, suspicious, and aggressive postures, accompanied by dramatic anime sound effects, heart beat audio, and spoken deductions via the Web Speech API.&lt;/p&gt;&lt;/li&gt;
&lt;/ol&gt;

&lt;h3&gt;
  
  
  Live Biometric Interrogation Log
&lt;/h3&gt;

&lt;p&gt;Here is the exact biometric telemetry recorded during our live interrogation run:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Phase 1: Distributed Redis Caching&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Candidate Claim: "Maintained 99.999% SLA across 4 cloud regions"&lt;/li&gt;
&lt;li&gt;Biometric Telemetry: 68 BPM surging to 89 BPM (+21 BPM delta surge)&lt;/li&gt;
&lt;li&gt;L Deduction: "Your pulse surged under 64 cameras. A classic sympathetic tell."&lt;/li&gt;
&lt;li&gt;Verdict: 🚨 Caught Red Handed&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Phase 2: Kafka Event Streaming&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Candidate Claim: "Zero message loss during network partition"&lt;/li&gt;
&lt;li&gt;Biometric Telemetry: 14 RPM surging to 27 RPM (+92% breathing acceleration)&lt;/li&gt;
&lt;li&gt;L Deduction: "Hyperventilation detected. You did not configure failover, did you?"&lt;/li&gt;
&lt;li&gt;Verdict: 🚨 Bluff Exposed&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;Phase 3: PostgreSQL Isolation Levels&lt;/strong&gt;&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Candidate Claim: "Explained serializable snapshot isolation calmly"&lt;/li&gt;
&lt;li&gt;Biometric Telemetry: 70 BPM to 71 BPM (Stable resting baseline)&lt;/li&gt;
&lt;li&gt;L Deduction: "Fascinating. Your capillaries remained steady. Suspicion reduced to 5%."&lt;/li&gt;
&lt;li&gt;Verdict: ✅ Plausible Truth&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Keeping It Honest
&lt;/h3&gt;

&lt;p&gt;This was vital during development:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Authentic Presage Optical Telemetry&lt;/strong&gt;: The biometric signals are not pre scripted mock data. The webcam stream is fed directly into the Presage SmartSpectra SDK, extracting live physiological signals client side in real time.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Deterministic Reaction Thresholds&lt;/strong&gt;: L does not insult you randomly. Every audio cue, anime visual reaction, and screen shake is mathematically triggered by deltas exceeding your calibrated resting baseline.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Zero Cloud Video Surveillance&lt;/strong&gt;: All video processing occurs entirely in browser memory. No camera frames ever leave your personal computer.&lt;/li&gt;
&lt;/ul&gt;

&lt;h2&gt;
  
  
  Prize Categories
&lt;/h2&gt;

&lt;h3&gt;
  
  
  Most Creative or Delightful Use
&lt;/h3&gt;

&lt;p&gt;RejectNote transforms a universally dreaded rite of passage (the intimidating technical interview) into a hilarious, gamified, and unforgettable interactive anime showdown. &lt;/p&gt;

&lt;p&gt;Instead of treating biometric telemetry as a dry clinical readout, RejectNote repurposes the cutting edge contactless sensing of the Presage SmartSpectra SDK into an anime polygraph. Pairing L Lawliet's legendary analytical interrogation style with real sub surface blood flow detection creates an unexpected, playful, and delightfully tense experience where you cannot hide behind rehearsed answers because your capillaries will betray you.&lt;/p&gt;

&lt;h3&gt;
  
  
  The Spirit of It
&lt;/h3&gt;

&lt;p&gt;The moment this project truly landed for me was during my first late night test run. I wrote the interrogation questions myself and knew exactly what L was going to say. &lt;/p&gt;

&lt;p&gt;Yet the second L crouched forward, locked eyes with me, and asked how I handled production Redis failovers while my webcam feed zoomed in, my pulse spontaneously jumped by nineteen beats per minute on screen. My palms actually sweated. That was the moment I realized: you can rehearse prompt engineering, and you can memorize LeetCode solutions, but your own capillaries will never lie for you.&lt;/p&gt;

&lt;h2&gt;
  
  
  Agent Session
&lt;/h2&gt;

&lt;p&gt;I built and architected RejectNote as a solo developer collaborating with an AI coding agent. &lt;/p&gt;

&lt;p&gt;The creative vision, psychological anime interrogation concept, and software architecture were entirely mine. I used the AI assistant as a tireless pair programmer to help scaffold the React and TypeScript front end, write Web Audio synthesis algorithms, fine tune Tailwind styling, and integrate the Presage SmartSpectra SDK client library. Every interrogation branch, anime voice cue, biometric threshold, and test run was directed, inspected, and verified by me.&lt;/p&gt;

&lt;h2&gt;
  
  
  Consent and Data Handling
&lt;/h2&gt;

&lt;p&gt;User privacy, security, and consent are built into every layer of RejectNote:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Explicit Camera Consent&lt;/strong&gt;: Camera access is requested strictly through browser permission dialogs with prominent visual indicators.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Pure Client Side Processing&lt;/strong&gt;: Video frames are analyzed entirely in browser memory. Video feeds are never recorded, never written to disk, and never transmitted to external cloud servers.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Ephemeral Biometrics&lt;/strong&gt;: Extracted physiological metrics (pulse and respiration) exist exclusively within local React application state for the duration of the interrogation session and are discarded on page refresh.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Zero Persistent Facial Identification&lt;/strong&gt;: RejectNote does not perform facial recognition, facial template storage, or identity tracking.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Non Medical Entertainment Disclaimer&lt;/strong&gt;: RejectNote is designed strictly for entertainment and educational purposes. It does not provide medical diagnoses, clinical evaluations, or physiological treatment advice.&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>devchallenge</category>
      <category>presagechallenge</category>
      <category>ai</category>
      <category>webdev</category>
    </item>
    <item>
      <title>Smriti: When someone you love passes away, their words scatter. Gemma and local speech gathered them into an open-source altar.</title>
      <dc:creator>Anavay Sharma</dc:creator>
      <pubDate>Thu, 29 Oct 2026 18:49:39 +0000</pubDate>
      <link>https://dev.to/supersaiyan101/smriti-when-someone-you-love-passes-away-their-words-scatter-gemma-and-local-speech-gathered-29dl</link>
      <guid>https://dev.to/supersaiyan101/smriti-when-someone-you-love-passes-away-their-words-scatter-gemma-and-local-speech-gathered-29dl</guid>
      <description>&lt;h1&gt;
  
  
  Smriti (स्मृति)
&lt;/h1&gt;

&lt;h3&gt;
  
  
  &lt;em&gt;"A place for those who live on in you."&lt;/em&gt;
&lt;/h3&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;Hacktoberfest 2026 — Week 4: Ghost in the Machine&lt;/strong&gt;&lt;br&gt;&lt;br&gt;
&lt;strong&gt;Repository:&lt;/strong&gt; &lt;a href="https://github.com/Supersaiyan101/smriti" rel="noopener noreferrer"&gt;github.com/Supersaiyan101/smriti&lt;/a&gt;&lt;br&gt;&lt;br&gt;
&lt;strong&gt;Production Sanctuary:&lt;/strong&gt; &lt;a href="https://smriti-sanctuary.onrender.com" rel="noopener noreferrer"&gt;https://smriti-sanctuary.onrender.com&lt;/a&gt;&lt;br&gt;&lt;br&gt;
&lt;strong&gt;Video Demonstration:&lt;/strong&gt; &lt;a href="https://youtu.be/2EsRZSqnxPs" rel="noopener noreferrer"&gt;https://youtu.be/2EsRZSqnxPs&lt;/a&gt;&lt;br&gt;&lt;br&gt;
&lt;strong&gt;License:&lt;/strong&gt; MIT (Free &amp;amp; Open Source forever)&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;  &lt;iframe src="https://www.youtube.com/embed/2EsRZSqnxPs" width="710" height="399"&gt;
  &lt;/iframe&gt;
&lt;/p&gt;




&lt;h2&gt;
  
  
  1. The Story: Why I Built Smriti
&lt;/h2&gt;

&lt;p&gt;When someone we love dies, what remains of them is scattered across the digital wind.&lt;/p&gt;

&lt;p&gt;A 7-second voice note on WhatsApp where they were laughing in traffic. A recipe scribbled on the back of an envelope. A piece of advice they gave you on a terrace at 2:00 AM when your life was falling apart.&lt;/p&gt;

&lt;p&gt;In recent years, commercial AI companies have begun packaging grief. They ask you to upload intimate photographs, personal diaries, and audio recordings of your deceased loved ones to private corporate servers. In return, they offer "digital resurrections"—creepy, ungrounded conversational chatbots that invent conversations your loved one never had, turn grief into a monthly subscription tier, and train corporate frontier models on your tears. When the startup runs out of venture funding, your grandmother’s digital presence simply goes 404.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Smriti refuses that reality.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;In ancient Sanskrit, &lt;strong&gt;Smriti&lt;/strong&gt; (स्मृति) means &lt;em&gt;Remembrance&lt;/em&gt;—that which is preserved in living memory. But the practice of remembering is universal across all human geography. Whether it is lighting a vigil candle in a quiet European chapel, setting a paper lantern adrift on water in Japan, or gathering around a family table, humans have always remembered the departed with a &lt;strong&gt;gentle light in the dark&lt;/strong&gt;.&lt;/p&gt;

&lt;p&gt;I built Smriti as an open-source, privacy-first sanctuary. It does not pretend the dead are still alive. It does not hallucinate false memories. Instead, it gathers scattered fragments of words, voice, and wisdom, preserves them with cryptographic cloud custody, and lets you sit quietly beside their flame.&lt;/p&gt;




&lt;h2&gt;
  
  
  2. What Smriti Actually Does: The Core Experience &amp;amp; The Memory Reel
&lt;/h2&gt;

&lt;p&gt;Smriti is intentionally designed with one defining aesthetic: &lt;strong&gt;Quiet&lt;/strong&gt;. There are no notification badges, no social feeds, and no login walls.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;       ┌────────────────────────────────────────────────────────┐
       │                       THE SANCTUARY                    │
       │                                                        │
       │               🕯️  [ Living Candle Flame ]               │
       │                                                        │
       │         [ Arjun Mehta ]            [ Rekha Sharma ]    │
       │        "Best friend, college"       "Grandmother"      │
       │               🕯️                         🕯️           │
       │                                                        │
       │          🎞️ [ THE MEMORY REEL • SPOTIFY SOUNDTRACK ]    │
       └────────────────────────────────────────────────────────┘
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  🎞️ The Flagship Centerpiece: The Memory Reel
&lt;/h3&gt;

&lt;p&gt;The defining feature of Smriti. It weaves photographs and heartfelt stories into a cinematic slideshow set to music, kept permanently on their altar:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Layout A (Cinematic Split):&lt;/strong&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Left Half:&lt;/strong&gt; High-resolution portrait framed in an archival brass &amp;amp; dark wood bezel with subtle Ken Burns drift (&lt;code&gt;1.0&lt;/code&gt; to &lt;code&gt;1.04&lt;/code&gt; zoom over 11s), realistic glass reflections, and a corner living flame. Adaptive contain framing guarantees &lt;strong&gt;zero image clipping&lt;/strong&gt; on vertical smartphone photos, square shots, or landscape portraits.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Right Half:&lt;/strong&gt; Spacetime pinning badge (&lt;code&gt;🗓️ [When] • 📍 [Where]&lt;/code&gt;), moment title, and the quiet written narrative in large, elegant &lt;em&gt;Cormorant Garamond&lt;/em&gt; serif prose.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Spotify Wrapped-Style Story Bars:&lt;/strong&gt; Segmented top progress bars (&lt;code&gt;▬▬ ▬▬ ▬▬&lt;/code&gt;), auto-advancing every 11 seconds, clickable to jump, keyboard controls (&lt;code&gt;←&lt;/code&gt;/&lt;code&gt;→&lt;/code&gt;/&lt;code&gt;Esc&lt;/code&gt;/&lt;code&gt;Space&lt;/code&gt;), and pause-on-hover.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Sanctuary Soundtrack Engine:&lt;/strong&gt; Custom MP3 audio upload ("Their Song"), direct Spotify web streaming embeds, or procedural sanctuary acoustic melodies (&lt;em&gt;Peaceful Piano Dusk&lt;/em&gt;, &lt;em&gt;Twilight Sarod&lt;/em&gt;, &lt;em&gt;Warm Acoustic Strings&lt;/em&gt;, &lt;em&gt;Rain &amp;amp; Wind Chimes&lt;/em&gt;), with spinning vinyl badge and mute control.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Read-Only Reverence:&lt;/strong&gt; Strictly human heartfelt stories with zero robotic TTS narration over the slideshow.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Feature 1 — The Sanctuary (Living Hearth)
&lt;/h3&gt;

&lt;p&gt;The home screen is a quiet room at dusk. Each remembered person appears as a softly framed portrait resting beside a living, flickering candle flame. The shelf features 3 clean sample profiles:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Arjun Mehta:&lt;/strong&gt; College best friend (&lt;em&gt;Monsoon chai, Solan road trip, graduation smile&lt;/em&gt;), paired with &lt;em&gt;Peaceful Piano Dusk&lt;/em&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Rekha Sharma:&lt;/strong&gt; Beloved grandmother (&lt;em&gt;Balcony Tagore readings, brass hearth sandesh, silver coin blessing&lt;/em&gt;), paired with &lt;em&gt;Twilight Sarod&lt;/em&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;David Miller:&lt;/strong&gt; High school debate mentor (&lt;em&gt;The unsharpened pencil, library rebuttal prep, brass championship trophy&lt;/em&gt;), paired with &lt;em&gt;Warm Acoustic Strings&lt;/em&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Feature 2 — The Offering (Reel-First Creator &amp;amp; Ceremony)
&lt;/h3&gt;

&lt;p&gt;Transforming the act of memorial creation into weaving a living Memory Reel from moment one:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Who Are We Honoring:&lt;/strong&gt; Name, relationship, and circular altar portrait upload with live preview.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Dynamic Moments Filmstrip:&lt;/strong&gt; Add unlimited photos and videos (up to 50MB) with heartfelt stories written in &lt;em&gt;Cormorant Garamond&lt;/em&gt;, moment titles, and spacetime pinning (&lt;code&gt;When was this?&lt;/code&gt;, &lt;code&gt;Where were you?&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Triple-Dock Soundtrack:&lt;/strong&gt; Choose between curated acoustic sanctuary presets (&lt;em&gt;Piano Dusk&lt;/em&gt;, &lt;em&gt;Classical Sarod&lt;/em&gt;, &lt;em&gt;Temple Dawn&lt;/em&gt;), offline MP3 audio upload, or direct Spotify song links.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Sacred Hold-to-Light Flame Ceremony:&lt;/strong&gt; Holding to light the ceremonial flame creates their profile, weaves all moment slides and soundtracks into their reel, and seamlessly launches the Memory Reel slideshow finale upon their newly lit altar.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Quiet Local Draft Auto-Save:&lt;/strong&gt; Automatically preserves in-progress moments and stories in local storage so not a single memory is lost.&lt;/li&gt;
&lt;/ol&gt;

&lt;h4&gt;
  
  
  💡 The Sparse Memory Dilemma: "What if I only have one memory?"
&lt;/h4&gt;

&lt;p&gt;One of the most tender realities of grief is that we often have very little preserved data. For a childhood friend who passed young, you might only have &lt;strong&gt;one sentence&lt;/strong&gt; they always said.&lt;/p&gt;

&lt;p&gt;Smriti never shames the user with &lt;em&gt;"Profile 10% complete—add more data."&lt;/em&gt; &lt;strong&gt;A single memory is already whole.&lt;/strong&gt; Smriti introduces two dedicated solutions:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Gentle Whispers:&lt;/strong&gt; Soft 1-tap prompts (&lt;em&gt;"A Catchphrase"&lt;/em&gt;, &lt;em&gt;"A Small Joy"&lt;/em&gt;, &lt;em&gt;"Life Advice"&lt;/em&gt;, &lt;em&gt;"A Scent or Song"&lt;/em&gt;) that offer tender starting words if grief leaves you feeling blank.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Reflection Mode:&lt;/strong&gt; When someone has only 1–3 memories, Gemma does &lt;strong&gt;not&lt;/strong&gt; attempt a fake conversational Q&amp;amp;A. Instead, it acts as a peaceful keeper of the flame, reflecting their actual preserved words and advice back to the user like a warm comforting presence.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Feature 3 — The Remembrance (Slow Ink &amp;amp; Citation Unfolding)
&lt;/h3&gt;

&lt;p&gt;Clicking a portrait brings full focus to their hearth:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Gemma Grounded Reflection:&lt;/strong&gt; Strictly grounded in uploaded fragments with zero hallucinations.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Slow Ink Emergence:&lt;/strong&gt; Gentle, typewriter-paced writing reveal with a glowing ink quill cursor.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Citation Artifact Unfolding:&lt;/strong&gt; Clicking any bracketed citation (&lt;code&gt;[Chai stall memory, 2018]&lt;/code&gt;) unfolds the original preserved artifact modal with its exact spacetime coordinates and sensory anchors.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Feature 4 — The Vigil ("Sit with Them")
&lt;/h3&gt;

&lt;p&gt;A dedicated meditation sanctuary for wordless presence with an expanding 4-7-8 mindful breathing ring and a tap-to-tend 432Hz bronze chime.&lt;/p&gt;

&lt;h3&gt;
  
  
  Feature 5 — Studio AI Audio Narration (ElevenLabs + Natural Fallback)
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;ElevenLabs Studio Streaming:&lt;/strong&gt; Powered by ElevenLabs' &lt;strong&gt;George&lt;/strong&gt; (&lt;em&gt;Warm, Captivating Storyteller&lt;/em&gt;) model (&lt;code&gt;JBFqnCBsd6RMkjVDRZzb&lt;/code&gt;) streaming live &lt;code&gt;audio/mpeg&lt;/code&gt; speech.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Poetic Text Preprocessing:&lt;/strong&gt; Automatically strips prompt echoes, citation brackets, and harsh quotes before synthesis, ensuring natural human storytelling.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Analog Warmth Filter:&lt;/strong&gt; Routes speech through a Web Audio &lt;code&gt;BiquadFilterNode&lt;/code&gt; lowpass filter (6800Hz) and vocal warmth boost (2400Hz), softening digital sibilance into vintage vinyl warmth.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Studio Audio Ducking:&lt;/strong&gt; Automatically ducks ambient background soundscapes by 65% whenever spoken reflections play, gently swelling back up when finished.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Natural Neural Browser Fallback:&lt;/strong&gt; If an ElevenLabs key is not present, auto-selects modern Microsoft Online Natural (&lt;em&gt;Jenny / Aria&lt;/em&gt;) and Google Neural voices with sentence-by-sentence 320ms human breath pauses, skipping robotic 2000s desktop voices.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Feature 6 — The Keepsake Letter (Story-Extracted Heirloom Export)
&lt;/h3&gt;

&lt;p&gt;One tap on &lt;em&gt;"📜 Keepsake Letter"&lt;/em&gt; generates a printable, framed heirloom document:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Story-Extracted Wisdom:&lt;/strong&gt; Directly pulls preserved quotes, moments, and spacetime coordinates from their Memory Reel photo stories into Gemma's synthesis.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Archival Deckled Parchment:&lt;/strong&gt; Renders with authentic torn paper edges, fold crease lines, moment thumbnails, and a dimensional crimson/gold Sanskrit wax seal stamp (&lt;code&gt;स्मृ&lt;/code&gt;).&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;High-Resolution Print Layout:&lt;/strong&gt; Custom &lt;code&gt;@media print&lt;/code&gt; styling removes dark backgrounds and prepares crisp typography for physical framing.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  3. System Architecture &amp;amp; Data Flow
&lt;/h2&gt;

&lt;p&gt;Smriti is built as an open-source monorepo combining a modern React + Vite frontend with an Express agent backend orchestrated by &lt;strong&gt;Mastra&lt;/strong&gt; and observed by &lt;strong&gt;Sentry&lt;/strong&gt;.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;  USER INPUT (Browser)
  ├─ Audio (MediaRecorder WebM)
  ├─ Text / Quote / Advice
  └─ Photo / Scanned Letter
         │
         ▼
  [ MongoDB Atlas Cloud Cluster ]
  ├─ profiles collection (metadata, relations, soundtracks)
  ├─ memories collection (chunks + Atlas Vector Search Index)
  └─ lettersToThem collection (sealed heirloom envelopes)
         │
  USER ASKS: "What did they tell me about patience?"
         │
         ▼
  [ Mastra Agent Workflow ] (server/mastra/agent.js)
  ┌────────────────────────────────────────────────────────┐
  │ 1. Tool: retrieveMemoriesTool (Atlas Vector Search)     │
  │    └─ Sentry Span: mastra.tool.retrieve                │
  │                                                        │
  │ 2. Tool: densityGateTool (Threshold &amp;amp; Volume Router)   │
  │    ├─ ≥ 4 chunks ──► Conversational Grounded Mode       │
  │    └─ 1-3 chunks ──► Reflection Mode (The Flame)       │
  │    └─ Sentry Span: mastra.tool.densityGate             │
  │                                                        │
  │ 3. Tool: synthesizeGemmaTool                           │
  │    ├─ Prompt Injection: [Context Blocks with Citations] │
  │    ├─ Google Gemma (gemma2:9b / Ollama / API)          │
  │    └─ Sentry Span: mastra.tool.gemma_synthesize        │
  └────────────────────────────────────────────────────────┘
         │
         ├──────────────────────────────┐
         ▼                              ▼
  [ Text Response + Citations ]   [ ElevenLabs TTS API ]
  UI renders clickable pills      Streams audio/mpeg for
  ⚓ [Chai stall memory, 2018]     screen-off quiet listening
                                  (George Storyteller Voice)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  4. The Engineering Rule: "Code Guarantees, AI Evaluates"
&lt;/h2&gt;

&lt;p&gt;To guarantee zero hallucination, Smriti does not rely on vague prompt instructions alone. The architecture enforces deterministic safeguards:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight javascript"&gt;&lt;code&gt;&lt;span class="c1"&gt;// server/mastra/tools/synthesize.js&lt;/span&gt;
&lt;span class="c1"&gt;// Safeguard 1: Cosine similarity gate&lt;/span&gt;
&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="o"&gt;!&lt;/span&gt;&lt;span class="nx"&gt;chunks&lt;/span&gt; &lt;span class="o"&gt;||&lt;/span&gt; &lt;span class="nx"&gt;chunks&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nx"&gt;length&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="mi"&gt;0&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
    &lt;span class="na"&gt;message&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="s2"&gt;`The sanctuary does not have enough preserved words of &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;personName&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt; to speak to this yet. You can add more memories at any time.`&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
    &lt;span class="na"&gt;citations&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="p"&gt;[],&lt;/span&gt;
    &lt;span class="na"&gt;grounded&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;false&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt;
  &lt;span class="p"&gt;};&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="c1"&gt;// Safeguard 2: Density gate routes to Reflection Mode when memories are sparse&lt;/span&gt;
&lt;span class="k"&gt;if &lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="nx"&gt;mode&lt;/span&gt; &lt;span class="o"&gt;===&lt;/span&gt; &lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="s1"&gt;reflection&lt;/span&gt;&lt;span class="dl"&gt;'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt;
  &lt;span class="nx"&gt;systemPrompt&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="s2"&gt;`You are a gentle keeper of the flame in Smriti, honoring &lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;personName&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;.
CRITICAL: Do NOT attempt a fake conversational roleplay.
Warmly reflect their actual preserved words back to the user.
Every fact MUST come strictly from the memories below:
&lt;/span&gt;&lt;span class="p"&gt;${&lt;/span&gt;&lt;span class="nx"&gt;contextBlocks&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="s2"&gt;`&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  5. Partner Technology Architecture &amp;amp; Track Alignments
&lt;/h2&gt;

&lt;p&gt;Smriti was engineered from Day 1 to meaningfully demonstrate the power of open-source and modern cloud infrastructure across &lt;strong&gt;6 partner categories&lt;/strong&gt;:&lt;/p&gt;

&lt;h3&gt;
  
  
  🏆 Best Use of Gemma
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Role:&lt;/strong&gt; Core Cognitive Engine for Grounded Reflection and Keepsake Synthesis.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Implementation:&lt;/strong&gt; Smriti connects to Google Gemma (&lt;code&gt;gemma2:9b&lt;/code&gt; open weights via Ollama or API). Gemma operates under strict temperature constraints (&lt;code&gt;0.3&lt;/code&gt;) and custom system prompts that forbid roleplaying as a living person. In &lt;strong&gt;Reflection Mode&lt;/strong&gt;, Gemma acts as an empathetic mirror, echoing the user's preserved words back to them with cited integrity.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  🏆 Best Use of Render
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Role:&lt;/strong&gt; Production Cloud Runtime and Frontend Hosting.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Implementation:&lt;/strong&gt; Smriti defines a declarative Infrastructure-as-Code &lt;a&gt;render.yaml&lt;/a&gt; blueprint:

&lt;ul&gt;
&lt;li&gt;An Express API web service running the Node.js Mastra agent runtime.&lt;/li&gt;
&lt;li&gt;A static web service hosting the React + Vite Single Page Application on Render's global edge CDN.&lt;/li&gt;
&lt;li&gt;Automatic URL rewrites routing &lt;code&gt;/api/*&lt;/code&gt; and &lt;code&gt;/uploads/*&lt;/code&gt; requests seamlessly to the backend service.&lt;/li&gt;
&lt;li&gt;Connected environment groups (&lt;code&gt;smriti-secrets&lt;/code&gt;) managing credentials with zero downtime.&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  🏆 Best Use of ElevenLabs
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Role:&lt;/strong&gt; Dignified Spoken Audio Readout for Screen-Off Listening.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Implementation:&lt;/strong&gt; Located in &lt;code&gt;server/routes/voice.js&lt;/code&gt;. When a reflection is generated, ElevenLabs streams high-fidelity speech (&lt;code&gt;audio/mpeg&lt;/code&gt;) using the Multilingual v2 &lt;strong&gt;George&lt;/strong&gt; (&lt;em&gt;Warm, Captivating Storyteller&lt;/em&gt;) model (&lt;code&gt;JBFqnCBsd6RMkjVDRZzb&lt;/code&gt;). Smriti strips all citation brackets (&lt;code&gt;[Source]&lt;/code&gt;) and prompt echoes before passing text to the voice model to ensure natural human cadence, accompanied by an animated pulsing audio waveform in &lt;code&gt;VoicePlayer.jsx&lt;/code&gt;.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  🏆 Best Use of MongoDB Atlas
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Role:&lt;/strong&gt; Scalable Vector Storage &amp;amp; Semantic Search Engine.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Implementation:&lt;/strong&gt; Located in &lt;code&gt;server/db.js&lt;/code&gt; and &lt;code&gt;server/vectorSearch.js&lt;/code&gt;. Smriti indexes every memory fragment into a live cloud MongoDB Atlas cluster (&lt;code&gt;smriti-cluster.iaaaw9a.mongodb.net&lt;/code&gt;) with 128-dimensional vector embeddings. Querying utilizes the Atlas &lt;code&gt;$vectorSearch&lt;/code&gt; aggregation stage with filtering scoped by &lt;code&gt;profileId&lt;/code&gt;, ensuring instant cosine semantic retrieval across years of memory fragments. Backed by offline local JSON fallback.&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  🏆 Best Use of Mastra
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Role:&lt;/strong&gt; Agent Workflow Orchestration.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Implementation:&lt;/strong&gt; Located in &lt;code&gt;server/mastra/agent.js&lt;/code&gt;. Built using &lt;code&gt;@mastra/core&lt;/code&gt; and &lt;code&gt;@mastra/core/workflows&lt;/code&gt;. Mastra coordinates the end-to-end remembrance pipeline across three formal steps:

&lt;ol&gt;
&lt;li&gt;
&lt;code&gt;retrieveStep&lt;/code&gt; — Vector search over memory chunks.&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;densityGateStep&lt;/code&gt; — Intelligent volume routing (Conversational vs. Reflection).&lt;/li&gt;
&lt;li&gt;
&lt;code&gt;synthesizeStep&lt;/code&gt; — Google Gemma contextual generation.&lt;/li&gt;
&lt;/ol&gt;
&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  🏆 Best Use of Sentry
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Role:&lt;/strong&gt; OpenTelemetry Agent Tracing &amp;amp; Observability.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Implementation:&lt;/strong&gt; Located in &lt;code&gt;server/sentry.js&lt;/code&gt;. Every Mastra tool execution and LLM call is instrumented with custom Sentry spans (&lt;code&gt;mastra.workflow.remembrance&lt;/code&gt;, &lt;code&gt;mastra.tool.retrieve&lt;/code&gt;, &lt;code&gt;mastra.tool.densityGate&lt;/code&gt;, &lt;code&gt;elevenlabs.text_to_speech&lt;/code&gt;). Spans capture attributes including &lt;code&gt;queryLength&lt;/code&gt;, &lt;code&gt;chunksCount&lt;/code&gt;, and &lt;code&gt;density_mode&lt;/code&gt;, providing real-time latency and error tracking in the Sentry dashboard (&lt;code&gt;smriti-sanctuary.sentry.io&lt;/code&gt;).&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  6. Verification &amp;amp; Automated Test Suite
&lt;/h2&gt;

&lt;p&gt;Every architectural layer of Smriti is backed by automated integration tests running in CI:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm run &lt;span class="nb"&gt;test&lt;/span&gt; &lt;span class="nt"&gt;-w&lt;/span&gt; server

&lt;span class="o"&gt;[&lt;/span&gt;Smriti Test Suite] Starting integration verification...
✔ Pinging /api/health ...
✔ Creating memorial profile ...
✔ Adding memory fragment ...
✔ Retrieving profile and memory hierarchy ...
&lt;span class="o"&gt;[&lt;/span&gt;Smriti Test Suite] ALL INTEGRATION TESTS PASSED &lt;span class="o"&gt;(&lt;/span&gt;100% OK&lt;span class="o"&gt;)&lt;/span&gt;

&lt;span class="o"&gt;[&lt;/span&gt;Smriti Phase 3 Brain Test] Starting verification...
✔ Testing Sparse Memory Scenario &lt;span class="o"&gt;(&lt;/span&gt;The Solitary Flame&lt;span class="o"&gt;)&lt;/span&gt;...
   Selected Mode: reflection | Is Sparse: &lt;span class="nb"&gt;true
   &lt;/span&gt;Citations: &lt;span class="o"&gt;[&lt;/span&gt; &lt;span class="s1"&gt;'Debate room memory, 2017'&lt;/span&gt; &lt;span class="o"&gt;]&lt;/span&gt;
✔ Testing Dense Memory Scenario &lt;span class="o"&gt;(&lt;/span&gt;The Sanctuary Conversation&lt;span class="o"&gt;)&lt;/span&gt;...
   Selected Mode: conversational | Retrieved Chunks: 4
&lt;span class="o"&gt;[&lt;/span&gt;Smriti Phase 3 Brain Test] ALL TESTS PASSED &lt;span class="o"&gt;(&lt;/span&gt;100% OK&lt;span class="o"&gt;)&lt;/span&gt;

&lt;span class="o"&gt;[&lt;/span&gt;Smriti Phase 4 Voice &amp;amp; Letter Test] Starting verification...
✔ Testing ElevenLabs Voice Endpoint &amp;amp; Citation Stripping ... PASSED
✔ Testing Keepsake Letter Generation ... PASSED
&lt;span class="o"&gt;[&lt;/span&gt;Smriti Phase 4 Voice &amp;amp; Letter Test] ALL TESTS PASSED &lt;span class="o"&gt;(&lt;/span&gt;100% OK&lt;span class="o"&gt;)&lt;/span&gt;

&lt;span class="o"&gt;[&lt;/span&gt;Smriti Depth Features Test] Starting verification...
✔ Testing Sensory Anchors &lt;span class="o"&gt;(&lt;/span&gt;weather, scent, song&lt;span class="o"&gt;)&lt;/span&gt; &amp;amp; Spacetime Pinning ... PASSED
✔ Testing Unsent Letters to Them on the Hearth ... PASSED
✔ Testing Memory Reel Slide Photo Stories &amp;amp; Heirloom Lightbox Framing ... PASSED
✔ Testing Soundtrack Modes &lt;span class="o"&gt;(&lt;/span&gt;Offline MP3, Spotify Embed, Curated 432Hz Presets&lt;span class="o"&gt;)&lt;/span&gt; ... PASSED
&lt;span class="o"&gt;[&lt;/span&gt;Smriti Depth Features Test] ALL DEPTH TESTS PASSED &lt;span class="o"&gt;(&lt;/span&gt;100% OK&lt;span class="o"&gt;)&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  7. Why Open Source Innovation Matters
&lt;/h2&gt;

&lt;p&gt;Commercial technology often treats death as an engagement metric or a data monetization opportunity.&lt;/p&gt;

&lt;p&gt;Smriti proves that modern open-source AI—when powered by open-weight models like &lt;strong&gt;Google Gemma&lt;/strong&gt;, frameworks like &lt;strong&gt;Mastra&lt;/strong&gt;, databases like &lt;strong&gt;MongoDB Atlas&lt;/strong&gt;, and platforms like &lt;strong&gt;Render&lt;/strong&gt;—can serve a fundamentally higher purpose.&lt;/p&gt;

&lt;p&gt;It provides a sanctuary where your loved one’s memory belongs only to you. No corporate lock-in. No surveillance. Just a quiet room, a steady flame, and the words that live on in you.&lt;/p&gt;




&lt;h3&gt;
  
  
  Links &amp;amp; Resources
&lt;/h3&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;GitHub Repository:&lt;/strong&gt; &lt;a href="https://github.com/Supersaiyan101/smriti" rel="noopener noreferrer"&gt;github.com/Supersaiyan101/smriti&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Live Sanctuary Demo:&lt;/strong&gt; &lt;a href="https://smriti-sanctuary.onrender.com" rel="noopener noreferrer"&gt;https://smriti-sanctuary.onrender.com&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Video Walkthrough:&lt;/strong&gt; &lt;a href="https://youtu.be/2EsRZSqnxPs" rel="noopener noreferrer"&gt;https://youtu.be/2EsRZSqnxPs&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;License:&lt;/strong&gt; &lt;a href="https://dev.toLICENSE"&gt;MIT License&lt;/a&gt;
&lt;/li&gt;
&lt;/ul&gt;

</description>
      <category>devchallenge</category>
      <category>hf26challenge</category>
      <category>gemma</category>
      <category>opensource</category>
    </item>
    <item>
      <title>SecureScope: Building a Privacy-First AI Code Security Agent with Google Gemma 2, SerpApi &amp; ElevenLabs</title>
      <dc:creator>Anavay Sharma</dc:creator>
      <pubDate>Sun, 25 Oct 2026 08:42:48 +0000</pubDate>
      <link>https://dev.to/supersaiyan101/securescope-building-a-privacy-first-ai-code-security-agent-with-google-gemma-2-serpapi--4e7</link>
      <guid>https://dev.to/supersaiyan101/securescope-building-a-privacy-first-ai-code-security-agent-with-google-gemma-2-serpapi--4e7</guid>
      <description>&lt;p&gt;&lt;em&gt;This project is submitted for the **Hacktoberfest 2026 — Week 3: Open-Source AI Challenge&lt;/em&gt;* (&lt;code&gt;#hf26challenge&lt;/code&gt;).*&lt;/p&gt;




&lt;h2&gt;
  
  
  🧭 The Dilemma: Why Code Security Demands Open-Source AI
&lt;/h2&gt;

&lt;p&gt;In the spirit of Hacktoberfest's 'Slow and Steady' sloth philosophy: moving too fast and breaking things is how API keys leak and injection flaws reach production. SecureScope brings steady, methodical, privacy-preserving AI audits to your workflow — because slow and steady wins the security race. 🦥&lt;/p&gt;

&lt;p&gt;Every developer knows the sinking feeling of discovering an unintentional security vulnerability in production. Maybe it was an unescaped SQL parameter, a leaked API key in a configuration file, or an insecure deserialization call that slipped past code review.&lt;/p&gt;

&lt;p&gt;Naturally, the industry has turned to AI for code analysis. But today's commercial AI code scanners present a painful paradox:&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;To find vulnerabilities in your private code, you must upload your entire proprietary codebase to a third-party closed-source cloud.&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;For individual open-source developers, privacy-conscious startups, and regulated industries (fintech, healthcare, defense), this is often an unacceptable trade-off. Your intellectual property is transferred over the wire, subject to third-party retention policies, vendor rate limits, and recurring subscription bills.&lt;/p&gt;

&lt;p&gt;I built &lt;strong&gt;&lt;a href="https://github.com/SuperSaiyan101/securescope" rel="noopener noreferrer"&gt;SecureScope&lt;/a&gt;&lt;/strong&gt; to break this trade-off.&lt;/p&gt;

&lt;p&gt;SecureScope is an open-source, local-first code security intelligence agent built with &lt;strong&gt;Google Gemma 2&lt;/strong&gt; at its core. It scans code across 6+ languages, screens vulnerabilities with a microsecond regex pre-filter, verifies threats using specialized open-weight AI personas, audits dependencies against the open-source &lt;strong&gt;Google OSV&lt;/strong&gt; database, grounds findings in live &lt;strong&gt;SerpApi&lt;/strong&gt; CVE data, generates unified git diff patches, enforces Git pre-commit hooks, and synthesizes executive voice briefings with &lt;strong&gt;ElevenLabs&lt;/strong&gt; — all while keeping your source code strictly under your control.&lt;/p&gt;




&lt;h2&gt;
  
  
  🏆 Target Prize Categories
&lt;/h2&gt;

&lt;p&gt;SecureScope was intentionally engineered to highlight open-weight AI and partner ecosystems:&lt;/p&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Category&lt;/th&gt;
&lt;th&gt;Partner / Tech&lt;/th&gt;
&lt;th&gt;How SecureScope Leverages It&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;🌟 &lt;strong&gt;Best Use of Gemma ($200)&lt;/strong&gt;
&lt;/td&gt;
&lt;td&gt;
&lt;strong&gt;Google Gemma 2&lt;/strong&gt; (&lt;code&gt;gemma2-9b-it&lt;/code&gt;)&lt;/td&gt;
&lt;td&gt;Primary open-weight foundation model driving vulnerability verification, false-positive elimination, confidence scoring, and drop-in code fix generation.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;🌐 &lt;strong&gt;Best Use of SerpApi ($100)&lt;/strong&gt;
&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;SerpApi&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Live search agent querying NIST NVD, MITRE CWE, and GitHub Advisories to enrich findings with verified CVE data and security research links.&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;🎙️ &lt;strong&gt;Best Use of ElevenLabs ($100)&lt;/strong&gt;
&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;ElevenLabs&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Executive voice audio security briefing (&lt;code&gt;--voice&lt;/code&gt;), converting complex scan diagnostics into clear spoken debriefs (&lt;code&gt;.mp3&lt;/code&gt;).&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;🐙 &lt;strong&gt;Best Use of GitHub ($100)&lt;/strong&gt;
&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;GitHub Ecosystem&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Complete GitHub integration: &lt;strong&gt;SARIF 2.1.0&lt;/strong&gt; alerts in GitHub Code Scanning, automated CI/CD security gating workflow, and one-click &lt;strong&gt;Git Pre-Commit Hooks&lt;/strong&gt;.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;




&lt;h2&gt;
  
  
  💡 Why Open Innovation Matters for SecureScope
&lt;/h2&gt;

&lt;p&gt;The core prompt for Week 3 asks: &lt;em&gt;Where does an open-based approach work better than a closed one?&lt;/em&gt; Here is the direct engineering reality:&lt;/p&gt;

&lt;h3&gt;
  
  
  1. Does it run on a laptop with no internet?
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Yes, 100%.&lt;/strong&gt; Using Ollama, SecureScope downloads Google Gemma 2 once and runs completely offline:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;python cli.py &lt;span class="nt"&gt;--path&lt;/span&gt; ./my-project &lt;span class="nt"&gt;--provider&lt;/span&gt; ollama &lt;span class="nt"&gt;--model&lt;/span&gt; gemma2 &lt;span class="nt"&gt;--output&lt;/span&gt; all
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Whether you are on an airplane, in an air-gapped lab, or working remotely without Wi-Fi, the entire audit pipeline — from file discovery to AI reasoning, SARIF export, and HTML report generation — executes locally on your CPU/GPU.&lt;/p&gt;

&lt;h3&gt;
  
  
  2. Does it keep data off servers you don't control?
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Absolutely.&lt;/strong&gt; Your code never leaves localhost. No proprietary logic, internal database connection strings, or architectural secrets are transmitted to closed-model API providers or stored in external prompt logs.&lt;/p&gt;

&lt;h3&gt;
  
  
  3. Does it allow model swapping and custom agent behavior?
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Yes.&lt;/strong&gt; Closed platforms lock you into their choice of model. SecureScope uses a modular adapter architecture. Want to switch from Google Gemma 2 to CodeGemma, or test a custom security fine-tune? Simply pass a flag:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;python cli.py &lt;span class="nt"&gt;--path&lt;/span&gt; &lt;span class="nb"&gt;.&lt;/span&gt; &lt;span class="nt"&gt;--provider&lt;/span&gt; ollama &lt;span class="nt"&gt;--model&lt;/span&gt; codegemma
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;The specialized security prompts (&lt;code&gt;analyzer/prompts.py&lt;/code&gt;) are fully open-source and customizable for team-specific coding standards.&lt;/p&gt;

&lt;h3&gt;
  
  
  4. Does it cost nothing to run?
&lt;/h3&gt;

&lt;p&gt;&lt;strong&gt;Zero marginal cost.&lt;/strong&gt; Running commercial API audits across high-frequency CI/CD pipelines can cost hundreds of dollars monthly in token usage. Running Gemma 2 locally or via generous free open-model endpoints means maintainers and students can run unlimited scans for $0.&lt;/p&gt;




&lt;h3&gt;
  
  
  📊 Direct Comparison: Closed SaaS vs. SecureScope
&lt;/h3&gt;

&lt;div class="table-wrapper-paragraph"&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Capability&lt;/th&gt;
&lt;th&gt;Traditional Closed SaaS SAST&lt;/th&gt;
&lt;th&gt;SecureScope (Open-Weight AI)&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Code Privacy&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Code uploaded to vendor cloud&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Zero code leaves your machine&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Offline Execution&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;❌ Impossible&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;✅ 100% offline with Ollama&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Model Transparency&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Black-box commercial LLM&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Open-weight Google Gemma 2&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;CVE Validation&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Static rule matching&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Live SerpApi search + NIST links&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Supply Chain (SCA)&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Expensive add-on tier&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Free Google OSV database audit&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Auto-Remediation&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Static hints&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;Unified Git patches (&lt;code&gt;.patch&lt;/code&gt;) &amp;amp; auto-fix (&lt;code&gt;.bak&lt;/code&gt;)&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Pre-Commit Guard&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Complex enterprise setup&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;One-click install (&lt;code&gt;--install-hook&lt;/code&gt;)&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Audio Debrief&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;❌ None&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;ElevenLabs Executive Briefing&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;GitHub Native&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Proprietary dashboards&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;OASIS SARIF 2.1.0 Code Scanning&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Cost at Scale&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;$50 – $500 / month / seat&lt;/td&gt;
&lt;td&gt;&lt;strong&gt;$0.00 (Self-hosted &amp;amp; open-source)&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;&lt;/div&gt;




&lt;h2&gt;
  
  
  🏗️ Architecture: How SecureScope Operates
&lt;/h2&gt;

&lt;p&gt;SecureScope avoids brute-forcing entire repositories into an LLM context window. Instead, it utilizes an efficient &lt;strong&gt;multi-stage security pipeline&lt;/strong&gt;:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;                      ┌───────────────────────────────┐
                      │    Target Codebase / Repo     │
                      └──────────────┬────────────────┘
                                     │
                         1. Git-Aware File Walker
                            (respects .gitignore,
                             supports --diff mode)
                                     │
                                     ▼
                         2. Regex Pre-Filter Engine
                            (Screens 200+ patterns;
                             skips clean files in &amp;lt;1ms)
                                     │
                                     ▼
                      3. Google Gemma 2 Analysis
                       (Multi-Role AI Security Agent)
                  ┌──────────────────┼──────────────────┐
                  ▼                  ▼                  ▼
           Role 1: Secrets    Role 2: Injection  Role 3: Auth &amp;amp; SSRF
                  └──────────────────┬──────────────────┘
                                     │
                      4. Live Threat Grounding (SerpApi)
                         (Fetches NIST NVD &amp;amp; MITRE CVEs)
                                     │
                                     ▼
                      5. Supply Chain Auditing (Google OSV)
                         (Audits requirements.txt &amp;amp; package.json)
                                     │
                                     ▼
                         6. OWASP Top 10 Mapping
                            (A01:2021 to A10:2021)
                                     │
                                     ▼
                        7. Multi-Modal Reporting
                  ┌────────────┬─────────────┬─────────────┐
                  ▼            ▼             ▼             ▼
            Rich Terminal  SARIF 2.1.0  Interactive   ElevenLabs
              Dashboard     (GitHub)     HTML Report   Voice Debrief
                                     │
                                     ▼
                      8. Automated Remediation Engine
                         (Unified .patch &amp;amp; safe .bak fixing)
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Stage 1: Git-Aware File Traversal &amp;amp; Diff Mode
&lt;/h3&gt;

&lt;p&gt;The file walker (&lt;code&gt;scanner/file_walker.py&lt;/code&gt;) queries &lt;code&gt;git ls-files&lt;/code&gt; to automatically honor &lt;code&gt;.gitignore&lt;/code&gt; rules, skips build artifacts (&lt;code&gt;node_modules&lt;/code&gt;, &lt;code&gt;dist&lt;/code&gt;, &lt;code&gt;venv&lt;/code&gt;), and includes a &lt;code&gt;--diff&lt;/code&gt; mode that scans only staged files in milliseconds.&lt;/p&gt;

&lt;h3&gt;
  
  
  Stage 2: Sub-Millisecond Regex Pre-Filter
&lt;/h3&gt;

&lt;p&gt;Scanning clean files with an LLM is slow and wasteful. SecureScope runs language-specific regex rules (&lt;code&gt;scanner/languages.py&lt;/code&gt;) covering Python, JavaScript, TypeScript, Go, Java, and PHP. Clean files are bypassed instantly; only suspicious snippets with surrounding context are packaged for AI review.&lt;/p&gt;

&lt;h3&gt;
  
  
  Stage 3: Multi-Role Reasoning with Google Gemma 2
&lt;/h3&gt;

&lt;p&gt;Candidate snippets are dispatched to Google Gemma 2 (&lt;code&gt;analyzer/ai_client.py&lt;/code&gt;). Specialized auditor personas analyze each flaw:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;Injection Auditor&lt;/strong&gt;: Traces whether untrusted inputs flow into &lt;code&gt;sqlite3.execute()&lt;/code&gt;, &lt;code&gt;child_process.exec()&lt;/code&gt;, or &lt;code&gt;eval()&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Credential &amp;amp; Secret Detector&lt;/strong&gt;: Distinguishes between real high-entropy API tokens and harmless test dummy strings.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Access &amp;amp; Cryptographic Reviewer&lt;/strong&gt;: Flags weak hashing (&lt;code&gt;MD5&lt;/code&gt;, &lt;code&gt;SHA1&lt;/code&gt;), disabled TLS validation, and unsafe deserialization (&lt;code&gt;pickle.loads&lt;/code&gt;, unsafe YAML).&lt;/li&gt;
&lt;/ul&gt;

&lt;h3&gt;
  
  
  Stage 4: Live Threat Grounding via SerpApi
&lt;/h3&gt;

&lt;p&gt;When Gemma 2 confirms a vulnerability, SecureScope queries SerpApi (&lt;code&gt;analyzer/cve_search.py&lt;/code&gt;) against the National Vulnerability Database (NVD) and MITRE CWE:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="n"&gt;search_query&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;vulnerability&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; &lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;language&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="s"&gt; (site:cve.mitre.org OR site:nvd.nist.gov)&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This attaches verified CVE IDs, severity scores, and direct research links to every report.&lt;/p&gt;

&lt;h3&gt;
  
  
  Stage 5: Software Composition Analysis (SCA) via Google OSV
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fzz54dwg8vgd8akofwrtx.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fzz54dwg8vgd8akofwrtx.png" alt=" " width="800" height="410"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Over 80% of real-world vulnerabilities stem from third-party dependencies. SecureScope parses &lt;code&gt;requirements.txt&lt;/code&gt; and &lt;code&gt;package.json&lt;/code&gt;, querying Google's Open Source Vulnerabilities (OSV) API to detect known CVEs, exact line numbers, and recommended patched version numbers (&lt;code&gt;&amp;gt;= x.y.z&lt;/code&gt;).&lt;/p&gt;

&lt;h3&gt;
  
  
  Stage 6: Automated Remediation Engine
&lt;/h3&gt;

&lt;p&gt;SecureScope doesn't just detect vulnerabilities—it fixes them. Using &lt;code&gt;remediator/patcher.py&lt;/code&gt;, developers can generate a unified Git diff (&lt;code&gt;securescope.patch&lt;/code&gt;) or apply safe automated fixes directly to source files with &lt;code&gt;.bak&lt;/code&gt; safety backups.&lt;/p&gt;




&lt;h2&gt;
  
  
  📸 The Multi-Modal Reporting Experience
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F50uysr4gm1upaxele86a.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2F50uysr4gm1upaxele86a.png" alt=" " width="799" height="407"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;SecureScope delivers findings across four complementary output channels:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Rich Terminal Dashboard&lt;/strong&gt;: Color-coded severity gauges, OWASP Top 10 breakdown tables, and highlighted code snippets.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Interactive Standalone HTML Report&lt;/strong&gt;: Zero-dependency dark-mode dashboard with expandable vulnerability cards, fix suggestions, and clickable CVE badges.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;OASIS SARIF 2.1.0 Export&lt;/strong&gt;: Direct ingestion into GitHub Advanced Security and GitHub Code Scanning alerts.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;ElevenLabs Audio Security Briefing&lt;/strong&gt;: Synthesizes an executive spoken overview (&lt;code&gt;.mp3&lt;/code&gt;) summarizing critical risks for engineering leads on the go.&lt;/li&gt;
&lt;/ol&gt;




&lt;h2&gt;
  
  
  🌐 Real-Time Web Dashboard (&lt;code&gt;--serve&lt;/code&gt;)
&lt;/h2&gt;

&lt;p&gt;For developers who prefer an interactive visual interface, SecureScope includes a built-in, zero-dependency local web server:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;python cli.py &lt;span class="nt"&gt;--serve&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Running this command spins up a local dashboard at &lt;code&gt;http://localhost:8080&lt;/code&gt; where you can:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Trigger live audits across any directory path.&lt;/li&gt;
&lt;li&gt;Filter findings by Severity (Critical, High, Medium, Low) and instant text search.&lt;/li&gt;
&lt;li&gt;Click &lt;strong&gt;"Download Git Patch"&lt;/strong&gt; to grab a ready-to-commit &lt;code&gt;.patch&lt;/code&gt; file.&lt;/li&gt;
&lt;li&gt;Click &lt;strong&gt;"Auto-Fix Files"&lt;/strong&gt; to remediate code directly with automatic safety backups.&lt;/li&gt;
&lt;/ul&gt;




&lt;h2&gt;
  
  
  🔬 Real-World Example: Finding &amp;amp; Fixing an Injection Flaw
&lt;/h2&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fctcu607b05amy0dqmf3q.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Fctcu607b05amy0dqmf3q.png" alt=" " width="799" height="397"&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;To test the system, I ran SecureScope against a deliberately vulnerable fixture containing an unsafe SQL query:&lt;/p&gt;

&lt;h3&gt;
  
  
  Vulnerable Input Code (&lt;code&gt;app.py&lt;/code&gt;):
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight python"&gt;&lt;code&gt;&lt;span class="k"&gt;def&lt;/span&gt; &lt;span class="nf"&gt;search_users&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;username&lt;/span&gt;&lt;span class="p"&gt;):&lt;/span&gt;
    &lt;span class="n"&gt;conn&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;sqlite3&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;connect&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;users.db&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="n"&gt;cursor&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;conn&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;cursor&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
    &lt;span class="c1"&gt;# Flaw: Direct string interpolation into SQL query
&lt;/span&gt;    &lt;span class="n"&gt;cursor&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;execute&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="sa"&gt;f&lt;/span&gt;&lt;span class="sh"&gt;"&lt;/span&gt;&lt;span class="s"&gt;SELECT * FROM users WHERE name = &lt;/span&gt;&lt;span class="sh"&gt;'&lt;/span&gt;&lt;span class="si"&gt;{&lt;/span&gt;&lt;span class="n"&gt;username&lt;/span&gt;&lt;span class="si"&gt;}&lt;/span&gt;&lt;span class="sh"&gt;'"&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;cursor&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="nf"&gt;fetchall&lt;/span&gt;&lt;span class="p"&gt;()&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  SecureScope Terminal Output:
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;╭──────────────── #1 — SQL Injection via String Formatting ────────────────╮
│ Severity: 🔴 CRITICAL                                                    │
│ OWASP: A03:2021 — Injection                                              │
│ Confidence: HIGH                                                         │
│ File: app.py (line 45)                                                   │
│                                                                          │
│ Description: User-controlled 'username' parameter is directly formatted │
│ into the SQL query string, allowing arbitrary SQL command execution.    │
│                                                                          │
│ 💡 Fix: Use parameterized queries:                                       │
│ cursor.execute("SELECT * FROM users WHERE name = ?", (username,))        │
│                                                                          │
│ 🌐 Live CVE: CWE-89 (https://cwe.mitre.org/data/definitions/89.html)     │
╰──────────────────────────────────────────────────────────────────────────╯
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  Auto-Remediation with Unified Patching:
&lt;/h3&gt;

&lt;p&gt;Running &lt;code&gt;python cli.py --patch&lt;/code&gt; generates a clean Git patch:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight diff"&gt;&lt;code&gt;&lt;span class="gd"&gt;--- a/app.py
&lt;/span&gt;&lt;span class="gi"&gt;+++ b/app.py
&lt;/span&gt;&lt;span class="p"&gt;@@ -45,1 +45,1 @@&lt;/span&gt;
&lt;span class="gd"&gt;-    cursor.execute(f"SELECT * FROM users WHERE name = '{username}'")
&lt;/span&gt;&lt;span class="gi"&gt;+    cursor.execute("SELECT * FROM users WHERE name = ?", (username,))
&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Apply with &lt;code&gt;git apply securescope.patch&lt;/code&gt; or pass &lt;code&gt;--fix&lt;/code&gt; to patch the file automatically!&lt;/p&gt;

&lt;h3&gt;
  
  
  Generated ElevenLabs Voice Briefing Transcript:
&lt;/h3&gt;

&lt;blockquote&gt;
&lt;p&gt;&lt;em&gt;"Attention security team. This is your SecureScope automated security audit briefing. We scanned 2 files in 0.1 seconds, identifying 1 critical vulnerability: SQL Injection via String Formatting in app.py. AI-suggested parameterized query patches have been compiled in your HTML report."&lt;/em&gt;&lt;/p&gt;
&lt;/blockquote&gt;




&lt;h2&gt;
  
  
  🪝 Zero-Config Git Pre-Commit Hook
&lt;/h2&gt;

&lt;p&gt;Prevent vulnerable code and leaked secrets from ever reaching your Git history with a single command:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Install the hook into your current Git repository:&lt;/span&gt;
python cli.py &lt;span class="nt"&gt;--install-hook&lt;/span&gt;

&lt;span class="c"&gt;# Now git commit automatically screens your staged diff in &amp;lt;0.2s:&lt;/span&gt;
git commit &lt;span class="nt"&gt;-m&lt;/span&gt; &lt;span class="s2"&gt;"feat: user search"&lt;/span&gt;
&lt;span class="c"&gt;# 🔐 [SecureScope] Auditing staged code and dependencies before commit...&lt;/span&gt;
&lt;span class="c"&gt;# 🚨 [SecureScope] Commit rejected: Security issues detected in staged changes!&lt;/span&gt;
&lt;span class="c"&gt;#    • Run 'python cli.py --diff' to view full findings.&lt;/span&gt;
&lt;span class="c"&gt;#    • Run 'python cli.py --fix' to automatically apply remediations.&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  ⚡ Quickstart &amp;amp; How to Run
&lt;/h2&gt;

&lt;h3&gt;
  
  
  1. Installation
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;git clone https://github.com/SuperSaiyan101/securescope.git
&lt;span class="nb"&gt;cd &lt;/span&gt;securescope
pip &lt;span class="nb"&gt;install&lt;/span&gt; &lt;span class="nt"&gt;-r&lt;/span&gt; requirements.txt
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  2. Instant Local Scan (No API Key Required)
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;python cli.py &lt;span class="nt"&gt;--path&lt;/span&gt; ./tests/fixtures/vulnerable_app &lt;span class="nt"&gt;--skip-ai&lt;/span&gt; &lt;span class="nt"&gt;--output&lt;/span&gt; all
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  3. Full AI Scan with Google Gemma 2
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;export &lt;/span&gt;&lt;span class="nv"&gt;GROQ_API_KEY&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"gsk_..."&lt;/span&gt;  &lt;span class="c"&gt;# Windows: $env:GROQ_API_KEY="gsk_..."&lt;/span&gt;
python cli.py &lt;span class="nt"&gt;--path&lt;/span&gt; ./my-project &lt;span class="nt"&gt;--output&lt;/span&gt; all
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  4. 100% Offline Local Scan with Ollama
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;ollama pull gemma2
python cli.py &lt;span class="nt"&gt;--path&lt;/span&gt; ./my-project &lt;span class="nt"&gt;--provider&lt;/span&gt; ollama &lt;span class="nt"&gt;--model&lt;/span&gt; gemma2 &lt;span class="nt"&gt;--output&lt;/span&gt; all
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  5. Generate Voice Briefing with ElevenLabs
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;export &lt;/span&gt;&lt;span class="nv"&gt;ELEVENLABS_API_KEY&lt;/span&gt;&lt;span class="o"&gt;=&lt;/span&gt;&lt;span class="s2"&gt;"your_key"&lt;/span&gt;
python cli.py &lt;span class="nt"&gt;--path&lt;/span&gt; ./my-project &lt;span class="nt"&gt;--voice&lt;/span&gt; &lt;span class="nt"&gt;--output&lt;/span&gt; all
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  6. Auto-Remediation &amp;amp; Patching
&lt;/h3&gt;



&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="c"&gt;# Generate unified git diff patch:&lt;/span&gt;
python cli.py &lt;span class="nt"&gt;--path&lt;/span&gt; ./my-project &lt;span class="nt"&gt;--patch&lt;/span&gt;

&lt;span class="c"&gt;# Or auto-fix source files with safety backups (.bak):&lt;/span&gt;
python cli.py &lt;span class="nt"&gt;--path&lt;/span&gt; ./my-project &lt;span class="nt"&gt;--fix&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;h3&gt;
  
  
  7. Launch Real-Time Web Dashboard
&lt;/h3&gt;

&lt;p&gt;&lt;a href="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Flmrxs0ma8w5ymdbhu9dm.png" class="article-body-image-wrapper"&gt;&lt;img src="https://media2.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Farticles%2Flmrxs0ma8w5ymdbhu9dm.png" alt=" " width="800" height="408"&gt;&lt;/a&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;python cli.py &lt;span class="nt"&gt;--serve&lt;/span&gt;
&lt;span class="c"&gt;# Open http://localhost:8080 in your browser&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  🐙 CI/CD Integration: GitHub Actions &amp;amp; SARIF Code Scanning
&lt;/h2&gt;

&lt;p&gt;SecureScope includes a drop-in workflow (&lt;code&gt;.github/workflows/securescope.yml&lt;/code&gt;) that audits every pull request, exports SARIF 2.1.0 results into the native &lt;strong&gt;GitHub Security Tab&lt;/strong&gt;, and blocks merges on critical flaws:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight yaml"&gt;&lt;code&gt;&lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;SecureScope Security Scan&lt;/span&gt;
&lt;span class="na"&gt;on&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="pi"&gt;[&lt;/span&gt;&lt;span class="nv"&gt;push&lt;/span&gt;&lt;span class="pi"&gt;,&lt;/span&gt; &lt;span class="nv"&gt;pull_request&lt;/span&gt;&lt;span class="pi"&gt;]&lt;/span&gt;

&lt;span class="na"&gt;permissions&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;contents&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;read&lt;/span&gt;
  &lt;span class="na"&gt;security-events&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;write&lt;/span&gt;

&lt;span class="na"&gt;jobs&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
  &lt;span class="na"&gt;security-scan&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
    &lt;span class="na"&gt;runs-on&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;ubuntu-latest&lt;/span&gt;
    &lt;span class="na"&gt;steps&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;actions/checkout@v4&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;actions/setup-python@v5&lt;/span&gt;
        &lt;span class="na"&gt;with&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;python-version&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s1"&gt;'&lt;/span&gt;&lt;span class="s"&gt;3.12'&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;pip install -r requirements.txt&lt;/span&gt;
      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Run SecureScope Audit&lt;/span&gt;
        &lt;span class="na"&gt;env&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;GROQ_API_KEY&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;${{ secrets.GROQ_API_KEY }}&lt;/span&gt;
        &lt;span class="na"&gt;run&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;python cli.py --path . --output all --report-file securescope_report --fail-on critical&lt;/span&gt;

      &lt;span class="pi"&gt;-&lt;/span&gt; &lt;span class="na"&gt;name&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;Upload SARIF to GitHub Code Scanning&lt;/span&gt;
        &lt;span class="na"&gt;uses&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;github/codeql-action/upload-sarif@v3&lt;/span&gt;
        &lt;span class="na"&gt;with&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt;
          &lt;span class="na"&gt;sarif_file&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="s"&gt;securescope_report.sarif&lt;/span&gt;
        &lt;span class="na"&gt;continue-on-error&lt;/span&gt;&lt;span class="pi"&gt;:&lt;/span&gt; &lt;span class="kc"&gt;true&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;






&lt;h2&gt;
  
  
  🛠️ How I Built It (Show Your Work)
&lt;/h2&gt;

&lt;p&gt;This project was developed iteratively using &lt;strong&gt;OpenCode&lt;/strong&gt;, an open-source terminal coding agent harness connecting to open-weight LLMs. &lt;/p&gt;

&lt;p&gt;Using OpenCode, I:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;
&lt;strong&gt;Architected the hybrid engine&lt;/strong&gt;: Combined regex pre-filtering with Google Gemma 2 for speed and precision.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Standardized on Open Formats&lt;/strong&gt;: Implemented OASIS SARIF 2.1.0 to integrate seamlessly with GitHub Advanced Security.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Engineered Auto-Remediation&lt;/strong&gt;: Built a unified diff patch generator and direct AST file patcher with automatic &lt;code&gt;.bak&lt;/code&gt; backups.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Integrated Supply Chain Auditing&lt;/strong&gt;: Connected directly to the Google OSV API to inspect &lt;code&gt;requirements.txt&lt;/code&gt; and &lt;code&gt;package.json&lt;/code&gt; with zero API keys.&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Crafted Developer Guards&lt;/strong&gt;: Designed a one-click Git pre-commit hook and a zero-dependency local web server for visual security audits.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Building an open security tool using an open agent harness felt like the ultimate demonstration of what open-source AI makes possible in 2026.&lt;/p&gt;




&lt;h2&gt;
  
  
  🔗 Code &amp;amp; Repository
&lt;/h2&gt;

&lt;ul&gt;
&lt;li&gt;
&lt;strong&gt;GitHub Repository&lt;/strong&gt;: &lt;a href="https://github.com/SuperSaiyan101/securescope" rel="noopener noreferrer"&gt;https://github.com/SuperSaiyan101/securescope&lt;/a&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;License&lt;/strong&gt;: MIT License&lt;/li&gt;
&lt;/ul&gt;




&lt;p&gt;&lt;em&gt;What are your biggest pain points with modern code security scanners? Try running SecureScope on your project, and share your thoughts and feedback below!&lt;/em&gt;&lt;/p&gt;

</description>
      <category>hf26challenge</category>
      <category>hacktoberfest</category>
      <category>ai</category>
      <category>opensource</category>
    </item>
  </channel>
</rss>
