Skip to content

Commit 6fb6de5

Browse files
Brian KrafftCopilot
Brian Krafft
and
Copilot
committed
Fix portability issues for public deployment
- Remove 4 committed PR diff artifacts (pr-25-diff-final.txt, etc.) - Add .gitignore patterns: pr-*-diff*.txt, NUL.txt, scratch_*/ - Fix Dockerfile: add COPY README.md (pyproject.toml references it) - Create CONTRIBUTING.md for public contributors - Remove internal jargon from CHANGELOG.md (/8eyes, /collab references) - Update docs/sdk-api-spec.md: remove Draft status, mark Stable - Update docs/sdk-public-surface.md: remove Draft status, mark Stable - Update docs/enforcement/ARCHITECTURE.md: remove internal tool references Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 9bd5b46 commit 6fb6de5

11 files changed

Lines changed: 82 additions & 5513 deletions

‎.gitignore‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,3 +78,8 @@ frontend/node_modules
7878
.coverage
7979
htmlcov/
8080
coverage.xml
81+
82+
# Dev artifacts (PR diffs, scratch files, Windows NUL)
83+
pr-*-diff*.txt
84+
NUL.txt
85+
scratch_*/

‎CHANGELOG.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ Format follows [Keep a Changelog](https://keepachangelog.com/).
77

88
### Overview
99

10-
OpenSpace v2.0.0 is a ground-up architectural overhaul of the self-evolving skill engine for AI agents. Across 8 phases (P0–P7) and 50+ epics, the project was hardened, decomposed, and extended from a monolithic prototype into a production-grade, security-first platform. The codebase grew from ~500 tests to **2,174 tests with zero failures**. Every epic was reviewed via multi-agent code review (/8eyes + /collab) before merge.
10+
OpenSpace v2.0.0 is a ground-up architectural overhaul of the self-evolving skill engine for AI agents. Across 8 phases (P0–P7) and 50+ epics, the project was hardened, decomposed, and extended from a monolithic prototype into a production-grade, security-first platform. The codebase grew from ~500 tests to **2,174 tests with zero failures**. Every epic underwent multi-agent adversarial code review before merge.
1111

1212
---
1313

@@ -153,7 +153,7 @@ Key security improvements across the v2.0.0 release:
153153
| Epics completed | 50+ |
154154
| Pull requests | 55+ |
155155
| Test count | 2,174 (zero failures) |
156-
| Review rounds | Multi-agent (/8eyes + /collab) on every PR |
156+
| Review rounds | Multi-agent adversarial review on every PR |
157157
| Monoliths decomposed | 5 (store.py, tool_layer.py, mcp_server.py, evolver.py, grounding_agent.py) |
158158
| AST blocklist patterns | 40+ |
159159
| Security layers | 5 (ReviewGate) + capability leases + auth |

‎CONTRIBUTING.md‎

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
# Contributing to OpenSpace
2+
3+
Thank you for your interest in contributing to OpenSpace! This document provides guidelines for contributing.
4+
5+
## Getting Started
6+
7+
1. **Fork** the repository on GitHub
8+
2. **Clone** your fork locally:
9+
```bash
10+
git clone https://github.com/<your-username>/OpenSpace.git
11+
cd OpenSpace
12+
```
13+
3. **Install** in development mode:
14+
```bash
15+
pip install -e ".[dev]"
16+
```
17+
4. **Create a branch** for your changes:
18+
```bash
19+
git checkout -b feature/your-feature-name
20+
```
21+
22+
## Development Setup
23+
24+
### Prerequisites
25+
26+
- Python 3.12+
27+
- Git
28+
29+
### Running Tests
30+
31+
```bash
32+
pytest tests/ -x -q
33+
```
34+
35+
### Linting & Type Checking
36+
37+
```bash
38+
ruff check openspace/
39+
mypy openspace/
40+
```
41+
42+
## Pull Request Process
43+
44+
1. Ensure all tests pass (`pytest tests/ -x -q`)
45+
2. Ensure linting passes (`ruff check openspace/`)
46+
3. Update documentation if your change affects public APIs
47+
4. Write clear commit messages describing what and why
48+
5. Open a pull request against the `main` branch
49+
50+
## Code Style
51+
52+
- Follow existing code conventions in the project
53+
- Use type hints for all public functions
54+
- Write docstrings for public classes and methods
55+
- Keep functions focused and small
56+
57+
## Reporting Issues
58+
59+
- Use GitHub Issues for bug reports and feature requests
60+
- Include steps to reproduce for bugs
61+
- Include Python version, OS, and relevant configuration
62+
63+
## Security Vulnerabilities
64+
65+
**Do NOT report security vulnerabilities via GitHub Issues.**
66+
See [SECURITY.md](SECURITY.md) for responsible disclosure instructions.
67+
68+
## License
69+
70+
By contributing, you agree that your contributions will be licensed under the [MIT License](LICENSE).

‎Dockerfile‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ RUN apt-get update && \
2121
rm -rf /var/lib/apt/lists/*
2222

2323
# Copy dependency files first (layer caching — code changes don't bust this)
24-
COPY pyproject.toml requirements.txt ./
24+
COPY pyproject.toml requirements.txt README.md ./
2525

2626
# Install Python dependencies (cached unless requirements change)
2727
RUN pip install --no-cache-dir --prefix=/install -r requirements.txt

‎docs/enforcement/ARCHITECTURE.md‎

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
11
# 🔒 Phase Gate Enforcement Architecture
22

33
> **Classification:** Security-Critical Infrastructure
4-
> **Status:** DRAFT — Pending /8eyes Security Audit
5-
> **Author:** /collab Security & Enforcement Lead
6-
> **Pattern Lineage:** eight-eyes/circuit_breaker → squad-audit/label-enforce → openspace/phase-gates
4+
> **Status:** Stable
5+
> **Pattern Lineage:** circuit_breaker → label-enforce → openspace/phase-gates
76
87
---
98

‎docs/sdk-api-spec.md‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
11
# SkillGuard SDK — REST API Specification
22

3-
> **Phase:** 1 (design only — implementation in Phase 6)
4-
> **Status:** Draft
53
> **Version:** 2.0.0
4+
> **Status:** Stable
65
76
## Overview
87

‎docs/sdk-public-surface.md‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
11
# SkillGuard SDK — Public API Surface
22

3-
> **Phase:** 1 (design only — implementation in Phase 6)
4-
> **Status:** Draft
53
> **Version:** 2.0.0
4+
> **Status:** Stable
65
76
## Overview
87

0 commit comments

Comments
 (0)