Skip to content

Frappucc1no/recall-loom / skills/recallloom

recallloom

Flagged

Use when a task involves continuing a project, restoring project context, maintaining file-based project memory, updating current-state summaries, or recording meaningful progress across sessions. Works best for long-horizon, file-based projects and supports research writing, product document collaboration, software project coordination, and broader cross-functional project continuity.

FileKindSize
LICENSEother10.0 KB
NOTICEother190 B
SKILL.mdskill md24.5 KB
managed-assets.jsonconfig1.1 KB
native_commands/README.mdmarkdown1.2 KB
native_commands/claude-code/rl-init.md.tmplother323 B
native_commands/claude-code/rl-resume.md.tmplother290 B
native_commands/claude-code/rl-status.md.tmplother299 B
native_commands/claude-code/rl-validate.md.tmplother277 B
native_commands/gemini-cli/rl-init.toml.tmplother295 B
native_commands/gemini-cli/rl-resume.toml.tmplother262 B
native_commands/gemini-cli/rl-status.toml.tmplother271 B
native_commands/gemini-cli/rl-validate.toml.tmplother249 B
native_commands/opencode/rl-init.md.tmplother286 B
native_commands/opencode/rl-resume.md.tmplother253 B
native_commands/opencode/rl-status.md.tmplother262 B
native_commands/opencode/rl-validate.md.tmplother240 B
package-metadata.jsonconfig1.0 KB
profiles/general-project-continuity.mdmarkdown2.4 KB
profiles/product-doc-collaboration.mdmarkdown2.2 KB
profiles/research-writing.mdmarkdown2.1 KB
profiles/software-project-coordination.mdmarkdown2.8 KB
references/anti-patterns.mdmarkdown2.5 KB
references/contract-registry.jsonconfig7.7 KB
references/contract-schema.jsonconfig7.7 KB
references/file-contracts.mdmarkdown23.4 KB
references/operation-playbooks.mdmarkdown26.5 KB
references/package-support-policy.mdmarkdown9.4 KB
references/profiles.mdmarkdown2.0 KB
references/protocol.mdmarkdown20.5 KB
references/recording-workflow.mdmarkdown9.9 KB
scripts/_common.pyscript87.8 KB
scripts/append_daily_log_entry.pyscript40.4 KB
scripts/archive_logs.pyscript17.6 KB
scripts/commit_context_file.pyscript31.6 KB
scripts/core/__init__.pyscript39 B
scripts/core/bridge/__init__.pyscript30 B
scripts/core/bridge/blocks.pyscript6.9 KB
scripts/core/coldstart/__init__.pyscript26 B
scripts/core/coldstart/sources.pyscript22.4 KB
scripts/core/coldstart/structured.pyscript5.4 KB
scripts/core/continuity/__init__.pyscript34 B
scripts/core/continuity/daily_log.pyscript16.1 KB
scripts/core/continuity/freshness.pyscript15.3 KB
scripts/core/continuity/preflight.pyscript41.0 KB
scripts/core/continuity/quick_summary.pyscript10.9 KB
scripts/core/continuity/workday.pyscript12.3 KB
scripts/core/errors.pyscript838 B
scripts/core/failure/__init__.pyscript47 B
scripts/core/failure/context.pyscript5.6 KB
scripts/core/failure/contracts.pyscript108.6 KB
scripts/core/output/__init__.pyscript35 B
scripts/core/output/confirmation_material.pyscript15.0 KB
scripts/core/output/privacy.pyscript10.5 KB
scripts/core/output/user_status.pyscript5.8 KB
scripts/core/protocol/__init__.pyscript60 B
scripts/core/protocol/contracts.pyscript8.3 KB
scripts/core/protocol/markers.pyscript4.9 KB
scripts/core/protocol/sections.pyscript3.4 KB
scripts/core/protocol/templates.pyscript6.5 KB
scripts/core/provenance/__init__.pyscript67 B
scripts/core/provenance/bindings.pyscript13.2 KB
scripts/core/provenance/evidence.pyscript58.2 KB
scripts/core/provenance/inconsistent_review.pyscript85.6 KB
scripts/core/provenance/receipts.pyscript20.2 KB
scripts/core/provenance/state.pyscript38.0 KB
scripts/core/provenance/store.pyscript43.8 KB
scripts/core/recording/__init__.pyscript1.6 KB
scripts/core/recording/contracts.pyscript31.7 KB
scripts/core/recording/daily_log_append.pyscript30.2 KB
scripts/core/recording/managed_write.pyscript52.8 KB
scripts/core/recording/planner.pyscript20.6 KB
scripts/core/recording/privacy.pyscript1.7 KB
scripts/core/recording/suggestions.pyscript8.6 KB
scripts/core/recording/transaction.pyscript93.3 KB
scripts/core/registry/__init__.pyscript58 B
scripts/core/registry/loader.pyscript18.8 KB
scripts/core/safety/__init__.pyscript30 B
scripts/core/safety/attached_text.pyscript6.9 KB
scripts/core/safety/input_transport.pyscript61.0 KB
scripts/core/safety/prepared_input.pyscript24.4 KB
scripts/core/safety/scratch_residue.pyscript18.8 KB
scripts/core/support/__init__.pyscript53 B
scripts/core/support/cache.pyscript19.4 KB
scripts/core/support/policy.pyscript8.8 KB
scripts/core/trust/__init__.pyscript42 B
scripts/core/trust/state.pyscript4.1 KB
scripts/core/workspace/__init__.pyscript33 B
scripts/core/workspace/atomic_io.pyscript12.2 KB
scripts/core/workspace/runtime.pyscript54.7 KB
scripts/detect_project_root.pyscript3.4 KB
scripts/generate_coldstart_proposal.pyscript7.5 KB
scripts/init_context.pyscript37.8 KB
scripts/install_native_commands.pyscript31.5 KB
scripts/manage_entry_bridge.pyscript20.8 KB
scripts/preflight_context_check.pyscript10.1 KB
scripts/prepare_recovery_promotion.pyscript22.1 KB
scripts/query_continuity.pyscript84.1 KB
scripts/recallloom.pyscript233.7 KB
scripts/recommend_workday.pyscript17.6 KB
scripts/record_recovery_review.pyscript50.9 KB
scripts/remove_context.pyscript13.9 KB
scripts/repair_daily_log_cursor.pyscript33.7 KB
scripts/stage_recovery_proposal.pyscript17.5 KB
scripts/summarize_continuity_status.pyscript43.7 KB
scripts/sync_contract_docs.pyscript11.3 KB
scripts/unlock_write_lock.pyscript8.1 KB
scripts/validate_context.pyscript54.9 KB

