cappv1 1.7.0__tar.gz

cappv1-1.7.0/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+
+[*.{html,css,js,yml,yaml,json,md}]
+indent_size = 2

cappv1-1.7.0/.env.example

@@ -0,0 +1,33 @@
+# Which AI service to use: openrouter, openai, anthropic, or ollama.
+# ollama runs the model on this computer: free, offline, and nothing leaves it
+# (see the README, "Private mode"). It needs no key.
+# Leave PROVIDER out and the first key you fill in below is used.
+PROVIDER=openrouter
+
+# Fill in the key for the provider you chose (the others can stay blank).
+OPENROUTER_API_KEY=your-key-here
+OPENAI_API_KEY=
+ANTHROPIC_API_KEY=
+
+# MODEL / FALLBACK_MODEL must be models from the provider you chose.
+# Leave MODEL blank to use that provider's default:
+#   openrouter: minimax/minimax-m3:free   (fallback google/gemma-3-12b-it)
+#   openai:     gpt-4o-mini
+#   anthropic:  claude-haiku-5-5
+#   ollama:     gemma3:4b   (must be a vision model you've downloaded with: ollama pull <name>)
+# FALLBACK_MODEL is tried when MODEL is unavailable, rate-limited, or out of credits.
+# Avoid "reasoning" models here - they burn completion tokens on hidden thinking,
+# which can starve short caption outputs.
+MODEL=
+FALLBACK_MODEL=
+# Leave blank for the default: 4 at a time (1 for ollama).
+CONCURRENCY=
+MIN_IMAGE_SIZE_PX=40
+# Alt text the author already wrote that is shorter than this is treated as unfinished
+# and improved; longer text is kept unless the AI judges it inadequate. Blank = 30.
+MIN_EXISTING_ALT_CHARS=
+MAX_ALT_TEXT_CHARS=125
+
+# Ollama only. Defaults shown; you normally don't need to touch these.
+# OLLAMA_BASE_URL=http://localhost:11434
+# REQUEST_TIMEOUT=300

cappv1-1.7.0/.git-blame-ignore-revs

@@ -0,0 +1,3 @@
+# Commits that only reformatted code (ruff format). Use: git config blame.ignoreRevsFile .git-blame-ignore-revs
+# GitHub reads this file by itself.
+d0167c188e321bd6565b2e3fa6850f616025b377

cappv1-1.7.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,64 @@
+name: Bug report
+description: Something doesn't work as expected
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: Please don't attach decks or documents with private content. A description or a small example file is enough.
+  - type: textarea
+    id: happened
+    attributes:
+      label: What happened
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: What you expected
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      placeholder: "1. ..."
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: cappv1 version
+      description: Run `cappv1 --version`.
+    validations:
+      required: true
+  - type: dropdown
+    id: provider
+    attributes:
+      label: AI service
+      options: [OpenRouter, OpenAI, Anthropic, "Ollama (on this computer)", Not sure]
+    validations:
+      required: true
+  - type: input
+    id: model
+    attributes:
+      label: Model
+      description: Shown by `/status`.
+  - type: dropdown
+    id: frontend
+    attributes:
+      label: Where did it happen
+      options: [Terminal, Browser, "Batch (cappv1 --batch)"]
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating system
+      options: [macOS, Linux, "Windows (WSL)", Other]
+    validations:
+      required: true
+  - type: dropdown
+    id: filetype
+    attributes:
+      label: File type
+      options: [".pptx", ".docx", Both, Not file related]

cappv1-1.7.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Security vulnerability
+    url: https://github.com/srsuiux/cappv1/security/advisories/new
+    about: Please report security problems privately.

cappv1-1.7.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,23 @@
+name: Feature request
+description: Suggest an improvement
+labels: [enhancement]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem are you trying to solve?
+    validations:
+      required: true
+  - type: textarea
+    id: wanted
+    attributes:
+      label: What would you like to happen?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Anything you considered instead?
+  - type: markdown
+    attributes:
+      value: cappv1 only writes alt text, plus a short list of visually inert fixes (see docs/scope.md). Requests that change how a file looks are out of scope.

cappv1-1.7.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+## What and why
+
+<!-- One or two sentences. -->
+
+## Checklist
+
+- [ ] The tool still only writes alt text (see `docs/scope.md`)
+- [ ] Tests added or updated, and `python -m pytest` passes
+- [ ] Docs updated (`README.md`, `docs/`, in-app pages) and `CHANGELOG.md` has an entry
+- [ ] If behavior about data changed (what is sent or stored), the Privacy page is updated

cappv1-1.7.0/.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: pip
+    directory: /
+    schedule:
+      interval: weekly
+    groups:
+      python-dependencies:
+        patterns: ["*"]
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly

cappv1-1.7.0/.github/scripts/check_release_tag.py

@@ -0,0 +1,38 @@
+"""Check that a release tag matches the package version, without running any project code.
+
+    check_release_tag.py v1.7.0     exit 0 if src/cappv1/version.py says 1.7.0, else exit 1 with a message
+    check_release_tag.py --print    print the version
+"""
+
+import re
+import sys
+from pathlib import Path
+
+VERSION_FILE = Path(__file__).resolve().parents[2] / "src" / "cappv1" / "version.py"
+PATTERN = re.compile(r'^VERSION\s*=\s*"(\d+\.\d+\.\d+)"\s*$', re.MULTILINE)
+
+
+def read_version() -> str:
+    match = PATTERN.search(VERSION_FILE.read_text(encoding="utf-8"))
+    if not match:
+        sys.exit(f'{VERSION_FILE} has no line like VERSION = "1.2.3"; cannot read the package version.')
+    return match.group(1)
+
+
+def main(argv: list[str]) -> int:
+    if argv == ["--print"]:
+        print(read_version())
+        return 0
+    if len(argv) != 1:
+        print(__doc__, file=sys.stderr)
+        return 2
+    version = read_version()
+    if argv[0] != f"v{version}":
+        print(f"Tag {argv[0]} does not match the package version {version} (expected v{version}).", file=sys.stderr)
+        return 1
+    print(f"Tag {argv[0]} matches version {version}.")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv[1:]))

cappv1-1.7.0/.github/workflows/ci.yml

@@ -0,0 +1,57 @@
+name: CI
+
+on:
+  push:
+    branches: [main, "fix/**", "docs/**", "feature/**", "release/**"]
+  pull_request:
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install -e ".[dev]"
+      - run: ruff check src tests
+      - run: ruff format --check src tests
+      - run: mypy
+
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: python -m compileall -q src
+      - run: python -m pytest -q --cov=cappv1 --cov-report=term --cov-report=xml
+
+  package:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Test the release tag check (the same script the Release workflow runs)
+        run: |
+          tag="v$(python .github/scripts/check_release_tag.py --print)"
+          python .github/scripts/check_release_tag.py "$tag"
+          if python .github/scripts/check_release_tag.py v0.0.0; then echo "a wrong tag was accepted"; exit 1; fi
+      - run: pip install build twine
+      - run: python -m build
+      - run: twine check dist/*
+      - name: Install the built wheel and run it
+        run: |
+          pip install dist/*.whl
+          cd "$RUNNER_TEMP"
+          cappv1 --version
+          python -c "from cappv1.home import bundled_file; assert bundled_file('CHANGELOG.md') and bundled_file('.env.example')"

cappv1-1.7.0/.github/workflows/links.yml

@@ -0,0 +1,20 @@
+name: Links
+
+on:
+  push:
+    branches: [main, "fix/**", "docs/**", "feature/**", "release/**"]
+  pull_request:
+
+jobs:
+  markdown-links:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: lycheeverse/lychee-action@v2
+        with:
+          args: >-
+            --no-progress --include-fragments --max-retries 3 --accept '200..=299,429'
+            --exclude '^https?://(localhost|127\.0\.0\.1)' '**/*.md'
+          fail: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

cappv1-1.7.0/.github/workflows/release.yml

