{"id":50193168,"url":"https://github.com/zer0pa/glyph-engine","last_synced_at":"2026-05-25T15:08:57.849Z","repository":{"id":355275008,"uuid":"1219417031","full_name":"Zer0pa/Glyph-Engine","owner":"Zer0pa","description":"Benchmark scaffold for glyph-shape descriptors. Three borrowed baselines (ORB, Hu, HOG) run; our own descriptor can't yet — blocked on D-06 retrieval of two Indus source files. Methods package, not a glyph claim.","archived":false,"fork":false,"pushed_at":"2026-05-14T18:04:24.000Z","size":237,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-14T19:43:48.119Z","etag":null,"topics":["ablation","borrowed-baselines","descriptors","glyph-engine","gnosis","methodology","methods","multi-seed","package-boundary","python","robustness","zer0pa"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Zer0pa.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":"AUDITOR_PLAYBOOK.md","citation":"CITATION.cff","codeowners":null,"security":"SECURITY.md","support":"docs/SUPPORT.md","governance":"GOVERNANCE.md","roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-23T21:20:42.000Z","updated_at":"2026-05-14T18:04:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Zer0pa/Glyph-Engine","commit_stats":null,"previous_names":["zer0pa/glyph-engine"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Zer0pa/Glyph-Engine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FGlyph-Engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FGlyph-Engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FGlyph-Engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FGlyph-Engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Zer0pa","download_url":"https://codeload.github.com/Zer0pa/Glyph-Engine/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Zer0pa%2FGlyph-Engine/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33480250,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-25T14:31:05.219Z","status":"ssl_error","status_checked_at":"2026-05-25T14:31:02.878Z","response_time":57,"last_error":"SSL_read: 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":["ablation","borrowed-baselines","descriptors","glyph-engine","gnosis","methodology","methods","multi-seed","package-boundary","python","robustness","zer0pa"],"created_at":"2026-05-25T15:08:56.488Z","updated_at":"2026-05-25T15:08:57.831Z","avatar_url":"https://github.com/Zer0pa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gnosis Glyph Engine\n\n\u003e Live window into the Zer0pa lab. Useful now, improving continuously; blockers are part of the public surface.\n\n## What This Is\n\nGlyph-Engine tests whether a standalone glyph-descriptor package boundary is earned; borrowed baselines run, owned-arm authority remains blocked.\n\n`gnosis-glyph-engine` is the Gnosis research lane that asks one falsifiable\nquestion:\n\n\u003e Is a standalone glyph-engine package boundary earned by a real consumer,\n\u003e a monorepo-free smoke path, and a descriptor ablation against borrowed\n\u003e baselines?\n\nIt is an extraction-target scaffold for reusable glyph geometry, stroke, and\ndescriptor kernels. It is **not a public library**, **not a product**, and\n**not a decipherment claim**.\n\n**Defensible headline metrics (as of 2026-04-28):** Borrowed-baseline ablation\nacross 10 seeds: mean σ `baseline_orb` 4.14 ± 1.12, `baseline_hu_regionprops`\n2.95 ± 1.06, `baseline_hog` 1.15 ± 1.17 (artifact:\n`artifacts/robustness/robustness_report.json`). Determinism:\n`replay_all_identical == true` for every arm in the seed-42 ablation;\nreference-freeze SHA256 is byte-stable across arms. 17 pytest tests pass when\nsibling `gnosis-morph-bench` is installed; 16 pass + 1 cleanly skips when it\nis not — preserving repo independence.\n\n**Honest blocker:** The owned-arm authority metric `package_boundary_earned`\nis `UNTESTED`. Two Indus source files (`scripts/indus/stroke_native_encoding.py`,\n`scripts/indus/phase3_common.py`) are not present in the portfolio snapshot;\nD-06 retrieval is the unblock. Phase 02b cannot start until D-06 clears.\n\n## Method Mechanics\n\n| Field | Value |\n| --- | --- |\n| Architecture | GNOSIS_GLYPH_DESCRIPTOR_METHOD |\n| Method | Descriptor extraction scaffold with synthetic 12-glyph fixture |\n| Baselines | OpenCV ORB, Hu regionprops, HOG borrowed arms |\n| Manifest Contract | `BenchmarkManifest` consumed by Morph-Bench |\n| Authority Gate | `package_boundary_earned` owned-arm metric |\n| Open Gate | D-06 source retrieval blocks Phase 02b |\n\n## Key Metrics\n\n| Metric | Value | Baseline |\n| --- | --- | --- |\n| Borrowed-baseline robustness | ORB 4.14 +/- 1.12; Hu 2.95 +/- 1.06; HOG 1.15 +/- 1.17 | 10 seeds |\n| Deterministic replay | `replay_all_identical == true` | seed-42 ablation |\n| Pytest surface | 17 pass with Morph-Bench; 16 pass + 1 skip without sibling | repo independence preserved |\n| Authority gate | `package_boundary_earned == UNTESTED` | D-06 blocker |\n\n\u003e Source: `artifacts/robustness/robustness_report.json`, `artifacts/ablation/ablation_report.json`, `.gpd/phases/02-minimal-extraction-smoke/`, and `SOURCE_BOUNDARY.md`.\n\n## Repo Identity\n\n| Field | Value |\n| --- | --- |\n| Identifier | Glyph-Engine |\n| Repository | https://github.com/Zer0pa/Glyph-Engine |\n| Portfolio | Gnosis |\n| Visibility | PUBLIC |\n| Default Branch | main |\n| Authority Source | `SOVEREIGN_PRD.md`; `.gpd/phases/02-minimal-extraction-smoke/` |\n| License | Apache-2.0 code; CC-BY-4.0 docs |\n\n## Readiness\n\n| Field | Value |\n| --- | --- |\n| Verdict | BLOCKED |\n| Posture | `package_boundary_unearned_pending_owned_arm_d06` |\n| Checks | borrowed-baseline and repo-independence checks pass |\n| Authority metric | `package_boundary_earned` is `UNTESTED` |\n| Authority | `SOURCE_BOUNDARY.md`; `SOVEREIGN_PRD.md` |\n\n### Honest Blocker\n\nThe owned-arm authority metric is `UNTESTED`. Gate 4 cannot run until D-06 retrieves the two missing Indus source files.\n\n## What We Prove\n\n- The frozen Phase 01 interface (`Descriptor`, `LearnedDescriptor`,\n  `manifest_builder`) is implementable using only borrowed OSS — OpenCV,\n  scikit-image, scikit-learn, NumPy.\n- The package installs cleanly with `pip install -e .[dev]` on Python 3.13\n  with no live-monorepo imports and no monorepo path coupling.\n- The 17-test pytest suite passes when sibling `gnosis-morph-bench` is\n  installed; 16 pass + 1 cleanly skips when it is not — preserving repo\n  independence.\n- The frozen `BenchmarkManifest` shape is consumed unmodified by\n  `gnosis_morph_bench.schema.load_manifest`, producing finite `sigma`,\n  `null_mean`, `null_std`, `silhouette`, and `mean_jaccard` per arm.\n- A multi-seed (10-seed) borrowed-baseline ceiling is recorded in\n  `artifacts/robustness/robustness_report.json`; mean σ across seeds\n  comes out to `baseline_orb` 4.14 ± 1.12, `baseline_hu_regionprops`\n  2.95 ± 1.06, `baseline_hog` 1.15 ± 1.17.\n- Determinism is checked: `replay_all_identical == true` for every arm\n  in the seed-42 ablation; reference-freeze SHA256 is byte-stable across\n  arms.\n\n## What We Don't Claim\n\n- We do not claim that any owned descriptor beats borrowed baselines.\n  Phase 02b is BLOCKED on D-06 (two Indus source files are not present\n  in the portfolio snapshot) and the gate-4 verdict is `UNTESTED`.\n- We do not claim cross-corpus generalisation. The fixture is a\n  deterministic 12-glyph synthetic generator; rights-cleared real-glyph\n  evidence does not yet exist in this repo.\n- We do not claim public-release readiness, performance superiority, or\n  product readiness.\n- We do not claim Indus or cuneiform domain results — those are owned by\n  sibling lanes.\n\n## Verification Status\n\n| Code | Check | Verdict |\n| --- | --- | --- |\n| V_01 | `pip install -e .[dev]` on Python 3.13 | PASS |\n| V_02 | pytest without Morph-Bench sibling: 16 pass + 1 skip | PASS |\n| V_03 | pytest with Morph-Bench sibling: 17 pass | PASS |\n| V_04 | seed-42 ablation matches verification to 6 decimals | PASS |\n| V_05 | D-06 owned-arm source retrieval | BLOCKED |\n\n## Proof Anchors\n\n| Path | State |\n| --- | --- |\n| `SOVEREIGN_PRD.md` | VERIFIED |\n| `.gpd/phases/01-consumer-and-interface-freeze/01-DECISIONS.md` | VERIFIED |\n| `artifacts/ablation/ablation_report.json` | VERIFIED |\n| `artifacts/robustness/robustness_report.json` | VERIFIED |\n| `SOURCE_BOUNDARY.md` | VERIFIED |\n| `HF_CUSTODY_REGISTER.md` | VERIFIED |\n\n## Repo Shape\n\n| Field | Value |\n| --- | --- |\n| Proof Anchors | 6 display anchors |\n| Portfolio | Gnosis |\n| Package | gnosis-glyph-engine==0.1.0a1 |\n| Primary Source | `src/gnosis_glyph_engine/` |\n| Tests | `tests/` |\n| Artifacts | `artifacts/ablation/`; `artifacts/robustness/` |\n| Support Sections | Licensing; Quick Start; Current Gaps; Upcoming Workstreams |\n\n```\n.\n├── NOTICE                                  # Apache-2.0 code and CC-BY-4.0 docs posture\n├── HF_CUSTODY_REGISTER.md                  # HF artefact-dataset truth\n├── README.md                               # this file\n├── SOVEREIGN_PRD.md                        # authority metric + extraction gate\n├── SOURCE_BOUNDARY.md                      # candidate sources, ledger, D-06\n├── AUDITOR_PLAYBOOK.md                     # fast path + reproduce + claim-replay\n├── CONTRIBUTING.md, GOVERNANCE.md, RELEASING.md, ROADMAP.md, SECURITY.md\n├── CHANGELOG.md, CITATION.cff, CODE_OF_CONDUCT.md\n├── DATA_POLICY.md, PUBLIC_AUDIT_LIMITS.md\n├── THIRD_PARTY_NOTICES.md, TRADEMARKS.md\n├── pyproject.toml                          # gnosis-glyph-engine==0.1.0a1\n├── _internal/                              # agent-orchestration scaffolding (not reader-facing)\n│   ├── AUTONOMOUS_EXECUTION_POLICY.md\n│   ├── GPD_BOOTSTRAP_GUIDE.md\n│   ├── UNIVERSAL_STARTUP_PROMPT.md\n│   ├── TEMPLATE_USAGE.md\n│   ├── MIGRATION_PLAN.md\n│   ├── WORKSTREAM_GPD_INIT_CHECKLIST.md\n│   ├── TODO.md\n│   └── AGENT_STATUS_REPORT_2026-04-24.md\n├── .github/\n│   ├── workflows/ci.yml\n│   ├── ISSUE_TEMPLATE/\n│   └── PULL_REQUEST_TEMPLATE.md\n├── .gpd/\n│   ├── PROJECT.md, STATE.md, ROADMAP.md, REQUIREMENTS.md, DECISIONS.md,\n│   │   CONVENTIONS.md, NOTATION_GLOSSARY.md, state.json, config.json\n│   └── phases/\n│       ├── 00-workstream-bootstrap/*\n│       ├── 01-consumer-and-interface-freeze/*\n│       └── 02-minimal-extraction-smoke/*      # 02a + 02c artefacts\n├── src/gnosis_glyph_engine/\n│   ├── __init__.py, protocols.py, fixtures.py, manifest_builder.py\n│   ├── baselines/{__init__,orb,hu_regionprops,hog}.py\n│   ├── owned/__init__.py                      # raises SourceRetrievalPending until D-06\n│   └── scripts/{__init__,run_ablation,run_robustness}.py\n├── tests/{test_fixtures,test_baselines,test_manifest_builder}.py\n├── scripts/run_ablation.py                    # thin shim\n├── artifacts/\n│   ├── ablation/   {ablation_report.json, per_arm/baseline_*.{manifest,smoke_report}.json}\n│   └── robustness/ robustness_report.json\n├── code/README.md                             # legacy code-surface marker\n└── docs/{ARCHITECTURE,LEGAL_BOUNDARIES,PROVENANCE_LABELS,FAQ,SUPPORT,README}.md\n```\n\n## Licensing\n\nThis repository is part of the Zer0pa Gnosis Portfolio.\n\n**Code** in this repository is licensed under the Apache License 2.0. See\n`LICENSE` for the full text. SPDX identifier: `Apache-2.0`.\n\n**Documentation, reports, and written materials** are licensed under Creative\nCommons Attribution 4.0 International. SPDX identifier: `CC-BY-4.0`. Canonical\nterms: \u003chttps://creativecommons.org/licenses/by/4.0/\u003e.\n\n**Data and fixtures** are handled per dataset and artifact family. See\n`DATA_POLICY.md` for this repository's data boundary. The code license does not\nlicense raw corpora, image-bearing cultural-heritage assets, private HF\nartifacts, model weights, endpoint logs, or operational transcripts.\n\n**Trademarks** - \"Gnosis\", \"Zer0pa Gnosis\", and distinctive sub-marks are\ntrademarks of Zer0pa. Apache-2.0 and CC-BY-4.0 do not grant trademark rights.\nSee `TRADEMARKS.md`.\n\n## Quick Start\n\n```bash\ngit clone https://github.com/Zer0pa/Glyph-Engine.git\ncd Glyph-Engine\npython3.13 -m venv .venv \u0026\u0026 source .venv/bin/activate\npip install -e .[dev]\npytest -q                          # → 16 passed, 1 skipped\npython -m gnosis_glyph_engine.scripts.run_ablation\npython -m gnosis_glyph_engine.scripts.run_robustness\n```\n\nConsole scripts (after install): `glyph-engine-ablation`,\n`glyph-engine-robustness`.\n\n## Current Gaps\n\n- **D-06** (owner action): retrieve\n  `scripts/indus/stroke_native_encoding.py` and\n  `scripts/indus/phase3_common.py` from the live monorepo, or grant pod\n  access to a live-monorepo clone. Phase 02b cannot start until D-06\n  clears.\n- No real-glyph fixture; the synthetic 12-glyph generator is the only\n  ablation surface today. Rights-cleared real-glyph evidence does not yet\n  exist in this repo.\n- Public contact surface remains owner-held.\n\n## Upcoming Workstreams\n\n### Operations / External Dependency\n\n- **D-06 source-file retrieval** — owner action: retrieve\n  `scripts/indus/stroke_native_encoding.py` and\n  `scripts/indus/phase3_common.py` from the live monorepo, or grant pod\n  access to a monorepo clone. All Phase 02b work is gated on this.\n\n### Research-Deferred — Investigation Underway\n\n- **Real-glyph fixture** — replace the deterministic 12-glyph synthetic\n  generator with rights-cleared real-glyph evidence. No rights-cleared\n  fixture exists yet; investigation of sourcing options is underway. Cross-\n  corpus generalisation claims cannot be made until this is resolved.\n\n### Active Engineering\n\n- **Phase 02b — owned-arm gate testing** — implement\n  `src/gnosis_glyph_engine/owned/stroke_compass.py` and\n  `src/gnosis_glyph_engine/owned/topology.py` from the retrieved Indus\n  source files; run ablation + robustness against the Phase 02c baseline\n  ceiling; apply D-04 pass rule under D-02c-02 sovereign routing. Starts\n  the moment D-06 clears.\n\n### Zero-Base Scientific Thinking — GPD Research and Planning Pending\n\n- None at this time.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzer0pa%2Fglyph-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzer0pa%2Fglyph-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzer0pa%2Fglyph-engine/lists"}