{"id":47707346,"url":"https://github.com/mapleleaflatte03/meridian-loom","last_synced_at":"2026-04-02T18:02:31.365Z","repository":{"id":346340372,"uuid":"1189452006","full_name":"mapleleaflatte03/meridian-loom","owner":"mapleleaflatte03","description":"Experimental local scaffold for the planned Meridian-native runtime.","archived":false,"fork":false,"pushed_at":"2026-04-01T15:01:02.000Z","size":2586,"stargazers_count":6,"open_issues_count":9,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-01T16:15:48.808Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mapleleaflatte03.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-23T10:36:01.000Z","updated_at":"2026-04-01T15:01:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mapleleaflatte03/meridian-loom","commit_stats":null,"previous_names":["mapleleaflatte03/meridian-loom"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/mapleleaflatte03/meridian-loom","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapleleaflatte03%2Fmeridian-loom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapleleaflatte03%2Fmeridian-loom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapleleaflatte03%2Fmeridian-loom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapleleaflatte03%2Fmeridian-loom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mapleleaflatte03","download_url":"https://codeload.github.com/mapleleaflatte03/meridian-loom/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mapleleaflatte03%2Fmeridian-loom/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31312744,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-02T18:01:56.822Z","updated_at":"2026-04-02T18:02:31.357Z","avatar_url":"https://github.com/mapleleaflatte03.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./docs/assets/meridian_loom_lockup.svg\" alt=\"Meridian Loom\" width=\"720\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-MIT-1f6feb?style=flat-square\" alt=\"MIT license\"\u003e\n  \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/mapleleaflatte03/meridian-loom/rust.yml?branch=main\u0026style=flat-square\" alt=\"Build passing\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/version-0.1.15-0c1117?style=flat-square\" alt=\"Version 0.1.15\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eInstall in one command. Run a governed job in minutes. Inspect the receipt instead of guessing.\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./docs/assets/install_in_60_seconds.gif\" alt=\"Install Loom in one command, then run doctor and status to see the proof-first runtime surface.\" width=\"920\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"docs/INSTALL.md\"\u003eInstall\u003c/a\u003e ·\n  \u003ca href=\"docs/RUN_LOCAL.md\"\u003eRun Local\u003c/a\u003e ·\n  \u003ca href=\"docs/BENCHMARKS.md\"\u003eBenchmarks\u003c/a\u003e ·\n  \u003ca href=\"docs/RELEASE.md\"\u003eRelease\u003c/a\u003e ·\n  \u003ca href=\"docs/SERVICE.md\"\u003eService\u003c/a\u003e ·\n  \u003ca href=\"docs/ARCHITECTURE.md\"\u003eArchitecture\u003c/a\u003e ·\n  \u003ca href=\"docs/MERIDIAN_PoGE_PROTOCOL.md\"\u003ePoGE\u003c/a\u003e\n\u003c/p\u003e\n\n# Meridian Loom\n\nMeridian Loom is the official Meridian v0.1 local runtime. It installs under\nthe operator's home directory, exposes a full CLI, runs bounded terminal and\nbrowser jobs, and writes local proof, audit, queue, and parity artifacts you\ncan inspect immediately.\n\nIf you want the shortest honest summary:\n\n- **Install:** one command, binary first\n- **Operate:** one CLI for doctor, status, jobs, queue, parity, service\n- **Prove:** every governed execution emits filesystem receipts and proof views\n- **Boundary:** local runtime is real; hosted replacement is not claimed here\n\n## 1-command install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/mapleleaflatte03/meridian-loom/main/scripts/install.sh | bash\n```\n\nThe installer prefers prebuilt GitHub release assets for the current host and\nfalls back to a source build only when no matching asset is available.\n\n## What ships in the official v0.1 release\n\n- One-command installer with binary-first release installs\n- Prebuilt GitHub release assets for:\n  - Linux x86_64\n  - Linux arm64\n  - macOS x86_64\n  - macOS arm64\n- Local runtime root under `$HOME/.local/share/meridian-loom`\n- `loom` linked into `$HOME/.local/bin`\n- Built-in governed capabilities for:\n  - terminal execution\n  - browser navigation\n  - heartbeat scheduling\n- Queue, job, audit, parity, and runtime-service surfaces on disk\n- Proof of Governed Execution (PoGE) contract and receipt architecture\n\n## Quickstart: three copy-paste examples\n\nThese examples are intentionally concrete. They assume:\n\n- you installed `loom`\n- your Kernel repo is available at `/opt/meridian-kernel`\n- you are willing to keep the truth boundary explicit\n- you are fine using `local_foundry` as the default local org id on a fresh root\n\nIf you have not initialized the Kernel yet, run example 3 first.\n\n### 1. Run one terminal job and inspect the receipt\n\n```bash\nexport LOOM_ROOT=\"${HOME}/.local/share/meridian-loom/runtime/default\"\nexport MERIDIAN_KERNEL_PATH=/opt/meridian-kernel\nexport MERIDIAN_ORG_ID=\"${MERIDIAN_ORG_ID:-local_foundry}\"\n\nloom init \\\n  --root \"$LOOM_ROOT\" \\\n  --mode embedded \\\n  --kernel-path \"$MERIDIAN_KERNEL_PATH\" \\\n  --org-id \"$MERIDIAN_ORG_ID\"\n\nloom doctor --root \"$LOOM_ROOT\" --format human\n\nloom action execute \\\n  --root \"$LOOM_ROOT\" \\\n  --kernel-path \"$MERIDIAN_KERNEL_PATH\" \\\n  --agent-id agent_atlas \\\n  --org-id \"$MERIDIAN_ORG_ID\" \\\n  --capability loom.terminal.exec.v1 \\\n  --payload-json '{\"argv\":[\"bash\",\"-lc\",\"printf \\\"hello from loom\\\\n\\\"\"],\"working_dir\":\".\",\"timeout_ms\":2000,\"max_output_bytes\":4096}' \\\n  --estimated-cost-usd 0.05\n\nLATEST_JOB_ID=\"$(\n  loom job list --root \"$LOOM_ROOT\" --format json \\\n    | python3 -c 'import json,sys; jobs=json.load(sys.stdin).get(\"jobs\", []); print(jobs[0][\"job_id\"] if jobs else \"\")'\n)\"\n\nloom job inspect --root \"$LOOM_ROOT\" --job-id \"$LATEST_JOB_ID\" --format human\nloom parity report --root \"$LOOM_ROOT\"\nloom shadow report --root \"$LOOM_ROOT\"\n```\n\nWhat you should see:\n\n- a governed decision\n- a runtime execution receipt\n- audit/parity artifact paths\n- one obvious next step if the run degraded\n\n### 2. Run bounded browser navigation and inspect proof\n\n```bash\nexport LOOM_ROOT=\"${HOME}/.local/share/meridian-loom/runtime/default\"\nexport MERIDIAN_KERNEL_PATH=/opt/meridian-kernel\nexport MERIDIAN_ORG_ID=\"${MERIDIAN_ORG_ID:-local_foundry}\"\n\nloom action execute \\\n  --root \"$LOOM_ROOT\" \\\n  --kernel-path \"$MERIDIAN_KERNEL_PATH\" \\\n  --agent-id agent_atlas \\\n  --org-id \"$MERIDIAN_ORG_ID\" \\\n  --capability loom.browser.navigate.v1 \\\n  --payload-json '{\"session_id\":\"docs-example\",\"url\":\"https://example.com\",\"allowed_hosts\":[\"example.com\"],\"wait_for\":\"dom_content_loaded\",\"timeout_ms\":4000,\"capture_semantic_snapshot\":true}' \\\n  --estimated-cost-usd 0.05\n\nLATEST_JOB_ID=\"$(\n  loom job list --root \"$LOOM_ROOT\" --format json \\\n    | python3 -c 'import json,sys; jobs=json.load(sys.stdin).get(\"jobs\", []); print(jobs[0][\"job_id\"] if jobs else \"\")'\n)\"\n\nloom job inspect --root \"$LOOM_ROOT\" --job-id \"$LATEST_JOB_ID\" --format human\nloom parity report --root \"$LOOM_ROOT\"\n```\n\nThis proves the local browser host-call lane and its receipt surfaces. It does\nnot claim broad hosted browser automation.\n\n### 3. Connect Loom to Kernel using `quickstart.py`\n\n```bash\ncd /opt/meridian-kernel\npython3 quickstart.py --init-only\n\nexport LOOM_ROOT=\"${HOME}/.local/share/meridian-loom/runtime/default\"\nexport MERIDIAN_ORG_ID=\"${MERIDIAN_ORG_ID:-local_foundry}\"\nloom init \\\n  --root \"$LOOM_ROOT\" \\\n  --mode embedded \\\n  --kernel-path /opt/meridian-kernel \\\n  --org-id \"$MERIDIAN_ORG_ID\"\n\nloom contract show --root \"$LOOM_ROOT\" --kernel-path /opt/meridian-kernel\nloom doctor --root \"$LOOM_ROOT\" --format human\n```\n\nIf you want the Kernel demo dashboard as well:\n\n```bash\ncd /opt/meridian-kernel\npython3 quickstart.py --port 8080\n```\n\nThat gives you the governed workspace while Loom remains the local execution\nsurface.\n\n## Doctor and status should tell you what to do next\n\nThe first-run commands worth memorizing are:\n\n```bash\nloom doctor --root \"$HOME/.local/share/meridian-loom/runtime/default\" --format human\nloom status --root \"$HOME/.local/share/meridian-loom/runtime/default\"\n```\n\nThe goal of both commands is simple:\n\n- `doctor` tells you whether the runtime is ready, degraded, or blocked\n- `status` tells you where the runtime, queue, and service artifacts live\n- both should point to an obvious next command instead of forcing you to read the source\n\n## Benchmark harness\n\nLoom now ships a tiny reproducible benchmark harness at\n[`scripts/bench_runtime.py`](scripts/bench_runtime.py). It measures short-lived\nCLI cold starts and approximate peak RSS on the same host.\n\nExample:\n\n```bash\npython3 scripts/bench_runtime.py \\\n  --iterations 5 \\\n  --warmup 1 \\\n  --case \"loom status::./target/release/loom status --root /tmp/loom-bench-root\" \\\n  --case \"openfang help::openfang --help\" \\\n  --case \"ironclaw::ironclaw --help\" \\\n  --format markdown\n```\n\nCurrent reference run on the Meridian VPS (`2026-04-01`):\n\n| Case | Mean cold start (ms) | p95 (ms) | Peak RSS (MiB) |\n| --- | ---: | ---: | ---: |\n| `loom status` | 29.8 | 33.9 | 4.8 |\n| `openfang --help` | 28.5 | 30.8 | 2.8 |\n| `ironclaw --help` | 32.6 | 33.9 | 5.1 |\n\nWhy this exists:\n\n- OpenFang is strong on one-binary operator packaging\n- IronClaw is strong on secure local-assistant ergonomics\n- Loom should make the comparison reproducible on one machine, with one script,\n  and with a clear boundary around what the numbers do and do not mean\n\nSee [docs/BENCHMARKS.md](docs/BENCHMARKS.md) for the benchmark boundary and the\nrecommended command choices.\n\n## Release story\n\nLoom releases are GitHub-first operator packages. Tagging `v0.1.15` builds and\npublishes release archives for:\n\n- Linux x86_64\n- Linux arm64\n- macOS x86_64\n- macOS arm64\n\nEach asset includes the Loom binary, example config, docs, installer helpers,\nsystemd units, and a checksum file.\n\nSee [docs/RELEASE.md](docs/RELEASE.md) for the release layout.\n\n## Three-part Meridian stack\n\n- [meridian-loom](https://github.com/mapleleaflatte03/meridian-loom): local runtime surface and operator tooling\n- [meridian-kernel](https://github.com/mapleleaflatte03/meridian-kernel): governance, policy, authority, treasury, and court\n- [meridian-intelligence](https://github.com/mapleleaflatte03/meridian-intelligence): public product surface and governed delivery routes\n\n## Proof of Governed Execution (PoGE)\n\nThe cryptographic execution-receipt architecture is defined in the\n[Meridian PoGE Protocol RFC](docs/MERIDIAN_PoGE_PROTOCOL.md).\n\n- Purpose: bind governed host-calls to verifiable receipts, Merkle roots, and future settlement surfaces\n- Scope: Loom runtime host-call evidence and audit architecture\n- Boundary: this repo does not claim that every future settlement primitive is already live here\n\n## Truth boundary\n\n- Local install, queue, audit, parity, and runtime-service surfaces are real\n- Terminal execution, browser navigation, and heartbeat scheduling are real local primitives\n- Hosted runtime replacement is not claimed here\n- Multi-channel presence and memory should only be claimed through named proof surfaces, not vague runtime language\n- Compatibility and migration surfaces exist where they still help real operator cutovers; they do not turn Loom into a broad hosted-runtime claim\n\n## Operational surface\n\n- `loom init`, `loom doctor`, `loom health`, `loom status`\n- `loom start`, `loom stop`, `loom restart`, `loom logs`\n- `loom queue inspect|consume|ack|run-once|run-until-empty|status`\n- `loom job list|inspect`\n- `loom parity report`\n- `loom shadow report`\n- `loom capability list|show|gap show|scaffold|forge|import-workspace-skill|verify|promote|shim`\n- `loom service start|status|submit|import-commitments|stop`\n\n## Rehearsals\n\n- Operational rehearsals live in `scripts/tests/`\n- Migration and backward-compatibility rehearsals live in `scripts/migration_tools/`\n- Generated `examples/*-output.txt` transcripts are not checked in\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmapleleaflatte03%2Fmeridian-loom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmapleleaflatte03%2Fmeridian-loom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmapleleaflatte03%2Fmeridian-loom/lists"}