Skip to content

refactor: rename apps publish commands to release and session-get - #45

Merged
raistlin042 merged 10 commits into
feat/lark-apps-devfrom
feat/apps-release-cmd-rename
Jun 9, 2026
Merged

refactor: rename apps publish commands to release and session-get#45
raistlin042 merged 10 commits into
feat/lark-apps-devfrom
feat/apps-release-cmd-rename

Conversation

@raistlin042

Copy link
Copy Markdown
Owner

Summary

Renames the Miaoda app full-stack release commands from the +publish* prefix to +release-*, drops the now-redundant +publish-error-log, renames +session-read to +session-get, and unifies +release-list pagination with the rest of the apps domain. These commands exist only on the feat/lark-apps-dev integration branch (not yet in main), so this is a clean hard rename with no backward-compat aliases. No API paths or network behavior change — only Go identifiers, command strings, error hints, tests, and skill docs.

Changes

  • Rename apps +publish -> +release-create (shortcuts/apps/apps_release_create.go)
  • Rename apps +publish-history -> +release-list and unify pagination: --limit (1-500, sent-when-set) -> --page-size (default 20, always sent as page_size), matching sibling +session-list; drop validateHistoryLimit (shortcuts/apps/apps_release_list.go)
  • Rename apps +publish-status -> +release-get (shortcuts/apps/apps_release_get.go)
  • Remove apps +publish-error-log — failure logs are already surfaced by +release-get (renders error_logs when status==failed via the retained writeReleaseErrorLogTable) (shortcuts/apps/apps_release_common.go)
  • Rename apps +session-read -> +session-get (shortcuts/apps/apps_session_get.go)
  • Update registration, path constants (publish*Path -> release*Path), cross-command error hints, and the --release-id description (shortcuts/apps/shortcuts.go, apps_release_common.go)
  • Rename + update skill reference docs (lark-apps-release-create.md / lark-apps-release-list.md / lark-apps-release-get.md; delete lark-apps-publish-error-log.md); update SKILL.md, lark-apps-cloud-dev.md, and other cross-references; add CHANGELOG.md entry
  • +html-publish (HTML static publish) is intentionally untouched

Test Plan

  • make unit-test / validate passed (build, vet, unit, integration all green)
  • sandbox E2E passed (2/2: new commands work via dry-run; old commands return unknown_subcommand; page_size always sent, no limit key)
  • acceptance-reviewer passed (5/5 scenarios: command inventory, page_size, removed-command rejection, hint/help text, --limit removed + error_logs on failed)
  • security code review passed (no real vulnerabilities; dropped client-side page_size range check is not a security boundary; +publish-error-log removal keeps the same spark:app:read scope)
  • skillave: ESCALATION — env-blocked, not a rename defect. Best run 5/6. The failing cases depend on backend releases/sessions API state that is not yet deployed (no real finished/failed release or live session status can be constructed for a fresh test app), compounded by single-run variance (3 runs: 2/6 -> 5/6 -> 3/6, failing set shifting while docs only improved). Three general skill-doc clarifications were added (release-get link contract, session-get vs session-list, release-list page-size rule). To be re-run once the backend ships.
  • manual verification: lark-cli apps +release-create --as user --app-id x --dry-run (POST /releases); apps +release-list --as user --app-id x --dry-run (query page_size=20, no limit); apps +publish --as user --app-id x --dry-run (-> unknown_subcommand)

Related Issues

N/A

@raistlin042 raistlin042 added the feature New functionality label Jun 9, 2026
@github-actions github-actions Bot added the size/L Large or sensitive change across domains or core paths label Jun 9, 2026
Renames apps +publish-status → +release-get (AppsPublishStatus → AppsReleaseGet),
updates --release-id desc to reference +release-create, and fixes the Execute
error hint to point at +release-list instead of +publish-history.
Fix six leftover references missed in Tasks 1-6: +publish-history in
jq-tip test wantCmds map and common_test hint fixture (×3), +session-read
in apps_chat.go comment+output string (×2), apps_session_stop.go flag
desc (×1), apps_chat_test.go comment (×1), and +publish-status in
lark-apps-list.md agent rule prose (×1).
@raistlin042
raistlin042 force-pushed the feat/apps-release-cmd-rename branch from 86a87dc to 0faab7a Compare June 9, 2026 13:13
Resolve apps conflicts: keep +release-*/+session-get rename atop incoming db rename (#43), cloud-dev rework (#44), and app_id guard (#46). All +session-read references in the merged cloud-dev/chat content renamed to +session-get.
@raistlin042
raistlin042 merged commit 7f232df into feat/lark-apps-dev Jun 9, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature New functionality size/L Large or sensitive change across domains or core paths

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant