@iowarp/clio-coder 0.5.0 → 0.5.2

package/dist/{chunk-TGWZXJ7L.js → chunk-BEMQK5Q7.js}

@@ -8,10 +8,10 @@ import {
   recallParentTurnId,
   recallableRefListing,
   resolveRecall
-} from "./chunk-EG4ARXPC.js";
+} from "./chunk-OX6QTA4N.js";
 import {
   foldWorkingSet
-} from "./chunk-EZD2BXGP.js";
+} from "./chunk-GUFQPTQK.js";
 import {
   getAtPath
 } from "./chunk-GGWI3OVM.js";
@@ -20,37 +20,35 @@ import {
   settingsSectionForPath
 } from "./chunk-LJRBX7QR.js";
 import {
-  checkSkillDrift
-} from "./chunk-4WOOTKFD.js";
+  buildSkillCatalogView,
+  checkSkillDrift,
+  checkSkillDriftBatch
+} from "./chunk-U3FETNQB.js";
 import {
   discoverMarketplaceSkills,
   installedSkillNames,
   installedSkillPackages,
   loadSkills,
   modelVisibleSkills
-} from "./chunk-LAR7DX5E.js";
+} from "./chunk-B5TASTCK.js";
 import {
   contextToolSurface
-} from "./chunk-CTFPFW3H.js";
+} from "./chunk-Q6FRR3AQ.js";
 import {
   OBSERVE_SELF_CAPS,
   finalizeObservation,
   observationBudgetExhausted,
   reserveObservation
-} from "./chunk-OPD7GL6F.js";
+} from "./chunk-H6FQVNZC.js";
 import {
   truncateHead
 } from "./chunk-GHXGMFQ5.js";
 import {
-  SKILL_INSTALL_OFFER_OPTION_NEVER,
-  SKILL_INSTALL_OFFER_OPTION_NOT_NOW,
-  SKILL_INSTALL_OFFER_OPTION_PROJECT,
-  SKILL_INSTALL_OFFER_OPTION_USER,
   SKILL_SUGGESTION_ANCHOR
-} from "./chunk-I4Y4WKZR.js";
+} from "./chunk-MMZMM6SW.js";
 import {
   ToolNames
-} from "./chunk-V4XJWDHR.js";
+} from "./chunk-6UKFRTXI.js";
 import {
   resolvePackageRoot
 } from "./chunk-ZPST2KQO.js";
@@ -771,57 +769,13 @@ function marketplaceRowsFor(deps, installed, options) {
     return [];
   }
 }
