hap-cli 0.6.5__tar.gz → 0.6.6__tar.gz

{hap_cli-0.6.5 → hap_cli-0.6.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hap-cli
-Version: 0.6.5
+Version: 0.6.6
 Summary: CLI harness for MingDAO HAP - Enterprise no-code platform
 Author: hap-cli
 License: Apache-2.0
@@ -333,8 +333,8 @@ hap --json worksheet record list WORKSHEET_ID
 
 | Command | Description |
 |---|---|
-| `post list` | List feed posts |
-| `post search` | Search posts by keyword and date range |
+| `post list` | List feed posts (`--topic-id` filters by topic tag) |
+| `post search` | Search posts by keyword and date range (`--topic-id` filters by topic tag) |
 | `post get` | Show a post with its comment thread |
 | `post create` | Create a new post |
 | `post update` | Edit a post's content |
@@ -348,6 +348,7 @@ hap --json worksheet record list WORKSHEET_ID
 | `post pin` | Pin a post (`--hours` for duration) |
 | `post unpin` | Unpin a post |
 | `post pinned` | List pinned posts |
+| `post topics` | List topic tags (autocomplete) |
 
 ### calendar — Calendar Management
 

{hap_cli-0.6.5 → hap_cli-0.6.6}/hap_cli/README.md

@@ -304,8 +304,8 @@ hap --json worksheet record list WORKSHEET_ID
 
 | Command | Description |
 |---|---|
-| `post list` | List feed posts |
-| `post search` | Search posts by keyword and date range |
+| `post list` | List feed posts (`--topic-id` filters by topic tag) |
+| `post search` | Search posts by keyword and date range (`--topic-id` filters by topic tag) |
 | `post get` | Show a post with its comment thread |
 | `post create` | Create a new post |
 | `post update` | Edit a post's content |
@@ -319,6 +319,7 @@ hap --json worksheet record list WORKSHEET_ID
 | `post pin` | Pin a post (`--hours` for duration) |
 | `post unpin` | Unpin a post |
 | `post pinned` | List pinned posts |
+| `post topics` | List topic tags (autocomplete) |
 
 ### calendar — Calendar Management
 

{hap_cli-0.6.5 → hap_cli-0.6.6}/hap_cli/README_CN.md

@@ -311,8 +311,8 @@ hap --json worksheet record list 工作表ID
 
 | 命令 | 说明 |
 |---|---|
-| `post list` | 列出动态帖子 |
-| `post search` | 按关键词和日期范围搜索帖子 |
+| `post list` | 列出动态帖子（`--topic-id` 按话题标签过滤） |
+| `post search` | 按关键词和日期范围搜索帖子（`--topic-id` 按话题标签过滤） |
 | `post get` | 查看帖子详情（含评论） |
 | `post create` | 创建新帖子 |
 | `post update` | 编辑帖子内容 |
@@ -326,6 +326,7 @@ hap --json worksheet record list 工作表ID
 | `post pin` | 置顶帖子（`--hours` 指定时长） |
 | `post unpin` | 取消置顶 |
 | `post pinned` | 列出置顶帖子 |
+| `post topics` | 列出话题标签（自动补全） |
 
 ### calendar — 日程管理
 

{hap_cli-0.6.5 → hap_cli-0.6.6}/hap_cli/__init__.py

@@ -1,3 +1,3 @@
 """CLI harness for MingDAO HAP (hap-cli)."""
 
-__version__ = "0.6.5"
+__version__ = "0.6.6"

{hap_cli-0.6.5 → hap_cli-0.6.6}/hap_cli/commands/post_cmd.py

@@ -431,6 +431,12 @@ def _normalize_scope(scope: str) -> str:
 @click.option("--start-date", default="", help="Only posts on or after this date (YYYY-MM-DD)")
 @click.option("--end-date", default="", help="Only posts on or before this date (YYYY-MM-DD)")
 @click.option("--post-type", default=-1, type=int, show_default=True, help="Filter by post type; -1 means all")
+@click.option(
+    "--topic-id",
+    "topic_id",
+    default="",
+    help="Filter by topic tag id (see `hap post topics`)",
+)
 @click.option("-p", "--page", default=1, show_default=True, help="Page number (1-based)")
 @click.option(
     "--cursor",
@@ -449,6 +455,7 @@ def post_list(
     start_date,
     end_date,
     post_type,
+    topic_id,
     page,
     last_post_auto_id,
 ):
@@ -487,6 +494,7 @@ def post_list(
             start_date=start_date,
             end_date=end_date,
             post_type=post_type,
+            category_id=topic_id,
             page_index=page,
             last_post_auto_id=last_post_auto_id,
         )
@@ -512,6 +520,12 @@ def post_list(
 @click.option("--post-type", default=-1, type=int, show_default=True, help="Filter by post type; -1 means all")
 @click.option("--account-id", default="", help="Filter by author member id")
 @click.option("--group-id", default="", help="Filter by group id")
+@click.option(
+    "--topic-id",
+    "topic_id",
+    default="",
+    help="Filter by topic tag id (see `hap post topics`)",
+)
 @click.option("-p", "--page", default=1, show_default=True, help="Page number (1-based)")
 @click.option(
     "--cursor",
@@ -530,6 +544,7 @@ def post_search(
     post_type,
     account_id,
     group_id,
+    topic_id,
     page,
     last_post_auto_id,
 ):
@@ -557,6 +572,7 @@ def post_search(
             account_id=account_id,
             group_id=group_id,
             post_type=post_type,
+            category_id=topic_id,
             page_index=page,
             last_post_auto_id=last_post_auto_id,
         )
@@ -870,3 +886,36 @@ def post_unpin(ctx, post_id):
         ))
     except Exception as e:
         ctx.handle_error(e)
+
+
+def _simplify_topic(t: dict) -> dict:
+    return {"id": t.get("id"), "name": t.get("value")}
+
+
+def _render_topics(summary: dict) -> None:
+    topics = summary.get("topics") or []
+    if not topics:
+        click.echo("No topics found.")
+        return
+    click.echo(f"Topics ({len(topics)}):")
+    for t in topics:
+        click.echo(f"  #{t.get('name')}#  id: {t.get('id')}")
+
+
+@post.command("topics")
+@click.option("--keywords", "-k", default="", help="Filter by keyword")
+@pass_context
+def post_topics(ctx, keywords):
+    """List topic tags (autocomplete suggestions).
+
+    Use a topic inside a post by wrapping its name in hashes
+    (e.g. `#周报#`) in the post message. The tag links automatically
+    on publish, and unknown names are created on the fly.
+    """
+    try:
+        session = ctx.get_session()
+        raw = post_mod.get_topics(session, keywords=keywords)
+        topics = [_simplify_topic(t) for t in (raw or []) if isinstance(t, dict)]
+        ctx.output({"topics": topics}, _render_topics)
+    except Exception as e:
+        ctx.handle_error(e)

{hap_cli-0.6.5 → hap_cli-0.6.6}/hap_cli/core/post.py

@@ -330,3 +330,15 @@ def add_top_post(
 def remove_top_post(session: Session, post_id: str) -> dict[str, Any]:
     """Unpin via ``Post.RemoveTopPost``."""
     return session.api_call("Post", "RemoveTopPost", {"postId": post_id})
+
+
+def get_topics(session: Session, keywords: str = "") -> list[dict[str, Any]]:
+    """Autocomplete topic tags via ``Category.AutoCompleteCategory``.
+
+    Returns ``[{id, value}]``. Callers don't need the id to use a tag
+    when posting — the server recognises ``#value#`` in the post body
+    and auto-links (or auto-creates) the matching topic.
+    """
+    return session.api_call(
+        "Category", "AutoCompleteCategory", {"keywords": keywords or ""}
+    )

{hap_cli-0.6.5 → hap_cli-0.6.6}/hap_cli/skills/SKILL.md

@@ -190,8 +190,8 @@ hap department search KEYWORDS --org-id ORG_ID [--include-disabled]
 
 ### post - Feed & Post Management
 ```bash
-hap post list [--org-id ORG_ID] [--scope org|user|fav|group|groups|myself] [--cursor AUTO_ID] [-p N]
-hap post search --keywords TEXT [--org-id ORG_ID] [--start-date D] [--end-date D]
+hap post list [--org-id ORG_ID] [--scope org|user|fav|group|groups|myself] [--topic-id TOPIC_ID] [--cursor AUTO_ID] [-p N]
+hap post search --keywords TEXT [--org-id ORG_ID] [--start-date D] [--end-date D] [--topic-id TOPIC_ID]
 hap post get POST_ID
 hap post create --org-id ORG_ID --message TEXT [--share-group GID]... [--share-org OID]...
 hap post update POST_ID --message TEXT [--old-message TEXT]
@@ -205,6 +205,7 @@ hap post favorite POST_ID [--remove]
 hap post pin POST_ID [--hours N]
 hap post unpin POST_ID
 hap post pinned [--org-id ORG_ID]
+hap post topics [--keywords K]              # Hint: use #NAME# in message to tag
 ```
 
 ### calendar - Calendar & Schedule

{hap_cli-0.6.5 → hap_cli-0.6.6}/hap_cli/tests/test_integration_social.py

@@ -146,5 +146,39 @@ class TestPost:
             f"GetTopPosts expected list, got {type(result).__name__}"
         )
 
+    def test_04_topics(self, integration_session):
+        """Category.AutoCompleteCategory returns ``[{id, value}]``."""
+        result = post.get_topics(integration_session)
+        assert isinstance(result, list)
+        for t in result:
+            assert "id" in t and "value" in t
+
+    def test_05_topics_keyword_filter(self, integration_session):
+        """Keyword filter narrows the suggestions."""
+        result = post.get_topics(integration_session, keywords="周")
+        assert isinstance(result, list)
+        # Every hit should match the keyword substring
+        for t in result:
+            assert "周" in (t.get("value") or "")
+
+    def test_06_list_by_topic(self, integration_session):
+        """`catId` filter: every returned post carries that topic."""
+        topics = post.get_topics(integration_session, keywords="周")
+        if not topics:
+            pytest.skip("no topic tags available on this server")
+        topic_id = topics[0]["id"]
+        result = post.get_post_list(
+            integration_session,
+            list_type="project",
+            category_id=topic_id,
+        )
+        assert_dict_like(result, ["postList"])
+        for p in result["postList"]:
+            cats = p.get("categories") or []
+            ids = {c.get("catID") or c.get("catId") or c.get("id") for c in cats}
+            assert topic_id in ids, (
+                f"post {p.get('postID')} missing topic {topic_id}; got {ids}"
+            )
+
 
 # Calendar coverage lives in ``test_integration_calendar.py``.

{hap_cli-0.6.5 → hap_cli-0.6.6}/hap_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hap-cli
-Version: 0.6.5
+Version: 0.6.6
 Summary: CLI harness for MingDAO HAP - Enterprise no-code platform
 Author: hap-cli
 License: Apache-2.0
@@ -333,8 +333,8 @@ hap --json worksheet record list WORKSHEET_ID
 
 | Command | Description |
 |---|---|
-| `post list` | List feed posts |
-| `post search` | Search posts by keyword and date range |
+| `post list` | List feed posts (`--topic-id` filters by topic tag) |
+| `post search` | Search posts by keyword and date range (`--topic-id` filters by topic tag) |
 | `post get` | Show a post with its comment thread |
 | `post create` | Create a new post |
 | `post update` | Edit a post's content |
@@ -348,6 +348,7 @@ hap --json worksheet record list WORKSHEET_ID
 | `post pin` | Pin a post (`--hours` for duration) |
 | `post unpin` | Unpin a post |
 | `post pinned` | List pinned posts |
+| `post topics` | List topic tags (autocomplete) |
 
 ### calendar — Calendar Management
 

{hap_cli-0.6.5 → hap_cli-0.6.6}/setup.py

@@ -4,7 +4,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="hap-cli",
-    version="0.6.5",
+    version="0.6.6",
     description="CLI harness for MingDAO HAP - Enterprise no-code platform",
     long_description=open("hap_cli/README.md").read(),
     long_description_content_type="text/markdown",