@native-marketing/cli 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,28 @@
-# Temporary Holding Version
+# @native-marketing/cli
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Node.js 24 authenticated Native Marketing CLI. One package supplies `cf` and `cf-agent`; both use `@native-marketing/sdk` and the same server capabilities. No database access, server administration, Runtime or automatic business execution.
+
+```sh
+npm install -g @native-marketing/cli
+cf help --json
+cf-agent help capabilities --json
+```
+
+Sign in to the exact resource using the existing OAuth flow:
+
+```sh
+cf auth login --resource https://ip.shipkitx.com/mcp/projects/PRJ-000003 \
+  --profile marketing --scope 'cf.context.read cf.survey.read' --json
+cf context --profile marketing --json
+cf capabilities find '当前定位' --profile marketing --json
+```
+
+Request the scopes needed for your authorized work. A project code or profile name does not grant access. Credentials are stored owner-only in `~/.config/content-factory-agent/` unless `CF_AGENT_CONFIG_DIR` is set. Never pass a token as a command argument. `auth import --token-file` accepts a protected local file; it does not exchange AgentStack API keys for Native OAuth.
+
+Help is layered: `help`, `help <group>`, `help all`. Discovery returns only currently visible capabilities; exact input schema is loaded on demand. `search` finds saved content. Supply exact business inputs through stdin or `--input-file`, keeping schema/view controls separate. Business writes require the existing request ID, concurrency checks and human authorization.
+
+`--json` returns one JSON envelope on stdout; OAuth interaction prompts go to stderr. Errors carry code, outcome and safe recovery details. UNKNOWN means the original write may have happened: query its original read-only receipt before deciding what to do. The CLI never automatically replays an unknown write. A receipt is the original result; reread current state separately. A lost write permission may still allow authorized receipt recovery, but cannot authorize a new write.
+
+The package exports its existing programmatic CLI surface and an `/agent` entry. Use `@native-marketing/sdk` for direct client APIs, or `@native-marketing/sdk/http` for typed HTTP calls. Installing or asking for help does not start work or a Runtime.
+
+The package's `release.json` identifies the source commit. Public availability does not change source licensing (UNLICENSED). Installation does not deploy or migrate a Native Marketing server.

package/dist/agent.js

@@ -0,0 +1,14 @@
+// apps/agent-cli/src/run.ts
+import { runNetworkCli } from "@native-marketing/sdk";
+var runAgentCli = (args, env, io) => runNetworkCli(args, env, io, "cf-agent");
+
+// apps/agent-cli/src/index.ts
+import {
+  withNativeAgentClient,
+  NativeAgentClientError
+} from "@native-marketing/sdk";
+export {
+  NativeAgentClientError,
+  runAgentCli,
+  withNativeAgentClient
+};

package/dist/cf-agent.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+
+// apps/agent-cli/src/run.ts
+import { runNetworkCli } from "@native-marketing/sdk";
+var runAgentCli = (args, env, io) => runNetworkCli(args, env, io, "cf-agent");
+
+// apps/agent-cli/src/index.ts
+import {
+  withNativeAgentClient,
+  NativeAgentClientError
+} from "@native-marketing/sdk";
+
+// apps/agent-cli/src/main.ts
+var result = await runAgentCli(process.argv.slice(2));
+process.stdout.write(
+  JSON.stringify(result.envelope, null, process.argv.includes("--json") ? void 0 : 2) + "\n"
+);
+process.exitCode = result.exitCode;

package/dist/cf.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+
+// apps/cli/src/index.ts
+import { runNetworkCli } from "@native-marketing/sdk";
+import {
+  withNativeAgentClient,
+  NativeAgentClientError
+} from "@native-marketing/sdk";
+
+// apps/cli/src/main.ts
+var result = await runNetworkCli(process.argv.slice(2));
+process.stdout.write(
+  JSON.stringify(result.envelope, null, process.argv.includes("--json") ? void 0 : 2) + "\n"
+);
+process.exitCode = result.exitCode;

package/dist/index.js

@@ -0,0 +1,11 @@
+// apps/cli/src/index.ts
+import { runNetworkCli } from "@native-marketing/sdk";
+import {
+  withNativeAgentClient,
+  NativeAgentClientError
+} from "@native-marketing/sdk";
+export {
+  NativeAgentClientError,
+  runNetworkCli as runCli,
+  withNativeAgentClient
+};

package/package.json

@@ -1,6 +1,41 @@
 {
   "name": "@native-marketing/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=24 <25"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SENLIN746/native-marketing.git"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist/",
+    "types/",
+    "README.md",
+    "release.json"
+  ],
+  "description": "Native Marketing authenticated CLI; cf and cf-agent share the public SDK",
+  "bin": {
+    "cf": "./dist/cf.js",
+    "cf-agent": "./dist/cf-agent.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./types/cli/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./agent": {
+      "types": "./types/agent/index.d.ts",
+      "default": "./dist/agent.js"
+    }
+  },
+  "dependencies": {
+    "@native-marketing/sdk": "0.1.1"
+  }
+}

package/release.json

@@ -0,0 +1,7 @@
+{
+  "sourceCommit": "d5c864b995aaa63230e895df3d7cbe50d4947202",
+  "workingTreeDirty": false,
+  "version": "0.1.1",
+  "openapiTypesSha256": "ab00b08c6f94b2b39d7f4010de2335d70be26e7987e9db6dc57fa308426aecc4",
+  "localBuild": true
+}

package/types/agent/index.d.ts

@@ -0,0 +1,2 @@
+export { runAgentCli } from './run.js';
+export { withNativeAgentClient, NativeAgentClientError, type NativeAgentClient, type NativeReadView, type NativeToolOptions, type NativeToolResult, } from '@native-marketing/sdk';

package/types/agent/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/types/agent/run.d.ts

@@ -0,0 +1,23 @@
+import { runNetworkCli } from '@native-marketing/sdk';
+export declare const runAgentCli: (args: Parameters<typeof runNetworkCli>[0], env?: Parameters<typeof runNetworkCli>[1], io?: Parameters<typeof runNetworkCli>[2]) => Promise<{
+    exitCode: number;
+    envelope: {
+        ok: boolean;
+        command: string;
+        data: null;
+        error: {
+            code: string;
+            message: string;
+            outcome: "NOT_SENT" | "REJECTED" | "UNKNOWN";
+            details?: Record<string, unknown>;
+        };
+    };
+} | {
+    exitCode: number;
+    envelope: {
+        ok: boolean;
+        command: string;
+        data: unknown;
+        error: null;
+    };
+}>;

package/types/cli/index.d.ts

@@ -0,0 +1,2 @@
+export { runNetworkCli as runCli } from '@native-marketing/sdk';
+export { withNativeAgentClient, NativeAgentClientError, type NativeAgentClient, type NativeReadView, type NativeToolOptions, type NativeToolResult, } from '@native-marketing/sdk';

package/types/cli/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};