speclogician 0.0.0b1__py3-none-any.whl → 0.0.0.dev1__py3-none-any.whl

speclogician/utils/prompt.md

@@ -1,325 +1 @@
-# SpecLogician Agent Playbook
-## Formal Reasoning Copilot for Code, Finance, and Contracts
-
----
-
-## 1. Purpose and Audience
-
-This playbook is written for **LLM-based coding and reasoning agents**
-(Claude Code, Copilot, Cursor, internal agents) operating alongside:
-
-- **SpecLogician** (stateful specification + analysis loop)
-- **CodeLogician** (code → formal model translation)
-- **ImandraX** (symbolic reasoning, decomposition, complement analysis)
-
-The goal is to enable **trustworthy, auditable, and logically complete workflows**
-for regulated and high‑assurance domains:
-- Software systems
-- Financial models
-- Risk engines
-- M&A and regulatory contracts
-- Protocols and workflows
-
-You are not a text editor.
-You are a **formal reasoning copilot**.
-
----
-
-## 2. Core Mental Model
-
-SpecLogician maintains an **immutable state history**.
-
-Each change:
-- Produces a new `StateInstance`
-- Triggers logical analysis
-- Produces a structured `state_diff`
-
-A state consists of:
-
-```
-State
- ├─ Spec
- │   ├─ Domain Model
- │   │   ├─ Base (types + core invariants, IML)
- │   │   ├─ State Predicates
- │   │   ├─ Action Predicates
- │   │   └─ Transitions
- │   ├─ Scenarios (Given / When / Then)
- │   └─ Scenario Complement (coverage)
- ├─ Artifact Container
- │   ├─ Test Traces
- │   ├─ Log Traces
- │   ├─ Documents
- │   └─ Source References
- ├─ Artifact Mapping
- ├─ Derived Stats
- └─ StateDiff (vs previous state)
-```
-
-Nothing mutates in place.
-Progress is measured by **diffs and coverage**, not by edits.
-
----
-
-## 3. The Agent Loop (Golden Path)
-
-Every successful interaction follows this loop:
-
-1. **Inspect**
-   ```bash
-   speclogician view state
-   speclogician view diff
-   ```
-
-2. **Diagnose**
-   - Missing predicates?
-   - Inconsistent scenarios?
-   - Large complement?
-   - Traces not matching scenarios?
-
-3. **Search**
-   ```bash
-   speclogician find predicates <query>
-   speclogician find transitions <query>
-   speclogician find artifacts <query>
-   ```
-
-4. **Apply exactly ONE change**
-   ```bash
-   speclogician ch ...
-   ```
-
-5. **Re‑inspect**
-   ```bash
-   speclogician view diff
-   ```
-
-6. **Repeat**
-
-> One change. One diff. One improvement.
-
----
-
-## 4. Change Commands (`speclogician ch`)
-
-### 4.1 Domain Base
-
-Defines the semantic universe.
-
-```bash
-speclogician ch base-edit --src "type state = { x:int }
-type action = int"
-```
-
-Rules:
-- Must be valid IML
-- Breaks everything downstream if wrong
-- Complement is gated on base validity
-
----
-
-### 4.2 Predicates
-
-Predicates define **classifications**, not behavior.
-
-```bash
-speclogician ch pred-add   --pred-type STATE   --pred-name is_large_trade   --pred-src "s.amount > 1_000_000"
-```
-
-Types:
-- STATE: properties of state
-- ACTION: properties of actions
-
----
-
-### 4.3 Transitions
-
-Transitions define **state evolution**.
-
-```bash
-speclogician ch trans-add   --trans-name execute   --trans-src "let execute (s:state) (a:action) = { amount = s.amount + a }"
-```
-
----
-
-### 4.4 Scenarios
-
-Scenarios define **intended behaviors**.
-
-```bash
-speclogician ch scenario-add trade_exec   --given is_authorized   --when place_order   --then execute
-```
-
-Scenarios:
-- Are partial specifications
-- Do not need to be complete
-- Drive complement reasoning
-
----
-
-### 4.5 Traces
-
-Traces are **concrete evidence**.
-
-```bash
-speclogician ch trace test-add   --art-id T1   --name test_large_trade   --given "{ amount = 2_000_000 }"   --when "{ order = BUY }"   --then "{ approved = true }"
-```
-
-Traces validate scenarios but **do not replace them**.
-
----
-
-## 5. View Commands (`speclogician view`)
-
-Most important commands:
-
-```bash
-speclogician view diff
-speclogician view spec
-speclogician view domain
-speclogician view artifacts
-```
-
-Rules:
-- Always inspect `view diff`
-- Treat diffs as first‑class artifacts
-- Never assume success without checking
-
----
-
-## 6. Search Commands (`speclogician find`)
-
-Use search before modification.
-
-```bash
-speclogician find predicates limit --kind state
-speclogician find transitions approve
-speclogician find artifacts margin --kind docs
-```
-
-Search prevents duplicate logic and drift.
-
----
-
-## 7. Complement & Coverage
-
-The **scenario complement** represents:
-> All logically possible behaviors not covered by scenarios.
-
-Properties:
-- Computed via ImandraX
-- Semantic (not test‑based)
-- Shrinking complement = progress
-
-Signals:
-- No complement → base or scenarios invalid
-- Large complement → missing intent
-- Empty complement → specification is complete (rare, valuable)
-
----
-
-## 8. Worked Example 1: Minimal State Machine
-
-### Goal
-Model a simple counter with increment.
-
-**Base**
-```bash
-speclogician ch base-edit --src "type state = { x:int }
-type action = int"
-```
-
-**Predicate**
-```bash
-speclogician ch pred-add --pred-type STATE --pred-name nonneg --pred-src "s.x >= 0"
-```
-
-**Transition**
-```bash
-speclogician ch trans-add --trans-name inc --trans-src "let inc s a = { x = s.x + a }"
-```
-
-**Scenario**
-```bash
-speclogician ch scenario-add inc_ok --given nonneg --then inc
-```
-
-Inspect:
-```bash
-speclogician view diff
-```
-
-Complement highlights:
-- What about negative actions?
-- What about overflow?
-
-Add scenarios accordingly.
-
----
-
-## 9. Worked Example 2: Financial Rule
-
-### Rule
-Large trades require approval.
-
-**Predicate**
-```bash
-speclogician ch pred-add --pred-type STATE --pred-name large_trade --pred-src "s.amount > 1_000_000"
-```
-
-**Scenario**
-```bash
-speclogician ch scenario-add approval_required --given large_trade --then approve
-```
-
-Complement reveals:
-- Small trades?
-- Large trades without approval?
-- Conflicting predicates?
-
-This is logic discovery, not testing.
-
----
-
-## 10. Domains Beyond Code
-
-This workflow applies unchanged to:
-
-- M&A contracts (conditions, obligations, breaches)
-- Financial models (risk regions, limits)
-- Regulatory logic (must/must-not rules)
-- Protocols (valid/invalid sequences)
-
-Replace:
-- state → contract state
-- action → event
-- transition → clause effect
-
----
-
-## 11. What NOT To Do
-
-❌ Edit files directly  
-❌ Apply multiple changes at once  
-❌ Ignore `state_diff`  
-❌ Confuse tests with coverage  
-❌ Assume LLM intuition equals correctness  
-
----
-
-## 12. Final Agent Instructions
-
-You are a **reasoning engine supervisor**.
-
-Every step must:
-- Be justified by `view` or `find`
-- Produce a measurable `state_diff`
-- Reduce inconsistency or complement
-- Increase confidence and auditability
-
-If unsure:
-- Inspect more
-- Ask for clarification
-- Apply the smallest possible change
-
-Formal reasoning is a process, not a jump.
+You are an expert in SpecLogician, an AI framework for data-driven formal program specification synthesis, verification and analysis.

