@succsoft/succapp 5.0.2 → 5.0.5

package/CHANGELOG.md

@@ -1,195 +1,53 @@
 # CHANGELOG
 
-## 0.3.4(2021-04-15)
-
-- 修复下载进度条无法消失的问题
-- 简化进度条弹框
-- 修复同步树本地下载新增失败
-- 数据源配置校验
-- 本地项目下载比较json未格式化问题
-- 本地新增文件无法比较问题
-- 修复projects.exclude失效问题
-- 修复刚启动succapp时刷新同步树按钮失效问题
-- 修复同步树根目录点击下载失效问题
-- 修复日志打印异常问题
-- 修复本地没有.meta文件会报错的问题
-- 添加同步树目录节点的描述信息
-- 改善数据源本地文件命名大小写问题
-  
-## 0.3.3(2021-02-23)
-
-- 修复未授信https请求失败问题
-
-## 0.3.2(2020-02-22)
-
-- 修改插件信息
-
-## 0.3.1(2020-12-17)
-
-- 添加datasource模块
-- 同步忽略
-- .meta文件同步描述
-- 添加设置开关，控制自动编译,自动格式化，自动备份
-- 优化视图，仅当succapp工作目录显示同步和服务视图
-
-## 0.3.0(2020-11-25)
-
-- 删除app模块
-
-## 0.2.19(2020-09-21)
-
-- 修复集群负载均衡下API请求错误问题
-- 兼容旧版war包API接口
-
-## 0.2.17，0.2.18(2020-09-18)
-
-- 修复无法加载项目文件
-
-## 0.2.16(2020-08-14)
-
-- 修复插件在4.0产品20200812之后的版本无法登录使用问题
-
-## 0.2.15(2020-01-13)
-
-- 修复关闭自动格式化不生效问题
-
-## 0.2.14(2020-01-07)
-
-- 修复引用node_module模块报错导致无法打包问题
-- 启动过程增加try catch，便于查启动内部报错的问题
-
-## 0.2.12, 0.2.13(2020-01-07)
-
-- 修复.js.map文件和图片文件无差别但仍显示有差异问题
-- 实现json的自动格式化，可在设置中配置是否启用，默认启用，格式化根据`editor.insertSpaces`设置方式为`Space`或`Tab`，根据`editor.tabSize`设置缩进数
-
-## 0.2.11(2020-01-05)
-
-- 修复下载图片后不能打开问题
-- 调整初始化设置，使项目初始化后编译不报错且编译结果与服务器保持一致
-
-## 0.2.7, 0.2.8, 0.2.9, 0.2.10(2019-11-28)
-
-- 调整插件服务端API，修复插件无法上传文件文件
-
-## 0.2.6(2019-11-11)
-
-- 启动插件会检查是否存在api-libs.json文件，若不存在则自动下载api
-- 修复同步树上change数不会刷新问题
-
-## 0.2.5(2019-11-09)
-
-- 修复服务器连接校验错误
-
-## 0.2.4(2019-11-08)
-
-- 优化扩展模板下载
-- 新增服务器增加校验
-- 修复命令中文不生效问题
-
-## 0.2.2, 0.2.3(2019-11-05)
-
-- 修复添加服务的一些bug
-- 新增api的下载入口
-
-## 0.2.1(2019-11-04)
-
-- `SuccBI Server`视图改为只显示当前服务器，切换服务器提供选择框选择
-- 添加第一个服务器时自动作为当前服务器，后续添加不改变当前服务器
-- `SuccBI Synchronize`视图支持收起所有
-- 屏蔽一些不需要的命令并添加命令的中文标题配置
-
-## 0.2.0(2019-11-01)
-
-- 插件更名为SuccApp，以前名为succADP-IDE
-- 视图改为`SuccBI Server`、`SuccBI Synchronize`，容器为`explorer`，以前是`修改待同步`、`持续同步`，自定义容器
-- 调整目录结构，compare、backup、temp等放在.vscode里
-- 新增日志文件，新增服务器备份、支持新增和删除的比较
-- 删除扩展发布功能，使用同步功能提交扩展，新增APP的同步
-
-## 0.1.28(2019-09-26)
-
-- fix: 跟远程仓库同步之后无法查看文件修改差异
-
-## 0.1.27(2019-09-23)
-
-- fix: 执行succ load project命令之后，点击“同步刷新”按钮，无法同步工程，没有显示新添加的文件
-
-## 0.1.22(2019-08-05)
-
-- fix:更新api的时候报错：9:38:36 Error: EPERM: operation not permitted, mkdir 'd:/succezIDE/github/bds/com.succez.bds/api'
-
-## 0.1.18(2019-07-20)
-
-- feat:启动插件时自动从服务器更新api文件。所以推荐启动插件之前服务器是启动的。如果没有启动，那么api目录将不会被更新。
-
-## 0.1.16(2019-07-20)
-
-- feat:上传文件到服务器时改成串行提交，避免服务器报异常
-
-## 0.1.12，0.1.13，0.1.14(2019-07-16)
-
-- feat:修改插件名字为succ-adp-ide，显示名为succADP-IDE。以前是叫succExtensionIDE
-- 解决ajax请求出现401错误时自动登录的问题
-
-## 0.1.11(2019-07-15)
-
-- feat:如果服务器启动的是本地开发环境，那么从vscode发布文件到服务器不需要确认
-
-## 0.1.9 , 0.1.10(2019-07-10)
-
-- fix:比较本地文件和服务器文件的修改时间时由于精度不同导致总是不相同。
-
-## 0.1.8(2019-07-09)
-
-- 同步时如果session失效那么自动登录
-- 执行操作时如果服务器没有启动，那么显示明确的提示信息
-
-## 0.1.7(2019-07-09)
-
-- 登录时输出日志，出现异常时也输出日志
-
-## 0.1.6(2019-07-08)
-
-- 增加插件启动日志，当发现ts文件有变化时也会在控制台输出日志
-
-## 0.1.1(2019-07-02)
-
-- 修复一些问题
-- 增加了部分文档
-
-## 0.1.0(2019-06-11)
-
-- 支持元数据项目级别的元数据同步
-- ts编译结果从jss改为js
-- 支持打开项目就直接开始编译
-- 支持元数据app的持续上传
-
-## 0.0.20(2019-04-11)
-
-- 支持在less中使用succ提供的默认less样式
-
-## 0.0.18(2019-01-09)
-
-- 支持在扩展内部引用第三方js文件
-- 修复偶尔出现的不编译脚本的问题
-
-## 0.0.15(2019-01-07)
-
-- 调整扩展目录结构
-
-## 0.0.14(2019-01-05)
-
-- 修复删除文件不能正确同步的问题
-
-## 0.0.13(2019-01-04)
-
-- 修复模板重命名的不正确的问题
-
-## 0.0.12 (2019-01-04)
-
-- 修复一些提示内容
-
-## 0.0.1 (2018-12-20)
-
-- 测试第一版发布
+## 5.0.5(2026-07-06)
+
+- 新增 `succapp server file locate` 和 `succapp server file search`，支持按文件 id、路径、名称等条件定位和检索服务器文件。
+- 新增 `succapp model` 命令组，支持模型列表、字段、索引、预览查询和导出，并统一 `model select`、`model query` 的 JSON 与文件输出。
+- 新增 `succapp workspace file compile`，接入 Dev Tool V2 编译接口，用于在 CLI 中校验和编译本地工作区文件。
+- 扩展 Dev Tool V2 客户端协议，补齐模型查询、文件搜索、文件编译、流式导出等接口声明和实现。
+- 重构 CLI 参数解析为声明式参数契约，统一必填输入、互斥输入、输出文件、stdin 和 JSON 输出的校验与提示。
+- 优化数据库查询/导出、服务器设置、工作区文件打开和锁等待等命令输出，进一步统一 SuccApp 命令命名和帮助文案。
+- 将工作区开发支持资产迁移到文档 skill 维护，并收敛 `.agents` 系统目录边界，减少初始化和修复工作区时的重复写入。
+- 修复同步写入后 mirror 内容基线不完整的问题，避免后续状态检测误判本地文件变化。
+- 补充模型命令、工作区文件编译、服务器文件定位/搜索、CLI 参数解析、输出格式和同步基线相关单元测试与集成测试。
+
+## 5.0.4(2026-06-30)
+
+- 新增 SuccApp CLI 版本更新检查，`succapp --version` 会检查 npm 包版本，并在命令完成后通过 stderr 给出低打扰升级提示。
+- 支持按服务器版本线推荐配套 CLI 版本，避免旧服务器被默认引导升级到不兼容的新大版本。
+- 调整 Dev Tool API 请求的 User-Agent 标识，区分 `SuccAppCLI` 与 `SuccAppForVSCode` 调用端，并保留 Node.js 明文 JSON 异常输出协议。
+- 补充版本检查缓存目录、环境变量开关和单元测试，确保 JSON stdout 不被升级提示污染。
+
+## 5.0.3(2026-06-30)
+
+- 发布 SuccApp CLI npm 包 `@succsoft/succapp@5.0.3`，并将 `latest` 指向该版本。
+- 支持 SuccApp 官方离线文档 skill，完善 AI Agent 在 SuccApp 工作区内读取产品手册和开发规则的能力。
+- 补充开发辅助资源和内容类型识别，完善低代码元数据和资源文件的本地开发体验。
+- 修复 clone 不可见项目时的错误处理，提前返回结构化错误，避免后续同步流程继续执行。
+
+## 5.0.2(2026-06-28)
+
+- 优化 SuccApp CLI 的命令提示风格，补充未知命令建议，降低命令输错后的排查成本。
+- 改善 `workspace init`、`clone`、`auth status`、元数据升级提示等常用命令的人类可读输出。
+- 支持 OAuth 登录入口，完善 CLI 服务信息、同步状态和系统信息展示。
+- 增加 `workspace discard`、`workspace settings get/set` 等工作区命令，并统一无副作用预演参数为 `--dry-run`。
+- 重组 SuccApp 元数据 TypeScript 声明目录，迁移 `.meta` 类型声明，补充移动端、样式、布局、资源类型和 MIME 类型定义。
+- 简化 MCP 接口，完善 CLI、DevTool v2 和工作区同步能力之间的协议边界。
+
+## 5.0.1(2026-06-20)
+
+- 首次将 SuccApp CLI 发布到 npm，包名为 `@succsoft/succapp`，命令名为 `succapp`。
+- 重构 CLI 命令体系，补齐工作区、服务器连接、项目、文件、同步和辅助命令能力。
+- 适配 DevTool v2 认证和服务端能力，接入本机认证、自动认证和结构化错误输出。
+- 支持创建元数据项目，完善 CLI 与 VS Code 共享的工作区初始化、修复和同步流程。
+- 增加 CLI 构建、测试和 release 脚本，发布时生成仅包含 CLI 运行所需文件的 npm staging 包。
+
+## 5.0.0(2026-06-20)
+
+- 实现 SuccApp DevTools 5.0 基线，将原 SuccIDE 能力升级为面向低代码项目交付、二次开发和 AI 辅助开发的 SuccApp 工具。
+- 重建 VS Code 扩展的服务器视图、Changes 视图、日志输出、diff、同步和项目管理体验。
+- 引入本地 SuccApp 工作区模型，支持元数据项目识别、工作区初始化、服务器配置和前端开发框架配置。
+- 优化 clone、fetch、pull、push、reset、apply remote changes 等同步流程，提高远端变化、本地变化和冲突识别能力。
+- 增加跨进程 workspace 锁管理、文件锁、认证持久化和结构化错误模型，为 VS Code 扩展和 CLI 共用同一工作区打基础。
+- 增强元数据 schema、类型声明、内容指纹、rename 检测和 inode 缓存能力，改善大批量元数据同步和比较性能。

