diff --git a/.discover/candidates.json b/.discover/candidates.json index f5d49c0..29ace9f 100644 --- a/.discover/candidates.json +++ b/.discover/candidates.json @@ -1,6 +1,6 @@ [ { - "repo": "MauricioPerera/just-bash-ocr", + "repo": "uriafranko/filesystem-sdk", "checks": { "readme_is_about_project": true, "install_command_matches_name": true, @@ -11,43 +11,9 @@ "is_subject_focused": true }, "relevant": true, - "confidence": 0.88, - "category": "Libraries", - "description": "OCR plugin adding `ocr extract`, `ocr scan`, and `ocr pdf` commands to just-bash via Tesseract.js — offline, 100+ languages, with bounding-box layout output", - "reasoning": "Clearly a just-bash plugin with real code, install command, usage examples, and distinct value (Tesseract.js OCR as custom commands). Passes all hard gates and fits the Libraries category alongside just-bash-data and just-bash-util." - }, - { - "repo": "MauricioPerera/just-bash-report", - "checks": { - "readme_is_about_project": true, - "install_command_matches_name": true, - "has_usage_example": true, - "describes_unique_value": true, - "is_not_copy_of_canonical": true, - "has_real_code": true, - "is_subject_focused": true - }, - "relevant": true, - "confidence": 0.9, - "category": "Libraries", - "description": "Plugin adding `report` commands to just-bash for generating self-contained HTML dashboards, invoices, and static sites — Chart.js charts, KPI cards, brand theming, i18n, and pure-HTML generators usable without just-bash", - "reasoning": "Well-documented just-bash plugin with real install commands, code examples, live demos, and clear distinct value. Passes all hard gates; fits Libraries alongside just-bash-data." - }, - { - "repo": "MauricioPerera/just-bash-wiki", - "checks": { - "readme_is_about_project": true, - "install_command_matches_name": true, - "has_usage_example": true, - "describes_unique_value": true, - "is_not_copy_of_canonical": true, - "has_real_code": true, - "is_subject_focused": true - }, - "relevant": true, - "confidence": 0.9, - "category": "Libraries", - "description": "Plugin implementing Karpathy's LLM Wiki pattern for just-bash — LLM-maintained knowledge base with `wiki` commands, semantic vector search, and source/page/log layers built on just-bash-data", - "reasoning": "Clearly a just-bash plugin with real install command, usage examples, distinct value (LLM wiki with semantic search), and passes all hard gates. Fits Libraries category." + "confidence": 0.87, + "category": "Filesystem Adapters", + "description": "POSIX-like virtual filesystem layer over files-sdk storage providers (R2, Vercel Blob, local, memory) that implements the just-bash IFileSystem interface directly", + "reasoning": "filesystem-sdk explicitly implements just-bash's filesystem interface, provides a real install command, rich usage examples, and is clearly just-bash focused with integration documented in detail. Strong candidate for Filesystem Adapters." } ] diff --git a/.discover/triage.json b/.discover/triage.json index 9e22758..1b183c1 100644 --- a/.discover/triage.json +++ b/.discover/triage.json @@ -1 +1 @@ -{"entries":[{"repo":"constructive-io/just-bash-test","checks":{"readme_is_about_project":false,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":false,"is_not_copy_of_canonical":true,"has_real_code":false,"is_subject_focused":false},"relevant":false,"confidence":0.98,"category":"Skip","description":"","reasoning":"This repo is about PostgreSQL/pgpm workspace tooling from Constructive. The name 'just-bash-test' is a name collision — the README has nothing to do with vercel-labs/just-bash; it's about modular Postgres development with pgpm."},{"repo":"dbreunig/dspy-just-bash-interpreter","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":false,"confidence":0.8,"category":"Integrations","description":"DSPy BashRLM code interpreter wrapping just-bash-py as a recursive language model backend for DSPy","reasoning":"While the project is clearly related to just-bash (uses just-bash Python port as a DSPy RLM), the README excerpt is very short with no install command or code example, and the author explicitly warns it's a proof-of-concept. It fails install_command_matches_name and has_usage_example hard gates."},{"repo":"devxiyang/just-bash-demo","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":false,"confidence":0.75,"category":"Built With just-bash","description":"Incident-response agent demo using just-bash and Vercel AI SDK to process multi-source data, implement business logic, and generate dual artifacts","reasoning":"The repo has `has_package_dep: true` and is a genuine just-bash consumer, but it fails `install_command_matches_name` (no npm install referencing its own package name — it's a demo app, not a library). As a demo/example rather than a published library or notable standalone project, it's borderline, but the README is in Chinese with no install command for the package itself."},{"repo":"leif293/just-bash-lazy-sql","checks":{"readme_is_about_project":false,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":false,"is_not_copy_of_canonical":false,"has_real_code":false,"is_subject_focused":false},"relevant":false,"confidence":0.97,"category":"Skip","description":"","reasoning":"The README is a near-verbatim copy of the canonical just-bash README (same security model, same installation, same Basic API examples, same configuration examples, same custom commands section). This fails is_not_copy_of_canonical — it's not a distinct project but a copy/fork with a Supabase SQL twist claimed in description only."},{"repo":"MauricioPerera/agent-skills-cli","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.8,"category":"Skip","description":"","reasoning":"This is a CLI for the agent-skills specification that uses just-bash as part of its implementation (via MountableFs + OverlayFs), but just-bash is not central to the project's identity — it's one implementation detail of a broader agent-skills toolchain. Fails is_subject_focused."},{"repo":"MauricioPerera/just-bash-ocr","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":true,"confidence":0.88,"category":"Libraries","description":"OCR plugin adding `ocr extract`, `ocr scan`, and `ocr pdf` commands to just-bash via Tesseract.js — offline, 100+ languages, with bounding-box layout output","reasoning":"Clearly a just-bash plugin with real code, install command, usage examples, and distinct value (Tesseract.js OCR as custom commands). Passes all hard gates and fits the Libraries category alongside just-bash-data and just-bash-util."},{"repo":"MauricioPerera/just-bash-report","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":true,"confidence":0.9,"category":"Libraries","description":"Plugin adding `report` commands to just-bash for generating self-contained HTML dashboards, invoices, and static sites — Chart.js charts, KPI cards, brand theming, i18n, and pure-HTML generators usable without just-bash","reasoning":"Well-documented just-bash plugin with real install commands, code examples, live demos, and clear distinct value. Passes all hard gates; fits Libraries alongside just-bash-data."},{"repo":"MauricioPerera/just-bash-wiki","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":true,"confidence":0.9,"category":"Libraries","description":"Plugin implementing Karpathy's LLM Wiki pattern for just-bash — LLM-maintained knowledge base with `wiki` commands, semantic vector search, and source/page/log layers built on just-bash-data","reasoning":"Clearly a just-bash plugin with real install command, usage examples, distinct value (LLM wiki with semantic search), and passes all hard gates. Fits Libraries category."},{"repo":"mesopelagique/JustBash","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":false,"is_subject_focused":true},"relevant":false,"confidence":0.75,"category":"Ports","description":"","reasoning":"A 4D language port of just-bash is an interesting addition to the Ports category, but the README has no install command, no code examples, and no evidence of real implemented code beyond a brief description. Fails install_command_matches_name and has_usage_example hard gates."},{"repo":"mwolting/context-fs","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.82,"category":"Skip","description":"","reasoning":"context-fs is a broader virtual filesystem framework that exposes APIs/databases as filesystems; `@context-fs/just-bash` is one adapter among many packages (nfs, cli, linear, core). just-bash is not central to the project's identity — it fails is_subject_focused."},{"repo":"nicoalbanese/ai-sdk-memory-just-bash","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.78,"category":"Skip","description":"","reasoning":"This is a general AI SDK memory example that includes a bash-backed approach using just-bash as one of three implementations. just-bash is not central to the project's identity — it's one approach among structured-actions and observational approaches. Fails is_subject_focused and install_command_matches_name."},{"repo":"Pibomeister/just-bash-vercel-ai-sdk-elements","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.78,"category":"Skip","description":"","reasoning":"This is a large production AI agent blueprint that uses just-bash as one component alongside LlamaParse, Mastra memory, and other tools. just-bash is not central to the project's identity; it's one piece of an 'Avengers-level stack'. Fails is_subject_focused and has no install command for the package."},{"repo":"tobowers/minimal-just-bash-failure","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":false,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":false,"confidence":0.95,"category":"Skip","description":"","reasoning":"This is a bug reproduction repo demonstrating a just-bash js-exec issue. It's not a library, port, adapter, integration, or notable project — it's a minimal test case for filing a bug report. No inclusion value for an awesome list."},{"repo":"vercel-labs/wterm","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.82,"category":"Skip","description":"","reasoning":"wterm is a full-featured web terminal emulator written in Zig/WASM that ships `@wterm/just-bash` as one of many packages. just-bash is not central to wterm's identity — it's a single optional package in a broader terminal emulator framework. Fails is_subject_focused."}]} +{"entries":[{"repo":"boozedog/pi-codemode","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.75,"category":"Skip","description":"Pi extension that replaces many small tool calls with one typed execute_tools call, using just-bash as one of several possible CLI backends","reasoning":"just-bash is mentioned as one possible backend for CLI capabilities but is not central to the project's identity — it's a broader Pi extension that supports multiple backends. Fails is_subject_focused and install_command_matches_name."},{"repo":"constructive-io/just-bash-test","checks":{"readme_is_about_project":false,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":false,"is_not_copy_of_canonical":true,"has_real_code":false,"is_subject_focused":false},"relevant":false,"confidence":0.95,"category":"Skip","description":"Postgres workspace scaffold generated with pgpm — unrelated to just-bash despite the name","reasoning":"The README is entirely about PostgreSQL tooling and pgpm workspaces; just-bash is a name collision. No connection to the virtual bash environment project."},{"repo":"dbreunig/dspy-just-bash-interpreter","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":false,"confidence":0.7,"category":"Integrations","description":"DSPy BashRLM wrapper using just-bash-py as the code interpreter backend for recursive language models","reasoning":"While this is clearly just-bash focused (uses the Python port), the README excerpt is too minimal — no install command matching the repo name and no usage code example, failing multiple hard gates."},{"repo":"devxiyang/just-bash-demo","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":false,"confidence":0.65,"category":"Built With just-bash","description":"Incident-response agent demo using just-bash sandbox with multi-source data ingestion, code generation, test execution, and dual-artifact output","reasoning":"This is a compelling demo built on just-bash with real code and use cases, but it lacks an install command matching the project name (it's a demo repo, not a package). Marginally relevant as a 'Built With' example but fails install_command_matches_name hard gate."},{"repo":"just-buildit/just-bashit","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":false,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.97,"category":"Skip","description":"Collection of shfmt-conformant, bats-tested, shellcheck-linted shell script tools and templates — unrelated to just-bash virtual environment","reasoning":"This is a real shell scripting toolkit but has nothing to do with vercel-labs/just-bash. Pure name collision with 'bash' in the name."},{"repo":"leif293/just-bash-lazy-sql","checks":{"readme_is_about_project":false,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":false,"is_not_copy_of_canonical":false,"has_real_code":false,"is_subject_focused":false},"relevant":false,"confidence":0.95,"category":"Skip","description":"Near-verbatim copy of the canonical just-bash README with a Supabase SQL filesystem note","reasoning":"The README is essentially a copy of the canonical just-bash README (same wording, same examples, same feature list). Fails is_not_copy_of_canonical and describes_unique_value."},{"repo":"MauricioPerera/agent-skills-cli","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.72,"category":"Skip","description":"Reference CLI for the agent-skills specification — validates SKILL.md files and uses just-bash's MountableFs/OverlayFs for sandboxed execution","reasoning":"just-bash is used as an execution substrate but is secondary to the agent-skills spec tooling. The project is primarily about SKILL.md validation and skill-bank operations, not just-bash itself. Fails is_subject_focused."},{"repo":"MauricioPerera/just-bash-harness","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":true,"confidence":0.72,"category":"Built With just-bash","description":"Single-agent loop built on just-bash and agent-skills with sandboxed tool execution, approval gates, persisted sessions, AES-256-GCM at rest, and Cloudflare Workers AI + Anthropic providers","reasoning":"just-bash is central to the harness's identity — it's explicitly named after it and depends on it for sandboxed execution. Despite missing a clear install command in the excerpt, the package is published as 'just-bash-harness' on npm making the name match implicit."},{"repo":"mesopelagique/JustBash","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":false,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":false,"confidence":0.7,"category":"Ports","description":"4D-language port of just-bash — simulated bash environment for AI agents written in 4D","reasoning":"This is a genuine port to the 4D language, but the README has no usage example and no install command, failing two hard gates. Too sparse to include confidently."},{"repo":"mwolting/context-fs","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.78,"category":"Skip","description":"Virtual filesystem framework for exposing APIs/databases to AI agents as navigable file trees, with an optional just-bash adapter package","reasoning":"just-bash is one of several packages in this broader framework (@context-fs/just-bash), but the project's identity is the context-fs ecosystem as a whole. Fails is_subject_focused since just-bash is just one adapter among many targets."},{"repo":"nicoalbanese/ai-sdk-memory-just-bash","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.72,"category":"Skip","description":"Minimal example of persistent agent memory with AI SDK — bash-backed approach uses just-bash sandbox as one of three memory implementations","reasoning":"just-bash is used in one of three approaches in this example repo, making it peripheral rather than central to the project's identity. Fails is_subject_focused."},{"repo":"Pibomeister/just-bash-vercel-ai-sdk-elements","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.68,"category":"Skip","description":"Production AI agent blueprint combining LlamaParse RAG, Mastra observational memory, just-bash sandboxed filesystem, and Vercel AI Elements streaming UI","reasoning":"just-bash is one of several major components in a broader production stack. While prominently featured, the project's identity is a full-stack blueprint rather than a just-bash-focused project. Fails is_subject_focused."},{"repo":"tobowers/minimal-just-bash-failure","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":false,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":false,"confidence":0.92,"category":"Skip","description":"Minimal reproduction repo demonstrating a js-exec bug in just-bash","reasoning":"This is a bug reproduction repo, not a library, integration, or project building on just-bash. It has no unique value to add to an awesome list — it's a temporary debugging artifact."},{"repo":"uriafranko/filesystem-sdk","checks":{"readme_is_about_project":true,"install_command_matches_name":true,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":true},"relevant":true,"confidence":0.87,"category":"Filesystem Adapters","description":"POSIX-like virtual filesystem layer over files-sdk storage providers (R2, Vercel Blob, local, memory) that implements the just-bash IFileSystem interface directly","reasoning":"filesystem-sdk explicitly implements just-bash's filesystem interface, provides a real install command, rich usage examples, and is clearly just-bash focused with integration documented in detail. Strong candidate for Filesystem Adapters."},{"repo":"vercel-labs/wterm","checks":{"readme_is_about_project":true,"install_command_matches_name":false,"has_usage_example":true,"describes_unique_value":true,"is_not_copy_of_canonical":true,"has_real_code":true,"is_subject_focused":false},"relevant":false,"confidence":0.78,"category":"Skip","description":"Web terminal emulator with DOM rendering and WASM core that includes an @wterm/just-bash package for in-browser bash","reasoning":"wterm is a full terminal emulator framework where just-bash is one of seven packages. The project's identity is the terminal emulator, not just-bash. Fails is_subject_focused despite the @wterm/just-bash subpackage being genuinely interesting."}]}