agentsmesh 0.18.0 → 0.19.0

package/dist/{schema-B4PYQrZH.d.ts → schema-CLmR2JOb.d.ts}

@@ -145,7 +145,17 @@ interface CanonicalFiles {
     ignore: IgnorePatterns;
 }
 
-/** Zod schema for agentsmesh.yaml config validation */
+/**
+ * Zod schema for `agentsmesh.yaml` config validation.
+ *
+ * Every field except `version` uses `.default(...)` so the runtime parser
+ * substitutes a documented value when the user omits the key. The published
+ * JSON Schema removes these from the top-level `required` array via
+ * `stripRequiredFromDefaults()` in `src/schemas/schema-generator.ts`, so
+ * editors don't complain about valid minimal configs (a `version: 1`-only
+ * file is allowed). Runtime parser typing stays `T` (not `T | undefined`) —
+ * the post-process fix lives at the publishing layer only.
+ */
 declare const configSchema: z.ZodObject<{
     version: z.ZodLiteral<1>;
     targets: z.ZodDefault<z.ZodArray<z.ZodEnum<{
@@ -226,6 +236,12 @@ declare const configSchema: z.ZodObject<{
             windsurf: "windsurf";
             zed: "zed";
         }>>;
+        as: z.ZodOptional<z.ZodEnum<{
+            rules: "rules";
+            commands: "commands";
+            agents: "agents";
+            skills: "skills";
+        }>>;
         features: z.ZodArray<z.ZodEnum<{
             rules: "rules";
             commands: "commands";

package/dist/{target-descriptor-XZEis_Js.d.ts → target-descriptor-CkLWz3Xk.d.ts}

@@ -1,4 +1,4 @@
-import { b as CanonicalFiles, c as CanonicalRule, V as ValidatedConfig } from './schema-B4PYQrZH.js';
+import { b as CanonicalFiles, c as CanonicalRule, V as ValidatedConfig } from './schema-CLmR2JOb.js';
 
 /** Result of generating files for a target */
 interface GenerateResult {
@@ -36,6 +36,14 @@ interface LintDiagnostic {
 /** Feature support level per target */
 type SupportLevel = 'native' | 'embedded' | 'partial' | 'none';
 
+/**
+ * Generated catalog of builtin target IDs (directory names under `src/targets/`).
+ * No descriptor imports — keeps this module on the schema-safe side of the
+ * `schema.ts → descriptors → ValidatedConfig → schema.ts` cycle.
+ */
+declare const BUILTIN_TARGET_IDS: readonly ["aider", "amazon-q", "amp", "antigravity", "augment-code", "claude-code", "cline", "codex-cli", "continue", "copilot", "crush", "cursor", "deepagents-cli", "factory-droid", "gemini-cli", "goose", "jules", "junie", "kilo-code", "kiro", "opencode", "pi-agent", "qwen-code", "replit-agent", "roo-code", "rovodev", "trae", "warp", "windsurf", "zed"];
+type BuiltinTargetId = (typeof BUILTIN_TARGET_IDS)[number];
+
 /** Serialization / projection variant for a canonical feature (see architecture review §3.3). */
 type FeatureFlavor = 'standard' | 'workflows' | 'settings-embedded' | 'projected-skills' | 'gh-actions-lite' | string;
 /** Normalized capability entry: support level plus optional serialization flavor. */
@@ -49,6 +57,9 @@ type TargetCapabilityInput = SupportLevel | TargetCapabilityValue;
 /**
  * Capabilities of a target tool — each feature has a level and optional serialization flavor.
  * String levels are accepted for authoring; `getTargetCapabilities` normalizes to objects.
+ *
+ * The matching `SupportLevel` union lives in `core/types.ts` (`'native' | 'embedded' |
+ * 'partial' | 'none'`); every external consumer imports it from there.
  */
 type TargetCapabilities = Record<'rules' | 'additionalRules' | 'commands' | 'agents' | 'skills' | 'mcp' | 'hooks' | 'ignore' | 'permissions', TargetCapabilityInput>;
 /** Optional context passed to feature generators (flavor-aware targets). */
@@ -172,17 +183,6 @@ interface TargetImporterDescriptor {
     readonly ignore?: ImportFeatureSpec;
 }
 
-/**
- * Self-describing target descriptor interface.
- *
- * A new target exports one TargetDescriptor from its index.ts.
- * The catalog imports it and adds it to BUILTIN_TARGETS — that
- * is the only central registration step.
- *
- * Designed for future plugin support: plugins will export a
- * TargetDescriptor that gets registered at runtime.
- */
-
 /** Declared output families for reference rewriting and decoration (architecture P1-3). */
 interface TargetOutputFamily {
     readonly id: string;
@@ -206,8 +206,13 @@ type ExtraRuleOutputResolver = (rule: CanonicalFiles['rules'][number], context:
  * target-specific path logic after those guards pass.
  */
 interface TargetPathResolvers {
-    /** Output path for a non-root, non-filtered rule. */
-    rulePath(slug: string, rule: CanonicalRule): string;
+    /**
+     * Output path for a non-root, non-filtered rule, or `null` to suppress
+     * generation. Targets whose capability `rules === 'none'` for a given
+     * scope MUST return `null` so callers can drop the row rather than emit
+     * to a fabricated directory path.
+     */
+    rulePath(slug: string, rule: CanonicalRule): string | null;
     /** Output path for a command. Null suppresses generation. */
     commandPath(name: string, config: ValidatedConfig): string | null;
     /** Output path for an agent. Null suppresses generation. */
@@ -289,8 +294,14 @@ interface TargetMetadata {
  * Bundles everything needed to generate, import, lint, and detect a target.
  */
 interface TargetDescriptor {
-    /** Unique target identifier, e.g. 'claude-code' */
-    readonly id: string;
+    /**
+     * Unique target identifier, e.g. 'claude-code'. The `string & {}` widening
+     * keeps plugin ids assignable while still letting `BuiltinTargetId` literal
+     * checks (`if (id === 'claude-code')`) get autocomplete + typo protection
+     * in editor tooling. Runtime validation lives in
+     * `target-descriptor.schema.ts` (`/^[a-z][a-z0-9-]*$/`).
+     */
+    readonly id: BuiltinTargetId | (string & {});
     /** User-facing metadata (display name, category, URL, description) */
     readonly metadata: TargetMetadata;
     /** Feature generators (rules, commands, agents, etc.) */
@@ -361,6 +372,26 @@ interface TargetDescriptor {
      * this flag get a lint warning when canonical rules have `trigger: 'manual'`.
      */
     readonly preservesManualActivation?: boolean;
+    /**
+     * When true, `agentsmesh init` excludes this target from the default bulk
+     * starter scaffold. Used by codex-cli because its `AGENTS.md` index format
+     * collides with other AGENTS.md-first targets when multiple targets are
+     * scaffolded together. Explicit `--target codex-cli` still works.
+     */
+    readonly excludeFromStarterInit?: boolean;
+    /**
+     * Built-in default values for `commands_to_skills` / `agents_to_skills`
+     * conversion projections. A `true` value enables conversion by default; an
+     * explicit `false` disables it (still consults the user's per-target config
+     * override before honoring this default). When the field is `undefined`,
+     * `shouldConvert{Commands,Agents}ToSkills` falls back to the caller-supplied
+     * `defaultEnabled` argument (used by plugin targets that haven't declared
+     * a default).
+     */
+    readonly conversionDefaults?: {
+        readonly commandsToSkills?: boolean;
+        readonly agentsToSkills?: boolean;
+    };
 }
 
 export type { ContentNormalizer as C, ExtraRuleOutputContext as E, FeatureLinter as F, GenerateResult as G, ImportPathBuilder as I, LintDiagnostic as L, RuleLinter as R, ScopeExtrasFn as S, TargetCapabilities as T, ExtraRuleOutputResolver as a, GeneratedOutputMerger as b, GlobalTargetSupport as c, ImportResult as d, TargetDescriptor as e, TargetGenerators as f, TargetLayout as g, TargetLayoutScope as h, TargetLintHooks as i, TargetManagedOutputs as j, TargetOutputFamily as k, TargetPathResolvers as l };

package/dist/targets.d.ts

@@ -1,6 +1,6 @@
-import { e as TargetDescriptor, h as TargetLayoutScope, C as ContentNormalizer, d as ImportResult } from './target-descriptor-XZEis_Js.js';
-export { E as ExtraRuleOutputContext, a as ExtraRuleOutputResolver, F as FeatureLinter, b as GeneratedOutputMerger, c as GlobalTargetSupport, I as ImportPathBuilder, R as RuleLinter, S as ScopeExtrasFn, T as TargetCapabilities, f as TargetGenerators, g as TargetLayout, i as TargetLintHooks, j as TargetManagedOutputs, k as TargetOutputFamily, l as TargetPathResolvers } from './target-descriptor-XZEis_Js.js';
-import './schema-B4PYQrZH.js';
+import { e as TargetDescriptor, h as TargetLayoutScope, C as ContentNormalizer, d as ImportResult } from './target-descriptor-CkLWz3Xk.js';
+export { E as ExtraRuleOutputContext, a as ExtraRuleOutputResolver, F as FeatureLinter, b as GeneratedOutputMerger, c as GlobalTargetSupport, I as ImportPathBuilder, R as RuleLinter, S as ScopeExtrasFn, T as TargetCapabilities, f as TargetGenerators, g as TargetLayout, i as TargetLintHooks, j as TargetManagedOutputs, k as TargetOutputFamily, l as TargetPathResolvers } from './target-descriptor-CkLWz3Xk.js';
+import './schema-CLmR2JOb.js';
 import 'zod';
 
 /** Register a full target descriptor (for plugins). */