@shrkcrft/inspector 0.1.0-alpha.7 → 0.1.0-alpha.8

package/dist/synthesize-from-onboarding.js

@@ -0,0 +1,508 @@
+/**
+ * Convert an {@link IOnboardingPlan} into populated `sharkcraft/*.ts`
+ * file contents — the engine behind `shrk init --infer --write`.
+ *
+ * Design goals:
+ *
+ *   - **Populated, not advisory.** The existing `writeOnboardingDrafts`
+ *     emits files into `sharkcraft/onboarding/` and asks the user to
+ *     adopt by hand. This module emits directly to `sharkcraft/`-root
+ *     files so a `shrk init --infer --write` user gets a working
+ *     project on day 1.
+ *
+ *   - **Honest about confidence.** Inferred entries are tagged with
+ *     their source signal and confidence; medium-confidence rows get a
+ *     `// TODO: review` marker on the emitted line. The user can see
+ *     exactly what was inferred vs hand-curated. Low-confidence rows
+ *     are dropped from the populated file and reported in the
+ *     companion `.inferred-report.md` so the user can find them.
+ *
+ *   - **Self-contained output.** Generated files declare their own
+ *     `defineKnowledgeEntry` / `definePathConvention` stubs — no
+ *     `@shrkcrft/*` imports, matching the local-mirror pattern from
+ *     `packages/presets/src/emit/synthesize-files.ts`.
+ *
+ *   - **Deterministic.** Same input → same output, byte-for-byte.
+ *     Sort lists by id where they're rendered together.
+ *
+ *   - **Idempotent at the file level.** The caller decides write vs
+ *     dry-run + force; this module only produces strings.
+ */
+// ─── Local-mirror preambles (match presets' synthesize-files.ts) ─────────────
+const KNOWLEDGE_HELPERS = `// Local helpers — keep this file self-contained (no @shrkcrft/* imports).
+// Generated by \`shrk init --infer\`. Edit freely.
+
+const KnowledgePriority = {
+  Critical: 'critical',
+  High: 'high',
+  Medium: 'medium',
+  Low: 'low',
+} as const;
+
+const KnowledgeType = {
+  Rule: 'rule',
+  Path: 'path',
+  Template: 'template',
+  Architecture: 'architecture',
+  Technical: 'technical',
+  Convention: 'convention',
+  Workflow: 'workflow',
+  Warning: 'warning',
+} as const;
+
+function defineKnowledgeEntry<T>(entry: T): T {
+  return entry;
+}
+`;
+const PIPELINE_HELPERS = `// Local helpers — keep this file self-contained (no @shrkcrft/* imports).
+// Generated by \`shrk init --infer\`. Edit freely.
+
+function definePipeline<T>(pipeline: T): T {
+  return pipeline;
+}
+`;
+// ─── Confidence triage ───────────────────────────────────────────────────────
+const HIGH_CONFIDENCE_RULE_IDS = new Set([
+    'typescript.strict-mode',
+    'project.package-manager',
+]);
+/** Map an inferred-rule priority to a {high|medium|low} adoption tier. */
+function ruleTier(rule) {
+    // Promote known-canonical rules.
+    if (HIGH_CONFIDENCE_RULE_IDS.has(rule.id))
+        return 'high';
+    const p = rule.priority.toLowerCase();
+    if (p === 'critical' || p === 'high')
+        return 'high';
+    if (p === 'medium')
+        return 'medium';
+    return 'low';
+}
+function pathTier(path) {
+    // Path conventions are inferred from disk presence — if we found the
+    // directory, the convention is real. The only "low" case is when the
+    // patterns list is empty (couldn't pin a concrete location).
+    if (path.patterns.length === 0)
+        return 'low';
+    return 'high';
+}
+function boundaryTier(rule) {
+    // Boundary rules require BOTH a from-pattern AND a forbidden list to
+    // be enforceable. Without forbidden imports, the rule is a label,
+    // not a gate.
+    if (rule.from.length === 0)
+        return 'low';
+    if (!rule.forbiddenImports || rule.forbiddenImports.length === 0)
+        return 'medium';
+    return 'high';
+}
+function pipelineTier(pipeline) {
+    // Pipelines with concrete steps that map to verification commands
+    // are higher-confidence than generic feature-dev outlines.
+    if (pipeline.steps.length === 0)
+        return 'low';
+    if (pipeline.steps.length <= 2)
+        return 'medium';
+    return 'high';
+}
+// ─── Renderers ──────────────────────────────────────────────────────────────
+function renderPath(p, tier) {
+    const todo = tier === 'medium' ? '// TODO: review — confidence: medium\n  ' : '';
+    const primaryPath = p.patterns[0]?.replace(/\/\*\*.*$/, '').replace(/\/\*$/, '') ?? '';
+    return `  ${todo}defineKnowledgeEntry({
+    id: ${JSON.stringify(p.id)},
+    title: ${JSON.stringify(p.title)},
+    type: KnowledgeType.Path,
+    priority: KnowledgePriority.High,
+    tags: ['paths', 'inferred'],
+    scope: ['inferred'],
+    appliesWhen: ['generate-code'],
+    content: ${JSON.stringify(p.content)},
+    metadata: {
+      path: ${JSON.stringify(primaryPath)},
+      patterns: ${JSON.stringify(p.patterns)},
+      inferredFrom: ${JSON.stringify(p.reason)},
+    },
+  })`;
+}
+function renderRule(r, tier) {
+    const todo = tier === 'medium' ? '// TODO: review — confidence: medium\n  ' : '';
+    const priority = r.priority === 'critical' ? 'KnowledgePriority.Critical'
+        : r.priority === 'high' ? 'KnowledgePriority.High'
+            : r.priority === 'medium' ? 'KnowledgePriority.Medium'
+                : 'KnowledgePriority.Low';
+    return `  ${todo}defineKnowledgeEntry({
+    id: ${JSON.stringify(r.id)},
+    title: ${JSON.stringify(r.title)},
+    type: KnowledgeType.Rule,
+    priority: ${priority},
+    tags: ['inferred', ${JSON.stringify(r.source)}],
+    scope: ['inferred'],
+    appliesWhen: ['generate-code', 'review'],
+    content: ${JSON.stringify(r.content)},
+    metadata: {
+      inferredFrom: ${JSON.stringify(r.reason)},
+      source: ${JSON.stringify(r.source)},
+    },
+  })`;
+}
+function renderBoundary(b, tier) {
+    const todo = tier === 'medium' ? '// TODO: review — confidence: medium\n  ' : '';
+    const forbidden = b.forbiddenImports && b.forbiddenImports.length > 0
+        ? `\n    forbiddenImports: ${JSON.stringify(b.forbiddenImports)},`
+        : '';
+    const allowed = b.allowedImports && b.allowedImports.length > 0
+        ? `\n    allowedImports: ${JSON.stringify(b.allowedImports)},`
+        : '';
+    return `  ${todo}{
+    id: ${JSON.stringify(b.id)},
+    title: ${JSON.stringify(b.title)},
+    severity: ${JSON.stringify(b.severity)},
+    from: ${JSON.stringify(b.from)},${forbidden}${allowed}
+    suggestedFix: ${JSON.stringify(b.suggestedFix)},
+    inferredFrom: ${JSON.stringify(b.reason)},
+  }`;
+}
+function renderPipeline(p, tier) {
+    const todo = tier === 'medium' ? '// TODO: review — confidence: medium\n  ' : '';
+    const stepLines = p.steps
+        .map((s) => `      { id: ${JSON.stringify(s)}, type: 'command', description: ${JSON.stringify(s)} }`)
+        .join(',\n');
+    return `  ${todo}definePipeline({
+    id: ${JSON.stringify(p.id)},
+    title: ${JSON.stringify(p.title)},
+    description: ${JSON.stringify(p.description)},
+    tags: ['inferred'],
+    steps: [
+${stepLines}
+    ],
+    metadata: {
+      inferredFrom: ${JSON.stringify(p.reason)},
+    },
+  })`;
+}
+// ─── File builders ──────────────────────────────────────────────────────────
+function buildConfigFile(opts) {
+    return (`// Generated by \`shrk init --infer\`. Edit freely; SharkCraft will not\n` +
+        `// regenerate this file. Re-run \`shrk init --infer --force\` to overwrite.\n\n` +
+        `const config = {\n` +
+        `  projectName: ${JSON.stringify(opts.projectName)},\n` +
+        `  description: ${JSON.stringify(opts.description)},\n` +
+        `  pathFiles: ${JSON.stringify(opts.includePaths ? ['paths.ts'] : [])},\n` +
+        `  ruleFiles: ${JSON.stringify(opts.includeRules ? ['rules.ts'] : [])},\n` +
+        `  boundaryFiles: ${JSON.stringify(opts.includeBoundaries ? ['boundaries.ts'] : [])},\n` +
+        `  pipelineFiles: ${JSON.stringify(opts.includePipelines ? ['pipelines.ts'] : [])},\n` +
+        `  knowledgeFiles: ${JSON.stringify(['knowledge.ts'])},\n` +
+        `  templateFiles: ${JSON.stringify([])},\n` +
+        `  docsFiles: ${JSON.stringify([])},\n` +
+        `  defaultMaxTokens: 3500,\n` +
+        `};\n\nexport default config;\n`);
+}
+function buildPathsFile(rendered) {
+    return (KNOWLEDGE_HELPERS +
+        '\nconst paths = [\n' +
+        rendered.join(',\n') +
+        (rendered.length > 0 ? ',\n' : '') +
+        '];\n\nexport default paths;\n');
+}
+function buildRulesFile(rendered) {
+    return (KNOWLEDGE_HELPERS +
+        '\nconst rules = [\n' +
+        rendered.join(',\n') +
+        (rendered.length > 0 ? ',\n' : '') +
+        '];\n\nexport default rules;\n');
+}
+function buildBoundariesFile(rendered) {
+    return ('// Generated by `shrk init --infer`. Plain default-export array — the\n' +
+        '// boundaries loader accepts any object with id/title/severity/from.\n\n' +
+        'export default [\n' +
+        rendered.join(',\n') +
+        (rendered.length > 0 ? ',\n' : '') +
+        '];\n');
+}
+function buildPipelinesFile(rendered) {
+    return (PIPELINE_HELPERS +
+        '\nconst pipelines = [\n' +
+        rendered.join(',\n') +
+        (rendered.length > 0 ? ',\n' : '') +
+        '];\n\nexport default pipelines;\n');
+}
+function buildKnowledgeSeed(projectName, description) {
+    // Minimal but useful knowledge seed — these aren't really inferable,
+    // but every repo benefits from the agent-briefing + safety baseline.
+    return (KNOWLEDGE_HELPERS +
+        '\n' +
+        `export const projectOverview = defineKnowledgeEntry({
+  id: 'project.overview',
+  title: ${JSON.stringify(projectName + ' — project overview')},
+  type: KnowledgeType.Architecture,
+  priority: KnowledgePriority.High,
+  tags: ['overview', 'inferred'],
+  scope: ['inferred'],
+  appliesWhen: ['onboard', 'plan-work'],
+  summary: ${JSON.stringify(description || 'High-level overview of this project.')},
+  content: ${JSON.stringify(description || 'High-level overview of this project. Generated by shrk init --infer; replace with project-specific context.')},
+});
+
+export const agentBriefing = defineKnowledgeEntry({
+  id: 'agent.briefing',
+  title: 'AI agent briefing',
+  type: KnowledgeType.Convention,
+  priority: KnowledgePriority.Critical,
+  tags: ['agent', 'safety'],
+  scope: ['agent'],
+  appliesWhen: ['agent-start', 'agent-plan'],
+  content: \`When working in this repo as an AI agent:
+1. Read \\\`shrk brief\\\` for the focused project context (rules + paths + verification).
+2. Use \\\`shrk task "<task>"\\\` to get a per-task packet (relevant rules + templates + commands).
+3. Generate code via \\\`shrk gen <template> <name> --dry-run --save-plan plan.json\\\`, then apply with \\\`shrk apply plan.json --verify-signature --validate\\\`.
+4. Never bypass \\\`shrk check boundaries\\\` — it gates architecture violations.\`,
+});
+
+export const generationSafety = defineKnowledgeEntry({
+  id: 'safety.generation',
+  title: 'Generation safety',
+  type: KnowledgeType.Warning,
+  priority: KnowledgePriority.Critical,
+  tags: ['safety', 'generation'],
+  scope: ['generation'],
+  appliesWhen: ['generate-code', 'overwrite-file'],
+  content: \`shrk gen defaults to dry-run. A real write requires --write AND a clean plan (no conflicts). AI agents must call create_generation_plan via MCP first — never write files directly through MCP.\`,
+});
+
+export default [projectOverview, agentBriefing, generationSafety];
+`);
+}
+// ─── Confidence report renderers ─────────────────────────────────────────────
+function buildReportMarkdown(report, projectName) {
+    const lines = [];
+    lines.push(`# Inferred from your codebase`);
+    lines.push('');
+    lines.push(`\`shrk init --infer\` scanned ${projectName} and produced the populated ` +
+        `\`sharkcraft/*.ts\` files alongside this report. Re-run with \`--force\` to regenerate.`);
+    lines.push('');
+    lines.push(`## ✅ Adopted directly (${report.adoptedHigh.length} entries — high confidence)`);
+    lines.push('');
+    if (report.adoptedHigh.length === 0) {
+        lines.push('_None._');
+    }
+    else {
+        for (const line of report.adoptedHigh) {
+            lines.push(`- **[${line.kind}] \`${line.id}\`** — ${line.title} _(${line.reason})_`);
+        }
+    }
+    lines.push('');
+    lines.push(`## 🟡 Adopted with review marker (${report.adoptedMedium.length} entries — medium confidence)`);
+    lines.push('');
+    lines.push('These entries were included in the populated files with a `// TODO: review` ' +
+        'comment. Read them, confirm they match your team\'s actual practice, then remove the marker.');
+    lines.push('');
+    if (report.adoptedMedium.length === 0) {
+        lines.push('_None._');
+    }
+    else {
+        for (const line of report.adoptedMedium) {
+            lines.push(`- **[${line.kind}] \`${line.id}\`** — ${line.title} _(${line.reason})_`);
+        }
+    }
+    lines.push('');
+    lines.push(`## ⚠️ Not adopted (${report.dropped.length} entries — low confidence)`);
+    lines.push('');
+    lines.push('These entries had weak signals — either incomplete data or generic patterns that ' +
+        'might not reflect your real conventions. Review the draft versions under ' +
+        '`sharkcraft/onboarding/` (after running `shrk onboard --write-drafts`) and adopt any that apply.');
+    lines.push('');
+    if (report.dropped.length === 0) {
+        lines.push('_None — all signals were strong enough to adopt._');
+    }
+    else {
+        for (const line of report.dropped) {
+            lines.push(`- **[${line.kind}] \`${line.id}\`** — ${line.title} _(${line.reason})_`);
+        }
+    }
+    lines.push('');
+    lines.push(`## ✍️ What shrk can't infer (author these by hand)`);
+    lines.push('');
+    lines.push('These categories rely on team knowledge that\'s not visible in code or config. ' +
+        'Add them to `sharkcraft/knowledge.ts` to make Claude aware:');
+    lines.push('');
+    for (const item of report.notInferable)
+        lines.push(`- ${item}`);
+    lines.push('');
+    lines.push('---');
+    lines.push('');
+    lines.push(`_Generated by \`shrk init --infer\`. This report is regenerated each ` +
+        `time you re-run with \`--force\`._`);
+    return lines.join('\n') + '\n';
+}
+const NOT_INFERABLE_DEFAULTS = [
+    'Project-specific architectural decisions ("we chose X over Y because…").',
+    'Deprecated paths / legacy code to avoid ("don\'t add new code to legacy/").',
+    'Non-obvious conventions ("our pagination uses cursor, not offset").',
+    'Cross-cutting concerns ("all writes go through the audit-log middleware").',
+    'Recently-changed patterns ("DTOs migrated to class-validator last month — old code uses Zod").',
+    'Team workflow conventions ("review with two approvals before merge to main").',
+];
+// ─── Public entry point ─────────────────────────────────────────────────────
+/**
+ * Convert an {@link IOnboardingPlan} into a populated set of
+ * `sharkcraft/*.ts` files plus a companion confidence report.
+ *
+ * The caller is responsible for actually writing the files; this
+ * function is pure (input plan → output strings).
+ */
+export function synthesizeFromOnboarding(plan) {
+    const report = { adoptedHigh: [], adoptedMedium: [], dropped: [] };
+    // ── Triage paths ────────────────────────────────────────────────────
+    const renderedPaths = [];
+    for (const p of [...plan.inferredPathConventions].sort((a, b) => a.id.localeCompare(b.id))) {
+        const tier = pathTier(p);
+        if (tier === 'low') {
+            report.dropped.push({ kind: 'path', id: p.id, title: p.title, reason: p.reason });
+            continue;
+        }
+        renderedPaths.push(renderPath(p, tier));
+        (tier === 'high' ? report.adoptedHigh : report.adoptedMedium).push({
+            kind: 'path',
+            id: p.id,
+            title: p.title,
+            reason: p.reason,
+        });
+    }
+    // ── Triage rules ────────────────────────────────────────────────────
+    const renderedRules = [];
+    for (const r of [...plan.inferredRules].sort((a, b) => a.id.localeCompare(b.id))) {
+        const tier = ruleTier(r);
+        if (tier === 'low') {
+            report.dropped.push({ kind: 'rule', id: r.id, title: r.title, reason: r.reason });
+            continue;
+        }
+        renderedRules.push(renderRule(r, tier));
+        (tier === 'high' ? report.adoptedHigh : report.adoptedMedium).push({
+            kind: 'rule',
+            id: r.id,
+            title: r.title,
+            reason: r.reason,
+        });
+    }
+    // ── Triage boundaries ──────────────────────────────────────────────
+    const renderedBoundaries = [];
+    for (const b of [...plan.inferredBoundaryRules].sort((a, b2) => a.id.localeCompare(b2.id))) {
+        const tier = boundaryTier(b);
+        if (tier === 'low') {
+            report.dropped.push({ kind: 'boundary', id: b.id, title: b.title, reason: b.reason });
+            continue;
+        }
+        renderedBoundaries.push(renderBoundary(b, tier));
+        (tier === 'high' ? report.adoptedHigh : report.adoptedMedium).push({
+            kind: 'boundary',
+            id: b.id,
+            title: b.title,
+            reason: b.reason,
+        });
+    }
+    // ── Triage pipelines ───────────────────────────────────────────────
+    const renderedPipelines = [];
+    for (const p of [...plan.inferredPipelines].sort((a, b) => a.id.localeCompare(b.id))) {
+        const tier = pipelineTier(p);
+        if (tier === 'low') {
+            report.dropped.push({ kind: 'pipeline', id: p.id, title: p.title, reason: p.reason });
+            continue;
+        }
+        renderedPipelines.push(renderPipeline(p, tier));
+        (tier === 'high' ? report.adoptedHigh : report.adoptedMedium).push({
+            kind: 'pipeline',
+            id: p.id,
+            title: p.title,
+            reason: p.reason,
+        });
+    }
+    // ── Templates are dropped wholesale into the report — emitting a
+    //    runnable template from inference is too speculative to populate
+    //    automatically. The user gets them as drafts via `shrk onboard
+    //    --write-drafts`.
+    for (const t of plan.inferredTemplateCandidates) {
+        report.dropped.push({
+            kind: 'template',
+            id: t.id,
+            title: t.name,
+            reason: `${t.reason} (templates require manual review; see sharkcraft/onboarding/inferred-templates.draft.ts after \`shrk onboard --write-drafts\`)`,
+        });
+    }
+    // ── Verification commands surface in the report only (consumed via
+    //    sharkcraft.config.ts verificationCommands[]; not emitted as
+    //    `sharkcraft/*.ts` here to avoid duplicating config shape).
+    for (const v of plan.inferredVerificationCommands) {
+        report.adoptedHigh.push({
+            kind: 'verification',
+            id: v.id,
+            title: `${v.label}: \`${v.command}\``,
+            reason: v.reason,
+        });
+    }
+    const projectName = plan.projectSummary.projectName ?? 'project';
+    const description = plan.projectSummary.description ?? '';
+    const files = [];
+    files.push({
+        path: 'sharkcraft.config.ts',
+        kind: 'config',
+        content: buildConfigFile({
+            projectName,
+            description,
+            includePaths: renderedPaths.length > 0,
+            includeRules: renderedRules.length > 0,
+            includeBoundaries: renderedBoundaries.length > 0,
+            includePipelines: renderedPipelines.length > 0,
+        }),
+    });
+    files.push({
+        path: 'knowledge.ts',
+        kind: 'knowledge',
+        content: buildKnowledgeSeed(projectName, description),
+    });
+    if (renderedPaths.length > 0) {
+        files.push({ path: 'paths.ts', kind: 'paths', content: buildPathsFile(renderedPaths) });
+    }
+    if (renderedRules.length > 0) {
+        files.push({ path: 'rules.ts', kind: 'rules', content: buildRulesFile(renderedRules) });
+    }
+    if (renderedBoundaries.length > 0) {
+        files.push({
+            path: 'boundaries.ts',
+            kind: 'boundaries',
+            content: buildBoundariesFile(renderedBoundaries),
+        });
+    }
+    if (renderedPipelines.length > 0) {
+        files.push({
+            path: 'pipelines.ts',
+            kind: 'pipelines',
+            content: buildPipelinesFile(renderedPipelines),
+        });
+    }
+    const fullReport = {
+        adoptedHigh: report.adoptedHigh,
+        adoptedMedium: report.adoptedMedium,
+        dropped: report.dropped,
+        notInferable: NOT_INFERABLE_DEFAULTS,
+    };
+    files.push({
+        path: '.inferred-report.md',
+        kind: 'report-md',
+        content: buildReportMarkdown(fullReport, projectName),
+    });
+    files.push({
+        path: '.inferred-report.json',
+        kind: 'report-json',
+        content: JSON.stringify({
+            schema: 'sharkcraft.inferred-report/v1',
+            generatedAt: new Date().toISOString().slice(0, 10),
+            projectName,
+            adoptedHigh: fullReport.adoptedHigh,
+            adoptedMedium: fullReport.adoptedMedium,
+            dropped: fullReport.dropped,
+            notInferable: fullReport.notInferable,
+        }, null, 2) + '\n',
+    });
+    return { files, report: fullReport };
+}

