@amg555/frameforge-mcp 2.7.6 → 2.7.8

package/.agent/skills/gstack-setup-gbrain/sections/engine-remediation.md

@@ -1,71 +0,0 @@
-<!-- AUTO-GENERATED from engine-remediation.md.tmpl — do not edit directly -->
-<!-- Regenerate: bun run gen:skill-docs -->
-### Step 1.5 remediation: broken-engine AskUserQuestion + repair branches
-
-The user has a non-working local engine (for example, `~/.gbrain/config.json`
-points at a dead Postgres URL). Fire a targeted AskUserQuestion BEFORE Step 2:
-
-> D# — Your local gbrain engine isn't responding. How do you want to fix it?
-> Project/branch/task: <one-sentence grounding using detected slug + branch>
-> ELI10: gbrain has a config at `~/.gbrain/config.json` but the engine it points
-> at isn't reachable. That could be a transient outage (Postgres container
-> stopped, Tailscale down) OR a stale config you want to abandon. Different
-> remediation for each case.
-> Stakes if we pick wrong: "Switch to PGLite" overwrites your existing config
-> (one-way door if the user actually wanted the broken engine). "Retry" preserves
-> existing state for transient cases.
-> Recommendation: A (Retry) — always try the cheap option first; if engine is
-> just temporarily down it'll come back without any destructive change.
-> Note: options differ in kind, not coverage — no completeness score.
-> A) Retry — re-probe the engine (recommended; ~80ms)
->   ✅ Cheapest test: re-runs `gbrain sources list` to see if engine is back
->   ✅ Zero side effects; existing config preserved
->   ❌ If engine is permanently dead, retries forever; user must choose another option
-> B) Switch to local PGLite (one-way — moves existing config to .bak)
->   ✅ Fastest path to a working local engine if user has abandoned the old one
->   ✅ ~30s; no accounts; private to this machine
->   ❌ Destructive — existing config moved to ~/.gbrain/config.json.gstack-bak-{ts}
-> C) Switch brain mode (continue to Step 2 path picker)
->   ✅ Lets user pick Path 1/2/3/4 to re-init from scratch
->   ✅ Preserves existing config until they explicitly init the new one
->   ❌ Longer flow if user just wants to repair to PGLite
-> D) Quit (do nothing)
->   ✅ No cons — this is a hard-stop choice
->   ❌ N/A
-> Net: A is the right starting move; B/C are explicit destructive paths; D bails.
-
-**If A (Retry)**: re-run `~/.claude/skills/gstack/bin/gstack-gbrain-detect`
-with `GSTACK_DETECT_NO_CACHE=1` (busts the 60s cache). If the new
-`gbrain_local_status` is `ok`, continue to Step 2. If still `broken-db` or
-`broken-config`, fire the same AskUserQuestion again (the user picks again).
-
-**If B (Switch to PGLite)** — execute the rollback-safe init sequence:
-
-```bash
-BACKUP="$HOME/.gbrain/config.json.gstack-bak-$(date +%s)"
-mv "$HOME/.gbrain/config.json" "$BACKUP"
-# gstack default: voyage-code-3 (1024d) when VOYAGE_API_KEY is set — best for
-# code retrieval. Without the key, fall back to gbrain's own auto-selected
-# embedding provider chain (OpenAI 1536d when OPENAI_API_KEY is present, etc.).
-# Never select gbrain's legacy zeroentropyai recipe for a new brain: its hosted
-# API's sunset date (September 4, 2026) has passed; the wireup helper warns existing installs.
-set --  # flags ride the positional params — unquoted $VAR breaks under zsh word-splitting
-if [ -n "${VOYAGE_API_KEY:-}" ]; then
-  set -- --embedding-model voyage:voyage-code-3 --embedding-dimensions 1024
-fi
-if ! gbrain init --pglite --json "$@"; then
-  # Restore on failure
-  mv "$BACKUP" "$HOME/.gbrain/config.json"
-  echo "gbrain init failed. Your previous config was restored at $HOME/.gbrain/config.json." >&2
-  echo "PGLite directory at ~/.gbrain/pglite/ may be in a partial state — \`rm -rf ~/.gbrain/pglite\` if needed before retrying." >&2
-  exit 1
-fi
-echo "Switched to local PGLite. Previous config saved at $BACKUP — review before deleting."
-```
-
-Then jump to Step 5a (MCP registration; the new PGLite engine is registered as
-local-stdio).
-
-**If C (Switch brain mode)**: continue to Step 2's normal path picker.
-
-**If D (Quit)**: STOP the skill cleanly.

