Commit graph

63 commits

Author SHA1 Message Date
Snider
41270b2904 feat(process): add process management package with Core IPC
Add pkg/process for spawning, monitoring, and orchestrating external
processes with Core ACTION integration:

- Service with framework.ServiceRuntime integration
- ACTION messages: ProcessStarted, ProcessOutput, ProcessExited
- RingBuffer for output capture
- Runner for orchestration (RunAll, RunSequential, RunParallel)
- Dependency graph support for QA pipelines
- Global convenience functions following i18n patterns

Also add docs/pkg/PACKAGE_STANDARDS.md defining how to create Core
packages, using pkg/i18n as the reference implementation.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 19:48:28 +00:00
Snider
e9be13bcd3 docs(i18n): add comprehensive package documentation
- README.md: Quick start, all features, configuration options
- GRAMMAR.md: Verb conjugation, pluralisation, articles, templates
- EXTENDING.md: Custom loaders, handlers, framework integration

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 19:18:43 +00:00
Snider
2a2dfcfe78 docs(i18n): add grammar fundamentals and DX improvements
- Parts of speech: verb, noun, article, adjective, preposition
- Verb conjugation structure (base/past/gerund)
- Noun with plurality and gender
- Article selection (a/an, gender agreement)
- DX: compile-time validation, IDE support, debug mode
- DX: short subject syntax, fluent chaining, fallback chain
- Notes for future: pluralize lib, CLDR, sync.Map caching

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 12:03:54 +00:00
Snider
a987980e82 docs(i18n): finalize API naming for semantic i18n
Stable API (permanent, cannot change):
- _() - simple gettext-style lookup
- T() / C() - compose (semantic intent resolution)
- S() / Subject() - typed subject with metadata

Renamed Transmute() to Compose() for clarity.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 12:00:53 +00:00
Snider
1f75cd8b40 docs(i18n): add semantic i18n system design
Design document for extending i18n with:
- Reserved namespaces (common.*, core.*)
- Semantic intents with metadata (_meta)
- Transmute() for composite translations
- CLI integration (Confirm, Question, Choose)
- Template functions (title, past, plural, etc.)
- Subject helper with count/gender support

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 11:56:29 +00:00
Snider
eecf267935 docs(plans): add Core IPC design for CLI commands
Documents the four dispatch patterns (ACTION, QUERY, QUERYALL, PERFORM),
worker bundle architecture, and permissions-through-presence model.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-30 10:05:35 +00:00
Snider
b9c5cc52a0 chore: clean up .gitignore by removing unnecessary build artifacts 2026-01-29 20:01:34 +00:00
Snider
654f8df1ad docs: add guides and fix documentation issues
New documentation:
- getting-started.md: installation, first build, first release
- troubleshooting.md: common errors and fixes
- workflows.md: end-to-end task sequences
- glossary.md: term definitions
- migration.md: upgrading from legacy tools

Fixes:
- Command examples: core dev task* → core ai task*
- CI flag: --were-go-for-launch → --we-are-go-for-launch
- Setup commands: core health → core dev health
- Installation: circular core go install reference
- Cross-references: broken fragment links

Improvements:
- Added complete repos.yaml documentation
- Added comprehensive environment variables reference
- Added multiple installation methods (go install, binary, source)
- Moved TODO.md to docs/.internal/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 19:59:49 +00:00
Snider
363f12f4da docs: move inline YAML to example.md files with fragment links
- Remove inline YAML from all index.md files
- Add fragment links to corresponding example.md sections
- Create ai/example.md for workflow examples
- Add missing configs to example.md files (test.yaml, php.yaml, etc)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 19:20:34 +00:00
Snider
f44ffe6f11 docs: add generated config examples to setup docs
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 19:13:22 +00:00
Snider
4f15b304fa docs: update TODO.md with recent changes
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 19:10:15 +00:00
Snider
9565122fdc feat(cli): implement setup wizard, fix ai examples, ci dry-run flag
Setup command now has three modes:
- Registry mode: interactive wizard to select packages
- Bootstrap mode: clones core-devops first, then wizard
- Repo setup mode: generates .core/{build,release,test}.yaml

Changes:
- setup: add interactive package selection with charmbracelet/huh
- setup: detect project type (go/php/node/wails) and generate configs
- setup: auto-detect GitHub repo from git remote
- ai: fix command examples (core dev -> core ai)
- ci: rename flag to --we-are-go-for-launch

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 19:09:51 +00:00
Snider
996fae70f4 docs: sync php, pkg, vm with CLI, update coverage tracking
- php: comprehensive rewrite with all 20+ subcommands documented
- pkg: added full documentation with flags and examples
- vm: added examples and detail for all commands
- TODO.md: updated to show current coverage (12/13 at 100%)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 18:39:10 +00:00
Snider
61cbf2bded docs: add ai command docs, update CLI structure
- Create docs/cmd/ai/index.md with full task management documentation
- Add ai command to main docs/cmd/index.md command list
- Update docs/cmd/dev/index.md to point to ai for task commands
- Update TODO.md to reflect current documentation state

Task commands (tasks, task, task:update, task:complete, task:commit, task:pr)
have moved from dev to ai package.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 18:34:49 +00:00
Snider
9add6cf2ee refactor(cli): restructure cmd packages into subdirectories
- Move CLI commands into subdirectories matching command hierarchy:
  dev/, go/, php/, build/, ci/, sdk/, pkg/, vm/, docs/, setup/, doctor/, test/, ai/
- Create shared/ package for common styles and utilities
- Add new `core ai` root command with claude subcommand
- Update package declarations and imports across all files
- Create commands.go entry points for each package
- Remove GUI-related files (moved to core-gui repo)

This makes the filesystem structure match the CLI command structure,
improving context capture and code organization.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 18:02:43 +00:00
Snider
76872efbd7 docs: complete CLI documentation sync
- pkg search: add --pattern, --type, --refresh, --limit, --org flags
- sdk: remove generate (use core build sdk), keep only diff/validate
- vm run: add --ssh-port, --name, fix defaults
- TODO.md: all gaps resolved

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 16:27:39 +00:00
Snider
78cb2b3507 docs: sync php, pkg, setup, doctor, test with CLI
- php: add serve flags, packages subcommands, all commands
- pkg: fix description (GitHub repos not Go modules), add --add flag
- setup: replace --path/--ssh with --dry-run/--only
- doctor: add --verbose flag
- test: full documentation with all flags and JSON output
- Cleaned up TODO.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 16:26:27 +00:00
Snider
a92df56fd1 docs: sync core build with CLI
- Added from-path and pwa subcommands
- Added missing flags (--archive, --checksum, --config, --format, --push)
- Updated build sdk with --dry-run and --version flags

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 16:17:00 +00:00
Snider
dea8f59c10 docs: sync core dev and core go with CLI
Updated by technical writer agents:
- core dev: added task management, api, sync, ci commands
- core dev: fixed all flag discrepancies
- core go: added work subcommands (init, sync, use)
- core go: added missing flags (--json, --check, --open, --threshold)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 16:10:23 +00:00
Snider
ab1a808657 docs: add TODO.md with CLI vs documentation gaps
Generated by comparing `core --help` output against docs.
Lists missing commands, flags, and discrepancies.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 16:03:06 +00:00
Snider
32c465b67f docs: add templates vars section and --wait flag
- Document core vm templates vars command
- Add --wait flag example for php deploy

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:58:00 +00:00
Snider
b51d85e3dd docs: fix sdk description to include generation
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:54:20 +00:00
Snider
03ab4c1704 docs: add missing commands and fix sdk release integration
- Add vars command to vm/templates
- Add ssl command to php
- Fix sdk release integration (remove non-existent --target flag)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:51:51 +00:00
Snider
bdfb089fd3 docs: fix --dir to --path in setup example
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:48:07 +00:00
Snider
13561b1de6 docs: fix command prefixes across documentation
- core search → core pkg search
- core install → core pkg install
- core templates → core vm templates
- core run → core vm run
- --target → --output in docs sync

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:46:24 +00:00
Snider
cf843d59de docs: remove ambiguous core dev ci from example
core ci is for releases, not CI status checking

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:42:43 +00:00
Snider
c34b256aaf docs: fix core dev prefixes in setup After Setup section
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:41:33 +00:00
Snider
5652b6b508 docs: fix command prefixes - use 'core dev' not 'core'
Multi-repo commands are under 'core dev':
- core dev work, core dev health, core dev commit, etc.

Not root-level commands.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:40:13 +00:00
Snider
c3d85eb948 docs: clarify dev command scope
- dev is for portable LinuxKit environment, not multi-repo commands
- Multi-repo commands (work, health, commit, etc.) are root-level
- Added See Also link to work/ for multi-repo docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:35:06 +00:00
Snider
5c4b8dd8c1 docs: fix broken subcommand links in pkg and dev indexes
Commands documented inline don't need directory links.
Only link to directories that actually exist.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:30:50 +00:00
Snider
059a0ba897 docs: fix broken links and update command references
- Update docs/index.md with correct directory links
- Fix relative path errors in subcommand docs
- Update core release → core ci references
- Expand vm/index.md with full command documentation
- Fix See Also sections across all docs

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:18:13 +00:00
Snider
01d34e1525 docs: add Claude Code skill installation guide
Hidden knowledge = dead code + bad DX

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:10:25 +00:00
Snider
77a7237d71 refactor: move plans to tasks/, framework docs to core-gui
- plans/ → tasks/plans/ (planning documents)
- framework/ → core-gui/docs/framework/ (GUI framework docs)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 15:01:46 +00:00
Snider
8601e5b355 docs: add example.md files for all CLI commands
Each command directory now has both index.md (reference) and
example.md (usage examples and configuration samples).

