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/continuity/quick_summary.py

View on GitHub
#!/usr/bin/env python3
"""Bounded quick-summary helpers for RecallLoom continuity snapshots."""

from __future__ import annotations

import re
from pathlib import Path

from core.continuity.freshness import (
    continuity_state_for_workspace,
    evaluate_continuity_freshness,
    freshness_risk_summary,
    is_effectively_empty_summary_next_step,
    summary_matches_empty_shell_template,
)
from core.output.privacy import public_project_root_label, redact_public_text
from core.protocol.sections import extract_section_text

from core.continuity.daily_log import validate_state_entry_bearing_latest_daily_log


PROJECT_VERSION_RE = re.compile(r"\b([A-Za-z][A-Za-z0-9_-]*)\s+v?\d+\.\d+(?:\.\d+)?\b")
BACKTICK_PATH_RE = re.compile(r"`([^`]+)`")
EXPLICIT_PROJECT_LABEL_RE = re.compile(
    r"(?i)(?:^|\b)(?:project|product|workspace|repo|项目|产品|工作区|仓库)\s*[::-]\s*(?P<value>.+)$"
)
PHASE_LABEL_RE = re.compile(
    r"(?i)(?:^|\b)(?:current phase|phase|当前阶段|阶段)\s*[::-]\s*(?P<value>.+)$"
)
WHITESPACE_RE = re.compile(r"\s+")
PROJECT_PATH_CUE_RE = re.compile(
    r"(?i)(project root|workspace|repo|repository|项目根目录|工作区|仓库)"
)
VERSION_TOKEN_RE = re.compile(r"^v?\d+(?:\.\d+){1,3}$", re.I)

PLACEHOLDER_NEXT_STEP_LINES = {
    "describe the handoff-first next move:",
    "active task",
    "owner or role when known",
    "immediate next action",
    "这里写 handoff-first 的下一步:",
    "current task",
    "known owner or role",
    "current owner or role",
    "当前任务",
    "已知负责人或角色",
    "立刻要做的动作",
}

PHASE_KEYWORDS: tuple[tuple[str, tuple[str, ...]], ...] = (
    ("planning", ("planning", "plan", "design", "proposal", "spec", "规划", "设计", "方案")),
    ("development", ("development", "implementation", "implement", "build", "开发", "实现", "编码")),
    ("testing", ("testing", "validation", "verify", "qa", "测试", "验证", "复核")),
    ("release", ("release", "deploy", "ship", "发布", "上线", "交付")),
    ("maintenance", ("maintenance", "fix", "optimiz", "stabil", "维护", "修复", "优化", "稳定")),
)


def _meaningful_lines(text: str) -> list[str]:
    lines: list[str] = []
    for raw in text.splitlines():
        stripped = raw.strip()
        if not stripped or stripped == "-":
            continue
        if stripped.startswith("<!--") or stripped.startswith("#"):
            continue
        stripped = stripped.lstrip("-* ").strip()
        if not stripped or stripped == "-":
            continue
        lines.append(stripped)
    return lines


def _compact(
    text: str | None,
    *,
    max_chars: int,
    project_root: Path | None = None,
) -> str | None:
    if text is None:
        return None
    compacted = WHITESPACE_RE.sub(" ", text).strip()
    if not compacted:
        return None
    compacted = redact_public_text(compacted, project_root=project_root) or "redacted"
    if len(compacted) <= max_chars:
        return compacted
    shortened = compacted[: max_chars - 3].rstrip(" ,;:|/-")
    return shortened + "..."


def _safe_project_label_candidate(value: str) -> str | None:
    candidate = value.strip().strip("`'\" ")
    if not candidate:
        return None
    candidate = candidate.split("|", 1)[0].split(" / ", 1)[0].strip()
    if not candidate or VERSION_TOKEN_RE.match(candidate):
        return None
    if "/" in candidate or "\\" in candidate:
        name = Path(candidate).name
        candidate = name if name and not VERSION_TOKEN_RE.match(name) else ""
    return candidate or None


def _extract_project_label(current_state_text: str, project_root: Path) -> str:
    root_label = redact_public_text(public_project_root_label(project_root), project_root=project_root) or "project"
    for line in _meaningful_lines(current_state_text)[:8]:
        explicit_match = EXPLICIT_PROJECT_LABEL_RE.search(line)
        if explicit_match:
            candidate = _safe_project_label_candidate(explicit_match.group("value"))
            if candidate:
                return _compact(candidate, max_chars=48, project_root=project_root) or root_label

    for line in _meaningful_lines(current_state_text)[:8]:
        if not EXPLICIT_PROJECT_LABEL_RE.search(line) and not PROJECT_PATH_CUE_RE.search(line):
            continue
        version_match = PROJECT_VERSION_RE.search(line)
        if version_match:
            candidate = _safe_project_label_candidate(version_match.group(1))
            if candidate:
                return _compact(candidate, max_chars=48, project_root=project_root) or root_label
        path_match = BACKTICK_PATH_RE.search(line)
        if path_match:
            candidate = _safe_project_label_candidate(Path(path_match.group(1)).name)
            if candidate:
                return _compact(candidate, max_chars=48, project_root=project_root) or root_label
    return root_label


