@norma-team/cli 0.1.0 → 0.1.1

package/README.md

@@ -14,10 +14,10 @@ only does the creative work of one task at a time.** Same dependency graph, same
 ## Install
 
 ```bash
-npm i -g @norma/cli     # provides the `norma` command
+npm i -g @norma-team/cli     # provides the `norma` command
 ```
 
-`@norma/cli` is a self-contained binary — the whole engine, adapters, and runtimes are
+`@norma-team/cli` is a self-contained binary — the whole engine, adapters, and runtimes are
 bundled in.
 
 ## Try it in 30 seconds

package/dist/index.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
+import { readFileSync, existsSync, writeFileSync } from 'node:fs';
 import { mkdir, appendFile, readFile, access, writeFile, readdir } from 'node:fs/promises';
-import { resolve, join, dirname, basename, extname } from 'node:path';
+import { join, resolve, dirname, basename, extname } from 'node:path';
 import { execFile, spawn } from 'node:child_process';
 import { Command } from 'commander';
 import * as p from '@clack/prompts';
-import { existsSync, readFileSync } from 'node:fs';
 import { createServer } from 'node:http';
 import { promisify } from 'node:util';
 
@@ -6473,6 +6473,67 @@ async function runPlanner(flags, r) {
   }
   return parseEpicPlan(JSON.parse(await readFile(outPath, "utf8")));
 }
+function parseDotenv(text2) {
+  const out = {};
+  for (const raw of text2.split(/\r?\n/)) {
+    const line = raw.trim();
+    if (!line || line.startsWith("#")) continue;
+    const eq = line.indexOf("=");
+    if (eq === -1) continue;
+    const key = line.slice(0, eq).trim();
+    let val = line.slice(eq + 1).trim();
+    if (val.startsWith('"') && val.endsWith('"') || val.startsWith("'") && val.endsWith("'")) {
+      val = val.slice(1, -1);
+    }
+    if (key) out[key] = val;
+  }
+  return out;
+}
+function loadDotenv(dir = process.cwd()) {
+  for (const name of [".env", ".env.local"]) {
+    const path = join(dir, name);
+    if (!existsSync(path)) continue;
+    try {
+      const parsed = parseDotenv(readFileSync(path, "utf8"));
+      for (const [k, v] of Object.entries(parsed)) {
+        if (process.env[k] === void 0) process.env[k] = v;
+      }
+    } catch {
+    }
+  }
+}
+function saveEnv(dir, entries) {
+  const path = join(dir, ".env");
+  const existing = existsSync(path) ? readFileSync(path, "utf8") : "";
+  const lines = existing ? existing.split(/\r?\n/) : [];
+  const seen = /* @__PURE__ */ new Set();
+  const next = lines.map((line) => {
+    const eq = line.indexOf("=");
+    if (eq === -1) return line;
+    const key = line.slice(0, eq).trim();
+    if (key in entries) {
+      seen.add(key);
+      return `${key}=${entries[key]}`;
+    }
+    return line;
+  });
+  for (const [k, v] of Object.entries(entries)) {
+    if (!seen.has(k)) next.push(`${k}=${v}`);
+  }
+  const body = `${next.join("\n").replace(/\n+$/, "")}
+`;
+  writeFileSync(path, body, "utf8");
+  return path;
+}
+function ensureGitignoreEnv(dir) {
+  const path = join(dir, ".gitignore");
+  const current = existsSync(path) ? readFileSync(path, "utf8") : "";
+  if (/^\.env(\.local)?\s*$/m.test(current) || /^\.env\*?\s*$/m.test(current)) return;
+  const suffix = current && !current.endsWith("\n") ? "\n" : "";
+  writeFileSync(path, `${current}${suffix}.env
+.env.local
+`, "utf8");
+}
 
 // src/mapping.ts
 var DEFAULT_LABELS = {
@@ -6604,6 +6665,20 @@ function check(value) {
   if (p.isCancel(value)) bail("Cancelled.");
   return value;
 }
+async function ensureSecret(envName, label, flags, collected, masked = true) {
+  if (process.env[envName]) return;
+  if (flags.yes) {
+    p.log.warn(`${envName} not set \u2014 export it (or add it to .env) to enable live access.`);
+    return;
+  }
+  const val = check(
+    masked ? await p.password({ message: `${label} (${envName})` }) : await p.text({ message: `${label} (${envName})` })
+  );
+  if (val) {
+    process.env[envName] = val;
+    collected[envName] = val;
+  }
+}
 function makeAdapter(kind, opts) {
   const bounceMarker = DEFAULT_LABELS.bounceMarker;
   if (kind === "linear") return new LinearAdapter({ team: opts.team, bounceMarker });
@@ -6654,6 +6729,7 @@ async function runInit(flags) {
     })
   );
   const trackerOptions = {};