scripts/core/output/privacy.py

View on GitHub
"""Helpers for public-vs-diagnostic JSON path handling."""

from __future__ import annotations

import os
from pathlib import Path
import re


PRIVATE_JSON_PATHS_ENV = "RECALLLOOM_DEBUG_JSON_PATHS"
_FALSEY_ENV_VALUES = {"", "0", "false", "no", "off"}
_NON_PUBLICIZED_PATH_FIELDS = {"latest_file"}
_PATH_VALUE_FIELDS = {
    "cache_path",
    "config_path",
    "destination_dir",
    "entry_path",
    "file",
    "latest_active_daily_log",
    "latest_active_daily_log_seen",
    "latest_workspace_artifact",
    "latest_workspace_artifact_seen",
    "lock_path",
    "package_path",
    "path",
    "proposal_file",
    "proposal_path",
    "project_root",
    "review_file",
    "review_path",
    "source_file",
    "source_path",
    "start_path",
    "storage_root",
    "target",
    "target_path",
    "tombstone_path",
    "update_protocol",
}
_PATH_LIST_FIELDS = {
    "archived_targets",
    "bridge_targets",
    "changed_files",
    "checked_files",
    "created",
    "existing_targets",
    "invalid_paths",
    "malformed_bridge_targets",
    "missing_paths",
    "skipped",
    "unknown_assets",
}
_SENSITIVE_FIELD_NAMES = {
    "absolute_path",
    "artifact_path",
    "command",
    "command_line",
    "environment",
    "env",
    "full_payload",
    "host_memory_payload",
    "raw_payload",
    "remote_response",
    "remote_service_response",
    "secret",
    "shell_transcript",
    "sidecar_body",
    "source_path",
    "target_path",
    "token",
}
_TRAILING_PATH_PUNCTUATION = ".,:;!?)]}"
_REDACTED_PATH_LABEL = "redacted-path"
_QUOTED_PATH_PATTERN = re.compile(
    r"(?P<quote>[\"'])(?P<path>(?<![A-Za-z0-9._-])(?:~[\\/]|/|[A-Za-z]:[\\\\/]|\\\\(?=[^\\/\s\"']+\\[^\\/\s\"']+))[^\"']+)(?P=quote)"
)
_UNQUOTED_PATH_PATTERN = re.compile(
    r"(?P<path>(?<![A-Za-z0-9._-])(?:~[\\/]|/|[A-Za-z]:[\\\\/]|\\\\(?=[^\\/\s\"']+\\[^\\/\s\"']+))\S+)"
)
_LOCAL_ABSOLUTE_PATH_PATTERN = re.compile(
    r"(?<![A-Za-z0-9._:/\\-])(?:"
    r"~[\\/][^\s\"'<>]+"
    r"|/[A-Za-z0-9._~+-][^\s\"'<>]*"
    r"|[A-Za-z]:[\\/][^\s\"'<>]+"
    r"|\\\\[^\\/\s\"'<>]+[\\/][^\s\"'<>]+"
    r"|//[^\\/\s\"'<>]+[\\/][^\s\"'<>]+"
    r")"
)
_WINDOWS_DRIVE_PREFIX_PATTERN = re.compile(r"^[A-Za-z]:[\\/]")
_EMAIL_PATTERN = re.compile(r"\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}\b")
_SECRET_ASSIGNMENT_PATTERN = re.compile(
    r"(?i)\b(api[_-]?key|token|secret|password|credential)\s*[:=]\s*['\"]?[^\s,'\"]+"
)
_COMMON_TOKEN_PATTERN = re.compile(
    r"\b(ghp_[A-Za-z0-9_]{6,}|github_pat_[A-Za-z0-9_]{6,}|xox[baprs]-[A-Za-z0-9-]{6,}|AKIA[0-9A-Z]{12,})\b"
)
_OPENAI_TOKEN_PATTERN = re.compile(r"\bsk-[A-Za-z0-9_-]{6,}\b")
_BEARER_TOKEN_PATTERN = re.compile(r"(?i)\bbearer\s+[A-Za-z0-9._-]+")
_URL_PATTERN = re.compile(r"(?i)\b(?:https?|file)://\S+")


def private_json_paths_enabled(env: dict[str, str] | None = None) -> bool:
    return False


def _resolve_path(path: Path) -> Path:
    try:
        return path.resolve()
    except OSError:
        return path.absolute()


def public_project_root_label(project_root: str | Path) -> str:
    resolved = _resolve_path(Path(project_root).expanduser())
    label = resolved.name or resolved.as_posix()
    return label or "."


def public_project_path(
    path: str | Path | None,
    *,
    project_root: str | Path,
) -> str | None:
    if path is None:
        return None
    try:
        root = _resolve_path(Path(project_root).expanduser())
        candidate = Path(path).expanduser()
        if not candidate.is_absolute():
            candidate = root / candidate
        resolved = _resolve_path(candidate)
        if resolved == root:
            return public_project_root_label(root)
        try:
            return resolved.relative_to(root).as_posix()
        except ValueError:
            return resolved.name or candidate.name or resolved.as_posix()
    except (TypeError, ValueError, RuntimeError, OSError):
        return _REDACTED_PATH_LABEL


def display_project_root_label(
    project_root: str | Path,
    *,
    private: bool | None = None,
) -> str:
    private = private_json_paths_enabled() if private is None else private
    if private:
        return str(project_root)
    return public_project_root_label(project_root)


def display_project_path(
    path: str | Path | None,
    *,
    project_root: str | Path,
    private: bool | None = None,
) -> str | None:
    private = private_json_paths_enabled() if private is None else private
    if path is None:
        return None
    if private:
        return str(path)
    return public_project_path(path, project_root=project_root)


def contains_local_absolute_path(text: str | None) -> bool:
    """Return whether text contains a POSIX, Windows-drive, or UNC absolute path."""

    return isinstance(text, str) and bool(_LOCAL_ABSOLUTE_PATH_PATTERN.search(text))


def _portable_foreign_path_label(raw_path: str) -> str | None:
    if not (
        _WINDOWS_DRIVE_PREFIX_PATTERN.match(raw_path)
        or raw_path.startswith("\\\\")
        or raw_path.startswith("//")
    ):
        return None
    parts = [part for part in raw_path.replace("\\", "/").split("/") if part]
    return parts[-1] if parts else _REDACTED_PATH_LABEL


def _publicize_path_fragment(
    raw_path: str,
    *,
    project_root: str | Path | None,
    private: bool,
) -> str:
    candidate = raw_path
    suffix = ""
    while candidate and candidate[-1] in _TRAILING_PATH_PUNCTUATION:
        suffix = candidate[-1] + suffix
        candidate = candidate[:-1]
    if not candidate:
        return raw_path
    publicized = _portable_foreign_path_label(candidate)
    if publicized is None:
        publicized = display_project_path(
            candidate,
            project_root=project_root or candidate,
            private=private,
        )
    if publicized is None:
        return raw_path
    return f"{publicized}{suffix}"


def publicize_text_paths(
    text: str | None,
    *,
    project_root: str | Path | None,
    private: bool | None = None,
) -> str | None:
    private = private_json_paths_enabled() if private is None else private
    if private or not isinstance(text, str) or not text:
        return text

    def replace_quoted(match: re.Match[str]) -> str:
        quote = match.group("quote")
        path = match.group("path")
        return (
            f"{quote}"
            f"{_publicize_path_fragment(path, project_root=project_root, private=private)}"
            f"{quote}"
        )

    def replace_unquoted(match: re.Match[str]) -> str:
        return _publicize_path_fragment(
            match.group("path"),
            project_root=project_root,
            private=private,
        )

    publicized = _QUOTED_PATH_PATTERN.sub(replace_quoted, text)
    return _UNQUOTED_PATH_PATTERN.sub(replace_unquoted, publicized)


def redact_public_text(
    text: str | None,
    *,
    project_root: str | Path | None = None,
    private: bool | None = None,
) -> str | None:
    if not isinstance(text, str) or not text:
        return text
    url_redacted = _URL_PATTERN.sub("redacted-url", text)
    publicized = publicize_text_paths(url_redacted, project_root=project_root, private=private)
    if publicized is None:
        return publicized
    redacted = _SECRET_ASSIGNMENT_PATTERN.sub("credential=redacted", publicized)
    redacted = _BEARER_TOKEN_PATTERN.sub("bearer redacted", redacted)
    redacted = _COMMON_TOKEN_PATTERN.sub("redacted-token", redacted)
    redacted = _OPENAI_TOKEN_PATTERN.sub("redacted-token", redacted)
    redacted = _EMAIL_PATTERN.sub("redacted-email", redacted)
    redacted = _URL_PATTERN.sub("redacted-url", redacted)
    return redacted


def _field_looks_pathlike(field_name: str | None) -> bool:
    if not field_name:
        return False
    if field_name in _NON_PUBLICIZED_PATH_FIELDS:
        return False
    return (
        field_name in _PATH_VALUE_FIELDS
        or field_name.endswith("_file")
        or field_name.endswith("_dir")
        or field_name.endswith("_path")
        or field_name.endswith("_root")
    )


def _field_looks_sensitive(field_name: str | None) -> bool:
    if not field_name:
        return False
    normalized = field_name.strip().casefold().replace("-", "_")
    suffix_sensitive = _SENSITIVE_FIELD_NAMES.difference({"command", "env"})
    return normalized in _SENSITIVE_FIELD_NAMES or any(
        normalized.endswith(f"_{name}") for name in suffix_sensitive
    )


def publicize_json_value(
    value,
    *,
    project_root: str | Path | None,
    field_name: str | None = None,
    private: bool | None = None,
):
    private = private_json_paths_enabled() if private is None else private
    if _field_looks_sensitive(field_name):
        return "redacted"
    if isinstance(value, dict):
        return {
            key: publicize_json_value(
                item,
                project_root=project_root,
                field_name=key,
                private=private,
            )
            for key, item in value.items()
        }
    if isinstance(value, list):
        if field_name in _PATH_LIST_FIELDS:
            public_items = []
            for item in value:
                if isinstance(item, (str, Path)):
                    public_path = display_project_path(
                        item,
                        project_root=project_root or ".",
                        private=private,
                    )
                    public_items.append(
                        redact_public_text(public_path, project_root=project_root, private=False)
                    )
                else:
                    public_items.append(
                        publicize_json_value(
                            item,
                            project_root=project_root,
                            private=private,
                        )
                    )
            return public_items
        return [
            publicize_json_value(
                item,
                project_root=project_root,
                private=private,
            )
            for item in value
        ]
    if isinstance(value, (str, Path)) and _field_looks_pathlike(field_name):
        raw_value = str(value)
        if field_name == "project_root":
            public_value = display_project_root_label(raw_value, private=private)
        else:
            public_value = display_project_path(
                raw_value,
                project_root=project_root or raw_value,
                private=private,
            )
        return redact_public_text(public_value, project_root=project_root, private=False)
    if isinstance(value, (str, Path)):
        return redact_public_text(
            str(value),
            project_root=project_root,
            private=False,
        )
    return value
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall