projscan 4.7.0 → 4.9.1

package/dist/core/startDailyWorkflows.js

@@ -0,0 +1,50 @@
+export function buildStartDailyWorkflows() {
+    return [
+        {
+            id: 'before_edit',
+            name: 'Before editing a feature',
+            outcome: 'The agent starts with cited change context and a before-edit gate.',
+            commands: [
+                'projscan start --intent "what files do I need to change for auth?"',
+                'projscan understand --view change --intent "add auth token refresh" --format json',
+                'projscan preflight --mode before_edit --format json',
+            ],
+            successCriteria: [
+                'Agent has cited change context before editing.',
+                'Likely touched files and read-first context are explicit.',
+                'Before-edit preflight is visible before code changes.',
+            ],
+        },
+        {
+            id: 'before_handoff',
+            name: 'Before handoff or commit',
+            outcome: 'The reviewer sees proof commands and separated fix/review gates.',
+            commands: [
+                'projscan bug-hunt --format json',
+                'projscan preflight --mode before_commit --format json',
+                'projscan evidence-pack --pr-comment',
+            ],
+            successCriteria: [
+                'Concrete fix targets and manual review gates are separated.',
+                'Reviewer-facing evidence includes exact proof commands.',
+                'The handoff does not depend on reading an agent transcript.',
+            ],
+        },
+        {
+            id: 'release_candidate_review',
+            name: 'Release-candidate review',
+            outcome: 'Release-readiness stays read-only and separates fixes from sign-off.',
+            commands: [
+                'projscan release-train --format json',
+                'projscan preflight --mode before_merge --format json',
+                'projscan evidence-pack --pr-comment',
+            ],
+            successCriteria: [
+                'Release-readiness output stays read-only.',
+                'Caution output explains whether fixes or manual sign-off are needed.',
+                'No version, publish, tag, or deploy step is implied.',
+            ],
+        },
+    ];
+}
+//# sourceMappingURL=startDailyWorkflows.js.map

package/dist/core/startDailyWorkflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startDailyWorkflows.js","sourceRoot":"","sources":["../../src/core/startDailyWorkflows.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL;YACE,EAAE,EAAE,aAAa;YACjB,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,oEAAoE;YAC7E,QAAQ,EAAE;gBACR,oEAAoE;gBACpE,mFAAmF;gBACnF,qDAAqD;aACtD;YACD,eAAe,EAAE;gBACf,gDAAgD;gBAChD,2DAA2D;gBAC3D,uDAAuD;aACxD;SACF;QACD;YACE,EAAE,EAAE,gBAAgB;YACpB,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,kEAAkE;YAC3E,QAAQ,EAAE;gBACR,iCAAiC;gBACjC,uDAAuD;gBACvD,qCAAqC;aACtC;YACD,eAAe,EAAE;gBACf,6DAA6D;gBAC7D,yDAAyD;gBACzD,6DAA6D;aAC9D;SACF;QACD;YACE,EAAE,EAAE,0BAA0B;YAC9B,IAAI,EAAE,0BAA0B;YAChC,OAAO,EAAE,sEAAsE;YAC/E,QAAQ,EAAE;gBACR,sCAAsC;gBACtC,sDAAsD;gBACtD,qCAAqC;aACtC;YACD,eAAe,EAAE;gBACf,2CAA2C;gBAC3C,sEAAsE;gBACtE,sDAAsD;aACvD;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/core/startDependencyRouteCriteria.d.ts

@@ -0,0 +1,2 @@
+import type { StartRoutedIntent } from '../types/start.js';
+export declare function dependencySuccessCriteria(route: StartRoutedIntent): string[];

package/dist/core/startDependencyRouteCriteria.js

@@ -0,0 +1,43 @@
+const DEPENDENCY_LICENSE_KEYWORDS = [
+    'license',
+    'licenses',
+    'gpl',
+    'copyleft',
+    'notice',
+    'notices',
+    'third',
+    'party',
+    'open',
+    'source',
+    'compliance',
+];
+const DEPENDENCY_BUNDLE_KEYWORDS = [
+    'bundle',
+    'bundles',
+    'size',
+    'sizes',
+    'large',
+    'heavy',
+    'bloat',
+    'bloated',
+    'weight',
+    'footprint',
+    'reduce',
+    'slim',
+];
+export function dependencySuccessCriteria(route) {
+    const criteria = [];
+    if (matchesAnyKeyword(route, DEPENDENCY_LICENSE_KEYWORDS)) {
+        criteria.push('Dependency license counts, unknown licenses, and copyleft risks are reviewed before third-party notices or compliance sign-off.');
+    }
+    if (matchesAnyKeyword(route, DEPENDENCY_BUNDLE_KEYWORDS)) {
+        criteria.push('Installed package-size totals and largest packages are reviewed before bundle-size or dependency-bloat work starts.');
+    }
+    criteria.push('Declared production and development dependencies are inventoried before package changes are planned.');
+    criteria.push('Any dependency risks, workspace-specific counts, or missing lockfile signal has an owner or follow-up command.');
+    return criteria;
+}
+function matchesAnyKeyword(route, keywords) {
+    return route.matchedKeywords.some((keyword) => keywords.includes(keyword));
+}
+//# sourceMappingURL=startDependencyRouteCriteria.js.map

