pythia-plsql 0.1.0__tar.gz → 0.1.2__tar.gz

{pythia_plsql-0.1.0/scripts/pythia_plsql.egg-info → pythia_plsql-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythia-plsql
-Version: 0.1.0
+Version: 0.1.2
 Summary: PL/SQL development for AI agents on Oracle Database - expert data-dictionary queries, impact analysis, and a snapshot-verified write path with honest rollback.
 License: MIT
 Project-URL: Homepage, https://github.com/thaildhe172591/pythia
@@ -12,10 +12,16 @@ License-File: LICENSE
 Requires-Dist: oracledb>=2.0
 Dynamic: license-file
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/thaildhe172591/pythia/main/assets/logo.png" alt="pythia" width="280" />
+</p>
+
 # pythia
 
 > Oracle's MCP gives your agent a connection. **pythia gives it the judgment to use it.**
 
+**English** · [Tiếng Việt](README.vi.md)
+
 [![ci](https://github.com/thaildhe172591/pythia/actions/workflows/ci.yml/badge.svg)](https://github.com/thaildhe172591/pythia/actions/workflows/ci.yml)
 [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 ![python](https://img.shields.io/badge/python-3.9%2B-blue)
@@ -79,6 +85,12 @@ for internal mirrors) — without Node it copies the bundled skill pack into
 `.claude/skills/` and `.agents/skills/`. Skills alone: `npx skills add
 thaildhe172591/pythia`, or `/plugin marketplace add thaildhe172591/pythia`.
 
+`pip install` is **once per machine**; `pythia install` is **once per
+project** — run it in each repo's root to drop the skills and a fresh
+`.pythia/connections.json` there. The CLI always reads the config of the
+project you are standing in (searched upward from the current directory,
+no global fallback), so one global CLI never mixes up databases.
+
 Running from a clone works too — `python scripts/pythia.py <command>`; every
 printed follow-up command matches how you invoked it. Windows, macOS, Linux
 and WSL are all CI-tested.
@@ -90,7 +102,7 @@ and WSL are all CI-tested.
 | `check` connectivity + counts | `deps` what it depends on | `apply` the six-step write |
 | `ls` find objects | `impact` what depends on it | `journal` list · diff · export · restore |
 | `src` source, compiler line numbers | `errors` compile errors, line:col | `policy` show · set |
-| `args` signatures | `invalid` everything broken | |
+| `args` signatures | `invalid` everything broken | `unistr` exact non-ASCII literals |
 | `ddl` via DBMS_METADATA | `plscope` exact identifier usages | |
 | `cols` columns + types | `similar` programs named like this | |
 | `grep` search all source | | |

{pythia_plsql-0.1.0 → pythia_plsql-0.1.2}/README.md

@@ -1,7 +1,13 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/thaildhe172591/pythia/main/assets/logo.png" alt="pythia" width="280" />
+</p>
+
 # pythia
 
 > Oracle's MCP gives your agent a connection. **pythia gives it the judgment to use it.**
 
+**English** · [Tiếng Việt](README.vi.md)
+
 [![ci](https://github.com/thaildhe172591/pythia/actions/workflows/ci.yml/badge.svg)](https://github.com/thaildhe172591/pythia/actions/workflows/ci.yml)
 [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 ![python](https://img.shields.io/badge/python-3.9%2B-blue)
@@ -65,6 +71,12 @@ for internal mirrors) — without Node it copies the bundled skill pack into
 `.claude/skills/` and `.agents/skills/`. Skills alone: `npx skills add
 thaildhe172591/pythia`, or `/plugin marketplace add thaildhe172591/pythia`.
 
+`pip install` is **once per machine**; `pythia install` is **once per
+project** — run it in each repo's root to drop the skills and a fresh
+`.pythia/connections.json` there. The CLI always reads the config of the
+project you are standing in (searched upward from the current directory,
+no global fallback), so one global CLI never mixes up databases.
+
 Running from a clone works too — `python scripts/pythia.py <command>`; every
 printed follow-up command matches how you invoked it. Windows, macOS, Linux
 and WSL are all CI-tested.
@@ -76,7 +88,7 @@ and WSL are all CI-tested.
 | `check` connectivity + counts | `deps` what it depends on | `apply` the six-step write |
 | `ls` find objects | `impact` what depends on it | `journal` list · diff · export · restore |
 | `src` source, compiler line numbers | `errors` compile errors, line:col | `policy` show · set |
-| `args` signatures | `invalid` everything broken | |
+| `args` signatures | `invalid` everything broken | `unistr` exact non-ASCII literals |
 | `ddl` via DBMS_METADATA | `plscope` exact identifier usages | |
 | `cols` columns + types | `similar` programs named like this | |
 | `grep` search all source | | |

{pythia_plsql-0.1.0 → pythia_plsql-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pythia-plsql"
-version = "0.1.0"
+version = "0.1.2"
 description = "PL/SQL development for AI agents on Oracle Database - expert data-dictionary queries, impact analysis, and a snapshot-verified write path with honest rollback."
 readme = "README.md"
 license = { text = "MIT" }

{pythia_plsql-0.1.0 → pythia_plsql-0.1.2}/scripts/pythia.py

@@ -42,6 +42,7 @@ you always know whether you saw everything.
   pythia journal restore <id>
   pythia policy
   pythia install
+  pythia unistr "Nhóm không được để trống"
 """
 import argparse
 import json
@@ -1300,6 +1301,36 @@ def cmd_conventions(conn, schema, ns):
         print(f"\nProse rules for agents: {md}")
 
 
+# unistr escapes. Single quote doubles to '' per SQL (a \' is ORA-01756 for
+# Oracle); backslash doubles for unistr itself.
+UNISTR_ESC = {0: r"\0", 8: r"\b", 9: r"\t", 10: r"\n", 13: r"\r",
+              11: r"\v", 12: r"\f", 92: "\\\\", 39: "''"}
+
+
+def to_unistr(text):
+    r"""A National-charset-safe Oracle literal for any text. Non-ASCII goes
+    to \XXXX escapes, so the statement survives every client/DB charset on
+    the way in — the standard way to keep Vietnamese messages exact."""
+    out = []
+    for ch in text:
+        cp = ord(ch)
+        if cp in UNISTR_ESC:
+            out.append(UNISTR_ESC[cp])
+        elif 0x1F < cp < 0x7F:
+            out.append(ch)
+        elif cp > 0xFFFF:
+            out.append("\\U%08X" % cp)   # beyond the BMP: \U + 8 hex
+        else:
+            out.append("\\%04X" % cp)
+    return "unistr('%s')" % "".join(out)
+
+
+def cmd_unistr(conn, schema, ns):
+    text = " ".join(ns.text) if ns.text else sys.stdin.read().rstrip("\n")
+    u = to_unistr(text)
+    print("'loi:'||%s||':loi'" % u if ns.loi else u)
+
+
 DEFAULT_SKILLS_SOURCE = "thaildhe172591/pythia"
 
 # Kept byte-identical to examples/connections.example.json —
@@ -1398,9 +1429,10 @@ COMMANDS = {"check": cmd_check, "ls": cmd_ls, "src": cmd_src, "args": cmd_args,
             "invalid": cmd_invalid, "errors": cmd_errors, "deps": cmd_deps,
             "impact": cmd_impact, "similar": cmd_similar, "plscope": cmd_plscope,
             "policy": cmd_policy, "journal": cmd_journal, "apply": cmd_apply,
-            "conventions": cmd_conventions, "install": cmd_install}
+            "conventions": cmd_conventions, "install": cmd_install,
+            "unistr": cmd_unistr}
 
-NO_DB_COMMANDS = {"policy", "journal", "conventions", "install"}
+NO_DB_COMMANDS = {"policy", "journal", "conventions", "install", "unistr"}
 
 
 # --- CLI ---------------------------------------------------------------------
@@ -1499,6 +1531,12 @@ def build_parser():
                    help="impact depth for the preview (default 3)")
     sub.add_parser("conventions", parents=[common()],
                    help="show the project's house-style naming patterns")
+    s = sub.add_parser("unistr", parents=[common()],
+                       help="Oracle unistr('...') literal for non-ASCII text "
+                            "(Vietnamese messages stay exact)")
+    s.add_argument("text", nargs="*", help="text; omit to read stdin")
+    s.add_argument("--loi", action="store_true",
+                   help="wrap as 'loi:'||unistr(...)||':loi'")
     s = sub.add_parser("install", parents=[common()],
                        help="install the skill pack and scaffold .pythia/ config")
     s.add_argument("--source", default=DEFAULT_SKILLS_SOURCE,

{pythia_plsql-0.1.0 → pythia_plsql-0.1.2/scripts/pythia_plsql.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythia-plsql
-Version: 0.1.0
+Version: 0.1.2
 Summary: PL/SQL development for AI agents on Oracle Database - expert data-dictionary queries, impact analysis, and a snapshot-verified write path with honest rollback.
 License: MIT
 Project-URL: Homepage, https://github.com/thaildhe172591/pythia
@@ -12,10 +12,16 @@ License-File: LICENSE
 Requires-Dist: oracledb>=2.0
 Dynamic: license-file
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/thaildhe172591/pythia/main/assets/logo.png" alt="pythia" width="280" />
+</p>
+
 # pythia
 
 > Oracle's MCP gives your agent a connection. **pythia gives it the judgment to use it.**
 
+**English** · [Tiếng Việt](README.vi.md)
+
 [![ci](https://github.com/thaildhe172591/pythia/actions/workflows/ci.yml/badge.svg)](https://github.com/thaildhe172591/pythia/actions/workflows/ci.yml)
 [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 ![python](https://img.shields.io/badge/python-3.9%2B-blue)
@@ -79,6 +85,12 @@ for internal mirrors) — without Node it copies the bundled skill pack into
 `.claude/skills/` and `.agents/skills/`. Skills alone: `npx skills add
 thaildhe172591/pythia`, or `/plugin marketplace add thaildhe172591/pythia`.
 
+`pip install` is **once per machine**; `pythia install` is **once per
+project** — run it in each repo's root to drop the skills and a fresh
+`.pythia/connections.json` there. The CLI always reads the config of the
+project you are standing in (searched upward from the current directory,
+no global fallback), so one global CLI never mixes up databases.
+
 Running from a clone works too — `python scripts/pythia.py <command>`; every
 printed follow-up command matches how you invoked it. Windows, macOS, Linux
 and WSL are all CI-tested.
@@ -90,7 +102,7 @@ and WSL are all CI-tested.
 | `check` connectivity + counts | `deps` what it depends on | `apply` the six-step write |
 | `ls` find objects | `impact` what depends on it | `journal` list · diff · export · restore |
 | `src` source, compiler line numbers | `errors` compile errors, line:col | `policy` show · set |
-| `args` signatures | `invalid` everything broken | |
+| `args` signatures | `invalid` everything broken | `unistr` exact non-ASCII literals |
 | `ddl` via DBMS_METADATA | `plscope` exact identifier usages | |
 | `cols` columns + types | `similar` programs named like this | |
 | `grep` search all source | | |

{pythia_plsql-0.1.0 → pythia_plsql-0.1.2}/skills/plsql-write/SKILL.md

@@ -33,6 +33,9 @@ existing ones — not to introduce a better style.
    - End the file with the PL/SQL block's `;` and a final line holding `/`.
    - Name the object unqualified, or qualified with the exact schema the
      connection targets — a mismatch is refused at apply time.
+   - **Non-ASCII string literals** (Vietnamese messages, any accented text):
+     never paste raw — run `pythia unistr "<text>"` and use the printed
+     `unistr('...')`, so the text survives every client/DB charset exactly.
 5. **Check yourself before handing off.** Reread against
    `reference/patterns.md` — cursor and bulk patterns, exception discipline,
    bind variables, commit ownership.

{pythia_plsql-0.1.0 → pythia_plsql-0.1.2}/tests/test_phase1.py

@@ -240,6 +240,19 @@ def test_source_unit_filter():
     assert pythia.filter_units(rows, body=False, spec=False) == rows
 
 
+def test_to_unistr():
+    r"""Ported from the field tool's self-check: Vietnamese exact, quote
+    doubled per SQL (never \'), backslash doubled, beyond-BMP \U form."""
+    u = pythia.to_unistr
+    assert u("Nhóm không được để trống") == \
+        r"unistr('Nh\00F3m kh\00F4ng \0111\01B0\1EE3c \0111\1EC3 tr\1ED1ng')"
+    assert u("Mã bệnh") == r"unistr('M\00E3 b\1EC7nh')"
+    assert u("O'Brien") == "unistr('O''Brien')"
+    assert u("a\\b") == r"unistr('a\\b')"
+    assert u("\U0001F600") == r"unistr('\U0001F600')"
+    assert u("ABC 123") == "unistr('ABC 123')"
+
+
 def test_json_envelope():
     s = pythia.json_envelope("ls", "DEV", "OWNER1", ["A", "B"],
                              [(1, datetime.date(2026, 1, 2))], truncated=True)