septum 0.1.0 → 0.1.2

package/src/mcp/tools/check-boundary.ts

@@ -1,102 +1,102 @@
-import type { BoundaryEvaluator } from "../../core/boundary/evaluator.ts";
-import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
-
-export interface CheckBoundaryArgs {
-  file_path?: string;
-  file_paths?: string[];
-  proposed_imports?: string[];
-  feature_key?: string;
-}
-
-export function handleCheckBoundary(
-  evaluator: BoundaryEvaluator,
-  config: ValidatedSeptumConfig,
-  args: CheckBoundaryArgs
-) {
-  const filesToCheck: string[] = [];
-  if (args.file_paths && Array.isArray(args.file_paths) && args.file_paths.length > 0) {
-    filesToCheck.push(...args.file_paths);
-  } else if (args.file_path) {
-    filesToCheck.push(args.file_path);
-  } else {
-    throw new Error("Missing required argument: specify either 'file_path' or 'file_paths'");
-  }
-
-  // Multi-file batch evaluation
-  if (filesToCheck.length > 1) {
-    const results = filesToCheck.map((filePath) => {
-      const violations = evaluator.evaluate(filePath, args.proposed_imports ?? [], args.feature_key, config);
-      return {
-        file: filePath,
-        status: violations.length > 0 ? "rejected" : "approved",
-        violations,
-      };
-    });
-
-    const totalViolations = results.reduce((acc, r) => acc + r.violations.length, 0);
-    const hasViolations = totalViolations > 0;
-
-    return {
-      content: [
-        {
-          type: "text" as const,
-          text: JSON.stringify(
-            {
-              status: hasViolations ? "rejected" : "approved",
-              total_checked: filesToCheck.length,
-              total_violations: totalViolations,
-              results,
-              message: hasViolations
-                ? `${totalViolations} boundary violation(s) detected across ${filesToCheck.length} file(s).`
-                : `All ${filesToCheck.length} file(s) approved. No boundary violations detected.`,
-            },
-            null,
-            2
-          ),
-        },
-      ],
-    };
-  }
-
-  // Single file evaluation (backward-compatible output)
-  const singleFile = filesToCheck[0];
-  const violations = evaluator.evaluate(singleFile, args.proposed_imports ?? [], args.feature_key, config);
-
-  if (violations.length > 0) {
-    return {
-      content: [
-        {
-          type: "text" as const,
-          text: JSON.stringify(
-            {
-              status: "rejected",
-              file: singleFile,
-              violations_count: violations.length,
-              violations,
-              message: "Boundary violation detected. Proposed imports violate bounded context architecture.",
-            },
-            null,
-            2
-          ),
-        },
-      ],
-    };
-  }
-
-  return {
-    content: [
-      {
-        type: "text" as const,
-        text: JSON.stringify(
-          {
-            status: "approved",
-            file: singleFile,
-            message: "No boundary violations detected. Proposed imports are permissible.",
-          },
-          null,
-          2
-        ),
-      },
-    ],
-  };
-}
+import type { BoundaryEvaluator } from "../../core/boundary/evaluator.ts";
+import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
+
+export interface CheckBoundaryArgs {
+  file_path?: string;
+  file_paths?: string[];
+  proposed_imports?: string[];
+  feature_key?: string;
+}
+
+export function handleCheckBoundary(
+  evaluator: BoundaryEvaluator,
+  config: ValidatedSeptumConfig,
+  args: CheckBoundaryArgs
+) {
+  const filesToCheck: string[] = [];
+  if (args.file_paths && Array.isArray(args.file_paths) && args.file_paths.length > 0) {
+    filesToCheck.push(...args.file_paths);
+  } else if (args.file_path) {
+    filesToCheck.push(args.file_path);
+  } else {
+    throw new Error("Missing required argument: specify either 'file_path' or 'file_paths'");
+  }
+
+  // Multi-file batch evaluation
+  if (filesToCheck.length > 1) {
+    const results = filesToCheck.map((filePath) => {
+      const violations = evaluator.evaluate(filePath, args.proposed_imports ?? [], args.feature_key, config);
+      return {
+        file: filePath,
+        status: violations.length > 0 ? "rejected" : "approved",
+        violations,
+      };
+    });
+
+    const totalViolations = results.reduce((acc, r) => acc + r.violations.length, 0);
+    const hasViolations = totalViolations > 0;
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify(
+            {
+              status: hasViolations ? "rejected" : "approved",
+              total_checked: filesToCheck.length,
+              total_violations: totalViolations,
+              results,
+              message: hasViolations
+                ? `${totalViolations} boundary violation(s) detected across ${filesToCheck.length} file(s).`
+                : `All ${filesToCheck.length} file(s) approved. No boundary violations detected.`,
+            },
+            null,
+            2
+          ),
+        },
+      ],
+    };
+  }
+
+  // Single file evaluation (backward-compatible output)
+  const singleFile = filesToCheck[0];
+  const violations = evaluator.evaluate(singleFile, args.proposed_imports ?? [], args.feature_key, config);
+
+  if (violations.length > 0) {
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify(
+            {
+              status: "rejected",
+              file: singleFile,
+              violations_count: violations.length,
+              violations,
+              message: "Boundary violation detected. Proposed imports violate bounded context architecture.",
+            },
+            null,
+            2
+          ),
+        },
+      ],
+    };
+  }
+
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify(
+          {
+            status: "approved",
+            file: singleFile,
+            message: "No boundary violations detected. Proposed imports are permissible.",
+          },
+          null,
+          2
+        ),
+      },
+    ],
+  };
+}