package/README.md

@@ -40,6 +40,17 @@ succapp workspace push <path>
 
 其中 `workspace push` 会写入服务器。推送前应先检查差异；生产服务器必须按团队发布流程确认。
 
+数据查询类命令分为预览和导出两类。预览命令只向 stdout 返回有限行数，导出命令必须写入本地文件：
+
+```bash
+succapp db query default "select * from orders" --max-rows=100 --json
+succapp db export default --query-file=./orders.sql --output=orders.csv
+succapp model select /DEMO/data/tables/orders.tbl --select ID,NAME --max-rows=100 --json
+succapp model query --query-file=./query.json --max-rows=100 --json
+succapp model export /DEMO/data/tables/orders.tbl --select ID,NAME --output=orders.csv
+succapp model export --query-file=./query.json --output=result.csv
+```
+
 ## SuccApp for VS Code / VS Code 工具
 
 SuccApp for VS Code 面向人工检查和交互式开发。它提供服务器视图、Changes 视图、文件历史、diff、脚本编辑、远端文件打开和 Git 协作入口，适合项目成员查看 AI 修改结果、处理冲突和执行需要人工确认的同步操作。

package/dist/cli/l10n/bundle.l10n.json

@@ -21,6 +21,7 @@
 	"err.sync.conflict.desc": "Please pull or diff before pushing. Reason: {reason}",
 	"err.sync.projectUnavailable": "Cannot {actionName} unavailable remote project(s): {paths}",
 	"err.sync.projectUnavailable.desc": "Check the server, user, project permissions, and project name before retrying.",
