@forwardimpact/libcodegen 0.1.61 → 0.1.64

package/bin/fit-codegen.js

@@ -316,17 +316,9 @@ async function executeGeneration(codegens, sourcePath, flags) {
  * @param {string[]} protoDirs - Discovered proto directories
  * @param {string} projectRoot - Project root directory path
  * @param {object} finder - Finder instance for path management
+ * @param {object} parsedFlags - Parsed generation flags
  */
-async function runCodegen(protoDirs, projectRoot, finder) {
-  const parsedFlags = parseFlags();
-
-  if (!parsedFlags.hasGenerationFlags()) {
-    cli.usageError(
-      "no generation flags specified (use --all, --type, --service, --client, --definition, or --metadata)",
-    );
-    process.exit(2);
-  }
-
+async function runCodegen(protoDirs, projectRoot, finder, parsedFlags) {
   const generatedStorage = createStorage("generated", "local");
   const sourcePath = generatedStorage.path();
 
@@ -375,6 +367,17 @@ async function runCodegen(protoDirs, projectRoot, finder) {
  */
 async function main() {
   try {
+    // Flags must parse before project-root and proto discovery: --help and
+    // --version have to exit 0 from a bare directory, and discovery throws
+    // outside a proto-bearing project.
+    const parsedFlags = parseFlags();
+    if (!parsedFlags.hasGenerationFlags()) {
+      cli.usageError(
+        "no generation flags specified (use --all, --type, --service, --client, --definition, or --metadata)",
+      );
+      process.exit(2);
+    }
+
     const logger = new Logger("codegen", runtime);
     // The shared runtime.finder carries a no-op logger; bind this CLI's logger
     // so createPackageSymlinks (the one logging Finder consumer) keeps emitting
@@ -391,7 +394,7 @@ async function main() {
       );
     }
 
-    await runCodegen(protoDirs, projectRoot, finder);
+    await runCodegen(protoDirs, projectRoot, finder, parsedFlags);
   } catch (err) {
     const logger = new Logger("codegen", runtime);
     logger.exception("main", err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/libcodegen",
-  "version": "0.1.61",
+  "version": "0.1.64",
   "description": "Protobuf code generation — keep types in sync with proto definitions without hand-writing.",
   "keywords": [
     "codegen",
@@ -20,10 +20,10 @@
     {
       "user": "Platform Builders",
       "goal": "Keep Service Contracts Typed",
-      "trigger": "Adding a proto definition and realizing the JavaScript types are already stale.",
-      "bigHire": "keep types in sync with proto definitions without hand-writing.",
+      "trigger": "A service contract changes and the drift surfaces at runtime, in a client, an endpoint, or an MCP tool that no longer matches the proto.",
+      "bigHire": "generate types, clients, endpoints, and MCP tools from one proto source so contracts cannot drift.",
       "littleHire": "change a proto definition and trust the JavaScript types follow.",
-      "competesWith": "manual type definitions; hoping hand-written types match; skipping types entirely"
+      "competesWith": "hand-rolled clients and JSON contracts; per-service endpoint boilerplate; hand-written MCP wrappers; trusting that callers and services agree"
     }
   ],
   "type": "module",
@@ -52,7 +52,7 @@
     "@forwardimpact/libutil": "^0.1.64",
     "@grpc/proto-loader": "^0.8.1",
     "mustache": "^4.2.0",
-    "protobufjs": "^7.6.1",
+    "protobufjs": "^7.6.3",
     "protobufjs-cli": "1.2.2"
   },
   "devDependencies": {