def _extract_phase(current_state_text: str, active_judgments_text: str, *, project_root: Path) -> str:
    lines = _meaningful_lines(current_state_text)[:6] + _meaningful_lines(active_judgments_text)[:4]

    for line in lines:
        explicit = PHASE_LABEL_RE.search(line)
        if explicit:
            return _compact(explicit.group("value"), max_chars=72, project_root=project_root) or "active"

    for line in lines:
        lowered = line.casefold()
        if PROJECT_VERSION_RE.search(line):
            for _, keywords in PHASE_KEYWORDS:
                if any(keyword in lowered for keyword in keywords):
                    return _compact(line, max_chars=72, project_root=project_root) or "active"

    for phase_label, keywords in PHASE_KEYWORDS:
        for line in lines:
            lowered = line.casefold()
            if any(keyword in lowered for keyword in keywords):
                return phase_label

    return "active"


def _extract_next_step(next_step_text: str, *, project_root: Path) -> str | None:
    if is_effectively_empty_summary_next_step(next_step_text):
        return None
    lines = [
        line
        for line in _meaningful_lines(next_step_text)
        if line.casefold() not in PLACEHOLDER_NEXT_STEP_LINES
    ]
    if not lines:
        return None
    return _compact(" | ".join(lines[:2]), max_chars=160, project_root=project_root)


def quick_summary_next_actions(
    *,
    no_project: bool = False,
    empty_shell: bool = False,
    summary_stale: bool = False,
) -> list[str]:
    if no_project:
        return ["rl-init", "choose_project_root"]
    actions = ["seed_initial_continuity"] if empty_shell else ["read_rolling_summary"]
    if summary_stale:
        actions.insert(1, "refresh_or_review_summary_before_write")
    actions.append("review_update_protocol_before_write")
    return actions


def build_quick_summary_payload(
    *,
    project_root: Path,
    storage_root: Path,
    summary_path: Path,
    summary_text: str,
    summary_revision: int,
    summary_base_workspace_revision: int,
    state: dict,
) -> dict:
    latest_daily_log_cursor = validate_state_entry_bearing_latest_daily_log(
        storage_root=storage_root,
        state=state,
    )
    latest_daily_log_exists = latest_daily_log_cursor is not None
    continuity_state, continuity_seeded = continuity_state_for_workspace(
        state=state,
        summary_text=summary_text,
        latest_daily_log_exists=latest_daily_log_exists,
    )
    freshness = evaluate_continuity_freshness(
        project_root=project_root,
        storage_root=storage_root,
        summary_path=summary_path,
        workspace_revision=state["workspace_revision"],
        summary_base_workspace_revision=summary_base_workspace_revision,
        latest_daily_log_exists=latest_daily_log_exists,
        scan_mode="quick",
        state=state,
    )
    freshness_risk = freshness_risk_summary(
        workspace_artifact_scan_mode=freshness["workspace_artifact_scan_mode"],
        workspace_artifact_scan_performed=freshness["workspace_artifact_scan_performed"],
        workspace_artifact_newer_than_summary=freshness["workspace_artifact_newer_than_summary"],
        summary_revision_stale=freshness["summary_revision_stale"],
        continuity_confidence=freshness["continuity_confidence"],
    )

    current_state_text = extract_section_text(summary_text, "current_state")
    active_judgments_text = extract_section_text(summary_text, "active_judgments")
    next_step_text = extract_section_text(summary_text, "next_step")
    empty_shell = continuity_state == "initialized_empty_shell"
    summary_looks_empty = summary_matches_empty_shell_template(summary_text)

    return {
        "schema_version": "1.1",
        "ok": True,
        "command": "quick-summary",
        "project_root": redact_public_text(
            public_project_root_label(project_root),
            project_root=project_root,
        )
        or "project",
        "storage_root": storage_root.relative_to(project_root).as_posix(),
        "summary": {
            "project": _extract_project_label(current_state_text, project_root),
            "phase": (
                "unseeded"
                if empty_shell
                else _extract_phase(current_state_text, active_judgments_text, project_root=project_root)
            ),
            "next_step": None if empty_shell else _extract_next_step(next_step_text, project_root=project_root),
            "confidence": freshness["continuity_confidence"],
        },
        "freshness": {
            "workspace_revision": state["workspace_revision"],
            "rolling_summary_revision": summary_revision,
            "summary_stale": freshness["summary_stale"],
            "workspace_newer_than_summary": freshness["workspace_newer_than_summary"],
            "workspace_artifact_newer_than_summary": freshness["workspace_artifact_newer_than_summary"],
            "freshness_risk_level": freshness_risk["level"],
        },
        "continuity_state": continuity_state,
        "continuity_seeded": continuity_seeded,
        "summary_template_detected": summary_looks_empty,
        "next_actions": quick_summary_next_actions(
            empty_shell=empty_shell,
            summary_stale=freshness["summary_stale"],
        ),
    }


def build_no_project_payload(start_path: Path) -> dict:
    return {
        "schema_version": "1.1",
        "ok": True,
        "command": "quick-summary",
        "project_root": redact_public_text(
            public_project_root_label(start_path),
            project_root=start_path,
        )
        or "project",
        "storage_root": None,
        "summary": {
            "project": None,
            "phase": "no_project",
            "next_step": None,
            "confidence": "none",
        },
        "freshness": {
            "workspace_revision": None,
            "rolling_summary_revision": None,
            "summary_stale": False,
            "freshness_risk_level": "not_applicable",
        },
        "continuity_state": "no_project",
        "continuity_seeded": False,
        "summary_template_detected": False,
        "next_actions": quick_summary_next_actions(no_project=True),
    }
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