@danieljvdm/dev-kit 0.17.0 → 1.0.0

package/src/tool-metadata.ts

@@ -1,5 +1,3 @@
 import packageMetadata from "../package.json" with { type: "json" };
 
 export const DEV_KIT_VERSION = packageMetadata.version;
-export const VITE_PLUS_TESTED_VERSION = packageMetadata.devDependencies["vite-plus"];
-export const VITE_PLUS_SUPPORTED_RANGE = packageMetadata.peerDependencies["vite-plus"];

package/src/vendor.ts

@@ -22,8 +22,6 @@ export type CatalogRefreshOptions = {
   readonly updateSourceIds?: ReadonlyArray<string>;
   readonly pinSourceIds?: ReadonlyArray<string>;
 };
-/** @deprecated Use CatalogRefreshOptions. */
-export type VendorOptions = CatalogRefreshOptions;
 
 export type CatalogInspection = {
   readonly id: string;
@@ -158,11 +156,13 @@ const normalizeRepositoryLocator = (
     const normalized = `https://github.com/${owner}/${name}.git`;
 
     if (segments[2] === "tree" && segments[3]) {
-      return Effect.succeed({
-        repository: normalized,
-        ref: segments[3],
-        ...(segments.length > 4 ? { skillsPath: segments.slice(4).join("/") } : {}),
-      });
+      const locator = { repository: normalized, ref: segments[3] };
+
+      if (segments.length > 4) {
+        Object.assign(locator, { skillsPath: segments.slice(4).join("/") });
+      }
+
+      return Effect.succeed(locator);
     }
 
     return Effect.succeed({ repository: normalized });
@@ -493,13 +493,16 @@ const prepareSource = Effect.fn("prepareSkillSource")(function* (
     }
   }
 
-  return {
+  const prepared = {
     checkoutDir,
     resolved,
     skills,
     source,
-    ...(licenseSource ? { licenseSource } : {}),
-  } satisfies PreparedSource;
+  };
+
+  if (licenseSource) Object.assign(prepared, { licenseSource });
+
+  return prepared satisfies PreparedSource;
 });
 
 const readCurrentLock = Effect.fn("readCurrentSkillSourcesLock")(function* (lockfilePath: string) {
@@ -713,20 +716,31 @@ const buildLock = Effect.fn("buildSkillCatalogLock")(function* (
       }
       digests[skill] = observation.digest;
     }
-    sources.push({
+    const lockedSource = {
       id: source.id,
       repository: source.repository,
       ref: source.ref,
       resolved,
       skillsPath: source.skillsPath,
       include: source.include,
-      ...(source.exclude ? { exclude: source.exclude } : {}),
+    };
+
+    if (source.exclude) Object.assign(lockedSource, { exclude: source.exclude });
+
+    const completeLockedSource = Object.assign(lockedSource, {
       skills,
       descriptions,
       digests,
-      ...(source.licensePath ? { licensePath: source.licensePath } : {}),
-      ...(source.stripFrontmatter ? { stripFrontmatter: source.stripFrontmatter } : {}),
-    });
+    }) satisfies LockedSkillSource;
+
+    if (source.licensePath) {
+      Object.assign(completeLockedSource, { licensePath: source.licensePath });
+    }
+    if (source.stripFrontmatter) {
+      Object.assign(completeLockedSource, { stripFrontmatter: source.stripFrontmatter });
+    }
+
+    sources.push(completeLockedSource);
   }
 
   return { version: 1, sources } satisfies SkillSourcesLock;
@@ -807,15 +821,18 @@ export const inspectCatalogRepository = Effect.fn("inspectCatalogRepository")(fu
     }
   }
 
-  return {
+  const inspection: CatalogInspection = {
     id,
     repository,
     ref,
     resolved: prepared.resolved,
     skillsPath: source.skillsPath,
     skills,
-    ...(licensePath ? { licensePath } : {}),
-  } satisfies CatalogInspection;
+  };
+
+  if (licensePath) Object.assign(inspection, { licensePath });
+
+  return inspection;
 });
 
 export const refreshSkillCatalog = Effect.fn("refreshSkillCatalog")(function* (
@@ -936,6 +953,3 @@ export const refreshSkillCatalog = Effect.fn("refreshSkillCatalog")(function* (
   yield* fs.rename(nextLockPath, lockfilePath);
   yield* printStatus("success", "Catalog refreshed", summary);
 });
-
-/** @deprecated Use refreshSkillCatalog. */
-export const vendorExternalSkills = refreshSkillCatalog;

package/src/vite-plus.ts

@@ -80,9 +80,7 @@ const createTypecheckTask = (options: VitePlusTypecheckOptions | undefined) => {
 };
 
 /**
- * Build Dev Kit's recommended Vite+ quality defaults without owning the
- * consuming repository's `vite.config.ts`. Spread the result before local
- * project configuration.
+ * Build this repository's Vite+ quality defaults.
  */
 export const createRecommendedVitePlusConfig = (options: RecommendedVitePlusConfigOptions = {}) => {
   const ignorePatterns = [...devKitToolIgnorePatterns, ...(options.ignorePatterns ?? [])];

package/dev-kit.example.jsonc

@@ -1,22 +0,0 @@
-{
-  "$schema": "./schema/dev-kit.schema.json",
-  "include": ["dev-kit", "effect"],
-  "setup": {
-    "agentInstructions": { "enabled": true },
-    "claudeInstructions": { "enabled": true },
-    "effectSource": { "enabled": true },
-    "effectTsgo": { "enabled": true },
-    "vitePlus": {
-      "hooks": { "enabled": true },
-      "workflow": { "enabled": true },
-    },
-    "worktrunk": {
-      "config": { "enabled": true },
-    },
-  },
-  "targets": {
-    "agents": { "enabled": true, "mode": "copy" },
-    "claude": { "enabled": true, "mode": "symlink" },
-    "opencode": { "enabled": false, "mode": "symlink" },
-  },
-}

package/schema/dev-kit.schema.json

@@ -1,218 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://raw.githubusercontent.com/danieljvdm/dev-kit/main/schema/dev-kit.schema.json",
-  "title": "Dev Kit Manifest",
-  "description": "Project-local desired state for portable skills and explicit dev-kit setup tasks.",
-  "type": "object",
-  "additionalProperties": false,
-  "properties": {
-    "$schema": {
-      "type": "string"
-    },
-    "include": {
-      "description": "Static skill names, family names, or exact <package>#<skill> selectors to sync. Installed package skills are discovered for browsing but selected only when explicitly included.",
-      "type": "array",
-      "items": {
-        "type": "string",
-        "pattern": "^(?:[a-z0-9]+(?:-[a-z0-9]+)*|(?:[a-z0-9][a-z0-9._-]*|@[a-z0-9][a-z0-9._-]*/[a-z0-9][a-z0-9._-]*)#[a-z0-9]+(?:-[a-z0-9]+)*)$"
-      },
-      "uniqueItems": true,
-      "minItems": 0
-    },
-    "exclude": {
-      "description": "Static skill names, family names, or exact <package>#<skill> selectors to remove after expanding includes.",
-      "type": "array",
-      "items": {
-        "type": "string",
-        "pattern": "^(?:[a-z0-9]+(?:-[a-z0-9]+)*|(?:[a-z0-9][a-z0-9._-]*|@[a-z0-9][a-z0-9._-]*/[a-z0-9][a-z0-9._-]*)#[a-z0-9]+(?:-[a-z0-9]+)*)$"
-      },
-      "uniqueItems": true,
-      "default": []
-    },
-    "setup": {
-      "description": "Explicit setup tasks executed by dev-kit apply after dependencies are installed.",
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "agentInstructions": {
-          "$ref": "#/$defs/agentInstructionsSetup"
-        },
-        "claudeInstructions": {
-          "$ref": "#/$defs/claudeInstructionsSetup"
-        },
-        "effectSource": {
-          "$ref": "#/$defs/effectSourceSetup"
-        },
-        "effectTsgo": {
-          "$ref": "#/$defs/effectTsgoSetup"
-        },
-        "vitePlus": {
-          "$ref": "#/$defs/vitePlusSetup"
-        },
-        "worktrunk": {
-          "$ref": "#/$defs/worktrunkSetup"
-        }
-      },
-      "default": {}
-    },
-    "targets": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "agents": { "$ref": "#/$defs/target" },
-        "claude": { "$ref": "#/$defs/target" },
-        "opencode": { "$ref": "#/$defs/target" }
-      },
-      "default": {
-        "agents": { "enabled": true, "mode": "copy" }
-      }
-    }
-  },
-  "required": ["include"],
-  "$defs": {
-    "agentInstructionsSetup": {
-      "description": "Manage marked sections in project-root AGENTS.md with dev-kit guidance and conditional tool instructions while preserving handwritten content.",
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": false
-        }
-      }
-    },
-    "claudeInstructionsSetup": {
-      "description": "Manage CLAUDE.md as a relative symlink to the project-root AGENTS.md file.",
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": false
-        }
-      }
-    },
-    "effectSourceSetup": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": false
-        },
-        "packageName": {
-          "description": "Installed package whose exact version selects the Effect source tag.",
-          "type": "string",
-          "pattern": "^(?:[a-z0-9][a-z0-9._-]*|@[a-z0-9][a-z0-9._-]*/[a-z0-9][a-z0-9._-]*)$",
-          "default": "effect"
-        },
-        "path": {
-          "description": "Project-relative checkout destination.",
-          "type": "string",
-          "default": ".repos/effect"
-        },
-        "repository": {
-          "description": "Git repository containing effect@<version> tags.",
-          "type": "string",
-          "default": "https://github.com/Effect-TS/effect.git"
-        }
-      }
-    },
-    "effectTsgoSetup": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": false
-        },
-        "force": {
-          "description": "Pass the unsafe upstream --force escape hatch when no commit-exact binary matches.",
-          "type": "boolean",
-          "default": false
-        },
-        "typescriptPackage": {
-          "description": "Project-local native TypeScript package or alias for effect-tsgo to patch.",
-          "type": "string",
-          "pattern": "^(?:[a-z0-9][a-z0-9._-]*|@[a-z0-9][a-z0-9._-]*/[a-z0-9][a-z0-9._-]*)$",
-          "default": "typescript"
-        }
-      }
-    },
-    "vitePlusSetup": {
-      "description": "Manage project-local Vite+ setup tasks.",
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "hooks": {
-          "$ref": "#/$defs/vitePlusHooksSetup"
-        },
-        "workflow": {
-          "$ref": "#/$defs/vitePlusWorkflowSetup"
-        }
-      }
-    },
-    "vitePlusHooksSetup": {
-      "description": "Run the installed Vite+ configurator to converge Git hook dispatchers in each worktree.",
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": false
-        }
-      }
-    },
-    "vitePlusWorkflowSetup": {
-      "description": "Scaffold the canonical GitHub Actions check workflow (.github/workflows/check.yml); the repository owns the file after creation.",
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": false
-        }
-      }
-    },
-    "worktrunkSetup": {
-      "description": "Manage project-local Worktrunk setup tasks.",
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "config": {
-          "$ref": "#/$defs/worktrunkConfigSetup"
-        }
-      }
-    },
-    "worktrunkConfigSetup": {
-      "description": "Scaffold the default Worktrunk project config (.config/wt.toml) with portable pre-start and pre-merge hooks rendered for the repository's command runner; the repository owns the file after creation.",
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": false
-        }
-      }
-    },
-    "target": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "enabled": {
-          "type": "boolean",
-          "default": true
-        },
-        "mode": {
-          "description": "copy copies from the package source; symlink links to the primary agents target when possible.",
-          "enum": ["copy", "symlink"],
-          "default": "copy"
-        },
-        "path": {
-          "type": "string",
-          "description": "Project-relative destination directory for skill folders."
-        }
-      }
-    }
-  }
-}

