Frappucc1no/recall-loom / skills/recallloom
recallloom
FlaggedUse 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.
scripts/detect_project_root.py
View on GitHub#!/usr/bin/env python3
"""Locate the nearest RecallLoom project root and storage layout."""
from __future__ import annotations
import argparse
import json
from _common import (
ConfigContractError,
EnvironmentContractError,
StorageResolutionError,
cli_failure_payload,
cli_failure_payload_for_exception,
enforce_package_support_gate,
ensure_supported_python_version,
exit_with_cli_error,
find_recallloom_root,
normalize_start_path,
public_json_payload,
)
def build_parser() -> argparse.ArgumentParser:
parser = argparse.ArgumentParser(
description="Locate the nearest RecallLoom project root by walking upward."
)
parser.add_argument(
"path",
nargs="?",
default=".",
help="Starting path. Defaults to the current working directory.",
)
parser.add_argument(
"--json",
action="store_true",
help="Print structured JSON output instead of just the resolved root.",
)
return parser
def main() -> None:
parser = build_parser()
args = parser.parse_args()
try:
ensure_supported_python_version()
except EnvironmentContractError as exc:
start = normalize_start_path(args.path)
exit_with_cli_error(
parser,
json_mode=args.json,
exit_code=2,
message=str(exc),
payload=cli_failure_payload(
"python_runtime_unavailable",
error=str(exc),
extra={"start_path": str(start), "found": False},
),
)
enforce_package_support_gate(parser, json_mode=args.json)
start = normalize_start_path(args.path)
try:
workspace = find_recallloom_root(start)
except (StorageResolutionError, ConfigContractError) as exc:
exit_with_cli_error(
parser,
json_mode=args.json,
exit_code=2,
message=str(exc),
payload=cli_failure_payload_for_exception(
exc,
default_reason="damaged_sidecar",
extra={"start_path": str(start), "found": False},
),
)
if workspace is None:
payload = {
"start_path": str(start),
"found": False,
"project_root": None,
"storage_root": None,
"storage_mode": None,
"workspace_language": None,
}
exit_with_cli_error(
parser,
json_mode=args.json,
exit_code=1,
message=f"No RecallLoom project root found from {start}.",
payload=cli_failure_payload(
"no_project_root",
error=f"No RecallLoom project root found from {start}.",
extra=payload,
),
)
payload = {
"start_path": str(start),
"found": True,
"project_root": str(workspace.project_root),
"storage_root": str(workspace.storage_root),
"storage_mode": workspace.storage_mode,
"workspace_language": workspace.workspace_language,
"config_path": str(workspace.config_path) if workspace.config_path else None,
}
if args.json:
print(
json.dumps(
public_json_payload(payload, project_root=workspace.project_root),
ensure_ascii=False,
indent=2,
)
)
else:
print(workspace.project_root)
if __name__ == "__main__":
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |