Drive Base File Fixer from your own code

{
 "task": "fix",
 "base": "filters:\n  and:\n    - file.hasTag(\"book\")\nformulas:\n  days_reading: (today() - date(started)).round(0)\nviews:\n  - type: table\n    name: Reading\n    order:\n      - file.name\n      - author\n      - formula.days_reading\n    groupBy:\n      property: status\n      direction: asc\n",
 "facts": "{\"checker\":\"Base File Fixer (YAML, Bases schema, expression parse and type checks, preview over pasted notes)\",\"status\":\"broken\",\"preview_clock\":\"2026-09-27 12:00\",\"base_path\":\"Reading.base\",\"findings\":[{\"id\":\"F1\",\"severity\":\"error\",\"source\":\"expr\",\"code\":\"duration-method\",\"where\":\"formulas.days_reading\",\"line\":5,\"text\":\"Subtracting dates gives a Duration, which has no .round(). Read a number first: (...).days.round(...) - the skill's own rule.\",\"quote\":\"(today() - date(started)).round(0)\"},{\"id\":\"F2\",\"severity\":\"error\",\"source\":\"schema\",\"code\":\"group-direction\",\"where\":\"views[0].groupBy.direction\",\"line\":15,\"text\":\"direction must be ASC or DESC (uppercase), not 'asc'.\",\"quote\":\"\"},{\"id\":\"F3\",\"severity\":\"warning\",\"source\":\"expr\",\"code\":\"unguarded-date\",\"where\":\"formulas.days_reading\",\"line\":5,\"text\":\"date(started) errors on any note without a started value (the skill's 'missing null check'). Guard it: if(started, ..., \\\"\\\").\",\"quote\":\"(today() - date(started)).round(0)\"}],\"findings_total\":3,\"formula_types\":{\"days_reading\":\"number\"},\"notes\":null,\"preview\":null,\"base_sent\":{\"lines\":16,\"lines_cut\":0}}",
 "symptom": "The days_reading column shows an error on every row."
}

{
 "task": "fix",
 "headline": "formulas.days_reading called .round() on a Duration and read started without a guard, and the grouping direction was lowercase; the fixed file reads .days behind if(started, ...) and groups by status ASC.",
 "verdict": "broken",
 "finding_responses": [
  {
   "ref": "F1",
   "stance": "fixed",
   "note": "today() minus a date is a Duration, which has no .round(). The formula now reads .days, which is already a whole number."
  },
  {
   "ref": "F2",
   "stance": "fixed",
   "note": "views[0].groupBy.direction is now ASC; only uppercase ASC or DESC is valid."
  },
  {
   "ref": "F3",
   "stance": "fixed",
   "note": "The formula now returns \"\" on a note without started instead of an error."
  }
 ],
 "changes": [
  {
   "where": "formulas.days_reading",
   "before": "days_reading: (today() - date(started)).round(0)",
   "after": "days_reading: 'if(started, (today() - date(started)).days, \"\")'",
   "why": "Reads a Duration field instead of rounding the Duration, and guards notes without started (single quotes because the formula holds double quotes)."
  },
  {
   "where": "views[0].groupBy.direction",
   "before": "direction: asc",
   "after": "direction: ASC",
   "why": "groupBy.direction takes ASC or DESC in uppercase."
  }
 ],
 "fixed_yaml": "filters:\n  and:\n    - file.hasTag(\"book\")\nformulas:\n  days_reading: 'if(started, (today() - date(started)).days, \"\")'\nviews:\n  - type: table\n    name: Reading\n    order:\n      - file.name\n      - author\n      - formula.days_reading\n    groupBy:\n      property: status\n      direction: ASC\n",
 "to_check": [
  "That your book notes spell the property started exactly so - no sample notes were given, so the page could not compare names.",
  "That status is the property you want the Reading table grouped by."
 ]
}

{
 "task": "build",
 "request": "All my recipes (tagged recipe) in a table sorted by rating, highest first, with cuisine, minutes and days since I last cooked each one; and a cards view of the quick ones under 30 minutes.",
 "facts": "{\"preview_clock\":\"2026-09-27 12:00\",\"base_path\":\"Recipes.base\",\"notes\":{\"files\":3,\"markdown\":3,\"extensions\":{\"md\":3},\"folders\":[\"Recipes\"],\"tags\":[\"quick\",\"recipe\"],\"properties\":[{\"name\":\"cuisine\",\"notes\":3,\"types\":[\"string\"],\"examples\":[\"Middle Eastern\",\"Indian\",\"Thai\"]},{\"name\":\"last_cooked\",\"notes\":2,\"types\":[\"date\"],\"examples\":[\"2026-09-12\",\"2026-08-30\"]},{\"name\":\"minutes\",\"notes\":3,\"types\":[\"number\"],\"examples\":[\"30\",\"45\",\"20\"]},{\"name\":\"rating\",\"notes\":3,\"types\":[\"number\"],\"examples\":[\"5\",\"4\"]},{\"name\":\"tags\",\"notes\":3,\"types\":[\"list\"],\"examples\":[\"recipe\",\"recipe, quick\"]}],\"properties_total\":5}}"
}

{
 "task": "build",
 "headline": "Your recipe notes in a table by rating, highest first, with days since each was last cooked, plus a cards view of recipes under 30 minutes.",
 "base_yaml": "filters:\n  and:\n    - file.hasTag(\"recipe\")\nformulas:\n  days_since_cooked: 'if(last_cooked, (today() - date(last_cooked)).days, \"\")'\nproperties:\n  formula.days_since_cooked:\n    displayName: Days since cooked\nviews:\n  - type: table\n    name: All recipes\n    order:\n      - file.name\n      - cuisine\n      - minutes\n      - rating\n      - formula.days_since_cooked\n    sort:\n      - property: rating\n        direction: DESC\n  - type: cards\n    name: Quick\n    filters:\n      and:\n        - \"minutes < 30\"\n    order:\n      - file.name\n      - cuisine\n      - minutes\n",
 "explanation": [
  {
   "part": "filters",
   "text": "Keeps notes tagged recipe; file.hasTag also matches nested tags such as recipe/dessert."
  },
  {
   "part": "formulas",
   "text": "days_since_cooked reads .days from today() minus last_cooked, and is empty on a recipe with no last_cooked (Dal tadka)."
  },
  {
   "part": "properties",
   "text": "Labels the formula column Days since cooked."
  },
  {
   "part": "views",
   "text": "All recipes is a table sorted by rating DESC; Quick is a cards view that adds the filter minutes < 30."
  }
 ],
 "properties_used": [
  "cuisine",
  "minutes",
  "rating",
  "last_cooked"
 ],
 "assumptions": [
  "Under 30 minutes is read as minutes < 30, so a 30-minute recipe (Shakshuka) is not in Quick; the quick tag is not used."
 ],
 "to_check": [
  "Whether Quick should show notes tagged quick instead - swap the view filter for file.hasTag(\"quick\")."
 ]
}

{"checker": "Base File Fixer (YAML, Bases schema, expression parse and type checks, preview over pasted notes)",
 "status": "broken|fix_first|ok",
 "preview_clock": "2026-09-27 12:00",
 "base_path": "Reading.base",
 "findings": [{"id": "F1", "severity": "error|warning|info", "source": "yaml|schema|expr|data",
               "code": "duration-method", "where": "formulas.days_reading", "line": 5,
               "text": "...", "quote": "..."}],
 "findings_total": 3,
 "formula_types": {"days_reading": "number"},
 "notes": {...} | null,
 "preview": [...] | null,
 "base_sent": {"lines": 16, "lines_cut": 0}}

{"preview_clock": "2026-09-27 12:00",
 "base_path": "Recipes.base",
 "notes": {...} | null,
 "current_base": {"status": "broken|fix_first|ok", "errors": 0, "warnings": 1}}

fix:
{"task": "fix", "headline": "", "verdict": "broken|fix_first|ok",
 "finding_responses": [{"ref": "F1", "stance": "fixed|not_a_problem|needs_you", "note": ""}],
 "changes": [{"where": "formulas.age", "before": "", "after": "", "why": ""}],
 "fixed_yaml": "the complete corrected .base file, or \"\"",
 "to_check": [""]}

build:
{"task": "build", "headline": "", "base_yaml": "the complete .base file",
 "explanation": [{"part": "filters|formulas|properties|summaries|views", "text": ""}],
 "properties_used": [""], "assumptions": [""], "to_check": [""]}

{"ok": true, "data": {"job_id": "job_...", "status": "queued"}}
{"ok": false, "error": {"code": "payment_required", "message": "..."}}

# Every call is the same three things: the base URL, your bearer token,
# and a JSON body. Keep the token in a shell variable.
BASE="https://api.skillsafe.ai/v1/app-api"
SLUG="basefile-fixer"
TOKEN="${SKILLSAFE_TOKEN:-YOUR_TOKEN}"   # from https://basefile-fixer.skillsafe.ai/tokens.html

