@theihtisham/agent-shadow-brain 7.0.0 → 7.1.0

package/dist/brain/task-workflow.js

@@ -0,0 +1,182 @@
+const TRANSFORMATION = /^(?:(?:please|just)\s+)*(?:translate|rewrite|rephrase|summarize|summarise|proofread|format|capitalize|convert|shorten)\b/;
+const SMALL_EDIT = /^(?:(?:please|just)\s+)*(?:fix|correct)\s+(?:this|the|a|one)\s+(?:typo|spelling|punctuation|grammar in (?:this|the) (?:sentence|text|paragraph))\b/;
+const EXPLANATION = /^(?:(?:please|just)\s+)*(?:what (?:does|is|are|means?)|why does|how (?:does|do i|can i|to)|explain|define)\b/;
+const ENGINEERING_SCOPE = /\b(?:api|backend|frontend|service|application|database|codebase|repository|entire project)\b/;
+const DIAGNOSIS_ONLY = /\b(?:analy[sz]e|analysis|diagnose|diagnosis|investigate|inspection) only\b/;
+const PLAN_ONLY = /\b(?:plan only|only plan|just plan|planning only|just (?:write|make|draft|give|provide)?\s*(?:me )?a plan|do not execute|don['’]t execute|without executing)\b/;
+const ASK_FOR_PLAN = /^(?:(?:please|just)\s+)*(?:plan\b|outline\b|(?:make|create|draft|write|provide|give)\s+(?:me\s+)?(?:a\s+)?(?:\w+\s+){0,2}(?:plan|roadmap)\b)/;
+const PLAN_THEN_EXECUTE = /\b(?:plan|outline)\b[^.!?\n]{0,120}(?:[.!?\n]\s*then|\b(?:then|and))\s+(?:(?:actually|also|then)\s+)?(?:implement|execute|fix|build|repair|apply|ship|deploy|publish)\b/;
+const NO_EDITS = /\b(?:(?:do not|don['’]t|never|without|no)\s+(?:make\s+)?(?:chang(?:e|es|ing)|edit(?:s|ing)?|modify(?:ing)?|mutat(?:e|ion|ing)?|implement(?:ing)?|write|writing)|read[- ]only|leave (?:the files|everything) unchanged)\b/;
+const REVIEW_REQUEST = /\b(?:review|audit|inspect|assess)\s+(?:this|the|my|our|these|a|an|changes|code|pr|pull request|patch|diff|repo(?:sitory)?|for)\b|^(?:please\s+)?(?:review|audit)\b/;
+const RESEARCH_REQUEST = /\b(?:research|look up|find out|compare)\b|\b(?:which|what)\b[^.!?\n]{0,100}\b(?:current|latest|supports?|available|official)\b/;
+const DEBUG_REQUEST = /\b(?:debug|diagnose|diagnosis|troubleshoot|reproduce|regression|broken|failing|fails|failure|crash(?:es|ing)?|error|bug|repair)\b/;
+const DIAGNOSIS_REQUEST = /^(?:(?:please|just)\s+)*(?:diagnose|investigate|analy[sz]e|identify the cause|find out why)\b/;
+const IMPLEMENT_REQUEST = /\b(?:build|implement|add|create|write|update|modify|refactor|integrate|migrate|migration|change|fix|edit|improve|rewrite|convert)\b/;
+const RELEASE_REQUEST = /\b(?:release (?:checklist|plan|package|artifact|notes|preparation)|(?:prepare|stage|cut|make|create)\b[^.!?\n]{0,80}\b(?:release|artifact)|package (?:the|this|our) (?:release|project|artifact|build|application)|(?:publish|deploy|ship|push|tag)\b[^.!?\n]{0,80}\b(?:npm|production|artifact|package|release|repository|repo\b|github|version|build|live)|(?:publish|deploy)\b)/;
+const COMPLEX_REQUEST = /\b(?:migration|migrate|rollout|production|architecture|cross[- ](?:service|project|platform)|multiple (?:components|services|projects|files)|across (?:the )?(?:api|ui|backend|frontend|services|projects)|(?:api|backend)\s+(?:and|plus)\s+(?:ui|frontend)|end[- ]to[- ]end|from scratch|multi[- ]step)\b/;
+const NEGATIVE_CLAUSE = /\b(?:do not|don['’]t|never|without|avoid|no)\s+[^.!?;,\n]*?(?=\s+(?:but|then|however)\b|[.!?;,\n]|$)/g;
+const RELEASE_CHECKLIST = /\brelease (?:checklist|roadmap|plan)\b/;
+function requestedAction(phrase) {
+    return new RegExp('(?:^|[.;!?\\n]|\\b(?:and|then|also|but|please|can you|could you|would you)\\s+)\\s*(?:' + phrase + ')\\b');
+}
+const REQUESTED_EDIT = requestedAction('fix|implement|repair|patch|apply|edit|update|change|modify');
+const SIDE_EFFECTS = [
+    ['publish', requestedAction('publish|push\\s+(?:it|to|the|this|our)|upload\\b[^.!?\\n]{0,65}\\b(?:npm|github|repository)')],
+    ['deploy', requestedAction('deploy|roll out')],
+    ['destructive-change', requestedAction('force[- ]push|(?:delete|drop|purge|erase|wipe|remove)\\s+(?:all\\s+|the\\s+|our\\s+|a\\s+)*(?:production|database|accounts?|repositories|repository|backups?|customer data)')],
+    ['send-external-message', requestedAction('send\\s+(?:an?\\s+|the\\s+|this\\s+)?(?:message|email|notice)|email\\s+(?:our|the|all)|notify\\s+(?:our|the|all)')],
+    ['spend-money', requestedAction('purchase|buy|place (?:an?|the) order|subscribe to')],
+];
+function actionText(request) {
+    return request
+        .replace(/\x60{3}[\s\S]*?(?:\x60{3}|$)|\x60[^\x60\n]*\x60|“[^”\n]*”|"[^"\n]*"|(^|\s)'[^'\n]*'(?=\s|[.!?,;]|$)/g, ' ')
+        .toLowerCase()
+        .trim();
+}
+function step(id, title, completion) {
+    return { id, title, completion };
+}
+function buildSteps(taskType, mode, mayEdit, external) {
+    if (mode === 'plan-only') {
+        return [
+            step('inspect', 'Inspect the relevant context', 'Identify the requested outcome, constraints, and current state using available evidence.'),
+            step('plan', 'Write the requested plan', 'Describe the proposed actions and verification, then stop at the plan.'),
+        ];
+    }
+    const steps = [];
+    if (mode === 'plan-then-execute') {
+        steps.push(step('plan', 'Plan the scoped work', 'Identify dependencies, material risks, and how to verify the requested outcome.'));
+    }
+    switch (taskType) {
+        case 'direct':
+            steps.push(step('respond', 'Complete the request', 'Return the requested result in the requested format.'));
+            break;
+        case 'implement':
+            steps.push(step('inspect', 'Inspect the relevant code and constraints', 'Identify existing behavior and the acceptance criteria for the change.'));
+            if (mayEdit) {
+                steps.push(step('implement', 'Implement the scoped change', 'Deliver the requested behavior through its normal entry points.'), step('verify', 'Verify the affected behavior', 'Check the result against the request and report any remaining gap.'));
+            }
+            break;
+        case 'debug':
+            steps.push(step('reproduce', 'Reproduce or isolate the failure', 'Identify the failing behavior and the evidence for its cause.'));
+            if (mayEdit) {
+                steps.push(step('fix', 'Fix the isolated cause', 'Make the smallest change that resolves the requested failure.'), step('verify', 'Verify the original failure', 'Repeat the failing path and check the related behavior for regressions.'));
+            }
+            else {
+                steps.push(step('diagnosis', 'Report the diagnosis', 'State the cause supported by the evidence and any remaining uncertainty.'));
+            }
+            break;
+        case 'review':
+            steps.push(step('review', 'Review the requested scope', 'Inspect the relevant changes and prioritize actionable findings with evidence.'));
+            if (mayEdit) {
+                steps.push(step('fix', 'Fix the requested findings', 'Apply scoped changes for findings the user asked to fix.'), step('verify', 'Verify the fixes', 'Confirm the observed problems are resolved in the affected paths.'));
+            }
+            steps.push(step('findings', 'Report the review findings', 'Give evidence and locations for actionable findings, with remaining verification gaps.'));
+            break;
+        case 'research':
+            steps.push(step('sources', 'Check the relevant sources', 'Use available primary evidence and identify gaps or conflicting information.'), step('answer', 'Answer the research question', 'State what the evidence supports and identify material uncertainty.'));
+            break;
+        case 'release':
+            steps.push(step('artifact', 'Prepare and verify the release artifact', 'Confirm version, artifact identity, destination when specified, and relevant checks.'));
+            if (external.some(action => action === 'publish' || action === 'deploy')) {
+                steps.push(step('release', 'Carry out the authorized release action', 'Use the intended destination and the verified artifact with existing authorization.'), step('verify', 'Verify the destination independently', 'Confirm the actual remote version, artifact, or deployed result.'));
+            }
+            else {
+                steps.push(step('report', 'Report the release preparation', 'Provide the requested checklist or release materials and any remaining dependencies.'));
+            }
+            break;
+    }
+    return steps;
+}
+/** Return advisory routing based on the request and explicit options. */
+export function analyzeTask(request, options = {}) {
+    if (typeof request !== 'string' || !request.trim())
+        throw new TypeError('A nonempty task request is required.');
+    const { mode = 'auto', taskType: selectedType = 'auto', complexity = 'auto' } = options;
+    if (!['auto', 'plan-only', 'execute'].includes(mode))
+        throw new TypeError('Unknown workflow mode.');
+    if (!['auto', 'implement', 'debug', 'review', 'research', 'release'].includes(selectedType)) {
+        throw new TypeError('Unknown workflow task type.');
+    }
+    if (!['auto', 'simple', 'complex'].includes(complexity))
+        throw new TypeError('Unknown workflow complexity.');
+    const text = actionText(request);
+    const positive = text.replace(NEGATIVE_CLAUSE, ' ');
+    const noEdits = NO_EDITS.test(text) || DIAGNOSIS_ONLY.test(text) || /\bno (?:code|file|source) changes\b/.test(text);
+    const explicitPlan = PLAN_ONLY.test(text);
+    const thenExecute = PLAN_THEN_EXECUTE.test(positive);
+    const planRequested = ASK_FOR_PLAN.test(text) || RELEASE_CHECKLIST.test(text);
+    const planOnly = mode === 'plan-only' || explicitPlan || (planRequested && noEdits) ||
+        (mode === 'auto' && !thenExecute && planRequested);
+    const engineeringTransform = TRANSFORMATION.test(text) && ENGINEERING_SCOPE.test(text);
+    const directRequest = SMALL_EDIT.test(text) || (TRANSFORMATION.test(text) && !engineeringTransform) ||
+        (EXPLANATION.test(text) && !RESEARCH_REQUEST.test(text));
+    let taskType;
+    const reasons = [];
+    if (selectedType !== 'auto') {
+        taskType = selectedType;
+        reasons.push('The task type was selected explicitly.');
+    }
+    else if (directRequest) {
+        taskType = 'direct';
+        reasons.push('The request is a direct answer or small transformation.');
+    }
+    else if (REVIEW_REQUEST.test(positive)) {
+        taskType = 'review';
+        reasons.push('The request asks for findings from a review.');
+    }
+    else if (RESEARCH_REQUEST.test(positive)) {
+        taskType = 'research';
+        reasons.push('The request asks for source-based information or comparison.');
+    }
+    else if (RELEASE_REQUEST.test(positive)) {
+        taskType = 'release';
+        reasons.push('The request concerns release preparation or delivery.');
+    }
+    else if (DEBUG_REQUEST.test(positive)) {
+        taskType = 'debug';
+        reasons.push('The request identifies a failure or regression.');
+    }
+    else if (IMPLEMENT_REQUEST.test(positive) || thenExecute) {
+        taskType = 'implement';
+        reasons.push('The request asks for a scoped implementation.');
+    }
+    else {
+        taskType = 'direct';
+        reasons.push('The request has no clear specialized workflow cue.');
+    }
+    if (noEdits)
+        reasons.push('The request limits the work to inspection.');
+    const complex = complexity === 'complex' ||
+        (complexity === 'auto' && taskType !== 'direct' &&
+            (taskType === 'release' || engineeringTransform || COMPLEX_REQUEST.test(positive)));
+    const resultMode = planOnly ? 'plan-only' : thenExecute || complex ? 'plan-then-execute' : 'direct';
+    if (planOnly)
+        reasons.push('The workflow stops after planning.');
+    else if (thenExecute)
+        reasons.push('The request explicitly asks to plan and then act.');
+    else if (complex)
+        reasons.push('The scope benefits from a short plan before work starts.');
+    const requestedEdit = REQUESTED_EDIT.test(positive);
+    const mayEdit = !noEdits && (taskType !== 'review' || requestedEdit) &&
+        (taskType !== 'debug' || !DIAGNOSIS_REQUEST.test(positive) || requestedEdit);
+    const sideEffects = planOnly || noEdits || taskType === 'research' || (taskType === 'review' && !mayEdit) || directRequest
+        ? []
+        : SIDE_EFFECTS.filter(([, pattern]) => pattern.test(positive)).map(([id]) => id);
+    const skills = taskType === 'direct'
+        ? (resultMode === 'direct' ? [] : ['shadow-workflow'])
+        : ['shadow-workflow', 'shadow-' + taskType];
+    return {
+        taskType,
+        mode: resultMode,
+        skills,
+        steps: buildSteps(taskType, resultMode, mayEdit, sideEffects),
+        reasons,
+        requiresAuthorization: sideEffects,
+        limitations: [
+            'Routing uses English request cues and explicit options.',
+            'The host performs the suggested work and checks authorization already present in the conversation.',
+        ],
+    };
+}
+//# sourceMappingURL=task-workflow.js.map

package/dist/brain/task-workflow.js.map

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

package/dist/brain/workflow-skills.d.ts

@@ -0,0 +1,86 @@
+export declare const WORKFLOW_TARGETS: Readonly<{
+    readonly codex: Readonly<{
+        skillRoot: ".agents/skills";
+        instructionFile: "AGENTS.md";
+    }>;
+    readonly 'claude-code': Readonly<{
+        skillRoot: ".claude/skills";
+        instructionFile: "CLAUDE.md";
+    }>;
+    readonly opencode: Readonly<{
+        skillRoot: ".opencode/skills";
+        instructionFile: "AGENTS.md";
+    }>;
+    readonly 'deepseek-harness': Readonly<{
+        skillRoot: ".dsh/skills";
+        instructionFile: "AGENTS.md";
+    }>;
+    readonly portable: Readonly<{
+        skillRoot: ".agents/skills";
+        instructionFile: "AGENTS.md";
+    }>;
+}>;
+export type WorkflowTarget = keyof typeof WORKFLOW_TARGETS;
+export interface BundledWorkflowSkill {
+    name: string;
+    description: string;
+}
+export interface SkillInstallOptions {
+    projectDir: string;
+    targets: WorkflowTarget[];
+    skills?: string[];
+}
+export interface SkillInstallFile {
+    path: string;
+    relativePath: string;
+    kind: 'skill' | 'instructions' | 'manifest';
+    action: 'create' | 'update' | 'unchanged' | 'conflict';
+    beforeSha256: string | null;
+    afterSha256: string | null;
+    content: string;
+    reason?: string;
+}
+export interface SkillInstallPlan {
+    projectDir: string;
+    targets: WorkflowTarget[];
+    skills: string[];
+    files: SkillInstallFile[];
+    warnings: string[];
+}
+export interface SkillInstallResult {
+    projectDir: string;
+    created: string[];
+    updated: string[];
+    unchanged: string[];
+    backupDir: string | null;
+}
+export declare function listWorkflowTargets(): ({
+    skillRoot: ".agents/skills";
+    instructionFile: "AGENTS.md";
+    target: "claude-code" | "opencode" | "codex" | "deepseek-harness" | "portable";
+} | {
+    skillRoot: ".claude/skills";
+    instructionFile: "CLAUDE.md";
+    target: "claude-code" | "opencode" | "codex" | "deepseek-harness" | "portable";
+} | {
+    skillRoot: ".opencode/skills";
+    instructionFile: "AGENTS.md";
+    target: "claude-code" | "opencode" | "codex" | "deepseek-harness" | "portable";
+} | {
+    skillRoot: ".dsh/skills";
+    instructionFile: "AGENTS.md";
+    target: "claude-code" | "opencode" | "codex" | "deepseek-harness" | "portable";
+} | {
+    skillRoot: ".agents/skills";
+    instructionFile: "AGENTS.md";
+    target: "claude-code" | "opencode" | "codex" | "deepseek-harness" | "portable";
+})[];
+export declare function getBundledSkill(name: string): BundledWorkflowSkill & {
+    content: string;
+};
+export declare function listBundledSkills(): BundledWorkflowSkill[];
+/** Inspect the requested project and compute a preview without making filesystem changes. */
+export declare function planSkillInstall(options: SkillInstallOptions): SkillInstallPlan;
+/** Apply a still-current preview. Existing edited or unowned files are preserved. */
+export declare function applySkillInstall(plan: SkillInstallPlan): SkillInstallResult;
+//# sourceMappingURL=workflow-skills.d.ts.map

package/dist/brain/workflow-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-skills.d.ts","sourceRoot":"","sources":["../../src/brain/workflow-skills.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAMlB,CAAC;AAEZ,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,UAAU,CAAC;IAC5C,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IACvD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAuBD,wBAAgB,mBAAmB;;;;;;;;;;;;;;;;;;;;KAElC;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAQxF;AAED,wBAAgB,iBAAiB,IAAI,oBAAoB,EAAE,CAK1D;AA6MD,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,gBAAgB,CAmE/E;AA6HD,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,kBAAkB,CA2D5E"}