diff --git a/README.md b/README.md
index d338cf6..5af20b8 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,6 @@
# deepevents.ai
deepevents.ai main codebase
+
+## Modules
+
+- [`project-repository-version-control`](./project-repository-version-control) - runnable prototype for citable scientific project repositories, version control, reproducibility checks, and export metadata.
diff --git a/project-repository-version-control/README.md b/project-repository-version-control/README.md
new file mode 100644
index 0000000..79bc030
--- /dev/null
+++ b/project-repository-version-control/README.md
@@ -0,0 +1,60 @@
+# Project Repository & Version Control
+
+This module is a self-contained implementation for SCIBASE.AI issue #10. It models the scientific project repository as a citable, versioned, reproducible workspace with manuscript, data, code, notebook, result, protocol, and metadata components.
+
+## What It Covers
+
+- Repository structure for `manuscript/`, `data/`, `code/`, `notebooks/`, `results/`, `protocols/`, and `metadata.json`.
+- Hash-based manifest generation for file integrity and reproducible export bundles.
+- Commit history, branch timelines, semantic version DOI metadata, forks, attribution, and merge request summaries.
+- Markdown/notebook-aware diff summaries for review workflows.
+- Computation-aware reproducibility checks for pipeline presence, raw data hashes, expected outputs, metadata schema, and sandbox execution.
+- Auto-generated APA, MLA, and BibTeX citations.
+- JSON API and browser dashboard for reviewer smoke testing.
+
+## Run Locally
+
+```bash
+cd project-repository-version-control
+npm test
+npm start
+```
+
+Then open `http://localhost:4129`.
+
+## API Surface
+
+- `GET /api/dashboard`
+- `GET /api/repositories/repo-organoid-response`
+- `GET /api/repositories/repo-organoid-response/manifest`
+- `GET /api/repositories/repo-organoid-response/merge-request`
+- `GET /api/repositories/repo-organoid-response/reproducibility`
+- `GET /api/repositories/repo-organoid-response/citation?style=APA|MLA|BibTeX`
+- `GET /api/repositories/repo-organoid-response/export`
+
+## Requirement Mapping
+
+- Repository components: represented in `demoRepository.files`.
+- File and metadata versioning: implemented by `buildManifest`, hash generation, branches, and commits.
+- Collaboration and forking: represented by `forks`, `mergeRequests`, branch timelines, discussion, and reviewer metadata.
+- In-browser editors and diffs: implemented as Markdown/notebook-aware diff summaries and dashboard review surfaces.
+- Computation-aware reproducibility: implemented by `runReproducibilityCheck`.
+- Repository identifiers and citation: implemented by DOI generation and `buildCitation`.
+- Programmatic access and export: implemented by the JSON API and `buildExportBundle`.
+
+## Verification
+
+```bash
+npm test
+node src/server.js
+```
+
+Optional smoke checks:
+
+```bash
+curl -s http://localhost:4129/api/dashboard
+curl -s http://localhost:4129/api/repositories/repo-organoid-response/manifest
+curl -s "http://localhost:4129/api/repositories/repo-organoid-response/citation?style=BibTeX"
+```
+
+Demo artifacts are committed under `docs/demo/`, including `dashboard.png` and `project-repository-version-control-demo.mp4`.
diff --git a/project-repository-version-control/docs/demo-script.md b/project-repository-version-control/docs/demo-script.md
new file mode 100644
index 0000000..e47f6db
--- /dev/null
+++ b/project-repository-version-control/docs/demo-script.md
@@ -0,0 +1,8 @@
+# Demo Script
+
+1. Run `npm test` to verify manifest, commit, diff, reproducibility, citation, and export logic.
+2. Run `npm start` and open `http://localhost:4129`.
+3. Confirm the dashboard shows repository DOI, file count, component list, and integrity hash.
+4. Inspect the merge request card for changed files and Markdown/notebook-aware diff types.
+5. Confirm the reproducibility checks all pass.
+6. Review the generated citation and export bundle metadata.
diff --git a/project-repository-version-control/docs/demo/dashboard.png b/project-repository-version-control/docs/demo/dashboard.png
new file mode 100644
index 0000000..d26f09b
Binary files /dev/null and b/project-repository-version-control/docs/demo/dashboard.png differ
diff --git a/project-repository-version-control/docs/demo/project-repository-version-control-demo.mp4 b/project-repository-version-control/docs/demo/project-repository-version-control-demo.mp4
new file mode 100644
index 0000000..07cfe85
Binary files /dev/null and b/project-repository-version-control/docs/demo/project-repository-version-control-demo.mp4 differ
diff --git a/project-repository-version-control/package.json b/project-repository-version-control/package.json
new file mode 100644
index 0000000..6e1f02b
--- /dev/null
+++ b/project-repository-version-control/package.json
@@ -0,0 +1,14 @@
+{
+ "name": "@scibase/project-repository-version-control",
+ "version": "0.1.0",
+ "private": true,
+ "description": "Self-contained scientific project repository and version-control prototype for SCIBASE.AI issue #10.",
+ "type": "module",
+ "scripts": {
+ "start": "node src/server.js",
+ "test": "node --test test/*.test.js"
+ },
+ "engines": {
+ "node": ">=20"
+ }
+}
diff --git a/project-repository-version-control/public/app.js b/project-repository-version-control/public/app.js
new file mode 100644
index 0000000..3ff1959
--- /dev/null
+++ b/project-repository-version-control/public/app.js
@@ -0,0 +1,33 @@
+const dashboard = await fetch("/api/dashboard").then((response) => response.json());
+
+document.querySelector("#repoTitle").textContent = dashboard.manifest.title;
+document.querySelector("#manifest").innerHTML = [
+ stat("DOI", dashboard.manifest.doi),
+ stat("Files", dashboard.manifest.files.length),
+ stat("Components", Object.keys(dashboard.manifest.components).join(", ")),
+ stat("Integrity", dashboard.manifest.integrityHash.slice(0, 16))
+].join("");
+
+document.querySelector("#mergeRequest").innerHTML = `
+
+ ${dashboard.mergeRequest.id}
+ ${dashboard.mergeRequest.status}
+
+
+ ${dashboard.mergeRequest.diffs.map((diff) => `- ${diff.path} · ${diff.type} · ${diff.hunks.length} hunks
`).join("")}
+
+`;
+
+document.querySelector("#checks").innerHTML = `
+ ${dashboard.reproducibility.status}
+
+ ${dashboard.reproducibility.checks.map((check) => `- ${check.passed ? "PASS" : "FAIL"} · ${check.name}
`).join("")}
+
+`;
+
+document.querySelector("#citation").textContent = dashboard.citation.apa;
+document.querySelector("#export").textContent = `${dashboard.exportBundle.fileName} · ${dashboard.exportBundle.cliCommand}`;
+
+function stat(label, value) {
+ return `${label}${String(value)}
`;
+}
diff --git a/project-repository-version-control/public/index.html b/project-repository-version-control/public/index.html
new file mode 100644
index 0000000..00f5ab4
--- /dev/null
+++ b/project-repository-version-control/public/index.html
@@ -0,0 +1,41 @@
+
+
+
+
+
+ SCIBASE Project Repository
+
+
+
+
+
+ SCIBASE.AI / issue #10
+ Project Repository & Version Control
+
+
+
+ Repository
+ Loading...
+
+
+
+ Version Control
+ Commit history and merge requests
+
+
+
+ Reproducibility
+ Sandbox validation
+
+
+
+ Citation & Export
+ Citable version bundle
+