@cleocode/caamp 2026.4.9 → 2026.4.11

package/dist/{chunk-JC77OAHA.js → chunk-XVZT7K6F.js}

@@ -760,19 +760,25 @@ var PiHarness = class {
     return scope.kind === "global" ? join5(getPiAgentDir2(), "AGENTS.md") : join5(scope.projectDir, "AGENTS.md");
   }
   // ── Skills ──────────────────────────────────────────────────────────
-  /** {@inheritDoc Harness.installSkill} */
+  /**
+   * Install a skill directory into the resolved Pi skills location.
+   */
   async installSkill(sourcePath, skillName, scope) {
     const targetDir = join5(this.skillsDir(scope), skillName);
     await rm3(targetDir, { recursive: true, force: true });
     await mkdir3(dirname2(targetDir), { recursive: true });
     await cp3(sourcePath, targetDir, { recursive: true });
   }
-  /** {@inheritDoc Harness.removeSkill} */
+  /**
+   * Remove a skill directory from the resolved Pi skills location.
+   */
   async removeSkill(skillName, scope) {
     const targetDir = join5(this.skillsDir(scope), skillName);
     await rm3(targetDir, { recursive: true, force: true });
   }
-  /** {@inheritDoc Harness.listSkills} */
+  /**
+   * List the installed skill directories at the given scope.
+   */
   async listSkills(scope) {
     const dir = this.skillsDir(scope);
     if (!existsSync4(dir)) return [];
@@ -780,7 +786,10 @@ var PiHarness = class {
     return entries.filter((e) => e.isDirectory()).map((e) => e.name);
   }
   // ── Instructions ────────────────────────────────────────────────────
-  /** {@inheritDoc Harness.injectInstructions} */
+  /**
+   * Inject or replace a CAAMP-managed instruction block inside the Pi
+   * `AGENTS.md` file for the resolved scope.
+   */
   async injectInstructions(content, scope) {
     const filePath = this.agentsMdPath(scope);
     await mkdir3(dirname2(filePath), { recursive: true });
@@ -804,7 +813,10 @@ ${MARKER_END}`;
     }
     await writeFile(filePath, updated, "utf8");
   }
-  /** {@inheritDoc Harness.removeInstructions} */
+  /**
+   * Remove the CAAMP-managed instruction block from the Pi `AGENTS.md`
+   * file at the resolved scope.
+   */
   async removeInstructions(scope) {
     const filePath = this.agentsMdPath(scope);
     if (!existsSync4(filePath)) return;
@@ -1204,7 +1216,9 @@ ${MARKER_END}`;
     });
   }
   // ── Settings ────────────────────────────────────────────────────────
-  /** {@inheritDoc Harness.readSettings} */
+  /**
+   * Read the Pi `settings.json` file for the resolved scope.
+   */
   async readSettings(scope) {
     const filePath = this.settingsPath(scope);
     if (!existsSync4(filePath)) return {};
@@ -1215,7 +1229,10 @@ ${MARKER_END}`;
       return {};
     }
   }
-  /** {@inheritDoc Harness.writeSettings} */
+  /**
+   * Merge a partial patch into the Pi `settings.json` file for the
+   * resolved scope using an atomic write.
+   */
   async writeSettings(patch, scope) {
     const filePath = this.settingsPath(scope);
     const current = await this.readSettings(scope);
@@ -1223,7 +1240,10 @@ ${MARKER_END}`;
     const merged = deepMerge(currentObj, patch);
     await atomicWriteJson(filePath, merged);
   }
-  /** {@inheritDoc Harness.configureModels} */
+  /**
+   * Persist the supplied model-name patterns into `settings.enabledModels`
+   * at the resolved scope.
+   */
   async configureModels(modelPatterns, scope) {
     await this.writeSettings({ enabledModels: modelPatterns }, scope);
   }
@@ -1248,7 +1268,10 @@ ${MARKER_END}`;
     return join5(getPiAgentDir2(), "sessions");
   }
   // ── Extensions (Wave-1, T263) ───────────────────────────────────────
-  /** {@inheritDoc Harness.installExtension} */
+  /**
+   * Install a Pi extension `.ts` source file into the resolved tier's
+   * extensions directory, validating that it has a default export.
+   */
   async installExtension(sourcePath, name, tier, projectDir, opts) {
     if (!existsSync4(sourcePath)) {
       throw new Error(`installExtension: source file does not exist: ${sourcePath}`);
@@ -1280,7 +1303,9 @@ ${MARKER_END}`;
     await writeFile(targetPath, contents, "utf8");
     return { targetPath, tier };
   }
