@rolexjs/local-platform 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,52 @@
+import { Platform, Organization, Feature, Goal, Plan, Task } from '@rolexjs/core';
+
+/**
+ * LocalPlatform — Local filesystem implementation of Platform.
+ *
+ * Everything lives under a single .rolex/ directory.
+ * rolex.json manages organization relationships (including teams).
+ *
+ * Directory convention:
+ *   <rootDir>/rolex.json                          ← Organization config
+ *   <rootDir>/<role>/identity/*.identity.feature   ← Identity features
+ *   <rootDir>/<role>/goals/<name>/<name>.goal.feature
+ *   <rootDir>/<role>/goals/<name>/<name>.plan.feature
+ *   <rootDir>/<role>/goals/<name>/tasks/<name>.task.feature
+ */
+
+declare class LocalPlatform implements Platform {
+    private readonly rootDir;
+    private config;
+    constructor(rootDir: string);
+    found(name: string): void;
+    organization(): Organization;
+    born(name: string, source: string): Feature;
+    hire(name: string): void;
+    fire(name: string): void;
+    growup(roleId: string, type: "knowledge" | "experience" | "voice", name: string, source: string): Feature;
+    identity(roleId: string): Feature[];
+    activeGoal(roleId: string): (Goal & {
+        plan: Plan | null;
+        tasks: Task[];
+    }) | null;
+    createGoal(roleId: string, name: string, source: string, testable?: boolean): Goal;
+    createPlan(roleId: string, source: string): Plan;
+    createTask(roleId: string, name: string, source: string, testable?: boolean): Task;
+    completeGoal(roleId: string, experience?: string): void;
+    abandonGoal(roleId: string, experience?: string): void;
+    completeTask(roleId: string, name: string): void;
+    private loadConfig;
+    private saveConfig;
+    private resolveRoleDir;
+    private getActiveGoalDir;
+    private toFeature;
+    private extractScenarios;
+    private loadPlan;
+    private loadTasks;
+    private detectIdentityType;
+    private findFeatureFile;
+    private addTag;
+    private addDoneTag;
+}
+
+export { LocalPlatform };

package/dist/index.js