package/dist/core/startDependencyRouteCriteria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startDependencyRouteCriteria.js","sourceRoot":"","sources":["../../src/core/startDependencyRouteCriteria.ts"],"names":[],"mappings":"AAEA,MAAM,2BAA2B,GAAG;IAClC,SAAS;IACT,UAAU;IACV,KAAK;IACL,UAAU;IACV,QAAQ;IACR,SAAS;IACT,OAAO;IACP,OAAO;IACP,MAAM;IACN,QAAQ;IACR,YAAY;CACb,CAAC;AAEF,MAAM,0BAA0B,GAAG;IACjC,QAAQ;IACR,SAAS;IACT,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,SAAS;IACT,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,MAAM;CACP,CAAC;AAEF,MAAM,UAAU,yBAAyB,CAAC,KAAwB;IAChE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,iBAAiB,CAAC,KAAK,EAAE,2BAA2B,CAAC,EAAE,CAAC;QAC1D,QAAQ,CAAC,IAAI,CACX,iIAAiI,CAClI,CAAC;IACJ,CAAC;IACD,IAAI,iBAAiB,CAAC,KAAK,EAAE,0BAA0B,CAAC,EAAE,CAAC;QACzD,QAAQ,CAAC,IAAI,CACX,qHAAqH,CACtH,CAAC;IACJ,CAAC;IACD,QAAQ,CAAC,IAAI,CACX,sGAAsG,CACvG,CAAC;IACF,QAAQ,CAAC,IAAI,CACX,gHAAgH,CACjH,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAwB,EAAE,QAAkB;IACrE,OAAO,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/core/startEnvTargets.d.ts

@@ -0,0 +1 @@
+export declare function extractEnvVarTarget(intent: string): string | undefined;

package/dist/core/startEnvTargets.js

@@ -0,0 +1,9 @@
+export function extractEnvVarTarget(intent) {
+    const compactIntent = intent.trim().replace(/[?!\s]+$/g, '');
+    const processMatch = compactIntent.match(/\bprocess\.env\.[A-Za-z_][A-Za-z0-9_]*\b/);
+    if (processMatch?.[0])
+        return processMatch[0];
+    const envMatch = compactIntent.match(/\b([A-Z][A-Z0-9]*_[A-Z0-9_]+)\b/);
+    return envMatch?.[1];
+}
+//# sourceMappingURL=startEnvTargets.js.map

package/dist/core/startEnvTargets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startEnvTargets.js","sourceRoot":"","sources":["../../src/core/startEnvTargets.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACrF,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACxE,OAAO,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;AACvB,CAAC"}

package/dist/core/startFileRouteCriteria.d.ts

@@ -0,0 +1,2 @@
+import type { StartRoutedIntent } from '../types/start.js';
+export declare function fileSuccessCriteria(route: StartRoutedIntent): string[];

package/dist/core/startFileRouteCriteria.js

@@ -0,0 +1,56 @@
+const FILE_CRITERIA_RULES = [
+    {
+        keywords: ['risk', 'risks', 'risky', 'dangerous'],
+        criterion: 'Hotspot reasons, related issues, imports, exports, and ownership explain why the file is risky.',
+    },
+    {
+        keywords: [
+            'last',
+            'touched',
+            'touch',
+            'changed',
+            'recently',
+            'history',
+            'author',
+            'authors',
+            'blame',
+        ],
+        criterion: 'Primary author, recent history, and ownership signals are reviewed before routing reviewers or changing the file.',
+    },
+    {
+        keywords: ['coverage', 'covered', 'uncovered', 'test', 'tests'],
+        criterion: 'Coverage, hotspot risk, and related test evidence for the file are reviewed before editing starts.',
+    },
+    {
+        matches: matchesFileTestDesignCriteria,
+        criterion: 'File purpose, risky functions, coverage, and existing test evidence are reviewed before designing a new test.',
+    },
+    {
+        keywords: ['read'],
+        criterion: 'Purpose, imports, exports, ownership, tests, and risk are reviewed before changing the named file.',
+    },
+    {
+        keywords: ['review', 'reviewer', 'reviewers'],
+        criterion: 'Ownership, primary author, hotspot risk, and related issues are reviewed before choosing a reviewer.',
+    },
+];
+export function fileSuccessCriteria(route) {
+    const matched = new Set(route.matchedKeywords);
+    return [
+        ...FILE_CRITERIA_RULES.filter((rule) => fileCriteriaRuleMatches(rule, matched)).map((rule) => rule.criterion),
+        'The file purpose, imports, exports, ownership, and risk are reviewed before editing starts.',
+        'Any follow-up impact, owner, or test command from the file report is added to the workplan.',
+    ];
+}
+function fileCriteriaRuleMatches(rule, matched) {
+    if (rule.matches)
+        return rule.matches(matched);
+    return (rule.keywords ?? []).some((keyword) => matched.has(keyword));
+}
+function matchesFileTestDesignCriteria(matched) {
+    const explicitAuthoring = ['add', 'write'].some((keyword) => matched.has(keyword));
+    const testWithoutCoverage = matched.has('test') &&
+        !['coverage', 'covered', 'uncovered'].some((keyword) => matched.has(keyword));
+    return explicitAuthoring || testWithoutCoverage;
+}
+//# sourceMappingURL=startFileRouteCriteria.js.map

