platformforge 0.1.3__tar.gz → 0.1.4__tar.gz

{platformforge-0.1.3 → platformforge-0.1.4}/.github/workflows/ci.yml

@@ -32,6 +32,10 @@ jobs:
           python-version: ${{ matrix.python }}
       - name: Install
         run: pip install -e ".[dev]"
+      # lf-0019 B2 — rota Git Bash no Windows depende deste shim;
+      # `bash -n` pega erro de sintaxe/CRLF antes de qualquer usuário.
+      - name: Git Bash installer syntax (lf-0019)
+        run: bash -n install.windows.sh
       - name: Lint
         run: python scripts/validate.py --gate lint
       - name: Tests

{platformforge-0.1.3 → platformforge-0.1.4}/CHANGELOG.md

@@ -1,6 +1,11 @@
 # CHANGELOG
 
 All notable changes. Format: wave/feature, the "why", key commits.
+## [0.1.4] - 2026-10-20
+
+### Changed
+- Cycle 12.1: vendored `scripts/forge_bootstrap.py` re-stamped to the canonical ruff-formatted source; `install.windows.sh` added as the Git Bash/MSYS install route; CI gains a `bash -n` gate for it; economy validation receipt rebound to the release head.
+
 ## [0.1.3] - 2026-10-20
 
 ### Changed

