Registry / devops / tdesign-publish-cli

tdesign-publish-cli

library0.0.12jsnpmunverified

tdesign-publish-cli is a command-line interface tool designed to streamline the release process for JavaScript projects, particularly those adhering to Conventional Commits. It automates the generation of changelogs based on Git commit history, leveraging `standard-changelog`. Furthermore, it can create formatted messages for enterprise communication platforms like WeChat Work (WeCom) robots, supporting both release log notifications and instant recognition messages. The current stable version is `0.0.12`, indicating it's still in early development, and its release cadence is likely irregular as features are added and refined. Its key differentiator is the integrated robot message generation tailored for Chinese enterprise platforms, which goes beyond standard changelog tools.

devops workflow communication

npm install tdesign-publish-cli

package ↗

INSTALL

IMPORT

SIG · TDESIGN-PUBLISH-CL

tdesign-publish-cli

devopsjavascriptv0.0.12

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

tdesign-publish-cli changelog

✓ npx tdesign-publish-cli changelog

✗ node tdesign-publish-cli changelog

Invoke the changelog command to generate a `CHANGELOG.md` file based on Conventional Commits.

tdesign-publish-cli robot

✓ npx tdesign-publish-cli robot

Use this command to generate robot notification messages for WeChat Work (WeCom) based on changelog content or instant recognition templates.

tdesign-publish-cli help

✓ npx tdesign-publish-cli help changelog

✗ tdesign-publish-cli --help

Get help for a specific command. Global `--help` might not be as detailed.

This quickstart demonstrates installing the CLI, generating a changelog, and then generating a WeChat Work robot message, including an example of how to send it.

npm i -D tdesign-publish-cli # Ensure your project uses Conventional Commits, e.g., via commitlint and husky # For initial changelog generation, ensure you have git tags (e.g., v1.0.0) # Generate CHANGELOG.md npx tdesign-publish-cli changelog # Generate a robot message for a release (reads from CHANGELOG.md) npx tdesign-publish-cli robot # After running 'robot', a robotMsg.json file will be created. # Example for sending the message using curl (replace with your webhook URL): # cat robotMsg.json | curl -X POST -H 'Content-Type: application/json' -d @- "${PROCESS_ENV_WECOM_WEBHOOK_URL ?? ''}"

tdesign-publish-cli --version

Debug

Known issues

gotchaThis CLI strictly relies on Git commit messages following the Conventional Commits specification. If your commit history does not adhere to this standard, the generated changelog will be incomplete or malformed.

fix

Adopt Conventional Commits in your project. Consider using `husky` and `cz-conventional-changelog` to enforce and facilitate this.

affects: >=0.0.1

gotchaThe robot message generation creates a `robotMsg.json` file in the project root. This file contains sensitive webhook content or message details. Ensure it's handled securely and not committed to public repositories inadvertently if it contains proprietary information.

fix

Add `robotMsg.json` to your `.gitignore` file. Always test robot messages in a dedicated testing group before sending to production channels to prevent 'operational incidents'.

affects: >=0.0.1

breakingAs a pre-1.0.0 package (current version 0.0.12), breaking changes can occur frequently without major version bumps, impacting API stability and command options.

fix

Regularly check the project's repository and README for updates or breaking changes before upgrading. Pin exact versions (`"tdesign-publish-cli": "0.0.12"`) in `package.json` for stability.

affects: >=0.0.1

Errors

Common errors & fixes

Error: Command 'changelog' requires a valid git repository with commit history.

The command was run in a directory that is not a git repository or has no commit history.

fix

Initialize a git repository (`git init`), make some commits, and ensure you are in the project's root directory.

Changelog generation failed: No commits found since last tag.

There are no new commits matching the Conventional Commits specification since the last Git tag, or no tags exist.

fix

Ensure you have recent commits that follow Conventional Commits and/or create a new Git tag (`git tag v1.0.0 && git push --tags`) to mark a release point.

Error: robotMsg.json not found or empty after 'robot' command.

The `robot` command failed to generate content, possibly due to missing changelog data, incorrect input, or permissions issues.

fix

Verify that `CHANGELOG.md` exists and contains content if generating release messages. Check terminal output for any errors during `tdesign-publish-cli robot` execution. Ensure proper write permissions in the project root.

Upgrade

Version history

0.0.12latest on npm

Audit

Dependencies

standard-changelogrequiredCore dependency for generating changelogs from git commits.

huskyoptionalRecommended optional dependency for enforcing commit message standards via Git hooks.

cz-conventional-changelogoptionalRecommended optional dependency for interactive Conventional Commits message creation.

Agent activity

31 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://www.npmjs.com/package/tdesign-publish-cli ↗