fraim 2.0.362-next.4 → 2.0.362

package/dist/registry/stubs/jobs/ai-manager/management/hire-right-ai-for-the-job.md

@@ -0,0 +1,29 @@
+<!-- FRAIM_DISCOVERY_STUB -->
+
+# FRAIM Job: hire-right-ai-for-the-job
+
+## Intent
+Analyze a task request, route it to the right tool based on modality + difficulty + frequency, and produce concrete provisioning steps for the chosen tool within the project environment.
+
+## Outcome
+- **Recommendation Artifact**: `docs/hiring/recommendation.md` with the modality classification, difficulty classification, a top-3 tool stack-rank with pricing + free-tier context, and copy-pasteable provisioning steps for the selected choice.
+
+## Steps
+1. Phase 1: `analyze-request`
+2. Phase 2: `recommend-ais`
+3. Phase 3: `provide-hiring-instructions`
+4. Phase 4: `submit`
+5. Phase 5: `address-feedback`
+6. Phase 6: `retrospective`
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** Do NOT attempt to execute this job based on the Intent/Outcome above.
+> This stub is for discoverability only. The actual job has multiple phases with
+> detailed steps, validation criteria, and required skills.
+>
+> To get full phase-by-phase instructions, call:
+> `get_fraim_job({ job: "hire-right-ai-for-the-job" })`
+>
+> Then follow all phases using `seekMentoring` at each phase transition.

package/dist/registry/stubs/jobs/ai-manager/management/hire-the-right-human-ai-manager.md

@@ -0,0 +1,29 @@
+<!-- FRAIM_DISCOVERY_STUB -->
+
+# FRAIM Job: hire-the-right-human-ai-manager
+
+## Intent
+Hire the right human to manage a given AI employee.
+
+## Outcome
+- `docs/hiring/human-ai-manager-{role}-{YYYY-MM-DD}.md` with the role brief, the job description, and a candidate shortlist captured from the hiring services the user chose.
+
+## Steps
+1. Phase 1: `gather-requirements`
+2. Phase 2: `draft-jd`
+3. Phase 3: `search-and-shortlist`
+4. Phase 4: `submit`
+5. Phase 5: `address-feedback`
+6. Phase 6: `retrospective`
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** Do NOT attempt to execute this job based on the Intent/Outcome above.
+> This stub is for discoverability only. The actual job has multiple phases with
+> detailed steps, validation criteria, and required skills.
+>
+> To get full phase-by-phase instructions, call:
+> `get_fraim_job({ job: "hire-the-right-human-ai-manager" })`
+>
+> Then follow all phases using `seekMentoring` at each phase transition.

package/dist/registry/stubs/jobs/ai-manager/management/how-should-i-verify.md

@@ -0,0 +1,32 @@
+<!-- FRAIM_DISCOVERY_STUB -->
+
+# FRAIM Job: how-should-i-verify
+
+## Intent
+Help the manager decide which verification method best fits the agent's work, then give the user exact steps to verify the work correctly.
+
+## Outcome
+- The work claim is classified clearly enough to choose the right proof method.
+- One of a small set of standard verification methods is selected with explicit rationale.
+- The user receives an exact verification brief and, when evidence already exists, a judgment on whether that evidence is strong enough.
+
+## Steps
+1. Phase 1: `understand-work-claim`
+2. Phase 2: `choose-verification-method`
+3. Phase 3: `write-user-verification-brief`
+4. Phase 4: `assess-evidence`
+5. Phase 5: `submit`
+6. Phase 6: `address-feedback`
+7. Phase 7: `retrospective`
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** Do NOT attempt to execute this job based on the Intent/Outcome above.
+> This stub is for discoverability only. The actual job has multiple phases with
+> detailed steps, validation criteria, and required skills.
+>
+> To get full phase-by-phase instructions, call:
+> `get_fraim_job({ job: "how-should-i-verify" })`
+>
+> Then follow all phases using `seekMentoring` at each phase transition.

package/dist/registry/stubs/jobs/ai-manager/management/need-pov.md

@@ -0,0 +1,30 @@
+<!-- FRAIM_DISCOVERY_STUB -->
+
+# FRAIM Job: need-pov
+
+## Intent
+Return with a clear point of view when the user has no strong preference and wants recommendation before execution.
+
+## Outcome
+- Options are analyzed against context and constraints
+- Trade-offs are presented clearly
+- A recommendation is made with rationale
+- User decision is captured before implementation
+
+## Steps
+1. Phase 1: `listen`
+2. Phase 2: `execute`
+3. Phase 3: `document-learnings`
+4. Phase 4: `submit`
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** Do NOT attempt to execute this job based on the Intent/Outcome above.
+> This stub is for discoverability only. The actual job has multiple phases with
+> detailed steps, validation criteria, and required skills.
+>
+> To get full phase-by-phase instructions, call:
+> `get_fraim_job({ job: "need-pov" })`
+>
+> Then follow all phases using `seekMentoring` at each phase transition.

