Skip to content

YujunZhou/tellonce / codex

tellonce

Verified

Use to view, explain, correct, delete or reorganize the user's saved preferences, or to record one by hand when automatic recording is off; learning and rule injection otherwise run automatically through Codex hooks.

FileKindSize
.codex-plugin/plugin.jsonconfig1.3 KB
SKILL.mdskill md12.0 KB
dashboard.shexecutablescript348 B
docs/CC_PARITY_MATRIX.mdmarkdown7.3 KB
docs/README.mdmarkdown3.4 KB
doctor.shexecutablescript345 B
hooks/hooks.jsonconfig714 B
hooks/posttooluse-deterministic-block.shexecutablescript2.0 KB
hooks/sessionstart-init.shexecutablescript1.9 KB
hooks/userpromptsubmit-dispatch.pyscript2.6 KB
hooks/userpromptsubmit-memory-upsert.shscript326 B
hooks/userpromptsubmit-pending-inject.shexecutablescript2.0 KB
hooks/userpromptsubmit-retrieve-inject.shexecutablescript3.1 KB
hooks/userpromptsubmit-shadow-alert-inject.shexecutablescript1.2 KB
install.shexecutablescript13.9 KB
shared_lib/_install_merge_settings.pyscript12.1 KB
shared_lib/_pt_hooks.txtmarkdown407 B
shared_lib/correction_interpretation.pyscript8.5 KB
shared_lib/detect_user_prefer.pyscript7.2 KB
shared_lib/deterministic_block.pyscript9.3 KB
shared_lib/event_obligations.pyscript19.8 KB
shared_lib/execution_support.pyscript75.8 KB
shared_lib/fingerprints.yamlconfig1.1 KB
shared_lib/learning_policy.pyscript4.6 KB
shared_lib/memory_judge.pyscript84.8 KB
shared_lib/memory_publication.pyscript14.9 KB
shared_lib/memory_runtime.pyscript12.2 KB
shared_lib/memory_store.pyscript99.6 KB
shared_lib/memory_upsert.pyscript57.1 KB
shared_lib/memory_upsert_hook.pyscript4.6 KB
shared_lib/model_requests.pyscript5.8 KB
shared_lib/path_config.pyscript13.3 KB
shared_lib/pending_queue_manager.pyscript23.4 KB
shared_lib/pt_platform.pyscript1.5 KB
shared_lib/redaction.pyscript3.4 KB
shared_lib/retrieve_inject.pyexecutablescript57.9 KB
shared_lib/rule_selection.pyscript18.9 KB
shared_lib/shadow_alert_inject.pyscript6.1 KB
shared_lib/training_memory.pyscript17.8 KB
shared_lib/transcript_adapter.pyscript13.7 KB
shared_lib/verify_compliance.pyexecutablescript24.5 KB
shared_lib/verify_retry_shadow.pyscript27.4 KB
tellonce_codex/__init__.pyscript52 B
tellonce_codex/__main__.pyscript49 B
tellonce_codex/cli.pyscript6.8 KB
tellonce_codex/codex_posttooluse_block.pyscript11.2 KB
tellonce_codex/dashboard.pyscript3.4 KB
tellonce_codex/doctor.pyscript10.9 KB
tellonce_codex/index.pyscript1.8 KB
tellonce_codex/install.pyscript3.1 KB
tellonce_codex/install_codex_hooks.pyscript15.1 KB
tellonce_codex/ledger.pyscript17.1 KB
tellonce_codex/memory.pyscript5.3 KB
tellonce_codex/migrate.pyscript1.3 KB
tellonce_codex/mode.pyscript2.3 KB
tellonce_codex/paths.pyscript8.6 KB
tellonce_codex/promote.pyscript4.4 KB
tellonce_codex/scan.pyscript2.6 KB
tellonce_codex/uninstall.pyscript1.7 KB
tellonce_codex/verify.pyscript5.3 KB
tellonce_codex/wrapper.pyscript12.0 KB
uninstall.shexecutablescript4.6 KB

tellonce_codex/verify.py

View on GitHub
from __future__ import annotations

import os
import re
from dataclasses import dataclass
from pathlib import Path


@dataclass(frozen=True)
class Verdict:
    verdict: str
    violations: list[dict]


# CX-15 fix: provide a base whitelist + user-extension contract instead of
# always running with an empty set (which made every Chinese reply containing
# any English token noise \u2014 e.g. `def`, `http`, `json`, `API`, file paths).
_BASE_WHITELIST: frozenset[str] = frozenset({
    # programming-ubiquitous tokens (case-insensitive)
    "api", "json", "yaml", "toml", "xml", "html", "css", "js", "ts",
    "url", "uri", "http", "https", "ftp", "ssh", "tcp", "udp",
    "cli", "gui", "ide", "sdk", "ci", "cd", "qa", "ux",
    "def", "var", "let", "const", "return", "import", "export",
    "true", "false", "null", "none",
    # AI/ML
    "ai", "ml", "llm", "gpt", "claude", "anthropic", "openai", "codex",
    # cloud / infra commonly referenced
    "aws", "gcp", "azure", "k8s", "docker", "git", "github", "gitlab",
    # python-style
    "pip", "npm", "yarn", "uv",
    # filesystem terms that are language-of-art in mixed-zh prose
    "path", "dir", "file", "pwd", "cwd", "env",
    # token symbols too short to filter individually but caught by the {2,} rule
})


def load_default_whitelist() -> set[str]:
    """Build the runtime whitelist: base set \u222a user-extension file (one token per line).

    User-extension file lookup order:
      1. CODEX_PT_WHITELIST env var (path to a file)
      2. <state_root>/whitelist.txt (resolved via paths.load_registration \u2014
         but verify.py doesn't know the project root, so this is loaded by
         wrapper.py at call time, not here)

    Comments (#-prefixed lines) and blank lines are ignored.
    """
    out: set[str] = {w.lower() for w in _BASE_WHITELIST}
    extra_path = os.environ.get("CODEX_PT_WHITELIST", "").strip()
    if extra_path:
        try:
            with open(extra_path, encoding="utf-8") as f:
                for line in f:
                    line = line.strip()
                    if not line or line.startswith("#"):
                        continue
                    out.add(line.lower())
        except OSError:
            pass
    return out


def merge_state_whitelist(base: set[str], state_root: Path) -> set[str]:
    """Add user-edited whitelist tokens from <state_root>/whitelist.txt.
    Called by wrapper.py once it knows the state root.
    """
    user_path = state_root / "whitelist.txt"
    if not user_path.is_file():
        return base
    out = set(base)
    try:
        with open(user_path, encoding="utf-8") as f:
            for line in f:
                line = line.strip()
                if not line or line.startswith("#"):
                    continue
                out.add(line.lower())
    except OSError:
        pass
    return out


def _chinese_ratio(text: str) -> float:
    chars = [c for c in text if not c.isspace()]
    if not chars:
        return 0.0
    chinese = sum(1 for c in chars if "\u4e00" <= c <= "\u9fff")
    return chinese / len(chars)


def _inline_english_tokens(text: str, whitelist: set[str]) -> list[str]:
    tokens = re.findall(r"\b[A-Za-z][A-Za-z0-9_\-]{2,}\b", text)
    allowed = {w.lower() for w in whitelist}
    return [token for token in tokens if token.lower() not in allowed]


def verify_output(text: str, whitelist: set[str] | None = None) -> Verdict:
    """Run deterministic output checks.

    Public-release stance (matches root + copilot, whose evaluate_rules() ships
    empty): verify_output ships NO built-in personal rules enabled by default.
    Both checks below are personal-origin rules and are gated behind opt-in env
    vars, so the default install is "ship-empty":

      - CODEX_PT_TMP_RULE   — when set to a non-empty value, enable the generic
                              `/tmp/` durable-path advisory (tool-pit-130).
      - CODEX_PT_LANG_RULE  — when set to a non-empty value, enable the
                              inline-English-in-Chinese advisory (lang-pit-130).
                              The value may be any non-empty marker / language
                              code; only its presence is checked here.

    The _BASE_WHITELIST and inline-token helpers remain available and are used
    only when CODEX_PT_LANG_RULE is enabled.
    """
    if whitelist is None:
        whitelist = load_default_whitelist()
    violations = []
    if os.environ.get("CODEX_PT_TMP_RULE", "").strip() and re.search(r"/tmp/[^\s`'\"]+", text):
        violations.append(
            {
                "rule_id": "tool-pit-130",
                "severity": "warn",
                "evidence": ["/tmp path in output"],
                "repair_instruction": "Use a durable project path for important artifacts.",
            }
        )
    if os.environ.get("CODEX_PT_LANG_RULE", "").strip():
        inline = _inline_english_tokens(text, whitelist)
        if inline and _chinese_ratio(text) >= 0.35:
            violations.append(
                {
                    "rule_id": "lang-pit-130",
                    "severity": "warn",
                    "evidence": inline[:10],
                    "repair_instruction": "Avoid ordinary English filler in Chinese user-facing replies unless whitelisted.",
                }
            )
    return Verdict(verdict="warn_log" if violations else "pass", violations=violations)
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall