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/memory_upsert_hook.py

View on GitHub
#!/usr/bin/env python3
"""Fast hook adapter that enqueues a turn without opening SQLite."""
from __future__ import annotations

import argparse
import json
import os
from pathlib import Path
import sys
import time
import hashlib
import math

_LIB_DIR = os.path.dirname(os.path.abspath(__file__))
if _LIB_DIR not in sys.path:
    sys.path.insert(0, _LIB_DIR)

import memory_upsert
import path_config
import pt_platform
import transcript_adapter


def _event_key(data: dict, mode: str, reference=None) -> str:
    session = transcript_adapter.get_session_id(data)
    if not isinstance(session, str) or not session.strip():
        return ''
    for key in ("turn_id", "turnId", "event_id", "eventId", "prompt_id", "promptId", "message_id"):
        value = data.get(key)
        if ((isinstance(value, str) and value.strip())
                or (type(value) is int and value >= 0)):
            return f"{mode}-{value}"
    timestamp = data.get('timestamp')
    valid_timestamp = ((isinstance(timestamp, str) and bool(timestamp.strip()))
                       or (type(timestamp) in {int, float} and math.isfinite(timestamp)))
    if reference is None and not valid_timestamp:
        return ''
    identity = {'session': session,
                'timestamp': timestamp if valid_timestamp else None, 'reference': reference,
                'prompt': data.get('prompt') or data.get('user_prompt') or ''}
    digest = hashlib.sha256(json.dumps(identity, sort_keys=True, ensure_ascii=False).encode()).hexdigest()
    return f'{mode}-{digest}'


def _load_stdin() -> dict:
    try:
        value = json.load(sys.stdin)
        return value if isinstance(value, dict) else {}
    except Exception:
        return {}


def _log_hook_error(exc: Exception) -> None:
    try:
        state_dir = Path(path_config.get_state_dir())
        state_dir.mkdir(parents=True, exist_ok=True)
        path = state_dir / "memory_upsert_hook_errors.log"
        with path.open("a", encoding="utf-8") as handle:
            handle.write(
                f"{time.strftime('%Y-%m-%dT%H:%M:%SZ', time.gmtime())} "
                f"{type(exc).__name__}: {str(exc)[:500]}\n"
            )
        try:
            os.chmod(path, 0o600)
        except OSError:
            pass
    except Exception:
        pass


def enqueue_from_hook(data: dict, mode: str) -> dict:
    disabled_by_guard = any(
        os.environ.get(name, "").strip().lower() in {"1", "true", "yes", "on"}
        for name in (
            "B5_RETRIEVE_RECURSION_GUARD",
            "PT_MEMORY_UPSERT_DISABLED",
        )
    )
    if pt_platform.is_child_session() or disabled_by_guard or not memory_upsert.hooks_enabled():
        return {"status": "disabled"}
    if mode == "stop" and (data.get("stop_hook_active") or data.get("stopHookActive")):
        return {"status": "reentry_skipped"}
    if mode != "prompt":
        return {"status": "prompt_only"}
    cwd = transcript_adapter.get_cwd(data)
    if cwd:
        os.environ["PT_PROJECT_ROOT"] = cwd
        os.environ["B5_PROJECT_ROOT"] = cwd
        path_config.get_project_root.cache_clear()
        path_config.get_memory_dir.cache_clear()
    session_id = transcript_adapter.get_session_id(data) or "unknown-session"
    source_text = data.get("prompt") or data.get("user_prompt") or ""
    if not isinstance(source_text, str):
        return {'status': 'invalid_prompt', 'blocking': False}
    if not transcript_adapter.is_trusted_user_entry(data, source_text):
        return {"status": "empty"}
    context_parts = []
    if cwd:
        context_parts.insert(0, f"Current project root: {cwd}")
    context = "\n\n".join(context_parts)
    if not source_text.strip():
        return {"status": "empty"}
    reference = transcript_adapter.capture_context_reference(data)
    event_key = _event_key(data, mode, reference)
    if not event_key:
        _log_hook_error(ValueError('automatic learning skipped: no stable prompt event identity'))
        return {'status': 'missing_event_identity', 'blocking': False}
    turn_key = f"{pt_platform.CLI_COMMAND}-{session_id}-{event_key}"
    return memory_upsert.enqueue(
        source_text=source_text,
        turn_key=turn_key,
        context=context,
        memory_dir=path_config.get_memory_dir(),
        spawn_worker=True,
        detect_signal=True,
        context_reference=reference,
    )


def main(argv=None) -> int:
    parser = argparse.ArgumentParser()
    parser.add_argument("mode", choices=("prompt", "stop"))
    args = parser.parse_args(argv)
    try:
        enqueue_from_hook(_load_stdin(), args.mode)
    except Exception as exc:
        _log_hook_error(exc)
    return 0


if __name__ == "__main__":
    raise SystemExit(main())
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