package/dist/registry/stubs/jobs/ai-manager/management/recognize-good-work.md

@@ -0,0 +1,29 @@
+<!-- FRAIM_DISCOVERY_STUB -->
+
+# FRAIM Job: recognize-good-work
+
+## Intent
+Perform a concise, evidence-based recognition of an unusual-but-correct agent decision so the validating principle is captured as a durable learning and is reproducible going forward. Mirror counterpart to `analyze-why-you-messed-up`.
+
+## Outcome
+- The validated decision is acknowledged with concrete evidence
+- The root strength (durable judgment, not surface symptom) is identified
+- A reproduction trigger is defined
+- Learning is recorded for future synthesis into validated-patterns
+
+## Steps
+1. Phase 1: `analyze-success`
+2. Phase 2: `document-learnings`
+3. Phase 3: `reinforce-it`
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** Do NOT attempt to execute this job based on the Intent/Outcome above.
+> This stub is for discoverability only. The actual job has multiple phases with
+> detailed steps, validation criteria, and required skills.
+>
+> To get full phase-by-phase instructions, call:
+> `get_fraim_job({ job: "recognize-good-work" })`
+>
+> Then follow all phases using `seekMentoring` at each phase transition.

package/dist/registry/stubs/jobs/ai-manager/management/refine-core-values.md

@@ -0,0 +1,29 @@
+<!-- FRAIM_DISCOVERY_STUB -->
+
+# FRAIM Job: refine-core-values
+
+## Intent
+Adjust the AI employee rule set so behavior matches manager priorities, risk tolerance, and quality standards for this repository.
+
+## Outcome
+- Updated or new rule overrides under `fraim/personalized-employee/rules/`.
+- Each rule change has explicit rationale and expected behavioral effect.
+- No edits outside explicitly approved rule scope.
+
+## Steps
+1. Phase 1: `refine-core-values`
+2. Phase 2: `submit`
+3. Phase 3: `address-feedback`
+4. Phase 4: `retrospective`
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** Do NOT attempt to execute this job based on the Intent/Outcome above.
+> This stub is for discoverability only. The actual job has multiple phases with
+> detailed steps, validation criteria, and required skills.
+>
+> To get full phase-by-phase instructions, call:
+> `get_fraim_job({ job: "refine-core-values" })`
+>
+> Then follow all phases using `seekMentoring` at each phase transition.

package/dist/registry/stubs/jobs/ai-manager/management/shape-team.md

@@ -0,0 +1,30 @@
+<!-- FRAIM_DISCOVERY_STUB -->
+
+# FRAIM Job: shape-team
+
+## Intent
+Decide what kinds of employee capabilities this repo needs and when specialized support is worth creating.
+
+## Outcome
+- A scoped team plan covering important domains, when to use specialized employees, and what reusable capability gaps should be hardened next.
+- A distinction between planning work (`shape-team`) and execution work (`evolve-employee`).
+
+## Steps
+1. Phase 1: `analyze-work-profile`
+2. Phase 2: `map-required-capabilities`
+3. Phase 3: `confirm-team-shape`
+4. Phase 4: `submit`
+5. Phase 5: `address-feedback`
+6. Phase 6: `retrospective`
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** Do NOT attempt to execute this job based on the Intent/Outcome above.
+> This stub is for discoverability only. The actual job has multiple phases with
+> detailed steps, validation criteria, and required skills.
+>
+> To get full phase-by-phase instructions, call:
+> `get_fraim_job({ job: "shape-team" })`
+>
+> Then follow all phases using `seekMentoring` at each phase transition.

package/dist/registry/stubs/jobs/ai-manager/management/strong-pov.md

@@ -0,0 +1,30 @@
+<!-- FRAIM_DISCOVERY_STUB -->
+
+# FRAIM Job: strong-pov
+
+## Intent
+Execute exactly to explicit user direction when the user has high confidence in a specific approach.
+
+## Outcome
+- User direction is applied without unsolicited alternatives
+- Execution remains within stated constraints
+- Final result and rationale are communicated
+- Preference pattern is logged
+
+## Steps
+1. Phase 1: `listen`
+2. Phase 2: `execute`
+3. Phase 3: `document-learnings`
+4. Phase 4: `submit`
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** Do NOT attempt to execute this job based on the Intent/Outcome above.
+> This stub is for discoverability only. The actual job has multiple phases with
+> detailed steps, validation criteria, and required skills.
+>
+> To get full phase-by-phase instructions, call:
+> `get_fraim_job({ job: "strong-pov" })`
+>
+> Then follow all phases using `seekMentoring` at each phase transition.

package/dist/registry/stubs/jobs/ai-manager/management/weak-pov.md

@@ -0,0 +1,30 @@
+<!-- FRAIM_DISCOVERY_STUB -->
+
+# FRAIM Job: weak-pov
+
+## Intent
+Evaluate a user preference that is suggestive, not mandatory, and return with a recommendation.
+
+## Outcome
+- Suggested path is evaluated alongside alternatives
+- Trade-offs and recommendation are shared clearly
+- User chooses direction after analysis
+- Collaboration preference is logged
+
+## Steps
+1. Phase 1: `listen`
+2. Phase 2: `execute`
+3. Phase 3: `document-learnings`
+4. Phase 4: `submit`
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** Do NOT attempt to execute this job based on the Intent/Outcome above.
+> This stub is for discoverability only. The actual job has multiple phases with
+> detailed steps, validation criteria, and required skills.
+>
+> To get full phase-by-phase instructions, call:
+> `get_fraim_job({ job: "weak-pov" })`
+>
+> Then follow all phases using `seekMentoring` at each phase transition.

package/dist/registry/stubs/jobs/ai-manager/management/what-should-i-review.md

@@ -0,0 +1,34 @@
+<!-- FRAIM_DISCOVERY_STUB -->
+
+# FRAIM Job: what-should-i-review
+
+## Intent
+Help a manager efficiently process their PR queue by analyzing each PR against its linked issue requirements, detecting risks with confidence-scored action items, and prioritizing across the queue so the manager knows exactly where to focus their review time.
+
+## Outcome
+- **Queue Triage**: All open PRs classified as Quick Approve / Focused Review / Deep Review.
+- **Per-PR Briefing**: Summary, ranked action items (file/line, risk, confidence), spec coverage.
+- **Reviewer Time Savings**: Manager knows which PRs to skim, which need focused attention, and which require deep review.
+- **Deliverable**: The complete review briefing.
+
+## Steps
+1. Phase 1: `queue-intake`
+2. Phase 2: `spec-and-context-loading`
+3. Phase 3: `per-pr-review`
+4. Phase 4: `queue-triage`
+5. Phase 5: `briefing-and-submission`
+6. Phase 6: `submit`
+7. Phase 7: `address-feedback`
+8. Phase 8: `retrospective`
+
+---
+
+> [!IMPORTANT]
+> **For AI Agents:** Do NOT attempt to execute this job based on the Intent/Outcome above.
+> This stub is for discoverability only. The actual job has multiple phases with
+> detailed steps, validation criteria, and required skills.
+>
+> To get full phase-by-phase instructions, call:
+> `get_fraim_job({ job: "what-should-i-review" })`
+>
+> Then follow all phases using `seekMentoring` at each phase transition.

package/dist/src/cli/utils/remote-sync.js

