renma 0.18.2 → 0.18.3

package/dist/evidence/target.d.ts

@@ -0,0 +1,51 @@
+import { type SkillParentIndex, type SkillParentResolution } from "../catalog.js";
+import { type RepositoryClassificationPathResolution, type SkillEntrypointPath } from "../discovery.js";
+import type { AssetMetadata, CatalogEntry } from "../model.js";
+import { type RepositorySnapshot } from "../repository-evidence.js";
+import type { SecurityPolicyAssetEvidence } from "../security-policy-inventory.js";
+import type { AssetClassificationEvidence, AssetGovernanceEvidence, ParsedDocument } from "../types.js";
+export interface TargetDocumentEvidence {
+    absolutePath: string;
+    outputPath: string;
+    content: string;
+    document: ParsedDocument;
+    metadata: AssetMetadata;
+    repositoryBoundary: RepositoryClassificationPathResolution;
+    repositoryRoot?: string;
+    repositoryRelativePath: string;
+    entrypoint?: SkillEntrypointPath;
+    classification: AssetClassificationEvidence;
+}
+export type TargetRepositoryEvidence = {
+    state: "resolved";
+    snapshot: RepositorySnapshot;
+    skillParents: SkillParentIndex;
+    parent: SkillParentResolution;
+    entry?: CatalogEntry;
+    policy?: SecurityPolicyAssetEvidence;
+    classification: AssetClassificationEvidence;
+    governance: AssetGovernanceEvidence | null;
+} | {
+    state: "unavailable";
+    reason: "repository-boundary-unresolved" | "repository-boundary-ambiguous" | "snapshot-unavailable";
+    classification: AssetClassificationEvidence;
+};
+export interface CollectTargetDocumentOptions {
+    /** Preserve each command's established unresolved-path evidence shape. */
+    unresolvedArtifactPath: "absolute" | "input";
+}
+/**
+ * Read and structurally classify one command target.
+ *
+ * This stage does not claim parent inheritance or other repository-backed
+ * governance. Those facts require a snapshot and are attached separately.
+ */
+export declare function collectTargetDocumentEvidence(target: string, options: CollectTargetDocumentOptions): Promise<TargetDocumentEvidence>;
+/**
+ * Enrich structural target evidence from one repository snapshot.
+ *
+ * Snapshot failures intentionally remain unavailable. Falling back to path
+ * guesses here would manufacture catalog identity or inherited governance.
+ */
+export declare function collectTargetRepositoryEvidence(target: TargetDocumentEvidence): Promise<TargetRepositoryEvidence>;
+//# sourceMappingURL=target.d.ts.map

package/dist/evidence/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/evidence/target.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EAIL,KAAK,sCAAsC,EAC3C,KAAK,mBAAmB,EACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,KAAK,EAEV,2BAA2B,EAC3B,uBAAuB,EACvB,cAAc,EACf,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,aAAa,CAAC;IACxB,kBAAkB,EAAE,sCAAsC,CAAC;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,cAAc,EAAE,2BAA2B,CAAC;CAC7C;AAED,MAAM,MAAM,wBAAwB,GAChC;IACE,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,2BAA2B,CAAC;IACrC,cAAc,EAAE,2BAA2B,CAAC;IAC5C,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAAC;CAC5C,GACD;IACE,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EACF,gCAAgC,GAChC,+BAA+B,GAC/B,sBAAsB,CAAC;IAC3B,cAAc,EAAE,2BAA2B,CAAC;CAC7C,CAAC;AAEN,MAAM,WAAW,4BAA4B;IAC3C,0EAA0E;IAC1E,sBAAsB,EAAE,UAAU,GAAG,OAAO,CAAC;CAC9C;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CA+CjC;AAED;;;;;GAKG;AACH,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CAyDnC"}

package/dist/evidence/target.js

