Commit graph

140 commits

Author SHA1 Message Date
Snider
2d52b83f60 docs: rewrite documentation suite against AX spec
Codex-authored docs covering primitives, commands, messaging,
lifecycle, subsystems, and getting started — all using the current
DTO/Options/Result API with concrete usage examples.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-21 10:05:04 +00:00
Snider
d66ff46312 docs: remove implemented plans, annotate partial ones
18 plan files deleted (absorbed into core.help docs).
4 kept with implementation notes (lint MCP, AltumCode Layer 2).

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-14 08:09:20 +00:00
Snider
681c88795f docs: add scheduled actions implementation plan (7 tasks)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 12:15:45 +00:00
Snider
d98eef7d37 docs: add scheduled actions design
Attribute-driven, database-backed Action scheduling for CorePHP.
#[Scheduled] attribute on Actions, auto-discovery via scanner,
persist to scheduled_actions table, runtime control via admin.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 12:12:08 +00:00
Snider
fd8a42a088 docs: add AltumCode update checker implementation plan (5 tasks)
TDD plan for uptelligence AltumCode version detection + Claude Code
download skill. Covers VendorUpdateCheckerService, vendor seeding,
deployed version sync, and browser-automated download plugin.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 08:27:58 +00:00
Snider
831e0736b5 docs: add AltumCode update checker design
Two-layer system: uptelligence version detection (5 HTTP GETs)
+ Claude Code skill for browser-automated downloads from
LemonSqueezy (Playwright) and CodeCanyon (Chrome).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-12 08:20:24 +00:00
Snider
89d189dd95 docs: add human-friendly documentation for Core Go framework
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-11 13:02:37 +00:00
Snider
48346a32cb docs: add core/mcp extraction plan
Move Go MCP server from go-ai + PHP MCP from php-mcp into
a single core/mcp repo producing the core-mcp binary.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-09 18:29:48 +00:00
Snider
e3882963a9 docs: add plug package extraction implementation plan (11 tasks)
Covers extracting app/Plug/* into 8 core/php-plug-* packages with
Core\Plug\* namespace alignment. Contracts move to core/php framework,
Registry gains register() method for package self-registration.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 17:22:02 +00:00
Snider
fba6ec6f8a docs: add plug package extraction design
Restores the original package split for Plug providers that was
flattened during GitHub→Forge migration. Contracts move into core/php,
8 category packages (social, web3, content, chat, business, cdn,
storage, stock) become independent repos on forge.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 17:17:41 +00:00
Snider
e232edb7f1 docs: add go-blockchain modernisation implementation plan (8 tasks)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 16:06:50 +00:00
Snider
3dfac0f9c0 docs: add go-blockchain modernisation design
Full refactor plan: cli.Main() migration, DI services for P2P sync
and wallet, go-process daemon for headless mode, build config.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 16:00:54 +00:00
Snider
2d8b1a8616 docs: add daemon registry & manifest implementation plan (6 tasks)
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 14:39:23 +00:00
Snider
693c1dceaa docs: add daemon registry & project manifest design
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 14:36:41 +00:00
Snider
c9ddc798d9 docs: add go-devops decomposition design
Extract 4 loosely-coupled packages from go-devops (31K LOC):
- devkit → merge into core/lint (QA checks, complexity, coverage)
- infra → core/go-infra (Hetzner, CloudNS APIs)
- ansible → core/go-ansible (pure Go playbook engine)
- container → core/go-container (LinuxKit/TIM for Lethean nodes)

Keep build/release/deploy pipeline as go-devops core purpose.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 11:20:04 +00:00
Snider
29bb2c2b40 docs: add lint pattern catalog implementation plan (9 tasks)
Layer 1 only: core/lint repo with YAML catalog, pkg/lint library
(Rule, Catalog, Matcher, Scanner, Report), and core-lint CLI.
18 seed patterns from the Go ecosystem sweep.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 10:48:59 +00:00
Snider
2e2560dc60 docs: add lint pattern catalog & polish skill design
Three-layer system: core/lint (pattern catalog + regex matcher),
go-ai MCP subsystem (lint tools for agents), core/agent polish
skill (multi-AI review orchestration). Seeded with 18 patterns
from the Go ecosystem sweep.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 10:44:42 +00:00
Snider
d08ecb1c0d docs: add Studio Phases 3-5 implementation plan
13 tasks: Phase 3 (TTS, voiceover, voice pipeline), Phase 4 (ComfyUI,
thumbnails, image overlays, batch remix for content flywheel),
Phase 5 (Livewire pages, Ansible playbooks, production deployment).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-09 06:23:25 +00:00
Snider
0ded875ff1 docs: add Studio multimedia pipeline implementation plan
15 tasks covering Phase 1 (Foundation) and Phase 2 (Remix Pipeline).
TDD with Pest tests, Actions pattern, API routes, Livewire UI.
Follows existing LEM module patterns.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 21:49:49 +00:00
Snider
243ab4ebbe docs: add Studio multimedia pipeline design
Smart/dumb architecture — LEM produces JSON manifests (creative decisions),
ffmpeg executes mechanically. Remote-first GPU on homelab. Five-phase delivery
targeting April demo for OF agency video remixing use case.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-08 21:41:17 +00:00
Snider
302fb038a2 docs: add help engine implementation plan (10 tasks)
Merge go-help → core/docs pkg/help, HLCRF layout via go-html,
gohelp sync target in go-devops, integration tests.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-06 16:28:23 +00:00
Snider
86b8a9136c docs: add core/docs help engine design
Merge go-help into core/docs as pkg/help, replace Hugo/Docsy with
native static generator + go-html HLCRF layout. Content owned by
package repos (docs/ convention), collected by go-devops for builds.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-06 16:25:13 +00:00
Snider
915816b3b5 docs: add pkg/core documentation, remove 12MB stale generated site
- Add comprehensive docs/pkg/core.md covering DI container, service
  pattern, message bus (ACTION/QUERY/TASK), error handling, runtime
- Remove pkg/core/docs/site/ (ancient MkDocs HTML with Lethean branding)

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-06 14:29:04 +00:00
Snider
f71f4c7d66 docs: remove stale CLI/ecosystem docs, keep framework-only content
Massive cleanup after module extraction sprint. core/go is now a pure
DI framework — docs should reflect that, not document CLI commands.

- Delete 130+ CLI command/example docs (already in core/cli)
- Delete 6 obsolete pkg-batch*-analysis.md files
- Delete plans/, skill/, static/, mcp/ (moved to correct repos)
- Rewrite index.md for DI framework (not CLI)
- Fix PACKAGE_STANDARDS.md: framework.* → core.* references
- Fix log.md: correct framework integration example

Remaining docs: index.md, pkg/PACKAGE_STANDARDS.md, pkg/log.md

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-06 14:24:35 +00:00
Snider
5da58d6c07 docs: remove internal homelab docs from public repo
These contain internal IPs, service topology, and homelab
architecture that shouldn't be in a public repo.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-03 13:57:53 +00:00
Snider
752f98d8bc docs: remove DNS records from plans dir (not a Charon task)
Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-03 13:44:22 +00:00
Snider
e000e31567 docs: migrate homelab docs from *.lthn.lan to *.lthn.sh
- Rewrite handover doc for lthn.sh with real TLS cert, proper DNS
- Add UniFi gateway DNS record reference (16 A records, no wildcards)
- Update OpenBrain usage guide to lthn.sh URLs
- Split services: *.lthn.sh (lab) vs *.infra.lthn.sh (admin tools)
- GoGetSSL wildcard cert covers lthn.sh + *.lthn.sh + *.infra.lthn.sh

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-03 13:43:39 +00:00
Snider
7fe48a6268 docs: update .lan service URLs to *.lthn.lan subdomain convention
All homelab services now use the *.lthn.lan naming convention
(ollama.lthn.lan, qdrant.lthn.lan, eaas.lthn.lan) per updated
/etc/hosts configuration.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-03-03 13:19:57 +00:00
Snider
bb9844c638 fix: correct clone URL in lthn.lan handover doc
Repo is lthn/hostuk, not host-uk/host.uk.com.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-03 12:36:23 +00:00
Snider
2a14fda69c docs: add OpenBrain usage guide for all agents
Covers seeding, querying, storing, MCP tools, maintenance,
and direct Qdrant API access. Written for agent onboarding.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-03 11:47:09 +00:00
Snider
3e65b13f3f docs: add lthn.lan homelab setup handover for Charon
Covers Docker/FrankenPHP deployment, Traefik integration,
MariaDB/Redis setup, OpenBrain config, and satellite service plan.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-03 11:36:57 +00:00
Claude
d48f613ddf
docs: archive 3 remaining completed plans
Move lem-chat-design, go-forge-design, and go-forge-plan to
docs/plans/completed/. The other completed plans were already
archived by a prior session.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-02-24 19:44:23 +00:00
Claude
674e3c3c9a
docs: archive cli-sdk-expansion plan, remove duplicate job-runner
Move completed cli-sdk-expansion plan to docs/plans/completed/ with
summary. Remove duplicate core-ide-job-runner plans (canonical copy
lives in core/cli).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 13:51:21 +00:00
Snider
3f162db925 docs: archive Q/K Bone Orientation plan as completed
7 tasks across 4 repos (go-inference, go-mlx, go-ml, LEM).
+917 lines, all tests passing, pushed to forge.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-23 00:39:09 +00:00
Snider
12ff432d6b docs: archive completed plans with summaries
Move completed plan documents to docs/plans/completed/ with
concise completion summaries alongside the originals.

Archived: MCP integration, Go API design/plan, CLI meta-package design.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 23:46:13 +00:00
Snider
138927baa5 docs: update plans to reflect WithCommands lifecycle pattern
- Rewrite cli-meta-package-design to document current state:
  WithCommands(), completed migrations, no init()/blank imports
- Add completion status note to MCP integration plan
- Update pkg-batch2-analysis RegisterCommands → WithCommands

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-21 22:13:22 +00:00
Snider
e3fdbe9809 docs: add CLI SDK expansion implementation plan (Phase 0)
9-task plan for adding charmbracelet TUI primitives to go/pkg/cli:
Spinner, ProgressBar, RunTUI, List, TextInput, Viewport, and stubs
for Form/FilePicker/Tabs. All charm deps stay inside pkg/cli —
domain packages import only forge.lthn.ai/core/go/pkg/cli.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-21 18:02:19 +00:00
Snider
e66115f036 docs: CLI meta-package restructure design
Domain repos own their commands via self-registration. cli/ becomes
a thin assembly repo shipping variant binaries (core, core-ci,
core-mlx, core-ops). go/pkg/cli wraps cobra + charmbracelet as the
single import for all CLI concerns.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-21 17:55:53 +00:00
Snider
2aff7a3503 docs: add go-forge design and implementation plan
Full-coverage Forgejo API client (450 endpoints, 229 types).
Generic Resource[T,C,U] for 91% CRUD + codegen from swagger.v1.json.
20-task plan across 6 waves.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-21 15:18:27 +00:00
Snider
d7e5215618 docs: add core.help implementation plan
5 tasks: Hugo scaffold, KB scanning, --target hugo sync,
pipeline testing, BunnyCDN deployment config.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-21 02:13:14 +00:00
Snider
1e8a4131db docs: add core.help website design document
Hugo + Docsy static site aggregating docs from 39 repos.
Pipeline: core docs sync → Hugo build → BunnyCDN deploy.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-21 02:08:40 +00:00
Snider
2d355f9223 docs: mark go-api Phase 3 complete in design doc
Phase 3 adds OpenAPI 3.1 runtime spec generation, MCP-to-REST bridge,
SDK codegen for 11 languages, and CLI commands. 176 tests in go-api.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-21 01:33:24 +00:00
Snider
db0c0adb65 docs: mark go-api Phase 2 complete — all 4 waves done
Wave 4 adds WithPprof, WithExpvar, WithTracing (OpenTelemetry).
143 tests passing across 21 With*() options. Phase 2 roadmap fully delivered.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-21 00:26:42 +00:00
Snider
ce12778561 docs: mark go-api Wave 3 complete in design doc
Wave 3 adds WithHTTPSign, WithSSE, WithLocation, WithI18n, WithGraphQL.
128 tests passing, 5 commits on forge.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-21 00:15:02 +00:00
Snider
44122f9ca6 docs: mark go-api Wave 2 complete in design doc
Wave 2 adds WithBrotli, WithCache, WithSessions, WithAuthz.
102 tests passing, 4 commits on forge.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-20 23:52:18 +00:00
Snider
b2e046f4c5 docs(go-api): mark Wave 1 complete — secure, slog, timeout, gzip, static
Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-20 23:25:20 +00:00
Snider
3135352b2f docs: add Authentik + Traefik integration plan
10 tasks covering DevOps deployment (enable Authentik on de2,
add to prod playbook, configure OIDC app) and go-api middleware
(header extraction, JWT validation, RequireAuth/RequireGroup helpers).
~220 LOC, 16 new tests.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-20 16:30:52 +00:00
Snider
2bae1148bb docs(go-api): add Authentik integration and auth layers to design
Adds forward auth (Traefik) and direct OIDC validation modes,
auth layers diagram, deployment notes, and coreos/go-oidc dependency.
Authentik added to Wave 1 plugin roadmap.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-20 16:23:02 +00:00
Snider
cffd9d3929 docs(go-api): add GraphQL to Phase 2 roadmap
gqlgen (99designs) endpoint at /graphql with playground.
ResolverGroup interface for subsystem opt-in alongside RouteGroup.
Four-protocol access: REST + GraphQL + WebSocket + MCP.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-20 16:18:49 +00:00
Snider
cb0408db1d docs(go-api): add Phase 2 gin plugin roadmap
19 gin-contrib plugins mapped to With*() options across 4 waves:
security, performance, content/streaming, and observability.
Phase 1 marked as implemented with test counts.

Co-Authored-By: Virgil <virgil@lethean.io>
2026-02-20 16:16:42 +00:00