Commit Graph
1687 Commits
Author SHA1 Message Date
Willie fcbfd39be2 refactor(extensions): describe and rename built-ins by output
md2codex / md2gemini named the *input* (markdown) and read poorly. Rename
the bundled extensions after what they produce: codex-agents and
gemini-commands. Turn the BuiltinExtensions catalog into structs carrying
a human-readable description so the dashboard can explain each one before
install, and propagate the new names across tests and docs.
2026-05-30 19:23:12 +08:00
Willie ce023b180f feat(ui): show extension descriptions and clarify wording
The Available list showed only a bare name with no hint of what each
built-in does. Render the catalog description next to it. Also broaden the
section copy: extensions pipe each file through a script (not only
'convert to a format'), and reword the source-path help to make the
intent clearer.
2026-05-30 19:23:12 +08:00
Willie 9bafda4fa3 refactor(ui): use Checkbox component and lock chip in Extras targets
The raw <input type=checkbox> and greyed-out mode select looked out of
place against the hand-drawn design. Use the shared Checkbox component for
Flatten, and render a read-only lock chip (instead of a disabled select)
when an extension forces copy mode — in both the Add Extra modal and
ExtraCard so the two stay consistent.
2026-05-30 19:23:12 +08:00
Willie 3779718631 fix(ui): clarify extras source path help 2026-05-30 19:23:12 +08:00
Willie 67ac184b71 feat(ui): label and clarify target row in Add Extra modal
Add column headers (Path / Extension / Mode) so first-time users can
tell the controls apart. When an extension is selected, replace the
greyed-out mode select with a read-only "copy" lock chip plus a
"runs in copy mode" hint — the disabled control read as broken rather
than intentionally locked.
2026-05-30 19:23:12 +08:00
Willie a42cf78f19 feat(ui): add extension picker to Add Extra modal
The create-extra dialog now offers the same per-target extension
dropdown as the Extras cards. Selecting an extension forces the target
into copy mode and disables the mode selector. createExtra carries the
extension, and the server coerces such targets to copy mode on create.
2026-05-30 19:23:12 +08:00
Willie 3b927ff4f1 fix(ui): open extensions directory in file manager, not editor
The "Open directory" action launched a text editor; switch it to the
OS file manager (Finder on macOS, Explorer on Windows, xdg-open on
Linux/BSD) so it reveals the folder as users expect. Drop the editor
override parameter and the {editor} toast placeholder.
2026-05-30 19:23:12 +08:00
Willie f6eca1fc7d feat(ui): add extensions management to Config page
Add an "Extensions" tab to the Config page for managing transform
extensions in the active mode (global or project):

- GET /api/extensions lists installed extensions with their manifest
  descriptions, merged with the built-in catalog so users can see what
  is available to download.
- POST /api/extensions/install downloads a whitelisted built-in
  extension into the active mode's extensions directory.
- POST /api/extensions/open opens that directory in the user's editor,
  mirroring the skill "open in editor" affordance.

