Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"name": "brief2ship",
"description": "Official Brief2Ship plugin marketplace",
"owner": {
"name": "Michael Costea",
"url": "https://michaelcostea.com/"
},
"plugins": [
{
"name": "brief2ship",
"description": "Search and score existing code before greenfield AI builds, then ship with proof",
"version": "0.6.2",
"source": "./",
"author": {
"name": "Michael Costea",
"url": "https://michaelcostea.com/"
}
}
]
}
20 changes: 20 additions & 0 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"name": "brief2ship",
"description": "Repo-first discovery and verified delivery for AI coding agents",
"version": "0.6.2",
"author": {
"name": "Michael Costea",
"url": "https://michaelcostea.com/"
},
"homepage": "https://github.com/five0nit/brief2ship",
"repository": "https://github.com/five0nit/brief2ship",
"license": "MIT",
"keywords": [
"agent-skills",
"ai-coding",
"code-search",
"package-search",
"repo-first",
"verified-delivery"
]
}
65 changes: 65 additions & 0 deletions .github/ISSUE_TEMPLATE/bug.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
name: Bug report
description: Report a reproducible Brief2Ship defect
title: "bug: "
labels: ["bug", "needs-triage"]
body:
- type: markdown
attributes:
value: |
Thanks for reporting a defect. Remove credentials, private repository names, private URLs, personal data, and sensitive receipt content before posting.
- type: input
id: version
attributes:
label: Brief2Ship version
description: Output of `brief2ship --version`.
placeholder: brief2ship 0.6.2
validations:
required: true
- type: dropdown
id: operating-system
attributes:
label: Operating system
options:
- Linux
- macOS
- Windows
- Other
validations:
required: true
- type: textarea
id: command
attributes:
label: Sanitized command
description: Preserve flags and structure, but replace private paths, URLs, tokens, and names.
render: shell
validations:
required: true
- type: textarea
id: expected
attributes:
label: Expected behavior
validations:
required: true
- type: textarea
id: actual
attributes:
label: Actual behavior
description: Include the exact error and a sanitized receipt excerpt when available.
validations:
required: true
- type: textarea
id: reproduction
attributes:
label: Minimal reproduction
description: List deterministic steps using public or synthetic fixtures where possible.
validations:
required: true
- type: checkboxes
id: safety
attributes:
label: Safety check
options:
- label: I removed credentials, private URLs, private repository names, and personal data.
required: true
- label: I did not bypass robots.txt, authentication, CAPTCHA, or private-network protections.
required: true
8 changes: 8 additions & 0 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
blank_issues_enabled: false
contact_links:
- name: Questions and adoption stories
url: https://github.com/five0nit/brief2ship/discussions
about: Ask for help, share a receipt, or discuss an unbounded idea before opening an issue.
- name: Sensitive security report
url: https://github.com/five0nit/brief2ship/security/advisories/new
about: Report vulnerabilities privately. Do not open a public issue containing exploit details or secrets.
56 changes: 56 additions & 0 deletions .github/ISSUE_TEMPLATE/feature.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
name: Feature request
description: Propose a bounded improvement with a verifiable outcome
title: "feat: "
labels: ["enhancement", "needs-triage"]
body:
- type: markdown
attributes:
value: |
Brief2Ship stays lean. Start with the problem and evidence, not a large proposed architecture.
- type: textarea
id: problem
attributes:
label: Problem
description: What repo-first decision, evidence gap, install path, or verification failure is difficult today?
validations:
required: true
- type: textarea
id: example
attributes:
label: Concrete example
description: Use public or synthetic data. Do not include credentials, private repository names, private URLs, or personal data.
validations:
required: true
- type: textarea
id: outcome
attributes:
label: Smallest useful outcome
description: Describe observable behavior, not implementation preference.
validations:
required: true
- type: textarea
id: acceptance
attributes:
label: Acceptance checks
placeholder: |
- deterministic fixture reproduces the gap
- behavior is bounded and cross-platform where claimed
- receipt explains the result
validations:
required: true
- type: dropdown
id: scope
attributes:
label: Area
options:
- Discovery provider
- Local workspace discovery
- Candidate inspection and scoring
- Agent Skill installation
- CLI usability
- Public-web collection
- Documentation and examples
- Release and packaging
- Other
validations:
required: true
40 changes: 40 additions & 0 deletions .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
## Problem and scope

<!-- What bounded problem does this change solve? Link an issue when one exists. -->

## What changed

-

## Verification

<!-- Paste real commands and outcomes. Do not include credentials, private paths, private URLs, or personal data. -->

```text
command:
result:
```

## Reuse decision

- [ ] `use-as-library`
- [ ] `fork`
- [ ] `selective-reuse`
- [ ] `reject`
- [ ] `build-clean`
- [ ] Canonical-repository exception; no new implementation base was required

Reason:

## Safety and maintainability

- [ ] No credentials, private repository names, private URLs, or personal data entered the diff or receipts
- [ ] No candidate code executes during normal discovery
- [ ] Tests cover behavior changes or the PR explains why no new test is required
- [ ] Documentation and release surfaces were updated where relevant
- [ ] `python scripts/validate-release.py` passes
- [ ] `git diff --check` passes

## Known gaps

-
82 changes: 82 additions & 0 deletions .github/workflows/publish-pypi.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
name: Publish to PyPI

on:
workflow_dispatch:

permissions: {}

