@uniqbit/mate-core 0.18.4 → 1.0.0-canary.0

package/src/cli/main.ts

@@ -209,8 +209,11 @@ export async function main(argv = process.argv, deps: MainDeps = mainDeps): Prom
         case "prepare":
           if (!(await gate({ updateGuard: true }))) return;
           break;
-        // open/tui/sync/update consume a companion context.
+        // open lists every Linked Companion itself instead of selecting one.
         case "open":
+          if (!(await gate({ updateGuard: true, notHubRoot: true }))) return;
+          break;
+        // tui/sync/update consume a companion context.
         case "tui":
         case "sync":
         case "update":

package/src/cli/parse-flags.ts

@@ -1,6 +1,5 @@
 import {
   type GitModeSelection,
-  type OpenSpecSchemaSelection,
   listSetupCapabilityCompatibilities,
 } from "../lib/orchestrator/setup-compatibilities";
 import type { CapabilityConfig } from "../lib/orchestrator/types";
@@ -63,6 +62,31 @@ export function parseFlags(
   return flags;
 }
 
+/** Tokens that are neither flags nor flag values, read with the rules of {@link parseFlags}. */
+export function positionalArgs(
+  argv: string[],
+  booleanFlags: BooleanFlagSet = NO_BOOLEAN_FLAGS,
+): string[] {
+  const names: string[] = [];
+  for (let index = 0; index < argv.length; index += 1) {
+    const token = argv[index];
+    if (!token.startsWith("--")) names.push(token);
+    else if (token.includes("=") || booleanFlags.has(token.slice(2))) continue;
+    else if (argv[index + 1] && !argv[index + 1].startsWith("--")) index += 1;
+  }
+  return names;
+}
+
+/** A flag's value when it was given one, so a bare or repeated flag reads as absent. */
+export function stringFlag(value: CliFlags[string] | undefined): string | undefined {
+  return typeof value === "string" ? value : undefined;
+}
+
+/** The first of `names` given bare or more than once, which {@link stringFlag} would read as absent. */
+export function malformedValueFlag(flags: CliFlags, names: readonly string[]): string | undefined {
+  return names.find((name) => flags[name] !== undefined && typeof flags[name] !== "string");
+}
+
 export function parseAllowedAgents(flags: CliFlags): string[] | undefined {
   const allowedAgents = flags["allowed-agent"];
   return Array.isArray(allowedAgents)
@@ -95,12 +119,6 @@ export function parseCapabilities(flags: CliFlags): CapabilityConfig[] | undefin
   return names.map((name) => index.get(name) ?? { name });
 }
 
