blog-cli 0.4.0__tar.gz → 0.4.2__tar.gz

{blog_cli-0.4.0 → blog_cli-0.4.2}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: blog-cli
-Version: 0.4.0
-Summary: Agent-friendly CLI for managing a personal site. Articles, projects, categories, private pages, media, and a bundled ChatGPT/Codex skill.
+Version: 0.4.2
+Summary: Agent-friendly CLI for managing a personal site. Articles, projects, services, media, and a bundled ChatGPT/Codex skill.
 Author: tanaka-mambinge
 License: MIT
 Project-URL: Repository, https://github.com/tanaka-mambinge/personal-cli
 Project-URL: Issues, https://github.com/tanaka-mambinge/personal-cli/issues
-Keywords: blog,cli,agent,markdown,writing,mdx,cms,dashboard
+Keywords: blog,cli,agent,markdown,writing,mdx,cms
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
@@ -37,7 +37,7 @@ Agent-friendly CLI for managing a personal blog: create drafts, upload media, ge
 From PyPI:
 
 ```bash
-pip install blog-cli
+pip install -U blog-cli
 ```
 
 Or install it as an isolated command-line tool:
@@ -57,23 +57,16 @@ uv sync --extra dev
 
 ## Configure
 
-The CLI requires the API URL and API key. The site URL is required for preview links.
+The CLI stores the server URL, API key, and site URL in its configured keyring
+backend. On first use it prints a local setup URL; open it in a browser, enter
+the three values, and submit. The values are validated against the server
+before they are saved.
 
-```bash
-export PERSONAL_SERVER_URL="https://api.example.com"
-export PERSONAL_API_KEY="your-api-key"
-export PERSONAL_SITE_URL="https://example.com"
-```
-
-For local development, put the same variables in a `.env` file in the current directory. Do not commit that file.
-
-Production installations use the same environment variables. For example:
+For local development, run the CLI through `scripts/docker-cli`. Docker uses a
+persistent container-only credential volume and never mounts the host keyring:
 
 ```bash
-PERSONAL_SERVER_URL="https://api.example.com" \
-PERSONAL_API_KEY="your-production-api-key" \
-PERSONAL_SITE_URL="https://example.com" \
-blog-cli article list --type blog
+./scripts/docker-cli run article list --type blog
 ```
 
 All commands support `--json` for machine-readable output and `--server-url` to override the configured API URL for one command. Commands also support `--insecure` to skip TLS certificate verification when needed for local development.
@@ -162,12 +155,6 @@ Override the configured site URL for a preview:
 blog-cli article preview my-post --site-url https://preview.example.com
 ```
 
-Revoke an existing preview link:
-
-```bash
-blog-cli article revoke-preview my-post
-```
-
 Publish an article explicitly:
 
 ```bash
@@ -194,56 +181,9 @@ blog-cli article tag-add my-project --tag python --tag agents
 blog-cli article tag-remove my-project --tag agents
 ```
 
-## Categories
-
-Categories are first-class models that group private content pages. The slug is auto-derived from the name. A category cannot be deleted while pages still belong to it.
-
-```bash
-# Create (slug auto from name, e.g. "YouTube Notes" -> "youtube-notes")
-blog-cli category create --name "Ideas" --icon bulb --description "Captured ideas"
-
-# List / show / update / delete
-blog-cli category list
-blog-cli category show ideas
-blog-cli category update ideas --name "Idea Box" --icon lightbulb
-blog-cli category delete ideas
-```
-
-## Pages
-
-Pages are private content shown only on the dashboard at `/d/<slug>`. They are for your eyes only. Each page belongs to a category and supports MDX with prebuilt components (`<Callout>`, `<Steps>`, `<ImageGrid>`, `<Video>`, `<Figure>`).
-
-```bash
-# Create a page
-blog-cli page create \
-  --title "An idea" \
-  --description "Short summary" \
-  --category ideas \
-  --tag web --tag ai \
-  --markdown-file idea.mdx
-
-# List (optionally filter by category)
-blog-cli page list
-blog-cli page list --category ideas
-
-# Show / update / delete
-blog-cli page show an-idea
-blog-cli page update an-idea --title "A better title"
-blog-cli page update an-idea --markdown-file updated.mdx
-blog-cli page delete an-idea
-```
-
-Page bodies are MDX. Referenced media uses names uploaded via `blog-cli media upload --name <name> <file>`; the site resolves names to media URLs at render time.
-
 ## ChatGPT / Codex skill
 
-The CLI ships a bundled `content-pipeline` skill that routes blog, project, and page tasks to the right reference doc. Install it into the user-level skills directory:
-
-```bash
-blog-cli skill install
-blog-cli skill uninstall
-blog-cli skill path
-```
+The repository skill lives at `skills/blog-cli/SKILL.md`. It is loaded by agents from the repository and is not managed through CLI commands.
 
 ## Media
 
@@ -299,10 +239,11 @@ Use the version from `pyproject.toml` when creating the tag.
 ## Testing
 
 ```bash
