Skip to content

chore: prepare for OSS release (CONTRIBUTING, SECURITY, COC, templates)#2

Merged
royosherove merged 1 commit into
mainfrom
chore/oss-prep
May 14, 2026
Merged

chore: prepare for OSS release (CONTRIBUTING, SECURITY, COC, templates)#2
royosherove merged 1 commit into
mainfrom
chore/oss-prep

Conversation

@royosherove
Copy link
Copy Markdown
Member

Pre-public-release housekeeping. Do not merge until you've reviewed the audit summary and confirmed the policy on emails/contact addresses.

Audit summary

A separate audit (kept private at ~/.roundhouse/workspace/loki-permissions-private/OSS_PREP_FINDINGS.md, deliberately NOT in this repo) scanned for:

  • Amazon-internal hostnames / aliases (@amazon.com, @amzn.com, Isengard, Midway, Conduit, Brazil, paste/sim/tt/wiki.amazon)
  • Real AWS account IDs / S3 buckets / KMS ARNs in fixtures
  • Email addresses in any code or doc file
  • Private GitHub repo references
  • Internal proprietary terms in repo content
  • TODO/FIXME with names or ticket IDs

Result: Repo is clean. No PII, no AWS-internal references, no private URLs, no proprietary terms. All AWS placeholders use the documented example account ID 123456789012. Only public refs in README are openclaw/openclaw (public OSS) and self-reference inceptionstack/loki-permissions.

What this PR adds

Standard public-repo conventions only — no policy or code changes:

  • CONTRIBUTING.md — contribution guide framed around the threat model; explicitly calls out the JSON↔Terraform dual-update rule and scripts/check_parity.py lint flow; service list (cloudtrail/config/guardduty/securityhub/s3/kms) for new deny additions
  • SECURITY.md — private vuln disclosure (security@inceptionstack.dev); scoped to what counts as a real bypass (e.g., DenySelfEscalation bypass, scope widening, JSON↔TF drift) vs noise
  • CODE_OF_CONDUCT.md — Contributor Covenant 2.1 (conduct@inceptionstack.dev)
  • .github/ISSUE_TEMPLATE/bug_report.yml — deployment-path-aware (CLI vs Terraform)
  • .github/ISSUE_TEMPLATE/feature_request.yml — with explicit threat-model fit checkbox
  • .github/PULL_REQUEST_TEMPLATE.md — with parity-check + dual-update reminder
  • README.md — added top-level Contributing / Security / Code of Conduct section so the new files are discoverable

Action items before going public

  • Confirm security@inceptionstack.dev and conduct@inceptionstack.dev are routable inboxes (DNS / forwarding set up)
  • Consider whether to retain OSS_PREP_FINDINGS.md in private workspace or delete it (audit log; useful as decision record)
  • Make repo public when ready

Per Roy's instruction

This PR is for review only — do not merge. Once you've signed off on the contact addresses and any wording changes, you can merge it manually.

This is the housekeeping pass before going public. A separate audit
(stored privately at ~/.roundhouse/workspace/loki-permissions-private/
OSS_PREP_FINDINGS.md) found no PII, no AWS-internal references, no
private URLs, no proprietary terms in the repo \u2014 only documented
placeholder account IDs (123456789012) and placeholder ARNs.

Adds standard public-repo conventions:

- CONTRIBUTING.md \u2014 contribution guide framed around the repo's
  opinionated threat model
- SECURITY.md \u2014 private vuln disclosure (security@inceptionstack.dev),
  scoped to what counts as a real bypass vs noise
- CODE_OF_CONDUCT.md \u2014 Contributor Covenant 2.1
- .github/ISSUE_TEMPLATE/bug_report.yml \u2014 deployment-path-aware bug form
- .github/ISSUE_TEMPLATE/feature_request.yml \u2014 with threat-model fit gate
- .github/PULL_REQUEST_TEMPLATE.md \u2014 with JSON\u2194Terraform parity checklist

No code or policy changes \u2014 docs and templates only.

Per Roy's instruction: this PR is for review, not merge.
@royosherove royosherove merged commit e3b4de1 into main May 14, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant