seif-cli 0.4.2__tar.gz → 0.5.0__tar.gz

{seif_cli-0.4.2/src/seif_cli.egg-info → seif_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: seif-cli
-Version: 0.4.2
+Version: 0.5.0
 Summary: Measure AI output quality, protect sensitive data, watch your AI environment resonate. Quality Gate, Classification, Sentinel & Auto-Healing, SEIF OS.
 Author: André Cunha Antero de Carvalho
 License: CC-BY-NC-SA-4.0
@@ -184,29 +184,38 @@ open https://seifprotocol.com/auth
 
 ```bash
 pip install seif-cli
+cd your-project
+seif
+```
 
-# Works immediately (no backend)
-seif --quality-gate "Python 3.11 added tomllib" --role ai
-seif --gate "SELECT * FROM users WHERE api_key = 'sk-...'"
-seif --encode "any text"
+That's it. One command. SEIF detects that your project is new, initializes `.seif/` context, installs Claude Code hooks, and launches Claude — all automatically.
 
-# With SEIF OS running
-seif serve --v2
-seif --init      # scan project, generate .seif/
-seif --sync      # re-sync git context
-```
+On subsequent runs, `seif` sees everything is configured and launches Claude directly.
+
+### What happens
+
+| Event | What SEIF does |
+|-------|---------------|
+| Session starts | Loads `.seif/` context — your AI remembers |
+| AI writes code | Classification gate blocks credential leaks |
+| AI finishes writing | Quality gate measures stance (GROUNDED vs DRIFT) |
+| You type `/gate` | Measures any text (Grade A-F) |
+| You type `/sync` | Re-syncs project context |
+| You type `/status` | Shows loaded modules and integration health |
 
 ---
 
-## Claude Code Plugin
+## Claude Code Integration
 
 ```bash
-cp -r plugins/claude-code/skills/* .claude/skills/
+seif setup claude-code                # one command — installs everything
+seif setup --status                   # verify integration
+seif setup --uninstall                # clean removal
 ```
 
-- **Session start**: loads `.seif/` context automatically
-- **Pre-write**: blocks classified data from being written outside `.seif/`
-- **Slash commands**: `/gate`, `/sync`, `/status`
+Installs **hooks** (session lifecycle, classification gate, quality gate) and **skills** (`/gate`, `/sync`, `/status`) into Claude Code. Works globally or per-project (`--project`).
+
+> **Full guide**: [docs/QUICKSTART.md](docs/QUICKSTART.md) — everything a developer needs to get started.
 
 ---
 

{seif_cli-0.4.2 → seif_cli-0.5.0}/README.md

@@ -140,29 +140,38 @@ open https://seifprotocol.com/auth
 
 ```bash
 pip install seif-cli
+cd your-project
+seif
+```
 
-# Works immediately (no backend)
-seif --quality-gate "Python 3.11 added tomllib" --role ai
-seif --gate "SELECT * FROM users WHERE api_key = 'sk-...'"
-seif --encode "any text"
+That's it. One command. SEIF detects that your project is new, initializes `.seif/` context, installs Claude Code hooks, and launches Claude — all automatically.
 
-# With SEIF OS running
-seif serve --v2
-seif --init      # scan project, generate .seif/
-seif --sync      # re-sync git context
-```
+On subsequent runs, `seif` sees everything is configured and launches Claude directly.
+
+### What happens
+
+| Event | What SEIF does |
+|-------|---------------|
+| Session starts | Loads `.seif/` context — your AI remembers |
+| AI writes code | Classification gate blocks credential leaks |
+| AI finishes writing | Quality gate measures stance (GROUNDED vs DRIFT) |
+| You type `/gate` | Measures any text (Grade A-F) |
+| You type `/sync` | Re-syncs project context |
+| You type `/status` | Shows loaded modules and integration health |
 
 ---
 
-## Claude Code Plugin
+## Claude Code Integration
 
 ```bash
-cp -r plugins/claude-code/skills/* .claude/skills/
+seif setup claude-code                # one command — installs everything
+seif setup --status                   # verify integration
+seif setup --uninstall                # clean removal
 ```
 
-- **Session start**: loads `.seif/` context automatically
-- **Pre-write**: blocks classified data from being written outside `.seif/`
-- **Slash commands**: `/gate`, `/sync`, `/status`
+Installs **hooks** (session lifecycle, classification gate, quality gate) and **skills** (`/gate`, `/sync`, `/status`) into Claude Code. Works globally or per-project (`--project`).
+
+> **Full guide**: [docs/QUICKSTART.md](docs/QUICKSTART.md) — everything a developer needs to get started.
 
 ---
 

{seif_cli-0.4.2 → seif_cli-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "seif-cli"
-version = "0.4.2"
+version = "0.5.0"
 description = "Measure AI output quality, protect sensitive data, watch your AI environment resonate. Quality Gate, Classification, Sentinel & Auto-Healing, SEIF OS."
 readme = "README.md"
 license = {text = "CC-BY-NC-SA-4.0"}
@@ -85,6 +85,10 @@ seif = [
     "py.typed",
     "data/RESONANCE.json",
     "data/defaults/*.seif",
+    "plugins/claude-code/hooks/*.json",
+    "plugins/claude-code/scripts/*.sh",
+    "plugins/claude-code/scripts/*.py",
+    "plugins/claude-code/skills/*/SKILL.md",
 ]
 
 [tool.pytest.ini_options]