package/src/mcp/tools/get-domain-catalog.ts

@@ -1,91 +1,91 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
-import type { SeptumRepository } from "../../core/database/repository.ts";
-
-export interface GetDomainCatalogArgs {
-  domain?: string;
-  archetype_filter?: string;
-}
-
-export function handleGetDomainCatalog(
-  repo: SeptumRepository,
-  config: ValidatedSeptumConfig,
-  args: GetDomainCatalogArgs
-) {
-  if (!args.domain) {
-    const allDomains = repo.getAllDomains();
-    const projectType = repo.getMeta("project_type") || "generic";
-    const framework = repo.getMeta("framework") || "unknown";
-    const archStyle = repo.getMeta("architecture_style") || "modular";
-    const totalSlices = repo.getAllVerticalSlices().length;
-
-    const macroMap = {
-      telescope_view: {
-        project_type: projectType,
-        framework,
-        architecture_style: archStyle,
-        total_domains: allDomains.length,
-        total_vertical_slices: totalSlices,
-      },
-      domains: allDomains.map((d) => ({
-        name: d.name,
-        root: d.root_path,
-        archetypes: Object.keys(JSON.parse(d.archetypes_json || "{}")),
-        allowed_dependencies: JSON.parse(d.allowed_deps_json || "[]"),
-        forbidden_dependencies: JSON.parse(d.forbidden_deps_json || "[]"),
-      })),
-      agent_instruction:
-        "Macro semantic map loaded from SQLite SSOT. Use 'septum_get_domain_catalog' with domain='<name>' for granular file/symbol catalogs, or 'septum_trace_vertical_slice' with query='<route|command|intent>' for end-to-end execution flow.",
-    };
-
-    return {
-      content: [
-        {
-          type: "text" as const,
-          text: JSON.stringify(macroMap, null, 2),
-        },
-      ],
-    };
-  }
-
-  const catalog = repo.getDomainCatalog(args.domain, args.archetype_filter);
-  if (!catalog) {
-    const available = Object.keys(config.domains).join(", ");
-    throw new Error(
-      `Domain '${args.domain}' not found. Available domains in Septum catalog: [${available}]. Run 'septum ingest' or 'septum_register_domain' if recently added.`
-    );
-  }
-
-  // Record access log for Gate 3 (Mandatory Catalog Consultation)
-  recordCatalogAccess(args.domain);
-
-  // Token-efficient serialization: keep payload dense and under 500 tokens
-  return {
-    content: [
-      {
-        type: "text" as const,
-        text: JSON.stringify(catalog, null, 2),
-      },
-    ],
-  };
-}
-
-function recordCatalogAccess(domain: string): void {
-  try {
-    const septumDir = path.resolve(process.cwd(), ".septum");
-    if (!fs.existsSync(septumDir)) {
-      fs.mkdirSync(septumDir, { recursive: true });
-    }
-    const logPath = path.join(septumDir, "catalog_access.json");
-    let log: { domains?: Record<string, string>; features?: Record<string, string> } = {};
-    if (fs.existsSync(logPath)) {
-      try {
-        log = JSON.parse(fs.readFileSync(logPath, "utf-8"));
-      } catch {}
-    }
-    log.domains = log.domains || {};
-    log.domains[domain] = new Date().toISOString();
-    fs.writeFileSync(logPath, JSON.stringify(log, null, 2), "utf-8");
-  } catch {}
-}
+import * as fs from "node:fs";
+import * as path from "node:path";
+import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
+import type { SeptumRepository } from "../../core/database/repository.ts";
+
+export interface GetDomainCatalogArgs {
+  domain?: string;
+  archetype_filter?: string;
+}
+
+export function handleGetDomainCatalog(
+  repo: SeptumRepository,
+  config: ValidatedSeptumConfig,
+  args: GetDomainCatalogArgs
+) {
+  if (!args.domain) {
+    const allDomains = repo.getAllDomains();
+    const projectType = repo.getMeta("project_type") || "generic";
+    const framework = repo.getMeta("framework") || "unknown";
+    const archStyle = repo.getMeta("architecture_style") || "modular";
+    const totalSlices = repo.getAllVerticalSlices().length;
+
+    const macroMap = {
+      telescope_view: {
+        project_type: projectType,
+        framework,
+        architecture_style: archStyle,
+        total_domains: allDomains.length,
+        total_vertical_slices: totalSlices,
+      },
+      domains: allDomains.map((d) => ({
+        name: d.name,
+        root: d.root_path,
+        archetypes: Object.keys(JSON.parse(d.archetypes_json || "{}")),
+        allowed_dependencies: JSON.parse(d.allowed_deps_json || "[]"),
+        forbidden_dependencies: JSON.parse(d.forbidden_deps_json || "[]"),
+      })),
+      agent_instruction:
+        "Macro semantic map loaded from SQLite SSOT. Use 'septum_get_domain_catalog' with domain='<name>' for granular file/symbol catalogs, or 'septum_trace_vertical_slice' with query='<route|command|intent>' for end-to-end execution flow.",
+    };
+
+    return {
+      content: [
+        {
+          type: "text" as const,
+          text: JSON.stringify(macroMap, null, 2),
+        },
+      ],
+    };
+  }
+
+  const catalog = repo.getDomainCatalog(args.domain, args.archetype_filter);
+  if (!catalog) {
+    const available = Object.keys(config.domains).join(", ");
+    throw new Error(
+      `Domain '${args.domain}' not found. Available domains in Septum catalog: [${available}]. Run 'septum ingest' or 'septum_register_domain' if recently added.`
+    );
+  }
+
+  // Record access log for Gate 3 (Mandatory Catalog Consultation)
+  recordCatalogAccess(args.domain);
+
+  // Token-efficient serialization: keep payload dense and under 500 tokens
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify(catalog, null, 2),
+      },
+    ],
+  };
+}
+
+function recordCatalogAccess(domain: string): void {
+  try {
+    const septumDir = path.resolve(process.cwd(), ".septum");
+    if (!fs.existsSync(septumDir)) {
+      fs.mkdirSync(septumDir, { recursive: true });
+    }
+    const logPath = path.join(septumDir, "catalog_access.json");
+    let log: { domains?: Record<string, string>; features?: Record<string, string> } = {};
+    if (fs.existsSync(logPath)) {
+      try {
+        log = JSON.parse(fs.readFileSync(logPath, "utf-8"));
+      } catch {}
+    }
+    log.domains = log.domains || {};
+    log.domains[domain] = new Date().toISOString();
+    fs.writeFileSync(logPath, JSON.stringify(log, null, 2), "utf-8");
+  } catch {}
+}

