textflowkit 0.1.3__tar.gz → 0.1.4__tar.gz

{textflowkit-0.1.3 → textflowkit-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: textflowkit
-Version: 0.1.3
+Version: 0.1.4
 Summary: Cross-platform media transcription toolkit: URL or file in, timestamped transcripts and subtitle files out.
 Project-URL: Homepage, https://github.com/scottconverse/textflowkit
 Project-URL: Issues, https://github.com/scottconverse/textflowkit/issues
@@ -50,9 +50,14 @@ Description-Content-Type: text/markdown
 
 Cross-platform media transcription toolkit. **One core, one CLI, thin adapters.**
 
-[Project landing page](https://scottconverse.github.io/textflowkit/) ·
+[Project landing page](https://www.textflowkit.org/) ·
+[PyPI package](https://pypi.org/project/textflowkit/) ·
 [GitHub releases](https://github.com/scottconverse/textflowkit/releases)
 
+The [static site deployment](https://github.com/scottconverse/textflowkit/blob/main/docs/site-deployment.md) is hosted on Cloudflare
+Pages. GitHub remains the source and CI host; the website does not run the
+transcription engine.
+
 Paste a URL or point at a file; get timestamped transcripts and subtitle files back.
 Built as a reusable primitive for developers — designed to sit under multiple
 products, AI harnesses, and agents.
@@ -63,12 +68,12 @@ products, AI harnesses, and agents.
 >
 > **This 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. See [LICENSE](LICENSE) (Apache-2.0,
+> FOR A PARTICULAR PURPOSE, and NONINFRINGEMENT. See [LICENSE](https://github.com/scottconverse/textflowkit/blob/main/LICENSE) (Apache-2.0,
 > §7–8) for the full disclaimer and limitation of liability.
 >
 > **You are responsible for what you transcribe.** textflowkit can fetch media from
 > third-party platforms. Copyright, terms-of-service, and privacy obligations for any
-> media you choose to process are **yours alone**. See [LEGAL.md](LEGAL.md).
+> media you choose to process are **yours alone**. See [LEGAL.md](https://github.com/scottconverse/textflowkit/blob/main/LEGAL.md).
 
 ---
 
@@ -112,39 +117,37 @@ YouTube · TikTok · Facebook · Instagram · Vimeo · Twitch · Bilibili · Rum
 Kick · Zoom · Medal · Loom · Dropbox — plus **direct media URLs and local files**.
 
 All 13 are recognised through `yt-dlp`; only YouTube has an opt-in, maintained
-[live end-to-end smoke](docs/release-checklist.md). It is run on a Windows
+[live end-to-end smoke](https://github.com/scottconverse/textflowkit/blob/main/docs/release-checklist.md). It is run on a Windows
 maintainer machine before a release, not on GitHub-hosted runners or every pull
 request. Local files have also been transcribed live. The other
 12 are not release-verified end to end, and some sources require cookies or
-change their access rules frequently. See [docs/sources.md](docs/sources.md).
+change their access rules frequently. See [docs/sources.md](https://github.com/scottconverse/textflowkit/blob/main/docs/sources.md).
 
 ## Install
 
 Requires **Python ≥ 3.10** and **ffmpeg** on `PATH`.
 
 ```bash
-git clone https://github.com/scottconverse/textflowkit
-cd textflowkit
-pip install -e .
+python -m pip install textflowkit
+textflowkit doctor
 ```
 
-Or install the built wheel from the release page:
+For MCP or the JSON HTTP adapter, install the matching extra:
 
 ```bash
-pip install https://github.com/scottconverse/textflowkit/releases/download/v0.1.3/textflowkit-0.1.3-py3-none-any.whl
+python -m pip install 'textflowkit[mcp]'    # MCP server
+python -m pip install 'textflowkit[http]'   # JSON HTTP API
 ```
 
-Not published to PyPI; the repository and its releases are the distribution path.
-The release page lists each artifact's SHA-256. (Those values are deliberately
-kept out of this file: the README is bundled into the wheel as its description,
-so a hash written here would change the artifact it describes.)
-Optional extras:
+**AMD ROCm on native Windows:** do not use the generic command in an environment
+with a working ROCm PyTorch install. Ordinary dependency resolution can replace
+that torch build. Follow the [ROCm install notes](https://github.com/scottconverse/textflowkit/blob/main/docs/install.md)
+to preserve it.
 
-```bash
-pip install -e ".[mcp]"    # MCP server adapter
-pip install -e ".[http]"   # HTTP API adapter
-pip install -e ".[dev]"    # tests + linter
-```
+The same version's wheel and source archive are also on the
+[GitHub release page](https://github.com/scottconverse/textflowkit/releases/latest).
+The release lists their SHA-256 hashes. For editable source development, see
+[CONTRIBUTING.md](https://github.com/scottconverse/textflowkit/blob/main/CONTRIBUTING.md).
 
 ## Usage
 
@@ -187,7 +190,7 @@ textflowkit export ./transcript.json --format vtt
 ## Use as an MCP server
 
 ```bash
-pip install -e ".[mcp]"
+python -m pip install 'textflowkit[mcp]'
 textflowkit-mcp                                  # stdio
 textflowkit-mcp --transport http --port 8766     # Streamable HTTP
 ```
@@ -214,12 +217,12 @@ These checks are not end-to-end transcription runs driven by each harness:
 There is also a protocol test that launches the server as a real subprocess and
 speaks newline-delimited JSON-RPC over stdio, so the entry point, framing, and
 version negotiation are covered on every CI run (`tests/test_stdio_protocol.py`).
-See [docs/adapters.md](docs/adapters.md) for per-harness configuration.
+See [docs/adapters.md](https://github.com/scottconverse/textflowkit/blob/main/docs/adapters.md) for per-harness configuration.
 
 ## Use as an HTTP API
 
 ```bash
-pip install -e ".[http]"
+python -m pip install 'textflowkit[http]'
 textflowkit-http --port 8767
 ```
 
@@ -227,7 +230,7 @@ Submit a job, poll it, fetch the transcript. Developer mode is unauthenticated
 and defaults to localhost. The opt-in JSON HTTP production profile requires a
 Bearer token, explicit roots, durable SQLite jobs, and request/rate/media/output
 limits; URL input additionally requires an SSRF-filtering egress proxy. See
-[adapter deployment details](docs/adapters.md#developer-mode-and-production-profile).
+[adapter deployment details](https://github.com/scottconverse/textflowkit/blob/main/docs/adapters.md#developer-mode-and-production-profile).
 
 ## Durable, bounded, cancellable
 
@@ -237,7 +240,7 @@ TEXTFLOWKIT_MAX_CONCURRENCY=1        # default; Whisper saturates a GPU alone
 ```
 
 `cancel_job` stops a queued job immediately, or a running job at its next stage
-boundary. See [docs/adapters.md](docs/adapters.md).
+boundary. See [docs/adapters.md](https://github.com/scottconverse/textflowkit/blob/main/docs/adapters.md).
 
 ## Long jobs never block
 
@@ -248,19 +251,19 @@ web frontend share the job contract without blocking a request.
 
 ## Status
 
-**v0.1.3 release.** Core, CLI, MCP, and HTTP have automated
+**v0.1.4 release.** Core, CLI, MCP, and HTTP have automated
 coverage; Windows-native ROCm and a dated local Windows YouTube run were verified.
 The GitHub-hosted YouTube attempt was blocked by a bot challenge, so hosted
 live transcription is not verified.
 This does not imply that all 13 platforms or every harness workflow has been
-tested end to end. See [docs/roadmap.md](docs/roadmap.md).
+tested end to end. See [docs/roadmap.md](https://github.com/scottconverse/textflowkit/blob/main/docs/roadmap.md).
 
 ## License
 
-Apache-2.0 — see [LICENSE](LICENSE). Includes an explicit patent grant and a
+Apache-2.0 — see [LICENSE](https://github.com/scottconverse/textflowkit/blob/main/LICENSE). Includes an explicit patent grant and a
 limitation of liability.
 
 ## Contributing
 
-Issues and PRs welcome. Please read [LEGAL.md](LEGAL.md) before adding a source
+Issues and PRs welcome. Please read [LEGAL.md](https://github.com/scottconverse/textflowkit/blob/main/LEGAL.md) before adding a source
 adapter.

{textflowkit-0.1.3 → textflowkit-0.1.4}/README.md

@@ -2,9 +2,14 @@
 
 Cross-platform media transcription toolkit. **One core, one CLI, thin adapters.**
 
-[Project landing page](https://scottconverse.github.io/textflowkit/) ·
+[Project landing page](https://www.textflowkit.org/) ·
+[PyPI package](https://pypi.org/project/textflowkit/) ·
 [GitHub releases](https://github.com/scottconverse/textflowkit/releases)
 
+The [static site deployment](https://github.com/scottconverse/textflowkit/blob/main/docs/site-deployment.md) is hosted on Cloudflare
+Pages. GitHub remains the source and CI host; the website does not run the
+transcription engine.
+
 Paste a URL or point at a file; get timestamped transcripts and subtitle files back.
 Built as a reusable primitive for developers — designed to sit under multiple
 products, AI harnesses, and agents.
@@ -15,12 +20,12 @@ products, AI harnesses, and agents.
 >
 > **This 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. See [LICENSE](LICENSE) (Apache-2.0,
+> FOR A PARTICULAR PURPOSE, and NONINFRINGEMENT. See [LICENSE](https://github.com/scottconverse/textflowkit/blob/main/LICENSE) (Apache-2.0,
 > §7–8) for the full disclaimer and limitation of liability.
 >
 > **You are responsible for what you transcribe.** textflowkit can fetch media from
 > third-party platforms. Copyright, terms-of-service, and privacy obligations for any
-> media you choose to process are **yours alone**. See [LEGAL.md](LEGAL.md).
+> media you choose to process are **yours alone**. See [LEGAL.md](https://github.com/scottconverse/textflowkit/blob/main/LEGAL.md).
 
 ---
 
@@ -64,39 +69,37 @@ YouTube · TikTok · Facebook · Instagram · Vimeo · Twitch · Bilibili · Rum
 Kick · Zoom · Medal · Loom · Dropbox — plus **direct media URLs and local files**.
 
 All 13 are recognised through `yt-dlp`; only YouTube has an opt-in, maintained
-[live end-to-end smoke](docs/release-checklist.md). It is run on a Windows
+[live end-to-end smoke](https://github.com/scottconverse/textflowkit/blob/main/docs/release-checklist.md). It is run on a Windows
 maintainer machine before a release, not on GitHub-hosted runners or every pull
 request. Local files have also been transcribed live. The other
 12 are not release-verified end to end, and some sources require cookies or
-change their access rules frequently. See [docs/sources.md](docs/sources.md).
+change their access rules frequently. See [docs/sources.md](https://github.com/scottconverse/textflowkit/blob/main/docs/sources.md).
 
 ## Install
 
 Requires **Python ≥ 3.10** and **ffmpeg** on `PATH`.
 
 ```bash
-git clone https://github.com/scottconverse/textflowkit
-cd textflowkit
-pip install -e .
+python -m pip install textflowkit
+textflowkit doctor
 ```
 
-Or install the built wheel from the release page:
+For MCP or the JSON HTTP adapter, install the matching extra:
 
 ```bash
-pip install https://github.com/scottconverse/textflowkit/releases/download/v0.1.3/textflowkit-0.1.3-py3-none-any.whl
+python -m pip install 'textflowkit[mcp]'    # MCP server
+python -m pip install 'textflowkit[http]'   # JSON HTTP API
 ```
 
-Not published to PyPI; the repository and its releases are the distribution path.
-The release page lists each artifact's SHA-256. (Those values are deliberately
-kept out of this file: the README is bundled into the wheel as its description,
-so a hash written here would change the artifact it describes.)
-Optional extras:
+**AMD ROCm on native Windows:** do not use the generic command in an environment
+with a working ROCm PyTorch install. Ordinary dependency resolution can replace
+that torch build. Follow the [ROCm install notes](https://github.com/scottconverse/textflowkit/blob/main/docs/install.md)
+to preserve it.
 
-```bash
-pip install -e ".[mcp]"    # MCP server adapter
-pip install -e ".[http]"   # HTTP API adapter
-pip install -e ".[dev]"    # tests + linter
-```
+The same version's wheel and source archive are also on the
+[GitHub release page](https://github.com/scottconverse/textflowkit/releases/latest).
+The release lists their SHA-256 hashes. For editable source development, see
+[CONTRIBUTING.md](https://github.com/scottconverse/textflowkit/blob/main/CONTRIBUTING.md).
 
 ## Usage
 
@@ -139,7 +142,7 @@ textflowkit export ./transcript.json --format vtt
 ## Use as an MCP server
 
 ```bash
-pip install -e ".[mcp]"
+python -m pip install 'textflowkit[mcp]'
 textflowkit-mcp                                  # stdio
 textflowkit-mcp --transport http --port 8766     # Streamable HTTP
 ```
@@ -166,12 +169,12 @@ These checks are not end-to-end transcription runs driven by each harness:
 There is also a protocol test that launches the server as a real subprocess and
 speaks newline-delimited JSON-RPC over stdio, so the entry point, framing, and
 version negotiation are covered on every CI run (`tests/test_stdio_protocol.py`).
-See [docs/adapters.md](docs/adapters.md) for per-harness configuration.
+See [docs/adapters.md](https://github.com/scottconverse/textflowkit/blob/main/docs/adapters.md) for per-harness configuration.
 
 ## Use as an HTTP API
 
 ```bash
-pip install -e ".[http]"
+python -m pip install 'textflowkit[http]'
 textflowkit-http --port 8767
 ```
 
@@ -179,7 +182,7 @@ Submit a job, poll it, fetch the transcript. Developer mode is unauthenticated
 and defaults to localhost. The opt-in JSON HTTP production profile requires a
 Bearer token, explicit roots, durable SQLite jobs, and request/rate/media/output
 limits; URL input additionally requires an SSRF-filtering egress proxy. See
-[adapter deployment details](docs/adapters.md#developer-mode-and-production-profile).
+[adapter deployment details](https://github.com/scottconverse/textflowkit/blob/main/docs/adapters.md#developer-mode-and-production-profile).
 
 ## Durable, bounded, cancellable
 
@@ -189,7 +192,7 @@ TEXTFLOWKIT_MAX_CONCURRENCY=1        # default; Whisper saturates a GPU alone
 ```
 
 `cancel_job` stops a queued job immediately, or a running job at its next stage
-boundary. See [docs/adapters.md](docs/adapters.md).
+boundary. See [docs/adapters.md](https://github.com/scottconverse/textflowkit/blob/main/docs/adapters.md).
 
 ## Long jobs never block
 
@@ -200,19 +203,19 @@ web frontend share the job contract without blocking a request.
 
 ## Status
 
-**v0.1.3 release.** Core, CLI, MCP, and HTTP have automated
+**v0.1.4 release.** Core, CLI, MCP, and HTTP have automated
 coverage; Windows-native ROCm and a dated local Windows YouTube run were verified.
 The GitHub-hosted YouTube attempt was blocked by a bot challenge, so hosted
 live transcription is not verified.
 This does not imply that all 13 platforms or every harness workflow has been
-tested end to end. See [docs/roadmap.md](docs/roadmap.md).
+tested end to end. See [docs/roadmap.md](https://github.com/scottconverse/textflowkit/blob/main/docs/roadmap.md).
 
 ## License
 
-Apache-2.0 — see [LICENSE](LICENSE). Includes an explicit patent grant and a
+Apache-2.0 — see [LICENSE](https://github.com/scottconverse/textflowkit/blob/main/LICENSE). Includes an explicit patent grant and a
 limitation of liability.
 
 ## Contributing
 
-Issues and PRs welcome. Please read [LEGAL.md](LEGAL.md) before adding a source
+Issues and PRs welcome. Please read [LEGAL.md](https://github.com/scottconverse/textflowkit/blob/main/LEGAL.md) before adding a source
 adapter.

{textflowkit-0.1.3 → textflowkit-0.1.4}/SECURITY.md

@@ -13,7 +13,7 @@ you expected.
 
 | Version | Security-fix policy |
 |---|---|
-| Latest published release tag (currently `v0.1.3`) | Receives fixes through the next patch release |
+| Latest published release tag (see [GitHub releases](https://github.com/scottconverse/textflowkit/releases)) | Receives fixes through the next patch release |
 | Earlier release tags, including earlier `0.1.x` tags | No backports |
 | Unreleased `main` commits | Development only; not a supported release |
 

{textflowkit-0.1.3 → textflowkit-0.1.4}/docs/adapters.md

@@ -78,7 +78,7 @@ targeting an existing entry and fails with `patch: entry "<id>" not found`.
 ## MCP (for AI harnesses)
 
 ```bash
-pip install -e ".[mcp]"
+python -m pip install 'textflowkit[mcp]'
 textflowkit-mcp                      # stdio (default)
 textflowkit-mcp --transport http --host 127.0.0.1 --port 8766
 ```
@@ -123,7 +123,7 @@ OpenCode (`opencode.json`):
 ## HTTP (for software products and web frontends)
 
 ```bash
-pip install -e ".[http]"
+python -m pip install 'textflowkit[http]'
 textflowkit-http --host 127.0.0.1 --port 8767
 ```
 
@@ -254,7 +254,7 @@ Binary formats cannot be returned inline, and asking for one that way returns a
 clear message rather than failing deeper down.
 
 ```bash
-pip install -e ".[export]"        # python-docx + reportlab
+python -m pip install 'textflowkit[export]'  # python-docx + reportlab
 curl -X POST "http://127.0.0.1:8767/jobs/$ID/export?formats=docx&formats=pdf"
 ```
 

{textflowkit-0.1.3 → textflowkit-0.1.4}/docs/index.html

@@ -8,8 +8,8 @@
   <meta property="og:type" content="website">
   <meta property="og:title" content="TextFlowKit — media in, useful text out">
   <meta property="og:description" content="An open-source transcription toolkit with one core and three ways in: CLI, MCP, and HTTP.">
-  <meta property="og:url" content="https://scottconverse.github.io/textflowkit/">
-  <link rel="canonical" href="https://scottconverse.github.io/textflowkit/">
+  <meta property="og:url" content="https://www.textflowkit.org/">
+  <link rel="canonical" href="https://www.textflowkit.org/">
   <title>TextFlowKit — media in, useful text out</title>
   <style>
     :root {
@@ -189,7 +189,7 @@
         <p class="lead">Transcribe video and audio into timestamped, searchable text. One shared core for your command line, AI harness, and application.</p>
         <div class="actions">
           <a class="button primary" href="#install">Get started <span aria-hidden="true">&nbsp;→</span></a>
-          <a class="button secondary" href="https://github.com/scottconverse/textflowkit/releases/latest">Latest release <span aria-hidden="true">&nbsp;↗</span></a>
+          <a class="button secondary" href="https://pypi.org/project/textflowkit/">Install from PyPI <span aria-hidden="true">&nbsp;↗</span></a>
         </div>
         <p class="micro">Self-hosted toolkit · Native Windows, macOS, Linux · No account required</p>
       </div>
@@ -265,7 +265,7 @@
       <div>
         <span class="kicker">Start building</span>
         <h2 id="install-title">Bring your own media. Keep your workflow.</h2>
-        <p>Python 3.10+ and ffmpeg are the starting point. The repository is the home for install notes, integration examples, and releases.</p>
+        <p>Python 3.10+ and ffmpeg are the starting point. Install from PyPI; the repository has GPU-specific notes, integration examples, and releases.</p>
         <ul>
           <li>Run locally on Windows without WSL, or on macOS and Linux.</li>
           <li>Use durable SQLite jobs and bounded concurrency when you need them.</li>
@@ -274,9 +274,7 @@
         <a class="button secondary" href="https://github.com/scottconverse/textflowkit/blob/main/docs/install.md">Read install guide ↗</a>
       </div>
       <div>
-        <pre class="codebox"><span class="prompt">$</span> git clone https://github.com/scottconverse/textflowkit
-<span class="prompt">$</span> cd textflowkit
-<span class="prompt">$</span> python -m pip install -e ".[mcp,http]"
+        <pre class="codebox"><span class="prompt">$</span> python -m pip install 'textflowkit[mcp,http]'
 <span class="prompt">$</span> textflowkit doctor</pre>
         <p class="note">For a GPU-specific or Windows-native ROCm setup, follow the <a href="https://github.com/scottconverse/textflowkit/blob/main/docs/install.md">install guide</a> instead of using this generic CPU-oriented quickstart.</p>
       </div>
@@ -296,6 +294,7 @@
       <div class="footer-links" aria-label="Project links">
         <a href="https://github.com/scottconverse/textflowkit">Repository</a>
         <a href="https://github.com/scottconverse/textflowkit/releases/latest">Releases</a>
+        <a href="https://pypi.org/project/textflowkit/">PyPI</a>
         <a href="https://github.com/scottconverse/textflowkit/issues">Issues</a>
         <a href="https://github.com/scottconverse/textflowkit/blob/main/LICENSE">License</a>
       </div>

{textflowkit-0.1.3 → textflowkit-0.1.4}/docs/install.md

@@ -6,6 +6,11 @@
 - **ffmpeg** on `PATH` (ffprobe comes with it)
 - **yt-dlp** — installed as a dependency
 
+For a standard CPU or NVIDIA environment, install from
+[PyPI](https://pypi.org/project/textflowkit/) with
+`python -m pip install textflowkit`. For an existing AMD ROCm environment,
+follow the instructions below instead of allowing pip to replace your torch.
+
 ## AMD GPU support (ROCm) — no WSL required
 
 textflowkit runs natively on Windows. On AMD hardware, GPU acceleration comes from a
@@ -28,9 +33,10 @@ distribution for the target architecture.
 will happily replace a working ROCm torch with a stock PyPI CPU wheel, silently
 disabling GPU acceleration.
 
-Install the engine **without** letting it resolve torch:
+Install textflowkit and the engine **without** letting either resolve torch:
 
 ```bash
+pip install textflowkit --no-deps
 pip install openai-whisper yt-dlp --no-deps
 pip install tiktoken more-itertools tqdm numba
 ```
@@ -230,4 +236,3 @@ how many segments were labelled. If the backend or token is missing, the run
 With no GPU, the engine selects CPU automatically. Pass `--device cpu` to force it.
 CPU transcription is dramatically slower; prefer a smaller `--model`.
 
-

{textflowkit-0.1.3 → textflowkit-0.1.4}/docs/release-checklist.md

@@ -48,3 +48,16 @@ neither result verifies the other 12 recognized sites.
 
 The script deletes its temporary media and transcript after producing the
 receipt. It does not upload cookies, media, or transcripts to GitHub.
+
+## PyPI publication
+
+If this release is also published to PyPI, upload the **same** verified wheel
+and source archive as the GitHub release. Check package metadata before upload,
+then compare both PyPI SHA-256 digests with the GitHub release assets. Finally,
+install that exact version from the public PyPI index in a clean environment
+and smoke the CLI entry point. An install with `--no-deps` proves distribution
+and entry-point wiring only; it does not prove a full transcription run.
+
+Never place an API token in this repository, a CI log, or a shell command line.
+An upload is a separate public release action; passing CI alone does not
+authorize it.

{textflowkit-0.1.3 → textflowkit-0.1.4}/docs/roadmap.md

@@ -57,6 +57,23 @@
 - [x] Correct the default input/output path-confinement documentation
 - [x] Update pinned CI checkout and Python setup actions and verify the combined matrix
 
+## Website hosting
+
+- [x] Move the static landing page to Cloudflare Pages Free, connected to the
+  GitHub `main` branch with `docs/` as the site root
+- [x] Serve `www.textflowkit.org` over HTTPS and redirect the apex domain to it
+
+See [site deployment](site-deployment.md) for the hosting configuration. This
+static page is documentation and a product landing page, not a hosted
+transcription service.
+
+## Package distribution
+
+- [x] Publish the verified v0.1.3 wheel and source archive on PyPI
+- [x] Prepare v0.1.4 with a PyPI-first package description and install guide
+- [x] Make PyPI the default developer install path while keeping GitHub
+  releases and the native-Windows ROCm dependency instructions
+
 The 13 listed media platforms are recognised through `yt-dlp`; **only YouTube**
 has an opt-in [live URL transcription release gate](release-checklist.md), not
 a deterministic pull-request job. The release gate runs locally on Windows,

textflowkit-0.1.4/docs/site-deployment.md

@@ -0,0 +1,34 @@
+# Static website deployment
+
+The [TextFlowKit landing page](https://www.textflowkit.org/) is the static
+`docs/index.html` file. It does **not** run the CLI, MCP server, HTTP adapter,
+or speech models. A public transcription service is a separate, future
+deployment with its own security and capacity design.
+
+## Cloudflare Pages configuration
+
+- Plan: Cloudflare Pages Free.
+- Project: `textflowkit`.
+- Source: GitHub repository `scottconverse/textflowkit`, production branch
+  `main`. The Cloudflare Workers and Pages GitHub App is scoped to this
+  repository only.
+- Root directory: `docs`.
+- Build command: `exit 0` (the page is already static HTML).
+- Build output directory: `.` (relative to `docs`).
+- Environment variable: `SKIP_DEPENDENCY_INSTALL=1`. This prevents Pages
+  from trying to install the repository's Python transcription dependencies.
+- Pages preview address: <https://textflowkit.pages.dev/>.
+- Custom domains: `www.textflowkit.org` and `textflowkit.org`. Cloudflare DNS
+  has proxied CNAMEs for both to `textflowkit.pages.dev`.
+- Canonical URL: `https://www.textflowkit.org/`. A Cloudflare Single Redirect
+  named `Canonical apex to www` sends HTTPS apex requests there with status
+  301, preserving path and query string. Cloudflare's HTTP-to-HTTPS redirect
+  handles HTTP requests before this rule.
+
+Merging a change to `main` under `docs/` triggers a new Pages deployment.
+Check the Pages deployment status and verify the public site over HTTPS after
+each website change. GitHub CI remains the deterministic code/test gate;
+Cloudflare Pages is only the static website host.
+
+The former GitHub Pages `docs/CNAME` file is intentionally absent. Do not
+recreate it: domain routing now lives in Cloudflare, not GitHub Pages.

{textflowkit-0.1.3 → textflowkit-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "textflowkit"
-version = "0.1.3"
+version = "0.1.4"
 description = "Cross-platform media transcription toolkit: URL or file in, timestamped transcripts and subtitle files out."
 readme = "README.md"
 requires-python = ">=3.10"

{textflowkit-0.1.3 → textflowkit-0.1.4}/src/textflowkit/__init__.py

@@ -3,6 +3,6 @@
 from textflowkit.core.model import Segment, Transcript
 from textflowkit.core.pipeline import PipelineError, transcribe
 
-__version__ = "0.1.3"
+__version__ = "0.1.4"
 
 __all__ = ["PipelineError", "Segment", "Transcript", "__version__", "transcribe"]