+	"err.sync.projectUnavailable.hint": "Run 'succapp server project list' to see projects visible to the current login, then retry with an exact project name.",
 	"err.sync.projectNotFound": "Workspace project does not exist: {projectNames}",
 	"err.sync.projectRootRenameUnsupported": "Cannot {actionName} renamed remote project(s): {paths}",
 	"err.sync.projectRootRenameUnsupported.desc": "Applying a project rename is not supported yet. Re-clone the renamed project or rename it locally to match.",
@@ -61,7 +62,7 @@
 	"err.workspace.issue.E403": "AI agent workspace files are missing",
 	"err.workspace.issue.E404": "TypeScript support files are missing",
 	"err.workspace.issue.E405": "JSON Schema support files are missing",
-	"err.workspace.issue.E406": "frontend development skill files are missing",
+	"err.workspace.issue.E407": "SuccApp docs skill files are missing",
 	"err.lock.busy": "Cannot {attemptedCommand}: workspace scope {conflictScope} is held by another process.",
 	"err.lock.busy.desc": "Stop the running process and retry; locks left by crashed processes are cleaned up automatically on the next attempt.",
 	"err.lock.compromised": "Workspace lock was taken over by another process; the current {attemptedCommand} has been aborted.",
@@ -101,8 +102,7 @@
 	"err.cli.invalidKeyValue.hint": "Use key=value.",
 	"err.cli.invalidNonEmptyKeyValue": "Invalid key=value for {input}: {value}.",
 	"err.cli.invalidNonEmptyKeyValue.hint": "Use key=value and keep key non-empty.",
-	"err.cli.invalidJson": "Invalid JSON for {input}: {source}.",
-	"err.cli.invalidJsonObject": "{input} must be a JSON object: {source}.",
+	"err.cli.invalidJsonObject": "{input} must be a valid JSON object: {source}.",
 	"err.cli.invalidReadableFile": "Input file is not readable: {source}.",
 	"err.cli.invalidRegularFile": "Input path is not a regular file: {source}.",
 	"err.cli.invalidWorkspace": "Not a SuccApp workspace: {source}.",
