io bypasses stream primitives. Core provides:
- core.ReadAll(reader) — read all + close
- core.WriteAll(writer, content) — write + close
- core.CloseStream(v) — close any Closer
9 disallowed imports in the quality gate. Zero violations in core/go.
Co-Authored-By: Virgil <virgil@lethean.io>
os bypasses Fs/Env primitives. Core provides:
- c.Fs().Write/Read/List/EnsureDir/TempDir/DeleteAll
- core.Env() for environment variables
- core.DirFS() for fs.FS from directory
Validated: core/go tests have zero os imports.
Co-Authored-By: Virgil <virgil@lethean.io>
path/filepath bypasses core.Path() security boundary.
errors bypasses core.NewError()/core.Is()/core.As().
Both now in the disallowed imports table. Validated by dogfooding
core/go's own tests — zero filepath, zero errors imports remaining.
Co-Authored-By: Virgil <virgil@lethean.io>
Example functions serve triple duty: test, godoc, documentation seed.
Write the Example first — if it's awkward, the API is wrong.
Convention: one {source}_example_test.go per source file.
Quality gate: source file without example file = missing documentation.
Co-Authored-By: Virgil <virgil@lethean.io>
- Replaced anonymous broadcast example with named Action pattern
- Added Task composition example
- Moved ACTION/QUERY to "Legacy Layer" subsection
- Principle 9: encoding/json now has core.JSONMarshal() replacement
Co-Authored-By: Virgil <virgil@lethean.io>
llm.txt: standard entry point for agents landing on the repo
docs/RFC.md: categorised index of all 28 RFCs with status
Co-Authored-By: Virgil <virgil@lethean.io>
Every code example now matches the actual implementation:
- Option{Key,Value} not Option{K,V}
- core.New(core.WithService(...)) not core.New(core.Options{})
- core.Result (no generics) not core.Result[T]
- Subsystem table matches actual Core accessors
- Service registration shows real factory pattern
- IPC examples use actual messages package
New content:
- Process execution rule: go-process not os/exec (Principle 6)
- Command extraction pattern (closures → named methods)
- Full IPC event-driven communication example
- Updated adoption priority (added test naming + process execution)
- Aligned file structure to actual core/agent layout
Co-Authored-By: Virgil <virgil@lethean.io>
Test{File}_{Function}_{Good,Bad,Ugly} naming convention.
Tests ARE the spec — machine-queryable, no prose needed.
Missing categories = gaps in the specification.
Co-Authored-By: Virgil <virgil@lethean.io>
Replace fmt.Errorf calls with log.E() structured errors in
LoadContentDir and Get, providing operation context for the
error chain.
Co-Authored-By: Virgil <virgil@lethean.io>
Added workspace.yaml, work.yaml, git.yaml, kb.yaml, test.yaml, and
manifest.yaml documentation. Added quick reference table with scope,
package, and discovery pattern for all 12 config file types. Expanded
directory structure to show user/workspace/project scopes.
Co-Authored-By: Virgil <virgil@lethean.io>
Resolve stale forge.lthn.ai/core/cli v0.1.0 references (tag never existed,
earliest is v0.0.1) and regenerate go.sum via workspace-aware go mod tidy.
Co-Authored-By: Virgil <virgil@lethean.io>
Replace stub page with comprehensive overview of the IPC-based package
structure covering all 16 sub-packages, platform insulation pattern,
service registration, config wiring, and MCP integration.
Co-Authored-By: Virgil <virgil@lethean.io>
Replaces the single plugin table with dedicated pages per AI platform:
- Claude Code: full marketplace + npm distribution reference
- OpenAI Codex: AGENTS.md structure and plugin inventory
- Google Gemini: CLI extension and MCP server
- LEM: local inference integration and community compute
Co-Authored-By: Virgil <virgil@lethean.io>
Update all 29 Go package pages, 4 tool pages (agent, mcp, ide, lint),
TypeScript, and Go framework index with rich content from individual
repo docs/. Add lint to Tools nav.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace Hugo+Docsy with Zensical (MkDocs Material). Restructure all
content under docs/ with explicit nav. Add 19 new Go package pages,
plus Agent, MCP, CoreTS, IDE, GUI, and AI (LEM) sections. PHP sidebar
restructured with collapsible Guides/Reference groups. Homepage now
has sidebar with Where to Start guide and Community links.
Tabs: Home | Go | PHP | TS | GUI | AI | Tools | Deploy | Publish
Co-Authored-By: Virgil <virgil@lethean.io>
All source, tests, and templates from forge.lthn.ai/core/go-help.
94% test coverage preserved. All tests pass.
Co-Authored-By: Virgil <virgil@lethean.io>