-  /** {@inheritDoc Harness.removeExtension} */
+  /**
+   * Remove a Pi extension `.ts` source file from the resolved tier.
+   */
   async removeExtension(name, tier, projectDir) {
     const dir = resolveTierDir({ tier, kind: "extensions", projectDir });
     const targetPath = join5(dir, `${name}.ts`);
@@ -1288,7 +1313,10 @@ ${MARKER_END}`;
     await rm3(targetPath, { force: true });
     return true;
   }
-  /** {@inheritDoc Harness.listExtensions} */
+  /**
+   * List Pi extension files across every tier in precedence order,
+   * flagging shadowed entries from lower tiers.
+   */
   async listExtensions(projectDir) {
     const tiers = resolveAllTiers("extensions", projectDir);
     const out = [];
@@ -1319,7 +1347,10 @@ ${MARKER_END}`;
     return out;
   }
   // ── Sessions (Wave-1, T264) ─────────────────────────────────────────
-  /** {@inheritDoc Harness.listSessions} */
+  /**
+   * List Pi session JSONL files (including subagent children when
+   * requested), summarising only the header line per file.
+   */
   async listSessions(opts) {
     const rootDir = this.sessionsDir();
     if (!existsSync4(rootDir)) return [];
@@ -1359,7 +1390,9 @@ ${MARKER_END}`;
     summaries.sort((a, b) => b.mtimeMs - a.mtimeMs);
     return summaries;
   }
-  /** {@inheritDoc Harness.showSession} */
+  /**
+   * Show the full entries of a single Pi session by id.
+   */
   async showSession(id) {
     const summaries = await this.listSessions({ includeSubagents: true });
     const match = summaries.find((s) => s.id === id);
@@ -1375,7 +1408,10 @@ ${MARKER_END}`;
     return { summary: match, entries };
   }
   // ── Models (Wave-1, T265) ───────────────────────────────────────────
-  /** {@inheritDoc Harness.readModelsConfig} */
+  /**
+   * Read the Pi `models.json` file for the resolved scope, tolerating
+   * missing or malformed files by returning an empty provider map.
+   */
   async readModelsConfig(scope) {
     const filePath = this.modelsConfigPath(scope);
     if (!existsSync4(filePath)) return { providers: {} };
@@ -1401,12 +1437,18 @@ ${MARKER_END}`;
       return { providers: {} };
     }
   }
-  /** {@inheritDoc Harness.writeModelsConfig} */
+  /**
+   * Write the Pi `models.json` file for the resolved scope via an atomic
+   * tmp-then-rename sequence.
+   */
   async writeModelsConfig(config, scope) {
     const filePath = this.modelsConfigPath(scope);
     await atomicWriteJson(filePath, config);
   }
-  /** {@inheritDoc Harness.listModels} */
+  /**
+   * Compose a flat `ModelListEntry` list from `models.json` plus the
+   * `enabledModels` and default-model hints in `settings.json`.
+   */
   async listModels(scope) {
     const models = await this.readModelsConfig(scope);
     const settings = await this.readSettings(scope);
@@ -1468,7 +1510,10 @@ ${MARKER_END}`;
     return out;
   }
   // ── Prompts (Wave-1, T266) ──────────────────────────────────────────
-  /** {@inheritDoc Harness.installPrompt} */
+  /**
+   * Install a Pi prompt directory (containing `prompt.md`) into the
+   * resolved tier's prompts directory.
+   */
   async installPrompt(sourceDir, name, tier, projectDir, opts) {
     if (!existsSync4(sourceDir)) {
       throw new Error(`installPrompt: source directory does not exist: ${sourceDir}`);
@@ -1494,7 +1539,10 @@ ${MARKER_END}`;
     await cp3(sourceDir, targetPath, { recursive: true });
     return { targetPath, tier };
   }
-  /** {@inheritDoc Harness.listPrompts} */
+  /**
+   * List Pi prompt directories across every tier in precedence order,
+   * flagging shadowed entries from lower tiers.
+   */
   async listPrompts(projectDir) {
     const tiers = resolveAllTiers("prompts", projectDir);
     const out = [];
@@ -1522,7 +1570,9 @@ ${MARKER_END}`;
     }
     return out;
   }