package/dist/core/startFileRouteCriteria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startFileRouteCriteria.js","sourceRoot":"","sources":["../../src/core/startFileRouteCriteria.ts"],"names":[],"mappings":"AAQA,MAAM,mBAAmB,GAAuB;IAC9C;QACE,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC;QACjD,SAAS,EACP,iGAAiG;KACpG;IACD;QACE,QAAQ,EAAE;YACR,MAAM;YACN,SAAS;YACT,OAAO;YACP,SAAS;YACT,UAAU;YACV,SAAS;YACT,QAAQ;YACR,SAAS;YACT,OAAO;SACR;QACD,SAAS,EACP,mHAAmH;KACtH;IACD;QACE,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC;QAC/D,SAAS,EACP,oGAAoG;KACvG;IACD;QACE,OAAO,EAAE,6BAA6B;QACtC,SAAS,EACP,+GAA+G;KAClH;IACD;QACE,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,SAAS,EACP,oGAAoG;KACvG;IACD;QACE,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC;QAC7C,SAAS,EACP,sGAAsG;KACzG;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,KAAwB;IAC1D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC/C,OAAO;QACL,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CACjF,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CACzB;QACD,6FAA6F;QAC7F,6FAA6F;KAC9F,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAsB,EAAE,OAAoB;IAC3E,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,6BAA6B,CAAC,OAAoB;IACzD,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACnF,MAAM,mBAAmB,GACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;QACnB,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAChF,OAAO,iBAAiB,IAAI,mBAAmB,CAAC;AAClD,CAAC"}

package/dist/core/startFileTargets.d.ts

@@ -0,0 +1,2 @@
+export declare function extractFileTarget(intent: string): string | undefined;
+export declare function isFilePathTarget(target: string): boolean;

package/dist/core/startFileTargets.js

