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/coldstart/structured.py

View on GitHub
#!/usr/bin/env python3
"""Structured proposal/review parsing for RecallLoom cold start flows."""

from __future__ import annotations

import re

MARKDOWN_HEADING_RE = re.compile(r"^\s{0,3}#{1,6}\s+(?P<title>.*?)\s*$")
HEADING_NUMBER_PREFIX_RE = re.compile(r"^\s*[0-9]+(?:\.[0-9]+)*[.)、::-]?\s*")

PROPOSAL_SECTION_ALIASES = {
    "source_summary": ("来源摘要", "source summary"),
    "source_type_confidence": ("来源类型与可信级别", "source type and confidence"),
    "candidate_current_state": ("候选当前状态事实", "candidate current-state facts"),
    "candidate_milestones": ("候选里程碑事件", "candidate milestone events"),
    "candidate_reversals": ("候选判断反转", "candidate judgment reversals"),
    "candidate_next_step": ("候选下一步变化", "candidate next-step changes"),
    "conflicts_with_sidecar": ("与当前 sidecar 的冲突", "conflicts with current sidecar"),
    "suggested_promotion_actions": ("建议提升动作", "suggested promotion actions"),
    "review_conclusion": ("审阅结论", "review conclusion"),
}

REVIEW_SECTION_ALIASES = {
    "proposal_reference": ("proposal reference", "提案引用"),
    "review_outcome": ("review outcome", "审阅结论"),
    "approved_items": ("approved items", "通过项"),
    "rejected_items": ("rejected items", "拒绝项"),
    "promotion_status": ("promotion status", "提升状态"),
    "next_action": ("next action", "下一步"),
}

PROMOTION_TARGET_MARKERS = (
    "rolling_summary.md",
    "context_brief.md",
    "daily_logs/",
    "daily_logs\\",
    "daily log",
)

NEGATED_APPROVAL_MARKERS = (
    "not approve",
    "not approved",
    "not yet approved",
    "do not approve",
    "do not accept",
    "not accepted",
    "未批准",
    "尚未批准",
    "不批准",
    "未通过",
    "尚未通过",
    "不通过",
)
HINT_ONLY_MARKERS = ("hint-only", "hint only", "保留为 hint", "仅提示", "only hint")
NEGATED_HINT_ONLY_MARKERS = (
    "no items remain hint-only",
    "no item remains hint-only",
    "no hint-only items remain",
    "not hint-only",
    "无 hint",
)


def _normalize_heading_title(raw: str) -> str:
    title = HEADING_NUMBER_PREFIX_RE.sub("", raw.strip())
    title = title.strip().strip("::-").strip()
    return title.casefold()


def extract_heading_sections(text: str) -> dict[str, str]:
    sections: dict[str, list[str]] = {}
    current_key: str | None = None
    for line in text.splitlines():
        match = MARKDOWN_HEADING_RE.match(line)
        if match:
            current_key = _normalize_heading_title(match.group("title"))
            sections.setdefault(current_key, [])
            continue
        if current_key is not None:
            sections[current_key].append(line)
    return {
        key: "\n".join(lines).strip()
        for key, lines in sections.items()
    }


def extract_structured_sections(text: str, aliases: dict[str, tuple[str, ...]]) -> dict[str, str]:
    sections = extract_heading_sections(text)
    structured: dict[str, str] = {}
    for canonical_key, alias_group in aliases.items():
        for alias in alias_group:
            normalized_alias = _normalize_heading_title(alias)
            if normalized_alias in sections:
                structured[canonical_key] = sections[normalized_alias]
                break
    return structured


def detect_source_tiers(text: str) -> list[str]:
    found: list[str] = []
    seen: set[str] = set()
    for match in re.finditer(r"\btier\s*([A-F])\b", text, flags=re.I):
        tier = match.group(1).upper()
        if tier not in seen:
            seen.add(tier)
            found.append(tier)
    return found


def detect_promotion_targets(text: str) -> list[str]:
    found: list[str] = []
    lowered = text.casefold()
    for marker in PROMOTION_TARGET_MARKERS:
        if marker.casefold() in lowered:
            found.append(marker)
    return found


def has_non_negated_hint_only_signal(text: str) -> bool:
    for line in text.splitlines():
        lowered = line.casefold()
        if not any(keyword in lowered for keyword in HINT_ONLY_MARKERS):
            continue
        if any(keyword in lowered for keyword in NEGATED_HINT_ONLY_MARKERS):
            continue
        return True
    return False


def classify_review_action(review_sections: dict[str, str]) -> str:
    review_outcome = review_sections.get("review_outcome", "")
    promotion_status = review_sections.get("promotion_status", "")
    lowered = " ".join([review_outcome, promotion_status]).casefold()

    if any(keyword in lowered for keyword in ("reject", "rejected", "拒绝")):
        return "reject"
    if any(keyword in lowered for keyword in NEGATED_APPROVAL_MARKERS):
        return "unspecified"
    if has_non_negated_hint_only_signal("\n".join([review_outcome, promotion_status])):
        if any(keyword in lowered for keyword in ("approve", "approved", "accept", "通过", "批准", "selective")):
            return "accept_after_edit"
        return "hint_only"
    if any(keyword in lowered for keyword in ("modify", "modified", "edit", "edited", "修改", "selective")):
        if any(keyword in lowered for keyword in ("approve", "approved", "accept", "通过", "批准")):
            return "accept_after_edit"
    if any(keyword in lowered for keyword in ("approve", "approved", "accept", "accepted", "通过", "批准")):
        return "accept"
    return "unspecified"


def promotion_ready_for_action(review_action: str) -> bool:
    return review_action in {"accept", "accept_after_edit"}
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