@ze-norm/cli 0.12.0 → 0.14.1

package/dist/config/environments.js

@@ -0,0 +1,65 @@
+import { CliError } from "../util/errors.js";
+import { PRODUCTION_API_URL, PRODUCTION_CLERK_CLIENT_ID, PRODUCTION_CLERK_ISSUER, } from "./defaults.js";
+const PROD_ENVIRONMENT = {
+    name: "prod",
+    apiUrl: PRODUCTION_API_URL,
+    clerkIssuer: PRODUCTION_CLERK_ISSUER,
+    clerkClientId: PRODUCTION_CLERK_CLIENT_ID,
+};
+export const ZENORM_CLI_ENV_VAR = "ZENORM_CLI";
+const ENV_NAMES = ["prod", "dev", "local"];
+/**
+ * Normalize a raw `ZENORM_CLI` value to a canonical env name. Accepts the bare
+ * name (`prod`/`dev`/`local`), `production`, and each name with a `-zenorm`
+ * suffix (constructed here so the suffixed literal is never a static token).
+ */
+function parseEnvName(raw) {
+    const key = raw.trim().toLowerCase();
+    if (key === "production")
+        return "prod";
+    for (const name of ENV_NAMES) {
+        if (key === name || key === `${name}-zenorm`)
+            return name;
+    }
+    return null;
+}
+/**
+ * Build a non-prod environment from the endpoint env vars injected by the
+ * repo launchers. Fails loud if they are missing — that means the public
+ * `zenorm` was pointed at an internal stack without the launcher that carries
+ * its (non-shipped) endpoints, and we must not silently fall back to prod.
+ */
+function environmentFromInjectedVars(name) {
+    const apiUrl = process.env["ZENORM_API_URL"];
+    const clerkIssuer = process.env["ZENORM_CLERK_ISSUER"];
+    const clerkClientId = process.env["ZENORM_CLERK_CLIENT_ID"];
+    if (!apiUrl || !clerkIssuer || !clerkClientId) {
+        const shim = `${name}${"-zenorm"}`;
+        throw new CliError(`${ZENORM_CLI_ENV_VAR}=${name} needs the ${name} endpoints, which are not ` +
+            `bundled in the public CLI. Launch it with \`${shim}\` (from the repo), ` +
+            `or set ZENORM_API_URL, ZENORM_CLERK_ISSUER, and ZENORM_CLERK_CLIENT_ID.`);
+    }
+    return { name, apiUrl, clerkIssuer, clerkClientId };
+}
+/**
+ * Resolve the active CLI environment from `ZENORM_CLI`.
+ *
+ * Unset → production (the public default). A set-but-unrecognized value is a
+ * loud error rather than a silent fallback: a typo like `ZENORM_CLI=prd` must
+ * not quietly send `zenorm` commands at the wrong stack.
+ */
+export function resolveEnvironment() {
+    const raw = process.env[ZENORM_CLI_ENV_VAR];
+    if (raw === undefined || raw.trim() === "") {
+        return PROD_ENVIRONMENT;
+    }
+    const name = parseEnvName(raw);
+    if (!name) {
+        const allowed = ENV_NAMES.join(", ");
+        throw new CliError(`Invalid ${ZENORM_CLI_ENV_VAR}=${JSON.stringify(raw)}. ` +
+            `Expected one of: ${allowed} (or a "-zenorm" suffixed form).`);
+    }
+    if (name === "prod")
+        return PROD_ENVIRONMENT;
+    return environmentFromInjectedVars(name);
+}

package/dist/config/schema.d.ts

