@cogenta/agents 0.2.1 → 0.4.0

package/dist/site-plan/site-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-context.js","sourceRoot":"","sources":["../../src/site-plan/site-context.ts"],"names":[],"mappings":"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"}

package/dist/site-plan/skin-candidates.d.ts

@@ -1,4 +1,5 @@
 import type { ProviderClient } from '../providers/types.js';
+import { type ExistingSiteSnapshot } from './site-context.js';
 import type { SkinCandidate } from './types.js';
 /**
  * L19 task 3 — "l'utilisateur voit et choisit explicitement entre deux et
@@ -40,6 +41,12 @@ export interface GenerateSkinCandidatesOptions {
     readonly count?: number;
     /** Passed to each candidate's own validation loop. */
     readonly maxAttemptsPerCandidate?: number;
+    /**
+     * Fiche 60 task 3 — the site these candidates would style, when one
+     * already exists. Threaded to every `generateSkin` call as tagged,
+     * escaped data (R8), never folded into `description`.
+     */
+    readonly existingSite?: ExistingSiteSnapshot;
 }
 export interface SkinCandidateFailure {
     readonly id: string;

package/dist/site-plan/skin-candidates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skin-candidates.d.ts","sourceRoot":"","sources":["../../src/site-plan/skin-candidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EA+BnD,CAAA;AAED,eAAO,MAAM,mBAAmB,IAAI,CAAA;AACpC,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAEpC,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,uGAAuG;IACvG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,sDAAsD;IACtD,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,4BAA4B,GACpC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAA;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAA;CACnD,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,8FAA8F;IAC9F,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAA;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAA;CACnD,CAAA;AAOL,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,4BAA4B,CAAC,CA6DvC"}
+{"version":3,"file":"skin-candidates.d.ts","sourceRoot":"","sources":["../../src/site-plan/skin-candidates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE3D,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EA+BnD,CAAA;AAED,eAAO,MAAM,mBAAmB,IAAI,CAAA;AACpC,eAAO,MAAM,mBAAmB,IAAI,CAAA;AAEpC,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,uGAAuG;IACvG,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,sDAAsD;IACtD,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;IACzC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAA;CAC7C;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,4BAA4B,GACpC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAA;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAA;CACnD,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,8FAA8F;IAC9F,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAA;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,CAAA;CACnD,CAAA;AAOL,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,4BAA4B,CAAC,CAoEvC"}

package/dist/site-plan/skin-candidates.js

@@ -1,4 +1,5 @@
 import { generateSkin } from '../skin/generate.js';
+import { isExistingSiteEmpty, renderExistingSiteForPrompt, } from './site-context.js';
 /**
  * Five directions, ordered. Asking one model for "three different skins"
  * in one call reliably produces three near-identical ones; asking three
@@ -43,6 +44,10 @@ function clampCount(count) {
 }
 export async function generateSkinCandidates(options) {
     const directions = SKIN_DIRECTIONS.slice(0, clampCount(options.count));
+    const hasExistingSite = options.existingSite !== undefined && !isExistingSiteEmpty(options.existingSite);
+    const context = hasExistingSite && options.existingSite !== undefined
+        ? [{ source: 'current site', content: renderExistingSiteForPrompt(options.existingSite) }]
+        : undefined;
     // Run in parallel: the installer's whole promise is measured in seconds,
     // and five sequential three-attempt loops is a minute of staring at a
     // spinner. Each call is independent — no candidate reads another's result.
@@ -55,6 +60,7 @@ export async function generateSkinCandidates(options) {
             ...(options.maxAttemptsPerCandidate === undefined
                 ? {}
                 : { maxAttempts: options.maxAttemptsPerCandidate }),
+            ...(context === undefined ? {} : { context }),
         });
         return { direction, result };
     }));

package/dist/site-plan/skin-candidates.js.map

@@ -1 +1 @@
-{"version":3,"file":"skin-candidates.js","sourceRoot":"","sources":["../../src/site-plan/skin-candidates.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skin-candidates.js","sourceRoot":"","sources":["../../src/site-plan/skin-candidates.ts"],"names":[],"mappings":"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"}

package/dist/site-plan/structural-gaps.d.ts

@@ -0,0 +1,32 @@
+import type { ExistingSiteSnapshot } from './site-context.js';
+import type { ProposedPage } from './types.js';
+/**
+ * Fiche 60 task 5 — "un site sans page « contact » reçoit une suggestion
+ * nommée comme telle, refusable comme tout le reste."
+ *
+ * Deterministic, like `./constraints.js`: this never asks a model. It
+ * compares what the plan already proposes, plus what the site already
+ * declares, against a closed list of pages most sites need — and says
+ * nothing about the ones already covered. A suggestion is never applied by
+ * itself (R6): it becomes its own reviewable item (`./approval.js`'s
+ * `structuralGaps` section), accepted or rejected exactly like a proposed
+ * collection or a proposed page.
+ */
+export declare const STRUCTURAL_GAP_TOPICS: readonly ['contact', 'legal', 'privacy'];
+export type StructuralGapTopic = (typeof STRUCTURAL_GAP_TOPICS)[number];
+export interface StructuralGapSuggestion {
+    /** Stable within a draft — one topic can appear at most once. */
+    readonly id: StructuralGapTopic;
+    readonly topic: StructuralGapTopic;
+    readonly title: string;
+    readonly slug: string;
+    readonly reason: string;
+}
+export interface DetectStructuralGapsInput {
+    readonly proposedPages: readonly ProposedPage[];
+    readonly existingSite: ExistingSiteSnapshot;
+    /** Which language to phrase a suggestion's title/reason in. Defaults to `en`. */
+    readonly locale?: string;
+}
+export declare function detectStructuralGaps(input: DetectStructuralGapsInput): readonly StructuralGapSuggestion[];
+//# sourceMappingURL=structural-gaps.d.ts.map

package/dist/site-plan/structural-gaps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-gaps.d.ts","sourceRoot":"","sources":["../../src/site-plan/structural-gaps.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,qBAAqB,YAAI,SAAS,EAAE,OAAO,EAAE,SAAS,CAAU,CAAA;AAC7E,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,MAAM,WAAW,uBAAuB;IACtC,iEAAiE;IACjE,QAAQ,CAAC,EAAE,EAAE,kBAAkB,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAyDD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,CAAA;IAC/C,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAA;IAC3C,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,yBAAyB,GAC/B,SAAS,uBAAuB,EAAE,CAuBpC"}

package/dist/site-plan/structural-gaps.js

@@ -0,0 +1,77 @@
+import { fold } from './constraints.js';
+/**
+ * Fiche 60 task 5 — "un site sans page « contact » reçoit une suggestion
+ * nommée comme telle, refusable comme tout le reste."
+ *
+ * Deterministic, like `./constraints.js`: this never asks a model. It
+ * compares what the plan already proposes, plus what the site already
+ * declares, against a closed list of pages most sites need — and says
+ * nothing about the ones already covered. A suggestion is never applied by
+ * itself (R6): it becomes its own reviewable item (`./approval.js`'s
+ * `structuralGaps` section), accepted or rejected exactly like a proposed
+ * collection or a proposed page.
+ */
+export const STRUCTURAL_GAP_TOPICS = ['contact', 'legal', 'privacy'];
+const GAP_TEMPLATES = [
+    {
+        topic: 'contact',
+        pattern: /\b(contact|nous contacter|contactez[- ]nous|reach us|get in touch)\b/,
+        title: { en: 'Contact', fr: 'Contact' },
+        slug: { en: 'contact', fr: 'contact' },
+        reason: {
+            en: 'Most sites need a way for a visitor to reach the site owner.',
+            fr: 'La plupart des sites ont besoin d’un moyen pour qu’un visiteur puisse joindre le responsable du site.',
+        },
+    },
+    {
+        topic: 'legal',
+        pattern: /\b(mentions legales|legal notice|imprint|impressum)\b/,
+        title: { en: 'Legal notice', fr: 'Mentions légales' },
+        slug: { en: 'legal-notice', fr: 'mentions-legales' },
+        reason: {
+            en: 'Legally required in most jurisdictions once a site names an identified owner.',
+            fr: 'Obligatoire dans la plupart des juridictions dès qu’un site nomme un responsable identifié.',
+        },
+    },
+    {
+        topic: 'privacy',
+        pattern: /\b(politique de confidentialite|vie privee|privacy policy|donnees personnelles)\b/,
+        title: { en: 'Privacy policy', fr: 'Politique de confidentialité' },
+        slug: { en: 'privacy-policy', fr: 'politique-de-confidentialite' },
+        reason: {
+            en: 'Expected wherever the site collects any personal data — a contact form, an account, analytics.',
+            fr: 'Attendue dès que le site collecte des données personnelles — un formulaire de contact, un compte, des statistiques de visite.',
+        },
+    },
+];
+function covered(pattern, texts) {
+    return texts.some((text) => pattern.test(fold(text)));
+}
+function pick(text, locale) {
+    return locale.toLowerCase().startsWith('fr') ? text.fr : text.en;
+}
+export function detectStructuralGaps(input) {
+    const locale = input.locale ?? 'en';
+    const known = [
+        ...input.proposedPages.flatMap((page) => [page.title, page.slug]),
+        ...input.existingSite.collections.flatMap((collection) => [
+            collection.name,
+            collection.labels.singular,
+            collection.labels.plural,
+        ]),
+    ];
+    const suggestions = [];
+    for (const template of GAP_TEMPLATES) {
+        if (covered(template.pattern, known))
+            continue;
+        suggestions.push({
+            id: template.topic,
+            topic: template.topic,
+            title: pick(template.title, locale),
+            slug: pick(template.slug, locale),
+            reason: pick(template.reason, locale),
+        });
+    }
+    return suggestions;
+}
+//# sourceMappingURL=structural-gaps.js.map

package/dist/site-plan/structural-gaps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-gaps.js","sourceRoot":"","sources":["../../src/site-plan/structural-gaps.ts"],"names":[],"mappings":"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"}

package/dist/site-plan/types.d.ts

@@ -2,6 +2,7 @@ import type { SkinTokens } from '@cogenta/render';
 import type { CollectionDefinition } from '@cogenta/schema';
 import type { DocumentFormat } from '../documents/extract-text.js';
 import type { DetectedConstraint } from './constraints.js';
+import type { StructuralGapSuggestion } from './structural-gaps.js';
 /**
  * The shapes L19's four agents pass between each other.
  *
@@ -80,6 +81,12 @@ export interface SitePlanDraft {
     readonly demoContent: readonly DemoEntry[];
     /** What was removed or flagged because it contradicted an explicit constraint. */
     readonly violations: readonly ConstraintViolation[];
+    /**
+     * Usual pages this plan, and the site it would join, still lack —
+     * contact, a legal notice, a privacy policy (fiche 60 task 5). Its own
+     * reviewable section, never applied on its own (R6).
+     */
+    readonly structuralGaps: readonly StructuralGapSuggestion[];
     readonly warnings: readonly string[];
 }
 export interface ConstraintViolation {

package/dist/site-plan/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/site-plan/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/site-plan/types.ts"],"names":[],"mappings":"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"}

package/dist/skills/frontmatter.d.ts

@@ -1,11 +1,29 @@
 import type { SkillMetadata } from './types.js';
 /**
- * Deliberately not a YAML parser (R9: no new dependency for three flat
+ * Deliberately not a YAML parser (R9: no new dependency for a handful of flat
  * string fields) — `---\nkey: value\n---\nbody`, one `key: value` per line,
  * nothing nested.
+ *
+ * `version` is deliberately **not** required (L24 task 4): a real
+ * Claude Code/Codex `SKILL.md` — see any `SKILL.md` under this very repo's
+ * `.claude/skills/` directory — only ever carries `name` and `description`.
+ * Requiring a third field
+ * this format doesn't have would refuse the exact copy-paste this task exists
+ * to support. `file-store.ts`'s marketplace registry (L7) still writes a
+ * `version` (it needs one, to compare installed-vs-available), so this parser
+ * keeps reading it when present — it is just never demanded.
  */
 export declare function parseSkillFile(path: string, raw: string): {
     readonly metadata: SkillMetadata;
     readonly instructions: string;
 };
+/**
+ * The inverse of `parseSkillFile` — renders a skill back to `SKILL.md` text.
+ * Used by `library.ts` to write the canonical on-disk form of a skill edited
+ * through the structured `AgentSkillStore` contract. Field order (`name`,
+ * `description`, then `version` only if present) matches every real
+ * Claude Code/Codex skill this project has seen, so a file this function
+ * writes reads exactly like one a human would have written by hand.
+ */
+export declare function renderSkillFile(metadata: SkillMetadata, instructions: string): string;
 //# sourceMappingURL=frontmatter.d.ts.map

package/dist/skills/frontmatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/skills/frontmatter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAI/C;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV;IAAE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAsCrE"}
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/skills/frontmatter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAI/C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV;IAAE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAsCrE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAKrF"}

package/dist/skills/frontmatter.js

@@ -1,9 +1,18 @@
 import { CogentaError } from '@cogenta/core';
-const REQUIRED_FIELDS = ['name', 'version', 'description'];
+const REQUIRED_FIELDS = ['name', 'description'];
 /**
- * Deliberately not a YAML parser (R9: no new dependency for three flat
+ * Deliberately not a YAML parser (R9: no new dependency for a handful of flat
  * string fields) — `---\nkey: value\n---\nbody`, one `key: value` per line,
  * nothing nested.
+ *
+ * `version` is deliberately **not** required (L24 task 4): a real
+ * Claude Code/Codex `SKILL.md` — see any `SKILL.md` under this very repo's
+ * `.claude/skills/` directory — only ever carries `name` and `description`.
+ * Requiring a third field
+ * this format doesn't have would refuse the exact copy-paste this task exists
+ * to support. `file-store.ts`'s marketplace registry (L7) still writes a
+ * `version` (it needs one, to compare installed-vs-available), so this parser
+ * keeps reading it when present — it is just never demanded.
  */
 export function parseSkillFile(path, raw) {
     const match = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/.exec(raw);
@@ -11,7 +20,7 @@ export function parseSkillFile(path, raw) {
         throw new CogentaError({
             code: 'SKILL_DEFINITION_INVALID',
             message: `"${path}" has no --- frontmatter block.`,
-            hint: 'Start the file with --- \\n name: ... \\n version: ... \\n description: ... \\n ---',
+            hint: 'Start the file with --- \\n name: ... \\n description: ... \\n ---',
         });
     }
     const [, frontmatter = '', body = ''] = match;
@@ -31,16 +40,31 @@ export function parseSkillFile(path, raw) {
         throw new CogentaError({
             code: 'SKILL_DEFINITION_INVALID',
             message: `"${path}" is missing required frontmatter field(s): ${missing.join(', ')}.`,
-            hint: 'A skill needs name, version and description in its frontmatter.',
+            hint: 'A skill needs at least name and description in its frontmatter.',
         });
     }
     return {
         metadata: {
             name: fields.name,
-            version: fields.version,
             description: fields.description,
+            ...(fields.version === undefined ? {} : { version: fields.version }),
         },
         instructions: body.trim(),
     };
 }
+/**
+ * The inverse of `parseSkillFile` — renders a skill back to `SKILL.md` text.
+ * Used by `library.ts` to write the canonical on-disk form of a skill edited
+ * through the structured `AgentSkillStore` contract. Field order (`name`,
+ * `description`, then `version` only if present) matches every real
+ * Claude Code/Codex skill this project has seen, so a file this function
+ * writes reads exactly like one a human would have written by hand.
+ */
+export function renderSkillFile(metadata, instructions) {
+    const lines = [`name: ${metadata.name}`, `description: ${metadata.description}`];
+    if (metadata.version !== undefined)
+        lines.splice(1, 0, `version: ${metadata.version}`);
+    const body = instructions.trim();
+    return `---\n${lines.join('\n')}\n---\n\n${body}\n`;
+}
 //# sourceMappingURL=frontmatter.js.map

package/dist/skills/frontmatter.js.map

@@ -1 +1 @@
-{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/skills/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAG5C,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAU,CAAA;AAEnE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,GAAW;IAEX,MAAM,KAAK,GAAG,6CAA6C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,IAAI,IAAI,iCAAiC;YAClD,IAAI,EAAE,qFAAqF;SAC5F,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,CAAC,EAAE,WAAW,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,CAAA;IAE7C,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAQ;QAChC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,cAAc,KAAK,CAAC,CAAC;YAAE,SAAQ;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,EAAE,CAAA;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACnD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACrB,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAA;IAC9E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,IAAI,IAAI,+CAA+C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACrF,IAAI,EAAE,iEAAiE;SACxE,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC,IAAc;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAiB;YACjC,WAAW,EAAE,MAAM,CAAC,WAAqB;SAC1C;QACD,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE;KAC1B,CAAA;AACH,CAAC"}
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/skills/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAG5C,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,aAAa,CAAU,CAAA;AAExD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,GAAW;IAEX,MAAM,KAAK,GAAG,6CAA6C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,IAAI,IAAI,iCAAiC;YAClD,IAAI,EAAE,oEAAoE;SAC3E,CAAC,CAAA;IACJ,CAAC;IACD,MAAM,CAAC,EAAE,WAAW,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,CAAA;IAE7C,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAQ;QAChC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,cAAc,KAAK,CAAC,CAAC;YAAE,SAAQ;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,EAAE,CAAA;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QACnD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACrB,CAAC;IAED,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,CAAA;IAC9E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CAAC;YACrB,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,IAAI,IAAI,+CAA+C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACrF,IAAI,EAAE,iEAAiE;SACxE,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE;YACR,IAAI,EAAE,MAAM,CAAC,IAAc;YAC3B,WAAW,EAAE,MAAM,CAAC,WAAqB;YACzC,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;SACrE;QACD,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE;KAC1B,CAAA;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,QAAuB,EAAE,YAAoB;IAC3E,MAAM,KAAK,GAAG,CAAC,SAAS,QAAQ,CAAC,IAAI,EAAE,EAAE,gBAAgB,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAA;IAChF,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACtF,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,CAAA;IAChC,OAAO,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAA;AACrD,CAAC"}

package/dist/skills/library.d.ts

@@ -0,0 +1,133 @@
+/**
+ * The standard reference-folder layout (fiche 57), matching the real Claude
+ * Code/Anthropic skill convention: sub-folders under a skill's own
+ * directory, all optional, `SKILL.md` the only thing required at the root.
+ * `references/` is documents consulted on demand, `scripts/` executable
+ * utilities, `assets/` templates/images/files used as-is — none of these are
+ * automatically read into an agent's context (see `AgentSkillStore`'s module
+ * doc for why); they exist for a human, or a future `skill.read_resource`
+ * tool, to reach for on purpose.
+ */
+export declare const SKILL_RESOURCE_DIRS: readonly ['references', 'scripts', 'assets'];
+export type SkillResourceDir = (typeof SKILL_RESOURCE_DIRS)[number];
+export interface SkillResource {
+    /** Relative to the skill's own directory, e.g. `"references/style-guide.md"`. Forward slashes always, on every OS. */
+    readonly path: string;
+    readonly size: number;
+    readonly updatedAt: string;
+}
+/**
+ * L22 task 1bis's "Skills" screen — a **different concept** from
+ * `skills/file-store.ts`'s `SkillStore`/`Skill`, which is L7's marketplace
+ * registry (a signed, distributable folder with resource files, gated by
+ * pre-check + review). This one is what the lot actually describes: "un
+ * skill est un texte d'instruction nommé... qu'un agent charge dans son
+ * contexte" — a short, site-authored piece of prompt text ("comment rédiger
+ * un article"), never installed from anywhere, never signed, edited
+ * in-place from the admin. Naming it `AgentSkill`/`AgentSkillStore` (this
+ * file lives in the same `skills/` directory as the marketplace one on
+ * purpose — they are siblings, not a replacement) keeps the two distinct in
+ * every import site rather than overloading `Skill`/`SkillStore`.
+ *
+ * **Storage format, changed in L24 task 4**: originally one JSON file per
+ * record (`<id>.json`). Now `<dir>/<id>/SKILL.md` (frontmatter + body),
+ * reusing `parseSkillFile`/`renderSkillFile` from `frontmatter.ts` rather
+ * than a second parser — the same format `file-store.ts`'s marketplace
+ * registry already speaks, and the format a real Claude Code/Codex skill
+ * ships in. This is what makes L24 task 4's acceptance criterion possible:
+ * a `SKILL.md` copied verbatim from `.claude/skills/` (or any other
+ * standard agent) is a valid `name`+`description`+body skill the moment it
+ * is dropped into this store's directory and given a matching `.meta.json`
+ * (or, read without one at all — see `readRecord` below).
+ *
+ * The fields this store needs that a portable `SKILL.md` has no room for
+ * (`enabledByDefault`, `builtin`, `createdAt`, `updatedAt`) are **not**
+ * folded into the frontmatter. Two options were open here (see
+ * `docs/lots/L24-langgraph-agents-avances.md` task 4): extra frontmatter
+ * keys (the parser already ignores keys it does not know), or a sidecar
+ * meta file. This store picks the sidecar (`.meta.json`, next to
+ * `SKILL.md`) **on purpose**: the whole point of this migration is
+ * portability — a skill authored here should export as a clean `SKILL.md`
+ * with nothing Cogenta-specific in it, and a `SKILL.md` imported here
+ * should not have its author's own frontmatter fields overwritten by this
+ * store's bookkeeping. Gluing `enabledByDefault`/`builtin`/timestamps into
+ * the frontmatter would make every skill this store ever touches carry
+ * Cogenta-only keys forever, defeating that.
+ */
+export interface AgentSkill {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly instructions: string;
+    /**
+     * The exact `SKILL.md` text on disk (frontmatter + body), rendered by
+     * `renderSkillFile` — what the admin's raw-Markdown editor (L24 task 4)
+     * reads and writes, and what a "copy this skill out" action would hand
+     * someone verbatim. Always the canonical rendering of `name`/`description`/
+     * `instructions` below: this store has one source of truth (the structured
+     * fields on `AgentSkillStore`'s contract, kept stable for its 11 existing
+     * call sites), and `content` is a derived, always-consistent view of it —
+     * never a second, independently-edited copy that could drift.
+     */
+    readonly content: string;
+    /**
+     * "Par défaut, un nouvel agent hérite de tous les skills du site" (L22 task
+     * 1bis) — a new agent's `AgentDeclaration.skills` is seeded with every
+     * skill whose `enabledByDefault` is true at the moment it is created
+     * (`agents/orchestrator.ts`'s creation path reads this), so the field stays
+     * a plain inclusion list (contract C's own documented shape) while still
+     * producing the lot's "inherit everything, exclude what you don't want"
+     * behaviour from the admin's point of view.
+     */
+    readonly enabledByDefault: boolean;
+    readonly builtin: boolean;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface AgentSkillInput {
+    readonly name: string;
+    readonly description: string;
+    readonly instructions: string;
+    readonly enabledByDefault?: boolean;
+}
+export type AgentSkillPatch = Partial<AgentSkillInput>;
+export interface AgentSkillStore {
+    list(): Promise<readonly AgentSkill[]>;
+    get(id: string): Promise<AgentSkill | undefined>;
+    create(input: AgentSkillInput, builtin?: boolean): Promise<AgentSkill>;
+    update(id: string, patch: AgentSkillPatch): Promise<AgentSkill>;
+    /** Refuses to remove a builtin (`AGENT_SKILL_BUILTIN_UNDELETABLE`). */
+    remove(id: string): Promise<void>;
+    /**
+     * Every file under the skill's directory except `SKILL.md`/`.meta.json` —
+     * `references/`, `scripts/`, `assets/`, and (for a skill imported from
+     * outside this store, which never had to follow the standard layout) any
+     * other file that happens to sit there too. Throws `AGENT_SKILL_UNKNOWN`
+     * for an unknown id. A skill created before this fiche, with no
+     * sub-folders yet, returns an empty list — never an error.
+     */
+    listResources(id: string): Promise<readonly SkillResource[]>;
+    /**
+     * Writes (or overwrites) a reference file. `relativePath` must start with
+     * one of `SKILL_RESOURCE_DIRS` — anything else, or a path that tries to
+     * escape the skill's own directory, is refused with
+     * `AGENT_SKILL_RESOURCE_INVALID`. Throws `AGENT_SKILL_UNKNOWN` for an
+     * unknown skill id.
+     */
+    addResource(id: string, relativePath: string, content: string | Uint8Array): Promise<SkillResource>;
+    /**
+     * Throws `AGENT_SKILL_RESOURCE_INVALID` for a path outside the three
+     * standard folders, `AGENT_SKILL_RESOURCE_UNKNOWN` for a path that names
+     * no file, and `AGENT_SKILL_UNKNOWN` for an unknown skill id.
+     */
+    removeResource(id: string, relativePath: string): Promise<void>;
+}
+export interface FileAgentSkillStoreOptions {
+    readonly dir: string;
+    readonly now?: () => Date;
+}
+export declare function createFileAgentSkillStore(options: FileAgentSkillStoreOptions): AgentSkillStore;
+/** L22 task 1bis: "au minimum ces trois" — content writing, a basic security review, and site-structure/menu management. */
+export declare function builtinAgentSkillSeeds(): readonly AgentSkillInput[];
+export declare function ensureBuiltinAgentSkills(store: AgentSkillStore): Promise<void>;
+//# sourceMappingURL=library.d.ts.map

package/dist/skills/library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library.d.ts","sourceRoot":"","sources":["../../src/skills/library.ts"],"names":[],"mappings":"AASA;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,YAAI,YAAY,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAA;AAC/E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,MAAM,WAAW,aAAa;IAC5B,sHAAsH;IACtH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B;;;;;;;;;OASG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB;;;;;;;;OAQG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CACpC;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;AAEtD,MAAM,WAAW,eAAe;IAC9B,IAAI,IAAI,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAA;IACtC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAA;IAChD,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACtE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAC/D,uEAAuE;IACvE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAA;IAC5D;;;;;;OAMG;IACH,WAAW,CACT,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GAAG,UAAU,GAC3B,OAAO,CAAC,aAAa,CAAC,CAAA;IACzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChE;AAiED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CAC1B;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,eAAe,CA6O9F;AAED,4HAA4H;AAC5H,wBAAgB,sBAAsB,IAAI,SAAS,eAAe,EAAE,CAkCnE;AAED,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpF"}