-export function parseOpenSpecSchema(flags: CliFlags): OpenSpecSchemaSelection | undefined {
-  const schema = flags["openspec-schema"];
-  if (schema === "mate-v1" || schema === "default") return schema;
-  return undefined;
-}
-
 export function parseGitMode(flags: CliFlags): GitModeSelection | undefined {
   const gitMode = flags["git-mode"];
   if (gitMode === "auto" || gitMode === "default") return gitMode;

package/src/cli/setup-selector.tsx

@@ -9,14 +9,10 @@ import { getRequiredPluginIds, withRequiredSelections } from "../tools/setup/pol
 
 import {
   type GitModeSelection,
-  type OpenSpecSchemaSelection,
   type SetupSelections,
-  applyOpenSpecSchemaSelection,
   DEFAULT_GIT_MODE_SELECTION,
-  getOpenSpecSchemaSelection,
   listSetupCapabilityCompatibilities,
   listSetupGitModeCompatibilities,
-  listSetupOpenSpecSchemaCompatibilities,
   listSetupPackageManagerCompatibilities,
   listSetupProviderCompatibilities,
 } from "../lib/orchestrator/setup-compatibilities";
@@ -28,16 +24,14 @@ interface SetupSelectorOptions {
   stderr?: NodeJS.WriteStream;
 }
 
-export type WizardStep = "providers" | "capabilities" | "openspecSchema" | "gitMode";
+export type WizardStep = "providers" | "capabilities" | "gitMode";
 
 interface SetupSelectorProps {
   activeIndex: number;
   currentStep: number;
-  steps: WizardStep[];
   selectedProviders: Set<string>;
   selectedPackageManagers: Set<string>;
   selectedCapabilities: Set<string>;
-  selectedOpenSpecSchema: OpenSpecSchemaSelection;
   selectedGitMode: GitModeSelection;
   onMounted?: () => void;
 }
@@ -47,7 +41,7 @@ export const setupSelectorDeps = {
 };
 
 export interface SetupSelectorItem {
-  kind: "provider" | "packageManager" | "capability" | "openspecSchema" | "gitMode";
+  kind: "provider" | "packageManager" | "capability" | "gitMode";
   id: string;
   label: string;
   description: string;
@@ -62,48 +56,17 @@ export interface SetupSelectorState {
   selectedProviders: Set<string>;
   selectedPackageManagers: Set<string>;
   selectedCapabilities: Set<string>;
-  selectedOpenSpecSchema: OpenSpecSchemaSelection;
   selectedGitMode: GitModeSelection;
 }
 
-const BASE_WIZARD_STEPS: readonly Exclude<WizardStep, "openspecSchema">[] = [
-  "providers",
-  "capabilities",
-  "gitMode",
-];
+export const WIZARD_STEPS: readonly WizardStep[] = ["providers", "capabilities", "gitMode"];
 
 const STEP_DISPLAY_NAMES: Record<WizardStep, string> = {
   providers: "Agents",
   capabilities: "Capabilities",
-  openspecSchema: "OpenSpec Schema Profile",
   gitMode: "Git Auto Mode",
 };
 
-export const OPENSPEC_SCHEMA_SKIP_MESSAGE = "OpenSpec not selected - skipping";
-
-function hasOpenSpecSelected(selectedCapabilities: Set<string>): boolean {
-  return selectedCapabilities.has("openspec");
-}
-
-export function getOpenSpecSchemaStepMessage(
-  step: WizardStep,
-  selectedCapabilities: Set<string>,
-): string | null {
-  return step === "openspecSchema" && !hasOpenSpecSelected(selectedCapabilities)
-    ? OPENSPEC_SCHEMA_SKIP_MESSAGE
-    : null;
-}
-
-export function buildWizardSteps(options: {
-  selectedCapabilities: Set<string>;
-  lockOpenSpecSchemaStep?: boolean;
-}): WizardStep[] {
-  if (!hasOpenSpecSelected(options.selectedCapabilities) && !options.lockOpenSpecSchemaStep) {
-    return [...BASE_WIZARD_STEPS];
-  }
-  return ["providers", "capabilities", "openspecSchema", "gitMode"];
-}
-
 export function parseSelectorInput(
   input: string,
 ): "up" | "down" | "toggle" | "submit" | "cancel" | "back" | null {
@@ -147,9 +110,7 @@ function markRequiredItems(items: SetupSelectorItem[]): SetupSelectorItem[] {
   );
 }
 
-export function getSelectableItems(
-  activeOpenSpecSchema?: OpenSpecSchemaSelection,
-): SetupSelectorItem[] {
+export function getSelectableItems(): SetupSelectorItem[] {
   const baseItems: SetupSelectorItem[] = [
     ...listSetupProviderCompatibilities().map((entry) => ({
       kind: "provider" as const,
@@ -177,12 +138,6 @@ export function getSelectableItems(
   return markRequiredItems([
     ...baseItems,
     ...getDistributionSelectorItems(knownIds),
-    ...listSetupOpenSpecSchemaCompatibilities(activeOpenSpecSchema).map((entry) => ({
-      kind: "openspecSchema" as const,
-      id: entry.id,
-      label: entry.label,
-      description: entry.description,
-    })),
     ...listSetupGitModeCompatibilities().map((entry) => ({
       kind: "gitMode" as const,
       id: entry.id,
@@ -192,17 +147,13 @@ export function getSelectableItems(
   ]);
 }
 
-export function getItemsForStep(
-  step: WizardStep,
-  activeOpenSpecSchema?: OpenSpecSchemaSelection,
-): SetupSelectorItem[] {
+export function getItemsForStep(step: WizardStep): SetupSelectorItem[] {
   const kindMap: Record<WizardStep, SetupSelectorItem["kind"]> = {
     providers: "provider",
     capabilities: "capability",
-    openspecSchema: "openspecSchema",
     gitMode: "gitMode",
   };
-  return getSelectableItems(activeOpenSpecSchema).filter((item) => item.kind === kindMap[step]);
+  return getSelectableItems().filter((item) => item.kind === kindMap[step]);
 }
 
 export function getDisabledCapabilityIds(selectedPackageManagers: Set<string>): Set<string> {
@@ -260,7 +211,6 @@ export function toggleSelectableItem(
     selectedProviders,
     selectedPackageManagers,
     selectedCapabilities,
-    selectedOpenSpecSchema: state.selectedOpenSpecSchema,
     selectedGitMode: state.selectedGitMode,
   };
 }
@@ -269,40 +219,30 @@ export function selectRadioItem(
   state: SetupSelectorState,
   current: SetupSelectorItem,
 ): SetupSelectorState {
-  if (current.kind !== "openspecSchema" && current.kind !== "gitMode") return state;
+  if (current.kind !== "gitMode") return state;
   return {
     selectedProviders: new Set(state.selectedProviders),
     selectedPackageManagers: new Set(state.selectedPackageManagers),
     selectedCapabilities: new Set(state.selectedCapabilities),
-    selectedOpenSpecSchema:
-      current.kind === "openspecSchema"
-        ? (current.id as OpenSpecSchemaSelection)
-        : state.selectedOpenSpecSchema,
-    selectedGitMode:
-      current.kind === "gitMode" ? (current.id as GitModeSelection) : state.selectedGitMode,
+    selectedGitMode: current.id as GitModeSelection,
   };
 }
 
 function getInitialActiveIndexForStep(
   step: WizardStep,
-  selectedOpenSpecSchema: OpenSpecSchemaSelection,
   selectedGitMode: GitModeSelection = DEFAULT_GIT_MODE_SELECTION,
 ): number {
-  if (step !== "openspecSchema" && step !== "gitMode") return 0;
-  const items = getItemsForStep(step, selectedOpenSpecSchema);
-  const selected = step === "gitMode" ? selectedGitMode : selectedOpenSpecSchema;
-  const index = items.findIndex((item) => item.id === selected);
+  if (step !== "gitMode") return 0;
+  const index = getItemsForStep(step).findIndex((item) => item.id === selectedGitMode);
   return index >= 0 ? index : 0;
 }
 
 function SetupSelectorApp({
   activeIndex,
   currentStep,
-  steps,
   selectedProviders,
   selectedPackageManagers,
   selectedCapabilities,
-  selectedOpenSpecSchema,
   selectedGitMode,
   onMounted,
 }: SetupSelectorProps) {
@@ -310,26 +250,18 @@ function SetupSelectorApp({
     onMounted?.();
   }, [onMounted]);
 
-  const totalSteps = steps.length;
-  const stepKey = steps[currentStep];
+  const totalSteps = WIZARD_STEPS.length;
+  const stepKey = WIZARD_STEPS[currentStep];
   const stepName = STEP_DISPLAY_NAMES[stepKey];
   const disabledCapabilityIds = getDisabledCapabilityIds(selectedPackageManagers);
-  const openSpecSkipMessage = getOpenSpecSchemaStepMessage(stepKey, selectedCapabilities);
-  const skipMessage = openSpecSkipMessage;
-  const showOpenSpecSkipMessage = skipMessage !== null;
-  const navigableItems = showOpenSpecSkipMessage
-    ? []
-    : getItemsForStep(stepKey, selectedOpenSpecSchema);
-  const isRadioStep =
-    (stepKey === "openspecSchema" || stepKey === "gitMode") && !showOpenSpecSkipMessage;
+  const navigableItems = getItemsForStep(stepKey);
+  const isRadioStep = stepKey === "gitMode";
   const isLastStep = currentStep === totalSteps - 1;
   const enterHint = isLastStep ? "enter confirm" : "enter next";
   const backHint = currentStep > 0 ? " · ← back" : "";
-  const footerHint = showOpenSpecSkipMessage
-    ? `${enterHint}${backHint} · q cancel`
-    : isRadioStep
-      ? `↑↓ navigate · enter select · ${enterHint}${backHint} · q cancel`
-      : `↑↓ navigate · space toggle · ${enterHint}${backHint} · q cancel`;
+  const footerHint = isRadioStep
+    ? `↑↓ navigate · enter select · ${enterHint}${backHint} · q cancel`
+    : `↑↓ navigate · space toggle · ${enterHint}${backHint} · q cancel`;
 
   const menuItems: SelectMenuItem[] = navigableItems.flatMap((item): SelectMenuItem[] => {
     if (item.kind === "provider") {
@@ -356,16 +288,6 @@ function SetupSelectorApp({
         },
       ];
     }
-    if (item.kind === "openspecSchema") {
-      return [
-        {
-          key: `openspecSchema:${item.id}`,
-          label: item.label,
-          description: item.description,
-          indicator: renderIndicator(selectedOpenSpecSchema === item.id, { mode: "radio" }),
-        },
-      ];
-    }
     if (item.kind === "gitMode") {
       return [
         {
@@ -384,15 +306,11 @@ function SetupSelectorApp({
       <WizardHeader title={stepName} step={currentStep} totalSteps={totalSteps} />
       {currentStep === 0 && <Text dimColor>Always installing: bun (node) · uv (python)</Text>}
       <Box marginTop={1} flexDirection="column">
-        {showOpenSpecSkipMessage ? (
-          <Text dimColor>{skipMessage}</Text>
-        ) : (
-          <SelectMenu
-            items={menuItems}
-            activeIndex={activeIndex}
-            mode={isRadioStep ? "radio" : "multi"}
-          />
-        )}
+        <SelectMenu
+          items={menuItems}
+          activeIndex={activeIndex}
+          mode={isRadioStep ? "radio" : "multi"}
+        />
       </Box>
       <WizardFooter hint={footerHint} />
     </Box>
@@ -426,11 +344,7 @@ export async function selectSetupCompatibilities(
     let selectedProviders = new Set(initialSelections.allowedAgents);
     let selectedPackageManagers = new Set(initialSelections.packageManagers);
     let selectedCapabilities = new Set(initialSelections.capabilities.map((entry) => entry.name));
-    let selectedOpenSpecSchema =
-      initialSelections.selectedOpenSpecSchema ??
-      getOpenSpecSchemaSelection(initialSelections.capabilities);
     let selectedGitMode = initialSelections.selectedGitMode;
-    let openSpecSchemaStepLocked = hasOpenSpecSelected(selectedCapabilities);
     let rendered: ReturnType<typeof inkRender> | undefined;
 
     const cleanup = () => {
@@ -449,31 +363,17 @@ export async function selectSetupCompatibilities(
       resolve(value);
     };
 
-    const getSteps = () =>
-      buildWizardSteps({
-        selectedCapabilities,
-        lockOpenSpecSchemaStep: openSpecSchemaStepLocked,
-      });
-
-    const getCurrentStep = () => getSteps()[currentStep];
-
-    const getCurrentItems = () => {
-      const step = getCurrentStep();
-      return step === "openspecSchema" && !hasOpenSpecSelected(selectedCapabilities)
-        ? []
-        : getItemsForStep(step, selectedOpenSpecSchema);
-    };
+    const getCurrentStep = () => WIZARD_STEPS[currentStep];
+    const getCurrentItems = () => getItemsForStep(getCurrentStep());
 
     const rerender = () => {
       rendered?.rerender(
         <SetupSelectorApp
           activeIndex={activeIndex}
           currentStep={currentStep}
-          steps={getSteps()}
           selectedProviders={selectedProviders}
           selectedPackageManagers={selectedPackageManagers}
           selectedCapabilities={selectedCapabilities}
-          selectedOpenSpecSchema={selectedOpenSpecSchema}
           selectedGitMode={selectedGitMode}
         />,
       );
@@ -510,14 +410,13 @@ export async function selectSetupCompatibilities(
       if (action === "toggle") {
         const stepItems = getCurrentItems();
         const current = stepItems[activeIndex];
-        if (!current || current.kind === "openspecSchema") return;
+        if (!current) return;
 
         const next = toggleSelectableItem(
           {
             selectedProviders,
             selectedPackageManagers,
             selectedCapabilities,
-            selectedOpenSpecSchema,
             selectedGitMode,
           },
           current,
@@ -525,7 +424,6 @@ export async function selectSetupCompatibilities(
         selectedProviders = next.selectedProviders;
         selectedPackageManagers = next.selectedPackageManagers;
         selectedCapabilities = next.selectedCapabilities;
-        selectedOpenSpecSchema = next.selectedOpenSpecSchema;
         selectedGitMode = next.selectedGitMode;
         activeIndex = Math.max(0, Math.min(activeIndex, getCurrentItems().length - 1));
         rerender();
@@ -534,20 +432,14 @@ export async function selectSetupCompatibilities(
 
       if (action === "submit") {
         const stepKey = getCurrentStep();
-        if (
-          (stepKey === "openspecSchema" && hasOpenSpecSelected(selectedCapabilities)) ||
-          stepKey === "gitMode"
-        ) {
+        if (stepKey === "gitMode") {
           const current = getCurrentItems()[activeIndex];
-          const selectedRadioValue =
-            stepKey === "gitMode" ? selectedGitMode : selectedOpenSpecSchema;
-          if (current && current.id !== selectedRadioValue) {
+          if (current && current.id !== selectedGitMode) {
             const next = selectRadioItem(
               {
                 selectedProviders,
                 selectedPackageManagers,
                 selectedCapabilities,
-                selectedOpenSpecSchema,
                 selectedGitMode,
               },
               current,
@@ -555,25 +447,15 @@ export async function selectSetupCompatibilities(
             selectedProviders = next.selectedProviders;
             selectedPackageManagers = next.selectedPackageManagers;
             selectedCapabilities = next.selectedCapabilities;
-            selectedOpenSpecSchema = next.selectedOpenSpecSchema;
             selectedGitMode = next.selectedGitMode;
             rerender();
             return;
           }
         }
 
-        if (stepKey === "capabilities" && hasOpenSpecSelected(selectedCapabilities)) {
-          openSpecSchemaStepLocked = true;
-        }
-
-        const steps = getSteps();
-        if (currentStep < steps.length - 1) {
+        if (currentStep < WIZARD_STEPS.length - 1) {
           currentStep++;
-          activeIndex = getInitialActiveIndexForStep(
-            steps[currentStep],
-            selectedOpenSpecSchema,
-            selectedGitMode,
-          );
+          activeIndex = getInitialActiveIndexForStep(WIZARD_STEPS[currentStep], selectedGitMode);
           rerender();
           return;
         }
@@ -583,19 +465,15 @@ export async function selectSetupCompatibilities(
         doResolve({
           allowedAgents: [...selectedProviders],
           packageManagers: [...selectedPackageManagers],
-          capabilities: applyOpenSpecSchemaSelection(
-            [
-              ...listSetupCapabilityCompatibilities()
-                .filter((entry) => selectedCapabilities.has(entry.capability.name))
-                .map((entry) => entry.capability),
-              // Distribution-registered capabilities without a builtin entry.
-              ...[...selectedCapabilities]
-                .filter((id) => !builtinCapabilityIds.has(id))
-                .map((id) => ({ name: id })),
-            ],
-            selectedOpenSpecSchema,
-          ),
-          selectedOpenSpecSchema,
+          capabilities: [
+            ...listSetupCapabilityCompatibilities()
+              .filter((entry) => selectedCapabilities.has(entry.capability.name))
+              .map((entry) => entry.capability),
+            // Distribution-registered capabilities without a builtin entry.
+            ...[...selectedCapabilities]
+              .filter((id) => !builtinCapabilityIds.has(id))
+              .map((id) => ({ name: id })),
+          ],
           selectedGitMode,
         });
         rendered?.unmount();
@@ -624,11 +502,9 @@ export async function selectSetupCompatibilities(
         <SetupSelectorApp
           activeIndex={activeIndex}
           currentStep={currentStep}
-          steps={getSteps()}
           selectedProviders={selectedProviders}
           selectedPackageManagers={selectedPackageManagers}
           selectedCapabilities={selectedCapabilities}
-          selectedOpenSpecSchema={selectedOpenSpecSchema}
           selectedGitMode={selectedGitMode}
           onMounted={onMounted}
         />,

package/src/cli/usage.ts

@@ -21,7 +21,7 @@ export function usage(): string {
     ` ${n} companion open`,
     ` ${n} companion tui`,
     ` ${n} working cleanup`,
-    ` ${n} wrap [--companion PATH] [--audience NAME]`,
+    ` ${n} wrap [--companion PATH]`,
     ` ${n} unwrap`,
     ` ${n} session prepare --repo <dir> [--json] [--sync]`,
     ` ${n} hub init [folder]`,
@@ -30,6 +30,10 @@ export function usage(): string {
     ` ${n} artifact publish <anchor|change-name> [--type openspec] [--no-push] [--json]`,
     "   target: a dated archive anchor, or a change name matching exactly one archive",
     ` ${n} artifact pending [--json]`,
+    ` ${n} artifact link <change>... [--repository <org/repo>] [--branch <b> [--direct]]`,
+    "   [--not-applicable <reason>] [--pr <url>] [--refresh]",
+    "   [--confirm-merged|--confirm-open|--confirm-dropped] [--json]",
+    ` ${n} artifact archive <change> [--repository <org/repo>] [--branch <b> [--direct]|--not-applicable <reason>|--skip-branch] [--json]`,
     ` ${n} doctor`,
     ` ${n} report [--days N] [--input FILE|-] [--json]`,
     ` ${n} studio [--writable] [--terminal] [--detach-timeout <minutes>]`,
@@ -54,7 +58,6 @@ export function usage(): string {
     "",
     "Wrapped repositories:",
     ` ${n} wrap configures the repository so sessions you start yourself load the companion`,
-    ` ${n} wrap --audience NAME gives those sessions one audience beside base; plain wrap returns to base`,
     ` ${n} claude does not run while a repository is wrapped for Claude`,
     ` ${n} opencode wraps the repository for OpenCode itself, then starts plain \`opencode\``,
     ` ${n} unwrap withdraws the wrap and restores managed launches; the link is kept`,