septum 0.1.3 → 0.1.5

package/src/cli/commands/query.ts

@@ -1,64 +1,64 @@
-import { ConfigLoader } from "../../core/config/loader.ts";
-import { SeptumDatabase } from "../../core/database/client.ts";
-import { SeptumRepository } from "../../core/database/repository.ts";
-
-export async function handleQueryCommand(domainName?: string, archetype?: string, jsonOutput?: boolean): Promise<void> {
-  const config = ConfigLoader.load();
-  const db = new SeptumDatabase(config.settings.db_path);
-  const repo = new SeptumRepository(db.raw);
-
-  if (!domainName) {
-    const allDomains = repo.getAllDomains();
-    if (allDomains.length === 0) {
-      console.log("[Septum] No domains found in database. Run 'septum ingest' first.");
-      db.close();
-      return;
-    }
-
-    console.log("=== Registered Domains in Septum ===");
-    for (const d of allDomains) {
-      console.log(`- ${d.name} (root: ${d.root_path})`);
-    }
-    db.close();
-    return;
-  }
-
-  const catalog = repo.getDomainCatalog(domainName, archetype);
-  if (!catalog) {
-    console.error(`[Septum Error] Domain '${domainName}' not found in database. Run 'septum ingest' first.`);
-    db.close();
-    process.exit(1);
-  }
-
-  if (jsonOutput) {
-    console.log(JSON.stringify(catalog, null, 2));
-  } else {
-    console.log(`=================================================`);
-    console.log(`  Domain: ${catalog.domain.toUpperCase()} (Root: ${catalog.root})`);
-    console.log(`=================================================`);
-    console.log(`  Allowed Dependencies:    [${catalog.allowed_dependencies.join(", ")}]`);
-    console.log(`  Forbidden Dependencies:  [${catalog.forbidden_dependencies.join(", ")}]`);
-    console.log(`  Total Files Cataloged:   ${catalog.files.length}`);
-    console.log(`-------------------------------------------------`);
-
-    for (const file of catalog.files) {
-      console.log(`\n  File: ${file.path} [archetype: ${file.archetype}]`);
-      for (const sym of file.symbols) {
-        console.log(`    • ${sym.kind.toUpperCase()} ${sym.name}`);
-        if (sym.methods && sym.methods.length > 0) {
-          for (const m of sym.methods) {
-            console.log(`        - ${m}`);
-          }
-        }
-        if (sym.signatures && sym.signatures.length > 0) {
-          for (const s of sym.signatures) {
-            console.log(`        - ${s}`);
-          }
-        }
-      }
-    }
-    console.log(`\n=================================================`);
-  }
-
-  db.close();
-}
+import { ConfigLoader } from "../../core/config/loader.ts";
+import { SeptumDatabase } from "../../core/database/client.ts";
+import { SeptumRepository } from "../../core/database/repository.ts";
+
+export async function handleQueryCommand(domainName?: string, archetype?: string, jsonOutput?: boolean): Promise<void> {
+  const config = ConfigLoader.load();
+  const db = new SeptumDatabase(config.settings.db_path);
+  const repo = new SeptumRepository(db.raw);
+
+  if (!domainName) {
+    const allDomains = repo.getAllDomains();
+    if (allDomains.length === 0) {
+      console.log("[Septum] No domains found in database. Run 'septum ingest' first.");
+      db.close();
+      return;
+    }
+
+    console.log("=== Registered Domains in Septum ===");
+    for (const d of allDomains) {
+      console.log(`- ${d.name} (root: ${d.root_path})`);
+    }
+    db.close();
+    return;
+  }
+
+  const catalog = repo.getDomainCatalog(domainName, archetype);
+  if (!catalog) {
+    console.error(`[Septum Error] Domain '${domainName}' not found in database. Run 'septum ingest' first.`);
+    db.close();
+    process.exit(1);
+  }
+
+  if (jsonOutput) {
+    console.log(JSON.stringify(catalog, null, 2));
+  } else {
+    console.log(`=================================================`);
+    console.log(`  Domain: ${catalog.domain.toUpperCase()} (Root: ${catalog.root})`);
+    console.log(`=================================================`);
+    console.log(`  Allowed Dependencies:    [${catalog.allowed_dependencies.join(", ")}]`);
+    console.log(`  Forbidden Dependencies:  [${catalog.forbidden_dependencies.join(", ")}]`);
+    console.log(`  Total Files Cataloged:   ${catalog.files.length}`);
+    console.log(`-------------------------------------------------`);
+
+    for (const file of catalog.files) {
+      console.log(`\n  File: ${file.path} [archetype: ${file.archetype}]`);
+      for (const sym of file.symbols) {
+        console.log(`    • ${sym.kind.toUpperCase()} ${sym.name}`);
+        if (sym.methods && sym.methods.length > 0) {
+          for (const m of sym.methods) {
+            console.log(`        - ${m}`);
+          }
+        }
+        if (sym.signatures && sym.signatures.length > 0) {
+          for (const s of sym.signatures) {
+            console.log(`        - ${s}`);
+          }
+        }
+      }
+    }
+    console.log(`\n=================================================`);
+  }
+
+  db.close();
+}

