@ulpi/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 ULPI
+
+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

@@ -0,0 +1,200 @@
+# ULPI
+
+**Take control of your AI coding agent.**
+
+ULPI sits between you and Claude Code, automatically approving safe operations, blocking dangerous ones, and enforcing your project's rules — so you spend less time clicking "Allow" and more time building.
+
+[![npm version](https://img.shields.io/npm/v/@ulpi/cli.svg)](https://www.npmjs.com/package/@ulpi/cli)
+[![license](https://img.shields.io/npm/l/@ulpi/cli.svg)](https://opensource.org/licenses/MIT)
+[![node](https://img.shields.io/node/v/@ulpi/cli.svg)](https://nodejs.org)
+
+---
+
+## Why ULPI?
+
+Without ULPI, every Claude Code session is a stream of permission prompts. You click "Allow" for `npm test`. Allow for `git status`. Allow for reading a file. Over and over.
+
+With ULPI:
+
+- `npm test` runs automatically — you defined it as safe
+- `rm -rf /` gets blocked — before Claude can execute it
+- Editing a file requires reading it first — because you set that rule
+- Your session history is preserved — decisions, patterns, and context carry over
+
+You write the rules once. ULPI enforces them every session.
+
+---
+
+## Install
+
+```bash
+npm install -g @ulpi/cli
+```
+
+Requires **Node.js 20** or later.
+
+## Get Started
+
+```bash
+cd your-project
+ulpi init
+```
+
+That's it. ULPI detects your stack — language, framework, package manager, test runner, linter — and generates a tailored rules configuration. Hooks are installed into Claude Code automatically.
+
+Next time you start a Claude Code session, ULPI is active.
+
+### Try it without installing
+
+```bash
+cd your-project
+npx @ulpi/cli init
+```
+
+---
+
+## What You Get
+
+### Automatic Permissions
+
+Stop clicking "Allow" for every safe command. Define what's safe once, and ULPI handles the rest.
+
+```yaml
+permissions:
+  auto-approve-tests:
+    trigger: PermissionRequest
+    matcher: Bash
+    command_pattern: "npm test|pnpm test|yarn test"
+    decision: allow
+```
+
+### Guardrails
+
+Block destructive operations before they execute. ULPI ships with built-in protection against `rm -rf`, `git push --force`, `DROP TABLE`, and more — plus you can add your own.
+
+### Preconditions
+
+Enforce good practices automatically. Require files to be read before editing. Require tests to pass before committing. Require linting before pushing.
+
+```yaml
+preconditions:
+  read-before-edit:
+    trigger: PreToolUse
+    matcher: "Write|Edit"
+    message: "Read the file before editing it."
+    requires_read: true
+```
+
+### Session Tracking
+
+ULPI knows what happened in your session — which files were read, which were written, which commands ran. Rules can use this context to make smarter decisions.
+
+### Web Dashboard
+
+A full web UI for managing rules, viewing live sessions, reviewing AI-generated plans, and browsing session history.
+
+```bash
+ulpi ui
+```
+
+<!-- TODO: Add screenshot -->
+
+### Plan & Code Review
+
+Review AI-generated plans and code changes in a dedicated UI before they execute. Annotate, approve, or reject with feedback that gets sent back to the agent.
+
+### Semantic Code Search
+
+ULPI indexes your codebase and exposes it as MCP tools that Claude Code can use for smarter, context-aware search — beyond simple grep.
+
+### Agent Memory
+
+Captures decisions, patterns, and lessons learned across sessions. Your AI agent builds institutional knowledge over time instead of starting fresh every conversation.
+
+---
+
+## Configuration
+
+Rules live in `.ulpi/guards.yml` at your project root:
+
+```yaml
+project:
+  name: my-app
+  runtime: node
+  package_manager: pnpm
+  test_command: pnpm test
+
+preconditions:
+  read-before-edit:
+    trigger: PreToolUse
+    matcher: "Write|Edit"
+    message: "Read the file before editing it."
+    requires_read: true
+
+permissions:
+  auto-approve-tests:
+    trigger: PermissionRequest
+    matcher: Bash
+    command_pattern: "pnpm test"
+    decision: allow
+
+  auto-approve-git-read:
+    trigger: PermissionRequest
+    matcher: Bash
+    command_pattern: "git (status|log|diff|branch)"
+    decision: allow
+```
+
+ULPI ships with **28 built-in templates** for popular stacks — Node.js, Python, Go, Rust, Next.js, Laravel, Django, FastAPI, and more.
+
+```bash
+ulpi templates list
+```
+
+---
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `ulpi init` | Detect your stack and install hooks |
+| `ulpi rules` | Manage rules (list, add, enable, disable, validate) |
+| `ulpi templates` | Browse and apply rule templates |
+| `ulpi skills` | Manage injectable skills |
+| `ulpi status` | Show current session state |
+| `ulpi log` | View activity log |
+| `ulpi ui` | Launch web dashboard |
+| `ulpi projects` | Manage multiple projects |
+| `ulpi history` | Browse session history |
+| `ulpi review` | Plan and code review management |
+| `ulpi codemap` | Semantic code search and indexing |
+| `ulpi memory` | Agent memory management |
+| `ulpi config` | View and update settings |
+| `ulpi update` | Check for and install updates |
+| `ulpi export` | Export your rules configuration |
+| `ulpi import` | Import a rules configuration |
+| `ulpi uninstall` | Remove ULPI hooks from project |
+
+---
+
+## How It Works
+
+ULPI uses [Claude Code hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) — lifecycle events that fire before and after every tool execution:
+
+1. **Before a tool runs**, ULPI checks your rules. Should this file edit be allowed? Has the file been read first? Is this command safe?
+2. **When a permission is requested**, ULPI decides automatically based on your rules — allow, deny, or ask the user.
+3. **After a tool runs**, ULPI updates session state and runs any postconditions you've defined.
+4. **At session boundaries**, ULPI captures history, classifies memories, and indexes code changes.
+
+If ULPI ever encounters an error, it fails open — Claude Code continues normally. Your agent is never blocked by a bug in ULPI.
+
+---
+
+## Requirements
+
+- **Node.js** >= 20
+- **Claude Code** with [hooks support](https://docs.anthropic.com/en/docs/claude-code/hooks)
+
+## License
+
+MIT

package/dist/auth-PN7TMQHV-2W4ICG64.js

@@ -0,0 +1,15 @@
+import {
+  generateApiSecret,
+  getApiSecret,
+  setApiSecret,
+  validateAuth,
+  validateLoopback
+} from "./chunk-MIAQVCFW.js";
+import "./chunk-4VNS5WPM.js";
+export {
+  generateApiSecret,
+  getApiSecret,
+  setApiSecret,
+  validateAuth,
+  validateLoopback
+};