Codex/pr9.1.3

[adgk2349]

Summary

This PR prepares FlowMap for public beta with clearer product positioning, reproducible validation evidence, improved packaging quality, and contributor onboarding improvements.

What Changed

• Updated README files in English, Korean, and Japanese:
  • Added top-of-file public beta notice
  • Replaced screenshot references with the new image set
  • Removed demo section
  • Clarified installation/run flow for both dev-host and VSIX usage
  • Documented parser debug build requirement for replay/scenario scripts
  • Simplified and unified beta license wording
• Added contributor onboarding and project hygiene docs:
  • CONTRIBUTING.md
  • .github/PULL_REQUEST_TEMPLATE.md
  • .github/ISSUE_TEMPLATE/*
  • docs/good-first-issues.md
• Added detailed validation report generator:
  • scripts/build_validation_detail.mjs
• Published validation artifacts for public review:
  • reports/replay-validation-bundle.{md,json}
  • reports/sample-scenarios-report.json
  • reports/public-beta-validation-detail.{md,json}
  • replay source reports (reports/replay-*.json, reports/commit-replay-*.json)
• Improved VSIX packaging metadata:
  • Added repository to editor/vscode/package.json
  • Added editor/vscode/LICENSE
  • Added editor/vscode/.vscodeignore
• Regenerated VSIX package:
  • editor/vscode/flowmap-0.1.0-public-beta.vsix

Validation

Executed:

node scripts/build_replay_summary.mjs \
  --report reports/replay-heavy-swift-full-strict.json \
  --report reports/replay-flowmap-75.json \
  --report reports/replay-kdecoder.json \
  --json-out reports/replay-validation-bundle.json \
  --md-out reports/replay-validation-bundle.md

node scripts/run_sample_scenarios.mjs \
  --report reports/sample-scenarios-report.json

node scripts/build_validation_detail.mjs \
  --replay-report reports/replay-heavy-swift-full-strict.json \
  --replay-report reports/replay-flowmap-75.json \
  --replay-report reports/replay-kdecoder.json \
  --scenario-report reports/sample-scenarios-report.json \
  --json-out reports/public-beta-validation-detail.json \
  --md-out reports/public-beta-validation-detail.md

cd editor/vscode
npm run compile
vsce package -o flowmap-0.1.0-public-beta.vsix

Results:

• Replay total pairs: 209
• TP / TN / FP / FN: 106 / 97 / 0 / 6
• Non-Swift FP Rate: 0%
• Swift Detection Rate: 94.64%
• Overall Match Rate: 97.13%
• Sample scenarios: 60/60 PASS (FP 0, FN 0)
• Public beta gate: PASS

Notes

• Replay non-pass entries are warn_swift_no_graph_change in non-strict mode (warnings, not hard failures).
• VSIX packaging warnings for missing repository, LICENSE, and .vscodeignore were resolved.