canisend 0.2.0__tar.gz

canisend-0.2.0/.codex-plugin/plugin.json

@@ -0,0 +1,33 @@
+{
+  "name": "canisend",
+  "version": "0.2.0",
+  "description": "Evidence-backed job application preparation skills for Codex.",
+  "author": {
+    "name": "Peng Jiaxin"
+  },
+  "homepage": "https://github.com/jxpeng98/CanISend",
+  "repository": "https://github.com/jxpeng98/CanISend",
+  "license": "MIT",
+  "keywords": [
+    "academic jobs",
+    "applications",
+    "skills",
+    "typst"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "CanISend",
+    "shortDescription": "Evidence-backed application skills.",
+    "longDescription": "CanISend provides local-first skills for preparing evidence-backed academic and professional job application materials without submitting applications or fabricating claims.",
+    "developerName": "Peng Jiaxin",
+    "category": "Productivity",
+    "capabilities": [
+      "Write"
+    ],
+    "defaultPrompt": [
+      "Use CanISend to review my application materials.",
+      "Strengthen this research statement with evidence.",
+      "Check my cover letter against the job criteria."
+    ]
+  }
+}

canisend-0.2.0/.env.example

@@ -0,0 +1,6 @@
+ACADEMIC_PREP_LLM_PROVIDER=openai-compatible
+OPENAI_API_KEY=
+OPENAI_BASE_URL=
+OPENAI_MODEL=
+ACADEMIC_PREP_LLM_COMMAND=
+ACADEMIC_PREP_LLM_TIMEOUT_SECONDS=300