package/.agent/skills/gstack-setup-gbrain/sections/engine-remediation.md.tmpl

@@ -1,69 +0,0 @@
-### Step 1.5 remediation: broken-engine AskUserQuestion + repair branches
-
-The user has a non-working local engine (for example, `~/.gbrain/config.json`
-points at a dead Postgres URL). Fire a targeted AskUserQuestion BEFORE Step 2:
-
-> D# — Your local gbrain engine isn't responding. How do you want to fix it?
-> Project/branch/task: <one-sentence grounding using detected slug + branch>
-> ELI10: gbrain has a config at `~/.gbrain/config.json` but the engine it points
-> at isn't reachable. That could be a transient outage (Postgres container
-> stopped, Tailscale down) OR a stale config you want to abandon. Different
-> remediation for each case.
-> Stakes if we pick wrong: "Switch to PGLite" overwrites your existing config
-> (one-way door if the user actually wanted the broken engine). "Retry" preserves
-> existing state for transient cases.
-> Recommendation: A (Retry) — always try the cheap option first; if engine is
-> just temporarily down it'll come back without any destructive change.
-> Note: options differ in kind, not coverage — no completeness score.
-> A) Retry — re-probe the engine (recommended; ~80ms)
->   ✅ Cheapest test: re-runs `gbrain sources list` to see if engine is back
->   ✅ Zero side effects; existing config preserved
->   ❌ If engine is permanently dead, retries forever; user must choose another option
-> B) Switch to local PGLite (one-way — moves existing config to .bak)
->   ✅ Fastest path to a working local engine if user has abandoned the old one
->   ✅ ~30s; no accounts; private to this machine
->   ❌ Destructive — existing config moved to ~/.gbrain/config.json.gstack-bak-{ts}
-> C) Switch brain mode (continue to Step 2 path picker)
->   ✅ Lets user pick Path 1/2/3/4 to re-init from scratch
->   ✅ Preserves existing config until they explicitly init the new one
->   ❌ Longer flow if user just wants to repair to PGLite
-> D) Quit (do nothing)
->   ✅ No cons — this is a hard-stop choice
->   ❌ N/A
-> Net: A is the right starting move; B/C are explicit destructive paths; D bails.
-
-**If A (Retry)**: re-run `~/.claude/skills/gstack/bin/gstack-gbrain-detect`
-with `GSTACK_DETECT_NO_CACHE=1` (busts the 60s cache). If the new
-`gbrain_local_status` is `ok`, continue to Step 2. If still `broken-db` or
-`broken-config`, fire the same AskUserQuestion again (the user picks again).
-
-**If B (Switch to PGLite)** — execute the rollback-safe init sequence:
-
-```bash
-BACKUP="$HOME/.gbrain/config.json.gstack-bak-$(date +%s)"
-mv "$HOME/.gbrain/config.json" "$BACKUP"
-# gstack default: voyage-code-3 (1024d) when VOYAGE_API_KEY is set — best for
-# code retrieval. Without the key, fall back to gbrain's own auto-selected
-# embedding provider chain (OpenAI 1536d when OPENAI_API_KEY is present, etc.).
-# Never select gbrain's legacy zeroentropyai recipe for a new brain: its hosted
-# API's sunset date (September 4, 2026) has passed; the wireup helper warns existing installs.
-set --  # flags ride the positional params — unquoted $VAR breaks under zsh word-splitting
-if [ -n "${VOYAGE_API_KEY:-}" ]; then
-  set -- --embedding-model voyage:voyage-code-3 --embedding-dimensions 1024
-fi
-if ! gbrain init --pglite --json "$@"; then
-  # Restore on failure
-  mv "$BACKUP" "$HOME/.gbrain/config.json"
-  echo "gbrain init failed. Your previous config was restored at $HOME/.gbrain/config.json." >&2
-  echo "PGLite directory at ~/.gbrain/pglite/ may be in a partial state — \`rm -rf ~/.gbrain/pglite\` if needed before retrying." >&2
-  exit 1
-fi
-echo "Switched to local PGLite. Previous config saved at $BACKUP — review before deleting."
-```
-
-Then jump to Step 5a (MCP registration; the new PGLite engine is registered as
-local-stdio).
-
-**If C (Switch brain mode)**: continue to Step 2's normal path picker.
-
-**If D (Quit)**: STOP the skill cleanly.

package/.agent/skills/gstack-setup-gbrain/sections/manifest.json

@@ -1,32 +0,0 @@
-{
-  "$schema": "https://gstack.dev/schemas/section-manifest.json",
-  "skill": "setup-gbrain",
-  "version": 1,
-  "note": "PASSIVE registry (v2 plan T9 / CM2). Fields are IDs, file paths, human titles, and human-readable trigger text ONLY. The skeleton's detect (Step 1) + path picker (Step 2) are the ONLY places that decide WHEN a section is read (the install routes are branch-exclusive — at most one init route runs per invocation); required section reads are checked by test/carve-section-loading-setup-gbrain.test.ts. No machine predicate here — see docs/designs/v2_PLAN.md:663.",
-  "sections": [
-    {
-      "id": "engine-remediation",
-      "file": "engine-remediation.md",
-      "title": "Step 1.5: broken-local-engine remediation (retry / switch-to-PGLite / re-init AUQ, rollback-safe)",
-      "trigger": "running the Step 1.5 broken-engine remediation — Step 1's detect returned `gbrain_local_status` of `broken-db` or `broken-config` and no shortcut flag was passed"
-    },
-    {
-      "id": "brain-init",
-      "file": "brain-init.md",
-      "title": "Step 4: initialize the brain — per-path init procedures (Paths 1, 2a, 2b, 3, 4, Switch)",
-      "trigger": "initializing the brain in Step 4 — run ONLY the procedure for the path picked in Step 2 (Paths 1/2a/2b/3/4 or Switch; also holds the PAT scope disclosure that `--cleanup-orphans` re-uses)"
-    },
-    {
-      "id": "transcript-gate",
-      "file": "transcript-gate.md",
-      "title": "Step 7.5: transcript ingest consent (has-check, probe, recent/all/off AskUserQuestion)",
-      "trigger": "running the Step 7.5 transcript & memory ingest gate on Paths 1, 2a, 2b, or 3 (Path 4 skips this section entirely — see the skeleton's skip note)"
-    },
-    {
-      "id": "claude-md-persist",
-      "file": "claude-md-persist.md",
-      "title": "Step 8: persist the GBrain Configuration block in CLAUDE.md",
-      "trigger": "persisting the Step 8 `## GBrain Configuration` block to CLAUDE.md"
-    }
-  ]
-}

package/.agent/skills/gstack-setup-gbrain/sections/transcript-gate.md

