@inneranimalmedia/agentsam-sdk 2.1.0 → 2.2.1

package/test/capabilities.test.mjs

@@ -0,0 +1,84 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { getCapability, getCapabilityManifest, repositorySnapshot } from '../src/capabilities/index.js';
+import { getPreset, resolvePreset } from '../src/presets/index.js';
+
+const CLI = path.resolve('src/cli.js');
+
+function git(cwd, args) { return execFileSync('git', args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim(); }
+
+function fixture() {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'agentsam-capability-'));
+  fs.writeFileSync(path.join(root, 'package.json'), JSON.stringify({ name: 'snapshot-fixture', version: '1.0.0', type: 'module' }, null, 2));
+  fs.mkdirSync(path.join(root, 'src'));
+  fs.writeFileSync(path.join(root, 'src', 'index.js'), 'export const value = 1;\n');
+  git(root, ['init', '-q']);
+  git(root, ['config', 'user.email', 'test@example.com']);
+  git(root, ['config', 'user.name', 'AgentSam Test']);
+  git(root, ['add', '.']);
+  git(root, ['commit', '-qm', 'fixture']);
+  return root;
+}
+
+test('capability manifest exposes deterministic primitives without requiring a model', () => {
+  const manifest = getCapabilityManifest();
+  assert.equal(manifest.schema_version, 1);
+  assert.equal(getCapability('repository.snapshot').model_required, false);
+  assert.equal(getCapability('repository.snapshot').side_effects, 'none');
+  assert.equal(getCapability('knowledge.index').deterministic, true);
+});
+
+test('presets resolve to explicit feature/capability selections', () => {
+  assert.equal(getPreset('cms').lane, 'cms');
+  const preset = resolvePreset('prototype');
+  assert.deepEqual(preset.features, ['agent']);
+  assert.throws(() => resolvePreset('nope'), /unknown_preset/);
+});
+
+test('repository.snapshot composes deterministic evidence and content addressing', async t => {
+  const root = fixture();
+  t.after(() => fs.rmSync(root, { recursive: true, force: true }));
+  const one = await repositorySnapshot({ cwd: root, churnDays: 30 });
+  const two = await repositorySnapshot({ cwd: root, churnDays: 30 });
+  assert.equal(one.capability, 'repository.snapshot');
+  assert.match(one.snapshot_id, /^rsnap_[a-f0-9]{24}$/);
+  assert.match(one.content_hash, /^sha256:[a-f0-9]{64}$/);
+  assert.equal(one.content_hash, two.content_hash);
+  assert.equal(one.snapshot_id, two.snapshot_id);
+  assert.equal(one.repository.revision_sha, git(root, ['rev-parse', 'HEAD']));
+  assert.ok(one.tree.merkle_root);
+  assert.ok(one.intelligence.summary.file_count >= 2);
+  assert.equal(one.packages[0].name, 'snapshot-fixture');
+  assert.equal(one.knowledge.configured, false);
+});
+
+test('product UX creates a preset project, adds a feature, and inspects before first commit', t => {
+  const parent = fs.mkdtempSync(path.join(os.tmpdir(), 'agentsam-product-'));
+  t.after(() => fs.rmSync(parent, { recursive: true, force: true }));
+  execFileSync(process.execPath, [CLI, 'create', 'demo', '--preset', 'cms', '--target', 'local'], {
+    cwd: parent,
+    stdio: 'pipe',
+  });
+  const project = path.join(parent, 'demo');
+  const config = JSON.parse(fs.readFileSync(path.join(project, '.agentsam', 'config.json'), 'utf8'));
+  assert.equal(config.preset, 'cms');
+  assert.equal(config.lane, 'cms');
+  assert.deepEqual(config.features, ['cms', 'knowledge']);
+  assert.ok(config.capabilities.includes('repository.snapshot'));
+
+  execFileSync(process.execPath, [CLI, 'add', 'knowledge', '--cwd', project, '--json'], { stdio: 'pipe' });
+  const features = JSON.parse(fs.readFileSync(path.join(project, '.agentsam', 'features.json'), 'utf8'));
+  assert.equal(features.features.knowledge.selected, true);
+
+  const snapshot = JSON.parse(execFileSync(process.execPath, [CLI, 'inspect', '--cwd', project, '--json'], {
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'pipe'],
+  }));
+  assert.equal(snapshot.capability, 'repository.snapshot');
+  assert.equal(snapshot.repository.revision_sha, null);
+  assert.ok(snapshot.tree.stats.files > 0);
+});

