@inf-monkeys-tech/monkeys-cli 0.12.19 → 0.12.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inf-monkeys-tech/monkeys-cli",
-  "version": "0.12.19",
+  "version": "0.12.21",
   "packageManager": "bun@1.3.14",
   "description": "Monkeys command-line client for AI agents, automation, and interactive use",
   "type": "module",
@@ -107,11 +107,17 @@
       },
       "workflow": {
         "description": "Create, inspect, run, and transfer workflows"
+      },
+      "page": {
+        "description": "Manage declarative Page JSON drafts, releases, and runtime verification"
+      },
+      "navigation": {
+        "description": "Manage declarative Navigation JSON drafts and releases"
       }
     }
   },
   "dependencies": {
-    "@inf-monkeys-tech/monkeys": "1.0.71",
+    "@inf-monkeys-tech/monkeys": "1.1.10",
     "@oclif/core": "4.13.2",
     "ajv": "8.20.0",
     "csv-parse": "6.1.0",
@@ -144,5 +150,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "monkeysReleaseCommit": "7334872d28c1eef08316ed3c9c77998d01333927"
+  "monkeysReleaseCommit": "770ffd854008106961ef0300e5213ed78f6a445a"
 }

package/skills/monkeys-pages/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: monkeys-pages
+description: "Manage declarative Page and Navigation JSON with native monkeys commands: inspect, export, validate, import drafts, publish, inspect history, and roll back exact releases."
+---
+
+# Monkeys Pages and Navigation
+
+Read `monkeys skills read monkeys-shared`, then inspect `monkeys schema page publish` or `monkeys schema navigation publish` for the installed command contract.
+
+- Select an explicit `--subscription`. Pass `--team` for Studio. Kernel control scope is selected by the server; never guess namespace IDs.
+- Use `page list/get/export` and `navigation list/get/export` to inspect current configuration. Export writes complete JSON to a new file and refuses to overwrite files.
+- Edit canonical Page or Navigation JSON. Do not invent a second page DSL or replace these commands with `api call`.
+- Run `import --file <json> --dry-run` or `publish --file <json> --dry-run` before writes. Show the target, changes and blocking diagnostics. File preflight does not save drafts, allocate namespaces, install dependencies or prove release compilation.
+- `import --file <json> --yes` saves only a draft. `publish <id> --yes` publishes an existing draft; `publish --file <json> --yes` imports then publishes. These are separate stages; a draft can remain saved after a publication failure.
+- Choose `--surface`, `--environment`, `--placement`, `--route-index` or `--release-slot` when the target is ambiguous. Do not choose a different tenant or placement to bypass a failure.
+- Templates may be bound by the server. Live foreign scopes and immutable references must not be rewritten. Missing dependencies require an explicit operator action; never bulk-import unrelated catalogs.
+- Successful publication requires matching active Release and runtime readback. Runtime access denial does not authorize widening the audience.
+- `history <id>` lists definition history. `history <id> --release-slot <slot>` lists release history. `rollback <id> --release-slot <slot> --release-version <version> --dry-run` inspects an exact historical release; apply only with user authorization and `--yes`.
+- On `MUTATION_OUTCOME_UNKNOWN`, do not automatically replay writes. Read `get` and `history`. On `DECLARATIVE_PARTIAL_RESULT`, preserve the saved draft revision and inspect the failed stage before continuing.
+- Page and Navigation publication have separate scopes and receipts; never promise a cross-scope atomic publication.

package/skills/monkeys-pages/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: Monkeys Pages and Navigation
+  short_description: Manage declarative page and navigation releases
+  default_prompt: Use native monkeys page and navigation commands to inspect, validate, and publish the requested JSON configuration.

package/skills/monkeys-shared/references/compatibility.md

@@ -3,7 +3,7 @@
 - 本 Skill 面向命令 Schema Major `4`，最低 CLI 版本 `0.12.0`。
 - 开始任务时运行 `monkeys version show --output json`。
 - 任意结构化输出中的 `_notice.update` 表示 npm `latest` 高于当前 CLI；报告 `current`、`latest` 与 `command`。可用 `monkeys update --check --output json` 实时复核，只有用户明确授权后才运行 `monkeys update` 或 `monkeys update --force`。
-- `monkeys update` 只更新由 npm 或 pnpm 实际拥有的安装，精确安装目标版本，并验证 shell PATH、版本 envelope、全部 7 个同版本 Skills 的实际发现路径与校验和。任一最终验证失败都回滚到精确旧版本并返回结构化错误；用 `monkeys skills status` 检查实际漂移，用 `monkeys skills sync` 只重同步 Skills。
+- `monkeys update` 只更新由 npm 或 pnpm 实际拥有的安装，精确安装目标版本，并验证 shell PATH、版本 envelope、全部 8 个同版本 Skills 的实际发现路径与校验和。任一最终验证失败都回滚到精确旧版本并返回结构化错误；用 `monkeys skills status` 检查实际漂移，用 `monkeys skills sync` 只重同步 Skills。
 - CLI Major、命令 Schema Major 或 Skill 声明不兼容时停止写操作，升级匹配版本后再继续。
 - OpenAPI Snapshot 可动态刷新，但语义命令合同不会因刷新而被静默改写。
 - Data 合同由 Deployment 的 `data_contract=auto|ontology-v1|bucket-v1` 决定；`auto` 依次采用精确 OpenAPI、同一上下文缓存和有界只读探测。只有 Ontology 路由明确返回 404 时才探测旧 Bucket 路由。

package/skills/monkeys-workflow/references/workflow-execution-files.md

@@ -3,6 +3,7 @@
 ## Workflow
 
 - 先用 `workflow list/get` 解析精确 Workflow ID 和版本。
+- 只需确认运行输入时，优先用 `workflow get <workflowId> --view inputs` 获取精简的必填字段、枚举值、默认值与可见性条件；需要检查图结构或完整配置时再读取默认的完整定义。同一会话已核对且版本未变的工作流不要重复 list/get。
 - `workflow list` 顶层的 `effectiveTeamId` 表示本次请求使用的 Team；条目中的 `ownerTeamId` 表示资源归属 Team。两者不同不代表 CLI 切换了上下文。
 - 依据 `accessScope` 判断可见性：`team-owned` 是当前 Team 资源，`builtin-cross-team-readonly` 是可跨 Team 读取的内置资源，`cross-team-visible-unknown` 只表示服务端返回了其他 Team 资源，不能据此推断可写。
 - `isBuiltin` 和 `accessScope` 都不能替代服务端授权；跨 Team 可见资源默认只读，写操作必须依赖明确的服务端授权结果。