@@ -1,105 +0,0 @@
-<!-- AUTO-GENERATED from transcript-gate.md.tmpl — do not edit directly -->
-<!-- Regenerate: bun run gen:skill-docs -->
-After memory sync is wired (Step 7) but before persisting the CLAUDE.md
-config (Step 8), ask whether this machine's coding-agent session
-transcripts may go into gbrain. Curated `~/.gstack/` artifacts (learnings,
-timeline, plans, designs, retros) sync whatever the answer; this question
-covers transcripts only. Transcripts are ingested only after the user picks
-`recent`, `all` or `new` (only sessions that start from now on).
-
-Check whether the user already chose. The gate keys on `has`, because `get`
-prints the `off` default for a key that was never set:
-```bash
-_TIM=$(~/.claude/skills/gstack/bin/gstack-config get transcript_ingest_mode 2>/dev/null || true)
-if ~/.claude/skills/gstack/bin/gstack-config has transcript_ingest_mode; then
-  _T='[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]t[0-9][0-9]:[0-9][0-9]:[0-9][0-9]z'
-  case "$(printf '%s' "$_TIM" | tr -d '[:space:]' | tr '[:upper:]' '[:lower:]')" in
-    recent|all|off|recent+repos|all+repos|new@$_T|new@$_T+repos)
-      echo "TRANSCRIPT_MODE: $_TIM (repos: $(~/.claude/skills/gstack/bin/gstack-config get transcript_repos 2>/dev/null || true))" ;;
-    *) echo "TRANSCRIPT_MODE: ask (stored value '$_TIM' is not recognized by this version)" ;;
-  esac
-else
-  echo "TRANSCRIPT_MODE: ask (not set)"
-fi
-```
-
-- `TRANSCRIPT_MODE:` with a value (`recent`, `all`, `off`, `new@<time>`,
-  any of them with `+repos`): the user already chose. Do not ask again;
-  continue to Step 8.
-- `TRANSCRIPT_MODE: ask`: ask once, below. With `SESSION_KIND: spawned` or
-  `headless`, do not ask and do not store a value. Consent is never
-  auto-chosen; leave the key unset (transcripts stay skipped) and report
-  that the next interactive `/sync-gbrain` will ask.
-
-Size the question with two probes. `--sources transcript` makes the probe
-count transcripts even though none are consented yet:
-```bash
-bun run ~/.claude/skills/gstack/bin/gstack-memory-ingest.ts --probe --sources transcript
-bun run ~/.claude/skills/gstack/bin/gstack-memory-ingest.ts --probe --sources transcript --all-history
-```
-Read `Total files in window`, `Total bytes` and the estimate from each.
-
-**No transcripts found** (both probes report 0): ask yes/no instead:
-
-> "Ingest coding-agent sessions as they appear?"
-
-Yes means `recent` (then ask the scope question below); No stores `off`.
-
-**Otherwise**, AskUserQuestion with the counts. Name both session sources
-and the destination brain from Step 4: the user's Supabase brain (Paths 1,
-2a, 2b) or the local PGLite brain on this machine (Path 3).
-
-> "Found <N_recent> Claude Code and Codex sessions from the last 90 days
-> (<N_all> in all history, <bytes>) across the projects on this machine
-> that your repo policy allows. Ingest them into your <Supabase | local
-> PGLite> brain?
->
-> What you get: gstack skills load recent context from your past sessions,
-> so the agent finds your prior work without you describing it, and you
-> can ask 'what was I doing on day X'. Per-session pages are searchable,
-> taggable and deletable. Secret scanning runs before any push.
->
-> What stays the same: nothing leaves this machine unless brain sync is
-> enabled (Step 7). Per-repo trust policies still apply. The first full
-> sync can take a while on a large history (estimate: <est>); skills stay
-> usable while it runs.
->
-> Multi-machine note: with brain sync enabled, transcript pages sync across
-> your machines. Deleting a page later removes it from gbrain, but git
-> history keeps it in earlier commits. Use `gstack-transcript-prune` to
-> delete in bulk, and `git filter-repo` on the brain remote to remove it
-> from history."
-
-Options:
-- A) Yes, last 90 days (`recent`)
-- B) Yes, all history (`all`)
-- C) Yes, only new sessions starting now (`new`)
-- E) No, never ingest transcripts (`off`)
-
-On any yes, ask a second, separate question: "Which repos' sessions?"
-A) every project repo your repo policy allows, or B) only this repo (offer
-B only when `git remote get-url origin` succeeds here). Store nothing until
-both answers are known; if the user cancels in between, store nothing.
-Then store the scope, then the mode value (never the letter; `new` stores
-`new@` plus the current UTC time):
-```bash
-~/.claude/skills/gstack/bin/gstack-config set transcript_repos "$(git remote get-url origin)"  # only this repo
-~/.claude/skills/gstack/bin/gstack-config unset transcript_repos                                 # every repo
-~/.claude/skills/gstack/bin/gstack-config set transcript_ingest_mode <recent|all|off|new@$(date -u +%Y-%m-%dT%H:%M:%SZ)>
-bun run ~/.claude/skills/gstack/lib/transcript-consent.ts --describe
-```
-Tell the user the `--describe` line: what will be ingested, in words.
-
-For `recent`, `all` or `new@…`, run the first sync now:
-```bash
-bun run ~/.claude/skills/gstack/bin/gstack-gbrain-sync.ts --full --no-brain-sync
-```
-(`--no-brain-sync` because Step 7 already wired that path; this runs the
-code import and memory ingest stages, and `all` walks the full history.)
-For `off`, run nothing here; other memory still syncs on the next
-`/sync-gbrain`.
-
-New transcripts are ingested on the next `/sync-gbrain` run. Nothing at
-skill start ingests them.
-
-Reference doc for users: `setup-gbrain/memory.md#transcripts`.

package/.agent/skills/gstack-setup-gbrain/sections/transcript-gate.md.tmpl

