geotech-cli 0.2.0

Contributor CLI for Stratum Commons executable notebooks and tool walkthroughs.

geotech-cli

geotech-cli is the contributor-facing scaffold for Stratum Commons executable notebooks and tool walkthroughs.

This in-repo scaffold currently supports a narrow Phase 2 contract:

• parse and validate the published YAML front-matter schema
• run a local Python run(runtime_inputs) function after the front-matter block
• persist a recorded output bundle under .geotech/output/
• submit the bundle to POST /api/cli/submit using a bearer token or browser-session-equivalent API token

Source file contract

The CLI expects a source file that starts with a fenced YAML block and then defines Python source code.

---
schema: 1
standard_id: geo.spt.n60_correction
version: 1.0.0
runtime:
  target: browser
  pyodide: "0.29.4"
inputs:
  - id: raw_blow_count
    label: Raw blow count
    quantity_kind: blow_count
    unit: blows/0.3m
outputs:
  - id: n60
    label: Corrected N60
    kind: scalar
    quantity_kind: blow_count
    unit: blows/0.3m
licence:
  code: MIT
audience: practitioner
domain_tags:
  - foundations
known_limitations:
  - Demonstration scaffold only.
required_packages:
  - numpy
lockfile: uv.lock
---

DEFAULT_INPUTS = {
    "raw_blow_count": 18,
}

def run(runtime_inputs):
    return {
        "summary": "Executed local scaffold.",
        "scalarOutputs": [
            {"id": "n60", "label": "Corrected N60", "value": runtime_inputs["raw_blow_count"], "unit": "blows/0.3m"},
        ],
    }

DEFAULT_INPUTS is optional. The CLI merges repeated --input key=value arguments over those defaults.

Commands

geotech validate notebook.py
geotech run notebook.py --input raw_blow_count=18
geotech submit notebook.py --title "SPT demo" --summary "Demo executable post"
geotech checklist notebook.py
geotech auth save-token stc_pat_...

Notes

• validate checks uv.lock, the manifest schema, runtime hints, optional marimo check, and the canonical /standards/<id>/v/<version> route when online.
• run executes the local run(runtime_inputs) function and writes .geotech/output/<stem>.run.json.
• submit synthesizes a minimal publishable markdown body around the validated front-matter and uploads the recorded output bundle to the current platform route.
• checklist currently prints a declaration shell from the manifest metadata; the full standards-bound assumption sync remains a later slice.