@stalfh233/omc-cli 0.5.0 → 0.5.2

package/dist/rule-support.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { wireCall, wireRows, WireError } from "./wire.js";
 import { ENDPOINTS } from "./endpoints.js";
+import { readModelRecord } from "./model-record.js";
 import { ToolRefusalError } from "./tool-types.js";
 import { decodeJsonColumn, JSON_COLUMN_NULL_COALESCE } from "./json-column.js";
 import { RULE_BIZ_RULE_TYPE_DESCRIPTION, RULE_CREATE_BODY, RULE_ROUTES_DESCRIPTION, ruleNodeGraphDescription, schedulerSettingDescription, } from "./lanes/businessrule-contract.js";
@@ -602,17 +603,10 @@ export async function assertRuleSchemaExists(session, schemaCode) {
     // SCHEMA_NOT_FOUNT_ERR (10011 业务模型不存在) on miss — the same facade
     // primitive the rule faces rely on. The fake answers ok+null for an absent
     // schema, so BOTH signals decode as a miss.
-    let missing = false;
-    try {
-        const probe = await wireCall(session, { path: ENDPOINTS.modelGet, query: { schemaCode } });
-        missing = probe.data == null;
-    }
-    catch (error) {
-        if (error instanceof WireError && error.kind === "business" && error.errcode === 10011)
-            missing = true;
-        else
-            throw error;
-    }
+    // Version-tolerant: 8.1 has no `/bizmodels/get_all` (404) and serves the same
+    // rows from `/bizmodels/list_schema`; see model-record.ts.
+    const record = await readModelRecord(session, schemaCode);
+    const missing = record === null;
     if (missing) {
         throw new ToolRefusalError({
             status: "refused",

package/dist/server.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { randomBytes } from "node:crypto";
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { buildToolRegistry, makeToolContext } from "./tools.js";
+import { SessionManager } from "./session-manager.js";
+import { redact, redactError } from "./redact.js";
+import { ConfigStore } from "./config-store.js";
+import { contractMarkdown, contractResourceUri, LANE_CONTRACTS, shortToolDescription } from "./contract-resources.js";
+import { listSkills, readSkill } from "./skills.js";
+export function createMcpServer(options = {}) {
+    const context = makeToolContext({
+        sessions: options.sessions ?? new SessionManager(new ConfigStore()),
+        artifactsDir: options.artifactsDir,
+        tokenKey: options.tokenKey ?? randomBytes(32).toString("base64"),
+        tokenTtlMs: options.tokenTtlMs,
+    });
+    const secrets = options.secrets ?? (() => []);
+    const server = new McpServer({ name: "omc-cli", version: "0.1.0" }, {
+        capabilities: { tools: {}, resources: {} },
+        instructions: "Governed CloudPivot 8.6 configuration server. Tool schemas are self-describing (field families, relation options, rule nodeGraph, workflow template, formData, and the two-step approval flow). Methodology is served as MCP resources under omc://skills/ (five-piece flow, tool selection, acceptance criteria, requirement analysis, capability scouting, glossary, config draft review); read them with resources/list + resources/read rather than reading repository source. Before ANY write, read omc://skills/omc-config-draft-review: present the design (exact names/codes/types, layout, rule graph, view) as a plain-language draft and get explicit human approval first — the conversational human gate (approval granularity is the enumerated change package; an interrupted package loses its approval and resuming needs a fresh draft and go-ahead). Then: call without approvalToken to preview the plan, approval.request to get a token (the machine gate — it carries no human check), re-call with it. Production environments refuse writes by default (dual-key grant). Deliver ONE closing report per run — never interrupt per step.",
+    });
+    const register = server.tool.bind(server);
+    for (const definition of buildToolRegistry()) {
+        register(definition.name, shortToolDescription(definition.name, definition.kind, definition.lane) ?? definition.description, definition.inputSchema, async (args) => {
+            try {
+                const result = await definition.handler(context, args, definition);
+                return { content: [{ type: "text", text: redact(result, secrets()) }] };
+            }
+            catch (error) {
+                const refusal = error.payload;
+                if (refusal)
+                    return { content: [{ type: "text", text: redact(refusal, secrets()) }] };
+                const redacted = redactError(error, secrets());
+                return { content: [{ type: "text", text: redact({ status: "error", message: redacted.message }, secrets()) }], isError: true };
+            }
+        });
+    }
+    registerSkillResources(server);
+    registerContractResources(server);
+    return { server, context };
+}
+/**
+ * Serve the package's methodology notes as MCP resources so any client can
+ * read them on demand (host-agnostic) instead of the agent globbing the
+ * filesystem for them. Each skill file's YAML frontmatter supplies its name
+ * and description.
+ */
+function registerSkillResources(server) {
+    for (const entry of listSkills()) {
+        const document = readSkill(entry.name);
+        if (document === undefined)
+            continue;
+        server.registerResource(entry.name, entry.uri, { title: entry.name, description: entry.description, mimeType: "text/markdown" }, async (uri) => ({ contents: [{ uri: uri.href, mimeType: "text/markdown", text: document.content }] }));
+    }
+}
+function registerContractResources(server) {
+    for (const contract of LANE_CONTRACTS) {
+        const text = contractMarkdown(contract);
+        server.registerResource(`contract-${contract.lane}`, contractResourceUri(contract), {
+            title: `${contract.lane} contract`,
+            description: `CloudPivot ${contract.family} contract for ${contract.lane}; reference ${contract.referenceVersion}`,
+            mimeType: "text/markdown",
+        }, async (uri) => ({ contents: [{ uri: uri.href, mimeType: "text/markdown", text }] }));
+    }
+}
+export async function runStdioServer(options = {}) {
+    const { server } = createMcpServer(options);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+function isProcessEntryPoint() {
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    try {
+        return realpathSync(entry) === fileURLToPath(import.meta.url);
+    }
+    catch {
+        return false;
+    }
+}
+if (isProcessEntryPoint()) {
+    runStdioServer().catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    });
+}
+export { buildToolRegistry, makeToolContext };
+//# sourceMappingURL=server.js.map

package/dist/session.js

@@ -21,6 +21,13 @@ export class CloudPivotSession {
     tokenCache;
     loginResult;
     version;
+    /**
+     * Non-fatal login caveats (e.g. the `client` blob in system/config was
+     * absent or unreadable, so the token request carried no client_secret).
+     * Doctor reports these as WARN so a deployment shape difference never reads
+     * as "环境不可达".
+     */
+    loginNotesValue = [];
     httpAdapter;
     fingerprintOf;
     constructor(environmentName, profile, credential, http, systemConfig = undefined, requestTimeoutMs = defaultRequestTimeoutMs(), tokenCache) {
@@ -101,6 +108,7 @@ export class CloudPivotSession {
             password: this.credential.password,
             ...(systemConfig ? { systemConfig } : {}),
         });
+        this.loginNotesValue = authenticator.loginNotes();
         this.version = detectVersion(systemConfig);
         this.tokenCache?.save({
             token: this.loginResult.token,
@@ -115,6 +123,10 @@ export class CloudPivotSession {
     detectedVersion() {
         return this.version;
     }
+    /** Non-fatal login caveats; empty when the login was fully nominal. */
+    loginNotes() {
+        return this.loginNotesValue;
+    }
     token() {
         if (!this.loginResult)
             throw new Error("session is not logged in");

package/dist/skills.js

@@ -11,6 +11,16 @@ import { fileURLToPath } from "node:url";
  * makes `git help <concept>` reliable and a docs-site link unreliable.
  */
 const skillsDir = join(dirname(fileURLToPath(import.meta.url)), "..", "skills");
+/**
+ * Methodology files are read as text on every platform, so normalize the line
+ * ending at the read boundary. A Windows checkout (`core.autocrlf`) otherwise
+ * adds one byte per line: the `omc help` bodies drift from the golden masters,
+ * the context-cost budgets inflate by ~1.2 KB, and every help payload carries
+ * stray `\r` into JSON. The shipped bytes are LF; make every host agree.
+ */
+function normalizeLineEndings(text) {
+    return text.includes("\r\n") ? text.replace(/\r\n/g, "\n") : text;
+}
 function frontmatterDescription(text) {
     const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(text);
     const line = match?.[1]?.split(/\r?\n/).find((entry) => entry.startsWith("description:"));
@@ -30,7 +40,7 @@ export function listSkills() {
         const name = file.replace(/\.md$/, "");
         let description = `OMC methodology: ${name}`;
         try {
-            description = frontmatterDescription(readFileSync(join(skillsDir, file), "utf8")) ?? description;
+            description = frontmatterDescription(normalizeLineEndings(readFileSync(join(skillsDir, file), "utf8"))) ?? description;
         }
         catch {
             // Unreadable file still lists by name; reading it reports the error.
@@ -46,7 +56,7 @@ export function readSkill(name) {
     if (entry === undefined)
         return undefined;
     try {
-        return { ...entry, content: readFileSync(join(skillsDir, `${name}.md`), "utf8") };
+        return { ...entry, content: normalizeLineEndings(readFileSync(join(skillsDir, `${name}.md`), "utf8")) };
     }
     catch {
         return undefined;

package/docs/images/omc-nixi/README.md

@@ -1,41 +1,41 @@
-# 截图占位目录（尼西实战案例）
-
-`omc-introduction.md` 的「15. 实战一：尼西双表单与流程搭建」章节里引用了 9 张截图。
-把截图按下面文件名放进本目录即可，文档中的占位说明可逐条删除。
-
-## 客户源需求（3 张）
-
-| 文件名 | 内容 |
-|---|---|
-| `01-requirement-ft-sheet.png` | 客户 Excel 的 `FT` Sheet（字段清单 / 必填 / LotClass 显隐） |
-| `02-requirement-fp-sheet.png` | 客户 Excel 的 `FP` Sheet |
-| `03-requirement-flow.png` | 客户给的流程图（FT/FP，含 `SubConRootCause=1` 分支） |
-
-## 对话截图（6 张）
-
-| 文件名 | 内容 |
-|---|---|
-| `04-chat-app-create.png` | 确认新建应用 + `app.create ok` |
-| `05-chat-intent-apply.png` | `intent apply` 返回 `DELIVERED` + `equivalent: true`（89 个动作） |
-| `06-chat-workflow-role.png` | 流程节点与角色路由（PIC→蔡依涛 / MOS→赵益 / AOSIT / AOSENG） |
-| `07-chat-permission-matrix.png` | 节点字段权限矩阵（本节点 + 之前所有节点可见） |
-| `08-chat-biz-integration.png` | `service.register` 注册 productType 服务 + `method.test` 返回 `PRODUCT_TYPE=MOS` |
-| `09-chat-onlinejs-publish.png` | `onlinejs.compose` 返回 `published: true` |
-
-## 替换方式
-
-文档里每处占位是：
-
-```
-> **[截图 01｜客户源需求：FT 表单规格]**
-> 占位文件：`docs/images/omc-nixi/01-requirement-ft-sheet.png`
-> 建议内容：...
-```
-
-落地后改成标准图片引用即可：
-
-```markdown
-![客户源需求：FT 表单规格](images/omc-nixi/01-requirement-ft-sheet.png)
-```
-
-建议截图宽度 ≥ 1200px，避免中文文字模糊。
+# 截图占位目录（尼西实战案例）
+
+`omc-introduction.md` 的「15. 实战一：尼西双表单与流程搭建」章节里引用了 9 张截图。
+把截图按下面文件名放进本目录即可，文档中的占位说明可逐条删除。
+
+## 客户源需求（3 张）
+
+| 文件名 | 内容 |
+|---|---|
+| `01-requirement-ft-sheet.png` | 客户 Excel 的 `FT` Sheet（字段清单 / 必填 / LotClass 显隐） |
+| `02-requirement-fp-sheet.png` | 客户 Excel 的 `FP` Sheet |
+| `03-requirement-flow.png` | 客户给的流程图（FT/FP，含 `SubConRootCause=1` 分支） |
+
+## 对话截图（6 张）
+
+| 文件名 | 内容 |
+|---|---|
+| `04-chat-app-create.png` | 确认新建应用 + `app.create ok` |
+| `05-chat-intent-apply.png` | `intent apply` 返回 `DELIVERED` + `equivalent: true`（89 个动作） |
+| `06-chat-workflow-role.png` | 流程节点与角色路由（PIC→蔡依涛 / MOS→赵益 / AOSIT / AOSENG） |
+| `07-chat-permission-matrix.png` | 节点字段权限矩阵（本节点 + 之前所有节点可见） |
+| `08-chat-biz-integration.png` | `service.register` 注册 productType 服务 + `method.test` 返回 `PRODUCT_TYPE=MOS` |
+| `09-chat-onlinejs-publish.png` | `onlinejs.compose` 返回 `published: true` |
+
+## 替换方式
+
+文档里每处占位是：
+
+```
+> **[截图 01｜客户源需求：FT 表单规格]**
+> 占位文件：`docs/images/omc-nixi/01-requirement-ft-sheet.png`
+> 建议内容：...
+```
+
+落地后改成标准图片引用即可：
+
+```markdown
+![客户源需求：FT 表单规格](images/omc-nixi/01-requirement-ft-sheet.png)
+```
+
+建议截图宽度 ≥ 1200px，避免中文文字模糊。