@fro.bot/systematic 2.33.2 → 3.0.0

package/dist/lib/setup.d.ts

@@ -0,0 +1,36 @@
+import fs from 'node:fs';
+/** The one package identity this module knows how to configure (literal check, not a resolver). */
+export declare const SYSTEMATIC_PACKAGE_NAME = "@fro.bot/systematic";
+/** The exact string written into a fresh Pi `packages` array entry. */
+export declare const PI_PACKAGE_IDENTIFIER = "npm:@fro.bot/systematic";
+export type Harness = 'opencode' | 'pi';
+/** Discriminated result: exactly one of these two states, never a boolean pair. */
+export type SetupResult = {
+    status: 'configured';
+    targetPath: string;
+} | {
+    status: 'already-configured';
+    targetPath: string;
+};
+/** Type guard for errors raised by `createSetupError`. */
+export declare function isSetupError(error: unknown): error is Error;
+/**
+ * Narrow filesystem seam for injecting failures (e.g. a broken `renameSync`)
+ * in tests. Default implementation is real `node:fs`.
+ */
+export interface SetupFsOps {
+    writeFileSync: typeof fs.writeFileSync;
+    renameSync: typeof fs.renameSync;
+    unlinkSync: typeof fs.unlinkSync;
+    chmodSync: typeof fs.chmodSync;
+}
+/**
+ * Configures the given harness's project-local config to load
+ * `@fro.bot/systematic`. Project-local only -- no `--global` mode. Writes
+ * are atomic, backed-up on real mutation, idempotent, and isolated per
+ * harness (setting up one never touches the other's config file).
+ *
+ * `opsOverride` is an injectable filesystem seam for tests exercising
+ * failure/cleanup paths; production callers should omit it.
+ */
+export declare function setupHarness(harness: Harness, cwd: string, opsOverride?: Partial<SetupFsOps>): SetupResult;

package/dist/lib/skill-loader.d.ts

@@ -1,4 +1,4 @@
-import type { SkillDeprecated, SkillInfo } from './skills.js';
+import type { SkillInfo } from './skills.js';
 export interface LoadedSkill {
     name: string;
     prefixedName: string;
@@ -12,7 +12,6 @@ export interface LoadedSkill {
     agent?: string;
     model?: string;
     argumentHint?: string;
-    deprecated?: SkillDeprecated;
 }
 export declare function formatSkillCommandName(name: string): string;
 export declare function formatSkillDescription(description: string, fallbackName: string): string;

package/dist/lib/skill-resolver.d.ts

@@ -0,0 +1,39 @@
+import { type LoadedSkill } from './skill-loader.js';
+/**
+ * Harness-neutral options shared by every adapter (OpenCode, Pi, ...).
+ */
+export interface SkillResolverOptions {
+    bundledSkillsDir: string;
+    disabledSkills: string[];
+}
+/**
+ * Resolves a requested skill name (with or without the `systematic:` prefix)
+ * against the bundled skill catalog. Throws the same not-found error text
+ * regardless of the calling harness.
+ */
+export declare function resolveSkill(options: SkillResolverOptions, requestedName: string): LoadedSkill;
+/**
+ * Deterministic, catalog-derived tool description shared by every harness.
+ */
+export declare function buildSkillToolDescription(options: SkillResolverOptions): string;
+/**
+ * Deterministic, catalog-derived parameter hint shared by every harness.
+ */
+export declare function buildSkillToolParameterHint(options: SkillResolverOptions): string;
+/**
+ * Builds the exact `<skill_content>`-wrapped output shared by every harness.
+ */
+export declare function buildSkillContentOutput(matchedSkill: LoadedSkill): {
+    output: string;
+    dir: string;
+};
+/**
+ * Discovers skill files in a directory and formats them as XML tags.
+ * Recursively searches subdirectories, includes hidden files, excludes .git and SKILL.md.
+ * Matches OpenCode v1.1.50 behavior exactly.
+ *
+ * @param dir - Directory path to search for skill files
+ * @param limit - Maximum number of files to return (default: 10)
+ * @returns String with absolute file paths formatted as XML tags, one per line
+ */
+export declare function discoverSkillFiles(dir: string, limit?: number): string;

package/dist/lib/skill-tool.d.ts

@@ -1,5 +1,6 @@
 import type { ToolDefinition } from '@opencode-ai/plugin';
-import { type SkillInfo } from './skills.js';
+import type { SkillInfo } from './skills.js';
+export { discoverSkillFiles } from './skill-resolver.js';
 export interface SkillToolOptions {
     bundledSkillsDir: string;
     disabledSkills: string[];
@@ -9,14 +10,4 @@ export interface SkillToolOptions {
  * Uses indented format matching OpenCode's native skill tool.
  */
 export declare function formatSkillsXml(skills: SkillInfo[]): string;
-/**
- * Discovers skill files in a directory and formats them as XML tags.
- * Recursively searches subdirectories, includes hidden files, excludes .git and SKILL.md.
- * Matches OpenCode v1.1.50 behavior exactly.
- *
- * @param dir - Directory path to search for skill files
- * @param limit - Maximum number of files to return (default: 10)
- * @returns String with absolute file paths formatted as XML tags, one per line
- */
-export declare function discoverSkillFiles(dir: string, limit?: number): string;
 export declare function createSkillTool(options: SkillToolOptions): ToolDefinition;

package/dist/lib/skills.d.ts

@@ -1,16 +1,9 @@
-export interface SkillDeprecated {
-    since: string;
-    removal: string;
-    replacement?: string;
-    reason?: string;
-}
 export interface SkillFrontmatter {
     name: string;
     description: string;
     license?: string;
     compatibility?: string;
     metadata?: Record<string, string>;
-    deprecated?: SkillDeprecated;
     disableModelInvocation?: boolean;
     userInvocable?: boolean;
     subtask?: boolean;
@@ -27,7 +20,6 @@ export interface SkillInfo {
     license?: string;
     compatibility?: string;
     metadata?: Record<string, string>;
-    deprecated?: SkillDeprecated;
     disableModelInvocation?: boolean;
     userInvocable?: boolean;
     subtask?: boolean;
@@ -36,7 +28,7 @@ export interface SkillInfo {
     argumentHint?: string;
     allowedTools?: string;
 }
-export declare const SKILL_FRONTMATTER_FIELDS: readonly ["name", "description", "argument-hint", "disable-model-invocation", "allowed-tools", "license", "compatibility", "metadata", "deprecated", "user-invocable", "agent", "model", "context", "subtask"];
+export declare const SKILL_FRONTMATTER_FIELDS: readonly ["name", "description", "argument-hint", "disable-model-invocation", "allowed-tools", "license", "compatibility", "metadata", "user-invocable", "agent", "model", "context", "subtask"];
 /**
  * Parse skill frontmatter from already-read file content. Split out from
  * `extractFrontmatter` so callers that also need the body (e.g. discovered-skill

package/dist/lib/source-model-defaults.d.ts

@@ -74,7 +74,7 @@ export interface CategoryDefault {
 }
 export type SourceCategoryDefaults = Record<string, CategoryDefault>;
 /**
- * Provider-grouped source model defaults for the 6 Systematic agent categories.
+ * Provider-grouped source model defaults for the 5 Systematic agent categories.
  *
  * Provider chains are ordered by OMO category-fit reasoning. The resolver
  * walks providers in order and picks the first available provider/model pair.

package/dist/pi.d.ts

@@ -0,0 +1,7 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+import { buildAgentCatalog } from './lib/agent-resolver.js';
+type PiExtensionDependencies = {
+    buildAgentCatalog?: typeof buildAgentCatalog;
+};
+export default function systematicPiExtension(pi: ExtensionAPI, deps?: PiExtensionDependencies): Promise<void>;
+export {};