faultsguards 0.1.0__py3-none-any.whl

faultsguards/__init__.py

@@ -0,0 +1,4 @@
+"""faultsguards: the Faults and Guards of Heuremen LLC as data, prompts and an MCP server. https://heuremen.org/faults.pdf https://heuremen.org/guards.pdf"""
+__version__ = '0.1.0'
+from .core import load, faults, guards, get_fault, get_guard, families, search, source_info
+from .prompts import checklist, preflight, system_prompt, review_prompt, tool_schemas, call_tool, OUTCOMES

faultsguards/__main__.py

@@ -0,0 +1,3 @@
+import sys
+from .cli import main
+sys.exit(main())

faultsguards/cli.py

@@ -0,0 +1,34 @@
+"""python -m faultsguards COMMAND. faults, guards, show, search, prompt, preflight, review, tools, mcp."""
+import sys, json, argparse
+from . import __version__
+from .core import faults, guards, get_fault, get_guard, search, families
+from .prompts import system_prompt, preflight, review_prompt, tool_schemas
+def main(argv=None):
+    ap = argparse.ArgumentParser(prog='faultsguards', description='Faults and Guards, Heuremen LLC. https://heuremen.org/faults.pdf')
+    ap.add_argument('--version', action='version', version=__version__); sub = ap.add_subparsers(dest='cmd')
+    sub.add_parser('faults', help='list the failure modes'); sub.add_parser('guards', help='list the procedures')
+    s = sub.add_parser('show', help='print one entry in full'); s.add_argument('which', choices=['fault', 'guard']); s.add_argument('number', type=int)
+    s = sub.add_parser('search', help='search by words'); s.add_argument('query', nargs='+')
+    s = sub.add_parser('prompt', help='a system prompt listing the guards'); s.add_argument('--full', action='store_true')
+    s = sub.add_parser('preflight', help='the guards that run before the work'); s.add_argument('--task'); s.add_argument('--full', action='store_true')
+    s = sub.add_parser('review', help='a prompt reviewing a text file against the faults'); s.add_argument('file'); s.add_argument('--numbers', type=int, nargs='*')
+    sub.add_parser('tools', help='function-calling schemas as JSON'); sub.add_parser('mcp', help='run the MCP server over stdio')
+    a = ap.parse_args(argv)
+    if a.cmd == 'faults':
+        for f in families('faults'):
+            print(f['part']); [print('  %d. %s' % (e['number'], e['title'])) for e in faults() if e['number'] in f['numbers']]
+    elif a.cmd == 'guards':
+        for f in families('guards'):
+            print(f['part']); [print('  %d. %s' % (e['number'], e['title'])) for e in guards() if e['number'] in f['numbers']]
+    elif a.cmd == 'show': e = (get_fault if a.which == 'fault' else get_guard)(a.number); print('%d. %s\n%s\n\n%s' % (e['number'], e['title'], e['part'], e['text']))
+    elif a.cmd == 'search':
+        for h in search(' '.join(a.query)): print('%s %d. %s' % (h['document'], h['number'], h['title']))
+    elif a.cmd == 'prompt': print(system_prompt(a.full))
+    elif a.cmd == 'preflight': print(preflight(a.task, a.full))
+    elif a.cmd == 'review': print(review_prompt(open(a.file, encoding='utf-8').read(), a.numbers))
+    elif a.cmd == 'tools': print(json.dumps(tool_schemas(), indent=1))
+    elif a.cmd == 'mcp':
+        from .mcp_server import serve; serve()
+    else: ap.print_help()
+    return 0
+if __name__ == '__main__': sys.exit(main())

faultsguards/core.py

@@ -0,0 +1,34 @@
+"""Data access for the Faults and Guards. The data is generated from the published sources (tools/extract.py) and never edited by hand."""
+import json, os, re
+_D = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'data')
+_cache = {}
+def load(which):
+    """which is 'faults' or 'guards'. Returns the whole document: intro, parts, entries, sections."""
+    if which not in ('faults', 'guards'): raise ValueError("which must be 'faults' or 'guards'")
+    if which not in _cache: _cache[which] = json.load(open(os.path.join(_D, which + '.json'), encoding='utf-8'))
+    return _cache[which]
+def faults(): return load('faults')['entries']
+def guards(): return load('guards')['entries']
+def _get(entries, n):
+    for e in entries:
+        if e['number'] == int(n): return e
+    raise KeyError(n)
+def get_fault(n): return _get(faults(), n)
+def get_guard(n): return _get(guards(), n)
+def families(which='faults'):
+    """The parts of the document in order, each with its entry numbers."""
+    out = []
+    for e in load(which)['entries']:
+        if not out or out[-1]['part'] != e['part']: out.append(dict(part=e['part'], numbers=[]))
+        out[-1]['numbers'].append(e['number'])
+    return out
+def search(query, which=None):
+    """Entries whose title or text contain every word of the query, case-insensitive. which: 'faults', 'guards' or None for both."""
+    words = [w for w in re.findall(r'\w+', query.lower()) if w]; hits = []
+    for w in ((which,) if which else ('faults', 'guards')):
+        for e in load(w)['entries']:
+            hay = (e['title'] + ' ' + e['text']).lower()
+            if all(x in hay for x in words): hits.append(dict(document=w, number=e['number'], title=e['title'], part=e['part']))
+    return hits
+def source_info():
+    return dict(faults='https://heuremen.org/faults.pdf', guards='https://heuremen.org/guards.pdf', publisher='Heuremen LLC')