@@ -133,6 +133,9 @@
 	"err.cli.confirmationRequired.projRemove.hint": "Confirm the local project files and mirror baselines can be removed, then pass {flag}.",
 	"err.cli.confirmationRequired.discardAll": "Discarding all workspace changes requires confirmation.",
 	"err.cli.confirmationRequired.discardAll.hint": "Confirm all local workspace changes can be discarded, then pass {flag}.",
+	"err.cli.confirmationRequired.openLocalChanged": "The local workspace file has unpushed changes: {path}.",
+	"err.cli.confirmationRequired.openLocalChanged.desc": "The browser opens the server version, so it may show old content or 404 for a new file.",
+	"err.cli.confirmationRequired.openLocalChanged.hint": "Run 'succapp workspace push {path}' first, or pass {flag} to open the server page anyway.",
 	"err.db.nonReadOnlySql": "db query only runs read-only SQL. Use db exec for SQL that may change data or schema.",
 	"err.db.nonReadOnlySql.hint": "Review the SQL impact, then run 'succapp db exec {flag}'.",
 	"err.net.httpStatusUnexpected": "Unexpected HTTP response status",
@@ -145,15 +148,20 @@
 	"workspace.maintenance.progress.checkingAll": "Checking workspace",
 	"workspace.maintenance.progress.blocked": "Blocked {0}.",
 	"workspace.maintenance.progress.checked": "Checked {0}.",
-	"workspace.maintenance.progress.checking": "Checking {0} ({1}/{2})",
+	"workspace.maintenance.progress.checking": "[{1}/{2}] Checking {0}",
 	"workspace.maintenance.progress.failed": "Failed {0}.",
 	"workspace.maintenance.progress.skipped": "Skipped {0}: {1}.",
 	"workspace.maintenance.progress.skipReason": "skipped",
 	"workspace.maintenance.progress.updated": "Updated {0}.",
 	"workspace.maintenance.progress.updatingAll": "Updating workspace",
 	"workspace.maintenance.progress.upToDate": "{0} is up to date.",
+	"workspace.maintenance.agentDocs.progress.assets": "checking assets",
+	"workspace.maintenance.agentDocs.progress.indexes": "fetching indexes",
+	"workspace.maintenance.agentDocs.progress.markdown": "checking markdown",
+	"workspace.maintenance.agentDocs.progress.metadata": "writing metadata",
 	"workspace.maint.task.frontendDevelopmentSkill": "frontend development skill",
 	"workspace.maint.task.jsonSchemaSupport": "JSON schema support",
+	"workspace.maint.task.succappDocsSkill": "SuccApp docs skill",
 	"workspace.maint.task.syncBaseline": "sync baseline",
 	"workspace.maint.task.typescriptSupport": "TypeScript support",
 	"workspace.maint.task.workspaceAgentFiles": "workspace agent files",
@@ -200,20 +208,20 @@
 	"cli.cmd.root.summary": "SuccApp command line interface.",
 	"cli.host.localeFallback": "Locale {0} is not available; using default messages.",
 	"cli.opt.help": "Show this help.",
-	"cli.opt.json": "Write newline-delimited JSON output.",
+	"cli.opt.json": "Write NDJSON for scripts; content output uses Base64.",
 	"cli.opt.locale": "Use the given locale for CLI messages.",
 	"cli.opt.lockTimeout": "Wait for a workspace lock before failing.",
 	"cli.opt.logLevel": "Set log level: trace, debug, info, warn, or error.",
 	"cli.opt.quiet": "Suppress progress and informational output.",
-	"cli.opt.server": "Select a server for commands that support it.",
+	"cli.opt.server": "Use the specified server for commands that support it.",
 	"cli.opt.verbose": "Enable debug logging.",
-	"cli.opt.version": "Show version information.",
+	"cli.opt.version": "Show version information and check for SuccApp CLI updates.",
 	"cli.opt.workspace": "Run as if SuccApp was started in the given workspace.",
 	"cli.cmd.auth.title": "Auth",
 	"cli.cmd.auth.summary": "login, logout, and inspect stored server auth",
 	"cli.cmd.auth.desc": "Login, logout, and inspect stored server auth.",
 	"cli.cmd.auth.login.summary": "Login to a server.",
-	"cli.cmd.auth.login.desc": "Login to a SuccBI server with OAuth2 or PAT and save local auth state.",
+	"cli.cmd.auth.login.desc": "Login to a SuccApp server with OAuth2 or PAT and save local auth state.",
 	"cli.cmd.auth.login.oauth": "Use OAuth2 login. This is the default.",
 	"cli.cmd.auth.login.pat": "Use Personal Access Token login. Interactive terminals prompt for the token; piped input is read from stdin.",
 	"cli.cmd.auth.login.patPrompt": "Personal Access Token: ",
@@ -338,14 +346,17 @@
 	"cli.cmd.db.export.force": "Overwrite the output file if it already exists.",
 	"cli.cmd.db.export.exportedData": "Exported data to {0}",
 	"cli.cmd.server.title": "Server",
-	"cli.cmd.server.summary": "inspect and operate a SuccBI server",
-	"cli.cmd.server.desc": "Inspect and operate a SuccBI server.",
+	"cli.cmd.server.summary": "inspect and operate the target SuccApp server",
+	"cli.cmd.server.desc": "Inspect and operate the target SuccApp server.",
 	"cli.cmd.server.serverNotConfigured": "Server is not configured for this workspace: {0}",
 	"cli.cmd.server.serverReachable": "Server reachable: {0}",
 	"cli.cmd.server.ping.summary": "Check server reachability.",
 	"cli.cmd.server.ping.desc": "Check whether the SuccApp Dev Tool v2 ping endpoint is reachable.",
 	"cli.cmd.server.info.summary": "Show server information.",
 	"cli.cmd.server.info.desc": "Show server information and metadata versions.",
+	"cli.cmd.server.info.scope": "Show only the selected scope. Repeat or use comma-separated values: product, sys, metadata, inspect, jvm, env, all.",
+	"cli.cmd.server.info.all": "Show all information scopes.",
+	"cli.cmd.server.info.raw": "Output the raw server detail response.",
 	"cli.cmd.server.cache.title": "Server cache",
 	"cli.cmd.server.cache.summary": "manage server cache",
 	"cli.cmd.server.cache.desc": "Manage server cache.",
@@ -366,26 +377,38 @@
 	"cli.cmd.server.file.desc": "Inspect and operate server metadata files.",
 	"cli.cmd.server.file.badValue": "Invalid value for {0}: {1}",
 	"cli.cmd.server.file.expectedRevRequired": "{0} requires --expected-revision=<n> unless --force is used.",
-	"cli.cmd.server.file.file": "file",
 	"cli.cmd.server.file.fileOrStdinConflict": "Use either --file or --stdin, not both.",
 	"cli.cmd.server.file.files": "No files.",
-	"cli.cmd.server.file.folder": "folder",
-	"cli.cmd.server.file.id": "ID",
 	"cli.cmd.server.file.inputPathRegular": "Input path is not a regular file: {0}",
 	"cli.cmd.server.file.missingContentSource": "Missing content source. Use --file=<local-file> or --stdin.",
 	"cli.cmd.server.file.missingServerFile": "Missing server file path.",
-	"cli.cmd.server.file.modifyTime": "Modify time",
-	"cli.cmd.server.file.name": "Name",
 	"cli.cmd.server.file.revForceConflict": "{0} accepts either --expected-revision or --force, not both.",
-	"cli.cmd.server.file.size": "Size",
 	"cli.cmd.server.file.success": "{0} succeeded: {1}",
 	"cli.cmd.server.file.unknownServerFile": "Unknown server file error.",
 	"cli.cmd.server.file.list.summary": "List server files.",
 	"cli.cmd.server.file.list.desc": "List direct children of a server metadata directory.",
+	"cli.cmd.server.file.search.summary": "Search server files.",
+	"cli.cmd.server.file.search.desc": "Search readable server metadata files by query, path, name, type, and size.",
+	"cli.cmd.server.file.search.path": "Search by full metadata path glob.",
+	"cli.cmd.server.file.search.name": "Search by file name glob.",
+	"cli.cmd.server.file.search.parentDir": "Search by parent directory glob.",
+	"cli.cmd.server.file.search.project": "Limit search to one project.",
+	"cli.cmd.server.file.search.type": "Limit search to metadata type. Repeat or use comma-separated values.",
+	"cli.cmd.server.file.search.subType": "Limit search to metadata subtype. Repeat or use comma-separated values.",
+	"cli.cmd.server.file.search.minSize": "Minimum original content size in bytes.",
+	"cli.cmd.server.file.search.maxSize": "Maximum original content size in bytes.",
+	"cli.cmd.server.file.search.limit": "Limit the number of returned files. Defaults to 50; maximum is 200.",
+	"cli.cmd.server.file.search.offset": "Skip this many matched files.",
+	"cli.cmd.server.file.search.includeFolders": "Include folders in the result.",
+	"cli.cmd.server.file.locate.summary": "Locate a server file by metadata ID.",
+	"cli.cmd.server.file.locate.desc": "Resolve a metadata ID to the current server file path.",
+	"cli.cmd.server.file.locate.url": "Only print the server view or edit URL.",
+	"cli.cmd.server.file.locate.viewUrl": "View URL: {0}",
+	"cli.cmd.server.file.locate.editUrl": "Edit URL: {0}",
 	"cli.cmd.server.file.info.summary": "Show server file information.",
 	"cli.cmd.server.file.info.desc": "Show server-side metadata for a file or directory.",
 	"cli.cmd.server.file.show.summary": "Show server file content.",
-	"cli.cmd.server.file.show.desc": "Write server file content to stdout.",
+	"cli.cmd.server.file.show.desc": "Write server file content to stdout. Omit --json to inspect readable text; --json wraps content as Base64 for scripts.",
 	"cli.cmd.server.file.show.revision": "Read a server file revision.",
 	"cli.cmd.server.file.show.upgradeContent": "Return upgraded metadata JSON content when supported.",
 	"cli.cmd.server.file.download.summary": "Download server file content.",
@@ -459,9 +482,15 @@
 	"cli.cmd.workspace.summary": "work with a local SuccApp workspace",
 	"cli.cmd.workspace.desc": "Work with a local SuccApp workspace.",
 	"cli.cmd.workspace.init.summary": "Initialize a SuccApp workspace.",
-	"cli.cmd.workspace.init.desc": "Initialize .succapp/config.json and recommended workspace support files.",
+	"cli.cmd.workspace.init.desc": "Initialize .succapp/config.json, recommended workspace support files, and the optional offline SuccApp docs skill.",
 	"cli.cmd.workspace.init.server": "Initialize the workspace with this active server.",
+	"cli.cmd.workspace.init.scope": "Limit initialization scope. Values: base, dev, agent-docs, all.",
+	"cli.cmd.workspace.init.force": "Force the offline SuccApp docs skill to check local files even when the index is unchanged.",
 	"cli.cmd.workspace.init.active": "Active server: {0}",
+	"cli.cmd.workspace.init.agentDocsSummary": "SuccApp docs skill: {0} files, {1} added, {2} changed, {3} removed, {4} unchanged.",
+	"cli.cmd.workspace.init.agentDocsFileSkipped": "SuccApp docs skill: {0} markdown files skipped. See logs for details.",
+	"cli.cmd.workspace.init.agentDocsResourceSkipped": "SuccApp docs skill: {0} linked resources skipped. See logs for details.",
+	"cli.cmd.workspace.init.agentDocsUnavailable": "SuccApp docs skill: skipped because the docs index is unavailable. Set SUCCAPP_DOCS_BASE_URL to a local or staging docs site, or copy .agents/skills/succapp-docs/ from the delivery package or team repository.",
 	"cli.cmd.workspace.init.alreadyActive": "Workspace is already initialized with active server: {0}. Use 'succapp workspace remote add <url>' or 'succapp workspace remote use <url>' to change servers.",
 	"cli.cmd.workspace.init.configBad": "Workspace config is corrupted: {0}",
 	"cli.cmd.workspace.init.initWorkspace": "Initialized workspace: {0}",
@@ -570,6 +599,8 @@
 	"cli.cmd.workspace.file.open.summary": "Open the server file page.",
 	"cli.cmd.workspace.file.open.desc": "Open the server view or edit page for a workspace file.",
 	"cli.cmd.workspace.file.open.edit": "Open the server edit page.",
+	"cli.cmd.workspace.file.open.force": "Open the server page even when the local file has unpushed changes.",
+	"cli.cmd.workspace.file.open.localChangedForce": "The local file has unpushed changes. The browser opens the server version of {0}.",
 	"cli.cmd.workspace.file.open.openedEdit": "Opened server edit page: {0}",
 	"cli.cmd.workspace.file.open.openedView": "Opened server view page: {0}",
 	"cli.cmd.workspace.file.show.summary": "Show file content.",
@@ -586,6 +617,11 @@
 	"cli.cmd.workspace.file.history.summary": "Show server file history.",
 	"cli.cmd.workspace.file.history.desc": "Show server-side file history for a workspace file.",
 	"cli.cmd.workspace.file.history.limit": "Limit the number of history records.",
+	"cli.cmd.workspace.file.compile.summary": "Compile workspace metadata content on the server.",
+	"cli.cmd.workspace.file.compile.desc": "Send local workspace metadata content to the server for compile validation.",
+	"cli.cmd.workspace.file.compile.compiler": "Compiler",
+	"cli.cmd.workspace.file.compile.failed": "Failed files: {0}",
+	"cli.cmd.workspace.file.compile.result": "Metadata compile result: {0} file(s), {1} passed, {2} failed",
 	"cli.cmd.workspace.file.upgrade.summary": "Upgrade old SuccApp metadata files.",
 	"cli.cmd.workspace.file.upgrade.desc": "Preview or upgrade old SuccApp metadata files in local workspace projects. If no path is given, all local projects are processed.",
 	"cli.cmd.workspace.file.upgrade.dryRun": "Preview upgrade candidates without changing files.",
@@ -619,7 +655,6 @@
 	"cli.cmd.workspace.backup.desc": "Inspect and clear workspace backups.",
 	"cli.cmd.workspace.backup.backupPath": "Backup path",
 	"cli.cmd.workspace.backup.cleared": "Merge backup clear: {0} cleared, {1} remaining.",
-	"cli.cmd.workspace.backup.size": "Size",
 	"cli.cmd.workspace.backup.list.summary": "List saved merge backups.",
 	"cli.cmd.workspace.backup.list.desc": "List local versions saved before pull conflict handling.",
 	"cli.cmd.workspace.backup.clear.summary": "Clear saved merge backups.",
@@ -655,12 +690,51 @@
 	"cli.out.common.product": "Product",
 	"cli.out.common.productInfo": "Product information",
 	"cli.out.common.server": "Server",
