septum 0.1.3 → 0.1.5

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 shironim
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 shironim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,102 +1,105 @@
-# Septum
-
-> **Deterministic Bounded-Context & Anti-Poisoning Architecture Guard for AI Coding Agents.**
-
-[![Runtime: Bun](https://img.shields.io/badge/Runtime-Bun-black?logo=bun)](https://bun.sh)
-[![Protocol: Model Context Protocol](https://img.shields.io/badge/Protocol-MCP-green)](https://modelcontextprotocol.io/)
-[![Database: SQLite WAL](https://img.shields.io/badge/Database-SQLite%20(bun:sqlite)-003B57?logo=sqlite)](https://sqlite.org/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue)](LICENSE)
-
-Septum stops **context poisoning** in AI coding agents. It indexes your codebase into an embedded SQLite SSOT (`.septum/septum.db`), enforces strict bounded-context domains, and intercepts unauthorized cross-domain edits before they hit disk.
-
----
-
-## Installation
-
-Install Septum globally using [Bun](https://bun.sh):
-
-```bash
-bun add -g septum
-```
-
-> **Note:** You can also run commands on-the-fly without global installation using `bunx septum <command>`.
-
----
-
-## Quick Start
-
-### 1. Initialize in Any Project
-
-```bash
-septum init
-# or zero-install via bunx:
-bunx septum init
-```
-*Auto-detects project topology (Monorepos, Laravel, Next.js, Go, NestJS), registers domains, and ingests AST symbols into `.septum/septum.db`.*
-
-### 2. Connect to AI Agent (MCP Server)
-
-Add Septum to your MCP client (`mcp.json` or `claude_desktop_config.json`):
-
-```json
-{
-  "mcpServers": {
-    "septum": {
-      "command": "septum",
-      "args": ["serve"]
-    }
-  }
-}
-```
-*(Or use `"command": "bunx", "args": ["septum", "serve"]` if running without global installation).*
-
----
-
-## CLI Reference
-
-| Command | Description |
-|---|---|
-| `septum init` | Detect topology, scaffold boundary guards, and build initial catalog |
-| `septum ingest` | Full AST re-indexing into `.septum/septum.db` |
-| `septum sync` | Fast incremental delta sync (< 15ms) for modified files |
-| `septum check --strict` | CI/CD gate: verify boundary integrity & fail on violations |
-| `septum query [domain]` | Inspect domain catalog, archetypes, and public signatures |
-| `septum locate <query>` | Locate symbol, class, interface, method, or error source |
-| `septum slice <route\|intent>` | Trace end-to-end vertical execution slice for route/intent |
-| `septum feature status\|clear` | Manage active feature lease and editing scope |
-| `septum serve` | Launch stdio MCP server for AI coding agents |
-
----
-
-## Core Capabilities & MCP Tools
-
-All tools expose typed schemas automatically via the Model Context Protocol:
-
-- **Whole-Project Telescope (`septum_get_domain_catalog`):** Returns macro architecture maps in < 400 tokens.
-- **Vertical Slice Tracer (`septum_trace_vertical_slice`):** Traces execution chains (*Ingress ➔ Validation ➔ Orchestration ➔ Domain ➔ Egress*) across frameworks.
-- **Pre-Flight Boundary Guard (`septum_check_boundary`):** Validates proposed edits and imports against bounded-context rules.
-- **Scope Locking (`septum_get_feature_context` / `septum_clear_feature_context`):** Locks active feature scope to eliminate context drift.
-- **Symbol & Blast Radius (`septum_locate_symbol`, `septum_get_symbol`, `septum_get_symbol_impact`):** Resolves call chains, signatures, and refactoring impact.
-- **God Function Detector (`septum_get_symbol_hotspots`):** Surfaces oversized functions/methods by physical lines-of-code.
-- **Dynamic Topology (`septum_register_domain`):** Registers or updates domains and boundary rules on-the-fly.
-
----
-
-## Development & Contributing
-
-```bash
-# Clone and install dependencies
-git clone https://github.com/shironim/septum.git
-cd septum
-bun install
-
-# Run test suite & build
-bun test
-bun run build
-```
-
----
-
-## License
-
-[MIT](LICENSE) © shironim
+# Septum
+
+> **Deterministic Bounded-Context & Anti-Poisoning Architecture Guard for AI Coding Agents.**
+
+[![Version: 0.1.5](https://img.shields.io/badge/Version-0.1.5-blue)](package.json)
+[![Runtime: Bun](https://img.shields.io/badge/Runtime-Bun-black?logo=bun)](https://bun.sh)
+[![Protocol: Model Context Protocol](https://img.shields.io/badge/Protocol-MCP-green)](https://modelcontextprotocol.io/)
+[![Database: SQLite WAL](https://img.shields.io/badge/Database-SQLite%20(bun:sqlite)-003B57?logo=sqlite)](https://sqlite.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue)](LICENSE)
+
+Septum stops **context poisoning** in AI coding agents. It indexes your codebase into an embedded SQLite SSOT (`.septum/septum.db`), enforces strict bounded-context domains, and intercepts unauthorized cross-domain edits before they hit disk.
+
+---
+
+## Installation
+
+Install Septum globally using [Bun](https://bun.sh):
+
+```bash
+bun add -g septum
+```
+
+> **Note:** You can also run commands on-the-fly without global installation using `bunx septum <command>`.
+
+---
+
+## Quick Start
+
+### 1. Initialize in Any Project
+
+```bash
+septum init
+# or zero-install via bunx:
+bunx septum init
+```
+*Auto-detects project topology (Monorepos, Laravel, Next.js, Go, NestJS), registers domains, and ingests AST symbols into `.septum/septum.db`.*
+
+### 2. Connect to AI Agent (MCP Server)
+
+Add Septum to your MCP client (`mcp.json` or `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "septum": {
+      "command": "septum",
+      "args": ["serve"]
+    }
+  }
+}
+```
+*(Or use `"command": "bunx", "args": ["septum", "serve"]` if running without global installation).*
+
+---
+
+## CLI Reference
+
+| Command | Description |
+|---|---|
+| `septum init` | Detect topology, scaffold boundary guards, and build initial catalog |
+| `septum ingest` | Full AST re-indexing into `.septum/septum.db` |
+| `septum sync` | Fast incremental delta sync (< 15ms) for modified files |
+| `septum check --strict` | CI/CD gate: verify boundary integrity & fail on violations |
+| `septum query [domain]` | Inspect domain catalog, archetypes, and public signatures |
+| `septum locate <query>` | Locate symbol, class, interface, method, or error source |
+| `septum slice <route\|intent>` | Trace end-to-end vertical execution slice for route/intent |
+| `septum topology [action]` | Inspect 6-layer environment topology plane & distributed nodes |
+| `septum feature status\|clear` | Manage active feature lease and editing scope |
+| `septum serve` | Launch stdio MCP server for AI coding agents |
+
+---
+
+## Core Capabilities & MCP Tools
+
+All tools expose typed schemas automatically via the Model Context Protocol:
+
+- **Self-Aware Environment Topology (`septum_get_environment_topology`):** Maps and verifies the 6-layer production architecture (Edge/WAF, Gateway/Web Server, Host, Runtime, Storage/Cache, Telemetry) and distributed entities with cross-layer invariants.
+- **Whole-Project Telescope (`septum_get_domain_catalog`):** Returns macro architecture maps in < 400 tokens.
+- **Omni-Trigger Vertical Slice Tracer (`septum_trace_vertical_slice`):** Traces execution chains across HTTP routes, queue jobs, console commands, and event listeners (*Ingress ➔ Validation ➔ Orchestration ➔ Domain ➔ Egress*).
+- **Pre-Flight Boundary Guard (`septum_check_boundary`):** Validates proposed edits and imports against bounded-context rules.
+- **Scope Locking (`septum_get_feature_context` / `septum_clear_feature_context`):** Locks active feature scope to eliminate context drift.
+- **Symbol & Blast Radius (`septum_locate_symbol`, `septum_get_symbol`, `septum_get_symbol_impact`):** Resolves call chains, signatures, and refactoring impact.
+- **God Function & Nesting Detector (`septum_get_symbol_hotspots`):** Surfaces oversized functions/methods ranked by physical lines, cyclomatic nesting depth, and composite risk score.
+- **Dynamic Topology (`septum_register_domain`):** Registers or updates domains and boundary rules on-the-fly.
+
+---
+
+## Development & Contributing
+
+```bash
+# Clone and install dependencies
+git clone https://github.com/shironim/septum.git
+cd septum
+bun install
+
+# Run test suite & build
+bun test
+bun run build
+```
+
+---
+
+## License
+
+[MIT](LICENSE) © shironim

package/bin/septum.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env bun
-import { runCLI } from "../src/cli/index.ts";
-
-runCLI(process.argv);
+#!/usr/bin/env bun
+import { runCLI } from "../src/cli/index.ts";
+
+runCLI(process.argv);

package/package.json

@@ -1,63 +1,63 @@
-{
-  "name": "septum",
-  "version": "0.1.3",
-  "description": "Deterministic Bounded-Context, Structural File Catalog & Anti-Poisoning Partition for AI Agents",
-  "type": "module",
-  "main": "src/index.ts",
-  "bin": {
-    "septum": "./bin/septum.ts"
-  },
-  "engines": {
-    "bun": ">=1.1.0"
-  },
-  "scripts": {
-    "start": "bun run bin/septum.ts",
-    "serve": "bun run bin/septum.ts serve",
-    "ingest": "bun run bin/septum.ts ingest",
-    "sync": "bun run bin/septum.ts sync",
-    "check": "bun run bin/septum.ts check",
-    "test": "bun test",
-    "build": "bun build ./bin/septum.ts --compile --outfile dist/septum",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.5.0",
-    "web-tree-sitter": "^0.24.0",
-    "yaml": "^2.7.0",
-    "zod": "^3.24.2"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/shironim/septum.git"
-  },
-  "homepage": "https://github.com/shironim/septum#readme",
-  "bugs": {
-    "url": "https://github.com/shironim/septum/issues"
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "bounded-context",
-    "architecture",
-    "ai-agent",
-    "tree-sitter",
-    "clean-architecture",
-    "domain-driven-design",
-    "codebase-catalog",
-    "antigravity"
-  ],
-  "files": [
-    "bin",
-    "src",
-    "README.md",
-    "LICENSE"
-  ],
-  "devDependencies": {
-    "@types/bun": "latest",
-    "@types/node": "^22.13.4",
-    "tree-sitter-wasms": "^0.1.13",
-    "typescript": "^5.7.3"
-  }
-}
-
+{
+  "name": "septum",
+  "version": "0.1.5",
+  "description": "Deterministic Bounded-Context, Structural File Catalog & Anti-Poisoning Partition for AI Agents",
+  "type": "module",
+  "main": "src/index.ts",
+  "bin": {
+    "septum": "./bin/septum.ts"
+  },
+  "engines": {
+    "bun": ">=1.1.0"
+  },
+  "scripts": {
+    "start": "bun run bin/septum.ts",
+    "serve": "bun run bin/septum.ts serve",
+    "ingest": "bun run bin/septum.ts ingest",
+    "sync": "bun run bin/septum.ts sync",
+    "check": "bun run bin/septum.ts check",
+    "test": "bun test",
+    "build": "bun build ./bin/septum.ts --compile --outfile dist/septum",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.5.0",
+    "web-tree-sitter": "^0.24.0",
+    "yaml": "^2.7.0",
+    "zod": "^3.24.2"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shironim/septum.git"
+  },
+  "homepage": "https://github.com/shironim/septum#readme",
+  "bugs": {
+    "url": "https://github.com/shironim/septum/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "bounded-context",
+    "architecture",
+    "ai-agent",
+    "tree-sitter",
+    "clean-architecture",
+    "domain-driven-design",
+    "codebase-catalog",
+    "antigravity"
+  ],
+  "files": [
+    "bin",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^22.13.4",
+    "tree-sitter-wasms": "^0.1.13",
+    "typescript": "^5.7.3"
+  }
+}
+