@agent-teams/docs-protocol 0.0.0

package/dist/composition/node-docs-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-docs-api.js","sourceRoot":"","sources":["../../src/composition/node-docs-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,+BAA+B,EAAE,MAAM,uDAAuD,CAAC;AAGxG,SAAS,YAAY;IACnB,OAAO,IAAI,YAAY,CAAC;QACtB,QAAQ,EAAE,IAAI,yBAAyB,EAAE;QACzC,OAAO,EAAE,IAAI,qBAAqB,EAAE;QACpC,UAAU,EAAE,IAAI,sBAAsB,EAAE;QACxC,QAAQ,EAAE,IAAI,qBAAqB,EAAE;KACtC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,QAAQ,CAAgD,SAA0B;IAC/F,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC;IACjC,MAAM,+BAA+B,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAQD,MAAM,UAAU,QAAQ,CAAC,KAA0B;IACjD,OAAO,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAGxB;IACC,OAAO,QAAQ,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAqB;IAC3C,OAAO,QAAQ,CAAC,YAAY,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAA0B;IACnD,OAAO,QAAQ,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAA8D;IACxF,OAAO,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAA0B;IAClD,OAAO,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/C,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { DocumentJsonValue, DocumentMetadataValue } from "@agent-teams/engineering-foundation/document-authoring";
+import type { DocsCodeAnchor } from "./model.js";
+export declare function normalizeCodeAnchors(values: readonly (DocumentJsonValue | DocumentMetadataValue)[]): readonly DocsCodeAnchor[];
+export declare function normalizeDocumentIds(values: readonly string[], subject: string): readonly string[];
+export declare function normalizeDocumentId(value: string, subject: string): string;
+export declare function assertDocumentMetadata(value: unknown): asserts value is Readonly<Record<string, DocumentJsonValue>>;
+//# sourceMappingURL=document-semantics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-semantics.d.ts","sourceRoot":"","sources":["../../src/domain/document-semantics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AAEvH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAuBjD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,iBAAiB,GAAG,qBAAqB,CAAC,EAAE,GAAG,SAAS,cAAc,EAAE,CA+B9H;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAgBlG;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E;AA2CD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAKnH"}

package/dist/domain/document-semantics.js

