typefully-cli 0.1.0__tar.gz → 0.3.0__tar.gz

typefully_cli-0.3.0/.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

{typefully_cli-0.1.0 → typefully_cli-0.3.0}/.github/workflows/ci.yml

@@ -8,16 +8,16 @@ on:
 
 jobs:
   test:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04  # Python 3.9 remains supported; avoid ubuntu-latest image drift.
     strategy:
       matrix:
         python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
           python-version: ${{ matrix.python-version }}
 
@@ -25,7 +25,7 @@ jobs:
         run: pip install -e ".[dev]"
 
       - name: Lint
-        run: ruff check src/ tests/
+        run: ruff check --isolated --select E4,E7,E9,F --target-version py39 --line-length 100 src/ tests/ scripts/
 
       - name: Test
         run: python -m pytest tests/ -v

typefully_cli-0.3.0/.github/workflows/monitor.yml

@@ -0,0 +1,72 @@
+name: Monitor Typefully API & Competitors
+
+on:
+  schedule:
+    - cron: "0 8 * * 1,4"  # Mon & Thu 8am UTC (1:30pm IST)
+  workflow_dispatch: {}
+
+concurrency:
+  group: typefully-upstream-monitor
+  cancel-in-progress: false
+
+permissions:
+  issues: write
+  contents: read
+
+jobs:
+  monitor:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
+
+      - name: Restore cache
+        uses: actions/cache/restore@27d5ce7f107fe9357f9df03efb73ab90386fccae  # v5.0.5
+        with:
+          path: .monitor-cache
+          key: monitor-cache-${{ github.run_id }}
+          restore-keys: monitor-cache-
+
+      - name: Fetch and validate public upstream sources
+        run: python3 scripts/monitor.py
+
+      - name: Report changes or degraded monitoring
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          python3 - <<'PYTHON'
+          import json
+          import subprocess
+          from pathlib import Path
+
+          cache = Path(".monitor-cache")
+          result = json.loads((cache / "result.json").read_text())
+          if result["report_needed"]:
+              # A stable title deduplicates the same unresolved change/failure.
+              issues = json.loads(subprocess.check_output([
+                  "gh", "issue", "list", "--state", "open", "--search",
+                  result["fingerprint"] + " in:title",
+                  "--json", "title", "--limit", "100",
+              ], text=True))
+              if not any(issue["title"] == result["title"] for issue in issues):
+                  subprocess.run([
+                      "gh", "issue", "create", "--title", result["title"],
+                      "--body-file", str(cache / "report.md"),
+                  ], check=True)
+          subprocess.run(["python3", "scripts/monitor.py", "--commit"], check=True)
+          PYTHON
+
+      - name: Save cache
+        uses: actions/cache/save@27d5ce7f107fe9357f9df03efb73ab90386fccae  # v5.0.5
+        with:
+          path: .monitor-cache
+          key: monitor-cache-${{ github.run_id }}
+
+      - name: Fail visibly on degraded monitoring
+        run: |
+          python3 - <<'PYTHON'
+          import json
+          from pathlib import Path
+          result = json.loads(Path(".monitor-cache/result.json").read_text())
+          if result["failed"]:
+              raise SystemExit("Upstream fetch failed; see monitoring issue and result.json")
+          PYTHON

typefully_cli-0.3.0/.github/workflows/publish.yml

@@ -0,0 +1,28 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # trusted publishing
+
+    steps:
+      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0  # v7.0.0
+
+      - name: Set up Python
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33  # v1.14.2

{typefully_cli-0.1.0 → typefully_cli-0.3.0}/.gitignore

@@ -10,4 +10,6 @@ venv/
 .env
 .ruff_cache/
 .pytest_cache/
+.coverage
 .mypy_cache/
+.gstack/

{typefully_cli-0.1.0 → typefully_cli-0.3.0}/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.3.0 (2026-10-29)
+
+- Add schema-backed `draft-payload` request-file input with offline validation, per-post fields and null/false clearing; keep `--json` as output-only.
+- Add X reply/subscriber/community flags, LinkedIn first-comment/reshare fields, upload alt text and media metadata updates.
+- Follow social-set pagination, accept repeated tag filters and reject negative offsets; document every public API operation and unverified MCP/product-only boundaries.
+
+
+- Repair upstream monitoring: validate official public sources, expose fetch failures, deduplicate reports, and advance baselines only after successful reporting.
+- Pin CI to Ubuntu 22.04 to retain Python 3.9 compatibility; isolate Fish completion tests from the real home directory.
+- Extend `--quote-post-url` / `--qrt` to the documented Threads, Bluesky, Mastodon and Substack quote targets.
+
+## 0.2.1 (2026-08-21)
+
+- Fix trusted PyPI publishing workflow action pin.
+
+## 0.2.0 (2026-08-21)
+
+Sync with Typefully's official MCP and Agent Skill surface.
+
+- Add X follower analytics with `followers`.
+- Add planned drafts with `draft --plan`, `update --plan`, and `plan`.
+- Add review comment threads: list, create, reply, resolve, update, delete.
+- Add comment-marker-safe reads and updates.
+- Add Substack Notes, X Articles, platform selection, link-preview suppression, X disclosures, and official quote-post payload fields.
+- Add multi-platform draft/thread creation through `--platform`.
+
 ## 0.1.0 (2026-03-26)
 
 Initial release.