Also adds exception for docs/cmd/build in .gitignore.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 14:58:54 +00:00
Snider
eed8a030f1 docs: add example.md files and ci subcommands
- Add example.md alongside index.md for config/usage samples
- Add ci subcommands: init, changelog, version
- Fix ci/index.md to reference correct commands (was release)
- Update references from config.md to example.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 14:54:44 +00:00
Snider
ace6306233 docs: restructure cmd docs to mirror CLI hierarchy
- Convert flat .md files to index.md in subdirectories
- Add subcommand directories (go/test, go/cov, build/sdk, etc.)
- Update dev/index.md to include multi-repo commands
- Structure now mirrors: core <cmd> [subcmd] → docs/cmd/<cmd>/<subcmd>/

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 14:46:31 +00:00
Snider
ef778936b6 docs: add next steps for docs sync setup
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 09:55:39 +00:00
Snider
d112dab0d1 docs: reorganize into docs/cmd/ and add missing commands
- Move command docs to docs/cmd/ for better organization
- Add work.md: multi-repo operations (health, issues, reviews, etc.)
- Add docs.md: documentation management (list, sync)
- Add templates.md: LinuxKit template management
- Add setup.md: clone repos from registry
- Update index.md with full command reference

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 09:44:28 +00:00
Snider
229cde534d docs: add comprehensive CLI documentation
- Add sdk.md: SDK generation and API diff commands
- Add dev.md: DevOps portable environment (100+ tools)
- Add doctor.md: Environment health check
- Add search.md: GitHub search and install commands
- Update build.md: Add code signing flags (--no-sign, --notarize)
- Update release.md: Add --target sdk flag
- Update index.md: Organize commands by category

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 09:34:57 +00:00
Snider
6ac40d93ac docs(release): add SDK release integration design and plan
S3.4 - Add `core release --target sdk` to generate SDKs as a
separate release target with breaking change detection.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 03:12:49 +00:00
Snider
f3789f6f4c docs: add code signing implementation plan
9 TDD tasks for GPG + macOS codesign + notarization.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 02:44:21 +00:00
Snider
fd7c15c753 docs: add code signing design (S3.3)
GPG signs checksums.txt by default. macOS codesign + notarization.
Windows signtool deferred.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 02:41:18 +00:00
Snider
a30e101281 docs: add core-devops CLI implementation plan
13 tasks with TDD approach:
- Package structure and config
- Image sources (GitHub, CDN)
- ImageManager with manifest tracking
- Boot/Stop/Status
- Shell (SSH + serial console)
- Test detection and execution
- Serve with project mounting
- Claude sandbox with auth forwarding
- CLI commands

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 01:59:44 +00:00
Snider
e5f9276fcd docs: add core-devops CLI design (S4.6)
Design for portable dev environment commands:
- core dev install/boot/shell/serve/test/update/status/stop
- core dev claude - sandboxed AI session with auth forwarding
- Image sources: GitHub Releases, Container Registry, CDN
- Mount & serve with auto-detection
- Test config via .core/test.yaml

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 01:55:02 +00:00
Snider
f70c6fb1c1 docs: add SDK configuration example
Add sdk-full.yaml example showing full SDK generation configuration
including spec path, languages, package naming, diff detection,
and publish settings.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 01:24:41 +00:00
Snider
5e3ae3199b docs: add SDK generation implementation plan
13 tasks with TDD approach:
- Package structure and types
- OpenAPI spec detection
- Generators for TypeScript, Python, Go, PHP
- Breaking change detection with oasdiff
- CLI commands
- Release config integration

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 01:03:05 +00:00
Snider
53b3d2613d docs: add SDK generation design (S3.4)
Design document for OpenAPI SDK generation feature:
- Hybrid generators (native + openapi-generator fallback)
- Core 4 languages: TypeScript, Python, Go, PHP
- Auto-detection: config → common paths → Laravel Scramble
- Breaking change detection with oasdiff
- Monorepo publish support

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 00:59:17 +00:00
Snider
4ae16dc09e docs(examples): add publish-* configuration examples
Publisher configuration examples for each target:
- publish-github.yaml - GitHub Releases (foundation)
- publish-npm.yaml - npm binary wrapper
- publish-homebrew.yaml - Homebrew formula + tap
- publish-scoop.yaml - Scoop manifest (Windows)
- publish-aur.yaml - AUR PKGBUILD (Arch Linux)
- publish-chocolatey.yaml - Chocolatey NuSpec (Windows)
- publish-docker.yaml - Multi-arch containers
- publish-linuxkit.yaml - Immutable images
- publish-all.yaml - All publishers combined

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 00:47:01 +00:00
Snider
05de92148b docs(examples): add build-* configuration examples
Build configuration examples for testing and documentation:
- build-minimal.yaml - Auto-detect everything
- build-go-cli.yaml - Cross-platform CLI
- build-go-wails.yaml - Desktop app with frontend
- build-go-library.yaml - Library (no binary)
- build-docker.yaml - Multi-arch container
- build-docker-go.yaml - Go binary + Docker
- build-linuxkit.yaml - Immutable Linux images
- build-php-laravel.yaml - FrankenPHP + Laravel
- build-multi-binary.yaml - Multiple binaries
- build-full.yaml - All available options

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 00:45:17 +00:00
Snider
dba9088eeb docs(examples): rename wails-desktop to go-wails
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-29 00:42:02 +00:00