Skip to content

Commit fcfabda

Browse files
TheWayWithinclaude
andcommitted
feat: local browser-based register editor (addresses the nano/editing wall, EF-ISS-4)
UAT dry run proved a non-technical owner cannot edit estate.yaml in a terminal editor (nano was a hard wall) — the dry-run evidence SPEC-v1 §9 said the parked GUI decision was waiting for. First response: - web/editor.html — a single, local, dependency-free page: fill the register as a form (dropdowns for every enum, plain-English help, auto IDs, contacts + documents), Save writes a valid estate.yaml. Runs entirely in the browser: no server, no network, nothing sent anywhere; holds pointers only. Best-effort loader re-opens a register the tool emitted, for editing. - scripts/edit.sh + double-clickable Edit-Executor-File.command to open it without touching the terminal. - README points owners to it as the no-YAML path. The generated YAML was tested against BOTH validator tiers (baseline awk + strict Python/JSON-Schema) with apostrophes, unknown dates, depends_on, transfer/beneficiary, closed assets, contacts and documents — passes clean. Sealing (setup.sh) still uses one Terminal command for now; that wall is the next target. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
1 parent e319a46 commit fcfabda

5 files changed

Lines changed: 434 additions & 0 deletions

File tree

Edit-Executor-File.command

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
#!/bin/sh
2+
# Double-click me (macOS) to fill in your Executor File as a browser form.
3+
cd "$(dirname "$0")" || exit 1
4+
exec scripts/edit.sh

ISSUES.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
# executor-file — Issue & Project Register
2+
3+
**This is the single source of truth for what is open in this repo.** One row per
4+
issue/project. Detail lives in the linked doc; this file is the index the Mission
5+
Control reconcile (`repo-reconcile.py`) reads and mirrors to the cockpit.
6+
7+
## ID convention (collision-safe)
8+
9+
Mission Control owns the bare `ISS-`/`PRJ-`/`T-` namespaces. **Every executor-file ID
10+
carries the `EF-` prefix** so it can never collide with a Mission-Control-native
11+
ID or another repo's. Raise issues here with `python3 ~/shared/scripts/repo-issue.py`.
12+
13+
---
14+
15+
## Open
16+
17+
| ID | Title | Status | Severity | Detail | MC-SYNC |
18+
|----|-------|--------|----------|--------|---------|
19+
| EF-ISS-4 | Editing the register in a terminal editor (nano) is a hard wall for non-technical owners: dry-run tester could not use nano, accidental ^V wrote junk, could not exit. This is the dry-run evidence the parked GUI/editing-interface decision (SPEC-v1 §9) was explicitly waiting for. Needs a humane edit path (GUI or form/web editor) before the tool is usable by its target audience. | Open | critical || pending |
20+
| EF-ISS-3 | Onboarding requires holding instructions across multiple pages — violates the product's own 'you don't have to hold it in your head' principle; non-technical owners should be funnelled to executorfile.com/get-started, not raw GitHub | Open | high || pending |
21+
| EF-ISS-2 | GitHub release page is a dead-end for non-technical users: no 'download this / do this next', assets collapsed under Assets, and competing with GitHub's auto Source-code downloads; install instructions are stranded back on the README (can't be recalled on the release page) | Open | high || pending |
22+
| EF-ISS-1 | README quickstart assumes the repo is already on disk: no download/unpack/cd step for tarball users | Open | low || pending |
23+
24+
## Recently closed
25+
26+
| ID | Title | Status | Commit | Detail |
27+
|----|-------|--------|--------|--------|

README.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,8 @@ cd executor-file
5858

5959
Either way you are now "in the folder" — every command below is typed into that same Terminal window, and the `scripts/...` paths will just work.
6060

61+
**Prefer not to hand-edit a text file?** Double-click **`Edit-Executor-File.command`** in the folder (or run `scripts/edit.sh`) to fill your register in as a form in your browser — dropdowns, plain-English help, no YAML. It runs entirely on your machine, saves `estate.yaml` to your Downloads, and you still seal it once with `scripts/setup.sh`.
62+
6163
**Two small tools to install once** (these do the encryption and the share-splitting; both are free, open-source, and standard):
6264

6365
```bash

scripts/edit.sh

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
#!/bin/sh
2+
# edit.sh — open the friendly register editor in your web browser.
3+
#
4+
# Fill your register in as a form (dropdowns, plain-English help) instead
5+
# of hand-editing YAML. It runs entirely in your browser on this machine:
6+
# no server, no network, nothing sent anywhere. When you click Save it
7+
# writes estate.yaml to your Downloads folder; then seal it once with
8+
# scripts/setup.sh.
9+
#
10+
# Usage: scripts/edit.sh
11+
set -u
12+
DIR=$(cd "$(dirname "$0")/.." && pwd)
13+
PAGE="$DIR/web/editor.html"
14+
[ -f "$PAGE" ] || { echo "error: editor not found at $PAGE" >&2; exit 1; }
15+
echo "Opening the register editor in your browser…"
16+
echo " (it runs locally — nothing you type is sent anywhere)"
17+
if command -v open >/dev/null 2>&1; then open "$PAGE"
18+
elif command -v xdg-open >/dev/null 2>&1; then xdg-open "$PAGE"
19+
else echo "Open this file in your browser: $PAGE"; fi

0 commit comments

Comments
 (0)