@forwardimpact/map 0.14.0 → 0.15.1

package/bin/fit-map.js

@@ -12,9 +12,12 @@
  *   --help                      Show help
  */
 
-import { stat } from "fs/promises";
+import fs from "fs/promises";
 import { join, resolve, dirname } from "path";
 import { fileURLToPath } from "url";
+import { homedir } from "os";
+import { Finder } from "@forwardimpact/libutil";
+import { createLogger } from "@forwardimpact/libtelemetry";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -48,46 +51,31 @@ function parseArgs(args) {
   return { command, subcommand, options, positional: rest };
 }
 
-/**
- * Check if a directory exists
- */
-async function dirExists(path) {
-  try {
-    const stats = await stat(path);
-    return stats.isDirectory();
-  } catch {
-    return false;
-  }
-}
-
 /**
  * Find the data directory
+ * @param {string|undefined} providedPath - Explicit path from --data flag
+ * @returns {Promise<string>} Resolved data directory path
  */
 async function findDataDir(providedPath) {
   if (providedPath) {
     const resolved = resolve(providedPath);
-    if (await dirExists(resolved)) {
-      return resolved;
+    try {
+      await fs.access(resolved);
+    } catch {
+      throw new Error(`Data directory not found: ${providedPath}`);
     }
-    throw new Error(`Data directory not found: ${providedPath}`);
+    return resolved;
   }
 
-  const candidates = [
-    join(process.cwd(), "data/pathway"),
-    join(process.cwd(), "examples/pathway"),
-    join(process.cwd(), "data"),
-    join(process.cwd(), "examples"),
-  ];
-
-  for (const candidate of candidates) {
-    if (await dirExists(candidate)) {
-      return candidate;
-    }
+  const logger = createLogger("map");
+  const finder = new Finder(fs, logger, process);
+  try {
+    return join(finder.findData("data", homedir()), "pathway");
+  } catch {
+    throw new Error(
+      "No data directory found. Use --data=<path> to specify location.",
+    );
   }
-
-  throw new Error(
-    "No data directory found. Use --data=PATH to specify location.",
-  );
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forwardimpact/map",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "description": "Public data model for career frameworks, consumed by AI agents and engineers",
   "license": "Apache-2.0",
   "repository": {
@@ -46,12 +46,12 @@
     "./activity/transform": "./activity/transform/index.js"
   },
   "dependencies": {
-    "ajv": "^8.17.1",
+    "ajv": "^8.18.0",
     "ajv-formats": "^3.0.1",
-    "yaml": "^2.3.4"
+    "yaml": "^2.8.3"
   },
   "devDependencies": {
-    "n3": "^2.0.1"
+    "n3": "^2.0.3"
   },
   "engines": {
     "node": ">=18.0.0"

package/schema/json/stages.schema.json

@@ -60,6 +60,13 @@
           "items": {
             "type": "string"
           }
+        },
+        "returnFormat": {
+          "type": "array",
+          "description": "Expected outputs when completing this stage",
+          "items": {
+            "type": "string"
+          }
         }
       },
       "additionalProperties": false

package/src/loader.js

@@ -284,8 +284,12 @@ export class DataLoader {
   async loadQuestionFolder(questionsDir) {
     const [skillProficiencies, behaviourMaturities, capabilityLevels] =
       await Promise.all([
-        this.#loadQuestionsFromDir(join(questionsDir, "skills")),
-        this.#loadQuestionsFromDir(join(questionsDir, "behaviours")),
+        this.#loadQuestionsFromDir(join(questionsDir, "skills")).catch(
+          () => ({}),
+        ),
+        this.#loadQuestionsFromDir(join(questionsDir, "behaviours")).catch(
+          () => ({}),
+        ),
         this.#loadQuestionsFromDir(join(questionsDir, "capabilities")).catch(
           () => ({}),
         ),
@@ -367,21 +371,13 @@ export class DataLoader {
     const tracksDir = join(dataDir, "tracks");
     const behavioursDir = join(dataDir, "behaviours");
 
-    const [
-      disciplineFiles,
-      trackFiles,
-      behaviourFiles,
-      vscodeSettings,
-      devcontainer,
-      copilotSetupSteps,
-    ] = await Promise.all([
-      this.#loadDisciplinesFromDir(disciplinesDir),
-      this.#loadTracksFromDir(tracksDir),
-      this.#loadBehavioursFromDir(behavioursDir),
-      this.#loadRepoFile(dataDir, "vscode-settings.yaml", {}),
-      this.#loadRepoFile(dataDir, "devcontainer.yaml", {}),
-      this.#loadRepoFile(dataDir, "copilot-setup-steps.yaml", null),
-    ]);
+    const [disciplineFiles, trackFiles, behaviourFiles, claudeCodeSettings] =
+      await Promise.all([
+        this.#loadDisciplinesFromDir(disciplinesDir),
+        this.#loadTracksFromDir(tracksDir),
+        this.#loadBehavioursFromDir(behavioursDir),
+        this.#loadRepoFile(dataDir, "claude-code-settings.yaml", {}),
+      ]);
 
     const disciplines = disciplineFiles
       .filter((d) => d.agent)
@@ -408,9 +404,7 @@ export class DataLoader {
       disciplines,
       tracks,
       behaviours,
-      vscodeSettings,
-      devcontainer,
-      copilotSetupSteps,
+      claudeCodeSettings,
     };
   }