package/schema/skill-sources.schema.json

@@ -1,83 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://raw.githubusercontent.com/danieljvdm/dev-kit/main/schema/skill-sources.schema.json",
-  "title": "External Agent Skill Sources",
-  "description": "Repository-level sources approved for the skill catalog.",
-  "type": "object",
-  "additionalProperties": false,
-  "properties": {
-    "$schema": {
-      "type": "string"
-    },
-    "sources": {
-      "type": "array",
-      "items": {
-        "$ref": "#/$defs/source"
-      }
-    }
-  },
-  "required": ["sources"],
-  "$defs": {
-    "source": {
-      "type": "object",
-      "additionalProperties": false,
-      "properties": {
-        "id": {
-          "description": "Unique source id. It also becomes broad family shorthand that selects every approved source skill in project manifests.",
-          "type": "string",
-          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
-        },
-        "repository": {
-          "description": "Git clone URL.",
-          "type": "string",
-          "minLength": 1
-        },
-        "ref": {
-          "description": "Git branch, tag, or commit to resolve when updating.",
-          "type": "string",
-          "minLength": 1
-        },
-        "skillsPath": {
-          "description": "Repository-relative directory containing skill folders.",
-          "type": "string",
-          "minLength": 1
-        },
-        "include": {
-          "description": "Explicit skill names, or [\"*\"] to approve every skill found under skillsPath.",
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^(\\*|[a-z0-9]+(-[a-z0-9]+)*)$"
-          },
-          "uniqueItems": true,
-          "minItems": 1
-        },
-        "exclude": {
-          "description": "Skills to subtract after expanding include, primarily for [\"*\"] sources.",
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
-          },
-          "uniqueItems": true,
-          "default": []
-        },
-        "licensePath": {
-          "description": "Optional repository-relative license file validated during catalog refresh.",
-          "type": "string",
-          "minLength": 1
-        },
-        "stripFrontmatter": {
-          "description": "Optional upstream frontmatter keys to remove for local harness compatibility.",
-          "type": "array",
-          "items": {
-            "type": "string",
-            "pattern": "^[A-Za-z0-9_-]+$"
-          },
-          "uniqueItems": true
-        }
-      },
-      "required": ["id", "repository", "ref", "skillsPath", "include"]
-    }
-  }
-}