@@ -0,0 +1,146 @@
+import { DocsProfileError } from "./profile-policy.js";
+const PATTERN = /^[A-Za-z0-9._@*?/[\]-]+$/u;
+const DOCUMENT_ID = /^[A-Za-z0-9@][A-Za-z0-9@._/-]*$/u;
+const MAX_ITEMS = 256;
+const RESERVED_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+function hasControlCharacter(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code <= 0x1f || code === 0x7f) {
+            return true;
+        }
+    }
+    return false;
+}
+function object(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new DocsProfileError("Each code anchor must be an object.");
+    }
+    return value;
+}
+export function normalizeCodeAnchors(values) {
+    if (values.length > MAX_ITEMS) {
+        throw new DocsProfileError(`code_anchors exceeds ${MAX_ITEMS} items.`);
+    }
+    const anchors = values.map((value, index) => {
+        const candidate = object(value);
+        const keys = Object.keys(candidate).toSorted();
+        if (keys.length !== 2 || keys[0] !== "enforcement" || keys[1] !== "pattern") {
+            throw new DocsProfileError(`code_anchors[${index}] must contain exactly enforcement and pattern.`);
+        }
+        const enforcement = candidate["enforcement"];
+        const pattern = candidate["pattern"];
+        if (enforcement !== "advisory" && enforcement !== "required") {
+            throw new DocsProfileError(`code_anchors[${index}].enforcement must be advisory or required.`);
+        }
+        if (typeof pattern !== "string" || pattern.length === 0 || Buffer.byteLength(pattern, "utf8") > 512 || pattern !== pattern.normalize("NFC") || hasControlCharacter(pattern) || !PATTERN.test(pattern)) {
+            throw new DocsProfileError(`code_anchors[${index}].pattern is invalid.`);
+        }
+        const segments = pattern.split("/");
+        if (pattern.startsWith("/") ||
+            pattern.includes("\\") ||
+            segments.some((segment) => segment === "" || segment === "." || segment === "..") ||
+            segments[0] === "docs" ||
+            segments[0] === ".agents") {
+            throw new DocsProfileError(`code_anchors[${index}].pattern must be a safe source-relative pattern outside docs and .agents.`);
+        }
+        return Object.freeze({ enforcement, pattern });
+    });
+    const identities = anchors.map(({ enforcement, pattern }) => `${enforcement}\0${pattern}`);
+    if (new Set(identities).size !== identities.length) {
+        throw new DocsProfileError("code_anchors must be unique.");
+    }
+    return Object.freeze(anchors);
+}
+export function normalizeDocumentIds(values, subject) {
+    if (values.length > MAX_ITEMS) {
+        throw new DocsProfileError(`${subject} exceeds ${MAX_ITEMS} items.`);
+    }
+    const normalized = values.map((value, index) => {
+        if (value.length === 0 ||
+            Buffer.byteLength(value, "utf8") > 214 ||
+            value !== value.normalize("NFC") ||
+            hasControlCharacter(value) ||
+            !DOCUMENT_ID.test(value)) {
+            throw new DocsProfileError(`${subject}[${index}] is not a canonical document ID.`);
+        }
+        return value;
+    });
+    if (new Set(normalized).size !== normalized.length) {
+        throw new DocsProfileError(`${subject} contains duplicates.`);
+    }
+    return Object.freeze(normalized.toSorted((left, right) => Buffer.compare(Buffer.from(left), Buffer.from(right))));
+}
+export function normalizeDocumentId(value, subject) {
+    return normalizeDocumentIds([value], subject)[0];
+}
+function assertMetadataScalar(value) {
+    if (value === null || typeof value === "boolean") {
+        return true;
+    }
+    if (typeof value === "string") {
+        if (value !== value.normalize("NFC")) {
+            throw new DocsProfileError("Additional metadata strings must use Unicode NFC.");
+        }
+        return true;
+    }
+    if (typeof value === "number") {
+        if (!Number.isSafeInteger(value) || Object.is(value, -0)) {
+            throw new DocsProfileError("Additional metadata numbers must be safe integers other than negative zero.");
+        }
+        return true;
+    }
+    if (typeof value !== "object") {
+        throw new DocsProfileError("Additional metadata must use the closed JSON data model.");
+    }
+    return false;
+}
+function assertMetadataValue(value, depth, budget, seen) {
+    budget.values += 1;
+    if (budget.values > 100_000) {
+        throw new DocsProfileError("Additional metadata exceeds the value budget.");
+    }
+    if (assertMetadataScalar(value)) {
+        return;
+    }
+    const container = value;
+    if (depth > 64 || seen.has(container)) {
+        throw new DocsProfileError("Additional metadata must be an unshared tree of at most 64 levels.");
+    }
+    seen.add(container);
+    if (Array.isArray(value)) {
+        const keys = Reflect.ownKeys(value);
+        const dense = keys.length === value.length + 1 && keys.every((key) => key === "length" || (typeof key === "string" && Number.isSafeInteger(Number(key)) && String(Number(key)) === key && Number(key) >= 0 && Number(key) < value.length));
+        if (Object.getPrototypeOf(value) !== Array.prototype || value.length > 10_000 || !dense) {
+            throw new DocsProfileError("Additional metadata array is sparse, extended, invalid, or exceeds 10000 items.");
+        }
+        value.forEach((entry) => { assertMetadataValue(entry, depth + 1, budget, seen); });
+        return;
+    }
+    const prototype = Object.getPrototypeOf(container);
+    const keys = Reflect.ownKeys(container);
+    if ((prototype !== Object.prototype && prototype !== null) || keys.length > 10_000 || keys.some((key) => typeof key !== "string")) {
+        throw new DocsProfileError("Additional metadata mapping is invalid or exceeds 10000 properties.");
+    }
+    for (const key of keys) {
+        if (key !== key.normalize("NFC") || RESERVED_KEYS.has(key)) {
+            throw new DocsProfileError(`Additional metadata key ${key} is not canonical.`);
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        if (descriptor === undefined || !("value" in descriptor)) {
+            throw new DocsProfileError(`Additional metadata key ${key} must be a data property.`);
+        }
+        assertMetadataValue(descriptor.value, depth + 1, budget, seen);
+    }
+}
+export function assertDocumentMetadata(value) {
+    assertMetadataValue(value, 0, { values: 0 }, new WeakSet());
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new DocsProfileError("Additional metadata root must be an object.");
+    }
+    const encoded = JSON.stringify(value);
+    if (Buffer.byteLength(encoded, "utf8") > 1_048_576) {
+        throw new DocsProfileError("Additional metadata exceeds the 1 MiB JSON budget.");
+    }
+}
+//# sourceMappingURL=document-semantics.js.map

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

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