{typefully_cli-0.1.0 → typefully_cli-0.3.0}/CLAUDE.md

@@ -2,14 +2,17 @@
 
 ## Overview
 
-Python CLI wrapping the Typefully API v2. Agent-first design: JSON output by default, structured errors on stderr, deterministic behavior. 17 Click commands for drafts, threads, batch, media, tags, accounts, config.
+Python CLI wrapping the Typefully API v2. Agent-friendly structured JSON output with `--json`, structured errors on stderr, and configurable text output. See `skills/typefully-cli/SKILL.md` for current agent usage and `docs/upstream-parity.md` for evidence and limitations.
 
 ## Architecture
 
 ```
 src/typefully_cli/
-  cli.py        -- 17 Click commands, shared options, error handler, payload builder
+  cli.py        -- Click commands, shared options, error handler, payload builder
+  payloads.py   -- Explicit JSON request input, local schema validation, media metadata
+  request-schemas.json -- Reviewed public create/update schema snapshot
   client.py     -- httpx wrapper over Typefully API v2 (rate-limited, account resolution)
+  completions.py -- Shell completions install/show (bash/zsh/fish)
   auth.py       -- API key resolution chain: flag > env > config > 1Password
   config.py     -- TOML config at ~/.config/typefully/config.toml
   console.py    -- stderr output (status, warnings, errors) via Rich
@@ -23,9 +26,12 @@ src/typefully_cli/
 
 - **Output contract:** Success -> `{"ok": true, "data": ...}` on stdout. Errors -> `{"ok": false, "error": {...}}` on stderr. Exit codes: 0 success, 1 input/auth, 2 API, 3 partial failure.
 - **Rich markup safety:** All user/API text in output.py is wrapped with `_esc()` (rich.markup.escape) before printing. Never pass raw API content to `_console.print()`.
-- **Input validation:** Dates via `_validate_date()`, limits via `_validate_limit()`, both raise `TypefullyError(code="invalid_input")` which exits 1.
+- **Input validation:** Dates via `_validate_date()`, limits via `_validate_limit()`, timezones via `_validate_timezone()`, platforms via `_validate_platforms()`. All raise on invalid input with exit 1.
+- **Default platforms:** Config `default_platforms` (e.g. `x,linkedin`) auto-applied on `draft`/`thread` when no platform flags passed. Explicit flags override defaults.
+- **Timezone conversion:** Config `timezone` (IANA name) converts naive schedule datetimes to UTC before API call. Already-tz-aware values pass through unchanged.
 - **Partial failure:** Delete and batch loops catch per-item errors. `_handle_multi_result()` handles the 3-branch contract (all succeed / partial / all fail).
 - **Error sanitization:** `APIError.user_message` property strips raw upstream bodies from stdout payloads. Full details stay on stderr.
+- **API parity:** Map each public operation in docs/upstream-parity.md. Do not claim exhaustive MCP parity; analytics and legacy convenience fields are not verified by the current public schema.
 
 ## Dev setup
 
@@ -37,17 +43,15 @@ pip install -e ".[dev]"
 
 ```bash
 python3 -m pytest tests/ -v