package/src/index.ts

@@ -1,125 +0,0 @@
-export {
-  type AgentInstructionsSetup,
-  AgentInstructionsSetupSchema,
-  type ClaudeInstructionsSetup,
-  ClaudeInstructionsSetupSchema,
-  type DevKitManifest,
-  DevKitManifestSchema,
-  type EffectSourceSetup,
-  EffectSourceSetupSchema,
-  type EffectTsgoSetup,
-  EffectTsgoSetupSchema,
-  type HarnessTarget,
-  TargetConfigSchema,
-  type VitePlusSetup,
-  VitePlusSetupSchema,
-  type VitePlusWorkflowSetup,
-  VitePlusWorkflowSetupSchema,
-  type WorktrunkConfigSetup,
-  WorktrunkConfigSetupSchema,
-  type WorktrunkSetup,
-  WorktrunkSetupSchema,
-} from "./manifest.ts";
-export {
-  applyEffectSourcePlan,
-  EffectSourceCheckoutError,
-  EffectSourceDependencyError,
-  type EffectSourceOptions,
-  type EffectSourcePlan,
-  planEffectSource,
-  syncEffectSource,
-} from "./effect-source.ts";
-export {
-  CANONICAL_REPOSITORIES_DIRECTORY,
-  DEV_KIT_GITIGNORE_ENTRIES,
-  GitignoreConflictError,
-  patchGitignoreContents,
-  patchProjectGitignore,
-  type GitignoreOptions,
-  type GitignorePatch,
-  UnsafeGitignorePathError,
-} from "./gitignore.ts";
-export {
-  EFFECT_TSGO_PLUGIN_NAME,
-  EFFECT_TSGO_TYPESCRIPT_VERSION,
-  EFFECT_TSGO_VERSION,
-  type EffectTsgoDiagnosticSeverity,
-  EffectTsgoDependencyError,
-  InvalidEffectTsgoPackageNameError,
-  type EffectTsgoPatchOptions,
-  type EffectTsgoPatchPlan,
-  type EffectTsgoPluginConfig,
-  EffectTsgoPatchCommandError,
-  patchEffectTsgo,
-  planEffectTsgoPatch,
-  recommendedEffectTsgoPlugin,
-} from "./effect-tsgo.ts";
-export {
-  ExternalSkillSourceSchema,
-  type ExternalSkillSource,
-  LockedSkillSourceSchema,
-  type LockedSkillSource,
-  SkillSourcesLockSchema,
-  type SkillSourcesLock,
-  SkillSourcesManifestSchema,
-  type SkillSourcesManifest,
-} from "./source-manifest.ts";
-export {
-  planProjectSkills,
-  printSkillPlan,
-  runProjectSkillPlan,
-  type SkillPlan,
-  type SyncOptions,
-} from "./sync.ts";
-export {
-  AppliedStateSchema,
-  CatalogProvenanceSchema,
-  DevKitLockSchema,
-  EffectSourceLockSchema,
-  EffectTsgoLockSchema,
-  ManagedAgentInstructionsOutputSchema,
-  ManagedClaudeInstructionsOutputSchema,
-  ManagedGeneratedFileOutputSchema,
-  ManagedInstructionOutputSchema,
-  ManagedOutputSchema,
-  ManagedSkillOutputSchema,
-  OwnershipReceiptSchema,
-  type AppliedState,
-  type CatalogProvenance,
-  type DevKitLock,
-  type EffectSourceLock,
-  type EffectTsgoLock,
-  type ManagedAgentInstructionsOutput,
-  type ManagedClaudeInstructionsOutput,
-  type ManagedGeneratedFileOutput,
-  type ManagedInstructionOutput,
-  type ManagedOutput,
-  type ManagedSkillOutput,
-  type OwnershipReceipt,
-} from "./project-state.ts";
-export {
-  refreshSkillCatalog,
-  vendorExternalSkills,
-  type CatalogRefreshOptions,
-  type VendorOptions,
-} from "./vendor.ts";
-export {
-  loadSkillCatalog,
-  resolveSkillSources,
-  type CatalogSkill,
-  type ResolvedSkillSource,
-  type SkillCatalog,
-} from "./catalog.ts";
-export {
-  addCatalogSource,
-  listCatalogSources,
-  removeCatalogEntry,
-  showCatalogSource,
-  type CatalogAddOptions,
-  type CatalogCommandOptions,
-} from "./catalog-manager.ts";
-export {
-  inspectCatalogRepository,
-  type CatalogInspection,
-  type CatalogInspectOptions,
-} from "./vendor.ts";