@superzerodev/cli 0.1.0

package/dist/output.js

@@ -0,0 +1,56 @@
+/**
+ * CLI の出力（P0設計 §6.1 / §5.9）
+ *
+ * ★ --json のときは stdout に JSON 以外を一切書かない。
+ *   エージェントが JSON.parse する前提なので、進捗表示が混ざると壊れる。
+ *   人間向けのメッセージは stderr へ出す。
+ */
+import { formatChange, isSuperzeroError, wrapUnknown } from '@superzerodev/core';
+export const consoleWriter = {
+    out: (line) => process.stdout.write(`${line}\n`),
+    err: (line) => process.stderr.write(`${line}\n`),
+};
+export function renderPlan(plan, { json, writer }) {
+    if (json) {
+        writer.out(JSON.stringify({ changes: plan.changes, destructiveKeys: plan.destructiveKeys }, null, 2));
+        return;
+    }
+    const actionable = plan.changes.filter((c) => c.action !== 'noop');
+    if (actionable.length === 0) {
+        writer.out('No changes. Infrastructure is up to date.');
+        return;
+    }
+    for (const change of plan.changes) {
+        writer.out(formatChange(change));
+    }
+    writer.out('');
+    writer.out(`${actionable.length} change(s) to apply.`);
+    if (plan.destructiveKeys.length > 0) {
+        writer.err(`Warning: ${plan.destructiveKeys.length} destructive change(s): ${plan.destructiveKeys.join(', ')}`);
+    }
+}
+/**
+ * エラー出力。
+ * --json でも人間向けでも、必ず suggestedFix まで見せる。
+ * ここを削るとエージェントが自力で直せなくなる。
+ */
+export function renderError(raw, { json, writer }) {
+    const error = isSuperzeroError(raw) ? raw : wrapUnknown('cli', raw);
+    const payload = error.toJSON();
+    if (json) {
+        writer.out(JSON.stringify(payload, null, 2));
+        return 1;
+    }
+    writer.err(`Error [${payload.code}]: ${payload.message}`);
+    if (payload.suggestedFix) {
+        writer.err('');
+        writer.err(`  Fix: ${payload.suggestedFix.description}`);
+        if (payload.suggestedFix.command) {
+            writer.err(`  Run: ${payload.suggestedFix.command}`);
+        }
+    }
+    writer.err('');
+    writer.err(`  Docs: ${payload.docsUrl}`);
+    return 1;
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"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"}

package/dist/source-upload.d.ts

@@ -0,0 +1,34 @@
+/**
+ * プロジェクトを固めて Control Plane へ送る（指摘1の送り側）
+ *
+ * ★ CLI と MCP の両方がここを呼ぶ。2つ実装を持たない（§6.3）。
+ *   以前は CLI だけが workspaceDir を送り、MCP の plan は送っていなかった。
+ *   そのため同じ宣言でも、CLI と MCP で plan の答えが違っていた。
+ */
+import type { ControlPlaneClient } from './client.js';
+export interface UploadedProjectSource {
+    sourceId: string;
+    fileCount: number;
+    bytes: number;
+    /** ファイルの選び方。'git' なら .gitignore が効いている */
+    selection: 'git' | 'walk';
+}
+/** 宣言が compute を持つか。持たないなら送るものが無い */
+export declare function declaresCompute(rawConfig: unknown): boolean;
+/**
+ * compute を宣言している場合だけ、ソースを固めて送る。
+ * 送らなかった場合は undefined を返す。
+ */
+export declare function uploadProjectSource(client: ControlPlaneClient, environmentId: string, config: {
+    raw: unknown;
+    workspaceDir: string;
+}): Promise<UploadedProjectSource | undefined>;
+/**
+ * 何を送ったかを1行で説明する。
+ *
+ * ★ 必ず見せること。.gitignore が効くので
+ *   「手元にはあるのに送られていない」ファイルが出る。
+ *   黙って落とすと、動かない理由が誰にも分からなくなる。
+ */
+export declare function describeUpload(uploaded: UploadedProjectSource): string;
+//# sourceMappingURL=source-upload.d.ts.map

package/dist/source-upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-upload.d.ts","sourceRoot":"","sources":["../src/source-upload.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;CAC1B;AAED,qCAAqC;AACrC,wBAAgB,eAAe,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAM3D;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAW5C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAOtE"}

package/dist/source-upload.js

@@ -0,0 +1,44 @@
+/**
+ * プロジェクトを固めて Control Plane へ送る（指摘1の送り側）
+ *
+ * ★ CLI と MCP の両方がここを呼ぶ。2つ実装を持たない（§6.3）。
+ *   以前は CLI だけが workspaceDir を送り、MCP の plan は送っていなかった。
+ *   そのため同じ宣言でも、CLI と MCP で plan の答えが違っていた。
+ */
+import { formatBytes, packSource } from '@superzerodev/core';
+/** 宣言が compute を持つか。持たないなら送るものが無い */
+export function declaresCompute(rawConfig) {
+    return (typeof rawConfig === 'object' &&
+        rawConfig !== null &&
+        rawConfig.compute !== undefined);
+}
+/**
+ * compute を宣言している場合だけ、ソースを固めて送る。
+ * 送らなかった場合は undefined を返す。
+ */
+export async function uploadProjectSource(client, environmentId, config) {
+    if (!declaresCompute(config.raw))
+        return undefined;
+    const packed = await packSource(config.workspaceDir);
+    const uploaded = await client.uploadSource(environmentId, packed.archive);
+    return {
+        sourceId: uploaded.sourceId,
+        fileCount: packed.fileCount,
+        bytes: packed.bytes,
+        selection: packed.selection,
+    };
+}
+/**
+ * 何を送ったかを1行で説明する。
+ *
+ * ★ 必ず見せること。.gitignore が効くので
+ *   「手元にはあるのに送られていない」ファイルが出る。
+ *   黙って落とすと、動かない理由が誰にも分からなくなる。
+ */
+export function describeUpload(uploaded) {
+    return (`Uploaded ${uploaded.fileCount} file(s), ${formatBytes(uploaded.bytes)}` +
+        (uploaded.selection === 'git'
+            ? ' (files ignored by git were not sent).'
+            : ' (no git repository here; build directories were skipped).'));
+}
+//# sourceMappingURL=source-upload.js.map

package/dist/source-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-upload.js","sourceRoot":"","sources":["../src/source-upload.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAY5D,qCAAqC;AACrC,MAAM,UAAU,eAAe,CAAC,SAAkB;IAChD,OAAO,CACL,OAAO,SAAS,KAAK,QAAQ;QAC7B,SAAS,KAAK,IAAI;QACjB,SAAmC,CAAC,OAAO,KAAK,SAAS,CAC3D,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAA0B,EAC1B,aAAqB,EACrB,MAA8C;IAE9C,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IAElD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;IACpD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IACzE,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,QAA+B;IAC5D,OAAO,CACL,YAAY,QAAQ,CAAC,SAAS,aAAa,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;QACxE,CAAC,QAAQ,CAAC,SAAS,KAAK,KAAK;YAC3B,CAAC,CAAC,wCAAwC;YAC1C,CAAC,CAAC,4DAA4D,CAAC,CAClE,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@superzerodev/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@superzerodev/config": "0.1.0",
+    "@superzerodev/core": "0.1.0"
+  },
+  "bin": {
+    "superzero": "./dist/bin.js"
+  },
+  "description": "The Superzero CLI. Plan, apply and verify a whole app from one declaration file.",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mashihara/superzero.git",
+    "directory": "apps/cli"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "!dist/__tests__"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "tsc -p tsconfig.json && node --test \"dist/__tests__/*.test.js\""
+  }
+}