+  const secrets = {};
   if (trackerKind === "linear") {
     trackerOptions.team = flags.yes ? flags.team ?? process.env.LINEAR_TEAM ?? "Redisco" : check(
       await p.text({
@@ -6661,8 +6737,7 @@ async function runInit(flags) {
         initialValue: flags.team ?? process.env.LINEAR_TEAM ?? ""
       })
     );
-    if (!process.env.LINEAR_API_KEY)
-      p.log.warn("LINEAR_API_KEY not set \u2014 set it to enable board introspection and runs.");
+    await ensureSecret("LINEAR_API_KEY", "Linear API key", flags, secrets);
   } else if (trackerKind === "jira") {
     trackerOptions.baseUrl = flags.yes ? flags.baseUrl ?? process.env.JIRA_BASE_URL : check(
       await p.text({
@@ -6676,6 +6751,8 @@ async function runInit(flags) {
         initialValue: flags.projectKey ?? process.env.JIRA_PROJECT ?? ""
       })
     );
+    await ensureSecret("JIRA_EMAIL", "Jira account email", flags, secrets, false);
+    await ensureSecret("JIRA_API_TOKEN", "Jira API token", flags, secrets);
   }
   let states = [];
   if (trackerKind !== "memory") {
@@ -6793,12 +6870,27 @@ async function runInit(flags) {
   ];
   const specs = dedupeByRole(roles.map(([role, stage]) => specForRole(role, stage)));
   const written = await writeAgents(agentsDir, specs);
+  let envLine = null;
+  if (Object.keys(secrets).length) {
+    const save = flags.yes ? true : check(
+      await p.confirm({
+        message: `Save ${Object.keys(secrets).join(", ")} to .env (gitignored)?`,
+        initialValue: true
+      })
+    );
+    if (save) {
+      const envPath = saveEnv(root, secrets);
+      ensureGitignoreEnv(root);
+      envLine = `secrets: ${Object.keys(secrets).join(", ")} \u2192 ${envPath} (gitignored)`;
+    }
+  }
   p.note(
     [
       `config:  ${configPath}`,
       `agents:  ${written.length} file(s) in ${agentsDir}`,
       `tracker: ${trackerKind}  \xB7  runtime: ${runtimeKind}`,
-      `workers: ${workers.join(", ")}`
+      `workers: ${workers.join(", ")}`,
+      ...envLine ? [envLine] : []
     ].join("\n"),
     "Generated"
   );
@@ -7405,8 +7497,12 @@ function registerWorktree(program2, resolved2) {
 }
 
 // src/index.ts
+loadDotenv();
+var { version: VERSION } = JSON.parse(
+  readFileSync(new URL("../package.json", import.meta.url), "utf8")
+);
 var program = new Command();
-program.name("norma").description("Norma \u2014 provider-agnostic orchestration for AI agent pipelines").version("0.1.0").option(
+program.name("norma").description("Norma \u2014 provider-agnostic orchestration for AI agent pipelines").version(VERSION).option(
   "-c, --config <path>",
   "path to a norma config JSON (default: discover norma.config.json)"
 ).option("--tracker <kind>", "override tracker kind (linear|jira|memory)").option("--runtime <kind>", "override agent runtime (claude-code|echo)");