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
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ body:
id: version
attributes:
label: Version
placeholder: e.g. 0.1.0
placeholder: e.g. 1.0.0
- type: input
id: python
attributes:
Expand Down
10 changes: 8 additions & 2 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ jobs:
runs-on: ubuntu-latest
strategy:
matrix:
python-version: ["3.11", "3.12"]
python-version: ["3.11", "3.12", "3.13"]
steps:
- name: Checkout
uses: actions/checkout@v4
Expand All @@ -23,6 +23,12 @@ jobs:
with:
python-version: ${{ matrix.python-version }}
- name: Install package
run: python -m pip install -e .
run: python -m pip install .
- name: Compile package
run: python -m compileall -q backlink_intelligence
- name: Run tests
run: python -m unittest discover -s tests -v
- name: CLI smoke test
run: |
backlink-intelligence --version
backlink-intelligence status
37 changes: 27 additions & 10 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,33 @@
# Changelog

All notable changes to Backlink Intelligence will be documented here.
All notable changes to Backlink Intelligence are documented here.

The project follows semantic versioning once functional releases begin.

## [Unreleased]
## 1.0.0 - 2026-08-30

### Added

- Initial repository foundation
- Project methodology and architecture documentation
- Public release roadmap from `v0.1.0` to `v1.0.0`
- Minimal installable package and CLI status command
- Contribution, security, crawl-safety, and limitation guidance
- CI workflow for the foundation package
- Existing backlink evidence auditing.
- Safe bounded HTTP/HTTPS fetcher with private-network protections.
- HTML metadata, paragraph, heading, and link extraction.
- Contextual placement classification for main/editorial content, navigation, sidebar, footer, and unknown locations.
- Deterministic page and context relevance analysis.
- Outbound-link density and external-domain evidence.
- Bulk prospect qualification from CSV.
- Contextual link placement ranking.
- Before/After placement recommendations with editorial-preservation indicators.
- Backlink monitoring with persisted JSON baselines and change detection.
- Backlink portfolio analysis for anchors, destinations, and placements.
- Human-readable and JSON audit reporting.
- CLI commands: `audit`, `qualify`, `place`, `monitor`, `portfolio`, and `status`.
- Offline unit-test suite and GitHub Actions CI.

### Design principles

- No paid SEO API required.
- No paid AI/model API required.
- Evidence-first output instead of an unexplained universal backlink score.
- Human review required for placement drafts and workflow recommendations.

## 0.0.1 - 2026-08-30

- Initial repository foundation, methodology, roadmap, contribution guidance, and CLI scaffold.
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Contributions should preserve the project's core principles:
git clone https://github.com/alok-vibe-code/backlink-intelligence.git
cd backlink-intelligence
python -m venv .venv
source .venv/bin/activate # Windows: .venv\\Scripts\\activate
source .venv/bin/activate # Windows: .venv\Scripts\activate
python -m pip install -e .
python -m unittest discover -s tests -v
```
Expand Down
6 changes: 6 additions & 0 deletions Dockerfile
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
FROM python:3.12-slim
WORKDIR /app
COPY . .
RUN python -m pip install --no-cache-dir .
ENTRYPOINT ["backlink-intelligence"]
CMD ["--help"]
Loading
Loading