canisend-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: ci
+
+on:
+  push:
+    branches:
+      - main
+      - "feature/**"
+  pull_request:
+
+jobs:
+  test-build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install project
+        run: uv sync --all-extras --dev
+
+      - name: Run tests
+        run: uv run python -m pytest -v
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Check package metadata
+        run: uvx twine check dist/*
+
+      - name: Check packaged resources
+        run: uv run python -m canisend.package_check dist/*.whl
+
+      - name: Smoke test built wheel
+        run: |
+          python -m venv /tmp/canisend-smoke
+          /tmp/canisend-smoke/bin/pip install dist/*.whl
+          /tmp/canisend-smoke/bin/canisend --help
+          /tmp/canisend-smoke/bin/canisend init-workspace --workspace /tmp/canisend-workspace
+          /tmp/canisend-smoke/bin/canisend doctor --workspace /tmp/canisend-workspace

canisend-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,198 @@
+name: release
+
+on:
+  push:
+    tags:
+      - "v*"
+      - "test/v*"
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.release-metadata.outputs.version }}
+      release_channel: ${{ steps.release-metadata.outputs.release_channel }}
+      prerelease: ${{ steps.release-metadata.outputs.prerelease }}
+      publish_pypi: ${{ steps.release-metadata.outputs.publish_pypi }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Resolve release metadata
+        id: release-metadata
+        shell: bash
+        run: |
+          tag="$GITHUB_REF_NAME"
+          publish_pypi=false
+          prerelease=false
+
+          if [[ "$tag" == test/v* ]]; then
+            version="${tag#test/v}"
+            release_channel=test
+          elif [[ "$tag" == v* ]]; then
+            version="${tag#v}"
+            publish_pypi=true
+            if [[ "$version" =~ (a|b|rc)[0-9]+$ ]]; then
+              release_channel=beta
+              prerelease=true
+            else
+              release_channel=stable
+            fi
+          else
+            echo "Unsupported release tag: $tag" >&2
+            exit 1
+          fi
+
+          pyproject_version="$(sed -nE 's/^version = "([^"]+)"/\1/p' pyproject.toml | head -n 1)"
+          package_version="$(sed -nE 's/^__version__ = "([^"]+)"/\1/p' src/canisend/__init__.py | head -n 1)"
+
+          if [[ "$version" != "$pyproject_version" ]]; then
+            echo "Tag version $version does not match pyproject.toml $pyproject_version" >&2
+            exit 1
+          fi
+
+          if [[ "$pyproject_version" != "$package_version" ]]; then
+            echo "pyproject.toml $pyproject_version does not match __init__.py $package_version" >&2
+            exit 1
+          fi
+
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+          echo "release_channel=$release_channel" >> "$GITHUB_OUTPUT"
+          echo "prerelease=$prerelease" >> "$GITHUB_OUTPUT"
+          echo "publish_pypi=$publish_pypi" >> "$GITHUB_OUTPUT"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install project
+        run: uv sync --all-extras --dev
+
+      - name: Run tests
+        run: uv run python -m pytest -v
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Check package metadata
+        run: uvx twine check dist/*
+
+      - name: Check packaged resources
+        run: uv run python -m canisend.package_check dist/*.whl
+
+      - name: Smoke test built wheel
+        run: |
+          python -m venv /tmp/canisend-smoke
+          /tmp/canisend-smoke/bin/pip install dist/*.whl
+          /tmp/canisend-smoke/bin/canisend --help
+          /tmp/canisend-smoke/bin/canisend init-workspace --workspace /tmp/canisend-workspace
+          /tmp/canisend-smoke/bin/canisend doctor --workspace /tmp/canisend-workspace
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-distributions
+          path: |
+            dist/*.tar.gz
+            dist/*.whl
+
+  publish-testpypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/canisend
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-distributions
+          path: dist
+
+      - name: Publish package distributions to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  smoke-test-testpypi:
+    needs: [build, publish-testpypi]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Smoke test TestPyPI package
+        shell: bash
+        run: |
+          version="${{ needs.build.outputs.version }}"
+          python -m venv /tmp/canisend-testpypi
+          for attempt in 1 2 3 4 5; do
+            if /tmp/canisend-testpypi/bin/pip install \
+              --index-url https://test.pypi.org/simple/ \
+              --extra-index-url https://pypi.org/simple/ \
+              "canisend==$version"; then
+              break
+            fi
+            if [[ "$attempt" == "5" ]]; then
+              exit 1
+            fi
+            sleep 20
+          done
+          /tmp/canisend-testpypi/bin/canisend --help
+          /tmp/canisend-testpypi/bin/canisend init-workspace --workspace /tmp/canisend-testpypi-workspace
+          /tmp/canisend-testpypi/bin/canisend doctor --workspace /tmp/canisend-testpypi-workspace
+
+  publish-pypi:
+    if: needs.build.outputs.publish_pypi == 'true'
+    needs: [build, publish-testpypi, smoke-test-testpypi]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/canisend
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: python-distributions
+          path: dist
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  create-github-release:
+    if: needs.build.outputs.publish_pypi == 'true'
+    needs: [build, publish-pypi]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          VERSION: ${{ needs.build.outputs.version }}
+          RELEASE_CHANNEL: ${{ needs.build.outputs.release_channel }}
+          PRERELEASE: ${{ needs.build.outputs.prerelease }}
+        shell: bash
+        run: |
+          label="${RELEASE_CHANNEL^}"
+          args=(
+            gh release create "$GITHUB_REF_NAME"
+            --verify-tag
+            --title "CanISend $VERSION"
+            --notes "$label release $VERSION. See CHANGELOG.md and RELEASE.md for details."
+          )
+          if [[ "$PRERELEASE" == "true" ]]; then
+            args+=(--prerelease)
+          fi
+          "${args[@]}"

canisend-0.2.0/.gitignore

@@ -0,0 +1,16 @@
+.DS_Store
+.env
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.ruff_cache/
+.claude/
+dist/
+build/
+jobs/*
+!jobs/.gitkeep
+job_leads/
+profile/*
+!profile/.gitkeep
+.vscode/

canisend-0.2.0/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## 0.1.0 - Alpha
+
+Initial alpha release of the local-first academic application preparation CLI.
+
+- Added installable `canisend` CLI and private workspace workflow.
+- Added jobs.ac.uk RSS lead import with local keyword filtering.
+- Added Typst-first private profile scaffolding and normalized evidence extraction.
+- Added OpenAI-compatible and local command LLM provider support.
+- Added job advert parsing, evidence matching, cover letter draft, CV tailoring notes, criteria checklist, final package, and material review checklist outputs.
+- Added modernpro Typst source generation with optional local PDF rendering.
+- Added cross-platform agent skill resources for Codex, Claude Code, and IDE agents.
+
+This release prepares application materials only. It does not submit applications, fill web portals, create accounts, scrape full job pages, or answer sensitive declarations.

canisend-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Peng Jiaxin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.