agent-bios 0.19.1 → 0.19.3

package/compose/native_cli.py

@@ -0,0 +1,52 @@
+"""Bash-free entrypoint for the installed Windows application and direct Python use."""
+from __future__ import annotations
+import json
+import os
+from pathlib import Path
+import runpy
+import sys
+
+ROOT = Path(__file__).resolve().parents[1]
+sys.path.insert(0, str(ROOT / 'compose'))
+sys.dont_write_bytecode = True
+
+
+def main(args=None):
+    args = list(sys.argv[1:] if args is None else args)
+    os.environ.setdefault('HOME', str(Path.home()))
+    os.environ['PYTHONDONTWRITEBYTECODE'] = '1'
+    if args and args[0] in ('--version', '-V'):
+        print(json.loads((ROOT / 'package.json').read_text(encoding='utf-8'))['version'])
+        return 0
+    command = args.pop(0) if args else ('instructions' if (Path(os.environ.get('AGENT_BIOS_STATE_DIR', str(Path.home()/'.local/share/agent-bios'))) / 'runtime/private-install.json').exists() else 'install')
+    if command in ('help', '--help', '-h'):
+        print('agent-bios: install | instructions | setup | app | import | learn | understand | launch | verify | status | uninstall | reset')
+        return 0
+    modules = {'instructions':'instructions', 'corpus':'instructions', 'setup':'instructions_setup_cli',
+               'app':'instructions_app', 'import':'instructions_import', 'understand':'instructions_understand'}
+    if command in ('install', 'onboard', 'verify', 'status', 'uninstall', 'reset'):
+        import instructions_install
+        return instructions_install.main(['--repo', str(ROOT), command, *args])
+    if command in modules:
+        import importlib
+        module = importlib.import_module(modules[command])
+        if command in ('instructions', 'corpus'):
+            return module.main(['--repo', str(ROOT), *args], bundled_ui=True)
+        return module.main(['--repo', str(ROOT), *args])
+    if command == 'launch':
+        os.environ['AGENT_BIOS_PACKAGE_ROOT'] = str(ROOT)
+        os.environ['AGENT_BIOS_PRIVATE_INSTRUCTIONS'] = '1'
+        os.environ.pop('AGENT_BIOS_PRIVATE_CORPUS', None)
+        sys.argv = [str(ROOT / 'launch/agent-launch.py'), *args]
+        runpy.run_path(sys.argv[0], run_name='__main__')
+        return 0
+    if command == 'learn':
+        sys.argv = [str(ROOT / 'learn/collect-learning.py'), *args]
+        runpy.run_path(sys.argv[0], run_name='__main__')
+        return 0
+    print(f'Unknown or unsupported native command: {command}', file=sys.stderr)
+    return 2
+
+
+if __name__ == '__main__':
+    raise SystemExit(main())

package/compose/register-hooks.py