-  /** {@inheritDoc Harness.removePrompt} */
+  /**
+   * Remove a Pi prompt directory from the resolved tier.
+   */
   async removePrompt(name, tier, projectDir) {
     const dir = resolveTierDir({ tier, kind: "prompts", projectDir });
     const targetPath = join5(dir, name);
@@ -1531,7 +1581,11 @@ ${MARKER_END}`;
     return true;
   }
   // ── Themes (Wave-1, T267) ───────────────────────────────────────────
-  /** {@inheritDoc Harness.installTheme} */
+  /**
+   * Install a Pi theme file (`.ts`/`.tsx`/`.mts`/`.json`) into the
+   * resolved tier's themes directory, blocking same-stem conflicts
+   * unless `--force` is supplied.
+   */
   async installTheme(sourceFile, name, tier, projectDir, opts) {
     if (!existsSync4(sourceFile)) {
       throw new Error(`installTheme: source file does not exist: ${sourceFile}`);
@@ -1570,7 +1624,10 @@ ${MARKER_END}`;
     await writeFile(targetPath, contents);
     return { targetPath, tier };
   }
-  /** {@inheritDoc Harness.listThemes} */
+  /**
+   * List Pi theme files across every tier in precedence order, flagging
+   * shadowed entries from lower tiers.
+   */
   async listThemes(projectDir) {
     const tiers = resolveAllTiers("themes", projectDir);
     const out = [];
@@ -1602,7 +1659,10 @@ ${MARKER_END}`;
     }
     return out;
   }
-  /** {@inheritDoc Harness.removeTheme} */
+  /**
+   * Remove a Pi theme from the resolved tier, matching any of the
+   * supported theme extensions for the given name stem.
+   */
   async removeTheme(name, tier, projectDir) {
     const dir = resolveTierDir({ tier, kind: "themes", projectDir });
     let removed = false;
@@ -1617,14 +1677,14 @@ ${MARKER_END}`;
   }
   // ── CANT profiles (Wave-1, T276) ────────────────────────────────────
   /**
-   * {@inheritDoc Harness.installCantProfile}
+   * Install a `.cant` profile into the resolved tier after passing it
+   * through the cant-core validator.
    *
-   * @remarks
-   * Validates the source via {@link validateCantProfile} before copying so
-   * we never persist a `.cant` file the runtime bridge cannot load. The
-   * target layout is `<tier-root>/cant/<name>.cant`, resolved through
-   * {@link resolveTierDir} so the project/user/global hierarchy stays
-   * consistent with the other Wave-1 verbs.
+   * Validates the source via {@link PiHarness.validateCantProfile}
+   * before copying so we never persist a `.cant` file the runtime bridge
+   * cannot load. The target layout is `<tier-root>/cant/<name>.cant`,
+   * resolved through `resolveTierDir` so the project/user/global
+   * hierarchy stays consistent with the other Wave-1 verbs.
    */
   async installCantProfile(sourcePath, name, tier, projectDir, opts) {
     if (!existsSync4(sourcePath)) {
@@ -1658,7 +1718,9 @@ ${MARKER_END}`;
     await writeFile(targetPath, contents);
     return { targetPath, tier, counts: validation.counts };
   }
-  /** {@inheritDoc Harness.removeCantProfile} */
+  /**
+   * Remove a `.cant` profile from the resolved tier.
+   */
   async removeCantProfile(name, tier, projectDir) {
     const dir = resolveTierDir({ tier, kind: "cant", projectDir });
     const targetPath = join5(dir, `${name}.cant`);
@@ -1667,10 +1729,10 @@ ${MARKER_END}`;
     return true;
   }
   /**
-   * {@inheritDoc Harness.listCantProfiles}
+   * List installed `.cant` profiles across every tier in precedence
+   * order, parsing each file to extract section counts.
    *
-   * @remarks
-   * Walks every tier in {@link TIER_PRECEDENCE} order, parsing each
+   * Walks every tier in `TIER_PRECEDENCE` order, parsing each
    * discovered `.cant` file via cant-core to extract a
    * {@link CantProfileCounts} bag. Higher-precedence tiers shadow
    * lower-precedence entries with the same name; shadowed entries
@@ -1714,9 +1776,9 @@ ${MARKER_END}`;
     return out;
   }
   /**
-   * {@inheritDoc Harness.validateCantProfile}
+   * Validate a `.cant` source file against cant-core's parser and
+   * 42-rule linter, returning section counts and per-diagnostic detail.
    *
-   * @remarks
    * Pure validator. Reads the file, runs `parseDocument` to derive
    * counts (when parsing succeeds) and `validateDocument` to collect
    * the 42-rule diagnostic feed. The two calls are kept independent so
@@ -4624,4 +4686,4 @@ export {
   discoverSkillsMulti,
   validateSkill
 };
-//# sourceMappingURL=chunk-JC77OAHA.js.map
+//# sourceMappingURL=chunk-XVZT7K6F.js.map