open-research-protocol 0.4.18 → 0.4.19

package/README.md

@@ -1,6 +1,6 @@
 # ORP — Open Research Protocol
 
-Maintained by Fractal Research Group (`frg.earth`).
+Maintained by SproutSeeds. Research stewardship: Fractal Research Group ([frg.earth](https://frg.earth)).
 
 [![npm version](https://img.shields.io/npm/v/open-research-protocol?color=111111&label=npm)](https://www.npmjs.com/package/open-research-protocol)
 [![npm downloads](https://img.shields.io/npm/dm/open-research-protocol?color=111111&label=downloads)](https://www.npmjs.com/package/open-research-protocol)
@@ -443,6 +443,11 @@ If you are using ORP normally, prefer:
 Reach for `orp pack ...` when you are doing advanced installs, ORP maintenance,
 or direct domain-template work.
 
+Pack installation is pack-owned: `pack.yml` can describe installable
+components, default includes, dependency checks, and report naming. That lets
+ORP consume repo-owned external packs through `--pack-path` without baking
+domain-specific install rules into ORP core.
+
 Install pack configs into a target repo (recommended):
 
 ```bash

package/docs/PROFILE_PACKS.md

@@ -39,6 +39,7 @@ Canonical fields:
 - `pack_id`: stable id
 - `name`, `version`, `description`
 - `orp_version_min`: optional compatibility floor
+- `install`: optional install contract for `orp pack install`
 - `variables`: render-time variables (for example `TARGET_REPO_ROOT`)
 - `templates`: available config templates
 
@@ -80,6 +81,10 @@ orp pack fetch \
   --install-target /path/to/repo
 ```
 
+Repo-owned local packs can also be installed directly with `--pack-path` as
+long as their `pack.yml` includes an `install` block describing components,
+default includes, and dependency-audit paths.
+
 This installs rendered config files and writes a dependency audit report:
 
 - `./orp.erdos-catalog-sync.yml`
@@ -218,6 +223,9 @@ orp erdos sync --problem-id 857 --problem-id 20
 - Packs can live in this repo (`packs/`) or external repos.
 - Users can copy/install packs without changing ORP core.
 - Version packs independently (for example `0.1.0`, `0.2.0`).
+- Repo-owned packs can ship their own install metadata in `pack.yml`, so ORP
+  can install external domain packs without hardcoding those domains into ORP
+  core.
 
 ## Quality guidance
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-research-protocol",
-  "version": "0.4.18",
+  "version": "0.4.19",
   "description": "ORP CLI (Open Research Protocol): workspace ledgers, secrets, scheduling, governed execution, and agent-friendly research workflows.",
   "license": "MIT",
   "author": "Fractal Research Group <cody@frg.earth>",

package/packs/erdos-open-problems/pack.yml

@@ -129,3 +129,57 @@ templates:
     output_hint: orp.erdos-catalog-sync.yml
     default_profiles:
       - erdos_catalog_sync_active
+
+install:
+  default_includes:
+    - catalog
+    - live_compare
+    - problem857
+  report_name: orp.erdos.pack-install-report.md
+  components:
+    catalog:
+      template_id: erdos_problems_catalog_sync
+      output_name: orp.erdos-catalog-sync.yml
+      description: Erdos catalog sync (all/open/closed/active snapshots).
+    live_compare:
+      template_id: sunflower_live_compare_suite
+      output_name: orp.erdos-live-compare.yml
+      description: Side-by-side atomic-board compare for Problems 857/20/367.
+      required_paths:
+        - analysis/problem857_counting_gateboard.json
+        - analysis/problem20_k3_gateboard.json
+        - analysis/problem367_sharp_gateboard.json
+        - scripts/problem857_ops_board.py
+        - scripts/problem20_ops_board.py
+        - scripts/problem367_ops_board.py
+        - scripts/frontier_status.py
+    problem857:
+      template_id: sunflower_problem857_discovery
+      output_name: orp.erdos-problem857.yml
+      description: Problem 857 discovery profile (board refresh/ready/spec/lean/frontier).
+      required_paths:
+        - analysis/problem857_counting_gateboard.json
+        - docs/PROBLEM857_COUNTING_OPS_BOARD.md
+        - orchestrator/v2/scopes/problem_857.yaml
+        - orchestrator/problem857_public_spec_check.py
+        - scripts/problem857_ops_board.py
+        - scripts/frontier_status.py
+        - sunflower_lean
+    governance:
+      template_id: sunflower_mathlib_pr_governance
+      output_name: orp.erdos-mathlib-pr-governance.yml
+      description: Mathlib PR governance profile set (pre-open, draft-readiness, full flow).
+      required_paths:
+        - docs/MATHLIB_SUBMISSION_CHECKLIST.md
+        - docs/MATHLIB_DRAFT_PR_TEMPLATE.md
+        - docs/MATHLIB_ISSUE_VIABILITY_GATE.md
+        - docs/UPSTREAM_PR_LANE.md
+        - analysis/UPSTREAM_PR_PLAN.yaml
+        - scripts/upstream-pr-plan.py
+        - scripts/upstream-pr-lane.sh
+        - scripts/mathlib-issue-viability-gate.py
+        - scripts/mathlib-naturality-snippet.sh
+        - scripts/mathlib-issue-local-gate.sh
+        - scripts/mathlib-tighten-fine-tooth-gate.sh
+        - scripts/mathlib-ready-to-draft-gate.sh
+        - scripts/mathlib-pr-body-preflight.py

package/packs/external-pr-governance/pack.yml

@@ -144,3 +144,20 @@ templates:
     output_hint: orp.external-pr-feedback-hardening.yml
     default_profiles:
       - external_feedback_hardening
+
+install:
+  default_includes:
+    - governance
+    - feedback_hardening
+  report_name: orp.external-pr.pack-install-report.md
+  components:
+    governance:
+      template_id: oss_pr_governance
+      output_name: orp.external-pr-governance.yml
+      description: Generic external contribution governance profiles (watch/select, pre-open, local-readiness, draft transition, draft lifecycle, full flow).
+      required_paths:
+        - analysis/PR_DRAFT_BODY.md
+    feedback_hardening:
+      template_id: oss_feedback_hardening
+      output_name: orp.external-pr-feedback-hardening.yml
+      description: Generic maintainer-feedback hardening profile.

package/packs/issue-smashers/pack.yml

@@ -176,3 +176,28 @@ templates:
     output_hint: orp.issue-smashers-feedback-hardening.yml
     default_profiles:
       - issue_smashers_feedback_hardening
+
+install:
+  default_includes:
+    - workspace
+    - feedback_hardening
+  report_name: orp.issue-smashers.pack-install-report.md
+  components:
+    workspace:
+      template_id: issue_smashers_workspace
+      output_name: orp.issue-smashers.yml
+      description: Opinionated issue-smashers workspace and external contribution governance profiles.
+      required_paths:
+        - issue-smashers/README.md
+        - issue-smashers/WORKSPACE_RULES.md
+        - issue-smashers/setup-issue-smashers.sh
+        - issue-smashers/analysis/ISSUE_SMASHERS_WATCHLIST.json
+        - issue-smashers/analysis/ISSUE_SMASHERS_STATUS.md
+        - issue-smashers/analysis/PR_DRAFT_BODY.md
+    feedback_hardening:
+      template_id: issue_smashers_feedback_hardening
+      output_name: orp.issue-smashers-feedback-hardening.yml
+      description: Issue-smashers maintainer-feedback hardening profile.
+      required_paths:
+        - issue-smashers/WORKSPACE_RULES.md
+        - issue-smashers/analysis/ISSUE_SMASHERS_STATUS.md

package/scripts/orp-pack-install.py

@@ -24,7 +24,7 @@ from typing import Any
 import yaml
 
 
-PACK_SPECS: dict[str, dict[str, Any]] = {
+LEGACY_PACK_SPECS: dict[str, dict[str, Any]] = {
     "erdos-open-problems": {
         "default_includes": ["catalog", "live_compare", "problem857"],
         "report_name": "orp.erdos.pack-install-report.md",
@@ -1267,18 +1267,99 @@ def _load_yaml(path: Path) -> dict[str, Any]:
     return payload
 
 
-def _pack_spec(pack_id: str) -> dict[str, Any]:
-    spec = PACK_SPECS.get(pack_id)
+def _legacy_pack_spec(pack_id: str) -> dict[str, Any]:
+    spec = LEGACY_PACK_SPECS.get(pack_id)
     if not isinstance(spec, dict):
         raise RuntimeError(f"unsupported pack for install flow: {pack_id}")
     return spec
 
 
-def _pack_components(pack_id: str) -> dict[str, dict[str, Any]]:
-    components = _pack_spec(pack_id).get("components", {})
+def _pack_install_spec(pack_meta: dict[str, Any], pack_id: str) -> dict[str, Any]:
+    install = pack_meta.get("install")
+    if isinstance(install, dict):
+        return install
+    return _legacy_pack_spec(pack_id)
+
+
+def _pack_templates(pack_meta: dict[str, Any]) -> dict[str, dict[str, Any]]:
+    raw = pack_meta.get("templates", {})
+    if not isinstance(raw, dict):
+        return {}
+    out: dict[str, dict[str, Any]] = {}
+    for key, value in raw.items():
+        if isinstance(key, str) and isinstance(value, dict):
+            out[key] = value
+    return out
+
+
+def _normalize_install_component(
+    component_key: str,
+    raw_component: dict[str, Any],
+    *,
+    templates: dict[str, dict[str, Any]],
+) -> dict[str, Any]:
+    template_id = str(raw_component.get("template_id", "")).strip()
+    if not template_id:
+        raise RuntimeError(f"install component missing template_id: {component_key}")
+
+    template_meta = templates.get(template_id)
+    if not isinstance(template_meta, dict):
+        raise RuntimeError(
+            f"install component {component_key} references unknown template_id: {template_id}"
+        )
+
+    output_name = str(raw_component.get("output_name") or template_meta.get("output_hint") or "").strip()
+    if not output_name:
+        raise RuntimeError(
+            f"install component {component_key} is missing output_name and template {template_id} has no output_hint"
+        )
+
+    description = str(raw_component.get("description") or template_meta.get("description") or "").strip()
+    required_paths_raw = raw_component.get("required_paths", [])
+    if required_paths_raw is None:
+        required_paths: list[str] = []
+    elif isinstance(required_paths_raw, list):
+        required_paths = [str(path) for path in required_paths_raw]
+    else:
+        raise RuntimeError(f"install component required_paths must be a list: {component_key}")
+
+    return {
+        "template_id": template_id,
+        "output_name": output_name,
+        "description": description,
+        "required_paths": required_paths,
+    }
+
+
+def _pack_components(pack_meta: dict[str, Any], pack_id: str) -> dict[str, dict[str, Any]]:
+    install = _pack_install_spec(pack_meta, pack_id)
+    components = install.get("components", {})
     if not isinstance(components, dict) or not components:
         raise RuntimeError(f"pack has no installable components: {pack_id}")
-    return components
+
+    templates = _pack_templates(pack_meta)
+    out: dict[str, dict[str, Any]] = {}
+    for key, value in components.items():
+        if not isinstance(key, str) or not isinstance(value, dict):
+            raise RuntimeError(f"invalid install component entry in pack {pack_id}: {key!r}")
+        out[key] = _normalize_install_component(key, value, templates=templates)
+    return out
+
+
+def _pack_default_includes(pack_meta: dict[str, Any], pack_id: str) -> list[str]:
+    install = _pack_install_spec(pack_meta, pack_id)
+    raw = install.get("default_includes", [])
+    if not isinstance(raw, list):
+        return []
+    return [str(x) for x in raw if isinstance(x, str)]
+
+
+def _pack_report_name(pack_meta: dict[str, Any], pack_id: str) -> str:
+    install = _pack_install_spec(pack_meta, pack_id)
+    raw = install.get("report_name")
+    if isinstance(raw, str) and raw.strip():
+        return raw.strip()
+    return f"orp.{pack_id}.pack-install-report.md"
 
 
 def _validate_var(raw: str) -> str:
@@ -2153,15 +2234,13 @@ def main() -> int:
     pack_id = str(pack_meta.get("pack_id", args.pack_id))
     pack_version = str(pack_meta.get("version", "unknown"))
     generated_at_utc = _now_utc()
-    components = _pack_components(pack_id)
+    components = _pack_components(pack_meta, pack_id)
     effective_vars = _vars_map(pack_meta, list(args.var or []))
     problem857_source_mode = _problem857_source_mode(effective_vars)
 
     includes = list(args.include or [])
     if not includes:
-        default_includes = _pack_spec(pack_id).get("default_includes", [])
-        if isinstance(default_includes, list):
-            includes = [str(x) for x in default_includes if isinstance(x, str)]
+        includes = _pack_default_includes(pack_meta, pack_id)
     if not includes:
         includes = sorted(components.keys())
 
@@ -2227,7 +2306,7 @@ def main() -> int:
         else:
             report_path = report_path.resolve()
     else:
-        report_name = str(_pack_spec(pack_id).get("report_name", f"orp.{pack_id}.pack-install-report.md"))
+        report_name = _pack_report_name(pack_meta, pack_id)
         report_path = (target_repo_root / report_name).resolve()
 
     _write_report(

package/spec/v1/profile-pack.schema.json

@@ -34,6 +34,9 @@
     "orp_version_min": {
       "type": "string"
     },
+    "install": {
+      "$ref": "#/$defs/install"
+    },
     "variables": {
       "type": "object",
       "additionalProperties": {
@@ -90,6 +93,51 @@
           }
         }
       }
+    },
+    "install": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "default_includes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "report_name": {
+          "type": "string"
+        },
+        "components": {
+          "type": "object",
+          "additionalProperties": {
+            "$ref": "#/$defs/installComponent"
+          }
+        }
+      }
+    },
+    "installComponent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "template_id"
+      ],
+      "properties": {
+        "template_id": {
+          "type": "string"
+        },
+        "output_name": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "required_paths": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
     }
   }
 }