@succsoft/succapp 5.0.5 → 5.0.6

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # CHANGELOG
 
+## 5.0.6(2026-07-18)
+
+- 新增 `db source probe <datasource>`，支持验证已有数据源连接；`db source test` 同时支持已有数据源和 JSON 配置，并统一返回 schema、数据库版本和驱动等结构化连接信息。
+- 新增 `succapp model search`，支持按路径、项目、模型属性和字段属性跨模型检索，以及忽略大小写的字面匹配和正则匹配。
+- 增强 `server file search`，支持按正文执行 AND/OR 字面或正则匹配，并返回命中片段和文件级警告。
+- 统一文件和模型搜索的相关度排序、结果数量限制与目录范围语义，裸关键词默认执行包含搜索，并完善结果元数据和终端展示。
+- 优化 SuccApp CLI 帮助：human 输出支持选项分组和按终端宽度换行，`--help --json` 提供版本化、可导航的结构化命令契约。
+- `server file open` 和 `workspace file open` 新增 `--no-open`，可仅返回页面 URL 而不启动系统浏览器。
+- 新增 `succapp server cache list` 和 `succapp server cache clean`，支持列出和清空服务器系统缓存。
+- `workspace file compile` 增加元数据内容版本检查，旧版文件会提示先升级，避免按当前 Schema 产生误报。
+
 ## 5.0.5(2026-07-06)
 
 - 新增 `succapp server file locate` 和 `succapp server file search`，支持按文件 id、路径、名称等条件定位和检索服务器文件。

package/README.md

@@ -10,7 +10,7 @@ SuccApp 的核心思路是把页面、仪表板、报表、数据模型、程序
 
 ## SuccApp CLI / 命令行工具
 
-SuccApp CLI 面向终端、脚本和 AI Agent，命令名为 `succapp`。它适合初始化工作区、连接服务器、查询状态、查看 diff、拉取和推送元数据、读取文件历史、解析页面地址、查询数据库结构，并用 `--json` 输出结构化结果。
+SuccApp CLI 面向终端、脚本和 AI Agent，命令名为 `succapp`。它适合初始化工作区、连接服务器、查询状态、查看 diff、拉取和推送元数据、读取文件历史、解析页面地址、查询数据库结构，并用 `--json` 输出结构化结果。需要人工阅读结构化结果时，可以使用 `--pretty-json` 输出格式化 JSON。
 
 Install:
 
@@ -32,6 +32,7 @@ succapp workspace init --server=<server-url>
 succapp auth login <server-url>
 succapp workspace project clone <project>
 succapp workspace status --json
+succapp workspace status --pretty-json
 succapp workspace file diff <path>
 succapp workspace push <path>
 ```

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

@@ -6,6 +6,8 @@
 	"err.net.connectionFailed": "Cannot connect to server: {url}{causeMessage}",
 	"err.net.connectionFailed.desc": "Check the server address and network connection, then retry or log in again.",
 	"err.login.notlogin": "Authentication failed, please log in again",
+	"err.login.busy": "The system is busy. Please try later!",
+	"err.login.busy.desc": "Possible causes include license limits on sessions or users, or database connection/query failures.",
 	"err.oauth2.tokenExpired": "OAuth2 access token expired.",
 	"err.login.oauthTimeout": "OAuth2 authorization timed out.",
 	"err.login.oauthTimeout.desc": "Restart login, complete authorization in the browser, or use PAT login in environments without a browser.",
@@ -37,6 +39,12 @@
 	"err.net.invalidUrl": "Invalid URL: {url}",
 	"err.meta.invalidPath": "Invalid metadata path",
 	"err.meta.invalidPath.desc": "Use a valid absolute metadata path and try again.",
+	"err.meta.invalidPath.relativeSearchQuery": "Relative search paths are not supported: {path}",
+	"err.meta.invalidPath.relativeSearchQuery.hint": "Use an absolute path beginning with '/', or a file name without '/'.",
+	"err.meta.invalidPath.parentDirGlob": "Glob wildcards are not supported in --parent-dir: {path}",
+	"err.meta.invalidPath.parentDirGlob.hint": "--parent-dir already searches recursively. Use --path='/DIR/*' to match direct children or --path for another glob.",
+	"err.meta.invalidPath.parentProjectMismatch": "Parent directory {path} does not belong to project {projectName}.",
+	"err.meta.invalidPath.parentProjectMismatch.hint": "Use a parent directory whose first path segment matches --project.",
 	"err.meta.projectExist": "A project with the same name already exists.",
 	"err.meta.projectname.illegal": "Invalid project name. Use letters, numbers, and underscores only, and keep it within 16 characters.",
 	"err.meta.projectname.reservedwords": "This project name is reserved by the system.",
@@ -61,7 +69,8 @@
 	"err.workspace.issue.E402": "SuccApp .gitignore rules are missing",
 	"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.E405": "Metadata validation support files are missing",
+	"err.workspace.issue.E405.hint": "Run 'succapp workspace init --scope dev', then retry the command.",
 	"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.",
@@ -82,10 +91,12 @@
 	"err.cli.unknownOption": "Unknown option: {option}",
 	"err.cli.missingOptionValue": "Option requires a value: {option}",
 	"err.cli.unexpectedOptionValue": "Option does not take a value: {option}",
-	"err.cli.missingArgument": "Missing required argument: {argument}.",
-	"err.cli.missingArgument.hint": "Usage: {usage}.",
+	"err.cli.missingArgument": "Missing required argument: {argument}",
+	"err.cli.missingArgument.hint": "Usage: {usage}",
 	"err.cli.tooManyArguments": "Too many arguments for {command}.",
 	"err.cli.tooManyArguments.hint": "This command accepts at most {max} positional argument(s).",
+	"err.cli.tooManyValues": "Too many values for {input}: received {actualItems}.",
+	"err.cli.tooManyValues.hint": "Provide at most {maxItems} values.",
 	"err.cli.missingInput": "Missing required input: {input}.",
 	"err.cli.missingInput.hint": "Provide the required input and retry.",
 	"err.cli.missingInput.hintWithSources": "Provide {sources} and retry.",
@@ -95,7 +106,7 @@
 	"err.cli.invalidUrl.hint": "Provide a full http:// or https:// URL.",
 	"err.cli.invalidPositiveInteger": "{input} must be a positive integer: {value}.",
 	"err.cli.invalidNonNegativeInteger": "{input} must be a non-negative integer: {value}.",
-	"err.cli.invalidNonNegativeIntegerRange": "{input} must be a non-negative integer no greater than {max}: {value}.",
+	"err.cli.invalidNonNegativeIntegerRange": "{input} must be an integer from {min} to {max}: {value}.",
 	"err.cli.invalidChoice": "Invalid value for {input}: {value}.",
 	"err.cli.invalidChoice.hint": "Expected one of: {allowedValues}.",
 	"err.cli.invalidKeyValue": "Invalid key=value for {input}: {value}.",
@@ -200,8 +211,6 @@
 	"workspace.sync.progress.upgradeMeta.checked": "Checked {0} metadata file(s): {1} upgradeable.",
 	"workspace.sync.progress.upgradeMeta.done": "Upgraded metadata files: {0} changed, {1} failed, {2} checked.",
 	"workspace.sync.progress.upgradeMeta.scan": "Scanning metadata files",
-	"workspace.validation.json.invalidJson": "Invalid JSON: {0}.",
-	"workspace.validation.json.jsonFileEmpty": "JSON file is empty.",
 	"cli.cmd.common.desc": "Common commands.",
 	"cli.cmd.common.summary": "common commands",
 	"cli.cmd.common.title": "Common",
@@ -212,6 +221,7 @@
 	"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.prettyJson": "Write formatted JSON for people; not intended for line-oriented scripts.",
 	"cli.opt.quiet": "Suppress progress and informational output.",
 	"cli.opt.server": "Use the specified server for commands that support it.",
 	"cli.opt.verbose": "Enable debug logging.",
@@ -246,7 +256,13 @@
 	"cli.cmd.db.summary": "inspect and operate server databases and data sources",
 	"cli.cmd.db.desc": "Inspect and operate server databases and data sources.",
 	"cli.cmd.db.dataSource": "Data source",
-	"cli.cmd.db.defaultSchema": "Default schema",
+	"cli.cmd.db.connection": "Connection",
+	"cli.cmd.db.defaultSchema": "Logical default schema",
+	"cli.cmd.db.databaseProduct": "Database product",
+	"cli.cmd.db.databaseVersion": "Database version",
+	"cli.cmd.db.databaseFullVersion": "Full database version",
+	"cli.cmd.db.driver": "JDBC driver",
+	"cli.cmd.db.driverVersion": "Driver version",
 	"cli.cmd.db.dryImport": "Dry run import",
 	"cli.cmd.db.dsConfigMust": "Datasource config must be a JSON object: {0}",
 	"cli.cmd.db.imported": "Imported",
@@ -268,18 +284,23 @@
 	"cli.cmd.db.sqlExecutedSuccess": "SQL executed successfully.",
 	"cli.cmd.db.sqlOrFileConflict": "Pass SQL either as <sql> or --file, not both.",
 	"cli.cmd.db.sqlUpdateCount": "SQL update count: {0}",
+	"cli.cmd.db.query.empty": "Query succeeded; 0 rows returned.",
 	"cli.cmd.db.tableOrQueryConflict": "Pass either <table> or --query/--query-file, not both.",
 	"cli.cmd.db.source.title": "Database source",
 	"cli.cmd.db.source.summary": "inspect and manage database sources",
 	"cli.cmd.db.source.desc": "Inspect and manage database sources.",
 	"cli.cmd.db.source.list.summary": "List visible data sources.",
 	"cli.cmd.db.source.list.desc": "List data sources visible to the active SuccApp server session.",
+	"cli.cmd.db.source.list.empty": "No data sources are available.",
 	"cli.cmd.db.source.show.summary": "Show a datasource configuration.",
 	"cli.cmd.db.source.show.desc": "Show a datasource configuration.",
-	"cli.cmd.db.source.test.summary": "Test a datasource connection.",
-	"cli.cmd.db.source.test.desc": "Test a datasource connection from a JSON configuration.",
+	"cli.cmd.db.source.probe.summary": "Validate an existing datasource and show its logical schema, database, and driver details.",
+	"cli.cmd.db.source.probe.desc": "Open and validate an existing datasource connection, then report its logical default schema, database product, normalized and full versions, and JDBC driver. JSON output also includes the sanitized datasource configuration.",
+	"cli.cmd.db.source.probe.datasource": "Name of the existing datasource to probe.",
+	"cli.cmd.db.source.test.summary": "Test connectivity for an existing datasource or an unsaved JSON configuration.",
+	"cli.cmd.db.source.test.desc": "Validate connectivity for an existing datasource, or for a JSON configuration without saving it. Both modes return the logical default schema, database versions, and JDBC driver details.",
+	"cli.cmd.db.source.test.datasource": "Name of the existing datasource to test.",
 	"cli.cmd.db.source.test.config": "Read datasource configuration JSON from a file, or use - for stdin.",
-	"cli.cmd.db.source.test.testOk": "Datasource connection succeeded: {0}",
 	"cli.cmd.db.source.create.summary": "Create a datasource.",
 	"cli.cmd.db.source.create.desc": "Create a datasource from a JSON configuration.",
 	"cli.cmd.db.source.create.config": "Read datasource configuration JSON from a file, or use - for stdin.",
@@ -301,12 +322,15 @@
 	"cli.cmd.db.schema.list.summary": "List schemas for a data source.",
 	"cli.cmd.db.schema.list.desc": "List schemas for a data source.",
 	"cli.cmd.db.schema.list.catalog": "Catalog",
+	"cli.cmd.db.schema.list.empty": "No schemas found for data source '{0}'.",
 	"cli.cmd.db.table.title": "Database table",
 	"cli.cmd.db.table.summary": "inspect database tables",
 	"cli.cmd.db.table.desc": "Inspect database tables.",
 	"cli.cmd.db.table.list.summary": "List tables for a data source.",
 	"cli.cmd.db.table.list.desc": "List tables for a data source.",
 	"cli.cmd.db.table.list.tableNameContains": "Filter tables by name. Supports * and ? wildcards.",
+	"cli.cmd.db.table.list.empty": "No tables are available.",
+	"cli.cmd.db.table.list.noMatches": "No tables matched the current filters.",
 	"cli.cmd.db.table.describe.summary": "Describe a database table.",
 	"cli.cmd.db.table.describe.desc": "Describe columns and metadata for a database table.",
 	"cli.cmd.db.table.describe.schema": "Schema name.",
@@ -360,14 +384,19 @@
 	"cli.cmd.server.cache.title": "Server cache",
 	"cli.cmd.server.cache.summary": "manage server cache",
 	"cli.cmd.server.cache.desc": "Manage server cache.",
-	"cli.cmd.server.cache.refresh.summary": "Refresh server cache.",
-	"cli.cmd.server.cache.refresh.desc": "Refresh server-side Dev Tool metadata cache.",
-	"cli.cmd.server.cache.refresh.refreshed": "Server cache refreshed: {0}",
+	"cli.cmd.server.cache.list.summary": "List server cache entries.",
+	"cli.cmd.server.cache.list.desc": "List server-side system cache entries (count, disk/memory usage, hit rate).",
+	"cli.cmd.server.cache.list.empty": "No server cache entries.",
+	"cli.cmd.server.cache.clean.summary": "Clean server cache.",
+	"cli.cmd.server.cache.clean.desc": "Clean a server-side system cache entry by <name>, or all caches with --all.",
+	"cli.cmd.server.cache.clean.all": "Clean all server cache entries.",
+	"cli.cmd.server.cache.clean.cleaned": "Server cache cleaned: {1} ({0})",
 	"cli.cmd.server.proj.title": "Server project",
 	"cli.cmd.server.proj.summary": "inspect server projects",
 	"cli.cmd.server.proj.desc": "Inspect server projects.",
 	"cli.cmd.server.proj.list.summary": "List server projects.",
 	"cli.cmd.server.proj.list.desc": "List projects visible on a server.",
+	"cli.cmd.server.proj.list.empty": "No visible projects found.",
 	"cli.cmd.server.proj.create.summary": "Create a server project.",
 	"cli.cmd.server.proj.create.desc": "Create a metadata project on a server.",
 	"cli.cmd.server.proj.create.descOption": "Set the project description.",
@@ -387,19 +416,28 @@
 	"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.list.empty": "Directory is empty: {0}",
 	"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.desc": "Search readable server metadata files by full path or by combinable project, parent-directory, and file-name filters.",
+	"cli.cmd.server.file.search.url": "Optional server URL. A lone non-URL argument is treated as <query>.",
+	"cli.cmd.server.file.search.query": "Starts with '/': full path or path glob. Contains '*' or '?': file name glob. Otherwise searches file metadata by keyword.",
+	"cli.cmd.server.file.search.path": "Search by an absolute metadata path glob; a project root searches recursively. Can be combined with a keyword <query>, but not with a path <query>, --project, --parent-dir, or --name.",
+	"cli.cmd.server.file.search.name": "Search by a file name glob; without wildcards, matches exactly. Can be combined with a keyword <query>, --project, and --parent-dir, but not with a glob <query> or --path.",
+	"cli.cmd.server.file.search.parentDir": "Search one absolute directory scope recursively. Glob wildcards are not supported; use --path='/DIR/*' for direct children. With --project, its first path segment must match the project name.",
+	"cli.cmd.server.file.search.project": "Match one project name. Can be combined with --parent-dir and --name.",
 	"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.limit": "Return at most this many most relevant files. Defaults to 50; maximum is 1000.",
 	"cli.cmd.server.file.search.includeFolders": "Include folders in the result.",
+	"cli.cmd.server.file.search.contentContains": "Require every repeated plain-text or /pattern/flags expression in text-file content. Plain text uses case-insensitive literal contains; regex defaults to multiline without flags. Values are not split on commas.",
+	"cli.cmd.server.file.search.contentContainsAny": "Require at least one repeated plain-text or /pattern/flags expression in text-file content. Plain text uses case-insensitive literal contains; regex defaults to multiline without flags. Values are not split on commas.",
+	"cli.cmd.server.file.search.empty": "No matching files.",
+	"cli.cmd.server.file.search.pathHint": "'{0}' is an exact metadata path. Use '{1}' to search recursively.",
+	"cli.cmd.server.file.search.nameHint": "File names match exactly without wildcards; wildcards are not added automatically.",
+	"cli.cmd.server.file.search.hasMore": "Only the {0} most relevant files are shown; add a project, directory, type, or more specific keyword to narrow the search.",
+	"cli.cmd.server.file.search.warningDetails": "Content was not checked; use --json for full details.",
 	"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.",
@@ -419,8 +457,10 @@
 	"cli.cmd.server.file.download.force": "Overwrite the local output file if it exists.",
 	"cli.cmd.server.file.download.downloaded": "Downloaded {0} to {1}",
 	"cli.cmd.server.file.open.summary": "Open the server file page.",
-	"cli.cmd.server.file.open.desc": "Open the server view or edit page for a server file path.",
-	"cli.cmd.server.file.open.edit": "Open the server edit page.",
+	"cli.cmd.server.file.open.desc": "Open the server view or edit page in the system browser, or return its URL without opening the browser.",
+	"cli.cmd.server.file.open.edit": "Open the server edit page instead of the view page.",
+	"cli.cmd.server.file.open.noOpen": "Return the page URL without launching the system browser.",
+	"cli.cmd.server.file.open.path": "Absolute server metadata path. The URL is constructed without checking whether the file exists.",
 	"cli.cmd.server.file.open.openedEdit": "Opened server edit page: {0}",
 	"cli.cmd.server.file.open.openedView": "Opened server view page: {0}",
 	"cli.cmd.server.file.history.summary": "Show server file history.",
@@ -556,6 +596,7 @@
 	"cli.cmd.workspace.proj.desc": "Manage workspace projects.",
 	"cli.cmd.workspace.proj.list.summary": "List workspace projects.",
 	"cli.cmd.workspace.proj.list.desc": "List workspace projects.",
+	"cli.cmd.workspace.proj.list.empty": "No projects are tracked in this workspace.",
 	"cli.cmd.workspace.proj.clone.summary": "Clone server projects into the workspace.",
 	"cli.cmd.workspace.proj.clone.desc": "Clone projects from the active server into the current workspace.",
 	"cli.cmd.workspace.proj.clone.force": "Allow clone to overwrite existing local workspace projects.",
@@ -597,8 +638,10 @@
 	"cli.cmd.workspace.file.resolve.remote": "Remote path: {0}",
 	"cli.cmd.workspace.file.resolve.viewUrl": "View URL: {0}",
 	"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.desc": "Open the server view or edit page for a workspace file, or return its URL without opening the browser.",
+	"cli.cmd.workspace.file.open.edit": "Open the server edit page instead of the view page.",
+	"cli.cmd.workspace.file.open.noOpen": "Return the page URL without launching the system browser.",
+	"cli.cmd.workspace.file.open.path": "Workspace-relative file path or absolute server metadata path.",
 	"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}",
@@ -611,19 +654,26 @@
 	"cli.cmd.workspace.file.show.badSource": "Invalid value for --source: {0}",
 	"cli.cmd.workspace.file.show.revSource": "--revision is only supported with --source=server.",
 	"cli.cmd.workspace.file.diff.summary": "Show workspace diff against server.",
-	"cli.cmd.workspace.file.diff.desc": "Show workspace diff against server.",
+	"cli.cmd.workspace.file.diff.desc": "Compare local workspace metadata files with server content. Inputs may be files, directories (recursively including all files), or globs.",
 	"cli.cmd.workspace.file.diff.source": "Compare against server content.",
 	"cli.cmd.workspace.file.diff.badSource": "Invalid value for --source: {0}",
 	"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.summary": "Validate workspace metadata files.",
+	"cli.cmd.workspace.file.compile.desc": "Validate local workspace metadata files. Inputs may be files, directories (recursively including all files), or globs.",
 	"cli.cmd.workspace.file.compile.compiler": "Compiler",
+	"cli.cmd.workspace.file.compile.done": "Validated {0} workspace metadata file(s).",
 	"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.compile.newerVersion": "{0} file(s) are newer than the active server and were skipped. Connect to a matching server, then validate again.",
+	"cli.cmd.workspace.file.compile.result": "Metadata validation result: {0} file(s), {1} passed, {2} failed",
+	"cli.cmd.workspace.file.compile.running": "Validating workspace metadata files",
+	"cli.cmd.workspace.file.compile.schemaFailed": "Metadata validation failed.",
+	"cli.cmd.workspace.file.compile.schemaFailedMsg": "Metadata validation failed: {0}",
+	"cli.cmd.workspace.file.compile.skipped": "Skipped files: {0}",
+	"cli.cmd.workspace.file.compile.upgradeRequired": "{0} file(s) require a metadata upgrade. Run `{1}` with the same pathspec, then validate again.",
 	"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.desc": "Preview or upgrade old SuccApp metadata files in the local workspace. Inputs may be files, directories (recursively including all files), or globs; with no input, all local projects are processed.",
 	"cli.cmd.workspace.file.upgrade.dryRun": "Preview upgrade candidates without changing files.",
 	"cli.cmd.workspace.file.upgrade.cands": "Upgrade candidates: {0}",
 	"cli.cmd.workspace.file.upgrade.dryRunRes": "Metadata upgrade dry-run: {0} checked, {1} candidate(s), {2} skipped, {3} failed",
@@ -639,6 +689,7 @@
 	"cli.cmd.workspace.lock.list.summary": "List locked workspace scopes.",
 	"cli.cmd.workspace.lock.list.desc": "List scopes currently locked in the SuccApp workspace.",
 	"cli.cmd.workspace.lock.list.scope": "Scope",
+	"cli.cmd.workspace.lock.list.empty": "No active workspace locks.",
 	"cli.cmd.workspace.lock.status.summary": "Show workspace lock holders.",
 	"cli.cmd.workspace.lock.status.desc": "Workspace lock status",
 	"cli.cmd.workspace.lock.status.heartbeat": "Last heartbeat",
@@ -657,6 +708,7 @@
 	"cli.cmd.workspace.backup.cleared": "Merge backup clear: {0} cleared, {1} remaining.",
 	"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.list.empty": "No merge backups found.",
 	"cli.cmd.workspace.backup.clear.summary": "Clear saved merge backups.",
 	"cli.cmd.workspace.backup.clear.desc": "Clear local versions saved before pull conflict handling.",
 	"cli.cmd.workspace.ext.title": "Workspace extension",
@@ -678,6 +730,7 @@
 	"cli.cmd.workspace.ext.push.force": "Allow local extension files to overwrite remote changes.",
 	"cli.cmd.workspace.ext.push.needNamePath": "Pass an extension name or --path=<path>.",
 	"cli.cmd.workspace.ext.push.onlyOne": "Use either <name> or --path=<path>, not both.",
+	"cli.out.search.score": "Score",
 	"cli.out.common.active": "Active",
 	"cli.out.common.api": "Dev Tool API",
 	"cli.out.common.baseline": "Baseline",
@@ -686,6 +739,7 @@
 	"cli.out.common.id": "ID",
 	"cli.out.common.jvmInfo": "JVM properties",
 	"cli.out.common.metaVersions": "Metadata versions",
+	"cli.out.common.noResults": "No results.",
 	"cli.out.common.noServers": "No servers configured.",
 	"cli.out.common.product": "Product",
 	"cli.out.common.productInfo": "Product information",
@@ -728,14 +782,41 @@
 	"cli.out.model.extractMode": "Extract mode",
 	"cli.out.model.fields": "Fields",
 	"cli.out.model.kind": "Kind",
+	"cli.out.model.matchedFields": "Matched fields",
 	"cli.out.model.primary": "Primary",
 	"cli.out.model.primaryKeys": "Primary keys",
+	"cli.out.model.profile": "Data profile",
+	"cli.out.model.profile.profiledRowCount": "Rows",
+	"cli.out.model.profile.sampled": "Sampled",
+	"cli.out.model.profile.nullCount": "Nulls",
+	"cli.out.model.profile.nullRate": "Null rate",
+	"cli.out.model.profile.distinctCount": "Distinct",
+	"cli.out.model.profile.minValue": "Min",
+	"cli.out.model.profile.maxValue": "Max",
+	"cli.out.model.profile.sum": "Sum",
+	"cli.out.model.profile.avg": "Average",
+	"cli.out.model.profile.median": "Median",
+	"cli.out.model.profile.p90": "P90",
+	"cli.out.model.profile.p95": "P95",
+	"cli.out.model.profile.zeroCount": "Zeros",
+	"cli.out.model.profile.negativeCount": "Negatives",
+	"cli.out.model.profile.topValues": "Top values",
+	"cli.out.model.profile.sampleValues": "Samples",
+	"cli.out.model.profile.estimatedProperties": "Estimated",
+	"cli.out.model.profile.unavailableProperties": "Unavailable",
+	"cli.out.model.role": "Role",
+	"cli.out.model.rowCount": "Row count",
 	"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.cacheDisk": "Disk",
+	"cli.out.header.cacheEntries": "Entries",
+	"cli.out.header.cacheHitRate": "Hit rate",
+	"cli.out.header.cacheMem": "Memory",
+	"cli.out.header.cacheName": "Cache",
 	"cli.out.header.column": "Column",
 	"cli.out.header.command": "Command",
 	"cli.out.header.comment": "Comment",
@@ -769,8 +850,16 @@
 	"cli.out.help.commandHelpRead": "Run 'succapp {0} <command> --help' to read about a specific command.",
 	"cli.out.help.commandHelpSee": "Run 'succapp <command> --help' to see command help.",
 	"cli.out.help.commands": "Commands",
+	"cli.out.help.arguments": "arguments:",
 	"cli.out.help.examples": "examples:",
-	"cli.out.help.options": "options:",
+	"cli.out.help.group.content": "content options:",
+	"cli.out.help.group.field": "field options:",
+	"cli.out.help.group.global": "global options:",
+	"cli.out.help.group.input": "input options:",
+	"cli.out.help.group.options": "options:",
+	"cli.out.help.group.output": "output options:",
+	"cli.out.help.group.query": "query options:",
+	"cli.out.help.group.search": "search options:",
 	"cli.out.help.usageHeader": "usage:",
 	"cli.out.help.usageLine": "usage: succapp {command} {usageArgs}",
 	"cli.out.human.error": "error: {0}",
@@ -832,6 +921,7 @@
 	"cli.input.activeServer": "active server",
 	"cli.input.contentSource": "content source",
 	"cli.input.dataSourceConfig": "data source config",
+	"cli.input.dataSourceTestTarget": "data source or data source config",
 	"cli.input.exportTarget": "export target",
 	"cli.input.extensionName": "extension name",
 	"cli.input.extensionNameOrPath": "extension name or path",
@@ -1111,23 +1201,48 @@
 	"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.search.summary": "Search semantic models.",
+	"cli.cmd.model.search.desc": "Search visible .tbl semantic models by full path or by combinable location, model-property, and field-property filters.",
+	"cli.cmd.model.search.query": "Starts with '/': full model path or path glob. Contains '*' or '?': model file name glob. Otherwise broadly searches model metadata or visible field metadata by keyword.",
+	"cli.cmd.model.search.path": "Search by an absolute model metadata path glob; a project root searches recursively. Can be combined with a keyword <query>, but not with a path <query>, --project, --parent-dir, or --name.",
+	"cli.cmd.model.search.name": "Search by a model file name glob; without wildcards, matches exactly. Can be combined with a keyword <query>, --project, and --parent-dir, but not with a glob <query> or --path.",
+	"cli.cmd.model.search.parentDir": "Search one absolute directory scope recursively. Glob wildcards are not supported; use --path='/DIR/*' for direct children. With --project, its first path segment must match the project name.",
+	"cli.cmd.model.search.project": "Match one project name. Can be combined with --parent-dir and --name.",
+	"cli.cmd.model.search.type": "Match Table.tableType values. Repeat or use comma-separated values; values are ORed.",
+	"cli.cmd.model.search.contains": "Require every value to match a model name, description, or physical table name (AND). Plain text uses case-insensitive contains; /pattern/flags uses regex with i (case-insensitive), m (multiline), and g (compatibility only; no effect).",
+	"cli.cmd.model.search.containsAny": "Match when any value matches a model name, description, or physical table name (OR). Plain text uses case-insensitive contains; /pattern/flags uses regex with i, m, and g (compatibility only; no effect).",
+	"cli.cmd.model.search.fieldContains": "Require every value to match a field name, description, physical name, or keyword (AND). Plain text uses case-insensitive contains; /pattern/flags uses regex with i (case-insensitive), m (multiline), and g (compatibility only; no effect).",
+	"cli.cmd.model.search.fieldContainsAny": "Match when any value matches a field name, description, physical name, or keyword (OR). Plain text uses case-insensitive contains; /pattern/flags uses regex with i, m, and g (compatibility only; no effect).",
+	"cli.cmd.model.search.fieldMatch": "Limit field-text matching to dim, measure, or all fields. Defaults to all.",
+	"cli.cmd.model.search.allFields": "Include hidden and extended fields in field-text matching.",
+	"cli.cmd.model.search.fieldLimit": "Maximum matched fields returned per model. Defaults to 5; valid range is 1 to 50.",
+	"cli.cmd.model.search.limit": "Return at most this many most relevant models. Defaults to 50; valid range is 1 to 200.",
+	"cli.cmd.model.search.empty": "No matching models.",
+	"cli.cmd.model.search.pathHint": "'{0}' is an exact model path. Use '{1}' to search recursively.",
+	"cli.cmd.model.search.nameHint": "Model names match exactly without wildcards; wildcards and the .tbl suffix are not added automatically.",
+	"cli.cmd.model.search.hasMore": "Only the {0} most relevant models are shown; add a project, directory, type, or more specific keyword to narrow the search.",
 	"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.profile.summary": "Profile one semantic model.",
+	"cli.cmd.model.profile.desc": "Return the model summary, current full metadata, and physical table row count. Human output is concise; use --json for the full metadata.",
+	"cli.cmd.model.fieldProfile.summary": "Profile selected model fields.",
+	"cli.cmd.model.fieldProfile.desc": "Inspect selected fields, inferred analytical roles, dimension attributes, and optional data statistics. Select 1 to 20 fields; aliases resolving to the same fieldPath are deduplicated.\n\nCapability depends on field type, data source, data volume, permissions, and masking. nullCount/nullRate apply to queryable fields. Numeric fields can use distinctCount, minValue, maxValue, sum, avg, zeroCount, negativeCount, topValues, and sampleValues. String/date fields can use distinctCount, minValue, maxValue, topValues, and sampleValues; boolean fields can use distinctCount, topValues, and sampleValues. median, p90, and p95 are accepted for protocol compatibility but currently return unsupported. Check dataProfile.unavailableProperties for the actual result. For unknown-size models, distinctCount/topValues run only after the visible row count is confirmed at 100,000 or less; million-scale models return costLimit. JSON sum/avg values are decimal strings to preserve precision.",
+	"cli.cmd.model.fieldProfile.field": "Field physical name, business name, or fieldPath. Repeat to select up to 20 fields; equivalent names are deduplicated by fieldPath.",
+	"cli.cmd.model.fieldProfile.dataProperty": "Data statistic to calculate. Repeat or use comma-separated values. Values: nullCount, nullRate, distinctCount, minValue, maxValue, sum, avg, median, p90, p95, zeroCount, negativeCount, topValues, sampleValues. Without this option, calculates nullCount, nullRate, distinctCount, minValue, and maxValue.",
+	"cli.cmd.model.fieldProfile.noData": "Do not scan field data; return semantic and dimension information only. Cannot be combined with --data-property.",
+	"cli.cmd.model.fieldProfile.topN": "Maximum topValues entries. Defaults to 20; valid range is 1 to 50.",
+	"cli.cmd.model.fieldProfile.sampleLimit": "Maximum sampleValues entries. Defaults to 10; valid range is 1 to 50.",
+	"cli.cmd.model.fieldProfile.dimensionAttributeDepth": "Dimension-attribute expansion depth. Defaults to 1; valid range is 0 to 3.",
 	"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.contains": "Match fields by name, title, or database field. Plain text uses case-insensitive contains; /pattern/flags uses regex with i, m, and g (compatibility only; no effect).",
 	"cli.cmd.model.fields.dim": "Only list dimension-key fields.",
 	"cli.cmd.model.fields.measure": "Only list measure fields.",
+	"cli.cmd.model.fields.empty": "No matching fields found.",
 	"cli.cmd.model.indexes.summary": "List model indexes.",
 	"cli.cmd.model.indexes.desc": "List primary keys, business keys, and model indexes.",
+	"cli.cmd.model.indexes.empty": "This model has no 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.",
@@ -1141,7 +1256,7 @@
 	"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.query.empty": "Query succeeded; 0 rows returned.",
 	"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.",