@@ -0,0 +1,68 @@
+name: Release
+
+# Runs only when a version tag (vX.Y.Z) is pushed: build once, publish to PyPI
+# with Trusted Publishing (no API token stored anywhere), then create the
+# GitHub Release from the CHANGELOG section.
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build twine
+      - name: Check the tag matches the package version
+        run: python .github/scripts/check_release_tag.py "$GITHUB_REF_NAME"
+      - run: python -m build
+      - run: twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/cappv1/
+    permissions:
+      id-token: write # lets PyPI verify this workflow run (OIDC); no token needed
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  github-release:
+    needs: publish-pypi
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Take the release notes from CHANGELOG.md
+        run: |
+          python3 - <<'PY' > notes.md
+          import os, re
+          version = os.environ["GITHUB_REF_NAME"].lstrip("v")
+          text = open("CHANGELOG.md", encoding="utf-8").read()
+          match = re.search(rf"^## {re.escape(version)}\b.*?\n(.*?)(?=^## |\Z)", text, re.S | re.M)
+          if not match:
+              raise SystemExit(f"No section for {version} in CHANGELOG.md")
+          print(match.group(1).strip())
+          PY
+      - uses: softprops/action-gh-release@v2
+        with:
+          body_path: notes.md
+          files: dist/*

cappv1-1.7.0/.gitignore

@@ -0,0 +1,22 @@
+.env
+keys.txt
+.DS_Store
+.venv/
+__pycache__/
+*.pyc
+.state/
+logs/
+output/*
+!output/.gitkeep
+input/*
+!input/.gitkeep
+.idea/
+.vscode/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.coverage
+coverage.xml
+.mypy_cache/
+.ruff_cache/

cappv1-1.7.0/.lycheeignore

@@ -0,0 +1,10 @@
+# Sites that block automated checkers or rate-limit GitHub's runners. The links stay in the docs.
+^https://(www\.)?openai\.com/
+^https://platform\.openai\.com/
+^https://(www\.)?anthropic\.com/
+^https://console\.anthropic\.com/
+^https://platform\.claude\.com/
+^https://openrouter\.ai/
+^https://img\.shields\.io/
+^https://codecov\.io/
+^https://(www\.)?(anthology|blackboard)\.com/

cappv1-1.7.0/.pre-commit-config.yaml

@@ -0,0 +1,29 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+        args: [--markdown-linebreak-ext=md]
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: [--maxkb=500]
+      - id: detect-private-key
+  - repo: local
+    hooks:
+      - id: block-env-files
+        name: block committed .env files
+        entry: ".env holds API keys and must never be committed"
+        language: fail
+        files: '(^|/)\.env$'
+      - id: block-user-files
+        name: block decks and documents in input/ and output/
+        entry: "input/ and output/ hold your own files and must never be committed"
+        language: fail
+        files: '^(input|output|logs|\.state)/(?!\.gitkeep$)'

cappv1-1.7.0/CHANGELOG.md

@@ -0,0 +1,140 @@
+# Changelog
+
+All notable changes to cappv1. Versions follow [Semantic Versioning](https://semver.org): MAJOR.MINOR.PATCH.
+
+## 1.7.0 - 2026-10-30
+
+### New
+
+- Changelog page under Learn: a card per release with its date, grouped into new, improved and fixed. It is read from this file, so it is always current.
+- Appearance page under Learn: choose the theme and an accent color (blue, teal, green, purple, rose or amber) for buttons and links, each checked for contrast in light and dark. Remembered in this browser. They are no longer in the sidebar.
+- Install with `pipx install cappv1` (or `pipx install git+https://github.com/srsuiux/cappv1.git`). No cloning, symlink or virtual environment.
+- cappv1 is published on PyPI, so `pipx install cappv1` works. Releases are built and uploaded by GitHub Actions when a version tag is pushed, using PyPI Trusted Publishing (no stored token).
+- Install cappv1 from the browser as an app with its own window. It still needs to be running, and the address it prints, to connect.
+- Each run keeps its finished copies in `output/<date>_<time>/` instead of replacing the last ones. Download or delete one copy or a whole run from the Files page, or in the terminal with `/history` and `/remove`; both see the change. Copies left loose in `output/` by older versions show as the oldest run.
+
+### Changed
+
+- **You will notice:** `cappv1 --batch` now runs in the foreground and prints the log, instead of starting a background job and returning. A script that relied on it returning at once should run `cappv1 --batch &` itself.
+- **You will notice:** when cappv1 is installed with pipx, your settings (`.env`), `input`, `output`, saved progress and logs live in `~/cappv1` (or the folder in `CAPPV1_HOME`). A cloned copy still uses its own project folder, so nothing moves for existing users; if you switch from a clone to pipx, copy `.env` and the folders you want into `~/cappv1`.
+
+### Improved
+
+- The Python package is now `cappv1` (it was `src`), and `pyproject.toml` is the only place dependencies are listed. `python -m cappv1` also works.
+- Checks on every push and pull request: ruff (lint and format), mypy, tests on Linux and macOS with Python 3.11 to 3.13 and coverage, a wheel build that is installed and run, and a link check for the docs. Dependabot keeps dependencies and Actions up to date, and `pre-commit` runs the same lint locally.
+- Type checking: mypy now covers every module except a short list still being fixed (tracked in issue #1). Five modules were fixed in this release.
+- A test runs the sample deck and checks that only alt text changed in the finished copy.
+- The docs are split into focused pages under `docs/`, with an index.
+- Every page now uses the full window width, in the same card layout as Files, with a shared page header.
+- The window is fixed to the screen and only the content scrolls; the sidebar no longer folds.
+- Files page: three panels (Current files, Past files, Finished copies), with sizes and dates on each card. Long processing notes moved into a ? on the card that shows them on hover, focus or tap.
+
+### Fixed
+
+- PowerPoint: finished decks open without the repair prompt and preview in Blackboard. The output is now the original file with only the slides that got alt text replaced, instead of a python-pptx re-save, which dropped embedded-object relationships with `Target="NULL"` and left slides pointing at nothing.
+
+## 1.6.0 - 2026-10-29
+
+### New
+
+- Word: Blackboard Ally structure fixes. Heading levels are renumbered to start at Heading 1 with no gaps, using copies of the existing heading styles so nothing looks different; captions become Heading 1 in a document with no headings; empty headings stop being headings; every table gets a header row, including one-row boxes; the Title property is filled when empty or wrong; text that fails the 4.5:1 contrast check is darkened to 7:1 and noted (the one visible change). `python -m src.docx_check` checks a file against these rules.
+- Word: a table's first row is now marked as its header (the Header Row box and Repeat as header row), which Blackboard Ally needs: a test file scored 100% with both and 68% with the box alone. Only plain tables: no table style, two or more rows and columns, text in every first-row cell, nothing merged. One visible effect, which the owner accepted: a table that runs onto a second page repeats its header row there. Applied even in documents where table descriptions are skipped.
+- Word: embedded objects (for example Visio drawings) now get alt text, so an accessibility checker no longer sees them as undescribed pictures. The Privacy page now lists the text read from an embedded object.
+- Files page: every file has a checkbox, with Select all and a count. "Improve accessibility" runs only the ticked files (`POST /runs` takes `files`). New files are ticked for you; previous files can be ticked too. "Remove all" empties the Current files list after an inline confirmation.
+
+### Improved
+
+- Sidebar: an icon beside every link, and a button that folds it to an icon rail (remembered in this browser). The theme choice is now three icon buttons (System, Light, Dark) with tooltips and screen-reader names.
+- A damaged item no longer stops a file. A slide or document item that cannot be read (for example an embedded object whose part is missing, which used to end the file with "no relationship with key 'rId4'") is skipped, noted in the file's saved progress and the log, and the rest finishes. The Files page lists what was skipped under each file and marks the slide, and the terminal run view prints it. Applies to decks and Word documents.
+- A run started from the browser now prints its log in the terminal that started cappv1 (`--web`, or `/web` in the terminal session).
+
+### Fixed
+
+- Word: finished copies open in Word and preview in Blackboard. The output is now the original file with only `word/document.xml` replaced, instead of a python-docx re-save. Documents saved in Word compatibility mode 11 or 12 (what LibreOffice writes) get no table alt text, because Word refuses to open them with it; picture alt text is unaffected, and one note says to use Save As in Word first.
+- Fixes a stray "null" shown on the finished-run card.
+
+## 1.5.0 - 2026-10-29
+
+### New
+
+- Word documents (`.docx`): pictures and tables get alt text (`wp:docPr` description and `w:tblDescription`), through the terminal, the batch command and the web UI. Charts, SmartArt, embedded objects and headers/footers are not handled yet, and `/audit` stays decks-only.
+
+### Improved
+
+- The Files page shows a deck's slide tiles or a document's item chips, lists current files apart from previous (already finished) ones, and always shows the "replace alt text" option, off by default.
+- Wording now describes cappv1 as improving accessibility (by writing alt text) for PowerPoint and Word.
+
+### Changed
+
+- API: the upload error code `not_pptx` is now `unsupported_file`; the audit of a Word file returns `audit_unsupported`. Run events carry `kind`.
+
+## 1.4.3 - 2026-10-27
+
+- On the Files page, a finished run shows every slide tile instead of clipping long decks.
+
+## 1.4.2 - 2026-10-27
+
+- The contrast audit now also checks text in table cells and in grouped shapes.
+
+## 1.4.1 - 2026-10-27
+
+- Fixes a syntax error that stopped cappv1 from installing on Python 3.11 (1.4.0 only works on 3.12 and newer, so use 1.4.1).
+
+## 1.4.0 - 2026-10-27
+
+- The Files page now puts a run front and center: a card at the top shows each slide lighting up and ticking off, what cappv1 is reading, and, when done, a clear "Your finished document is ready" card with Download, the saved location, and a note that the original is unchanged. The finished file is marked in the list too. Animations respect reduced-motion settings.
+- The Files page has a Check accessibility button that shows the same report in the browser.
+- New `/audit` command and `GET /api/v1/files/<name>/audit`: reports low-contrast text (WCAG AA, judged against the real backdrop including template shapes, patterns and gradients) and slides whose reading order doesn't follow the layout. Findings with the same cause are grouped across slides. It only reports; colors and layout are never changed.
+
+## 1.3.0 - 2026-10-27
+
+- A table's first row is now flagged as its header when that changes nothing visually (no table style, two or more rows, every first-row cell filled, nothing merged). This fixes Blackboard Ally's "tables are missing headers". Tables where it would change the look are left alone and the reason is logged.
+- `skills.md` now allows a short list of visually inert accessibility fixes beyond alt text. Colors, including low contrast, are never changed.
+
+## 1.2.0 - 2026-10-27
+
+### Added
+- **Local web interface** (`cappv1 --web`, or `/web` inside cappv1; `/init` now ends by offering the browser or the terminal). It is a small site served on this computer only:
+  - A front page that introduces cappv1 to new visitors and, once you're set up, leads with an Overview (next step, file counts, service, health, data) and moves the introduction below it.
+  - Files (add decks, run, live feed of the alt text being written, stop, download), Services (choose service, model and key), Health, and Your data (what is kept and where, with an erase button).
+  - How it works, Privacy, FAQ and About pages. The Privacy page states exactly what is sent to an AI service and what is stored, and a test keeps it in step with the code.
+  - Light, dark and system themes with a switch in the side panel, applied before the page paints; a test checks the contrast of every color pair in both themes. Keyboard, screen-reader and small-screen friendly; a favicon.
+- **Web server and API** (`src/web`, standard library only, documented in `docs/API.md`): bound to this computer, per-launch token, Host check, strict content policy, size-limited validated uploads, live progress over Server-Sent Events that resumes after a dropped connection.
+- Each service says what it does with your slides and links to its privacy policy; saved API keys can be removed from Services.
+- A new `alt_written` progress event carrying each piece of alt text as it is settled.
+- `src/services/`, a service layer between the engine and the screens, with a pytest suite and GitHub Actions CI.
+- `CAPPV1_HOME` to keep settings, decks and progress in a folder of your choice.
+- Project files: `SECURITY.md`, `CODE_OF_CONDUCT.md`, issue and pull request templates, `.editorconfig`, `pyproject.toml`, and `docs/ARCHITECTURE.md`.
+
+### Fixed
+- Pictures are matched by their exact bytes. Before, flat or near-identical images (for example two solid-color pictures) could share one caption.
+- A picture whose "alt text" is only its file name (`image1.png`, filled in by some tools) is no longer treated as text the author wrote.
+- The terminal toolbar no longer re-reads every deck on each keystroke.
+
+### Changed
+- No more colored bars down one side of panels, menu items or messages; they use whole, subtle borders instead. The three steps and other boxes follow the same paper-like style.
+- `cappv1` is now the only command in the shell. `cappv1 doctor`, `models`, `clean`, `init` and `start` are refused; use `/doctor`, `/models`, `/clean` and the others inside the session. `cappv1 --batch` remains for scripts, plus `--version` and `--help`.
+- `/init` shows the current service and model first and lets you keep it, change only the model, or switch service, instead of asking everything again. `/models` goes straight to the service and model pickers. Both are listed in `/help` and in the `/` menu.
+
+## 1.1.0 - 2026-10-26
+
+### Added
+- Interactive terminal session (`cappv1`, `cappv1 start`, `cappv1 init`): slash commands with completion, arrow-key menus, drag-and-drop of `.pptx` files, and a live run view whose animation follows what is happening (picture, chart, table, diagram, saving).
+- Local, private captioning with Ollama (`PROVIDER=ollama`); nothing leaves the computer, and a remote Ollama address is refused unless explicitly allowed.
+- `/models`: one flow to switch AI service and model, including free and paid OpenRouter vision models with prices (reaches DeepSeek, Google, OpenAI and more).
+- Alt text that authors already wrote is built on, not replaced: short text is improved, adequate text is kept as written. `/run --force` replaces it after confirmation.
+- Edited decks are recognised by content hash and reprocessed; unchanged items reuse saved captions. Unchanged files are reported as already captioned.
+
+### Fixed
+- Resuming after a crash lost the captions of slides finished before the crash.
+- One unreadable progress file stopped the whole run; it is now set aside.
+- Output and progress files are written atomically, so a crash cannot leave a half-written file.
+- An edited deck with the same filename was skipped as "already complete".
+
+### Changed
+- `cappv1 start` opens the interactive session. The old background behavior is `cappv1 start --batch` (also used automatically when there is no terminal).
+
+## 1.0.0 - 2026-10-26 (tag `engine-cappv1-1.0.0`)
+
+- Terminal engine: alt text for pictures, tables, charts, SmartArt and embedded objects; invisible shapes marked decorative; files processed in sequence and resumable.
+- Providers: OpenRouter, OpenAI, Anthropic, and Ollama.

cappv1-1.7.0/CLAUDE.md

@@ -0,0 +1,2 @@
+@git-skills.md
+@docs/scope.md

cappv1-1.7.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,5 @@
+# Code of Conduct
+
+This project follows the [Contributor Covenant, version 2.1](https://www.contributor-covenant.org/version/2/1/code_of_conduct/). In short: be respectful, assume good intent, give and accept feedback graciously, and keep discussion focused on the work. Harassment of any kind isn't tolerated.
+
+To report a concern, contact the maintainer through the repository's GitHub profile. Reports are handled privately.

cappv1-1.7.0/CONTRIBUTING.md

@@ -0,0 +1,7 @@
+# Contributing to cappv1
+
+cappv1 is open source under the [MIT License](LICENSE). Issues and pull requests are welcome.
+
+**The ground rule:** the tool never changes how a slide looks. It writes alt text, plus a short list of visually inert accessibility fixes, and every change must keep that true. Read [`docs/scope.md`](docs/scope.md) first.
+
+Everything else (branches, layers, tests, the Web pages and privacy rule, commits, versions and releases, and what never to commit) is in [`docs/development.md`](docs/development.md). Security problems go to [`SECURITY.md`](SECURITY.md). LLM agents also read `git-skills.md`, which `CLAUDE.md` loads automatically.

cappv1-1.7.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sundar raj sharma
+
+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.