GoogleCloudPlatform / GoogleCloudPlatform/knowledge-catalog

Proposing okf-guard for community tools listing

Open
#356 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
9.2k
Forks
782
Avg merge
6h 36m
Merged PRs (30d)
85

Description

Hi — I've built an open-source tool that complements the OKF ecosystem and wanted to check where community-built tools are tracked, and propose it for inclusion if there's a relevant list.

okf-guard is a content-safety scanning layer for OKF generation pipelines. It inspects raw source content (PDFs, Word docs, PowerPoint, spreadsheets, HTML) for hidden text and prompt-injection patterns before that content is written into an OKF concept file — complementing existing conformance validators (which check structural validity) with a check on content safety instead.

Targets the v0.2 schema — writes generated/sources fields, and deliberately never writes a verified field (since a tool asserting its own output as verified would defeat the purpose of that field per the spec).
Fully local and deterministic in this release — no network calls, no LLM dependency, single hard dependency (PyYAML).
Apache 2.0.

GitHub: https://github.com/darshanNhb/okf-guard
PyPI: pip install okf-guard

Happy to open a PR directly if there's a specific file this should go in (e.g., a community tools section in the README) — just let me know where that lives, or point me at the contributing guide if I've missed it.

Contributor guide

Open the contributing guide

Research direction

Check the repository README and contributing guide first, especially for any community-tools listing or submission process. Done means adding okf-guard in the appropriate documented location, with its GitHub and PyPI links, if the project accepts the proposal.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
52/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.