renma 0.18.0 → 0.18.2

package/dist/types.d.ts

@@ -8,6 +8,78 @@ export type Severity = "low" | "medium" | "high" | "critical";
 export type RiskClass = "violation" | "suspicious" | "advisory";
 /** Classified artifact kind discovered from repository paths. */
 export type ArtifactKind = "skill" | "agent" | "context" | "context_lens" | "profile" | "reference" | "example" | "script" | "asset" | "config" | "unknown";
+/** Repository governance boundary determined from a normalized asset path. */
+export type AssetScope = "independent" | "skill-local" | "repository-support" | "unknown";
+/** Stable registry of deterministic asset-classification rules. */
+export declare const ASSET_CLASSIFICATION_RULES: readonly ["skill-entrypoint", "skill-local-support", "context-root", "context-root-legacy", "lens-root", "agent-root", "repository-tool", "config-file", "generic-profile", "generic-reference", "generic-example", "unknown"];
+export type AssetClassificationRule = (typeof ASSET_CLASSIFICATION_RULES)[number];
+/** Stable registry of positive and competing asset-classification reasons. */
+export declare const ASSET_CLASSIFICATION_REASON_CODES: readonly ["under-canonical-skill-root", "under-skill-support-directory", "outside-recognized-asset-boundary", "unsupported-skill-local-directory", "under-recognized-context-root", "under-legacy-context-root", "under-recognized-lens-root", "under-recognized-agent-root", "repository-tool-not-context", "recognized-config-file", "under-generic-support-directory", "outside-recognized-skill-boundary", "outside-recognized-context-root"];
+export type AssetClassificationReasonCode = (typeof ASSET_CLASSIFICATION_REASON_CODES)[number];
+/** Resolution state for the structurally implied parent of Skill-local support. */
+export type ParentAssetResolution = "structural-candidate" | "resolved" | "missing" | "ambiguous";
+/** Stable negative evidence for a nearby classification rule. */
+export interface AssetCompetingRuleEvidence {
+    rule: AssetClassificationRule;
+    matched: false;
+    reasonCode: AssetClassificationReasonCode;
+    reason: string;
+}
+/** Deterministic, machine-readable evidence explaining one path classification. */
+export interface AssetClassificationEvidence {
+    kind: ArtifactKind;
+    scope: AssetScope;
+    matchedRule: AssetClassificationRule;
+    reasonCode: AssetClassificationReasonCode;
+    reason: string;
+    recognizedRoot?: string;
+    /** Structural path candidate; it does not prove that a parent asset exists. */
+    parentAssetCandidatePath?: string;
+    /** Resolved parent source path; present only for one unambiguous parent. */
+    parentAssetPath?: string;
+    parentResolution?: ParentAssetResolution;
+    parentAssetCandidates?: string[];
+    supportDirectory?: string;
+    ignoredNestedSegments?: string[];
+    competingRules?: AssetCompetingRuleEvidence[];
+}
+/** Explicit outcome for commands that may recommend an authoring change. */
+export type DecisionStatus = "deterministic" | "human-confirmation-required" | "blocked" | "no-change-recommended";
+/** Stable registry of suggestion decision reasons. */
+export declare const ASSET_DECISION_REASON_CODES: readonly ["conflicting-ownership-evidence", "explicit-human-provided-override", "skill-local-governance-inherited", "skill-local-existing-metadata-preserved", "skill-local-unowned", "skill-local-parent-unresolved", "repository-boundary-unresolved", "repository-boundary-ambiguous", "repository-tool-not-context", "outside-recognized-asset-boundary", "independent-governance-intent-unconfirmed", "deterministic-metadata-candidate", "metadata-already-sufficient", "conflicting-or-incomplete-skill-evidence", "canonical-agent-skill-no-change", "agent-skills-migration-review-required"];
+export type AssetDecisionReasonCode = (typeof ASSET_DECISION_REASON_CODES)[number];
+export interface AssetDecisionEvidence {
+    reasonCode: AssetDecisionReasonCode;
+    summary: string;
+    question?: string;
+}
+/** Declared and effective ownership with explicit provenance. */
+export interface AssetOwnership {
+    declaredOwner: string | null;
+    effectiveOwner: string | null;
+    source: "declared" | "inherited" | "unowned";
+    inheritedFrom?: {
+        id: string;
+        sourcePath: string;
+    };
+}
+/** Governance provenance kept separate from path classification evidence. */
+export interface AssetGovernanceEvidence {
+    ownership: AssetOwnership;
+    policySource?: "declared" | "inherited" | "missing";
+    policyInheritedFrom?: string;
+    metadataState?: "declared" | "partial" | "missing" | "not-required";
+}
+/** Executable command data plus a shell-oriented human display string. */
+export interface CommandInvocation<Args extends string[] = string[]> {
+    command: "renma";
+    args: Args;
+    display: string;
+}
+export interface SuggestedNextAction {
+    kind: "inspect-parent" | "inspect-target" | "review-layout" | "verify";
+    invocation: CommandInvocation;
+}
 /** Source location and snippet used to justify a finding. */
 export interface Evidence {
     path: string;

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,2 +1,51 @@
-export {};
+/** Stable registry of deterministic asset-classification rules. */
+export const ASSET_CLASSIFICATION_RULES = [
+    "skill-entrypoint",
+    "skill-local-support",
+    "context-root",
+    "context-root-legacy",
+    "lens-root",
+    "agent-root",
+    "repository-tool",
+    "config-file",
+    "generic-profile",
+    "generic-reference",
+    "generic-example",
+    "unknown",
+];
+/** Stable registry of positive and competing asset-classification reasons. */
+export const ASSET_CLASSIFICATION_REASON_CODES = [
+    "under-canonical-skill-root",
+    "under-skill-support-directory",
+    "outside-recognized-asset-boundary",
+    "unsupported-skill-local-directory",
+    "under-recognized-context-root",
+    "under-legacy-context-root",
+    "under-recognized-lens-root",
+    "under-recognized-agent-root",
+    "repository-tool-not-context",
+    "recognized-config-file",
+    "under-generic-support-directory",
+    "outside-recognized-skill-boundary",
+    "outside-recognized-context-root",
+];
+/** Stable registry of suggestion decision reasons. */
+export const ASSET_DECISION_REASON_CODES = [
+    "conflicting-ownership-evidence",
+    "explicit-human-provided-override",
+    "skill-local-governance-inherited",
+    "skill-local-existing-metadata-preserved",
+    "skill-local-unowned",
+    "skill-local-parent-unresolved",
+    "repository-boundary-unresolved",
+    "repository-boundary-ambiguous",
+    "repository-tool-not-context",
+    "outside-recognized-asset-boundary",
+    "independent-governance-intent-unconfirmed",
+    "deterministic-metadata-candidate",
+    "metadata-already-sufficient",
+    "conflicting-or-incomplete-skill-evidence",
+    "canonical-agent-skill-no-change",
+    "agent-skills-migration-review-required",
+];
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgCA,mEAAmE;AACnE,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,kBAAkB;IAClB,qBAAqB;IACrB,cAAc;IACd,qBAAqB;IACrB,WAAW;IACX,YAAY;IACZ,iBAAiB;IACjB,aAAa;IACb,iBAAiB;IACjB,mBAAmB;IACnB,iBAAiB;IACjB,SAAS;CACD,CAAC;AAIX,8EAA8E;AAC9E,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,4BAA4B;IAC5B,+BAA+B;IAC/B,mCAAmC;IACnC,mCAAmC;IACnC,+BAA+B;IAC/B,2BAA2B;IAC3B,4BAA4B;IAC5B,6BAA6B;IAC7B,6BAA6B;IAC7B,wBAAwB;IACxB,iCAAiC;IACjC,mCAAmC;IACnC,iCAAiC;CACzB,CAAC;AA6CX,sDAAsD;AACtD,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,gCAAgC;IAChC,kCAAkC;IAClC,kCAAkC;IAClC,yCAAyC;IACzC,qBAAqB;IACrB,+BAA+B;IAC/B,gCAAgC;IAChC,+BAA+B;IAC/B,6BAA6B;IAC7B,mCAAmC;IACnC,2CAA2C;IAC3C,kCAAkC;IAClC,6BAA6B;IAC7B,0CAA0C;IAC1C,iCAAiC;IACjC,wCAAwC;CAChC,CAAC"}

package/docs/README.md

@@ -32,7 +32,8 @@ Use this index to choose the smallest document that answers your question.
 
 - [Advanced Skill Authoring](advanced-skill-authoring.md): deriving focused,
   bounded Skills from existing workflows while using progressive disclosure.
-- [Context Lens](context-lens.md)
+- [Context Lens](context-lens.md): canonical semantics, placement decisions,
+  persona guidance, fields, examples, and runtime boundaries.
 - [Context Lifecycle Diagnostics](context-lifecycle-diagnostics.md)
 - [Context Conflict Diagnostics](context-conflict-diagnostics.md)
 - [Context Language Diagnostics](context-language-diagnostics.md)

package/docs/agent-skills-compatibility.md

@@ -216,7 +216,10 @@ requires a rename. A flat `*.skill.md` requires a move into the filename-derived
 directory plus a rename. Structured `suggest-metadata` output reports
 `sourcePath`, `targetPath`, and `entrypointMigration` (`none`, `rename`, or
 `move-and-rename`) so the path change cannot be mistaken for an apply-ready
-frontmatter-only result.
+frontmatter-only result. Both paths are normalized repository-relative paths.
+Renma uses that same identity for entrypoint classification and rebases the
+target against the resolved repository root only when checking the filesystem
+for collisions.
 
 Repository discovery recognizes these roots only at the beginning of a
 repository-relative path. A nested path such as `docs/skills/demo/SKILL.md` is
@@ -224,6 +227,10 @@ not a repository Skill, and a later `skills` segment cannot escape a reserved
 `references` or `examples` directory. For absolute `suggest-metadata` targets,
 Renma requires one unambiguous Skill root and rejects paths with multiple
 possible roots.
+When structural evidence leaves multiple repository roots plausible, Renma
+returns `repository-boundary-ambiguous` and does not recommend scanning the
+caller's current directory. Add a repository marker or supply an explicit root
+before retrying.
 
 Repository-relative classification normalizes leading and internal `.` segments
 and safe `..` segments before checking the root. A path is rejected if `..`

package/docs/authoring-guide.md

@@ -1,7 +1,7 @@
 # Renma Authoring Guide
 
-This is the canonical guide for authoring and improving Skills and Context
-Assets in a Renma repository.
+This is the canonical guide for placing, authoring, and improving Skills,
+Context Assets, Context Lenses, and Skill-local support in a Renma repository.
 
 ## Responsibility Boundary
 
@@ -48,17 +48,21 @@ Use Agent Skills progressive disclosure deliberately:
 3. Resources: local files are read or executed only when the workflow calls
    for them.
 
-Choose placement by responsibility, not size alone:
-
-| Content | Place it in | Ownership test |
-| --- | --- | --- |
-| Selection boundaries, ordered workflow, constraints, completion | `SKILL.md` | Required to perform this focused workflow |
-| Skill-specific detail, variants, edge cases | `references/` | Owned and loaded by one Skill |
-| Deterministic repeatedly executed implementation | `scripts/` | Code is safer and more repeatable than prose |
-| Templates, images, data, output resources | `assets/` | Consumed or copied as material, not instructions |
-| Shared knowledge | `contexts/` | Used by multiple Skills or needs independent ownership, lifecycle, or source-of-truth status |
-| Purpose-specific interpretation of Context | `lenses/` | A static governance view over Context Assets |
-| Provider-specific UI metadata | provider-owned files such as `agents/openai.yaml` | Optional interface metadata, not Renma core schema |
+Choose placement by responsibility, ownership, and reuse—not size alone:
+
+| Content or responsibility | Correct placement | Ownership or reuse test | Common misuse |
+| --- | --- | --- | --- |
+| Review supplied test code and produce prioritized findings; define selection boundaries, inputs, ordered steps, decisions, constraints, verification, output, and completion | Skill in `SKILL.md` | Required to perform one focused workflow | Reducing the Skill to a thin redirect or moving its task contract into Context |
+| Shared rules for reliable automated tests or other durable, source-backed knowledge | Context Asset under `contexts/` | May outlive or serve multiple Skills, or needs independent ownership, lifecycle, or source-of-truth status | Storing one workflow's instructions or transient task state as shared knowledge |
+| Emphasize determinism, isolation, and false-confidence risk while interpreting declared test-quality Context | Context Lens under `lenses/` | The same Context benefits from reusable purpose-specific interpretation | Creating a Lens with no Context target, copying Context, or storing only a persona or runtime route |
+| A stricter review variant for one Skill | Skill-local Profile under `profiles/`, if current Profile semantics fit | An overlay or variant owned and loaded by one Skill | Treating Profiles as generic global personas or a substitute for shared Context |
+| Detailed framework-specific review notes used only by one Skill | Skill-local Reference under `references/` | Supporting detail owned and loaded by one Skill | Promoting local detail without evidence of independent reuse or ownership |
+| A representative good or bad test implementation | Skill-local Example under `examples/` | A fixture or demonstration owned by one Skill | Hiding required workflow instructions only in an example |
+| Deterministic, repeatedly executed implementation | Script under Skill-local `scripts/`, or shared helper under `tools/` | Code is safer and more repeatable than prose; use `tools/` when implementation is shared | Embedding a large executable implementation in prose or treating a script as knowledge |
+| Templates, images, data, fonts, PDFs, or output resources | Asset under Skill-local `assets/` | Consumed, copied, or transformed as material rather than read as instructions | Putting workflow or reusable knowledge in an opaque asset |
+| Provider-specific UI or presentation metadata | Provider-owned metadata such as `agents/openai.yaml` | Optional interface behavior owned by the consuming provider | Adding provider fields to Renma core metadata |
+| Dynamically select a Lens, load or inject Context, assemble prompts, execute tools, or apply the workflow | External agent or runtime | Depends on the live request or execution environment | Encoding runtime behavior in a Lens or claiming Renma performs it |
+| “Act as a senior QA engineer” with no concrete criteria | Usually keep as brief local framing; create no asset solely for it | Persona or tone alone has no reusable interpretation contract | Treating generic role wording as a Context Lens |
 
 The canonical defaults and their Agent Skills/Renma provenance are in the
 [Quality Profile](quality-profile.md).
@@ -254,6 +258,24 @@ Do not route an already canonical Skill through `suggest-metadata` as ceremony.
 Use it only for a metadata retrofit, explicit owner retrofit, recognized
 pre-0.16 one-way migration, or blocked migration review.
 
+### Evidence-first LLM preflight
+
+When an LLM is asked to improve one existing Skill:
+
+1. Run `renma scan . --fail-on high --format json`.
+2. Run `renma inspect <SKILL.md> --format json`.
+3. Inspect relevant local resources and referenced Context Assets.
+4. Use `renma suggest-metadata` only when metadata retrofit or migration
+   evidence exists.
+5. Prepare the smallest intended patch.
+6. Run `renma scan . --fail-on high --format json` again.
+7. Stop without manufacturing work when Renma returns `no-proposal`.
+8. Report unresolved human decisions.
+
+For a classification-only question, `renma inspect <target> --format json` may
+be the first command. `scan` remains the normal repository-level starting
+point.
+
 ### 4. Review before applying
 
 Treat the output as a candidate. Compare it with the source and apply only the
@@ -333,9 +355,74 @@ Skill -> Context Asset
 These metadata relationships are static governance evidence. Renma does not
 select, load, or inject Context at runtime.
 
+Use this placement sequence before creating an asset:
+
+1. Is this the task, workflow, or completion contract? Put it in the Skill.
+2. Is this durable, reusable, source-backed knowledge? Create or reuse a Context
+   Asset.
+3. Does declared Context need a reusable purpose-specific interpretation?
+   Create a Context Lens. Do not create a Lens when there is no Context Asset to
+   interpret.
+4. Is this a Skill-local overlay or execution variant? Use a Profile only when
+   the current Profile semantics fit.
+5. Is this supporting detail used by only one Skill? Use a Reference.
+6. Is this a local fixture or demonstration? Use an Example.
+7. Is this only generic persona or tone framing? Usually keep it local and do
+   not create an asset solely for the persona.
+
+A Skill can reference a Context Asset directly when no separate interpretation
+layer adds value. A Lens is justified only when it adds meaningful, reusable
+structure to how declared Context is read for a purpose. See the
+[Context Lens guide](context-lens.md) for field semantics, persona guidance,
+examples, and a zero-context classification self-check.
+
 Context and Context Lens scaffolds keep their top-level Renma metadata syntax;
 the Agent Skills `metadata.renma.*` serialization boundary applies to Skills.
 
+## Context Asset Discovery Boundary
+
+The classification precedence is: explicit Skill entrypoint, explicit local
+support inside a recognized Skill, recognized top-level asset root,
+repository-level support or configuration, compatible generic nested rules,
+then unknown. This makes the repository root authoritative:
+
+```text
+contexts/foo/references/policy.md
+  -> independent Context Asset
+
+skills/foo/references/policy.md
+  -> Skill-local Reference
+
+references/policy.md
+  -> outside the Context root
+
+tools/helper.mjs
+  -> repository implementation
+
+skills/foo/tools/helper.mjs
+  -> not canonical Skill-local support
+```
+
+Use `contexts/**` for preferred independent Context and `context/**` only for
+compatibility. Nested `references/`, `examples/`, `profiles/`, `scripts/`, or
+`assets/` does not override either Context root. The same names are Skill-local
+only inside `skills/**` or `.agents/skills/**`, where they establish a structural
+parent candidate. Local metadata overrides remain supported where valid, but
+are not required. `tools/**` is shared repository implementation, and a Skill
+uses `scripts/`, not `tools/`, for canonical local executable support.
+
+The Skill-local path rule establishes only a structural parent candidate. The
+catalog must resolve exactly one parent entrypoint before Renma reports
+inherited governance. A missing or ambiguous parent remains structurally
+Skill-local but unowned or unresolved; `suggest-metadata` blocks instead of
+adding independent metadata automatically. Existing explicit local owner or
+policy metadata is preserved and is not described as inherited.
+
+Humans decide whether knowledge needs independent ownership, lifecycle, reuse,
+and source-of-truth status. Renma classifies the resulting placement but never
+promotes or moves content automatically. A `no-proposal` result is successful:
+preserve the file and stop unless a separate intentional change is supported.
+
 For current guidance on deriving several focused, bounded workflows from a broad
 existing Skill—including focused `inspect`, graph, Context reuse, and Appium
 examples—see [Advanced Skill Authoring](advanced-skill-authoring.md). That guide