+	"cli.out.common.sysInfo": "System information",
 	"cli.out.common.sysInspectInfo": "System diagnostics",
 	"cli.out.common.systemEnvirInfo": "Environment variables",
 	"cli.out.common.targetVersion": "Target version",
 	"cli.out.common.version": "Current version",
 	"cli.out.common.workspace": "Workspace",
 	"cli.out.db.exists": "Output file already exists: {0}. Use --force to overwrite.",
+	"cli.out.file.createTime": "Create time",
+	"cli.out.file.creator": "Creator",
+	"cli.out.file.description": "Description",
+	"cli.out.file.file": "file",
+	"cli.out.file.folder": "folder",
+	"cli.out.file.hash": "Hash",
+	"cli.out.file.hidden": "Hidden",
+	"cli.out.file.icon": "Icon",
+	"cli.out.file.id": "ID",
+	"cli.out.file.kind": "Kind",
+	"cli.out.file.labels": "Labels",
+	"cli.out.file.modifier": "Modifier",
+	"cli.out.file.modifyTime": "Modify time",
+	"cli.out.file.name": "Name",
+	"cli.out.file.order": "Order",
+	"cli.out.file.parentDir": "Parent dir",
+	"cli.out.file.path": "Path",
+	"cli.out.file.project": "Project",
+	"cli.out.file.revision": "Revision",
+	"cli.out.file.size": "Size",
+	"cli.out.file.subFileType": "Subfile type",
+	"cli.out.file.type": "Type",
+	"cli.out.model.businessKeys": "Business keys",
+	"cli.out.model.dataType": "Data type",
+	"cli.out.model.dbField": "DB field",
+	"cli.out.model.dim": "Dim",
+	"cli.out.model.enabled": "Enabled",
+	"cli.out.model.extracted": "Extracted",
+	"cli.out.model.extractMode": "Extract mode",
+	"cli.out.model.fields": "Fields",
+	"cli.out.model.kind": "Kind",
+	"cli.out.model.primary": "Primary",
+	"cli.out.model.primaryKeys": "Primary keys",
+	"cli.out.model.targetTable": "Target table",
+	"cli.out.model.title": "Title",
+	"cli.out.model.type": "Model type",
+	"cli.out.model.unique": "Unique",
+	"cli.out.model.writable": "Writable",
 	"cli.out.header.action": "Action",
 	"cli.out.header.column": "Column",
 	"cli.out.header.command": "Command",
@@ -672,6 +746,7 @@
 	"cli.out.header.extra": "Extra",
 	"cli.out.header.field": "Field",
 	"cli.out.header.key": "Key",
+	"cli.out.header.kind": "Kind",
 	"cli.out.header.latestVersion": "Latest version",
 	"cli.out.header.message": "Message",
 	"cli.out.header.metaType": "Metadata type",
@@ -703,6 +778,12 @@
 	"cli.out.human.info": "info: {0}",
 	"cli.out.human.seeLogs": "See logs: {0}",
 	"cli.out.human.warning": "warning: {0}",
+	"cli.out.version.checking": "Checking SuccApp CLI version...",
+	"cli.out.version.serverIncompatible": "SuccApp CLI {0} may not be compatible with server {1}. Recommended CLI version: {2}. Run `{3}` to install a compatible version.",
+	"cli.out.version.serverNoCompatible": "No compatible SuccApp CLI version was found for server {0}. Do not upgrade to npm latest unless the server is upgraded.",
+	"cli.out.version.serverUpdateAvailable": "A newer SuccApp CLI is recommended for server {0}: {1}. Run `{2}` to upgrade.",
+	"cli.out.version.updateAvailable": "A newer SuccApp CLI is available: {0}. Run `{1}` to upgrade.",
+	"cli.out.version.upToDate": "SuccApp CLI is up to date.",
 	"cli.out.server.file.download.exists": "Output file already exists: {0}. Use --force to overwrite.",
 	"cli.out.server.file.exists": "Output file already exists: {0}. Use --force to overwrite.",
 	"cli.out.server.file.needOutput": "Missing required option: --output=<local-file>.",
@@ -784,7 +865,7 @@
 	"vs.cmd.misc.remoteFile.changeHaveRemote": "This change does not have a remote file to open.",
 	"vs.cmd.misc.remoteFile.connectedServer": "Not connected to a server",
 	"vs.cmd.misc.remoteFile.fileHaveRemote": "This file does not have a remote metadata record.",
-	"vs.common.cannotAddingSucc": "Cannot {0} before adding a SuccBI server.",
+	"vs.common.cannotAddingSucc": "Cannot {0} before adding a SuccApp server.",
 	"vs.common.connectContinue": "Connect to {0} to continue {1}.",
 	"vs.common.createFolder": "Create Folder",
 	"vs.common.createOrSelect": "Create or select a SuccApp workspace folder",
@@ -795,12 +876,12 @@
 	"vs.common.showLogs": "Show Logs",
 	"vs.common.succAppNeeds": "SuccApp needs a local workspace to save server configuration and cloned projects.",
 	"vs.cmd.server.add.cloneProjects": "Clone Projects",