-ruff check src/ tests/
+ruff check --isolated --select E4,E7,E9,F --target-version py39 --line-length 100 src/ tests/ scripts/
 ```
 
 ## Auth for live testing
 
-Config at `~/.config/typefully/config.toml`. Test account: BungeeCEO.
-
-```bash
-typefully config set api_key tf_...
-typefully config set default_account BungeeCEO
-```
+Use existing authorized access from environment/config; never assume an account
+named in documentation is a sandbox. No cloud credential is bundled with this repo.
+Use local `--validate-only` and mocked tests first. Live test writes need explicit
+scope and a verified social set; never publish as part of maintenance tests.
 
 ## Conventions
 

typefully_cli-0.3.0/Formula/README.md

@@ -0,0 +1,40 @@
+# Homebrew Formula for typefully-cli
+
+This directory contains the Homebrew formula, staged here before moving to a dedicated tap repo.
+
+## Setup the tap
+
+1. Create a repo named `homebrew-tap` under `dheeraj-shah` (or your preferred GitHub org).
+2. Copy `Formula/typefully-cli.rb` into that repo at `Formula/typefully-cli.rb`.
+3. Push to GitHub.
+
+## Install
+
+```bash
+brew tap dheeraj-shah/tap
+brew install typefully-cli
+```
+
+## Filling in resource hashes
+
+The formula has `TODO` placeholders for sha256 hashes. To fill them in:
+
+```bash
+pip install homebrew-pypi-poet
+poet typefully-cli
+```
+
+Paste the output over the existing resource blocks. Then validate:
+
+```bash
+brew audit --new typefully-cli
+brew install --build-from-source typefully-cli
+brew test typefully-cli
+```
+
+## Updating to a new version
+
+1. Bump the `url` in the formula to the new PyPI tarball URL.
+2. Update the top-level `sha256` with the new tarball hash.
+3. Re-run `poet typefully-cli` to check if any dependency versions changed. Update resource blocks as needed.
+4. Run `brew audit` and `brew test` to verify.

typefully_cli-0.3.0/Formula/typefully-cli.rb

@@ -0,0 +1,84 @@
+class TypefullyCli < Formula
+  include Language::Python::Virtualenv
+
+  desc "CLI for the Typefully API - draft, schedule, and publish social media posts"
+  homepage "https://github.com/nicedevelopers/typefully-cli"
+  url "https://files.pythonhosted.org/packages/c3/6d/d96bd1a794e8819c9c048cd1eccb86ba06d361ae5b60c82f3277a737775b/typefully_cli-0.1.0.tar.gz"
+  sha256 "c8344f6c527f4e2028604f966409d0368e6f3f626f0fa6cadfce71fbf270ca94"
+  license "MIT"
+
+  depends_on "python@3.13"
+
+  resource "anyio" do
+    url "https://files.pythonhosted.org/packages/19/14/2c5dd9f512b66549ae92767a9c7b330ae88e1932ca57876909410251fe13/anyio-4.13.0.tar.gz"
+    sha256 "334b70e641fd2221c1505b3890c69882fe4a2df910cba14d97019b90b24439dc"
+  end
+
+  resource "certifi" do
+    url "https://files.pythonhosted.org/packages/af/2d/7bf41579a8986e348fa033a31cdd0e4121114f6bce2457e8876010b092dd/certifi-2026.2.25.tar.gz"
+    sha256 "e887ab5cee78ea814d3472169153c2d12cd43b14bd03329a39a9c6e2e80bfba7"
+  end
+
+  resource "click" do
+    url "https://files.pythonhosted.org/packages/3d/fa/656b739db8587d7b5dfa22e22ed02566950fbfbcdc20311993483657a5c0/click-8.3.1.tar.gz"
+    sha256 "12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a"
+  end
+
+  resource "h11" do
+    url "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz"
+    sha256 "4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1"
+  end
+
+  resource "httpcore" do
+    url "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz"
+    sha256 "6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8"
+  end
+
+  resource "httpx" do
+    url "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz"
+    sha256 "75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc"
+  end
+
+  resource "idna" do
+    url "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz"
+    sha256 "795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902"
+  end
+
+  resource "markdown-it-py" do
+    url "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz"
+    sha256 "cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3"
+  end
+
+  resource "mdurl" do
+    url "https://files.pythonhosted.org/packages/d6/54/cfe61301667036ec958cb99bd3efefba235e65cdeb9c84d24a8293ba1d90/mdurl-0.1.2.tar.gz"
+    sha256 "bb413d29f5eea38f31dd4754dd7377d4465116fb207585f97bf925588687c1ba"
+  end
+
+  resource "pygments" do
+    url "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea585a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz"
+    sha256 "636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887"
+  end
+
+  resource "rich" do
+    url "https://files.pythonhosted.org/packages/b3/c6/f3b320c27991c46f43ee9d856302c70dc2d0fb2dba4842ff739d5f46b393/rich-14.3.3.tar.gz"
+    sha256 "b8daa0b9e4eef54dd8cf7c86c03713f53241884e814f4e2f5fb342fe520f639b"
+  end
+
+  resource "sniffio" do
+    url "https://files.pythonhosted.org/packages/a2/87/a6771e1546d97e7e041b6ae58d80074f81b7d5121207425c964ddf5cfdbd/sniffio-1.3.1.tar.gz"
+    sha256 "f4324edc670a0f49750a81b895f35c3adb843cca46f0530f79fc1babb23789dc"
+  end
+
+  resource "typing-extensions" do
+    url "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz"
+    sha256 "0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466"
+  end
+
+  def install
+    virtualenv_install_with_resources
+  end
+
+  test do
+    assert_match "typefully, version", shell_output("#{bin}/typefully --version")
+  end
+end