chore(docs): strip JIT-project-specific references from public framework#60
Merged
Merged
Conversation
## What
Removes owner-specific project names (AIFieldSupport-*, AIFS, AIBM, CovenAI,
jitai-www, jitai-api, jITSecure, AuthFirebase, dash-api), local Windows paths
(D:/Code/..., C:/Users/dstolts/...), machine names (DEVINFRAVM), private prod
version numbers (v2.4.5), personal name (Dan Stolts), and JIT-specific secret
names (JITAI_OPENCLAW_PROD) from public docs, release notes, GH Actions
templates, and command templates. Where an example block required a specific
name, the block was rewritten using abstract placeholders (<repo-name>,
<project>, <session-name>, <workspace-path>, etc.) or removed and replaced
with prose conveying the same framework concept.
## Why
.claude/CLAUDE.md "Generic Project Rule": jitneuro is a public open-source
framework; never use owner-specific names. Reinforced by Owner directive
2026-05-18 ("jitneuro project should only be the public framework, not any of
the jit projects").
## Risk
Pure docs and GH Actions workflow templates. No code logic changed. Examples
are now more abstract -- framework features themselves are unchanged.
## Test plan
- [x] grep across worktree finds zero JIT-project / owner-name / local-path
hits in public files (method: exhaustive rg sweep excluding .jitneuro,
.git, .archive, .claude, and legitimate dstolts/jitneuro repo URLs)
- [x] git diff --stat shows 13 files, net-deletion, no unintended files
## What Closes all residual internal-reference leaks found by verification grep after commit af04ec2. Eight files patched. ## Why jitneuro is a public open-source framework. Owner directive: strip all JIT-specific product names, private paths, private IPs, and internal-only URLs. No fake names; use <placeholder> syntax only where an abstract identifier is required for clarity. ## Changes per file - templates/commands/divergent.md: 6 D:\Code\ workspace path literals -> <workspace-path>/ - docs/HANDOFF-verify-before-presenting.md: private DOE spec path D:\Code\Automation\... -> generic description - docs/scheduled-agents.md: D:\Code\.claude\scripts\... and WorkingDirectory D:\Code -> <workspace-path>/... placeholders - docs/sub-orchestrator-pattern.md: 4x D:\Code\Automation\blog\... example log paths -> <workspace-path>/<project>/... - .jitneuro/engrams/context.md: removed Migrated-from line (C:/Users/dstolts/...); replaced Local path with <local-clone-path>; stripped Paperclip section (private IP 192.168.1.155, digital.jitai.co UI URL, automate1 host); stripped jitai.co domain-guard convention; stripped Not-this jitai.co reference - README.md: removed Blog & Articles section containing jitai.co URL - FEATURE-REQUESTS.md: removed Published URL line containing jitai.co URL - RELEASE-NOTES-v0.3.0.md: changed "D:\Code\ hardcoded paths" -> "hardcoded local paths" ## Risk Documentation-only changes. Zero production code. Zero behavior change. ## Test plan - [x] Verification grep re-run post-edit: 0 hits in public files (method: grep -rE across *.md/*.yml/*.yaml excluding .git/.archive/.HUB/node_modules)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Sanitizes 17 leak sites across 14 public files (release notes, docs, command templates, workflows, engram) where owner-specific project names, owner's name, machine names, private prod version numbers, or local Windows paths had leaked into the public framework. Two-commit progression: initial sweep + targeted second pass.
Why
.claude/CLAUDE.md"Generic Project Rule": jitneuro is a public open-source framework that must NEVER use owner-specific names. Reinforced by Owner directive 2026-05-18:<workspace-path>placeholders -- never the owner's actual drive)The audit started from 4 catalogued leak sites and expanded to a comprehensive grep sweep when residual hits surfaced.
Categories of change
AIFieldSupport-API,AIFieldSupport-HE,AIFS-marine-analysis,AuthFirebase,AIBM,CovenAI, prodv2.4.5,HE+cost on uatD:/Code/...andC:/Users/dstolts/Code/...-><workspace-path>/...,<repo-path>/...,<local-clone-path>as appropriate per contextDan Stolts, "Dan->Owner scrub" pattern namingDEVINFRAVMmachine name,digital.jitai.coPaperclip UI URL,192.168.1.155private IPjitai.co/sage/...blog article bullets in README and FEATURE-REQUESTS.jitneuro/engrams/context.md: removedMigrated from:line and Owner's local clone pathnotify-jit-knowledge.ymlworkflow kept (jit-knowledge is the framework's canonical companion knowledge index, public); workflow secret name updated for clarityRisk
Pure documentation. No production code or framework behavior changes. Examples may now read as more abstract -- the underlying feature/strategy/command-behavior text is preserved.
Test plan
AIFieldSupport|AIFS-|AIBM|ai-boat-mechanic|CovenAI|jitai-www|jitai-api|jITSecure|scanner-platform|AuthFirebase|diyaisupport|dash-api|DEVINFRAVM|D:[/\]Code|C:[/\]Users[/\]dstolts|jitai\.co|v2\.4\.5across all public*.md/*.yml/*.yamlfiles returns zero hits (method: grep -rE in the worktree, excluding.git,.HUB,.archive,node_modules)git diff --stat origin/main..HEADshows net-deletion / substitution only (no JIT-named content was renamed -- it was removed)Follow-ups
.HUB/directory contains Owner-local task state and is gitignored; it still contains the original D:/Code refs but is never published.~/.claude/rules/c-drive-path-convention.mdadded (always use C:\ for Owner's local paths);~/.claude/url-resolver.mdcleaned;~/.claude/rules/bash-path-safety.mdexamples updated.