Commit Graph

40 Commits

Author SHA1 Message Date
alexei.dolgolyov 814cf29f47 docs: add PEP 440 version normalization to section 3
Bare labels like 'dev' or 'nightly' break pip/setuptools when
stamped into pyproject.toml. Add a regex check that falls back
to 0.0.0.dev0 with a warning, plus a callout explaining the
gotcha.
2026-04-07 19:41:39 +03:00
alexei.dolgolyov 0bd4549af0 docs: add gitea-runner.md — Act Runner worker capacity on TrueNAS
How to configure parallel job capacity for Gitea Act Runner:
the CONFIG_FILE env var requirement, custom config.yaml mount,
and capacity tuning.
2026-04-07 19:41:35 +03:00
alexei.dolgolyov 936ee9c317 docs: add gitea-runner.md to README index 2026-04-01 00:43:21 +03:00
alexei.dolgolyov 57f79a7365 docs: add NSIS shortcut icons section to CI/CD guide
Explains how to use custom .ico files for shortcuts instead of
the default Python/WSH icon that appears in the taskbar.
2026-03-28 18:37:51 +03:00
alexei.dolgolyov 4c6908bccb docs: add Docker build workflow to manual build section (6.2) 2026-03-28 13:27:17 +03:00
alexei.dolgolyov b5ed703108 docs: add manual build workflow section (6.2)
Describes a workflow_dispatch-triggered build.yml that produces
CI artifacts without creating a Gitea release. Useful for testing
builds before tagging.
2026-03-27 23:41:09 +03:00
alexei.dolgolyov da4fb51b7c docs: add code signing reference to CI/CD guide
Section 6.1 points to windows-code-signing.md for signing
options and CI examples, rather than duplicating content.
2026-03-26 22:00:17 +03:00
alexei.dolgolyov 7d2b8c562d docs: fix lint warnings and clean up references
- Fix MD060 table separator spacing across all docs
- Fix MD031/MD032 blank lines around code fences and lists
- Fix MD029 ordered list numbering in ecc-setup-guide
- Genericize hardcoded app names (LedGrab/MediaServer → YourApp)
- Remove non-existent `claude skill install` CLI command
- Add staleness warning for ECC Windows fixes
- Add cross-link from windows-code-signing to gitea-python-ci-cd
2026-03-26 21:57:23 +03:00
alexei.dolgolyov 1ed06d54c4 chore: rename PORTAINER_WEBHOOK_URL to DOCKER_REDEPLOY_WEBHOOK_URL
More generic name, not tied to Portainer specifically.
Also update dolgolyov-git-release-publisher skill.
2026-03-26 21:45:59 +03:00
alexei.dolgolyov 9bbe7cb24c docs: add minimal Gitea release workflow document
Standalone workflow: push v* tag → create Gitea release with
optional RELEASE_NOTES.md. No builds or artifacts — just the
release entry. Links to full CI/CD guide for extensions.
2026-03-26 00:34:17 +03:00
alexei.dolgolyov d2d0359902 docs: update release notes pattern to use sparse-checkout
Replace full checkout + find scan with sparse-checkout for
RELEASE_NOTES.md — faster and simpler.
2026-03-25 23:23:39 +03:00
alexei.dolgolyov 807d73dfc3 docs: expand sync rule to require full pattern compliance check
When syncing local repos, verify all documented CI/CD patterns
are adopted — not just the one that triggered the sync.
2026-03-25 23:15:54 +03:00
alexei.dolgolyov 43c84ae515 docs: add optional Portainer webhook auto-deploy to CI/CD guide
Document the pattern for triggering Portainer stack redeploy
after docker push, with graceful skip when webhook is not configured.
2026-03-25 22:54:28 +03:00
alexei.dolgolyov 00919c384c chore: add LocalRepos.md to gitignore and sync rule to CLAUDE.md
LocalRepos.md stores paths to local repos that should be kept in
sync when CI/CD documentation is updated. Added mandatory rule
to CLAUDE.md to propagate relevant changes.
2026-03-25 21:59:47 +03:00
alexei.dolgolyov 4f660ff3b6 chore: rename dolgolyov-claude-facts skill to dolgolyov-dev-facts
Update packaged skill and claude-code-tools reference.
Also update dolgolyov-git-release-publisher skill.
2026-03-25 21:54:47 +03:00
alexei.dolgolyov 137acd0ba8 docs: move packaged skills list from README to claude-code-tools
Skills belong with the other Claude Code extension docs, not in the
top-level index.
2026-03-25 15:55:54 +03:00
alexei.dolgolyov 78149d9e56 docs: add .skill package installation instructions
Document both CLI and manual extraction methods for installing
.skill packages, covering VS Code extension users without the
claude CLI.
2026-03-25 15:55:04 +03:00
alexei.dolgolyov 0daa7f77ff docs: add skills directory and update README index
Add three packaged .skill files and document them in README:
dolgolyov-claude-facts, dolgolyov-git-release-publisher, feature-planner.
2026-03-25 15:50:24 +03:00
alexei.dolgolyov b12b9746c6 docs: add RELEASE_NOTES.md pattern for CI release notes
CI scans for RELEASE_NOTES.md in the repo and prepends its content
to the auto-generated Downloads section in the release body.
2026-03-25 15:33:34 +03:00
alexei.dolgolyov b7d25231b9 docs: add modular usage guide and fix GITEA_TOKEN warning
- Added table showing which sections to use per project type
- Fixed stale warning: "Do NOT use DEPLOY_TOKEN" → "Do NOT use GITEA_TOKEN"
2026-03-25 15:09:28 +03:00
alexei.dolgolyov 4788bdf59d docs: add TrueNAS Docker network fix and package linking notes
- Docker address pool 0.0.0.0 causes unreachable gateway on TrueNAS 25.10
- Gitea requires manual package-repo linking on first push
2026-03-25 15:07:36 +03:00
alexei.dolgolyov 985200691d fix: rename GITEA_TOKEN to DEPLOY_TOKEN
GITEA_TOKEN is a reserved name in Gitea — the UI and API reject it
when creating secrets. Use DEPLOY_TOKEN instead.
2026-03-25 14:37:26 +03:00
alexei.dolgolyov c435a5cf0a docs: add shared build logic pattern and expanded size optimization
- Section 4.3: expanded with NumPy submodule removal, zeroconf cleanup,
  debug symbol stripping, .py source removal, dependency replacement tip
- Section 5.2: new "Shared Build Logic" documenting build-common.sh
  pattern for deduplicating Windows/Linux build scripts
2026-03-25 14:08:32 +03:00
alexei.dolgolyov c65dd349f7 docs: add Gitea duplicate asset prevention pattern
Gitea silently appends duplicate asset names on re-triggered releases.
Added upload_asset helper that deletes existing assets before uploading.
2026-03-25 13:19:38 +03:00
alexei.dolgolyov 0a9c270c6b docs: add version management and in-app auto-update sections
- Section 10: Single source of truth via pyproject.toml + importlib.metadata,
  CI version stamping, Docker build args, updated fallback chain
- Section 11: Release provider abstraction, PEP 440 version normalization,
  install type detection, update service pattern, NSIS silent install,
  portable ZIP/tarball swap scripts, API endpoints, frontend integration
2026-03-25 12:51:07 +03:00
alexei.dolgolyov 7b563c235e docs: add Windows code signing review for open-source projects 2026-03-24 15:14:03 +03:00
alexei.dolgolyov 01c8f71fee fix: add f-string prefix to release body template 2026-03-24 14:26:17 +03:00
alexei.dolgolyov 294c50a2eb docs: expand CI/CD guide with NSIS launch function, VBS fallback, and local build testing
- Replace MUI_FINISHPAGE_RUN_PARAMETERS with RUN_FUNCTION (fixes quoting)
- Add embedded Python fallback to VBS hidden launcher
- Add .onInit file-lock detection for running instances
- Add section 11: local Windows build testing with NSIS
- Expand troubleshooting table with common build/install issues
2026-03-24 12:46:38 +03:00
alexei.dolgolyov e32cf5fe58 docs: add VBS hidden launcher pattern to CI/CD guide
Document the VBS wrapper approach for launching Windows apps
without console window flash. Update NSIS example to prefer
VBS over direct bat execution.
2026-03-23 13:53:19 +03:00
alexei.dolgolyov bf7631b7e4 docs: add NSIS finish page launch option to CI/CD guide
Add optional MUI_FINISHPAGE_RUN pattern for launching the app
after installation completes.
2026-03-23 13:41:41 +03:00
alexei.dolgolyov feb05e1df4 docs: restructure repo — extract tools file, add CLAUDE.md, date-based versioning
- Move ECC setup guide reference from README to claude-code-tools.md
- Add CLAUDE.md with mandatory README sync rule
- Add "Last updated" date to README
- README is now a clean index of repo contents
2026-03-23 02:52:02 +03:00
alexei.dolgolyov f17ff30c11 docs: add release fallback logic and troubleshooting section
Add ::warning:: annotation and fallback to fetch existing release
when tag already has a release. Add troubleshooting section for
re-triggering failed release workflows. Fix markdown lint warnings.
2026-03-23 02:47:57 +03:00
alexei.dolgolyov f22e3fabe6 docs: add Gitea Python CI/CD guide
Reusable reference extracted from wled-screen-controller covering:
- Lint/test and release workflows for Gitea Actions
- Cross-building Windows from Linux (embedded Python + wheels)
- NSIS installer packaging
- Docker multi-stage builds with Gitea registry
- Version detection, pre-release handling, size optimization
2026-03-23 01:17:28 +03:00
alexei.dolgolyov ed3378cb44 docs: add ECC update/upgrade instructions
Covers pulling latest, backing up customizations (model tiers, hook fixes),
re-running installer, and re-applying changes that get overwritten.
2026-03-22 01:59:38 +03:00
alexei.dolgolyov 0004809f1a docs: add Windows continuous learning v2 fixes to ECC setup guide
Three silent-failure bugs: python3 Store stub, claude-vscode entrypoint
rejected, observer disabled by default. All must be fixed for observations
to flow.
2026-03-22 01:53:38 +03:00
alexei.dolgolyov 97611d132f docs: add agent model tier configuration to ECC setup guide
Recommended model assignments: opus for reviewers/security/tdd/planning,
sonnet for build resolvers/mechanical tasks, haiku for doc-updater.
2026-03-21 13:35:59 +03:00
alexei.dolgolyov b9e0d9967f Add ECC setup guide with full installation instructions
Covers cloning, installer usage, agent config, continuous learning v2 hooks,
and known gotchas (Windows paths, fake /plugin commands, WSL/PowerShell mixing).
2026-03-21 12:22:22 +03:00
alexei.dolgolyov 3aba23c9f2 Add .gitignore and ECC setup guide reference
Ignore .claude/ directory and add Everything Claude Code setup guide
link to README.
2026-03-21 12:06:04 +03:00
alexei.dolgolyov 51128a7502 Clarify MCP vs Skills distinction in README
Separate AST Index into its own Skills section, add descriptions
for both extension mechanisms, and fix markdown lint warnings.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 12:21:36 +03:00
alexei.dolgolyov 70d60458b8 Add README with Claude Code facts collection
Initial README covering Context7 MCP server and AST Index skill.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-16 12:15:13 +03:00