@lmctl-ai/lmctl 0.2.6 → 0.2.8

package/dist/cli/teamfile-template.d.ts

@@ -24,11 +24,18 @@ export declare function parseMemberSpec(raw: string): {
 };
 export declare function renderMemberLine(member: MemberSpec): string;
 /**
- * Render the canonical starter teamfile. The header carries the no-timeout
- * rule INLINE (not only as a skill-doc link) so a new Lead's first read
- * already has it; the wording is association-first on purpose (a diagnosis
- * to reach for after a dispatch dies, not a prohibition stated in advance).
- * Session ids are never generated here — that is `lmctl seed`'s job.
+ * Render the canonical starter teamfile. Session ids are never generated
+ * here — that is `lmctl seed`'s job.
+ *
+ * Operator, 2026-09-29 (onboarding revamp, queued#21811): the header
+ * teaches the loop -- generate, edit, lint, seed -- and points at ONE page
+ * covering the teamfile format plus what lint and seed each do, rather
+ * than explaining any of that inline. Deliberately ONE link, not two:
+ * lmctl-lead.md is dropped (the seed prompt is cut to bare minimum for the
+ * same reason -- an arriving Lead isn't front-loaded with an operating
+ * guide) and the previously-inline no-`timeout` paragraph is cut entirely
+ * (queued#21813/#21814/#21820, operator: a warning that never stopped
+ * anyone who hit it is noise for everyone who has not).
  */
 export declare function renderTeamfile(opts: {
     teamName: string;

package/dist/providers/config/init-config.d.ts

@@ -0,0 +1,43 @@
+export interface InitProviderSlot {
+    provider: string;
+    model1: string;
+    model2: string;
+    model3: string;
+}
+export interface InitConfig {
+    provider1: InitProviderSlot;
+    provider2: InitProviderSlot;
+    provider3: InitProviderSlot;
+}
+/**
+ * The four providers lmctl actively ships defaults for, each with three
+ * model tiers (top / mid / lighter). These are real, currently-declared
+ * models observed on a live fleet (2026-09-29) -- a useful starting point,
+ * not a claim of permanent correctness; lint warns (never errors) if one
+ * goes stale, and the whole point of `lmctl init`'s output is that it is
+ * meant to be edited.
+ */
+export declare const PROVIDER_MODEL_DEFAULTS: Record<string, readonly [string, string, string]>;
+/** Providers lmctl init knows how to fill in, in fixed preference order
+ * (used only to pick 3 of 4 when every provider is present; presence
+ * detection itself never ranks). */
+export declare const SUPPORTED_INIT_PROVIDERS: readonly ["claude", "codex", "agy", "kimi"];
+export declare function getDefaultInitConfigPath(): string;
+/** Fill rule (operator, 2026-09-29): 3 detected -> use all 3; 2 -> Provider3 = Provider1;
+ * 1 (or 0, using a placeholder) -> Provider2 and Provider3 = Provider1. */
+export declare function buildInitConfig(detectedProviders: string[]): InitConfig;
+/** Returns the subset of SUPPORTED_INIT_PROVIDERS present on this machine,
+ * in SUPPORTED_INIT_PROVIDERS order (not a usage ranking -- presence is a
+ * yes/no question, order here is just deterministic output, not a claim
+ * about which is "best"). */
+export declare function detectPresentProviders(): string[];
+export declare function renderInitConfig(config: InitConfig): string;
+export declare function parseInitConfigText(raw: string): InitConfig | null;
+/** Reads the init config, or null if it doesn't exist / doesn't parse into
+ * all three complete slots. Never throws. */
+export declare function readInitConfig(filePath?: string): InitConfig | null;
+export declare function writeInitConfig(config: InitConfig, filePath?: string): void;
+/** Substitutes ${Provider1..3} and ${Model1..3} in template text from a
+ * resolved InitConfig. Unknown placeholders are left untouched (quickrun
+ * surfaces them separately so a lint failure names the real cause). */
+export declare function substituteInitPlaceholders(text: string, config: InitConfig): string;

package/dist/providers/seed-instruction.d.ts

@@ -1,3 +1,3 @@
 export declare const SEED_ACK = "ACK: waiting for explicit lmctl task.";
 export declare const SEED_INITIAL_PROMPT: string;
-export declare const MANUAL_SEED_POST_LAUNCH_NOTE = "send this exact lmctl seed instruction: \"lmctl seed initial connection only. Create or pin this provider session, then stop. Do not inspect files, run commands, infer a task, delegate, or edit. A dispatch that dies mid-turn is usually a timeout you set -- use --idle-timeout, not a shell timeout. Reply exactly: ACK: waiting for explicit lmctl task.\"";
+export declare const MANUAL_SEED_POST_LAUNCH_NOTE = "send this exact lmctl seed instruction: \"lmctl seed initial connection only. Create or pin this provider session, then stop. Do not inspect files, run commands, infer a task, delegate, or edit. Reply exactly: ACK: waiting for explicit lmctl task.\"";

package/dist/script/lmscript.d.ts

@@ -512,6 +512,20 @@ export interface ExecutionResult {
 export declare const LANGUAGE_DOCS: FunctionDoc[];
 export declare const BUILTIN_FUNCTION_DOCS: FunctionDoc[];
 export declare const STDLIB_FUNCTION_DOCS: FunctionDoc[];
+/**
+ * Real C/Perl/Python printf-style substitution for sprintf()/printf()
+ * (math.lmctl, 2026-09-29, defect B: sprintf/printf were aliased onto
+ * format(), which is Python str.format brace syntax -- `sprintf("%s=%s",
+ * a, b)` silently returned the literal template unsubstituted, because "%s"
+ * is not a brace placeholder. "%s is the ONLY reason anyone reaches for the
+ * name sprintf" -- so these two entry points get their OWN real % syntax,
+ * format() keeps braces. Deliberately minimal: %s/%d/%f/%%, no width/
+ * precision/padding modifiers -- add more only against a concrete need.
+ * Extra args with no corresponding %-directive are silently unused,
+ * matching real printf (not folded into a "no directives -> space-join"
+ * fallback, which would just be a second silently-wrong behavior).
+ */
+export declare function printfFormat(template: any, args: any[]): string;
 export declare class LMScript {
     private readonly hostFunctions;
     private readonly functionDocs;

package/examples/book-team.lmctl

@@ -22,4 +22,4 @@ _MEMBER_ alias=Lead provider=claude
 _MEMBER_ alias=Outliner provider=claude
 _MEMBER_ alias=Drafter provider=codex
 _MEMBER_ alias=Editor provider=codex
-_MEMBER_ alias=FactChecker provider=qwen
+_MEMBER_ alias=FactChecker provider=agy

package/examples/research-team.lmctl

@@ -21,5 +21,5 @@
 _MEMBER_ alias=Lead provider=claude
 _MEMBER_ alias=Researcher1 provider=codex
 _MEMBER_ alias=Researcher2 provider=claude
-_MEMBER_ alias=Critic provider=qwen
+_MEMBER_ alias=Critic provider=opencode
 _MEMBER_ alias=Synthesizer provider=codex

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lmctl-ai/lmctl",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "A provider-agnostic control plane for teams of AI coding agents — across providers, with independent review and durable memory.",
   "type": "module",
   "homepage": "https://lmctl.com",