jobs:
verify:
name: Validate tag and release assets
runs-on: ubuntu-latest
permissions:
contents: read
steps:
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
- uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
with:
python-version: '3.13'
cache: pip
- name: Validate source and release contract
run: python scripts/validate-release.py
- name: Require immutable release tag to match VERSION
id: names
env:
RELEASE_TAG: ${{ github.ref_name }}
RELEASE_REF_TYPE: ${{ github.ref_type }}
run: |
python -c "from pathlib import Path; import os; expected='v'+Path('VERSION').read_text(encoding='utf-8').strip(); actual=os.environ['RELEASE_TAG']; ref_type=os.environ['RELEASE_REF_TYPE']; assert ref_type == 'tag', ref_type; assert actual == expected, (actual, expected)"
VERSION="$(cat VERSION)"
echo "version=$VERSION" >> "$GITHUB_OUTPUT"
echo "wheel=brief2ship-$VERSION-py3-none-any.whl" >> "$GITHUB_OUTPUT"
echo "sdist=brief2ship-$VERSION.tar.gz" >> "$GITHUB_OUTPUT"
- name: Install distribution metadata checker
run: python -m pip install --upgrade pip twine
- name: Download and verify exact GitHub release assets
env:
GH_TOKEN: ${{ github.token }}
run: |
mkdir dist
gh release download "$GITHUB_REF_NAME" \
--repo "$GITHUB_REPOSITORY" \
--pattern '${{ steps.names.outputs.wheel }}' \
--pattern '${{ steps.names.outputs.sdist }}' \
--pattern 'SHA256SUMS' \
--dir dist
python -m twine check \
'dist/${{ steps.names.outputs.wheel }}' \
'dist/${{ steps.names.outputs.sdist }}'
python scripts/verify-release-assets.py \
--directory dist \
--version '${{ steps.names.outputs.version }}'
- name: Preserve verified distributions for isolated publisher
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
with:
name: python-distributions
path: |
dist/${{ steps.names.outputs.wheel }}
dist/${{ steps.names.outputs.sdist }}
if-no-files-found: error
retention-days: 1

publish:
name: Publish trusted distributions
needs: verify
runs-on: ubuntu-latest
environment:
name: pypi
url: https://pypi.org/p/brief2ship
permissions:
id-token: write
steps:
- name: Retrieve verified distributions
uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4
with:
name: python-distributions
path: dist/
- name: Publish through PyPI Trusted Publishing
uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # release/v1
with:
packages-dir: dist/
skip-existing: false
verbose: true
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,15 @@
# Changelog

## 0.6.2 - 2026-09-05

- reposition Brief2Ship around its sharpest searchable job: stop AI coding agents rebuilding what already exists
- move a runnable PyPI quickstart, real dogfood demo, scored result, comparison table, and proof strip above the detailed workflow documentation
- add a custom 1280×640 social preview, an animated terminal receipt, and three evidence-bounded decision cases
- add GitHub CLI Agent Skills, skills.sh, Claude Code plugin, PyPI, and immutable-tag installation routes
- add GitHub Trusted Publishing workflow for PyPI with exact release-tag/version validation and no repository secret requirement
- add Code of Conduct, issue forms, pull-request template, roadmap, contribution links, and Discussions routes
- expand package metadata and release-contract checks for distribution, community, and marketing artifacts

## 0.6.1 - 2026-09-04

- restore HTTPS scraping on Python 3.12 and 3.13 by forwarding the portable `SSLContext` argument without the removed `HTTPSConnection(check_hostname=...)` keyword
Expand Down
73 changes: 73 additions & 0 deletions CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
# Contributor Covenant Code of Conduct

## Our Pledge

We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.

We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.

## Our Standards

Examples of behavior that contributes to a positive environment include:

- demonstrating empathy and kindness toward other people;
- being respectful of differing opinions, viewpoints, and experiences;
- giving and gracefully accepting constructive feedback;
- accepting responsibility, apologizing to those affected by mistakes, and learning from the experience;
- focusing on what is best for the overall community.

Examples of unacceptable behavior include:

- sexualized language or imagery, and sexual attention or advances of any kind;
- trolling, insulting or derogatory comments, and personal or political attacks;
- public or private harassment;
- publishing another person's private information without explicit permission;
- other conduct that could reasonably be considered inappropriate in a professional setting.

## Enforcement Responsibilities

Community leaders are responsible for clarifying and enforcing these standards and will take appropriate and fair corrective action in response to behavior they deem inappropriate, threatening, offensive, or harmful.

Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned with this Code of Conduct. Reasons for moderation decisions will be communicated when appropriate.

## Scope

This Code of Conduct applies within all community spaces and when an individual officially represents the community in public spaces.

## Enforcement

Report abusive, harassing, or otherwise unacceptable behavior privately to the maintainer through the contact route on the [`five0nit` GitHub profile](https://github.com/five0nit). Do not place sensitive personal information in a public issue. All complaints will be reviewed promptly and fairly, with respect for the privacy and security of the reporter.

## Enforcement Guidelines

Community leaders will use these Community Impact Guidelines when determining consequences.

### 1. Correction

**Community Impact:** Inappropriate language or other behavior deemed unprofessional or unwelcome.

**Consequence:** A private written warning explaining the violation and why the behavior was inappropriate. A public apology may be requested.

### 2. Warning

**Community Impact:** A violation through a single incident or series of actions.

**Consequence:** A warning with consequences for continued behavior. Interaction with the people involved, including unsolicited contact with those enforcing the Code of Conduct, may be prohibited for a specified period.

### 3. Temporary Ban

**Community Impact:** A serious violation of community standards, including sustained inappropriate behavior.

**Consequence:** A temporary ban from interaction or public communication with the community for a specified period.

### 4. Permanent Ban

**Community Impact:** A pattern of violating community standards, including sustained harassment, aggression, or disparagement of classes of individuals.

**Consequence:** A permanent ban from public interaction within the community.

## Attribution

This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1, available at <https://www.contributor-covenant.org/version/2/1/code_of_conduct.html>.

Community Impact Guidelines were inspired by [Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
Loading
Loading