speclogician-0.0.0.dev1.dist-info/METADATA

@@ -0,0 +1,21 @@
+Metadata-Version: 2.3
+Name: speclogician
+Version: 0.0.0.dev1
+Summary: SpecLogicain AI framework for data-driven formal program specification synthesis, verification and analysis
+Author: denis, hongyu
+Author-email: denis <denis@imandra.ai>, hongyu <hongyu@imandra.ai>
+Requires-Dist: imandrax-api-models>=18.0.0
+Requires-Dist: iml-query>=0.5.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: rich>=14.2.0
+Requires-Dist: textual>=6.11.0
+Requires-Dist: typer>=0.20.0
+Requires-Python: >=3.12
+Project-URL: Homepage, https://speclogician.dev/
+Description-Content-Type: text/markdown
+
+# SpecLogician
+SpecLogicain AI framework for data-driven formal program specification synthesis, verification and analysis
+
+
+www.speclogician.dev

speclogician-0.0.0.dev1.dist-info/RECORD

@@ -0,0 +1,43 @@
+speclogician/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+speclogician/agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+speclogician/agent/funcs.py,sha256=lBVL-1YlU9f5dn482TxuTisfBXk3kr17h-oFC8Q3z7c,552
+speclogician/cmd/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+speclogician/cmd/agent_cmd.py,sha256=tJvKklJpbQw1Db5DVzYyU2VBl0rN9iwePzb8mLhuS4k,2710
+speclogician/cmd/data_cmd.py,sha256=n6P0L38mnVaCAqruDJjNCqmFCNzBWe-BoQn8utPA0kQ,398
+speclogician/cmd/model_cmd.py,sha256=QA5YMBXFjaSRkQRBQaRPMp8Y2lhkKi288b1G_gAE5fI,1029
+speclogician/cmd/overlay_cmd.py,sha256=sHx8E3pwMDkBd8IWeCVCjO5AiD4bfFtlb1_dZ1B2wJ4,673
+speclogician/cmd/scenario_cmd.py,sha256=Gjmm0elZ3sAtVveqP6nZff_O_GpTN2yZhO68qoUvUT4,1100
+speclogician/cmd/state_cmd.py,sha256=8KmRDIl71QQl8_yw6ORxy1O5fsca9o-RkRlqfOWSAI0,1159
+speclogician/data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+speclogician/data/artifact.py,sha256=oQHQ0D565i3gvp_QdiEALoXewSL-Z4AL8Y2Z56rmBx8,366
+speclogician/data/container.py,sha256=jljeavtdDwSG4I6Ntvmpwmb_KmXvDy0L_aAB1GV56Ro,563
+speclogician/data/mapping.py,sha256=2x5KMiUhcUoRL-Tb8sxpGiI6eX4oD4YCDvENpRV8_qk,2885
+speclogician/data/refs.py,sha256=rb3zD0JkOVzktG2tdC_j9YOv_34oKwFl5q7k0tkyPZs,348
+speclogician/data/reports.py,sha256=PaK7go4zMXtugyJ4gg1vLAkuDwkd33SGHz4-LRtjqDw,116
+speclogician/data/traces.py,sha256=DBXPd4IUbBxoEhSMjs0fiis7NNvw3vkJdzyT_9FVMr8,608
+speclogician/llms/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+speclogician/llms/llmtools.py,sha256=NHmkenyszS2NoVXdQ22eAq75OmraIX7m02FPEYP7ogg,2276
+speclogician/llms/overlay.py,sha256=nrowPE4SrcsFhWdKbGIPI80uWThXYenXT00iLmLybUk,7885
+speclogician/main.py,sha256=mAkTz-DAsvrU5vOcQPdUk93IbdgsVE-EUOs20TxuytU,2310
+speclogician/modeling/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+speclogician/modeling/component.py,sha256=d_HzfyCBuI90GRFlsiu7JxPqvxvsfnPRswP96nlCTp8,267
+speclogician/modeling/conflict.py,sha256=7rVlhGfCZbv8i-dgVLZ0deaGABNS9SZ3KvOi5x7-qFY,127
+speclogician/modeling/domain.py,sha256=4ZCJUBxt7gcrXFMtg70reApuHXTi8dVSImFwDOeBfk0,4432
+speclogician/modeling/model.py,sha256=A4VobQOIYgjDrDPkJ4srROzV_nRSmscN_yDNv6MgGwk,5651
+speclogician/modeling/predicates.py,sha256=ePu-3QW0-Ja60U6P_6L0g9iXSl40PdDF3IgNAnYhrco,1195
+speclogician/modeling/report.py,sha256=VejOnI4hDIHl-5q-trd17c4dYqKKLU3eAigb-PfnEHk,476
+speclogician/modeling/scenario.py,sha256=tJuAjfqZzw8q_xzXAq1xd4iqeEMuRh5Xwb1r3u74XHs,5081
+speclogician/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+speclogician/sl_cmd.py,sha256=rh72UYlQTzEaAiZJ5RBWTGka-LU-zpvoeqoCBq4Ki9g,1159
+speclogician/state/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+speclogician/state/change.py,sha256=MICmyj4bh0k0dFKYfJNWccgRhVXDdnnhxd2_fbaOuxg,2422
+speclogician/state/state.py,sha256=V5_XHP4CfFKdC_5XOa514HKJiAI1ypEFCMzXdi0AQgU,7154
+speclogician/tui/box.tcss,sha256=IfVIxGMR1fStHWkwF3u72wIsLtzZRu3JN83do9jLI-Y,126
+speclogician/tui/tui.py,sha256=0gLHEQL4jo82SRdYRl1u9UdFiBwAcoUh9bCMphQpiT0,3817
+speclogician/utils/__init__.py,sha256=8RWo-F7jlfmpmCWSgNW_rWjO6waEYeDI-oAmsxqf1Xc,100
+speclogician/utils/imx.py,sha256=Z9-6_-Dc1btZzApRYjHSh1Q2XBJticMKiP0rxQcLVEg,6002
+speclogician/utils/load.py,sha256=i06IUiocR0AOwEe3oL-5bOlKJiw1rDmgyHRRljAcFYM,980
+speclogician/utils/prompt.md,sha256=A61_-VG_U-rxPXTjcZbaFLUB5uBW6yuFLrseBAW1-TQ,133
+speclogician-0.0.0.dev1.dist-info/WHEEL,sha256=-neZj6nU9KAMg2CnCY6T3w8J53nx1kFGw_9HfoSzM60,79
+speclogician-0.0.0.dev1.dist-info/METADATA,sha256=uvEB0LF_EX5BM3b1vwFRQ447Rlu4bZIsRezXZo5L7kc,721
+speclogician-0.0.0.dev1.dist-info/RECORD,,

speclogician/commands/__init__.py

@@ -1,15 +0,0 @@
-#
-#   Imandra Inc.
-#
-#   speclogician/commands/__init__.py
-#
-
-from .cmd_ch import app as ch_app
-from .cmd_find import app as find_app
-from .cmd_view import app as view_app
-
-__all__ = [
-    "ch_app",
-    "find_app",
-    "view_app"
-]