Skip to content

STUDIO_UI.md

Latest commit

 

History

History
104 lines (72 loc) · 2.95 KB

STUDIO_UI.md

File metadata and controls

104 lines (72 loc) · 2.95 KB
Raw

RepoSense Studio UI

What it is

RepoSense Studio is a local Studio UI for interactive repository analysis.

Start Studio

.\.venv\Scripts\python.exe -m reposense studio serve --port 8010

Open:

http://127.0.0.1:8010

Current workflow

  1. Choose one import mode:
    • Upload a repository ZIP, or
    • Analyze a local repository path.
  2. Start analysis.
  3. Wait for run completion.
  4. Open generated outputs:
    • report.html
    • Learn UI
    • SARIF
    • Context Pack
    • run_manifest.json
    • backend verifier report
    • local AI-derived outputs if generated

Analyze a local repository path

  1. Start Studio.
  2. Enter a local repository path in Analyze local repository path.
  3. Click Analyze local path.
  4. Configure run profile/ruleset/specs and start analysis.
  5. Track runs and open artifacts from the same run list.

Boundary notes:

  • Local path analysis is local-only in Studio.
  • RepoSense reads repository files for static analysis and does not execute repository code.
  • Browser flow does not upload the full local directory to a hosted cloud service by default.

Repository Review panel

Studio can display Repository Review artifacts generated by RepoSense when they exist in a run directory.

The panel is read-only. It links to:

  • repository_review_report.md
  • human_review_required.md
  • Code Health artifacts such as code_health_summary.json
  • Permission Auditor artifacts such as permission_risk_report.md
  • AuthZ Matrix artifacts such as authz_matrix_report.md and authz_negative_test_plan.md
  • Context Pack REVIEW files such as context_pack/REVIEW/README.md

The panel does not execute review generation automatically. Generate the review artifacts with the existing CLI commands, then refresh the Studio run list.

For a complete local demo that produces the artifacts shown in this panel:

powershell -ExecutionPolicy Bypass -File tools/review_demo.ps1

The canonical output is .reposense_review_demo/current/.

The recommended screenshot target for this panel is studio-review-panel.png.

Boundary notes:

  • Studio surfaces evidence-backed review artifacts; it does not replace human code review.
  • Missing review artifacts are shown as an empty state, not as a pass result.
  • Suspected findings require human confirmation.

What Studio does not do yet

  • It does not currently expose a browser folder picker for local directories.
  • It does not upload data to a hosted cloud service by default.
  • It does not replace CLI workflows.
  • It does not guarantee backend correctness.

CLI alternative

For local directory analysis:

.\.venv\Scripts\python.exe -m reposense ci run --repo <repo-path> --out .reposense_runs --profile demo --with-context-pack

Then open:

.\.venv\Scripts\python.exe -m reposense show <run_dir> --open

Implementation references

  • webui/studio/index.html
  • reposense/studio/server.py
  • reposense/studio/jobs.py
  • reposense/cli.py