-function renderSkillsList(skills, marketplace, marketplaceOffered, modelActivation, packages = []) {
-  if (skills.length === 0 && marketplace.length === 0 && packages.length === 0) {
-    return marketplaceOffered ? "No skills are available in Clio and no additional marketplace skills were found." : "No skills are available in Clio.";
-  }
-  const lines = ["Available skills.", ""];
-  const native = skills.filter((skill) => skill.source === "clio-coder" || skill.source === "plugin");
-  const discovered = skills.filter((skill) => skill.source !== "clio-coder" && skill.source !== "plugin");
-  lines.push(`Ready skills in Clio (${native.length}):`);
-  if (native.length === 0) lines.push("- none");
-  for (const skill of native) {
-    lines.push(`- ${skill.name} (source: ${skill.source}; scope: ${skill.scope}): ${skill.description}`);
-  }
-  if (discovered.length > 0) {
-    lines.push("", "Explicitly supplied session skills (not installed packages):");
-    for (const skill of discovered) {
-      lines.push(
-        `- ${skill.name} (source: ${skill.source}; scope: ${skill.scope}; file: ${skill.filePath}): ${skill.description}`
-      );
-    }
-    lines.push(
-      "These skills were explicitly supplied for this session. Preserve their source; session availability does not mean Clio installed or copied them."
-    );
-  }
-  if (packages.length > 0) {
-    lines.push("", `Installed packages providing skills (${packages.length}):`);
-    for (const pkg of packages)
-      lines.push(
-        `- ${pkg.name} (scope: ${pkg.scope}; origin: ${pkg.origin === "catalog" ? "marketplace catalog" : pkg.origin}; state: ${pkg.state}; path: ${pkg.path})`
-      );
-  }
-  lines.push(
-    "",
-    "Other-agent skill folders are discovery-only. Explicitly import into Clio before use; the trust-imports setting does not install or activate loose files."
-  );
-  if (marketplace.length > 0) {
-    lines.push("", "Marketplace (additional skills available to install; /skill <name> offers to install):");
-    for (const entry of marketplace) {
-      const category = entry.category ? ` [${entry.category}]` : "";
-      lines.push(`- ${entry.name}${category}: ${entry.description}`);
-    }
-  }
-  lines.push(
-    "",
-    modelActivation ? `If one skill above matches the current task, load it now with context(scope="skills", name="<name>") and continue in the same turn; at this autonomy level you activate installed skills yourself and do not wait for the operator. Marketplace additions still require operator approval. If none match, do not mention skills.` : `If one skill above matches the current task, begin your reply with the line \`${SKILL_SUGGESTION_ANCHOR}\` (a comma-separated sequence, in order, when several compose), then continue the task in the same turn without it; only the operator can run it. If none match, do not mention skills.`
-  );
-  if (marketplace.length > 0) {
-    lines.push(
-      `When no installed skill serves the task but a marketplace skill above genuinely does, you may instead ask the operator with ask_user (mode=single_question, header "Install skill") whether to install it, offering exactly: "${SKILL_INSTALL_OFFER_OPTION_PROJECT}", "${SKILL_INSTALL_OFFER_OPTION_USER}", "${SKILL_INSTALL_OFFER_OPTION_NOT_NOW}", "${SKILL_INSTALL_OFFER_OPTION_NEVER}". The harness handles those exact offer options. An explicit operator request or approval also authorizes the documented library install CLI. After installation, refresh the inventory; distinguish installed from ready and report /library reload when required.`
-    );
+function driftedSkillNames(skills, cwd) {
+  try {
+    const reports = checkSkillDriftBatch(skills, cwd);
+    return new Set([...reports].filter(([, report]) => report.verdict === "mismatch").map(([name]) => name));
+  } catch {
+    return /* @__PURE__ */ new Set();
   }
-  return lines.join("\n");
 }
 function runWorkspaceScope(deps, reservation, options) {
   const workspace = deps.workspace;
@@ -909,35 +863,54 @@ function runSkillsScope(deps, args, reservation, options) {
       cwdFromDeps(deps),
       deps.getSkillLoaderOptions?.().trustProjectCompatRoots === true
     );
-    const rendered = renderSkillsList(
-      visible2,
+    const view = buildSkillCatalogView({
+      skills: visible2,
+      packages,
       marketplace,
-      deps.skillMarketplace !== false,
-      options?.pendingSkillPolicy?.modelActivation === true,
-      packages
-    );
-    const truncation2 = truncateHead(rendered, { maxBytes: reservation.callCapBytes, maxLines: Number.MAX_SAFE_INTEGER });
-    const total = visible2.length + marketplace.length + packages.length;
+      drifted: driftedSkillNames(visible2, cwdFromDeps(deps)),
+      marketplaceOffered: deps.skillMarketplace !== false,
+      modelActivation: options?.pendingSkillPolicy?.modelActivation === true,
+      query: typeof args.query === "string" ? args.query : "",
+      limit: typeof args.limit === "number" ? args.limit : void 0,
+      offset: typeof args.offset === "number" ? args.offset : 0,
+      capBytes: reservation.callCapBytes
+    });
+    const shownKeys = new Set(view.rows.map((row) => row.key));
+    const shown = (kind, identity) => shownKeys.has(`${kind}:${identity}`);
     return finalizeObservation({
       tool: ToolNames.Context,
       unit: "entries",
-      output: truncation2.content,
-      ...truncation2.truncated ? { fullOutput: rendered } : {},
-      shownCount: total,
-      totalCount: total,
-      truncated: truncation2.truncated,
+      output: view.text,
+      shownCount: view.shown,
+      totalCount: view.total,
+      truncated: view.nextOffset !== void 0 || view.shown < view.total,
+      // Offsets index the filtered result set. A continuation carrying only
+      // the offset would be applied to the unfiltered catalog, which repeats
+      // rows and skips matches, so the envelope says the query is part of it.
+      ...view.nextOffset !== void 0 ? {
+        next: view.filtered ? `offset=${view.nextOffset} with the same query` : `offset=${view.nextOffset}`
+      } : {},
       details: {
-        skills: visible2.map((skill2) => ({
+        // Rows on this page, so a caller reading `details` sees the same
+        // listing the text carries. The totals beside them are how a
+        // filtered or paged view is told apart from a complete one.
+        skills: visible2.filter((skill2) => shown("ready", skill2.filePath) || shown("session", skill2.filePath)).map((skill2) => ({
           name: skill2.name,
           scope: skill2.scope,
           source: skill2.source,
-          path: skill2.filePath
+          path: skill2.filePath,
+          ...view.driftedNames.includes(skill2.name) ? { drift: "mismatch" } : {}
         })),
-        installedPackages: packages,
-        marketplace: marketplace.map((entry) => ({
+        installedPackages: packages.filter((pkg) => shown("package", `${pkg.scope}:${pkg.path}`)),
+        marketplace: marketplace.filter((entry) => shown("marketplace", entry.sourceUrl)).map((entry) => ({
           name: entry.name,
           ...entry.category ? { category: entry.category } : {}
-        }))
+        })),
+        totalSkills: visible2.length,
+        totalPackages: packages.length,
+        totalMarketplace: marketplace.length,
+        ...view.filtered ? { query: args.query.trim(), matchMode: view.matchMode } : {},
+        ...view.driftedNames.length > 0 ? { drifted: view.driftedNames } : {}
       },
       reservation,
       ...options ? { options } : {}
@@ -1134,6 +1107,36 @@ function runRecallScope(deps, args, reservation, options) {
     ...options ? { options } : {}
   });
 }
+function runBudgetScope(deps, reservation, options) {
+  const inspection = deps.getContextBudget?.() ?? {
+    status: "unavailable",
+    reason: "This run has no native session budget port. Worker and external-agent budgets are not the parent session's budget."
+  };
+  const payload = inspection.status === "available" ? {
+    ...inspection,
+    mode: "enforced",
+    admissionNote: "Submission and continuation enforce input plus reserved output against the effective window. Counts are estimates unless provider-attested; pressure advice remains advisory."
+  } : inspection;
+  const full = JSON.stringify(payload);
+  const fits = Buffer.byteLength(full, "utf8") <= reservation.callCapBytes;
+  const output = fits ? full : JSON.stringify({
+    status: "unavailable",
+    reason: "observation-limit",
+    message: "The budget view exceeds the available observation bytes. Continue in a follow-up turn; do not retry this turn."
+  });
+  return finalizeObservation({
+    tool: ToolNames.Context,
+    unit: "results",
+    format: "json",
+    output,
+    shownCount: fits ? 1 : 0,
+    totalCount: 1,
+    totalBytes: Buffer.byteLength(full, "utf8"),
+    truncated: !fits,
+    reservation,
+    ...options ? { options } : {}
+  });
+}
 function createContextTool(deps = {}) {
   return {
     ...contextToolSurface,
@@ -1146,18 +1149,22 @@ function createContextTool(deps = {}) {
           message: `context: scope "${scope}" is a gateway capability now: call gateway(op="call", capability="${capability}", args={...}) or gateway(op="describe", capability="${capability}") for its arguments.`
         };
       }
-      if (scope !== "workspace" && scope !== "settings" && scope !== "skills" && scope !== "recall") {
+      if (scope !== "workspace" && scope !== "settings" && scope !== "skills" && scope !== "recall" && scope !== "budget") {
         return {
           kind: "error",
-          message: `context: scope must be workspace, settings, skills, or recall; got '${scope}'`
+          message: `context: scope must be workspace, settings, skills, recall, or budget; got '${scope}'`
         };
       }
+      if (scope === "budget" && Object.keys(args).some((key) => key !== "scope")) {
+        return { kind: "error", message: 'context: scope="budget" accepts only scope; it inspects the current request.' };
+      }
       const selfCap = scope === "skills" ? OBSERVE_SELF_CAPS.contextSkills : OBSERVE_SELF_CAPS.contextWorkspace;
       const reservation = reserveObservation(selfCap, options);
       if (reservation.exhausted) {
         return observationBudgetExhausted({
           tool: ToolNames.Context,
           unit: scope === "skills" ? "entries" : "results",
+          ...scope === "budget" ? { format: "json" } : {},
           reservation,
           subject: `scope=${scope}`,
           hint: "Continue in a follow-up turn."
@@ -1191,6 +1198,7 @@ function createContextTool(deps = {}) {
           ...options ? { options } : {}
         });
       }
+      if (scope === "budget") return runBudgetScope(deps, reservation, options);
       if (scope === "workspace") return runWorkspaceScope(deps, reservation, options);
       if (scope === "recall") return runRecallScope(deps, args, reservation, options);
       return runSkillsScope(deps, args, reservation, options);
@@ -1202,4 +1210,4 @@ export {
   runDocsScope,
   createContextTool
 };
-//# sourceMappingURL=chunk-TGWZXJ7L.js.map
+//# sourceMappingURL=chunk-BEMQK5Q7.js.map

package/dist/{chunk-RNDCROSG.js → chunk-CNXU7TR2.js}

@@ -2,13 +2,13 @@ import { createRequire as __clioCreateRequire } from "node:module"; const requir
 import {
   isSessionEntry,
   isSessionHeader
-} from "./chunk-I4Y4WKZR.js";
+} from "./chunk-F6KCJO3U.js";
 import {
   atomicWrite,
   cwdHash,
   readSessionFileEntries,
   sessionPaths
-} from "./chunk-EKV4UBCM.js";
+} from "./chunk-PZBQUJ2F.js";
 import {
   clioStateDir
 } from "./chunk-CTTI7G3T.js";
@@ -196,4 +196,4 @@ export {
   operatorTextOfUserPayload,
   enrichForkMeta
 };
-//# sourceMappingURL=chunk-RNDCROSG.js.map
+//# sourceMappingURL=chunk-CNXU7TR2.js.map

package/dist/{chunk-3JLTRPN7.js → chunk-CVMUXT64.js}

@@ -7,19 +7,27 @@ import {
   loadProjectRules,
   renderOperatorProfile,
   selectActiveRules,
-  selectProjectPreload
-} from "./chunk-LTWH2ACR.js";
+  selectProjectPreload,
+  sessionCanUseSkills
+} from "./chunk-EQPFEDFV.js";
 import {
   loadFragments,
   sha256
-} from "./chunk-OZ76TLGU.js";
+} from "./chunk-EEITU7S6.js";
 import {
   createLocalCapacitySampler,
   resolveGlobalConcurrency
 } from "./chunk-E6IPKW2E.js";
+import {
+  detectClioCoderRepo
+} from "./chunk-B5TASTCK.js";
+import {
+  isAutonomyLevel,
+  modelMayActivateSkills
+} from "./chunk-UZVYEF57.js";
 import {
   isUserVisibleAgent
-} from "./chunk-LNOXCGN2.js";
+} from "./chunk-7UFDIOBT.js";
 import {
   BusChannels
 } from "./chunk-PS6JAWJZ.js";
@@ -134,67 +142,6 @@ init_esm_shims();
 // src/domains/prompts/extension.ts
 init_esm_shims();
 import { isAbsolute, relative, resolve, sep } from "node:path";
-
-// src/core/clio-repo.ts
-init_esm_shims();
-import { existsSync, readFileSync, statSync } from "node:fs";
-import path from "node:path";
-var CLIO_PACKAGE_NAME = "@iowarp/clio-coder";
-var SOURCE_MARKERS = [
-  "src/entry/orchestrator.ts",
-  "src/worker/entry.ts",
-  "src/domains/prompts/fragments/identity/clio.md"
-];
-function isFile(filePath) {
-  try {
-    return statSync(filePath).isFile();
-  } catch {
-    return false;
-  }
-}
-function readPackageJson(root) {
-  try {
-    const raw = readFileSync(path.join(root, "package.json"), "utf8");
-    const parsed = JSON.parse(raw);
-    return parsed && typeof parsed === "object" ? parsed : null;
-  } catch {
-    return null;
-  }
-}
-function repositoryMatches(value) {
-  if (typeof value === "string") return value.includes("iowarp/clio-coder");
-  if (!value || typeof value !== "object") return false;
-  const url = value.url;
-  return typeof url === "string" && url.includes("iowarp/clio-coder");
-}
-function hasGitMarker(root) {
-  return existsSync(path.join(root, ".git"));
-}
-function hasSourceMarkers(root) {
-  return SOURCE_MARKERS.every((marker) => isFile(path.join(root, marker)));
-}
-function isClioCoderRepoRoot(root) {
-  const pkg = readPackageJson(root);
-  if (pkg?.name !== CLIO_PACKAGE_NAME) return false;
-  if (!repositoryMatches(pkg.repository)) return false;
-  if (!hasGitMarker(root)) return false;
-  return hasSourceMarkers(root);
-}
-function detectClioCoderRepo(cwd = process.cwd()) {
-  let current = path.resolve(cwd);
-  for (; ; ) {
-    if (isClioCoderRepoRoot(current)) {
-      return { isClioCoderRepo: true, repoRoot: current };
-    }
-    if (hasGitMarker(current)) break;
-    const parent = path.dirname(current);
-    if (parent === current) break;
-    current = parent;
-  }
-  return { isClioCoderRepo: false, repoRoot: null };
-}
-
-// src/domains/prompts/extension.ts
 var CLIO_REPO_AWARENESS_ID = "context.clio-repo-awareness";
 var WORKSPACE_ROOT_ID = "context.workspace-root";
 function createPromptsBundle(context, options = {}) {
@@ -313,6 +260,7 @@ function createPromptsBundle(context, options = {}) {
         additionalFragments: [
           ...sources.workspaceRoot,
           ...sources.clioRepoAwareness,
+          ...selfDevelopmentSkillFragments(sources.clioRepoAwareness.length > 0, sessionInputs, safety),
           ...renderCustomizationFragments(sources.customization, cwd, input.workingContextPaths ?? []).fragments
         ]
       });
@@ -461,6 +409,7 @@ function clioRepoAwarenessFragments(cwd) {
   const body = [
     "# Clio Source Tree",
     "This workspace is Clio Coder's own source tree.",
+    `Source repository root: ${JSON.stringify(awareness.repoRoot)}.`,
     "When running inside this repo, Clio can modify her own TUI, skills, agents, tools, prompts, context/bootstrap, and harness as ordinary local source work when the user asks.",
     "Shared contribution/publishing/push/PR/release requires explicit user intent and normal Git/GitHub etiquette. Do not imply autonomous publishing."
   ].join("\n");
@@ -474,6 +423,26 @@ function clioRepoAwarenessFragments(cwd) {
     }
   ];
 }
+function selfDevelopmentSkillFragments(selfRepo, inputs, autonomy) {
+  if (!selfRepo || !sessionCanUseSkills(inputs) || inputs.turnConstraints?.mode === "proposal") return [];
+  const activation = isAutonomyLevel(autonomy) && modelMayActivateSkills(autonomy);
+  const body = [
+    "# Self-development skills",
+    "For a task that changes Clio's source, harness, prompts, or library, use clio-coder-dev before editing and clio-coder-test when choosing validation. Skip this workflow for unrelated or self-contained questions.",
+    `These two skills are discoverable from this checkout's library/skills/meta when no installed package owns their names. Check context(scope="skills") for current readiness; disabled, damaged, or hidden skills stay unavailable.`,
+    activation ? 'Load each relevant ready skill with context(scope="skills", name="clio-coder-dev") or context(scope="skills", name="clio-coder-test") as needed, without waiting for a separate skill request. Reuse already loaded guidance; do not load every reference or the whole catalog.' : "Only the operator activates skills at this autonomy level. Suggest /skill clio-coder-dev or /skill clio-coder-test when relevant, then continue permitted work without waiting or bypassing the activation gate.",
+    "Read CONTRIBUTING.md and the assigned sprint packet from the detected repository root. A plan or skill does not launch an unapproved implementation sprint or authorize publication."
+  ].join("\n");
+  return [
+    {
+      id: "context.self-development-skills",
+      relPath: "inline/self-development-skills",
+      body,
+      contentHash: sha256(body),
+      dynamic: true
+    }
+  ];
+}
 
 // src/domains/prompts/manifest.ts
 init_esm_shims();
@@ -708,4 +677,4 @@ export {
   createPromptsDomainModule,
   SchedulingDomainModule
 };
-//# sourceMappingURL=chunk-3JLTRPN7.js.map
+//# sourceMappingURL=chunk-CVMUXT64.js.map

package/dist/{chunk-733ZBT5P.js → chunk-E74MJF6G.js}

@@ -14,7 +14,7 @@ import {
 import {
   classify,
   normalizeCallPaths
-} from "./chunk-VYRQHORQ.js";
+} from "./chunk-NMQSO6Z6.js";
 import {
   commandArgumentSegments,
   extractCommandCdTargets,
@@ -24,7 +24,7 @@ import {
   invokesClioSkillMutation,
   scanShellLike,
   scanShellLikeDeep
-} from "./chunk-P4GNZPXO.js";
+} from "./chunk-OYUS3UZP.js";
 import {
   pathBoundaryCovers,
   resolvePathBoundary
@@ -44,7 +44,7 @@ import {
 } from "./chunk-MGLRTOCK.js";
 import {
   ToolNames
-} from "./chunk-V4XJWDHR.js";
+} from "./chunk-6UKFRTXI.js";
 import {
   require_dist
 } from "./chunk-B5GGDIHT.js";
@@ -1718,4 +1718,4 @@ export {
   WRITE_ROOT_REFUSED_TOOLS,
   createSafetyPolicyEngine
 };
-//# sourceMappingURL=chunk-733ZBT5P.js.map
+//# sourceMappingURL=chunk-E74MJF6G.js.map

package/dist/{chunk-T2MDZES3.js → chunk-EBMTBE76.js}

@@ -9,14 +9,14 @@ import {
 import {
   loadPromptTemplates,
   validateLibraryPackage
-} from "./chunk-UX2L5CUD.js";
+} from "./chunk-AI36V3ON.js";
 import {
   fetchPluginSource,
   loadSkills,
   parseAgentRecipeSchema,
   parsePluginGithubSource,
   pluginLocalPath
-} from "./chunk-LAR7DX5E.js";
+} from "./chunk-B5TASTCK.js";
 import {
   normalizedSkillHash
 } from "./chunk-DNCE23JJ.js";
@@ -1574,4 +1574,4 @@ export {
   renderLibraryImportPlan,
   InteropDomainModule
 };
-//# sourceMappingURL=chunk-T2MDZES3.js.map
+//# sourceMappingURL=chunk-EBMTBE76.js.map

package/dist/{chunk-OZ76TLGU.js → chunk-EEITU7S6.js}

@@ -3,7 +3,7 @@ import {
   RUN_RECEIPT_INTEGRITY_VERSION,
   TRUST_STATUS_AXES,
   retiredIntegrityVersionOf
-} from "./chunk-VKHLUZNO.js";
+} from "./chunk-UZ7YBL43.js";
 import {
   readSettings
 } from "./chunk-56XP4FJU.js";
@@ -737,4 +737,4 @@ export {
   EvalTaskFileError,
   loadFragments
 };
-//# sourceMappingURL=chunk-OZ76TLGU.js.map
+//# sourceMappingURL=chunk-EEITU7S6.js.map