Skip to content

docs: define OpenAI-backed intelligence intake v1 - #4

Merged
qt314wink merged 3 commits into
mainfrom
docs/openai-intelligence-intake-v1
Jul 20, 2026
Merged

qt314wink merged 3 commits into
mainfrom
docs/openai-intelligence-intake-v1

Conversation

@qt314wink

Copy link
Copy Markdown
Contributor

Purpose

Integrate nightly briefing findings into GitHub through an OpenAI-assisted, approval-gated intake contract without authorizing autonomous source mutation.

What changed

  • documents the organization-level OpenAI intelligence boundary
  • defines allowed and forbidden AI responsibilities
  • adds a canonical JSON Schema for structured signals
  • adds a reusable GitHub issue form for evidence, routing, scope, and safeguards
  • establishes dispositions, execution envelopes, security constraints, and human approval gates

Changed-file inventory

  • docs/intelligence/OPENAI_INTEGRATION.md
  • schemas/intelligence/signal.schema.json
  • .github/ISSUE_TEMPLATE/intelligence-signal.yml

Not included

  • no GitHub Actions workflow
  • no OpenAI API call
  • no secret changes
  • no application source changes
  • no dependency changes
  • no cross-repository writes
  • no branch, PR, deployment, or merge authority for an AI analyzer

Proposed next phase after approval

Create a separate draft PR for a read-only analyzer that:

  1. is manually or issue triggered
  2. uses OPENAI_API_KEY only through GitHub Actions secrets
  3. requests contents: read and issues: write only
  4. validates structured output against the canonical schema
  5. posts analysis as a comment or artifact
  6. records model, prompt version, run ID, sources, confidence, and limitations
  7. cannot create branches, modify source, deploy, or merge

QA requested

  • parse the JSON Schema
  • validate a representative signal fixture
  • confirm the issue form loads
  • review prompt-injection and untrusted-input boundaries
  • verify implementation candidates require an execution envelope
  • verify Jennipher remains the required approver

Rollback

Close this draft PR without merging, or revert the three documentation/schema commits. No runtime or product behavior is affected.

Approval gate

Do not merge. Requesting Jennipher’s approval before any runtime analyzer work begins.

@qt314wink
qt314wink marked this pull request as ready for review July 20, 2026 06:36
@qt314wink
qt314wink merged commit 5aec106 into main Jul 20, 2026
@qt314wink
qt314wink deleted the docs/openai-intelligence-intake-v1 branch July 20, 2026 06:36
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