-uv run pytest -v
+./scripts/docker-cli test
 ```
 
-The CLI tests use an in-memory fake API client, so they run without MongoDB or the personal server. The CLI architecture is:
+The CLI tests use an in-memory fake API client, run with networking disabled,
+and reuse Docker's cached dependencies. The CLI architecture is:
 
 ```text
 blog-cli (httpx) → FastAPI server → MongoDB/GridFS

{blog_cli-0.4.0 → blog_cli-0.4.2}/README.md

@@ -7,7 +7,7 @@ Agent-friendly CLI for managing a personal blog: create drafts, upload media, ge
 From PyPI:
 
 ```bash
-pip install blog-cli
+pip install -U blog-cli
 ```
 
 Or install it as an isolated command-line tool:
@@ -27,23 +27,16 @@ uv sync --extra dev
 
 ## Configure
 
-The CLI requires the API URL and API key. The site URL is required for preview links.
+The CLI stores the server URL, API key, and site URL in its configured keyring
+backend. On first use it prints a local setup URL; open it in a browser, enter
+the three values, and submit. The values are validated against the server
+before they are saved.
 
-```bash
-export PERSONAL_SERVER_URL="https://api.example.com"
-export PERSONAL_API_KEY="your-api-key"
-export PERSONAL_SITE_URL="https://example.com"
-```
-
-For local development, put the same variables in a `.env` file in the current directory. Do not commit that file.
-
-Production installations use the same environment variables. For example:
+For local development, run the CLI through `scripts/docker-cli`. Docker uses a
+persistent container-only credential volume and never mounts the host keyring:
 
 ```bash
-PERSONAL_SERVER_URL="https://api.example.com" \
-PERSONAL_API_KEY="your-production-api-key" \
-PERSONAL_SITE_URL="https://example.com" \
-blog-cli article list --type blog
+./scripts/docker-cli run article list --type blog
 ```
 
 All commands support `--json` for machine-readable output and `--server-url` to override the configured API URL for one command. Commands also support `--insecure` to skip TLS certificate verification when needed for local development.
@@ -132,12 +125,6 @@ Override the configured site URL for a preview:
 blog-cli article preview my-post --site-url https://preview.example.com
 ```
 
-Revoke an existing preview link:
-
-```bash
-blog-cli article revoke-preview my-post
-```
-
 Publish an article explicitly:
 
 ```bash
@@ -164,56 +151,9 @@ blog-cli article tag-add my-project --tag python --tag agents
 blog-cli article tag-remove my-project --tag agents
 ```
 
-## Categories
-
-Categories are first-class models that group private content pages. The slug is auto-derived from the name. A category cannot be deleted while pages still belong to it.
-
-```bash
-# Create (slug auto from name, e.g. "YouTube Notes" -> "youtube-notes")
-blog-cli category create --name "Ideas" --icon bulb --description "Captured ideas"
-
-# List / show / update / delete
-blog-cli category list
-blog-cli category show ideas
-blog-cli category update ideas --name "Idea Box" --icon lightbulb
-blog-cli category delete ideas
-```
-
-## Pages
-
-Pages are private content shown only on the dashboard at `/d/<slug>`. They are for your eyes only. Each page belongs to a category and supports MDX with prebuilt components (`<Callout>`, `<Steps>`, `<ImageGrid>`, `<Video>`, `<Figure>`).
-
-```bash
-# Create a page
-blog-cli page create \
-  --title "An idea" \
-  --description "Short summary" \
-  --category ideas \
-  --tag web --tag ai \
-  --markdown-file idea.mdx
-
-# List (optionally filter by category)
-blog-cli page list
-blog-cli page list --category ideas
-
-# Show / update / delete
-blog-cli page show an-idea
-blog-cli page update an-idea --title "A better title"
-blog-cli page update an-idea --markdown-file updated.mdx
-blog-cli page delete an-idea
-```
-
-Page bodies are MDX. Referenced media uses names uploaded via `blog-cli media upload --name <name> <file>`; the site resolves names to media URLs at render time.
-
 ## ChatGPT / Codex skill
 
-The CLI ships a bundled `content-pipeline` skill that routes blog, project, and page tasks to the right reference doc. Install it into the user-level skills directory:
-
-```bash
-blog-cli skill install
-blog-cli skill uninstall
-blog-cli skill path
-```
+The repository skill lives at `skills/blog-cli/SKILL.md`. It is loaded by agents from the repository and is not managed through CLI commands.
 
 ## Media
 
@@ -269,10 +209,11 @@ Use the version from `pyproject.toml` when creating the tag.
 ## Testing
 
 ```bash
