@oldboydev/sheldon-darwin-arm64 0.2.0 → 0.2.1

package/node_modules/@sheldon/cli/dist/main.js

@@ -21,6 +21,7 @@ import { configureMcpConsumer, doctorMcp, installSheldonSkill, serveMcp } from '
 import { buildBundle, createBundle, diffBundles, validateBundle } from './commands/bundle.js';
 import { startWebServer } from '@sheldon/web';
 import { createWebApplication } from './web-api.js';
+import { openHelpPage, readHelpPageIds, resolveHelpPage, resolveHelpRoot } from './help.js';
 import { createOfficialCatalogClient, currentPlatform } from './official-catalog.js';
 export async function runCli(args, dependencies = {}) {
     const stdout = [];
@@ -83,6 +84,14 @@ export async function runCli(args, dependencies = {}) {
             };
         }
         const message = error instanceof Error ? error.message : String(error);
+        if (message.startsWith('HELP_PAGE_MISSING:')) {
+            stderr.push(`Error: ${message}\nTarget: offline help\nRecovery: run sheldon help --path and confirm the help files are installed.\n`);
+            return {
+                exitCode: 1,
+                stdout: stdout.join(''),
+                stderr: stderr.join('')
+            };
+        }
         stderr.push(`Error: ${message}\nTarget: command execution\nRecovery: review the command and retry.\n`);
         return {
             exitCode: 1,
@@ -101,6 +110,14 @@ function configureCommander(command, stdout, stderr) {
 }
 function createProgram(context, dependencies) {
     const program = new Command('sheldon').description('Build and use a local, reviewable knowledge vault.');
+    program.helpCommand(false);
+    program.command('help [topic]').description('Show CLI help, or open offline HTML help.').option('--html', 'open offline HTML help in the default browser').option('--path', 'print the offline HTML help directory').action(async (topic, options, command)=>{
+        const parent = command.parent;
+        if (!parent) {
+            throw new Error('Help command is missing its parent program.');
+        }
+        await executeHelp(topic, options, parent, context, dependencies);
+    });
     program.command('init [path]').description('Create a Sheldon vault and save it as the local default.').addOption(new Option('--yes', 'accept the proposed default path')).action((path, options)=>executeInit(path, options, context));
     program.command('doctor').description('Check the vault, local databases, plugins, and agent tools.').option('--vault <path>', 'explicit vault path').action((options)=>executeDoctor(options, context));
     program.command('migrate-state').description('Copy legacy plugin state to this platform state directory after hash verification.').requiredOption('--from <directory>', 'legacy Sheldon application-state directory').action(async (options)=>{
@@ -157,6 +174,27 @@ function createProgram(context, dependencies) {
     language.command('remove <code>').description('Remove installed OCR language data.').action((code)=>removeImageLanguageCommand(code, context));
     return program;
 }
+async function executeHelp(topic, options, program, context, dependencies) {
+    const helpRoot = resolveHelpRoot(dependencies.helpRoot);
+    if (options.path) {
+        context.write(helpRoot);
+        return;
+    }
+    if (options.html) {
+        const page = resolveHelpPage(topic, helpRoot, await readHelpPageIds(helpRoot));
+        await openHelpPage(page, dependencies.openHelp);
+        return;
+    }
+    if (!topic) {
+        program.outputHelp();
+        return;
+    }
+    const command = program.commands.find((candidate)=>candidate.name() === topic || candidate.aliases().includes(topic));
+    if (!command || command.name() === 'help') {
+        throw new Error(`Unknown help topic '${topic}'.`);
+    }
+    command.outputHelp();
+}
 function agentKind(value) {
     if (isAgentKind(value)) return value;
     throw new InvalidArgumentError(`Agent must be ${formatAgentKindList()}.`);

package/node_modules/@sheldon/cli/node_modules/@sheldon/agent-runtime/dist/command-executor.js

@@ -253,7 +253,7 @@ async function readTextIfPresent(path) {
 function terminate(child) {
     if (!child.killed) child.kill('SIGKILL');
 }
-function buildChildEnvironment(source, allowlist) {
+export function buildChildEnvironment(source, allowlist) {
     const environment = sanitizedEnvironment(source);
     for (const key of [
         'HOME',

package/node_modules/@sheldon/cli/node_modules/@sheldon/agent-runtime/dist/index.js

@@ -1,6 +1,6 @@
 export { createClaudeCommandAdapter, createClaudeQueryAdapter, createCodexCommandAdapter, createCodexQueryAdapter, createCommandAdapter, createGrokCommandAdapter, createGrokQueryAdapter, createQueryCommandAdapter } from './adapters.js';
 export { ProposalPromotionError, ProposalValidationError } from './errors.js';
-export { JsonCommandExecutor } from './command-executor.js';
+export { JsonCommandExecutor, buildChildEnvironment } from './command-executor.js';
 export { isProposalId, PROPOSAL_SCHEMA_VERSION, summarizeProposal, validateProposal } from './proposal.js';
 export { ProposalStore } from './proposal-store.js';
 export { AGENT_PROFILE_IDS, formatAgentKindList, isAgentKind, listAgentProfiles, requireAgentProfile } from './profiles.js';

package/node_modules/@sheldon/cli/node_modules/@sheldon/agent-runtime/dist/profiles.js

@@ -1,8 +1,3 @@
-export const AGENT_PROFILE_IDS = [
-    'codex',
-    'claude',
-    'grok'
-];
 const profiles = [
     {
         id: 'codex',
@@ -102,6 +97,7 @@ const profiles = [
         }
     }
 ];
+export const AGENT_PROFILE_IDS = profiles.map((profile)=>profile.id);
 export function isAgentKind(value) {
     return AGENT_PROFILE_IDS.includes(value);
 }

package/node_modules/@sheldon/cli/node_modules/@sheldon/plugin-host/dist/official-catalog.js

@@ -53,7 +53,8 @@ function parseCatalogDocument(value) {
     }
     const publishedAt = timestamp(document.publishedAt);
     const plugins = pluginEntries(document.plugins);
-    const languages = languageEntries(document.languages);
+    const imagePlatforms = plugins.find((plugin)=>plugin.id === 'source.image')?.platforms ?? SUPPORTED_PLATFORMS;
+    const languages = languageEntries(document.languages, imagePlatforms);
     return {
         schemaVersion: 1,
         publishedAt,
@@ -91,7 +92,7 @@ function pluginEntries(value) {
     });
     return entries.sort((left, right)=>left.id.localeCompare(right.id));
 }
-function languageEntries(value) {
+function languageEntries(value, imagePlatforms) {
     if (!Array.isArray(value)) schemaInvalid();
     const codes = new Set();
     const entries = value.map((candidate)=>{
@@ -111,7 +112,7 @@ function languageEntries(value) {
         return {
             owner: 'source.image',
             code: entry.code,
-            artifacts: artifactRecord(entry.artifacts, SUPPORTED_PLATFORMS)
+            artifacts: artifactRecord(entry.artifacts, imagePlatforms)
         };
     });
     return entries.sort((left, right)=>left.code.localeCompare(right.code));

package/node_modules/@sheldon/cli/node_modules/@sheldon/plugin-source-image/node_modules/@sheldon/plugin-host/dist/official-catalog.js

@@ -53,7 +53,8 @@ function parseCatalogDocument(value) {
     }
     const publishedAt = timestamp(document.publishedAt);
     const plugins = pluginEntries(document.plugins);
-    const languages = languageEntries(document.languages);
+    const imagePlatforms = plugins.find((plugin)=>plugin.id === 'source.image')?.platforms ?? SUPPORTED_PLATFORMS;
+    const languages = languageEntries(document.languages, imagePlatforms);
     return {
         schemaVersion: 1,
         publishedAt,
@@ -91,7 +92,7 @@ function pluginEntries(value) {
     });
     return entries.sort((left, right)=>left.id.localeCompare(right.id));
 }
-function languageEntries(value) {
+function languageEntries(value, imagePlatforms) {
     if (!Array.isArray(value)) schemaInvalid();
     const codes = new Set();
     const entries = value.map((candidate)=>{
@@ -111,7 +112,7 @@ function languageEntries(value) {
         return {
             owner: 'source.image',
             code: entry.code,
-            artifacts: artifactRecord(entry.artifacts, SUPPORTED_PLATFORMS)
+            artifacts: artifactRecord(entry.artifacts, imagePlatforms)
         };
     });
     return entries.sort((left, right)=>left.code.localeCompare(right.code));