{platformforge-0.1.3 → platformforge-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: platformforge
-Version: 0.1.3
+Version: 0.1.4
 Summary: Agentic Platform Engineering intelligence platform — deterministic, offline-first, evidence-first
 Project-URL: Homepage, https://github.com/EdgarSocrates98/platform-forge
 Project-URL: Repository, https://github.com/EdgarSocrates98/platform-forge

{platformforge-0.1.3 → platformforge-0.1.4}/docs/economy-parity/VALIDATION-RECEIPT.json

@@ -11,75 +11,75 @@
     "economy-agentic": {
       "ok": true,
       "reproduce": "pytest -q tests/test_economy_agents_waste.py tests/test_economy_evals.py -k uniqueness or debate or duplication or fanout or waste or stagnant",
-      "seconds": 0.37
+      "seconds": 0.88
     },
     "economy-budget": {
       "ok": true,
       "reproduce": "pytest -q tests/test_economy_contracts.py -k budget or limit or protected or dimension",
-      "seconds": 0.28
+      "seconds": 0.71
     },
     "economy-cache": {
       "ok": true,
       "reproduce": "pytest -q tests/test_economy_cache.py",
-      "seconds": 0.4
+      "seconds": 1.03
     },
     "economy-closure": {
       "ok": true,
       "reproduce": "python -c import sys\nfrom pathlib import Path\nreq = {'docs/economy-parity/FINAL-REPORT.md':\n         ['validated_sha', 'remote_ci', 'known gap'],\n       'docs/economy-parity/FINAL-MATRIX.md':\n         ['validated', 'externally-unverified'],\n       'docs/economy-parity/ECONOMY-BENCHMARKS.md':\n         ['Control Plane Overhead', 'End-to-End'],\n       'docs/economy/ROUTING.md':\n         ['decide', 'advisory'],\n       'docs/economy-parity/POLISH-BASELINE.md': ['drift']}\nbad = []\nfor f, needles in req.items():\n    p = Path(f)\n    if not p.is_file(): bad.append(('missing', f)); continue\n    txt = p.read_text()\n    for n in needles:\n        if n not in txt: bad.append((f, n))\nm = Path('docs/economy-parity/FINAL-MATRIX.md').read_text()\nif '\\n' + '|' in m and ' fully-production' in m:\n    bad.append(('matrix', 'overclaimed status'))\nif bad: print(bad); sys.exit(1)\nprint('closure docs coherent')\n && pytest -q tests/test_economy_closure.py",
-      "seconds": 0.41
+      "seconds": 0.71
     },
     "economy-context": {
       "ok": true,
       "reproduce": "pytest -q tests/test_economy_gateway.py -k TestGateway or TestLazy or TestRole or Suff",
-      "seconds": 0.31
+      "seconds": 0.53
     },
     "economy-contracts": {
       "ok": true,
       "reproduce": "pytest -q tests/test_economy_contracts.py tests/test_economy_v2.py",
-      "seconds": 0.48
+      "seconds": 0.86
     },
     "economy-evals": {
       "ok": true,
       "reproduce": "pytest -q tests/test_economy_evals.py",
-      "seconds": 0.37
+      "seconds": 0.68
     },
     "economy-qpt": {
       "ok": true,
       "reproduce": "pytest -q tests/test_qpt_v2.py tests/test_economy_fleet_qpt.py",
-      "seconds": 0.95
+      "seconds": 2.03
     },
     "economy-receipt": {
       "ok": true,
       "reproduce": "python -c import json, re, subprocess, sys\nfrom pathlib import Path\nsys.path.insert(0, 'scripts')\nimport validate as V\np = Path(V.ECONOMY_RECEIPT_PATH)\nif not p.is_file():\n    print('missing receipt:', p); sys.exit(1)\nr = json.loads(p.read_text())\nbad = []\nif r.get('schema') != V.ECONOMY_RECEIPT_SCHEMA:\n    bad.append(('schema', r.get('schema')))\nvs = r.get('validated_sha') or ''\nok_sha = subprocess.run(['git','cat-file','-e',\n    vs + '^{commit}'], capture_output=True).returncode == 0\nif not ok_sha: bad.append(('validated_sha-not-a-commit', vs))\nhead = subprocess.run(['git','rev-parse','HEAD'],\n    capture_output=True, text=True).stdout.strip()\n# PR merge ref: HEAD^2 is the pushed branch tip \u2014 the Option-A\n# pair (functional commit + receipt commit) sits one level down.\nhead2 = subprocess.run(['git','rev-parse','HEAD^2'],\n    capture_output=True, text=True).stdout.strip()\nbase = head2 if __import__('re').fullmatch(r'[0-9a-f]{40}', head2) else head\nhead1 = subprocess.run(['git','rev-parse', base + '~1'],\n    capture_output=True, text=True).stdout.strip()\nif vs not in (base, head1):\n    bad.append(('validated_sha-stale', vs, head))\ncanon = set(V._economy_gate_names())\nextra = set(r.get('gates', {})) - canon\nif extra: bad.append(('noncanonical-gates', sorted(extra)))\npat = re.compile('tests/' + r'\\S+' + r'\\.py')\nfor g, e in r.get('gates', {}).items():\n    for t in pat.findall(e.get('reproduce') or ''):\n        if not Path(t).is_file():\n            bad.append(('dead-reproduce-path', g, t))\nif r.get('verdict') not in ('validated', 'failed'):\n    bad.append(('verdict', r.get('verdict')))\nif bad: print(bad); sys.exit(1)\nprint('receipt coherent:', len(r['gates']), 'gates,',\n      'sha bound')\n",
-      "seconds": 0.04
+      "seconds": 0.07
     },
     "economy-reconcile": {
       "ok": true,
       "reproduce": "pytest -q tests/test_economy_gateway.py tests/test_economy_evals.py -k reconcil or mismatch or unobserved",
-      "seconds": 0.35
+      "seconds": 0.7
     },
     "economy-resume": {
       "ok": true,
       "reproduce": "pytest -q tests/test_economy_gateway.py -k resume or checkpoint",
-      "seconds": 0.28
+      "seconds": 0.7
     },
     "economy-routing": {
       "ok": true,
       "reproduce": "pytest -q tests/test_economy_evals.py -k routing or profile or champion or simple_task",
-      "seconds": 0.32
+      "seconds": 0.82
     },
     "economy-surface": {
       "ok": true,
       "reproduce": "python -c import subprocess, sys\ncmds = [\n ['platformforge','economy','doctor'],\n ['platformforge','economy','checkpoint','--run-id','gate',\n  '--spent','{\"tokens\":1}'],\n ['platformforge','economy','resume','--run-id','gate'],\n ['platformforge','economy','reconcile',\n  '--planned','{\"tokens\":1}','--observed','{\"tokens\":2}'],\n ['platformforge','economy','explain','--run-id','gate'],\n ['platformforge','cache','stats'],\n ['platformforge','cache','gc'],\n ['platformforge','context','capsule','--task','t',\n  '--facts','[{\"fact_id\":\"f\"}]'],\n ['platformforge','context','gc'],\n ['platformforge','routing','explain','--signal','{}'],\n ['platformforge','routing','compare',\n  '--champion','{}','--challenger','{}'],\n]\nfor c in cmds:\n    r = subprocess.run(c, capture_output=True)\n    if r.returncode not in (0, 2):\n        print('FAIL', c, r.returncode, r.stderr[-300:])\n        sys.exit(1)\nprint('all economy verbs respond')\n",
-      "seconds": 1.63
+      "seconds": 3.65
     },
     "economy-verification": {
       "ok": true,
       "reproduce": "pytest -q tests/test_economy_pricing_verify.py",
-      "seconds": 0.31
+      "seconds": 0.78
     }
   },
