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

typefully_cli-0.2.1/.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.2.1}/.github/workflows/ci.yml

@@ -14,10 +14,10 @@ jobs:
         python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
 
       - 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 }}
 

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

@@ -0,0 +1,141 @@
+name: Monitor Typefully API & Competitors
+
+on:
+  schedule:
+    - cron: "0 8 * * 1,4"  # Mon & Thu 8am UTC (1:30pm IST)
+  workflow_dispatch: {}
+
+permissions:
+  issues: write
+  contents: read
+
+jobs:
+  monitor:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+
+      - name: Restore cache
+        uses: actions/cache/restore@668228422ae6a00e4ad889ee87cd7109ec5666a7  # v5.0.4
+        with:
+          path: .monitor-cache
+          key: monitor-cache-${{ github.run_id }}
+          restore-keys: monitor-cache-
+
+      - name: Init cache dir
+        run: mkdir -p .monitor-cache
+
+      - name: Fetch OpenAPI spec
+        run: |
+          curl -sf https://api.typefully.com/ -o .monitor-cache/openapi-new.json || true
+          if [ ! -f .monitor-cache/openapi.json ]; then
+            cp .monitor-cache/openapi-new.json .monitor-cache/openapi.json 2>/dev/null || true
+          fi
+
+      - name: Fetch agent-skills source
+        run: |
+          curl -sf https://raw.githubusercontent.com/typefully/agent-skills/main/scripts/typefully.js \
+            -o .monitor-cache/agent-skills-new.js || true
+          if [ ! -f .monitor-cache/agent-skills.js ]; then
+            cp .monitor-cache/agent-skills-new.js .monitor-cache/agent-skills.js 2>/dev/null || true
+          fi
+
+      - name: Fetch MCP tool list
+        run: |
+          curl -sf -X POST https://mcp.typefully.com/mcp \
+            -H "Content-Type: application/json" \
+            -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
+            -o .monitor-cache/mcp-tools-new.json || true
+          if [ ! -f .monitor-cache/mcp-tools.json ]; then
+            cp .monitor-cache/mcp-tools-new.json .monitor-cache/mcp-tools.json 2>/dev/null || true
+          fi
+
+      - name: Fetch npm package version
+        run: |
+          npm view @typefully/agent-skills version 2>/dev/null \
+            > .monitor-cache/npm-version-new.txt || true
+          if [ ! -f .monitor-cache/npm-version.txt ]; then
+            cp .monitor-cache/npm-version-new.txt .monitor-cache/npm-version.txt 2>/dev/null || true
+          fi
+
+      - name: Fetch changelog
+        run: |
+          curl -sf https://typefully.com/blog/changelog \
+            | sha256sum | cut -d' ' -f1 > .monitor-cache/changelog-hash-new.txt || true
+          if [ ! -f .monitor-cache/changelog-hash.txt ]; then
+            cp .monitor-cache/changelog-hash-new.txt .monitor-cache/changelog-hash.txt 2>/dev/null || true
+          fi
+
+      - name: Diff and report
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          changes=""
+
+          # OpenAPI spec
+          if [ -f .monitor-cache/openapi-new.json ] && [ -f .monitor-cache/openapi.json ]; then
+            d=$(diff .monitor-cache/openapi.json .monitor-cache/openapi-new.json || true)
+            if [ -n "$d" ]; then
+              changes="${changes}\n## OpenAPI Spec Changed\n\`\`\`diff\n${d}\n\`\`\`\n"
+            fi
+          fi
+
+          # agent-skills source
+          if [ -f .monitor-cache/agent-skills-new.js ] && [ -f .monitor-cache/agent-skills.js ]; then
+            d=$(diff .monitor-cache/agent-skills.js .monitor-cache/agent-skills-new.js || true)
+            if [ -n "$d" ]; then
+              changes="${changes}\n## agent-skills (typefully.js) Changed\n\`\`\`diff\n${d}\n\`\`\`\n"
+            fi
+          fi
+
+          # MCP tools
+          if [ -f .monitor-cache/mcp-tools-new.json ] && [ -f .monitor-cache/mcp-tools.json ]; then
+            d=$(diff .monitor-cache/mcp-tools.json .monitor-cache/mcp-tools-new.json || true)
+            if [ -n "$d" ]; then
+              changes="${changes}\n## MCP Tool List Changed\n\`\`\`diff\n${d}\n\`\`\`\n"
+            fi
+          fi
+
+          # npm version
+          if [ -f .monitor-cache/npm-version-new.txt ] && [ -f .monitor-cache/npm-version.txt ]; then
+            old=$(cat .monitor-cache/npm-version.txt)
+            new=$(cat .monitor-cache/npm-version-new.txt)
+            if [ "$old" != "$new" ]; then
+              changes="${changes}\n## npm Package Version Changed\n- Old: ${old}\n- New: ${new}\n"
+            fi
+          fi
+
+          # Changelog hash
+          if [ -f .monitor-cache/changelog-hash-new.txt ] && [ -f .monitor-cache/changelog-hash.txt ]; then
+            old=$(cat .monitor-cache/changelog-hash.txt)
+            new=$(cat .monitor-cache/changelog-hash-new.txt)
+            if [ "$old" != "$new" ]; then
+              changes="${changes}\n## Changelog Page Updated\nHash changed from \`${old}\` to \`${new}\`.\nCheck: https://typefully.com/blog/changelog\n"
+            fi
+          fi
+
+          # Report
+          if [ -n "$changes" ]; then
+            body=$(printf "Automated monitoring detected changes in Typefully's ecosystem.\n\n${changes}\n\nReview these changes and determine if typefully-cli needs updates.")
+            gh issue create \
+              --title "Monitor: Typefully API/MCP changes detected $(date +%Y-%m-%d)" \
+              --body "$body" \
+              --label "monitor"
+            echo "Changes detected. Issue created."
+          else
+            echo "No changes detected."
+          fi
+
+          # Update cache
+          for f in openapi agent-skills mcp-tools; do
+            [ -f ".monitor-cache/${f}-new.json" ] && cp ".monitor-cache/${f}-new.json" ".monitor-cache/${f}.json"
+            [ -f ".monitor-cache/${f}-new.js" ] && cp ".monitor-cache/${f}-new.js" ".monitor-cache/${f}.js"
+          done
+          [ -f .monitor-cache/npm-version-new.txt ] && cp .monitor-cache/npm-version-new.txt .monitor-cache/npm-version.txt
+          [ -f .monitor-cache/changelog-hash-new.txt ] && cp .monitor-cache/changelog-hash-new.txt .monitor-cache/changelog-hash.txt
+
+      - name: Save cache
+        uses: actions/cache/save@668228422ae6a00e4ad889ee87cd7109ec5666a7  # v5.0.4
+        with:
+          path: .monitor-cache
+          key: monitor-cache-${{ github.run_id }}

typefully_cli-0.2.1/.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@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+
+      - 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.2.1}/.gitignore

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

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

@@ -1,5 +1,20 @@
 # Changelog
 
+## 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.2.1}/CLAUDE.md

@@ -2,14 +2,15 @@
 
 ## 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-first design: JSON output by default, structured errors on stderr, deterministic behavior. 24 Click commands for drafts, threads, batch, media, analytics, queue, LinkedIn, tags, accounts, config, completions.
 
 ## Architecture
 
 ```
 src/typefully_cli/
-  cli.py        -- 17 Click commands, shared options, error handler, payload builder
+  cli.py        -- 24 Click commands, shared options, error handler, payload builder
   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 +24,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:** Tracks all Typefully API v2 endpoints including analytics, queue management, and LinkedIn org resolution.
 
 ## Dev setup
 
@@ -47,6 +51,8 @@ Config at `~/.config/typefully/config.toml`. Test account: BungeeCEO.
 ```bash
 typefully config set api_key tf_...
 typefully config set default_account BungeeCEO
+typefully config set default_platforms x,linkedin
+typefully config set timezone Asia/Kolkata
 ```
 
 ## Conventions

typefully_cli-0.2.1/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.2.1/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