@@ -1,103 +0,0 @@
-After memory sync is wired (Step 7) but before persisting the CLAUDE.md
-config (Step 8), ask whether this machine's coding-agent session
-transcripts may go into gbrain. Curated `~/.gstack/` artifacts (learnings,
-timeline, plans, designs, retros) sync whatever the answer; this question
-covers transcripts only. Transcripts are ingested only after the user picks
-`recent`, `all` or `new` (only sessions that start from now on).
-
-Check whether the user already chose. The gate keys on `has`, because `get`
-prints the `off` default for a key that was never set:
-```bash
-_TIM=$(~/.claude/skills/gstack/bin/gstack-config get transcript_ingest_mode 2>/dev/null || true)
-if ~/.claude/skills/gstack/bin/gstack-config has transcript_ingest_mode; then
-  _T='[0-9][0-9][0-9][0-9]-[0-9][0-9]-[0-9][0-9]t[0-9][0-9]:[0-9][0-9]:[0-9][0-9]z'
-  case "$(printf '%s' "$_TIM" | tr -d '[:space:]' | tr '[:upper:]' '[:lower:]')" in
-    recent|all|off|recent+repos|all+repos|new@$_T|new@$_T+repos)
-      echo "TRANSCRIPT_MODE: $_TIM (repos: $(~/.claude/skills/gstack/bin/gstack-config get transcript_repos 2>/dev/null || true))" ;;
-    *) echo "TRANSCRIPT_MODE: ask (stored value '$_TIM' is not recognized by this version)" ;;
-  esac
-else
-  echo "TRANSCRIPT_MODE: ask (not set)"
-fi
-```
-
-- `TRANSCRIPT_MODE:` with a value (`recent`, `all`, `off`, `new@<time>`,
-  any of them with `+repos`): the user already chose. Do not ask again;
-  continue to Step 8.
-- `TRANSCRIPT_MODE: ask`: ask once, below. With `SESSION_KIND: spawned` or
-  `headless`, do not ask and do not store a value. Consent is never
-  auto-chosen; leave the key unset (transcripts stay skipped) and report
-  that the next interactive `/sync-gbrain` will ask.
-
-Size the question with two probes. `--sources transcript` makes the probe
-count transcripts even though none are consented yet:
-```bash
-bun run ~/.claude/skills/gstack/bin/gstack-memory-ingest.ts --probe --sources transcript
-bun run ~/.claude/skills/gstack/bin/gstack-memory-ingest.ts --probe --sources transcript --all-history
-```
-Read `Total files in window`, `Total bytes` and the estimate from each.
-
-**No transcripts found** (both probes report 0): ask yes/no instead:
-
-> "Ingest coding-agent sessions as they appear?"
-
-Yes means `recent` (then ask the scope question below); No stores `off`.
-
-**Otherwise**, AskUserQuestion with the counts. Name both session sources
-and the destination brain from Step 4: the user's Supabase brain (Paths 1,
-2a, 2b) or the local PGLite brain on this machine (Path 3).
-
-> "Found <N_recent> Claude Code and Codex sessions from the last 90 days
-> (<N_all> in all history, <bytes>) across the projects on this machine
-> that your repo policy allows. Ingest them into your <Supabase | local
-> PGLite> brain?
->
-> What you get: gstack skills load recent context from your past sessions,
-> so the agent finds your prior work without you describing it, and you
-> can ask 'what was I doing on day X'. Per-session pages are searchable,
-> taggable and deletable. Secret scanning runs before any push.
->
-> What stays the same: nothing leaves this machine unless brain sync is
-> enabled (Step 7). Per-repo trust policies still apply. The first full
-> sync can take a while on a large history (estimate: <est>); skills stay
-> usable while it runs.
->
-> Multi-machine note: with brain sync enabled, transcript pages sync across
-> your machines. Deleting a page later removes it from gbrain, but git
-> history keeps it in earlier commits. Use `gstack-transcript-prune` to
-> delete in bulk, and `git filter-repo` on the brain remote to remove it
-> from history."
-
-Options:
-- A) Yes, last 90 days (`recent`)
-- B) Yes, all history (`all`)
-- C) Yes, only new sessions starting now (`new`)
-- E) No, never ingest transcripts (`off`)
-
-On any yes, ask a second, separate question: "Which repos' sessions?"
-A) every project repo your repo policy allows, or B) only this repo (offer
-B only when `git remote get-url origin` succeeds here). Store nothing until
-both answers are known; if the user cancels in between, store nothing.
-Then store the scope, then the mode value (never the letter; `new` stores
-`new@` plus the current UTC time):
-```bash
-~/.claude/skills/gstack/bin/gstack-config set transcript_repos "$(git remote get-url origin)"  # only this repo
-~/.claude/skills/gstack/bin/gstack-config unset transcript_repos                                 # every repo
-~/.claude/skills/gstack/bin/gstack-config set transcript_ingest_mode <recent|all|off|new@$(date -u +%Y-%m-%dT%H:%M:%SZ)>
-bun run ~/.claude/skills/gstack/lib/transcript-consent.ts --describe
-```
-Tell the user the `--describe` line: what will be ingested, in words.
-
-For `recent`, `all` or `new@…`, run the first sync now:
-```bash
-bun run ~/.claude/skills/gstack/bin/gstack-gbrain-sync.ts --full --no-brain-sync
-```
-(`--no-brain-sync` because Step 7 already wired that path; this runs the
-code import and memory ingest stages, and `all` walks the full history.)
-For `off`, run nothing here; other memory still syncs on the next
-`/sync-gbrain`.
-
-New transcripts are ingested on the next `/sync-gbrain` run. Nothing at
-skill start ingests them.
-
-Reference doc for users: `setup-gbrain/memory.md#transcripts`.