@@ -0,0 +1,19 @@
+import { unwrapTarget } from './startIntentTargetText.js';
+export function extractFileTarget(intent) {
+    const compactIntent = intent.trim().replace(/[?!\s]+$/g, '');
+    const wrapped = compactIntent.match(/[`'"]([^`'"]+\.[A-Za-z0-9]{1,12})[`'"]/);
+    if (wrapped?.[1] && isFilePathTarget(wrapped[1]))
+        return wrapped[1];
+    const pathMatch = compactIntent.match(/(?:^|\s)([A-Za-z0-9_./:@-]+\.[A-Za-z0-9]{1,12})(?:\s|$)/);
+    if (pathMatch?.[1] && isFilePathTarget(pathMatch[1]))
+        return unwrapTarget(pathMatch[1]);
+    const slashPathMatch = compactIntent.match(/(?:^|\s)([A-Za-z0-9_./:@-]+\/[A-Za-z0-9_./:@-]+)(?:\s|$)/);
+    if (slashPathMatch?.[1] && isFilePathTarget(slashPathMatch[1]))
+        return unwrapTarget(slashPathMatch[1]);
+    return undefined;
+}
+export function isFilePathTarget(target) {
+    return ((target.includes('/') || target.startsWith('.') || /\.[A-Za-z0-9]{1,12}$/.test(target)) &&
+        !/\s/.test(target));
+}
+//# sourceMappingURL=startFileTargets.js.map

package/dist/core/startFileTargets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startFileTargets.js","sourceRoot":"","sources":["../../src/core/startFileTargets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC9E,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IAEpE,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IACjG,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAExF,MAAM,cAAc,GAAG,aAAa,CAAC,KAAK,CACxC,0DAA0D,CAC3D,CAAC;IACF,IAAI,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAC5D,OAAO,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,CACL,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvF,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CACnB,CAAC;AACJ,CAAC"}

package/dist/core/startFixedRouteCriteria.d.ts

@@ -0,0 +1 @@
+export declare const FIXED_ROUTE_CRITERIA: Record<string, string[]>;

package/dist/core/startFixedRouteCriteria.js

@@ -0,0 +1,90 @@
+export const FIXED_ROUTE_CRITERIA = {
+    projscan_release_train: [
+        'Release train readiness has no blockers before packaging or publishing continues.',
+        'Changelog, package, SBOM, and provenance evidence are reviewed before a release handoff.',
+    ],
+    projscan_bug_hunt: [
+        'Bug-hunt findings are triaged by severity with a first fix candidate selected.',
+        'The selected fix has a runnable verification command before editing starts.',
+    ],
+    projscan_workplan: [
+        'The workplan identifies the first safe implementation or review step before edits begin.',
+        'The selected action has a focused verification command before handoff.',
+    ],
+    projscan_agent_brief: [
+        'The agent brief summarizes focus items, repo context, guardrails, and suggested next actions for the next developer.',
+        'The handoff includes enough proof commands for the next agent to resume without rerunning broad discovery.',
+    ],
+    projscan_session: [
+        'Remembered touched files and recent session events are reviewed before resuming work.',
+        'The current worktree preflight is rerun after session context is reviewed, so stale memory does not override live risk.',
+    ],
+    projscan_coordinate: [
+        'Coordination readiness, collisions, claims, and merge order are reviewed before parallel work continues.',
+        'Any conflicted files, contended claims, or merge-order blockers have an owner or follow-up command before editing resumes.',
+    ],
+    projscan_privacy_check: [
+        'Telemetry state, offline mode, scan root, ignored-file handling, .env content policy, plugin execution, local writes, and network-capable endpoints are reviewed.',
+        'Any required trust-boundary change is made explicitly before broader analysis or report sharing continues.',
+    ],
+    projscan_quality_scorecard: [
+        'Quality dimensions, top risks, and verification commands are reviewed before choosing the next task.',
+        'The developer knows whether health, security, tests, maintainability, or coordination needs attention first.',
+    ],
+    projscan_review: [
+        'The structural PR review reports a verdict and identifies any risk that needs owner follow-up.',
+        'Review, preflight, or evidence-pack follow-up is chosen before the branch is handed to reviewers.',
+    ],
+    projscan_evidence_pack: [
+        'The evidence pack produces a paste-ready PR comment with verdict, top risks, owner routing, and next commands.',
+        'The reviewer-facing comment is validated before it is shared or used for approval.',
+    ],
+    projscan_analyze: [
+        'The scoped analysis, health, and CI artifacts are generated with path redaction enabled before sharing outside the repo.',
+        'The reviewer can correlate redacted-path-N labels without seeing raw repo structure.',
+    ],
+    projscan_doctor: [
+        'Dead code, unused exports, lint, dependency, security, and config issues are reviewed before cleanup starts.',
+        'Any issue chosen for cleanup has a fix-suggest, impact, or verification follow-up before files are deleted.',
+    ],
+    projscan_fix_suggest: [
+        'A concrete fix suggestion is produced for the selected issue id.',
+        'The suggestion names the file, fix instruction, and verification step before editing starts.',
+    ],
+    projscan_explain_issue: [
+        'A deep issue explanation is produced for the selected issue id.',
+        'The explanation identifies surrounding code, related issues, similar fixes, and the next fix prompt before editing starts.',
+    ],
+    projscan_pr_diff: [
+        'The structural diff is reviewed for changed exports, imports, call sites, and complexity before a full review verdict.',
+        'The developer knows which changed files or symbols need deeper review.',
+    ],
+    projscan_coverage: [
+        'Coverage gaps are ranked by risk so the next test target is explicit.',
+        'The selected file has either a new test plan, an owner, or a documented reason to defer.',
+    ],
+    projscan_upgrade: [
+        'The upgrade preview identifies declared version, installed version, breaking markers, and importers.',
+        'Importer files are reviewed before changing the package version.',
+    ],
+    projscan_audit: [
+        'npm audit findings are reviewed for critical, high, moderate, low, and info vulnerabilities.',
+        'Any vulnerable dependency has a fix, upgrade preview, or documented deferral before the branch is trusted.',
+    ],
+    projscan_workspaces: [
+        'Monorepo workspace packages are listed with names and relative paths before package-scoped work begins.',
+        'The selected workspace name is available for package-scoped follow-up commands such as hotspots, coupling, review, or audit.',
+    ],
+    projscan_dataflow: [
+        'Dataflow findings are reviewed for direct, propagated, and bridge source-to-sink paths.',
+        'Any confirmed source-to-sink path has an owner, mitigation, and rerunnable verification command before editing continues.',
+    ],
+    projscan_semantic_graph: [
+        'The targeted graph query answers the importer/import/export question without dumping the full graph.',
+        'Any returned files are reviewed before editing the queried file or symbol.',
+    ],
+    projscan_search: [
+        'Search results identify the target files or symbols with enough confidence to choose the next tool.',
+    ],
+};
+//# sourceMappingURL=startFixedRouteCriteria.js.map

package/dist/core/startFixedRouteCriteria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startFixedRouteCriteria.js","sourceRoot":"","sources":["../../src/core/startFixedRouteCriteria.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAA6B;IAC5D,sBAAsB,EAAE;QACtB,mFAAmF;QACnF,0FAA0F;KAC3F;IACD,iBAAiB,EAAE;QACjB,gFAAgF;QAChF,6EAA6E;KAC9E;IACD,iBAAiB,EAAE;QACjB,0FAA0F;QAC1F,wEAAwE;KACzE;IACD,oBAAoB,EAAE;QACpB,sHAAsH;QACtH,4GAA4G;KAC7G;IACD,gBAAgB,EAAE;QAChB,uFAAuF;QACvF,yHAAyH;KAC1H;IACD,mBAAmB,EAAE;QACnB,0GAA0G;QAC1G,4HAA4H;KAC7H;IACD,sBAAsB,EAAE;QACtB,mKAAmK;QACnK,4GAA4G;KAC7G;IACD,0BAA0B,EAAE;QAC1B,sGAAsG;QACtG,8GAA8G;KAC/G;IACD,eAAe,EAAE;QACf,gGAAgG;QAChG,mGAAmG;KACpG;IACD,sBAAsB,EAAE;QACtB,gHAAgH;QAChH,oFAAoF;KACrF;IACD,gBAAgB,EAAE;QAChB,0HAA0H;QAC1H,sFAAsF;KACvF;IACD,eAAe,EAAE;QACf,8GAA8G;QAC9G,6GAA6G;KAC9G;IACD,oBAAoB,EAAE;QACpB,kEAAkE;QAClE,8FAA8F;KAC/F;IACD,sBAAsB,EAAE;QACtB,iEAAiE;QACjE,4HAA4H;KAC7H;IACD,gBAAgB,EAAE;QAChB,wHAAwH;QACxH,wEAAwE;KACzE;IACD,iBAAiB,EAAE;QACjB,uEAAuE;QACvE,0FAA0F;KAC3F;IACD,gBAAgB,EAAE;QAChB,sGAAsG;QACtG,kEAAkE;KACnE;IACD,cAAc,EAAE;QACd,8FAA8F;QAC9F,4GAA4G;KAC7G;IACD,mBAAmB,EAAE;QACnB,yGAAyG;QACzG,8HAA8H;KAC/H;IACD,iBAAiB,EAAE;QACjB,yFAAyF;QACzF,2HAA2H;KAC5H;IACD,uBAAuB,EAAE;QACvB,sGAAsG;QACtG,4EAA4E;KAC7E;IACD,eAAe,EAAE;QACf,qGAAqG;KACtG;CACF,CAAC"}

package/dist/core/startGeneratedConfigSearchTargets.d.ts

@@ -0,0 +1 @@
+export declare function searchQueryFromGeneratedAndConfig(trimmed: string): string | undefined;

package/dist/core/startGeneratedConfigSearchTargets.js

@@ -0,0 +1,22 @@
+import { unwrapTarget } from './startIntentTargetText.js';
+import { extractToolingConfigQuery } from './startIntentToolingConfigQueries.js';
+export function searchQueryFromGeneratedAndConfig(trimmed) {
+    const generatedLookup = trimmed.match(/\b(?:show|find|locate|search(?:\s+for)?|where\s+(?:are|is)|which|what|is)\s+(?:me\s+)?(?:this\s+)?(?:the\s+)?(.+?)\s*[?!.]*$/i);
+    if (generatedLookup?.[1] && /\bgenerated\b/i.test(generatedLookup[1])) {
+        if (/\bfiles?\b/i.test(generatedLookup[1]))
+            return 'generated files';
+        if (/\bcode\b/i.test(generatedLookup[1]))
+            return 'generated code';
+    }
+    const toolingConfig = extractToolingConfigQuery(trimmed);
+    if (toolingConfig)
+        return toolingConfig;
+    const configDefinitionLookup = trimmed.match(/\bwhich\s+(?:config(?:uration)?\s+files?|files?)\s+(?:defines?|contains|sets?|configures?)\s+(.+?)\s*[?!.]*$/i);
+    if (configDefinitionLookup?.[1] && /\bconfig(?:uration)?\b/i.test(trimmed))
+        return `${unwrapTarget(configDefinitionLookup[1].trim())} config`;
+    const configLookup = trimmed.match(/\b(?:where\s+(?:is|are)|find|locate|search(?:\s+for)?|lookup|show)\s+(?:the\s+)?(.+?\bconfig(?:uration)?(?:\s+files?)?)\s*[?!.]*$/i);
+    if (configLookup?.[1])
+        return unwrapTarget(configLookup[1].trim());
+    return undefined;
+}
+//# sourceMappingURL=startGeneratedConfigSearchTargets.js.map

package/dist/core/startGeneratedConfigSearchTargets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startGeneratedConfigSearchTargets.js","sourceRoot":"","sources":["../../src/core/startGeneratedConfigSearchTargets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,MAAM,UAAU,iCAAiC,CAAC,OAAe;IAC/D,MAAM,eAAe,GAAG,OAAO,CAAC,KAAK,CACnC,+HAA+H,CAChI,CAAC;IACF,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,IAAI,aAAa,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,iBAAiB,CAAC;QACrE,IAAI,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,gBAAgB,CAAC;IACpE,CAAC;IACD,MAAM,aAAa,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,aAAa;QAAE,OAAO,aAAa,CAAC;IACxC,MAAM,sBAAsB,GAAG,OAAO,CAAC,KAAK,CAC1C,+GAA+G,CAChH,CAAC;IACF,IAAI,sBAAsB,EAAE,CAAC,CAAC,CAAC,IAAI,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC;QACxE,OAAO,GAAG,YAAY,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC;IACpE,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAChC,oIAAoI,CACrI,CAAC;IACF,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACnE,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/startGraphTargets.d.ts

@@ -0,0 +1,10 @@
+import type { GraphQueryDirection } from './graphQuery.js';
+export type StartGraphQuery = {
+    direction: GraphQueryDirection;
+    file?: string;
+    symbol?: string;
+    limit?: number;
+};
+export declare function graphQueryFromIntent(intent: string): StartGraphQuery | undefined;
+export declare function graphQueryIsReady(query: StartGraphQuery): boolean;
+export declare function semanticGraphCommand(query: StartGraphQuery): string;

package/dist/core/startGraphTargets.js

@@ -0,0 +1,82 @@
+import { extractFileTarget } from './startFileTargets.js';
+import { isPackageNameTarget, normalizePackageName } from './startPackageTargets.js';
+import { isPlaceholder, quoteShellArg } from './startShellArgs.js';
+import { extractSymbolTarget } from './startSymbolTargets.js';
+export function graphQueryFromIntent(intent) {
+    const file = extractFileTarget(intent);
+    const packageName = extractGraphPackageTarget(intent);
+    const symbol = extractSymbolTarget(intent);
+    const direction = graphDirectionFromIntent(intent);
+    return direction ? graphQueryForDirection(direction, { file, packageName, symbol }) : undefined;
+}
+function graphQueryForDirection(direction, target) {
+    if (['imports', 'exports', 'importers'].includes(direction) && target.file)
+        return { direction, file: target.file };
+    if (direction === 'package_importers' && target.packageName)
+        return { direction, symbol: target.packageName };
+    if (['symbol_defs', 'package_importers'].includes(direction) && target.symbol)
+        return { direction, symbol: target.symbol };
+    return { direction };
+}
+function graphDirectionFromIntent(intent) {
+    const text = intent.toLowerCase();
+    if (!extractFileTarget(intent) && packageImporterGraphIntent(text))
+        return 'package_importers';
+    return GRAPH_DIRECTION_RULES.find((rule) => rule.pattern.test(text))?.direction;
+}
+const GRAPH_DIRECTION_RULES = [
+    {
+        pattern: /\b(?:who|what|which)\s+(?:files\s+)?imports?\b|\bimporters\b/,
+        direction: 'importers',
+    },
+    { pattern: /\bexports?\b/, direction: 'exports' },
+    { pattern: /\bimports?\b/, direction: 'imports' },
+    { pattern: /\b(?:defined|definition|defines)\b/, direction: 'symbol_defs' },
+];
+function packageImporterGraphIntent(text) {
+    return [
+        /\b(?:who|what|which)\s+uses?\b/,
+        /\b(?:who|what|which)\s+depends?\s+on\b/,
+        /\bwhy\b.*\b(?:depend\s+on|depends\s+on|installed)\b/,
+        /\b(?:who|what|which)\s+(?:files\s+)?imports?\b/,
+    ].some((pattern) => pattern.test(text));
+}
+export function graphQueryIsReady(query) {
+    if (query.direction === 'imports' ||
+        query.direction === 'exports' ||
+        query.direction === 'importers') {
+        return typeof query.file === 'string' && !isPlaceholder(query.file);
+    }
+    if (query.direction === 'symbol_defs' || query.direction === 'package_importers') {
+        return typeof query.symbol === 'string' && !isPlaceholder(query.symbol);
+    }
+    return false;
+}
+export function semanticGraphCommand(query) {
+    const parts = ['projscan semantic-graph', '--query', query.direction];
+    if (query.file)
+        parts.push('--file', isPlaceholder(query.file) ? query.file : quoteShellArg(query.file));
+    if (query.symbol)
+        parts.push('--symbol', isPlaceholder(query.symbol) ? query.symbol : quoteShellArg(query.symbol));
+    if (typeof query.limit === 'number')
+        parts.push('--limit', String(query.limit));
+    parts.push('--format', 'json');
+    return parts.join(' ');
+}
+function extractGraphPackageTarget(intent) {
+    const compactIntent = intent.trim().replace(/[?!\s]+$/g, '');
+    const importMatch = compactIntent.match(/\b(?:who|what|which)\s+(?:files\s+)?imports?\s+(?:(?:package|dependency)\s+)?(@?[A-Za-z0-9][\w.-]*(?:\/[A-Za-z0-9][\w.-]*)?)\b/i);
+    if (importMatch?.[1] && isPackageNameTarget(importMatch[1]))
+        return normalizePackageName(importMatch[1]);
+    const useMatch = compactIntent.match(/\b(?:who|what|which)\s+uses?\s+(?:(?:package|dependency)\s+)?(@?[A-Za-z0-9][\w.-]*(?:\/[A-Za-z0-9][\w.-]*)?)\b/i);
+    if (useMatch?.[1] && isPackageNameTarget(useMatch[1]))
+        return normalizePackageName(useMatch[1]);
+    const dependsMatch = compactIntent.match(/\b(?:who|what|which|why(?:\s+do\s+we)?)\s+depends?\s+on\s+(?:(?:package|dependency)\s+)?(@?[A-Za-z0-9][\w.-]*(?:\/[A-Za-z0-9][\w.-]*)?)\b/i);
+    if (dependsMatch?.[1] && isPackageNameTarget(dependsMatch[1]))
+        return normalizePackageName(dependsMatch[1]);
+    const installedMatch = compactIntent.match(/\bwhy\s+is\s+(@?[A-Za-z0-9][\w.-]*(?:\/[A-Za-z0-9][\w.-]*)?)\s+installed\b/i);
+    if (installedMatch?.[1] && isPackageNameTarget(installedMatch[1]))
+        return normalizePackageName(installedMatch[1]);
+    return undefined;
+}
+//# sourceMappingURL=startGraphTargets.js.map

package/dist/core/startGraphTargets.js.map

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

package/dist/core/startHighPrioritySearchTargets.d.ts

@@ -0,0 +1 @@
+export declare function searchQueryFromHighPrioritySignals(trimmed: string): string | undefined;

package/dist/core/startHighPrioritySearchTargets.js

@@ -0,0 +1,24 @@
+import { extractEnvVarTarget } from './startEnvTargets.js';
+import { extractFileTarget } from './startFileTargets.js';
+import { unwrapTarget } from './startIntentTargetText.js';
+import { extractQuotedTextTarget } from './startQuotedTextTargets.js';
+export function searchQueryFromHighPrioritySignals(trimmed) {
+    const file = extractFileTarget(trimmed);
+    if (file && /\b(?:where|find|locate|search)\b/i.test(trimmed) && /\btests?\b/i.test(trimmed)) {
+        return `tests for ${file}`;
+    }
+    const envVar = extractEnvVarTarget(trimmed);
+    if (envVar && /\b(?:where|find|locate|search|lookup|used|referenced|process)\b/i.test(trimmed)) {
+        return envVar;
+    }
+    const envControl = trimmed.match(/\b(?:which|what|where|find|locate|search(?:\s+for)?|lookup)\s+(?:env(?:ironment)?\s+)?(?:var|vars|variable|variables)\s+(?:controls?|configures?|sets?|for)\s+(.+?)\s*[?!.]*$/i);
+    if (envControl?.[1])
+        return `${unwrapTarget(envControl[1].trim())} env var`;
+    const quotedDebugText = extractQuotedTextTarget(trimmed);
+    if (quotedDebugText &&
+        /\b(?:error|errors|message|messages|throws?|thrown|logs?|logged|logging)\b/i.test(trimmed)) {
+        return quotedDebugText;
+    }
+    return undefined;
+}
+//# sourceMappingURL=startHighPrioritySearchTargets.js.map

package/dist/core/startHighPrioritySearchTargets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startHighPrioritySearchTargets.js","sourceRoot":"","sources":["../../src/core/startHighPrioritySearchTargets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE,MAAM,UAAU,kCAAkC,CAAC,OAAe;IAChE,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,IAAI,IAAI,mCAAmC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7F,OAAO,aAAa,IAAI,EAAE,CAAC;IAC7B,CAAC;IACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,MAAM,IAAI,kEAAkE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/F,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAC9B,gLAAgL,CACjL,CAAC;IACF,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC;QAAE,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC;IAC5E,MAAM,eAAe,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACzD,IACE,eAAe;QACf,4EAA4E,CAAC,IAAI,CAAC,OAAO,CAAC,EAC1F,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/startImpactRouteCriteria.d.ts

@@ -0,0 +1,7 @@
+import type { PreflightSuggestedAction } from '../types/preflight.js';
+import type { StartRoutedIntent } from '../types/start.js';
+export interface ImpactSuccessCriteriaInput {
+    route?: StartRoutedIntent;
+    primaryAction?: PreflightSuggestedAction;
+}
+export declare function impactSuccessCriteria(context: ImpactSuccessCriteriaInput): string[] | undefined;

package/dist/core/startImpactRouteCriteria.js

@@ -0,0 +1,14 @@
+export function impactSuccessCriteria(context) {
+    if (context.route?.tool !== 'projscan_impact')
+        return undefined;
+    return [
+        ...(context.primaryAction?.tool === 'projscan_search'
+            ? [
+                'An exact symbol or file path is selected from search results before impact analysis continues.',
+            ]
+            : []),
+        'The impact report is reviewed for direct and transitive dependents before editing starts.',
+        'Affected call sites, tests, or owners are added to the workplan before code changes begin.',
+    ];
+}
+//# sourceMappingURL=startImpactRouteCriteria.js.map

package/dist/core/startImpactRouteCriteria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startImpactRouteCriteria.js","sourceRoot":"","sources":["../../src/core/startImpactRouteCriteria.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,qBAAqB,CACnC,OAAmC;IAEnC,IAAI,OAAO,CAAC,KAAK,EAAE,IAAI,KAAK,iBAAiB;QAAE,OAAO,SAAS,CAAC;IAChE,OAAO;QACL,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,KAAK,iBAAiB;YACnD,CAAC,CAAC;gBACE,gGAAgG;aACjG;YACH,CAAC,CAAC,EAAE,CAAC;QACP,2FAA2F;QAC3F,4FAA4F;KAC7F,CAAC;AACJ,CAAC"}

package/dist/core/startImpactTargets.d.ts

@@ -0,0 +1 @@
+export declare function extractImpactTarget(intent: string): string | undefined;

package/dist/core/startImpactTargets.js

@@ -0,0 +1,18 @@
+import { isGenericReferenceTarget, unwrapTarget } from './startIntentTargetText.js';
+export function extractImpactTarget(intent) {
+    const compactIntent = intent.trim().replace(/[?!.\s]+$/g, '');
+    const usageMatch = compactIntent.match(/\bwhere\s+(?:is|are)\s+[`'"]?([A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)?)[`'"]?\s+(?:used|referenced|called)\b/i);
+    if (usageMatch?.[1] && !isGenericReferenceTarget(usageMatch[1]))
+        return usageMatch[1];
+    const match = compactIntent.match(/\b(?:rename|change|modify|delete|remove)\s+(?:the\s+|a\s+|an\s+)?(.+)$/i);
+    const target = unwrapTarget((match?.[1] ?? '').trim());
+    if (target.length === 0)
+        return undefined;
+    const normalized = target
+        .replace(/\s+(?:in|from|inside)\s+(?:this\s+)?(?:repo|repository|codebase)$/i, '')
+        .trim();
+    if (isGenericReferenceTarget(normalized))
+        return undefined;
+    return normalized;
+}
+//# sourceMappingURL=startImpactTargets.js.map

package/dist/core/startImpactTargets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startImpactTargets.js","sourceRoot":"","sources":["../../src/core/startImpactTargets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAEpF,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CACpC,8GAA8G,CAC/G,CAAC;IACF,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;IAEtF,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAC/B,yEAAyE,CAC1E,CAAC;IACF,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,UAAU,GAAG,MAAM;SACtB,OAAO,CAAC,oEAAoE,EAAE,EAAE,CAAC;SACjF,IAAI,EAAE,CAAC;IACV,IAAI,wBAAwB,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3D,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/core/startIntentApiContractQueries.d.ts

@@ -0,0 +1 @@
+export declare function extractApiContractQuery(intent: string): string | undefined;

package/dist/core/startIntentApiContractQueries.js

@@ -0,0 +1,50 @@
+export function extractApiContractQuery(intent) {
+    const compactIntent = intent.trim().replace(/[?!.\s]+$/g, '');
+    return (fixedApiContractQuery(compactIntent) ??
+        apiContractFromRules(compactIntent) ??
+        graphQlSchemaQuery(compactIntent));
+}
+function fixedApiContractQuery(compactIntent) {
+    if (/\bopenapi\b/i.test(compactIntent) && /\bspecs?\b/i.test(compactIntent))
+        return 'OpenAPI spec';
+    if (/\bswagger\b/i.test(compactIntent) && /\bdocs?\b/i.test(compactIntent))
+        return 'Swagger docs';
+    return undefined;
+}
+const API_CONTRACT_RULES = [
+    {
+        pattern: /\b(?:where\s+(?:is|are)|find|locate|search(?:\s+for)?|lookup)\s+(?:the\s+)?trpc\s+routers?\s+(?:for|of|on|in)\s+(.+?)$/i,
+        suffix: 'tRPC router',
+    },
+    {
+        pattern: /\b(?:which|what)\s+graphql\s+resolvers?\s+(?:handles?|for|of)\s+(.+?)$/i,
+        suffix: 'GraphQL resolver',
+    },
+    { pattern: /\b(?:which|what)\s+(?:protobuf|proto)\s+defines?\s+(.+?)$/i, suffix: 'protobuf' },
+    {
+        pattern: /\b(?:where\s+(?:is|are)|find|locate|search(?:\s+for)?|lookup)\s+(?:the\s+)?grpc\s+clients?\s+(?:for|of|on|in)\s+(.+?)$/i,
+        suffix: 'gRPC client',
+    },
+];
+function apiContractFromRules(compactIntent) {
+    for (const rule of API_CONTRACT_RULES) {
+        const match = compactIntent.match(rule.pattern);
+        if (match?.[1])
+            return `${unwrapTarget(match[1].trim())} ${rule.suffix}`;
+    }
+    return undefined;
+}
+function graphQlSchemaQuery(compactIntent) {
+    const graphqlSchema = compactIntent.match(/\b(?:where\s+(?:is|are)|find|locate|search(?:\s+for)?|lookup)\s+(?:the\s+)?graphql\s+schemas?\s*(?:for|of)?\s*(.*?)$/i);
+    if (graphqlSchema) {
+        const target = unwrapTarget((graphqlSchema[1] ?? '').trim());
+        return target ? `${target} GraphQL schema` : 'GraphQL schema';
+    }
+    return undefined;
+}
+function unwrapTarget(value) {
+    const trimmed = value.trim();
+    const wrapped = trimmed.match(/^([`'"])(.+)\1$/);
+    return (wrapped?.[2] ?? trimmed).trim();
+}
+//# sourceMappingURL=startIntentApiContractQueries.js.map

package/dist/core/startIntentApiContractQueries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startIntentApiContractQueries.js","sourceRoot":"","sources":["../../src/core/startIntentApiContractQueries.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC9D,OAAO,CACL,qBAAqB,CAAC,aAAa,CAAC;QACpC,oBAAoB,CAAC,aAAa,CAAC;QACnC,kBAAkB,CAAC,aAAa,CAAC,CAClC,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,aAAqB;IAClD,IAAI,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC;QACzE,OAAO,cAAc,CAAC;IACxB,IAAI,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC;QAAE,OAAO,cAAc,CAAC;IAClG,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,kBAAkB,GAA+C;IACrE;QACE,OAAO,EACL,yHAAyH;QAC3H,MAAM,EAAE,aAAa;KACtB;IACD;QACE,OAAO,EAAE,yEAAyE;QAClF,MAAM,EAAE,kBAAkB;KAC3B;IACD,EAAE,OAAO,EAAE,4DAA4D,EAAE,MAAM,EAAE,UAAU,EAAE;IAC7F;QACE,OAAO,EACL,yHAAyH;QAC3H,MAAM,EAAE,aAAa;KACtB;CACF,CAAC;AAEF,SAAS,oBAAoB,CAAC,aAAqB;IACjD,KAAK,MAAM,IAAI,IAAI,kBAAkB,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;IAC3E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,kBAAkB,CAAC,aAAqB;IAC/C,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CACvC,uHAAuH,CACxH,CAAC;IACF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,iBAAiB,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAChE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACjD,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1C,CAAC"}

package/dist/core/startIntentAuthorizationQueries.d.ts

@@ -0,0 +1 @@
+export declare function extractAuthorizationQuery(intent: string): string | undefined;