Skip to content

docs(profile): add viz + Get started install commands#1

Merged
WomB0ComB0 merged 1 commit intomainfrom
docs/add-viz-and-onboarding
Apr 14, 2026
Merged

docs(profile): add viz + Get started install commands#1
WomB0ComB0 merged 1 commit intomainfrom
docs/add-viz-and-onboarding

Conversation

@WomB0ComB0
Copy link
Copy Markdown
Member

@WomB0ComB0 WomB0ComB0 commented Apr 14, 2026

Summary

Two small updates to the org profile README shown on https://github.com/resq-software:

  1. Ecosystem table

    • Add viz (.NET visualization library) — was missing
    • Clarify crates ships the resq binary (the hook/audit backend)
    • Clarify dev ships the canonical git hooks contract
  2. New "Get started" section
    Two-curl onboarding using the installers that just landed in dev/:

    • scripts/install-resq.sh — SHA-verified binary from the latest resq-cli-v* release, cargo fallback
    • scripts/install-hooks.sh — canonical hooks + prompt to scaffold a repo-type-aware local-pre-push

Keeps the current compact style.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Updated ecosystem overview to clarify available tools and binaries.
    • Added new "Get started" section with step-by-step installation instructions for the CLI and repository setup.
    • Documented canonical git hooks configuration process.
    • Added information about the .NET visualization library.