package/dist/domain/model.d.ts

@@ -0,0 +1,285 @@
+import type { DocumentDescriptor, DocumentIntent, DocumentJsonValue, DocumentMetadataObject, DocumentPlanV2, DocumentReceiptContract, DocumentTransactionInspectionV2, DocumentationCatalogSnapshotV2 } from "@agent-teams/engineering-foundation/document-authoring";
+export declare const DOCS_PROTOCOL_ID: "agent-teams.docs-protocol";
+export declare const DOCS_PROTOCOL_VERSION: 1;
+export type DocsCommand = "docs.check" | "docs.doctor" | "docs.find" | "docs.info" | "docs.new" | "docs.recover";
+export type DocsCommandOutcome = "authority-stale" | "cancelled" | "conflict" | "execution-failure" | "invalid-input" | "recovery-required" | "success" | "violation";
+export interface DocsDiagnostic {
+    readonly message: string;
+    readonly phase: "apply" | "authority" | "input" | "planning" | "query" | "recovery";
+    readonly ruleId: string;
+    readonly severity: "error" | "info" | "warning";
+    readonly subject: string;
+}
+export interface DocsCommandEnvelope<Result = unknown> {
+    readonly schemaVersion: 1;
+    readonly protocol: {
+        readonly id: typeof DOCS_PROTOCOL_ID;
+        readonly version: typeof DOCS_PROTOCOL_VERSION;
+    };
+    readonly command: DocsCommand;
+    readonly outcome: DocsCommandOutcome;
+    readonly diagnostics: readonly DocsDiagnostic[];
+    readonly result: Result;
+}
+export interface DocsExecution<Result> {
+    readonly envelope: DocsCommandEnvelope<Result>;
+    readonly exitCode: 0 | 1 | 2 | 3 | 130;
+}
+export interface DocsTypeProfile {
+    readonly type: string;
+    readonly initialStatus: string;
+    readonly allowedOwnerIds: readonly string[];
+    readonly identity: {
+        readonly format: "adr-four-digits" | "open-decision-three-digits" | "qualified";
+    };
+    readonly heading: {
+        readonly kind: "id-colon-title" | "title";
+    };
+    readonly placement: {
+        readonly kind: "collection";
+        readonly [key: string]: unknown;
+    } | {
+        readonly kind: "explicit";
+        readonly requiredSegmentsInOrder: readonly string[];
+    } | {
+        readonly kind: "qualified-leaf-index";
+        readonly [key: string]: unknown;
+    };
+    readonly requiredMetadata: readonly string[];
+    readonly reachability: {
+        readonly kind: "manual-fixed-index";
+        readonly indexPath: string;
+    } | {
+        readonly kind: "manual-colocated-index";
+        readonly indexBasename: "README.md";
+        readonly pathPrefix: "before-required-segments";
+    } | {
+        readonly kind: "not-required";
+        readonly reason: string;
+    };
+}
+export interface DocsProtocolProfile {
+    readonly schemaVersion: 1;
+    readonly protocol: {
+        readonly id: typeof DOCS_PROTOCOL_ID;
+        readonly version: typeof DOCS_PROTOCOL_VERSION;
+    };
+    readonly foundationProfile: {
+        readonly metadataSidecarPolicy: "foundation-profile-v2-strict-merge";
+        readonly path: string;
+        readonly schemaVersion: 2;
+    };
+    readonly agentWorkflow: {
+        readonly skillPath: string;
+    };
+    readonly semanticValidatorIds: readonly string[];
+}
+export interface FoundationDocsDescription {
+    readonly authority: {
+        readonly metadataSchema: {
+            readonly digest: string;
+            readonly path: string;
+            readonly size: number;
+        };
+        readonly metadataSidecar?: {
+            readonly digest: string;
+            readonly path: string;
+            readonly size: number;
+        };
+        readonly ownerCatalog: {
+            readonly digest: string;
+            readonly path: string;
+            readonly size: number;
+        };
+        readonly profile: {
+            readonly digest: string;
+            readonly path: string;
+            readonly size: number;
+        };
+        readonly templates: readonly {
+            readonly evidence: {
+                readonly digest: string;
+                readonly path: string;
+                readonly size: number;
+            };
+            readonly type: string;
+        }[];
+    };
+    readonly projectId: string;
+    readonly profileSchemaVersion: 2;
+    readonly semanticDigest: string;
+    readonly metadataSchemaPath: string;
+    readonly metadataSidecar: {
+        readonly kind: "none";
+    } | {
+        readonly kind: "path-metadata-map";
+        readonly path: string;
+    };
+    readonly ownerIds: readonly string[];
+    readonly types: readonly DocsTypeProfile[];
+    readonly authorityPaths: readonly string[];
+}
+export interface DocsAdoptionInspector {
+    inspect(input: {
+        readonly authorityPaths: readonly string[];
+        readonly consumerRoot: string;
+        readonly profilePath: string;
+        readonly skillPath: string;
+    }): Promise<readonly DocsDiagnostic[]>;
+}
+export interface DocsFindQuery {
+    readonly text?: string;
+    readonly id?: string;
+    readonly type?: string;
+    readonly status?: string;
+    readonly owner?: string;
+    readonly related?: string;
+    readonly blockedBy?: string;
+}
+export interface DocsFindDocument extends DocumentDescriptor {
+    readonly metadata: DocumentMetadataObject;
+    readonly related: readonly string[];
+    readonly blockedBy: readonly string[];
+}
+export interface DocsNewRequest {
+    readonly apply: boolean;
+    readonly consumerRoot: string;
+    readonly profilePath: string;
+    readonly intent: Omit<DocumentIntent, "schemaVersion" | "related" | "additionalMetadata">;
+    readonly related?: readonly string[];
+    readonly blockedBy?: readonly string[];
+    readonly codeAnchors?: readonly DocumentJsonValue[];
+    readonly additionalMetadata?: Readonly<Record<string, DocumentJsonValue>>;
+    readonly signal?: AbortSignal;
+}
+export interface DocsCodeAnchor {
+    readonly enforcement: "advisory" | "required";
+    readonly pattern: string;
+}
+export type DocsNewResult = Readonly<{
+    kind: "new";
+    reservation: "none";
+    writeState: "blocked";
+    transaction: Readonly<{
+        state: "idle";
+    } | {
+        state: "recoverable";
+        transactionKind: "document";
+        recovery: Readonly<{
+            commandId: "docs.recover";
+            args: Readonly<{
+                exactFoundationBuildIdentity: string;
+                exactFoundationVersion: string;
+            }>;
+        }>;
+    } | {
+        state: "manual-recovery-required";
+        transactionKind?: "corrupt" | "document" | "local-mode" | "scaffold" | "transition-residue" | "unknown" | "version-mismatch";
+        reason: string;
+        recovery?: {
+            readonly commandId: "detach" | "docs-recover" | "scaffold-recover";
+            readonly args: Readonly<Record<string, string>>;
+        };
+    }>;
+}> | Readonly<{
+    kind: "new";
+    reason: "adoption-invalid" | "authority-stale";
+    reservation: "none";
+    writeState: "blocked";
+}> | Readonly<{
+    documentPath: string;
+    kind: "new";
+    planDigest: `sha256:${string}`;
+    reachability: ReachabilityAction;
+    reservation: "none";
+    writeState: "preview";
+}> | Readonly<{
+    documentPath: string;
+    kind: "new";
+    planDigest: `sha256:${string}`;
+    reachability?: ReachabilityAction;
+    receipt: Readonly<{
+        commit: Readonly<{
+            publication: "none" | "preexisting-exact" | "published" | "unknown";
+            recoverability: "not-required" | "preserved-for-recovery";
+            state: "committed" | "manual-recovery-required" | "not-published" | "recovery-required";
+        }>;
+        directoryMaterialization?: {
+            readonly observedCreatedDirectories: readonly string[];
+            readonly plannedDirectories: readonly string[];
+            readonly state: "none-created" | "created-and-retained" | "preserved-unknown";
+        };
+        outcome: DocumentReceiptContract["outcome"];
+    }>;
+    receiptDigest: `sha256:${string}`;
+    receiptOutcome: DocumentReceiptContract["outcome"];
+    reservation: "none";
+    writeState: "already-applied" | "applied" | "published-recovery-required" | "unchanged" | "unknown";
+}>;
+export interface CodeAnchorMatcher {
+    matchedPatterns(input: {
+        readonly consumerRoot: string;
+        readonly patterns: readonly string[];
+        readonly signal?: AbortSignal;
+    }): Promise<readonly string[]>;
+}
+export interface ReachabilityAction {
+    readonly state: "manual-required" | "not-required";
+    readonly indexPath?: string;
+    readonly markdownLink?: string;
+    readonly reason?: string;
+}
+export interface FoundationDocsPort {
+    inspectEnvironment(input: {
+        readonly consumerRoot: string;
+        readonly signal?: AbortSignal;
+    }): Promise<{
+        readonly installedFoundationVersion: string;
+        readonly installedFoundationBuildIdentity: string;
+        readonly filesystem: {
+            readonly basis: "platform-contract";
+            readonly strictDirectoryDurability: "platform-supported" | "platform-unsupported";
+        };
+    }>;
+    describe(input: {
+        readonly consumerRoot: string;
+        readonly profilePath: string;
+        readonly signal?: AbortSignal;
+    }): Promise<FoundationDocsDescription>;
+    buildCatalog(input: {
+        readonly consumerRoot: string;
+        readonly profilePath: string;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentationCatalogSnapshotV2>;
+    find(input: {
+        readonly consumerRoot: string;
+        readonly profilePath: string;
+        readonly query: DocsFindQuery;
+        readonly signal?: AbortSignal;
+    }): Promise<readonly DocsFindDocument[]>;
+    inspect(consumerRoot: string): Promise<DocumentTransactionInspectionV2>;
+    plan(input: {
+        readonly consumerRoot: string;
+        readonly profilePath: string;
+        readonly intent: DocumentIntent;
+        readonly parentPolicy: "create-missing-real-directories";
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentPlanV2>;
+    apply(input: {
+        readonly consumerRoot: string;
+        readonly plan: DocumentPlanV2;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentReceiptContract>;
+    recover(input: {
+        readonly consumerRoot: string;
+        readonly signal?: AbortSignal;
+    }): Promise<DocumentReceiptContract>;
+}
+export interface DocsProfileReader {
+    read(input: {
+        readonly consumerRoot: string;
+        readonly profilePath: string;
+        readonly signal?: AbortSignal;
+    }): Promise<DocsProtocolProfile>;
+}
+//# sourceMappingURL=model.d.ts.map

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

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

package/dist/domain/model.js

@@ -0,0 +1,3 @@
+export const DOCS_PROTOCOL_ID = "agent-teams.docs-protocol";
+export const DOCS_PROTOCOL_VERSION = 1;
+//# sourceMappingURL=model.js.map

package/dist/domain/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/domain/model.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,gBAAgB,GAAG,2BAAoC,CAAC;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAU,CAAC"}

package/dist/domain/profile-policy.d.ts

@@ -0,0 +1,7 @@
+import { type DocsProtocolProfile, type DocsTypeProfile, type ReachabilityAction } from "./model.js";
+export declare class DocsProfileError extends Error {
+    constructor(message: string);
+}
+export declare function parseDocsProtocolProfile(value: unknown): DocsProtocolProfile;
+export declare function projectReachability(type: DocsTypeProfile, destination: string, heading: string): ReachabilityAction;
+//# sourceMappingURL=profile-policy.d.ts.map

package/dist/domain/profile-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-policy.d.ts","sourceRoot":"","sources":["../../src/domain/profile-policy.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AAKpB,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AA6CD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CA2B5E;AAMD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAuBnH"}

package/dist/domain/profile-policy.js

@@ -0,0 +1,109 @@
+import { posix } from "node:path";
+import { DOCS_PROTOCOL_ID, DOCS_PROTOCOL_VERSION } from "./model.js";
+const LOWER_ID = /^[a-z0-9][a-z0-9._/-]*$/u;
+const REPOSITORY_PATH = /^(?!.*(?:^|\/)\.{1,2}(?:\/|$))[A-Za-z0-9._@-]+(?:\/[A-Za-z0-9._@-]+)*$/u;
+export class DocsProfileError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "DocsProfileError";
+    }
+}
+function record(value, subject) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new DocsProfileError(`${subject} must be an object.`);
+    }
+    return value;
+}
+function exactKeys(value, keys, subject) {
+    const expected = keys.toSorted();
+    const actual = Object.keys(value).toSorted();
+    if (expected.length !== actual.length || expected.some((key, index) => key !== actual[index])) {
+        throw new DocsProfileError(`${subject} must contain exactly: ${expected.join(", ")}.`);
+    }
+}
+function lowerId(value, subject) {
+    if (typeof value !== "string" || value.length === 0 || value.length > 160 || !LOWER_ID.test(value)) {
+        throw new DocsProfileError(`${subject} is invalid.`);
+    }
+    return value;
+}
+function repositoryPath(value, subject) {
+    if (typeof value !== "string" || value.length === 0 || value.length > 512 || !REPOSITORY_PATH.test(value)) {
+        throw new DocsProfileError(`${subject} is invalid.`);
+    }
+    if (Buffer.byteLength(value, "utf8") > 512 || value.split("/").some((segment) => Buffer.byteLength(segment, "utf8") > 255)) {
+        throw new DocsProfileError(`${subject} exceeds portable path limits.`);
+    }
+    return value;
+}
+function validatorIds(value) {
+    if (!Array.isArray(value) || value.length > 256) {
+        throw new DocsProfileError("profile.semanticValidatorIds must be a bounded array.");
+    }
+    const entries = value.map((entry, index) => lowerId(entry, `profile.semanticValidatorIds[${index}]`));
+    if (new Set(entries).size !== entries.length) {
+        throw new DocsProfileError("profile.semanticValidatorIds must not contain duplicates.");
+    }
+    return Object.freeze(entries.toSorted((left, right) => Buffer.compare(Buffer.from(left), Buffer.from(right))));
+}
+export function parseDocsProtocolProfile(value) {
+    const candidate = record(value, "profile");
+    exactKeys(candidate, ["schemaVersion", "protocol", "foundationProfile", "agentWorkflow", "semanticValidatorIds"], "profile");
+    if (candidate["schemaVersion"] !== 1) {
+        throw new DocsProfileError("profile.schemaVersion must be 1.");
+    }
+    const protocol = record(candidate["protocol"], "profile.protocol");
+    exactKeys(protocol, ["id", "version"], "profile.protocol");
+    if (protocol["id"] !== DOCS_PROTOCOL_ID || protocol["version"] !== DOCS_PROTOCOL_VERSION) {
+        throw new DocsProfileError(`profile.protocol must be ${DOCS_PROTOCOL_ID}/v${DOCS_PROTOCOL_VERSION}.`);
+    }
+    const foundationProfile = record(candidate["foundationProfile"], "profile.foundationProfile");
+    exactKeys(foundationProfile, ["metadataSidecarPolicy", "path", "schemaVersion"], "profile.foundationProfile");
+    if (foundationProfile["schemaVersion"] !== 2 || foundationProfile["metadataSidecarPolicy"] !== "foundation-profile-v2-strict-merge") {
+        throw new DocsProfileError("profile.foundationProfile must route to Foundation profile v2 strict sidecar merge.");
+    }
+    const workflow = record(candidate["agentWorkflow"], "profile.agentWorkflow");
+    exactKeys(workflow, ["skillPath"], "profile.agentWorkflow");
+    return Object.freeze({
+        schemaVersion: 1,
+        protocol: Object.freeze({ id: DOCS_PROTOCOL_ID, version: DOCS_PROTOCOL_VERSION }),
+        foundationProfile: Object.freeze({
+            metadataSidecarPolicy: "foundation-profile-v2-strict-merge",
+            path: repositoryPath(foundationProfile["path"], "profile.foundationProfile.path"),
+            schemaVersion: 2
+        }),
+        agentWorkflow: Object.freeze({ skillPath: repositoryPath(workflow["skillPath"], "profile.agentWorkflow.skillPath") }),
+        semanticValidatorIds: validatorIds(candidate["semanticValidatorIds"])
+    });
+}
+function markdownLabel(value) {
+    return value.replace(/\\/gu, "\\\\").replace(/\[/gu, "\\[").replace(/\]/gu, "\\]");
+}
+export function projectReachability(type, destination, heading) {
+    const strategy = type.reachability;
+    if (strategy.kind === "not-required") {
+        return Object.freeze({ state: "not-required", reason: strategy.reason });
+    }
+    let indexPath;
+    if (strategy.kind === "manual-fixed-index") {
+        indexPath = strategy.indexPath;
+    }
+    else {
+        if (type.placement.kind !== "explicit") {
+            throw new DocsProfileError("Colocated reachability requires explicit Foundation placement authority.");
+        }
+        const destinationSegments = destination.split("/");
+        const requiredSegments = type.placement.requiredSegmentsInOrder;
+        const candidates = destinationSegments.flatMap((_segment, start) => requiredSegments.every((segment, offset) => destinationSegments[start + offset] === segment) ? [start] : []);
+        if (candidates.length !== 1 || candidates[0] === undefined || candidates[0] === 0) {
+            throw new DocsProfileError(`Cannot derive one colocated index for ${destination}.`);
+        }
+        indexPath = `${destinationSegments.slice(0, candidates[0]).join("/")}/${strategy.indexBasename}`;
+    }
+    const relative = posix.relative(posix.dirname(indexPath), destination);
+    if (relative.length === 0) {
+        throw new DocsProfileError("Reachability index cannot equal the document path.");
+    }
+    return Object.freeze({ state: "manual-required", indexPath, markdownLink: `[${markdownLabel(heading)}](${relative})` });
+}
+//# sourceMappingURL=profile-policy.js.map

package/dist/domain/profile-policy.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { renderDocsHuman, runDocsCli } from "./composition/cli.js";
+export { docsCheck, docsDoctor, docsFind, docsInfo, docsNew, docsRecover } from "./composition/node-docs-api.js";
+export type { DocsConsumerRequest } from "./composition/node-docs-api.js";
+export { DOCS_PROTOCOL_ID, DOCS_PROTOCOL_VERSION } from "./domain/model.js";
+export type { DocsCommand, DocsCommandEnvelope, DocsCommandOutcome, DocsCodeAnchor, DocsDiagnostic, DocsExecution, DocsFindDocument, DocsFindQuery, DocsNewResult, DocsNewRequest, DocsProtocolProfile, DocsTypeProfile, ReachabilityAction } from "./domain/model.js";
+//# 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":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EACL,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,WAAW,EACZ,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,kBAAkB,EACnB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { renderDocsHuman, runDocsCli } from "./composition/cli.js";
+export { docsCheck, docsDoctor, docsFind, docsInfo, docsNew, docsRecover } from "./composition/node-docs-api.js";
+export { DOCS_PROTOCOL_ID, DOCS_PROTOCOL_VERSION } from "./domain/model.js";
+//# sourceMappingURL=index.js.map