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

View on GitHub
from __future__ import annotations

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

from .ledger import append_event, event_id
from .memory import canonical_key


_VALID_ATOMIC_ID = re.compile(r"^[A-Za-z0-9][A-Za-z0-9_\-]{0,127}$")


def _scalar(value) -> str:
    """Collapse a candidate field to a single frontmatter-safe line.

    Frontmatter scalars are single-line by contract, but LLM-generated
    candidate text routinely contains newlines. Unescaped, a newline lets a
    candidate smuggle extra frontmatter keys (forging `status:` /
    `applies_when:`) or a premature `---` fence that truncates the block —
    the written file then fails the index's validate/hash pass and is
    silently dropped from active_memories.json while the retrieve hook still
    injects the forged fields. Same treatment for list items (supersedes)."""
    return re.sub(r"[\r\n]+", " ", str(value if value is not None else "")).strip()


class InvalidAtomicIdError(ValueError):
    """Raised when a candidate's atomic_id contains characters that could
    enable path traversal or filename-shell-meta abuse. The id is used
    directly as a filename (`<atomic_id>.md`) so it must be tightly
    constrained.
    """


@dataclass(frozen=True)
class PromoteResult:
    created: bool
    path: Path | None = None
    reason: str = ""


def promote_candidate(
    state_root: Path,
    candidate: dict,
    dry_run: bool = False,
    *,
    source_text: str | None = None,
) -> PromoteResult:
    """Queue a candidate through the shared semantic upsert core.

    SQLite is the only truth store; this compatibility entry point returns
    immediately after writing the shared inbox request.
    """
    key = canonical_key(candidate)
    atomic_id = candidate["atomic_id"]

    # Reject path-traversal / filename-meta atomic_ids before they reach
    # the filesystem. atomic_id flows from LLM / user input and is used
    # directly as a filename, so any `..` / `/` / `\0` etc. would let an
    # attacker write outside `<state>/memories/active/`.
    if not isinstance(atomic_id, str) or not _VALID_ATOMIC_ID.match(atomic_id):
        raise InvalidAtomicIdError(
            f"atomic_id must match [A-Za-z0-9][A-Za-z0-9_-]{{0,127}}, got {atomic_id!r}"
        )

    if dry_run:
        return PromoteResult(created=False, reason=f"dry_run:{key}")
    if not isinstance(source_text, str) or not source_text.strip():
        return PromoteResult(created=False, reason="needs_original_user_turn")

    shared_lib = Path(__file__).resolve().parents[1] / "shared_lib"
    if str(shared_lib) not in sys.path:
        sys.path.insert(0, str(shared_lib))
    import memory_upsert

    registration_path = state_root / "registration.json"
    default_project_root = (
        state_root.parent.parent
        if state_root.name == "tellonce" and state_root.parent.name == ".codex"
        else state_root.parent
    )
    try:
        project_root = Path(
            json.loads(registration_path.read_text(encoding="utf-8")).get(
                "project_root", default_project_root
            )
        )
    except Exception:
        project_root = default_project_root
    os.environ["PT_PROJECT_ROOT"] = str(project_root)
    os.environ["B5_PROJECT_ROOT"] = str(project_root)
    memory_upsert.path_config.get_project_root.cache_clear()
    memory_upsert.path_config.get_memory_dir.cache_clear()
    context = "Legacy Codex candidate:\n" + json.dumps(candidate, ensure_ascii=False)
    result = memory_upsert.enqueue(
        source_text=source_text,
        turn_key=f"codex-promote-{event_id('upsert')}",
        context=context,
        memory_dir=memory_upsert.path_config.get_memory_dir(),
        spawn_worker=True,
        force=True,
    )
    if result.get("status") not in {"queued", "pending"}:
        return PromoteResult(
            created=False,
            reason=f"enqueue_failed:{result.get('status', 'unknown')}",
        )
    append_event(
        state_root,
        {
            "event_type": "promotion_queued_shared_upsert",
            "session_id": "codex-current",
            "payload": {
                "legacy_atomic_id": atomic_id,
                "canonical_key": key,
                "turn_key": result["turn_key"],
                "request_file": result["request_file"],
            },
        },
    )
    return PromoteResult(
        created=True,
        path=Path(result["request_file"]),
        reason=f"queued:{result['turn_key']}",
    )
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