@@ -2,7 +2,7 @@
 """Legacy utility: merge canonical hook registrations into Claude settings.
 
 The private installer registers no global host hooks. Explicit native session
-activation is shared by Claude and Codex through corpus_catalog/corpus_session.
+activation is shared by Claude and Codex through instructions_catalog/instructions_session.
 This compatibility utility retains the legacy Claude settings.json ownership
 and merge behavior by calling the assembler's merge_settings implementation.
 

package/compose/runtime_entry.py

@@ -0,0 +1,58 @@
+"""Application dependency entry for ordinary and isolated embeddable Python."""
+from __future__ import annotations
+import argparse
+import importlib
+import importlib.metadata
+import os
+from pathlib import Path
+import runpy
+import sys
+
+
+def main(argv=None):
+    # A Windows PowerShell 5.1 caller may prefix piped input with a UTF-8 BOM.
+    for stream, encoding in ((sys.stdin, "utf-8-sig"), (sys.stdout, "utf-8"), (sys.stderr, "utf-8")):
+        if hasattr(stream, "reconfigure"):
+            stream.reconfigure(encoding=encoding, errors="strict")
+    argv = list(sys.argv[1:] if argv is None else argv)
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument('--dependencies', required=True, type=Path)
+    parser.add_argument('--probe', choices=['jsonschema'])
+    if '--script' in argv:
+        index = argv.index('--script')
+        if len(argv) <= index + 1:
+            parser.error('--script requires a file')
+        args = parser.parse_args(argv[:index])
+        script, tail = Path(argv[index+1]), argv[index+2:]
+    else:
+        args = parser.parse_args(argv)
+        script, tail = None, []
+    dependencies = args.dependencies.resolve(strict=True)
+    if not dependencies.is_dir():
+        parser.error('dependencies must be a directory')
+    sys.dont_write_bytecode = True
+    sys.path.insert(0, str(dependencies))
+    os.environ['PYTHONDONTWRITEBYTECODE'] = '1'
+    os.environ['AGENT_BIOS_PYTHON_EXECUTABLE'] = str(Path(sys.executable).resolve())
+    os.environ['AGENT_BIOS_PYTHON_ENTRY'] = str(Path(__file__).resolve())
+    os.environ['AGENT_BIOS_PYTHON_DEPS'] = str(dependencies)
+    if args.probe:
+        module = importlib.import_module(args.probe)
+        getattr(module, 'Draft202012Validator')
+        print(importlib.metadata.version(args.probe))
+        return 0
+    if script is None:
+        parser.error('a script or probe is required')
+    script = script.resolve(strict=True)
+    if not script.is_file() or script.suffix != '.py':
+        parser.error('script must be a Python file')
+    # Isolated Python does not add the script directory to sys.path. Do this only
+    # for the explicitly selected application/helper, not a user's working directory.
+    sys.path.insert(0, str(script.parent))
+    sys.argv = [str(script), *tail]
+    runpy.run_path(str(script), run_name='__main__')
+    return 0
+
+
+if __name__ == '__main__':
+    raise SystemExit(main())

package/compose/setup/START.md

@@ -59,24 +59,24 @@ and the user's activation-policy decision.
 
 Collect the six plan fields without asking the user to author JSON:
 
-- `selection_mode` and `targets`: keep saved policy, no active corpus, all available
-  corpus, or specific returned package/domain/item targets. Start from the returned
-  default. No active corpus retains private library assets but delivers no corpus.
+- `selection_mode` and `targets`: keep saved policy, no active instructions, all available
+  instructions, or specific returned package/domain/item targets. Start from the returned
+  default. No active instructions retains private library assets but delivers no instructions.
 - `dependencies`: chosen installable inventory IDs; an empty list installs none.
 - `app_bridge`: the explicit **Connect to the Codex app** choice, adding `$agent-bios`
   for setup and personal instruction management. Registration enables discovery only;
-  each task still requires its own explicit corpus use.
+  each task still requires its own explicit instructions use.
 - `project_roots` and `import_paths`: absolute project folders and explicitly
-  selected files from discovery. Capture is independent of corpus selection.
+  selected files from discovery. Capture is independent of instructions selection.
 
-Keep saved policy uses `selection_mode: null` and `targets: null`. No active corpus
+Keep saved policy uses `selection_mode: null` and `targets: null`. No active instructions
 uses `"none"` and `[]`. Explicit choices use `"selected"` and their target list;
-all available corpus uses `"selected"` and `["all"]`.
+all available instructions uses `"selected"` and `["all"]`.
 
 Discovery checks known global instruction locations and the specified project
 roots. Show detected sources before selecting them. Capture preserves originals
 and prepares private evidence for later model review; it is not an automatically
-optimized personal corpus. Read the import procedure only when the user requests
+optimized personal instructions. Read the import procedure only when the user requests
 that subsequent review.
 
 Save choices to a new caller-owned artifact. Run `plan` and save its complete
@@ -89,7 +89,7 @@ agent-bios setup plan --language ko --input /absolute/choices.json > /absolute/r
 The returned review envelope contains `review_id`, `context`, `language`,
 `preview` and `summary`. Keep the entire envelope; do not reconstruct it from the
 summary, copy only `preview`, change its IDs, or accept truncated output. Show the
-concrete private paths, selected dependency commands/destinations, corpus policy,
+concrete private paths, selected dependency commands/destinations, instructions policy,
 app discovery change and selected capture sources. Keep the exact artifact
 available for inspection. Preparing these caller-owned files is separate from
 applying installation effects.
@@ -149,10 +149,10 @@ through its reviewed entrypoint/context; changing entrypoints requires a fresh
 review. Status and subsequent setup can use the verified handoff.
 Do not create a duplicate personal skill or edit host discovery settings to force
 refresh. Once discovered, `$agent-bios` is the ordinary entrypoint. Registration
-on disk is not proof of discovery or corpus loading.
+on disk is not proof of discovery or instructions loading.
 
 If capture completed, report its actual capture ID and returned next action. Its
 semantic review, proposed consumption placement and revision-checked import are
 separate from installation. Setup enables no hooks, native agent registration,
 permissions or edits to global/project instruction files. Each app task requires
-its own explicit corpus use; neither setup nor opening the app performs it.
+its own explicit instructions use; neither setup nor opening the app performs it.