@senior-skills/core 1.0.0

package/dist/domain/validation.d.ts

@@ -0,0 +1,30 @@
+export type IssueSeverity = 'error' | 'warning' | 'info';
+export interface ValidationIssue {
+    readonly severity: IssueSeverity;
+    /** Stable identifier, e.g. `manifest.name.mismatch`. Used in tests and docs. */
+    readonly rule: string;
+    /** Dotted path into the document, or a file path. */
+    readonly at: string;
+    readonly message: string;
+    /** Concrete fix, when there is an obvious one. */
+    readonly hint?: string;
+}
+export interface ValidationReport {
+    readonly ok: boolean;
+    readonly issues: readonly ValidationIssue[];
+    readonly errors: readonly ValidationIssue[];
+    readonly warnings: readonly ValidationIssue[];
+}
+export declare function buildReport(issues: readonly ValidationIssue[]): ValidationReport;
+/** Small helper so validators read as a list of rules rather than a list of pushes. */
+export declare class IssueCollector {
+    private readonly issues;
+    error(rule: string, at: string, message: string, hint?: string): void;
+    warn(rule: string, at: string, message: string, hint?: string): void;
+    info(rule: string, at: string, message: string, hint?: string): void;
+    private add;
+    absorb(issues: readonly ValidationIssue[]): void;
+    all(): readonly ValidationIssue[];
+    report(): ValidationReport;
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/domain/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/domain/validation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,gBAAgB,CAIhF;AAED,uFAAuF;AACvF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAIrE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAIpE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAIpE,OAAO,CAAC,GAAG;IAYX,MAAM,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI;IAIhD,GAAG,IAAI,SAAS,eAAe,EAAE;IAIjC,MAAM,IAAI,gBAAgB;CAG3B"}

package/dist/domain/validation.js

@@ -0,0 +1,32 @@
+export function buildReport(issues) {
+    const errors = issues.filter((issue) => issue.severity === 'error');
+    const warnings = issues.filter((issue) => issue.severity === 'warning');
+    return { ok: errors.length === 0, issues, errors, warnings };
+}
+/** Small helper so validators read as a list of rules rather than a list of pushes. */
+export class IssueCollector {
+    issues = [];
+    error(rule, at, message, hint) {
+        this.add('error', rule, at, message, hint);
+    }
+    warn(rule, at, message, hint) {
+        this.add('warning', rule, at, message, hint);
+    }
+    info(rule, at, message, hint) {
+        this.add('info', rule, at, message, hint);
+    }
+    add(severity, rule, at, message, hint) {
+        const issue = hint === undefined ? { severity, rule, at, message } : { severity, rule, at, message, hint };
+        this.issues.push(issue);
+    }
+    absorb(issues) {
+        this.issues.push(...issues);
+    }
+    all() {
+        return this.issues;
+    }
+    report() {
+        return buildReport(this.issues);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/domain/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/domain/validation.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,WAAW,CAAC,MAAkC;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IACxE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC/D,CAAC;AAED,uFAAuF;AACvF,MAAM,OAAO,cAAc;IACR,MAAM,GAAsB,EAAE,CAAC;IAEhD,KAAK,CAAC,IAAY,EAAE,EAAU,EAAE,OAAe,EAAE,IAAa;QAC5D,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,EAAU,EAAE,OAAe,EAAE,IAAa;QAC3D,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,EAAU,EAAE,OAAe,EAAE,IAAa;QAC3D,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAEO,GAAG,CACT,QAAuB,EACvB,IAAY,EACZ,EAAU,EACV,OAAe,EACf,IAAa;QAEb,MAAM,KAAK,GACT,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC/F,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,MAAkC;QACvC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,MAAM;QACJ,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/domain/version.d.ts

@@ -0,0 +1,23 @@
+/**
+ * A validated, strict semantic version string. Nominal typing keeps unvalidated strings
+ * from reaching the resolver: the only way to obtain one is through {@link parseVersion}.
+ */
+export type SemanticVersion = string & {
+    readonly __brand: 'SemanticVersion';
+};
+export declare function isSemanticVersion(value: string): boolean;
+export declare function parseVersion(value: string, context?: string): SemanticVersion;
+export declare function parseRange(value: string, context?: string): string;
+export declare function satisfies(version: SemanticVersion, range: string): boolean;
+export declare function compareVersions(a: SemanticVersion, b: SemanticVersion): number;
+export declare function isPrerelease(version: SemanticVersion): boolean;
+export declare function sortVersionsDescending(versions: readonly SemanticVersion[]): readonly SemanticVersion[];
+/** Highest version satisfying `range`, or undefined. Stable releases win ties by sorting. */
+export declare function maxSatisfying(versions: readonly SemanticVersion[], range: string): SemanticVersion | undefined;
+/** True when every listed range can be satisfied by at least one of the versions. */
+export declare function intersects(ranges: readonly string[]): boolean;
+export type VersionBump = 'major' | 'minor' | 'patch' | 'prerelease' | 'same' | 'downgrade';
+/** Classifies a version change, used by `update` to describe what it did. */
+export declare function classifyChange(from: SemanticVersion, to: SemanticVersion): VersionBump;
+export declare function increment(version: SemanticVersion, release: 'major' | 'minor' | 'patch'): SemanticVersion;
+//# sourceMappingURL=version.d.ts.map

package/dist/domain/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/domain/version.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAE/E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAY7E;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CASlE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAI1E;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,MAAM,CAE9E;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAE9D;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,eAAe,EAAE,GACnC,SAAS,eAAe,EAAE,CAE5B;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,eAAe,EAAE,EACpC,KAAK,EAAE,MAAM,GACZ,eAAe,GAAG,SAAS,CAQ7B;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAI7D;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,WAAW,CAAC;AAE5F,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,eAAe,GAAG,WAAW,CAStF;AAED,wBAAgB,SAAS,CACvB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GACnC,eAAe,CAMjB"}

package/dist/domain/version.js

@@ -0,0 +1,81 @@
+import semver from 'semver';
+import { AgentSkillsError, ErrorCode } from "./errors.js";
+export function isSemanticVersion(value) {
+    return semver.valid(value, { loose: false }) !== null;
+}
+export function parseVersion(value, context) {
+    if (!isSemanticVersion(value)) {
+        throw new AgentSkillsError(ErrorCode.INVALID_VERSION, `Invalid version "${value}"`, {
+            details: context === undefined ? [] : [`In: ${context}`],
+            hints: [
+                'Versions must be strict semver: MAJOR.MINOR.PATCH (e.g. 1.0.0, 2.3.1-rc.1)',
+                'Ranges such as ^1.0.0 belong in dependencies, not in the version field',
+            ],
+            data: { value, context },
+        });
+    }
+    return value;
+}
+export function parseRange(value, context) {
+    if (semver.validRange(value) === null) {
+        throw new AgentSkillsError(ErrorCode.INVALID_VERSION, `Invalid version range "${value}"`, {
+            details: context === undefined ? [] : [`In: ${context}`],
+            hints: ['Valid forms: 1.2.0, ^1.2.0, ~1.2, >=1.0.0 <2.0.0, *'],
+            data: { value, context },
+        });
+    }
+    return value;
+}
+export function satisfies(version, range) {
+    // includePrerelease keeps `1.0.0-rc.1` resolvable when a user asks for it explicitly,
+    // while `maxSatisfying` below still prefers stable releases because they sort higher.
+    return semver.satisfies(version, range, { includePrerelease: true });
+}
+export function compareVersions(a, b) {
+    return semver.compare(a, b);
+}
+export function isPrerelease(version) {
+    return semver.prerelease(version) !== null;
+}
+export function sortVersionsDescending(versions) {
+    return [...versions].sort((a, b) => semver.rcompare(a, b));
+}
+/** Highest version satisfying `range`, or undefined. Stable releases win ties by sorting. */
+export function maxSatisfying(versions, range) {
+    const stable = versions.filter((version) => semver.prerelease(version) === null);
+    const pool = stable.length > 0 ? stable : versions;
+    const best = semver.maxSatisfying([...pool], range, { includePrerelease: true });
+    if (best !== null)
+        return best;
+    // Fall back to the full set so an explicit prerelease range still resolves.
+    const fallback = semver.maxSatisfying([...versions], range, { includePrerelease: true });
+    return fallback === null ? undefined : fallback;
+}
+/** True when every listed range can be satisfied by at least one of the versions. */
+export function intersects(ranges) {
+    return ranges.every((a, index) => ranges.slice(index + 1).every((b) => semver.intersects(a, b, { includePrerelease: true })));
+}
+/** Classifies a version change, used by `update` to describe what it did. */
+export function classifyChange(from, to) {
+    const comparison = semver.compare(from, to);
+    if (comparison === 0)
+        return 'same';
+    if (comparison > 0)
+        return 'downgrade';
+    const diff = semver.diff(from, to);
+    if (diff === 'major' || diff === 'premajor')
+        return 'major';
+    if (diff === 'minor' || diff === 'preminor')
+        return 'minor';
+    if (diff === 'patch' || diff === 'prepatch')
+        return 'patch';
+    return 'prerelease';
+}
+export function increment(version, release) {
+    const next = semver.inc(version, release);
+    if (next === null) {
+        throw new AgentSkillsError(ErrorCode.INVALID_VERSION, `Cannot increment "${version}"`);
+    }
+    return next;
+}
+//# sourceMappingURL=version.js.map

package/dist/domain/version.js.map

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

package/dist/domain/workflow-document.d.ts

@@ -0,0 +1,23 @@
+import type { SkillDocument } from './skill-document.ts';
+/**
+ * A workflow's entrypoint is JavaScript, not Markdown, so its identity lives in
+ * `export const meta = { … }` rather than in YAML frontmatter.
+ *
+ * Reading it statically — never executing the script — is what lets `validate`, `search` and
+ * `info` describe a workflow the same way they describe a skill. The result is deliberately a
+ * {@link SkillDocument}: `meta` becomes the frontmatter and the script becomes the body, so
+ * every rule downstream (name agreement, description required, version match) applies to all
+ * package kinds without knowing which one it is looking at.
+ *
+ * The two constraints enforced here are Claude Code's own: the declaration must be the first
+ * statement, and it must be a pure literal. A package this parser accepts is one the agent
+ * can compile.
+ */
+export declare function parseWorkflowDocument(text: string, source?: string): SkillDocument;
+/**
+ * Renders a workflow document back to a script. Used by the scaffold; installs copy the
+ * author's bytes verbatim rather than round-tripping, because reformatting someone's
+ * JavaScript is not this tool's business.
+ */
+export declare function stringifyWorkflowDocument(doc: SkillDocument): string;
+//# sourceMappingURL=workflow-document.d.ts.map

package/dist/domain/workflow-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-document.d.ts","sourceRoot":"","sources":["../../src/domain/workflow-document.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,SAAgB,GAAG,aAAa,CA0CzF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAEpE"}

package/dist/domain/workflow-document.js

@@ -0,0 +1,56 @@
+import { AgentSkillsError, ErrorCode } from "./errors.js";
+import { parseJsLiteral, skipTrivia } from "./js-literal.js";
+/**
+ * A workflow's entrypoint is JavaScript, not Markdown, so its identity lives in
+ * `export const meta = { … }` rather than in YAML frontmatter.
+ *
+ * Reading it statically — never executing the script — is what lets `validate`, `search` and
+ * `info` describe a workflow the same way they describe a skill. The result is deliberately a
+ * {@link SkillDocument}: `meta` becomes the frontmatter and the script becomes the body, so
+ * every rule downstream (name agreement, description required, version match) applies to all
+ * package kinds without knowing which one it is looking at.
+ *
+ * The two constraints enforced here are Claude Code's own: the declaration must be the first
+ * statement, and it must be a pure literal. A package this parser accepts is one the agent
+ * can compile.
+ */
+export function parseWorkflowDocument(text, source = 'WORKFLOW.js') {
+    const normalized = text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+    const start = skipTrivia(normalized, 0);
+    const declaration = /^export\s+const\s+meta\s*=\s*/.exec(normalized.slice(start));
+    if (declaration === null) {
+        throw new AgentSkillsError(ErrorCode.INVALID_PACKAGE, `${source} does not begin with an "export const meta" declaration`, {
+            details: ['It must be the first statement, before any other code.'],
+            hints: [
+                'Example:',
+                'export const meta = {',
+                "  name: 'ship-review',",
+                "  description: 'What the workflow does.',",
+                '};',
+            ],
+            data: { source },
+        });
+    }
+    const { value, end } = parseJsLiteral(normalized, start + declaration[0].length, `${source}: meta must be a pure literal`);
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new AgentSkillsError(ErrorCode.INVALID_PACKAGE, `${source}: meta must be an object`, {
+            data: { source },
+        });
+    }
+    return {
+        frontmatter: value,
+        body: normalized
+            .slice(end)
+            .replace(/^[;\s]*\n/, '')
+            .trimStart(),
+    };
+}
+/**
+ * Renders a workflow document back to a script. Used by the scaffold; installs copy the
+ * author's bytes verbatim rather than round-tripping, because reformatting someone's
+ * JavaScript is not this tool's business.
+ */
+export function stringifyWorkflowDocument(doc) {
+    return `export const meta = ${JSON.stringify(doc.frontmatter, null, 2)};\n\n${doc.body.trimStart()}`;
+}
+//# sourceMappingURL=workflow-document.js.map

package/dist/domain/workflow-document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-document.js","sourceRoot":"","sources":["../../src/domain/workflow-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAAM,GAAG,aAAa;IACxE,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxE,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAExC,MAAM,WAAW,GAAG,+BAA+B,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAClF,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,gBAAgB,CACxB,SAAS,CAAC,eAAe,EACzB,GAAG,MAAM,yDAAyD,EAClE;YACE,OAAO,EAAE,CAAC,wDAAwD,CAAC;YACnE,KAAK,EAAE;gBACL,UAAU;gBACV,uBAAuB;gBACvB,wBAAwB;gBACxB,2CAA2C;gBAC3C,IAAI;aACL;YACD,IAAI,EAAE,EAAE,MAAM,EAAE;SACjB,CACF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,cAAc,CACnC,UAAU,EACV,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,EAC7B,GAAG,MAAM,+BAA+B,CACzC,CAAC;IAEF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,gBAAgB,CAAC,SAAS,CAAC,eAAe,EAAE,GAAG,MAAM,0BAA0B,EAAE;YACzF,IAAI,EAAE,EAAE,MAAM,EAAE;SACjB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,WAAW,EAAE,KAAgC;QAC7C,IAAI,EAAE,UAAU;aACb,KAAK,CAAC,GAAG,CAAC;aACV,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;aACxB,SAAS,EAAE;KACf,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAkB;IAC1D,OAAO,uBAAuB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;AACvG,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `@senior-skills/core` — the agent-agnostic heart of senior-skills.
+ *
+ * Contains the domain model, the application services, and the port interfaces every
+ * adapter implements. It has no knowledge of Claude Code, Codex, git, HTTP or the
+ * filesystem: those live behind the ports re-exported below.
+ */
+export { AgentSkillsError, ErrorCode, ExitCode, exitCodeFor, isAgentSkillsError, type AgentSkillsErrorOptions, } from './domain/errors.ts';
+export { detectionFrom, entryNameFor, INSTALL_SCOPES, type AgentDetection, type AgentId, type AgentLayout, type AgentLocation, type AgentTarget, type DetectionEvidence, type DetectionStrength, type EntryShape, type InstallScope, type LayoutEntry, type LocationContext, } from './domain/agent.ts';
+export { computeIntegrity, computePackageIntegrity, INTEGRITY_PREFIX, isIntegrityString, } from './domain/integrity.ts';
+export { CURRENT_LOCKFILE_VERSION, LOCKFILE_NAME, assertIntegrityMatches, emptyLockfile, parseLockfile, stringifyLockfile, withSkill, withoutSkill, type Lockfile, type LockedSkill, } from './domain/lockfile.ts';
+export { COMMAND_ENTRYPOINT, CURRENT_SCHEMA_VERSION, WORKFLOW_ENTRYPOINT, DEFAULT_PACKAGE_KIND, MANIFEST_FILENAME, PACKAGE_KINDS, SKILL_ENTRYPOINT, entrypointFor, parseManifest, stringifyManifest, type AgentCompatibility, type PackageKind, type ParsedManifest, type SkillAuthor, type SkillDependency, type SkillManifest, type SkillRepository, } from './domain/manifest.ts';
+export { MAX_PATH_SEGMENTS, MAX_SEGMENT_LENGTH, inspectPath, isSafePath, normalizeSafePath, type PathSafetyRule, type PathSafetyViolation, } from './domain/path-safety.ts';
+export * as posix from './domain/posix-path.ts';
+export { CURRENT_RECEIPT_VERSION, RECEIPT_DIRNAME, parseReceipt, receiptPath, stringifyReceipt, type InstallReceipt, type ReceiptFile, } from './domain/receipt.ts';
+export { CURRENT_INDEX_VERSION, findIndexEntry, parseRegistryIndex, stringifyRegistryIndex, type IndexSkillEntry, type IndexVersionEntry, type RegistryIndex, type RegistryKind, } from './domain/registry-index.ts';
+export { Resolver, type ResolutionResult, type ResolutionSource, type ResolveOptions, type ResolvedSkill, } from './domain/resolver.ts';
+export { documentDescription, documentName, documentVersion, parseSkillDocument, stringifySkillDocument, type SkillDocument, } from './domain/skill-document.ts';
+export { parseWorkflowDocument, stringifyWorkflowDocument } from './domain/workflow-document.ts';
+export { parseJsLiteral, skipTrivia } from './domain/js-literal.ts';
+export { buildSkillPackage, decodeText, encodeText, parseEntrypoint, findFile, isManifestFile, packageSize, readTextFile, type PackageFile, type SkillPackage, } from './domain/skill-package.ts';
+export { LATEST, SKILL_NAME_MAX_LENGTH, SKILL_NAME_MIN_LENGTH, assertValidSkillName, formatSkillRef, isValidSkillName, parseSkillRef, validateSkillName, type SkillRef, } from './domain/skill-ref.ts';
+export { buildReport, IssueCollector, type IssueSeverity, type ValidationIssue, type ValidationReport, } from './domain/validation.ts';
+export { classifyChange, compareVersions, increment, intersects, isSemanticVersion, isPrerelease, maxSatisfying, parseRange, parseVersion, satisfies, sortVersionsDescending, type SemanticVersion, type VersionBump, } from './domain/version.ts';
+export { AgentCatalog, type AgentAdapter, type DetectionContext } from './ports/agent-adapter.ts';
+export type { AgentConfig, AgentSkillsConfig, CacheConfig, ConfigStore, } from './ports/config-store.ts';
+export type { ArchiveEntry, ArchiveReader, Clock, CommandOptions, CommandResult, CommandRunner, DirEntry, Environment, FileStat, FileSystem, Hasher, HttpClient, HttpRequestOptions, HttpResponse, LogLevel, Logger, } from './ports/infrastructure.ts';
+export type { InstallationEngine, PackageExtractor, InstallOutcome, InstallRequest, InstallResult, InstalledSkill, UninstallRequest, UninstallResult, } from './ports/installation.ts';
+export type { FederatedRegistry, FetchedPackage, RefreshOptions, RegistryConfig, RegistryFactory, RegistryRouter, SearchQuery, SkillRegistry, SkillSummary, } from './ports/skill-registry.ts';
+export { ALL_AGENTS, detectAgents, detectionContext, locationContext, selectAgents, targetsFor, type AgentSelection, type AgentSelectionOptions, } from './application/agent-selection.ts';
+export type { ApplicationContext } from './application/context.ts';
+export { emptyUpdateState, type UpdateState, type UpdateStateStore, type ToolUpdater, type ToolUpdateAction, type SelectionPrompt, } from './ports/updates.ts';
+export { CheckUpdates, UPDATE_REMINDER_MS, type UpdateNotice, type SkillUpdateNotice, type UpdateNotices, } from './application/check-updates.ts';
+export { ApplySkillUpdates } from './application/apply-skill-updates.ts';
+export { CreateSkill, type CreateOptions, type CreateReport } from './application/create-skill.ts';
+export { DiagnoseSystem, type CheckStatus, type DiagnosticCheck, type DiagnosticSection, type DoctorOptions, type DoctorReport, } from './application/diagnose.ts';
+export { InstallSkills, formatIssue, type InstallOptions, type InstallReport, type InstallResolvedSkill, } from './application/install-skills.ts';
+export { ListInstalled, type ListEntry, type ListOptions, type ListReport, } from './application/list-installed.ts';
+export { DEFAULT_MAX_FILES, DEFAULT_MAX_TOTAL_BYTES, loadPackageFromDirectory, peekSkillDocument, scaffoldPackage, type LoadPackageOptions, type LoadedPackage, } from './application/package-loader.ts';
+export { PublishSkill, type PublishOptions, type PublishReport, } from './application/publish-skill.ts';
+export { RemoveSkills, type RemoveOptions, type RemoveReport, } from './application/remove-skills.ts';
+export { FederationResolutionSource } from './application/resolution-source.ts';
+export { DescribeSkill, SearchSkills, type SearchOptions, type SkillInfo, } from './application/search-skills.ts';
+export { UpdateSkills, type UpdateChange, type UpdateOptions, type UpdateReport, type UpdateAddition, } from './application/update-skills.ts';
+export { pathSafetyIssues, validateDirectory, validatePackage, type ValidateDirectoryResult, type ValidatePackageOptions, } from './application/validate-package.ts';
+export { findProjectRoot, lockfilePath, pinsFrom, readLockfile, requireProjectRoot, writeLockfile, } from './application/workspace.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,45 @@
+/**
+ * `@senior-skills/core` — the agent-agnostic heart of senior-skills.
+ *
+ * Contains the domain model, the application services, and the port interfaces every
+ * adapter implements. It has no knowledge of Claude Code, Codex, git, HTTP or the
+ * filesystem: those live behind the ports re-exported below.
+ */
+// --- Domain -----------------------------------------------------------------------------
+export { AgentSkillsError, ErrorCode, ExitCode, exitCodeFor, isAgentSkillsError, } from "./domain/errors.js";
+export { detectionFrom, entryNameFor, INSTALL_SCOPES, } from "./domain/agent.js";
+export { computeIntegrity, computePackageIntegrity, INTEGRITY_PREFIX, isIntegrityString, } from "./domain/integrity.js";
+export { CURRENT_LOCKFILE_VERSION, LOCKFILE_NAME, assertIntegrityMatches, emptyLockfile, parseLockfile, stringifyLockfile, withSkill, withoutSkill, } from "./domain/lockfile.js";
+export { COMMAND_ENTRYPOINT, CURRENT_SCHEMA_VERSION, WORKFLOW_ENTRYPOINT, DEFAULT_PACKAGE_KIND, MANIFEST_FILENAME, PACKAGE_KINDS, SKILL_ENTRYPOINT, entrypointFor, parseManifest, stringifyManifest, } from "./domain/manifest.js";
+export { MAX_PATH_SEGMENTS, MAX_SEGMENT_LENGTH, inspectPath, isSafePath, normalizeSafePath, } from "./domain/path-safety.js";
+export * as posix from "./domain/posix-path.js";
+export { CURRENT_RECEIPT_VERSION, RECEIPT_DIRNAME, parseReceipt, receiptPath, stringifyReceipt, } from "./domain/receipt.js";
+export { CURRENT_INDEX_VERSION, findIndexEntry, parseRegistryIndex, stringifyRegistryIndex, } from "./domain/registry-index.js";
+export { Resolver, } from "./domain/resolver.js";
+export { documentDescription, documentName, documentVersion, parseSkillDocument, stringifySkillDocument, } from "./domain/skill-document.js";
+export { parseWorkflowDocument, stringifyWorkflowDocument } from "./domain/workflow-document.js";
+export { parseJsLiteral, skipTrivia } from "./domain/js-literal.js";
+export { buildSkillPackage, decodeText, encodeText, parseEntrypoint, findFile, isManifestFile, packageSize, readTextFile, } from "./domain/skill-package.js";
+export { LATEST, SKILL_NAME_MAX_LENGTH, SKILL_NAME_MIN_LENGTH, assertValidSkillName, formatSkillRef, isValidSkillName, parseSkillRef, validateSkillName, } from "./domain/skill-ref.js";
+export { buildReport, IssueCollector, } from "./domain/validation.js";
+export { classifyChange, compareVersions, increment, intersects, isSemanticVersion, isPrerelease, maxSatisfying, parseRange, parseVersion, satisfies, sortVersionsDescending, } from "./domain/version.js";
+// --- Ports ------------------------------------------------------------------------------
+export { AgentCatalog } from "./ports/agent-adapter.js";
+// --- Application ------------------------------------------------------------------------
+export { ALL_AGENTS, detectAgents, detectionContext, locationContext, selectAgents, targetsFor, } from "./application/agent-selection.js";
+export { emptyUpdateState, } from "./ports/updates.js";
+export { CheckUpdates, UPDATE_REMINDER_MS, } from "./application/check-updates.js";
+export { ApplySkillUpdates } from "./application/apply-skill-updates.js";
+export { CreateSkill } from "./application/create-skill.js";
+export { DiagnoseSystem, } from "./application/diagnose.js";
+export { InstallSkills, formatIssue, } from "./application/install-skills.js";
+export { ListInstalled, } from "./application/list-installed.js";
+export { DEFAULT_MAX_FILES, DEFAULT_MAX_TOTAL_BYTES, loadPackageFromDirectory, peekSkillDocument, scaffoldPackage, } from "./application/package-loader.js";
+export { PublishSkill, } from "./application/publish-skill.js";
+export { RemoveSkills, } from "./application/remove-skills.js";
+export { FederationResolutionSource } from "./application/resolution-source.js";
+export { DescribeSkill, SearchSkills, } from "./application/search-skills.js";
+export { UpdateSkills, } from "./application/update-skills.js";
+export { pathSafetyIssues, validateDirectory, validatePackage, } from "./application/validate-package.js";
+export { findProjectRoot, lockfilePath, pinsFrom, readLockfile, requireProjectRoot, writeLockfile, } from "./application/workspace.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/ports/agent-adapter.d.ts

@@ -0,0 +1,65 @@
+import type { AgentDetection, AgentId, AgentLayout, AgentLocation, InstallScope, LocationContext } from '../domain/agent.ts';
+import type { PackageKind } from '../domain/manifest.ts';
+import type { SkillPackage } from '../domain/skill-package.ts';
+import type { ValidationIssue } from '../domain/validation.ts';
+import type { CommandRunner, Environment, FileSystem } from './infrastructure.ts';
+/**
+ * What an adapter may consult while detecting its agent.
+ *
+ * Detection is the one adapter method that must look at the real world, so it gets ports
+ * rather than reaching for `node:fs` — which is what makes "Codex is installed" a fact a
+ * unit test can fabricate with a fake home directory and a fake PATH.
+ */
+export interface DetectionContext {
+    readonly env: Environment;
+    readonly fs: FileSystem;
+    readonly commands: CommandRunner;
+}
+/**
+ * The extension point of the whole system. Supporting a new coding agent means shipping one
+ * implementation of this interface — no change to core, to the installer, or to the CLI.
+ *
+ * Note what is *absent*: `install` and `uninstall`. Adapters describe and project; the single
+ * hardened installer performs every write.
+ */
+export interface AgentAdapter {
+    /** Stable identifier, recorded in receipts and lockfiles. Never localised. */
+    readonly id: AgentId;
+    readonly displayName: string;
+    /** Accepted on `--agent`, e.g. `claude` for `claude-code`. */
+    readonly aliases: readonly string[];
+    /**
+     * Keys this adapter accepts under `agentOverrides.<id>`. Anything else is a validation
+     * error, which keeps the escape hatch narrow.
+     */
+    readonly overrideKeys: readonly string[];
+    /** Evidence-based detection, so `doctor` can explain its conclusion. */
+    detect(ctx: DetectionContext): Promise<AgentDetection>;
+    /**
+     * Where this agent keeps packages of one kind, and whether one package is a directory or
+     * a single file there. The only place a path convention is written down.
+     *
+     * Returns `undefined` when the agent has no concept of that kind — installs targeting it
+     * are then reported as skipped rather than written somewhere invented.
+     */
+    locationFor(kind: PackageKind, scope: InstallScope, ctx: LocationContext): AgentLocation | undefined;
+    /** Pure projection of a neutral package onto this agent's on-disk shape. */
+    layoutFor(pkg: SkillPackage): AgentLayout;
+    /** Agent-specific package checks, e.g. frontmatter this agent cannot accept. */
+    validate(pkg: SkillPackage): readonly ValidationIssue[];
+}
+/**
+ * Registry of known adapters. Built-in adapters are registered by the CLI's composition
+ * root; a third-party adapter package is registered the same way, which is what keeps
+ * "add an agent without touching core" true.
+ */
+export declare class AgentCatalog {
+    private readonly adapters;
+    register(adapter: AgentAdapter): this;
+    all(): readonly AgentAdapter[];
+    ids(): readonly AgentId[];
+    /** Resolves an id or an alias, case-insensitively. */
+    find(idOrAlias: string): AgentAdapter | undefined;
+    has(id: AgentId): boolean;
+}
+//# sourceMappingURL=agent-adapter.d.ts.map

package/dist/ports/agent-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-adapter.d.ts","sourceRoot":"","sources":["../../src/ports/agent-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,OAAO,EACP,WAAW,EACX,aAAa,EACb,YAAY,EACZ,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAElF;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAEzC,wEAAwE;IACxE,MAAM,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEvD;;;;;;OAMG;IACH,WAAW,CACT,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,eAAe,GACnB,aAAa,GAAG,SAAS,CAAC;IAE7B,4EAA4E;IAC5E,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,WAAW,CAAC;IAE1C,gFAAgF;IAChF,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,eAAe,EAAE,CAAC;CACzD;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAE7D,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAKrC,GAAG,IAAI,SAAS,YAAY,EAAE;IAI9B,GAAG,IAAI,SAAS,OAAO,EAAE;IAIzB,sDAAsD;IACtD,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IASjD,GAAG,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO;CAG1B"}

package/dist/ports/agent-adapter.js

@@ -0,0 +1,28 @@
+/**
+ * Registry of known adapters. Built-in adapters are registered by the CLI's composition
+ * root; a third-party adapter package is registered the same way, which is what keeps
+ * "add an agent without touching core" true.
+ */
+export class AgentCatalog {
+    adapters = new Map();
+    register(adapter) {
+        this.adapters.set(adapter.id, adapter);
+        return this;
+    }
+    all() {
+        return [...this.adapters.values()].sort((a, b) => a.id.localeCompare(b.id));
+    }
+    ids() {
+        return this.all().map((adapter) => adapter.id);
+    }
+    /** Resolves an id or an alias, case-insensitively. */
+    find(idOrAlias) {
+        const needle = idOrAlias.trim().toLowerCase();
+        return this.all().find((adapter) => adapter.id.toLowerCase() === needle ||
+            adapter.aliases.some((alias) => alias.toLowerCase() === needle));
+    }
+    has(id) {
+        return this.adapters.has(id);
+    }
+}
+//# sourceMappingURL=agent-adapter.js.map

package/dist/ports/agent-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-adapter.js","sourceRoot":"","sources":["../../src/ports/agent-adapter.ts"],"names":[],"mappings":"AAoEA;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACN,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE7D,QAAQ,CAAC,OAAqB;QAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,GAAG;QACD,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,sDAAsD;IACtD,IAAI,CAAC,SAAiB;QACpB,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CACpB,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,MAAM;YACnC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAClE,CAAC;IACJ,CAAC;IAED,GAAG,CAAC,EAAW;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/ports/config-store.d.ts

@@ -0,0 +1,27 @@
+import type { AgentId } from '../domain/agent.ts';
+import type { RegistryConfig } from './skill-registry.ts';
+export interface AgentConfig {
+    readonly enabled: boolean;
+    /** Overrides the adapter's default global skill root. Escape hatch for convention drift. */
+    readonly globalRoot?: string;
+    /** Overrides the adapter's default project-relative skill directory. */
+    readonly projectRoot?: string;
+}
+export interface CacheConfig {
+    readonly ttlSeconds: number;
+}
+export interface AgentSkillsConfig {
+    readonly schemaVersion: number;
+    /** Ordered: earlier registries take precedence. */
+    readonly registries: readonly RegistryConfig[];
+    readonly agents: Readonly<Record<AgentId, AgentConfig>>;
+    readonly cache: CacheConfig;
+}
+/** Persisted user configuration. A port so tests never touch a real home directory. */
+export interface ConfigStore {
+    load(): Promise<AgentSkillsConfig>;
+    save(config: AgentSkillsConfig): Promise<void>;
+    /** Absolute path of the config file, for `doctor` and error messages. */
+    location(): string;
+}
+//# sourceMappingURL=config-store.d.ts.map

package/dist/ports/config-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../../src/ports/config-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,4FAA4F;IAC5F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B;AAED,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC1B,IAAI,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,yEAAyE;IACzE,QAAQ,IAAI,MAAM,CAAC;CACpB"}

package/dist/ports/config-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config-store.js.map

package/dist/ports/config-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.js","sourceRoot":"","sources":["../../src/ports/config-store.ts"],"names":[],"mappings":""}