From 5c5d6d923a31b1136454f57e129fbce7859d4e5b Mon Sep 17 00:00:00 2001 From: timerloggedout-spec Date: Sat, 1 Aug 2026 08:23:36 -0700 Subject: [PATCH 1/2] docs: deep RECON intel, branch/PR critique, navigation SSOT, refTemplates gap analysis - Add docs/RECON.md: codebase familiarization, critical eval of open PRs/branches, refTemplates nesting gaps (Haven, ICM_fork, missing 15_Reverse_Engineering), proposals for navigation SSOT beyond Entry+HTML - Expand README navigation section (expand-only) to point at CONCEPT_INDEX, TOOL_INDEX, REFERENCE_HUB, METHODOLOGY, replit.md (PR#1), skeleton branch --- README.md | 96 +++++++++++++++++++------- docs/RECON.md | 185 ++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 255 insertions(+), 26 deletions(-) create mode 100644 docs/RECON.md diff --git a/README.md b/README.md index 021af7a5c..a42bddcbb 100644 --- a/README.md +++ b/README.md @@ -12,22 +12,28 @@ It further documents the **live projects and directories currently in the codeba - I compiled a consolidated recovery plan (Option B) and embedded the `refTemplates` snapshot (Option A) in this README. - I created this README in the repo root so it is available as the single recovery cockpit. - **Expansion:** project inventory of directories present on `master` (deepcli, cli-synthegration, termux-multi-agent, archwiz, harmonizer, etc.) is included below so recovery and live code share one map. +- **Navigation:** prefer ArchWiz indices over a two-link “Entry + HTML” pair — see **Navigation SSOT** below and `docs/RECON.md` on `feature/recon-intel-and-nav`. --- -## What I inspected (actions taken) -- Listed and read archwiz/ and workspace/llm_map/ directories and index files. -- Retrieved recent commits touching `refTemplates` and the repository branch list. -- Read `.gitmodules` to identify submodules referenced by the monorepo. -- Extracted backup indicators (.bak files and large JSONL indices) available for restoration. +## Navigation SSOT (better than Entry + HTML alone) -This information was used to run git-diff-style consolidation and create the recovery plan below. +Use this ladder when orienting in the tree. `_Entry+ReadMe.md` and `termux-ecosystem-architecture.html` remain useful but are **not** the primary map. ---- +| Priority | Start here | What you get | +|----------|------------|--------------| +| 1 | `archwiz/TOOL_INDEX.md` | 28 tools / 7 categories — cockpit, forensic, autonomous, verification | +| 2 | `archwiz/CONCEPT_INDEX.md` | Concepts + status (built / reserved / not built) + feature backlog | +| 3 | `archwiz/REFERENCE_HUB.md` | Links to DATA_FLOW_MANIFEST, SYSTEM_MAP, func/llm indices | +| 4 | `archwiz/METHODOLOGY_INDEX.md` | Approaches tried, failures, what stuck | +| 5 | `archwiz/PROCEDURES.md`, `ARCHWIZARD_TASKS.md` | Runbooks and active tasks | +| 6 | `docs/RECON.md` (this RECON) | Branch/PR critique, refTemplates nesting gaps, prioritized proposals | +| 7 | `replit.md` on branch `critical-proposal` (PR #1) | Critical path/config issues and optimization proposals | +| 8 | `_Entry+ReadMe.md` | One-line command → entry table | +| 9 | `termux-ecosystem-architecture.html` | Visual ecosystem diagram | +| 10 | `refTemplates/README_RECOVERY.md` on `recreate/refTemplates-skeleton` | Metadata-only restore policy for refs | -## Live projects & directories (currently available on master) - -Quick entry map (also in `_Entry+ReadMe.md`): +Quick command table (also in `_Entry+ReadMe.md`): | What you want to do | Where you start | |---------------------|-----------------| @@ -36,8 +42,23 @@ Quick entry map (also in `_Entry+ReadMe.md`): | Make a change | `dispatch ` or `agent-shell run ` | | Validate & promote | `validate_promotion.py` → promote | | Rebuild indices | `map-build && map-func && fore` | +| Open cockpit | `python3 archwiz/archwiz.py` | + +--- + +## What I inspected (actions taken) +- Listed and read archwiz/ and workspace/llm_map/ directories and index files. +- Retrieved recent commits touching `refTemplates` and the repository branch list. +- Read `.gitmodules` to identify submodules referenced by the monorepo. +- Extracted backup indicators (.bak files and large JSONL indices) available for restoration. + +This information was used to run git-diff-style consolidation and create the recovery plan below. + +--- + +## Live projects & directories (currently available on master) -Architecture overview: `termux-ecosystem-architecture.html` (Terminal → ArchWiz / Harmonizer / DeepSeek CLI-TUI / Central Mapper / Multi-Agent → DeepSeek API, local cache, workspace). +Architecture overview: `termux-ecosystem-architecture.html` (Terminal → ArchWiz / Harmonizer / DeepSeek CLI-TUI / Central Mapper / Multi-Agent → DeepSeek API, local cache, workspace). Prefer **TOOL_INDEX** + **CONCEPT_INDEX** for tool-level truth. ### Core automation & agents @@ -82,9 +103,9 @@ Related: `synthegration-cli/`, `.synthegration/`. #### `archwiz/` ArchWizard — indexing, provenance, recovery indices, automation cockpit. -- Docs: `ARCHWIZARD_TASKS.md`, `CONCEPT_INDEX.md`, `METHODOLOGY_INDEX.md`, `PROCEDURES.md`, `DATA_FLOW_MANIFEST.md`, `REFERENCE_HUB.md`, etc. -- Operational: pointer/staging indices, restore helpers, listener/poller/autoexec-style components -- Role: dashboard + pipeline control (see architecture HTML) +- Docs: `ARCHWIZARD_TASKS.md`, `CONCEPT_INDEX.md`, `METHODOLOGY_INDEX.md`, `PROCEDURES.md`, `DATA_FLOW_MANIFEST.md`, `REFERENCE_HUB.md`, `TOOL_INDEX.md`, etc. +- Operational: pointer/staging indices, restore helpers, listener/poller/autoexec-style components (**poller/listener = legacy**; canonical path is cache-write → `dispatch_pipeline` — see PR #1 / `replit.md`) +- Role: dashboard + pipeline control ### Harmonizer, multi-AI, swarm @@ -93,7 +114,7 @@ ArchWizard — indexing, provenance, recovery indices, automation cockpit. | `harmonizer-prod_cli/` | Production Harmonizer CLI (unified DeepSeek automation: sessions, export, search, sync) | | `harmony_hub/` | Harmony hub integration | | `multi-ai-cli/` | Multi-model CLI surface | -| `commingle-swarm/` | Swarm / multi-agent commingle setup | +| `commingle-swarm/` | **Template / scavenge-only** external clone — not first-class runtime | | Root scripts | `setup-comingle-swarm.sh`, `upgrade-commingle-swarm.sh`, `deepseek_harmonizer.sh` | ### Projects, exchanges, applied work @@ -125,6 +146,9 @@ ArchWizard — indexing, provenance, recovery indices, automation cockpit. ## refTemplates — last-known directory snapshot (include B) The following is the last-known top-2-level snapshot of `~/refTemplates/` from the last 30 days. Use this as the authoritative reference for restoration. +**On `master` today:** only a stub under `refTemplates/01_Agent_Runtime/`. +**Full metadata skeleton:** branch `recreate/refTemplates-skeleton` (README.md + SOURCE.txt per entry; depth-1 sparse style). See `refTemplates/README_RECOVERY.md` on that branch. + refTemplates/ 01_Agent_Runtime/ frankenterm/ @@ -133,6 +157,7 @@ refTemplates/ orca/ pi_agent_rust/ senpi/ + # also historically: deepcode-cli (pointer removed in consolidation) 02_Memory_Session/ cass_memory_system/ coding_agent_session_search/ @@ -155,6 +180,7 @@ refTemplates/ markdown_web_browser/ source_to_prompt_tui/ toon_rust/ + # nest here: Interpreted-Context-Methdology_fork (currently uncategorized at tree -L 1) 08_Swarm_References/ swarm-ecosystem/ swarms/ @@ -184,12 +210,15 @@ refTemplates/ aadc/ ffa-brackets/ openskill.lua/ + # also historically: assistral (pointer removed) 14_Plain_Files/ approxination.txt ranking_research-concept-_.txt - Haven/ (Android app workspace + build artifacts + docs) - Interpreted-Context-Methdology_fork/ (fork workspace with _core and workspaces) - ...many other subprojects (see repo inventory for full details) + 15_Reverse_Engineering/ # MISSING as category — pointers removed in consolidation; recreate as metadata-only + # AIStudio2API, AIStudioProxy, AIstudioProxyAPI, gemini-cli-api + # UNCATEGORIZED at tree -L 1 (need nesting): + Haven/ → propose 15_Android_Workspaces or 16_Product_Workspaces + Interpreted-Context-Methdology_fork/ → propose under 07_Prompt_Context > Note: Many entries above correspond to external git repositories or local workspaces and were sometimes included as submodules or as nested repositories. **Existing refTemplates were depth-1 selective sparse-checkout of relevant files, with metadata only** — not full recursive checkouts. @@ -226,7 +255,7 @@ I inspected recent commits touching `refTemplates` and surrounding restore commi - `.gitmodules` (current repo content): contains submodule entries for several projects, notably `powerlevel10k` and other project submodules. -Summary: The repo history shows active restoration attempts — multiple commits rehydrated `refTemplates` from a backup commit (d5814d9 referenced). Later consolidation removed some explicit submodule pointers, possibly because content was restored directly or those submodules were intentionally removed. The state on `master` represents the consolidated result of these operations. +Summary: The repo history shows active restoration attempts — multiple commits rehydrated `refTemplates` from a backup commit (d5814d9 referenced). Later consolidation removed some explicit submodule pointers, possibly because content was restored directly or those submodules were intentionally removed. The state on `master` represents the consolidated result of these operations. **Category 15 and several L1 names remain debt** — see `docs/RECON.md` §5. --- @@ -266,15 +295,13 @@ git submodule status 3) Recreate the `refTemplates` tree from git history if needed ```bash -# find commit that contained refTemplates +# Prefer merging metadata from recreate/refTemplates-skeleton rather than full clones git log --all --pretty=format:'%H %ad %s' --date=iso -- refTemplates | head -n 50 -# checkout the tree from a known good commit (replace with the commit sha found) git checkout -- refTemplates -# commit the restored tree if it looks correct git add refTemplates git commit -m "Restore refTemplates from " ``` -If git checkout fails because refTemplates was a submodule pointer, try the backup-restore commits already present (see commits listed above). The repository already contains restore commits; inspect files under refTemplates to confirm content is present. Prefer depth-1 selective sparse-checkout of relevant files (metadata only) rather than full recursive population. +If git checkout fails because refTemplates was a submodule pointer, try the backup-restore commits already present (see commits listed above). Prefer depth-1 selective sparse-checkout of relevant files (metadata only) rather than full recursive population. Nest uncategorized L1 entries (Haven, ICM_fork) and restore **15_Reverse_Engineering** as metadata slots. 4) Use archwiz and llm_map indices to fill gaps - Many indices are present in: `archwiz/pointer_index.json`, `archwiz/index_registry.json`, `workspace/llm_map/*_index*.jsonl`. @@ -319,15 +346,31 @@ python3 build_all.py # or the smaller targeted build scripts: build_llm_index. ## Safety & Secrets - The repo includes references to `cookies_2.json` and browser cookie exports; DO NOT commit secrets. If `cookies_2.json` is present locally, ensure it is in `.gitignore`. +- Session stores must not be tracked in Git (see open PR #3 `agent/repository-hygiene`). - Back up large JSONL indices externally before attempting destructive rebuilds. --- +## Open branches & PRs (snapshot 2026-08-01) + +| Item | Note | +|------|------| +| PR #1 `critical-proposal` | Docs: critical eval + roadmap — mergeable | +| PR #2 `timerloggedout-spec-patch-1` | GHA Rust — narrow scope before merge | +| PR #3 `agent/repository-hygiene` (draft) | Untrack session stores — **priority** | +| `recreate/refTemplates-skeleton` | Full metadata tree; merge to master | +| `mistral/fixes-config-security` | config.py + security baseline | +| `vibe/mistralai-vibe-code-wrapper-*` | Mistral CLI + harvester; fix silent dispatch | + +Detail and ranked proposals: **`docs/RECON.md`**. + +--- + ## What I can do next (pick one or more) 1. Run selective submodule / sparse-checkout steps and report results (I can run commands only if you ask me to perform GitHub write operations or environment commands; I can provide exact commands for you to run). 2. Page through archwiz and workspace/llm_map to list every `.bak` file and recommend the highest-confidence restoration candidates. -3. Commit this README into `master` (I am about to do this now). If you want a different branch, tell me. -4. Create an automated PR that applies the recommended recovery script(s) (I can open issues/PRs if you want). +3. Land refTemplates skeleton + category 15 nesting on a dedicated `feature/*` branch. +4. Create follow-up PRs for P0 items in `docs/RECON.md` (dispatch logging, PR #3 hygiene). --- @@ -339,10 +382,11 @@ python3 build_all.py # or the smaller targeted build scripts: build_llm_index. - 65c9f81162fd9a080a4a8aea4f6a0b6ecd2dcd72 — "Complete restore: refTemplates, submodules, and powerlevel10k" - ee1807049fd93d087bc14055b2ae6cbffb5dbf82 — "Add base configs and dotfiles" - ebe3e0ca504cb35ef61832b0b1b1576a1a0d44fb — "Initial monorepo commit..." + - f19716e / 5c6e5e2 / 6ef0e2f — README expand + refTemplates stub restore - Found `.gitmodules` with multiple submodule URLs — use **selective depth-1** updates only when a listed submodule is needed; refTemplates historically used sparse depth-1 checkout with metadata only. - Found evidence that some restored content was then consolidated and had submodule pointers removed in the latest commit; verify that removed submodules are intentionally removed (or re-add them via git submodule add if needed). --- -If you confirm, I will push this README into `master` (the repository's default branch) and then proceed to Option B step 2 (list .bak files and large indices and produce a prioritized file-by-file recovery plan). If you prefer to run commands yourself first, I will provide a runnable script you can execute. +If you confirm further implementation work, use **`feature/*` branches only** (never commit recovery or nav changes straight to `master` without review). See `docs/RECON.md` for the full proposal table. diff --git a/docs/RECON.md b/docs/RECON.md new file mode 100644 index 000000000..99d687b8a --- /dev/null +++ b/docs/RECON.md @@ -0,0 +1,185 @@ +# Deep RECON — Intel, Familiarization, Critical Evaluation & Proposals + +**Date:** 2026-08-01 +**Branch:** `feature/recon-intel-and-nav` +**Scope:** Codebase map, open branches/PRs/commits, refTemplates gaps, navigation SSOT, actionable proposals. + +> Rule of engagement: **expand** existing recovery + inventory docs; do not replace them. All write work stays on `feature/*` until reviewed. + +--- + +## 1. Situation report + +| Fact | Detail | +|------|--------| +| Default branch | `master` @ `6ef0e2f` (protected) | +| Live monorepo | Termux-origin agentic stack: DeepSeek CLI → ArchWiz dispatch → Sentinel → promote; synthegration/Chronos; multi-agent | +| refTemplates on `master` | **Stub only:** `refTemplates/01_Agent_Runtime/README.md` | +| refTemplates skeleton | Full metadata tree on `recreate/refTemplates-skeleton` (README + SOURCE.txt per entry; depth-1 sparse style) | +| Open PRs | #1 critical-proposal, #2 GHA Rust workflow, #3 security session-store hygiene (draft) | + +Canonical pipeline (from `critical-proposal` / `replit.md`): + +```text +User → deepcli (TUI/cli) + → core.py stream_completion → session cache + → dispatch_pipeline (on cache write) + → autonomous_runner / dispatch_task (sandbox) + → Sentinel (5-gate) → promote + → cli-synthegration / Chronos + → archwiz/archivist (indices) +``` + +Legacy parallel paths (`export_poller.sh`, `activity_listener.py`) are **candidates for archive**, not dual maintenance. + +--- + +## 2. Better navigation than “Entry + HTML only” + +`_Entry+ReadMe.md` and `termux-ecosystem-architecture.html` are useful but **insufficient** as the sole pointers. Prefer this **SSOT ladder**: + +| Priority | Artifact | Why it is better | +|----------|----------|------------------| +| 1 | `archwiz/TOOL_INDEX.md` | 28 tools, 7 categories, cockpit + FOSS stack — **operational** map | +| 2 | `archwiz/CONCEPT_INDEX.md` | Concepts, status (✅/🟡/❌), feature backlog, methodology evolution | +| 3 | `archwiz/REFERENCE_HUB.md` | Auto-generated links to DATA_FLOW, SYSTEM_MAP, func/llm indices | +| 4 | `archwiz/METHODOLOGY_INDEX.md` | What was tried, what broke, what stuck | +| 5 | `archwiz/PROCEDURES.md` + `ARCHWIZARD_TASKS.md` | Runbooks and active tasks | +| 6 | `replit.md` (branch `critical-proposal` / PR #1) | Critical issues, env-aware config design, branch evaluations | +| 7 | `_Entry+ReadMe.md` | One-line command table only | +| 8 | `termux-ecosystem-architecture.html` | Visual diagram; Termux-path absolute links in REFERENCE_HUB still need portability | +| 9 | `refTemplates/README_RECOVERY.md` (skeleton branch) | How to restore refs without recursive submodule bloat | + +**Proposal N1:** Treat TOOL_INDEX + CONCEPT_INDEX as primary “where do I start?” docs; demote Entry/HTML to secondary. +**Proposal N2:** Fix REFERENCE_HUB absolute `/data/data/com.termux/...` links via `archwiz/config.py` path roots (align with PR #1 / mistral config work). +**Proposal N3:** Add a short “Navigation SSOT” block at the top of root README (done on this branch) that lists the ladder above — expand-only. + +--- + +## 3. Branches — critical evaluation + +| Branch | SHA (approx) | Assessment | +|--------|--------------|------------| +| `master` | `6ef0e2f` | Recovery README + live inventory + tiny refTemplates stub. Protected. | +| `critical-proposal` | `2bc964b` | **High value docs.** Corrects poller/listener as legacy; env-aware config; silent-except critique; symlink/path coupling. Safe to merge as docs. Follow-ups need code branches. | +| `mistral/fixes-config-security` | `cbe0d30` | Real `archwiz/config.py`, security docs, requirements-base, setup.sh. Gaps noted in replit.md (paths properties, __init__, silent dispatch in multi-ai-cli). **Merge after** dispatch-log fix. | +| `vibe/mistralai-vibe-code-wrapper-6055d2` | `9864646` | Mistral CLI + code_harvester (content-addressable). Copies silent `except: pass`. Path hardcoding. High value if hygiene fixed. | +| `recreate/refTemplates-skeleton` | `c1ae49f` | **Best current refTemplates representation** — categories 01–14 + uncategorized Haven/ICM_fork + README_RECOVERY. Should land on master as metadata-only. | +| `agent/repository-hygiene` | `742bba7` | PR #3: untrack session stores, sanitizer. **Priority security.** Draft; pre-commit hook issue documented. | +| `timerloggedout-spec-patch-1` | `5862ebe` | PR #2: GHA Rust build/test. Scope unclear vs monorepo Python-heavy reality; review for Termux resource limits. | + +--- + +## 4. Open PRs — evaluation + +### PR #1 — Critical Evaluation (docs) +- **Keep.** Mergeable as documentation. +- Strengths: pipeline truth, config intermediary (not naive relative paths), archive poller/listener, extension table. +- Do not treat poller/listener as first-class in architecture HTML without a “legacy” label. + +### PR #2 — GHA Rust workflow +- **Caution.** Monorepo is predominantly Python/Bash; Rust is mainly Harmonizer / select refTemplates. +- Propose: narrow workflow to paths that actually contain Cargo projects; add resource limits suitable for Termux-origin CI expectations. + +### PR #3 — Session store hygiene (draft) +- **Prioritize.** Session artifacts in Git is a credential-adjacent risk. +- Requirements before merge: fix pre-commit scanning deleted files to stdout; document rotation of any leaked tokens; history rewrite is separate, reviewed work. + +--- + +## 5. refTemplates — CoPilot gaps & nesting debt + +### 5.1 What CoPilot / recovery snapshot listed vs skeleton + +Documented categories **01–14** plus loose top-level names. Consolidation commit `b104890` **removed** nested pointers including: + +- `01_Agent_Runtime/deepcode-cli`, `hermes-agent` (later re-skeletoned as metadata) +- `07_Prompt_Context/Interpreted-Context-Methdology` (+ `_fork`) +- `13_Third_Party_Refs/assistral` +- **`15_Reverse_Engineering/`** entire set: AIStudio2API, AIStudioProxy, AIstudioProxyAPI, gemini-cli-api + +### 5.2 Still uncategorized at `tree -L 1` (skeleton branch) + +These sit **beside** 01–14, not inside a numbered category: + +| Entry | Proposed nest | +|-------|----------------| +| `Haven/` | **15_Android_Workspaces/** or **16_Product_Workspaces/** — Android app workspace + build artifacts | +| `Interpreted-Context-Methdology_fork/` | **07_Prompt_Context/** (restore under category; keep `_fork` naming) | + +### 5.3 Missing category **15_Reverse_Engineering** (removed pointers) + +Propose recreate as **metadata-only** slots (README + SOURCE.txt), same sparse pattern: + +- AIStudio2API +- AIStudioProxy +- AIstudioProxyAPI +- gemini-cli-api + +Optional: `assistral` under 13; `deepcode-cli` under 01 if still relevant. + +### 5.4 master vs skeleton drift + +| Location | State | +|----------|--------| +| `master` | Only `refTemplates/01_Agent_Runtime/README.md` | +| `recreate/refTemplates-skeleton` | Full 01–14 + Haven + ICM_fork + README_RECOVERY | + +**Proposal R1:** Merge skeleton → master as metadata-only (no full clones). +**Proposal R2:** Add `15_Reverse_Engineering/` placeholders + nest Haven + ICM_fork. +**Proposal R3:** Update root README refTemplates snapshot to mark 15 as intentional category and list uncategorized→nested plan (expand-only). + +--- + +## 6. Live codebase comprehension (compressed) + +| Layer | Paths | Role | +|-------|-------|------| +| CLI | `deepcli/`, `deepcli-tui/`, `deepseek-cli/` | Sessions, stream, PoW, export/fork | +| Cockpit | `archwiz/` | Menu, dispatch, Sentinel, Archivist, forensic restore | +| History | `cli-synthegration/`, Chronos | Branch/export/ELO/sync | +| Agents | `termux-multi-agent/` | Provision, run, Cedar MCP | +| Multi-provider | `multi-ai-cli/`, `harmonizer-prod_cli/`, `harmony_hub/` | Mistral/other + Harmonizer | +| Map | `central_mapper_v420.py`, `workspace/llm_map/` | AST/index/bloat | +| Projects | `_1-Projects/`, `exchanges/` | APIs, detectors, eggshell submodule pointers | +| Swarm template | `commingle-swarm/` | **Scavenge-only** — not first-class runtime | + +Critical defects already documented (endorse, don’t re-litigate): + +1. Termux path coupling / broken root symlinks +2. Silent `except: pass` on dispatch (deepcli + multi-ai-cli) +3. Diverged send_message vs stream_completion payloads +4. Hardcoded session UUID fallback +5. Session stores tracked in Git (PR #3) +6. `.bak` pollution under archwiz + +--- + +## 7. Prioritized proposals (“Build the Future Now”) + +| ID | Action | Effort | Depends | +|----|--------|--------|---------| +| P0 | Land PR #3 hygiene (session untrack) after pre-commit fix | M | — | +| P0 | Log dispatch failures (no silent pass) in deepcli + multi-ai-cli | S | — | +| P1 | Merge `recreate/refTemplates-skeleton` metadata to master | S | — | +| P1 | Nest Haven + ICM_fork; add `15_Reverse_Engineering` metadata slots | S | P1 skeleton | +| P1 | Expand README nav SSOT (this branch) | S | — | +| P2 | Merge PR #1 docs; implement `archwiz/config.py` consumers | M | mistral branch | +| P2 | Archive poller/listener to `_archive/` once dispatch confirmed | S | P0 log | +| P2 | Replace broken Termux absolute symlinks with config-rooted entrypoints | M | config.py | +| P3 | ChronoMancer TUI; report_back(); self-heal sandbox glue | L | pipeline stable | +| P3 | Narrow PR #2 GHA to real Cargo paths | S | review | + +--- + +## 8. Out of scope / non-goals + +- Full recursive submodule update as default (refTemplates = depth-1 sparse metadata). +- Treating `commingle-swarm` as production dependency. +- History rewrite without explicit, reviewed ops plan (after tip hygiene). + +--- + +## 9. Sign-off + +This RECON is documentation-only on `feature/recon-intel-and-nav`. Implementation of P0–P2 should proceed as separate `feature/*` branches, one concern each, with PRs against `master`. From 7b68032448afdd8fe39afeef873f7a2e56296184 Mon Sep 17 00:00:00 2001 From: timerloggedout-spec Date: Sat, 1 Aug 2026 08:35:31 -0700 Subject: [PATCH 2/2] =?UTF-8?q?fix(docs):=20resolve=20CodeRabbit=20threads?= =?UTF-8?q?=20on=20PR=20#4=20=E2=80=94=20unindent=20heading,=20skeleton-fi?= =?UTF-8?q?rst=20recovery?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 24 +++++++++++++++++++----- 1 file changed, 19 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index a42bddcbb..e5383860d 100644 --- a/README.md +++ b/README.md @@ -216,9 +216,11 @@ refTemplates/ ranking_research-concept-_.txt 15_Reverse_Engineering/ # MISSING as category — pointers removed in consolidation; recreate as metadata-only # AIStudio2API, AIStudioProxy, AIstudioProxyAPI, gemini-cli-api - # UNCATEGORIZED at tree -L 1 (need nesting): - Haven/ → propose 15_Android_Workspaces or 16_Product_Workspaces - Interpreted-Context-Methdology_fork/ → propose under 07_Prompt_Context + +**Uncategorized at tree -L 1 (need nesting):** + +- `Haven/` → propose 15_Android_Workspaces or 16_Product_Workspaces +- `Interpreted-Context-Methdology_fork/` → propose under 07_Prompt_Context > Note: Many entries above correspond to external git repositories or local workspaces and were sometimes included as submodules or as nested repositories. **Existing refTemplates were depth-1 selective sparse-checkout of relevant files, with metadata only** — not full recursive checkouts. @@ -294,14 +296,26 @@ git submodule status ``` 3) Recreate the `refTemplates` tree from git history if needed + +**Primary (preferred):** restore metadata-only skeleton from `recreate/refTemplates-skeleton`: + +```bash +git fetch origin recreate/refTemplates-skeleton +git restore --source=origin/recreate/refTemplates-skeleton -- refTemplates +git add refTemplates +git commit -m "Restore refTemplates metadata from recreate/refTemplates-skeleton" +``` + +**Fallback (if skeleton branch is unavailable):** checkout from a known restore commit: + ```bash -# Prefer merging metadata from recreate/refTemplates-skeleton rather than full clones git log --all --pretty=format:'%H %ad %s' --date=iso -- refTemplates | head -n 50 git checkout -- refTemplates git add refTemplates git commit -m "Restore refTemplates from " ``` -If git checkout fails because refTemplates was a submodule pointer, try the backup-restore commits already present (see commits listed above). Prefer depth-1 selective sparse-checkout of relevant files (metadata only) rather than full recursive population. Nest uncategorized L1 entries (Haven, ICM_fork) and restore **15_Reverse_Engineering** as metadata slots. + +Prefer depth-1 selective sparse-checkout of relevant files (metadata only) rather than full recursive population. Nest uncategorized L1 entries (Haven, ICM_fork) and restore **15_Reverse_Engineering** as metadata slots. 4) Use archwiz and llm_map indices to fill gaps - Many indices are present in: `archwiz/pointer_index.json`, `archwiz/index_registry.json`, `workspace/llm_map/*_index*.jsonl`.