@cat-factory/agents 0.40.13 → 0.41.0

package/dist/presets/docs-refresh/docs-detect.logic.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The narrow slice of the checkout-free repo API the detector needs — a `RepoFiles`
+ * satisfies it structurally, and a test supplies an in-memory fake. A MISSING path yields
+ * `null` / `[]`, so the heuristics degrade gracefully on partial repos. A genuine read
+ * fault (auth/permission revoked, rate limit, transport error) may THROW — the real
+ * GitHub/GitLab reader throws on any non-404 status. The detector NEVER propagates it: the
+ * shared {@link BudgetedRepoScanner} swallows the fault (records it, keeps scanning
+ * best-effort) and this probe simply ignores `readFault`, so it can only ever return
+ * defaults, never reject — a prefill must never block create.
+ */
+export interface DocsRepoReader {
+    getFile(path: string, gitRef?: string): Promise<{
+        content: string;
+    } | null>;
+    listDirectory(path: string, gitRef?: string): Promise<{
+        name: string;
+        type: string;
+        path: string;
+    }[]>;
+}
+/**
+ * The detected documentation layout — the docs-refresh preset's placement DEFAULTS plus two
+ * intel facts for the analyst. All fields are always present (a partial/unreadable repo
+ * yields the conventional defaults), so the caller never has to null-check.
+ */
+export interface DocsLayoutDetection {
+    /**
+     * How docs are placed: `root` (one top-level docs tree) vs `per-service` (each package
+     * carries its own docs — the monorepo shape). Drives the `placementMode` form default.
+     */
+    placementMode: 'root' | 'per-service';
+    /** The repo-relative docs root directory (no trailing slash), e.g. `docs`. */
+    docsRoot: string;
+    /** The repo-relative diagrams directory (no trailing slash), e.g. `docs/diagrams`. */
+    diagramsDir: string;
+    /** The repo-relative business-rules directory (no trailing slash), e.g. `docs/business-logic`. */
+    businessRulesDir: string;
+    /**
+     * Whether the repo already carries mermaid diagram SOURCES — a standalone `.mmd`/`.mermaid`
+     * file or a `mermaid` directory in a scanned location. A hint for the analyst; it is NOT
+     * authoritative (embedded ```mermaid fences inside `.md` files aren't detected — reading
+     * doc bodies is out of the probe's checkout-free budget; the analyst finds those after clone).
+     */
+    hasExistingMermaid: boolean;
+    /**
+     * Whether the repo looks like a monorepo (a workspace manifest, a `workspaces` package.json
+     * field, or a conventional `packages`/`apps`/`services`/`libs` directory). Distinct from
+     * `placementMode`: a monorepo can still keep one root docs tree.
+     */
+    monorepo: boolean;
+}
+/**
+ * Detect the documentation layout of a repo for the docs-refresh preset's form prefill.
+ *
+ * Deterministic, bounded (a hard read budget), and TOTAL — it never throws and never rejects,
+ * so an unwired GitHub / a partial or unreadable repo simply yields the conventional defaults
+ * (`root` placement, `docs`, `docs/diagrams`, `docs/business-logic`). The result is a set of
+ * non-binding FORM DEFAULTS; the user's edits win and the analyst confirms placement at
+ * planning time.
+ */
+export declare function detectDocsLayout(reader: DocsRepoReader): Promise<DocsLayoutDetection>;
+//# sourceMappingURL=docs-detect.logic.d.ts.map

package/dist/presets/docs-refresh/docs-detect.logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-detect.logic.d.ts","sourceRoot":"","sources":["../../../src/presets/docs-refresh/docs-detect.logic.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAC3E,aAAa,CACX,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAA;CAC3D;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,aAAa,CAAA;IACrC,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAA;IAChB,sFAAsF;IACtF,WAAW,EAAE,MAAM,CAAA;IACnB,kGAAkG;IAClG,gBAAgB,EAAE,MAAM,CAAA;IACxB;;;;;OAKG;IACH,kBAAkB,EAAE,OAAO,CAAA;IAC3B;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAA;CAClB;AAyGD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAiD3F"}

package/dist/presets/docs-refresh/docs-detect.logic.js

@@ -0,0 +1,170 @@
+// ---------------------------------------------------------------------------
+// Documentation-refresh preset — repo LAYOUT AUTODETECTION (slice 6).
+//
+// A deterministic, bounded, checkout-free heuristic that proposes the docs-refresh
+// preset's placement DEFAULTS (where docs live, whether the repo documents per-service,
+// which subfolders hold diagrams / business rules) by reading a targeted, tiny slice of
+// the repo over a {@link DocsRepoReader}-shaped reader. No LLM, no clone — just a handful
+// of directory listings plus the root workspace manifests. Mirrors the spirit of
+// `provision-detect.logic.ts` (integrations): high-confidence facts are inferred
+// deterministically; everything is a NON-BINDING prefill the user (and later the analyst
+// during planning) confirms or overrides.
+//
+// This is the pure logic behind the preset's `detect` hook (slice 8), which maps the
+// result onto the form's `InitiativePresetInputs`. Detected values are FORM DEFAULTS: a
+// user edit wins, and both freeze on `presetInputs` at create. The analyst confirms /
+// refines placement at planning time and records deviations as `decisions` — it never
+// silently rewrites the frozen inputs. See
+// `docs/initiatives/initiative-presets-and-docs-refresh.md` (slice 6).
+// ---------------------------------------------------------------------------
+import { BudgetedRepoScanner, joinRepoPath } from '@cat-factory/kernel';
+const DEFAULT_DOCS_ROOT = 'docs';
+// Root directory names that hold documentation, most-conventional first (first present wins).
+const DOCS_ROOT_NAMES = ['docs', 'doc', 'documentation'];
+// Subfolder names (under the docs root) that hold diagrams, most-conventional first.
+const DIAGRAMS_DIR_NAMES = ['diagrams', 'diagram', 'architecture', 'arch'];
+// Subfolder names (under the docs root) that hold business rules / domain docs. `business-logic`
+// first — it matches the `business-documenter` agent's default placement.
+const BUSINESS_RULES_DIR_NAMES = ['business-logic', 'business', 'domain', 'rules'];
+// Conventional monorepo package roots — listed to sample per-service docs placement.
+const WORKSPACE_DIRS = ['packages', 'apps', 'services', 'libs'];
+// Root files that declare a workspace/monorepo (presence alone is the signal — never parsed).
+const MONOREPO_MANIFESTS = [
+    'pnpm-workspace.yaml',
+    'lerna.json',
+    'turbo.json',
+    'nx.json',
+    'rush.json',
+];
+// Standalone mermaid source extensions (directory-listing signal for `hasExistingMermaid`).
+const MERMAID_FILE_RE = /\.(mmd|mermaid)$/i;
+// The most packages we sample when deciding per-service placement — bounds the read fan-out.
+const MAX_SAMPLED_PACKAGES = 6;
+// Hard ceiling on reads so a pathological repo can't fan out without bound. A typical repo
+// resolves in ~10 reads (root + a root manifest + the docs tree + a few sampled packages); the
+// cap only bites on a decoy-heavy tree, where the scan simply stops and returns what it has.
+const READ_BUDGET = 32;
+/** Immediate child directory names of a listing. */
+function dirNames(entries) {
+    return new Set(entries.filter((e) => e.type === 'dir').map((e) => e.name));
+}
+/** Immediate child file names of a listing. */
+function fileNames(entries) {
+    return new Set(entries.filter((e) => e.type !== 'dir').map((e) => e.name));
+}
+/** The first of `candidates` present as a child dir of `dirs`, else undefined. */
+function firstPresent(dirs, candidates) {
+    return candidates.find((c) => dirs.has(c));
+}
+/** True when any listed entry is a standalone mermaid source file or a `mermaid` directory. */
+function listingHasMermaid(entries) {
+    return entries.some((e) => (e.type === 'dir' && e.name === 'mermaid') ||
+        (e.type !== 'dir' && MERMAID_FILE_RE.test(e.name)));
+}
+/**
+ * Read the root `package.json` and report whether it declares a `workspaces` field (the
+ * npm/yarn/bun monorepo marker). Best-effort: an absent/unparseable manifest ⇒ false. This is
+ * the only file the probe reads beyond directory listings, and it is a root workspace manifest.
+ */
+async function hasNpmWorkspaces(scanner) {
+    const content = await scanner.getFile('package.json');
+    if (!content)
+        return false;
+    try {
+        const pkg = JSON.parse(content);
+        const ws = pkg.workspaces;
+        // Array form (`["packages/*"]`) OR yarn's object form (`{ packages: ["packages/*"] }`) — a
+        // monorepo marker only when it actually declares globs. An empty `[]`/`{}` (or `{ nohoist }`
+        // with no `packages`) declares no workspaces, so it's not a monorepo signal.
+        if (Array.isArray(ws))
+            return ws.length > 0;
+        if (ws !== null && typeof ws === 'object') {
+            const packages = ws.packages;
+            return Array.isArray(packages) && packages.length > 0;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Sample up to {@link MAX_SAMPLED_PACKAGES} packages across the present workspace dirs and count
+ * how many carry their own docs directory. Returns the vote (`sampled`/`withDocs`) plus whether
+ * any sampled package held a mermaid source. Bounded by the sample cap + the global read budget.
+ */
+async function samplePackageDocs(scanner, workspaceDirs) {
+    let sampled = 0;
+    let withDocs = 0;
+    let mermaid = false;
+    for (const wsDir of workspaceDirs) {
+        if (sampled >= MAX_SAMPLED_PACKAGES)
+            break;
+        const children = (await scanner.listDir(wsDir)).filter((e) => e.type === 'dir');
+        for (const child of children) {
+            if (sampled >= MAX_SAMPLED_PACKAGES)
+                break;
+            sampled++;
+            const entries = await scanner.listDir(joinRepoPath(wsDir, child.name));
+            if (firstPresent(dirNames(entries), DOCS_ROOT_NAMES))
+                withDocs++;
+            if (listingHasMermaid(entries))
+                mermaid = true;
+        }
+    }
+    return { sampled, withDocs, mermaid };
+}
+/**
+ * Detect the documentation layout of a repo for the docs-refresh preset's form prefill.
+ *
+ * Deterministic, bounded (a hard read budget), and TOTAL — it never throws and never rejects,
+ * so an unwired GitHub / a partial or unreadable repo simply yields the conventional defaults
+ * (`root` placement, `docs`, `docs/diagrams`, `docs/business-logic`). The result is a set of
+ * non-binding FORM DEFAULTS; the user's edits win and the analyst confirms placement at
+ * planning time.
+ */
+export async function detectDocsLayout(reader) {
+    const scanner = new BudgetedRepoScanner(reader, READ_BUDGET);
+    const rootEntries = await scanner.listDir('');
+    const rootDirs = dirNames(rootEntries);
+    const rootFiles = fileNames(rootEntries);
+    // --- docs root -------------------------------------------------------------------------------
+    const docsRoot = firstPresent(rootDirs, DOCS_ROOT_NAMES) ?? DEFAULT_DOCS_ROOT;
+    let diagramsDir = joinRepoPath(docsRoot, 'diagrams');
+    let businessRulesDir = joinRepoPath(docsRoot, 'business-logic');
+    // Root listing signal: a standalone `.mmd`/`.mermaid` file OR a `mermaid` directory (the root
+    // is a scanned location, so both halves of the signal count here — not just the file half).
+    let hasExistingMermaid = listingHasMermaid(rootEntries);
+    // --- known subfolders under the docs root ----------------------------------------------------
+    if (rootDirs.has(docsRoot)) {
+        const docsEntries = await scanner.listDir(docsRoot);
+        const docsDirs = dirNames(docsEntries);
+        const diagramsChild = firstPresent(docsDirs, DIAGRAMS_DIR_NAMES);
+        if (diagramsChild)
+            diagramsDir = joinRepoPath(docsRoot, diagramsChild);
+        const businessChild = firstPresent(docsDirs, BUSINESS_RULES_DIR_NAMES);
+        if (businessChild)
+            businessRulesDir = joinRepoPath(docsRoot, businessChild);
+        hasExistingMermaid = hasExistingMermaid || listingHasMermaid(docsEntries);
+        // Peek inside the diagrams dir once for standalone mermaid sources (budget permitting).
+        if (diagramsChild && !hasExistingMermaid) {
+            hasExistingMermaid = listingHasMermaid(await scanner.listDir(joinRepoPath(docsRoot, diagramsChild)));
+        }
+    }
+    // --- monorepo shape + per-service placement --------------------------------------------------
+    const workspaceDirs = WORKSPACE_DIRS.filter((d) => rootDirs.has(d));
+    const monorepoManifest = MONOREPO_MANIFESTS.some((m) => rootFiles.has(m)) || (await hasNpmWorkspaces(scanner));
+    const monorepo = monorepoManifest || workspaceDirs.length > 0;
+    let placementMode = 'root';
+    if (monorepo && workspaceDirs.length > 0) {
+        const { sampled, withDocs, mermaid } = await samplePackageDocs(scanner, workspaceDirs);
+        hasExistingMermaid = hasExistingMermaid || mermaid;
+        // Per-service when MOST sampled packages document themselves (a strict majority — an even
+        // split stays on the safe `root` default). A monorepo we can't sample (manifest-only, no
+        // conventional package dir) stays `root` too — the safe, common default.
+        if (sampled > 0 && withDocs * 2 > sampled)
+            placementMode = 'per-service';
+    }
+    return { placementMode, docsRoot, diagramsDir, businessRulesDir, hasExistingMermaid, monorepo };
+}
+//# sourceMappingURL=docs-detect.logic.js.map

package/dist/presets/docs-refresh/docs-detect.logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-detect.logic.js","sourceRoot":"","sources":["../../../src/presets/docs-refresh/docs-detect.logic.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/agents",
-  "version": "0.40.13",
+  "version": "0.41.0",
   "description": "Agent catalog, routing, prompts and fragment library for the Agent Architecture Board.",
   "repository": {
     "type": "git",
@@ -31,14 +31,14 @@
     "ai": "^6.0.219",
     "handlebars": "^4.7.9",
     "valibot": "^1.4.2",
-    "@cat-factory/contracts": "0.117.0",
-    "@cat-factory/kernel": "0.104.4",
-    "@cat-factory/prompt-fragments": "0.10.26"
+    "@cat-factory/contracts": "0.118.0",
+    "@cat-factory/kernel": "0.105.0",
+    "@cat-factory/prompt-fragments": "0.10.27"
   },
   "devDependencies": {
     "typescript": "7.0.1-rc",
     "vitest": "^4.1.9",
-    "@cat-factory/caching": "0.6.4"
+    "@cat-factory/caching": "0.6.5"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",