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/recording/suggestions.py

View on GitHub
"""Side-effect-free proactive recording suggestions."""

from __future__ import annotations

from collections.abc import Mapping

from core.output.privacy import redact_public_text

from .contracts import digest_payload, normalize_record_plan_input
from .privacy import contains_unsafe_record_text, record_input_text


MILESTONE_TOKENS = (
    "approved",
    "authorized",
    "completed",
    "decided",
    "fixed",
    "implemented",
    "released",
    "resolved",
    "reviewed",
    "shipped",
    "validated",
    "验证通过",
    "修复",
    "决定",
    "完成",
    "实现",
    "已授权",
    "已发布",
    "已验证",
    "已评审",
)

STABLE_RULE_TOKENS = (
    "always",
    "must",
    "policy",
    "rule",
    "source of truth",
    "以后",
    "必须",
    "规则",
    "规范",
    "长期",
)

NO_PROMPT_TOKENS = (
    "do not record",
    "do not log",
    "do not save",
    "don't record",
    "don't log",
    "don't save",
    "no need to record",
    "no record needed",
    "不要记录",
    "不用记录",
    "无需记录",
    "不需要记录",
)

UNSTABLE_TOKENS = (
    "brainstorm",
    "draft",
    "maybe",
    "not sure",
    "rough idea",
    "thinking aloud",
    "探索",
    "草稿",
    "还没定",
    "不确定",
)

UNSAFE_PRIVACY_CLASSES = {
    "blocked",
    "contains_sensitive",
    "private",
    "sensitive",
    "unsafe",
}


def _contains_any(text: str, tokens: tuple[str, ...]) -> bool:
    return any(token in text for token in tokens)


def _privacy_classification(input_contract: Mapping[str, object]) -> str:
    privacy = input_contract.get("privacy_safety_result")
    if not isinstance(privacy, Mapping):
        return "unknown"
    value = privacy.get("classification") or privacy.get("status") or privacy.get("safety_status")
    return value.strip().casefold().replace("-", "_") if isinstance(value, str) else "unknown"


def _summary_from_text(
    text: str,
    *,
    unsafe: bool,
    max_chars: int = 220,
) -> tuple[str | None, bool]:
    if not text.strip():
        return None, False
    if unsafe:
        return f"redacted-candidate:{digest_payload({'candidate_text': text})}", True
    public_text = redact_public_text(text, project_root=None) or ""
    redacted = public_text != text
    compacted = " ".join(public_text.split())
    if not compacted:
        return None, redacted
    if len(compacted) <= max_chars:
        return compacted, redacted
    return compacted[: max_chars - 3].rstrip(" ,;:|/-") + "...", redacted


def _user_summary(
    *,
    category: str,
    conclusion: str,
    reason: str,
    next_step: str,
) -> dict[str, str]:
    return {
        "category": category,
        "conclusion": conclusion,
        "reason": reason,
        "next_step": next_step,
    }


def _suggested_record_class(text: str) -> tuple[str, str]:
    if _contains_any(text, STABLE_RULE_TOKENS):
        return "stable_context_update", "stable_context"
    return "append_only", "daily_log"


def build_recording_suggestion(input_contract: Mapping[str, object]) -> dict[str, object]:
    """Build a no-write recording suggestion from public-safe candidate material."""

    normalized = normalize_record_plan_input(input_contract)
    intent_text = normalized.get("intent_text") or ""
    if not isinstance(intent_text, str):
        intent_text = str(intent_text)
    lowered = intent_text.casefold()
    combined_text, _payload_present = record_input_text(input_contract)
    privacy_classification = _privacy_classification(normalized)
    unsafe = (
        privacy_classification in UNSAFE_PRIVACY_CLASSES
        or contains_unsafe_record_text(combined_text)
    )
    if unsafe:
        candidate_summary, candidate_summary_redacted = _summary_from_text(
            combined_text,
            unsafe=True,
        )
        user_summary = _user_summary(
            category="blocked",
            conclusion="No recording suggestion.",
            reason="The candidate text looks sensitive or private and cannot be suggested as-is.",
            next_step="Remove or redact the sensitive material before asking for a recording suggestion.",
        )
        return {
            "ok": False,
            "schema_version": "1.1",
            "command": "record",
            "mode": "suggest",
            "side_effect": "none",
            "user_visible_category": user_summary["category"],
            "user_summary": user_summary,
            "suggestion_status": "blocked",
            "should_prompt": False,
            "candidate_summary": candidate_summary,
            "candidate_summary_redacted": candidate_summary_redacted,
            "suggested_record_class": None,
            "suggested_layer": None,
            "suggested_path": None,
            "privacy_safety_classification": privacy_classification,
            "safety_notes": [
                "record --suggest is side-effect-free",
                "sensitive candidate material is never converted into a write path",
            ],
        }
    if _contains_any(lowered, NO_PROMPT_TOKENS):
        user_summary = _user_summary(
            category="no_write_needed",
            conclusion="No recording prompt needed.",
            reason="The candidate explicitly says not to record or save this.",
            next_step="Stop; do not suggest or prepare a RecallLoom write.",
        )
        return {
            "ok": True,
            "schema_version": "1.1",
            "command": "record",
            "mode": "suggest",
            "side_effect": "none",
            "user_visible_category": user_summary["category"],
            "user_summary": user_summary,
            "suggestion_status": "silent",
            "should_prompt": False,
            "candidate_summary": None,
            "candidate_summary_redacted": False,
            "suggested_record_class": None,
            "suggested_layer": None,
            "suggested_path": None,
            "privacy_safety_classification": privacy_classification,
            "safety_notes": ["record --suggest is side-effect-free"],
        }
    if _contains_any(lowered, UNSTABLE_TOKENS) or not _contains_any(lowered, MILESTONE_TOKENS):
        user_summary = _user_summary(
            category="diagnostic_only",
            conclusion="No proactive prompt.",
            reason="The candidate does not look like a durable milestone, decision, validation, or release fact yet.",
            next_step="Continue working; ask for record --plan only after a durable fact exists.",
        )
        return {
            "ok": True,
            "schema_version": "1.1",
            "command": "record",
            "mode": "suggest",
            "side_effect": "none",
            "user_visible_category": user_summary["category"],
            "user_summary": user_summary,
            "suggestion_status": "silent",
            "should_prompt": False,
            "candidate_summary": None,
            "candidate_summary_redacted": False,
            "suggested_record_class": None,
            "suggested_layer": None,
            "suggested_path": None,
            "privacy_safety_classification": privacy_classification,
            "safety_notes": ["record --suggest is side-effect-free"],
        }

    record_class, layer = _suggested_record_class(lowered)
    candidate_summary, candidate_summary_redacted = _summary_from_text(
        intent_text,
        unsafe=False,
    )
    user_summary = _user_summary(
        category="diagnostic_only",
        conclusion="Recording candidate found.",
        reason="The candidate looks like a durable milestone, decision, validation, or release fact.",
        next_step="Offer the sanitized candidate summary and run record --plan only if the user wants to record it.",
    )
    return {
        "ok": True,
        "schema_version": "1.1",
        "command": "record",
        "mode": "suggest",
        "side_effect": "none",
        "user_visible_category": user_summary["category"],
        "user_summary": user_summary,
        "suggestion_status": "candidate",
        "should_prompt": True,
        "candidate_summary": candidate_summary,
        "candidate_summary_redacted": candidate_summary_redacted,
        "suggested_record_class": record_class,
        "suggested_layer": layer,
        "suggested_path": (
            f"record --plan with record_class={record_class}, layer_hint={layer}, "
            "and the sanitized candidate summary"
        ),
        "privacy_safety_classification": privacy_classification,
        "safety_notes": [
            "record --suggest is side-effect-free",
            "a suggestion is not a write authorization",
            "record --plan must still run privacy, preflight, revision and receipt gates",
        ],
    }
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