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

shared_lib/shadow_alert_inject.py

View on GitHub
#!/usr/bin/env python3
"""Soft injection (UserPromptSubmit hook).

Read B5_SHADOW_ALERT.md (rolling cap N=3 violations from shadow judge), inject
"last turn you violated X" notice into next-turn additionalContext.

Defenses:
  - B5_INJECT_DISABLED=1 env opt-out
  - 24h TTL: alerts older than 24h auto-skipped at read time
  - Empty alert file → exit 0 silently

JSON output.
Defensive fallbacks.
"""
import json
import os
import re
import sys
from datetime import datetime, timezone, timedelta
try:
    import fcntl
except ImportError:  # pragma: no cover - Windows fallback
    fcntl = None

import sys as _sys
_LIB_DIR = os.path.dirname(os.path.abspath(__file__))
_sys.path.insert(0, _LIB_DIR)
import path_config

SHADOW_ALERT_MD = path_config.get_shadow_alert_md_path()
SHADOW_LOG = path_config.get_shadow_log_path()
CONSUMED_ALERTS = os.path.join(os.path.dirname(SHADOW_LOG), 'b5_shadow_alerts_consumed.json')
CONSUMED_ALERTS_LOCK = os.path.join(os.path.dirname(SHADOW_LOG), 'b5_shadow_alerts_consumed.lock')

B5_INJECT_DISABLED = path_config.pt_env('INJECT_DISABLED', '').lower() in ('1', 'true', 'yes')
TTL_HOURS = path_config.pt_env_float('TTL_HOURS', 24)
ALERT_ROLLING_CAP = path_config.pt_env_int('ALERT_ROLLING_CAP', 3)


def _alert_key(alert):
    """Stable key for one logged alert entry."""
    return '|'.join([
        str(alert.get('timestamp', '')),
        str(alert.get('rule_id', '')),
        str(alert.get('feedback', '')),
    ])


def _read_consumed_alert_keys():
    """Read alerts already injected into UserPromptSubmit once."""
    if not os.path.exists(CONSUMED_ALERTS):
        return set()
    try:
        with open(CONSUMED_ALERTS, errors='ignore') as f:
            data = json.load(f)
        if isinstance(data, list):
            return {str(x) for x in data}
    except Exception:
        pass
    return set()


def _write_consumed_alert_keys(keys):
    """Persist consumed alert keys with a small bounded file."""
    try:
        os.makedirs(os.path.dirname(CONSUMED_ALERTS), exist_ok=True)
        ordered = sorted(keys)[-1000:]
        tmp = f'{CONSUMED_ALERTS}.tmp.{os.getpid()}'
        with open(tmp, 'w') as f:
            json.dump(ordered, f, ensure_ascii=False)
            f.write('\n')
            f.flush()
            os.fsync(f.fileno())
        path_config.chmod_or_warn(tmp, 0o600, critical=True)
        os.replace(tmp, CONSUMED_ALERTS)
        path_config.chmod_or_warn(CONSUMED_ALERTS, 0o600, critical=True)
    except Exception:
        try:
            if 'tmp' in locals() and os.path.exists(tmp):
                os.unlink(tmp)
        except Exception:
            pass


def _mark_alerts_consumed(alerts):
    if not alerts:
        return
    keys = _read_consumed_alert_keys()
    keys.update(_alert_key(a) for a in alerts)
    _write_consumed_alert_keys(keys)


def _claim_recent_alerted_violations(hours=24):
    """Return recent alerts and atomically mark them consumed for this project."""
    try:
        os.makedirs(os.path.dirname(CONSUMED_ALERTS_LOCK), exist_ok=True)
        with open(CONSUMED_ALERTS_LOCK, 'a+') as lock:
            path_config.chmod_or_warn(CONSUMED_ALERTS_LOCK, 0o600, critical=False)
            if fcntl is not None:
                fcntl.flock(lock.fileno(), fcntl.LOCK_EX)
            alerts = _read_recent_alerted_violations(hours=hours)
            _mark_alerts_consumed(alerts)
            if fcntl is not None:
                fcntl.flock(lock.fileno(), fcntl.LOCK_UN)
            return alerts
    except Exception:
        return []


def _read_recent_alerted_violations(hours=24):
    """Read shadow log, return alerted=True entries within TTL window. Most recent first."""
    if not os.path.exists(SHADOW_LOG):
        return []
    cutoff = datetime.now(timezone.utc) - timedelta(hours=hours)
    out = []
    consumed = _read_consumed_alert_keys()
    try:
        with open(SHADOW_LOG, errors='ignore') as f:
            for line in f:
                try:
                    o = json.loads(line.strip())
                except Exception:
                    continue
                if not o.get('alerted', False):
                    continue
                ts_str = o.get('timestamp')
                try:
                    ts = datetime.fromisoformat(ts_str.replace('Z', '+00:00'))
                except Exception:
                    continue
                if ts >= cutoff:
                    if _alert_key(o) in consumed:
                        continue
                    out.append(o)
    except Exception:
        pass
    out.sort(key=lambda o: o.get('timestamp', ''), reverse=True)
    # dedupe by rule_id (latest only)
    seen_ids = set()
    deduped = []
    for o in out:
        rid = o.get('rule_id', '')
        if rid in seen_ids:
            continue
        seen_ids.add(rid)
        deduped.append(o)
        if len(deduped) >= ALERT_ROLLING_CAP:
            break
    return deduped


def build_inject_context(alerts):
    """Build additionalContext markdown from the alert list: which rules the
    shadow judge flagged last turn, and the suggested fix direction."""
    if not alerts:
        return None
    lines = ['### Rules the shadow judge flagged last turn:']
    for a in alerts:
        rid = a.get('rule_id', '<unknown>')
        desc = a.get('rule_desc', '')
        conf = a.get('judge_confidence', '?')
        feedback = a.get('feedback', '')[:150]
        lines.append(f'- **[{rid}]** {desc} (confidence {conf})')
        if feedback:
            lines.append(f'  fix: {feedback}')
    return '\n'.join(lines)


def main():
    """UserPromptSubmit hook entrypoint."""
    try:
        data = json.load(sys.stdin)
    except Exception:
        sys.exit(0)

    if B5_INJECT_DISABLED:
        sys.exit(0)

    alerts = _claim_recent_alerted_violations(hours=TTL_HOURS)
    context = build_inject_context(alerts)
    if not context:
        sys.exit(0)

    out = {
        'hookSpecificOutput': {
            'hookEventName': 'UserPromptSubmit',
            'additionalContext': context,
        }
    }
    sys.stdout.write(json.dumps(out, ensure_ascii=False))


if __name__ == '__main__':
    try:
        main()
    except SystemExit:
        raise
    except Exception:
        sys.exit(0)
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