@ai-outfitter/outfitter 0.9.0 → 0.11.0

package/src/schemas/profile.schema.json

@@ -42,7 +42,7 @@
         },
         "skills": {
           "type": "array",
-          "items": { "type": "string" }
+          "items": { "$ref": "#/$defs/skillEntry" }
         },
         "prompt_template": { "type": "string" },
         "system_prompt": { "type": "string" },
@@ -81,7 +81,7 @@
             },
             "skills": {
               "type": "array",
-              "items": { "type": "string" }
+              "items": { "$ref": "#/$defs/skillEntry" }
             },
             "prompt_template": { "type": "string" },
             "system_prompt": { "type": "string" },
@@ -111,7 +111,7 @@
             },
             "skills": {
               "type": "array",
-              "items": { "type": "string" }
+              "items": { "$ref": "#/$defs/skillEntry" }
             },
             "prompt_template": { "type": "string" },
             "system_prompt": { "type": "string" },
@@ -129,6 +129,43 @@
   },
   "additionalProperties": true,
   "$defs": {
+    "skillReference": {
+      "oneOf": [
+        {
+          "type": "object",
+          "required": ["file"],
+          "properties": {
+            "file": { "type": "string" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["repo_file"],
+          "properties": {
+            "repo_file": { "type": "string" }
+          },
+          "additionalProperties": false
+        }
+      ]
+    },
+    "skillEntry": {
+      "oneOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "required": ["id"],
+          "properties": {
+            "id": { "type": "string" },
+            "references": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/skillReference" }
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
+    },
     "appendSystemPromptEntry": {
       "oneOf": [
         { "type": "string" },

package/dist/agents/OutfitterDocs.d.ts

@@ -1,2 +0,0 @@
-export declare const resolveOutfitterDocsDirectory: () => string | undefined;
-export declare const createOutfitterDocsSystemPrompt: (docsDirectory: string) => string;

package/dist/agents/OutfitterDocs.js

@@ -1,38 +0,0 @@
-// Points launched agents at the bundled user-facing Outfitter documentation.
-//
-// This mirrors pi's own self-documentation mechanism: pi's default system prompt
-// lists absolute paths to the docs shipped inside the pi package with guidance to
-// read them only when the user asks about pi itself. Outfitter appends the same
-// kind of section for its own documentation so an Outfitter-managed agent can
-// explain Outfitter features and iterate on its own profiles.
-import { existsSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-const packageRootDirectory = join(dirname(fileURLToPath(import.meta.url)), '..', '..');
-// The docs live at <repo>/docs/documentation in the repository layout and are
-// staged to <package>/doc/documentation by scripts/sync-package-assets.mjs for
-// the published npm package.
-export const resolveOutfitterDocsDirectory = () => {
-    const repositoryDocsPath = join(packageRootDirectory, '..', '..', 'docs', 'documentation');
-    const packageDocsPath = join(packageRootDirectory, 'doc', 'documentation');
-    /* v8 ignore else -- packaged npm layout is exercised after pack, not unit tests. */
-    if (existsSync(repositoryDocsPath)) {
-        return repositoryDocsPath;
-    }
-    /* v8 ignore next 3 -- packaged npm layout is exercised after pack, not unit tests. */
-    if (existsSync(packageDocsPath)) {
-        return packageDocsPath;
-    }
-    /* v8 ignore next -- defensive fallback for installs that exclude documentation assets. */
-    return undefined;
-};
-export const createOutfitterDocsSystemPrompt = (docsDirectory) => {
-    return [
-        'Outfitter documentation (read only when the user asks about Outfitter itself — profiles, settings, profile catalogs, setup sources, state persistence, or how to inspect or change this launch configuration):',
-        `- Documentation index: ${join(docsDirectory, 'README.md')}`,
-        `- Additional docs: ${docsDirectory}`,
-        '- When asked about: getting started (getting-started.md), profiles and profile layouts (profiles.md), shared profile repositories and catalogs (profile-repository.md), state persistence (state.md), switching from another agent CLI (switching-to-outfitter.md), first-time CLI agent users (first-time-cli-agent-users.md), iterating on a local or worktree profile — including improving your own active profile (iterating-on-profiles.md)',
-        '- When reading Outfitter docs, resolve relative links against the documentation directory, read the referenced .md files completely, and follow cross-references before answering or editing profiles.',
-    ].join('\n');
-};
-//# sourceMappingURL=OutfitterDocs.js.map

package/dist/agents/OutfitterDocs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"OutfitterDocs.js","sourceRoot":"","sources":["../../src/agents/OutfitterDocs.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,iFAAiF;AACjF,kFAAkF;AAClF,gFAAgF;AAChF,8EAA8E;AAC9E,8DAA8D;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,oBAAoB,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEvF,8EAA8E;AAC9E,+EAA+E;AAC/E,6BAA6B;AAC7B,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAuB,EAAE;IACpE,MAAM,kBAAkB,GAAG,IAAI,CAAC,oBAAoB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IAC3F,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;IAE3E,oFAAoF;IACpF,IAAI,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACnC,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,sFAAsF;IACtF,IAAI,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAChC,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,0FAA0F;IAC1F,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,aAAqB,EAAU,EAAE;IAC/E,OAAO;QACL,gNAAgN;QAChN,0BAA0B,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,EAAE;QAC5D,sBAAsB,aAAa,EAAE;QACrC,mbAAmb;QACnb,wMAAwM;KACzM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC,CAAC"}

package/skills/outfitter/SKILL.md

@@ -1,68 +0,0 @@
----
-name: outfitter
-description: Help users create, inspect, and maintain Outfitter profiles, settings, setup sources, and Pi launch loadouts. Use when a user invokes /outfitter or asks for help setting up Outfitter-managed profiles, profile.yml files, profile sources, default profiles, skills, extensions, prompts, or setup repositories.
----
-
-# Outfitter
-
-Use this skill to guide profile setup for Outfitter-managed Pi sessions.
-
-## Default behavior
-
-If the user invokes `/outfitter` without a specific request:
-
-1. Run `outfitter profile list` to show available profiles.
-2. Summarize the profiles by name, scope/source when visible, and default status when visible.
-3. Ask whether the user wants to create a new profile.
-4. If they do, ask for the intended profile ID and scope before running `outfitter profile create`.
-
-## Workflow
-
-1. Inspect the current directory and home configuration before editing:
-   - `.outfitter/settings.yml`
-   - `.outfitter/local/settings.yml`
-   - `.outfitter/profiles/*/profile.yml`
-   - `~/.outfitter/settings.yml`
-2. Identify the intended scope:
-   - user profile: reusable across projects
-   - project profile: checked into the repository
-   - project-local profile: private machine-specific overrides
-3. Prefer existing commands before manual file edits:
-   - `outfitter setup <source>` to import setup sources
-   - `outfitter sync` to refresh remote profile sources
-   - `outfitter profile list` to inspect available profiles
-   - `outfitter profile create <id> --scope user|project|project-local` to scaffold profiles
-   - `outfitter run --profile <id>` to verify launch behavior
-4. Keep profile changes focused:
-   - put reusable resources under `skills/`, `prompts/`, `extensions/`, or `deepwork/jobs/`
-   - put Pi-only resources under `cli_specific/pi/`
-   - put Claude-only resources under `cli_specific/claude/`
-5. Validate profile YAML against the current schema and run a smoke test with `outfitter run --profile <id> -- --help` when possible.
-
-## Profile skeleton
-
-```yaml
-id: engineer
-label: Engineer
-
-controls:
-  provider: openai-codex
-  model: gpt-5.5
-  thinking: xhigh
-  append_system_prompt:
-    - ./prompts/engineering.md
-  skills:
-    - ./skills/review
-  pi:
-    extensions:
-      - git:github.com/ai-outfitter/ulta-tasklist
-      - git:github.com/ai-outfitter/deepwork
-    skills:
-      - ./cli_specific/pi/skills/outfitter
-```
-
-## Notes
-
-- Use profile IDs matching lowercase letters, digits, `.`, `_`, and `-`.
-- Use `template: true` only for inheritance-only profiles.
-- Do not store provider secrets in profile files; use Pi login, environment variables, or the user's private agent state.