package/test/portable-context.test.mjs

@@ -1,7 +1,7 @@
 import test from 'node:test';
 import assert from 'node:assert/strict';
 import { execFileSync } from 'node:child_process';
-import { mkdtempSync, writeFileSync } from 'node:fs';
+import { mkdtempSync, realpathSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 
@@ -39,6 +39,16 @@ test('resolveGitContext derives repository identity from Git without user/worksp
   assert.equal('userId' in ctx, false);
 });
 
+test('resolveGitContext supports an initialized repository before its first commit', () => {
+  const root = mkdtempSync(join(tmpdir(), 'agentsam-sdk-unborn-'));
+  execFileSync('git', ['init'], { cwd: root, stdio: 'ignore' });
+  writeFileSync(join(root, 'README.md'), '# unborn\n');
+  const ctx = resolveGitContext({ cwd: root });
+  assert.equal(ctx.root, realpathSync(root));
+  assert.equal(ctx.revisionSha, null);
+  assert.equal(ctx.dirty, true);
+});
+
 test('bridge headers authenticate only the machine principal', () => {
   const headers = buildBridgeHeaders({
     env: {

package/test/shell.test.mjs

@@ -0,0 +1,60 @@
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import test from 'node:test';
+import { dispatchShellLine, renderShellCatalog, tokenizeShellLine } from '../src/commands/shell.js';
+
+const repoRoot = path.resolve(new URL('..', import.meta.url).pathname);
+
+test('shell tokenizer preserves Windows paths and quoted arguments', () => {
+  assert.deepEqual(tokenizeShellLine('/cd C:\\Users\\conno\\fuelnreetime'), ['/cd', 'C:\\Users\\conno\\fuelnreetime']);
+  assert.deepEqual(tokenizeShellLine('/cd "C:\\Users\\Connor Smith\\repo"'), ['/cd', 'C:\\Users\\Connor Smith\\repo']);
+  assert.deepEqual(tokenizeShellLine('/agent "inspect this repo"'), ['/agent', 'inspect this repo']);
+});
+
+test('shell catalog advertises commands that the REPL owns', () => {
+  const catalog = renderShellCatalog();
+  assert.match(catalog, /\/help\s+Show Agent Sam commands/);
+  assert.match(catalog, /\/status\s+Local project/);
+  assert.match(catalog, /\/exit\s+Exit Agent Sam shell/);
+});
+
+test('dispatch handles help, pwd, cd, and exit without falling through to host shell', async () => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'agentsam-shell-'));
+  const child = path.join(root, 'child folder');
+  fs.mkdirSync(child);
+  let output = '';
+  const state = { cwd: root, write: (text) => { output += text; } };
+
+  let result = await dispatchShellLine('/help', state);
+  assert.equal(result.handled, true);
+  assert.equal(result.exit, false);
+  assert.match(output, /Slash commands/);
+
+  output = '';
+  result = await dispatchShellLine('/pwd', state);
+  assert.equal(result.handled, true);
+  assert.equal(output.trim(), root);
+
+  output = '';
+  result = await dispatchShellLine('/cd "child folder"', state);
+  assert.equal(result.handled, true);
+  assert.equal(state.cwd, child);
+  assert.equal(output.trim(), child);
+
+  result = await dispatchShellLine('/exit', state);
+  assert.equal(result.exit, true);
+});
+
+test('CLI supports a deterministic one-shot slash command for regression tests', () => {
+  const result = spawnSync(process.execPath, ['src/cli.js', 'shell', '--command', '/help'], {
+    cwd: repoRoot,
+    encoding: 'utf8',
+  });
+  assert.equal(result.status, 0, result.stderr);
+  assert.match(result.stdout, /Agent Sam Terminal/);
+  assert.match(result.stdout, /\/help/);
+  assert.match(result.stdout, /\/exit/);
+});

package/test/smoke.mjs

@@ -57,8 +57,8 @@ assert.ok(SLASH_COMMANDS.some((c) => c.cmd === '/db'));
 assert.ok(SLASH_COMMANDS.some((c) => c.cmd === '/agent'));
 assert.deepEqual(
   listSlashCommands({ lane: 'deploy' }).map(({ cmd }) => cmd),
-  ['/help', '/deploy'],
-  'deploy lane keeps global help and excludes commands from other lanes',
+  ['/help', '/deploy', '/exit'],
+  'deploy lane keeps global shell controls and excludes commands from other lanes',
 );
 
 printContextSummary({