@@ -1,6 +1,16 @@
 export interface ZenormConfig {
     org?: string;
     apiUrl?: string;
+    /**
+     * Opt into coding-agent mode for local `zenorm work` runs: instead of running
+     * each task headlessly, launch the active coding agent (the one named by
+     * `--agent`) as a LIVE interactive session seeded with the spec handoff. The
+     * operator works with the agent, then closes it to release the worker and
+     * continue to the next task. Off by default; the `--interactive` flag
+     * overrides this. Requires a usable local TTY at run time (fails loud
+     * otherwise — see `interactive-agent.ts`).
+     */
+    interactive?: boolean;
 }
 export declare function validateConfig(raw: unknown): ZenormConfig;
 //# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAuBzD"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CA8BzD"}

package/dist/config/schema.js

@@ -17,5 +17,11 @@ export function validateConfig(raw) {
         }
         config.apiUrl = obj["apiUrl"];
     }
+    if ("interactive" in obj) {
+        if (typeof obj["interactive"] !== "boolean") {
+            throw new CliError('.zenorm.json: "interactive" must be a boolean');
+        }
+        config.interactive = obj["interactive"];
+    }
     return config;
 }

package/dist/util/markdown.d.ts

@@ -21,4 +21,20 @@ export type SpecBlock = {
  * the agent sees a clean "## goals", "## acceptance_criterion" structure.
  */
 export declare function blocksToMarkdown(blocks: SpecBlock[]): string;
+export type AttachmentRecord = {
+    id: string;
+    fileName: string;
+    fileSize: number;
+    mimeType: string;
+    status: string;
+};
+/**
+ * Render the spec's ready attachments as an "## Attachments" markdown section
+ * for the worker work context. Lists fileName — mimeType — pretty size only;
+ * the file CONTENT/bytes are never inlined (binary can't be, and no AC needs
+ * download). Callers must pass ONLY ready attachments — the server is the gate
+ * (the `?status=ready` filter), this renderer does not re-filter. Returns an
+ * empty string when there are none so `pull` can omit the section.
+ */
+export declare function attachmentsToMarkdown(attachments: AttachmentRecord[]): string;
 //# sourceMappingURL=markdown.d.ts.map

package/dist/util/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/util/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAmB1D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAqB1E;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACvC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CA+B5D"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/util/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAmB1D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAqB1E;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACvC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CA+B5D;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAmBF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAO7E"}

package/dist/util/markdown.js

@@ -77,6 +77,40 @@ export function blocksToMarkdown(blocks) {
     }
     return out.join("\n").trimEnd();
 }
+/**
+ * Render a human-readable byte size (e.g. 1536 → "1.5 KB"). Used for the
+ * attachments listing only — purely cosmetic.
+ */
+function prettySize(bytes) {
+    if (!Number.isFinite(bytes) || bytes < 0)
+        return `${bytes} B`;
+    const units = ["B", "KB", "MB", "GB"];
+    let value = bytes;
+    let unit = 0;
+    while (value >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit += 1;
+    }
+    const rounded = unit === 0 ? value : Math.round(value * 10) / 10;
+    return `${rounded} ${units[unit]}`;
+}
+/**
+ * Render the spec's ready attachments as an "## Attachments" markdown section
+ * for the worker work context. Lists fileName — mimeType — pretty size only;
+ * the file CONTENT/bytes are never inlined (binary can't be, and no AC needs
+ * download). Callers must pass ONLY ready attachments — the server is the gate
+ * (the `?status=ready` filter), this renderer does not re-filter. Returns an
+ * empty string when there are none so `pull` can omit the section.
+ */
+export function attachmentsToMarkdown(attachments) {
+    if (attachments.length === 0)
+        return "";
+    const out = ["## Attachments", ""];
+    for (const a of attachments) {
+        out.push(`- ${a.fileName} — ${a.mimeType} — ${prettySize(a.fileSize)}`);
+    }
+    return out.join("\n");
+}
 function humanizeType(type) {
     return type.split("_").map((s) => s.charAt(0).toUpperCase() + s.slice(1)).join(" ");
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ze-norm/cli",
   "private": false,
-  "version": "0.12.0",
+  "version": "0.14.1",
   "license": "SEE LICENSE IN README.md",
   "type": "module",
   "repository": {