- Ecosystem table: add `viz` (C# .NET visualization library)
- Update `crates` description to mention the `resq` binary it ships
- Update `dev` description to mention the canonical git hooks contract
- New "Get started" section: two-curl onboarding (install-resq.sh +
  install-hooks.sh) so first-time contributors land on a working setup
  without having to dig through repo-level READMEs

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@WomB0ComB0 WomB0ComB0 merged commit 5270561 into main Apr 14, 2026
@WomB0ComB0 WomB0ComB0 deleted the docs/add-viz-and-onboarding branch April 14, 2026 20:18
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 14, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 00a98679-8c2e-4b96-9a71-9dcae2036527

📥 Commits

Reviewing files that changed from the base of the PR and between 33e5641 and 5c8bade.

📒 Files selected for processing (1)
  • profile/README.md

📝 Walkthrough

Walkthrough

The ecosystem section of the profile README was updated to clarify that the crates repository ships the resq binary, add a new viz repository entry for a .NET visualization library, and expand the dev repository description. A new "Get started" section was added with installation instructions for the resq CLI and canonical git hooks deployment via remote scripts.

Changes

Cohort / File(s) Summary
Documentation Updates
profile/README.md
Updated ecosystem table entries to clarify resq binary shipping and added viz repository row. Enhanced dev repository description with canonical git hooks reference. Added new "Get started" section with shell commands for installing resq CLI and canonical git hooks, including script behavior descriptions.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 A table refreshed, a section so new,
With hooks and with binaries, all shiny and true,
The CLI commands now guide the way,
Our ecosystem blooms brighter each day! ✨

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/add-viz-and-onboarding

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the repository ecosystem table in profile/README.md by adding the viz repository and refining descriptions for crates and dev. It also introduces a 'Get started' section with installation instructions. Review feedback highlights an inconsistency between this table and the root README.md and suggests using bash instead of sh for executing remote scripts to ensure compatibility with Bash-specific features.

Comment thread profile/README.md
Comment on lines +20 to +28
| [crates](https://github.com/resq-software/crates) | Rust CLI/TUI toolset for drone ops (ships the `resq` binary) | Rust |
| [pypi](https://github.com/resq-software/pypi) | FastMCP server + DSA utilities | Python |
| [dotnet-sdk](https://github.com/resq-software/dotnet-sdk) | .NET typed clients + blockchain anchoring | C# |
| [programs](https://github.com/resq-software/programs) | Solana Anchor on-chain programs | Rust |
| [vcpkg](https://github.com/resq-software/vcpkg) | C++ vcpkg libraries | C++ |
| [viz](https://github.com/resq-software/viz) | .NET visualization library | C# |
| [landing](https://github.com/resq-software/landing) | Marketing & product site | Next.js |
| [docs](https://github.com/resq-software/docs) | Documentation (Mintlify) | MDX |
| [dev](https://github.com/resq-software/dev) | One-command developer setup | Shell |
| [dev](https://github.com/resq-software/dev) | One-command developer setup + canonical git hooks | Shell |
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The ecosystem table in this file is inconsistent with the one in the root README.md (lines 54-64). Specifically:

  • Repository names and links differ (e.g., crates vs cli, npm vs ui, pypi vs mcp).
  • The new viz repository is missing from the root README.md.
  • Descriptions for dev and crates have been updated here but not in the root file.

Consider synchronizing both tables to ensure a consistent experience for users browsing the organization.

Comment thread profile/README.md
Comment on lines +35 to +37
curl -fsSL https://raw.githubusercontent.com/resq-software/dev/main/scripts/install-resq.sh | sh
cd <any resq repo>
curl -fsSL https://raw.githubusercontent.com/resq-software/dev/main/scripts/install-hooks.sh | sh
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

It is recommended to use bash instead of sh when piping remote scripts to the shell. Many modern installation scripts rely on Bash-specific features (like pipefail, arrays, or extended globbing) that are not available in POSIX-compliant shells like dash (the default sh on many Linux distributions).

Suggested change
curl -fsSL https://raw.githubusercontent.com/resq-software/dev/main/scripts/install-resq.sh | sh
cd <any resq repo>
curl -fsSL https://raw.githubusercontent.com/resq-software/dev/main/scripts/install-hooks.sh | sh
curl -fsSL https://raw.githubusercontent.com/resq-software/dev/main/scripts/install-resq.sh | bash
cd <any resq repo>
curl -fsSL https://raw.githubusercontent.com/resq-software/dev/main/scripts/install-hooks.sh | bash

WomB0ComB0 added a commit that referenced this pull request Apr 17, 2026
…e lang

Addresses review feedback on PR #12 from CodeQL, CodeRabbit, and
gemini-code-assist:

Script-injection mitigations (CodeQL #1-15, #22-25; CodeRabbit):
- node-ci.yml:       forward install/lint/typecheck/build/test/package-manager via env:
- python-ci.yml:     forward ruff/mypy/test targets and flags via env:
- rust-ci.yml:       forward clippy-flags and test-flags via env:
- cpp-ci.yml:        forward source-dir, build-dir, cmake-flags via env:
- docker-publish.yml: image-digest output doc-fixed (only populated when push:true)

All affected steps now use `sh -c "$VAR"` rather than direct `${{ ... }}`
interpolation, closing the template-time-to-shell expansion path.

node-ci.yml critical ordering fix (CodeRabbit):
- pnpm/action-setup now runs BEFORE actions/setup-node with cache: 'pnpm';
  required because setup-node's pnpm cache detection resolves the pnpm
  binary.

required.yml (CodeRabbit):
- Added validate-lang gate that fails fast on unknown lang values. Prior
  to this, a typo like `pyhton` silently skipped every language job and
  `required` still passed. validate-lang is now a `needs:` dependency of
  every other job + the final `required` evaluator.

python-ci.yml (CodeRabbit):
- Added `test-paths` input (default empty = pytest discovers via
  pyproject.toml). Previous hardcoded `tests/` didn't match src-layout
  or discover-by-config projects.

ops/governance-payloads.md (gemini-code-assist):
- Rollback command for rulesets: PUT was stripping the resource because
  only `enforcement` was sent. Replaced with
  `gh api GET | jq .enforcement="disabled" | gh api PUT --input -`.

Still open (not fixed here, requires org discussion):
- Ruleset A `required_approving_review_count: 0` — gemini notes that
  without CODEOWNERS matching, PRs can merge with zero reviews. Current
  solo-dev intent; bump when team grows.
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