3 Commits

Author	SHA1	Message	Date
anngo-nk	3c2cc273f7	feat(apps): design_html support, creative-design skill, unified TOS publish (#1901) ... * feat(apps): add design_html app type support and credential author identity - Add design_html to appTypePolicies (same as modern_html: skip install/env-pull/skills-sync) - Route +html-publish via policy (useTOSPublish) instead of hardcoded type check - Parse commit_author_name/commit_author_email from +git-credential-init response - Use server-provided author identity for repo-local git config, fallback to defaults - Support meta_token as identifier in +get command - Use envvars.AgentName() for source_agent in +create (reads LARKSUITE_CLI_AGENT_NAME) - Add creative HTML guide reference skeleton and SKILL.md routing entry - Update git-credential skill docs with new output fields * fix(apps): unify html-publish to TOS path, add html to init skip policy - Remove useTOSPublish policy field, html-publish always uses TOS upload - Add html type to appTypePolicies (skip install/env-pull/skills-sync) - Remove design_html from policies (not yet in use) - Fix git credential dry-run test for new local_effects entry * feat(apps): validate --app-id format to reject meta_token with resolution hint * feat(apps): integrate creative-design skill and update skill docs - Add creative-design skill under lark-apps/ (same level as references/) - Update SKILL.md description with creative design trigger keywords - Add creative design routing in development path selection table - Add --path relative path guidance in html-publish reference - Remove old creative-html-guide skeleton (replaced by creative-design) * feat(apps): skip app sync for html/modern_html in +init Add skipAppSync policy field; html and modern_html skip npx app sync on non-empty repo path since static HTML sites don't need it. * fix(apps): merge creative-design into html routing and add intent entry - Merge static HTML and creative-design into one path selection row - Add creative-design intent routing entry before html-publish * docs(apps): add html local dev flow, unify publish link source - Add html端到端 flow in local-dev.md (create → init → dev → release-create) - Unify publish link source: html and full_stack both use +release-get - Update SKILL.md routing and publish护栏 accordingly * fix(apps): update html-publish dry-run and skill docs for TOS flow - DryRun shows actual 3-step TOS flow (pre_release → TOS PUT → release-create) - Skill docs: output is release_id, use +release-get to poll for online_url - Remove references to legacy multipart upload and data.url * TEMP: pin miaoda-cli alpha and add BOE header for testing - Pin miaoda-cli to 0.1.24-alpha.fb2cf0a (revert to @latest before merge) - Add x-tt-env=boe_aily_lark_cli header globally (remove before merge) - html app-type uses --template design-html instead of --app-type (remove before merge) * docs(apps): add creative mode link format and meta_token recognition - Add creative mode (html) link format `https://{tenant}/page/{meta_token}` in publish护栏 - Note dev and publish URLs are the same for creative mode, unlike full_stack - Add meta_token to app_id resolution with full link format in app_id获取 * docs(apps): route html apps through local-dev git pipeline by default - Select dev path: html apps now default to local-dev pipeline instead of skipping local/cloud axis - Intent routing: creative-design publishes via local-dev flow instead of +html-publish - Remove +html-publish fallback from local-dev "when not to use" section * docs(apps): generalize skill references to cover both html and full_stack Remove full_stack-only wording from init, create, list, env-pull, and release-create references since html apps now share the same local dev and release flow. * feat(apps): add meta_token to +get pretty output and dry-run description * docs(apps): unify html as creative mode, fix routing and local-dev flow - Remove "HTML" as separate dev path; html and full_stack both go through local-dev - Intent routing: read local-dev before creative-design to establish git pipeline first - Mark +html-publish as legacy, redirect to local-dev for creative mode - Split html local-dev into 3 scenarios: first-time, iteration, pre-generated files - git add . instead of selective add to capture all creative-design output files * docs(apps): remove dev link from html-publish output, only return release-get online_url * fix: add license header to deck-stage.js * docs(apps): clarify dev link only for full_stack, creative mode shares dev/pub URL * docs(apps): remove +html-publish from intent routing, description, and guardrails All HTML apps now go through local-dev pipeline. +html-publish is deprecated. * docs(apps): remove html-publish references from create/release-create/cloud-dev pages html-publish is no longer the recommended path for HTML apps; all html and full_stack apps now follow the same local-dev + release-create flow. * fix(apps): address PR review feedback - html-publish dry-run: register all 3 API calls (GET pre_release, PUT TOS, POST release-create) instead of hiding steps in metadata - validateRealAppID: remove cli_ prefix check (not a valid app_id prefix) - E2E: update git-credential dry-run to expect 4 local_effects - E2E: update html-publish dry-run to expect GET pre_release * fix(apps): address PR review — remove legacy multipart dead code, fix docs - Delete html_publish_client.go and html_publish_client_test.go (legacy multipart) - Remove runHTMLPublish, enrichHTMLPublishAPIError, buildHTMLPublishFailureHint - Migrate tests from runHTMLPublish to prepareHTMLPublishTarball (same coverage) - Remove cli_ prefix from validateRealAppID (not a valid app_id prefix) - Fix html-publish.md error wording to match actual message - Register all 3 TOS API calls in html-publish dry-run - Update E2E tests for new dry-run contract * fix(apps): correctly merge SKILL.md with main (role mgmt, auth wording, source boundary) Rebuild SKILL.md from our branch version, then merge in main's additions: - description: add HTML静态站点发布, 应用角色与成员管理, 应用角色/角色成员 - 身份与授权: use main's updated wording (no proactive re-login) - intent routing: add +role-* row, +init refs 平台资源与应用源码边界 - 能力边界 → 平台资源与应用源码边界 (7 rules from main) - 禁止预授权底线: add role ② and html-publish ③ clauses * docs(apps): route legacy html-publish only for non-git html apps * docs(apps): strengthen local-dev routing and git recovery guidance fix:cherry-pick and resolve conflicts * fix: gofmt apps_errors.go and apps_errors_test.go * docs(apps): strengthen git credential recovery and add file-upload guidance - Generalize git error recovery: any git operation failure triggers +git-credential-init refresh, with environment analysis on failure - Add resource file upload rule: use +file-upload instead of local paths, base64 inlining, or git commits; files are app-scoped * test(apps): strengthen html-publish dry-run assertions for TOS 3-step contract * fix: 文件资源上传 * docs(apps): update creative-design skill content * fix: re-add license header to deck-stage.js * refactor(apps): merge system-prompt.md into SKILL.md for creative-design skill Consolidate the thin SKILL.md wrapper and the full system-prompt.md methodology into a single file, eliminating an unnecessary indirection. Update references in claude.md and codex.md accordingly. * chore: revert TEMP changes — miaoda-cli back to @latest, remove BOE header * docs(apps): remove 可见范围 from 发布态护栏 创意模式的可见范围权限走 lark-drive 文档权限体系，而非妙搭应用 权限体系，当前的 +access-scope-set/get 无法正确管理创意模式应用 的可见范围。待文档协作支持妙搭能力后，再通过 lark-drive 域能力 引导修改。 TODO: 等文档协作支持妙搭能力后，在 skill 中加入使用文档域权限 能力修改创意模式可见范围的引导。 * docs(lark-apps): 在平台资源与应用源码边界添加路径规则，引导 agent 使用相对路径 `apps` 命令的 `--path`、`--file`、`--output` 只接受 cwd 下的相对路径，传绝对路径会报错。 * docs(lark-apps): 新增创意模式评论路由和裸 meta_token 识别引导 - 意图路由表新增创意模式应用评论，引导走 lark-drive 文档评论体系 - app_id 获取章节补充裸 meta_token 识别：非链接非 app_ 开头时尝试用 +get 解析 * refactor(apps): flatten creative-design built-in-skills into references - Delete built-in-skills/ directory (9 nested sub-skill folders) - Move media skill content to references/ as flat .md files - Add assets/index.html React+Babel starter template - Integrate publishing flow into creative-design SKILL.md - Update harness reference docs (aily/claude/codex.md) - Simplify lark-apps SKILL.md routing to point directly to creative-design - Remove creative-design standalone .git directory * refactor(apps): rename creative-design/SKILL.md to creative-design.md Avoid being mistaken as an independent skill entry point. Update all internal references (lark-apps routing table + 10 reference files). * fix(apps): fail closed when queryAppType fails instead of falling back to full_stack queryAppType now returns an error instead of silently returning "". +init aborts if the app type cannot be determined, preventing wrong scaffold type from being committed and pushed to the repository. --------- Co-authored-by: zhangli <zhangli.268@bytedance.com>	2026-07-20 20:15:43 +08:00
anngo-nk	1ab853023a	feat(apps): support modern_html app type with TOS publish path and app type querying ... * feat(apps): read LARKSUITE_CLI_AGENT env var and pass app_source in +create * feat(apps): add queryAppMeta shared function for app_type/arch_type lookup * feat(apps): skip scaffold for legacy html apps, pass app_type/arch_type for arch_type=4 html in +init * feat(apps): add zip packaging for arch_type=4 html publish path * feat(apps): add TOS upload path for arch_type=4 html in +html-publish with arch_type-based routing * refactor(apps): replace appMeta struct with queryAppType string for simpler routing * refactor(apps): simplify to source_agent in +create, unified scaffold in +init, revert html-publish changes * feat(apps): add --source-path flag to +init for existing source file incorporation * fix(apps): align queryAppType with actual API path and response structure * refactor(apps): use appInfo struct to parse GET /apps/{id} response * test(apps): add full_stack scaffold test case * feat(apps): surface sync field in +release-create response * refactor(apps): remove --template flag from +init, derive template from queryAppType with full_stack fallback * style(apps): fix gofmt formatting in apps_init.go * test(apps): improve coverage for sync field, queryAppType, and scaffoldInitArgs * chore(apps): pin miaoda-cli to alpha version 0.1.20-alpha.dd573f8 * feat(apps): add modern_html enum and pass --app-type instead of --template to miaoda-cli * chore: add global PPE headers for testing (x-use-ppe, x-tt-env) * feat(apps): add TOS upload path in +html-publish for modern_html, add --tos-path to +release-create * feat(apps): unify html-publish output structure with app_id for both html and modern_html * fix(apps): use newFileTransferClient for TOS presigned upload to satisfy forbidigo lint * test(apps): add coverage for runHTMLPublishTOS success, errors, and upload failures * fix(apps): change pre_release API method from POST to GET * fix(apps): adapt pre_release response from map to list<KV> format * fix(apps): use PUT method and Content-Length for TOS presigned upload * fix(apps): use tos_path instead of tosPath in release-create request body * chore(apps): add npmmirror registry for npx miaoda-cli, fix TOS upload test to expect PUT * refactor(apps): use envvars.AgentName() for source_agent in +create * feat(apps): integrate release-create into html-publish for modern_html, auto-detect modern_html from doubao agent env * refactor(apps): remove --tos-path flag from +release-create (now internal to html-publish) * refactor(apps): remove app_id from html-publish output, update skill doc * docs(apps): update html-publish description to reflect dual return values * refactor(apps): remove doubao app_type conversion in +create, let server decide via source_agent * feat(apps): skip env-pull for modern_html apps in +init * test(apps): add tests for modern_html env-pull skip in +init * refactor(apps): introduce appTypePolicy for init control points (skipInstall, skipEnvPull, skipSkillsSync) * feat(apps): add init step timing and default git config for +init * feat(apps): add +get shortcut to fetch single app detail by app_id * chore(apps): remove init step timing (not ready for production) * test(apps): add coverage for +get shortcut * chore: remove PPE headers and revert miaoda-cli to @latest for production * refactor(apps): extract shared prepareHTMLPublishTarball, fix stale comments, simplify queryAppType * fix(apps): update html-publish dry-run desc, remove hardcoded API path * fix(apps): use rctx.IO().ErrOut instead of os.Stderr, remove unused appInfo struct * fix(apps): restore dry-run API path output for E2E compatibility * refactor(apps): move --source-path control char validation to Validate for dry-run coverage * fix(apps): update stale --template comments to --app-type in init tests * test(apps): explicitly unset agent env var for test isolation	2026-07-13 16:43:07 +08:00
evandance	9bc66cc445	feat(apps): emit typed error envelopes across the apps domain (#1288)	2026-06-11 19:04:34 +08:00