@@ -0,0 +1,161 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { resolveSkillSupportParent, withResolvedSkillParent, } from "../catalog.js";
+import { classifyAssetPath, classifyRepositorySkillEntrypointPath, repositoryClassificationPath, } from "../discovery.js";
+import { parseDocument } from "../markdown.js";
+import { parseAssetMetadata } from "../metadata.js";
+import { collectRepositorySnapshot, } from "../repository-evidence.js";
+/**
+ * Read and structurally classify one command target.
+ *
+ * This stage does not claim parent inheritance or other repository-backed
+ * governance. Those facts require a snapshot and are attached separately.
+ */
+export async function collectTargetDocumentEvidence(target, options) {
+    const absolutePath = path.resolve(target);
+    const content = await readFile(absolutePath, "utf8");
+    const outputPath = target.replaceAll("\\", "/");
+    const repositoryBoundary = repositoryClassificationPath(target);
+    const repositoryRelativePath = repositoryBoundary.state === "resolved"
+        ? repositoryBoundary.relativePath
+        : "";
+    // Keep repository-relative paths in public evidence and migration semantics.
+    // The absolute path is reserved for filesystem I/O and exact entry matching.
+    const repositoryRoot = repositoryBoundary.state === "resolved"
+        ? repositoryBoundary.root
+        : undefined;
+    const initialClassification = classifyAssetPath(repositoryRelativePath);
+    const unresolvedPath = options.unresolvedArtifactPath === "absolute" ? absolutePath : outputPath;
+    const document = parseDocument({
+        absolutePath,
+        content,
+        kind: initialClassification.kind,
+        path: repositoryRelativePath || unresolvedPath,
+        sizeBytes: Buffer.byteLength(content),
+        contentClassification: "text",
+        markdownParserEligible: /\.mdx?$/i.test(unresolvedPath),
+    });
+    const metadata = parseAssetMetadata(document).metadata;
+    const classification = classifyAssetPath(repositoryRelativePath, {
+        ...(metadata.type ? { metadataType: metadata.type } : {}),
+    });
+    const entrypoint = repositoryRelativePath
+        ? classifyRepositorySkillEntrypointPath(repositoryRelativePath)
+        : undefined;
+    return {
+        absolutePath,
+        outputPath,
+        content,
+        document,
+        metadata,
+        repositoryBoundary,
+        ...(repositoryRoot ? { repositoryRoot } : {}),
+        repositoryRelativePath,
+        ...(entrypoint ? { entrypoint } : {}),
+        classification,
+    };
+}
+/**
+ * Enrich structural target evidence from one repository snapshot.
+ *
+ * Snapshot failures intentionally remain unavailable. Falling back to path
+ * guesses here would manufacture catalog identity or inherited governance.
+ */
+export async function collectTargetRepositoryEvidence(target) {
+    if (!target.repositoryRoot) {
+        return {
+            state: "unavailable",
+            reason: target.repositoryBoundary.state === "unresolved"
+                ? target.repositoryBoundary.reasonCode
+                : "repository-boundary-unresolved",
+            classification: target.classification,
+        };
+    }
+    try {
+        const snapshot = await collectRepositorySnapshot(target.repositoryRoot);
+        const skillParents = snapshot.skillParents;
+        const parent = resolveSkillSupportParent(target.repositoryRelativePath, skillParents);
+        const classification = withResolvedSkillParent(target.classification, target.repositoryRelativePath, skillParents);
+        const entry = snapshot.catalog.entries.find((candidate) => path.resolve(snapshot.root, candidate.sourcePath) ===
+            target.absolutePath);
+        const policy = snapshot.securityPolicies.find((candidate) => candidate.path === target.repositoryRelativePath);
+        const governance = buildTargetGovernance(target, classification, parent, entry, policy);
+        return {
+            state: "resolved",
+            snapshot,
+            skillParents,
+            parent,
+            ...(entry ? { entry } : {}),
+            ...(policy ? { policy } : {}),
+            classification,
+            governance,
+        };
+    }
+    catch {
+        return {
+            state: "unavailable",
+            reason: "snapshot-unavailable",
+            classification: target.classification,
+        };
+    }
+}
+function buildTargetGovernance(target, classification, parent, entry, policy) {
+    if (entry) {
+        return {
+            ownership: entry.ownership,
+            policySource: policySource(policy),
+            ...(policy?.inheritedFrom
+                ? { policyInheritedFrom: policy.inheritedFrom.sourcePath }
+                : {}),
+            metadataState: targetMetadataState(target, classification),
+        };
+    }
+    if (classification.scope !== "skill-local")
+        return null;
+    const declaredOwner = target.metadata.owner?.trim();
+    const ownership = declaredOwner
+        ? {
+            declaredOwner,
+            effectiveOwner: declaredOwner,
+            source: "declared",
+        }
+        : parent.state === "resolved" && parent.parent.owner
+            ? {
+                declaredOwner: null,
+                effectiveOwner: parent.parent.owner,
+                source: "inherited",
+                inheritedFrom: {
+                    id: parent.parent.id,
+                    sourcePath: parent.parent.sourcePath,
+                },
+            }
+            : {
+                declaredOwner: null,
+                effectiveOwner: null,
+                source: "unowned",
+            };
+    return {
+        ownership,
+        policySource: "missing",
+        metadataState: targetMetadataState(target, classification),
+    };
+}
+function policySource(policy) {
+    if (!policy?.hasEffectivePolicy)
+        return "missing";
+    if (policy.hasLocalPolicyMetadata)
+        return "declared";
+    return "inherited";
+}
+function targetMetadataState(target, classification) {
+    const hasMetadata = Object.keys(target.document.metadata).length > 0;
+    if (classification.scope === "skill-local" && !hasMetadata) {
+        return "not-required";
+    }
+    if (!hasMetadata)
+        return "missing";
+    if (target.metadata.id && target.metadata.owner)
+        return "declared";
+    return "partial";
+}
+//# sourceMappingURL=target.js.map

