Docs & rules

MillerMark/squad-dashGitHub

This is a public, read-only report. Striff reads this repository's docs, turns each sentence that makes a claim about the code into a rule, and checks the rule against the code on the default branch. How this works

main9affb69Last read Nov 19

Is this yours? Install to manage it

Once installed, Striff checks every pull request.

Rules summary
Documents
Rules
55
29
1
1
28
26
16
7
9
10
10
195 docs
MillerMark/squad-dashOpen repository

MillerMark/squad-dash — documented rules

55 of 55 rules, printed November 22, 2026.

The sentence in your docs
RichTextBoxExtensions.GetPlainText() (line 60) and ToFencedText() (line ~326, via GetFencedPlainText) give a lossless flat round-trip: a region serializes to its exact fenced text and SetPlainText reconstructs identical structure (the same round-trip the empty-region Backspace "no resurrection" guarantee relies on).
RichTextBoxExtensions has a GetPlainText method
Holds
RichTextBoxExtensions.GetCharOffset/GetTextPointerAt (lines 137, 208) define ONE flat offset space over that serialization.
2 rules from this sentence
RichTextBoxExtensions has GetCharOffset
checks “RichTextBoxExtensions.GetCharOffset”
Holds
RichTextBoxExtensions has GetTextPointerAt
Holds
The per-region editor exposes CaretOffset, SelectionStart, SelectionLength local to the region text through IRegionCodeEditor (SquadDash/IRegionCodeEditor.cs, lines 79–85), backed by AvalonEditRegionEditor (SquadDash/AvalonEditRegionEditor.cs, lines 57–73).
3 rules from this sentence
IRegionCodeEditor has CaretOffset
Holds
IRegionCodeEditor has SelectionStart
Holds
IRegionCodeEditor has SelectionLength
Holds
Replace the _contentBox field with an ICSharpCode.AvalonEdit.TextEditor instance, kept behind a NEW narrow seam IRegionCodeEditor (see §4) so EmbeddedCodeRegionBlock depends on the seam, not on AvalonEdit types directly.
EmbeddedCodeRegionBlock depends on IRegionCodeEditor
Holds
Enumerate via the existing FlowDocument-walk pattern already used across RichTextBoxExtensions (PromptTextBox. Document.Blocks → BlockUIContainer { Child: EmbeddedCodeRegionBlock region });
RichTextBoxExtensions depends on EmbeddedCodeRegionBlock
Holds
editor host and palette source are pluggable via IRegionCodeEditor / IRegionEditorPaletteSource;
AvalonEditRegionEditor implements IRegionCodeEditor
Holds
PlanCollectionService owns the collection transition. Converting a transient PendingDecomposePlan into a durable Approved plan in PlanStore is the sole responsibility of this service. It enforces idempotency, stale-revision rejection, active-plan protection, and best-effort pending cleanup. Collection never starts a loop, switches branches, or writes .squad/tasks.md.
2 rules from this sentence
PlanCollectionService depends on PendingDecomposePlan
Holds
PlanCollectionService depends on PlanStore
Holds
PlanViewerLiveSyncHandler provides 80 ms coalescence. Rapid PlanProgressEvent bursts are coalesced into a single UI refresh every 80 ms via DispatcherTimer. Events are filtered by PlanId, stale events (lower completion count) are rejected, and the subscription detaches on window close.
PlanViewerLiveSyncHandler depends on PlanProgressEvent
Holds
Squad.SDK/runPrompt.ts: handleSubSquadsList, handleSubSquadsActivate, SubSquadsListRequest, SubSquadsActivateRequest types
ts imports @bradygaster/squad-sdk
Holds
WorkspaceConversationStore now calls ToolTranscriptDetailContent.Build() directly.
WorkspaceConversationStore depends on ToolTranscriptDetailContent
Holds
All 5 stores confirmed delegating to JsonFileStorage.AtomicWrite.
5 rules from this sentence
ApplicationSettingsStore depends on JsonFileStorage
Holds
PromptHistoryStore depends on JsonFileStorage
Holds
RestartCoordinatorStateStore depends on JsonFileStorage
Holds
RuntimeSlotStateStore depends on JsonFileStorage
Holds
WorkspaceConversationStore depends on JsonFileStorage
Holds
ApplicationSettingsSnapshot schema expansion: +3 properties (NotificationProvider, NotificationEndpoint, NotificationEventToggles)
3 rules from this sentence
ApplicationSettingsSnapshot has NotificationProvider
Holds
ApplicationSettingsSnapshot has NotificationEndpoint
Holds
ApplicationSettingsSnapshot has NotificationEventToggles
Holds
Pattern Service Locator (legacy), Usage Being phased out, Example WorkspacePaths static (replaced by IWorkspacePaths )
WorkspacePaths is declared static
Holds
Pattern Observer (events), Usage SDK bridge, Example SquadSdkProcess.EventReceived
SquadSdkProcess has EventReceived
Holds
Fix applied: Created ToolTranscriptData.cs (data layer) with ToolTranscriptDetailContent.Build() method.
ToolTranscriptDetailContent has a Build method
Holds
Logging: All critical paths log to SquadDashTrace.Write(category, message).
SquadDashTrace has a Write method
Holds
Parser: PushNotificationService.ExtractSquadashPayload (uses regex)
PushNotificationService has an ExtractSquadashPayload method
Holds
RevisionHighlightAdorner signature change: Attach(RichTextBox, TextPointer, TextPointer) instead of Attach(RichTextBox, int offset, int length).
RevisionHighlightAdorner has an Attach method
Holds
PanelDockingService.RegisterPanel() is ready and waiting.
PanelDockingService has a RegisterPanel method
Holds
Introduce an IReplayableUiAction abstraction and a UiActionReplayRegistry that together form a named, enumerable catalogue of programmatically invocable UI state transitions. The interface is defined in SquadDash/Screenshots/ and registered at application startup.
IReplayableUiAction is in SquadDash.Screenshots
Holds
Fixtures use a generic IReadOnlyDictionary<string, JsonElement> key-value bag (ScreenshotFixture.Data), not typed interfaces.
ScreenshotFixture has Data
Holds
Each IFixtureLoader implementation declares the fixture-bag keys it owns via IFixtureLoader.KnownKeys.
IFixtureLoader has KnownKeys
Holds
FixtureLoaderRegistry.RestoreAllAsync calls each loader's RestoreAsync in reverse registration order — the last loader registered is the first to restore.
2 rules from this sentence
FixtureLoaderRegistry depends on IFixtureLoader
checks “FixtureLoaderRegistry.RestoreAllAsync calls each loader's RestoreAsync in reverse registration order”
Holds
FixtureLoaderRegistry has RestoreAllAsync
checks “FixtureLoaderRegistry.RestoreAllAsync”
Holds
ApplyAllAsync preserves forward registration order for symmetry.
FixtureLoaderRegistry has ApplyAllAsync
Holds
A ScreenshotFixture? DefaultFixture property with a default interface implementation returning ScreenshotFixture.Empty was added to IReplayableUiAction.
IReplayableUiAction has DefaultFixture
Holds
Decision: Introduce an IHaveUniqueName interface with a single string UniqueName { get; } property.
2 rules from this sentence
IHaveUniqueName is a contract
checks “Introduce an IHaveUniqueName interface”
Holds
IHaveUniqueName has UniqueName
Holds
AgentStatusCard (the data-context type bound to each agent card DataTemplate) implements it by returning Name.
AgentStatusCard implements IHaveUniqueName
Holds
VisualTreeEdgeAnalyzer.FindAnchor checks (element as FrameworkElement)?.DataContext as IHaveUniqueName as a fallback when no x:Name is present;
2 rules from this sentence
VisualTreeEdgeAnalyzer depends on IHaveUniqueName
Holds
VisualTreeEdgeAnalyzer has FindAnchor
checks “VisualTreeEdgeAnalyzer.FindAnchor”
Holds
the returned string is used as the unique name in EdgeAnchorRecord.ElementNames.
EdgeAnchorRecord has ElementNames
Holds
The IReplayableUiAction.ActionId of the action to replay before capture.
IReplayableUiAction has ActionId
Holds
Matches the ReplayActionId added to ScreenshotManifest in this phase.
ScreenshotManifest has ReplayActionId
Holds
ScreenshotDefinitionRegistry.AddOrUpdate(definition) implements a name-keyed upsert (case-insensitive):
ScreenshotDefinitionRegistry has an AddOrUpdate method
Holds
Coalescing is purely in-memory: ReadAgentSatelliteCoalescer.FindActiveEntry walks the transcript list in reverse and reuses the last open read_agent entry for the same agent_id. It has a WPF dependency (ToolTranscriptEntry) so only TryExtractAgentId is covered by headless unit tests.
ReadAgentSatelliteCoalescer depends on ToolTranscriptEntry
Holds
PlanStore state machine is enforced by PlanStoreUpdater pure static methods (ApplyExecutionStarted, ApplyStepAccepted, ApplyCompleted, ApplyInterrupted, ApplyStopped, ApplyBlocked).
6 rules from this sentence
PlanStoreUpdater has an ApplyExecutionStarted method
Holds
PlanStoreUpdater has an ApplyStepAccepted method
Holds
PlanStoreUpdater has an ApplyCompleted method
Holds
PlanStoreUpdater has an ApplyInterrupted method
Holds
PlanStoreUpdater has an ApplyStopped method
Holds
PlanStoreUpdater has an ApplyBlocked method
Holds
Load-time repair of impossible states is handled by PlanStoreUpdater.RepairInconsistentState.
PlanStoreUpdater has RepairInconsistentState
Holds
Class PlanViewerLiveSyncHandler, Responsibility Subscribes to PlanProgressEvent via WeakEventBroker Filters by PlanId, rejects stale events (lower completion count), coalesces rapid updates with an 80 ms DispatcherTimer , and detaches on window close
2 rules from this sentence
PlanViewerLiveSyncHandler depends on PlanProgressEvent
Holds
PlanViewerLiveSyncHandler depends on WeakEventBroker
Holds
55 rules from 5 docs

More open-source reports

Every report →

Other public repositories whose docs Striff read and checked against their code.