{"id":51011599,"url":"https://github.com/jwill9999/conscius","last_synced_at":"2026-06-21T03:30:28.255Z","repository":{"id":343081535,"uuid":"1176211890","full_name":"jwill9999/conscius","owner":"jwill9999","description":"AI-assisted engineering workflow platform — layered agent ecosystem","archived":false,"fork":false,"pushed_at":"2026-03-18T17:42:56.000Z","size":692,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-19T05:44:10.585Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jwill9999.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-08T19:09:42.000Z","updated_at":"2026-03-18T17:42:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jwill9999/conscius","commit_stats":null,"previous_names":["jwill9999/coreai","jwill9999/conscius"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jwill9999/conscius","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwill9999%2Fconscius","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwill9999%2Fconscius/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwill9999%2Fconscius/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwill9999%2Fconscius/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jwill9999","download_url":"https://codeload.github.com/jwill9999/conscius/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jwill9999%2Fconscius/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34593128,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-21T03:30:25.826Z","updated_at":"2026-06-21T03:30:28.249Z","avatar_url":"https://github.com/jwill9999.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Conscius\n\n![version](https://img.shields.io/badge/version-0.5.0--alpha.0-blue)\n[![CI](https://github.com/jwill9999/conscius/actions/workflows/ci.yml/badge.svg)](https://github.com/jwill9999/conscius/actions/workflows/ci.yml)\n[![CodeQL](https://github.com/jwill9999/conscius/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/jwill9999/conscius/actions/workflows/github-code-scanning/codeql)\n[![codecov](https://codecov.io/gh/jwill9999/conscius/graph/badge.svg)](https://codecov.io/gh/jwill9999/conscius)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=jwill9999_coreai\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=jwill9999_coreai)\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=jwill9999_coreai\u0026metric=security_rating)](https://sonarcloud.io/summary/new_code?id=jwill9999_coreai)\n\n**Conscius** is a plugin-based framework that gives AI agents persistent cognition — memory, session awareness, task context, and reusable skills that survive across sessions.\n\nMost AI agents are stateless. Conscius bridges that gap by providing a structured runtime that agents can use to reason about past actions, understand current work, and plan future steps.\n\n**`main` baseline:** runtime **v3** plus **Epic 11 MVP hardening** — types and orchestration in `@conscius/runtime`; CLI **`conscius`** (`@conscius/cli`). Includes **`memoryPromptLimits`** and **`memoryGuardrails`**, **`createRuntime().run(input)`** (full compose cycle → prompt string), **`conscius run --input`**, and the documented **memory-only prompt contract** (`buildPromptContext` ignores host-only fields such as `activeTask` unless reflected in segments / compression / conversation). Legacy `agent-core` / standalone `agent-types` packages are not in this workspace.\n\n---\n\n## Packages\n\n| Package                                                         | Description                                                                                        |\n| --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |\n| [`@conscius/runtime`](./packages/runtime)                       | Unified runtime v3 — `createRuntime`, `definePlugin`, `run()`, memory pipeline, hook runner, types |\n| [`@conscius/cli`](./packages/cli)                               | `conscius` CLI — `run --input`, `start` / `end` / `task start`; thin runtime consumer              |\n| [`@conscius/agent-plugin-beads`](./packages/agent-plugin-beads) | Plugin: injects active task context from the Beads task graph                                      |\n| [`@conscius/agent-plugin-mulch`](./packages/agent-plugin-mulch) | Plugin: injects Mulch lessons via `ml prime` during session start                                  |\n\n---\n\n## Quick start\n\n```bash\ngit clone git@github.com:jwill9999/conscius.git\ncd conscius\nnvm use\nnpm install\nnpx nx run-many -t typecheck,lint,test,build --all\n```\n\nWith `.agent/config.json` in the working directory (same layout the runtime expects in real repos), you can try a one-shot compose cycle:\n\n```bash\nnpx conscius run --input \"Hello\"\n```\n\n→ Full setup guide: [docs/guides/getting-started.md](./docs/guides/getting-started.md)\n\n---\n\n## Documentation\n\n| Section                                                                      | Description                                                           |\n| ---------------------------------------------------------------------------- | --------------------------------------------------------------------- |\n| [Documentation index](./docs/README.md)                                      | Full navigation — all guides, specs, ADRs, and API reference          |\n| [Getting started](./docs/guides/getting-started.md)                          | Install, configure, and run the workspace                             |\n| [Adding a plugin](./docs/guides/adding-a-plugin.md)                          | Scaffold and register a new Conscius plugin                           |\n| [Publishing](./docs/guides/publishing.md)                                    | Pre-publish checklist and npm publish workflow                        |\n| [Upstream versions (Mulch / Beads)](./docs/guides/upstream-versions.md)      | Pinning policy, lockfile + CI, bumping `ml` and `bd`                  |\n| [API reference — runtime](./docs/api/runtime.md)                             | Engine, types, hooks, memory pipeline                                 |\n| [API reference — cli](./docs/api/cli.md)                                     | `conscius` binary                                                     |\n| [API reference — agent-types (archived)](./docs/api/agent-types.md)          | Redirect: types merged into `@conscius/runtime`                       |\n| [API reference — agent-core (archived)](./docs/api/agent-core.md)            | Redirect: split into `runtime` + `cli`                                |\n| [Architecture overview](./docs/specs/archive/agent_architecture_overview.md) | 7-layer system design                                                 |\n| [Architecture Decision Records](./docs/adr/)                                 | Why key decisions were made                                           |\n| [Planning](./docs/planning/index.md)                                         | Epics, features, and tasks in progress                                |\n| [Mulch in this repo](./.mulch/README.md)                                     | `.mulch/` layout, **`make mulch-record`**, CLI install / `PATH` notes |\n\n---\n\n## Architecture\n\nConscius separates concerns across 7 layers:\n\n| Layer | Name                                 | Persistence |\n| ----- | ------------------------------------ | ----------- |\n| 1     | Beads — task graph                   | persistent  |\n| 2     | Mulch — experience / lessons learned | persistent  |\n| 3     | Skills / instruction knowledge       | persistent  |\n| 4     | Conversation compression             | ephemeral   |\n| 5     | Session continuity (`SESSION.md`)    | persistent  |\n| 6     | Context injection hooks              | persistent  |\n| 7     | Guardrails \u0026 quality gates           | runtime     |\n\nEach layer is implemented as an independent plugin package. **`@conscius/runtime`** loads and orchestrates whichever plugins are configured.\n\n---\n\n## Development\n\n```bash\n# Build a single package\nnpx nx build @conscius/runtime\n\n# Run tests\nnpx nx test @conscius/runtime\n\n# Lint\nnpx nx lint @conscius/runtime\n\n# Run all quality checks\nnpx nx run-many -t typecheck,lint,test --all\n\n# Check only affected packages (CI mode)\nnpx nx affected -t typecheck,lint,test\n```\n\nRepo **Makefile** (optional): run **`make help`** for targets. **`make mulch-record`** starts the interactive Mulch lesson flow after **`npm install`** — details, required fields, and how the CLI is resolved on `PATH` are in **[.mulch/README.md](./.mulch/README.md)**.\n\n---\n\n## Contributing\n\nSee [SESSION.md](./SESSION.md) for epic status, open housekeeping items, and next steps. [SUMMARY.md](./SUMMARY.md) holds compressed session history for agents.\n\n**Badges:** CI, Codecov, and CodeQL target this repo (**`jwill9999/conscius`**). SonarCloud still uses the historical project key **`jwill9999_coreai`** in URLs — quality gate links remain valid.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjwill9999%2Fconscius","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjwill9999%2Fconscius","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjwill9999%2Fconscius/lists"}