-  "generated_at": "2026-10-20T07:36:57Z",
+  "generated_at": "2026-10-20T14:25:20Z",
   "kind": "platformforge/economy-validation-receipt/1",
   "known_gaps": [
     "real provider pricing catalog not bundled (declared-rates engine only, by design)",
@@ -93,7 +93,7 @@
   "remote_ci": "not independently verified",
   "schema": "platformforge/economy-validation-receipt/v1",
   "spec": "prompt_evo_economy.md",
-  "validated_sha": "23a613b7de67e0cfc9300e1a4f621c55827f63d5",
+  "validated_sha": "b94d5ed481cd7ad18f5b21d710bda9af0ea3337b",
   "validator": "scripts/validate.py",
   "validator_version": "economy-validation-receipt/v1",
   "verdict": "validated"

{platformforge-0.1.3 → platformforge-0.1.4}/docs/installation/account-installation.md

@@ -4,6 +4,6 @@ Run `install.sh` (POSIX) or `install.ps1` (Windows) from this checkout. Installe
 
 Published variables use prefix `PLATFORM_FORGE`: `HOME`, `INSTALL_ROOT`, `VENV`, `PYTHON`, `CLI`, and `LAUNCHER`. Underscores are canonical because POSIX shells reject hyphens. Windows also receives aliases such as `PLATFORM-FORGE-HOME`, without administrator permission.
 
-POSIX installer writes `~/.config/forjas/env.sh`; open a new shell or run `source ~/.config/forjas/env.sh`. Windows processes opened after installation receive HKCU variables. Under Windows Git Bash, `install.sh` writes both HKCU variables and this Bash environment file; reload with `source ~/.config/forjas/env.sh`.
+POSIX installer writes `~/.config/forjas/env.sh`; open a new shell or run `source ~/.config/forjas/env.sh`. Windows processes opened after installation receive HKCU variables. Under Windows Git Bash, `install.sh` writes both HKCU variables and this Bash environment file; reload with `source ~/.config/forjas/env.sh`. When PowerShell is unavailable or blocked by policy, `install.windows.sh` is the dedicated Git Bash route — it runs the same shared bootstrap and never spawns `powershell.exe`/`pwsh`.
 
 `setup.sh`/`setup.ps1` remains compatibility mode. The Forge doctor and Portal validate runtime paths while never reading credentials.

platformforge-0.1.4/install.windows.sh

@@ -0,0 +1,156 @@
+#!/usr/bin/env bash
+# Forge account install — Windows Git Bash route (MSYS2 / Git for Windows).
+#
+# Thin adapter over scripts/forge_bootstrap.py — the SAME shared Python
+# bootstrap install.sh and install.ps1 exec. Nothing here reimplements a
+# pipeline stage: env discovery → python resolution → venv → runtime →
+# launcher → HKCU + Git Bash env.sh persistence → InstallReceipt → smoke
+# verify all live in the bootstrap; this script only picks the
+# interpreter, invokes it and surfaces FORGE-* refusal codes.
+#
+# Primary target: Git Bash. On a non-MSYS POSIX shell the script still
+# runs (documented decision — the shared bootstrap is platform-agnostic)
+# but install.sh stays the canonical POSIX route and the script says so.
+# It NEVER spawns powershell.exe/pwsh — PowerShell is not a fallback on
+# this route; a shell that is not bash refuses FORGE-SHELL-UNAVAILABLE.
+#
+# CRLF: keep LF endings. A checkout cloned with core.autocrlf=true can
+# hand bash a CRLF file it cannot parse (the \r lands inside tokens) —
+# repair a converted copy once with:  sed -i 's/\r$//' install.windows.sh
+if [ -z "${BASH_VERSION:-}" ]; then
+  echo "install.windows.sh: FORGE-SHELL-UNAVAILABLE — esta rota exige bash (Git Bash); a shell atual nao e bash" >&2
+  echo "  remedy: run 'bash install.windows.sh' inside Git Bash, or use install.ps1 under PowerShell" >&2
+  exit 2
+fi
+set -euo pipefail
+
+_forge_is_sourced=0
+if [[ "${BASH_SOURCE[0]}" != "$0" ]]; then
+  _forge_is_sourced=1
+fi
+_forge_original_dir=$PWD
+_forge_root="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd -P)"
+cd "$_forge_root"
+
+_forge_is_git_bash=0
+case "${MSYSTEM:-}:${OSTYPE:-}" in
+  *MSYS*|*MINGW*|*UCRT*|*CYGWIN*) _forge_is_git_bash=1 ;;
+  *)
+    # Tolerated, documented (lf-0018): the shared bootstrap is
+    # platform-agnostic so a stray POSIX invocation still works — but
+    # install.sh is the canonical POSIX route and we say so.
+    echo "install.windows.sh: esta e a rota Windows Git Bash; em POSIX o caminho canonico e ./install.sh — continuando (mesmo bootstrap compartilhado)" >&2
+    echo "install.windows.sh: this is the Windows Git Bash route; on POSIX the canonical route is ./install.sh — continuing (same shared bootstrap)" >&2
+    ;;
+esac
+_forge_dry_run=0
+for arg in "$@"; do
+  if [ "$arg" = "--dry-run" ]; then _forge_dry_run=1; break; fi
+done
+
+# Interpreter selection, same priority as the lf-0017 pipeline:
+# --python flag > FORGE_PYTHON > PATH scan (python3|python|py -3).
+_forge_python_arg=""
+_forge_prev=""
+for arg in "$@"; do
+  if [ "$_forge_prev" = "--python" ]; then _forge_python_arg="$arg"; fi
+  case "$arg" in
+    --python=*) _forge_python_arg="${arg#--python=}" ;;
+  esac
+  _forge_prev="$arg"
+done
+
+PY=""
+PY_ARGS=()
+if [ -n "$_forge_python_arg" ]; then
+  PY="$_forge_python_arg"
+elif [ -n "${FORGE_PYTHON:-}" ]; then
+  PY="$FORGE_PYTHON"
+fi
+if [ -n "$PY" ]; then
+  # Intentional word-split: FORGE_PYTHON/--python may carry an
+  # invocation ("py -3.11") — the bootstrap validates it independently
+  # (FORGE_PYTHON reaches find_python via the environment itself).
+  # shellcheck disable=SC2206
+  _forge_py_argv=($PY)
+  PY="${_forge_py_argv[0]}"
+  PY_ARGS=("${_forge_py_argv[@]:1}")
+else
+  for candidate in python3 python py; do
+    if command -v "$candidate" >/dev/null 2>&1; then
+      PY="$(command -v "$candidate")"
+      case "$(basename -- "$PY")" in
+        py|py.exe) PY_ARGS=(-3) ;;
+      esac
+      break
+    fi
+  done
+fi
+if [ -z "$PY" ]; then
+  echo "install.windows.sh: FORGE-PYTHON-NOT-FOUND — nenhum interpretador em PATH (precisa >=3.10)" >&2
+  echo "  remedio: instale Python e reabra o Git Bash, ou aponte FORGE_PYTHON=<caminho/python.exe>, ou rode ./install.windows.sh --python <exe>" >&2
+  echo "  remedy: install Python and reopen Git Bash, or set FORGE_PYTHON=<python.exe path>, or run ./install.windows.sh --python <exe>" >&2
+  cd "$_forge_original_dir"
+  if [ "$_forge_is_sourced" -eq 1 ]; then return 2; fi
+  exit 2
+fi
+if ! command -v "$PY" >/dev/null 2>&1 && [ ! -x "$PY" ]; then
+  echo "install.windows.sh: FORGE-PYTHON-UNEXECUTABLE — o interpretador apontado nao executa: $PY" >&2
+  echo "  remedio: corrija --python/FORGE_PYTHON ou remova a variavel para a varredura de PATH" >&2
+  echo "  remedy: fix --python/FORGE_PYTHON or unset it to fall back to the PATH scan" >&2
+  cd "$_forge_original_dir"
+  if [ "$_forge_is_sourced" -eq 1 ]; then return 2; fi
+  exit 2
+fi
+
+ARGS=(--persist-env --allow-download "$@")
+_forge_log="${TMPDIR:-${TMP:-/tmp}}/forge-install-windows.$$.log"
+status=0
+if command -v tee >/dev/null 2>&1; then
+  # tee keeps live output AND lets us lift the FORGE-* kind from the
+  # bootstrap's JSON report on failure.
+  "$PY" "${PY_ARGS[@]}" scripts/forge_bootstrap.py "${ARGS[@]}" 2>&1 | tee "$_forge_log" || status=${PIPESTATUS[0]}
+else
+  "$PY" "${PY_ARGS[@]}" scripts/forge_bootstrap.py "${ARGS[@]}" 2>&1 || status=$?
+fi
+
+if [ "$status" -eq 0 ]; then
+  rm -f "$_forge_log"
+  env_file="${XDG_CONFIG_HOME:-$HOME/.config}/forjas/env.sh"
+  if [ "$_forge_dry_run" -eq 1 ]; then
+    echo "Install plan complete. No files, variables or registry entries were written."
+  elif [ "$_forge_is_git_bash" -eq 1 ]; then
+    echo "Install complete. Windows user variables saved in HKCU\Environment and Git Bash environment saved in: $env_file"
+    echo "Reload current Git Bash with: source '$env_file'"
+  else
+    echo "Install complete. Open a new shell or run: source '$env_file'"
+  fi
+  if [ "$_forge_is_sourced" -eq 1 ] && [ -f "$env_file" ]; then
+    # A sourced installer can update its caller; an executed child cannot.
+    # shellcheck disable=SC1090
+    . "$env_file"
+  fi
+else
+  _forge_kind=""
+  _forge_detail=""
+  if [ -f "$_forge_log" ]; then
+    _forge_kind="$(sed -n 's/.*"kind"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$_forge_log" | tail -n 1)"
+    _forge_detail="$(sed -n 's/.*"detail"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/p' "$_forge_log" | tail -n 1)"
+  fi
+  rm -f "$_forge_log"
+  if [ -n "$_forge_kind" ]; then
+    echo "install.windows.sh: ${_forge_kind} — o bootstrap recusou: ${_forge_detail:-ver o relatorio JSON acima}" >&2
+    echo "install.windows.sh: ${_forge_kind} — bootstrap refused: ${_forge_detail:-see the JSON report above}" >&2
+  else
+    # Bootstrap crashed without a named refusal (traceback, no JSON).
+    echo "install.windows.sh: FORGE-INSTALL-BOOTSTRAP-FAILED — scripts/forge_bootstrap.py saiu com codigo $status sem recusa nomeada" >&2
+    echo "install.windows.sh: FORGE-INSTALL-BOOTSTRAP-FAILED — scripts/forge_bootstrap.py exited $status with no named refusal" >&2
+  fi
+  echo "  remedio: corrija a causa indicada pelo codigo FORGE-* e reexecute ./install.windows.sh; o receipt fica em ~/.forge/installations/" >&2
+  echo "  remedy: fix the cause named by the FORGE-* code and re-run ./install.windows.sh; the receipt lives under ~/.forge/installations/" >&2
+fi
+cd "$_forge_original_dir"
+if [ "$_forge_is_sourced" -eq 1 ]; then
+  return "$status"
+fi
+exit "$status"

{platformforge-0.1.3 → platformforge-0.1.4}/platformforge/__init__.py

@@ -4,4 +4,4 @@ Deterministic-first, offline-first, evidence-first. The core never imports
 LLM SDKs, cloud SDKs, or MCP — those live behind optional adapters.
 """
 
-__version__ = "0.1.3"
+__version__ = "0.1.4"

{platformforge-0.1.3 → platformforge-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "platformforge"
-version = "0.1.3"
+version = "0.1.4"
 description = "Agentic Platform Engineering intelligence platform — deterministic, offline-first, evidence-first"
 readme = "README.md"
 license = { file = "LICENSE" }