npm - agent-skillboard - Versions diffs - 0.1.0 - Mend

agent-skillboard 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (94) hide show

package/CONTRIBUTING.md +83 -0
package/LICENSE +21 -0
package/README.md +645 -0
package/bin/skillboard.mjs +4 -0
package/docs/adapters.md +127 -0
package/docs/capabilities.md +107 -0
package/docs/install.md +346 -0
package/docs/plans/20260625-080025-skillboard-mvp-review.md +189 -0
package/docs/plans/README.md +20 -0
package/docs/policy-model.md +251 -0
package/docs/positioning.md +94 -0
package/docs/profiles.md +166 -0
package/docs/rollout-runbook.md +60 -0
package/docs/user-flow.md +231 -0
package/docs/versioning.md +201 -0
package/examples/multi-source-skills/anthropic/docx/SKILL.md +8 -0
package/examples/multi-source-skills/anthropic/skill-creator/SKILL.md +8 -0
package/examples/multi-source-skills/matt/grill-me/SKILL.md +8 -0
package/examples/multi-source-skills/matt/tdd/SKILL.md +8 -0
package/examples/multi-source-skills/omo/review-work/SKILL.md +8 -0
package/examples/multi-source-skills/omo/ulw-plan/SKILL.md +8 -0
package/examples/multi-source-skills/private/tdd-work-continuity/SKILL.md +8 -0
package/examples/multi-source-skills/private/workflow-router/SKILL.md +8 -0
package/examples/multi-source-skills/wshobson/python-testing/SKILL.md +8 -0
package/examples/multi-source-skills/wshobson/security-review/SKILL.md +8 -0
package/examples/multi-source.config.yaml +271 -0
package/examples/skillboard.config.yaml +194 -0
package/examples/skills/grill-me/SKILL.md +9 -0
package/examples/skills/grill-with-docs/SKILL.md +9 -0
package/examples/skills/requirement-intake/SKILL.md +9 -0
package/examples/skills/tdd/SKILL.md +8 -0
package/package.json +58 -0
package/profiles/anthropics-skills.yaml +17 -0
package/profiles/mattpocock-skills.yaml +26 -0
package/profiles/oh-my-openagent.yaml +32 -0
package/profiles/voltagent-awesome-agent-skills.yaml +18 -0
package/profiles/wshobson-agents.yaml +19 -0
package/src/advisor/action-core.mjs +74 -0
package/src/advisor/actions.mjs +256 -0
package/src/advisor/application-commands.mjs +59 -0
package/src/advisor/apply-action.mjs +183 -0
package/src/advisor/schema.mjs +112 -0
package/src/advisor/setup-actions.mjs +42 -0
package/src/advisor/skills.mjs +191 -0
package/src/advisor/sort.mjs +15 -0
package/src/advisor/sources.mjs +160 -0
package/src/advisor/trust-policy.mjs +65 -0
package/src/advisor/workflow.mjs +41 -0
package/src/advisor.mjs +134 -0
package/src/agent-inventory-platforms.mjs +100 -0
package/src/agent-inventory.mjs +804 -0
package/src/brief-cli.mjs +40 -0
package/src/brief-renderer.mjs +362 -0
package/src/change-plan.mjs +169 -0
package/src/cli.mjs +1171 -0
package/src/config-helpers.mjs +72 -0
package/src/control/can-use-guard.mjs +91 -0
package/src/control/config-write.mjs +163 -0
package/src/control/skill-crud.mjs +394 -0
package/src/control/source-trust.mjs +161 -0
package/src/control/workflow-crud.mjs +104 -0
package/src/control.mjs +197 -0
package/src/doctor.mjs +299 -0
package/src/domain/constants.mjs +47 -0
package/src/domain/indexes.mjs +29 -0
package/src/domain/rules/capabilities.mjs +33 -0
package/src/domain/rules/harnesses.mjs +16 -0
package/src/domain/rules/install-units.mjs +95 -0
package/src/domain/rules/skills.mjs +105 -0
package/src/domain/rules/workflows.mjs +105 -0
package/src/domain/skill-state-matrix.mjs +79 -0
package/src/domain/source-classes.mjs +99 -0
package/src/hook-plan.mjs +152 -0
package/src/impact.mjs +41 -0
package/src/index.mjs +82 -0
package/src/init.mjs +136 -0
package/src/install-output-detector.mjs +337 -0
package/src/install-units.mjs +62 -0
package/src/inventory-refresh.mjs +45 -0
package/src/lifecycle-cli.mjs +166 -0
package/src/lifecycle-content.mjs +87 -0
package/src/policy.mjs +42 -0
package/src/reconcile.mjs +111 -0
package/src/report.mjs +151 -0
package/src/review.mjs +88 -0
package/src/rollout.mjs +453 -0
package/src/skill-paths.mjs +17 -0
package/src/source-cache.mjs +178 -0
package/src/source-profile-loader.mjs +160 -0
package/src/source-profiles.mjs +299 -0
package/src/source-verification.mjs +252 -0
package/src/uninstall.mjs +258 -0
package/src/workspace.mjs +219 -0
package/tsconfig.lsp.json +15 -0

package/src/workspace.mjs ADDED Viewed

@@ -0,0 +1,219 @@
+import { readdir, readFile, realpath, stat } from "node:fs/promises";
+import { join, relative } from "node:path";
+import YAML from "yaml";
+import {
+  readBoolean,
+  readOptionalString,
+  readString,
+  readStringList,
+  requireRecord
+} from "./config-helpers.mjs";
+import {
+  EXPOSURE_VALUES,
+  HARNESS_STATUS_VALUES,
+  INVOCATION_VALUES,
+  STATUS_VALUES
+} from "./domain/constants.mjs";
+import { parseInstallUnits } from "./install-units.mjs";
+import { normalizeSkillPath } from "./skill-paths.mjs";
+export async function loadWorkspace(options) {
+  const configText = await readFile(options.configPath, "utf8");
+  const parsed = YAML.parse(configText);
+  const config = requireRecord(parsed, "config root");
+  const version = parseVersion(config.version);
+  const skills = parseSkills(config.skills);
+  return {
+    version,
+    defaults: parseDefaults(config.defaults),
+    installedSkills: await discoverInstalledSkills(options.skillsRoot, skills),
+    skills,
+    capabilities: parseCapabilities(config.capabilities),
+    harnesses: parseHarnesses(config.harnesses),
+    installUnits: parseInstallUnits(config.install_units),
+    workflows: parseWorkflows(config.workflows)
+  };
+}
+async function discoverInstalledSkills(skillsRoot, declaredSkills) {
+  if (skillsRoot === undefined) {
+    return [];
+  }
+  const skillFiles = await findSkillFiles(skillsRoot);
+  const installed = [];
+  for (const file of skillFiles) {
+    const frontmatter = parseSkillFrontmatter(await readFile(file, "utf8"));
+    const path = relative(skillsRoot, file).replaceAll("\\", "/").replace(/\/SKILL\.md$/, "");
+    const declared = declaredSkills.find((skill) => skill.path === path);
+    installed.push({
+      id: declared?.id ?? frontmatter.name ?? path,
+      name: frontmatter.name,
+      description: frontmatter.description,
+      path
+    });
+  }
+  return installed.sort((left, right) => left.path.localeCompare(right.path));
+}
+async function findSkillFiles(root, seen = new Set()) {
+  const files = [];
+  const resolvedRoot = await realpath(root).catch(() => root);
+  if (seen.has(resolvedRoot)) {
+    return files;
+  }
+  seen.add(resolvedRoot);
+  const entries = await readdir(root, { withFileTypes: true }).catch(() => []);
+  for (const entry of entries) {
+    const path = join(root, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...(await findSkillFiles(path, seen)));
+    } else if (entry.isSymbolicLink()) {
+      const target = await stat(path).catch(() => undefined);
+      if (target?.isDirectory()) {
+        files.push(...(await findSkillFiles(path, seen)));
+      } else if (target?.isFile() && entry.name === "SKILL.md") {
+        files.push(path);
+      }
+    } else if (entry.isFile() && entry.name === "SKILL.md") {
+      files.push(path);
+    }
+  }
+  return files;
+}
+function parseSkillFrontmatter(text) {
+  const match = /^---[ \t]*\r?\n(?<body>[\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/.exec(text);
+  if (match?.groups === undefined) {
+    throw new Error(
+      "SKILL.md is missing YAML frontmatter. " +
+      "Add --- delimiters at the top of the file with at least 'name' and 'description'.\n" +
+      "Example:\n" +
+      "---\n" +
+      "name: my-skill\n" +
+      "description: What this skill does in one sentence.\n" +
+      "---\n" +
+      "See docs/user-flow.md for the first-time skill guide."
+    );
+  }
+  const raw = requireRecord(YAML.parse(match.groups.body), "SKILL.md frontmatter");
+  return {
+    name: readString(raw, "name", ""),
+    description: readString(raw, "description", "")
+  };
+}
+function parseVersion(value) {
+  if (value === undefined) {
+    return 1;
+  }
+  if (value !== 1) {
+    throw new Error(`Unsupported config version: ${value}`);
+  }
+  return value;
+}
+function parseDefaults(value) {
+  const raw = requireRecord(value ?? {}, "defaults");
+  return {
+    invocationPolicy: readString(raw, "invocation_policy", "deny-by-default"),
+    allowModelInvocation: readBoolean(raw, "allow_model_invocation", false),
+    requireExplicitWorkflow: readBoolean(raw, "require_explicit_workflow", true)
+  };
+}
+function parseSkills(value) {
+  const raw = requireRecord(value ?? {}, "skills");
+  return Object.entries(raw).map(([id, entry]) => {
+    const skill = requireRecord(entry, `skills.${id}`);
+    const status = readString(skill, "status", "vendor");
+    const invocation = readString(skill, "invocation", "manual-only");
+    const exposure = readString(skill, "exposure", "exported");
+    if (!STATUS_VALUES.has(status)) {
+      throw new Error(`Unsupported status for ${id}: ${status}`);
+    }
+    if (!INVOCATION_VALUES.has(invocation)) {
+      throw new Error(`Unsupported invocation for ${id}: ${invocation}`);
+    }
+    if (!EXPOSURE_VALUES.has(exposure)) {
+      throw new Error(`Unsupported exposure for ${id}: ${exposure}`);
+    }
+    return {
+      id,
+      path: normalizeSkillPath(readString(skill, "path", id), `skills.${id}.path`),
+      status,
+      invocation,
+      exposure,
+      category: readString(skill, "category", "uncategorized"),
+      canonicalFor: readStringList(skill, "canonical_for"),
+      conflictsWith: readStringList(skill, "conflicts_with"),
+      replacedBy: readOptionalString(skill, "replaced_by"),
+      ownerInstallUnit: readOptionalString(skill, "owner_install_unit")
+    };
+  });
+}
+function parseCapabilities(value) {
+  const raw = requireRecord(value ?? {}, "capabilities");
+  return Object.entries(raw).map(([name, entry]) => {
+    const capability = requireRecord(entry, `capabilities.${name}`);
+    const defaultPolicy = readString(capability, "default_policy", "manual-only");
+    if (!INVOCATION_VALUES.has(defaultPolicy)) {
+      throw new Error(`Unsupported capability default_policy for ${name}: ${defaultPolicy}`);
+    }
+    return {
+      name,
+      canonical: readString(capability, "canonical", ""),
+      alternatives: readStringList(capability, "alternatives"),
+      defaultPolicy
+    };
+  });
+}
+function parseHarnesses(value) {
+  const raw = requireRecord(value ?? {}, "harnesses");
+  return Object.entries(raw).map(([name, entry]) => {
+    const harness = requireRecord(entry, `harnesses.${name}`);
+    const status = readString(harness, "status", "available");
+    if (!HARNESS_STATUS_VALUES.has(status)) {
+      throw new Error(`Unsupported harness status for ${name}: ${status}`);
+    }
+    return {
+      name,
+      status,
+      workflows: readStringList(harness, "workflows"),
+      commands: readStringList(harness, "commands")
+    };
+  });
+}
+function parseWorkflows(value) {
+  const raw = requireRecord(value ?? {}, "workflows");
+  return Object.entries(raw).map(([name, entry]) => {
+    const workflow = requireRecord(entry, `workflows.${name}`);
+    return {
+      name,
+      harness: readString(workflow, "harness", "unspecified"),
+      activeSkills: readStringList(workflow, "active_skills"),
+      blockedSkills: readStringList(workflow, "blocked_skills"),
+      requiredOutputs: readStringList(workflow, "required_outputs"),
+      requiredCapabilities: parseRequiredCapabilities(workflow.required_capabilities, `workflows.${name}.required_capabilities`)
+    };
+  });
+}
+function parseRequiredCapabilities(value, label) {
+  const raw = requireRecord(value ?? {}, label);
+  return Object.entries(raw).map(([name, entry]) => {
+    const capability = requireRecord(entry, `${label}.${name}`);
+    const policy = readString(capability, "policy", "manual-only");
+    if (!INVOCATION_VALUES.has(policy)) {
+      throw new Error(`Unsupported capability policy for ${label}.${name}: ${policy}`);
+    }
+    return {
+      name,
+      preferred: readString(capability, "preferred", ""),
+      fallback: readStringList(capability, "fallback"),
+      policy
+    };
+  });
+}

package/tsconfig.lsp.json ADDED Viewed

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "allowJs": true,
+    "checkJs": true,
+    "noEmit": true,
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "target": "ES2022",
+    "types": ["node"],
+    "skipLibCheck": true,
+    "strict": false,
+    "noImplicitAny": false
+  },
+  "include": ["bin/**/*.mjs", "src/**/*.mjs", "test/**/*.mjs"]
+}