package/src/cli/commands/serve.ts

@@ -1,5 +1,5 @@
-import { runMCPServer } from "../../mcp/server.ts";
-
-export async function handleServeCommand(): Promise<void> {
-  await runMCPServer();
-}
+import { runMCPServer } from "../../mcp/server.ts";
+
+export async function handleServeCommand(): Promise<void> {
+  await runMCPServer();
+}

package/src/cli/commands/slice.ts

@@ -1,90 +1,48 @@
-import { ConfigLoader } from "../../core/config/loader.ts";
-import { SeptumDatabase } from "../../core/database/client.ts";
-import { SeptumRepository } from "../../core/database/repository.ts";
-import { VerticalSliceTracer } from "../../core/resolver/vertical-slice-tracer.ts";
-
-export async function handleSliceCommand(
-  query: string,
-  options?: { json?: boolean }
-): Promise<void> {
-  const config = ConfigLoader.load();
-  const db = new SeptumDatabase(config.settings.db_path);
-  const repo = new SeptumRepository(db.raw);
-
-  try {
-    const tracer = new VerticalSliceTracer(repo);
-    const result = tracer.trace(query);
-
-    if (options?.json) {
-      console.log(JSON.stringify(result, null, 2));
-      return;
-    }
-
-    if (result.found && result.slice) {
-      const s = result.slice;
-      console.log(`\n=================================================`);
-      console.log(`  VERTICAL SLICE: ${s.route.method} ${s.route.uri}`);
-      console.log(`=================================================`);
-      if (s.route.name) {
-        console.log(`  • Route Name:   ${s.route.name}`);
-      }
-
-      if (s.request) {
-        console.log(`\n  • Request Validation:`);
-        console.log(`      Class: ${s.request.class} (${s.request.file || "inline"})`);
-        const rules = Object.keys(s.request.rules);
-        if (rules.length > 0) {
-          console.log(`      Rules:`);
-          for (const r of rules) {
-            console.log(`        - ${r}: ${s.request.rules[r]}`);
-          }
-        }
-      }
-
-      console.log(`\n  • Controller Action:`);
-      console.log(`      Class:  ${s.controller.class}@${s.controller.action}`);
-      console.log(`      Target: ${s.controller.file || "unknown"}:${s.controller.line}`);
-
-      if (s.model) {
-        console.log(`\n  • Model:`);
-        console.log(`      Class:    ${s.model.class} (${s.model.file || "unknown"})`);
-        if (s.model.fillable && s.model.fillable.length > 0) {
-          console.log(`      Fillable: [${s.model.fillable.join(", ")}]`);
-        }
-        if (s.model.casts && Object.keys(s.model.casts).length > 0) {
-          console.log(`      Casts:    ${JSON.stringify(s.model.casts)}`);
-        }
-      }
-
-      if (s.frontend) {
-        console.log(`\n  • Frontend Target:`);
-        console.log(`      Page:  ${s.frontend.target}`);
-        if (s.frontend.props.length > 0) {
-          console.log(`      Props: [${s.frontend.props.join(", ")}]`);
-        }
-      }
-
-      if (result.alternatives && result.alternatives.length > 0) {
-        console.log(`\n  • Alternative Matches:`);
-        for (const alt of result.alternatives) {
-          console.log(`      - ${alt.method} ${alt.uri} -> ${alt.controller}@${alt.action}`);
-        }
-      }
-      console.log(`\n=================================================\n`);
-    } else {
-      console.log(`\n❌ Vertical Slice Not Found:`);
-      console.log(`   Query:   ${result.query}`);
-      console.log(`   Message: ${result.message}`);
-
-      if (result.alternatives && result.alternatives.length > 0) {
-        console.log(`\n   Available Slices:`);
-        for (const alt of result.alternatives) {
-          console.log(`      - ${alt.method} ${alt.uri} -> ${alt.controller}@${alt.action}`);
-        }
-      }
-      console.log(``);
-    }
-  } finally {
-    db.close();
-  }
-}
+import { ConfigLoader } from "../../core/config/loader.ts";
+import { SeptumDatabase } from "../../core/database/client.ts";
+import { SeptumRepository } from "../../core/database/repository.ts";
+import { VerticalSliceTracer } from "../../core/resolver/vertical-slice-tracer.ts";
+
+export async function handleSliceCommand(
+  query: string,
+  options?: { json?: boolean }
+): Promise<void> {
+  const config = ConfigLoader.load();
+  const db = new SeptumDatabase(config.settings.db_path);
+  const repo = new SeptumRepository(db.raw);
+
+  try {
+    const tracer = new VerticalSliceTracer(repo);
+    const result = tracer.trace(query);
+
+    if (options?.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+
+    if (result.found) {
+      console.log(`\n${result.message}\n`);
+      if (result.alternatives && result.alternatives.length > 0) {
+        console.log(`  • Alternative Matches:`);
+        for (const alt of result.alternatives) {
+          console.log(`      - ${alt.method} ${alt.uri} -> ${alt.controller}@${alt.action}`);
+        }
+        console.log(``);
+      }
+    } else {
+      console.log(`\n❌ Vertical Slice Not Found:`);
+      console.log(`   Query:   ${result.query}`);
+      console.log(`   Message: ${result.message}`);
+
+      if (result.alternatives && result.alternatives.length > 0) {
+        console.log(`\n   Available Slices:`);
+        for (const alt of result.alternatives) {
+          console.log(`      - ${alt.method} ${alt.uri} -> ${alt.controller}@${alt.action}`);
+        }
+      }
+      console.log(``);
+    }
+  } finally {
+    db.close();
+  }
+}

package/src/cli/commands/sync.ts

@@ -1,31 +1,31 @@
-import { ConfigLoader } from "../../core/config/loader.ts";
-import { SeptumDatabase } from "../../core/database/client.ts";
-import { SeptumRepository } from "../../core/database/repository.ts";
-import { IngestionPipeline } from "../../core/ingestion/pipeline.ts";
-
-export interface SyncCommandOptions {
-  json?: boolean;
-}
-
-export async function handleSyncCommand(options: SyncCommandOptions = {}): Promise<void> {
-  const config = ConfigLoader.load();
-  const db = new SeptumDatabase(config.settings.db_path);
-  const repo = new SeptumRepository(db.raw);
-  const pipeline = new IngestionPipeline(repo);
-
-  const metrics = await pipeline.run(config);
-
-  if (options.json) {
-    console.log(JSON.stringify(metrics, null, 2));
-  } else {
-    console.log(
-      `[Septum Sync] Ingested in ${metrics.duration_ms.toFixed(0)}ms: ` +
-        `${metrics.files_updated} updated/added, ` +
-        `${metrics.files_skipped} unchanged, ` +
-        `${metrics.symbols_indexed} symbols, ` +
-        `${metrics.dependencies_indexed} deps.`
-    );
-  }
-
-  db.close();
-}
+import { ConfigLoader } from "../../core/config/loader.ts";
+import { SeptumDatabase } from "../../core/database/client.ts";
+import { SeptumRepository } from "../../core/database/repository.ts";
+import { IngestionPipeline } from "../../core/ingestion/pipeline.ts";
+
+export interface SyncCommandOptions {
+  json?: boolean;
+}
+
+export async function handleSyncCommand(options: SyncCommandOptions = {}): Promise<void> {
+  const config = ConfigLoader.load();
+  const db = new SeptumDatabase(config.settings.db_path);
+  const repo = new SeptumRepository(db.raw);
+  const pipeline = new IngestionPipeline(repo);
+
+  const metrics = await pipeline.run(config);
+
+  if (options.json) {
+    console.log(JSON.stringify(metrics, null, 2));
+  } else {
+    console.log(
+      `[Septum Sync] Ingested in ${metrics.duration_ms.toFixed(0)}ms: ` +
+        `${metrics.files_updated} updated/added, ` +
+        `${metrics.files_skipped} unchanged, ` +
+        `${metrics.symbols_indexed} symbols, ` +
+        `${metrics.dependencies_indexed} deps.`
+    );
+  }
+
+  db.close();
+}

package/src/cli/commands/topology.ts

@@ -0,0 +1,119 @@
+import { SeptumDatabase } from "../../core/database/client.ts";
+import { SeptumRepository } from "../../core/database/repository.ts";
+import { EnvironmentDetector } from "../../core/topology/environment-detector.ts";
+import type { EnvironmentLayer, TopologyNode } from "../../core/topology/types.ts";
+
+export async function handleTopologyCommand(
+  subcommand?: string,
+  arg1?: string,
+  arg2?: string,
+  arg3?: string,
+  arg4?: string
+): Promise<void> {
+  const cwd = process.cwd();
+  const db = new SeptumDatabase();
+  const repo = new SeptumRepository(db.raw);
+
+  if (subcommand === "resolve" && arg1 && arg2) {
+    const layer = arg1.toLowerCase() as EnvironmentLayer;
+    const platform = arg2;
+    // Fix: Preserve existing constraints instead of overwriting with empty array
+    const existing = repo.environment.getLayer(layer);
+    repo.environment.saveLayer({
+      layer,
+      platform,
+      canonical_tag: EnvironmentDetector.matchCanonicalTag(platform),
+      status: "VERIFIED",
+      detected_from: ["CLI Manual Resolution"],
+      constraints: existing?.constraints && existing.constraints.length > 0 ? existing.constraints : [
+        `Configured manually as '${platform}'.`
+      ],
+    });
+    console.log(`[Septum Topology] Layer '${layer}' successfully verified as '${platform}' in SQLite SSOT.\n`);
+  } else if (subcommand === "add-node" && arg1 && arg2 && arg3) {
+    const nodeId = arg1;
+    const layer = arg2.toLowerCase() as EnvironmentLayer;
+    const platform = arg3;
+    const domainOrIp = arg4;
+
+    const node: TopologyNode = {
+      id: nodeId,
+      layer,
+      name: nodeId,
+      platform,
+      canonical_tag: EnvironmentDetector.matchCanonicalTag(platform),
+      domain_or_ip: domainOrIp,
+      status: "VERIFIED",
+      detected_from: ["CLI Manual Node Resolution"],
+      constraints: [`Node added manually with platform '${platform}'.`],
+    };
+    repo.environment.saveNode(node);
+    console.log(`[Septum Topology] Node '${nodeId}' (${layer.toUpperCase()}) added to distributed topology graph.\n`);
+  } else if (subcommand === "remove-node" && arg1) {
+    repo.environment.deleteNode(arg1);
+    console.log(`[Septum Topology] Node '${arg1}' removed from distributed topology graph.\n`);
+  } else if (subcommand === "clear") {
+    repo.environment.clearAll();
+    console.log("[Septum Topology] Cleared environment topology and nodes in SQLite SSOT.\n");
+  }
+
+  const topology = EnvironmentDetector.detect(cwd, repo);
+
+  console.log("================================================================================");
+  console.log("🌐 SEPTUM SELF-AWARE ENVIRONMENT TOPOLOGY PLANE");
+  console.log("================================================================================");
+  console.log(`Overall Status:   ${topology.overall_status}`);
+  console.log(`Topology Mode:    ${topology.is_distributed ? "DISTRIBUTED MULTI-NODE GRAPH" : "MONOLITHIC SINGLE-NODE"}`);
+  console.log(`Summary:          ${topology.architectural_summary}\n`);
+
+  if (topology.nodes.length > 0) {
+    console.log("--- DISTRIBUTED TOPOLOGY NODES ---");
+    for (const node of topology.nodes) {
+      const statusIcon = node.status === "VERIFIED" ? "✓ [VERIFIED]" : node.status === "DETECTED" ? "• [DETECTED]" : "? [AMBIGUOUS]";
+      const domainStr = node.domain_or_ip ? ` @ ${node.domain_or_ip}` : "";
+      const roleStr = node.role ? ` [Role: ${node.role}]` : "";
+      console.log(`  ${statusIcon} ${node.id.padEnd(20)} (${node.layer.toUpperCase()}): ${node.platform}${domainStr}${roleStr}`);
+      if (node.connected_to && node.connected_to.length > 0) {
+        console.log(`      ➔ Connected to: ${node.connected_to.join(", ")}`);
+      }
+      if (node.constraints && node.constraints.length > 0) {
+        for (const c of node.constraints) {
+          console.log(`      - ${c}`);
+        }
+      }
+    }
+    console.log("");
+  }
+
+  console.log("--- 6-LAYER PRODUCTION SUMMARY PLANE ---");
+  for (const [layerKey, info] of Object.entries(topology.layers)) {
+    const statusIcon = info.status === "VERIFIED" ? "✓ [VERIFIED]" : info.status === "DETECTED" ? "• [DETECTED]" : "? [AMBIGUOUS]";
+    console.log(`  ${statusIcon} ${layerKey.toUpperCase().padEnd(10)}: ${info.platform || "Unresolved"}`);
+  }
+
+  if (topology.interplays.length > 0) {
+    console.log("\n--- CROSS-LAYER & DISTRIBUTED INVARIANTS ---");
+    for (const interplay of topology.interplays) {
+      console.log(`  ⚡ ${interplay.title} (${interplay.involved_layers.join(" ➔ ")})`);
+      console.log(`     Rule:   ${interplay.risk_or_rule}`);
+      console.log(`     Action: ${interplay.required_action}`);
+    }
+  }
+
+  if (topology.pending_inquiries.length > 0) {
+    console.log("\n--- PENDING ARCHITECTURAL INQUIRIES ---");
+    console.log("Action Required: Please clarify these ambiguous layers/nodes for your AI Agent:\n");
+    for (const inquiry of topology.pending_inquiries) {
+      console.log(`  ❓ ${inquiry}`);
+    }
+    console.log("\nTip: To resolve an inquiry or add distributed nodes, run:");
+    console.log("  septum topology resolve <layer> \"<Platform Name>\"");
+    console.log("  septum topology add-node <id> <layer> \"<Platform Name>\" [domain_or_ip]");
+    console.log("Example:");
+    console.log("  septum topology add-node host:vps-worker host \"Ubuntu 24.04 (Dedicated Worker)\" 10.0.0.6");
+  }
+
+  console.log("================================================================================\n");
+
+  db.close();
+}