Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -224,7 +224,7 @@ bash plugins/narness/scripts/narness-rust-test-integration.sh examples/rust-work

The example contains a root workspace contract, a task Skill with progressive disclosure, unit and integration evidence, an environment declaration, and a stable CI required gate.

The repository also contains research prototypes that are intentionally outside the canonical Narness runtime scope. The [System One Kubernetes command generator](examples/system-one-k8s/README.md) remains an in-repository reference implementation. The [Code Locator directory](research/code-locator/README.md) is an archived Narness snapshot; active System One code-exploration implementation and research now live in [BestNathan/system-one-code-explore](https://github.com/BestNathan/system-one-code-explore).
The repository also contains research prototypes that are intentionally outside the canonical Narness runtime scope. The [System One Kubernetes command generator](examples/system-one-k8s/README.md) remains an in-repository reference implementation. The [Code Locator directory](research/code-locator/README.md) is now only a migration pointer; its implementation and experiment payload have been removed from Narness, and active System One code-exploration work lives in [BestNathan/system-one-code-explore](https://github.com/BestNathan/system-one-code-explore).

## Adopt Narness

Expand Down Expand Up @@ -259,7 +259,7 @@ Start with [docs/adoption.md](docs/adoption.md):
- [Change-to-Evidence Planning topic](docs/topics/change-to-evidence-planning/README.md)
- [System One Progressive Action Spaces topic](docs/topics/system-one-progressive-action-space/README.md)
- [System One Kubernetes command generator](examples/system-one-k8s/README.md)
- [Archived System One code locator snapshot](research/code-locator/README.md)
- [Code Locator migration pointer](research/code-locator/README.md)
- [Active System One code-exploration repository](https://github.com/BestNathan/system-one-code-explore)
- [AI Workspace architecture](docs/architecture.md)
- [Adoption guide](docs/adoption.md)
Expand Down
4 changes: 2 additions & 2 deletions docs/topics/system-one-progressive-action-space/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -676,7 +676,7 @@ The active Code Locator / System One code-exploration codebase is now:

Narness should **not** mirror ongoing implementation or experiment logs back into this repository. Only stable, reusable harness conclusions should graduate back into Narness topics or canonical architecture.

The local [`research/code-locator/`](../../../research/code-locator/README.md) directory is therefore an archived snapshot of the early Narness prototype, retained for provenance.
The local [`research/code-locator/`](../../../research/code-locator/README.md) directory is now only a migration pointer. The old implementation, fixtures, tests, experiment documents, and run artifacts were removed from Narness; provenance remains available through Git history and the closed research PRs.

## 20. What remains active in this topic

Expand All @@ -692,7 +692,7 @@ The broader Progressive Action Spaces topic remains active. Code Locator is now
## Reference implementations

- [System One Kubernetes Command Generator](../../../examples/system-one-k8s/README.md)
- [Archived Narness Code Locator snapshot](../../../research/code-locator/README.md)
- [Code Locator migration pointer](../../../research/code-locator/README.md)
- [Active System One code-exploration repository](https://github.com/BestNathan/system-one-code-explore)

## Related Narness topics
Expand Down
67 changes: 9 additions & 58 deletions research/code-locator/README.md
Original file line number Diff line number Diff line change
@@ -1,65 +1,16 @@
# System One Code Locator — Archived Narness Snapshot
# Code Locator research

> Status: Archived in Narness. Active implementation and ongoing research have moved to [BestNathan/system-one-code-explore](https://github.com/BestNathan/system-one-code-explore).
> Status: Migrated. Narness no longer contains the Code Locator implementation, fixtures, tests, experiment workflows, or run artifacts.

This directory is retained as historical evidence for the early Code Locator experiment that was merged into Narness in [PR #16](https://github.com/BestNathan/narness-engineering/pull/16).
Code Locator started in Narness as a case study for System One progressive action spaces. The implementation and ongoing research now live in:

It is **not** the current Code Locator implementation and should not be used as the starting point for new experiments.

## Why this snapshot remains

Code Locator began as a concrete test of the System One Progressive Action Spaces thesis:

~~~text
large environment
-> bounded grounded frontier
-> fast model judgment
-> typed effect
-> observation
-> new state
~~~

The early prototype in this directory explored hierarchical repository localization and established the first reproducible fixtures, traces, and workflow evidence.

Later research moved well beyond this snapshot. The follow-up work in [PR #17](https://github.com/BestNathan/narness-engineering/pull/17) explored two-phase readers, independent file-local runtimes, explicit stop control, bounded decision views, canonical localization results, and multiple exploration algorithms. Additional benchmark branches were opened as PRs #21-#25.

Those branches are preserved as GitHub research history, but active development no longer happens in Narness.

## Converged findings retained by Narness

The durable conclusions are documented in the [System One Progressive Action Spaces topic](../../docs/topics/system-one-progressive-action-space/README.md). In short:

- keep each model decision over a small grounded action frontier;
- treat source reads as observations produced by typed effects;
- separate broad file discovery from file-local navigation;
- prefer independent file-local runtimes when raw observations would otherwise overwhelm one shared context;
- keep navigation action generation content-agnostic where possible;
- use `Choice` for mutually exclusive control flow and `Noul` for independent relevance/utility judgments;
- do not overload relevance thresholds as implicit stopping semantics;
- separate durable `RuntimeState` from bounded model-visible `DecisionView`;
- keep execution traces separate from canonical localization results.

## Historical scope of this directory

The code and documents here reflect the early merged prototype, roughly:

~~~text
repository
-> directory relevance
-> file relevance
-> source-line relevance
-> merged snippets
~~~

That design is useful as provenance, but it has been superseded as an active architecture.

Do not add new Code Locator algorithms, benchmark runs, or experiment logs here.
- [BestNathan/system-one-code-explore](https://github.com/BestNathan/system-one-code-explore)
- active experiment records: `docs/research/` in that repository

## Current implementation and research
Narness keeps only the architectural conclusions that generalize to harness engineering. See:

Use the dedicated repository instead:
- [System One Progressive Action Spaces](../../docs/topics/system-one-progressive-action-space/README.md)

- [BestNathan/system-one-code-explore](https://github.com/BestNathan/system-one-code-explore)
- ongoing research: `docs/research/` in that repository
Historical Narness development remains available through Git history and the closed research pull requests, especially #16 and #17.

Narness may still absorb stable architectural conclusions from that work, but should not duplicate its implementation or experiment history.
Do not add Code Locator source code, fixtures, tests, workflows, or run logs back under this directory. Stable cross-project conclusions may be incorporated into Narness topics instead.
255 changes: 0 additions & 255 deletions research/code-locator/docs/design.md

This file was deleted.

Loading
Loading