-	"vs.cmd.server.add.enterSuccBi": "Enter SuccBI server URL",
+	"vs.cmd.server.add.enterSuccBi": "Enter SuccApp server URL",
 	"vs.cmd.server.add.invalidUrl": "Please enter a valid URL",
 	"vs.cmd.server.add.serverExists": "Server already exists",
 	"vs.cmd.server.add.succAppAdd": "SuccApp: Add Server",
 	"vs.cmd.server.changeUrl.action": "Change Server URL",
-	"vs.cmd.server.changeUrl.enterNewSucc": "Enter new SuccBI server URL",
+	"vs.cmd.server.changeUrl.enterNewSucc": "Enter new SuccApp server URL",
 	"vs.cmd.server.changeUrl.invalidUrl": "Please enter a valid URL",
 	"vs.cmd.server.changeUrl.newServerUrl": "New server URL must be different from the current URL.",
 	"vs.cmd.server.changeUrl.noServers": "No servers configured. Please add one first.",
@@ -1027,6 +1108,51 @@
 	"vs.ui.workspaceProblem.showLogs": "Show Logs",
 	"vs.ui.workspaceProblem.staleBaseline": "SuccApp detected a stale local sync baseline. See logs for details before changing the workspace.",
 	"vs.ui.workspaceProblem.syncProblem": "SuccApp detected a workspace sync problem. See logs for details.",
+	"cli.cmd.model.title": "Model",
+	"cli.cmd.model.summary": "inspect and query semantic data models",
+	"cli.cmd.model.desc": "Inspect and query SuccApp semantic data models.",
+	"cli.cmd.model.list.summary": "List semantic models.",
+	"cli.cmd.model.list.desc": "List visible .tbl semantic models.",
+	"cli.cmd.model.list.project": "Filter models by project.",
+	"cli.cmd.model.list.type": "Filter models by model type.",
+	"cli.cmd.model.list.contains": "Filter models by text.",
+	"cli.cmd.model.list.limit": "Maximum returned model count.",
+	"cli.cmd.model.show.summary": "Show model metadata summary.",
+	"cli.cmd.model.show.desc": "Show semantic model metadata summary.",
+	"cli.cmd.model.show.detail": "Show detailed model summary.",
+	"cli.cmd.model.fields.summary": "List model fields.",
+	"cli.cmd.model.fields.desc": "List semantic model fields.",
+	"cli.cmd.model.fields.all": "Include hidden fields and extended properties.",
+	"cli.cmd.model.fields.contains": "Filter fields by name, title, or database field.",
+	"cli.cmd.model.fields.dim": "Only list dimension-key fields.",
+	"cli.cmd.model.fields.measure": "Only list measure fields.",
+	"cli.cmd.model.indexes.summary": "List model indexes.",
+	"cli.cmd.model.indexes.desc": "List primary keys, business keys, and model indexes.",
+	"cli.cmd.model.select.summary": "Select rows from one model.",
+	"cli.cmd.model.select.desc": "Select rows from one .tbl model with SuccApp expression filters.",
+	"cli.cmd.model.select.select": "Select fields, separated by commas. Can be repeated.",
+	"cli.cmd.model.select.where": "Filter expression, for example STATUS='ACTIVE'.",
+	"cli.cmd.model.select.order": "Sort expression, for example CREATE_TIME desc.",
+	"cli.cmd.model.select.limit": "Maximum returned row count.",
+	"cli.cmd.model.select.maxRows": "Maximum preview row count.",
+	"cli.cmd.model.query.summary": "Query models with Query DSL.",
+	"cli.cmd.model.query.desc": "Query one or more .tbl models with Query DSL JSON.\n\nJSON type: succ.meta.dw.Query in query.d.ts.\nOnline DTS: https://docs.succapp.com/dev-types/types/meta/file-types/query.d.ts\nWorkspace DTS: .agents/skills/succapp-docs/dev-types/types/meta/file-types/query.d.ts",
+	"cli.cmd.model.query.query": "Query DSL JSON.",
+	"cli.cmd.model.query.queryFile": "Read Query DSL JSON from a file.",
+	"cli.cmd.model.query.stdin": "Read Query DSL JSON from stdin.",
+	"cli.cmd.model.query.maxRows": "Maximum preview row count.",
+	"cli.cmd.model.query.empty": "Query executed successfully.",
+	"cli.cmd.model.export.summary": "Export model query results as CSV.",
+	"cli.cmd.model.export.desc": "Export one model or Query DSL result as CSV.",
+	"cli.cmd.model.export.select": "Select fields, separated by commas. Can be repeated.",
+	"cli.cmd.model.export.where": "Filter expression for single-model export.",
+	"cli.cmd.model.export.order": "Sort expression for single-model export.",
+	"cli.cmd.model.export.query": "Query DSL JSON.",
+	"cli.cmd.model.export.queryFile": "Read Query DSL JSON from a file.",
+	"cli.cmd.model.export.stdin": "Read Query DSL JSON from stdin.",
+	"cli.cmd.model.export.output": "Write CSV output to a local file.",
+	"cli.cmd.model.export.force": "Overwrite the output file if it already exists.",
+	"cli.cmd.model.export.exportedData": "Exported data to {0}",
 	"vs.cmd.title.addServer": "Add Server",
 	"vs.cmd.title.useServer": "Use Server",
 	"vs.cmd.title.loginServer": "Login Server",