ExtensionSpec now carries the manifest description so the list can
surface it. The UI shows installed extensions with a built-in badge,
available built-ins with a Download button, and an Open-directory
action. Strings are translated across all 11 locales.
2026-05-30 19:23:12 +08:00
Willie f6c9b98562 feat(ui): add per-target extension picker to Extras page
Surface the per-target extension transform in the dashboard. A new
GET /api/extras/extensions endpoint lists extensions available in the
current mode's directory (global or project), and the Extras page renders
a picker per target. Selecting an extension forces copy mode (transforms
are copy-only) and locks the mode control; changes apply optimistically
via the query cache. Adds i18n keys across all locales.
2026-05-30 19:23:12 +08:00
Willie c0609011e4 feat(extensions): map model field and document Codex agents recipe
The md2codex reference converter now carries the agent's `model`
frontmatter into the generated TOML, matching what Codex agents expect.
Document the extras + extension recipe for converting markdown agents to
Codex TOML so the conversion works without a built-in agents target.
2026-05-30 19:23:12 +08:00
Willie 9e4563d143 chore(extensions): port reference scripts to Node.js and validate extras extension schema
Port the md2gemini and md2codex reference extensions from Python to
Node.js for broader portability (Node ships uniformly across Windows,
macOS, and Linux). Add the extension field to extraTargetConfig in the
global and project JSON schemas so editors accept it, with a schema test
guarding its presence.
2026-05-30 19:23:12 +08:00
Willie 5c3a3dff30 docs: document extras extension transforms 2026-05-30 19:23:12 +08:00
Willie 3a2a97b542 docs(extensions): add md2gemini and md2codex reference extensions 2026-05-30 19:23:12 +08:00
Willie fa87ef745f test(integration): end-to-end extras extension transform 2026-05-30 19:23:12 +08:00
Willie c200349540 feat(cmd): skip extension targets in collect; label them in list 2026-05-30 19:23:12 +08:00
Willie 519f7f9412 feat(cmd): apply extension transform during extras sync 2026-05-30 19:23:12 +08:00
Willie aa309d52d7 feat(cmd): resolve extension value and validate transform mode 2026-05-30 19:23:12 +08:00
Willie 1b9d25de7a feat(sync): implement per-file transform with output rename and prune 2026-05-30 19:23:12 +08:00
Willie 425c32d489 refactor(sync): thread extension spec param through SyncExtra 2026-05-30 19:23:12 +08:00
Willie 68607f338f feat(sync): run transform subprocess over a single file 2026-05-30 19:23:12 +08:00
Willie 27e8e55fea feat(sync): add ExtensionSpec and manifest loading 2026-05-30 19:23:12 +08:00
Willie 768dc2e848 feat(config): add extension field to ExtraTargetConfig 2026-05-30 19:23:12 +08:00
Willie e51134af24 feat(git-root): surface scope mismatch in UI and document git_root field
Add Config.GitRootMismatch() as the single source of truth for detecting
when the git repo lives at a different scope than git_root configures, and
reuse it across the CLI guidance, the server status response (scopeMismatch
/mismatchScope/mismatchDir), and a new warning banner on the Git Sync page.

Document git_root in the config structure-view field docs (fieldDocs) and the
GitStatus client type, and add the gitSync.scope.* / gitSync.mismatch.* i18n
keys across all locales to keep dictionary parity.

Cover the behavior with config, server handler, and CLI integration tests:
push/pull honor the root scope (agents files reach the remote, config.yaml
stays untracked), POST /git/root inits+persists the scope and rejects invalid
scopes and project mode, and git status reports scope mismatches.
2026-05-30 19:23:12 +08:00
Willie 54d6706168 feat(ui): switch git_root scope from the Git Sync page 2026-05-30 19:23:12 +08:00
Willie 16c6e8ec8d feat(server): git operations honor git_root scope + POST /git/root to switch scope
- extract shared git.InitScopeRepo/WriteScopeGitignore/EnsureLocalIdentity (UI-free)
- cmd init delegates to the shared helpers (no logic duplication)
- handler_git operations use EffectiveGitRoot; status exposes the scope
- new POST /api/git/root inits a repo at the target scope dir + persists git_root
2026-05-30 19:23:12 +08:00
Willie d6b6b929de feat(ui): validate git_root scope in config editor 2026-05-30 19:23:12 +08:00
Willie 9e371f2dde refactor(git-root): enforce config.yaml exclusion, dedupe scope mapping, warn on scope change
- writeInitGitignore now appends config.yaml to a pre-existing root .gitignore
  if missing (enforces the safety guarantee instead of best-effort)
