Skip to content

chore: migrate framework from DevTrail to StrayMark v4.19.0#3

Merged
montfort merged 1 commit into
mainfrom
chore/migrate-devtrail-to-straymark
May 28, 2026
Merged

chore: migrate framework from DevTrail to StrayMark v4.19.0#3
montfort merged 1 commit into
mainfrom
chore/migrate-devtrail-to-straymark

Conversation

@montfort

@montfort montfort commented May 28, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Migrates the in-repo documentation framework from DevTrail v1.0.0 to StrayMark v4.19.0 (no upstream migration tool existed — adopter set was tiny).
  • Renames .devtrail/ → .straymark/ via git mv (history-preserving) and lets straymark repair install 183 framework files (STRAYMARK.md, expanded 00-governance/, new dirs 08-security/, 09-ai-models/, audit-prompts/, hooks/, schemas/, scripts/, project-local skills under .claude/, .gemini/, .codex/, .agent/).
  • Replaces 8 legacy v1 templates and 4 legacy v1 governance docs with v4 framework versions; drops 28 obsolete shell/PS scripts across 7 subprojects; rebrands 14 subproject .github/* files, 7 subproject .cursorrules, root docs (README.md, CONTRIBUTING.md, ayuda.md, lnxdrive.spdx), and lnxdrive-guide/ / lnxdrive-engine/specs/ references.
  • Preserves the 57 historical AILOGs and 1 AIDEC as immutable audit records (they still mention "DevTrail" by design — decided with the human reviewer).
  • Full decision trail in .straymark/07-ai-audit/agent-logs/guide/AILOG-2026-05-28-001-devtrail-to-straymark-rename.md.

Verification

  • ✅ straymark status → 17/17 framework items present, AILOG=57, AIDEC=1.
  • ✅ straymark validate → 0 errors, 5 informational warnings ([SEC-001] false positives on the strings Bearer/token: in narrative context inside 3 historical AILOGs + this PR's AILOG, plus 1 [REF-002] no-traceability hint on the migration AILOG itself).
  • ✅ grep -rli "devtrail" . --exclude-dir=.straymark --exclude-dir=.git → 0 matches.
  • ✅ git log --follow on a renamed AILOG returns the full pre-rename history (blame preserved).

Out of scope (follow-ups, not blocking this PR)

  • Subproject CI workflows (lnxdrive-*/.github/workflows/docs-validation.yml) are inert in the monorepo — only the root .github/workflows/ runs on GitHub Actions. Consolidation can land as a TDE in a later PR.
  • Frontmatter modernization of the 57 historical AILOGs to StrayMark v4 schema fields (e.g. eu_ai_act_risk, nist_genai_risks, iso_42001_clause). Validate accepts the v1 shape, so deferred.

Test plan

  • CI green on the new root .github/workflows/docs-validation.yml shipped by straymark repair.
  • straymark status & straymark validate reproduce locally on the reviewer's machine (CLI 3.16.0).
  • Spot-check that .straymark/07-ai-audit/agent-logs/daemon/*.md still resolves through git log --follow from the merge commit.
  • Quick read of the rewritten CLAUDE.md and GEMINI.md to confirm the monorepo-specific sections (Project Structure, Agent-Logs Organization, Design Guide Navigation, Context7) survived the merge.

🤖 Generated with Claude Code

@montfort @claude
chore: migrate documentation framework from DevTrail to StrayMark v4.…
da68902 
…19.0

Rebrand the in-repo documentation framework: DevTrail v1.0.0 →
StrayMark v4.19.0. The upstream project was renamed
(strangedaystech/devtrail-framework → StrangeDaysTech/straymark) without
shipping a migration tool, so this commit performs the migration
manually on the lnxdrive monorepo.

Highlights:
- Rename .devtrail/ → .straymark/ via `git mv` (preserves blame).
- Run `straymark repair` to install 183 framework files (STRAYMARK.md,
  expanded 00-governance/, new 08-security/, 09-ai-models/,
  audit-prompts/, hooks/, schemas/, scripts/, and project-local skills
  under .claude/, .gemini/, .codex/, .agent/).
- Rewrite root CLAUDE.md and GEMINI.md to delegate governance to
  STRAYMARK.md while preserving monorepo-specific sections (project
  structure, agent-logs organization by component, design guide
  navigation, Context7).
- Replace 8 legacy v1 templates and 4 legacy v1 governance docs with
  the v4 framework versions.
- Update .straymark/config.yml header and upstream URL.
- Drop 28 obsolete shell/PowerShell scripts across 7 subprojects
  (devtrail-new.sh, devtrail-status.sh, pre-commit-docs.sh,
  validate-docs.ps1) — superseded by the `straymark` CLI.
- Rebrand 14 subproject .github/* files, 7 subproject .cursorrules,
  the 7 .specify/lnxdrive-engine/specs paths, lnxdrive-guide design
  docs, and root-level README/CONTRIBUTING/ayuda/SPDX.
- Drop 10 project-local devtrail-* skill dirs (replaced by straymark-*
  installed by repair).
- Preserve all historical AILOGs (57) and the historical AIDEC (1) as
  immutable audit records — they still mention DevTrail by design.

Verification: `straymark status` reports 17/17 items present and
AILOG=57, AIDEC=1; `straymark validate` returns 0 errors. Repo-wide
`devtrail` references outside .straymark/ are zero. The remaining 54
references inside .straymark/ live in historical audit logs and are
preserved on purpose.

See .straymark/07-ai-audit/agent-logs/guide/AILOG-2026-05-28-001-devtrail-to-straymark-rename.md
for full migration trail and decision boundaries.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@montfort montfort merged commit 7dff6f2 into main May 28, 2026
4 checks passed
@cla-assistant

cla-assistant Bot commented May 28, 2026 •
edited
Loading

Copy link
Copy Markdown

CLA assistant check
All committers have signed the CLA.

@montfort montfort mentioned this pull request Jul 4, 2026
Merged
montfort added a commit that referenced this pull request Jul 4, 2026
@montfort @claude
chore(governance): Charter-01 honest close, Charter-02 (M0-M6), ADRs …
d3e2f39 
…D1/D3, AIDEC D2 (#62)

Executes governance actions C1-C5 of the replanteo plan (new-guide/08, PR #61):

- C1: CHARTER-01 closed by redefinition — telemetry validated against schema
  (completed_as_planned: false, scope_changes: mayor). Fases 0-5 delivered with
  audited quality; Fase 6 (tag) NOT executed because its gate was wrong
  (feature-checklist without capability criteria). Closing notes added.
- C2: CHARTER-02 'Road to functional v0.1' declared — phases are the capability
  milestones M0-M6; load-bearing file surface declared from READ code; R1-R5
  with concrete-threshold mitigations; closure gated by the v0.1.0-alpha.1 tag.
- C3: ADR-2026-07-04-001 (D1: restore crate delimitation, incremental),
  ADR-2026-07-04-002 (D3: telemetry internal-only, external export discarded),
  AIDEC-2026-07-04-001 (D2: GOA for GNOME login, PKCE loopback universal).
  ADRs are draft + review_required for operator approval.
- C4: GitHub Milestones M0-M6 created (#4-#10); version umbrellas #1-#3 kept.
- C5: FU-016 (runtime token refresh -> M5) and FU-017 (divergent auth routes ->
  M1) registered via AILOG-2026-07-04-001 + followups drift --apply.

Validation: straymark validate 0 errors; followups registry in sync;
charter list shows 01 closed / 02 declared.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@montfort