[416rehman]

Problem and change

The quickstart requires a driver corpus and external analysis tooling before a new user can see the engine work. Add a local demo using two harmless text samples and built-in discovery/filter processors, then make it the README's first run. Users can inspect a report and resume saved results without API keys or external analysis tools.

Include the demo instructions in all six documentation locales, preserving existing translations and using English for the new section as CONTRIBUTING.md permits. Add a modest star/feedback invitation and correct the documented CI Python versions.

Validation

• Ran the demo and status commands locally on Windows with Python 3.11.
• Added a test covering the shipped pipeline's expected filtering, saved run identity on resume, and report generation.
• pytest -m "not ghidra": 359 passed, 1 skipped, 1 deselected.
• Ruff lint and format checks, Bandit at the configured threshold, and git diff --check passed.
• Real Ghidra integration remains covered by GitHub CI; the demo does not use it.

[Copilot]

🟡 Changes recommended

The newly added demo-first sections in all doc locales can be misread as working with a package-only install despite requiring a repository checkout, so the wording should be clarified to avoid confusing first-time users.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

This PR adds a fully local “first run” demo pipeline (no API keys or external tooling) and makes it the primary quickstart path, backed by a new test to ensure the shipped demo can run, resume from persisted state, and generate reports.

Changes:

• Added a pipelines/demo pipeline and two harmless text samples to demonstrate discovery, filtering, resumable runs, and report generation offline.
• Updated README + all documentation locales to surface the demo as the recommended first run, and refreshed the documented CI Python versions.
• Added an end-to-end pytest that runs the demo via the CLI, asserts expected filtering behavior, verifies resume semantics, and checks report outputs.

File summaries

File	Description
tests/test_demo.py	Adds an end-to-end CLI test for the shipped demo pipeline (run/resume/report).
README.md	Reworks Quickstart to use the local demo first; updates repo structure and CI Python version notes.
pipelines/demo/pipeline.yaml	Defines the minimal built-in demo pipeline (file discovery + metadata filter).
pipelines/demo/README.md	Documents expected demo behavior and how to experiment with the pipeline locally.
pipelines/demo/samples/hello.txt	Adds the “kept” sample that passes the size filter.
pipelines/demo/samples/tiny.txt	Adds the “filtered” sample that fails the size filter.
docs/en/overview/quickstart.md	Adds “Try the local demo first” section to the English quickstart.
docs/es/overview/quickstart.md	Adds the demo-first section to the Spanish quickstart.
docs/fr/overview/quickstart.md	Adds the demo-first section to the French quickstart.
docs/ja/overview/quickstart.md	Adds the demo-first section to the Japanese quickstart.
docs/ru/overview/quickstart.md	Adds the demo-first section to the Russian quickstart.
docs/zh-CN/overview/quickstart.md	Adds the demo-first section to the Simplified Chinese quickstart.

Review details

• Files reviewed: 12/12 changed files
• Comments generated: 6
• Review effort level: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.