- single source of truth config.ScopeDir; EffectiveGitRoot/scopeDir/gitRootScopes delegate
- warn when --git-root is passed with --remote on an already-initialized repo
- use 0o644 and check WriteFile errors; add tests for the append + agents scope
2026-05-30 19:23:12 +08:00
Willie 7941ef295a docs: document git_root scope and --git-root flag 2026-05-30 19:23:12 +08:00
Willie e79bde558b test(git-root): cover init --git-root root setup 2026-05-30 19:23:12 +08:00
Willie 757a6c0074 feat(init): scope-aware git init with interactive picker and root .gitignore 2026-05-30 19:23:12 +08:00
Willie d6c21e9638 test(git-root): cover root-scope commit and scope mismatch guidance 2026-05-30 19:23:12 +08:00
Willie 9cad34f3b2 feat(pull): operate on configured git_root scope 2026-05-30 19:23:12 +08:00
Willie e4287f3061 feat(push): operate on configured git_root scope 2026-05-30 19:23:12 +08:00
Willie abeeb93dbe feat(commit): operate on configured git_root scope 2026-05-30 19:23:12 +08:00
Willie d8bf753049 feat(config): add git_root to config JSON schema 2026-05-30 19:23:12 +08:00
Willie a41accc00c feat(cli): add resolveGitRoot scope resolver with mismatch detection 2026-05-30 19:23:12 +08:00
Willie 286070c2a4 feat(config): add git_root scope field and EffectiveGitRoot resolver 2026-05-30 19:23:12 +08:00
김봉섭 62e571fe92 docs(proposals): propose extras in git integration (#171)
skillshare's git integration covers only the skills source today, so
extras (hooks, rules, commands, prompts) sit outside the commit/push/pull
workflow. This proposal asks that extras become a first-class git target.
2026-05-29 16:41:33 +08:00
Willie 244f742a84 docs(readme): add bit3125 to contributors 2026-05-29 01:19:13 +08:00
Willie 046e35a566 fix(devcontainer): forward port 3000 for docs site
The `docs` command starts Docusaurus on :3000 inside the container,
but compose only published 5173 and 19420 to the host. The
`forwardPorts` entry in devcontainer.json only takes effect under
VS Code / the devcontainer CLI; `make devc` uses plain
`docker compose`, which honors only the compose `ports:` mapping.

Publish 3000 so `docs` is reachable from the host browser.
2026-05-29 01:12:28 +08:00
Willie e44896b518 docs(getting-started): restructure for scenario clarity
- index: open with a Mermaid source→targets diagram and describe the
  three kinds of skills that coexist in a source repo (authored,
  vendored, tracked) so readers form a mental model before commands
- first-sync: keep the linear walkthrough as the primary path; add
  Variation sections for restoring on another machine (idempotent
  clone + tracked re-install) and headless setup (CI / devcontainer
  post-create) with the non-interactive flag table
- from-existing-skills: split into single-CLI migration, multi-CLI
  consolidation, and connect-existing-repo paths; surface a backup
  caution before collect since it mutates target directories

Trim filler prose and favor copy-pasteable commands.
2026-05-29 01:12:22 +08:00
Willie d32a15fd94 chore: release v0.19.24 v0.19.24 2026-05-27 17:03:13 +08:00
Willie d6600e744a feat: add UI local commit action 2026-05-27 16:28:50 +08:00
Willie 0becff010e feat: add local commit command 2026-05-27 15:10:00 +08:00
Willie ff8860c9cd fix(ui): preserve update check status after update 2026-05-27 13:56:38 +08:00
Willie e02b2078de chore: release v0.19.23 v0.19.23 2026-05-26 16:01:42 +08:00
Willie 4e532615f6 fix: persist update check status in dashboard 2026-05-26 15:57:36 +08:00
Willie 39011e716c docs: update changelog for v0.19.23 2026-05-26 15:57:23 +08:00
Willie 0e091a5e63 fix: refresh metadata after nested skill updates 2026-05-26 13:37:47 +08:00
Willie 6374134955 chore: release v0.19.22 v0.19.22 2026-05-26 11:09:24 +08:00