package/dist/evidence/target.js.map

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

package/dist/renderers/inspect.d.ts

@@ -0,0 +1,3 @@
+import type { InspectOutline } from "../evidence/inspect.js";
+export declare function renderTextOutline(outline: InspectOutline): string;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/renderers/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/renderers/inspect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,cAAc,EAEf,MAAM,wBAAwB,CAAC;AAOhC,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAuCjE"}

package/dist/renderers/inspect.js

@@ -0,0 +1,159 @@
+// Rendering must preserve the collected evidence instead of reinterpreting it.
+export function renderTextOutline(outline) {
+    const lines = [
+        `Path: ${outline.path}`,
+        `Lines: ${outline.lineCount}`,
+        `Bytes: ${outline.bytes}`,
+        `Frontmatter: ${outline.frontmatterRange ?? "none"}`,
+        "",
+        "Repository boundary:",
+        ...renderRepositoryBoundary(outline.repositoryBoundary),
+        "",
+        "Classification:",
+        ...renderClassification(outline.classification),
+        "",
+        "Governance:",
+        ...renderGovernance(outline.governance),
+        ...(outline.asset
+            ? ["", "Asset:", ...renderAssetSummary(outline.asset)]
+            : []),
+        "",
+        "Context Lens:",
+        ...renderContextLensSummary(outline.contextLens),
+        "",
+        "Headings:",
+        ...outline.headings.flatMap((heading) => [
+            `- ${"#".repeat(heading.depth)} ${heading.text} ${heading.range}`,
+            ...heading.preview.map((line) => `  ${line}`),
+        ]),
+        "",
+        "Code fences:",
+        ...outline.codeFences.map((fence) => `- ${fence.range} ${fence.language || "(no language)"}`),
+        "",
+        "Links:",
+        ...outline.links.map((link) => `- L${link.line}: ${link.target}`),
+        "",
+    ];
+    return `${lines.join("\n")}\n`;
+}
+function renderRepositoryBoundary(boundary) {
+    if (boundary.state === "resolved") {
+        return [
+            `- State: ${boundary.state}`,
+            `- Source: ${boundary.source}`,
+            `- Root: ${boundary.root}`,
+            `- Relative path: ${boundary.relativePath}`,
+        ];
+    }
+    return [
+        `- State: ${boundary.state}`,
+        `- Reason code: ${boundary.reasonCode}`,
+        `- Reason: ${boundary.reason}`,
+        `- Candidate roots: ${boundary.candidateRoots.join(", ") || "(none)"}`,
+    ];
+}
+function renderClassification(classification) {
+    return [
+        `- Kind: ${classification.kind}`,
+        `- Scope: ${classification.scope}`,
+        `- Matched rule: ${classification.matchedRule}`,
+        `- Reason code: ${classification.reasonCode}`,
+        ...(classification.recognizedRoot
+            ? [`- Recognized root: ${classification.recognizedRoot}`]
+            : []),
+        ...(classification.parentAssetPath
+            ? [`- Parent asset: ${classification.parentAssetPath}`]
+            : []),
+        ...(classification.parentAssetCandidatePath
+            ? [
+                `- Parent candidate: ${classification.parentAssetCandidatePath}`,
+                `- Parent resolution: ${classification.parentResolution ?? "structural-candidate"}`,
+            ]
+            : []),
+        ...(classification.parentAssetCandidates?.length
+            ? [
+                `- Parent candidates: ${classification.parentAssetCandidates.join(", ")}`,
+            ]
+            : []),
+        ...(classification.supportDirectory
+            ? [`- Support directory: ${classification.supportDirectory}`]
+            : []),
+        ...(classification.ignoredNestedSegments?.length
+            ? [
+                `- Ignored nested segments: ${classification.ignoredNestedSegments.join(", ")}`,
+            ]
+            : []),
+        `- Reason: ${classification.reason}`,
+        ...(classification.competingRules?.flatMap((competing) => [
+            `- Competing rule: ${competing.rule} (${competing.reasonCode})`,
+            `  ${competing.reason}`,
+        ]) ?? []),
+    ];
+}
+function renderGovernance(governance) {
+    if (!governance)
+        return ["- Unresolved: target is not a catalog entry."];
+    const inheritedOwner = governance.ownership.inheritedFrom?.sourcePath;
+    return [
+        `- Declared owner: ${governance.ownership.declaredOwner ?? "(none)"}`,
+        `- Effective owner: ${governance.ownership.effectiveOwner ?? "(unowned)"}`,
+        `- Ownership source: ${governance.ownership.source}`,
+        ...(inheritedOwner
+            ? [`- Ownership inherited from: ${inheritedOwner}`]
+            : []),
+        `- Policy source: ${governance.policySource ?? "missing"}`,
+        ...(governance.policyInheritedFrom
+            ? [`- Policy inherited from: ${governance.policyInheritedFrom}`]
+            : []),
+        `- Metadata state: ${governance.metadataState ?? "missing"}`,
+    ];
+}
+function renderContextLensSummary(contextLens) {
+    return [
+        `- Enabled: ${contextLens.enabled ? "yes" : "no"}`,
+        `- Detected: ${contextLens.detected ? "yes" : "no"}`,
+        `- Lenses: ${contextLens.validLensCount}/${contextLens.totalLensCount} valid (${contextLens.invalidLensCount} invalid)`,
+        `- Diagnostics: error ${contextLens.diagnosticCounts.error}, warning ${contextLens.diagnosticCounts.warning}, info ${contextLens.diagnosticCounts.info}`,
+        `- Representative diagnostic: ${contextLens.representativeDiagnosticCode ?? "(none)"}`,
+        `- Definition paths: ${list(contextLens.definitionPaths)}`,
+        `- Target references: ${list(contextLens.targetReferences)}`,
+    ];
+}
+function renderAssetSummary(asset) {
+    return [
+        `- ID: ${asset.id}`,
+        `- Kind: ${asset.kind}`,
+        ...(asset.owner ? [`- Owner: ${asset.owner}`] : []),
+        ...(asset.status ? [`- Status: ${asset.status}`] : []),
+        `- Tags: ${list(asset.tags)}`,
+        ...(asset.kind === "context_lens"
+            ? [
+                ...(asset.purpose ? [`- Purpose: ${asset.purpose}`] : []),
+                `- Applies to: ${list(asset.appliesTo)}`,
+                `- Focus: ${list(asset.focus)}`,
+                `- Expected outputs: ${list(asset.expectedOutputs)}`,
+            ]
+            : []),
+        "",
+        "Relationships:",
+        "- Inbound dependents:",
+        ...relationshipLines(asset.inboundDependents),
+        "- Outbound dependencies:",
+        ...relationshipLines(asset.outboundDependencies),
+        ...(asset.relationshipChains.length > 0
+            ? [
+                "- Relationship chains:",
+                ...asset.relationshipChains.map((chain) => `  - ${chain.skill} -> ${chain.lens} -> ${chain.context}`),
+            ]
+            : []),
+    ];
+}
+function relationshipLines(relationships) {
+    if (relationships.length === 0)
+        return ["  - (none)"];
+    return relationships.map((relationship) => `  - ${relationship.from} ${relationship.kind} -> ${relationship.to}`);
+}
+function list(values) {
+    return values.length > 0 ? values.join(", ") : "(none)";
+}
+//# sourceMappingURL=inspect.js.map

package/dist/renderers/inspect.js.map

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

package/dist/renderers/metadata-suggestion.d.ts

@@ -0,0 +1,3 @@
+import type { MetadataSuggestion } from "../decisions/metadata-suggestion.js";
+export declare function renderMetadataPrompt(suggestion: MetadataSuggestion): string;
+//# sourceMappingURL=metadata-suggestion.d.ts.map

package/dist/renderers/metadata-suggestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-suggestion.d.ts","sourceRoot":"","sources":["../../src/renderers/metadata-suggestion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAI9E,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,kBAAkB,GAAG,MAAM,CAsG3E"}