@@ -228,13 +228,6 @@ async function syncTypedFilesToUserDir(files, type, subdir, label) {
  * Extracted from syncFromRemote so it can run without a project root.
  */
 async function syncScriptsToUserDir(files) {
-    const catalog = files.find(file => file.type === 'config' && file.path === 'domains.json');
-    if (catalog) {
-        // Only this known root artifact is accepted; never clean the user root.
-        JSON.parse(catalog.content);
-        (0, fs_1.mkdirSync)((0, script_sync_utils_1.getUserFraimDir)(), { recursive: true });
-        (0, fs_1.writeFileSync)((0, path_1.join)((0, script_sync_utils_1.getUserFraimDir)(), 'domains.json'), catalog.content, 'utf8');
-    }
     return syncTypedFilesToUserDir(files, 'script', 'scripts', 'script');
 }
 /**

package/dist/src/cli/utils/script-sync-utils.js

@@ -105,10 +105,6 @@ function copyScriptToUserDirectory(sourcePath, registryScriptsPath) {
  */
 function syncScriptsToUserDirectory(registryPath) {
     ensureUserFraimDirectories();
-    const domainCatalog = path_1.default.join(registryPath, 'domains.json');
-    if (fs_1.default.existsSync(domainCatalog)) {
-        fs_1.default.copyFileSync(domainCatalog, path_1.default.join(getUserFraimDir(), 'domains.json'));
-    }
     const registryScriptsPath = path_1.default.join(registryPath, 'scripts');
     const allScripts = getRegistryScripts(registryPath);
     let syncedCount = 0;

package/dist/src/config/learning-domains.js

@@ -1,35 +1,28 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.jobCategoryFromRegistryPath = exports.STORED_LEARNING_DOMAINS = exports.HISTORICAL_LEARNING_DOMAINS = exports.LEARNING_DOMAINS = exports.LEARNING_DOMAIN_MAP_VERSION = void 0;
 exports.isLearningDomain = isLearningDomain;
 exports.resolveJobDomain = resolveJobDomain;
 exports.resolveDomainForJob = resolveDomainForJob;
-/** Learning domains use the same folder authority as rule delivery. */
-const catalog_1 = require("../../registry/scripts/domains/catalog");
-let catalog = { schemaVersion: 2, mapVersion: 0, domains: {} };
-try {
-    const candidate = require('../../registry/domains.json');
-    if (candidate?.schemaVersion !== 2 || !candidate.domains || typeof candidate.domains !== 'object' || Array.isArray(candidate.domains))
-        throw new Error('Invalid domain catalog');
-    catalog = candidate;
-}
-catch {
-    console.warn('Learning domains unavailable: restore or sync registry/domains.json, then refresh instructions. Global learning files remain available.');
-}
-exports.LEARNING_DOMAIN_MAP_VERSION = catalog.mapVersion;
-exports.LEARNING_DOMAINS = Object.freeze(Object.keys(catalog.domains).filter(domain => domain !== 'global'));
-/** Retired storage names remain readable/editable; never use these as current job domains. */
+/** Job folders own domain identity; no parallel JSON mapping. */
+const node_path_1 = __importDefault(require("node:path"));
+const folders_1 = require("../../registry/scripts/domains/folders");
+// Retain the version in persisted learning provenance; the folder model began at version 3.
+exports.LEARNING_DOMAIN_MAP_VERSION = 3;
+exports.LEARNING_DOMAINS = Object.freeze((0, folders_1.discoverJobDomains)(node_path_1.default.join(__dirname, '../../registry')));
 exports.HISTORICAL_LEARNING_DOMAINS = Object.freeze(['compliance', 'company-building', 'operations']);
 exports.STORED_LEARNING_DOMAINS = Object.freeze([...exports.LEARNING_DOMAINS, ...exports.HISTORICAL_LEARNING_DOMAINS]);
 function isLearningDomain(value) {
     return typeof value === 'string' && exports.LEARNING_DOMAINS.includes(value);
 }
-exports.jobCategoryFromRegistryPath = catalog_1.jobDomainFromRegistryPath;
+exports.jobCategoryFromRegistryPath = folders_1.jobDomainFromRegistryPath;
 function resolveJobDomain(registryPath) {
-    const selected = (0, catalog_1.selectCatalogDomain)(catalog, registryPath);
-    return selected.selection === 'mapped' && isLearningDomain(selected.domain) ? selected.domain : null;
+    const domain = (0, folders_1.jobDomainFromRegistryPath)(registryPath);
+    return domain && isLearningDomain(domain) ? domain : null;
 }
-/** Job declarations are deliberately ignored, including personalized overrides. */
 function resolveDomainForJob(registryPath, _jobFileContent) {
     return registryPath ? resolveJobDomain(registryPath) : null;
 }

package/dist/src/core/ai-mentor.js

@@ -91,12 +91,12 @@ class AIMentor {
         }
         return null;
     }
-    /** Delivery identity and first entry come from the executable job, never request categories. */
+    /** The rule domain comes from the executable job's path, never request categories. */
     async getRuleDeliveryContext(jobName) {
         const job = await this.getOrLoadJob(jobName);
         if (!job?.path)
             return null;
-        return { jobPath: job.path.replace(/\\/g, '/').replace(/^.*\/registry\//, ''), initialPhase: job.metadata.initialPhase || Object.keys(job.metadata.phases || {})[0] || Array.from(job.phases.keys())[0] || 'starting' };
+        return { jobPath: job.path.replace(/\\/g, '/').replace(/^.*\/registry\//, '') };
     }
     async resolveIncludes(content, basePath) {
         return (0, include_resolver_1.resolveIncludes)(content, this.resolver, basePath, this.skillDedup);