Merge pull request #22 from gowtham0992/develop

Release Link v1.1.0

Author: gowtham0992

.github/workflows/ci.yml

@@ -2,20 +2,33 @@ name: CI
 
 on:
   pull_request:
-  push:
-    branches: [main]
   workflow_dispatch:
 
 permissions:
   contents: read
 
 jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install ruff
+        run: python -m pip install "ruff>=0.8,<1"
+
+      - name: Run ruff
+        run: python -m ruff check .
+
   test:
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12"]
+        python-version: ["3.10", "3.12", "3.14"]
     steps:
       - uses: actions/checkout@v4
 
@@ -24,19 +37,32 @@ jobs:
           python-version: ${{ matrix.python-version }}
 
       - name: Compile Python
-        run: python -m py_compile serve.py link.py scripts/check_release_hygiene.py scripts/prepare_release.py mcp_package/link_mcp/server.py mcp_package/link_mcp/__main__.py mcp_package/link_mcp/__init__.py
+        run: python -m py_compile serve.py link.py scripts/check_release_hygiene.py scripts/check_runtime_duplication.py scripts/check_tool_contract.py scripts/prepare_release.py scripts/smoke_first_use.py scripts/smoke_http_viewer.py scripts/smoke_large_wiki.py scripts/smoke_mcp_stdio.py mcp_package/link_core/*.py mcp_package/link_mcp/server.py mcp_package/link_mcp/__main__.py mcp_package/link_mcp/__init__.py
+
+      - name: Install MCP package for verification
+        run: python -m pip install ./mcp_package
 
       - name: Run tests
         run: python -m unittest discover -s tests
 
+      - name: Large wiki smoke test
+        if: matrix.python-version == '3.12'
+        run: python scripts/smoke_large_wiki.py --pages 1000
+
       - name: Demo health smoke test
         run: |
+          python scripts/smoke_first_use.py
           python link.py demo /tmp/link-demo-ci --force
           python /tmp/link-demo-ci/link.py doctor /tmp/link-demo-ci
           python /tmp/link-demo-ci/link.py rebuild-backlinks /tmp/link-demo-ci
+          python /tmp/link-demo-ci/link.py validate /tmp/link-demo-ci
           python /tmp/link-demo-ci/link.py doctor /tmp/link-demo-ci
           PYTHONPATH=mcp_package python link.py verify-mcp /tmp/link-demo-ci --python python
 
+      - name: HTTP viewer smoke test
+        if: matrix.python-version == '3.12'
+        run: python scripts/smoke_http_viewer.py
+
   installer-syntax:
     runs-on: ubuntu-latest
     steps:
@@ -57,6 +83,12 @@ jobs:
       - name: Check tracked files for secret-looking data
         run: python scripts/check_release_hygiene.py
 
+      - name: Check runtime duplication
+        run: python scripts/check_runtime_duplication.py
+
+      - name: Check tool contract
+        run: python scripts/check_tool_contract.py
+
   package:
     runs-on: ubuntu-latest
     steps:
@@ -76,3 +108,12 @@ jobs:
       - name: Check package metadata
         working-directory: mcp_package
         run: python -m twine check dist/*
+
+      - name: Install built wheel
+        working-directory: mcp_package
+        run: python -m pip install dist/*.whl
+
+      - name: MCP stdio smoke test
+        run: |
+          python link.py demo /tmp/link-mcp-smoke --force
+          python scripts/smoke_mcp_stdio.py /tmp/link-mcp-smoke/wiki

.gitignore

@@ -19,6 +19,7 @@ wiki/explorations/*
 
 # Keep index and log templates but ignore personal content
 # (we ship empty versions in the repo)
+wiki/_link_schema.json
 
 # OS junk
 .DS_Store
@@ -39,6 +40,8 @@ autoresearch/
 
 # Local demo output
 link-demo/
+.link-backups/
+.link-cache/
 
 # Integration artifacts (generated by install scripts)
 CLAUDE.md

CHANGELOG.md

@@ -0,0 +1,41 @@
+# Contributing To Link
+
+Thanks for helping improve Link. The goal is simple: make local agent memory
+easier to trust, inspect, and use.
+
+Please open pull requests against `main` unless the maintainer asks for a
+different target. The `develop` branch is a maintainer integration branch for
+staging release work before it is proposed to `main`.
+
+## Before Opening A PR
+
+Run the local gate:
+
+```bash
+python3 -m pip install "ruff>=0.8,<1"
+python3 -m ruff check .
+python3 -m unittest discover -s tests
+python3 scripts/check_release_hygiene.py
+python3 scripts/check_runtime_duplication.py
+python3 scripts/check_tool_contract.py
+git diff --check
+```
+
+For UI changes, include a screenshot or GIF. For installer, MCP, memory-write,
+HTTP API, or automation changes, call that out explicitly in the PR description.
+
+## PR Description
+
+Include:
+
+- What changed.
+- How you tested it.
+- Whether it touches memory writes, installers, MCP behavior, HTTP endpoints, or
+  automation.
+- Screenshots or GIFs for UI changes.
+
+Do not include personal wiki data, raw sources, registry tokens, `.env` files, or
+local MCP credentials in a PR.
+
+Full contributor guide:
+https://gowtham0992.github.io/link/contributing.html