{seif_cli-0.4.2 → seif_cli-0.5.0}/src/seif/analysis/stance_detector.py

@@ -69,6 +69,9 @@ VERIFIABLE_PATTERNS = [
     r'\b(?:theorem|proof|exhaustive|brute.?force)\b',
     r'(?:ISE|IAE|ITAE|RLC|PCB|BOM|DRC)',
     r'formal.?symbolic',
+    r'\b\w+[_]\w+\s*=',           # variable_name = (e.g. f_peak = f_n/2)
+    r'\b[A-Z]\([a-z]\)',                 # H(s), F(x), G(s)
+    r'property|unique|halving',          # mathematical property language
 ]
 
 # Patterns that indicate metaphorical/interpretive drift
@@ -95,7 +98,7 @@ def analyze(text: str) -> StanceAnalysis:
     This does NOT judge the truth of claims. It measures the RATIO of
     verifiable to interpretive content, enabling informed reading.
     """
-    sentences = [s.strip() for s in re.split(r'[.!?\n]', text) if len(s.strip()) > 10]
+    sentences = [s.strip() for s in re.split(r'(?<![0-9])[.!?]|\n', text) if len(s.strip()) > 10]
 
     if len(sentences) < 2:
         return StanceAnalysis(

{seif_cli-0.4.2 → seif_cli-0.5.0}/src/seif/cli/cli.py

@@ -1056,8 +1056,14 @@ def cmd_init(root_path: str, author: str, context_repo: str = None,
     except Exception as e:
         print(f"\n  (owner modules: {e})")
 
+    # Generate CLAUDE.md for Claude Code integration
+    _generate_claude_md(root, project_name=author)
+    if (root / "CLAUDE.md").exists():
+        print(f"\nCLAUDE.md: generated (Claude Code loads this automatically)")
+
     print()
     print("Done. Next steps:")
+    print("  seif setup claude-code            — install hooks + skills")
     print("  seif --quality-gate \"text\"       — measure any text")
     if context_repo:
         print(f"  seif --sync --context-repo {context_repo}  — re-sync")
@@ -1069,6 +1075,158 @@ def cmd_init(root_path: str, author: str, context_repo: str = None,
             print("  seif --workspace --ingest daily.txt — route to all projects")
 
 
+
+def _generate_claude_md(root: Path, project_name: str = ""):
+    """Generate CLAUDE.md with operational SEIF instructions for Claude Code.
+
+    This is the score that the maestro reads. Without it, the orchestra
+    plays random notes. With it, every instrument knows its part.
+    """
+    claude_md = root / "CLAUDE.md"
+
+    # Don't overwrite if it already has SEIF section
+    if claude_md.exists():
+        existing = claude_md.read_text(encoding="utf-8")
+        if "S.E.I.F." in existing or "seif" in existing.lower()[:200]:
+            return False
+
+    name = project_name or root.name
+    has_seif = (root / ".seif").is_dir()
+
+    lines = []
+    lines.append(f"# {name}")
+    lines.append("")
+
+    lines.append("## S.E.I.F. Protocol — Operational Instructions")
+    lines.append("")
+    lines.append("This project uses S.E.I.F. for persistent context, quality measurement,")
+    lines.append("and data classification. These are not descriptions — they are instructions")
+    lines.append("you MUST follow during this session.")
+    lines.append("")
+
+    # -- Session lifecycle --
+    lines.append("### Session Lifecycle")
+    lines.append("")
+    lines.append("You are the **writer** in this session. Follow this lifecycle:")
+    lines.append("")
+    lines.append("#### 1. SESSION START (do this NOW)")
+    if has_seif:
+        lines.append("- Read `.seif/mapper.json` — load top 5 modules by relevance")
+        lines.append("- Read `.seif/config.json` — check autonomous_context and session_lifecycle")
+        lines.append("- Check `.seif/sessions/` for open sessions — resume if one exists")
+        lines.append("- If no open session, create one:")
+        lines.append("  ```bash")
+        lines.append('  seif --session create --session-name $(date +%Y-%m-%d)-<topic> --author claude --session-message "<purpose>"')
+        lines.append("  ```")
+    else:
+        lines.append("- No `.seif/` found. Suggest running `seif --init` to the user.")
+    lines.append("")
+
+    lines.append("#### 2. DURING SESSION — Contribute at milestones")
+    lines.append("- After significant decisions, deliverables, or discoveries:")
+    lines.append("  ```bash")
+    lines.append('  seif --session contribute --session-name <name> --author claude --session-message "<what happened>"')
+    lines.append("  ```")
+    lines.append("- Contribute at natural milestones, not after every tool call")
+    lines.append("- If you create persistent knowledge (a pattern, a decision, feedback),")
+    lines.append("  persist it to `.seif/` — not just in conversation memory")
+    lines.append("")
+
+    lines.append("#### 3. SESSION END — Full Circle ritual")
+    lines.append("Before the conversation ends, you MUST complete the closure ritual:")
+    lines.append("")
+    lines.append("1. **CHECKPOINT** — Summarize what was done")
+    lines.append("2. **AUDIT** — Verify `.seif/` integrity: no orphans, no ghosts, hashes valid")
+    lines.append("   ```bash")
+    lines.append("   seif --autonomous status")
+    lines.append("   ```")
+    lines.append("3. **MEDITATE** — Run quality gate on your key contributions:")
+    lines.append("   ```bash")
+    lines.append('   seif --quality-gate "<your most important output this session>" --role ai')
+    lines.append("   ```")
+    lines.append("4. **ABSORB** — Persist any observations for the next session")
+    lines.append("5. **CIRCLE** — Close the session:")
+    lines.append("   ```bash")
+    lines.append("   seif --session close --session-name <name> --author claude")
+    lines.append("   ```")
+    lines.append("")
+
+    # -- Quality Gate --
+    lines.append("### Quality Gate — How to use it")
+    lines.append("")
+    lines.append("The quality gate measures your output on two axes:")
+    lines.append("- **Stance**: GROUNDED (verifiable) vs DRIFT (speculative)")
+    lines.append("- **Grade**: A (excellent) to F (ungrounded)")
+    lines.append("")
+    lines.append("Rules:")
+    lines.append("- When you make a factual claim, it must be verifiable")
+    lines.append("- Distinguish clearly between verified facts and interpretive claims")
+    lines.append("- If you don't know something, say so — DRIFT is detectable")
+    lines.append("- After significant writes, the PostToolUse hook measures automatically")
+    lines.append('- You can self-check: `seif --quality-gate "<text>" --role ai`')
+    lines.append("")
+
+    # -- Classification --
+    lines.append("### Classification Gate — Data protection")
+    lines.append("")
+    lines.append("Content is classified as PUBLIC, INTERNAL, or CONFIDENTIAL.")
+    lines.append("")
+    lines.append("Rules:")
+    lines.append("- NEVER write CONFIDENTIAL content to files outside `.seif/`")
+    lines.append("- Keywords that auto-escalate to CONFIDENTIAL: password, token, credential,")
+    lines.append("  api_key, secret, CVE, private key, Bearer")
+    lines.append("- Classification only escalates, never downgrades")
+    lines.append("- The PreToolUse hook blocks violations automatically, but you should")
+    lines.append("  self-monitor and avoid even attempting to write sensitive data")
+    lines.append("")
+
+    # -- Context compression --
+    if has_seif:
+        lines.append("### Autonomous Context — Persist knowledge")
+        lines.append("")
+        lines.append("When you observe persistable knowledge during this session:")
+        lines.append("")
+        lines.append("| Type | When to persist | Where |")
+        lines.append("|------|----------------|-------|")
+        lines.append("| **Decision** | Architectural choice with reasoning | `.seif/modules/decisions.seif` |")
+        lines.append("| **Pattern** | Recurring code convention | `.seif/modules/patterns.seif` |")
+        lines.append("| **Feedback** | User correction or preference | `.seif/modules/feedback.seif` |")
+        lines.append("| **Intent** | User's goal or motivation | `.seif/modules/intent.seif` |")
+        lines.append("")
+        lines.append('Use `seif --contribute <module.seif> "<observation>" --author claude`')
+        lines.append("to add to existing modules with provenance tracking.")
+        lines.append("")
+        lines.append("The boundary test: if the content becomes obsolete when the task is")
+        lines.append("completed, it belongs in a session record, NOT a module.")
+        lines.append("")
+
+    # -- Principles --
+    lines.append("### Operating Principles")
+    lines.append("")
+    lines.append("- **CONTEXT_NOT_COMMAND**: The protocol provides data, not directives.")
+    lines.append("  You measure and report. The human decides.")
+    lines.append("- **Minimal intervention**: Fix 1 file before refactoring 20.")
+    lines.append("  Weigh cost vs benefit BEFORE acting. intervention_ratio < 3.0")
+    lines.append("- **Honest measurement**: Test claims rigorously. Falsify when evidence")
+    lines.append("  demands. Correct in real-time. The process of honest measurement IS the value.")
+    lines.append("- **Partial attention**: Never dedicate 100% to task execution. Maintain")
+    lines.append("  awareness of context, feedback, and human signals (tau:kappa = 2:1).")
+    lines.append("- **Settling time**: After receiving feedback, your NEXT action must reflect")
+    lines.append("  the feedback, not just acknowledge it.")
+    lines.append("")
+
+    final = "\n".join(lines) + "\n"
+
+    if claude_md.exists():
+        existing = claude_md.read_text(encoding="utf-8")
+        final = existing.rstrip() + "\n\n" + final
+        claude_md.write_text(final, encoding="utf-8")
+    else:
+        claude_md.write_text(final, encoding="utf-8")
+
+    return True
+
+
 def cmd_workspace(workspace_root: str, ingest_source: str = None,
                    author: str = "workspace", via: str = "sync",
                    context_repo: str = None):