- GET /api/extras — list extras with sync status
- GET /api/extras/diff — per-file diff for extras
- POST /api/extras — create new extra
- POST /api/extras/sync — sync extras (all or by name)
- DELETE /api/extras/{name} — remove extra from config
Check each configured extra's source directory exists and count its
files; warn when one or more target parent directories are unreachable.
Runs in both global and project mode after the main doctor checks.
cmdSyncExtras now parses mode args and auto-detects project mode via
projectConfigExists. Global logic is extracted into cmdSyncExtrasGlobal;
new cmdSyncExtrasProject handles project-scoped extras using
config.LoadProject and config.ExtrasSourceDirProject, with relative
target paths resolved against the project root.
sync --all in project mode now defers a cmdSyncExtras("-p", ...) call
instead of printing a warning, so extras are also synced.
- extras init: create new extra with --target/--mode flags, global + project mode
- extras list: show all extras with sync status detection, --json support
- extras remove: remove extra from config with --force confirmation
ValidateExtraName rejects empty names, reserved words ("skills", "extras"),
and names that don't start with alphanumeric or contain invalid characters
(slashes, dots, spaces, leading dash/underscore). ValidateExtraNameUnique
prevents duplicate extra names in config.
JihuLab (jihulab.com) is a GitLab distribution that supports nested
subgroups but its hostname doesn't contain "gitlab". Add "jihulab" to
the built-in host detection so URLs like jihulab.com/group/sub/project
are parsed as full-path repos without requiring gitlab_hosts config.
- CHANGELOG/website: add gitlab_hosts config and SKILLSHARE_GITLAB_HOSTS
env var to New Features section, add HTTPS fallback bug fix
- RELEASE_NOTES: expand with EffectiveGitLabHosts design decisions,
env var merge semantics, and project-mode isolation
- Runbook: extend gitlab_hosts_config_runbook from 10 to 18 steps
covering env var merge, persistence safety, server parseOpts isolation,
and CLI-level env var smoke tests (18/18 PASS verified)
- TestParseOpts_ProjectMode_NoFallbackToGlobal: server project mode
returns empty hosts when project has none, never falls back to global
- TestParseOpts_ProjectMode_MergesEnvVar: env var merges with project
config, not global
- TestLoadProject_GitLabHosts_EffectiveGitLabHosts: project config
EffectiveGitLabHosts() merges env var while GitLabHosts stays
config-file-only
Move SKILLSHARE_GITLAB_HOSTS merge from Load()/LoadProject() to new
EffectiveGitLabHosts() methods so the GitLabHosts field stays config-file-only
and Save() never writes env-only hosts to disk.
Also fix project-mode direct install dropping gitlab_hosts from the
synthetic Config, and server project-mode parseOpts() falling back to
global config when project had no hosts configured.
Support CI/CD pipelines that need gitlab_hosts without a config file.
The env var is comma-separated and merged (deduplicated) with config
file values in both global and project modes.
Also cleans up from review:
- Extract isValidGitLabHostname to share validation logic
- Remove redundant ToLower before EqualFold in isGitLabHost
- Revert 3 no-opts call sites back to ParseSource()
- Add parseOptsFromProjectConfig helper to reduce inline duplication
- Fix project mode LoadProject missing env var merge
- Add install.md tip about custom GitLab domains
Self-managed GitLab instances on custom domains (e.g., git.company.com)
without "gitlab" in the hostname were parsed with 2-segment owner/repo
split instead of full-path repo. Users can now declare extra GitLab
hostnames in config so the parser treats them like gitlab.com (nested
subgroup support).
- Add `gitlab_hosts` field to both global and project Config structs
- Validate entries at load time (reject scheme, path, port, empty)
- Add `ParseOptions` / `ParseSourceWithOptions` to thread hosts into parser
- Add `isGitLabHost()` helper combining built-in + custom host detection
- Extend `InstallContext` interface with `GitLabHosts()` method
- Update all ParseSource call sites (install, search, update, server)
- Add JSON schemas for both config files
- Add unit tests for config validation and source parsing
- Add E2E runbook for devcontainer verification
- Document in configuration reference and URL formats appendix
The initial GitLab subgroup fix treated all multi-segment HTTPS paths as
full repo paths, regressing GHE and generic host subdir installs like
github.mycompany.com/org/repo/path/to/skill.
Add host-based heuristic: hosts containing "gitlab" use full-path-as-repo
behavior; all other hosts retain the original 2-segment owner/repo split
with remainder as subdir. This preserves backward compatibility for GHE,
Gitea, Gogs, and other non-GitLab platforms while correctly handling
GitLab nested subgroups.
Replace rigid 2-segment HTTPS regex with flexible path parsing that
treats the entire URL path as a repo when no explicit boundary exists.
Use .git suffix as the canonical repo/subdir delimiter, preserving
/-/ (GitLab) and /src/ (Bitbucket) web URL markers.
This fixes install failures for URLs like
onprem.gitlab.internal/org-group/sub1/sub2/project which previously
misinterpreted extra path segments as monorepo subdirectories.
Add a copy button (overlapping-squares icon) to the skill detail page:
- Next to the "Path" label in the Metadata card, copies the full
absolute source path
- In the file viewer modal header, copies the full file path
Clicking shows a brief checkmark with "Copied!" confirmation.
The in-tree runbook runner (tools/runbook/, 25 Go files, ~4500 LOC)
has been extracted into the standalone mdproof project and is no
longer needed here.
Removed:
- tools/runbook/ — parser, executor, assertions, reporters, tests
- .devcontainer/bin/runbook — wrapper that built from tools/runbook
- ai_docs/runbook-guide.md — docs describing the old runner
- Makefile build-runbook target
The cli-e2e-test skill, runbook.json, and ensure-mdproof.sh already
reference the external mdproof binary for all E2E test execution.
- Per-step timeout: `### Step 5: Build (timeout: 10m)` overrides the
global timeout for individual steps. Uses `timeout` command + heredoc
in the session script to avoid quoting issues.
- Env seeding: `runbook.json` `env` field injects environment variables
into all steps via `export` at the top of the session script.
Deterministic key ordering via sortedKeys().
Three DX improvements for runbook runner:
- --fail-fast: two-layer stop-on-failure (bash __rb_stop flag +
Go assertion loop) skips remaining steps after first failure,
reducing noise in long runbooks
- -v/-vv: verbose output showing assertion details (level 1) and
stdout/stderr snippets (level 2) for easier debugging
- --output/-o: write JSON report to file while still printing
plain text summary to stdout, useful for CI artifact collection
Skip re-running unchanged steps when debugging runbooks.
--steps 1,3,5 runs only specified steps; --from N runs from step N onwards.
Filtered steps are marked skipped. Flags are mutually exclusive.
Three runbook CLI improvements addressing top pain points from
verification:
- Auto-prepend (?m) to regex assertions so ^/$ match line boundaries
instead of string boundaries (skip if pattern already has flags)
- Track heredoc delimiters in parser so embedded ``` inside heredocs
don't prematurely close code blocks
- Remove set -e from step subshells — exit code is now the last
command's exit code, eliminating need for CMD_EXIT workarounds
Resolves opportunities #103, #105, #106.
Add a build hook that runs once before all runbooks, enabling
automatic binary rebuild. Lifecycle is now:
build (once) → [per runbook: setup → steps → teardown]
Build hook uses os/exec directly (not session executor), outputs
to stderr, and aborts immediately on failure.
Fix all 17 runbooks to pass in devcontainer:
- Adapt to session executor's set -eo pipefail (use cmd || EXIT=$?
pattern for expected non-zero exits)
- Replace embedded ```bash in heredocs with printf to avoid
confusing the runbook parser
- Fix negated assertion gotchas (Not FAIL, No such file)
- Remove fragile verify code blocks (multi-block merge issues)
- Fix step number collision (7b → 8, renumber subsequent)
- Use -s flag for batch installs instead of repeated --force
- Add (?m) flag for multi-line regex assertions
Disable TUI when hooks are active (hooks need session executor for
env persistence). Show [setup]/[teardown] status in plain text output.
Fix negative step numbers in marker regex for synthetic steps.
Add setup and teardown commands that run before/after each runbook.
Config file (runbook.json) provides persistent defaults; CLI flags
override. Setup env vars persist to all steps via session executor.
Setup failure skips all steps; teardown failure is informational only.
Removed Step 0 from atomgit runbook — init is now in runbook.json.
When inside an ssenv isolated shell, HOME changes and relative paths
like ai_docs/tests/ don't resolve. The wrapper now rewrites relative
non-flag arguments to /workspace/<path> when the file exists there.
Auto-builds from source on each invocation, same pattern as the
ss/skillshare wrapper. Added to help screen and setup.sh quick
start message. Updated guide to document the shortcut.
Convert Expected blocks from natural language descriptions to
matchable assertions: exit_code: N, regex: <pattern>, jq: <expr>,
Not <text>, and plain substring matches. All runbooks now parse
correctly with the assertion engine.
SKILL.md now instructs AI to use bin/runbook --report json for
structured test execution. atomgit_install_runbook.md rewritten with
typed assertions (exit_code:, regex:, Not) as proof-of-concept.
Prefix-based dispatch: exit_code: N, regex: <pattern>, jq: <expr>
fall through to substring match. Assertions always run when defined
and determine pass/fail regardless of exit code. Supports negation
(!0 for exit_code, Not/NOT for substring).
Single bash process runs all auto steps sequentially. Each step uses a
subshell with EXIT trap to persist env via export -p. Marker-based
output parsing splits per-step stdout/stderr. Existing runbooks work
without rewriting.
Extract shared helpers (truncateText, formatDurationMs, stepFailReason,
checkAssertions) and status/executor constants into helpers.go. Remove
7 duplicate functions across reporter_tui.go and reporter_plain.go.
Replace all magic strings with typed constants for compile-time safety.
WriteSingleReport prints per-step results with status icons,
duration, and failure reasons. WritePlainSummary aggregates
multiple runbook results into a compact batch summary.
Replace placeholder main.go with full CLI that supports:
- Single file or directory of *_runbook.md files
- TUI mode (default for single files), plain text, and JSON output
- --dry-run for parse-and-classify without execution
- Per-step timeout with --timeout flag
- Exit code 1 on any failure