Skip to content

Improve large-codebase workflows and Windows JSON handling (#95) - #97

Open
1oridevs wants to merge 5 commits into
haydenschmitty:mainfrom
1oridevs:fix/95-large-project-workflow
Open

1oridevs wants to merge 5 commits into
haydenschmitty:mainfrom
1oridevs:fix/95-large-project-workflow

Conversation

@1oridevs

@1oridevs 1oridevs commented Nov 6, 2026

Copy link
Copy Markdown

What this changes

Refs #95.

This improves Floorplan's workflow for large codebases, including projects without Git.

  • Adds --lite builds that fill missing file and route descriptions using available scan information. Generated descriptions are marked, and hand-written descriptions take precedence.
  • Allows description worksheets to retain original filenames and route identifiers with --keep-names.
  • Accepts BOM-prefixed JSON in build, refresh, recent-work, and related inputs.
  • Reports excluded file categories, unlinked files, and possible runtime-built HTTP calls without treating unmatched connections as proof that code is unused.
  • Adds default exclusions for common generated/build directories, including tracked generated files.
  • Provides a no-Git recent-work fallback and preserves lite mode when refreshing.
  • Updates the skill documentation, Windows guidance, CLI engine labeling, and regression tests.

The generated HTML remains self-contained. HTML-size optimization and broader agent-specific workflow changes are outside this patch.

How I tested it

Environment: macOS, Node 24.19.0, npm 11.17.0.

Required checks:

  • npm test — 208 passed, 0 failed, 1 Windows-specific test skipped.
  • claude plugin validate . — passed.
  • node --test tests/issue95-large-project.test.mjs — all 6 tests passed.
  • Full-diff whitespace checks and clean working-tree check — passed.

Project testing: Scanned, built, and refreshed a map from Floorplan's own JavaScript source tree in a working copy without Git metadata. Also tested a synthetic no-Git workspace containing 751 code files and 500 Express-style routes, including a lite build and excluded/unlinked reporting.

The BOM behavior was covered by regression tests. Native Windows testing has not been performed; Windows CI results are pending.

Checklist

  • No new dependencies
  • Anything the map shows people is in plain language
  • No secret values stored or printed by the new functionality
  • No details of a real private project in code, comments, docs or screenshots
  • npm test passes
  • claude plugin validate . passes
  • CHANGELOG.md updated under Unreleased

@1oridevs 1oridevs changed the title Fix/95 large project workflow Improve large-codebase workflows and Windows JSON handling (#95) Nov 6, 2026
haydenschmitty added a commit that referenced this pull request Nov 15, 2026
Two of the frictions reported on a large project mapped from Windows:

- Windows PowerShell's Set-Content and Out-File, and some editors, start a
  UTF-8 file with a byte order mark, which JSON.parse rejects, so the build
  stopped on architecture.json and skipped recent-work.json. Every JSON
  file a person, an agent or Floorplan writes is now read through one
  helper (readJsonFile in lib/common.mjs; serve.mjs and query.mjs, which
  stand alone, strip it themselves) that skips one leading mark and is
  otherwise as strict as before.
- Only the kinds of file "include" names are mapped (code by default), so a
  big project's board could look too small, as if the scan had failed. The
  scan and the build now print a NOT MAPPED line with the files left out by
  kind (and by "ignore"), and how to add a kind, and --json carries the
  same counts (scan counts.notMapped, build notMapped).

The guides also say their commands are written for a POSIX shell, with the
PowerShell way where it differs.

Pull request #97 covered these too, but also added a --lite mode with
generated descriptions, dynamic-call hints, new always-ignored folders
(dist, build, out, target, coverage) and unrelated changes to open.mjs and
recent.mjs, and was based on 0.6.3. Its BOM helper and exclusion report
are the basis of this change; the rest is left out. The issue's other two
items, generated descriptions for big projects and hints for requests whose
address is built at runtime, are not done here.

Refs #95
haydenschmitty added a commit that referenced this pull request Nov 16, 2026
…e command

open.mjs called whatever answered to the claude command "the Claude Code
CLI", even when its own --version said otherwise ("devin 3000.11.238"), so
the line contradicted itself. When the version names another program, the
line now names that program and says it was found as the claude (or codex)
command. Claude Code's and Codex's own version lines keep the usual names.

First version of the fix by @1oridevs in #97.

Refs #95
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.

1 participant