Skip to content

chore: clean out ad-hoc scripts, move CLI to src/, rewrite Readme - #193

Merged
rbuergi merged 1 commit into
mainfrom
chore/repo-cleanup
Jul 2, 2026
Merged

rbuergi merged 1 commit into
mainfrom
chore/repo-cleanup

Conversation

@rbuergi

@rbuergi rbuergi commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

What

Repo hygiene sweep + CLI promotion:

  • tools/: delete 12 one-off diagnostic/fix .csx scripts (audit-, check-, diag-, find-, fix-, hotfix-, list-*). The reusable connection pattern + SQL cheat sheet live inline in DebuggingPostgres.md. Kept: deploy.sh + check-db-version.csx (Container Apps deploy gate) and generate-memex-template.cs (invoked by MemexTemplate.Pack's Pack target).
  • Root: delete ad-hoc files (FAILING_TESTS.md, failing-tests.txt, run-failing-tests.sh, test-run-results.txt, clean-expired-secrets.ps1, empty SpellingExclusions.dic), the unreferenced scripts/ folder (old ProjectTemplates generators, superseded), and stale Notebooks/ (pin the removed MeshWeaver.Connection.Notebook 2.0 package), plus a stray .cs.bak.
  • Docs: relocate stray root Doc/Architecture/DebuggingPostgres.md into src/MeshWeaver.Documentation/Data/Architecture/ so it is actually embedded and served; drop its reference to a deleted script. DocumentationLinkIntegrityTest passes.
  • CLI: move MeshWeaver.Cli from tools/ to src/. Already PackAsTool/IsPackable, so the next v*.*.* tag publishes it via the solution-wide pack (dotnet tool install -g MeshWeaver.Cli). Fixed wrong package metadata (pointed at github.com/meshweaver/meshweaver) and added the package README required by the central PackageReadmeFile.
  • Readme: rewritten around what MeshWeaver is + how to install (source, dotnet new meshweaver-memex, Homebrew memex-local, deploy/ recipes, CLI, NuGet), linking memex.meshweaver.cloud and its /Doc. Dropped the stale MeshWeaver.ProjectTemplates section, GitHub-MCP setup, dead portal.meshweaver.cloud link, and a dead Discord invite.

Verification

  • dotnet build -c Release -p:CIRun=true -warnaserror of the full solution on this branch (= main + this diff): green, 0 warnings.
  • dotnet pack src/MeshWeaver.Cli produces the tool package.
  • DocumentationLinkIntegrityTest passes.
  • Verified nothing references the deleted files (docs, workflows, deploy scripts).

🤖 Generated with Claude Code

- delete 12 one-off diagnostic/fix .csx scripts from tools/ — the reusable
  pattern lives inline in DebuggingPostgres.md; keep deploy.sh +
  check-db-version.csx (Container Apps deploy gate) and
  generate-memex-template.cs (used by MemexTemplate.Pack)
- delete root-level ad-hoc files (failing-test triage artifacts,
  clean-expired-secrets.ps1, empty SpellingExclusions.dic), the
  unreferenced scripts/ folder, stale Notebooks/ (pin the removed
  MeshWeaver.Connection.Notebook 2.0 package), and a stray .cs.bak
- relocate stray root Doc/Architecture/DebuggingPostgres.md into
  src/MeshWeaver.Documentation/Data/Architecture so it is embedded/served
- move MeshWeaver.Cli tools/ -> src/: ships as dotnet tool (memex) with the
  solution-wide NuGet release on the next v tag; fix package metadata and
  add the package README required by PackageReadmeFile
- rewrite Readme.md: what MeshWeaver is, link memex.meshweaver.cloud
  (portal + /Doc), and installation paths (source, dotnet-new template,
  Homebrew memex-local, deploy/ recipes, CLI, NuGet); drop stale
  MeshWeaver.ProjectTemplates + GitHub-MCP sections and dead links

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Hygiene sweep that removes committed one-off maintenance scripts and stale artifacts, promotes MeshWeaver.Cli into src/ for first-class packaging, and refreshes documentation/README to match current installation + deployment flows.

Changes:

  • Deleted a set of ad-hoc diagnostic/fix scripts and stale local tracker files/notebooks.
  • Moved/promoted MeshWeaver.Cli into src/ and added the required package README + corrected package metadata.
  • Relocated/updated Postgres debugging documentation and rewrote the root README.

Reviewed changes

Copilot reviewed 30 out of 34 changed files in this pull request and generated no comments.

Show a summary per file
File Description
tools/list-prod-schemas.csx Remove one-off prod schema listing script
tools/hotfix-searchable-schemas.csx Remove one-off searchable_schemas hotfix script
tools/fix-rsalzmann-access.csx Remove one-off prod access row fix script
tools/find-api-tokens.csx Remove one-off ApiToken diagnostic script
tools/diag-apitoken-schema.csx Remove one-off apitoken schema diagnostic script
tools/check-user-nodes.csx Remove one-off user node check script
tools/check-thread.csx Remove one-off thread diagnostic script
tools/check-thread-access.csx Remove one-off thread access diagnostic script
tools/check-prod-db.csx Remove one-off prod DB diagnostic script
tools/check-markus-thread.csx Remove one-off thread page-not-found diagnostic script
tools/audit-user-prefix.csx Remove one-off migration audit script
tools/audit-and-fix-access.csx Remove one-off audit+fix access script
test-run-results.txt Remove committed local test output
src/MeshWeaver.Documentation/Data/Architecture/DebuggingPostgres.md Update guidance to avoid committing throwaway scripts
src/MeshWeaver.Cli/README.md Add package README for CLI tool
src/MeshWeaver.Cli/Program.cs New CLI entry point + command wiring
src/MeshWeaver.Cli/MeshWeaver.Cli.csproj Fix package metadata + tool packaging settings in src/
src/MeshWeaver.Cli/MemexConfig.cs Add CLI config resolution + persistence to ~/.memex/config.json
src/MeshWeaver.Cli/MemexClient.cs Add REST client for /api/mesh/* endpoints
src/MeshWeaver.AI/DefaultAgentSelectionStrategy.cs.bak Remove stray backup file
SpellingExclusions.dic Remove empty/unneeded spelling exclusions file
scripts/create-project-templates.ps1 Remove obsolete template generation script
scripts/create-project-templates-simple.ps1 Remove obsolete template generation script (simple)
scripts/analyze-test-mem-leaks.ps1 Remove local diagnostic script
scripts/add_project_guids.sh Remove local utility script
run-failing-tests.sh Remove local test runner script
Readme.md Rewrite README for current install/deploy/CLI story
Notebooks/What is a Data Mesh.ipynb Remove stale notebook pinned to removed package
Notebooks/Specifying User Interfaces.ipynb Remove stale notebook pinned to removed package
Notebooks/Charting.ipynb Remove stale notebook pinned to removed package
MeshWeaver.slnx Add CLI project under src/ and remove the old tools/ project reference
failing-tests.txt Remove local failing test list
FAILING_TESTS.md Remove stale failing tests tracker doc
clean-expired-secrets.ps1 Remove ad-hoc Azure secret cleanup script

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Test Results (shard 3)

792 tests  ±0   685 ✅ ±0   2m 42s ⏱️ -1s
 13 suites ±0   107 💤 ±0 
 13 files   ±0     0 ❌ ±0 

Results for commit 5128711. ± Comparison against base commit 9f7b0ea.

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Test Results (shard 1)

1 239 tests   - 153   1 239 ✅  - 152   5m 31s ⏱️ - 1m 11s
   14 suites ±  0       0 💤  -   1 
   14 files   ±  0       0 ❌ ±  0 

Results for commit 5128711. ± Comparison against base commit 9f7b0ea.

This pull request removes 153 tests.
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionPartitionedTest ‑ PartitionedPath_ObserveAgents_FromHostedSubHub_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionPartitionedTest ‑ PartitionedPath_ObserveAgents_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionPartitionedTest ‑ PartitionedPath_ObserveModels_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionTest ‑ ObserveAgents_FromHostedSubHub_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionTest ‑ ObserveAgents_FromMeshHub_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionTest ‑ ObserveAgents_SpaceAndUserSet_SurfacesSpaceAgent_UserAgent_AndPlatform
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionTest ‑ ObserveModels_FromHostedSubHub_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionTest ‑ ObserveModels_FromMeshHub_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.BrokenNodeTypeAccessTest ‑ AccessingInstance_OfNonCompilingNodeType_AnswersTerminalError_NotSilence
MeshWeaver.Hosting.Monolith.Test.CircuitContextIsolationTest ‑ CircuitContext_DoesNotLeakAnotherUserAcrossAnAsyncLocalHop
…

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Test Results (shard 0)

1 478 tests  ±0   1 478 ✅ ±0   3m 53s ⏱️ -2s
   12 suites ±0       0 💤 ±0 
   12 files   ±0       0 ❌ ±0 

Results for commit 5128711. ± Comparison against base commit 9f7b0ea.

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Test Results (shard 2)

   15 files  ± 0     15 suites  ±0   6m 40s ⏱️ -26s
1 119 tests  - 81  1 116 ✅  - 81  3 💤 ±0  0 ❌ ±0 
1 119 runs   - 85  1 116 ✅  - 85  3 💤 ±0  0 ❌ ±0 

Results for commit 5128711. ± Comparison against base commit 9f7b0ea.

This pull request removes 82 and adds 1 tests. Note that renamed tests count towards both.
MeshWeaver.Persistence.Test.ApplicationPageResolutionTest ‑ ResolvePathAsync_FutuReSubPaths_ShouldResolve(path: "FutuRe/Analysis", expectedPrefix: "FutuRe/Analysis", expectedRemainder: null)
MeshWeaver.Persistence.Test.ApplicationPageResolutionTest ‑ ResolvePathAsync_FutuReSubPaths_ShouldResolve(path: "FutuRe/EuropeRe", expectedPrefix: "FutuRe/EuropeRe", expectedRemainder: null)
MeshWeaver.Persistence.Test.ApplicationPageResolutionTest ‑ ResolvePathAsync_FutuReSubPaths_ShouldResolve(path: "FutuRe/EuropeRe/LineOfBusiness", expectedPrefix: "FutuRe/EuropeRe/LineOfBusiness", expectedRemainder: null)
MeshWeaver.Persistence.Test.ApplicationPageResolutionTest ‑ ResolvePathAsync_FutuReSubPaths_ShouldResolve(path: "FutuRe/EuropeRe/Overview", expectedPrefix: "FutuRe/EuropeRe", expectedRemainder: "Overview")
MeshWeaver.Persistence.Test.ApplicationPageResolutionTest ‑ ResolvePathAsync_FutuRe_ShouldNotReturnNull
MeshWeaver.Persistence.Test.ApplicationPageResolutionTest ‑ ResolvePathAsync_UnknownDeepPath_ShouldReturnNull
MeshWeaver.Persistence.Test.DocumentationCodeBlockCompilationTest ‑ ExecutedCsharpBlocks_MustCompile(embeddedResourceName: "MeshWeaver.Documentation.Data.AI.AgenticAI.md")
MeshWeaver.Persistence.Test.DocumentationCodeBlockCompilationTest ‑ ExecutedCsharpBlocks_MustCompile(embeddedResourceName: "MeshWeaver.Documentation.Data.AI.ChatCommands.md")
MeshWeaver.Persistence.Test.DocumentationCodeBlockCompilationTest ‑ ExecutedCsharpBlocks_MustCompile(embeddedResourceName: "MeshWeaver.Documentation.Data.AI.PlatformProviderS"···)
MeshWeaver.Persistence.Test.DocumentationCodeBlockCompilationTest ‑ ExecutedCsharpBlocks_MustCompile(embeddedResourceName: "MeshWeaver.Documentation.Data.AI.TeamsBot.md")
…
MeshWeaver.Persistence.Test.DocumentationCodeBlockCompilationTest ‑ ExecutedCsharpBlocks_MustCompile(embeddedResourceName: "MeshWeaver.Documentation.Data.Architecture.Debuggi"···)

@github-actions

github-actions Bot commented Jul 2, 2026

Copy link
Copy Markdown
Contributor

Test Results

   54 files  ±  0     54 suites  ±0   18m 47s ⏱️ - 1m 38s
4 628 tests  - 234  4 518 ✅  - 233  110 💤  - 1  0 ❌ ±0 
4 628 runs   - 238  4 518 ✅  - 237  110 💤  - 1  0 ❌ ±0 

Results for commit 5128711. ± Comparison against base commit 9f7b0ea.

This pull request removes 235 and adds 1 tests. Note that renamed tests count towards both.
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionPartitionedTest ‑ PartitionedPath_ObserveAgents_FromHostedSubHub_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionPartitionedTest ‑ PartitionedPath_ObserveAgents_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionPartitionedTest ‑ PartitionedPath_ObserveModels_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionTest ‑ ObserveAgents_FromHostedSubHub_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionTest ‑ ObserveAgents_FromMeshHub_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionTest ‑ ObserveAgents_SpaceAndUserSet_SurfacesSpaceAgent_UserAgent_AndPlatform
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionTest ‑ ObserveModels_FromHostedSubHub_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.AgentPickerProjectionTest ‑ ObserveModels_FromMeshHub_PopulatesCombobox
MeshWeaver.Hosting.Monolith.Test.BrokenNodeTypeAccessTest ‑ AccessingInstance_OfNonCompilingNodeType_AnswersTerminalError_NotSilence
MeshWeaver.Hosting.Monolith.Test.CircuitContextIsolationTest ‑ CircuitContext_DoesNotLeakAnotherUserAcrossAnAsyncLocalHop
…
MeshWeaver.Persistence.Test.DocumentationCodeBlockCompilationTest ‑ ExecutedCsharpBlocks_MustCompile(embeddedResourceName: "MeshWeaver.Documentation.Data.Architecture.Debuggi"···)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants