@dexto/tools-plan 1.5.8 → 1.6.1

package/dist/plan-service.cjs

@@ -0,0 +1,247 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var plan_service_exports = {};
+__export(plan_service_exports, {
+  PlanService: () => PlanService
+});
+module.exports = __toCommonJS(plan_service_exports);
+var fs = __toESM(require("node:fs/promises"), 1);
+var path = __toESM(require("node:path"), 1);
+var import_node_fs = require("node:fs");
+var import_types = require("./types.js");
+var import_errors = require("./errors.js");
+const PLAN_FILENAME = "plan.md";
+const META_FILENAME = "plan-meta.json";
+class PlanService {
+  basePath;
+  logger;
+  constructor(options, logger) {
+    this.basePath = options.basePath;
+    this.logger = logger;
+  }
+  /**
+   * Resolves and validates a session directory path.
+   * Prevents path traversal attacks by ensuring the resolved path stays within basePath.
+   */
+  resolveSessionDir(sessionId) {
+    const base = path.resolve(this.basePath);
+    const resolved = path.resolve(base, sessionId);
+    const rel = path.relative(base, resolved);
+    if (rel.startsWith("..") || path.isAbsolute(rel)) {
+      throw import_errors.PlanError.invalidSessionId(sessionId);
+    }
+    return resolved;
+  }
+  /**
+   * Gets the directory path for a session's plan
+   */
+  getPlanDir(sessionId) {
+    return this.resolveSessionDir(sessionId);
+  }
+  /**
+   * Gets the path to the plan content file.
+   * Public accessor for tools that need to display the path.
+   */
+  getPlanPath(sessionId) {
+    return path.join(this.getPlanDir(sessionId), PLAN_FILENAME);
+  }
+  /**
+   * Gets the path to the plan metadata file
+   */
+  getMetaPath(sessionId) {
+    return path.join(this.getPlanDir(sessionId), META_FILENAME);
+  }
+  /**
+   * Checks if a plan exists for the given session
+   */
+  async exists(sessionId) {
+    const planPath = this.getPlanPath(sessionId);
+    return (0, import_node_fs.existsSync)(planPath);
+  }
+  /**
+   * Creates a new plan for the session
+   *
+   * @throws PlanError.planAlreadyExists if plan already exists
+   * @throws PlanError.storageError on filesystem errors
+   */
+  async create(sessionId, content, options) {
+    if (await this.exists(sessionId)) {
+      throw import_errors.PlanError.planAlreadyExists(sessionId);
+    }
+    const planDir = this.getPlanDir(sessionId);
+    const now = Date.now();
+    const meta = {
+      sessionId,
+      status: "draft",
+      title: options?.title,
+      createdAt: now,
+      updatedAt: now
+    };
+    try {
+      await fs.mkdir(planDir, { recursive: true });
+      await Promise.all([
+        fs.writeFile(this.getPlanPath(sessionId), content, "utf-8"),
+        fs.writeFile(this.getMetaPath(sessionId), JSON.stringify(meta, null, 2), "utf-8")
+      ]);
+      this.logger.debug(`Created plan for session ${sessionId}`);
+      return { content, meta };
+    } catch (error) {
+      throw import_errors.PlanError.storageError("create", sessionId, error);
+    }
+  }
+  /**
+   * Reads the plan for the given session
+   *
+   * @returns The plan or null if not found
+   */
+  async read(sessionId) {
+    if (!await this.exists(sessionId)) {
+      return null;
+    }
+    try {
+      const [content, metaContent] = await Promise.all([
+        fs.readFile(this.getPlanPath(sessionId), "utf-8"),
+        fs.readFile(this.getMetaPath(sessionId), "utf-8")
+      ]);
+      const metaParsed = JSON.parse(metaContent);
+      const metaResult = import_types.PlanMetaSchema.safeParse(metaParsed);
+      if (!metaResult.success) {
+        this.logger.warn(`Invalid plan metadata for session ${sessionId}, using defaults`);
+        return {
+          content,
+          meta: {
+            sessionId,
+            status: "draft",
+            createdAt: Date.now(),
+            updatedAt: Date.now()
+          }
+        };
+      }
+      return { content, meta: metaResult.data };
+    } catch (error) {
+      const err = error;
+      if (err.code === "ENOENT") {
+        return null;
+      }
+      if (error instanceof SyntaxError) {
+        this.logger.error(`Failed to read plan for session ${sessionId}: ${error.message}`);
+        return null;
+      }
+      this.logger.error(
+        `Failed to read plan for session ${sessionId}: ${err.message ?? String(err)}`
+      );
+      throw import_errors.PlanError.storageError("read", sessionId, err);
+    }
+  }
+  /**
+   * Updates the plan content for the given session
+   *
+   * @throws PlanError.planNotFound if plan doesn't exist
+   * @throws PlanError.storageError on filesystem errors
+   */
+  async update(sessionId, content) {
+    const existing = await this.read(sessionId);
+    if (!existing) {
+      throw import_errors.PlanError.planNotFound(sessionId);
+    }
+    const oldContent = existing.content;
+    const now = Date.now();
+    const updatedMeta = {
+      ...existing.meta,
+      updatedAt: now
+    };
+    try {
+      await Promise.all([
+        fs.writeFile(this.getPlanPath(sessionId), content, "utf-8"),
+        fs.writeFile(
+          this.getMetaPath(sessionId),
+          JSON.stringify(updatedMeta, null, 2),
+          "utf-8"
+        )
+      ]);
+      this.logger.debug(`Updated plan for session ${sessionId}`);
+      return {
+        oldContent,
+        newContent: content,
+        meta: updatedMeta
+      };
+    } catch (error) {
+      throw import_errors.PlanError.storageError("update", sessionId, error);
+    }
+  }
+  /**
+   * Updates the plan metadata (status, title)
+   *
+   * @throws PlanError.planNotFound if plan doesn't exist
+   * @throws PlanError.storageError on filesystem errors
+   */
+  async updateMeta(sessionId, updates) {
+    const existing = await this.read(sessionId);
+    if (!existing) {
+      throw import_errors.PlanError.planNotFound(sessionId);
+    }
+    const updatedMeta = {
+      ...existing.meta,
+      ...updates,
+      updatedAt: Date.now()
+    };
+    try {
+      await fs.writeFile(
+        this.getMetaPath(sessionId),
+        JSON.stringify(updatedMeta, null, 2),
+        "utf-8"
+      );
+      this.logger.debug(`Updated plan metadata for session ${sessionId}`);
+      return updatedMeta;
+    } catch (error) {
+      throw import_errors.PlanError.storageError("update metadata", sessionId, error);
+    }
+  }
+  /**
+   * Deletes the plan for the given session
+   *
+   * @throws PlanError.planNotFound if plan doesn't exist
+   * @throws PlanError.storageError on filesystem errors
+   */
+  async delete(sessionId) {
+    if (!await this.exists(sessionId)) {
+      throw import_errors.PlanError.planNotFound(sessionId);
+    }
+    try {
+      await fs.rm(this.getPlanDir(sessionId), { recursive: true, force: true });
+      this.logger.debug(`Deleted plan for session ${sessionId}`);
+    } catch (error) {
+      throw import_errors.PlanError.storageError("delete", sessionId, error);
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PlanService
+});

package/dist/plan-service.d.ts

@@ -6,7 +6,7 @@
  * - plan.md: The plan content
  * - plan-meta.json: Metadata (status, checkpoints, timestamps)
  */
-import type { IDextoLogger } from '@dexto/core';
+import type { Logger } from '@dexto/core';
 import type { Plan, PlanMeta, PlanServiceOptions, PlanUpdateResult } from './types.js';
 /**
  * Service for managing implementation plans.
@@ -14,7 +14,7 @@ import type { Plan, PlanMeta, PlanServiceOptions, PlanUpdateResult } from './typ
 export declare class PlanService {
     private basePath;
     private logger;
-    constructor(options: PlanServiceOptions, logger?: IDextoLogger);
+    constructor(options: PlanServiceOptions, logger: Logger);
     /**
      * Resolves and validates a session directory path.
      * Prevents path traversal attacks by ensuring the resolved path stays within basePath.

package/dist/plan-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan-service.d.ts","sourceRoot":"","sources":["../src/plan-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMvF;;GAEG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAA2B;gBAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,YAAY;IAK9D;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;;OAGG;IACI,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI7C;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjD;;;;;OAKG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC7F;;;;OAIG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAmDnD;;;;;OAKG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqC3E;;;;;OAKG;IACG,UAAU,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,GACrD,OAAO,CAAC,QAAQ,CAAC;IA2BpB;;;;;OAKG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAYjD"}
+{"version":3,"file":"plan-service.d.ts","sourceRoot":"","sources":["../src/plan-service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMvF;;GAEG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM;IAKvD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;;OAGG;IACI,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI7C;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjD;;;;;OAKG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC7F;;;;OAIG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAiDnD;;;;;OAKG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqC3E;;;;;OAKG;IACG,UAAU,CACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,GACrD,OAAO,CAAC,QAAQ,CAAC;IA2BpB;;;;;OAKG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAYjD"}