@forwardimpact/schema 0.1.0

package/examples/tracks/sre.yaml

@@ -0,0 +1,48 @@
+# yaml-language-server: $schema=https://schema.forwardimpact.team/json/track.schema.json
+
+name: SRE
+
+# Shared content (used by both human job descriptions and agent profiles)
+description:
+  Site Reliability Engineering focus on system reliability, observability, and
+  incident response
+roleContext:
+  In this Site Reliability Engineering role, you will focus on system
+  reliability, observability, and incident response. You will ensure our
+  services meet their reliability targets while driving continuous improvement
+  in system resilience and operational excellence.
+
+# Derivation inputs - used by both human and agent profiles
+skillModifiers:
+  scale: 1
+  reliability: 1
+  delivery: -1
+behaviourModifiers:
+  outcome_ownership: 1
+  relentless_curiosity: 1
+assessmentWeights:
+  skillWeight: 0.6
+  behaviourWeight: 0.4
+
+# Agent-specific content
+agent:
+  identity: |
+    You are an SRE {roleTitle} agent. Your primary focus is 
+    system reliability, observability, and incident response.
+  priority: |
+    Reliability is non-negotiable. You instrument everything, design for 
+    graceful degradation, and maintain error budgets. Every change 
+    considers blast radius and recovery paths.
+
+    Production stability trumps feature velocity. No change ships without
+    understanding its impact on system reliability.
+  beforeMakingChanges:
+    - Understand system dependencies and failure modes
+    - Ensure observability instrumentation is in place
+    - Consider rollback procedures and blast radius
+    - Verify runbooks are updated
+  constraints:
+    - Never compromise on observability instrumentation
+    - Document all runbooks and incident response procedures
+    - Verify failover mechanisms regularly
+    - Consider blast radius for all changes

package/examples/vscode-settings.yaml

@@ -0,0 +1,21 @@
+# Enable coding agent
+chat.agent.enabled: true
+
+# Maximum requests per agent session (high limit for complex tasks)
+chat.agent.maxRequests: 999
+
+# Enable edits v2 for improved code editing
+chat.edits2.enabled: true
+
+# Enable extension unification for consistent behavior
+chat.extensionUnification.enabled: true
+
+# Enable custom agents to be used as subagents
+# Required for multi-agent workflows with handoffs
+chat.customAgentInSubagent.enabled: true
+
+# Enable agent skills for enhanced agent capabilities
+chat.useAgentSkills: true
+
+# Enable skill adherence prompt to improve agent compliance with defined skills
+chat.experimental.useSkillAdherencePrompt: true

package/lib/index-generator.js

@@ -0,0 +1,65 @@
+/**
+ * Directory Index Generator
+ *
+ * Generates _index.yaml files for browser-based directory discovery.
+ * These files list all entity files in a directory.
+ */
+
+import { readdir, writeFile } from "fs/promises";
+import { join, basename } from "path";
+import { stringify as stringifyYaml } from "yaml";
+
+/**
+ * Generate _index.yaml for a directory
+ * @param {string} dir - Directory path
+ * @returns {Promise<string[]>} List of file IDs included
+ */
+export async function generateDirIndex(dir) {
+  const files = await readdir(dir);
+  const yamlFiles = files.filter(
+    (f) => f.endsWith(".yaml") && !f.startsWith("_"),
+  );
+
+  const fileIds = yamlFiles.map((f) => basename(f, ".yaml")).sort();
+
+  const content = stringifyYaml(
+    {
+      // Auto-generated index for browser loading
+      // Do not edit manually - regenerate with: npx pathway --generate-index
+      files: fileIds,
+    },
+    { lineWidth: 0 },
+  );
+
+  // Add header comment
+  const output = `# Auto-generated index for browser loading
+# Do not edit manually - regenerate with: npx pathway --generate-index
+${content}`;
+
+  await writeFile(join(dir, "_index.yaml"), output, "utf-8");
+
+  return fileIds;
+}
+
+/**
+ * Generate all index files for the data directory
+ * @param {string} dataDir - Path to the data directory
+ * @returns {Promise<Object>} Summary of generated indexes
+ */
+export async function generateAllIndexes(dataDir) {
+  const directories = ["behaviours", "disciplines", "tracks", "capabilities"];
+
+  const results = {};
+
+  for (const dir of directories) {
+    const fullPath = join(dataDir, dir);
+    try {
+      const files = await generateDirIndex(fullPath);
+      results[dir] = files;
+    } catch (err) {
+      results[dir] = { error: err.message };
+    }
+  }
+
+  return results;
+}

package/lib/index.js

@@ -0,0 +1,44 @@
+/**
+ * @forwardimpact/schema
+ *
+ * Schema definitions, data validation, and loading for Engineering Pathway.
+ */
+
+// Data loading
+export {
+  loadAllData,
+  loadYamlFile,
+  createDataLoader,
+  loadFrameworkConfig,
+  loadQuestionFolder,
+  loadQuestionBankFromFolder,
+  loadSelfAssessments,
+  loadExampleData,
+  loadAndValidate,
+  loadAgentData,
+  loadSkillsWithAgentData,
+} from "./loader.js";
+
+// Referential integrity validation
+export {
+  validateAllData,
+  validateQuestionBank,
+  validateSelfAssessment,
+  validateAgentData,
+} from "./validation.js";
+
+// Schema-based validation
+export {
+  validateDataDirectory,
+  validateReferentialIntegrity,
+  runSchemaValidation,
+} from "./schema-validation.js";
+
+// Index generation
+export { generateAllIndexes, generateDirIndex } from "./index-generator.js";
+
+// Type constants and helpers
+export * from "./levels.js";
+
+// Capability validation helper
+export { isCapability } from "./modifiers.js";