package/dist/task-ranker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-ranker.d.ts","sourceRoot":"","sources":["../src/task-ranker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAElE;;;;;;;;GAQG;AAEH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAiQD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,IAAI,EAAE,MAAM,GACX,WAAW,CAAC,eAAe,CAAC,EAAE,CAqBhC;AAGD,wBAAgB,aAAa,CAC3B,SAAS,EAAE,SAAS,mBAAmB,EAAE,EACzC,IAAI,EAAE,MAAM,GACX,WAAW,CAAC,mBAAmB,CAAC,EAAE,CAiBpC;AAGD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,IAAI,EAAE,MAAM,GACX,WAAW,CAAC,eAAe,CAAC,EAAE,CAEhC;AAGD,wBAAgB,aAAa,CAC3B,SAAS,EAAE,SAAS,mBAAmB,EAAE,EACzC,IAAI,EAAE,MAAM,GACX,WAAW,CAAC,mBAAmB,CAAC,EAAE,CAkCpC;AAGD,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,WAAW,CAAC,OAAO,CAAC,EAAE,CAgCxB;AAGD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EAAE,CAAC;IACtC,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EAAE,CAAC;IACtC,SAAS,EAAE,WAAW,CAAC,mBAAmB,CAAC,EAAE,CAAC;IAC9C,SAAS,EAAE,WAAW,CAAC,mBAAmB,CAAC,EAAE,CAAC;IAC9C,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;CACjC;AAED,wBAAgB,OAAO,CACrB,UAAU,EAAE;IACV,gBAAgB,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC1C,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC1C,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,SAAS,OAAO,EAAE,CAAA;KAAE,CAAC;IACnD,SAAS,EAAE;QAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAC3C,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,SAAS,eAAe,EAAE,CAAA;KAAE,CAAC;IACxD,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,SAAS,eAAe,EAAE,CAAA;KAAE,CAAC;CACzD,EACD,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAW,GACjB,cAAc,CAiEhB;AAGD,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,EAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC7B,KAAK,GAAE,MAAU,GAChB,MAAM,CAKR;AAED,uFAAuF;AACvF,YAAY,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"task-ranker.d.ts","sourceRoot":"","sources":["../src/task-ranker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAElE;;;;;;;;GAQG;AAEH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAmOD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,IAAI,EAAE,MAAM,GACX,WAAW,CAAC,eAAe,CAAC,EAAE,CAqBhC;AAGD,wBAAgB,aAAa,CAC3B,SAAS,EAAE,SAAS,mBAAmB,EAAE,EACzC,IAAI,EAAE,MAAM,GACX,WAAW,CAAC,mBAAmB,CAAC,EAAE,CAiBpC;AAGD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,IAAI,EAAE,MAAM,GACX,WAAW,CAAC,eAAe,CAAC,EAAE,CAEhC;AAGD,wBAAgB,aAAa,CAC3B,SAAS,EAAE,SAAS,mBAAmB,EAAE,EACzC,IAAI,EAAE,MAAM,GACX,WAAW,CAAC,mBAAmB,CAAC,EAAE,CAkCpC;AAGD,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,OAAO,EAAE,EAC3B,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,SAAS,MAAM,EAAE,GAClC,WAAW,CAAC,OAAO,CAAC,EAAE,CAgCxB;AAGD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EAAE,CAAC;IACtC,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EAAE,CAAC;IACtC,SAAS,EAAE,WAAW,CAAC,mBAAmB,CAAC,EAAE,CAAC;IAC9C,SAAS,EAAE,WAAW,CAAC,mBAAmB,CAAC,EAAE,CAAC;IAC9C,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;CACjC;AAED,wBAAgB,OAAO,CACrB,UAAU,EAAE;IACV,gBAAgB,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC1C,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC1C,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,SAAS,OAAO,EAAE,CAAA;KAAE,CAAC;IACnD,SAAS,EAAE;QAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;IAC3C,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,SAAS,eAAe,EAAE,CAAA;KAAE,CAAC;IACxD,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,SAAS,eAAe,EAAE,CAAA;KAAE,CAAC;CACzD,EACD,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAW,GACjB,cAAc,CAiEhB;AAGD,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,EAChC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,EAC7B,KAAK,GAAE,MAAU,GAChB,MAAM,CAKR;AAED,uFAAuF;AACvF,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/task-ranker.js

@@ -29,33 +29,8 @@ const VERB_HINTS = [
 // ── Domain hints (what *kind of thing* is being worked on) ──────────────
 // These boost rules/templates/pipelines whose own `appliesWhen` or `tags`
 // declare the same domain — much higher signal than verb hints alone for
-// "create a user profile *plugin*" vs "add pagination *capability*".
+// "create a *service*" vs "add a *utility*".
 const DOMAIN_HINTS = [
-    {
-        token: 'plugin',
-        appliesWhen: ['create-plugin', 'generate-plugin', 'plugin-dev', 'register-plugin'],
-        tags: ['plugin'],
-    },
-    {
-        token: 'defaults',
-        appliesWhen: ['register-defaults', 'create-defaults', 'plugin-defaults'],
-        tags: ['defaults'],
-    },
-    {
-        token: 'capability',
-        appliesWhen: ['create-capability', 'generate-capability'],
-        tags: ['capability'],
-    },
-    {
-        token: 'policy',
-        appliesWhen: ['create-policy', 'generate-policy'],
-        tags: ['policy'],
-    },
-    {
-        token: 'adapter',
-        appliesWhen: ['create-adapter', 'generate-adapter'],
-        tags: ['adapter'],
-    },
     {
         token: 'service',
         appliesWhen: ['generate-service'],
@@ -81,11 +56,6 @@ const DOMAIN_HINTS = [
         appliesWhen: ['generate-route'],
         tags: ['http', 'routes', 'api'],
     },
-    {
-        token: 'kernel',
-        appliesWhen: ['create-kernel-service'],
-        tags: ['kernel'],
-    },
 ];
 function tokenize(s) {
     return s

package/dist/test-runner.js

@@ -144,8 +144,8 @@ function buildMissingIncludeSuggestions(id, existsInRegistry, task) {
     }
     return [
         `Entry "${id}" exists but did not make the context for task "${task}".`,
-        `Try adding domain-aligned appliesWhen values (create-plugin / generate-service / register-defaults / …).`,
-        `Add task-relevant tags (plugin / capability / adapter / …).`,
+        `Try adding domain-aligned appliesWhen values (generate-service / generate-utility / create-pipeline / …).`,
+        `Add task-relevant tags (service / utility / route / …).`,
         `Reference the entry from a preset's includes.knowledgeIds / ruleIds so it ranks higher.`,
         `Or raise its priority / shorten the title to include task-relevant tokens.`,
     ];
@@ -219,7 +219,7 @@ export function runAgentContractTest(inspection, test, registries) {
                 suggestions: exists
                     ? [
                         `Template "${id}" exists but the ranker did not place it in the top results.`,
-                        'Add task-aligned tags/appliesWhen to the template (e.g. tags:["plugin"], appliesWhen:["create-plugin"]).',
+                        'Add task-aligned tags/appliesWhen to the template (e.g. tags:["service"], appliesWhen:["generate-service"]).',
                         'Reference the template from a preset that matches the task profile (includes.templateIds).',
                         'Reference it from a pipeline step (`step.references`).',
                     ]
@@ -237,8 +237,8 @@ export function runAgentContractTest(inspection, test, registries) {
                 suggestions: exists
                     ? [
                         `Rule "${id}" exists but the ranker did not surface it for "${test.task}".`,
-                        'Align its appliesWhen with the domain (e.g. create-plugin / register-defaults / generate-service).',
-                        'Add domain tags (plugin / capability / adapter / defaults).',
+                        'Align its appliesWhen with the domain (e.g. generate-service / generate-utility / create-pipeline).',
+                        'Add domain tags (service / utility / route / pipeline).',
                         'Reference it from actionHints.relatedTemplates on a rule that *is* ranking, or include it in a preset.',
                     ]
                     : [

package/dist/universal-search.d.ts

@@ -17,7 +17,6 @@ export declare enum SearchResultKind {
     ScaffoldPattern = "scaffold-pattern",
     ContractTemplate = "contract-template",
     MigrationProfile = "migration-profile",
-    PluginLifecycleProfile = "plugin-lifecycle-profile",
     FeedbackRule = "feedback-rule",
     TaskRoutingHint = "task-routing-hint",
     Docs = "docs",

package/dist/universal-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"universal-search.d.ts","sourceRoot":"","sources":["../src/universal-search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"universal-search.d.ts","sourceRoot":"","sources":["../src/universal-search.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAgC,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGhG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,eAAO,MAAM,uBAAuB,mCAAmC,CAAC;AAExE,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,OAAO,aAAa;IACpB,SAAS,cAAc;IACvB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,eAAe,qBAAqB;IACpC,gBAAgB,sBAAsB;IACtC,gBAAgB,sBAAsB;IACtC,YAAY,kBAAkB;IAC9B,eAAe,sBAAsB;IACrC,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAClD,QAAQ,CAAC,aAAa,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACvD,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,uBAAuB,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AA+CD,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,qBAAqB,EACjC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CA4NjC;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAmDhF;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CA8BpF"}

package/dist/universal-search.js

@@ -17,7 +17,6 @@ import { buildPackContributionsInventory } from "./pack-contributions-inventory.
 import { listConventions } from "./convention-registry.js";
 import { listPackHelpers } from "./pack-helper-registry.js";
 import { explainTaskRouting } from "./task-routing-hint-registry.js";
-import { listPluginLifecycleProfiles } from "./plugin-lifecycle-profile-registry.js";
 import { uncertaintyReportFromSummary } from "./uncertainty-report.js";
 import { buildUncertaintySummary } from "./uncertainty.js";
 import { buildTaskPacket } from "./task-packet.js";
@@ -39,7 +38,6 @@ export var SearchResultKind;
     SearchResultKind["ScaffoldPattern"] = "scaffold-pattern";
     SearchResultKind["ContractTemplate"] = "contract-template";
     SearchResultKind["MigrationProfile"] = "migration-profile";
-    SearchResultKind["PluginLifecycleProfile"] = "plugin-lifecycle-profile";
     SearchResultKind["FeedbackRule"] = "feedback-rule";
     SearchResultKind["TaskRoutingHint"] = "task-routing-hint";
     SearchResultKind["Docs"] = "docs";
@@ -89,7 +87,6 @@ export async function buildUniversalSearch(inspection, query, options = {}) {
     const conventions = await listConventions(inspection);
     const helpers = await listPackHelpers(inspection);
     const routing = await explainTaskRouting(inspection, q);
-    const lifecycle = await listPluginLifecycleProfiles(inspection);
     const knowledgeEntries = inspection.knowledgeEntries;
     const allHits = [];
     // Knowledge
@@ -113,13 +110,6 @@ export async function buildUniversalSearch(inspection, query, options = {}) {
             allHits.push(makeHit(SearchResultKind.Helper, h.helper.id, h.helper.title, h.source === 'pack' ? 'pack' : 'local', h.packageName, s, `shrk helper plan ${h.helper.id}`));
         }
     }
-    // Plugin lifecycle profiles
-    for (const p of lifecycle) {
-        const s = score(`${p.profile.id} ${p.profile.title} ${(p.profile.tags ?? []).join(' ')}`, q);
-        if (s.score > 0) {
-            allHits.push(makeHit(SearchResultKind.PluginLifecycleProfile, p.profile.id, p.profile.title, p.source === 'pack' ? 'pack' : 'local', p.packageName, s, `shrk plugin lifecycle profile ${p.profile.id}`));
-        }
-    }
     // Pack contributions (catch-all for kinds we didn't iterate above)
     for (const e of inv.entries) {
         if (allHits.find((h) => h.id === e.id && String(h.kind) === e.kind))
@@ -140,7 +130,6 @@ export async function buildUniversalSearch(inspection, query, options = {}) {
                 decision: SearchResultKind.Decision,
                 'contract-template': SearchResultKind.ContractTemplate,
                 'migration-profile': SearchResultKind.MigrationProfile,
-                'plugin-lifecycle-profile': SearchResultKind.PluginLifecycleProfile,
                 'feedback-rule': SearchResultKind.FeedbackRule,
                 'task-routing-hint': SearchResultKind.TaskRoutingHint,
                 helper: SearchResultKind.Helper,
@@ -184,7 +173,6 @@ export async function buildUniversalSearch(inspection, query, options = {}) {
             SearchResultKind.Policy,
             SearchResultKind.ContractTemplate,
             SearchResultKind.MigrationProfile,
-            SearchResultKind.PluginLifecycleProfile,
             SearchResultKind.ScaffoldPattern,
             SearchResultKind.FeedbackRule,
             SearchResultKind.TaskRoutingHint,