package/src/mcp/tools/get-feature-context.ts

@@ -1,116 +1,116 @@
-import * as fs from "node:fs";
-import * as path from "node:path";
-import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
-import type { SeptumRepository } from "../../core/database/repository.ts";
-import { SessionManager } from "../../core/session/session-manager.ts";
-import type { FeatureContextResponse } from "../../types/index.ts";
-
-export interface GetFeatureContextArgs {
-  feature: string;
-}
-
-export function handleClearFeatureContext(workspaceRoot: string = process.cwd()): boolean {
-  return SessionManager.clearActiveSession(workspaceRoot);
-}
-
-export function handleGetFeatureContext(
-  repo: SeptumRepository,
-  config: ValidatedSeptumConfig,
-  args: GetFeatureContextArgs
-) {
-  if (!args.feature) {
-    throw new Error("Missing required argument: 'feature'");
-  }
-
-  const features = config.features ?? {};
-  const featureConfig = features[args.feature];
-
-  if (!featureConfig) {
-    const available = Object.keys(features).join(", ") || "none";
-    throw new Error(
-      `Feature '${args.feature}' not found in configuration. Available features: [${available}]`
-    );
-  }
-
-  // Record Active Feature Session Lease (.septum/session.json)
-  SessionManager.saveActiveSession(process.cwd(), {
-    feature_key: args.feature,
-    domain: featureConfig.domain,
-    touchpoints: featureConfig.allowed_touchpoints ?? [],
-    locked_at: new Date().toISOString(),
-  });
-
-  // Deterministically fetch signatures, methods, and properties for reuse_symbols from SQLite
-  const reuseSymbolsWithMeta: FeatureContextResponse["reuse_symbols"] = [];
-  const requestedSymbols = featureConfig.reuse_symbols ?? [];
-
-  for (const symName of requestedSymbols) {
-    const record = repo.findSymbolWithMembers(symName);
-    if (record) {
-      reuseSymbolsWithMeta.push({
-        name: record.symbol_name,
-        kind: record.kind,
-        signature: record.signature,
-        methods: record.methods.length > 0 ? record.methods : undefined,
-        properties: record.properties.length > 0 ? record.properties : undefined,
-        file_path: record.file_path,
-        domain: record.domain_name,
-      });
-    } else {
-      reuseSymbolsWithMeta.push({
-        name: symName,
-        kind: "unknown",
-        domain: featureConfig.domain,
-      });
-    }
-  }
-
-  const response: FeatureContextResponse = {
-    feature: args.feature,
-    domain: featureConfig.domain,
-    description: featureConfig.description,
-    allowed_touchpoints: featureConfig.allowed_touchpoints,
-    reuse_symbols: reuseSymbolsWithMeta,
-    input_contract: (featureConfig.input_contract as Record<string, unknown>) ?? {},
-    output_contract: (featureConfig.output_contract as Record<string, unknown>) ?? {},
-    governance_directives: [
-      "DO NOT modify or edit any files outside allowed_touchpoints.",
-      "DO NOT create duplicate helpers/services; reuse the existing symbols and methods declared in reuse_symbols.",
-      "DO NOT emit or expect phantom payload fields outside input_contract and output_contract.",
-      "DO NOT import cross-domain modules without declared allowed_dependencies in Septum domain boundaries.",
-    ],
-  };
-
-  recordFeatureAccess(featureConfig.domain, args.feature);
-
-  return {
-    content: [
-      {
-        type: "text" as const,
-        text: JSON.stringify(response, null, 2),
-      },
-    ],
-  };
-}
-
-function recordFeatureAccess(domain: string, feature: string): void {
-  try {
-    const septumDir = path.resolve(process.cwd(), ".septum");
-    if (!fs.existsSync(septumDir)) {
-      fs.mkdirSync(septumDir, { recursive: true });
-    }
-    const logPath = path.join(septumDir, "catalog_access.json");
-    let log: { domains?: Record<string, string>; features?: Record<string, string> } = {};
-    if (fs.existsSync(logPath)) {
-      try {
-        log = JSON.parse(fs.readFileSync(logPath, "utf-8"));
-      } catch {}
-    }
-    log.domains = log.domains || {};
-    log.features = log.features || {};
-    const now = new Date().toISOString();
-    log.domains[domain] = now;
-    log.features[feature] = now;
-    fs.writeFileSync(logPath, JSON.stringify(log, null, 2), "utf-8");
-  } catch {}
-}
+import * as fs from "node:fs";
+import * as path from "node:path";
+import type { ValidatedSeptumConfig } from "../../core/config/schema.ts";
+import type { SeptumRepository } from "../../core/database/repository.ts";
+import { SessionManager } from "../../core/session/session-manager.ts";
+import type { FeatureContextResponse } from "../../types/index.ts";
+
+export interface GetFeatureContextArgs {
+  feature: string;
+}
+
+export function handleClearFeatureContext(workspaceRoot: string = process.cwd()): boolean {
+  return SessionManager.clearActiveSession(workspaceRoot);
+}
+
+export function handleGetFeatureContext(
+  repo: SeptumRepository,
+  config: ValidatedSeptumConfig,
+  args: GetFeatureContextArgs
+) {
+  if (!args.feature) {
+    throw new Error("Missing required argument: 'feature'");
+  }
+
+  const features = config.features ?? {};
+  const featureConfig = features[args.feature];
+
+  if (!featureConfig) {
+    const available = Object.keys(features).join(", ") || "none";
+    throw new Error(
+      `Feature '${args.feature}' not found in configuration. Available features: [${available}]`
+    );
+  }
+
+  // Record Active Feature Session Lease (.septum/session.json)
+  SessionManager.saveActiveSession(process.cwd(), {
+    feature_key: args.feature,
+    domain: featureConfig.domain,
+    touchpoints: featureConfig.allowed_touchpoints ?? [],
+    locked_at: new Date().toISOString(),
+  });
+
+  // Deterministically fetch signatures, methods, and properties for reuse_symbols from SQLite
+  const reuseSymbolsWithMeta: FeatureContextResponse["reuse_symbols"] = [];
+  const requestedSymbols = featureConfig.reuse_symbols ?? [];
+
+  for (const symName of requestedSymbols) {
+    const record = repo.findSymbolWithMembers(symName);
+    if (record) {
+      reuseSymbolsWithMeta.push({
+        name: record.symbol_name,
+        kind: record.kind,
+        signature: record.signature,
+        methods: record.methods.length > 0 ? record.methods : undefined,
+        properties: record.properties.length > 0 ? record.properties : undefined,
+        file_path: record.file_path,
+        domain: record.domain_name,
+      });
+    } else {
+      reuseSymbolsWithMeta.push({
+        name: symName,
+        kind: "unknown",
+        domain: featureConfig.domain,
+      });
+    }
+  }
+
+  const response: FeatureContextResponse = {
+    feature: args.feature,
+    domain: featureConfig.domain,
+    description: featureConfig.description,
+    allowed_touchpoints: featureConfig.allowed_touchpoints,
+    reuse_symbols: reuseSymbolsWithMeta,
+    input_contract: (featureConfig.input_contract as Record<string, unknown>) ?? {},
+    output_contract: (featureConfig.output_contract as Record<string, unknown>) ?? {},
+    governance_directives: [
+      "DO NOT modify or edit any files outside allowed_touchpoints.",
+      "DO NOT create duplicate helpers/services; reuse the existing symbols and methods declared in reuse_symbols.",
+      "DO NOT emit or expect phantom payload fields outside input_contract and output_contract.",
+      "DO NOT import cross-domain modules without declared allowed_dependencies in Septum domain boundaries.",
+    ],
+  };
+
+  recordFeatureAccess(featureConfig.domain, args.feature);
+
+  return {
+    content: [
+      {
+        type: "text" as const,
+        text: JSON.stringify(response, null, 2),
+      },
+    ],
+  };
+}
+
+function recordFeatureAccess(domain: string, feature: string): void {
+  try {
+    const septumDir = path.resolve(process.cwd(), ".septum");
+    if (!fs.existsSync(septumDir)) {
+      fs.mkdirSync(septumDir, { recursive: true });
+    }
+    const logPath = path.join(septumDir, "catalog_access.json");
+    let log: { domains?: Record<string, string>; features?: Record<string, string> } = {};
+    if (fs.existsSync(logPath)) {
+      try {
+        log = JSON.parse(fs.readFileSync(logPath, "utf-8"));
+      } catch {}
+    }
+    log.domains = log.domains || {};
+    log.features = log.features || {};
+    const now = new Date().toISOString();
+    log.domains[domain] = now;
+    log.features[feature] = now;
+    fs.writeFileSync(logPath, JSON.stringify(log, null, 2), "utf-8");
+  } catch {}
+}