call() {                  # call <path> [json-body]
  if [ -n "$2" ]; then
    curl -sS -X POST "$BASE/$1" \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json" \
      -d "$2"
  else
    curl -sS "$BASE/$1" -H "Authorization: Bearer $TOKEN"
  fi
}

# The token page is the shortest path. It shows the token this browser holds and
# hands you a ready-made shell export:
#
#   https://basefile-fixer.skillsafe.ai/tokens.html
#   export SKILLSAFE_TOKEN="..."
#
# To mint a guest token from the command line instead. A guest token is enough
# for /me and /estimate; a run needs a personal token from signing in.
curl -sS -X POST "$BASE/guest" \
  -H "Content-Type: application/json" -d '{"slug":"basefile-fixer"}'
# {"ok":true,"data":{"token":"...","subject_type":"guest"}}

call me
# {"ok":true,"data":{"subject_type":"user","username":"you","credits":51234}}

# body.json is the input object itself - no {"input": ...} wrapper. estimate does
# not validate it, so check the shape first:
python3 -c '
import json
b = json.load(open("body.json"))
assert isinstance(b, dict) and b.get("task") in ("fix", "build"), "task must be fix or build"
assert all(isinstance(v, str) for v in b.values()), "every field is a string"
assert isinstance(json.loads(b["facts"]), dict), "facts is a JSON string of an object"
need = "base" if b["task"] == "fix" else "request"
assert b.get(need, "").strip(), b["task"] + " needs " + need
'
INPUT=$(cat body.json)

call estimate "$INPUT"
# {"ok":true,"data":{"model":"...","model_alias":"gpt-terra",
#   "markup_bps":...,"hold_credits":...,"min_credits":...,"sponsor_enabled":false}}
# hold_credits is RESERVED, not the price; charged_credits after the run is the cost.

# Always send an Idempotency-Key derived from the input. A retried request with
# the same key returns the SAME job instead of billing a second run.
LANE=$(printf '%s' "$INPUT" | python3 -c 'import sys,json;print(json.load(sys.stdin)["task"])')   # fix or build
KEY="basefile-fixer:$LANE:$(printf '%s' "$INPUT" | shasum -a 256 | cut -c1-16):a1"

JOB=$(curl -sS -X POST "$BASE/run" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $KEY" \
  -d "$INPUT" | python3 -c 'import sys,json;print(json.load(sys.stdin)["data"]["job_id"])')

while :; do
  OUT=$(call "jobs/$JOB")
  STATUS=$(printf '%s' "$OUT" | python3 -c 'import sys,json;print(json.load(sys.stdin)["data"]["status"])')
  [ "$STATUS" = "succeeded" ] && break
  [ "$STATUS" = "failed" ] && echo "$OUT" && exit 1
  sleep 2
done

# {"ok":true,"data":{"job_id":"job_...","status":"succeeded",
#   "output":{"output":"{\"task\":\"fix\",\"headline\":\"...\",\"verdict\":\"broken\", ...}"},
#   "charged_credits":...,"truncated":false}}
printf '%s' "$OUT" | python3 -c 'import sys,json;print(json.load(sys.stdin)["data"]["output"]["output"])' > reply.json

# Server-sent events. `delta` events carry chunks of the reply; `done` carries the
# status, charged_credits and the truncated flag. Ignore `tick` heartbeats.
curl -N -X POST "$BASE/run-stream" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $KEY" \
  -H "Accept: text/event-stream" \
  -d "$INPUT"

# event: job    {"job_id":"job_..."}
# event: delta  {"text":"{\"task\":\"fix\",\"headline\":\"formulas.days_reading"}
# event: done   {"status":"succeeded","charged_credits":...,"truncated":false}

# The reply is a JSON string inside data.output.output (saved as reply.json in step 5):
python3 -c '
import json
r = json.load(open("reply.json"))
print(r["task"], r["headline"])
if r["task"] == "fix":
    print("verdict:", r["verdict"])
    for f in r["finding_responses"]: print(f["ref"], f["stance"], f["note"])
    for c in r["changes"]: print("-", c["where"], ":", c["before"], "->", c["after"])
    if r["fixed_yaml"]: open("fixed.base", "w").write(r["fixed_yaml"])
else:
    for e in r["explanation"]: print(e["part"], "-", e["text"])
    print("assumptions:", r["assumptions"])
    open("new.base", "w").write(r["base_yaml"])
for x in r["to_check"]: print("check:", x)
'
# Paste fixed.base or new.base into https://basefile-fixer.skillsafe.ai/ to re-check and preview it.