@@ -0,0 +1,278 @@
+// src/LocalPlatform.ts
+import { readdirSync, readFileSync, writeFileSync, mkdirSync, existsSync, rmSync } from "fs";
+import { join, basename } from "path";
+import { parse } from "@rolexjs/parser";
+var LocalPlatform = class {
+  rootDir;
+  config = null;
+  constructor(rootDir) {
+    this.rootDir = rootDir;
+  }
+  // ========== Found ==========
+  found(name) {
+    mkdirSync(this.rootDir, { recursive: true });
+    const config = {
+      name,
+      teams: { default: [] }
+    };
+    this.saveConfig(config);
+  }
+  // ========== Organization ==========
+  organization() {
+    const config = this.loadConfig();
+    const roles = [];
+    for (const [teamName, roleNames] of Object.entries(config.teams)) {
+      for (const roleName of roleNames) {
+        roles.push({
+          name: roleName,
+          team: teamName
+        });
+      }
+    }
+    return { name: config.name, roles };
+  }
+  // ========== Born ==========
+  born(name, source) {
+    const roleDir = join(this.rootDir, name);
+    const identityDir = join(roleDir, "identity");
+    mkdirSync(identityDir, { recursive: true });
+    const filePath = join(identityDir, "persona.identity.feature");
+    writeFileSync(filePath, source, "utf-8");
+    const doc = parse(source);
+    return this.toFeature(doc.feature, "persona");
+  }
+  hire(name) {
+    const roleDir = join(this.rootDir, name);
+    if (!existsSync(join(roleDir, "identity", "persona.identity.feature"))) {
+      throw new Error(`Role not found: ${name}. Call born() first.`);
+    }
+    mkdirSync(join(roleDir, "goals"), { recursive: true });
+    const config = this.loadConfig();
+    const [firstTeam] = Object.keys(config.teams);
+    if (!config.teams[firstTeam].includes(name)) {
+      config.teams[firstTeam].push(name);
+      this.saveConfig(config);
+    }
+  }
+  fire(name) {
+    const roleDir = join(this.rootDir, name);
+    const goalsDir = join(roleDir, "goals");
+    if (!existsSync(goalsDir)) {
+      throw new Error(`Role not hired: ${name}`);
+    }
+    rmSync(goalsDir, { recursive: true, force: true });
+    const config = this.loadConfig();
+    for (const teamName of Object.keys(config.teams)) {
+      const idx = config.teams[teamName].indexOf(name);
+      if (idx !== -1) {
+        config.teams[teamName].splice(idx, 1);
+        break;
+      }
+    }
+    this.saveConfig(config);
+  }
+  // ========== Growup ==========
+  growup(roleId, type, name, source) {
+    const roleDir = this.resolveRoleDir(roleId);
+    const dir = join(roleDir, "identity");
+    mkdirSync(dir, { recursive: true });
+    const filePath = join(dir, `${name}.${type}.identity.feature`);
+    writeFileSync(filePath, source, "utf-8");
+    const doc = parse(source);
+    return this.toFeature(doc.feature, type);
+  }
+  // ========== Query ==========
+  identity(roleId) {
+    const roleDir = this.resolveRoleDir(roleId);
+    const dir = join(roleDir, "identity");
+    if (!existsSync(dir)) return [];
+    return readdirSync(dir).filter((f) => f.endsWith(".identity.feature")).sort().map((f) => {
+      const source = readFileSync(join(dir, f), "utf-8");
+      const doc = parse(source);
+      return this.toFeature(doc.feature, this.detectIdentityType(f));
+    });
+  }
+  activeGoal(roleId) {
+    const roleDir = this.resolveRoleDir(roleId);
+    const goalsDir = join(roleDir, "goals");
+    if (!existsSync(goalsDir)) return null;
+    const goalDirs = readdirSync(goalsDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name).sort();
+    for (const goalName of goalDirs) {
+      const goalDir = join(goalsDir, goalName);
+      const goalFile = this.findFeatureFile(goalDir, ".goal.feature");
+      if (!goalFile) continue;
+      const source = readFileSync(goalFile, "utf-8");
+      const doc = parse(source);
+      if (!doc.feature) continue;
+      if (doc.feature.tags.some((t) => t.name === "@done" || t.name === "@abandoned")) continue;
+      const goal = this.toFeature(doc.feature, "goal");
+      return {
+        ...goal,
+        plan: this.loadPlan(goalDir),
+        tasks: this.loadTasks(goalDir)
+      };
+    }
+    return null;
+  }
+  // ========== Write ==========
+  createGoal(roleId, name, source, testable) {
+    const roleDir = this.resolveRoleDir(roleId);
+    const goalDir = join(roleDir, "goals", name);
+    mkdirSync(goalDir, { recursive: true });
+    if (testable) source = `@testable
+${source}`;
+    const filePath = join(goalDir, `${name}.goal.feature`);
+    writeFileSync(filePath, source, "utf-8");
+    const doc = parse(source);
+    return this.toFeature(doc.feature, "goal");
+  }
+  createPlan(roleId, source) {
+    const roleDir = this.resolveRoleDir(roleId);
+    const goalDir = this.getActiveGoalDir(roleDir);
+    if (!goalDir) throw new Error("No active goal");
+    const goalName = basename(goalDir);
+    const filePath = join(goalDir, `${goalName}.plan.feature`);
+    writeFileSync(filePath, source, "utf-8");
+    const doc = parse(source);
+    return this.toFeature(doc.feature, "plan");
+  }
+  createTask(roleId, name, source, testable) {
+    const roleDir = this.resolveRoleDir(roleId);
+    const goalDir = this.getActiveGoalDir(roleDir);
+    if (!goalDir) throw new Error("No active goal");
+    const tasksDir = join(goalDir, "tasks");
+    mkdirSync(tasksDir, { recursive: true });
+    if (testable) source = `@testable
+${source}`;
+    const filePath = join(tasksDir, `${name}.task.feature`);
+    writeFileSync(filePath, source, "utf-8");
+    const doc = parse(source);
+    return this.toFeature(doc.feature, "task");
+  }
+  // ========== Close ==========
+  completeGoal(roleId, experience) {
+    const roleDir = this.resolveRoleDir(roleId);
+    const goalDir = this.getActiveGoalDir(roleDir);
+    if (!goalDir) throw new Error("No active goal");
+    const goalFile = this.findFeatureFile(goalDir, ".goal.feature");
+    this.addDoneTag(goalFile);
+    if (experience) {
+      const goalName = basename(goalDir);
+      this.growup(roleId, "experience", goalName, experience);
+    }
+  }
+  abandonGoal(roleId, experience) {
+    const roleDir = this.resolveRoleDir(roleId);
+    const goalDir = this.getActiveGoalDir(roleDir);
+    if (!goalDir) throw new Error("No active goal");
+    const goalFile = this.findFeatureFile(goalDir, ".goal.feature");
+    this.addTag(goalFile, "@abandoned");
+    if (experience) {
+      const goalName = basename(goalDir);
+      this.growup(roleId, "experience", goalName, experience);
+    }
+  }
+  completeTask(roleId, name) {
+    const roleDir = this.resolveRoleDir(roleId);
+    const goalDir = this.getActiveGoalDir(roleDir);
+    if (!goalDir) throw new Error("No active goal");
+    const tasksDir = join(goalDir, "tasks");
+    const taskFile = join(tasksDir, `${name}.task.feature`);
+    if (!existsSync(taskFile)) throw new Error(`Task not found: ${name}`);
+    this.addDoneTag(taskFile);
+  }
+  // ========== Internal ==========
+  loadConfig() {
+    if (this.config) return this.config;
+    const configPath = join(this.rootDir, "rolex.json");
+    if (existsSync(configPath)) {
+      this.config = JSON.parse(readFileSync(configPath, "utf-8"));
+      return this.config;
+    }
+    throw new Error(`No rolex.json found in ${this.rootDir}. Call found() first.`);
+  }
+  saveConfig(config) {
+    writeFileSync(join(this.rootDir, "rolex.json"), JSON.stringify(config, null, 2), "utf-8");
+    this.config = config;
+  }
+  resolveRoleDir(roleId) {
+    const roleDir = join(this.rootDir, roleId);
+    if (!existsSync(roleDir)) {
+      throw new Error(`Role directory not found: ${roleDir}`);
+    }
+    return roleDir;
+  }
+  getActiveGoalDir(roleDir) {
+    const goalsDir = join(roleDir, "goals");
+    if (!existsSync(goalsDir)) return null;
+    const goalDirs = readdirSync(goalsDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name).sort();
+    for (const goalName of goalDirs) {
+      const goalDir = join(goalsDir, goalName);
+      const goalFile = this.findFeatureFile(goalDir, ".goal.feature");
+      if (!goalFile) continue;
+      const source = readFileSync(goalFile, "utf-8");
+      const doc = parse(source);
+      if (!doc.feature) continue;
+      if (!doc.feature.tags.some((t) => t.name === "@done" || t.name === "@abandoned")) {
+        return goalDir;
+      }
+    }
+    return null;
+  }
+  toFeature(gherkin, type) {
+    return {
+      ...gherkin,
+      type,
+      scenarios: this.extractScenarios(gherkin)
+    };
+  }
+  extractScenarios(feature) {
+    const featureTestable = feature.tags.some((t) => t.name === "@testable");
+    return (feature.children || []).filter((c) => c.scenario).map((c) => ({
+      ...c.scenario,
+      verifiable: featureTestable || c.scenario.tags.some((t) => t.name === "@testable")
+    }));
+  }
+  loadPlan(goalDir) {
+    const planFile = this.findFeatureFile(goalDir, ".plan.feature");
+    if (!planFile) return null;
+    const source = readFileSync(planFile, "utf-8");
+    const doc = parse(source);
+    if (!doc.feature) return null;
+    return this.toFeature(doc.feature, "plan");
+  }
+  loadTasks(goalDir) {
+    const tasksDir = join(goalDir, "tasks");
+    if (!existsSync(tasksDir)) return [];
+    return readdirSync(tasksDir).filter((f) => f.endsWith(".task.feature")).sort().map((f) => {
+      const source = readFileSync(join(tasksDir, f), "utf-8");
+      const doc = parse(source);
+      return this.toFeature(doc.feature, "task");
+    });
+  }
+  detectIdentityType(filename) {
+    if (filename === "persona.identity.feature") return "persona";
+    if (filename.endsWith(".knowledge.identity.feature")) return "knowledge";
+    if (filename.endsWith(".experience.identity.feature")) return "experience";
+    if (filename.endsWith(".voice.identity.feature")) return "voice";
+    return "knowledge";
+  }
+  findFeatureFile(dir, suffix) {
+    if (!existsSync(dir)) return null;
+    const file = readdirSync(dir).find((f) => f.endsWith(suffix));
+    return file ? join(dir, file) : null;
+  }
+  addTag(filePath, tag) {
+    const content = readFileSync(filePath, "utf-8");
+    const updated = content.replace(/^(Feature:)/m, `${tag}
+$1`);
+    writeFileSync(filePath, updated, "utf-8");
+  }
+  addDoneTag(filePath) {
+    this.addTag(filePath, "@done");
+  }
+};
+export {
+  LocalPlatform
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/LocalPlatform.ts"],"sourcesContent":["/**\n * LocalPlatform — Local filesystem implementation of Platform.\n *\n * Everything lives under a single .rolex/ directory.\n * rolex.json manages organization relationships (including teams).\n *\n * Directory convention:\n *   <rootDir>/rolex.json                          ← Organization config\n *   <rootDir>/<role>/identity/*.identity.feature   ← Identity features\n *   <rootDir>/<role>/goals/<name>/<name>.goal.feature\n *   <rootDir>/<role>/goals/<name>/<name>.plan.feature\n *   <rootDir>/<role>/goals/<name>/tasks/<name>.task.feature\n */\n\nimport { readdirSync, readFileSync, writeFileSync, mkdirSync, existsSync, rmSync } from \"node:fs\";\nimport { join, basename } from \"node:path\";\nimport { parse } from \"@rolexjs/parser\";\nimport type { Feature as GherkinFeature } from \"@rolexjs/parser\";\nimport type {\n  Platform,\n  Organization,\n  RoleEntry,\n  Feature,\n  Scenario,\n  Goal,\n  Plan,\n  Task,\n} from \"@rolexjs/core\";\n\ninterface RolexConfig {\n  name: string;\n  teams: Record<string, string[]>;\n}\n\nexport class LocalPlatform implements Platform {\n  private readonly rootDir: string;\n  private config: RolexConfig | null = null;\n\n  constructor(rootDir: string) {\n    this.rootDir = rootDir;\n  }\n\n  // ========== Found ==========\n\n  found(name: string): void {\n    mkdirSync(this.rootDir, { recursive: true });\n\n    const config: RolexConfig = {\n      name,\n      teams: { default: [] },\n    };\n\n    this.saveConfig(config);\n  }\n\n  // ========== Organization ==========\n\n  organization(): Organization {\n    const config = this.loadConfig();\n    const roles: RoleEntry[] = [];\n\n    for (const [teamName, roleNames] of Object.entries(config.teams)) {\n      for (const roleName of roleNames) {\n        roles.push({\n          name: roleName,\n          team: teamName,\n        });\n      }\n    }\n\n    return { name: config.name, roles };\n  }\n\n  // ========== Born ==========\n\n  born(name: string, source: string): Feature {\n    const roleDir = join(this.rootDir, name);\n    const identityDir = join(roleDir, \"identity\");\n    mkdirSync(identityDir, { recursive: true });\n\n    const filePath = join(identityDir, \"persona.identity.feature\");\n    writeFileSync(filePath, source, \"utf-8\");\n\n    const doc = parse(source);\n    return this.toFeature(doc.feature!, \"persona\");\n  }\n\n  hire(name: string): void {\n    const roleDir = join(this.rootDir, name);\n\n    if (!existsSync(join(roleDir, \"identity\", \"persona.identity.feature\"))) {\n      throw new Error(`Role not found: ${name}. Call born() first.`);\n    }\n\n    mkdirSync(join(roleDir, \"goals\"), { recursive: true });\n\n    // Update rolex.json — add role to default team\n    const config = this.loadConfig();\n    const [firstTeam] = Object.keys(config.teams);\n    if (!config.teams[firstTeam].includes(name)) {\n      config.teams[firstTeam].push(name);\n      this.saveConfig(config);\n    }\n  }\n\n  fire(name: string): void {\n    const roleDir = join(this.rootDir, name);\n    const goalsDir = join(roleDir, \"goals\");\n\n    if (!existsSync(goalsDir)) {\n      throw new Error(`Role not hired: ${name}`);\n    }\n\n    rmSync(goalsDir, { recursive: true, force: true });\n\n    // Update rolex.json — remove role from team\n    const config = this.loadConfig();\n    for (const teamName of Object.keys(config.teams)) {\n      const idx = config.teams[teamName].indexOf(name);\n      if (idx !== -1) {\n        config.teams[teamName].splice(idx, 1);\n        break;\n      }\n    }\n    this.saveConfig(config);\n  }\n\n  // ========== Growup ==========\n\n  growup(\n    roleId: string,\n    type: \"knowledge\" | \"experience\" | \"voice\",\n    name: string,\n    source: string\n  ): Feature {\n    const roleDir = this.resolveRoleDir(roleId);\n    const dir = join(roleDir, \"identity\");\n    mkdirSync(dir, { recursive: true });\n\n    const filePath = join(dir, `${name}.${type}.identity.feature`);\n    writeFileSync(filePath, source, \"utf-8\");\n\n    const doc = parse(source);\n    return this.toFeature(doc.feature!, type);\n  }\n\n  // ========== Query ==========\n\n  identity(roleId: string): Feature[] {\n    const roleDir = this.resolveRoleDir(roleId);\n    const dir = join(roleDir, \"identity\");\n    if (!existsSync(dir)) return [];\n\n    return readdirSync(dir)\n      .filter((f) => f.endsWith(\".identity.feature\"))\n      .sort()\n      .map((f) => {\n        const source = readFileSync(join(dir, f), \"utf-8\");\n        const doc = parse(source);\n        return this.toFeature(doc.feature!, this.detectIdentityType(f));\n      });\n  }\n\n  activeGoal(roleId: string): (Goal & { plan: Plan | null; tasks: Task[] }) | null {\n    const roleDir = this.resolveRoleDir(roleId);\n    const goalsDir = join(roleDir, \"goals\");\n    if (!existsSync(goalsDir)) return null;\n\n    const goalDirs = readdirSync(goalsDir, { withFileTypes: true })\n      .filter((d) => d.isDirectory())\n      .map((d) => d.name)\n      .sort();\n\n    for (const goalName of goalDirs) {\n      const goalDir = join(goalsDir, goalName);\n      const goalFile = this.findFeatureFile(goalDir, \".goal.feature\");\n      if (!goalFile) continue;\n\n      const source = readFileSync(goalFile, \"utf-8\");\n      const doc = parse(source);\n      if (!doc.feature) continue;\n\n      if (doc.feature.tags.some((t) => t.name === \"@done\" || t.name === \"@abandoned\")) continue;\n\n      const goal = this.toFeature(doc.feature, \"goal\") as Goal;\n      return {\n        ...goal,\n        plan: this.loadPlan(goalDir),\n        tasks: this.loadTasks(goalDir),\n      };\n    }\n\n    return null;\n  }\n\n  // ========== Write ==========\n\n  createGoal(roleId: string, name: string, source: string, testable?: boolean): Goal {\n    const roleDir = this.resolveRoleDir(roleId);\n    const goalDir = join(roleDir, \"goals\", name);\n    mkdirSync(goalDir, { recursive: true });\n\n    if (testable) source = `@testable\\n${source}`;\n    const filePath = join(goalDir, `${name}.goal.feature`);\n    writeFileSync(filePath, source, \"utf-8\");\n\n    const doc = parse(source);\n    return this.toFeature(doc.feature!, \"goal\") as Goal;\n  }\n\n  createPlan(roleId: string, source: string): Plan {\n    const roleDir = this.resolveRoleDir(roleId);\n    const goalDir = this.getActiveGoalDir(roleDir);\n    if (!goalDir) throw new Error(\"No active goal\");\n\n    const goalName = basename(goalDir);\n    const filePath = join(goalDir, `${goalName}.plan.feature`);\n    writeFileSync(filePath, source, \"utf-8\");\n\n    const doc = parse(source);\n    return this.toFeature(doc.feature!, \"plan\") as Plan;\n  }\n\n  createTask(roleId: string, name: string, source: string, testable?: boolean): Task {\n    const roleDir = this.resolveRoleDir(roleId);\n    const goalDir = this.getActiveGoalDir(roleDir);\n    if (!goalDir) throw new Error(\"No active goal\");\n\n    const tasksDir = join(goalDir, \"tasks\");\n    mkdirSync(tasksDir, { recursive: true });\n\n    if (testable) source = `@testable\\n${source}`;\n    const filePath = join(tasksDir, `${name}.task.feature`);\n    writeFileSync(filePath, source, \"utf-8\");\n\n    const doc = parse(source);\n    return this.toFeature(doc.feature!, \"task\") as Task;\n  }\n\n  // ========== Close ==========\n\n  completeGoal(roleId: string, experience?: string): void {\n    const roleDir = this.resolveRoleDir(roleId);\n    const goalDir = this.getActiveGoalDir(roleDir);\n    if (!goalDir) throw new Error(\"No active goal\");\n\n    const goalFile = this.findFeatureFile(goalDir, \".goal.feature\")!;\n    this.addDoneTag(goalFile);\n\n    if (experience) {\n      const goalName = basename(goalDir);\n      this.growup(roleId, \"experience\", goalName, experience);\n    }\n  }\n\n  abandonGoal(roleId: string, experience?: string): void {\n    const roleDir = this.resolveRoleDir(roleId);\n    const goalDir = this.getActiveGoalDir(roleDir);\n    if (!goalDir) throw new Error(\"No active goal\");\n\n    const goalFile = this.findFeatureFile(goalDir, \".goal.feature\")!;\n    this.addTag(goalFile, \"@abandoned\");\n\n    if (experience) {\n      const goalName = basename(goalDir);\n      this.growup(roleId, \"experience\", goalName, experience);\n    }\n  }\n\n  completeTask(roleId: string, name: string): void {\n    const roleDir = this.resolveRoleDir(roleId);\n    const goalDir = this.getActiveGoalDir(roleDir);\n    if (!goalDir) throw new Error(\"No active goal\");\n\n    const tasksDir = join(goalDir, \"tasks\");\n    const taskFile = join(tasksDir, `${name}.task.feature`);\n    if (!existsSync(taskFile)) throw new Error(`Task not found: ${name}`);\n\n    this.addDoneTag(taskFile);\n  }\n\n  // ========== Internal ==========\n\n  private loadConfig(): RolexConfig {\n    if (this.config) return this.config;\n\n    const configPath = join(this.rootDir, \"rolex.json\");\n    if (existsSync(configPath)) {\n      this.config = JSON.parse(readFileSync(configPath, \"utf-8\"));\n      return this.config!;\n    }\n\n    throw new Error(`No rolex.json found in ${this.rootDir}. Call found() first.`);\n  }\n\n  private saveConfig(config: RolexConfig): void {\n    writeFileSync(join(this.rootDir, \"rolex.json\"), JSON.stringify(config, null, 2), \"utf-8\");\n    this.config = config;\n  }\n\n  private resolveRoleDir(roleId: string): string {\n    const roleDir = join(this.rootDir, roleId);\n    if (!existsSync(roleDir)) {\n      throw new Error(`Role directory not found: ${roleDir}`);\n    }\n    return roleDir;\n  }\n\n  private getActiveGoalDir(roleDir: string): string | null {\n    const goalsDir = join(roleDir, \"goals\");\n    if (!existsSync(goalsDir)) return null;\n\n    const goalDirs = readdirSync(goalsDir, { withFileTypes: true })\n      .filter((d) => d.isDirectory())\n      .map((d) => d.name)\n      .sort();\n\n    for (const goalName of goalDirs) {\n      const goalDir = join(goalsDir, goalName);\n      const goalFile = this.findFeatureFile(goalDir, \".goal.feature\");\n      if (!goalFile) continue;\n\n      const source = readFileSync(goalFile, \"utf-8\");\n      const doc = parse(source);\n      if (!doc.feature) continue;\n\n      if (!doc.feature.tags.some((t) => t.name === \"@done\" || t.name === \"@abandoned\")) {\n        return goalDir;\n      }\n    }\n\n    return null;\n  }\n\n  private toFeature(gherkin: GherkinFeature, type: Feature[\"type\"]): Feature {\n    return {\n      ...gherkin,\n      type,\n      scenarios: this.extractScenarios(gherkin),\n    };\n  }\n\n  private extractScenarios(feature: GherkinFeature): Scenario[] {\n    const featureTestable = feature.tags.some((t) => t.name === \"@testable\");\n    return (feature.children || [])\n      .filter((c) => c.scenario)\n      .map((c) => ({\n        ...c.scenario!,\n        verifiable: featureTestable || c.scenario!.tags.some((t) => t.name === \"@testable\"),\n      }));\n  }\n\n  private loadPlan(goalDir: string): Plan | null {\n    const planFile = this.findFeatureFile(goalDir, \".plan.feature\");\n    if (!planFile) return null;\n\n    const source = readFileSync(planFile, \"utf-8\");\n    const doc = parse(source);\n    if (!doc.feature) return null;\n\n    return this.toFeature(doc.feature, \"plan\") as Plan;\n  }\n\n  private loadTasks(goalDir: string): Task[] {\n    const tasksDir = join(goalDir, \"tasks\");\n    if (!existsSync(tasksDir)) return [];\n\n    return readdirSync(tasksDir)\n      .filter((f) => f.endsWith(\".task.feature\"))\n      .sort()\n      .map((f) => {\n        const source = readFileSync(join(tasksDir, f), \"utf-8\");\n        const doc = parse(source);\n        return this.toFeature(doc.feature!, \"task\") as Task;\n      });\n  }\n\n  private detectIdentityType(filename: string): Feature[\"type\"] {\n    if (filename === \"persona.identity.feature\") return \"persona\";\n    if (filename.endsWith(\".knowledge.identity.feature\")) return \"knowledge\";\n    if (filename.endsWith(\".experience.identity.feature\")) return \"experience\";\n    if (filename.endsWith(\".voice.identity.feature\")) return \"voice\";\n    return \"knowledge\";\n  }\n\n  private findFeatureFile(dir: string, suffix: string): string | null {\n    if (!existsSync(dir)) return null;\n    const file = readdirSync(dir).find((f) => f.endsWith(suffix));\n    return file ? join(dir, file) : null;\n  }\n\n  private addTag(filePath: string, tag: string): void {\n    const content = readFileSync(filePath, \"utf-8\");\n    const updated = content.replace(/^(Feature:)/m, `${tag}\\n$1`);\n    writeFileSync(filePath, updated, \"utf-8\");\n  }\n\n  private addDoneTag(filePath: string): void {\n    this.addTag(filePath, \"@done\");\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@rolexjs/local-platform",
+  "version": "0.2.0",
+  "description": "Local filesystem Platform for RoleX — stores roles in .rolex/ directories",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@rolexjs/core": "^0.3.0",
+    "@rolexjs/parser": "^0.3.0"
+  },
+  "devDependencies": {
+    "rolexjs": "^0.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}