-uv run pytest -v
+./scripts/docker-cli test
 ```
 
-The CLI tests use an in-memory fake API client, so they run without MongoDB or the personal server. The CLI architecture is:
+The CLI tests use an in-memory fake API client, run with networking disabled,
+and reuse Docker's cached dependencies. The CLI architecture is:
 
 ```text
 blog-cli (httpx) → FastAPI server → MongoDB/GridFS

{blog_cli-0.4.0 → blog_cli-0.4.2}/pyproject.toml

@@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "blog-cli"
-version = "0.4.0"
-description = "Agent-friendly CLI for managing a personal site. Articles, projects, categories, private pages, media, and a bundled ChatGPT/Codex skill."
+version = "0.4.2"
+description = "Agent-friendly CLI for managing a personal site. Articles, projects, services, media, and a bundled ChatGPT/Codex skill."
 readme = "README.md"
 requires-python = ">=3.13"
 license = {text = "MIT"}
 authors = [{name = "tanaka-mambinge"}]
-keywords = ["blog", "cli", "agent", "markdown", "writing", "mdx", "cms", "dashboard"]
+keywords = ["blog", "cli", "agent", "markdown", "writing", "mdx", "cms"]
 classifiers = [
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
@@ -58,6 +58,3 @@ include-package-data = true
 
 [tool.setuptools.packages.find]
 where = ["src"]
-
-[tool.setuptools.package-data]
-personal_cli = ["skill_data/**/*"]

{blog_cli-0.4.0 → blog_cli-0.4.2}/src/blog_cli.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: blog-cli
-Version: 0.4.0
-Summary: Agent-friendly CLI for managing a personal site. Articles, projects, categories, private pages, media, and a bundled ChatGPT/Codex skill.
+Version: 0.4.2
+Summary: Agent-friendly CLI for managing a personal site. Articles, projects, services, media, and a bundled ChatGPT/Codex skill.
 Author: tanaka-mambinge
 License: MIT
 Project-URL: Repository, https://github.com/tanaka-mambinge/personal-cli
 Project-URL: Issues, https://github.com/tanaka-mambinge/personal-cli/issues
-Keywords: blog,cli,agent,markdown,writing,mdx,cms,dashboard
+Keywords: blog,cli,agent,markdown,writing,mdx,cms
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
@@ -37,7 +37,7 @@ Agent-friendly CLI for managing a personal blog: create drafts, upload media, ge
 From PyPI:
 
 ```bash
-pip install blog-cli
+pip install -U blog-cli
 ```
 
 Or install it as an isolated command-line tool:
@@ -57,23 +57,16 @@ uv sync --extra dev
 
 ## Configure
 
-The CLI requires the API URL and API key. The site URL is required for preview links.
+The CLI stores the server URL, API key, and site URL in its configured keyring
+backend. On first use it prints a local setup URL; open it in a browser, enter
+the three values, and submit. The values are validated against the server
+before they are saved.
 
-```bash
-export PERSONAL_SERVER_URL="https://api.example.com"
-export PERSONAL_API_KEY="your-api-key"
-export PERSONAL_SITE_URL="https://example.com"
-```
-
-For local development, put the same variables in a `.env` file in the current directory. Do not commit that file.
-
-Production installations use the same environment variables. For example:
+For local development, run the CLI through `scripts/docker-cli`. Docker uses a
+persistent container-only credential volume and never mounts the host keyring:
 
 ```bash
-PERSONAL_SERVER_URL="https://api.example.com" \
-PERSONAL_API_KEY="your-production-api-key" \
-PERSONAL_SITE_URL="https://example.com" \
-blog-cli article list --type blog
+./scripts/docker-cli run article list --type blog
 ```
 
 All commands support `--json` for machine-readable output and `--server-url` to override the configured API URL for one command. Commands also support `--insecure` to skip TLS certificate verification when needed for local development.
@@ -162,12 +155,6 @@ Override the configured site URL for a preview:
 blog-cli article preview my-post --site-url https://preview.example.com
 ```
 
-Revoke an existing preview link:
-
-```bash
-blog-cli article revoke-preview my-post
-```
-
 Publish an article explicitly:
 
 ```bash
@@ -194,56 +181,9 @@ blog-cli article tag-add my-project --tag python --tag agents
 blog-cli article tag-remove my-project --tag agents
 ```
 
-## Categories
-
-Categories are first-class models that group private content pages. The slug is auto-derived from the name. A category cannot be deleted while pages still belong to it.
-
-```bash
-# Create (slug auto from name, e.g. "YouTube Notes" -> "youtube-notes")
-blog-cli category create --name "Ideas" --icon bulb --description "Captured ideas"
-
-# List / show / update / delete
-blog-cli category list
-blog-cli category show ideas
-blog-cli category update ideas --name "Idea Box" --icon lightbulb
-blog-cli category delete ideas
-```
-
-## Pages
-
-Pages are private content shown only on the dashboard at `/d/<slug>`. They are for your eyes only. Each page belongs to a category and supports MDX with prebuilt components (`<Callout>`, `<Steps>`, `<ImageGrid>`, `<Video>`, `<Figure>`).
-
-```bash
-# Create a page
-blog-cli page create \
-  --title "An idea" \
-  --description "Short summary" \
-  --category ideas \
-  --tag web --tag ai \
-  --markdown-file idea.mdx
-
-# List (optionally filter by category)
-blog-cli page list
-blog-cli page list --category ideas
-
-# Show / update / delete
-blog-cli page show an-idea
-blog-cli page update an-idea --title "A better title"
-blog-cli page update an-idea --markdown-file updated.mdx
-blog-cli page delete an-idea
-```
-
-Page bodies are MDX. Referenced media uses names uploaded via `blog-cli media upload --name <name> <file>`; the site resolves names to media URLs at render time.
-
 ## ChatGPT / Codex skill
 
-The CLI ships a bundled `content-pipeline` skill that routes blog, project, and page tasks to the right reference doc. Install it into the user-level skills directory:
-
-```bash
-blog-cli skill install
-blog-cli skill uninstall
-blog-cli skill path
-```
+The repository skill lives at `skills/blog-cli/SKILL.md`. It is loaded by agents from the repository and is not managed through CLI commands.
 
 ## Media
 
@@ -299,10 +239,11 @@ Use the version from `pyproject.toml` when creating the tag.
 ## Testing
 
 ```bash
-uv run pytest -v
+./scripts/docker-cli test
 ```
 
-The CLI tests use an in-memory fake API client, so they run without MongoDB or the personal server. The CLI architecture is:
+The CLI tests use an in-memory fake API client, run with networking disabled,
+and reuse Docker's cached dependencies. The CLI architecture is:
 
 ```text
 blog-cli (httpx) → FastAPI server → MongoDB/GridFS

{blog_cli-0.4.0 → blog_cli-0.4.2}/src/blog_cli.egg-info/SOURCES.txt

@@ -11,14 +11,9 @@ src/personal_cli/__main__.py
 src/personal_cli/cli.py
 src/personal_cli/client.py
 src/personal_cli/credentials.py
+src/personal_cli/docker_keyring.py
 src/personal_cli/formatting.py
 src/personal_cli/setup_server.py
-src/personal_cli/skill.py
-src/personal_cli/skill_data/SKILL.md
-src/personal_cli/skill_data/agents/openai.yaml
-src/personal_cli/skill_data/references/articles.md
-src/personal_cli/skill_data/references/pages.md
-src/personal_cli/skill_data/references/projects.md
 tests/test_cli.py
 tests/test_client.py
-tests/test_pages_categories.py
+tests/test_setup_server.py